Method: mediaItems.list

Belirtilen oturum sırasında kullanıcının seçtiği medya öğelerinin listesini döndürür.

Oturumda henüz medya öğeleri yoksa ve bu nedenle medya içeriği döndüremiyorsa FAILED_PRECONDITION hatası döndürülür. Bu senaryoda, sınırlı girişli cihazlarda çalışan uygulamalar oturumdaki pickerUri kodunu kodlayan bir QR kodu oluşturarak kullanıcıdan kodu taramasını ve Google Fotoğraflar Seçici Kullanıcı Arayüzü'nde medya öğeleri seçmesini istemelidir. Kullanıcının öğelerini seçmesini beklerken müşteriler, sessions.get yanıtındaki pickedItemsSet = true tarihine kadar her pollingConfig.pollInterval kez sessions.get ile ilgili anket göndermelidir. Bu noktadan sonra müşteriler mediaItems.list numaralı telefonu aramaya devam edebilir ve başarılı bir yanıt almayı bekleyebilir.

HTTP isteği

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

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

Sorgu parametreleri

Parametreler
sessionId

string

Zorunlu. Bu oturum için Google tarafından oluşturulan tanımlayıcı.

pageSize

integer

İsteğe bağlı. Döndürülecek maksimum medya öğesi sayısı.

Hizmet bu değerden daha az bir değer döndürebilir (sıfır sonuç dahil). Belirtilmezse veya 0 olarak ayarlanırsa en fazla 50 medya öğesi döndürülür. Maksimum değer 100'dür; 100'ün üzerindeki değerler 100'e zorlanır. Negatif değerler INVALID_ARGUMENT hatasına neden olur.

pageToken

string

İsteğe bağlı. Önceki mediaItems.list çağrısından alınan bir sayfa jetonu. Sonraki sayfayı almak için bunu sağlayın.

İstek içeriği

İstek metni boş olmalıdır.

Yanıt gövdesi

mediaItems.list TBG'sine yanıt.

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

JSON gösterimi
{
  "mediaItems": [
    {
      object (PickedMediaItem)
    }
  ],
  "nextPageToken": string
}
Alanlar
mediaItems[]

object (PickedMediaItem)

Seçilen medya öğelerinin sayfası.

nextPageToken

string

mediaItems.list isteğinde sonraki sayfayı almak için pageToken olarak gönderilebilecek bir jeton.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/photospicker.mediaitems.readonly