Escolha de fotos: o que os usuários veem
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Este guia ajuda você a entender a experiência do usuário ao escolher itens de mídia.
Seguindo o fluxo padrão da API Picker,
a seleção começa depois que o app exibe o pickerUri
e enquanto o app está pesquisando para que mediaItemsSet retorne verdadeiro.
Para conferir qualquer uma dessas etapas no seu dispositivo, confira nosso app de exemplo.
Iniciar a sessão de escolha
Depois de criar uma sessão, o app vai mostrar o pickerUri aos
usuários.
- Mostrar o
pickerUri como um QR code e um URL.
- Forneça um texto útil com o
pickerUri. Por exemplo, "Digitalize este código
para abrir o Google Fotos e selecionar seus itens".
- Para dispositivos com recursos de entrada limitados (por exemplo, quiosques, tablets, smart
TVs), verifique as recomendações do fabricante do hardware sobre o tamanho do texto e a largura do
código QR.
Pesquisar e selecionar fotos
Quando um usuário acessa o pickerUri, ele é direcionado para uma página de seleção de fotos
no app Google Fotos.
Essa página sempre vai mostrar as fotos mais recentes da biblioteca do Google
Fotos do usuário. Álbuns, favoritos e outras categorias de fotos comuns não são
mostrados diretamente. Os usuários podem pesquisar fotos usando vários critérios,
como palavras-chave, datas, locais e títulos de álbuns.
Se o app usa álbuns, datas ou outras categorias de fotos comuns, ajude os
usuários a pesquisar assim que entrarem no app Google Fotos.
Por exemplo, se você pedir que os usuários compartilhem um álbum específico, inclua
o texto a seguir na mesma página em que os usuários se conectam ao Google Fotos:
"Conecte-se ao Google Fotos e pesquise o álbum que você quer compartilhar".
Depois de pesquisar, o usuário pode selecionar um ou mais itens nos resultados.
Tela "Concluído"
Quando o usuário tocar no botão "Concluído" e concluir a seleção, a tela "Concluído" vai aparecer. Isso encerra a sessão de seleção, e o pickerUri
atual não vai mais funcionar.
Para oferecer aos usuários a opção de selecionar mais fotos, crie uma nova sessão
de seleção e mostre o pickerUri novamente no app.
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.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-29 UTC."],[[["\u003cp\u003eThis guide explains the user experience within the Google Photos app when selecting media items using the Picker API.\u003c/p\u003e\n"],["\u003cp\u003eUsers initiate the process by accessing the \u003ccode\u003epickerUri\u003c/code\u003e displayed in your app, which opens a photo selection page within Google Photos.\u003c/p\u003e\n"],["\u003cp\u003eUsers can search and select photos from their Google Photos library using various criteria before confirming their choices.\u003c/p\u003e\n"],["\u003cp\u003eAfter selection, users are presented with a "Done" screen, and your app can re-display the \u003ccode\u003epickerUri\u003c/code\u003e to allow for further selections in a new session.\u003c/p\u003e\n"]]],["The core process involves displaying a `pickerUri` (QR code and URL) to users, prompting them to access it. This takes them to Google Photos for photo selection. Users can search using keywords, dates, or locations to find specific photos. Upon selection and pressing \"Done,\" the process ends. Apps can offer to display the `pickerUri` again to initiate a new picking session, to select more items. While the app is polling for the media selection the process has begun.\n"],null,["# Photo picking: what users see\n\nThis guide helps you understand your user's experience when picking media items.\n\nFollowing the [standard Picker API flow](/photos/picker/guides/get-started-picker#the_picker_api_flow),\npicking beings after your app displays the [`pickerUri`](/photos/picker/reference/rest/v1/sessions#PickingSession.FIELDS.picker_uri),\nand while your app is polling for [`mediaItemsSet`](/photos/picker/reference/rest/v1/sessions#PickingSession.FIELDS.media_items_set) to return true.\n\nTo view any of these steps on your own device, check out our [sample app](/photos/picker/samples).\n\nStart the picking session\n-------------------------\n\nAfter successfully creating a session your app should display the `pickerUri` to\nyour users.\n\n- Display the `pickerUri` as both a QR code and a URL.\n- Provide helpful text alongside the `pickerUri`. For example, \"Scan this code to open Google Photos and select your items.\".\n- For devices with limited input capabilities (e.g., kiosks, tablets, smart TVs), check your hardware manufacture's recommendations on text size and QR code width.\n\nSearch and select photos\n------------------------\n\nWhen a user accesses the `pickerUri`, they are taken to a photo selection page\nwithin the Google Photos app.\n\nThis page will always display the most recent photos from your user's Google\nPhotos library. Albums, favorites, and other common photos categories are not\nshow directly. Users can search for photos using various criteria,\nsuch as keywords, dates, locations, and album titles.\n\nIf your app utilizes albums, dates, or other common photos categories, help your\nusers by prompting them to search once they enter the Google Photos app.\n\nFor example, if your asking your users to share a specific album, you could\ninclude the following text on the same page your users connect to Google Photos:\n\"Connect to Google Photos, then search for the album you want to share.\"\n\nAfter searching, the user can select one or more items from the results.\n\nDone screen\n-----------\n\nOnce the user taps the \"Done\" button and completes picking, they will see\nthe \"Done\" screen. This ends the picking session and the current `pickerUri`\nwill no longer work.\n\nTo provide your users the option to select more photos, create a new picking\nsession and display the `pickerUri` again in your app."]]
