Pour commencer à utiliser les API Google Photos avec la bibliothèque cliente PHP, vous devez configurer 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 configurer 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 la bibliothèque Google Photos d'un utilisateur ou importez des éléments multimédias dans son compte Google Photos, l'utilisateur autorise ces requêtes d'API via le protocole OAuth 2.0.
L'ID client OAuth 2.0 permet aux utilisateurs de votre application de se connecter, et donc utiliser les API Photos. L'API Photos n'est pas compatible avec des comptes de service ; Pour utiliser cette API, les utilisateurs doivent être connectés à un compte Google Compte.
Configurer votre application
Activer l'API
Avant de pouvoir utiliser les API Photos, vous devez les 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, sélectionnez API et services > Bibliothèque dans le menu de navigation.
- Recherchez "Google Photos APIs" (API 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 dans laquelle l'ensemble du flux OAuth est géré côté serveur, comme dans nos exemples. La procédure de configuration peut varier pour d'autres scénarios d'implémentation.
- 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.
Enregistrez 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 application. Ce champ n'accepte pas les caractères génériques.
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 à 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.comLe 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/callbackCliquez 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 informations sur vos clients 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 aux API Photos, votre application doit être examinée par Google. Un message "Application non validée" s'affiche à l'écran lorsque vous testez votre application, jusqu'à ce qu'elle soit validée.
Configurez la bibliothèque cliente
La bibliothèque cliente PHP gère tous les appels d'API backend à votre place et expose des objets conviviaux à utiliser, y compris des exemples de code pour certaines tâches d'API courantes. Tout d'abord, téléchargez et installez la bibliothèque cliente des API Google Photos pour PHP, ainsi que les dépendances sur 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-libraryVous pouvez également cloner le dépôt ou télécharger un fichier tarball compressé.
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 des 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.