Inizia a utilizzare REST

Per iniziare a utilizzare l'API libreria di Google Foto, configura il tuo 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.

  1. Vai alla console dell'API di Google.
  2. Nella 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 > Libreria.
  4. 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.

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

  5. Registra le origini da cui la tua app può accedere alle API di Google nel seguente modo:

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

    2. 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.com

    3. Il 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/callback

    4. Fai clic su Crea.

  1. Nella 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 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.

Prova l'anteprima

Ora che hai configurato il tuo progetto per l'utilizzo con l'API Library, dai un'occhiata all'app di esempio su GitHub. L'app di esempio mostra come creare una cornice digitale intelligente utilizzando l'API Library.