Visualizza Explorer API ed esegui un metodo

Nella maggior parte delle pagine della documentazione, sul lato destro dello schermo è visibile un riquadro Explorer API condensato. Se Explorer API non è visibile, fai clic su Prova! per visualizzare la versione condensata di Explorer API.

Se il link Prova! non è visualizzato sul lato destro di una pagina della documentazione di riferimento, significa che il metodo non è supportato da Explorer API. Ad esempio, Explorer API non è compatibile con le API che richiedono account di servizio, pertanto non viene visualizzato nelle pagine della documentazione per tali API.

Visualizza la versione espansa di Explorer API

La versione espansa di Explorer API contiene cURL, HTTP ed eventualmente altri esempi di codice. Per visualizzare la versione espansa di Explorer API, fai clic su Schermo intero .

Nota: per eseguire gli esempi di codice, devi generare e utilizzare le tue credenziali di autorizzazione. Per una spiegazione su come creare un progetto e generare le credenziali, consulta la documentazione specifica dell'API di Google.

Eseguire un metodo

Explorer API consente di inserire i parametri obbligatori, parametri facoltativi e, se applicabile, un corpo di richiesta per i metodi API. Per molti metodi REST, ad esempio i metodi dell'elenco, devi compilare solo uno o due campi prima di poter eseguire il metodo. Ad esempio, il metodo Libri API books.volumes.list richiede solo un parametro di ricerca (q) per elencare i libri. Per provare il metodo books.volumes.list:

1. Vai all'indirizzo books.volumes.list.
2. Se l'Explorer API non viene visualizzata, fai clic su Prova.
3. Nel campo q, digita Hunger Games (senza virgolette o caratteri speciali).
4. Scorri verso il basso e fai clic su Esegui.
5. (Facoltativo) Una schermata di accesso con Google ti chiede di selezionare un Account Google.
6. (Facoltativo) Una finestra di dialogo dell'autorizzazione Google ti chiede se è consentito gestire i libri. Fai clic su Consenti. I risultati vengono visualizzati sotto il pulsante Esegui.

Se Explorer API mostra un risultato pari a 200, il metodo è riuscito.

Nota: dopo che hai consentito alla schermata di autorizzazione di effettuare una richiesta autorizzata, Explorer API è autorizzato a fare altre richieste fino alla scadenza delle credenziali. Di conseguenza, non viene visualizzata la schermata di autorizzazione per ogni chiamata successiva al metodo. Per ulteriori informazioni sulle credenziali, vedi Test con ambiti e tipi di credenziali diversi.

Risoluzione dei problemi di Explorer API

Hai ricevuto un errore 401 o 403

Se ricevi un errore 401 o 403 durante l'esecuzione di un metodo utilizzando Explorer API, è probabile che si sia verificato uno dei seguenti problemi:

• Stai utilizzando il tipo di autorizzazione errato (chiave API anziché OAuth 2.0). Prova a cambiare tipo di autorizzazione.
• Stai utilizzando OAuth 2.0, ma con un ambito troppo limitato. Prova a utilizzare un ambito più ampio.

La finestra di dialogo di autorizzazione non viene visualizzata

Explorer API utilizza un popup per concedere l'accesso ai tuoi dati privati. Se il browser blocca i popup, questo non verrà visualizzato e non potrai concedere l'accesso.

Se fai clic su Consenti nella finestra di dialogo dell'autorizzazione e non accade nulla, prova a modificare le impostazioni popup del browser per attivare i popup.