Method: mediaItems.list

Elencare tutti gli elementi multimediali della raccolta Google Foto di un utente.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri di ricerca

Parametri
pageSize

integer

Numero massimo di elementi multimediali da restituire nella risposta. È possibile che vengano restituiti meno elementi multimediali rispetto al numero specificato. Il valore predefinito di pageSize è 25, il massimo è 100.

pageToken

string

Un token di continuazione per visualizzare la pagina successiva dei risultati. Se aggiungi questo elemento alla richiesta, vengono restituite le righe che seguono pageToken. pageToken deve essere il valore restituito nel parametro nextPageToken nella risposta alla richiesta listMediaItems.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

L'elenco di tutti gli elementi multimediali della raccolta di Google Foto dell'utente.

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

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

object (MediaItem)

Solo output. Elenco di elementi multimediali nella raccolta dell'utente.

nextPageToken

string

Solo output. Token da utilizzare per ottenere il successivo insieme di elementi multimediali. La sua presenza è l'unico indicatore affidabile della disponibilità di altri elementi multimediali nella richiesta successiva.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/photoslibrary
  • https://www.googleapis.com/auth/photoslibrary.readonly
  • https://www.googleapis.com/auth/photoslibrary.readonly.appcreateddata