Method: albums.list

Google Fotoğraflar uygulamasının Albümler sekmesinde bir kullanıcıya gösterilen tüm albümleri listeler.

HTTP isteği

GET https://photoslibrary.googleapis.com/v1/albums

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

Sorgu parametreleri

Parametreler
pageSize

integer

Yanıtta döndürülecek maksimum albüm sayısı. Belirtilen sayıdan daha az albüm döndürülebilir. Varsayılan pageSize değeri 20, maksimum değer 50'dir.
pageToken

string

Sonuçların sonraki sayfasını almak için bir devam jetonu. İsteğe bu dizenin eklenmesi, pageToken öğesinden sonraki satırları döndürür. pageToken, listAlbums isteğine verilen yanıttaki nextPageToken parametresinde döndürülen değer olmalıdır.
excludeNonAppCreatedData

boolean

Ayarlandığında, bu uygulama tarafından oluşturulmayan medya öğeleri sonuçlarda hariç tutulur. Varsayılan olarak yanlış değerine ayarlanır (tüm albümler döndürülür). photoslibrary.readonly.appcreateddata kapsamı kullanılırsa bu alan yoksayılır.

İstek içeriği

İstek metni boş olmalıdır.

Yanıt gövdesi

Albüm listesi istendi.

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

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

object (Album)

Yalnızca çıkış. Kullanıcının Google Fotoğraflar uygulamasının Albümler sekmesinde gösterilen albümlerin listesi.
nextPageToken

string

Yalnızca çıkış. Bir sonraki albüm grubunu almak için kullanılacak jeton. Bu istek için alınacak başka albüm varsa doldurulur.

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