Method: mediaItems.list

إدراج جميع عناصر الوسائط من مكتبة "صور Google" الخاصة بالمستخدم

طلب HTTP

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

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

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

المَعلمات
pageSize

integer

الحد الأقصى لعدد ملفات الوسائط المطلوب عرضها في الرد يمكن عرض عدد عناصر وسائط أقل من الرقم المحدّد. القيمة التلقائية pageSize هي 25، والحد الأقصى هو 100.
pageToken

string

رمز مميز للمتابعة للحصول على الصفحة التالية من النتائج. تؤدي إضافة هذا إلى الطلب إلى عرض الصفوف التي تلي pageToken. يجب أن تكون القيمة pageToken هي القيمة التي يتم عرضها في المَعلمة nextPageToken عند الردّ على طلب listMediaItems.

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

قائمة بكل ملفات الوسائط من مكتبة المستخدم في "صور Google".

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل 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