لإزالة عنصر وسائط واحد أو أكثر من ألبوم محدّد. يجب أن يكون المطوّر هو من أنشأ عناصر الوسائط والألبوم من خلال واجهة برمجة التطبيقات.
بالنسبة إلى الألبومات المشترَكة، لا يتوفّر هذا الإجراء إلا لعناصر الوسائط التي أضافها هذا المستخدم إلى الألبوم، أو لجميع عناصر الوسائط إذا أنشأ هذا المستخدم الألبوم.
لا تتوفّر حالة النجاح الجزئي. سيفشل الطلب بالكامل ولن يتم تنفيذ أي إجراء على الألبوم إذا تم تحديد عنصر وسائط أو ألبوم غير صالح.
طلب HTTP
POST https://photoslibrary.googleapis.com/v1/albums/{albumId}:batchRemoveMediaItems
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المعلمات | |
---|---|
albumId |
مطلوب. معرّف |
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "mediaItemIds": [ string ] } |
الحقول | |
---|---|
mediaItemIds[] |
مطلوب. معرّفات يجب ألا يحتوي على معرّفات متكرّرة ولا يمكن أن يكون فارغًا. الحد الأقصى لعدد عناصر الوسائط التي يمكن إزالتها في مكالمة واحدة هو 50. |
نص الاستجابة
إذا كانت الاستجابة ناجحة، يكون نص الاستجابة فارغًا.
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/photoslibrary