Method: mediaItems.batchGet

Belirtilen medya öğesi tanımlayıcıları için medya öğeleri listesini döndürür. Öğeler, sağlanan tanımlayıcılarla aynı sırada döndürülür.

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Sorgu parametreleri

Parametreler
mediaItemIds[]

string

Zorunlu. İstenecek medya öğelerinin tanımlayıcıları. Tekrarlanan tanımlayıcılar içermemelidir ve boş bırakılamaz. Bir çağrıda alınabilecek maksimum medya öğesi sayısı 50'dir.

İstek içeriği

İstek metni boş olmalıdır.

Yanıt gövdesi

Medya öğelerinin listesini alma yanıtı.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "mediaItemResults": [
    {
      object (MediaItemResult)
    }
  ]
}
Alanlar
mediaItemResults[]

object (MediaItemResult)

Yalnızca çıkış. Medya öğeleri listesi alındı. mediaItems.batchGet çağrısı başarılı olsa bile gruptaki bazı medya öğeleri için hatalar olabilir. Bu hatalar her MediaItemResult.status içinde belirtilir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

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

MediaItemResult

Medya öğesi alınmasının sonucu.

JSON gösterimi 
{
  "status": {
    object (Status)
  },
  "mediaItem": {
    object (MediaItem)
  }
}
Alanlar
status

object (Status)

Bu medya öğesine erişilirken bir hata oluştuysa bu alan, hatayla ilgili bilgilerle doldurulur. Bu alanla ilgili ayrıntılar için Status başlıklı makaleyi inceleyin.
mediaItem

object (MediaItem)

Medya öğesi, kullanıcının kitaplığından alındı. Herhangi bir hata olmadıysa ve medya öğesi başarıyla getirildiyse bu alan doldurulur.