*Nội dung này được dịch bằng AI (Beta) và có thể có lỗi. Để xem trang này bằng tiếng Anh, hãy nhấp vào đây.

GroupMembership

Một thành viên của một nhóm. ID người dùng có thể được sử dụng thay cho ID thành viên.

Thuộc Tính

pathstring

Con đường tài nguyên của thành viên nhóm.

Định dạng: groups/{group_id}/memberships/{group_membership_id}.

createTimestring
Chỉ Xuất

Thời gian chạy khi thành viên nhóm được tạo. Chuỗi này được định dạng là Dấu thời gian.

updateTimestring
Chỉ Xuất

Thời gian chỉnh sửa lần cuối khi thành viên nhóm được cập nhật lần cuối. Chuỗi này được định dạng là Dấu thời gian.

userstring
Bất Biến

Con đường tài nguyên của một thành viên trong nhóm.

rolestring

Con đường tài nguyên cho vai trò thành viên nhóm.

URL Cơ Sở
https://apis.roblox.com
Tài nguyên GroupMembership
{

  "path": "groups/123/memberships/123",

  "createTime": "2023-07-05T12:34:56Z",

  "updateTime": "2023-07-05T12:34:56Z",

  "user": "users/21557",

  "role": "groups/7/roles/99513316"

}

GroupMembership

Danh sách thành viên nhóm
Bản Beta

GET /cloud/v2/groups/{group_id}/memberships

Danh sách thành viên nhóm trong một nhóm.

Yêu CầuTham Số Đường Dẫn
group_idstring
Bắt Buộc

ID nhóm.

Tham Số Truy Vấn
maxPageSizenumber

Số tối đa thành viên nhóm để trả lại.Dịch vụ có thể trả về ít hơn giá trị này.Nếu không được xác định, tối đa 10 thành viên nhóm được trả về.Giá trị tối đa là 100 và giá trị cao hơn được đặt thành 100.

pageTokenstring

Một token trang, nhận từ cuộc gọi trước, để lấy lại trang tiếp theo.

Khi paginate, tất cả các tham số khác được cung cấp cho cuộc gọi tiếp theo phải phù hợp với cuộc gọi cung cấp token trang.

filterstring

Trường này có thể được đặt để lọc các tài nguyên được trả về.

Xem tài liệu lọc filtering để có thêm thông tin.

Phản Hồi

Một danh sách thành viên nhóm trong bộ sưu tập cha.

groupMembershipsarray<GroupMembership>

Các thành viên nhóm từ nhóm được chỉ định.

nextPageTokenstring

Một token mà bạn có thể gửi như một tham số pageToken để lấy trang tiếp theo. Nếu trường này bị bỏ qua, không có trang tiếp theo.

GET /cloud/v2/groups/{group_id}/memberships
curl -L -X GET 'https://apis.roblox.com/cloud/v2/groups/{group_id}/memberships?maxPageSize=10&pageToken={string}&filter={string}' \

  -H 'x-api-key: {your-api-key}'
Phản Hồi
{

  "groupMemberships": [

    {

      "path": "groups/123/memberships/123",

      "createTime": "2023-07-05T12:34:56Z",

      "updateTime": "2023-07-05T12:34:56Z",

      "user": "users/21557",

      "role": "groups/7/roles/99513316"

    }

  ],

  "nextPageToken": "string"

}

GroupMembership

Cập nhật thành viên nhóm
Bản Beta

PATCH /cloud/v2/groups/{group_id}/memberships/{membership_id}

Cập nhật thành viên nhóm cho một thành viên nhóm cụ thể.Hành động này yêu cầu người yêu cầu phải có thể quản lý các thành viên có xếp hạng thấp hơn.Không thể gán cấp Guest hoặc Owner, và một người yêu cầu không thể thay đổi cấp của riêng mình.

Phạm Vi
group:write
Yêu CầuTham Số Đường Dẫn
group_idstring
Bắt Buộc

ID nhóm.

membership_idstring
Bắt Buộc

ID thành viên.

Yêu Cầu Cơ ThểGroupMembership
Phản HồiGroupMembership
PATCH /cloud/v2/groups/{group_id}/memberships/{membership_id}
curl -L -X PATCH 'https://apis.roblox.com/cloud/v2/groups/{group_id}/memberships/{membership_id}' \

  -H 'x-api-key: {your-api-key}' \

  -H 'Content-Type: application/json' \

  --data '{

  "role": "groups/7/roles/99513316"

}'
Phản Hồi
{

  "path": "groups/123/memberships/123",

  "createTime": "2023-07-05T12:34:56Z",

  "updateTime": "2023-07-05T12:34:56Z",

  "user": "users/21557",

  "role": "groups/7/roles/99513316"

}