L'API Directory fa parte dell'API SDK Admin RESTful che puoi utilizzare per creare e gestire in modo programmatico le risorse di proprietà di un account Google Workspace controllate dall'amministratore. Ecco alcuni casi d'uso:
- Creazione e gestione degli utenti e aggiunta di amministratori.
- Creazione e gestione di gruppi e appartenenze ai gruppi.
- Monitoraggio dei dispositivi connessi al tuo dominio e intervento sui dispositivi smarriti.
- Gestione dell'organigramma e delle strutture organizzative.
- Controllo delle applicazioni a cui gli utenti hanno concesso l'accesso e revoca delle app non autorizzate.
Di seguito è riportato un elenco dei termini comuni utilizzati nell'API Directory:
- Cliente
- L'entità proprietaria dell'account Google Workspace, rappresentata dalla risorsa Customer.
- 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 sotto-unità dell'albero organizzativo di un account Google Workspace, utilizzata per raggruppare e ordinare gli utenti allo scopo di applicare le norme e concedere le autorizzazioni. Un'UO è rappresentata dalla 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.
- Ruolo
- Una raccolta definita di privilegi che possono essere assegnati a un utente o a un insieme di utenti, rappresentata dalla risorsa Role.
- Assegnazione di ruolo
- Un record che indica a quale utente vengono concessi i ruoli e in quale ambito. Un'assegnazione di ruolo è rappresentata dalla RoleAssignment.
- Schema
- Un oggetto JSON che definisce gli attributi utente personalizzati per la tua organizzazione, rappresentato dalla risorsa Schema.
- Utente
- Un account utente individuale con accesso alle app e alle risorse di Google Workspace, rappresentato dalla risorsa User.
Passaggi successivi
Per scoprire di più sullo sviluppo con le API di Google Workspace, inclusa la gestione dell'autenticazione e dell'autorizzazione, consulta Inizia a utilizzare le API di Google Workspace.
Per scoprire come configurare ed eseguire un'app API Directory, prova la guida rapida di JavaScript.