Il percorso risorsa del ruolo di gruppo.
Formato: groups/{group_id}/roles/{group_role_id}.
*Questo contenuto è tradotto usando AI (Beta) e potrebbe contenere errori. Per visualizzare questa pagina in inglese, clicca qui.
GroupRole
Una proprietà configurabile per concedere privilegi specifici ai membri all'interno di un gruppo.
Attributi
L'timestamp per quando il ruolo del gruppo è stato aggiornato per l'ultima volta.
Visibile solo ai proprietari del gruppo. Questa stringa è formattata come Timestamp.
L'timestamp quando il ruolo del gruppo è stato aggiornato per l'ultima volta.
Visibile solo ai proprietari del gruppo. Questa stringa è formattata come Timestamp.
Un ID univoco che identifica un ruolo.
Distinto dal grado di un ruolo, che è unico solo all'interno del gruppo.
Il nome del ruolo.
Ha un limite massimo di 100 caratteri. I nomi sopra il limite vengono rifiutati.
La descrizione del ruolo.
Ha un limite massimo di 1000 caratteri. Le stringhe al di sopra del limite vengono rifiutate. Visibile solo ai proprietari del gruppo.
Il grado del ruolo.
Il valore minimo è 0. Il valore massimo è 255.
Numero totale di membri all'interno di un ruolo.
Questo campo non viene restituito per i ruoli ospiti.
Le autorizzazioni concesse per questo ruolo.
Questo valore viene riempito in base alla scala di lettura e al ruolo dell'utente autorizzato o creatore della chiave API.Se l'utente o il creatore è il proprietario del gruppo padre, è in grado di visualizzare tutte le autorizzazioni di ruolo nel gruppo.Se l'utente o il creatore è un membro del gruppo padre, è in grado di visualizzare le autorizzazioni del loro ruolo nel gruppo.Chiunque può visualizzare le autorizzazioni degli ospiti.Nel caso in cui qualcuno non possa visualizzare le autorizzazioni, questo campo non viene restituito.
URL di base
https://apis.roblox.comRisorsa 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
Ruoli di gruppo di lista
GET /cloud/v2/groups/{group_id}/roles
Elenca i ruoli in un gruppo.
Il campo delle autorizzazioni per i ruoli è visualizzabile in base all'accesso e alle scoperte del richiedente.
Le autorizzazioni per il ruolo ospite sono sempre visibili - non è necessaria una scala.
Se il richiedente è un membro del gruppo e ha la scoperta group:read , le autorizzazioni nel loro ruolo sono visibili.
Se il richiedente è il proprietario del gruppo e ha la scoperta group:read , le autorizzazioni in tutti i ruoli sono visibili.
L'ID del gruppo.
Il numero massimo di ruoli di gruppo da restituire.Il servizio potrebbe restituire meno di questo valore.Se non specificato, vengono restituiti al massimo 10 ruoli di gruppo.Il valore massimo è 20 e i valori più alti sono impostati su 20.
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.
RispostagroupRolesarray<GroupRole> nextPageTokenstring
Un elenco di ruoli di gruppo nella collezione padre.
I ruoli di gruppo dal gruppo specificato.
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}/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}'Risposta
{
"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
Ottieni il ruolo di gruppo
GET /cloud/v2/groups/{group_id}/roles/{role_id}
Ottieni il ruolo del gruppo
L'ID del gruppo.
L'ID ruolo.
RispostaGroupRole
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}'Risposta
{
"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
}
}