Inizia a utilizzare l'API Picker

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

Dai un'occhiata alla panoramica: confronta l'API Picker e l'API Library per assicurarti che l'API Picker sia adatta al tuo caso d'uso.
Configura l'app:abilita l'API e configura l'autenticazione. Per i passaggi dettagliati, vedi Configurare l'app.

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.

Nota: ogni volta che esegui il polling di una sessione, la risposta contiene intervalli e timeout consigliati per configurare il polling.
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.