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