لإضافة عنصر وسائط واحد أو أكثر في مكتبة مستخدم "صور Google" إلى ألبوم. يجب أن يكون قد تم إنشاء ملفات الوسائط والألبومات بواسطة المطوّر عبر واجهة برمجة التطبيقات.
تتم إضافة عناصر الوسائط إلى نهاية الألبوم. إذا تم توفير عدة عناصر وسائط، تتم إضافتها بالترتيب المحدد في هذه المكالمة.
ويمكن أن يحتوي كل ألبوم على ما يصل إلى 20,000 ملف وسائط.
لا يمكن أن تضيف إلى ألبوم سوى عناصر الوسائط الموجودة في مكتبة المستخدم. بالنسبة إلى الألبومات التي تتم مشاركتها، يجب أن يكون الألبوم ملكًا للمستخدم أو أن يكون قد انضم إلى الألبوم كمتعاون.
النجاح الجزئي غير متاح. سيفشل الطلب بالكامل إذا تم تحديد عنصر وسائط أو ألبوم غير صالح.
طلب HTTP
POST https://photoslibrary.googleapis.com/v1/albums/{albumId}:batchAddMediaItems
يستخدم عنوان URL بنية تحويل الترميز gRPC.
معلمات المسار
المَعلمات | |
---|---|
albumId |
مطلوبة. معرّف |
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "mediaItemIds": [ string ] } |
الحقول | |
---|---|
mediaItemIds[] |
مطلوبة. معرّفات |
نص الاستجابة
إذا كانت الاستجابة ناجحة، يكون نص الاستجابة فارغًا.
نطاقات التفويض
يتطلب استخدام أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/photoslibrary
https://www.googleapis.com/auth/photoslibrary.appendonly
https://www.googleapis.com/auth/photoslibrary.sharing