Guida rapida di PHP

Questa guida rapida spiega come configurare una semplice applicazione a riga di comando PHP che invia richieste all'API YouTube Data. Questa guida rapida spiega come effettuare due richieste API:

1. Utilizzerai una chiave API, che identifica la tua applicazione, per recuperare informazioni sul canale YouTube GoogleDevelopers.
2. Utilizzerai un ID client OAuth 2.0 per inviare una richiesta autorizzata che recupera informazioni sul tuo canale YouTube.

Nota: più in generale, puoi seguire le istruzioni per il primo esempio per qualsiasi caso d'uso che utilizza una chiave API o per il secondo esempio per qualsiasi caso d'uso che richiede l'autorizzazione utilizzando OAuth 2.0. Per altri esempi, consulta lo strumento per i casi d'uso e gli esempi di codice.

Prerequisiti

Per eseguire questa guida rapida, devi disporre di:

• PHP 5.4 o versioni successive con l'interfaccia a riga di comando (CLI) e l'estensione JSON installate.
• Strumento di gestione delle dipendenze Composer installato a livello globale {: target="_blank"}
• La libreria client delle API di Google per PHP:
  • Se non hai già installato la libreria client:

    composer require google/apiclient:^2.0

  • Se hai già installato la libreria client, ti consigliamo di aggiornarla per assicurarti di disporre delle classi più aggiornate per la libreria che stai testando:

    composer update google/apiclient --with-dependencies

Passaggio 1: configura il progetto e le credenziali

Crea o seleziona un progetto nella console API. Completa le seguenti attività nella console API del tuo progetto:

1. Nel riquadro della libreria, cerca l'API YouTube Data v3. Fai clic sulla scheda dell'API e assicurati che l'API sia abilitata per il tuo progetto.

2. Nel riquadro delle credenziali, crea due credenziali:

   1. Crea una chiave API La utilizzerai per effettuare richieste API che non richiedono l'autorizzazione dell'utente. Ad esempio, non hai bisogno dell'autorizzazione dell'utente per recuperare le informazioni su un canale YouTube pubblico.

   2. Crea un ID client OAuth 2.0 Imposta il tipo di applicazione su Altro. Devi utilizzare le credenziali OAuth 2.0 per le richieste che richiedono l'autorizzazione dell'utente. Ad esempio, devi disporre dell'autorizzazione dell'utente per recuperare le informazioni sul canale YouTube dell'utente attualmente autenticato.

      Scarica il file JSON contenente le credenziali OAuth 2.0. Il file ha un nome come client_secret_CLIENTID.json, dove CLIENTID è l'ID client del tuo progetto.

Passaggio 2: configura ed esegui l'esempio

Utilizza il widget Explorer API nel riquadro laterale per ottenere un codice campione per recuperare informazioni sul canale YouTube GoogleDevelopers. Questa richiesta utilizza una chiave API per identificare la tua applicazione e non richiede l'autorizzazione dell'utente o alcuna autorizzazione speciale da parte dell'utente che esegue l'esempio.

1. Apri la documentazione per il metodo channels.list dell'API.

2. In questa pagina, la sezione "Casi d'uso comuni" contiene una tabella che spiega i diversi metodi di utilizzo del metodo. La prima scheda della tabella riguarda i risultati in base all'ID canale.

   Fai clic sul simbolo del codice della prima scheda per aprire e completare l'Explorer API a schermo intero.

   

3. La parte sinistra dell'Explorer API a schermo intero mostra quanto segue:

   1. Sotto l'intestazione Parametri di richiesta, è presente un elenco dei parametri supportati dal metodo. I valori dei parametri part e id devono essere impostati. Il valore del parametro id, UC_x5XG1OV2P6uZZ5FSM9Ttw, è l'ID del canale YouTube GoogleDevelopers.

   2. Sotto i parametri c'è una sezione denominata Credentials (Credenziali). Il menu a discesa in quella sezione dovrebbe visualizzare il valore Chiave API. Per impostazione predefinita, Explorer API utilizza le credenziali demo per aiutarti a iniziare più facilmente. Tuttavia, utilizzerai la tua chiave API per eseguire l'esempio localmente.

      

4. La parte destra di Explorer API a schermo intero mostra le schede con esempi di codice in diverse lingue. Seleziona la scheda PHP.

5. Copia l'esempio di codice e salvalo in un file denominato example.php.

6. Nell'esempio scaricato, trova la stringa YOUR_API_KEY e sostituiscila con la chiave API creata nel passaggio 1 di questa guida rapida.

7. Esegui l'esempio dalla riga di comando. Nella directory di lavoro, esegui:

   php example.php

8. L'esempio deve eseguire la richiesta e stampare la risposta in STDOUT.

Passaggio 3: esegui una richiesta autorizzata

In questo passaggio, modificherai l'esempio di codice in modo che, anziché recuperare informazioni sul canale YouTube di GoogleDevelopers, recuperi le informazioni sul tuo canale YouTube. Questa richiesta richiede l'autorizzazione dell'utente.

1. Torna alla documentazione del metodo channels.list dell'API.

2. Nella sezione "Casi d'uso comuni", fai clic sul simbolo del codice per la terza scheda nella tabella. Questo caso d'uso è chiamare il metodo list per "il mio canale".

3. Ancora una volta, sul lato sinistro di Explorer API a schermo intero, vedrai un elenco di parametri seguiti dalla sezione Credenziali. Tuttavia, ci sono due modifiche rispetto all'esempio in cui hai recuperato informazioni sul canale GoogleDevelopers:

   1. Nella sezione dei parametri, anziché il valore parametro id impostato, il valore parametro mine deve essere impostato su true. Questo indica al server API di recuperare le informazioni sul canale dell'utente attualmente autenticato.

   2. Nella sezione Credenziali, il menu a discesa dovrebbe selezionare l'opzione Google OAuth 2.0.

      Inoltre, se fai clic sul link Mostra ambiti, devi controllare l'ambito https://www.googleapis.com/auth/youtube.readonly.

      

4. Come nell'esempio precedente, seleziona la scheda PHP, copia l'esempio di codice e salvalo in example.php.

   Nel codice, trova la stringa YOUR_CLIENT_SECRET_FILE.json e sostituiscila con la posizione del file client client che hai scaricato nel passaggio 1 di questa guida rapida.

5. Esegui l'esempio dalla riga di comando. Nella directory di lavoro, esegui:

   php example.php

6. Copia l'URL dalla console e aprilo nel browser.

   Se non hai ancora eseguito l'accesso al tuo Account Google, ti verrà chiesto di accedere. Se hai eseguito l'accesso a più Account Google, ti verrà chiesto di selezionare un account da utilizzare per l'autorizzazione.

7. Fai clic sul pulsante per concedere alla tua applicazione l'accesso agli ambiti specificati nell'esempio di codice.

8. Copia il codice di autorizzazione dal browser e incollalo nel tuo terminale. Puoi quindi chiudere la scheda del browser utilizzata per il flusso di autenticazione.

   La risposta dell'API deve essere nuovamente stampata su STDOUT.

Per approfondire

• Documentazione di assistenza di Google Developers Console
• Documentazione sul client API di Google per la documentazione di PHP
• Libreria client delle API di Google per PHP su GitHub e classi generate automaticamente per l'API di YouTube. Nella pagina, trova la cartella YouTube e il file YouTube.php.
• Documentazione di riferimento dell'API di dati di YouTube