تحميل الوسائط

تتيح لك ميزة تحميل الوسائط تخزين البيانات التي يمكنك استخدامها في "مساحة العرض والفيديو 360". تشمل أنواع البيانات التي قد يرغب المستخدم في تحميلها الصور والفيديوهات وملفات zip وما إلى ذلك.

خيارات التحميل

تتيح لك واجهة برمجة التطبيقات في "مساحة العرض والفيديو 360" تحميل أنواع معيّنة من البيانات الثنائية أو الوسائط. يتم تفصيل خصائص البيانات التي يمكنك تحميلها في دليل المطوّرين لأي مهمة تتطلّب تحميل وسائط:

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

يمكنك تقديم طلبات التحميل بأي من الطرق التالية. حدِّد الطريقة التي تستخدمها مع المَعلمة uploadType.

تحميل بسيط: uploadType=media نقل سريع للملفات التي يبلغ حجمها 5 ميغابايت أو أقل
التحميل المتعدد الأجزاء: uploadType=multipart. نقل سريع للملفات والبيانات الوصفية ذات الصلة ينقل هذا الخيار الملف والبيانات الوصفية، وكل ذلك في طلب واحد.

عند تحميل الوسائط، يمكنك استخدام /upload معرّف موارد موحّد (URI). استخدِم معرّف الموارد المنتظم (URI) هذا عند نقل بيانات الوسائط نفسها.

مثال:

  POST /upload/media/resource-name

تحميل بسيط

طلب التحميل البسيط هو الطريقة الأسهل لتحميل ملف. يكون هذا الخيار مناسبًا في الحالات التالية:

يمكنك تحميل الملف مرة أخرى إذا لزم الأمر.
لا تتوفّر بيانات وصفية لإرسالها. قد يكون هذا صحيحًا إذا لم تكن البيانات الوصفية ضرورية أو إذا تم تضمينها في مكان آخر في الطلب.

لاستخدام ميزة "التحميل البسيط"، أرسِل طلب POST أو PUT إلى معرّف الموارد المنتظم (URI) الخاص بالطريقة /upload وأضِف مَعلمة طلب البحث uploadType=media. على سبيل المثال:

  POST https://displayvideo.googleapis.com/upload/media/resource-name?uploadType=media

تشمل عناوين HTTP التي يجب استخدامها عند إجراء عملية تحميل بسيطة ما يلي:

Content-Type. اضبط القيمة على أحد أنواع بيانات الوسائط المقبولة في الطريقة.
استبدِل Content-Length بعدد وحدات البايت التي تحمّلها. غير مطلوب إذا كنت تستخدم ترميز النقل المقسّم.

التحميل المتعدد الأجزاء

إذا كان لديك بيانات وصفية لإرسالها مع البيانات التي سيتم تحميلها، يمكنك تقديم طلب multipart/related. ويُعدّ هذا اختيارًا جيدًا إذا كانت البيانات التي ترسلها صغيرة بما يكفي لإعادة تحميلها عند الضرورة.

لاستخدام ميزة "التحميل المتعدد الأجزاء"، أرسِل طلب POST أو PUT إلى معرّف الموارد المنتظم (URI) الخاص بالطريقة /upload وأضِف مَعلمة طلب البحث uploadType=multipart. على سبيل المثال:

  POST https://displayvideo.googleapis.com/upload/v4/advertisers/advertiser-id/assets?uploadType=multipart

تتضمّن عناوين HTTP العالية المستوى التي يجب استخدامها عند تقديم طلب تحميل متعدد الأجزاء ما يلي:

Content-Type: اضبط القيمة على multipart/related وأدرِج سلسلة الحدود التي تستخدمها لتحديد أجزاء الطلب.
Content-Length. اضبط القيمة على إجمالي عدد وحدات البايت في نص الطلب. يجب أن يكون حجم جزء الوسائط في الطلب أقل من الحد الأقصى لحجم الملف المحدّد لهذه الطريقة.

يتم تنسيق نص الطلب كنوع محتوى multipart/related [RFC2387] ويحتوي على جزأين بالضبط. يتم تحديد الأجزاء من خلال سلسلة حدود، وتتبع سلسلة الحدود النهائية شرطتان أفقيتان.

يحتاج كل جزء من الطلب المتعدد الأجزاء إلى عنوان Content-Type إضافي:

جزء البيانات الوصفية: يجب أن يظهر أولاً، ويجب أن يتطابق Content-Type مع أحد تنسيقات البيانات الوصفية المقبولة.
مقطع صوتي مشغَّل خلال المكالمة: يجب أن يأتي ثانيًا، ويجب أن يتطابق Content-Type مع أحد أنواع MIME المقبولة للوسائط في الطريقة.

أمثلة

يمكنك تحميل الوسائط باستخدام Display & Video 360 API لتنفيذ مهام مختلفة. يقدّم هذا القسم أمثلة على شكل طلبات curl.

تحميل ملف أصل المواد الإبداعية

في ما يلي كيفية تحميل ملف أصل المواد الإبداعية:

curl --request POST \
  'https://displayvideo.googleapis.com/upload/v4/advertisers/advertiser-id/assets?uploadType=multipart' \
  --header 'Authorization: Bearer access-token' \
   -F "data={\"filename\": \"asset-filename\"};type=application/json;charset=UTF-8" \
   -F "file=@asset-path;type=asset-mime-type"

اطّلِع على دليل تحميل مواد عرض الإعلانات لمزيد من التفاصيل وأمثلة الرموز.

تحميل ملف نص برمجي مخصّص لعروض الأسعار

في ما يلي كيفية تحميل ملف نص برمجي:

curl --request POST \
  'https://displayvideo.googleapis.com/upload/media/resource-name?uploadType=media' \
  -H 'authorization: Bearer access-token' \
  -H 'Content-Type: text/plain' \
  --data-binary @script-path

اطّلِع على دليل النص البرمجي للتحميل للحصول على مزيد من التفاصيل وأمثلة على الرموز البرمجية.

تحميل الوسائط تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.