Guida rapida di PHP

Questa guida rapida spiega come configurare una semplice applicazione a riga di comando PHP che effettua richieste all'API YouTube Data. Questa guida rapida spiega in realtà 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.

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 installata.
  • Lo strumento di gestione delle dipendenze Composer installato a livello globale
  • La libreria client delle API di Google per PHP:
    • Se non hai installato in precedenza la libreria client: 
      composer require google/apiclient:^2.0
    • Se hai installato in precedenza la libreria client, ti consigliamo di aggiornarla per assicurarti di avere le 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 Cloud. Completa le seguenti attività nella console Cloud per il tuo progetto:

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

  2. Nel riquadro delle credenziali, crea due credenziali:

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

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

      Scarica il file JSON contenente le credenziali OAuth 2.0. Il file ha un nome simile a 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 il 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 autorizzazioni speciali da parte dell'utente che esegue l'esempio.

  1. Apri la documentazione del metodo channels.list dell'API.

  2. In questa pagina, la sezione "Casi d'uso comuni" contiene una tabella che spiega diversi modi comuni in cui viene utilizzato il metodo. Il primo elenco nella tabella riguarda l'elenco dei risultati per ID canale.

    Fai clic sul simbolo del codice per il primo elenco per aprire e compilare l'Explorer API a schermo intero.

    Immagine che identifica la posizione del link simbolico nella tabella che elenca i casi d'uso per la documentazione di channels.list. Il testo alternativo di questa immagine la identifica come un simbolo di codice e specifica il caso d'uso associato al link.

  3. Il lato sinistro dell'Explorer API a schermo intero mostra quanto segue:

    1. Sotto l'intestazione Parametri della richiesta è presente un elenco di 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 è presente una sezione denominata Credenziali. Il menu a discesa in questa sezione deve visualizzare il valore Chiave API. Per impostazione predefinita, l'Explorer API utilizza le credenziali demo per semplificare l'utilizzo. Tuttavia, utilizzerai la tua chiave API per eseguire l'esempio in locale.

      Immagine che mostra le "Credenziali" in Explorer API a schermo intero e il menu a discesa con l'opzione "Chiave API" selezionata.

  4. Il lato destro dell'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 che hai scaricato, trova la stringa YOUR_API_KEY e sostituiscila con la chiave API che hai creato 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 dovrebbe eseguire la richiesta e stampare la risposta su STDOUT.

Passaggio 3: esegui una richiesta autorizzata

In questo passaggio, modificherai l'esempio di codice in modo che, anziché recuperare informazioni sul canale YouTube GoogleDevelopers, recuperi 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 il terzo elenco nella tabella. Questo caso d'uso consiste nel chiamare il metodo list per "il mio canale".

  3. Anche in questo caso, sul lato sinistro dell'Explorer API a schermo intero, vedrai un elenco di parametri seguito 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é impostare il valore del parametro id, il valore del parametro mine deve essere impostato su true. In questo modo, il server API recupera informazioni sul canale dell'utente attualmente autenticato.

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

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

      Immagine che mostra gli ambiti in Explorer API a schermo intero e l'opzione per utilizzare le credenziali "Google OAuth 2.0" selezionata.

  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 il percorso del file dei client secret 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 farlo. Se hai eseguito l'accesso a più Account Google, ti verrà chiesto di selezionarne uno 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 autenticazione dal browser e incollalo nel terminale. Puoi quindi chiudere la scheda del browser utilizzata per il flusso di autenticazione.

    La risposta dell'API dovrebbe essere stampata di nuovo su STDOUT.

Per approfondire