Introdução à API Picker
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
A API Picker oferece uma maneira segura para os usuários selecionarem fotos e vídeos
da biblioteca do Google Fotos e compartilhar com o aplicativo.
Antes de começar
Fluxo da API Picker
Confira uma visão geral de como a API Picker funciona:
Verifique o token do OAuth:antes de iniciar o fluxo da API Picker, verifique se há um
token de acesso OAuth 2.0 válido para o usuário. Se não houver um token, inicie
o fluxo de autorização do OAuth 2.0 para receber um.
Criar uma sessão:inicie o processo fazendo uma chamada para a API
Picker para criar uma nova
sessão. Essa chamada
vai retornar um pickerUri exclusivo.
Direcione os usuários ao app Google Fotos:forneça o pickerUri
aos usuários (como um link clicável ou um código QR). Esse URL vai
abrir o app Google Fotos com segurança.
O usuário seleciona itens de mídia:no app Google Fotos, os usuários podem navegar
pela biblioteca e selecionar as fotos e os vídeos que querem compartilhar com seu
app. Leia uma visão geral da experiência de seleção do usuário.
Solicitar a sessão:o app precisa solicitar a sessão
periodicamente para verificar o status. Você quer que a propriedade
mediaItemsSet
retorne "true", indicando que o usuário terminou a seleção.
Listar itens de mídia selecionados:depois que mediaItemsSet retornar "true", você poderá
usar o método de lista para
conferir detalhes sobre os itens de mídia selecionados.
Recuperar e usar itens de mídia:agora você tem acesso aos itens de mídia
selecionados. É possível buscar o
conteúdo
usando o
baseUrl
e usá-los no seu app.
Próximas etapas
- Analise os documentos de referência: consulte a documentação de referência da API
Picker para saber mais sobre todos
os métodos e parâmetros disponíveis.
- Teste os exemplos: confira nosso exemplo (em inglês) para ver
a API Picker em ação e se inspirar para sua integração.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-08-29 UTC.
[null,null,["Última atualização 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."]]
