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 20, maksimum değer 50'dir.

pageToken

string

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

excludeNonAppCreatedData

boolean

Ayarlanırsa sonuçlarda bu uygulama tarafından oluşturulmayan medya öğeleri 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ındaki 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
  • https://www.googleapis.com/auth/photoslibrary.readonly
  • https://www.googleapis.com/auth/photoslibrary.readonly.appcreateddata