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 عادية فقط، بدون علامات IMG أو سيناريو.

لا يمكن كتابة هذا الحقل إلّا بلغة 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

تصميمات إعلانات علامات VAST التابعة لجهة خارجية هي تصميمات إعلانات تتضمّن 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 التابعة لجهة خارجية.

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

  • HOSTING_SOURCE_THIRD_PARTY

مع creativeType التالية:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
vpaid

boolean

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

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

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

  • HOSTING_SOURCE_THIRD_PARTY

مع creativeType التالية:

  • CREATIVE_TYPE_VIDEO
html5Video

boolean

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

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

تصميمات إعلانات علامات 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)

حالات مراجعة تصميم الإعلان من خلال Exchange
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

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

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

enum (Exchange)

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

enum (ReviewStatus)

حالة مراجعة Exchange

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 لربط مادة العرض بتصميم إعلان.

تم تعديل مساحة معرّف الوسائط في 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

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