Method: mediaItems.list

همه موارد رسانه را از کتابخانه Google Photos کاربر فهرست کنید.

درخواست HTTP

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

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

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

پارامترها
pageSize

integer

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

pageToken

string

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

درخواست بدن

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

بدن پاسخگو

فهرست همه موارد رسانه از کتابخانه Google Photos کاربر.

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

نمایندگی JSON 
{
  "mediaItems": [
    {
      object (MediaItem)
    }
  ],
  "nextPageToken": string
}
فیلدها
mediaItems[]

object ( MediaItem )

فقط خروجی فهرست موارد رسانه ای در کتابخانه کاربر.

nextPageToken

string

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

محدوده مجوز

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

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