Per iniziare a utilizzare l'API della libreria di Google Foto con la libreria client Java, dovrai: configurare la libreria client nel tuo ambiente di sviluppo. Prima di farlo, configura il progetto abilitando l'API mediante la console API di Google e configurando 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 l'API Library. L'API Library 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 l'API Library, devi abilitarla per il tuo progetto.
- Vai alla console dell'API di Google.
- Dalla 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 > Raccolta.
- Cerca "API Google Foto Library". 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.
- 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 come segue:
- Per identificare l'ID client, inserisci un nome.
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 l'esecuzione dell'app su diverse protocolli, domini o sottodomini. Gli URL inseriti possono essere 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
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
Fai 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 costituiti seguenti:
- 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 avviare un'applicazione pubblica che accede all'API Library, la tua app deve essere esaminata da Google. Un'"App non verificata" viene visualizzato schermata quando si testa l'applicazione, finché non viene verificati.
Configurare 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 dell'API della libreria di Google Foto per Java insieme a con le dipendenze di 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
.repositories { mavenCentral() } dependencies { compile 'com.google.photos.library:google-photos-library-client:1.7.3' }
Dipendenza da Maven:
Per utilizzare questa libreria con Maven, aggiungi quanto segue al tuo
pom.xml
Maven .<dependency> <groupId>com.google.photos.library</groupId> <artifactId>google-photos-library-client</artifactId> <version>1.7.3</version> </dependency>
Scaricare una release:
La pagina delle release contiene elementi diversi per ogni release della raccolta, inclusi i file jar.
Clona il repository:
Utilizza questo metodo se vuoi modificare o contribuire a questa raccolta, ad esempio ad esempio inviando richieste di pull o se vuoi provare i nostri esempi. Quando clono il repository, verranno scaricati tutti i file in questo repository.
- Corri
git clone https://github.com/google/java-photoslibrary.git
alle al prompt dei comandi. - Verrà visualizzata una directory
java-photoslibrary
. Per accedervi, eseguicd java-photoslibrary
. - Apri il file
build.gradle
nel tuo IDE o esegui./gradlew assemble
su al prompt dei comandi per creare il progetto. Vai su./gradlew tasks
per scoprire di più le attività disponibili.
- Corri
Configura le tue credenziali OAuth2 per Java
Questa libreria client è compatibile con la libreria di autenticazione Google per Java. Per ulteriori informazioni, Consulta l'articolo sull'utilizzo di OAuth 2.0 con la libreria client dell'API di Google per Java.
Specifica la configurazione OAuth del client in CredentialsProvider
quando
creazione di PhotoLibrarySettings
per un oggetto PhotosLibraryClient
.
Prova alcuni esempi
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
}
Sono disponibili altri esempi su GitHub.