*เนื้อหานี้แปลโดยใช้ AI (เวอร์ชัน Beta) และอาจมีข้อผิดพลาด หากต้องการดูหน้านี้เป็นภาษาอังกฤษ ให้คลิกที่นี่

GroupRole

คุณสมบัติที่สามารถปรับแต่งได้เพื่อให้สิทธิ์พิเศษแก่สมาชิกภายในกลุ่ม

คุณลักษณะ

pathstring

เส้นทางทรัพยากรของบทบาทกลุ่ม

รูปแบบ: groups/{group_id}/roles/{group_role_id}.

createTimestring
เอาต์พุตเท่านั้น

เวลาที่บทบาทกลุ่มได้รับการปรับปรุงล่าสุด

มองเห็นได้เฉพาะเจ้าของกลุ่มเท่านั้น. สตริงนี้มีรูปแบบประทับเวลา

updateTimestring
เอาต์พุตเท่านั้น

เวลาที่บทบาทกลุ่มได้รับการปรับปรุงล่าสุด

มองเห็นได้เฉพาะเจ้าของกลุ่มเท่านั้น. สตริงนี้มีรูปแบบประทับเวลา

idstring
เอาต์พุตเท่านั้น

ID ที่ไม่ซ้ำกันที่ระบุบทบาท

แตกต่างจากอันดับบทบาทซึ่งมีเฉพาะในกลุ่มเท่านั้น.

displayNamestring

ชื่อบทบาท

มีขีดจํากัดสูงสุด 100 ตัวอักษร ชื่อที่อยู่เหนือขีดจํากัดถูกปฏิเสธ.

descriptionstring

คำอธิบายบทบาท

มีขีดจํากัดสูงสุด 1000 ตัวอักษร สตริงที่อยู่เหนือขีดจํากัดถูกปฏิเสธ มองเห็นได้เฉพาะเจ้าของกลุ่มเท่านั้น.

ranknumber

อันดับของบทบาท

มูลค่าขั้นต่ำคือ 0 มูลค่าสูงสุดคือ 255.

memberCountnumber
เอาต์พุตเท่านั้น

จํานวนสมาชิกทั้งหมดภายในบทบาท

ฟิลด์นี้ไม่ถูกส่งคืนสำหรับบทบาทแขก.

permissionsobject

สิทธิ์ที่ได้รับสำหรับบทบาทนี้

ค่านี้จะถูกเติมขึ้นตามขอบเขตการอ่านและบทบาทของผู้ใช้ที่ได้รับอนุญาตหรือผู้สร้างคีย์ APIหากผู้ใช้หรือผู้สร้างเป็นเจ้าของกลุ่มพ่อแม่ พวกเขาสามารถดูสิทธิบทบาททั้งหมดในกลุ่มได้หากผู้ใช้หรือผู้สร้างเป็นสมาชิกของกลุ่มแม่ พวกเขาสามารถดูสิทธิ์บทบาทของพวกเขาในกลุ่มได้ทุกคนสามารถดูสิทธิ์ของแขกได้ในกรณีที่บางคนไม่สามารถดูสิทธิ์ได้ ฟิลด์นี้จะไม่ถูกส่งคืน.

URL หลัก

https://apis.roblox.com
แหล่งข้อมูล 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

รายการบทบาทกลุ่ม
เวอร์ชัน Beta

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

ระบุบทบาทในกลุ่ม

ฟิลด์สิทธิ์สำหรับบทบาทสามารถดูได้ตามการเข้าถึงและขอบเขตของผู้ร้องขอ

สิทธิ์สำหรับบทบาทแขกจะมองเห็นได้เสมอ - ไม่จำเป็นต้องใช้ขอบเขต

หากผู้ร้องขอเป็นสมาชิกของกลุ่มและมีขอบเขต group:read สิทธิ์ในบทบาทของพวกเขาจะปรากฏให้เห็น

หากผู้ร้องขอเป็นเจ้าของกลุ่มและมีขอบเขต group:read สิทธิ์ในบทบาททั้งหมดจะปรากฏให้เห็น

การจำกัด
  • คีย์ API: 300 คำขอต่อนาทีสำหรับคีย์ API ทั้งหมดสำหรับผู้ใช้หรือกลุ่ม
  • OAuth 2.0: 90 คำขอต่อนาทีต่อผู้ใช้แอป

หมายเหตุ: อัตราสูงสุดอาจต่ำกว่านี้ในช่วงที่มีการใช้งานสูง บาง Endpoints มีอัตราสูงสุดเพิ่มเติม เรียนรู้เพิ่มเติมเกี่ยวกับอัตราสูงสุด

คำขอพารามิเตอร์เส้นทาง
group_idstring
จำเป็นต้องมี

ID กลุ่ม.

พารามิเตอร์คิวรี
maxPageSizenumber

จํานวนบทบาทกลุ่มสูงสุดที่จะส่งคืนบริการอาจ返回值น้อยกว่านี้หากไม่ได้ระบุ บทบาทกลุ่มสูงสุด 10 บทบาทจะถูกส่งคืนมูลค่าสูงสุดคือ 20 และมูลค่าที่สูงกว่าจะถูกตั้งเป็น 20.

pageTokenstring

โทเค็นหน้าที่ได้รับจากการโทรก่อนหน้านี้เพื่อดึงหน้าต่อไป

เมื่อจัดหน้า พารามิเตอร์อื่น ๆ ทั้งหมดที่ให้กับการโทรต่อไปจะต้องตรงกับการโทรที่ให้โทเค็นหน้า.

การตอบกลับ

รายการบทบาทกลุ่มในคอลเลกชันรากฐาน

groupRolesarray<GroupRole>

บทบาทกลุ่มจากกลุ่มที่ระบุ.

nextPageTokenstring

โทเคนที่คุณสามารถส่งเป็นพารามิเตอร์ pageToken เพื่อดึงหน้าถัดไป หากฟิลด์นี้ถูกข้ามไป จะไม่มีหน้าต่อไป.

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}'
การตอบกลับ

{
"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

รับบทบาทกลุ่ม
เวอร์ชัน Beta

GET /cloud/v2/groups/{group_id}/roles/{role_id}

รับบทบาทกลุ่ม

การจำกัด
  • คีย์ API: 300 คำขอต่อนาทีสำหรับคีย์ API ทั้งหมดสำหรับผู้ใช้หรือกลุ่ม
  • OAuth 2.0: 90 คำขอต่อนาทีต่อผู้ใช้แอป

หมายเหตุ: อัตราสูงสุดอาจต่ำกว่านี้ในช่วงที่มีการใช้งานสูง บาง Endpoints มีอัตราสูงสุดเพิ่มเติม เรียนรู้เพิ่มเติมเกี่ยวกับอัตราสูงสุด

คำขอพารามิเตอร์เส้นทาง
group_idstring
จำเป็นต้องมี

ID กลุ่ม.

role_idstring
จำเป็นต้องมี

รหัสบทบาท.

การตอบกลับGroupRole
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}'
การตอบกลับ

{
"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
}
}