Il 1° aprile 2025 sono stati rimossi alcuni ambiti nell'API Library.
Scopri di più qui.
Inizia a utilizzare l'API Picker
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
L'API Picker offre agli utenti un modo sicuro per selezionare foto e video dalla raccolta di Google Foto e condividerli con la tua applicazione.
Prima di iniziare
Flusso dell'API Picker
Ecco una panoramica del funzionamento dell'API Picker:
Verifica il token OAuth: prima di avviare il flusso dell'API Picker, verifica la presenza di un
token di accesso OAuth 2.0 valido per l'utente. Se non è presente alcun token, avvia il flusso di autorizzazione OAuth 2.0 per ottenerne uno.
Crea una sessione: avvia la procedura effettuando una chiamata all'API
Selettore per creare una nuova
sessione. Questa chiamata restituirà un pickerUri univoco.
Indirizza gli utenti all'app Google Foto: fornisci il pickerUri ai tuoi utenti (come link cliccabile o codice QR). Questo URL aprirà in modo sicuro l'app Google Foto.
L'utente seleziona gli elementi multimediali: all'interno dell'app Google Foto, gli utenti possono sfogliare
la propria raccolta e selezionare le foto e i video da condividere con
l'app. Leggi una panoramica dell'esperienza di selezione dell'utente.
Esegui il polling della sessione:l'app deve eseguire periodicamente il polling della sessione per controllare lo stato. Stai cercando che la proprietà mediaItemsSet restituisca true, a indicare che l'utente ha terminato la selezione.
Elenca gli elementi multimediali selezionati: una volta che mediaItemsSet restituisce true, puoi utilizzare il metodo list per ottenere i dettagli degli elementi multimediali selezionati.
Recuperare e utilizzare gli elementi multimediali: ora hai accesso agli elementi multimediali selezionati. Puoi recuperare i contenuti utilizzando baseUrl e utilizzarli all'interno della tua applicazione.
Passaggi successivi
- Consulta la documentazione di riferimento: esplora la documentazione di riferimento dell'API Picker dettagliata per conoscere tutti i metodi e i parametri disponibili.
- Prova gli esempi: dai un'occhiata al nostro esempio per vedere l'API Picker in azione e trovare ispirazione per la tua integrazione.
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-08-29 UTC.
[null,null,["Ultimo aggiornamento 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."]]
