Vous consultez actuellement l'ancienne documentation de l'API Library de Google Photos.

Découvrez les mises à jour de l'API Library.
Revenez à la documentation actuelle de l'API Photos.

Cette page a été traduite par l'API Cloud Translation.

Premiers pas avec REST

Pour commencer à utiliser l'API Library de Google Photos, configurez votre projet en l'activant 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 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:
1. Pour identifier l'ID client, saisissez un nom.
2. 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
```
3. 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
```
4. Cliquez sur Créer.

Dans la boîte de dialogue du client OAuth qui s'affiche, copiez les éléments suivants:
- ID client
- Code secret du client
Votre application peut accéder aux API Google activées à l'aide de ces valeurs.

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é.

Essayer l'exemple

Maintenant que vous avez configuré votre projet pour l'utiliser avec l'API Library, consultez l'application exemple sur GitHub. Application exemple montre comment créer un cadre photo intelligent à l'aide de l'API Library.