*이 콘텐츠는 AI(베타)를 사용해 번역되었으며, 오류가 있을 수 있습니다. 이 페이지를 영어로 보려면 여기를 클릭하세요.

GroupRole

그룹 내 멤버에게 특정 권한을 부여하는 구성 가능한 속성.

특성

pathstring

그룹 역할의 리소스 경로.

형식: groups/{group_id}/roles/{group_role_id}.

createTimestring

출력 전용

그룹 역할이 마지막으로 업데이트된 시간의 타임스탬프.

그룹 소유자에게만 표시됩니다. 이 문자열은 Timestamp 형식으로 지정됩니다.

updateTimestring

출력 전용

그룹 역할이 마지막으로 업데이트된 시간.

그룹 소유자에게만 표시됩니다. 이 문자열은 Timestamp 형식으로 지정됩니다.

idstring

출력 전용

역할을 식별하는 고유 ID.

그룹 내에서만 유일한 역할의 순위와 구별됩니다. Distinct from a role's rank, which is only unique within the group.

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

List Group Roles
베타

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

그룹에서 역할 목록을 나열합니다.

역할의 권한 필드는 요청자의 액세스 및 범위에 따라 볼 수 있습니다.

게스트 역할의 권한은 항상 표시되며 범위가 필요하지 않습니다.

요청자가 그룹의 멤버이고 group:read범위를 가지고 있으면 역할의 권한이 표시됩니다.

요청자가 그룹의 소유자이고 group:read 범위를 가지고 있으면 모든 역할의 권한이 표시됩니다.

요청경로 매개 변수

group_idstring

필수

그룹 ID.

쿼리 매개 변수

maxPageSizenumber

반환할 그룹 역할 최대 수.서비스는 이 값보다 적은 값을 반환할 수 있습니다.지정되지 않으면 최대 10개의 그룹 역할이 반환됩니다.최대 값은 20이고 더 높은 값은 20으로 설정됩니다.

pageTokenstring

이전 호출에서 받은 페이지 토큰으로, 이후 페이지를 검색합니다.

페이징할 때 후속 호출에 제공된 모든 다른 매개변수는 페이지 토큰을 제공한 호출과 일치해야 합니다.

응답

부모 컬렉션의 GroupRoles 목록.

groupRolesarray<GroupRole>

지정된 그룹의 GroupRoles.

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

Get Group Role
베타

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

그룹 역할 가져오기

요청경로 매개 변수

group_idstring

필수

그룹 ID.

role_idstring

필수

역할 ID.

응답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
  }
}

GroupRole

특성

GroupRole

List Group Roles베타

GroupRole

Get Group Role베타

List Group Roles
베타

Get Group Role
베타