*Questo contenuto è tradotto usando AI (Beta) e potrebbe contenere errori. Per visualizzare questa pagina in inglese, clicca qui.

GroupMembership

Un'adesione a un gruppo. Un ID utente può essere utilizzato invece di un ID di adesione.

Attributi

pathstring

Il percorso risorsa della membership del gruppo.

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

createTimestring
Solo output

L'timestamp quando la membership del gruppo è stata creata. Questa stringa è formattata come Timestamp.

updateTimestring
Solo output

L'timestamp quando l'adesione al gruppo è stata aggiornata per l'ultima volta. Questa stringa è formattata come Timestamp.

userstring
Immutabile

Il percorso risorsa di un membro del gruppo.

rolestring

Il percorso risorsa per il ruolo del membro del gruppo.

URL di base

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

Elenca le iscrizioni al gruppo
Beta

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

Elenca i membri del gruppo in un gruppo.

RichiestaParametri percorso
group_idstring
Necessario

L'ID del gruppo.

Parametri query
maxPageSizenumber

Il numero massimo di iscrizioni di gruppo da restituire.Il servizio potrebbe restituire meno di questo valore.Se non specificato, vengono restituiti al massimo 10 abbonamenti di gruppo.Il valore massimo è 100 e i valori più alti sono impostati su 100.

pageTokenstring

Un token di pagina, ricevuto da una chiamata precedente, per recuperare una pagina successiva.

Durante la paginazione, tutti gli altri parametri forniti alla chiamata successiva devono corrispondere alla chiamata che ha fornito il token della pagina.

filterstring

Questo campo può essere impostato per filtrare le risorse restituite.

Vedi la documentazione filtraggio per ulteriori informazioni.

Risposta

Un elenco di Gruppi di appartenenza nella collezione padre.

groupMembershipsarray<GroupMembership>

I GruppiMembri dal gruppo specificato.

nextPageTokenstring

Un token che puoi inviare come parametro pageToken per recuperare la pagina successiva. Se questo campo viene omesso, non ci sono pagine successive.

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}'
Risposta

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

Aggiorna la membership del gruppo
Beta

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

Aggiorna la membership del gruppo per un membro particolare del gruppo.Questa azione richiede che il richiedente sia in grado di gestire i membri di minor rango.Non è possibile assegnare i gradi Guest o Owner e un richiedente non può cambiare il proprio grado.

Campi
group:write
RichiestaParametri percorso
group_idstring
Necessario

L'ID del gruppo.

membership_idstring
Necessario

L'ID della membership.

Corpo della richiestaGroupMembership
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"
}'
Risposta

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