Para comenzar a usar la API de la Biblioteca de Google Fotos con la biblioteca cliente de PHP, 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.comEl 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/callbackHaz 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 consisten en 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 PHP 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 PHP controla todas las llamadas a la API de backend por ti 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 PHP junto con las dependencias de GitHub. Luego, configura tus credenciales de OAuth2 para PHP.
Opciones de descarga
Usa composer.
incluir la biblioteca como una dependencia en tu entorno de desarrollo. Ejecuta el
siguiente comando para agregar la biblioteca a la configuración de tu proyecto y descargarla
en el directorio vendor/.
composer require google/photos-library
Como alternativa, también puedes clonar basado en la nube o descarga un archivo tarball.
Configura tus credenciales de OAuth2 para PHP
Esta biblioteca cliente funciona con el Biblioteca de Google Auth para PHP Para obtener más información, consulta Cómo usar OAuth 2.0 con la biblioteca cliente de las APIs de Google PHP
Usa las credenciales de autenticación que muestra la biblioteca auth durante la configuración
PhotosLibraryClient
Prueba algunas muestras
Prueba el siguiente código para realizar tu primera llamada a la API con la biblioteca cliente de PHP.
use Google\Auth\Credentials\UserRefreshCredentials;
use Google\Photos\Library\V1\PhotosLibraryClient;
use Google\Photos\Library\V1\PhotosLibraryResourceFactory;
try {
// Use the OAuth flow provided by the Google API Client Auth library
// to authenticate users. See the file /src/common/common.php in the samples for a complete
// authentication example.
$authCredentials = new UserRefreshCredentials( /* Add your scope, client secret and refresh token here */ );
// Set up the Photos Library Client that interacts with the API
$photosLibraryClient = new PhotosLibraryClient(['credentials' => $authCredentials]);
// Create a new Album object with at title
$newAlbum = PhotosLibraryResourceFactory::album("My Album");
// Make the call to the Library API to create the new album
$createdAlbum = $photosLibraryClient->createAlbum($newAlbum);
// The creation call returns the ID of the new album
$albumId = $createdAlbum->getId();
} catch (\Google\ApiCore\ApiException $exception) {
// Error during album creation
} catch (\Google\ApiCore\ValidationException $e) {
// Error during client creation
echo $exception;
}
Hay más muestras en GitHub que puedes probar.