Scegli gli ambiti API rivenditore

Questo documento contiene informazioni di autorizzazione e autenticazione specifiche per l'API dei rivenditori. Prima di leggere questo documento, assicurati di leggere le informazioni generali su autenticazione e autorizzazione di Google Workspace nella pagina Scopri di più su autenticazione e autorizzazione.

Configurare OAuth 2.0 per l'autorizzazione

Configura la schermata per il consenso OAuth e scegli gli ambiti per definire le informazioni da mostrare a utenti e revisori di app e registra la tua app in modo da poterla pubblicare in un secondo momento.

Ambiti API dei rivenditori

Per definire il livello di accesso concesso alla tua app, devi identificare e dichiarare gli ambiti di autorizzazione. Un ambito di autorizzazione è una stringa URI OAuth 2.0 che contiene il nome dell'app Google Workspace, il tipo di dati a cui accede e il livello di accesso. Gli ambiti sono le richieste della tua app di utilizzo dei dati di Google Workspace, inclusi i dati dell'Account Google degli utenti.

Una volta installata l'app, all'utente viene chiesto di convalidare gli ambiti utilizzati dall'app. In genere, dovresti scegliere l'ambito più specifico possibile ed evitare di richiedere ambiti non richiesti dall'app. Gli utenti concedono più facilmente l'accesso ad ambiti limitati e chiaramente descritti.

L'API dei rivenditori supporta i seguenti ambiti:

Ambito Significato
https://www.googleapis.com/auth/apps.order Ambito globale per l'accesso a tutte le operazioni dell'API dei rivenditori.
https://www.googleapis.com/auth/admin.directory.user Ambito globale per l'accesso a tutte le operazioni di utenti e alias utente.
https://www.googleapis.com/auth/siteverification Ambito globale per l'accesso in lettura completo per i siti verificati esistenti e la possibilità di verificare i nuovi siti.