Premiers pas avec l'API Picker

L'API Picker permet à vos utilisateurs de sélectionner des photos et des vidéos dans leur bibliothèque Google Photos et de les partager avec votre application de manière sécurisée.

Avant de commencer

Flux de l'API Picker

Voici une présentation du fonctionnement de l'API Picker :

  1. Recherchez un jeton OAuth : avant de commencer le flux de l'API Picker, recherchez un jeton d'accès OAuth 2.0 valide pour l'utilisateur. S'il n'y en a pas, lancez le flux d'autorisation OAuth 2.0 pour en obtenir un.

  2. Créez une session : lancez le processus en appelant l'API Picker pour créer une session. Cet appel renvoie un pickerUri unique.

  3. Redirigez les utilisateurs vers l'application Google Photos : fournissez le pickerUri à vos utilisateurs (sous forme de lien cliquable ou de code QR). Cette URL ouvrira l'application Google Photos de l'utilisateur de manière sécurisée. Pour les applications Web, vous pouvez ajouter /autoclose à cet URI pour fermer automatiquement la fenêtre Google Photos une fois que l'utilisateur a terminé sa sélection.

  4. L'utilisateur sélectionne des éléments multimédias : dans l'application Google Photos, les utilisateurs peuvent parcourir leur bibliothèque et sélectionner les photos et vidéos qu'ils souhaitent partager avec votre application. Consultez un aperçu de l'expérience de sélection de l'utilisateur.

  5. Interrogez la session : votre application doit interroger régulièrement la session pour vérifier son état. Vous recherchez la propriété mediaItemsSet qui renvoie "true", indiquant que l'utilisateur a terminé sa sélection.

  6. Lister les éléments multimédias sélectionnés : une fois que mediaItemsSet renvoie "true", vous pouvez utiliser la méthode list pour obtenir des informations sur les éléments multimédias sélectionnés.

  7. Récupérer et utiliser des éléments multimédias : vous avez désormais accès aux éléments multimédias sélectionnés. Vous pouvez récupérer leur contenu à l'aide de baseUrl et l'utiliser dans votre application.

Étapes suivantes

  • Consultez la documentation de référence : explorez la documentation de référence de l'API Picker pour en savoir plus sur toutes les méthodes et tous les paramètres disponibles.
  • Essayez les exemples : consultez notre exemple pour voir l'API Picker en action et trouver l'inspiration pour votre intégration.