REST Resource: customers.ads

FinalAppUrl

عنوان URL للربط بصفحات معيّنة في تطبيق لنظام التشغيل المحدّد.

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

enum (AppUrlOperatingSystemType)

نظام التشغيل المستهدف من خلال عنوان URL هذا. مطلوبة.
url

string

عنوان URL لرابط صفحة معيّنة في التطبيق. تحدد الروابط المؤدية إلى صفحات في التطبيق موقعًا جغرافيًا في التطبيق يتوافق مع المحتوى الذي تريد عرضه، ويجب أن يكون على النحو التالي {scheme}://{host_path}. ويحدِّد المخطط التطبيق المطلوب فتحه. بالنسبة إلى تطبيقك، يمكنك استخدام مخطط مخصَّص يبدأ باسم التطبيق. يحدد المضيف والمسار الموقع الفريد في التطبيق حيث يوجد المحتوى. مثال: "exampleapp://productid_1234". مطلوبة.

AppUrlOperatingSystemType

نظام التشغيل

عمليات التعداد
UNSPECIFIED عدم تحديد صيغة مخاطبة
UNKNOWN تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
IOS نظام التشغيل Apple IOS.
ANDROID نظام التشغيل Android.

CustomParameter

عملية ربط يمكن استخدامها بواسطة علامات مَعلمات مخصّصة في trackingUrlTemplate أو finalUrls أو mobile_final_urls.

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

string

المفتاح الذي يطابق اسم علامة المَعلمة
value

string

القيمة المطلوب استبدالها.

AdType

تمثّل هذه السمة الأنواع الممكنة من الإعلان.

عمليات التعداد
UNSPECIFIED لم يتم تحديد قيمة.
UNKNOWN

القيمة المُستلَمة غير معروفة في هذا الإصدار.

هذه قيمة للاستجابة فقط.
TEXT_AD الإعلان عبارة عن إعلان نصي.
EXPANDED_TEXT_AD الإعلان عبارة عن إعلان نصي موسَّع.
EXPANDED_DYNAMIC_SEARCH_AD الإعلان هو إعلان ديناميكي موسّع على شبكة البحث.
HOTEL_AD الإعلان هو إعلان فندق.
SHOPPING_SMART_AD الإعلان هو إعلان Shopping ذكي.
SHOPPING_PRODUCT_AD يُعتبر الإعلان إعلان Shopping عاديًا.
VIDEO_AD الإعلان هو إعلان فيديو.
IMAGE_AD هذا الإعلان عبارة عن إعلان مصوّر.
RESPONSIVE_SEARCH_AD الإعلان عبارة عن إعلان متجاوب على شبكة البحث.
LEGACY_RESPONSIVE_DISPLAY_AD الإعلان هو إعلان صوري متجاوب قديم.
APP_AD الإعلان هو إعلان تطبيق.
LEGACY_APP_INSTALL_AD الإعلان عبارة عن إعلان قديم لتثبيت التطبيق.
RESPONSIVE_DISPLAY_AD يُعتبر الإعلان إعلانًا صوريًا متجاوبًا.
LOCAL_AD الإعلان محلي.
HTML5_UPLOAD_AD الإعلان عبارة عن إعلان صوري من نوع المنتج HTML5_UPLOAD_AD.
DYNAMIC_HTML5_AD الإعلان عبارة عن إعلان صوري لتحميل الصور باستخدام أحد أنواع المنتجات DYNAMIC_HTML5_*.
APP_ENGAGEMENT_AD الإعلان هو إعلان جذب إلى تطبيق.
SHOPPING_COMPARISON_LISTING_AD الإعلان هو إعلان مقارنة على Shopping.
VIDEO_BUMPER_AD إعلان ملصق صغير للفيديو.
VIDEO_NON_SKIPPABLE_IN_STREAM_AD إعلان فيديو غير قابل للتخطي أثناء عرض الفيديو.
VIDEO_OUTSTREAM_AD إعلان فيديو خارج البث
VIDEO_TRUEVIEW_IN_STREAM_AD إعلان فيديو TrueView أثناء عرض الفيديو.
VIDEO_RESPONSIVE_AD إعلان فيديو متجاوب.
SMART_CAMPAIGN_AD إعلان حملة ذكية.
CALL_AD إعلان للاتصال.
APP_PRE_REGISTRATION_AD إعلان تسجيل مُسبَق لتطبيقات عامة.
IN_FEED_VIDEO_AD إعلان فيديو ضمن الخلاصة.
DISCOVERY_MULTI_ASSET_AD إعلان متعدد مواد العرض أثناء التصفّح.
TRAVEL_AD إعلان سفر.
DISCOVERY_VIDEO_RESPONSIVE_AD إعلان متجاوب للفيديو أثناء التصفّح

الجهاز

لتعداد أجهزة "إعلانات Google" المتاحة للاستهداف.

عمليات التعداد
UNSPECIFIED عدم تحديد صيغة مخاطبة
UNKNOWN القيمة غير معروفة في هذا الإصدار.
MOBILE الأجهزة الجوّالة المجهزة بمتصفّحات إنترنت كاملة الوظائف
TABLET الأجهزة اللوحية المزوّدة بمتصفّحات بوظائف كاملة.
DESKTOP أجهزة الكمبيوتر.
CONNECTED_TV أجهزة التلفزيون الذكية ووحدات تحكّم الألعاب
OTHER أنواع الأجهزة الأخرى

UrlCollection

مجموعة من عناوين URL التي تم وضع علامة عليها باستخدام معرّف فريد

تمثيل JSON 
{
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCollectionId": string,
  "trackingUrlTemplate": string
}
الحقول
finalUrls[]

string

قائمة بعناوين URL النهائية المحتملة.
finalMobileUrls[]

string

قائمة بعناوين URL النهائية المحتملة للأجهزة الجوّالة.
urlCollectionId

string

المعرّف الفريد لمثيل UrlCollection هذا.
trackingUrlTemplate

string

نموذج عنوان URL لإنشاء عنوان URL للتتبّع.

SystemManagedResourceSource

يشير هذا المقياس إلى قائمة تعداد قائمة بمصادر الكيانات التي يديرها النظام.

عمليات التعداد
UNSPECIFIED عدم تحديد صيغة مخاطبة
UNKNOWN تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
AD_VARIATIONS إعلان تجربة لصيغ الإعلان المُنشأة.

TextAdInfo

إعلان نصي.

تمثيل JSON 
{
  "headline": string,
  "description1": string,
  "description2": string
}
الحقول
headline

string

عنوان الإعلان.
description1

string

السطر الأول من وصف الإعلان.
description2

string

السطر الثاني من وصف الإعلان.

ExpandedTextAdInfo

إعلان نصي موسَّع

تمثيل JSON 
{
  "headlinePart1": string,
  "headlinePart2": string,
  "headlinePart3": string,
  "description": string,
  "description2": string,
  "path1": string,
  "path2": string
}
الحقول
headlinePart1

string

الجزء الأول من عنوان الإعلان.
headlinePart2

string

الجزء الثاني من عنوان الإعلان.
headlinePart3

string

الجزء الثالث من عنوان الإعلان.
description

string

وصف الإعلان.
description2

string

الوصف الثاني للإعلان.
path1

string

النص الذي يمكن أن يظهر بجانب عنوان URL المعروض للإعلان
path2

string

نص إضافي يمكن أن يظهر إلى جانب عنوان URL المعروض للإعلان

CallAdInfo

إعلان للاتصال.

تمثيل JSON 
{
  "countryCode": string,
  "phoneNumber": string,
  "businessName": string,
  "headline1": string,
  "headline2": string,
  "description1": string,
  "description2": string,
  "callTracked": boolean,
  "disableCallConversion": boolean,
  "phoneNumberVerificationUrl": string,
  "conversionAction": string,
  "conversionReportingState": enum (CallConversionReportingState),
  "path1": string,
  "path2": string
}
الحقول
countryCode

string

رمز البلد في الإعلان.
phoneNumber

string

رقم الهاتف الظاهر في الإعلان
businessName

string

اسم النشاط التجاري في الإعلان.
headline1

string

العنوان الأول في الإعلان.
headline2

string

العنوان الثاني في الإعلان.
description1

string

السطر الأول من وصف الإعلان.
description2

string

السطر الثاني من وصف الإعلان.
callTracked

boolean

ما إذا كان سيتم تفعيل تتبُّع المكالمات في تصميم الإعلان. يؤدّي تفعيل ميزة تتبُّع المكالمات أيضًا إلى تفعيل الإحالات الناجحة عبر الاتصال الهاتفي.
disableCallConversion

boolean

ما إذا كان سيتم إيقاف الإحالة الناجحة عبر الاتصال الهاتفي في تصميم الإعلان. وفي حال الضبط على true، سيتم إيقاف الإحالات الناجحة عبر الاتصال الهاتفي حتى إذا كانت قيمة callTracked هي true. وإذا كانت قيمة callTracked هي false، سيتم تجاهل هذا الحقل.
phoneNumberVerificationUrl

string

عنوان URL الذي سيتم استخدامه لإثبات ملكية رقم الهاتف.
conversionAction

string

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

enum (CallConversionReportingState)

سلوك إحالة ناجحة عبر الاتصال الهاتفي في إعلان الاتصال هذا. ويمكن أن تستخدِم هذه الميزة إعداد الإحالة الناجحة عبر الاتصال الهاتفي، أو أن تكتسب الإعداد على مستوى الحساب، أو يتم إيقافها.
path1

string

الجزء الأول من النص الذي يمكن إلحاقه بعنوان URL في الإعلان اختياريّ.
path2

string

الجزء الثاني من النص الذي يمكن إلحاقه بعنوان URL في الإعلان لا يمكن ضبط هذا الحقل إلا عند ضبط "path1" أيضًا. اختياريّ.

CallConversionReportingState

أنواع البيانات المحتملة لحالة إجراء إحالة ناجحة عبر الاتصال الهاتفي.

عمليات التعداد
UNSPECIFIED عدم تحديد صيغة مخاطبة
UNKNOWN تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
DISABLED تم إيقاف إجراء الإحالة الناجحة للمكالمة.
USE_ACCOUNT_LEVEL_CALL_CONVERSION_ACTION سيستخدِم إجراء الإحالة الناجحة عبر الاتصال الهاتفي نوع الإحالة الناجحة عبر الاتصال الهاتفي المحدّد على مستوى الحساب.
USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION سيستخدم إجراء الإحالة الناجحة عبر الاتصال الهاتفي نوع الإحالة الناجحة عبر الاتصال الهاتفي المحدّد على مستوى المورد (إعلانات للاتصال فقط/إضافات المكالمات).

ExpandedDynamicSearchAdInfo

إعلان ديناميكي موسّع على شبكة البحث

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

string

وصف الإعلان.
description2

string

الوصف الثاني للإعلان.

HotelAdInfo

لا يشتمل هذا النوع على أي حقول.

إعلان فندق

ShoppingSmartAdInfo

لا يشتمل هذا النوع على أي حقول.

إعلان Shopping ذكي

ShoppingProductAdInfo

لا يشتمل هذا النوع على أي حقول.

إعلان Shopping عادي

ImageAdInfo

إعلان مصوّر

تمثيل JSON 
{
  "mimeType": enum (MimeType),
  "pixelWidth": string,
  "pixelHeight": string,
  "imageUrl": string,
  "previewPixelWidth": string,
  "previewPixelHeight": string,
  "previewImageUrl": string,
  "name": string,

  // Union field image can be only one of the following:
  "mediaFile": string,
  "data": string,
  "adIdToCopyImageFrom": string
  // End of list of possible types for union field image.
}
الحقول
mimeType

enum (MimeType)

نوع MIME للصورة
pixelWidth

string (int64 format)

عرض الصورة بالحجم الكامل بالبكسل
pixelHeight

string (int64 format)

الارتفاع بالبكسل للصورة بالحجم الكامل.
imageUrl

string

عنوان URL للصورة بالحجم الكامل
previewPixelWidth

string (int64 format)

عرض بالبكسل لصورة حجم المعاينة
previewPixelHeight

string (int64 format)

الارتفاع بالبكسل لصورة حجم المعاينة.
previewImageUrl

string

عنوان URL لصورة حجم المعاينة
name

string

اسم الصورة إذا تم إنشاء الصورة من ملف MediaFile، يكون هذا هو اسم الملف MediaFile. إذا تم إنشاء الصورة من وحدات بايت، سيكون هذا الحقل فارغًا.
حقل الاتحاد image الصورة المطلوب إنشاء إعلان مصوّر منها. يمكن تحديد ذلك بإحدى الطريقتين. 1- مورد MediaFile حالي 2- بيانات الصورة الأولية كبايت. يمكن أن يكون الحقل "image" واحدًا فقط مما يلي:
mediaFile

string

المورد MediaFile لاستخدامه مع الصورة.
data

string (bytes format)

بيانات الصورة الأولية كبايت.

سلسلة بترميز base64.
adIdToCopyImageFrom

string (int64 format)

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

MimeType

نوع MIME

عمليات التعداد
UNSPECIFIED لم يتم تحديد نوع MIME.
UNKNOWN

القيمة المُستلَمة غير معروفة في هذا الإصدار.

هذه قيمة للاستجابة فقط.
IMAGE_JPEG نوع MIME للصورة/jpeg.
IMAGE_GIF نوع MIME للصورة/gif هو.
IMAGE_PNG نوع MIME للصورة/png.
FLASH نوع MIME للتطبيق/x-shockwave-flash.
TEXT_HTML نوع MIME عبارة عن نص/html.
PDF نوع MIME للتطبيق/pdf.
MSWORD نوع MIME للتطبيق/msword.
MSEXCEL نوع MIME لملف app/vnd.ms-excel.
RTF نوع MIME للتطبيق/rtf.
AUDIO_WAV نوع MIME للصوت/wav.
AUDIO_MP3 نوع MIME للصوت/mp3.
HTML5_AD_ZIP نوع MIME للتطبيق/x-html5-ad-zip.

VideoAdInfo

إعلان فيديو

تمثيل JSON 
{
  "video": {
    object (AdVideoAsset)
  },

  // Union field format can be only one of the following:
  "inStream": {
    object (VideoTrueViewInStreamAdInfo)
  },
  "bumper": {
    object (VideoBumperInStreamAdInfo)
  },
  "outStream": {
    object (VideoOutstreamAdInfo)
  },
  "nonSkippable": {
    object (VideoNonSkippableInStreamAdInfo)
  },
  "inFeed": {
    object (InFeedVideoAdInfo)
  }
  // End of list of possible types for union field format.
}
الحقول
video

object (AdVideoAsset)

مواد عرض فيديو YouTube المستخدَمة للإعلان.
حقل الاتحاد format مخطط خاص بالتنسيق لتنسيقات الفيديو المختلفة. يمكن أن يكون الحقل "format" واحدًا فقط مما يلي:
inStream

object (VideoTrueViewInStreamAdInfo)

شكل إعلان فيديو TrueView ضمن البث.
bumper

object (VideoBumperInStreamAdInfo)

شكل إعلان ملصق الفيديو الصغير أثناء عرض الفيديو.
outStream

object (VideoOutstreamAdInfo)

شكل إعلان الفيديو خارج البث
nonSkippable

object (VideoNonSkippableInStreamAdInfo)

شكل الإعلان غير القابل للتخطي أثناء عرض الفيديو.
inFeed

object (InFeedVideoAdInfo)

شكل إعلان الفيديو ضمن الخلاصة.

AdVideoAsset

مادة عرض فيديو مستخدَمة داخل إعلان

تمثيل JSON 
{
  "asset": string
}
الحقول
asset

string

اسم مورد مادة العرض لهذا الفيديو.

VideoTrueViewInStreamAdInfo

تمثيل لشكل إعلان فيديو TrueView ضمن البث (إعلان يتم عرضه أثناء تشغيل الفيديو، غالبًا في البداية، ويعرض زر التخطي بعد بضع ثوانٍ من الفيديو).

تمثيل JSON 
{
  "actionButtonLabel": string,
  "actionHeadline": string,
  "companionBanner": {
    object (AdImageAsset)
  }
}
الحقول
actionButtonLabel

string

تسمية على زر حث المستخدم على اتخاذ إجراء (CTA) الذي ينقل المستخدم إلى رابط عنوان URL النهائي لإعلان الفيديو. مطلوبة لحملات TrueView for Action، واختيارية في الحالات الأخرى.
actionHeadline

string

نص إضافي معروض مع زر CTA (الحث على اتخاذ إجراء) لتوفير سياق والتشجيع على النقر على الزر.
companionBanner

object (AdImageAsset)

مواد عرض الصور لإعلان البانر المصاحب المستخدَم مع الإعلان.

AdImageAsset

مادة عرض صورة مستخدَمة داخل إعلان

تمثيل JSON 
{
  "asset": string
}
الحقول
asset

string

اسم مورد مادة العرض لهذه الصورة.

VideoBumperInStreamAdInfo

تمثيل شكل إعلان ملصق الفيديو الصغير أثناء عرض الفيديو (إعلان فيديو قصير جدًا غير قابل للتخطي أثناء عرض الفيديو).

تمثيل JSON 
{
  "companionBanner": {
    object (AdImageAsset)
  },
  "actionButtonLabel": string,
  "actionHeadline": string
}
الحقول
companionBanner

object (AdImageAsset)

مواد عرض الصور لإعلان البانر المصاحب المستخدَم مع الإعلان.
actionButtonLabel

string

تصنيف على زر "الحث على اتخاذ إجراء" الذي ينقل المستخدم إلى رابط عنوان URL النهائي لإعلان الفيديو
actionHeadline

string

نص إضافي معروض مع زر CTA (الحث على اتخاذ إجراء) لتوفير سياق والتشجيع على النقر على الزر.

VideoOutstreamAdInfo

تمثيل لشكل إعلان الفيديو خارج البث (إعلان يظهر إلى جانب خلاصة مع التشغيل التلقائي، بدون صوت).

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

string

عنوان الإعلان.
description

string

سطر الوصف.

VideoNonSkippableInStreamAdInfo

تمثيل شكل الإعلان غير القابل للتخطي أثناء عرض الفيديو (إعلان فيديو غير قابل للتخطي أثناء عرض الفيديو مدته 15 ثانية).

تمثيل JSON 
{
  "companionBanner": {
    object (AdImageAsset)
  },
  "actionButtonLabel": string,
  "actionHeadline": string
}
الحقول
companionBanner

object (AdImageAsset)

مواد عرض الصور لإعلان البانر المصاحب المستخدَم مع الإعلان.
actionButtonLabel

string

تصنيف على زر "الحث على اتخاذ إجراء" الذي ينقل المستخدم إلى رابط عنوان URL النهائي لإعلان الفيديو
actionHeadline

string

نص إضافي معروض مع زر "الحث على اتخاذ إجراء" لتوفير سياق وتشجيع المستخدمين على النقر على الزر.

InFeedVideoAdInfo

تمثيل شكل إعلان الفيديو ضمن الخلاصة.

تمثيل JSON 
{
  "headline": string,
  "description1": string,
  "description2": string,
  "thumbnail": enum (VideoThumbnail)
}
الحقول
headline

string

عنوان الإعلان.
description1

string

سطر النص الأول للإعلان.
description2

string

سطر النص الثاني للإعلان.
thumbnail

enum (VideoThumbnail)

الصورة المصغّرة للفيديو المطلوب استخدامها.

VideoThumbnail

يعرض هذا التعداد الأنواع المحتملة للصور المصغّرة للفيديو.

عمليات التعداد
UNSPECIFIED لم يتم تحديد النوع.
UNKNOWN القيمة المُستلَمة غير معروفة في هذا الإصدار. هذه قيمة للاستجابة فقط.
DEFAULT_THUMBNAIL الصورة المصغّرة التلقائية ويمكن أن يتم إنشاؤها تلقائيًا أو تحميلها من قِبل المستخدم.
THUMBNAIL_1 الصورة المصغّرة 1، مصدرها الفيديو
THUMBNAIL_2 الصورة المصغّرة 2 التي تم إنشاؤها من الفيديو
THUMBNAIL_3 الصورة المصغّرة 3 التي تم إنشاؤها من الفيديو

VideoResponsiveAdInfo

إعلان فيديو متجاوب.

تمثيل JSON 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "longHeadlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "callToActions": [
    {
      object (AdTextAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ],
  "companionBanners": [
    {
      object (AdImageAsset)
    }
  ],
  "breadcrumb1": string,
  "breadcrumb2": string
}
الحقول
headlines[]

object (AdTextAsset)

قائمة بمواد العرض النصية المستخدَمة للعنوان القصير في الوقت الحالي، يمكن استخدام قيمة واحدة فقط للعنوان القصير.
longHeadlines[]

object (AdTextAsset)

قائمة بمواد العرض النصية المستخدَمة في العنوان الطويل. في الوقت الحالي، يمكن استخدام قيمة واحدة فقط للعنوان الطويل.
descriptions[]

object (AdTextAsset)

قائمة مواد العرض النصية المستخدَمة في الوصف في الوقت الحالي، يُسمح باستخدام قيمة واحدة فقط للوصف.
callToActions[]

object (AdTextAsset)

قائمة بمواد العرض النصية المستخدمة للزر، مثل زر "الحث على اتخاذ إجراء". في الوقت الحالي، لا تتوفّر سوى قيمة واحدة للزر.
videos[]

object (AdVideoAsset)

قائمة بمواد عرض الفيديو على YouTube المستخدَمة للإعلان. في الوقت الحالي، يمكن استخدام قيمة واحدة فقط لمادة عرض الفيديو على YouTube.
companionBanners[]

object (AdImageAsset)

قائمة بمواد عرض الصور المستخدَمة في إعلان البانر المصاحب. في الوقت الحالي، يمكن استخدام قيمة واحدة فقط لمادة عرض إعلان البانر المصاحب.
breadcrumb1

string

الجزء الأول من النص الذي يظهر في الإعلان مع عنوان URL المعروض
breadcrumb2

string

الجزء الثاني من النص الذي يظهر في الإعلان مع عنوان URL المعروض.

AdTextAsset

مادة عرض نصية تُستخدَم داخل إعلان.

تمثيل JSON 
{
  "pinnedField": enum (ServedAssetFieldType),
  "assetPerformanceLabel": enum (AssetPerformanceLabel),
  "policySummaryInfo": {
    object (AdAssetPolicySummary)
  },
  "text": string
}
الحقول
pinnedField

enum (ServedAssetFieldType)

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

enum (AssetPerformanceLabel)

تصنيف الأداء لمادة العرض النصية هذه
policySummaryInfo

object (AdAssetPolicySummary)

ملخّص السياسة لمادة العرض النصية هذه
text

string

نص مادة العرض.

ServedAssetFieldType

أنواع حقول مواد العرض المحتملة.

عمليات التعداد
UNSPECIFIED لم يتم تحديد قيمة.
UNKNOWN

القيمة المُستلَمة غير معروفة في هذا الإصدار.

هذه قيمة للاستجابة فقط.
HEADLINE_1 مادة العرض مستخدَمة في العنوان 1.
HEADLINE_2 يتم استخدام مادة العرض في العنوان 2.
HEADLINE_3 يتم استخدام مادة العرض في العنوان 3.
DESCRIPTION_1 تُستخدم مادة العرض في الوصف 1.
DESCRIPTION_2 تُستخدم مادة العرض في الوصف 2.
CALL يتمّ استخدام مادة العرض هذه كمكالمة.
MOBILE_APP يتمّ استخدام مادة العرض هذه كتطبيق متوافق مع الأجهزة الجوّالة.
CALLOUT يتمّ استخدام مادة العرض هذه كوسيلة شرح.
STRUCTURED_SNIPPET يتم استخدام مادة العرض هذه كمقتطف من الموقع.
PRICE يتمّ استخدام مادة العرض هذه كسعر.
PROMOTION يتمّ استخدام مادة العرض هذه كعرض ترويجي.
AD_IMAGE يتم استخدام مادة العرض هذه كصورة.
LEAD_FORM يتم استخدام مادة العرض كنموذج عملاء محتملين.

AssetPerformanceLabel

يشير هذا المصطلح إلى قيم التعداد التي تصف تصنيفات الأداء المحتمَلة لمادة عرض معيّنة، ويتم احتسابها عادةً في سياق الربط.

عمليات التعداد
UNSPECIFIED عدم تحديد صيغة مخاطبة
UNKNOWN تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
PENDING لا تتضمّن مادة العرض هذه حتى الآن أي معلومات عن الأداء. قد يرجع السبب في ذلك إلى أنّه لا يزال قيد المراجعة.
LEARNING بدأت مادة العرض في تحقيق مرّات ظهور، ولكنّ الإحصاءات ليست ذات دلالة إحصائية بما يكفي للحصول على تصنيف أداء مادة العرض.
LOW مواد العرض الأسوأ أداءً.
GOOD مواد العرض جيدة الأداء.
BEST مواد العرض الأفضل أداءً.

AdAssetPolicySummary

يحتوي على معلومات السياسة لمادة عرض داخل إعلان.

تمثيل JSON 
{
  "policyTopicEntries": [
    {
      object (PolicyTopicEntry)
    }
  ],
  "reviewStatus": enum (PolicyReviewStatus),
  "approvalStatus": enum (PolicyApprovalStatus)
}
الحقول
policyTopicEntries[]

object (PolicyTopicEntry)

تمثّل هذه السمة قائمة النتائج المتعلقة بالسياسات المتعلّقة بمادة العرض هذه.
reviewStatus

enum (PolicyReviewStatus)

المكان الذي تتم فيه معالجة مادة العرض هذه قيد المراجعة.
approvalStatus

enum (PolicyApprovalStatus)

حالة الموافقة العامة على مادة العرض هذه، والتي يتم احتسابها استنادًا إلى حالة الإدخالات الفردية لمواضيع السياسة

PolicyTopicEntry

نتيجة متعلّقة بالسياسة المرفقة بمرجع (مثل سياسة الكحول المرتبطة بموقع إلكتروني يبيع المشروبات الكحولية)

يحتوي كل PolicyTopicEntry على موضوع يشير إلى سياسة الإعلانات المحدَّدة التي يتناولها الإدخال ونوعًا يوضّح تأثير المحتوى في عرض الإعلانات. قد يحتوي اختياريًا على دليل واحد أو أكثر يشير إلى سبب النتيجة. وقد يتضمّن أيضًا بشكلٍ اختياري قيدًا واحدًا أو أكثر يوفّر تفاصيل حول كيفية حظر العرض.

تمثيل JSON 
{
  "type": enum (PolicyTopicEntryType),
  "evidences": [
    {
      object (PolicyTopicEvidence)
    }
  ],
  "constraints": [
    {
      object (PolicyTopicConstraint)
    }
  ],
  "topic": string
}
الحقول
type

enum (PolicyTopicEntryType)

تصف التأثير السلبي أو الإيجابي لهذه السياسة على عرض الإعلانات.
evidences[]

object (PolicyTopicEvidence)

معلومات إضافية توضّح النتائج المتعلقة بالسياسات (مثل اسم العلامة التجارية نتيجة بحث عن علامة تجارية)
constraints[]

object (PolicyTopicConstraint)

تشير هذه السمة إلى مدى تأثّر عرض هذا المورد (على سبيل المثال، عدم العرض في بلد معيّن).
topic

string

موضوع السياسة الذي تشير إليه هذه النتيجة. على سبيل المثال، "ALCOHOL" أو "TRADEMARKS_IN_AD_TEXT" أو "destination_NOT_WORKING". يُرجى العلم أنّ مجموعة مواضيع السياسة المحتملة ليست ثابتة لإصدار معيّن من واجهة برمجة التطبيقات، وقد تتغير في أي وقت.

PolicyTopicEntryType

تمثّل هذه السمة أنواع الإدخالات المحتملة لموضوع السياسة.

عمليات التعداد
UNSPECIFIED لم يتم تحديد قيمة.
UNKNOWN

القيمة المُستلَمة غير معروفة في هذا الإصدار.

هذه قيمة للاستجابة فقط.
PROHIBITED لن يتم عرض المورد.
LIMITED لن يتم عرض المورد في بعض الحالات.
FULLY_LIMITED لا يمكن عرض المورد على الإطلاق بسبب معايير الاستهداف الحالية.
DESCRIPTIVE قد يكون مهمًا، ولكنه لا يحدّ من كيفية عرض المورد.
BROADENING وقد يؤدي ذلك إلى زيادة التغطية عن المعتاد.
AREA_OF_INTEREST_ONLY يقتصر على جميع البلدان المستهدفة، ولكن قد يتم عرضه في بلدان أخرى من خلال مجال الاهتمام.

PolicyTopicEvidence

معلومات إضافية تشرح نتيجة متعلقة بالسياسة.

تمثيل JSON 
{

  // Union field value can be only one of the following:
  "websiteList": {
    object (WebsiteList)
  },
  "textList": {
    object (TextList)
  },
  "languageCode": string,
  "destinationTextList": {
    object (DestinationTextList)
  },
  "destinationMismatch": {
    object (DestinationMismatch)
  },
  "destinationNotWorking": {
    object (DestinationNotWorking)
  }
  // End of list of possible types for union field value.
}
الحقول
حقل الاتحاد value معلومات محدّدة عن الأدلة استنادًا إلى نوع الدليل. يمكن أن يكون الحقل "value" واحدًا فقط مما يلي:
websiteList

object (WebsiteList)

قائمة بالمواقع الإلكترونية المرتبطة بهذا المورد
textList

object (TextList)

قائمة بالأدلة المتوفّرة في نص أحد المصادر
languageCode

string

اللغة التي تم اكتشاف أن المورد مكتوب بها. هذه علامة خاصة بلغة IETF، مثل "en-US".
destinationTextList

object (DestinationTextList)

النص في وجهة المورد الذي يتسبب في العثور على سياسة.
destinationMismatch

object (DestinationMismatch)

لا تتطابق وجهات عناوين URL للمورد.
destinationNotWorking

object (DestinationNotWorking)

تفاصيل عندما تعرض الوجهة رمز خطأ HTTP أو لا تعمل في جميع المواقع الجغرافية للأجهزة الشائعة الاستخدام.

WebsiteList

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

تمثيل JSON 
{
  "websites": [
    string
  ]
}
الحقول
websites[]

string

المواقع الإلكترونية التي تسببت في العثور على السياسة.

TextList

قائمة بأجزاء النص التي انتهكت سياسة

تمثيل JSON 
{
  "texts": [
    string
  ]
}
الحقول
texts[]

string

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

DestinationTextList

قائمة بالسلاسل التي تم العثور عليها في صفحة مقصودة وأدت إلى العثور على السياسة.

تمثيل JSON 
{
  "destinationTexts": [
    string
  ]
}
الحقول
destinationTexts[]

string

قائمة النصوص التي تم العثور عليها في الصفحة المقصودة للمصدر.

DestinationMismatch

دليل على حالات عدم التطابق بين عناوين URL لمورد معيَّن

تمثيل JSON 
{
  "urlTypes": [
    enum (PolicyTopicEvidenceDestinationMismatchUrlType)
  ]
}
الحقول
urlTypes[]

enum (PolicyTopicEvidenceDestinationMismatchUrlType)

مجموعة عناوين URL التي لا تتطابق مع بعضها البعض.

PolicyTopicEvidenceDestinationMismatchUrlType

أنواع عناوين URL الوجهة غير المتوافقة مع دليل موضوع السياسة المُحتمَلة.

عمليات التعداد
UNSPECIFIED لم يتم تحديد قيمة.
UNKNOWN

القيمة المُستلَمة غير معروفة في هذا الإصدار.

هذه قيمة للاستجابة فقط.
DISPLAY_URL تمثّل هذه السمة عنوان URL المعروض.
FINAL_URL تمثّل هذه السمة عنوان URL النهائي.
FINAL_MOBILE_URL عنوان URL النهائي للأجهزة الجوّالة.
TRACKING_URL نموذج عنوان URL للتتبّع، مع استبدال عنوان URL لأجهزة الكمبيوتر المكتبي.
MOBILE_TRACKING_URL نموذج عنوان URL للتتبّع، مع استبدال عنوان URL للأجهزة الجوّالة.

DestinationNotWorking

تفاصيل الدليل عندما تعرض الوجهة رمز خطأ HTTP أو لا تعمل في جميع المواقع الجغرافية للأجهزة الشائعة الاستخدام.

تمثيل JSON 
{
  "device": enum (PolicyTopicEvidenceDestinationNotWorkingDevice),
  "expandedUrl": string,
  "lastCheckedDateTime": string,

  // Union field reason can be only one of the following:
  "dnsErrorType": enum (PolicyTopicEvidenceDestinationNotWorkingDnsErrorType),
  "httpErrorCode": string
  // End of list of possible types for union field reason.
}
الحقول
device

enum (PolicyTopicEvidenceDestinationNotWorkingDevice)

نوع الجهاز الذي تعذّر تحميل عنوان URL له.
expandedUrl

string

عنوان URL الكامل الذي لم يعمل.
lastCheckedDateTime

string

تاريخ آخر مرة تم فيها التحقّق من عنوان URL. التنسيق هو "YYYY-MM-DD HH:MM:SS". أمثلة: "2018-03-05 09:15:00" أو " 2018-02-01 14:34:30"
حقل الاتحاد reason يشير إلى سبب العثور على السياسة : destination_NOT_WORKING. يمكن أن يكون الحقل "reason" واحدًا فقط مما يلي:
dnsErrorType

enum (PolicyTopicEvidenceDestinationNotWorkingDnsErrorType)

نوع الخطأ في نظام أسماء النطاقات.
httpErrorCode

string (int64 format)

رمز خطأ HTTP.

PolicyTopicEvidenceDestinationNotWorkingDevice

تشير هذه القيمة إلى أنّ الوجهة المحتملة لا تعمل على أساس موضوع السياسة.

عمليات التعداد
UNSPECIFIED لم يتم تحديد قيمة.
UNKNOWN

القيمة المُستلَمة غير معروفة في هذا الإصدار.

هذه قيمة للاستجابة فقط.
DESKTOP لا تعمل الصفحة المقصودة على جهاز كمبيوتر مكتبي.
ANDROID لا تعمل الصفحة المقصودة على جهاز Android.
IOS لا تعمل الصفحة المقصودة على جهاز iOS.

PolicyTopicEvidenceDestinationNotWorkingDnsErrorType

أنواع أخطاء نظام أسماء النطاقات المحتملة لا تعمل على وجهة دليل موضوع السياسة.

عمليات التعداد
UNSPECIFIED لم يتم تحديد قيمة.
UNKNOWN

القيمة المُستلَمة غير معروفة في هذا الإصدار.

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

PolicyTopicConstraint

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

تمثيل JSON 
{

  // Union field value can be only one of the following:
  "countryConstraintList": {
    object (CountryConstraintList)
  },
  "resellerConstraint": {
    object (ResellerConstraint)
  },
  "certificateMissingInCountryList": {
    object (CountryConstraintList)
  },
  "certificateDomainMismatchInCountryList": {
    object (CountryConstraintList)
  }
  // End of list of possible types for union field value.
}
الحقول
حقل الاتحاد value معلومات محددة عن القيد. يمكن أن يكون الحقل "value" واحدًا فقط مما يلي:
countryConstraintList

object (CountryConstraintList)

البلدان التي لا يمكن عرض المورد فيها.
resellerConstraint

object (ResellerConstraint)

قيد المورّد.
certificateMissingInCountryList

object (CountryConstraintList)

البلدان التي يتطلّب فيها تقديم شهادة الاعتماد
certificateDomainMismatchInCountryList

object (CountryConstraintList)

البلدان التي لا تشملها الشهادات المرتبطة بنطاق المورد.

CountryConstraintList

قائمة بالبلدان التي يتم فيها تقييد عرض الموارد.

تمثيل JSON 
{
  "countries": [
    {
      object (CountryConstraint)
    }
  ],
  "totalTargetedCountries": integer
}
الحقول
countries[]

object (CountryConstraint)

البلدان التي يتم فيها حظر عرض الإعلانات.
totalTargetedCountries

integer

إجمالي عدد البلدان التي يستهدفها المورد.

CountryConstraint

يشير إلى تقييد قدرة المورد على العرض في بلد معيّن.

تمثيل JSON 
{
  "countryCriterion": string
}
الحقول
countryCriterion

string

اسم مورد ثابت للاستهداف الجغرافي للبلد الذي يتم فيه عرض الإعلانات

ResellerConstraint

لا يشتمل هذا النوع على أي حقول.

يشير إلى أنّه تم فرض قيود على موضوع السياسة بسبب رفض الموقع الإلكتروني لأغراض المورّدين.

PolicyReviewStatus

تمثّل هذه السمة الحالات المحتملة للتحقّق من الالتزام بالسياسات.

عمليات التعداد
UNSPECIFIED لم يتم تحديد قيمة.
UNKNOWN

القيمة المُستلَمة غير معروفة في هذا الإصدار.

هذه قيمة للاستجابة فقط.
REVIEW_IN_PROGRESS قيد المراجعة حاليًا.
REVIEWED اكتملت المراجعة الأساسية. وقد تستمر المراجعات الأخرى.
UNDER_APPEAL تمت إعادة إرسال المرجع للموافقة عليه أو تم تقديم طلب إعادة نظر في قراره المتعلّق بالسياسة.
ELIGIBLE_MAY_SERVE المورد مؤهَّل وقد يتم عرضه، ولكن يمكن أن يخضع لمراجعة إضافية.

PolicyApprovalStatus

حالات الموافقة المحتملة على السياسة. وفي حال توفُّر العديد من حالات الموافقة المتاحة، سيتم استخدام الحالة الأكثر شدة. يتم ترتيب درجة الخطورة: DISAPPROVED وAREA_OF_INTEREST_ONLY وAPPROVED_LIMITED وAPPROVED.

عمليات التعداد
UNSPECIFIED لم يتم تحديد قيمة.
UNKNOWN

القيمة المُستلَمة غير معروفة في هذا الإصدار.

هذه قيمة للاستجابة فقط.
DISAPPROVED لن يتم عرضها.
APPROVED_LIMITED يتم تقديم الخلاصة مع قيود مفروضة.
APPROVED يتم تقديم الخدمة بدون قيود.
AREA_OF_INTEREST_ONLY لن يتمّ عرض الإعلانات في البلدان المستهدَفة، ولكن قد يتمّ عرضها للمستخدِمين الذين يبحثون عن معلومات عن البلدان المستهدَفة.

ResponsiveSearchAdInfo

إعلان متجاوب على شبكة البحث

تتيح لك الإعلانات المتجاوبة على شبكة البحث إنشاء إعلان يتكيَّف لعرض المزيد من النص ورسائل أكثر ملاءمةً لعملائك. أدخِل عدّة عناوين وأوصاف عند إنشاء إعلان متجاوب على شبكة البحث. وبمرور الوقت، ستختبر "إعلانات Google" تلقائيًا تركيبات مختلفة وتتعرّف على أفضل التركيبات أداءً. ومن خلال تكييف محتوى إعلانك ليلائم عبارات بحث العملاء المحتملين بشكلٍ أوثق، قد تسهم الإعلانات المتجاوبة على شبكة البحث في تحسين أداء حملتك.

مزيد من المعلومات على https://support.google.com/google-ads/answer/7684791

تمثيل JSON 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "path1": string,
  "path2": string
}
الحقول
headlines[]

object (AdTextAsset)

قائمة بمواد العرض النصية للعناوين. سيتم اختيار العناوين من هذه القائمة عند عرض الإعلان.
descriptions[]

object (AdTextAsset)

قائمة مواد العرض النصية للأوصاف سيتمّ اختيار الأوصاف من هذه القائمة عند عرض الإعلان.
path1

string

الجزء الأول من النص الذي يمكن إلحاقه بعنوان URL في الإعلان
path2

string

الجزء الثاني من النص الذي يمكن إلحاقه بعنوان URL في الإعلان لا يمكن ضبط هذا الحقل إلا عند ضبط "path1" أيضًا.

LegacyResponsiveDisplayAdInfo

إعلان صوري متجاوب قديم. يتم تصنيف الإعلانات من هذا النوع على أنها "إعلانات متجاوبة" في واجهة مستخدم "إعلانات Google".

تمثيل JSON 
{
  "formatSetting": enum (DisplayAdFormatSetting),
  "shortHeadline": string,
  "longHeadline": string,
  "description": string,
  "businessName": string,
  "allowFlexibleColor": boolean,
  "accentColor": string,
  "mainColor": string,
  "callToActionText": string,
  "logoImage": string,
  "squareLogoImage": string,
  "marketingImage": string,
  "squareMarketingImage": string,
  "pricePrefix": string,
  "promoText": string
}
الحقول
formatSetting

enum (DisplayAdFormatSetting)

تُحدِّد الشكل الذي سيتم عرض الإعلان به. الإعداد التلقائي هو ALL_FORMATS.
shortHeadline

string

النسخة القصيرة من عنوان الإعلان.
longHeadline

string

النسخة الطويلة من عنوان الإعلان.
description

string

وصف الإعلان.
businessName

string

اسم النشاط التجاري في الإعلان.
allowFlexibleColor

boolean

موافقة المعلن على السماح بالألوان المرنة. عند ضبطهما على "صحيح"، يمكن عرض الإعلان بلون مختلف إذا لزم الأمر. أما إذا كانت القيمة خاطئة، فسيتم عرض الإعلان بالألوان المحدّدة أو بلون محايد. ستكون القيمة التلقائية true. يجب أن تكون القيمة صحيحة إذا لم يتم ضبط mainColor وaccentColor.
accentColor

string

لون التمييز للإعلان بالنظام السداسي العشري، على سبيل المثال، #MAX مع اللون الأبيض. في حال ضبط أحدهما على mainColor وaccentColor، يجب أيضًا ضبط الآخر.
mainColor

string

اللون الرئيسي للإعلان بالنظام السداسي العشري، على سبيل المثال، #level مع اللون الأبيض. في حال ضبط أحدهما على mainColor وaccentColor، يجب أيضًا ضبط الآخر.
callToActionText

string

نص الحث على اتخاذ إجراء للإعلان.
logoImage

string

اسم مورد MediaFile لصورة الشعار المستخدمة في الإعلان.
squareLogoImage

string

اسم مورد MediaFile لصورة الشعار المربّعة المستخدَمة في الإعلان.
marketingImage

string

اسم مورد MediaFile للصورة التسويقية المستخدمة في الإعلان.
squareMarketingImage

string

اسم مورد MediaFile للصورة التسويقية المربّعة المستخدَمة في الإعلان.
pricePrefix

string

البادئة قبل السعر. على سبيل المثال، "أدنى من".
promoText

string

النص الترويجي المستخدم للأشكال الديناميكية للإعلانات المتجاوبة. على سبيل المثال، "شحن مجاني خلال يومين".

DisplayAdFormatSetting

لتعداد إعدادات أشكال الإعلانات الصورية.

عمليات التعداد
UNSPECIFIED عدم تحديد صيغة مخاطبة
UNKNOWN القيمة غير معروفة في هذا الإصدار.
ALL_FORMATS الأشكال النصية والمصوّرة والمدمجة مع المحتوى.
NON_NATIVE التنسيقات النصية والصور:
NATIVE على سبيل المثال، يتحكّم الناشر في طريقة عرض التنسيق، وليس Google، وليس Google.

AppAdInfo

إعلان تطبيق

تمثيل JSON 
{
  "mandatoryAdText": {
    object (AdTextAsset)
  },
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "images": [
    {
      object (AdImageAsset)
    }
  ],
  "youtubeVideos": [
    {
      object (AdVideoAsset)
    }
  ],
  "html5MediaBundles": [
    {
      object (AdMediaBundleAsset)
    }
  ]
}
الحقول
mandatoryAdText

object (AdTextAsset)

نص الإعلان الإلزامي.
headlines[]

object (AdTextAsset)

قائمة بمواد العرض النصية للعناوين. سيتم اختيار العناوين من هذه القائمة عند عرض الإعلان.
descriptions[]

object (AdTextAsset)

قائمة مواد العرض النصية للأوصاف سيتمّ اختيار الأوصاف من هذه القائمة عند عرض الإعلان.
images[]

object (AdImageAsset)

قائمة بمواد عرض الصور التي قد يتم عرضها مع الإعلان.
youtubeVideos[]

object (AdVideoAsset)

قائمة بمواد عرض فيديو YouTube التي قد تظهر مع الإعلان.
html5MediaBundles[]

object (AdMediaBundleAsset)

قائمة بمواد عرض حِزمة الوسائط التي يمكن استخدامها مع الإعلان.

AdMediaBundleAsset

مادة عرض حِزمة وسائط مستخدَمة داخل أحد الإعلانات

تمثيل JSON 
{
  "asset": string
}
الحقول
asset

string

اسم مورد مواد العرض لحِزمة الوسائط هذه.

LegacyAppInstallAdInfo

إعلان قديم لتثبيت التطبيق لا يمكن استخدامه إلا لعدد قليل من العملاء المحدّدين.

تمثيل JSON 
{
  "appStore": enum (LegacyAppInstallAdAppStore),
  "appId": string,
  "headline": string,
  "description1": string,
  "description2": string
}
الحقول
appStore

enum (LegacyAppInstallAdAppStore)

متجر التطبيقات الذي يتوفر فيه التطبيق المتوافق مع الأجهزة الجوّالة.
appId

string

رقم تعريف التطبيق المتوافق مع الأجهزة الجوّالة.
headline

string

عنوان الإعلان.
description1

string

سطر الوصف الأول للإعلان.
description2

string

سطر الوصف الثاني للإعلان.

LegacyAppInstallAdAppStore

نوع متجر التطبيقات في إعلان قديم لتثبيت التطبيق.

عمليات التعداد
UNSPECIFIED عدم تحديد صيغة مخاطبة
UNKNOWN تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
APPLE_APP_STORE Apple iTunes.
GOOGLE_PLAY Google Play.
WINDOWS_STORE متجر Windows.
WINDOWS_PHONE_STORE متجر هواتف Windows.
CN_APP_STORE تتم استضافة التطبيق في متجر تطبيقات صيني.

ResponsiveDisplayAdInfo

إعلان صوري متجاوب

تمثيل JSON 
{
  "marketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "squareMarketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "squareLogoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "longHeadline": {
    object (AdTextAsset)
  },
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "youtubeVideos": [
    {
      object (AdVideoAsset)
    }
  ],
  "formatSetting": enum (DisplayAdFormatSetting),
  "controlSpec": {
    object (ResponsiveDisplayAdControlSpec)
  },
  "businessName": string,
  "mainColor": string,
  "accentColor": string,
  "allowFlexibleColor": boolean,
  "callToActionText": string,
  "pricePrefix": string,
  "promoText": string
}
الحقول
marketingImages[]

object (AdImageAsset)

الصور التسويقية التي سيتمّ استخدامها في الإعلان أنواع الصور الصالحة هي GIF وJPEG وPNG. الحد الأدنى للحجم هو 600x314، ويجب أن تكون نسبة العرض إلى الارتفاع 1.91:1 (+-1%). يجب توفير سمة marketingImage واحدة على الأقل. بالإضافة إلى squareMarketingImages، الحد الأقصى هو 15.
squareMarketingImages[]

object (AdImageAsset)

صور تسويقية مربّعة الشكل لاستخدامها في الإعلان. أنواع الصور الصالحة هي GIF وJPEG وPNG. الحد الأدنى للحجم هو 300x300، ويجب أن تكون نسبة العرض إلى الارتفاع 1:1 (+-1%). يجب توفّر marketingImage مربّع واحد على الأقل. بالإضافة إلى marketingImages، الحد الأقصى هو 15.
logoImages[]

object (AdImageAsset)

صور الشعار التي سيتم استخدامها في الإعلان. أنواع الصور الصالحة هي GIF وJPEG وPNG. الحد الأدنى للحجم هو 512x128، ويجب أن تكون نسبة العرض إلى الارتفاع 4:1 (+-1%). بالإضافة إلى squareLogoImages، الحد الأقصى هو 5.
squareLogoImages[]

object (AdImageAsset)

صور الشعار المربّعة التي سيتم استخدامها في الإعلان. أنواع الصور الصالحة هي GIF وJPEG وPNG. الحد الأدنى للحجم هو 128x128، ويجب أن تكون نسبة العرض إلى الارتفاع 1:1 (+-1%). بالإضافة إلى logoImages، الحد الأقصى هو 5.
headlines[]

object (AdTextAsset)

عناوين قصيرة بتنسيقات للإعلان الحد الأقصى لعدد الأحرف المسموح به هو 30 حرفًا. يمكن تحديد عنوان واحد على الأقل و5 عناوين بحد أقصى.
longHeadline

object (AdTextAsset)

يجب إدخال عنوان طويل التنسيق. الحد الأقصى لعدد الأحرف المسموح به هو 90 حرفًا.
descriptions[]

object (AdTextAsset)

نصوص وصفية للإعلان. الحد الأقصى لعدد الأحرف المسموح به هو 90 حرفًا. يمكن تحديد عنوان واحد على الأقل و5 عناوين بحد أقصى.
youtubeVideos[]

object (AdVideoAsset)

فيديوهات YouTube اختيارية للإعلان. يمكن تحديد 5 فيديوهات كحد أقصى.
formatSetting

enum (DisplayAdFormatSetting)

تُحدِّد الشكل الذي سيتم عرض الإعلان به. الإعداد التلقائي هو ALL_FORMATS.
controlSpec

object (ResponsiveDisplayAdControlSpec)

مواصفات عناصر التحكم المختلفة في المواد الإبداعية
businessName

string

اسم المعلن/العلامة التجارية. الحد الأقصى لعرض الشاشة هو 25.
mainColor

string

اللون الرئيسي للإعلان بالنظام السداسي العشري، على سبيل المثال، #level مع اللون الأبيض. في حال ضبط أحدهما على mainColor وaccentColor، يجب أيضًا ضبط الآخر.
accentColor

string

لون التمييز للإعلان بالنظام السداسي العشري، على سبيل المثال، #MAX مع اللون الأبيض. في حال ضبط أحدهما على mainColor وaccentColor، يجب أيضًا ضبط الآخر.
allowFlexibleColor

boolean

موافقة المعلن على السماح بالألوان المرنة. عند ضبطهما على "صحيح"، يمكن عرض الإعلان بلون مختلف إذا لزم الأمر. أما إذا كانت القيمة خاطئة، فسيتم عرض الإعلان بالألوان المحدّدة أو بلون محايد. ستكون القيمة التلقائية true. يجب أن تكون القيمة صحيحة إذا لم يتم ضبط mainColor وaccentColor.
callToActionText

string

نص الحث على اتخاذ إجراء للإعلان. الحد الأقصى لعرض الشاشة هو 30.
pricePrefix

string

البادئة قبل السعر. على سبيل المثال، "أدنى من".
promoText

string

النص الترويجي المستخدم للأشكال الديناميكية للإعلانات المتجاوبة. على سبيل المثال، "شحن مجاني خلال يومين".

ResponsiveDisplayAdControlSpec

مواصفات عناصر تحكم متنوعة في تصميم الإعلان للإعلان الصوري المتجاوب.

تمثيل JSON 
{
  "enableAssetEnhancements": boolean,
  "enableAutogenVideo": boolean
}
الحقول
enableAssetEnhancements

boolean

ما إذا كان المعلن قد فعّل ميزة تحسينات مواد العرض
enableAutogenVideo

boolean

ما إذا كان المعلن قد فعّل ميزة المنشأ التلقائي للفيديو

LocalAdInfo

إعلان محلي.

تمثيل JSON 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "callToActions": [
    {
      object (AdTextAsset)
    }
  ],
  "marketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ],
  "path1": string,
  "path2": string
}
الحقول
headlines[]

object (AdTextAsset)

قائمة بمواد العرض النصية للعناوين. سيتم اختيار العناوين من هذه القائمة عند عرض الإعلان. يجب تحديد عنوان واحد على الأقل و5 عناوين على الأكثر.
descriptions[]

object (AdTextAsset)

قائمة مواد العرض النصية للأوصاف سيتمّ اختيار الأوصاف من هذه القائمة عند عرض الإعلان. يجب تحديد وصف واحد على الأقل و5 أوصاف على الأكثر.
callToActions[]

object (AdTextAsset)

قائمة مواد العرض النصية التي تحث المستخدم على اتخاذ إجراء عندما يتم عرض الإعلان، سيتمّ اختيار عبارة الحث على اتّخاذ إجراء من هذه القائمة. يجب تحديد ما لا يقل عن عبارة واحدة للحث على اتخاذ إجراء و5 عبارات على الأكثر.
marketingImages[]

object (AdImageAsset)

قائمة بمواد عرض الصور التسويقية التي قد تظهر مع الإعلان. يجب أن تكون الصور بحجم 314×600 بكسل أو 320×320 بكسل. يجب تحديد مادة عرض صورة واحدة على الأقل و20 مادة عرض صورة على الأكثر.
logoImages[]

object (AdImageAsset)

قائمة بمواد عرض صور الشعار التي يمكن عرضها مع الإعلان يجب أن تكون الصور بحجم 128×128 بكسل وألا يزيد حجمها عن 120 كيلوبايت. يجب تحديد مادة عرض صور واحدة على الأقل و5 مواد عرض صور على الأكثر.
videos[]

object (AdVideoAsset)

قائمة بمواد عرض فيديو YouTube التي قد تظهر مع الإعلان. يجب تحديد مادة عرض فيديو واحدة على الأقل و20 مادة عرض فيديو على الأكثر.
path1

string

الجزء الأول من نص اختياري يمكن إلحاقه بعنوان URL في الإعلان
path2

string

الجزء الثاني من نص اختياري يمكن إلحاقه بعنوان URL في الإعلان لا يمكن ضبط هذا الحقل إلا عند ضبط "path1" أيضًا.

DisplayUploadAdInfo

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

تمثيل JSON 
{
  "displayUploadProductType": enum (DisplayUploadProductType),

  // Union field media_asset can be only one of the following:
  "mediaBundle": {
    object (AdMediaBundleAsset)
  }
  // End of list of possible types for union field media_asset.
}
الحقول
displayUploadProductType

enum (DisplayUploadProductType)

نوع المنتج لهذا الإعلان. اطّلِع على التعليقات على التعداد للحصول على التفاصيل.
حقل الاتحاد media_asset بيانات مواد العرض التي تشكّل الإعلان. يمكن أن يكون الحقل "media_asset" واحدًا فقط مما يلي:
mediaBundle

object (AdMediaBundleAsset)

مادة عرض حِزمة وسائط ستُستخدم في الإعلان. للحصول على معلومات عن حِزمة الوسائط لـ HTML5_UPLOAD_AD، راجع https://support.google.com/google-ads/answer/1722096 حِزم الوسائط التي تكون جزءًا من أنواع المنتجات الديناميكية تستخدم تنسيقًا خاصًا يجب إنشاؤه من خلال Google Web Designer. يمكنك الانتقال إلى https://support.google.com/webdesigner/answer/7543898 للحصول على مزيد من المعلومات.

DisplayUploadProductType

يعمل التعداد على عرض أنواع المنتجات التي يتم تحميلها.

عمليات التعداد
UNSPECIFIED عدم تحديد صيغة مخاطبة
UNKNOWN القيمة غير معروفة في هذا الإصدار.
HTML5_UPLOAD_AD إعلان تحميل HTML5. يتطلب نوع المنتج هذا ضبط الحقل upload_media_bundle في DisplayUploadAdInfo.
DYNAMIC_HTML5_EDUCATION_AD إعلان تعليمي HTML5 ديناميكي. يتطلب نوع المنتج هذا ضبط الحقل upload_media_bundle في DisplayUploadAdInfo. لا يمكن استخدامها إلا في حملة تعليمية.
DYNAMIC_HTML5_FLIGHT_AD إعلان طيران HTML5 ديناميكي. يتطلب نوع المنتج هذا ضبط الحقل upload_media_bundle في DisplayUploadAdInfo. لا يمكن استخدامها إلا في حملة طيران.
DYNAMIC_HTML5_HOTEL_RENTAL_AD إعلان HTML5 ديناميكي للفنادق والتأجير. يتطلب نوع المنتج هذا ضبط الحقل upload_media_bundle في DisplayUploadAdInfo. لا يمكن استخدامها إلا في حملة فندق.
DYNAMIC_HTML5_JOB_AD إعلان وظائف HTML5 ديناميكي. يتطلب نوع المنتج هذا ضبط الحقل upload_media_bundle في DisplayUploadAdInfo. لا يمكن استخدامه إلا في حملة وظيفية.
DYNAMIC_HTML5_LOCAL_AD إعلان HTML5 محلي ديناميكي. يتطلب نوع المنتج هذا ضبط الحقل upload_media_bundle في DisplayUploadAdInfo. لا يمكن استخدامها إلا في حملة محلية.
DYNAMIC_HTML5_REAL_ESTATE_AD إعلان عقارات HTML5 ديناميكي. يتطلب نوع المنتج هذا ضبط الحقل upload_media_bundle في DisplayUploadAdInfo. لا يمكن استخدامه إلا في حملة عقارية.
DYNAMIC_HTML5_CUSTOM_AD إعلان مخصّص HTML5 ديناميكي. يتطلب نوع المنتج هذا ضبط الحقل upload_media_bundle في DisplayUploadAdInfo. لا يمكن استخدامها إلا في حملة مخصّصة.
DYNAMIC_HTML5_TRAVEL_AD إعلان سفر ديناميكي HTML5. يتطلب نوع المنتج هذا ضبط الحقل upload_media_bundle في DisplayUploadAdInfo. لا يمكن استخدامها إلّا في حملة سفر.
DYNAMIC_HTML5_HOTEL_AD إعلان فندق HTML5 ديناميكي يتطلب نوع المنتج هذا ضبط الحقل upload_media_bundle في DisplayUploadAdInfo. لا يمكن استخدامها إلا في حملة فندق.

AppEngagementAdInfo

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

تمثيل JSON 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "images": [
    {
      object (AdImageAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ]
}
الحقول
headlines[]

object (AdTextAsset)

قائمة بمواد العرض النصية للعناوين. سيتم اختيار العناوين من هذه القائمة عند عرض الإعلان.
descriptions[]

object (AdTextAsset)

قائمة مواد العرض النصية للأوصاف سيتمّ اختيار الأوصاف من هذه القائمة عند عرض الإعلان.
images[]

object (AdImageAsset)

قائمة بمواد عرض الصور التي قد يتم عرضها مع الإعلان.
videos[]

object (AdVideoAsset)

قائمة بمواد عرض الفيديو التي قد تظهر مع الإعلان.

ShoppingComparisonListingAdInfo

إعلان بيانات مقارنة Shopping

تمثيل JSON 
{
  "headline": string
}
الحقول
headline

string

عنوان الإعلان. هذا الحقل مطلوب. يتراوح عدد الأحرف المسموح به بين 25 و45 حرفًا.

SmartCampaignAdInfo

إعلان حملة ذكية

تمثيل JSON 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ]
}
الحقول
headlines[]

object (AdTextAsset)

قائمة بمواد العرض النصية، تتطابق كل مادة منها مع عنوان رئيسي عند عرض الإعلان تتألف هذه القائمة من 3 مواد عرض نصية على الأقل وما يصل إلى 15 مادة عرض.
descriptions[]

object (AdTextAsset)

قائمة بمواد العرض النصية، تتوافق كل مادة منها مع وصف وقت عرض الإعلان. تتكوّن هذه القائمة من مادتَي عرض نصيتَين على الأقل وما يصل إلى 4 مواد عرض نصية.

AppPreRegistrationAdInfo

ترتبط إعلانات التسجيل المُسبَق للتطبيق ببطاقة بيانات تطبيقك أو لعبتك على Google Play، ويمكن عرضها على Google Play وYouTube (أثناء عرض الفيديو فقط) وضمن التطبيقات الأخرى والمواقع الإلكترونية المتوافقة مع الأجهزة الجوّالة على "الشبكة الإعلانية". وسيساعد ذلك في جذب اهتمام المستخدمين بتطبيقك أو لعبتك وإنشاء قاعدة تثبيت للتطبيق أو اللعبة قبل إطلاقها.

تمثيل JSON 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "images": [
    {
      object (AdImageAsset)
    }
  ],
  "youtubeVideos": [
    {
      object (AdVideoAsset)
    }
  ]
}
الحقول
headlines[]

object (AdTextAsset)

قائمة بمواد العرض النصية للعناوين. سيتم اختيار العناوين من هذه القائمة عند عرض الإعلان.
descriptions[]

object (AdTextAsset)

قائمة مواد العرض النصية للأوصاف سيتمّ اختيار الأوصاف من هذه القائمة عند عرض الإعلان.
images[]

object (AdImageAsset)

قائمة بأرقام تعريف مواد عرض الصور التي قد يتمّ عرض صورها مع الإعلان
youtubeVideos[]

object (AdVideoAsset)

قائمة بأرقام تعريف مواد عرض الفيديوهات على YouTube التي قد يتمّ عرض فيديوهاتها مع الإعلان.

DiscoveryMultiAssetAdInfo

إعلان متعدّد مواد العرض أثناء التصفّح.

تمثيل JSON 
{
  "marketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "squareMarketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "portraitMarketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "businessName": string,
  "callToActionText": string,
  "leadFormOnly": boolean
}
الحقول
marketingImages[]

object (AdImageAsset)

مواد عرض الصور التسويقية التي سيتمّ استخدامها في الإعلان أنواع الصور الصالحة هي GIF وJPEG وPNG. الحد الأدنى للحجم هو 600x314، ويجب أن تكون نسبة العرض إلى الارتفاع 1.91:1 (+-1%). تكون مطلوبة في حال عدم توفّر squareMarketingImages. عند الجمع بين squareMarketingImages وportraitMarketingImages، الحد الأقصى هو 20.
squareMarketingImages[]

object (AdImageAsset)

مواد عرض الصور التسويقية المربّعة التي سيتم استخدامها في الإعلان. أنواع الصور الصالحة هي GIF وJPEG وPNG. الحد الأدنى للحجم هو 300x300، ويجب أن تكون نسبة العرض إلى الارتفاع 1:1 (+-1%). تكون هذه السمة مطلوبة في حال عدم توفّر سمة MarketingImages. عند الجمع بين marketingImages وportraitMarketingImages، الحد الأقصى هو 20.
portraitMarketingImages[]

object (AdImageAsset)

مواد عرض الصور التسويقية الرأسية التي سيتمّ استخدامها في الإعلان أنواع الصور الصالحة هي GIF وJPEG وPNG. الحد الأدنى للحجم هو 480x600 ويجب أن تكون نسبة العرض إلى الارتفاع 4:5 (+-1%). عند الجمع بين marketingImages وsquareMarketingImages، الحد الأقصى هو 20.
logoImages[]

object (AdImageAsset)

مواد عرض صور الشعار التي سيتمّ استخدامها في الإعلان أنواع الصور الصالحة هي GIF وJPEG وPNG. الحد الأدنى للحجم هو 128x128، ويجب أن تكون نسبة العرض إلى الارتفاع 1:1 (+-1%). يمكن تحديد ما لا يقل عن صورة واحدة و5 صور شعار على الأقل.
headlines[]

object (AdTextAsset)

مادة عرض نص عنوان الإعلان. الحد الأقصى لعرض الشاشة هو 30. يمكن تحديد عنوان واحد على الأقل و5 عناوين بحد أقصى.
descriptions[]

object (AdTextAsset)

تمثّل هذه السمة النص الوصفي للإعلان. الحد الأقصى لعرض شاشة العرض هو 90. يمكن تحديد وصف واحد على الأقل و5 أوصاف على الأقل.
businessName

string

اسم المعلن/العلامة التجارية. الحد الأقصى لعرض الشاشة هو 25. مطلوبة.
callToActionText

string

نص الحث على اتخاذ إجراء.
leadFormOnly

boolean

خيار منطقي يشير إلى ما إذا كان يجب عرض هذا الإعلان باستخدام نموذج عملاء محتملين

DiscoveryCarouselAdInfo

إعلان متبدّل أثناء التصفّح.

تمثيل JSON 
{
  "businessName": string,
  "logoImage": {
    object (AdImageAsset)
  },
  "headline": {
    object (AdTextAsset)
  },
  "description": {
    object (AdTextAsset)
  },
  "callToActionText": string,
  "carouselCards": [
    {
      object (AdDiscoveryCarouselCardAsset)
    }
  ]
}
الحقول
businessName

string

مطلوبة. اسم المعلن/العلامة التجارية.
logoImage

object (AdImageAsset)

مطلوبة. صورة الشعار التي سيتم استخدامها في الإعلان. الحد الأدنى للحجم هو 128x128، ويجب أن تكون نسبة العرض إلى الارتفاع 1:1 (+-1%).
headline

object (AdTextAsset)

مطلوبة. عنوان الإعلان.
description

object (AdTextAsset)

مطلوبة. تمثّل هذه السمة النص الوصفي للإعلان.
callToActionText

string

نص الحث على اتخاذ إجراء.
carouselCards[]

object (AdDiscoveryCarouselCardAsset)

مطلوبة. بطاقات لوحة العرض الدوّارة التي سيتم عرضها مع الإعلان 2 كحد أدنى 10.

AdDiscoveryCarouselCardAsset

مادة عرض لبطاقة منصّة العرض بعناصر متغيّرة أثناء التصفّح مستخدَمة داخل إعلان.

تمثيل JSON 
{
  "asset": string
}
الحقول
asset

string

اسم مورد مادة العرض لبطاقة لوحة العرض الدوّارة أثناء التصفّح هذه.

DiscoveryVideoResponsiveAdInfo

إعلان متجاوب على شكل فيديو أثناء التصفّح.

تمثيل JSON 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "longHeadlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "breadcrumb1": string,
  "breadcrumb2": string,
  "businessName": {
    object (AdTextAsset)
  },
  "callToActions": [
    {
      object (AdCallToActionAsset)
    }
  ]
}
الحقول
headlines[]

object (AdTextAsset)

قائمة بمواد العرض النصية المستخدَمة للعنوان القصير
longHeadlines[]

object (AdTextAsset)

قائمة بمواد العرض النصية المستخدَمة في العنوان الطويل.
descriptions[]

object (AdTextAsset)

قائمة مواد العرض النصية المستخدَمة في الوصف
videos[]

object (AdVideoAsset)

قائمة بمواد عرض الفيديو على YouTube المستخدَمة للإعلان.
logoImages[]

object (AdImageAsset)

صورة الشعار التي سيتم استخدامها في الإعلان. أنواع الصور الصالحة هي GIF وJPEG وPNG. الحد الأدنى للحجم هو 128x128، ويجب أن تكون نسبة العرض إلى الارتفاع 1:1 (+-1%).
breadcrumb1

string

الجزء الأول من النص الذي يظهر في الإعلان مع عنوان URL المعروض
breadcrumb2

string

الجزء الثاني من النص الذي يظهر في الإعلان مع عنوان URL المعروض.
businessName

object (AdTextAsset)

مطلوبة. اسم المعلن/العلامة التجارية.
callToActions[]

object (AdCallToActionAsset)

هي مواد العرض من نوع CallToActionAsset المستخدَمة لزر "الحثّ على اتّخاذ إجراء".

AdCallToActionAsset

مادة عرض لعبارة الحث على اتّخاذ إجراء تُستخدَم داخل أحد الإعلانات.

تمثيل JSON 
{
  "asset": string
}
الحقول
asset

string

اسم مورد مادة العرض لمادة عرض العبارة التي تحث المستخدم على اتخاذ إجراء هذه.

TravelAdInfo

لا يشتمل هذا النوع على أي حقول.

إعلان عن السفر

الطُرق

get

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

mutate

 لتعديل الإعلانات