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". ويجب ألا يزيد طوله عن 1,000 حرف. لا تضمِّن سوى النص الذي كتبه المستخدمون. يجب أن تضيف الأوصاف سياقًا وتساعد المستخدمين على فهم الوسائط. لا تضمِّن أي سلاسل تم إنشاؤها تلقائيًا، مثل أسماء الملفات والعلامات وغيرها من البيانات الوصفية.
حقل الاتحاد 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)

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