لعرض قائمة عناصر الوسائط لمعرّفات عناصر الوسائط المحددة. يتمّ إرجاع السلع بنفس ترتيب المعرّفات التي تمّ توفيرها.
طلب HTTP
GET https://photoslibrary.googleapis.com/v1/mediaItems:batchGet
يستخدم عنوان URL بنية تحويل الترميز gRPC.
معلمات طلب البحث
المَعلمات | |
---|---|
mediaItemIds[] |
مطلوبة. معرّفات عناصر الوسائط المطلوبة يجب ألا يحتوي على معرّفات متكرّرة، ولا يمكن أن يكون فارغًا. الحد الأقصى لعدد ملفات الوسائط التي يمكن استردادها في مكالمة واحدة هو 50. |
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
ردّ لاسترداد قائمة عناصر الوسائط.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"mediaItemResults": [
{
object ( |
الحقول | |
---|---|
mediaItemResults[] |
النتائج فقط. تم استرداد قائمة من ملفات الوسائط. تجدر الإشارة إلى أنّه حتى إذا نجحت عملية استدعاء mediaItems.batchGet، فقد تكون هناك إخفاقات في بعض عناصر الوسائط في المجموعة. يتم توضيح حالات عدم اكتمال العملية في كل |
نطاقات التفويض
يتطلب استخدام أحد نطاقات 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 |
تم استرداد عنصر الوسائط من مكتبة المستخدم. وتتم تعبئة هذا الحقل في حال عدم حدوث أي أخطاء واسترجاع عنصر الوسائط بنجاح. |