Method: orgunits.list

Récupère la liste de toutes les unités organisationnelles d'un compte.

Requête HTTP

GET https://admin.googleapis.com/admin/directory/v1/customer/{customerId}/orgunits

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
customerId

string

Identifiant unique du compte Google Workspace du client. En tant qu'administrateur de compte, vous pouvez également utiliser l'alias my_customer pour représenter le customerId de votre compte. customerId est également renvoyé dans la ressource "Users".

Paramètres de requête

Paramètres
orgUnitPath

string

Chemin d'accès complet de l'unité organisationnelle ou ID unique de l'UO. Renvoie les enfants de l'unité organisationnelle spécifiée.
type

enum (Type)

Indique si toutes les sous-organisations doivent être renvoyées ou seulement les enfants immédiats.

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 des données présentant la structure suivante :

Représentation JSON 
{
  "kind": string,
  "etag": string,
  "organizationUnits": [
    {
      object (OrgUnit)
    }
  ]
}
Champs
kind

string

Type de la ressource d'API. Pour les ressources d'unité organisationnelle, le type est admin#directory#orgUnits.
etag

string

ETag de la ressource.
organizationUnits[]

object (OrgUnit)

Liste d'objets d'unités organisationnelles.

Champs d'application des autorisations

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

  • https://apps-apis.google.com/a/feeds/policies/
  • https://www.googleapis.com/auth/admin.directory.orgunit
  • https://www.googleapis.com/auth/admin.directory.orgunit.readonly

Pour en savoir plus, consultez le guide d'autorisation.

Type

Enums
ALL Toutes les sous-unités organisationnelles.
CHILDREN Enfants immédiats uniquement (par défaut)
ALL_INCLUDING_PARENT Toutes les sous-unités organisationnelles et l'unité organisationnelle spécifiée (racine si elle n'est pas spécifiée).