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