Method: mediaItems.list

لعرض قائمة بعناصر الوسائط التي اختارها المستخدم خلال الجلسة المحدّدة.

يتم عرض الخطأ FAILED_PRECONDITION إذا لم ينته المستخدم بعد من اختيار عناصر الوسائط للجلسة المحدّدة. في هذا السيناريو، يجب أن يسأل تطبيقك sessions.get إلى أن تصبح الجلسة جاهزة قبل إعادة محاولة استخدام هذه الطريقة.

طلب HTTP

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

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات طلب البحث

المعلمات
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