L'API Directory fa parte dell'API SDK Admin RESTful che può essere utilizzata 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 di utenti e aggiunta di amministratori.
- Creazione e gestione di gruppi e iscrizioni ai gruppi.
- Monitoraggio dei dispositivi connessi al tuo dominio e intervento in caso di dispositivi smarriti.
- Gestire l'organigramma e le strutture dell'organizzazione.
- Controllare le applicazioni a cui gli utenti hanno concesso l'accesso e revocare quelle 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 (OU)
- Una suddivisione della struttura dell'organizzazione di un account Google Workspace, utilizzata per raggruppare e ordinare gli utenti al fine di applicare criteri e concedere autorizzazioni. Una UO è rappresentata dalla risorsa OrgUnit.
- Privilegio
- La possibilità di un utente di eseguire un'azione su una risorsa di Google Workspace. Si applica principalmente agli amministratori. Un privilegio è rappresentato dalla risorsa Privilegio.
- Role
- Una raccolta definita di privilegi che possono essere assegnati a un utente o a un insieme di utenti, rappresentati dalla risorsa Ruolo.
- Assegnazione del ruolo
- Un record che indica a quale utente sono assegnati quali ruoli e in quale ambito. Un'assegnazione del 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
Per scoprire di più sullo sviluppo con le API Google Workspace, inclusa la gestione dell'autenticazione e dell'autorizzazione, consulta Iniziare a utilizzare Workspace come sviluppatore.
Per scoprire come configurare ed eseguire una semplice app dell'API Directory, prova la guida introduttiva di JavaScript.