Inizia a utilizzare la libreria client PHP

Per iniziare a utilizzare le API di Google Foto con la libreria client PHP, dovrai: configurare la libreria client nel tuo ambiente di sviluppo. Prima di farlo, configura il progetto attivando l'API tramite la console API di Google e impostando un ID client OAuth 2.0.

La tua applicazione interagisce con Google Foto per conto di un Utente di Google Foto. Ad esempio, quando crei album nella raccolta di Google Foto di un utente o carichi elementi multimediali nell'account Google Foto di un utente, l'utente autorizza queste richieste API tramite il protocollo OAuth 2.0.

L'ID client OAuth 2.0 consente agli utenti dell'applicazione di accedere, autenticarsi e quindi utilizzare le API Foto. L'API Foto non supporta account di servizio; per utilizzare questa API, gli utenti devono aver effettuato l'accesso a un Account.

Configura la tua app

Abilita l'API

Prima di poter utilizzare le API Photos, devi abilitarle per il tuo progetto.

  1. Vai alla console dell'API di Google.
  2. Dalla barra dei menu, seleziona un progetto o creane uno nuovo.
  3. Per aprire la libreria API di Google, dal menu di navigazione seleziona API e Servizi > Raccolta.
  4. Cerca "API Google Foto". Seleziona il risultato corretto e fai clic Attiva.

Richiedere un ID client OAuth 2.0

Segui questi passaggi per richiedere un ID client OAuth e configurarlo per il tuo un'applicazione. Questo esempio utilizza un'applicazione in cui l'intero flusso OAuth gestito lato server, come quello nei nostri campioni. La procedura di configurazione può variare per altri scenari di implementazione.

  1. Vai alla console API di Google e seleziona il tuo progetto.
  2. Nel menu, seleziona API e servizi > Credenziali.
  3. Nella pagina Credenziali, fai clic su Crea credenziali > ID client OAuth.
  4. Seleziona il tipo di applicazione. In questo esempio, il tipo di applicazione è Applicazione web.

  5. Registra le origini da cui la tua app è autorizzata ad accedere alle API di Google come segue:

    1. Per identificare l'ID client, inserisci un nome.

    2. Nel campo Origini JavaScript autorizzate, inserisci l'origine del tuo dell'app. In questo campo non sono consentiti caratteri jolly.

      Puoi inserire più origini per consentire all'app di funzionare su protocolli, domini o sottodomini diversi. Gli URL inseriti possono avviare una richiesta OAuth.

      L'esempio seguente mostra un URL di sviluppo locale (i nostri esempi utilizzano localhost:8080) e un URL di produzione.

      http://localhost:8080
https://myproductionurl.example.com

    3. Il campo URI di reindirizzamento autorizzato è l'endpoint che riceve dal server OAuth 2.0. In genere, sono inclusi dell'ambiente di sviluppo e rimanda a un percorso nell'applicazione.

      http://localhost:8080/auth/google/callback
https://myproductionurl.example.com/auth/google/callback

    4. Fai clic su Crea.

  1. Dalla finestra di dialogo del client OAuth risultante, scarica il file JSON contenente la configurazione del client. I dettagli del cliente sono costituiti da quanto segue:

    • ID client
    • Client secret

    Questo file JSON verrà utilizzato in un secondo momento per configurare la libreria Google Auth per PHP che funziona con questa libreria client.

Prima di poter lanciare un'applicazione pubblica che accede alle API di Foto, la tua app deve essere esaminata da Google. Un'"App non verificata" viene visualizzato schermata quando si testa l'applicazione, finché non viene verificate.

Configurare la libreria client

La libreria client PHP gestisce per te tutte le chiamate API di backend ed espone oggetti di facile utilizzo, inclusi esempi di codice per alcune attività comuni dell'API. Innanzitutto, scarica e installa la libreria client delle API di Google Foto per PHP insieme le dipendenze da GitHub. Quindi, configura le tue credenziali OAuth2 per PHP.

Opzioni di download

Utilizza composer per includere la libreria come dipendenza nel tuo ambiente di sviluppo. Esegui l' seguente comando per aggiungere la libreria alla configurazione del progetto e scaricare nella directory vendor/.

composer require google/photos-library

In alternativa, puoi anche clona il repository oppure scaricare un file compresso tarball.

Configurare le credenziali OAuth2 per PHP

Questa libreria client è compatibile con la libreria di autenticazione Google per PHP. Per ulteriori informazioni, consulta Utilizzare OAuth 2.0 con la libreria client dell'API di Google per PHP.

Utilizza le credenziali di autenticazione restituite dalla libreria di autenticazione durante la configurazione del PhotosLibraryClient.

Prova alcuni Sample

Prova il codice riportato di seguito per effettuare la tua prima chiamata API utilizzando la libreria client PHP.

use Google\Auth\Credentials\UserRefreshCredentials;
use Google\Photos\Library\V1\PhotosLibraryClient;
use Google\Photos\Library\V1\PhotosLibraryResourceFactory;

try {
    // Use the OAuth flow provided by the Google API Client Auth library
    // to authenticate users. See the file /src/common/common.php in the samples for a complete
    // authentication example.
    $authCredentials = new UserRefreshCredentials( /* Add your scope, client secret and refresh token here */ );

    // Set up the Photos Library Client that interacts with the API
    $photosLibraryClient = new PhotosLibraryClient(['credentials' => $authCredentials]);

    // Create a new Album object with at title
    $newAlbum = PhotosLibraryResourceFactory::album("My Album");

    // Make the call to the Library API to create the new album
    $createdAlbum = $photosLibraryClient->createAlbum($newAlbum);

    // The creation call returns the ID of the new album
    $albumId = $createdAlbum->getId();
} catch (\Google\ApiCore\ApiException $exception) {
    // Error during album creation
} catch (\Google\ApiCore\ValidationException $e) {
    // Error during client creation
    echo $exception;
}

Esistono altri samples su GitHub da provare.