Questo documento contiene informazioni su autorizzazione e autenticazione specifiche per l'API Impostazioni amministratore. Prima di leggere questo documento, assicurati di leggere le informazioni generali su autenticazione e autorizzazione di Google Workspace all'indirizzo Scopri di più su autenticazione e autorizzazione.
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 per lavorare con i dati di Google Workspace, inclusi i dati dell'Account Google degli utenti.
Quando l'app è installata, a un utente viene chiesto di convalidare gli ambiti utilizzati dall'app. In genere, devi scegliere l'ambito più limitato possibile ed evitare di richiedere ambiti non necessari per la tua app. Gli utenti acconsentono più facilmente all'accesso ad ambiti limitati e descritti chiaramente.
L'API Admin Settings supporta i seguenti ambiti:
Ambiti
Significato
https://apps-apis.google.com/a/feeds/domain/
Ambito globale per l'accesso a tutte le impostazioni del dominio
[null,null,["Ultimo aggiornamento 2024-11-15 UTC."],[[["This document provides authorization and authentication details specifically for the Admin Settings API within Google Workspace."],["Before using this API, review Google Workspace's general authentication and authorization guidelines."],["Configure OAuth 2.0 including the consent screen and scopes to manage user data access for your app."],["Choose the most restrictive scopes necessary for your application's functionality to foster user trust."],["The Admin Settings API utilizes specific scopes, like `https://apps-apis.google.com/a/feeds/domain/`, to define access levels to domain settings."]]],["To access the Admin Settings API, configure OAuth 2.0 by setting up the consent screen and selecting authorization scopes, which define the level of data access. Scopes are OAuth 2.0 URI strings specifying the Google Workspace app, data type, and access level. Choose the narrowest scopes necessary for your app. Public apps using sensitive data-accessing scopes must undergo a verification process. The Admin Settings API supports one scope: `https://apps-apis.google.com/a/feeds/domain/` for global domain settings access.\n"]]
