Method: mediaItems.list

Belirtilen cihaz için kullanıcı tarafından yapılandırılan medya kaynaklarındaki ambiyans medya öğelerinin listesini döndürür.

listMediaItems varsayılan olarak Ambiyans deneyimini sunar ve kullanıcı tarafından yapılandırılmış tüm kaynaklardan seçilmiş bir medya öğesi grubu döndürür.

İsteğe bağlı olarak, belirli bir medya kaynağından sayfalandırılmış bir öğe listesi almak için isteğe mediaSourceId ekleyebilirsiniz. Bu sayede daha geleneksel bir filtreleme yapabilirsiniz.

İstemci uygulamaları, cihaz başına günlük 240 istekle sınırlıdır.

Kullanıcı herhangi bir medya kaynağını yapılandırmazsa FAILED_PRECONDITION hatası oluşur.

HTTP isteği

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

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

Sorgu parametreleri

Parametreler
deviceId

string

Zorunlu. Bu cihazın benzersiz tanımlayıcısı.
mediaSourceId

string

İsteğe bağlıdır. Ambient deneyimi için bu alanı atlayın. Bu işlem, tüm yapılandırılmış kaynaklardan seçilen bir medya öğesi grubu döndürür. Döndürülen öğe sayısı, pageSize isteğiniz doğrultusunda en fazla 100 öğe olacak şekilde belirlenir. Belirtilen medya kaynağındaki öğeler döndürülür.

id, belirtilen cihaz için kullanıcı tarafından seçilen bir kaynaktan (yani AmbientDevice.media_sources.id kaynaklarından biri) olmalıdır.

Kullanıcı tarafından bu cihaz için seçilmiş bir kaynak olsa bile highlights'ün desteklenmediğini unutmayın. Bu alan highlights olarak ayarlanırsa INVALID_ARGUMENT hatası döndürülür.
pageSize

integer

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

Hizmet, pageSize isteğinizi yerine getirir ancak belirtilenden daha az öğe döndürebilir (sıfır sonuç dahil).

pageSize belirtilmezse veya 0 olarak ayarlanırsa en fazla 50 medya öğesi döndürülür. 100'den büyük değerler, izin verilen maksimum değer olan 100'e düşürülür. Negatif bir değer sağlanırsa INVALID_ARGUMENT hatası oluşur.
pageToken

string

İsteğe bağlıdır. Önceki bir mediaItems.list çağrısından alınan 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 yöntemine verilen yanıt.

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

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

object (AmbientMediaItem)

Cihazın görüntüleyeceği ambiyans medya öğelerinin bulunduğu bir sayfa.
nextPageToken

string

Ayarlanırsa bu alan, bir sonraki mediaItems.list çağrısında öğelerin bir sonraki sayfasını almak için pageToken olarak kullanılabilir.

Bu alan atlanırsa bu, getirilebilecek başka içerik olmadığı anlamına gelmez. Bunun yerine, sonraki içerik sayfasında daha önce önceki sayfalarda döndürülmüş medya öğeleri bulunabilir.

Yetkilendirme kapsamları

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

  • https://www.googleapis.com/auth/photosambient.mediaitems