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)

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