Scegli gli ambiti API Google Drive Labels

Questo documento contiene informazioni su autorizzazione e autenticazione specifiche per l'API Drive Labels. Prima di leggere questo documento, assicurati di leggere le informazioni generali su autenticazione e autorizzazione di Google Workspace all'indirizzo Informazioni su autenticazione e autorizzazione.

Configurare OAuth 2.0 per l'autorizzazione

Configura la schermata per il consenso OAuth e scegli gli ambiti per definire quali informazioni vengono visualizzate dagli utenti e dai revisori delle app e registra la tua app in modo da poterla pubblicare in un secondo momento.

Ambiti dell'API Google Drive Labels

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 dell'app di utilizzare i dati di Google Workspace, inclusi i dati dell'Account Google degli utenti.

Quando l'app viene installata, all'utente viene chiesto di convalidare gli ambiti utilizzati dall'app. In genere, devi scegliere l'ambito più ristretto possibile ed evitare di richiedere ambiti che la tua app non richiede. Gli utenti concedono più facilmente l'accesso ad ambiti limitati e descritti chiaramente.

Quando possibile, consigliamo di utilizzare ambiti non sensibili, in quanto concedono l'ambito di accesso per file e limitano l'accesso a funzionalità specifiche necessarie a un'app.

I seguenti ambiti OAuth 2.0 possono essere utilizzati per leggere, cercare e modificare i metadati delle etichette applicate agli elementi di Drive:

Ambito Significato
  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.metadata
Leggi, cerca e modifica i metadati delle etichette applicate agli elementi di Drive.
  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive.metadata.readonly
Leggi e cerca i metadati delle etichette applicate agli elementi di Drive autorizzati per l'applicazione.

Per saperne di più, vedi Ambiti OAuth 2.0 dell'API Drive e Autorizzazione specifica dell'API Drive.

Ambiti per le etichette

Per visualizzare e gestire le etichette, puoi utilizzare i seguenti ambiti OAuth:

Ambito Significato
https://www.googleapis.com/auth/drive.labels Visualizzare, utilizzare e gestire le etichette di Drive.
  • Questo ambito consente l'accesso degli utenti ed è necessario per le operazioni di scrittura quando use_admin_access non è impostato.
  • Le operazioni di scrittura con questo ambito sono valide per le etichette con il SHARED tipo di etichetta.
https://www.googleapis.com/auth/drive.labels.readonly Visualizzare e utilizzare le etichette di Drive.
  • Questo ambito consente l'accesso degli utenti ed è necessario per le operazioni di lettura quando use_admin_access non è impostato.
https://www.googleapis.com/auth/drive.admin.labels Visualizzare, modificare, creare ed eliminare tutte le etichette di Drive della tua organizzazione, nonché visualizzare i criteri amministrativi correlati alle etichette della tua organizzazione.
  • Questo ambito consente l'accesso amministrativo ed è obbligatorio per le operazioni di scrittura quando è impostato use_admin_access. Questo ambito concede anche l'accesso in lettura.
  • Le operazioni di scrittura con questo ambito sono valide per le etichette con il SHARED o il ADMIN tipo di etichetta.
https://www.googleapis.com/auth/drive.admin.labels.readonly Visualizzare tutte le etichette di Drive e i criteri amministrativi correlati alle etichette della tua organizzazione.
  • Questo ambito consente l'accesso amministrativo ed è necessario per le operazioni di lettura quando è impostato use_admin_access.

Accesso come amministratore

Per gestire le etichette ADMIN, devi specificare:

  • useAdminAccess è true per utilizzare le credenziali di amministratore dell'utente.
  • Amministratori dell'account con il privilegio Gestione etichette.

useAdminAccess

Gli amministratori devono impostare il parametro useAdminAccess per richiamare i propri privilegi amministrativi. L'impostazione useAdminAccess consente la visualizzazione e la modifica di qualsiasi etichetta di proprietà di un cliente. Sono incluse sia le etichette ADMIN sia SHARED.

Quando useAdminAccess non è impostato, le richieste di scrittura sono consentite solo per le etichette con un SHARED label type e per gli utenti con il ruolo EDITOR appropriato per questa etichetta.

Per saperne di più, consulta Creare credenziali di accesso.