Il 1° aprile 2025 sono stati rimossi alcuni ambiti nell'API Library.
Scopri di più qui.
Selezione di foto: cosa vedono gli utenti
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Questa guida ti aiuta a comprendere l'esperienza dell'utente quando sceglie gli elementi multimediali.
Seguendo il flusso standard dell'API Picker, la selezione inizia dopo che l'app mostra pickerUri e mentre l'app esegue il polling per fare in modo che mediaItemsSet restituisca true.
Per visualizzare uno di questi passaggi sul tuo dispositivo, dai un'occhiata alla nostra app di esempio.
Avvia la sessione di scelta
Dopo aver creato una sessione, l'app deve mostrare pickerUri ai suoi utenti.
- Mostra
pickerUri sia come codice QR sia come URL.
- Fornisci un testo utile accanto a
pickerUri. Ad esempio, "Scansiona questo codice per aprire Google Foto e selezionare i tuoi articoli".
- Per i dispositivi con funzionalità di inserimento limitate (ad es. chioschi, tablet, smart TV), consulta i consigli del produttore dell'hardware sulle dimensioni del testo e sulla larghezza del codice QR.
Cercare e selezionare le foto
Quando un utente accede al pickerUri, viene indirizzato a una pagina di selezione delle foto
all'interno dell'app Google Foto.
In questa pagina verranno sempre visualizzate le foto più recenti della raccolta di Google Foto dell'utente. Gli album, i preferiti e altre categorie di foto comuni non vengono visualizzati direttamente. Gli utenti possono cercare foto utilizzando vari criteri, come parole chiave, date, località e titoli degli album.
Se la tua app utilizza album, date o altre categorie di foto comuni, aiuta i tuoi utenti chiedendo di eseguire una ricerca non appena aprono l'app Google Foto.
Ad esempio, se chiedi agli utenti di condividere un album specifico, puoi includere il seguente testo nella stessa pagina in cui gli utenti si connettono a Google Foto: "Connettiti a Google Foto, quindi cerca l'album che vuoi condividere".
Dopo la ricerca, l'utente può selezionare uno o più elementi dai risultati.
Schermata Fine
Una volta che l'utente tocca il pulsante "Fine" e completa la selezione, viene visualizzata la schermata "Fine". La sessione di picking termina e l'pickerUri
attuale non funzionerà più.
Per offrire agli utenti la possibilità di selezionare altre foto, crea una nuova sessione di selezione e mostra di nuovo il pulsante pickerUri nella tua app.
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.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Mancano le informazioni di cui ho bisogno","missingTheInformationINeed","thumb-down"],["Troppo complicato/troppi passaggi","tooComplicatedTooManySteps","thumb-down"],["Obsoleti","outOfDate","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Problema relativo a esempi/codice","samplesCodeIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 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."]]
