Pour commencer à utiliser l'API Library de Google Photos avec la bibliothèque cliente PHP, vous devez : Configurez la bibliothèque cliente dans votre environnement de développement. Avant cela, configurez votre projet en activant l'API. via la console Google APIs et en configurant un ID client OAuth 2.0.
Votre application interagit avec Google Photos pour le compte d'un Utilisateur Google Photos. Par exemple, lorsque vous créez des albums dans le dossier bibliothèque Google Photos ou d'importer des éléments multimédias compte Google Photos, l'utilisateur autorise ces requêtes API via le Protocole OAuth 2.0.
L'ID client OAuth 2.0 permet aux utilisateurs de votre application de se connecter, et ainsi utiliser l'API Library. L'API Library ne prend pas en charge des comptes de service ; Pour utiliser cette API, les utilisateurs doivent être connectés à un compte Compte.
Configurer votre application
Activer l'API
Avant de pouvoir utiliser l'API Library, vous devez l'activer pour votre projet.
- Accédez à la console Google APIs.
- Dans la barre de menu, sélectionnez un projet ou créez-en un.
- Pour ouvrir la bibliothèque d'API Google, dans le menu de navigation, sélectionnez API et Services > bibliothèque.
- Recherchez "API Library de Google Photos". Sélectionnez le résultat correct, puis cliquez sur Activer :
Demander un ID client OAuth 2.0
Suivez les étapes ci-dessous pour demander un ID client OAuth et le configurer pour votre application. Cet exemple utilise une application où l'intégralité du flux OAuth est gérés côté serveur, comme celui de nos exemples. Le processus de configuration peut varier pour découvrir d'autres scénarios de mise en œuvre.
- Accédez à la console Google APIs. et sélectionnez votre projet.
- Dans le menu, sélectionnez API et Services > Identifiants
- Sur la page Identifiants, cliquez sur Créer des identifiants > ID client OAuth.
- Sélectionnez le type d'application. Dans cet exemple, le type d'application est Application Web :
Enregistrer les origines à partir desquelles votre application est autorisée à accéder aux API Google comme suit:
- Pour identifier l'ID client, saisissez un nom.
Dans le champ Origines JavaScript autorisées, saisissez l'origine de votre l'application. Les caractères génériques ne sont pas acceptés dans ce champ.
Vous pouvez saisir plusieurs origines pour permettre à votre appli de s'exécuter sur différentes protocoles, domaines ou sous-domaines. Les URL que vous saisissez sont autorisées à pour lancer une requête OAuth.
L'exemple suivant illustre une URL de développement en local (dans nos exemples,
localhost:8080
) et une URL de production.http://localhost:8080 https://myproductionurl.example.com
Le champ URI de redirection autorisé correspond au point de terminaison qui reçoit du serveur OAuth 2.0. Il s'agit généralement environnement de développement et pointe vers un chemin d'accès dans votre application.
http://localhost:8080/auth/google/callback https://myproductionurl.example.com/auth/google/callback
Cliquez sur Créer.
-
Dans la boîte de dialogue du client OAuth qui s'affiche, téléchargez le fichier JSON. contenant votre configuration client. Les détails de votre client sont les suivants : suivantes:
- ID client
- Code secret du client
Ce fichier JSON sera utilisé ultérieurement pour la configuration la bibliothèque Google Auth pour PHP qui fonctionne avec cette bibliothèque cliente.
Avant de pouvoir lancer une application publique qui accède à l'API Library, votre application doit être examinée par Google. Une "Application non validée" s'affiche sur le lorsque vous testez votre application, jusqu'à ce qu'elle soit validé.
Configurez la bibliothèque cliente
La bibliothèque cliente PHP gère tous les appels de l'API backend à votre place et expose compatibles, y compris des exemples de code pour certaines tâches courantes de l'API. Tout d'abord, téléchargez et installez la bibliothèque cliente de l'API Google Photos Library pour PHP, ainsi que les dépendances de GitHub. Configurez ensuite vos identifiants OAuth2 pour PHP.
Options de téléchargement
Utilisez composer.
pour l'inclure en tant que dépendance dans votre environnement de développement. Exécutez la
pour ajouter la bibliothèque à la configuration de votre projet et télécharger
dans le répertoire vendor/
.
composer require google/photos-library
Vous pouvez également clonez les un dépôt ou télécharger un fichier tarball.
Configurer vos identifiants OAuth2 pour PHP
Cette bibliothèque cliente fonctionne avec Bibliothèque Google Auth pour PHP Pour plus d'informations, consultez Utiliser OAuth 2.0 avec la bibliothèque cliente des API Google PHP
Utilisez les identifiants d'authentification renvoyés par la bibliothèque d'authentification lors de la configuration
le PhotosLibraryClient
.
Essayer quelques exemples
Essayez le code ci-dessous pour effectuer votre premier appel d'API à l'aide de la bibliothèque cliente 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;
}
Il y a plus samples sur GitHub à essayer.