Para comenzar a usar la API de la biblioteca de Google Fotos con la biblioteca cliente de Java, deberás hacer lo siguiente: configura la biblioteca cliente en tu entorno de desarrollo. Antes de hacerlo, habilita la API para configurar tu proyecto a través de la Consola de API de Google y la configuración de un ID de cliente de OAuth 2.0.
Tu aplicación interactúa con Google Fotos en nombre de un Usuario de Google Fotos. Por ejemplo, cuando creas álbumes en la cuenta de usuario biblioteca de Google Fotos o subir elementos multimedia a la cuenta de un usuario de Google Fotos, el usuario autoriza estas solicitudes a la API mediante el OAuth 2.0.
El ID de cliente de OAuth 2.0 permite que los usuarios de tu aplicación accedan, se autentiquen, y, por lo tanto, usar la API de la Biblioteca. La API de la Biblioteca no es compatible las cuentas de servicio; Para usar esta API, los usuarios deben acceder a una cuenta de Google Cuenta.
Cómo configurar tu app
Habilita la API
Antes de poder usar la API de la Biblioteca, debes habilitarla en tu proyecto.
- Ve a la Consola de API de Google.
- En la barra de menú, selecciona un proyecto o crea uno nuevo.
- Para abrir la Biblioteca de APIs de Google, desde el menú de navegación, selecciona APIs y Servicios > Biblioteca.
- Busca “API de la Biblioteca de Google Fotos”. Selecciona el resultado correcto y haz clic Habilitar.
Cómo solicitar un ID de cliente de OAuth 2.0
Sigue los pasos que se indican a continuación para solicitar un ID de cliente de OAuth y configurarlo para tu y mantener la integridad de su aplicación. En este ejemplo, se usa una aplicación en la que todo el flujo de OAuth del servidor, como el de nuestros ejemplos. El proceso de configuración puede variar para otras situaciones de implementación.
- Ve a la Consola de APIs de Google. y selecciona tu proyecto.
- En el menú, selecciona APIs y Servicios > Credenciales.
- En la página Credenciales, haz clic en Crear credenciales > ID de cliente de OAuth.
- Selecciona tu Tipo de aplicación. En este ejemplo, el tipo de aplicación es Aplicación web.
Registra los orígenes desde los que tu app puede acceder a las APIs de Google de la siguiente manera:
- Para identificar el ID de cliente, ingresa un nombre.
En el campo Orígenes autorizados de JavaScript, ingresa el origen de tu . Este campo no permite comodines.
Puedes ingresar varios orígenes para permitir que tu app se ejecute en diferentes protocolos, dominios o subdominios. Las URLs que ingreses iniciar una solicitud de OAuth.
El siguiente ejemplo muestra una URL de desarrollo local (nuestras muestras usan
localhost:8080
) y una URL de producción.http://localhost:8080 https://myproductionurl.example.com
El campo URI de redireccionamiento autorizado es el extremo que recibe respuestas automáticas del servidor de OAuth 2.0. Por lo general, esto incluye de desarrollo de aplicaciones y apunta a una ruta de acceso en tu aplicación.
http://localhost:8080/auth/google/callback https://myproductionurl.example.com/auth/google/callback
Haz clic en Crear.
-
Desde el diálogo resultante del cliente de OAuth, descarga el archivo JSON. que contiene la configuración del cliente. Los detalles de tu cliente constan de lo siguiente: lo siguiente:
- ID de cliente
- Secreto del cliente
Este archivo JSON se usará más adelante para configurar la biblioteca de Google Auth para Java que funciona con esta biblioteca cliente.
Antes de iniciar una aplicación pública que acceda a la API de la Biblioteca, Google debe revisar tu app. Una "app sin verificar" que aparezca en la la pantalla cuando pruebes tu aplicación, hasta que verificada.
Configura la biblioteca cliente
La biblioteca cliente de Java controla todas las llamadas a la API de backend y expone con los que puedes trabajar, incluidas muestras de código para algunas tareas comunes de la API. Primero, descarga e instala la biblioteca cliente de la API de Google Photos Library para Java junto con las dependencias de GitHub. Luego, configura tus credenciales de OAuth2 para Java.
Opciones de descarga
A continuación, se muestran algunas opciones para descargar la biblioteca cliente:
Dependencia de Gradle:
Para usar esta biblioteca con Gradle, agrega la siguiente dependencia a tu
build.gradle
.repositories { mavenCentral() } dependencies { compile 'com.google.photos.library:google-photos-library-client:1.7.3' }
Dependencia de Maven:
Para usar esta biblioteca con Maven, agrega lo siguiente a tu
pom.xml
de Maven .<dependency> <groupId>com.google.photos.library</groupId> <artifactId>google-photos-library-client</artifactId> <version>1.7.3</version> </dependency>
Descarga una versión:
La página de versiones contiene artefactos diferentes para cada versión de la biblioteca, incluidos archivos JAR.
Clona el repositorio:
Usa este método si quieres modificar esta biblioteca o contribuir con ella. como el envío de solicitudes de extracción, o si deseas probar nuestras muestras. Cuando si clona el repositorio, se descargarán todos los archivos del repositorio.
- Ejecuta
git clone https://github.com/google/java-photoslibrary.git
a las el símbolo del sistema. - Obtendrás un directorio
java-photoslibrary
. Para navegar, ejecuta lo siguiente:cd java-photoslibrary
- Abre el archivo
build.gradle
en tu IDE o ejecuta./gradlew assemble
en el símbolo del sistema para compilar el proyecto. Visita./gradlew tasks
para ver las tareas disponibles.
- Ejecuta
Configura tus credenciales de OAuth2 para Java
Esta biblioteca cliente funciona con la biblioteca de autenticación de Google para Java Para obtener más información, consulta Cómo usar OAuth 2.0 con la biblioteca cliente de las APIs de Google Java
Especifica la configuración de OAuth de tu cliente en CredentialsProvider
cuando
Crea la PhotoLibrarySettings
para un objeto PhotosLibraryClient
.
Prueba algunas muestras
Prueba el siguiente código para realizar tu primera llamada a la API con la biblioteca cliente de 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
}
Hay más muestras en GitHub para que los pruebes.