La sezione delle credenziali di Explorer API ti consente di testare credenziali e ambiti diversi. Questa funzionalità è utile per utilizzare le credenziali e l'ambito minimi richiesti per richiamare un endpoint API.
Test con credenziali diverse
Per impostazione predefinita, sono selezionati i tipi di credenziali OAuth 2 e la chiave API. Se vuoi effettuare il test con una sola credenziale, seleziona il tipo di credenziale da utilizzare (e deseleziona l'altro tipo di credenziale). Di seguito sono riportate le regole generali per la scelta di una credenziale da utilizzare con:
Se utilizzi un metodo per accedere ai dati pubblici, ad esempio ai dati di Google Maps, puoi utilizzare una chiave API come credenziale. Controlla la chiave API e deseleziona Google OAuth 2.0.
Se utilizzi un metodo per accedere ai dati privati, ad esempio i dati di Google Drive dell'utente, devi utilizzare una credenziale OAuth 2. Deseleziona Chiave API e seleziona Google OAuth 2.0.
Se il risultato è 200, le credenziali sono sufficienti per accedere ai dati. Se ricevi un risultato 401, devi utilizzare le credenziali OAuth 2 per accedere ai dati.
Test con ambiti diversi
Un ambito è una stringa, ad esempio https://www.googleapis.com/auth/drive.metadata.readonly, che definisce un livello di accesso alle risorse richieste dall'app, ad esempio il livello di accesso ai dati di proprietà degli utenti. Idealmente, vuoi che la tua app utilizzi ambiti con il livello
di accesso più limitato ai dati dell'utente. Metodi diversi potrebbero
richiedere ambiti diversi. Ad esempio, un metodo in un'API potrebbe richiedere almeno un ambito di sola lettura, mentre altri metodi potrebbero richiedere un ambito di lettura/scrittura.
Per impostazione predefinita, tutti gli ambiti Google OAuth 2.0 per un'API sono abilitati nel programma di esplorazione delle API. Per eseguire il test con un ambito specifico:
- Nella sezione Credenziali Google OAuth 2.0, fai clic su Mostra ambiti.
- Controlla l'ambito da utilizzare durante la chiamata al metodo.
- Fai clic su Esegui per eseguire l'API utilizzando solo l'ambito selezionato. L'Explorer API mostra una schermata di autorizzazione che ti chiede di concedere l'accesso per utilizzare l'ambito.
- Fai clic su Consenti. I risultati vengono visualizzati sotto il pulsante Esegui.
Se Explorer API mostra un risultato pari a 200 in un file "application/json", l'ambito è sufficiente per richiamare il metodo. Se Explorer API mostra un risultato 403, significa che hai scelto un ambito insufficiente per richiamare il metodo. Prova a utilizzare un ambito più ampio.
Per ulteriori informazioni sulla selezione dell'ambito, consulta la sezione relativa all'autenticazione e all'autorizzazione della tua specifica API Google.
Revoca accesso autorizzato a test con nuovi ambiti
Dopo aver utilizzato la schermata di autorizzazione di Google per approvare l'autorizzazione, Explorer API rimane autorizzato a effettuare richieste autenticate finché le credenziali non siano scadute. Se deselezioni gli ambiti, le credenziali e gli ambiti approvati in precedenza non verranno reimpostati. Se vuoi effettuare il test con una nuova configurazione dell'ambito, devi revocare le credenziali precedentemente approvate.
Per revocare le credenziali utilizzate da Explorer API:
- Vai ad App con accesso al tuo account.
- In App di terze parti con accesso all'account, fai clic su Explorer API di Google.
- Fai clic su Rimuovi accesso.
- (Facoltativo) Ricarica la pagina della documentazione per reimpostare Explorer API.