Inizia a utilizzare la libreria client Java

Per iniziare a utilizzare le API di Google Foto con la libreria client Java, devi 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 cartella raccolta di Google Foto o caricare elementi multimediali nella cartella Google Foto, l'utente autorizza queste richieste API tramite OAuth 2.0.

L'ID client OAuth 2.0 consente agli utenti dell'applicazione di accedere, autenticarsi e quindi utilizzare le API Foto. Le API di Foto non supportano 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 le API di Foto, devi attivarle 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 su 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 viene gestito lato server, come quella nei nostri esempi. La procedura 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 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 cliente, inserisci un nome.

    2. Nel campo Origini JavaScript autorizzate, inserisci l'origine per la tua app. Questo campo non ammette 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 Java 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. Quando testi l'applicazione, sullo schermo viene visualizzato il messaggio "App non verificata" finché non viene verificata.

Configura la libreria client

La libreria client Java gestisce tutte le chiamate API di backend per te ed espone oggetti semplici da utilizzare, compresi esempi di codice per alcune attività API comuni. Innanzitutto, scarica e installa la libreria client delle API di Google Foto per Java insieme alle dipendenze da GitHub. Quindi, configura le credenziali OAuth2 per Java.

Opzioni di download

Ecco alcune opzioni per scaricare la libreria client:

  • Dipendenza da gradi:

    Per utilizzare questa libreria con Gradle, aggiungi la seguente dipendenza al tuo build.gradle file.

    repositories {
  mavenCentral()
}
dependencies {
  compile 'com.google.photos.library:google-photos-library-client:1.7.3'
}

  • Dipendenza Maven:

    Per utilizzare questa libreria con Maven, aggiungi quanto segue al file pom.xml Maven.

    <dependency>
  <groupId>com.google.photos.library</groupId>
  <artifactId>google-photos-library-client</artifactId>
  <version>1.7.3</version>
</dependency>

  • Per scaricare una release:

    La pagina delle release contiene diversi elementi per ogni release della libreria, inclusi i file JAR.

  • Clona il repository:

    Utilizza questo metodo se vuoi modificare o contribuire a questa libreria, ad esempio inviando richieste pull, o se vuoi provare i nostri sample. Quando cloni il repository, verranno scaricati tutti i file al suo interno.

    1. Corri git clone https://github.com/google/java-photoslibrary.git alle al prompt dei comandi.
    2. Riceverai una directory java-photoslibrary. Per accedervi, esegui cd java-photoslibrary.
    3. Apri il file build.gradle nell'IDE o esegui ./gradlew assemble al prompt dei comandi per compilare il progetto. Vai su ./gradlew tasks per scoprire di più le attività disponibili.

Configura le tue credenziali OAuth2 per Java

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

Specifica la configurazione del client OAuth in CredentialsProvider quando crei il PhotoLibrarySettings per un oggetto PhotosLibraryClient.

Prova alcuni Sample

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

// Set up the Photos Library Client that interacts with the API
PhotosLibrarySettings settings =
     PhotosLibrarySettings.newBuilder()
    .setCredentialsProvider(
        FixedCredentialsProvider.create(/* Add credentials here. */)) 
    .build();

try (PhotosLibraryClient photosLibraryClient =
    PhotosLibraryClient.initialize(settings)) {

    // Create a new Album  with at title
    Album createdAlbum = photosLibraryClient.createAlbum("My Album");

    // Get some properties from the album, such as its ID and product URL
    String id = album.getId();
    String url = album.getProductUrl();

} catch (ApiException e) {
    // Error during album creation
}

Su GitHub sono disponibili altri esempi da provare.