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)

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