لتحميل مادة عرض تعرض معرّف مادة العرض التي تم تحميلها مؤخرًا إذا كانت ناجحة. يجب ألا يزيد حجم ملف مادة العرض عن 10 ميغابايت للصور و200 ميغابايت لملفات ZIP و1 غيغابايت للفيديوهات.
ويجب استخدامه ضمن عملية تحميل الوسائط المتعدّدة الأجزاء. ويمكنك الاطّلاع على أمثلة حول استخدام مكتبات العملاء المتوفّرة في دليل إنشاء تصميمات الإعلانات.
طلب HTTP
- معرّف الموارد المنتظم (URI) للتحميل، لطلبات تحميل الوسائط:
POST https://displayvideo.googleapis.com/upload/v1/advertisers/{advertiserId}/assets
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المَعلمات | |
---|---|
advertiserId |
مطلوبة. رقم تعريف المعلِن الذي تنتمي إليه مادة العرض هذه. |
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "filename": string } |
الحقول | |
---|---|
filename |
مطلوبة. اسم ملف مادة العرض، بما في ذلك امتداد الملف يجب أن يكون اسم الملف بترميز UTF-8 بحد أقصى للحجم يبلغ 240 بايت. |
نص الاستجابة
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
رسالة رد على assets.upload
.
تمثيل JSON |
---|
{
"asset": {
object ( |
الحقول | |
---|---|
asset |
مادة العرض التي تم تحميلها، إذا كانت ناجحة. |
نطاقات الأذونات
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/display-video
لمزيد من المعلومات، راجِع نظرة عامة على بروتوكول OAuth 2.0.