Method: mediaItems.batchGet

Restituisce l'elenco di elementi multimediali per gli identificatori degli elementi multimediali specificati. Gli articoli vengono restituiti nello stesso ordine degli identificatori forniti.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri di ricerca

Parametri
mediaItemIds[]

string

obbligatorio. Identificatori degli elementi multimediali da richiedere. Non deve contenere identificatori ripetuti e non può essere vuoto. Il numero massimo di elementi multimediali che è possibile recuperare in una chiamata è 50.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

Risposta per recuperare un elenco di elementi multimediali.

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

Rappresentazione JSON 
{
  "mediaItemResults": [
    {
      object (MediaItemResult)
    }
  ]
}
Campi
mediaItemResults[]

object (MediaItemResult)

Solo output. Elenco di elementi multimediali recuperati. Tieni presente che, anche se la chiamata a mediaItems.batchGet ha esito positivo, potrebbero verificarsi errori per alcuni elementi multimediali nel batch. Questi errori sono indicati in ogni MediaItemResult.status.

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

MediaItemResult

Risultato del recupero di un elemento multimediale.

Rappresentazione JSON 
{
  "status": {
    object (Status)
  },
  "mediaItem": {
    object (MediaItem)
  }
}
Campi
status

object (Status)

Se si è verificato un errore durante l'accesso a questo elemento multimediale, in questo campo vengono compilate le informazioni relative all'errore. Per maggiori dettagli su questo campo, consulta Status.
mediaItem

object (MediaItem)

Elemento multimediale recuperato dalla raccolta dell'utente. Viene compilato se non si sono verificati errori e l'elemento multimediale è stato recuperato correttamente.