Premiers pas avec l'API Picker

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

Avant de commencer

Consultez la présentation:Comparez l'API Picker et l'API Library pour vous assurer que l'API Picker est adaptée à votre cas d'utilisation.
Configurer votre application:activez l'API et configurez l'authentification. Pour en savoir plus, consultez la section Configurer votre application.

Flux de l'API Picker

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

Vérifier le jeton OAuth:avant de démarrer le flux de l'API Picker, recherchez un jeton d'accès OAuth 2.0 valide pour l'utilisateur. Si aucun jeton n'est disponible, lancez le flux d'autorisation OAuth 2.0 pour en obtenir un.
Créer une session:lancez le processus en appelant l'API de sélecteur pour créer une session. Cet appel renvoie un pickerUri unique.
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.
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 une présentation de l'expérience de sélection de l'utilisateur.
Interroger la session:votre application doit interroger régulièrement la session pour vérifier son état. Vous souhaitez que la propriété mediaItemsSet renvoie la valeur "true", ce qui indique que l'utilisateur a terminé sa sélection.

Remarque :Chaque fois que vous interrogez une session, la réponse contient des intervalles et des délais recommandés pour configurer l'interrogation.
Liste des éléments multimédias sélectionnés:une fois que mediaItemsSet renvoie la valeur "true", vous pouvez utiliser la méthode list pour obtenir des informations sur les éléments multimédias sélectionnés.
Récupérer et utiliser les é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 les utiliser dans votre application.

Étapes suivantes

Consultez la documentation de référence: consultez 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 des idées pour votre intégration.