Con đường tài nguyên của vai trò nhóm.
Định dạng: groups/{group_id}/roles/{group_role_id}.
*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.
GroupRole
Một thuộc tính có thể cấu hình để cấp quyền cụ thể cho các thành viên trong nhóm.
Thuộc Tính
Thời gian đánh dấu khi vai trò nhóm cuối cùng được cập nhật.
Chỉ hiển thị cho chủ nhân của nhóm. Chuỗi này được định dạng là Dấu thời gian.
Thời gian chính xác khi vai trò nhóm được cập nhật lần cuối.
Chỉ hiển thị cho chủ nhân của nhóm. Chuỗi này được định dạng là Dấu thời gian.
Một ID duy nhất xác định một vai trò.
Khác với thứ hạng của một vai trò, chỉ duy nhất trong nhóm.
Tên của vai trò.
Có giới hạn tối đa 100 ký tự. Các tên vượt giới hạn bị từ chối.
Mô tả về vai trò.
Có giới hạn tối đa 1000 ký tự. Các chuỗi vượt giới hạn bị từ chối. Chỉ có chủ nhân của nhóm có thể nhìn thấy.
Xếp hạng của vai trò.
Giá trị tối thiểu là 0. Giá trị tối đa là 255.
Tổng số thành viên trong một vai trò.
Trường này không được trả lại cho vai trò khách.
Các quyền được cấp cho vai trò này.
Giá trị này được lấp đầy dựa trên phạm vi đọc và vai trò của người dùng được ủy quyền hoặc nhà sáng tạo chìa khóa API.Nếu người dùng hoặc người tạo là chủ sở hữu của nhóm cha, họ có thể xem tất cả các quyền vai trò trong nhóm.Nếu người dùng hoặc nhà sáng tạo là thành viên của nhóm cha, họ có thể xem các quyền của vai trò của họ trong nhóm.Bất cứ ai cũng có thể xem quyền truy cập khách.Trong trường hợp ai đó không thể xem các quyền, trường này không được trả về.
URL Cơ Sở
https://apis.roblox.comTài nguyên GroupRole
{
"path": "groups/123/roles/123",
"createTime": "2023-07-05T12:34:56Z",
"updateTime": "2023-07-05T12:34:56Z",
"id": "200",
"displayName": "Member",
"description": "This is a description for the role",
"rank": 1,
"memberCount": 10223136,
"permissions": {
"viewWallPosts": true,
"createWallPosts": true,
"deleteWallPosts": true,
"viewGroupShout": true,
"createGroupShout": true,
"changeRank": true,
"acceptRequests": true,
"exileMembers": true,
"manageRelationships": true,
"viewAuditLog": true,
"spendGroupFunds": true,
"advertiseGroup": true,
"createAvatarItems": true,
"manageAvatarItems": true,
"manageGroupUniverses": true,
"viewUniverseAnalytics": true,
"createApiKeys": true,
"manageApiKeys": true,
"banMembers": true,
"viewForums": true,
"manageCategories": true,
"createPosts": true,
"lockPosts": true,
"pinPosts": true,
"removePosts": true,
"createComments": true,
"removeComments": true
}
}GroupRole
List Group Roles
GET /cloud/v2/groups/{group_id}/roles
Danh sách vai trò trong một nhóm.
Trường quyền cho vai trò có thể xem dựa trên quyền truy cập và phạm vi của người yêu cầu.
Các quyền cho vai trò khách luôn luôn hiển thị - một phạm vi không cần thiết.
Nếu người yêu cầu là thành viên của nhóm và có phạm vi group:read, quyền trong vai trò của họ được hiển thị.
Nếu người yêu cầu là chủ sở hữu của nhóm và có phạm vi group:read, quyền trong tất cả các vai trò đều có thể nhìn thấy.
ID nhóm.
Số nhóm vai trò tối đa để 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 vai trò nhóm được trả về.Giá trị tối đa là 20 và giá trị cao hơn được đặt thành 20.
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.
Phản HồigroupRolesarray<GroupRole> nextPageTokenstring
Một danh sách các vai trò Nhóm trong bộ sưu tập cha.
Các vai trò nhóm từ nhóm được chỉ định.
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}/roles
curl -L -X GET 'https://apis.roblox.com/cloud/v2/groups/{group_id}/roles?maxPageSize=10&pageToken={string}' \
-H 'x-api-key: {your-api-key}'Phản Hồi
{
"groupRoles": [
{
"path": "groups/123/roles/123",
"createTime": "2023-07-05T12:34:56Z",
"updateTime": "2023-07-05T12:34:56Z",
"id": "200",
"displayName": "Member",
"description": "This is a description for the role",
"rank": 1,
"memberCount": 10223136,
"permissions": {
"viewWallPosts": true,
"createWallPosts": true,
"deleteWallPosts": true,
"viewGroupShout": true,
"createGroupShout": true,
"changeRank": true,
"acceptRequests": true,
"exileMembers": true,
"manageRelationships": true,
"viewAuditLog": true,
"spendGroupFunds": true,
"advertiseGroup": true,
"createAvatarItems": true,
"manageAvatarItems": true,
"manageGroupUniverses": true,
"viewUniverseAnalytics": true,
"createApiKeys": true,
"manageApiKeys": true,
"banMembers": true,
"viewForums": true,
"manageCategories": true,
"createPosts": true,
"lockPosts": true,
"pinPosts": true,
"removePosts": true,
"createComments": true,
"removeComments": true
}
}
],
"nextPageToken": "string"
}GroupRole
Get Group Role
GET /cloud/v2/groups/{group_id}/roles/{role_id}
Nhận vai trò nhóm
ID nhóm.
ID nhập vai.
Phản HồiGroupRole
GET /cloud/v2/groups/{group_id}/roles/{role_id}
curl -L -X GET 'https://apis.roblox.com/cloud/v2/groups/{group_id}/roles/{role_id}' \
-H 'x-api-key: {your-api-key}'Phản Hồi
{
"path": "groups/123/roles/123",
"createTime": "2023-07-05T12:34:56Z",
"updateTime": "2023-07-05T12:34:56Z",
"id": "200",
"displayName": "Member",
"description": "This is a description for the role",
"rank": 1,
"memberCount": 10223136,
"permissions": {
"viewWallPosts": true,
"createWallPosts": true,
"deleteWallPosts": true,
"viewGroupShout": true,
"createGroupShout": true,
"changeRank": true,
"acceptRequests": true,
"exileMembers": true,
"manageRelationships": true,
"viewAuditLog": true,
"spendGroupFunds": true,
"advertiseGroup": true,
"createAvatarItems": true,
"manageAvatarItems": true,
"manageGroupUniverses": true,
"viewUniverseAnalytics": true,
"createApiKeys": true,
"manageApiKeys": true,
"banMembers": true,
"viewForums": true,
"manageCategories": true,
"createPosts": true,
"lockPosts": true,
"pinPosts": true,
"removePosts": true,
"createComments": true,
"removeComments": true
}
}