Configurer votre application

Pour commencer à utiliser les API Google Photos, configurez votre projet en activant les API Photos dont vous avez besoin à l'aide de 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. 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 API à l'aide du 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 les API Photos. Les API Photos ne sont pas compatibles avec les comptes de service. Pour utiliser ces API, les utilisateurs doivent être connectés à un compte Google valide.

Configurer votre application

Commencez par activer l'API, puis demandez un ID client OAuth 2.0.

Activer l'API

Avant de pouvoir utiliser les API Photos, vous devez les activer dans votre projet.

  1. Accédez à la console Google APIs.
  2. Dans la barre de menu, sélectionnez un projet ou créez-en un.
  3. Pour ouvrir l'une des API Google Photos, dans le menu de navigation, sélectionnez API et services > Bibliothèque.
  4. Recherchez "Photos". Sélectionnez une ou plusieurs API Photos, puis cliquez sur Activer.

Capture d'écran des API de sélecteur dans la console Google Cloud

Demander un ID client OAuth 2.0

Pour demander un ID client OAuth et le configurer pour votre application, procédez comme suit : Cet exemple utilise une application dans laquelle l'intégralité du flux OAuth est gérée côté serveur, comme celle de nos exemples. Le processus de configuration peut varier pour d'autres scénarios d'implémentation.

  1. Accédez à la console Google APIs, puis sélectionnez votre projet.
  2. Dans le menu, sélectionnez API et services > Identifiants.

  3. Sur la page Identifiants, cliquez sur Créer des identifiants > ID client OAuth.

  4. Sélectionnez le type d'application. Dans cet exemple, le type d'application est Web application (Application Web).

  5. Enregistrez 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 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 montre une URL de développement en local (nos exemples utilisent localhost:8080) et une URL de production.

        http://localhost:8080
    https://myproductionurl.example.com
    ```

1.  The **Authorized redirect URI** field is the endpoint that receives
    responses from the OAuth 2.0 server. Typically, this includes your
    development environment and points to a path in your application.

```none
    http://localhost:8080/auth/google/callback
    https://myproductionurl.example.com/auth/google/callback
    ```

1.  Click **Create**.

  1. 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 aux API Photos, 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.

Une fois que vous avez configuré votre application, vous êtes prêt à commencer:

Modifier votre ID client

Les ressources créées via les API Google Photos ne sont accessibles ou modifiées qu'à l'aide de l'ID client d'origine utilisé pour les créer. Par exemple, si vous créez une "session" dans l'API Picker avec un ID client spécifique et que vous modifiez cet ID client ultérieurement dans votre application, votre application perdra l'accès à toutes les ressources API créées avec l'ID client précédent.

Planifiez soigneusement votre déploiement et choisissez le type d'ID client approprié pour l'API Photos que vous utilisez. Ne modifiez votre ID client que si cela est absolument nécessaire pour éviter les problèmes d'accès.