L'API Directory fa parte dell'API RESTful Admin SDK 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 di 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.
- Gestire l'organigramma e le strutture dell'organizzazione.
- Controllo delle applicazioni a cui gli utenti hanno concesso l'accesso e la revoca delle app non autorizzate.
Di seguito è riportato un elenco dei 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 dominio. Non tutti gli account sono associati a un dominio.
- Unità organizzativa (UO)
- Una sottounità della struttura organizzativa di un account Google Workspace, utilizzata per raggruppare e ordinare gli utenti allo scopo di applicare i criteri e concedere le 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.
- Ruolo
- 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 stati concessi i ruoli e l'ambito di applicazione. Un'assegnazione di ruolo è rappresentata dalla risorsa RoleRole.
- Schema
- Un oggetto JSON che definisce gli attributi utente personalizzati per la tua organizzazione, rappresentati dalla risorsa Schema.
- Utente
- Un account utente individuale con accesso alle app e alle risorse di Google Workspace, rappresentato dalla risorsa Utente.
Passaggi successivi
Per scoprire come sviluppare con le API di Google Workspace, inclusa la gestione di autenticazione e autorizzazione, consulta la pagina Inizia come sviluppatore di Workspace.
Per scoprire come configurare ed eseguire una semplice app API Directory, prova la guida rapida di JavaScript.