Method: mediaItems.batchCreate

إنشاء عنصر وسائط واحد أو أكثر في مكتبة "صور 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 (NewMediaItem)
    }
  ],
  "albumPosition": {
    object (AlbumPosition)
  }
}
الحقول
albumId

string

معرّف الألبوم الذي تمت إضافة ملفات الوسائط إليه تتم أيضًا إضافة ملفات الوسائط إلى مكتبة المستخدم. هذا حقل اختياري.
newMediaItems[]

object (NewMediaItem)

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

object (AlbumPosition)

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

نص الاستجابة

تم إنشاء قائمة بعناصر الوسائط

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "newMediaItemResults": [
    {
      object (NewMediaItemResult)
    }
  ]
}
الحقول
newMediaItemResults[]

object (NewMediaItemResult)

النتائج فقط. تم إنشاء قائمة بعناصر الوسائط

نطاقات الأذونات

يتطلب هذا الإعداد أحد نطاقات 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 new_media_item_type can be only one of the following:
  "simpleMediaItem": {
    object (SimpleMediaItem)
  }
  // End of list of possible types for union field new_media_item_type.
}
الحقول
description

string

وصف عنصر الوسائط تظهر هذه المعلومات للمستخدم في قسم معلومات الملف في تطبيق "صور Google". يجب ألا يزيد عدد الأحرف عن 1000 حرف. يجب تضمين النصوص التي كتبها المستخدمون فقط. يجب أن تضيف الأوصاف سياقًا وتساعد المستخدمين على فهم الوسائط. لا تضمِّن أي سلاسل تم إنشاؤها تلقائيًا، مثل أسماء الملفات والعلامات والبيانات الوصفية الأخرى.
حقل الاتحاد new_media_item_type. قد تكون هناك أنواع مختلفة لعنصر الوسائط الجديد، ويعتمد ذلك على مسار التحميل. لا تستخدم التحميلات المدعومة حاليًا سوى مسار عنصر الوسائط البسيط. يمكن أن يكون new_media_item_type واحدًا فقط مما يلي:
simpleMediaItem

object (SimpleMediaItem)

ملف وسائط جديد تم تحميله عبر uploadToken المضمّنة

SimpleMediaItem

عنصر وسائط بسيط يتم إنشاؤه في "صور Google" من خلال رمز مميّز للتحميل.

تمثيل JSON 
{
  "uploadToken": string,
  "fileName": string
}
الحقول
uploadToken

string

رمز مميّز يحدّد وحدات البايت للوسائط التي تم تحميلها إلى Google.
fileName

string

اسم الملف مع امتداد ملف الوسائط ستظهر هذه المعلومات للمستخدم في "صور Google". يتم تجاهل اسم الملف المحدَّد أثناء عملية تحميل البايت في حال ضبط هذا الحقل. يجب ألا يزيد اسم الملف، بما في ذلك امتداد الملف، عن 255 حرفًا. هذا حقل اختياري.

NewMediaItemResult

نتيجة إنشاء عنصر وسائط جديد

تمثيل JSON 
{
  "uploadToken": string,
  "status": {
    object (Status)
  },
  "mediaItem": {
    object (MediaItem)
  }
}
الحقول
uploadToken

string

رمز التحميل المميّز المُستخدَم لإنشاء ملف الوسائط الجديد (البسيط) هذا لا تتم تعبئة هذا الحقل إلا إذا كان عنصر الوسائط بسيطًا ويتطلب رمزًا مميّزًا واحدًا للتحميل.
status

object (Status)

في حال حدوث خطأ أثناء إنشاء عنصر الوسائط هذا، تتم تعبئة هذا الحقل بمعلومات ذات صلة بالخطأ. للحصول على تفاصيل حول هذا الحقل، راجِع الحالة.
mediaItem

object (MediaItem)

عنصر وسائط تم إنشاؤه باستخدام الرمز المميّز للتحميل يتمّ تعبئته في حال عدم حدوث أيّ أخطاء وإنشاء ملفّ الوسائط بنجاح.