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)

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

يشكّل رقم تعريف الإعلانات العامة جزءًا من معيار VAST 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 أو script

يمكن كتابة هذا الحقل فقط في ما يلي: creativeType:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
jsTrackerUrl

string

عنوان URL لقياس JavaScript من موفّري خدمة معتمدين تابعين لجهات خارجية (ComScore و DoubleVerify و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[]
(deprecated)

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

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

يعدِّل تصميم إعلان حالي.