L'API Directory fa parte dell'API RESTful Admin SDK che può essere utilizzata per creare e gestire in modo programmatico risorse controllate dall'amministratore di proprietà di un account Google Workspace. Ecco alcuni casi d'uso:
- Creazione e gestione degli utenti e aggiunta di amministratori.
- Creazione e gestione dei gruppi e delle 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 revocando le 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 capacità di un utente di eseguire un'azione su una risorsa Google Workspace. Si applica principalmente agli amministratori. Un privilegio è rappresentato dalla risorsa Privilegio.
- Ruolo
- Una raccolta definita di privilegi che può essere assegnata a un utente o a un insieme di utenti, rappresentata dalla risorsa Ruolo.
- Assegnazione del ruolo
- Un record che indica a quale utente sono stati assegnati 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, rappresentato dalla risorsa Schema.
- User
- Un singolo account utente finale con accesso alle app e alle risorse di Google Workspace, rappresentato dalla risorsa Utente.
Passaggi successivi
Per saperne di più sullo sviluppo con le API Google Workspace, inclusa la gestione dell'autenticazione e dell'autorizzazione, consulta Iniziare come sviluppatore di Workspace.
Per scoprire come configurare ed eseguire una semplice app dell'API Directory, prova la guida rapida di JavaScript.