Si quieres comenzar a usar la API de la Biblioteca de Google Fotos, habilita la API mediante la Consola de APIs de Google y configura un ID de cliente de OAuth 2.0 para configurar tu proyecto.
Tu aplicación interactúa con Google Fotos en nombre de un usuario de Google Fotos. Por ejemplo, cuando creas álbumes en la biblioteca de Google Fotos de un usuario o subes elementos multimedia a su cuenta de Google Fotos, el usuario autoriza estas solicitudes a la API mediante el protocolo 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, usen la API de la Biblioteca. La API de Library no admite cuentas de servicio. Para usar esta API, los usuarios deben acceder a una Cuenta de Google válida.
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.
- Desde la barra de menú, selecciona un proyecto o crea uno nuevo.
- Para abrir la biblioteca de API de Google, en el menú de navegación, selecciona APIs y servicios > Biblioteca.
- Busca “API de Google Photos Library”. Selecciona el resultado correcto y haz clic en 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 aplicación. En este ejemplo, se usa una aplicación en la que todo el flujo de OAuth se controla del lado del servidor, como la que se muestra en nuestras muestras. El proceso de configuración puede variar para otras situaciones de implementación.
- Ve a la Consola de API 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 el tipo de aplicación. En este ejemplo, el tipo de aplicación es Web application.
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 la app. Este campo no admite comodines.
Puedes ingresar varios orígenes para permitir que la app se ejecute en diferentes protocolos, dominios o subdominios. Las URLs que ingreses pueden iniciar una solicitud de OAuth.
En el siguiente ejemplo, se muestra una URL de desarrollo local (nuestras muestras usan
localhost:8080) y una URL de producción.http://localhost:8080 https://myproductionurl.example.comEl campo URI de redireccionamiento autorizado es el extremo que recibe las respuestas del servidor de OAuth 2.0. Por lo general, esto incluye el entorno de desarrollo y apunta a una ruta en la aplicación.
http://localhost:8080/auth/google/callback https://myproductionurl.example.com/auth/google/callbackHaz clic en Crear.
-
En el diálogo del cliente de OAuth resultante, copia lo siguiente:
- ID de cliente
- Secreto del cliente
Tu app puede acceder a las APIs de Google habilitadas usando estos valores.
Antes de que puedas lanzar una aplicación pública que acceda a la API de la Biblioteca, Google debe revisarla. Cuando pruebes la aplicación, aparecerá el mensaje “No se verificó la app” en la pantalla hasta que se verifique.
Prueba la muestra
Ahora que configuraste tu proyecto para usarlo con la API de la Biblioteca, consulta la app de ejemplo en GitHub. En la app de ejemplo, se demuestra cómo puedes crear un marco de fotos inteligente usando la API de Library.