Method: albums.list

همه آلبوم‌هایی را که در برگه آلبوم‌های برنامه Google Photos به کاربر نشان داده می‌شود فهرست می‌کند.

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای پرس و جو

مولفه های
pageSize

integer

حداکثر تعداد آلبوم برای بازگشت در پاسخ. ممکن است تعداد کمتری آلبوم از تعداد مشخص شده بازگردانده شود. pageSize پیش فرض 20 و حداکثر 50 است.

pageToken

string

یک نشانه ادامه برای دریافت صفحه بعدی نتایج. با افزودن این به درخواست، ردیف‌های بعد از pageToken برمی‌گردد. pageToken باید مقداری باشد که در پارامتر nextPageToken در پاسخ به درخواست listAlbums برگردانده شده است.

excludeNonAppCreatedData

boolean

اگر تنظیم شود، نتایج شامل موارد رسانه‌ای نمی‌شوند که توسط این برنامه ایجاد نشده‌اند. پیش فرض ها به false (همه آلبوم ها برگردانده می شوند). اگر از محدوده photoslibrary.readonly.appcreateddata استفاده شود، این قسمت نادیده گرفته می شود.

درخواست بدن

بدنه درخواست باید خالی باشد.

بدن پاسخگو

لیست آلبوم های درخواستی

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

نمایندگی JSON
{
  "albums": [
    {
      object (Album)
    }
  ],
  "nextPageToken": string
}
زمینه های
albums[]

object ( Album )

فقط خروجی فهرست آلبوم‌هایی که در برگه آلبوم‌ها در برنامه Google Photos کاربر نشان داده شده است.

nextPageToken

string

فقط خروجی رمزی برای استفاده برای دریافت مجموعه بعدی آلبوم ها. اگر آلبوم‌های بیشتری برای بازیابی برای این درخواست وجود داشته باشد، تکمیل می‌شود.

محدوده مجوز

به یکی از حوزه های OAuth زیر نیاز دارد:

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