Method: mediaItems.batchGet

Restituisce l'elenco di elementi multimediali per gli identificatori di elementi multimediali specificati. Gli elementi 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 query

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 possono essere recuperati 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 va a buon fine, potrebbero esserci stati 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
  • https://www.googleapis.com/auth/photoslibrary.readonly.originals

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, questo campo viene compilato con le informazioni relative all'errore. Per informazioni dettagliate 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.