Method: roles.get

Récupère un rôle.

Requête HTTP

GET https://admin.googleapis.com/admin/directory/v1/customer/{customer}/roles/{roleId}

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
customer

string

Identifiant unique du compte Google Workspace du client. Dans le cas d'un compte multidomaine, utilisez ce champ à la place de domain pour récupérer tous les groupes d'un client. Vous pouvez également utiliser l'alias my_customer pour représenter le customerId de votre compte. Le customerId est également renvoyé dans la ressource Users. Vous devez indiquer le paramètre customer ou domain.

roleId

string

ID immuable du rôle.

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une instance de Role.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • https://www.googleapis.com/auth/admin.directory.rolemanagement
  • https://www.googleapis.com/auth/admin.directory.rolemanagement.readonly

Pour en savoir plus, consultez le guide relatif aux autorisations.