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.edit.appcreateddata