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

GroupMembership

그룹에 대한 회원권. 사용자 ID는 회원권 ID 대신 사용할 수 있습니다.

특성

pathstring

그룹 멤버십의 리소스 경로.

형식: groups/{group_id}/memberships/{group_membership_id}.

createTimestring
출력 전용

그룹 회원 자격이 생성된 시점의 타임스탬프. 이 문자열은 Timestamp 형식으로 지정됩니다.

updateTimestring
출력 전용

그룹 회원권이 마지막으로 업데이트된 시점의 타임스탬프. 이 문자열은 Timestamp 형식으로 지정됩니다.

userstring
불변

그룹의 멤버의 리소스 경로.

rolestring

그룹 멤버의 리소스 경로.

기본 URL

https://apis.roblox.com
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

그룹 멤버십 목록
베타

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

그룹에서 그룹 멤버를 목록으로 나열합니다.

요청경로 매개 변수
group_idstring
필수

그룹 ID.

쿼리 매개 변수
maxPageSizenumber

반환할 그룹 멤버 최대 수.서비스는 이 값보다 적은 값을 반환할 수 있습니다.지정되지 않으면 최대 10개의 그룹 구성원이 반환됩니다.최대 값은 100이며 더 높은 값은 100으로 설정됩니다.

pageTokenstring

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

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

filterstring

이 필드는 반환된 리소스를 필터링하기 위해 설정될 수 있습니다.

자세한 내용은 필터링 문서를 참조하십시오.

응답

부모 컬렉션의 GroupMemberships 목록.

groupMembershipsarray<GroupMembership>

지정된 그룹의 GroupMemberships.

nextPageTokenstring

다음 페이지를 검색하기 위해 pageToken 매개변수로 보낼 수 있는 토큰입니다. 이 필드가 생략되면 후속 페이지가 없습니다.

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

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

그룹 회원 업데이트
베타

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

특정 그룹 멤버의 그룹 회원권을 업데이트합니다.이 작업에는 요청자가 하위 순위의 멤버를 관리할 수 있어야 합니다.게스트 또는 소유자 등급을 할당할 수 없으며 요청자는 자신의 등급을 변경할 수 없습니다.

범위
group:write
요청경로 매개 변수
group_idstring
필수

그룹 ID.

membership_idstring
필수

멤버십 ID.

요청 본문GroupMembership
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"
}'
응답

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