Method: albums.list

Uygulamanız tarafından oluşturulan 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 iade edilebilir. Varsayılan pageSize değeri 20, maksimum değer 50'dir.
pageToken

string

Sonuçların bir sonraki sayfasını almak için bir devam ağı jetonu. Bu parametre isteğe eklendiğinde pageToken'ten sonraki satırlar döndürülür. pageToken, listAlbums isteğinin yanıtındaki nextPageToken parametresinde döndürülen değer olmalıdır.
excludeNonAppCreatedData

boolean

Ayarlanırsa sonuçlar, bu uygulama tarafından oluşturulmayan medya öğelerini hariç tutar. Varsayılan olarak yanlıştı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

İstenen albümlerin listesi.

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ış. Sonraki albüm grubunu almak için kullanılacak jeton. Bu istek için alınacak daha fazla albüm varsa doldurulur.

Yetkilendirme kapsamları

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

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