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 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.
- 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 Cliente.
- Dominio
- Se applicabile, il dominio DNS associato a un account Google Workspace, rappresentato dalla risorsa Dominio. Non tutti gli account hanno un dominio associato.
- Unità organizzativa (UO)
- Una sottounità della struttura organizzativa di un account Google Workspace, utilizzata per raggruppare e ordinare gli utenti allo scopo 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 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 del ruolo
- Un record che indica a quale utente vengono assegnati determinati ruoli e l'ambito di applicazione. Un'assegnazione del ruolo è rappresentata dalla risorsa RoleAssignment.
- Schema
- Un oggetto JSON che definisce attributi utente personalizzati per la tua organizzazione, rappresentato dalla risorsa Schema.
- User
- Un account utente finale individuale con accesso alle app e alle risorse di Google Workspace, rappresentato dalla risorsa Utente.
Passaggi successivi
Per informazioni sullo sviluppo con le API Google Workspace, inclusa la gestione dell'autenticazione e dell'autorizzazione, consulta Iniziare come sviluppatore Workspace.
Per scoprire come configurare ed eseguire una semplice app per l'API Directory, prova la guida rapida di JavaScript.