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)

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