Method: mediaItems.batchGet

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

طلب HTTP

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

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

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

المَعلمات
mediaItemIds[]

string

مطلوبة. معرّفات عناصر الوسائط المطلوبة يجب ألا يحتوي على معرّفات متكرّرة، ولا يمكن أن يكون فارغًا. الحد الأقصى لعدد ملفات الوسائط التي يمكن استردادها في مكالمة واحدة هو 50.

نص الطلب

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

نص الاستجابة

ردّ لاسترداد قائمة عناصر الوسائط.

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

تمثيل JSON 
{
  "mediaItemResults": [
    {
      object (MediaItemResult)
    }
  ]
}
الحقول
mediaItemResults[]

object (MediaItemResult)

النتائج فقط. تم استرداد قائمة من ملفات الوسائط. تجدر الإشارة إلى أنّه حتى إذا نجحت عملية استدعاء mediaItems.batchGet، فقد تكون هناك إخفاقات في بعض عناصر الوسائط في المجموعة. يتم توضيح حالات عدم اكتمال العملية في كل MediaItemResult.status.

نطاقات التفويض

يتطلب استخدام أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/photoslibrary
  • https://www.googleapis.com/auth/photoslibrary.readonly
  • https://www.googleapis.com/auth/photoslibrary.readonly.appcreateddata

MediaItemResult

نتيجة استرداد ملف وسائط

تمثيل JSON 
{
  "status": {
    object (Status)
  },
  "mediaItem": {
    object (MediaItem)
  }
}
الحقول
status

object (Status)

إذا حدث خطأ أثناء الوصول إلى عنصر الوسائط هذا، ستتم تعبئة هذا الحقل بمعلومات ذات صلة بالخطأ. للحصول على تفاصيل حول هذا الحقل، يُرجى الاطّلاع على Status.
mediaItem

object (MediaItem)

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