Method: mediaItems.list

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

سيتم عرض خطأ FAILED_PRECONDITION إذا لم تتضمن الجلسة أي وسائط تم اختيارها، وبالتالي لا يمكن عرض محتوى وسائط. في هذا السيناريو، يجب أن تعرض التطبيقات التي تعمل على الأجهزة ذات الإدخال المحدود رمز استجابة سريعة لترميز pickerUri للجلسة، ما يطلب من المستخدم مسح الرمز ضوئيًا واختيار عناصر الوسائط في واجهة مستخدم "أداة اختيار صور Google". أثناء انتظار المستخدم لاختيار العناصر، يجب على العملاء استطلاع رأي sessions.get، مرة واحدة كل pollingConfig.pollInterval، حتى pickedItemsSet = true في رد sessions.get. عندئذٍ، قد يستأنف العملاء الاتصال برقم mediaItems.list ويتوقّعون تلقّي ردّ ناجح.

طلب 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