Le 1er avril 2025, certains champs d'application de l'API Library ont été supprimés.
En savoir plus
Premiers pas avec l'API Picker
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
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
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.
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.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/29 (UTC).
[null,null,["Dernière mise à jour le 2025/08/29 (UTC)."],[[["\u003cp\u003eThe Picker API lets users securely select photos and videos from their Google Photos library and share them with your application.\u003c/p\u003e\n"],["\u003cp\u003eBefore using the Picker API, ensure it's the right fit for your use case and properly configure your app with the necessary API and authentication setup.\u003c/p\u003e\n"],["\u003cp\u003eThe Picker API flow involves creating a session, directing users to the Google Photos app for selection, polling the session for completion, and then retrieving the selected media items.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers should check the provided resources like reference documentation and samples for detailed information and implementation examples.\u003c/p\u003e\n"]]],["The Picker API enables users to share media from Google Photos with your app. First, check for and obtain an OAuth token. Then, create a new session via the Picker API, generating a `pickerUri`. Direct users to this URI to select media. Periodically poll the session until `mediaItemsSet` is true. Use the list method to retrieve details of selected items, and then access their content using `baseUrl` for use in your application.\n"],null,["# Get started with the Picker API\n\nThe Picker API provides a secure way for your users to select photos and videos\nfrom their Google Photos library and share them with your application.\n\nBefore you start\n----------------\n\n- **Check out the overview:** [Compare the Picker API and the Library API](/photos/overview/about) to make sure the Picker API is the right fit for your use case.\n- **Configure your app:** Enable the API and set up authentication. See [Configure your app](/photos/overview/configure-your-app) for detailed steps.\n\nThe Picker API flow\n-------------------\n\nHere is an overview of the how the Picker API works:\n\n1. **Check for OAuth token:** Before starting the Picker API flow, check for a\n valid OAuth 2.0 access token for the user. If there is no token, [initiate\n the OAuth 2.0 authorization flow](/identity/protocols/oauth2) to obtain one.\n\n2. **Create a session:** Initiate the process by making a call to the Picker\n API to [create a new\n session](/photos/picker/reference/rest/v1/sessions/create). This call will\n return a unique `pickerUri`.\n\n3. **Direct users to the Google Photos app:** Provide the [`pickerUri`](/photos/picker/reference/rest/v1/sessions#PickingSession.FIELDS.picker_uri)\n to your users (either as a clickable link or a QR code). This URL will\n securely open their Google Photos app.\n\n4. **User selects media items:** Within the Google Photos app, users can browse\n their library and select the photos and videos they want to share with your\n app. Read an overview of the [user's picking experience](/photos/picker/guides/picking-experience).\n\n5. **Poll the session:** Your app should periodically [poll the session](/photos/picker/reference/rest/v1/sessions/get)\n to check the status. You're looking for the\n [`mediaItemsSet`](/photos/picker/reference/rest/v1/sessions#PickingSession.FIELDS.media_items_set)\n property to return true, indicating the user has finished their selection.\n\n | **Note:** Every time you poll a session the response contains [recommended\n | intervals and\n | timeouts](/photos/picker/reference/rest/v1/sessions#PollingConfig) to configure your polling.\n6. **List selected media items:** Once `mediaItemsSet` returns true, you can\n use [the list method](/photos/picker/reference/rest/v1/mediaItems/list) to\n get details about the selected media items.\n\n7. **Retrieve and use media items:** Now you have access to the selected media\n items. You can [fetch their\n content](/photos/picker/guides/media-items#retrieve-picked-media-items)\n using the\n [`baseUrl`](/photos/picker/reference/rest/v1/mediaItems#MediaFile.FIELDS.base_url)\n and utilize them within your application.\n\nNext steps\n----------\n\n- Review the reference docs: Explore the detailed [Picker API reference\n documentation](/photos/picker/reference/rest) to learn about all the available methods and parameters.\n- Try out the samples: Check out our [sample](/photos/picker/samples) to see the Picker API in action and get inspiration for your integration."]]
