*Ta zawartość została przetłumaczona przy użyciu narzędzi AI (w wersji beta) i może zawierać błędy. Aby wyświetlić tę stronę w języku angielskim, kliknij tutaj.

GroupMembership

Członkostwo w grupie. ID użytkownika może zostać użyte w miejsce ID członkostwa.

Atrybuty

pathstring

Ścieżka zasobów członkostwa grupy.

Format: groups/{group_id}/memberships/{group_membership_id}.

createTimestring
Tylko dane wyjściowe

Data i czas utworzenia członkostwa w grupie. Ten ciąg jest sformatowany jako Timestamp.

updateTimestring
Tylko dane wyjściowe

Data i czas aktualizacji członkostwa w grupie po raz ostatni. Ten ciąg jest sformatowany jako Timestamp.

userstring
Nieodwołalny

Ścieżka zasobów członka grupy.

rolestring

Ścieżka zasobów dla roli członka grupy.

Podstawowy adres URL

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

Lista członkostw grupowych
Beta

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

Wyświetl członków grupy w grupie.

ŻądanieParametry ścieżki
group_idstring
Wymagane

Identyfikator grupy.

Parametry zapytania
maxPageSizenumber

Maksymalna liczba członkostw grupowych do zwrotu.Usługa może zwrócić mniej niż tę wartość.Jeśli nie określono, zwracane jest maksymalnie 10 członkostw grupowych.Maksymalna wartość wynosi 100, a wyższe wartości są ustawione na 100.

pageTokenstring

Żeton strony, otrzymany z poprzedniego wezwania, aby odzyskać następną stronę.

Podczas paginowania wszystkie pozostałe parametry dostarczone do następnego wezwania muszą pasować do wezwania, które dostarczyło token strony.

filterstring

Pole to można ustawić w celu filtrowania zasobów zwrotnych.

Zobacz dokumentację filtrowania dla więcej informacji.

Odpowiedź:

Lista członkostw grupowych w kolekcji macierzystej.

groupMembershipsarray<GroupMembership>

Członkostwo w grupie z określonej grupy.

nextPageTokenstring

Token, który możesz wysłać jako parametr pageToken w celu odzyskania następnej strony. Jeśli to pole zostanie pominięte, nie ma następnych stron.

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}'
Odpowiedź:

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

Aktualizacja członkostwa w grupie
Beta

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

Aktualizuje członkostwo w grupie dla określonego członka grupy.Akcja ta wymaga, aby wnioskodawca mógł zarządzać członkami o niższej randze.Nie można przypisać rangi gościa lub właściciela, a wnioskodawca nie może zmienić własnej rangi.

Zakresy
group:write
ŻądanieParametry ścieżki
group_idstring
Wymagane

Identyfikator grupy.

membership_idstring
Wymagane

ID członkostwa.

Treść żądaniaGroupMembership
Odpowiedź: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"
}'
Odpowiedź:

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