Panoramica dell'API Directory
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
L'API Directory fa parte dell'API Admin SDK RESTful che può essere utilizzata per
creare e gestire in modo programmatico le risorse controllate dall'amministratore di proprietà di un
account Google Workspace. Alcuni casi d'uso includono:
- Creazione e gestione degli utenti e aggiunta di amministratori.
- Creazione e gestione di gruppi e iscrizioni ai gruppi.
- Monitoraggio dei dispositivi connessi al tuo dominio e intervento sui dispositivi smarriti.
- Gestione dell'organigramma e delle strutture organizzative.
- Controllare le applicazioni a cui i tuoi utenti hanno concesso l'accesso e revocare
le app non autorizzate.
Di seguito è riportato un elenco di termini comuni utilizzati nell'API Directory:
- Cliente
- La persona giuridica proprietaria dell'account Google Workspace, rappresentata dalla risorsa
Cliente.
- Dominio
- Se applicabile, il dominio DNS associato a un account Google Workspace,
rappresentato dalla risorsa
Domain. Non tutti
gli account hanno un dominio associato.
- Unità organizzativa (UO)
- Una sottounità della struttura dell'organizzazione di un account Google Workspace, utilizzata per
raggruppare e ordinare gli utenti allo scopo di applicare criteri e concedere
autorizzazioni. Un'unità organizzativa è rappresentata dalla risorsa
OrgUnit.
- Privilegio
- La capacità di un utente di eseguire un'azione su una risorsa Google Workspace.
Si applica principalmente agli amministratori. Un privilegio è rappresentato dalla risorsa
Privilege.
- Role
- Una raccolta definita di privilegi che possono essere assegnati a un utente o a un insieme di
utenti, rappresentati dalla risorsa
Ruolo.
- Assegnazione dei ruoli
- Un record che indica a quale utente vengono concessi quali ruoli e in quale ambito.
Un'assegnazione di ruolo è rappresentata dalla risorsa
RoleAssignment.
- Schema
- Un oggetto JSON che definisce gli attributi utente personalizzati per la tua organizzazione, rappresentati dalla risorsa Schema.
- Utente
- Un account utente finale individuale con accesso alle app e alle risorse di Google Workspace, rappresentato dalla risorsa Utente.
Passaggi successivi
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-08-29 UTC.
[null,null,["Ultimo aggiornamento 2025-08-29 UTC."],[],[],null,["# Directory API Overview\n\n|-------------------------------------------------------------------------------------------------------------------------------------------|\n| Got 5 minutes? Help us improve our Google Workspace documentation by taking a quick [online survey](https://forms.gle/XcqRP3PJiQv9ADuj9). |\n\nThe Directory API is part of the RESTful Admin SDK API that can be used to\nprogrammatically create and manage admin-controlled resources owned by a\nGoogle Workspace account. Some use cases include:\n\n- Creating and managing users and adding administrators.\n- Creating and managing groups and group memberships.\n- Monitoring devices connected to your domain and taking action on lost devices.\n- Managing your org chart and organization structures.\n- Auditing applications your users have granted access to and revoking unauthorized apps.\n\nFollowing is a list of common terms used in the Directory API:\n\n*Customer*\n: The entity that owns the Google Workspace account, represented by the\n [Customer](/workspace/admin/directory/reference/rest/v1/customers) resource.\n\n*Domain*\n: If applicable, the DNS domain associated with a Google Workspace account,\n represented by the\n [Domain](/workspace/admin/directory/reference/rest/v1/domains) resource. Not all\n accounts have an associated domain.\n\n*Organizational unit (OU)*\n: A sub-unit of a Google Workspace account's organizational tree, used to\n group and sort users for the purpose of applying policies and granting\n authorizations. An OU is represented by the\n [OrgUnit](/workspace/admin/directory/reference/rest/v1/orgunits) resource.\n\n*Privilege*\n: The ability of a user to perform an action on a Google Workspace resource.\n Applies primarily to admins. A privilege is represented by the\n [Privilege](/workspace/admin/directory/reference/rest/v1/privileges/list#Privilege)\n resource.\n\n*Role*\n: A defined collection of privileges that can be assigned to a user or set of\n users, represented by the\n [Role](/workspace/admin/directory/reference/rest/v1/roles) resource.\n\n*Role assignment*\n: A record indicating which user is granted what roles, and over what scope.\n A role assignment is represented by the\n [RoleAssignment](/workspace/admin/directory/reference/rest/v1/roleAssignments)\n resource.\n\n*Schema*\n: A JSON object that defines custom user attributes for your organization,\n represented by the\n [Schema](/workspace/admin/directory/reference/rest/v1/schemas) resource.\n\n*User*\n: An individual end user account with access to Google Workspace apps and\n resources, represented by the\n [User](/workspace/admin/directory/reference/rest/v1/users) resource.\n\nNext steps\n----------\n\n- To learn about developing with Google Workspace APIs, including handling\n authentication and authorization, refer to\n [Get started as a Workspace developer](/workspace/guides/getstarted-overview).\n\n- To learn how to configure and run a simple Directory API app, try the\n [JavaScript quickstart](/workspace/admin/directory/v1/quickstart/js)."]]
