Per iniziare a utilizzare le API di Google Foto, configura il tuo progetto attivando le API di Foto di cui hai bisogno utilizzando 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 utilizzando il protocollo OAuth 2.0.
L'ID client OAuth 2.0 consente agli utenti della tua applicazione di accedere, autenticarsi e quindi utilizzare le API Foto. Le API Foto non supportano gli account di servizio; per utilizzare queste API, gli utenti devono aver eseguito l'accesso a un Account Google valido.
Configura la tua app
Innanzitutto abilita l'API, quindi richiedi un ID client OAuth 2.0.
Abilita l'API
Prima di poter utilizzare le API Foto, devi abilitarle nel tuo progetto.
- Vai alla console dell'API di Google.
- Dalla barra dei menu, seleziona un progetto o creane uno nuovo.
- Per aprire una delle API di Google Foto, seleziona API e servizi > Libreria dal menu di navigazione.
- Cerca "Foto". Seleziona una o più API Foto e fai clic su Abilita.
Richiedere un ID client OAuth 2.0
Segui questi passaggi per richiedere un ID client OAuth e configurarlo per la tua applicazione. In questo esempio viene utilizzata un'applicazione in cui l'intero flusso OAuth è gestito lato server, come quello nei nostri esempi. La procedura 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 Tipo di applicazione. In questo esempio, il tipo di applicazione è Applicazione web.
Registra le origini da cui la tua app è autorizzata ad 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. 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 sono autorizzati ad 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 ``` 1. The **Authorized redirect URI** field is the endpoint that receives responses from the OAuth 2.0 server. Typically, this includes your development environment and points to a path in your application. ```none http://localhost:8080/auth/google/callback https://myproductionurl.example.com/auth/google/callback ``` 1. Click **Create**.
-
Dalla finestra di dialogo del client OAuth risultante, copia quanto segue:
- ID client
- Client secret
La tua app può accedere alle API di Google abilitate utilizzando questi valori.
Prima di poter lanciare un'applicazione pubblica che accede alle API Foto, l'app deve essere esaminata da Google. Quando l'applicazione viene testata, sullo schermo viene visualizzato il messaggio "App non verificata" finché non viene verificata.
Dopo aver configurato l'app, puoi iniziare:
Modifica dell'ID cliente
Puoi accedere o modificare le risorse create tramite una qualsiasi delle API di Google Foto solo utilizzando l'ID client originale utilizzato per crearle. Ad esempio, se crei una "sessione" nell'API Picker con un ID client specifico e in un secondo momento modifichi quell'ID client nella tua app, l'app perderà l'accesso a tutte le risorse dell'API create con l'ID client precedente.
Pianifica con attenzione e scegli il tipo di ID client corretto per l'API Photos che stai utilizzando. Modifica l'ID cliente solo se assolutamente necessario per evitare problemi di accesso.