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
  • https://www.googleapis.com/auth/photoslibrary.readonly.originals

MediaItemResult

نتيجة استرداد عنصر وسائط

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

object (Status)

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

object (MediaItem)

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