Per iniziare a utilizzare l'API Google Foto Library con la libreria client PHP, devi configurare la libreria client nel tuo ambiente di sviluppo. Prima di farlo, configura il progetto abilitando 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 Google Foto di un utente o carichi elementi multimediali nell'account Google Foto di un utente, l'utente autorizza le richieste API tramite il protocollo OAuth 2.0.
L'ID client OAuth 2.0 consente agli utenti dell'applicazione di accedere, autenticarsi e, di conseguenza, utilizzare l'API Library. L'API Library non supporta gli account di servizio; per utilizzare questa API, gli utenti devono aver eseguito l'accesso a un Account Google valido.
Configura la tua app
Abilita l'API
Prima di poter utilizzare l'API Library, devi abilitarla per il tuo progetto.
- Vai alla console dell'API di Google.
- Nella barra dei menu, seleziona un progetto o creane uno nuovo.
- Per aprire la libreria API di Google, dal menu di navigazione seleziona API e servizi > Libreria.
- Cerca "API della libreria di Google Foto". Seleziona il risultato corretto e fai clic su Abilita.
Richiedere un ID client OAuth 2.0
Segui i passaggi riportati di seguito per richiedere un ID client OAuth e configurarlo per la tua applicazione. Questo esempio utilizza un'applicazione in cui l'intero flusso OAuth viene gestito sul lato server, come quello nei nostri esempi. Il processo di configurazione può variare per altri scenari di implementazione.
- Vai alla console API di Google e seleziona il tuo progetto.
- Dal menu, seleziona API e servizi > Credenziali.
- Nella pagina Credenziali, fai clic su Crea credenziali > ID client OAuth.
- Seleziona il tuo Tipo di applicazione. In questo esempio, il tipo di applicazione è Applicazione web.
Registra le origini da cui la tua app può accedere alle API di Google nel seguente modo:
- Per identificare l'ID client, inserisci un nome.
Nel campo Origini JavaScript autorizzate, inserisci l'origine della tua app. Questo campo non consente i caratteri jolly.
Puoi inserire più origini per consentire l'esecuzione dell'app su protocolli, domini o sottodomini diversi. Gli URL che inserisci 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.comIl campo URI di reindirizzamento autorizzato è l'endpoint che riceve le risposte dal server OAuth 2.0. In genere, include l'ambiente di sviluppo e rimanda a un percorso nell'applicazione.
http://localhost:8080/auth/google/callback https://myproductionurl.example.com/auth/google/callbackFai clic su Crea.
-
Dalla finestra di dialogo del client OAuth risultante, scarica il file JSON contenente la configurazione del client. I dettagli del cliente sono i seguenti:
- ID client
- Client secret
Questo file JSON verrà utilizzato in un secondo momento per configurare la libreria di autenticazione Google per PHP che funziona con questa libreria client.
Prima di poter lanciare un'applicazione pubblica che accede all'API Library, l'app deve essere esaminata da Google. Quando testi l'applicazione, viene visualizzato il messaggio "App non verificata" sullo schermo fino a quando non viene verificata.
Configurare la libreria client
La libreria client PHP gestisce per te tutte le chiamate API di backend ed espone gli oggetti compatibili con cui lavorare, inclusi gli esempi di codice per alcune attività API comuni. Innanzitutto, scarica e installa la libreria client dell'API della libreria Google Foto per PHP insieme alle dipendenze da GitHub. Quindi, configura le credenziali OAuth2 per PHP.
Opzioni di download
Utilizza composer per includere la libreria come dipendenza nel tuo ambiente di sviluppo. Esegui questo comando per aggiungere la libreria alla configurazione del progetto e scaricarla nella directory vendor/.
composer require google/photos-library
In alternativa, puoi anche clonare il repository o scaricare un tarball compresso.
Configurazione delle credenziali OAuth2 per PHP
Questa libreria client funziona con la libreria di autenticazione di Google per PHP. Per ulteriori informazioni, consulta la pagina relativa all'utilizzo di 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 di PhotosLibraryClient.
Prova alcuni esempi
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 esempi su GitHub che puoi provare.