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

• Consulta la panoramica:confronta l'API Picker e l'API Library per assicurarti che l'API Picker sia adatta al tuo caso d'uso.
• Configura la tua app:abilita l'API e configura l'autenticazione. Per la procedura dettagliata, vedi Configurare l'app.

Flusso dell'API Picker

Ecco una panoramica del funzionamento dell'API Picker:

1. Controlla il token OAuth:prima di iniziare 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.

2. Crea una sessione:avvia la procedura effettuando una chiamata all'API Picker per creare una nuova sessione. Questa chiamata restituirà un pickerUri univoco.

3. Indirizza gli utenti all'app Google Foto:fornisci l'pickerUri ai tuoi utenti (come link selezionabile o codice QR). Questo URL aprirà in modo sicuro l'app Google Foto. Per le applicazioni basate sul web, puoi aggiungere /autoclose a questo URI per chiudere automaticamente la finestra di Google Foto dopo che l'utente ha completato la selezione.

4. 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 che vogliono condividere con la tua app. Leggi una panoramica dell'esperienza di selezione dell'utente.

5. Esegui il polling della sessione:la tua app deve eseguire periodicamente il polling della sessione per controllare lo stato. Stai cercando la proprietà mediaItemsSet che restituisce il valore 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.

6. Elenca gli elementi multimediali selezionati:una volta che mediaItemsSet restituisce true, puoi utilizzare il metodo list per ottenere dettagli sugli elementi multimediali selezionati.

7. Recupera e utilizza gli elementi multimediali:ora hai accesso agli elementi multimediali selezionati. Puoi recuperare i loro 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 scoprire tutti i metodi e i parametri disponibili.
• Prova gli esempi: dai un'occhiata al nostro esempio per vedere l'API Picker in azione e trarre ispirazione per la tua integrazione.