Method: albums.batchRemoveMediaItems

لإزالة عنصر وسائط واحد أو أكثر من ألبوم محدَّد. يجب أن يكون قد تم إنشاء عناصر الوسائط والألبوم بواسطة المطوّر عبر واجهة برمجة التطبيقات.

بالنسبة إلى الألبومات التي تمت مشاركتها، لا يتوفر هذا الإجراء إلا لعناصر الوسائط التي أضافها هذا المستخدم إلى الألبوم، أو لكل عناصر الوسائط إذا كان هذا المستخدم قد أنشأها.

النجاح الجزئي غير متاح. سيتعذر الطلب بالكامل ولن يتم تنفيذ أي إجراء على الألبوم إذا تم تحديد عنصر وسائط أو ألبوم غير صالح.

طلب HTTP

POST https://photoslibrary.googleapis.com/v1/albums/{albumId}:batchRemoveMediaItems

يستخدم عنوان URL بنية تحويل الترميز gRPC.

معلمات المسار

المَعلمات
albumId

string

مطلوبة. معرِّف Album الذي ستتم إزالة عناصر الوسائط منه.

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON 
{
  "mediaItemIds": [
    string
  ]
}
الحقول
mediaItemIds[]

string

مطلوبة. معرّفات MediaItem التي ستتم إزالتها.

يجب ألا يحتوي على معرّفات متكرّرة، ولا يمكن أن يكون فارغًا. الحد الأقصى لعدد ملفات الوسائط التي يمكن إزالتها في مكالمة واحدة هو 50 عنصرًا.

نص الاستجابة

إذا كانت الاستجابة ناجحة، يكون نص الاستجابة فارغًا.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/photoslibrary