REST Resource: advertisers.creatives

المرجع: تصميم الإعلان

مادة إبداعية واحدة:

تمثيل JSON 
{
  "name": string,
  "advertiserId": string,
  "creativeId": string,
  "cmPlacementId": string,
  "displayName": string,
  "entityStatus": enum (EntityStatus),
  "updateTime": string,
  "createTime": string,
  "creativeType": enum (CreativeType),
  "hostingSource": enum (HostingSource),
  "dynamic": boolean,
  "dimensions": {
    object (Dimensions)
  },
  "additionalDimensions": [
    {
      object (Dimensions)
    }
  ],
  "mediaDuration": string,
  "creativeAttributes": [
    enum (CreativeAttribute)
  ],
  "reviewStatus": {
    object (ReviewStatusInfo)
  },
  "assets": [
    {
      object (AssetAssociation)
    }
  ],
  "exitEvents": [
    {
      object (ExitEvent)
    }
  ],
  "timerEvents": [
    {
      object (TimerEvent)
    }
  ],
  "counterEvents": [
    {
      object (CounterEvent)
    }
  ],
  "appendedTag": string,
  "integrationCode": string,
  "notes": string,
  "iasCampaignMonitoring": boolean,
  "companionCreativeIds": [
    string
  ],
  "skippable": boolean,
  "skipOffset": {
    object (AudioVideoOffset)
  },
  "progressOffset": {
    object (AudioVideoOffset)
  },
  "universalAdId": {
    object (UniversalAdId)
  },
  "thirdPartyUrls": [
    {
      object (ThirdPartyUrl)
    }
  ],
  "transcodes": [
    {
      object (Transcode)
    }
  ],
  "trackerUrls": [
    string
  ],
  "jsTrackerUrl": string,
  "cmTrackingAd": {
    object (CmTrackingAd)
  },
  "obaIcon": {
    object (ObaIcon)
  },
  "thirdPartyTag": string,
  "requireMraid": boolean,
  "requireHtml5": boolean,
  "requirePingForAttribution": boolean,
  "expandingDirection": enum (ExpandingDirection),
  "expandOnHover": boolean,
  "vastTagUrl": string,
  "vpaid": boolean,
  "html5Video": boolean,
  "lineItemIds": [
    string
  ],
  "mp3Audio": boolean,
  "oggAudio": boolean
}
الحقول
name

string

النتائج فقط. اسم مورد تصميم الإعلان.
advertiserId

string (int64 format)

النتائج فقط. رقم التعريف الفريد للمعلِن الذي ينتمي إليه تصميم الإعلان.
creativeId

string (int64 format)

النتائج فقط. رقم التعريف الفريد لتصميم الإعلان. تم تعيينه من قِبل النظام.
cmPlacementId

string (int64 format)

النتائج فقط. رقم التعريف الفريد لموضع إعلان "مدير الحملة 360" المرتبط بتصميم الإعلان. لا ينطبق هذا الحقل إلا على تصميمات الإعلانات التي تتم مزامنتها من "مدير الحملة".
displayName

string

مطلوبة. الاسم المعروض لتصميم الإعلان.

يجب ترميزها باستخدام UTF-8 بحجم 240 بايت كحد أقصى.
entityStatus

enum (EntityStatus)

مطلوبة. تحديد ما إذا كان يمكن عرض تصميم الإعلان أم لا.

القيم المقبولة هي:

  • ENTITY_STATUS_ACTIVE
  • ENTITY_STATUS_ARCHIVED
  • ENTITY_STATUS_PAUSED
updateTime

string (Timestamp format)

النتائج فقط. الطابع الزمني لوقت إجراء آخر تعديل على تصميم الإعلان، إمّا من قِبل المستخدم أو النظام (مثل مراجعة تصميم الإعلان). تم تعيينه من قِبل النظام.

طابع زمني بتنسيق RFC3339 UTC "Zulu" ، مع دقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"
createTime

string (Timestamp format)

النتائج فقط. الطابع الزمني عند إنشاء تصميم الإعلان. تم تعيينه من قِبل النظام.

طابع زمني بتنسيق RFC3339 UTC "Zulu" ، مع دقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"
creativeType

enum (CreativeType)

مطلوبة. غير قابل للتغيير. نوع تصميم الإعلان.
hostingSource

enum (HostingSource)

مطلوبة. يشير إلى مكان استضافة تصميم الإعلان.
dynamic

boolean

النتائج فقط. يشير هذا العمود إلى ما إذا كان تصميم الإعلان ديناميكيًا.
dimensions

object (Dimensions)

مطلوبة. الأبعاد الأساسية لتصميم الإعلان. ينطبق ذلك على جميع أنواع تصميمات الإعلانات. يتم ضبط قيمة widthPixels وheightPixels تلقائيًا على 0 عندما تكون قيمة creativeType واحدة مما يلي:

  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_NATIVE_VIDEO
additionalDimensions[]

object (Dimensions)

السمات الإضافية. يسري هذا العرض الترويجي عندما تكون السمة creativeType واحدة مما يلي:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_LIGHTBOX
  • CREATIVE_TYPE_PUBLISHER_HOSTED

في حال تحديد هذا الحقل، تكون قيمة الحقلين widthPixels وheightPixels مطلوبة ويجب أن تكون القيمة أكبر من 0 أو مساوٍ له.
mediaDuration

string (Duration format)

النتائج فقط. مدة الوسائط لتصميم الإعلان. يسري هذا العرض الترويجي عندما تكون السمة creativeType واحدة مما يلي:

  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_NATIVE_VIDEO
  • CREATIVE_TYPE_PUBLISHER_HOSTED

مدة بالثواني يصل عددها إلى تسعة أرقام كسرية وتنتهي بـ "s". مثال: "3.5s".
creativeAttributes[]

enum (CreativeAttribute)

النتائج فقط. قائمة بسمات تصميم الإعلان التي يُنشئها النظام.
reviewStatus

object (ReviewStatusInfo)

النتائج فقط. الحالة الراهنة لعملية مراجعة المواد الإبداعية
assets[]

object (AssetAssociation)

مطلوبة. مواد العرض المرتبطة بتصميم الإعلان هذا.
exitEvents[]

object (ExitEvent)

مطلوبة. الخروج من الأحداث لتصميم الإعلان هذا. المخرج (المعروف أيضًا باسم علامة النقر) هو أي منطقة في تصميم الإعلان يمكن لشخص ما النقر عليها أو النقر عليها لفتح الصفحة المقصودة للمعلِن. يجب أن يحتوي كل تصميم إعلان على مخرج واحد على الأقل. يمكنك إضافة مخرج إلى تصميمك بأيّ من الطرق التالية:

  • استخدام منطقة النقر في Google Web Designer
  • حدِّد متغيّر JavaScript يُسمى "clickTag".
  • استخدم أداة التفعيل (Enabler.exit()) لتتبُّع مرّات الخروج في تنسيقات الوسائط التفاعلية المتقدّمة.
timerEvents[]

object (TimerEvent)

أحداث مخصّصة للمؤقّتات لتصميم إعلان وسائط متعددة تفاعلية. تتتبّع المؤقتات الوقت الذي يعرض فيه المستخدم جزءًا محددًا من تصميم إعلان الوسائط التفاعلية ويتفاعل معه. يمكن أن يشتمل تصميم الإعلان على أحداث موقِّتات متعددة، يتم ضبط كلّ منها على حدة. يمكنك ترك هذا الحقل فارغًا أو بدون ضبط لتصاميم الإعلانات التي تحتوي على مواد عرض صور فقط.
counterEvents[]

object (CounterEvent)

الفعاليات المضادة لتصميم إعلان من الوسائط التفاعلية المتقدّمة. تتتبّع العدّادات عدد المرات التي يتفاعل فيها المستخدم مع أي جزء من تصميم إعلان الوسائط التفاعلية المتقدّمة بطريقة محددة (تمرير الماوس فوقه، وتمرير الماوس خارجه، والنقرات، والنقرات، وتحميل البيانات، وإدخالات لوحة المفاتيح، وما إلى ذلك). يمكن تسجيل أي حدث يمكن تسجيله في تصميم الإعلان كعدّاد. يمكنك ترك هذا الحقل فارغًا أو بدون ضبط لتصاميم الإعلانات التي تحتوي على مواد عرض صور فقط.
appendedTag

string

علامة تتبُّع HTML التابعة لجهة خارجية التي سيتم إلحاقها بعلامة تصميم الإعلان.
integrationCode

string

معلومات المعرّف المستخدمة لربط تصميم الإعلان هذا بنظام خارجي. يجب أن يكون ترميز UTF-8 بطول لا يزيد عن 10,000 حرف.
notes

string

ملاحظات المستخدم لتصميم الإعلان هذا يجب أن يكون ترميز UTF-8 بطول لا يزيد عن 20,000 حرف.
iasCampaignMonitoring

boolean

يشير إلى ما إذا كانت خدمة Integral Ad Science (IAS) مفعَّلة لمراقبة الحملة. لتفعيل هذا الإعداد في تصميم الإعلان، تأكّد من ضبط Advertiser.creative_config.ias_client_id على معرّف عميل IAS.
companionCreativeIds[]

string (int64 format)

أرقام تعريف تصميمات الإعلانات المصاحبة لتصميم فيديو.

يمكنك تحديد تصاميم إعلانات صورية حالية (تتضمّن مواد عرض صور أو مواد عرض HTML5) ليتم عرضها حول مشغّل الفيديو الخاص بالناشر. تظهر الإعلانات المصاحبة المُصاحبة حول مشغّل الفيديو أثناء تشغيله، وتظل معروضة بعد انتهاء الفيديو.

لا يمكن أن تكون تصميمات الإعلانات التي تحتوي على additional dimensions تصميمات إعلانات مصاحبة.

هذا الحقل متوافق فقط مع أنواع creativeType التالية:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
skippable

boolean

ما إذا كان يمكن للمستخدم اختيار تخطّي تصميم إعلان الفيديو

هذا الحقل متاح فقط لأنواع creativeType التالية:

  • CREATIVE_TYPE_VIDEO
skipOffset

object (AudioVideoOffset)

مقدار الوقت المستغرَق لتشغيل الفيديو قبل ظهور زر التخطّي

يجب ملء هذا الحقل عندما تكون قيمة skippable صحيحة.

هذا الحقل متاح فقط لأنواع creativeType التالية:

  • CREATIVE_TYPE_VIDEO
progressOffset

object (AudioVideoOffset)

مقدار الوقت اللازم لتشغيل الفيديو قبل احتساب عدد المشاهدات.

يجب ملء هذا الحقل عندما تكون قيمة skippable صحيحة.

هذا الحقل متاح فقط لأنواع creativeType التالية:

  • CREATIVE_TYPE_VIDEO
universalAdId

object (UniversalAdId)

اختياريّ. معرّف اختياري لتصميم الإعلان يقدّمه قاعدة بيانات المسجّلين ويكون فريدًا في جميع المنصات

يشكّل معرّف الإعلان العالمي جزءًا من معيار "نموذج عرض إعلانات فيديو" 4.0. ويمكن تعديله بعد إنشاء تصميم الإعلان.

هذا الحقل متاح فقط لأنواع creativeType التالية:

  • CREATIVE_TYPE_VIDEO
thirdPartyUrls[]

object (ThirdPartyUrl)

تتبُّع عناوين URL من جهات خارجية لتتبُّع التفاعلات مع تصميم إعلان الفيديو

هذا الحقل متاح فقط لأنواع creativeType التالية:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_NATIVE_VIDEO
transcodes[]

object (Transcode)

النتائج فقط. عمليات تحويل ترميز الصوت/الفيديو

تحوّل "مساحة العرض والفيديو 360" ترميز مادة العرض الرئيسية إلى عدد من الإصدارات البديلة التي تستخدم تنسيقات ملفات مختلفة أو لها خصائص مختلفة (درجة الدقة ومعدل نقل بيانات الصوت ومعدّل نقل بيانات الفيديو)، ويتم تصميم كل منها لمشغّلات فيديو أو معدّلات نقل بيانات معيّنة.

وتمنح هذه الرموز لنظام الناشر مزيدًا من الخيارات للاختيار من بينها لكل مرة ظهور على الفيديو وتضمن عرض الملف المناسب استنادًا إلى اتصال المشاهد وحجم الشاشة.

لا يتوفّر هذا الحقل إلا في أنواع creativeType التالية:

  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_NATIVE_VIDEO
  • CREATIVE_TYPE_AUDIO
trackerUrls[]

string

تتبُّع عناوين URL لمزوّدي خدمة التحليلات أو مورّدي تقنية الإعلان التابعين لجهات خارجية

يجب أن تبدأ عناوين URL ببروتوكول https (باستثناء المستودع الذي لا يتطلب التوافق مع طبقة المقابس الآمنة). في حال استخدام وحدات ماكرو في عنوان URL، استخدِم فقط وحدات الماكرو المتوافقة مع "مساحة العرض والفيديو 360".

عناوين URL القياسية فقط، بدون علامات {8} أو سيناريو.

لا يمكن كتابة هذا الحقل إلا بلغة creativeType التالية:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
jsTrackerUrl

string

عنوان URL لقياس JavaScript من مزوِّدي التحقق التابعين لجهات خارجية والمعتمَدين (ComScore وDoubleCheck وIAS وMoat). علامات نص HTML البرمجي غير متوافقة.

لا يمكن كتابة هذا الحقل إلا بلغة creativeType التالية:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
cmTrackingAd

object (CmTrackingAd)

إعلان تتبُّع "مدير الحملة 360" المرتبط بتصميم الإعلان.

اختيارية لحملة creativeType التالية عند إنشائها من قِبل معلِن يستخدِم كلاً من "مدير الحملة 360" وعرض إعلانات الجهات الخارجية:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE

النتائج للحالات الأخرى فقط.
obaIcon

object (ObaIcon)

تحدّد رمز OBA لتصميم إعلان الفيديو.

لا يتوفّر هذا الحقل إلا في أنواع creativeType التالية:

  • CREATIVE_TYPE_VIDEO
thirdPartyTag

string

اختياريّ. العلامة الأصلية للجهة الخارجية المستخدَمة في تصميم الإعلان.

مطلوبة وصالحة فقط لتصميمات علامات الجهات الخارجية.

تصميمات إعلانات علامة الجهة الخارجية هي تصميمات إعلانات تستخدم hostingSource التالية:

  • HOSTING_SOURCE_THIRD_PARTY

بالإضافة إلى creativeType التالية:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
requireMraid

boolean

اختياريّ. يشير إلى أن تصميم الإعلان يتطلب MRAID (نظام تعريفات واجهة إعلانات الوسائط المتعددة التفاعلية على الأجهزة الجوّالة).

اضبط هذا الخيار إذا كان تصميم الإعلان يعتمد على إيماءات الأجهزة الجوّالة للتفاعل، مثل التمرير السريع أو النقر.

اختيارية وصالحة فقط لتصميمات علامات الجهات الخارجية.

تصميمات إعلانات علامة الجهة الخارجية هي تصميمات إعلانات تستخدم hostingSource التالية:

  • HOSTING_SOURCE_THIRD_PARTY

بالإضافة إلى creativeType التالية:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
requireHtml5

boolean

اختياريّ. يشير إلى أن تصميم الإعلان يعتمد على HTML5 ليتم عرضه بشكل صحيح.

اختيارية وصالحة فقط لتصميمات علامات الجهات الخارجية. تصميمات إعلانات علامة الجهة الخارجية هي تصميمات إعلانات تستخدم hostingSource التالية:

  • HOSTING_SOURCE_THIRD_PARTY

بالإضافة إلى creativeType التالية:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
requirePingForAttribution

boolean

اختياريّ. تشير هذه القيمة إلى أنّ تصميم الإعلان سينتظر إرسال إشعار للإرجاع لتحديد مصدر الإحالة.

صالح فقط عند استخدام إعلان تتبع "مدير الحملة 360" مع معلمة خادم إعلانات جهة خارجية ووحدة الماكرو ${DC_DBM_TOKEN}.

اختيارية وصالحة فقط لتصميمات علامات الجهات الخارجية أو تصميمات إعلانات علامات VAST التابعة لجهة خارجية.

تصميمات إعلانات علامة الجهة الخارجية هي تصميمات إعلانات تستخدم hostingSource التالية:

  • HOSTING_SOURCE_THIRD_PARTY

بالإضافة إلى creativeType التالية:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE

تصميمات إعلانات علامات نموذج عرض إعلانات الفيديو التابعة لجهة خارجية هي مواد إبداعية تتضمّن hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

بالإضافة إلى creativeType التالية:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
expandingDirection

enum (ExpandingDirection)

اختياريّ. تحدد اتجاه توسيع تصميم الإعلان.

مطلوبة وصالحة فقط لتصميمات الإعلانات القابلة للتوسيع التابعة لجهات خارجية.

تصميمات الإعلانات القابلة للتوسعة التابعة لجهة خارجية هي تصميمات إعلانات لها مصدر الاستضافة التالي:

  • HOSTING_SOURCE_THIRD_PARTY

بالإضافة إلى creativeType التالية:

  • CREATIVE_TYPE_EXPANDABLE
expandOnHover

boolean

اختياريّ. يشير إلى أن تصميم الإعلان سيتم توسيعه تلقائيًا عند التمرير فوقه.

اختيارية وصالحة فقط لتصميمات الإعلانات القابلة للتوسيع التابعة لجهات خارجية. تصميمات الإعلانات القابلة للتوسعة التابعة لجهة خارجية هي تصميمات إعلانات لها مصدر الاستضافة التالي:

  • HOSTING_SOURCE_THIRD_PARTY

بالإضافة إلى creativeType التالية:

  • CREATIVE_TYPE_EXPANDABLE
vastTagUrl

string

اختياريّ. عنوان URL لعلامة VAST لتصميم علامة VAST التابعة لجهة خارجية.

مطلوبة وصالحة فقط لتصميمات علامات VAST التابعة لجهات خارجية.

تصميمات إعلانات علامات نموذج عرض إعلانات الفيديو التابعة لجهة خارجية هي مواد إبداعية تتضمّن hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

بالإضافة إلى creativeType التالية:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
vpaid

boolean

النتائج فقط. يشير إلى أن تصميم إعلان علامة نموذج عرض إعلانات الفيديو (VAST) التابع لجهة خارجية يتطلب معيار VPAID (واجهة إعلان-مشغّل الفيديو الرقمي).

النتائج فقط صالحة فقط لتصميمات علامات نموذج عرض إعلانات الفيديو (VAST) التابعة لجهات خارجية.

تصميمات إعلانات علامات نموذج عرض إعلانات الفيديو التابعة لجهة خارجية هي مواد إبداعية تتضمّن hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

بالإضافة إلى creativeType التالية:

  • CREATIVE_TYPE_VIDEO
html5Video

boolean

النتائج فقط. يشير إلى أن تصميم إعلان علامة نموذج عرض إعلانات الفيديو (VAST) التابع لجهة خارجية يتطلب دعم فيديو HTML5.

النتائج فقط صالحة فقط لتصميمات علامات نموذج عرض إعلانات الفيديو (VAST) التابعة لجهات خارجية.

تصميمات إعلانات علامات نموذج عرض إعلانات الفيديو التابعة لجهة خارجية هي مواد إبداعية تتضمّن hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

بالإضافة إلى creativeType التالية:

  • CREATIVE_TYPE_VIDEO
lineItemIds[]

string (int64 format)

النتائج فقط. أرقام تعريف العناصر المرتبطة بتصميم الإعلان هذا.

ولربط تصميم إعلان بعنصر، استخدِم LineItem.creative_ids بدلاً من ذلك.
mp3Audio

boolean

النتائج فقط. يشير إلى توافق تصميم الإعلان الصوتي التابع لجهة خارجية مع MP3.

النتائج فقط صالحة للتصاميم الصوتية التابعة لجهات خارجية فقط.

تصميمات الإعلانات الصوتية التابعة لجهة خارجية هي تصميمات إعلانات تتضمّن hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

بالإضافة إلى creativeType التالية:

  • CREATIVE_TYPE_AUDIO
oggAudio

boolean

النتائج فقط. يشير هذا الرمز إلى أنّ تصميم الإعلان الصوتي التابع لجهة خارجية متوافق مع OGG.

النتائج فقط صالحة للتصاميم الصوتية التابعة لجهات خارجية فقط.

تصميمات الإعلانات الصوتية التابعة لجهة خارجية هي تصميمات إعلانات تتضمّن hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

بالإضافة إلى creativeType التالية:

  • CREATIVE_TYPE_AUDIO

HostingSource

مصادر الاستضافة المحتملة لتصميم الإعلان يشير إلى مكان إنشاء تصميم الإعلان واستضافته.

عمليات التعداد
HOSTING_SOURCE_UNSPECIFIED لم يتم تحديد مصدر الاستضافة أو غير معروف في هذا الإصدار.
HOSTING_SOURCE_CM

تصميم إعلان تمت مزامنته من "مدير الحملة 360".

إنّ طرق الإنشاء والتعديل غير متوافقة مع نوع الاستضافة هذا.
HOSTING_SOURCE_THIRD_PARTY

تصميم إعلان يستضيفه خادم إعلانات تابع لجهة خارجية (3PAS).

تتوفّر طرق الإنشاء والتعديل لنوع الاستضافة هذا إذا كانت قيمة creativeType هي إحدى الحالات التالية:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_EXPANDABLE
  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_VIDEO
HOSTING_SOURCE_HOSTED

تصميم إعلان تم إنشاؤه في "مساحة العرض والفيديو 360" وتتم استضافته من خلال "مدير الحملة 360".

تتوفّر طرق الإنشاء والتعديل لنوع الاستضافة هذا إذا كانت قيمة creativeType هي إحدى الحالات التالية:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_VIDEO
HOSTING_SOURCE_RICH_MEDIA

تصميم إعلان من الوسائط التفاعلية المتقدّمة تم إنشاؤه في "استوديو YouTube" ويستضيفه "مدير الحملة 360".

إنّ طرق الإنشاء والتعديل غير متوافقة مع نوع الاستضافة هذا.

CreativeAttribute

السمات المحتملة لتصميم الإعلان

عمليات التعداد
CREATIVE_ATTRIBUTE_UNSPECIFIED لم يتم تحديد سمة تصميم الإعلان أو غير معروفة في هذا الإصدار.
CREATIVE_ATTRIBUTE_VAST تصميم الإعلان عبارة عن تصميم إعلان نموذج عرض إعلانات فيديو (VAST).
CREATIVE_ATTRIBUTE_VPAID_LINEAR تصميم الإعلان هو تصميم إعلان خطي بمعيار VPAID.
CREATIVE_ATTRIBUTE_VPAID_NON_LINEAR تصميم الإعلان هو تصميم إعلان غير خطي بمعيار VPAID.

ReviewStatusInfo

راجِع حالات تصميم الإعلان.

تمثيل JSON 
{
  "approvalStatus": enum (ApprovalStatus),
  "creativeAndLandingPageReviewStatus": enum (ReviewStatus),
  "contentAndPolicyReviewStatus": enum (ReviewStatus),
  "exchangeReviewStatuses": [
    {
      object (ExchangeReviewStatus)
    }
  ],
  "publisherReviewStatuses": [
    {
      object (PublisherReviewStatus)
    }
  ]
}
الحقول
approvalStatus

enum (ApprovalStatus)

يمثل الموافقة الأساسية اللازمة لبدء عرض تصميم الإعلان. ملخّص عن creativeAndLandingPageReviewStatus وcontentAndPolicyReviewStatus
creativeAndLandingPageReviewStatus

enum (ReviewStatus)

حالة مراجعة تصميم الإعلان والصفحة المقصودة لتصميم الإعلان.
contentAndPolicyReviewStatus

enum (ReviewStatus)

حالة مراجعة المحتوى والسياسات لتصميم الإعلان
exchangeReviewStatuses[]

object (ExchangeReviewStatus)

تبادل حالات مراجعة تصميم الإعلان.
publisherReviewStatuses[]

object (PublisherReviewStatus)

حالات مراجعة الناشر لتصميم الإعلان

ApprovalStatus

الأنواع المحتملة من حالات الموافقة إنّه ملخّص creativeAndLandingPageReviewStatus وcontentAndPolicyReviewStatus.

عمليات التعداد
APPROVAL_STATUS_UNSPECIFIED لم يتم تحديد قيمة النوع أو غير معروفة في هذا الإصدار.
APPROVAL_STATUS_PENDING_NOT_SERVABLE لا يزال تصميم الإعلان قيد المراجعة وغير قابل للعرض.
APPROVAL_STATUS_PENDING_SERVABLE اجتاز تصميم الإعلان مراجعة تصميم الإعلان والصفحات المقصودة وهو قابل للعرض، ولكنه في انتظار مراجعة إضافية للمحتوى والسياسات.
APPROVAL_STATUS_APPROVED_SERVABLE تمت الموافقة على كلٍّ من مراجعة تصميمات الإعلانات والصفحات المقصودة ومراجعة المحتوى ومراجعة السياسات. تصميم الإعلان قابل للعرض.
APPROVAL_STATUS_REJECTED_NOT_SERVABLE هناك مشكلة في تصميم الإعلان يجب إصلاحها قبل أن يتم عرضه.

ReviewStatus

الأنواع المحتملة من حالات المراجعة

عمليات التعداد
REVIEW_STATUS_UNSPECIFIED لم يتم تحديد قيمة النوع أو غير معروفة في هذا الإصدار.
REVIEW_STATUS_APPROVED تمت الموافقة على تصميم الإعلان.
REVIEW_STATUS_REJECTED يتم رفض تصميم الإعلان.
REVIEW_STATUS_PENDING تصميم الإعلان في انتظار المراجعة.

ExchangeReviewStatus

حالة مراجعة Exchange لتصميم الإعلان

تمثيل JSON 
{
  "exchange": enum (Exchange),
  "status": enum (ReviewStatus)
}
الحقول
exchange

enum (Exchange)

موضع التبادل الذي يراجع تصميم الإعلان.
status

enum (ReviewStatus)

حالة مراجعة التبادل

PublisherReviewStatus

حالة مراجعة الناشر لتصميم الإعلان.

تمثيل JSON 
{
  "publisherName": string,
  "status": enum (ReviewStatus)
}
الحقول
publisherName

string

الناشر الذي يراجع تصميم الإعلان.
status

enum (ReviewStatus)

حالة مراجعة الناشر

AssetAssociation

ارتباط مادة العرض لتصميم الإعلان.

تمثيل JSON 
{
  "asset": {
    object (Asset)
  },
  "role": enum (AssetRole)
}
الحقول
asset

object (Asset)

مادة العرض المرتبطة
role

enum (AssetRole)

دور مادة العرض هذه في تصميم الإعلان.

مادة العرض

مادة عرض واحدة

تمثيل JSON 
{
  "mediaId": string,
  "content": string
}
الحقول
mediaId

string (int64 format)

رقم تعريف الوسائط لمادة العرض التي تم تحميلها. هذا الرقم هو معرّف فريد لمادة العرض. يمكن تمرير رقم التعريف هذا إلى طلبات بيانات أخرى من واجهة برمجة التطبيقات، مثل creatives.create لربط مادة العرض بتصميم إعلان.

تم تعديل مساحة Media ID في 5 نيسان (أبريل) 2023. عدِّل معرّفات الوسائط التي تم تخزينها مؤقتًا قبل 5 نيسان (أبريل) 2023 من خلال استرداد معرّف الوسائط الجديد من موارد المواد الإبداعية المرتبطة أو إعادة تحميل مادة العرض.
content

string

محتوى مادة العرض بالنسبة إلى مواد العرض المحمَّلة، يكون المحتوى هو مسار العرض.

AssetRole

دور مادة العرض هذه في تصميم الإعلان.

عمليات التعداد
ASSET_ROLE_UNSPECIFIED دور مادة العرض غير محدد أو غير معروف في هذا الإصدار.
ASSET_ROLE_MAIN مادة العرض هي مادة العرض الرئيسية لتصميم الإعلان.
ASSET_ROLE_BACKUP مادة العرض هي مادة عرض احتياطية لتصميم الإعلان.
ASSET_ROLE_POLITE_LOAD مادة العرض هي مادة عرض تحميل مهذبة لتصميم الإعلان.
ASSET_ROLE_HEADLINE

عنوان لتصميم إعلان مدمج مع المحتوى.

ويجب أن يكون content بترميز UTF-8 بطول لا يزيد عن 25 حرفًا.

هذا الدور غير متاح إلا في أنواع "creativeType" التالية:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_LONG_HEADLINE

عنوان طويل لتصميم إعلان مدمج مع المحتوى

ويجب أن يكون content بترميز UTF-8 بطول لا يزيد عن 50 حرفًا.

هذا الدور غير متاح إلا في أنواع "creativeType" التالية:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_BODY

النص الأساسي لتصميم الإعلان المدمج مع المحتوى.

ويجب أن يكون content بترميز UTF-8 بطول لا يزيد عن 90 حرفًا.

هذا الدور غير متاح إلا في أنواع "creativeType" التالية:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_LONG_BODY

نص أساسي طويل لتصميم إعلان مدمج

ويجب أن يكون content بترميز UTF-8 بطول لا يزيد عن 150 حرفًا.

هذا الدور غير متاح إلا في أنواع "creativeType" التالية:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_CAPTION_URL

نسخة قصيرة وبسيطة من عنوان URL للصفحة المقصودة يتم عرضها في تصميم الإعلان. يمنح عنوان URL هذا الأشخاص فكرة عن الصفحة التي سيتم توجيههم إليها بعد أن ينقروا على تصميم الإعلان.

ويجب أن يكون content بترميز UTF-8 بطول لا يزيد عن 30 حرفًا.

على سبيل المثال، إذا كان عنوان URL للصفحة المقصودة هو "http://www.example.com/page"، يمكن أن يكون عنوان URL للترجمة والشرح هو "example.com". يُعتبر البروتوكول (http://) اختياريًا، ولكن لا يمكن أن يحتوي عنوان URL على مسافات أو رموز خاصة.

هذا الدور غير متاح إلا في أنواع "creativeType" التالية:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_CALL_TO_ACTION

النص المطلوب استخدامه على زر عبارة الحث على اتخاذ إجراء في تصميم إعلان مدمج مع المحتوى.

يجب أن يكون content بترميز UTF-8 بطول لا يزيد عن 15 حرفًا.

هذا الدور غير متاح إلا في أنواع "creativeType" التالية:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_ADVERTISER_NAME

النص الذي يحدّد اسم المعلن أو العلامة التجارية.

ويجب أن يكون content بترميز UTF-8 بطول لا يزيد عن 25 حرفًا.

هذا الدور غير متاح إلا في أنواع "creativeType" التالية:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_PRICE

سعر شراء تطبيقك في متجر Google Play أو متجر تطبيقات iOS (على سبيل المثال، 5.99 دولار أمريكي)

يُرجى العِلم أنّه لا تتم مزامنة هذه القيمة تلقائيًا مع القيمة الفعلية المدرَجة في المتجر. وسيكون هو العنوان الذي يتم تقديمه عند حفظ تصميم الإعلان.

يجب أن يكون content بترميز UTF-8 بطول لا يزيد عن 15 حرفًا.

مواد عرض هذا الدور للقراءة فقط.
ASSET_ROLE_ANDROID_APP_ID

رقم تعريف تطبيق Android في "متجر Google Play".

يمكنك العثور على هذا المعرّف في عنوان URL للتطبيق في "متجر Google Play" بعد "id". على سبيل المثال، في https://play.google.com/store/apps/details?id=com.company.appname، يكون المعرّف هو com.company.appname.

مواد عرض هذا الدور للقراءة فقط.
ASSET_ROLE_IOS_APP_ID

رقم تعريف تطبيق iOS في متجر تطبيقات Apple.

يمكن العثور على رقم التعريف هذا في عنوان URL لمتجر Apple App Store كسلسلة من الأرقام بعد "id" مباشرةً. على سبيل المثال، في https://apps.apple.com/us/app/gmail-email-by-google/id422689480، يكون رقم التعريف هو 422689480.

مواد عرض هذا الدور للقراءة فقط.
ASSET_ROLE_RATING

تقييم تطبيق في "متجر Google Play" أو متجر تطبيقات iOS

يُرجى العلم أنّه لا تتم مزامنة هذه القيمة تلقائيًا مع التقييم الفعلي في المتجر. وسيكون هو العنوان الذي يتم تقديمه عند حفظ تصميم الإعلان.

مواد عرض هذا الدور للقراءة فقط.
ASSET_ROLE_ICON

رمز تصميم الإعلان.

هذا الدور متاح ومطلوب فقط في creativeType التالية:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
ASSET_ROLE_COVER_IMAGE

صورة الغلاف لتصميم إعلان فيديو مدمج مع المحتوى

هذا الدور متاح ومطلوب فقط في creativeType التالية:

  • CREATIVE_TYPE_VIDEO

ExitEvent

الخروج من حدث تصميم الإعلان.

تمثيل JSON 
{
  "type": enum (ExitEventType),
  "url": string,
  "name": string,
  "reportingName": string
}
الحقول
type

enum (ExitEventType)

مطلوبة. نوع حدث الخروج.
url

string

مطلوبة. عنوان URL للنقرة لحدث الخروج. هذا الإجراء مطلوب في الحالات التالية: type:

  • EXIT_EVENT_TYPE_DEFAULT
  • EXIT_EVENT_TYPE_BACKUP
name

string

اسم علامة النقر لحدث الخروج.

يجب أن يكون الاسم فريدًا في تصميم إعلان واحد.

يمكنك ترك هذا الحقل فارغًا أو بدون ضبط لتصاميم الإعلانات التي تحتوي على مواد عرض صور فقط.
reportingName

string

الاسم المستخدَم لتحديد هذا الحدث في التقارير. يمكنك ترك هذا الحقل فارغًا أو بدون ضبط لتصاميم الإعلانات التي تحتوي على مواد عرض صور فقط.

ExitEventType

نوع حدث الخروج.

عمليات التعداد
EXIT_EVENT_TYPE_UNSPECIFIED نوع حدث الخروج غير محدّد أو غير معروف في هذا الإصدار.
EXIT_EVENT_TYPE_DEFAULT حدث الخروج هو الحدث التلقائي.
EXIT_EVENT_TYPE_BACKUP حدث الخروج هو حدث خروج احتياطي. قد تكون هناك عدة أحداث خروج احتياطية في تصميم إعلان.

TimerEvent

حدث الموقّت لتصميم الإعلان.

تمثيل JSON 
{
  "name": string,
  "reportingName": string
}
الحقول
name

string

مطلوبة. اسم حدث الموقّت.
reportingName

string

مطلوبة. الاسم المستخدَم لتحديد حدث الموقّت هذا في التقارير.

CounterEvent

الحدث المضاد لتصميم الإعلان.

تمثيل JSON 
{
  "name": string,
  "reportingName": string
}
الحقول
name

string

مطلوبة. اسم الحدث المضاد
reportingName

string

مطلوبة. الاسم المستخدَم لتحديد هذا الحدث المضاد في التقارير

AudioVideoOffset

مدة تشغيل الصوت أو الفيديو

تمثيل JSON 
{

  // Union field offset can be only one of the following:
  "percentage": string,
  "seconds": string
  // End of list of possible types for union field offset.
}
الحقول
حقل الاتحاد offset قيمة الإزاحة. يمكن أن يكون الحقل "offset" واحدًا فقط مما يلي:
percentage

string (int64 format)

الانحراف بالنسبة المئوية لمدة الصوت أو الفيديو.
seconds

string (int64 format)

الإزاحة بالثواني من بداية الصوت أو الفيديو.

UniversalAdId

معرّف تصميم إعلان توفّره قاعدة بيانات المسجّلين ويكون فريدًا في جميع المنصات هذا جزء من معيار VAST 4.0.

تمثيل JSON 
{
  "id": string,
  "registry": enum (UniversalAdRegistry)
}
الحقول
id

string

المعرّف الفريد لتصميم الإعلان.
registry

enum (UniversalAdRegistry)

توفّر قاعدة بيانات المسجّلين معرّفات فريدة لتصميمات الإعلانات.

UniversalAdRegistry

وتوفِّر قاعدة بيانات المسجّلين معرّفات فريدة لتصميمات الإعلانات في المعرّف العام للإعلان.

عمليات التعداد
UNIVERSAL_AD_REGISTRY_UNSPECIFIED سجلّ الإعلانات العامة غير محدّد أو غير معروف في هذا الإصدار.
UNIVERSAL_AD_REGISTRY_OTHER استخدِم موفِّر خدمة مخصّصًا لتقديم معرّف الإعلان العام.
UNIVERSAL_AD_REGISTRY_AD_ID استخدِم رقم تعريف الإعلان لتقديم رقم تعريف الإعلان العام.
UNIVERSAL_AD_REGISTRY_CLEARCAST استخدِم clearcast.co.uk لتقديم رقم تعريف الإعلان العام.
UNIVERSAL_AD_REGISTRY_DV360 استخدِم "مساحة العرض والفيديو 360" لتقديم رقم تعريف الإعلان العام.
UNIVERSAL_AD_REGISTRY_CM استخدِم "مدير الحملة 360" لتقديم رقم تعريف الإعلان العام.

ThirdPartyUrl

تتبُّع عناوين URL من جهات خارجية لتتبُّع التفاعلات مع تصميم إعلان صوتي أو فيديو

تمثيل JSON 
{
  "type": enum (ThirdPartyUrlType),
  "url": string
}
الحقول
type

enum (ThirdPartyUrlType)

نوع التفاعل الذي يجب تتبُّعه من خلال عنوان URL للتتبّع
url

string

عنوان URL للتتبُّع المستخدَم لتتبُّع التفاعل.

يُرجى تقديم عنوان URL يتضمّن مسارًا أو سلسلة طلب بحث اختيارية يبدأ بـ https:. على سبيل المثال، https://www.example.com/path

ThirdPartyUrlType

نوع التفاعل الذي يجب تتبُّعه من خلال عنوان URL لتتبُّع الجهة الخارجية.

عمليات التعداد
THIRD_PARTY_URL_TYPE_UNSPECIFIED نوع عنوان URL التابع لجهة خارجية غير محدّد أو غير معروف في هذا الإصدار.
THIRD_PARTY_URL_TYPE_IMPRESSION يتم استخدام البيانات لحساب مرات ظهور تصميم الإعلان بعد اكتمال التخزين المؤقت للصوت أو الفيديو.
THIRD_PARTY_URL_TYPE_CLICK_TRACKING يتم استخدامه لتتبُّع نقرات المستخدم على الصوت أو الفيديو.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_START يتم استخدام هذه الخدمة لتتبُّع عدد المرات التي يشغِّل فيها المستخدم الصوت أو الفيديو.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_FIRST_QUARTILE يُستخدم لتتبُّع عدد مرات تشغيل الصوت أو الفيديو حتى% 25 من مدته.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_MIDPOINT يُستخدم لتتبُّع عدد مرات تشغيل الصوت أو الفيديو حتى 50% من مدته.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_THIRD_QUARTILE تُستخدم هذه الوظيفة لتتبُّع عدد مرات تشغيل الصوت أو الفيديو حتى% 75 من مدته.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_COMPLETE يُستخدم لتتبُّع عدد مرات تشغيل الصوت أو الفيديو حتى النهاية.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_MUTE يتم استخدام هذه الخدمة لتتبُّع عدد المرات التي يكتم فيها المستخدم الصوت أو الفيديو.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_PAUSE يتم استخدام هذه الخدمة لتتبُّع عدد المرات التي يوقف فيها المستخدم الصوت أو الفيديو مؤقتًا.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_REWIND تُستخدَم هذه الوظيفة لتتبُّع عدد المرات التي يُعيد فيها المستخدم تشغيل الصوت أو الفيديو.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_FULLSCREEN تُستخدَم هذه الوظيفة لتتبُّع عدد المرات التي يوسّع فيها المستخدم المشغّل إلى حجم ملء الشاشة.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_STOP يتم استخدام هذه الخدمة لتتبُّع عدد المرات التي يوقف فيها المستخدم الصوت أو الفيديو.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_CUSTOM يُستخدم لتتبُّع عدد المرات التي يقوم فيها المستخدم بالنقر المخصص، مثل النقر على نقطة اتصال بالفيديو.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_SKIP يتم استخدام البيانات لتتبّع عدد مرّات تخطّي الصوت أو الفيديو.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_PROGRESS تُستخدَم هذه الوظيفة لتتبُّع عدد مرات تشغيل الصوت أو الفيديو بإزاحة تحدِّدها progressOffset.

تحويل الترميز

تمثل هذه السمة معلومات عن ملف الصوت أو الفيديو الذي تم تحويل ترميزه.

تمثيل JSON 
{
  "name": string,
  "mimeType": string,
  "transcoded": boolean,
  "dimensions": {
    object (Dimensions)
  },
  "bitRateKbps": string,
  "frameRate": number,
  "audioBitRateKbps": string,
  "audioSampleRateHz": string,
  "fileSizeBytes": string
}
الحقول
name

string

اسم الملف الذي تم تحويل ترميزه
mimeType

string

تمثّل هذه السمة نوع MIME للملف الذي تم تحويل ترميزه.
transcoded

boolean

يشير إلى ما إذا كان تحويل الترميز قد تم بنجاح.
dimensions

object (Dimensions)

أبعاد الفيديو الذي تم تحويل ترميزه.
bitRateKbps

string (int64 format)

معدّل نقل بيانات تحويل الترميز للفيديو الذي تم تحويل ترميزه بالكيلوبت في الثانية
frameRate

number

عدد اللقطات في الثانية للفيديو الذي تم تحويل ترميزه، باللقطات في الثانية.
audioBitRateKbps

string (int64 format)

معدّل نقل البيانات للبث الصوتي للفيديو الذي تم تحويل ترميزه، أو معدّل نقل بيانات الصوت الذي تم تحويل ترميزه، بالكيلوبت في الثانية.
audioSampleRateHz

string (int64 format)

معدّل البيانات في الملف الصوتي للبث الصوتي للفيديو الذي تم تحويل ترميزه، أو معدّل العيّنة للصوت الذي تم تحويل ترميزه، بالهرتز
fileSizeBytes

string (int64 format)

تمثّل هذه السمة حجم الملف الذي تم تحويل ترميزه بالبايت.

CmTrackingAd

إعلان تتبُّع في "مدير الحملة 360".

تمثيل JSON 
{
  "cmPlacementId": string,
  "cmCreativeId": string,
  "cmAdId": string
}
الحقول
cmPlacementId

string (int64 format)

رقم تعريف موضع إعلان تتبع "مدير الحملة 360".
cmCreativeId

string (int64 format)

رقم تعريف تصميم الإعلان لإعلان التتبُّع في "مدير الحملة 360".
cmAdId

string (int64 format)

رقم تعريف إعلان التتبّع 360 في "مدير الحملة".

ObaIcon

رمز OBA لتصاميم الإعلانات

تمثيل JSON 
{
  "resourceUrl": string,
  "resourceMimeType": string,
  "position": enum (ObaIconPosition),
  "dimensions": {
    object (Dimensions)
  },
  "program": string,
  "landingPageUrl": string,
  "clickTrackingUrl": string,
  "viewTrackingUrl": string
}
الحقول
resourceUrl

string

تمثّل هذه السمة عنوان URL لمورد رمز OBA.
resourceMimeType

string

تمثّل هذه السمة نوع MIME لمورد رمز OBA.
position

enum (ObaIconPosition)

تمثّل هذه السمة موضع رمز OBA في تصميم الإعلان.
dimensions

object (Dimensions)

تمثّل هذه السمة أبعاد رمز OBA.
program

string

برنامج رمز OBA. على سبيل المثال: "خيارات الإعلان".
landingPageUrl

string

مطلوبة. تمثّل هذه السمة عنوان URL للصفحة المقصودة لرمز OBA.

يُسمح فقط بعناوين URL للنطاقات التالية:
clickTrackingUrl

string

مطلوبة. عنوان URL لتتبُّع النقرات لرمز OBA.

يُسمح فقط بعناوين URL للنطاقات التالية:
viewTrackingUrl

string

مطلوبة. عنوان URL لتتبّع العرض الخاص برمز OBA.

يُسمح فقط بعناوين URL للنطاقات التالية:

ObaIconPosition

تمثّل هذه السمة موضع رمز OBA في تصميم الإعلان.

عمليات التعداد
OBA_ICON_POSITION_UNSPECIFIED لم يتم تحديد موضع رمز OBA.
OBA_ICON_POSITION_UPPER_RIGHT في أعلى يسار تصميم الإعلان.
OBA_ICON_POSITION_UPPER_LEFT في أعلى يمين تصميم الإعلان.
OBA_ICON_POSITION_LOWER_RIGHT في أسفل يسار تصميم الإعلان.
OBA_ICON_POSITION_LOWER_LEFT في الجانب السفلي الأيمن من تصميم الإعلان.

ExpandingDirection

الاتجاه الموسع لتصميم الإعلان القابل للتوسيع والتابع لجهة خارجية.

عمليات التعداد
EXPANDING_DIRECTION_UNSPECIFIED لم يتم تحديد اتجاه التوسيع.
EXPANDING_DIRECTION_NONE لا يتسع في أي اتجاه.
EXPANDING_DIRECTION_UP توسيع لأعلى.
EXPANDING_DIRECTION_DOWN توسيع للأسفل.
EXPANDING_DIRECTION_LEFT لتوسيع اليمين
EXPANDING_DIRECTION_RIGHT توسيع جهة اليسار
EXPANDING_DIRECTION_UP_AND_LEFT لتوسيع لأعلى وللجانب الأيسر.
EXPANDING_DIRECTION_UP_AND_RIGHT توسيع لأعلى وعلى الجانب الأيمن.
EXPANDING_DIRECTION_DOWN_AND_LEFT لتوسيع لأسفل وإلى الجانب الأيسر.
EXPANDING_DIRECTION_DOWN_AND_RIGHT توسيع لأسفل وإلى الجانب الأيمن.
EXPANDING_DIRECTION_UP_OR_DOWN لتوسيع الأعلى أو الأسفل.
EXPANDING_DIRECTION_LEFT_OR_RIGHT توسيع إما إلى الجانب الأيمن أو الأيسر.
EXPANDING_DIRECTION_ANY_DIAGONAL يمكن توسيعه في أي اتجاه قُطري.

الطُرق

create

 تنشئ تصميم إعلان جديدًا.

delete

 لحذف تصميم إعلان.

get

 إبداع بلا حدود.

list

 يسرد تصميمات الإعلانات في أحد المعلنين.

patch

 تعديل تصميم إعلان حالي