Method: mediaItems.list

Restituisce un elenco di elementi multimediali scelti dall'utente durante la sessione specificata.

Se la sessione non ha ancora elementi multimediali scelti e di conseguenza non può restituire contenuti multimediali, verrà restituito un errore FAILED_PRECONDITION. In questo scenario, le applicazioni in esecuzione su dispositivi con input limitato dovrebbero visualizzare un codice QR che codifica l'elemento pickerUri della sessione, invitando l'utente a eseguire la scansione del codice e a scegliere gli elementi multimediali nell'interfaccia utente del selettore di Google Foto. Mentre attendi che l'utente scelga gli articoli, i clienti devono condurre un sondaggio su sessions.get, una volta ogni pollingConfig.pollInterval, fino al giorno pickedItemsSet = true nella risposta sessions.get. A quel punto, i clienti potrebbero riprendere a chiamare mediaItems.list e aspettarsi una risposta corretta.

Richiesta HTTP

GET https://photospicker.googleapis.com/v1/mediaItems

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri di query

Parametri
sessionId

string

Obbligatorio. L'identificatore generato da Google per questa sessione.
pageSize

integer

(Facoltativo) Il numero massimo di elementi multimediali da restituire.

Il servizio potrebbe restituire un valore inferiore a questo valore (inclusi zero risultati). Se il valore non è specificato o se viene impostato su 0, verranno restituiti al massimo 50 elementi multimediali. Il valore massimo è 100; valori superiori a 100 verranno forzati a 100. I valori negativi comportano un errore INVALID_ARGUMENT.
pageToken

string

(Facoltativo) Un token di pagina, ricevuto da una precedente chiamata a mediaItems.list. Forniscilo per recuperare la pagina successiva.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

Una risposta all'RPC mediaItems.list.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "mediaItems": [
    {
      object (PickedMediaItem)
    }
  ],
  "nextPageToken": string
}
Campi
mediaItems[]

object (PickedMediaItem)

Una pagina di elementi multimediali selezionati.
nextPageToken

string

Un token, che può essere inviato come pageToken per recuperare la pagina successiva in una richiesta mediaItems.list.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/photospicker.mediaitems.readonly