Para comenzar a usar la API de la biblioteca de Google Fotos, habilita la API en la Consola de API de Google y configura un ID de cliente de OAuth 2.0 para configurar el 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, 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
Cómo habilitar la API
Antes de poder usar la API de la Biblioteca, debes habilitarla para 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 las APIs de Google, en 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 en Habilitar.
Cómo solicitar un ID de cliente de OAuth 2.0
Sigue los pasos que se indican a continuación a fin de 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 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 app. Este campo no permite 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 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.
-
Copia lo siguiente del diálogo del cliente de OAuth resultante:
- ID de cliente
- Secreto del cliente
Tu app puede acceder a las APIs de Google habilitadas mediante estos valores.
Antes de iniciar una aplicación pública que acceda a la API de la Biblioteca, Google debe revisar la app. Cuando pruebes tu aplicación, aparecerá el mensaje "App no verificada" en la pantalla hasta que se verifique.
Prueba la muestra
Ahora que ya configuraste tu proyecto para usarlo con la API de Library, consulta la app de ejemplo en GitHub. En la app de ejemplo, se muestra cómo crear un marco de fotos inteligente con la API de la Biblioteca.