Method: orgunits.list

Recupera un elenco di tutte le unità organizzative di un account.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
customerId

string

L'ID univoco dell'account Google Workspace del cliente. In qualità di amministratore dell'account, puoi anche utilizzare l'alias my_customer per rappresentare i customerId del tuo account. customerId viene restituito anche nell'ambito della risorsa Utenti.

Parametri di query

Parametri
orgUnitPath

string

Il percorso completo dell'unità organizzativa o il relativo ID univoco. Restituisce gli elementi secondari dell'unità organizzativa specificata.

type

enum (Type)

Indica se restituire tutte le organizzazioni secondarie o solo gli elementi secondari immediati.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON
{
  "kind": string,
  "etag": string,
  "organizationUnits": [
    {
      object (OrgUnit)
    }
  ]
}
Campi
kind

string

Il tipo di risorsa API. Per le risorse dell'unità organizzativa, il tipo è admin#directory#orgUnits.

etag

string

ETag della risorsa.

organizationUnits[]

object (OrgUnit)

Un elenco di oggetti di unità organizzative.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • 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

Per ulteriori informazioni, consulta la Guida all'autorizzazione.

Tipo

Enum
ALL Tutte le unità organizzative secondarie.
CHILDREN Solo bambini immediati (impostazione predefinita).
ALL_INCLUDING_PARENT Tutte le unità organizzative secondarie e l'unità organizzativa specificata (radice se non specificata).