Elenca e recupera gli elementi multimediali

Dopo che un utente ha selezionato elementi multimediali utilizzando l'API Picker, puoi recuperare le relative informazioni e accedere ai relativi contenuti. Questa guida illustra la procedura di elencazione e recupero degli elementi multimediali.

Prima di iniziare

  • Comprendi il flusso: consulta la sezione Iniziare a utilizzare l'API Picker per una panoramica dell'intero processo di selezione delle foto.
  • Selezione completa di elementi multimediali:assicurati che l'utente abbia selezionato correttamente gli elementi multimediali dalla sessione. Per ulteriori dettagli, consulta la guida sulle sessioni.
  • Esamina gli ambiti di autorizzazione richiesti: per lavorare con le sessioni è necessario l'ambitophotospicker.mediaitems.readonly. Per ulteriori informazioni sugli ambiti, consulta Ambiti di autorizzazione.

Elenca gli elementi multimediali selezionati

  1. Utilizza l'endpoint mediaItems.list: invia una richiesta GET a https://photospicker.googleapis.com/v1/mediaItems, fornendo sessionId come parametro di query.

  2. Gestisci la paginazione (se necessario):

    Se l'utente seleziona un numero elevato di elementi, la risposta potrebbe essere suddivisa in pagine. Utilizza nextPageToken nella risposta per recuperare le pagine di risultati successive.

  3. Elabora gli elementi multimediali: la risposta conterrà un array di oggetti PickedMediaItem, ciascuno dei quali rappresenta un elemento multimediale selezionato. Questi oggetti includono dettagli essenziali come:

    • id: l'identificatore univoco dell'elemento multimediale.
    • baseUrl: l'URL di base da cui puoi creare URL per accedere ai contenuti dell'elemento multimediale a varie risoluzioni.
    • mimeType: il tipo MIME dell'elemento multimediale (ad es. image/jpeg, video/mp4).

Recupera gli elementi multimediali selezionati

Assicurati di disporre di un token di accesso OAuth 2.0 valido con l'ambito https://www.googleapis.com/auth/photospicker.mediaitems.readonly per autorizzare le tue richieste.

  • Crea l'URL dei contenuti: utilizza baseUrl dell'oggetto PickedMediaItem. Aggiungi la risoluzione o il formato del file a baseUrl. Per ulteriori dettagli, consulta la sezione sugli URL di base.

  • Recupero dei contenuti:effettua una richiesta GET all'URL di base dell'elemento multimediale. La risposta conterrà i byte dell'elemento multimediale (immagine o video). Esistono diverse opzioni baseURL.

URL di base

Gli URL di base nelle API di Google Foto forniscono l'accesso ai byte non elaborati degli elementi multimediali, consentendo alla tua app di scaricarli o visualizzarli. Questi URL sono inclusi nelle risposte quando vengono elencati gli album (API Library) o si accede agli elementi multimediali (API Library e Picker). Ricorda che gli URL di base richiedono parametri aggiuntivi per funzionare correttamente.

Per l'API Picker:

Tutti gli oggetti PickedMediaItem.mediaFile includono un baseUrl.

Gli URL di base rimangono attivi per 60 minuti, ma possono scadere prima se l'utente revoca le autorizzazioni della tua app tramite le impostazioni del suo Account Google.

Per l'API Library:

Gli URL di base rimangono attivi per 60 minuti.

I vari URL di base sono:

  • baseUrl: accedi direttamente a una foto, a una miniatura di un video o scarica i dati video.
  • coverPhotoBaseUrl: accedi direttamente alla foto di copertina dell'album.
  • profilePictureBaseUrl: accedi direttamente alla foto del profilo del proprietario di un mediaItem.

URL di base delle immagini

Ecco l'elenco di opzioni che puoi utilizzare con gli URL per le immagini base:

Parametro
w, h

Descrizione

I parametri larghezza, w e altezza, h.

Per accedere a un elemento multimediale immagine, ad esempio una foto o una miniatura di un video, devi specificare le dimensioni che prevedi di visualizzare nella tua applicazione (in modo che l'immagine possa essere ridimensionata in queste dimensioni mantenendo le proporzioni). Per farlo, concatena l'URL base con le dimensioni richieste come mostrato negli esempi.

Esempi:

base-url=wmax-width-hmax-height

Ecco un esempio per visualizzare un elemento multimediale non più largo di 2048 px e non più alto di 1024 px:

https://lh3.googleusercontent.com/p/AF....VnnY=w2048-h1024
c

Descrizione

Parametro c di ritaglio.

Se vuoi ritagliare l'immagine in base alle dimensioni esatte di larghezza e altezza specificate, concatena l'URL di base con il parametro facoltativo -c insieme ai parametri obbligatori w e h.

Le dimensioni (in pixel) devono essere comprese nell'intervallo [1, 16383]. Se la larghezza o l'altezza dell'immagine superano le dimensioni richieste, l'immagine viene ridimensionata e ritagliata (mantenendo le proporzioni).

Esempi:

base-url=wmax-width-hmax-height-c

In questo esempio, l'applicazione mostra un elemento multimediale di esattamente 256 px di larghezza per 256 px di altezza, come una miniatura:

https://lh3.googleusercontent.com/p/AF....VnnY=w256-h256-c
d

Descrizione

Il parametro download, d.

Se vuoi scaricare l'immagine mantenendo tutti i metadati Exif tranne i metadati sulla posizione, concatena l'URL di base con il parammetro d.

Esempi:

base-url=d

In questo esempio, l'applicazione scarica un'immagine con tutti i metadati tranne i metadati sulla posizione:

https://lh3.googleusercontent.com/p/Az....XabC=d

URL di base dei video

Di seguito è riportato l'elenco delle opzioni che puoi utilizzare con gli URL di base dei video:

Parametro
dv

Descrizione

Per accedere ai byte di un video mediaItem, concatena il baseUrl con il parametro dv per il download del video.

Il parametro dv richiede una versione transcodificata di alta qualità del video originale. Il parametro non è compatibile con i parametri w e h.

Per gli URL di base per i download dei video, il ritorno dei byte può richiedere fino a qualche secondo.

Prima di utilizzare questo parametro, verifica che il campo mediaMetadata.status dell'elemento multimediale sia READY. In caso contrario, se l'elaborazione dell'elemento multimediale non è stata completata, potresti ricevere un messaggio di errore.

Esempi:

base-url=dv

L'esempio seguente mostra come scaricare i byte di un video:

https://lh3.googleusercontent.com/p/AF....BsdZ=dv
w, h, c e d

Descrizione

Per accedere alla miniatura del video, utilizza uno dei parametri URL immagine base.

Per impostazione predefinita, tutte le miniature dei video includono un overlay di un pulsante di riproduzione. Consulta il parametro -no per rimuovere questo overlay.

Esempi:

Consulta la tabella degli URL di base delle immagini per alcuni esempi.
no

Descrizione

Il parametro no per rimuovere l'overlay della miniatura.

Se vuoi recuperare la miniatura di un video senza l'overlay di un pulsante di riproduzione, concatena l'URL di base con il parametro no.

Il parametro no deve essere utilizzato con almeno uno dei parametri URL immagine di base.

Esempi:

base-url=wmax-width-hmax-height-no

L'esempio seguente mostra una miniatura di un video che ha esattamente 1280 px di larghezza e 720 px di altezza e non include un overlay del pulsante di riproduzione:

https://lh3.googleusercontent.com/p/AF....VnnY=w1280-h720-no

URL di base delle foto in movimento

Le foto in movimento contengono elementi sia fotografici che video. Puoi utilizzare i parametri degli URL di base delle immagini o degli URL di base dei video per le richieste di foto in movimento baseUrl.

Parametro
dv

Descrizione

Per recuperare l'elemento video di un elemento multimediale di una foto in movimento, utilizza il parametro dv come faresti per scaricare gli URL di base dei video.
w, h, c e d

Descrizione

Per recuperare l'elemento di foto di un elemento multimediale di foto in movimento, utilizza il formato per gli URL base delle immagini.