- طلب HTTP
- نص الطلب
- نص الاستجابة
- نطاقات التفويض
- NewMediaItem
- SimpleMediaItem
- NewMediaItemResult
- جرِّبه الآن
ينشئ عنصر وسائط واحدًا أو أكثر في مكتبة "صور Google" للمستخدم.
هذه هي الخطوة الثانية لإنشاء عنصر وسائط. لمعرفة التفاصيل حول الخطوة 1، تحميل وحدات البايت غير المُعدَّلة إلى خادم Google، يُرجى الاطّلاع على تحميل الوسائط.
تؤدي هذه المكالمة إلى إضافة عنصر الوسائط إلى المكتبة. في حال تحديد ألبوم id
، تضيف المكالمة عنصر الوسائط إلى الألبوم أيضًا. ويمكن أن يحتوي كل ألبوم على ما يصل إلى 20,000 ملف وسائط. ستتم إضافة عنصر الوسائط تلقائيًا إلى نهاية المكتبة أو الألبوم.
إذا تم تحديد كل من الألبوم id
والموضع، تتم إضافة عنصر الوسائط إلى الألبوم في الموضع المحدد.
إذا كانت المكالمة تحتوي على عناصر وسائط متعددة، تتم إضافتها في الموضع المحدد. إذا كنت بصدد إنشاء عنصر وسائط في ألبوم مشترك لست مالكًا له، لن يُسمح لك بوضع عنصر الوسائط. وسيؤدي ذلك إلى ظهور خطأ BAD REQUEST
.
طلب HTTP
POST https://photoslibrary.googleapis.com/v1/mediaItems:batchCreate
يستخدم عنوان URL بنية تحويل الترميز gRPC.
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "albumId": string, "newMediaItems": [ { object ( |
الحقول | |
---|---|
albumId |
معرّف الألبوم الذي تتم إضافة عناصر الوسائط إليه. وتتم أيضًا إضافة عناصر الوسائط إلى مكتبة المستخدم. هذا حقل اختياري. |
newMediaItems[] |
مطلوبة. قائمة عناصر الوسائط التي سيتم إنشاؤها 50 ملف وسائط كحد أقصى لكل مكالمة. |
albumPosition |
الموضع في الألبوم حيث تتم إضافة عناصر الوسائط. وإذا لم يتم تحديد ذلك، تتم إضافة عناصر الوسائط إلى نهاية الألبوم (وفقًا للقيمة التلقائية، أي |
نص الاستجابة
قائمة بعناصر الوسائط التي تم إنشاؤها
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"newMediaItemResults": [
{
object ( |
الحقول | |
---|---|
newMediaItemResults[] |
النتائج فقط. قائمة بعناصر الوسائط التي تم إنشاؤها |
نطاقات التفويض
يتطلب استخدام أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/photoslibrary
https://www.googleapis.com/auth/photoslibrary.appendonly
https://www.googleapis.com/auth/photoslibrary.sharing
NewMediaItem
عنصر وسائط جديد تم إنشاؤه في حساب المستخدم على "صور Google".
تمثيل JSON |
---|
{ "description": string, // Union field |
الحقول | |
---|---|
description |
وصف عنصر الوسائط. يظهر هذا الاسم للمستخدم في قسم معلومات العنصر في تطبيق "صور Google". ويجب ألا يزيد طوله عن 1,000 حرف. لا تضمِّن سوى النص الذي كتبه المستخدمون. يجب أن تضيف الأوصاف سياقًا وتساعد المستخدمين على فهم الوسائط. لا تضمِّن أي سلاسل تم إنشاؤها تلقائيًا، مثل أسماء الملفات والعلامات وغيرها من البيانات الوصفية. |
حقل الاتحاد new_media_item_type قد يكون عنصر الوسائط الجديد من أنواع مختلفة، ويعتمد ذلك على مسار التحميل. تستخدم عمليات التحميل المتوافقة حاليًا مسار عنصر الوسائط البسيط فقط. يمكن أن يكون الحقل "new_media_item_type " واحدًا فقط مما يلي: |
|
simpleMediaItem |
عنصر وسائط جديد تم تحميله عبر |
SimpleMediaItem
عنصر وسائط بسيط يتم إنشاؤه في "صور Google" من خلال رمز مميَّز للتحميل.
تمثيل JSON |
---|
{ "uploadToken": string, "fileName": string } |
الحقول | |
---|---|
uploadToken |
رمز مميّز يحدّد وحدات البايت الخاصة بالوسائط التي تم تحميلها إلى Google |
fileName |
اسم الملف بامتداد عنصر الوسائط ويظهر هذا الاسم للمستخدم في "صور Google". يتم تجاهل اسم الملف المحدّد أثناء عملية تحميل البايت في حال ضبط هذا الحقل. يجب ألا يزيد طول اسم الملف، بما في ذلك امتداد الملف، عن 255 حرفًا. هذا حقل اختياري. |
NewMediaItemResult
نتيجة إنشاء عنصر وسائط جديد
تمثيل JSON |
---|
{ "uploadToken": string, "status": { object ( |
الحقول | |
---|---|
uploadToken |
الرمز المميّز للتحميل المستخدَم لإنشاء عنصر الوسائط الجديد (البسيط) هذا وتتم تعبئة هذا الحقل فقط إذا كان عنصر الوسائط بسيطًا ويتطلب رمزًا مميّزًا واحدًا للتحميل. |
status |
إذا حدث خطأ أثناء إنشاء عنصر الوسائط هذا، ستتم تعبئة هذا الحقل بمعلومات ذات صلة بالخطأ. للحصول على تفاصيل بشأن هذا الحقل، يُرجى الاطّلاع على الحالة. |
mediaItem |
تم إنشاء عنصر الوسائط باستخدام الرمز المميّز للتحميل. تتم تعبئة هذا الحقل في حال عدم حدوث أي أخطاء وإنشاء عنصر الوسائط بنجاح. |