Method: mediaItems.batchGet

Belirtilen medya öğesi tanımlayıcıları için medya öğelerinin listesini döndürür. Öğeler, sağlanan tanımlayıcılarla aynı sırayla 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ı içermemelidir ve boş bırakılamaz. Tek 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 almak için verilen 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ış. Alınan medya öğelerinin listesi. mediaItems.batchGet çağrısı başarılı olsa bile gruptaki bazı medya öğelerinde hata oluşmuş olabileceğini unutmayın. Bu hatalar her MediaItemResult.status'te 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
  • https://www.googleapis.com/auth/photoslibrary.readonly.originals

MediaItemResult

Bir medya öğesinin alınmasının sonucu.

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

object (Status)

Bu medya öğesine erişirken 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)

Kullanıcının kitaplığından alınan medya öğesi. Hata oluşmazsa ve medya öğesi başarıyla getirilirse doldurulur.