Method: albums.batchAddMediaItems

تُضيف عنصر وسائط واحدًا أو أكثر في مكتبة "صور Google" الخاصة بالمستخدم إلى ألبوم. يجب أن يكون المطوّر هو من أنشأ عناصر الوسائط والألبومات من خلال واجهة برمجة التطبيقات.

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

يمكن أن يحتوي كل ألبوم على 20,000 ملف وسائط بحد أقصى.

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

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

طلب HTTP

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

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

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

المعلمات
albumId

string

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

نص الطلب

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

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

string

مطلوب. معرّفات MediaItem التي سيتمّ إضافتها الحد الأقصى لعدد عناصر الوسائط التي يمكن إضافتها في مكالمة واحدة هو 50.

نص الاستجابة

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

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

يتطلب أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/photoslibrary
  • https://www.googleapis.com/auth/photoslibrary.appendonly
  • https://www.googleapis.com/auth/photoslibrary.sharing
  • https://www.googleapis.com/auth/photoslibrary.edit.appcreateddata