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

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

نص الاستجابة

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

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

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

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