Method: mediaItems.list

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

اگر کاربر هنوز انتخاب آیتم های رسانه ای را برای جلسه مشخص شده تمام نکرده باشد، یک خطای FAILED_PRECONDITION برمی گردد. در این سناریو، قبل از امتحان مجدد این روش، برنامه شما باید از sessions.get نظرسنجی کند تا جلسه آماده شود.

درخواست HTTP

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

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

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

پارامترها
sessionId

string

مورد نیاز. شناسه ایجاد شده توسط Google برای این جلسه.

pageSize

integer

اختیاری. حداکثر تعداد آیتم های رسانه ای برای بازگشت.

ممکن است سرویس کمتر از این مقدار (شامل نتایج صفر) برگرداند. اگر مشخص نشده باشد یا روی 0 تنظیم شود، حداکثر 50 مورد رسانه برگردانده می شود. حداکثر مقدار 100 است. مقادیر بالای 100 به 100 تبدیل می شوند. مقادیر منفی منجر به خطای INVALID_ARGUMENT می شود.

pageToken

string

اختیاری. یک نشانه صفحه، دریافت شده از تماس قبلی mediaItems.list . این را برای بازیابی صفحه بعدی ارائه دهید.

درخواست بدن

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

بدن پاسخگو

پاسخ به روش mediaItems.list .

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

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

object ( PickedMediaItem )

صفحه ای از آیتم های رسانه ای انتخاب شده

nextPageToken

string

در صورت تنظیم، این فیلد می تواند به عنوان pageToken در یک فراخوان بعدی mediaItems.list برای بازیابی صفحه بعدی آیتم های رسانه انتخاب شده استفاده شود.

اگر این قسمت حذف شود، هیچ صفحه بعدی وجود ندارد.

محدوده مجوز

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

  • https://www.googleapis.com/auth/photospicker.mediaitems.readonly