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)

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