Esegui esempi di codice

cURL

Configura

1. Segui le istruzioni nella documentazione dell'API per creare o selezionare un progetto per la tua app e abilitare l'API.
2. Nella console Google Cloud, crea una chiave API.
3. Nella console Cloud, crea una credenziale ID client OAuth per un'applicazione web e utilizza https://developers.google.com/oauthplayground come URI di reindirizzamento.
4. In OAuth 2.0 Playground, fai clic su Configurazione OAuth 2.0 settings.
5. Seleziona Usa le tue credenziali.
6. Inserisci l'ID client e il client secret generati nel passaggio 3.
7. Nel campo degli ambiti, digita l'ambito da utilizzare con il metodo e fai clic su Autorizza API.
8. (Facoltativo) Se viene visualizzata una schermata di accesso, seleziona l'account da utilizzare.
9. (Facoltativo) Se viene visualizzata una schermata di autorizzazione, fai clic su Accetta.
10. Fai clic su Scambia codice di autorizzazione con token. Viene restituito un token.
11. Nell'esempio di codice cURL, sostituisci [YOUR_API_KEY] con la chiave API generata nel passaggio 2: 'https://www.googleapis.com/drive/v3/files?key=[YOUR_API_KEY]' \
12. Nell'esempio di codice cURL, sostituisci [YOUR_ACCESS_TOKEN] con il token di accesso generato nel passaggio 10: --header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \

Esegui l'esempio di codice

Dalla riga di comando, esegui il comando cURL. Il comando dovrebbe essere simile al seguente:

curl \
'https://www.googleapis.com/drive/v3/files?key=AIzaSyBiKcaoXmVApwnT24hitQG_dwjGvAj6Ddw' \
--header 'Authorization: Bearer ya29.a0ARrdaM_yQn9MWBpJgKPx880BSnRYIizRYIDz0JN9e66nSliIYpqNXmPsvv2ccfplCTG_U4b1' \
--header 'Accept: application/json' \
--compressed

JavaScript

Configura

1. Segui le istruzioni nella documentazione dell'API per creare o selezionare un progetto per la tua app e abilitare l'API.
2. Nella console Google Cloud, crea una chiave API.
3. Nella console Google Cloud, crea una credenziale ID client OAuth per un'applicazione web e imposta le origini JavaScript autorizzate per identificare l'URL da cui invierai le richieste, ad esempio http://localhost.
4. Copia l'esempio di codice completo in un file locale accessibile al tuo server web, ad esempio /var/www/html/example.html.

5. Trova la riga nell'esempio di codice che imposta la chiave API o l'ID client e sostituisci il valore con i valori generati nei passaggi 2 e 3:

   • Chiave API: gapi.client.setApiKey(YOUR_API_KEY);
   • ID client OAuth 2.0: gapi.client.init({ 'clientId': 'YOUR_CLIENT_ID',

Esegui l'esempio di codice

1. Apri il file nel browser, ad esempio http://localhost/example.html. Ti consigliamo di utilizzare un browser con una console di debug, come Google Chrome.
2. (Facoltativo) Se viene visualizzata una schermata di accesso, seleziona l'account da utilizzare.
3. (Facoltativo) Se viene visualizzata una schermata di autorizzazione, fai clic su Accetta. La console di debug dovrebbe mostrare la risposta del metodo come oggetto JSON.

Java

Prerequisiti

• Java 1.7 o versioni successive.
• Gradle 7 o versioni successive.

Configura

1. Segui le istruzioni nella documentazione dell'API per creare o selezionare un progetto per la tua app e abilitare l'API.
2. A seconda del tipo di dati a cui accede il metodo, crea una chiave API (dati pubblici) o un ID client OAuth 2.0 (dati privati).
3. Imposta il tipo di applicazione su App desktop.
4. Se hai creato un ID client OAuth 2.0, scarica il file JSON contenente le credenziali OAuth 2.0. Il nome di questo file è simile a client_secret_CLIENTID.json, dove CLIENTID è l'ID client del tuo progetto.

5. Nella directory di lavoro, esegui i seguenti comandi per creare una nuova struttura di progetto:

   $ gradle init --type basic
   $ mkdir -p src/main/java src/main/resources
   

6. Se hai creato un ID client OAuth 2.0 nel passaggio 2, rinomina il file JSON scaricato in client_secret.json.

7. Salva il file rinominato nella directory src/main/resources creata nel passaggio 5.

8. Nella directory di lavoro, apri il file build.gradle e sostituisci i contenuti con i seguenti:

   apply plugin: 'java'
   apply plugin: 'application'
   
   mainClassName = 'ApiExample'
   sourceCompatibility = 1.7
   targetCompatibility = 1.7
   version = '1.0'
   
   repositories {
       mavenCentral()
   }
   
   dependencies {
       compile 'com.google.api-client:google-api-client:1.23.0'
       compile 'com.google.oauth-client:google-oauth-client-jetty:1.23.0'
       API_SPECIFIC_DEPENDENCY
   }
   

9. Nel file build.gradle, sostituisci la riga API_SPECIFIC_DEPENDENCY con un'istruzione per compilare il codice per l'API che stai chiamando. Ecco un esempio per l'API YouTube Analytics:

   compile 'com.google.apis:google-api-services-youtubeAnalytics:v2-rev16-1.23.0'
   

   L'istruzione segue questo modello:

   compile 'com.google.apis:google-api-services-API_NAME:API_VERSION-   revREVISION-CL_VERSION'
   

Dove:

• API_NAME è il nome dell'API elencato su GitHub per l'API. Per trovare il nome, fai clic sul link della versione accanto all'API nella pagina API di Google supportate. Il link della versione rimanda a GitHub. Il nome dell'API si trova nella parte centrale superiore della pagina ed è preceduto da googleapis/google-apis-services-. Ad esempio, per la versione 3 dell'API Drive, API_NAME è drive.
• API_VERSION è la versione dell'API elencata per l'API sotto il nome dell'API nella pagina API Google supportate.
• REVISION è il numero di revisione elencato nella documentazione di riferimento JavaDoc per l'API. La documentazione di riferimento JavaDoc è disponibile all'indirizzo https://googleapis.dev/java/google-api-services-API_NAME/latest/index.html
• CL_VERSION è la versione della libreria client. Questo valore viene visualizzato anche nella documentazione di riferimento JavaDoc.
• Dalla directory di lavoro, copia l'esempio di codice da Explorer API in src/main/java/ApiExample.java. (Il nome della classe in ogni esempio è ApiExample, quindi non devi modificare il file build.gradle per eseguire esempi diversi.

Esegui l'esempio di codice

Utilizza il seguente comando per eseguire l'esempio:

  gradle -q run

L'esempio dovrebbe eseguire la richiesta API e stampare la risposta su STDOUT. Puoi anche controllare il servizio che stai chiamando per vedere gli effetti delle richieste che scrivono i dati.

Node.js

Prerequisiti

• Node.js

• La libreria client delle API Google per Node.js:

  • Se non hai installato la libreria client in precedenza, esegui il comando:

  npm install googleapis --save
  

  • Se hai installato la libreria client in precedenza, ti consigliamo di aggiornarla per assicurarti di avere le classi più aggiornate per la libreria che stai testando. Per aggiornare la libreria client, esegui il comando:

  npm update googleapis --save
  

Configura

1. Segui le istruzioni nella documentazione dell'API per creare o selezionare un progetto per la tua app e abilitare l'API.
2. A seconda del tipo di dati a cui accede il metodo, crea una chiave API (dati pubblici) o un ID client OAuth 2.0 (dati privati).
3. Imposta il tipo di applicazione su App desktop.
4. Se hai creato un ID client OAuth 2.0, scarica il file JSON contenente le credenziali OAuth 2.0. Il nome di questo file è simile a client_secret_CLIENTID.json, dove CLIENTID è l'ID client del tuo progetto.
5. Copia l'esempio di codice in un file locale e modificalo per identificare correttamente la chiave API o il file client secret. Nell'esempio, il valore della chiave API è YOUR_API_KEY e la posizione del file client secret è YOUR_CLIENT_SECRET_FILE.json.

Esegui l'esempio di codice

Utilizza il seguente comando per eseguire l'esempio:

  node sample.js

La maggior parte degli esempi stampa una risposta API (o altro) su STDOUT.

PHP

Prerequisiti

• PHP 5.4 o versioni successive con l'interfaccia a riga di comando (CLI) e l'estensione JSON.
• Lo strumento di gestione delle dipendenze Composer installato a livello globale.

• La libreria client delle API Google per PHP:

  • Se non hai installato la libreria client in precedenza, esegui il comando:

    composer require google/apiclient:^2.0
    

  • Se hai installato la libreria client in precedenza, ti consigliamo di aggiornarla per assicurarti di avere le classi più aggiornate per la libreria che stai testando. Per aggiornare la libreria client, esegui il comando:

    composer update google/apiclient --with-dependencies
    

Esegui l'esempio di codice

Utilizza il seguente comando per eseguire l'esempio:

  php sample.php

La maggior parte degli esempi stampa una risposta API (o altro) su STDOUT.

Python

Prerequisiti

• Python 2.7 o Python 3.5+
• Lo strumento di gestione dei pacchetti pip

• La libreria client delle API Google per Python:

  pip install --upgrade google-api-python-client
  

• Le librerie google-auth-oauthlib e google-auth-httplib2 per l'autorizzazione utente:

  pip install --upgrade google-auth-oauthlib google-auth-httplib2
  

Configura

1. Segui le istruzioni nella documentazione dell'API per creare o selezionare un progetto per la tua app e abilitare l'API.
2. A seconda del tipo di dati a cui accede il metodo, crea una chiave API (dati pubblici) o un ID client OAuth 2.0 (dati privati).
3. Imposta il tipo di applicazione su App desktop.
4. Se hai creato un ID client OAuth 2.0, scarica il file JSON contenente le credenziali OAuth 2.0. Il nome di questo file è simile a client_secret_CLIENTID.json, dove CLIENTID è l'ID client del tuo progetto.
5. Copia l'esempio di codice in un file locale e modificalo per identificare correttamente la chiave API o il file client secret. Nell'esempio, il valore della chiave API è YOUR_API_KEY e la posizione del file client secret è YOUR_CLIENT_SECRET_FILE.json.

Esegui l'esempio di codice

Utilizza il seguente comando per eseguire l'esempio:

  python sample.py

La maggior parte degli esempi stampa una risposta API (o altro) su STDOUT.

Ruby

Prerequisiti

• Ruby 2.0 o versioni successive

• La libreria client delle API di Google per Ruby:

  gem install google-api-client`
  

Configura

1. Segui le istruzioni nella documentazione dell'API per creare o selezionare un progetto per la tua app e abilitare l'API.
2. A seconda del tipo di dati a cui accede il metodo, crea una chiave API (dati pubblici) o un ID client OAuth 2.0 (dati privati).
3. Imposta il tipo di applicazione su App desktop.
4. Se hai creato un ID client OAuth 2.0, scarica il file JSON contenente le credenziali OAuth 2.0. Il nome di questo file è simile a client_secret_CLIENTID.json, dove CLIENTID è l'ID client del tuo progetto.
5. Copia l'esempio di codice in un file locale e modificalo per identificare correttamente la chiave API o il file client secret. Nell'esempio, il valore della chiave API è YOUR_API_KEY e la posizione del file client secret è YOUR_CLIENT_SECRET_FILE.json.

Esegui l'esempio di codice

Utilizza il seguente comando per eseguire l'esempio:

  ruby sample.rb

La maggior parte degli esempi stampa una risposta API (o altro) su STDOUT.