Pour commencer à utiliser l'API Library de Google Photos, 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 de 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 le compte Google Photos d'un utilisateur, celui-ci 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, de s'authentifier et donc d'utiliser l'API Library. L'API Library n'est pas compatible avec les comptes de service. Pour l'utiliser, les utilisateurs doivent être connectés à un compte Google valide.
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, sélectionnez API et services > Bibliothèque dans le menu de navigation.
- Recherchez "API Library de Google Photos". Sélectionnez le résultat approprié, 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'intégralité du flux OAuth est gérée côté serveur, comme celle présentée dans nos exemples. Le processus de configuration peut varier pour d'autres scénarios de mise en œuvre.
- Accédez à la console Google APIs, puis 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 application de s'exécuter sur différents protocoles, domaines ou sous-domaines. Les URL que vous saisissez sont autorisées à lancer une requête OAuth.
L'exemple suivant présente une URL de développement local (nos exemples utilisent
localhost:8080) et une URL de production.http://localhost:8080 https://myproductionurl.example.comLe champ URI de redirection autorisé est le point de terminaison qui reçoit les réponses du serveur OAuth 2.0. En règle générale, cela inclut votre 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, copiez le code suivant:
- ID client
- Client secret (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. Le message "Application non validée" s'affiche à l'écran lorsque vous testez votre application, jusqu'à ce qu'elle soit validée.
Essayer l'exemple
Maintenant que vous avez configuré votre projet pour l'utiliser avec l'API Library, consultez l'application exemple sur GitHub. L'application exemple montre comment créer un cadre photo intelligent à l'aide de l'API Library.