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)

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