Asset

مادة العرض هي جزء من إعلان يمكن مشاركته على مستوى إعلانات متعدّدة. ويمكن أن تكون صورة (ImageAsset) أو فيديو (YouTubeVideoAsset) أو ما إلى ذلك. مواد العرض غير قابلة للتغيير ولا يمكن إزالتها. لإيقاف ظهور مادة عرض معيّنة، يجب إزالتها من الكيان الذي يستخدمها.

تمثيل JSON 
{
  "resourceName": string,
  "type": enum (AssetType),
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "source": enum (AssetSource),
  "policySummary": {
    object (AssetPolicySummary)
  },
  "fieldTypePolicySummaries": [
    {
      object (AssetFieldTypePolicySummary)
    }
  ],
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string,

  // Union field asset_data can be only one of the following:
  "youtubeVideoAsset": {
    object (YoutubeVideoAsset)
  },
  "mediaBundleAsset": {
    object (MediaBundleAsset)
  },
  "imageAsset": {
    object (ImageAsset)
  },
  "textAsset": {
    object (TextAsset)
  },
  "leadFormAsset": {
    object (LeadFormAsset)
  },
  "bookOnGoogleAsset": {
    object (BookOnGoogleAsset)
  },
  "promotionAsset": {
    object (PromotionAsset)
  },
  "calloutAsset": {
    object (CalloutAsset)
  },
  "structuredSnippetAsset": {
    object (StructuredSnippetAsset)
  },
  "sitelinkAsset": {
    object (SitelinkAsset)
  },
  "pageFeedAsset": {
    object (PageFeedAsset)
  },
  "dynamicEducationAsset": {
    object (DynamicEducationAsset)
  },
  "mobileAppAsset": {
    object (MobileAppAsset)
  },
  "hotelCalloutAsset": {
    object (HotelCalloutAsset)
  },
  "callAsset": {
    object (CallAsset)
  },
  "priceAsset": {
    object (PriceAsset)
  },
  "callToActionAsset": {
    object (CallToActionAsset)
  },
  "dynamicRealEstateAsset": {
    object (DynamicRealEstateAsset)
  },
  "dynamicCustomAsset": {
    object (DynamicCustomAsset)
  },
  "dynamicHotelsAndRentalsAsset": {
    object (DynamicHotelsAndRentalsAsset)
  },
  "dynamicFlightsAsset": {
    object (DynamicFlightsAsset)
  },
  "demandGenCarouselCardAsset": {
    object (DemandGenCarouselCardAsset)
  },
  "dynamicTravelAsset": {
    object (DynamicTravelAsset)
  },
  "dynamicLocalAsset": {
    object (DynamicLocalAsset)
  },
  "dynamicJobsAsset": {
    object (DynamicJobsAsset)
  },
  "locationAsset": {
    object (LocationAsset)
  },
  "hotelPropertyAsset": {
    object (HotelPropertyAsset)
  }
  // End of list of possible types for union field asset_data.
}
الحقول
resourceName

string

غير قابل للتغيير. اسم المورد لمادة العرض وتكون أسماء موارد مواد العرض على النحو التالي:

customers/{customerId}/assets/{asset_id}
type

enum (AssetType)

النتائج فقط. نوع مادة العرض
finalUrls[]

string

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

string

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

object (CustomParameter)

قائمة بعمليات الربط التي سيتم استخدامها لاستبدال علامات المَعلمات المخصَّصة لعناوين URL في trackUrlTemplate و/أو FinalUrls و/أو FinalMobileUrls.
source

enum (AssetSource)

النتائج فقط. مصدر مادة العرض
policySummary

object (AssetPolicySummary)

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

object (AssetFieldTypePolicySummary)

النتائج فقط. معلومات السياسة المتعلقة بمادة العرض لكل نوع حقل
id

string (int64 format)

النتائج فقط. رقم تعريف مادة العرض
name

string

اسم اختياري لمادة العرض
trackingUrlTemplate

string

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

string

نموذج عنوان URL لإلحاق مَعلمات بعناوين URL للصفحات المقصودة يتمّ عرضها باستخدام التتبّع الموازي.
حقل الاتحاد asset_data. النوع المحدّد لمادة العرض يمكن أن يكون asset_data واحدًا فقط مما يلي:
youtubeVideoAsset

object (YoutubeVideoAsset)

غير قابل للتغيير. مادة عرض فيديو على YouTube
mediaBundleAsset

object (MediaBundleAsset)

غير قابل للتغيير. مادة عرض حِزمة وسائط.
imageAsset

object (ImageAsset)

النتائج فقط. مادة عرض صورة
textAsset

object (TextAsset)

غير قابل للتغيير. مادة عرض نصية
leadFormAsset

object (LeadFormAsset)

مادة عرض لنموذج عملاء محتملين
bookOnGoogleAsset

object (BookOnGoogleAsset)

كتاب عن مواد عرض Google
promotionAsset

object (PromotionAsset)

مادة عرض خاصة بالعرض الترويجي
calloutAsset

object (CalloutAsset)

مادة عرض وسيلة شرح
structuredSnippetAsset

object (StructuredSnippetAsset)

مادة عرض مقتطف من الموقع
pageFeedAsset

object (PageFeedAsset)

مادة عرض لخلاصة صفحة
dynamicEducationAsset

object (DynamicEducationAsset)

مادة عرض تعليمية ديناميكية
mobileAppAsset

object (MobileAppAsset)

مادة عرض تطبيق للأجهزة الجوّالة
hotelCalloutAsset

object (HotelCalloutAsset)

مادة عرض وسيلة شرح للفندق.
callAsset

object (CallAsset)

مادة عرض مكالمة
priceAsset

object (PriceAsset)

مادة عرض السعر
callToActionAsset

object (CallToActionAsset)

غير قابل للتغيير. مادة عرض لعبارة الحث على اتخاذ إجراء.
dynamicRealEstateAsset

object (DynamicRealEstateAsset)

مادة عرض عقارية ديناميكية.
dynamicCustomAsset

object (DynamicCustomAsset)

مادة عرض مخصّصة ديناميكية
dynamicHotelsAndRentalsAsset

object (DynamicHotelsAndRentalsAsset)

مادة عرض ديناميكية للفنادق والتأجير.
dynamicFlightsAsset

object (DynamicFlightsAsset)

مادة عرض ديناميكية لرحلات جوية
dynamicTravelAsset

object (DynamicTravelAsset)

مادة عرض ديناميكية للسفر
dynamicLocalAsset

object (DynamicLocalAsset)

مادة عرض محلية ديناميكية
dynamicJobsAsset

object (DynamicJobsAsset)

مادة عرض ديناميكية للوظائف
locationAsset

object (LocationAsset)

النتائج فقط. مادة عرض موقع جغرافي
hotelPropertyAsset

object (HotelPropertyAsset)

غير قابل للتغيير. مادة عرض لفندق.

AssetType

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

عمليات التعداد
UNSPECIFIED لم يتم تحديده.
UNKNOWN تُستخدَم للقيمة المعروضة فقط. يمثل هذا الحقل قيمة غير معروفة في هذا الإصدار.
YOUTUBE_VIDEO مادة عرض الفيديو على YouTube
MEDIA_BUNDLE مادة عرض حِزمة الوسائط.
IMAGE مادة عرض الصورة
TEXT مادة عرض نصية
LEAD_FORM مادة عرض نموذج العملاء المحتملين
BOOK_ON_GOOGLE مادة عرض الحجز على Google
PROMOTION مادة العرض الخاصة بالعرض الترويجي
CALLOUT مادة عرض وسيلة الشرح
STRUCTURED_SNIPPET مادة عرض مقتطف من الموقع.
PAGE_FEED مادة عرض خلاصة الصفحة
DYNAMIC_EDUCATION مادة عرض التعليم الديناميكي
MOBILE_APP مادة عرض تطبيق الأجهزة الجوّالة.
HOTEL_CALLOUT مادة عرض وسيلة الشرح للفندق.
CALL مادة عرض المكالمة
PRICE مادة عرض السعر
CALL_TO_ACTION مادة عرض عبارة الحثّ على اتّخاذ إجراء
DYNAMIC_REAL_ESTATE مادة عرض عقارات ديناميكية
DYNAMIC_CUSTOM مادة عرض مخصّصة ديناميكية
DYNAMIC_HOTELS_AND_RENTALS مواد عرض الفنادق والإيجارات الديناميكية.
DYNAMIC_FLIGHTS مادة عرض رحلات الطيران الديناميكية.
DYNAMIC_TRAVEL مادة عرض السفر الديناميكي
DYNAMIC_LOCAL مادة عرض محلية ديناميكية
DYNAMIC_JOBS مادة عرض الوظائف الديناميكية
LOCATION مادة عرض الموقع الجغرافي.
HOTEL_PROPERTY مادة عرض الفندق

AssetPolicySummary

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

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

object (PolicyTopicEntry)

النتائج فقط. قائمة نتائج السياسة لمادة العرض هذه
reviewStatus

enum (PolicyReviewStatus)

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

enum (PolicyApprovalStatus)

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

AssetFieldTypePolicySummary

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

تمثيل JSON 
{
  "assetFieldType": enum (AssetFieldType),
  "assetSource": enum (AssetSource),
  "policySummaryInfo": {
    object (AssetPolicySummary)
  }
}
الحقول
assetFieldType

enum (AssetFieldType)

النتائج فقط. حقل نوع مادة العرض هذه
assetSource

enum (AssetSource)

النتائج فقط. مصدر مادة العرض هذه
policySummaryInfo

object (AssetPolicySummary)

النتائج فقط. ملخّص السياسة

YoutubeVideoAsset

مادة عرض على YouTube

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

string

عنوان الفيديو على YouTube
youtubeVideoId

string

معرّف الفيديو على YouTube وهي قيمة السلسلة المكونة من 11 حرفًا والمستخدَمة في عنوان URL لفيديو YouTube.

MediaBundleAsset

مادة عرض MediaBundle

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

string (bytes format)

بيانات مواد عرض حِزمة الوسائط (ملف ZIP) يعتمد تنسيق ملف ZIP الذي تم تحميله على حقل الإعلان الذي سيتم استخدامه فيه. للحصول على مزيد من المعلومات عن شكل الإعلان، يمكنك مراجعة مستندات حقل الإعلان الذي تنوي استخدام MediaBundleAsset عليه. هذا الحقل مخصص للتغيير فقط.

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

ImageAsset

مادة عرض صورة

تمثيل JSON 
{
  "mimeType": enum (MimeType),
  "fullSize": {
    object (ImageDimension)
  },
  "data": string,
  "fileSize": string
}
الحقول
mimeType

enum (MimeType)

نوع MIME لمادة عرض الصورة
fullSize

object (ImageDimension)

البيانات الوصفية لهذه الصورة بحجمها الأصلي.
data

string (bytes format)

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

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

string (int64 format)

حجم ملف مادة عرض الصورة بالبايت

ImageDimension

البيانات الوصفية لصورة بحجم معيّن، سواء كانت أصلية أو تم تغيير حجمها

تمثيل JSON 
{
  "heightPixels": string,
  "widthPixels": string,
  "url": string
}
الحقول
heightPixels

string (int64 format)

ارتفاع الصورة.
widthPixels

string (int64 format)

عرض الصورة.
url

string

تمثّل هذه السمة عنوان URL يعرض الصورة بهذا الارتفاع والعرض.

TextAsset

مادة عرض نصية

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

string

المحتوى النصي لمادة العرض النصية

LeadFormAsset

مادة عرض لنموذج العملاء المحتملين

تمثيل JSON 
{
  "businessName": string,
  "callToActionType": enum (LeadFormCallToActionType),
  "callToActionDescription": string,
  "headline": string,
  "description": string,
  "privacyPolicyUrl": string,
  "fields": [
    {
      object (LeadFormField)
    }
  ],
  "customQuestionFields": [
    {
      object (LeadFormCustomQuestionField)
    }
  ],
  "deliveryMethods": [
    {
      object (LeadFormDeliveryMethod)
    }
  ],
  "postSubmitCallToActionType": enum (LeadFormPostSubmitCallToActionType),
  "desiredIntent": enum (LeadFormDesiredIntent),
  "postSubmitHeadline": string,
  "postSubmitDescription": string,
  "backgroundImageAsset": string,
  "customDisclosure": string
}
الحقول
businessName

string

مطلوبة. اسم النشاط التجاري الذي يتم الإعلان عنه.
callToActionType

enum (LeadFormCallToActionType)

مطلوبة. نص عرض محدد مسبقًا يشجع المستخدم على توسيع النموذج.
callToActionDescription

string

مطلوبة. نص يقدّم عرض قيمة واضحًا لما يتوقعه المستخدمون بعد توسيع النموذج.
headline

string

مطلوبة. تمثّل هذه السمة عنوان النموذج الموسّع لوصف ما يطلبه النموذج أو يسهّله.
description

string

مطلوبة. وصف تفصيلي للنموذج الموسّع لوصف ما يطلبه النموذج أو يسهّله.
privacyPolicyUrl

string

مطلوبة. رابط إلى صفحة توضّح السياسة المتعلّقة بكيفية معالجة المعلِن أو النشاط التجاري للبيانات التي يتم جمعها.
fields[]

object (LeadFormField)

قائمة مرتبة لحقول الإدخال. يمكن تعديل هذا الحقل من خلال إعادة ترتيب الأسئلة، وليس بإضافة أسئلة أو إزالتها.
customQuestionFields[]

object (LeadFormCustomQuestionField)

قائمة مرتَّبة لحقول الأسئلة المخصّصة. يُسمح في هذا الحقل بعدد 5 أسئلة مؤهِّلة كحدّ أقصى في كل نموذج.
deliveryMethods[]

object (LeadFormDeliveryMethod)

تم ضبط الطرق لتسليم بيانات العملاء المحتملين التي تم جمعها إلى المعلن. يمكن ضبط طريقة واحدة فقط تمت كتابتها على أنّها تسليم الردّ التلقائي على الويب.
postSubmitCallToActionType

enum (LeadFormPostSubmitCallToActionType)

نص معروض محدد مسبقًا يشجع المستخدم على اتخاذ إجراء بعد إرسال النموذج.
desiredIntent

enum (LeadFormDesiredIntent)

النية المختارة لنموذج العملاء المحتملين، على سبيل المثال، عدد أكبر أو أكثر تأهلاً.
postSubmitHeadline

string

عنوان النص المعروض بعد إرسال النموذج والذي يصف كيف سيتابع المعلِن مع المستخدم.
postSubmitDescription

string

وصف تفصيلي يظهر بعد إرسال النموذج ويوضّح طريقة متابعة المعلِن مع المستخدم
backgroundImageAsset

string

اسم مورد مادة العرض لصورة الخلفية يجب أن تكون أبعاد الصورة 1200x628 بالضبط.
customDisclosure

string

يظهر بيان الإفصاح المخصّص مع بيان إخلاء المسؤولية من Google في نموذج العملاء المحتملين. متاح للعملاء المسموح لهم فقط.

LeadFormCallToActionType

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

عمليات التعداد
UNSPECIFIED لم يتم تحديده.
UNKNOWN تُستخدَم للقيمة المعروضة فقط. يمثل هذا الحقل قيمة غير معروفة في هذا الإصدار.
LEARN_MORE مزيد من المعلومات
GET_QUOTE الحصول على عرض أسعار تقديري
APPLY_NOW ننصحك بالإسراع في تقديم طلب الانضمام.
SIGN_UP الاشتراك.
CONTACT_US تواصل معنا.
SUBSCRIBE اشتراك.
DOWNLOAD تنزيل.
BOOK_NOW احجز الآن.
GET_OFFER الحصول على العرض.
REGISTER التسجيل
GET_INFO الحصول على معلومات
REQUEST_DEMO اطلب عرضًا توضيحيًا.
JOIN_NOW انضم الآن.
GET_STARTED البدء.

LeadFormField

مثيل حقل إدخال واحد داخل نموذج.

تمثيل JSON 
{
  "inputType": enum (LeadFormFieldUserInputType),

  // Union field answers can be only one of the following:
  "singleChoiceAnswers": {
    object (LeadFormSingleChoiceAnswers)
  },
  "hasLocationAnswer": boolean
  // End of list of possible types for union field answers.
}
الحقول
inputType

enum (LeadFormFieldUserInputType)

يصِف نوع الإدخال، الذي قد يكون نوعًا محددًا مسبقًا مثل "الاسم بالكامل" أو سؤال تم فحصه مسبقًا مثل "ما نوع المركبة التي لديك؟".
حقل الاتحاد answers. تحدِّد إعدادات الإجابة التي يقبلها حقل النموذج هذا. إذا لم يتم ضبط أحد هذين الخيارين، تكون الإجابة في نص حر. يمكن أن يكون answers واحدًا فقط مما يلي:
singleChoiceAnswers

object (LeadFormSingleChoiceAnswers)

ضبط الإجابة على سؤال واحد اختيار لا يمكن ضبط هذا الإعداد إلا لحقول الأسئلة التي تم فحصها مسبقًا. يجب تقديم إجابتَين كحد أدنى و12 إجابة كحد أقصى.
hasLocationAnswer

boolean

إعدادات الإجابة لسؤال الموقع الجغرافي في حال اختيار القيمة "صحيح"، سيتم عرض بيانات الموقع الجغرافي على مستوى الحملة/الحساب (الولاية والمدينة واسم النشاط التجاري وما إلى ذلك) في نموذج العملاء المحتملين. بدءًا من الإصدار 13.1، لا يمكن ضبط hasLocationAnswer إلا على السؤال "ما هي وكالتك المفضّلة؟" للمعلِنين الذين تم إعداد "مواد عرض المواقع الجغرافية" لهم على مستوى الحملة/الحساب.

LeadFormSingleChoiceAnswers

تحدد الإجابات المحتملة لسؤال اختيار واحد، ويتم تقديمها عادةً في شكل قائمة منسدلة ذات اختيار واحد.

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

string

قائمة بالخيارات لحقل سؤال واحد. يحدد ترتيب الإدخالات ترتيب واجهة المستخدم. يجب تقديم إجابتَين كحد أدنى و12 إجابة كحد أقصى.

LeadFormCustomQuestionField

مثال واحد لحقل إدخال سؤال مخصّص واحد داخل نموذج

تمثيل JSON 
{
  "customQuestionText": string,

  // Union field answers can be only one of the following:
  "singleChoiceAnswers": {
    object (LeadFormSingleChoiceAnswers)
  },
  "hasLocationAnswer": boolean
  // End of list of possible types for union field answers.
}
الحقول
customQuestionText

string

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

object (LeadFormSingleChoiceAnswers)

ضبط الإجابة على سؤال واحد اختيار يمكن تقديم إجابتين كحد أدنى و12 إجابة كحد أقصى.
hasLocationAnswer

boolean

إعدادات الإجابة لسؤال الموقع الجغرافي في حال اختيار القيمة "صحيح"، سيتم عرض بيانات الموقع الجغرافي على مستوى الحملة/الحساب (الولاية والمدينة واسم النشاط التجاري وما إلى ذلك) في نموذج العملاء المحتملين. بدءًا من الإصدار 13.1، لا يمكن ضبط hasLocationAnswer إلا على السؤال "ما هي وكالتك المفضّلة؟" للمعلِنين الذين تم إعداد "مواد عرض المواقع الجغرافية" لهم على مستوى الحملة/الحساب.

LeadFormDeliveryMethod

ضبط لكيفية تسليم العملاء المحتملين إلى المعلِن

تمثيل JSON 
{

  // Union field delivery_details can be only one of the following:
  "webhook": {
    object (WebhookDelivery)
  }
  // End of list of possible types for union field delivery_details.
}
الحقول
حقل الاتحاد delivery_details. أنواع فرعية مختلفة من التسليم: يمكن أن يكون delivery_details واحدًا فقط مما يلي:
webhook

object (WebhookDelivery)

طريقة الرد التلقائي على الويب للتسليم.

WebhookDelivery

ترسِل Google إشعارًا إلى المعلِنين عن العملاء المحتملين من خلال إجراء طلبات HTTP إلى نقطة نهاية يحدِّدونها. تحتوي الطلبات على ملف JSON يطابق مخططًا تنشره Google كجزء من مستندات نماذج الإعلانات.

تمثيل JSON 
{
  "advertiserWebhookUrl": string,
  "googleSecret": string,
  "payloadSchemaVersion": string
}
الحقول
advertiserWebhookUrl

string

عنوان URL للردّ التلقائي على الويب الذي حدّده المعلِن لإرسال العميل المحتمل.
googleSecret

string

سر مكافحة الانتحال الذي حدده المعلن كجزء من حمولة الرد التلقائي على الويب
payloadSchemaVersion

string (int64 format)

إصدار المخطط الذي سيستخدمه مثيل التسليم هذا.

LeadFormPostSubmitCallToActionType

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

عمليات التعداد
UNSPECIFIED لم يتم تحديده.
UNKNOWN تُستخدَم للقيمة المعروضة فقط. يمثل هذا الحقل قيمة غير معروفة في هذا الإصدار.
VISIT_SITE انتقِل إلى الموقع الإلكتروني.
DOWNLOAD تنزيل.
LEARN_MORE مزيد من المعلومات
SHOP_NOW تسوّق الآن.

LeadFormDesiredIntent

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

عمليات التعداد
UNSPECIFIED لم يتم تحديده.
UNKNOWN تُستخدَم للقيمة المعروضة فقط. يمثل هذا الحقل قيمة غير معروفة في هذا الإصدار.
LOW_INTENT يمكنك جذب المزيد من العملاء المحتملين بجودة أدنى.
HIGH_INTENT جذب عملاء محتملين أكثر تأهلاً.

BookOnGoogleAsset

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

مادة عرض من "الحجز على Google" تُستخدم لإعادة توجيه المستخدم إلى الحجز من خلال Google. ستغيّر ميزة "الحجز على Google" عنوان URL لإعادة التوجيه إلى الحجز مباشرةً من خلال Google.

PromotionAsset

مادة عرض خاصة بالعرض الترويجي

تمثيل JSON 
{
  "promotionTarget": string,
  "discountModifier": enum (PromotionExtensionDiscountModifier),
  "redemptionStartDate": string,
  "redemptionEndDate": string,
  "occasion": enum (PromotionExtensionOccasion),
  "languageCode": string,
  "startDate": string,
  "endDate": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],

  // Union field discount_type can be only one of the following:
  "percentOff": string,
  "moneyAmountOff": {
    object (Money)
  }
  // End of list of possible types for union field discount_type.

  // Union field promotion_trigger can be only one of the following:
  "promotionCode": string,
  "ordersOverAmount": {
    object (Money)
  }
  // End of list of possible types for union field promotion_trigger.
}
الحقول
promotionTarget

string

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

enum (PromotionExtensionDiscountModifier)

تمثّل هذه السمة أداة تعديل للإشارة إلى أهلية الخصم.
redemptionStartDate

string

تاريخ البدء الذي يكون فيه العرض الترويجي مؤهَّلاً للاستفادة منه، بالتنسيق yyyy-MM-dd
redemptionEndDate

string

آخر تاريخ يكون فيه العرض الترويجي مؤهَّلاً للاستفادة منه، بالتنسيق yyyy-MM-dd
occasion

enum (PromotionExtensionOccasion)

المناسبة التي كان الهدف منها العرض الترويجي. إذا تم تحديد مناسبة، يجب أن تقع فترة تحصيل القيمة ضمن النطاق الزمني المرتبط بهذه المناسبة.
languageCode

string

لغة العرض الترويجي يتم تمثيلها كعلامة اللغة BCP 47.
startDate

string

تاريخ البدء عندما تصبح مادة العرض هذه سارية ويمكن أن يبدأ عرضها بالتنسيق yyyy-MM-dd
endDate

string

التاريخ الأخير الذي أصبحت فيه مادة العرض هذه سارية ولا تزال قيد العرض، بالتنسيق yyyy-MM-dd
adScheduleTargets[]

object (AdScheduleInfo)

قائمة بالجداول الزمنية غير المتداخلة التي تحدِّد جميع الفواصل الزمنية التي قد تُعرض خلالها مادة العرض يمكن أن يكون هناك 6 جداول زمنية كحد أقصى في اليوم، وإجمالي 42 جدولاً.
حقل الاتحاد discount_type. نوع الخصم، يمكن أن يكون نسبة مئوية للخصم أو مبلغ خصم، ويمكن أن يكون discount_type واحدًا فقط مما يلي:
percentOff

string (int64 format)

تمثّل هذه السمة النسبة المئوية للخصم في العرض الترويجي. 1,000,000 = 100%. يجب تحديد هذا الحقل أوmoneyAmountOff.
moneyAmountOff

object (Money)

المبلغ النقدي للخصم في العرض الترويجي. يجب إدخال إما هذه النسبة المئوية للخصم أو النسبة المئوية للخصم.
حقل الاتحاد promotion_trigger. عامل تشغيل الترويج. يمكن استخدام الرمز الترويجي أو العرض الترويجي حسب مبلغ الطلب المؤهَّل. يمكن أن يكون promotion_trigger واحدًا فقط مما يلي:
promotionCode

string

رمز يجب أن يستخدمه المستخدم ليكون مؤهلاً للاستفادة من العرض الترويجي
ordersOverAmount

object (Money)

المبلغ الإجمالي الذي يجب أن يكون الطلب حتى يكون المستخدم مؤهلاً للعرض الترويجي.

CalloutAsset

مادة عرض وسيلة الشرح

تمثيل JSON 
{
  "calloutText": string,
  "startDate": string,
  "endDate": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ]
}
الحقول
calloutText

string

مطلوبة. نص وسيلة الشرح. يجب أن يكون طول هذه السلسلة بين 1 و25، بشكل شامل.
startDate

string

تاريخ البدء عندما تصبح مادة العرض هذه سارية ويمكن أن يبدأ عرضها بالتنسيق yyyy-MM-dd
endDate

string

التاريخ الأخير الذي أصبحت فيه مادة العرض هذه سارية ولا تزال قيد العرض، بالتنسيق yyyy-MM-dd
adScheduleTargets[]

object (AdScheduleInfo)

قائمة بالجداول الزمنية غير المتداخلة التي تحدِّد جميع الفواصل الزمنية التي قد تُعرض خلالها مادة العرض يمكن أن يكون هناك 6 جداول زمنية كحد أقصى في اليوم، وإجمالي 42 جدولاً.

StructuredSnippetAsset

مادة عرض مقتطف من الموقع

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

string

مطلوبة. تمثّل هذه السمة عنوان المقتطف. يجب أن تكون هذه السلسلة إحدى القيم المحدَّدة مسبقًا على الرابط https://developers.google.com/google-ads/api/reference/data/structured-snippet-headers.
values[]

string

مطلوبة. القيم في المقتطف. يجب أن يتراوح حجم هذه المجموعة من 3 إلى 10 بشكل شامل. ويجب أن يكون طول كل قيمة بين 1 و25 حرفًا بشكل شامل.

SitelinkAsset

مادة عرض رابط أقسام الموقع

تمثيل JSON 
{
  "linkText": string,
  "description1": string,
  "description2": string,
  "startDate": string,
  "endDate": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ]
}
الحقول
linkText

string

مطلوبة. النص المعروض لعنوان URL لرابط أقسام الموقع. يجب أن يكون طول هذه السلسلة بين 1 و25، بشكل شامل.
description1

string

السطر الأول من وصف رابط أقسام الموقع. وفي حال ضبطها، يجب أن يكون الطول بين 1 و35، ويجب أيضًا ضبط الوصف 2.
description2

string

السطر الثاني من وصف رابط أقسام الموقع. وفي حال ضبطها، يجب أن يكون الطول بين 1 و35، ويجب أيضًا ضبط description1.
startDate

string

تاريخ البدء عندما تصبح مادة العرض هذه سارية ويمكن أن يبدأ عرضها بالتنسيق yyyy-MM-dd
endDate

string

التاريخ الأخير الذي أصبحت فيه مادة العرض هذه سارية ولا تزال قيد العرض، بالتنسيق yyyy-MM-dd
adScheduleTargets[]

object (AdScheduleInfo)

قائمة بالجداول الزمنية غير المتداخلة التي تحدِّد جميع الفواصل الزمنية التي قد تُعرض خلالها مادة العرض يمكن أن يكون هناك 6 جداول زمنية كحد أقصى في اليوم، وإجمالي 42 جدولاً.

PageFeedAsset

مادة عرض لخلاصة صفحة

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

string

مطلوبة. صفحة الويب التي يريد المعلنون استهدافها.
labels[]

string

التصنيفات المستخدمة لتجميع عناوين URL للصفحات.

DynamicEducationAsset

مادة عرض ديناميكية للتعليم

تمثيل JSON 
{
  "programId": string,
  "locationId": string,
  "programName": string,
  "subject": string,
  "programDescription": string,
  "schoolName": string,
  "address": string,
  "contextualKeywords": [
    string
  ],
  "androidAppLink": string,
  "similarProgramIds": [
    string
  ],
  "iosAppLink": string,
  "iosAppStoreId": string,
  "thumbnailImageUrl": string,
  "imageUrl": string
}
الحقول
programId

string

مطلوبة. رقم تعريف البرنامج الذي يمكن أن يكون أي تسلسل من الأحرف والأرقام، ويجب أن يكون فريدًا وأن يتطابق مع قيم علامة تجديد النشاط التسويقي. مطلوبة.
locationId

string

معرّف الموقع الجغرافي الذي يمكن أن يكون أي تسلسل من الأحرف والأرقام، ويجب أن يكون فريدًا.
programName

string

مطلوبة. اسم البرنامج، مثل "تمريض". مطلوبة.
subject

string

موضوع الدراسة، مثل الصحة.
programDescription

string

تمثّل هذه السمة وصف البرنامج، مثل شهادة التمريض.
schoolName

string

اسم المدرسة، على سبيل المثال، "مدرسة ماونتن فيو للتمريض".
address

string

عنوان المدرسة الذي يمكن تحديده بأحد التنسيقات التالية. (1) المدينة، والولاية، والرمز، والبلد، على سبيل المثال، ماونتن فيو، كاليفورنيا، الولايات المتحدة الأمريكية. (2) العنوان الكامل، على سبيل المثال، 123 Boulevard St, Mountain View, CA 94043 (3) خط العرض وخط الطول بتنسيق DDD، على سبيل المثال، 41.40338، 2.17403
contextualKeywords[]

string

الكلمات الرئيسية السياقية، مثل شهادة التمريض، الصحة، ماونتن فيو.
similarProgramIds[]

string

أرقام تعريف البرامج المتشابهة
iosAppStoreId

string (int64 format)

رقم التعريف في متجر تطبيقات iOS. يُستخدم هذا للتحقّق مما إذا كان المستخدم قد ثبَّت التطبيق على جهازه قبل الربط بصفحة معيّنة. في حال ضبط هذا الحقل، يجب أن يكون حقل iosAppLink متوفرًا أيضًا.
thumbnailImageUrl

string

عنوان URL للصورة المصغّرة، على سبيل المثال، http://www.example.com/thumbnail.png. لن يتمّ تحميل الصورة المصغّرة كمادة عرض صورة.
imageUrl

string

عنوان URL للصورة، على سبيل المثال، http://www.example.com/image.png. لن يتم تحميل الصورة كمادة عرض صورة.

MobileAppAsset

مادة عرض تمثّل تطبيقًا للأجهزة الجوّالة

تمثيل JSON 
{
  "appId": string,
  "appStore": enum (MobileAppVendor),
  "linkText": string,
  "startDate": string,
  "endDate": string
}
الحقول
appId

string

مطلوبة. سلسلة تُعرِّف تطبيقًا للأجهزة الجوّالة بشكلٍ فريد. ويجب أن تحتوي فقط على رقم التعريف الأصلي للنظام الأساسي، مثل "com.android.ebay" لنظام التشغيل Android أو "12345689" لنظام التشغيل iOS.
appStore

enum (MobileAppVendor)

مطلوبة. متجر التطبيقات الذي يوزّع هذا التطبيق المحدّد.
linkText

string

مطلوبة. النص المرئي الذي يتم عرضه عند عرض الرابط في أحد الإعلانات. يجب أن يكون طول هذه السلسلة بين 1 و25، بشكل شامل.
startDate

string

تاريخ البدء عندما تصبح مادة العرض هذه سارية ويمكن أن يبدأ عرضها بالتنسيق yyyy-MM-dd
endDate

string

التاريخ الأخير الذي أصبحت فيه مادة العرض هذه سارية ولا تزال قيد العرض، بالتنسيق yyyy-MM-dd

HotelCalloutAsset

مادة عرض تمثّل وسيلة شرح للفندق.

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

string

مطلوبة. نص مادة عرض وسيلة الشرح للفندق. يجب أن يكون طول هذه السلسلة بين 1 و25، بشكل شامل.
languageCode

string

مطلوبة. لغة وسيلة الشرح للفندق. يتم تمثيلها كعلامة اللغة BCP 47.

CallAsset

مادة عرض الاتصال

تمثيل JSON 
{
  "countryCode": string,
  "phoneNumber": string,
  "callConversionReportingState": enum (CallConversionReportingState),
  "callConversionAction": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ]
}
الحقول
countryCode

string

مطلوبة. رمز البلد المكوّن من حرفَين لرقم الهاتف. أمثلة: "الولايات المتحدة" و"الولايات المتحدة".
phoneNumber

string

مطلوبة. رقم الهاتف الأولي للمعلِن. أمثلة: "1234567890" و"(123)456-7890"
callConversionReportingState

enum (CallConversionReportingState)

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

string

إجراء الإحالة الناجحة الذي يتم تحديد مصدر إحالة ناجحة للمكالمات عليه. وفي حال ترك هذه السياسة بدون ضبط، يتم استخدام إجراء الإحالة الناجحة التلقائي. لن يكون لهذا الحقل أي تأثير إلا في حال ضبط call ConversionReportingState على USE_LOCATION_LEVEL_CALL_CONVERSION_ACTION.
adScheduleTargets[]

object (AdScheduleInfo)

قائمة بالجداول الزمنية غير المتداخلة التي تحدِّد جميع الفواصل الزمنية التي قد تُعرض خلالها مادة العرض يمكن أن يكون هناك 6 جداول زمنية كحد أقصى في اليوم، وإجمالي 42 جدولاً.

PriceAsset

مادة عرض تمثّل قائمة بعروض أسعار

تمثيل JSON 
{
  "type": enum (PriceExtensionType),
  "priceQualifier": enum (PriceExtensionPriceQualifier),
  "languageCode": string,
  "priceOfferings": [
    {
      object (PriceOffering)
    }
  ]
}
الحقول
type

enum (PriceExtensionType)

مطلوبة. نوع مادة عرض السعر
priceQualifier

enum (PriceExtensionPriceQualifier)

مؤهِّل سعر مادة عرض السعر
languageCode

string

مطلوبة. لغة مادة عرض السعر يتم تمثيلها كعلامة اللغة BCP 47.
priceOfferings[]

object (PriceOffering)

عروض الأسعار لمادة عرض السعر يجب أن يتراوح حجم هذه المجموعة من 3 إلى 8 كحد أقصى.

PriceOffering

عرض سعر واحد ضمن priceAsset

تمثيل JSON 
{
  "header": string,
  "description": string,
  "price": {
    object (Money)
  },
  "unit": enum (PriceExtensionPriceUnit),
  "finalUrl": string,
  "finalMobileUrl": string
}
الحقول
header

string

مطلوبة. تمثّل هذه السمة عنوان سعر العرض. يجب أن يكون طول هذه السلسلة بين 1 و25، بشكل شامل.
description

string

مطلوبة. تمثّل هذه السمة وصف السعر المعروض. يجب أن يكون طول هذه السلسلة بين 1 و25، بشكل شامل.
price

object (Money)

مطلوبة. تشير هذه السمة إلى قيمة سعر العرض.
unit

enum (PriceExtensionPriceUnit)

تمثّل هذه السمة وحدة سعر العرض.
finalUrl

string

مطلوبة. عنوان URL النهائي بعد جميع عمليات إعادة التوجيه عبر النطاقات.
finalMobileUrl

string

عنوان URL النهائي للجوّال بعد جميع عمليات إعادة التوجيه عبر النطاقات.

CallToActionAsset

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

تمثيل JSON 
{
  "callToAction": enum (CallToActionType)
}
الحقول
callToAction

enum (CallToActionType)

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

DynamicRealEstateAsset

مادة عرض عقارية ديناميكية.

تمثيل JSON 
{
  "listingId": string,
  "listingName": string,
  "cityName": string,
  "description": string,
  "address": string,
  "price": string,
  "imageUrl": string,
  "propertyType": string,
  "listingType": string,
  "contextualKeywords": [
    string
  ],
  "formattedPrice": string,
  "androidAppLink": string,
  "iosAppLink": string,
  "iosAppStoreId": string,
  "similarListingIds": [
    string
  ]
}
الحقول
listingId

string

مطلوبة. رقم تعريف النشاط التجاري الذي يمكن أن يكون أي تسلسل من الأحرف والأرقام، ويجب أن يكون فريدًا وأن يتطابق مع قيم علامة تجديد النشاط التسويقي. مطلوبة.
listingName

string

مطلوبة. اسم النشاط، على سبيل المثال، بنغالو. مطلوبة.
cityName

string

اسم المدينة، مثل مدينة القاهرة، مصر.
description

string

الوصف، على سبيل المثال، 3 أسرّة وحمّامَين و1568 قدمًا مربعًا
address

string

العنوان الذي يمكن تحديده بأحد التنسيقات التالية. (1) المدينة، والولاية، والرمز، والبلد، على سبيل المثال، ماونتن فيو، كاليفورنيا، الولايات المتحدة الأمريكية. (2) العنوان الكامل، على سبيل المثال، 123 Boulevard St, Mountain View, CA 94043 (3) خط العرض وخط الطول بتنسيق DDD، على سبيل المثال، 41.40338، 2.17403
price

string

هو السعر الذي يمكن أن يكون رقمًا متبوعًا برمز العملة الأبجدي، وفقًا لمعيار ISO 4217. استخدِم "." كعلامة عشرية، مثلاً 200,000.00 SAR.
imageUrl

string

عنوان URL للصورة، على سبيل المثال، http://www.example.com/image.png. لن يتم تحميل الصورة كمادة عرض صورة.
propertyType

string

نوع الموقع، على سبيل المثال، منزل.
listingType

string

نوع النشاط، على سبيل المثال، "معروض للبيع".
contextualKeywords[]

string

الكلمات الرئيسية السياقية، مثل للبيع، ومنازل للبيع.
formattedPrice

string

السعر المنسَّق الذي يمكن أن يكون أي أحرف في حال ضبط هذه السمة، سيتمّ استخدام هذه السمة بدلاً من "price" (السعر) مثلاً، بدءًا من 200,000.00 ريال سعودي.
iosAppStoreId

string (int64 format)

رقم التعريف في متجر تطبيقات iOS. يُستخدم هذا للتحقّق مما إذا كان المستخدم قد ثبَّت التطبيق على جهازه قبل الربط بصفحة معيّنة. في حال ضبط هذا الحقل، يجب أن يكون حقل iosAppLink متوفرًا أيضًا.
similarListingIds[]

string

أرقام تعريف الأنشطة المتشابهة.

DynamicCustomAsset

مادة عرض مخصّصة ديناميكية

تمثيل JSON 
{
  "id": string,
  "id2": string,
  "itemTitle": string,
  "itemSubtitle": string,
  "itemDescription": string,
  "itemAddress": string,
  "itemCategory": string,
  "price": string,
  "salePrice": string,
  "formattedPrice": string,
  "formattedSalePrice": string,
  "imageUrl": string,
  "contextualKeywords": [
    string
  ],
  "androidAppLink": string,
  "iosAppLink": string,
  "iosAppStoreId": string,
  "similarIds": [
    string
  ]
}
الحقول
id

string

مطلوبة. رقم تعريف يمكن أن يكون أي سلسلة من الأحرف والأرقام، ويجب أن يكون فريدًا وأن يتطابق مع قيم علامة تجديد النشاط التسويقي، مثل سيارة سيدان. مطلوبة.
id2

string

ID2 الذي يمكن أن يكون أي تسلسل من الأحرف والأرقام، مثل الأحمر. يجب أن يكون تسلسل أرقام التعريف (رقم التعريف + رقم التعريف 2) فريدًا.
itemTitle

string

مطلوبة. عنوان السلعة، على سبيل المثال، سيارة سيدان متوسطة الحجم مطلوبة.
itemSubtitle

string

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

string

وصف السلعة، مثل السيارة المتوسطة الحجم الأكثر مبيعًا
itemAddress

string

عنوان العنصر الذي يمكن تحديده بأحد التنسيقات التالية. (1) المدينة، والولاية، والرمز، والبلد، على سبيل المثال، ماونتن فيو، كاليفورنيا، الولايات المتحدة الأمريكية. (2) العنوان الكامل، على سبيل المثال، 123 Boulevard St, Mountain View, CA 94043 (3) خط العرض وخط الطول بتنسيق DDD، على سبيل المثال، 41.40338، 2.17403
itemCategory

string

فئة السلعة، مثل سيارات سيدان.
price

string

هو السعر الذي يمكن أن يكون رقمًا متبوعًا برمز العملة الأبجدي، وفقًا لمعيار ISO 4217. استخدِم "." كعلامة عشرية، مثلاً 20,000.00 SAR.
salePrice

string

يشير إلى السعر المخفَّض (يمكن أن يكون رقمًا متبوعًا برمز العملة الأبجدي وفقًا لمعيار ISO 4217). استخدِم "." كعلامة عشرية، على سبيل المثال 15,000.00 SAR. يجب أن يكون أقل من حقل "السعر".
formattedPrice

string

السعر المنسَّق الذي يمكن أن يكون أي أحرف في حال ضبط هذه السمة، سيتمّ استخدام هذه السمة بدلاً من "price" (السعر) مثلاً، بدءًا من 20,000.00 دولار أمريكي.
formattedSalePrice

string

السعر المخفَّض المنسَّق الذي يمكن أن يكون أي أحرف في حال ضبط هذه السمة، سيتمّ استخدام هذه السمة بدلاً من "sale price" (السعر المخفَّض)، على سبيل المثال، "معروض بسعر مخفَّض" بقيمة 15,000.00 ريال سعودي.
imageUrl

string

عنوان URL للصورة، على سبيل المثال، http://www.example.com/image.png. لن يتم تحميل الصورة كمادة عرض صورة.
contextualKeywords[]

string

الكلمات الرئيسية السياقية، مثل سيارات سيدان، سيارات سيدان بأربعة أبواب
iosAppStoreId

string (int64 format)

رقم التعريف في متجر تطبيقات iOS. يُستخدم هذا للتحقّق مما إذا كان المستخدم قد ثبَّت التطبيق على جهازه قبل الربط بصفحة معيّنة. في حال ضبط هذا الحقل، يجب أن يكون حقل iosAppLink متوفرًا أيضًا.
similarIds[]

string

أرقام التعريف المتشابهة.

DynamicHotelsAndRentalsAsset

مادة عرض ديناميكية للفنادق والتأجير.

تمثيل JSON 
{
  "propertyId": string,
  "propertyName": string,
  "imageUrl": string,
  "destinationName": string,
  "description": string,
  "price": string,
  "salePrice": string,
  "starRating": string,
  "category": string,
  "contextualKeywords": [
    string
  ],
  "address": string,
  "androidAppLink": string,
  "iosAppLink": string,
  "iosAppStoreId": string,
  "formattedPrice": string,
  "formattedSalePrice": string,
  "similarPropertyIds": [
    string
  ]
}
الحقول
propertyId

string

مطلوبة. رقم تعريف الموقع الذي يمكن أن يكون أي تسلسل من الأحرف والأرقام، ويجب أن يكون فريدًا ويتطابق مع قيم علامة تجديد النشاط التسويقي. مطلوبة.
propertyName

string

مطلوبة. اسم الموقع، على سبيل المثال، فندق ماونتن فيو. مطلوبة.
imageUrl

string

عنوان URL للصورة، على سبيل المثال، http://www.example.com/image.png. لن يتم تحميل الصورة كمادة عرض صورة.
destinationName

string

اسم الوجهة، مثل وسط المدينة، ماونتن فيو.
description

string

وصف، على سبيل المثال، بالقرب من مطار دبي الدولي.
price

string

هو السعر الذي يمكن أن يكون رقمًا متبوعًا برمز العملة الأبجدي، وفقًا لمعيار ISO 4217. استخدِم "." كعلامة عشرية، مثلاً 100.00 SAR.
salePrice

string

معيار ISO 4217 استخدِم "." كعلامة عشرية، مثلاً 80.00 SAR. يجب أن يكون أقل من حقل "السعر".
starRating

string (int64 format)

تقييم بالنجوم يجب أن تكون القيمة رقمًا يتراوح بين 1 و5 (ضمنًا).
category

string

الفئة، مثل "جناح الفندق".
contextualKeywords[]

string

الكلمات الرئيسية السياقية، مثل "فنادق" في ماونتن فيو وفنادق في المنطقة الجنوبية.
address

string

العنوان الذي يمكن تحديده بأحد التنسيقات التالية. (1) المدينة، والولاية، والرمز، والبلد، على سبيل المثال، ماونتن فيو، كاليفورنيا، الولايات المتحدة الأمريكية. (2) العنوان الكامل، على سبيل المثال، 123 Boulevard St, Mountain View, CA 94043 (3) خط العرض وخط الطول بتنسيق DDD، على سبيل المثال، 41.40338، 2.17403
iosAppStoreId

string (int64 format)

رقم التعريف في متجر تطبيقات iOS. يُستخدم هذا للتحقّق مما إذا كان المستخدم قد ثبَّت التطبيق على جهازه قبل الربط بصفحة معيّنة. في حال ضبط هذا الحقل، يجب أن يكون حقل iosAppLink متوفرًا أيضًا.
formattedPrice

string

السعر المنسَّق الذي يمكن أن يكون أي أحرف في حال ضبط هذه السمة، سيتمّ استخدام هذه السمة بدلاً من "price" (السعر) مثلاً، بدءًا من $100.00.
formattedSalePrice

string

السعر المخفَّض المنسَّق الذي يمكن أن يكون أي أحرف في حال ضبط هذه السمة، سيتمّ استخدام هذه السمة بدلاً من "sale price" (السعر المخفَّض)، على سبيل المثال، "معروض بسعر مخفَّض" بقيمة 80.00 SAR.
similarPropertyIds[]

string

أرقام تعريف المواقع المتشابهة.

DynamicFlightsAsset

مادة عرض ديناميكية لرحلات جوية

تمثيل JSON 
{
  "destinationId": string,
  "originId": string,
  "flightDescription": string,
  "imageUrl": string,
  "destinationName": string,
  "originName": string,
  "flightPrice": string,
  "flightSalePrice": string,
  "formattedPrice": string,
  "formattedSalePrice": string,
  "androidAppLink": string,
  "iosAppLink": string,
  "iosAppStoreId": string,
  "similarDestinationIds": [
    string
  ],
  "customMapping": string
}
الحقول
destinationId

string

مطلوبة. رقم تعريف الوجهة الذي يمكن أن يكون أي تسلسل من الأحرف والأرقام، ويجب أن يكون فريدًا ويتطابق مع قيم علامة تجديد النشاط التسويقي. مطلوبة.
originId

string

رقم تعريف المنشأ الذي يمكن أن يكون أي تسلسل من الأحرف والأرقام. يجب أن يكون تسلسل أرقام التعريف (رقم تعريف الوجهة + رقم تعريف المصدر) فريدًا.
flightDescription

string

مطلوبة. وصف الرحلة الجوية، مثل حجز تذكرتك مطلوبة.
imageUrl

string

عنوان URL للصورة، على سبيل المثال، http://www.example.com/image.png. لن يتم تحميل الصورة كمادة عرض صورة.
destinationName

string

اسم الوجهة، على سبيل المثال، دبي.
originName

string

اسم نقطة الانطلاق، مثل لندن
flightPrice

string

سعر رحلة الطيران الذي يمكن أن يكون رقمًا متبوعًا برمز العملة الأبجدي وفقًا لمعيار ISO 4217 استخدِم "." كعلامة عشرية، مثلاً 100.00 SAR.
flightSalePrice

string

السعر المخفَّض لرحلة الطيران الذي يمكن أن يكون رقمًا متبوعًا برمز العملة الأبجدي وفقًا لمعيار ISO 4217 استخدِم "." كعلامة عشرية، مثلاً 80.00 SAR. يجب أن يكون الحقل أقل من حقل "FlightPrice".
formattedPrice

string

السعر المنسَّق الذي يمكن أن يكون أي أحرف في حال ضبط هذه السمة، سيتمّ استخدام هذه السمة بدلاً من "price" (السعر) مثلاً، بدءًا من $100.00.
formattedSalePrice

string

السعر المخفَّض المنسَّق الذي يمكن أن يكون أي أحرف في حال ضبط هذه السمة، سيتمّ استخدام هذه السمة بدلاً من "sale price" (السعر المخفَّض)، على سبيل المثال، "معروض بسعر مخفَّض" بقيمة 80.00 SAR.
iosAppStoreId

string (int64 format)

رقم التعريف في متجر تطبيقات iOS. يُستخدم هذا للتحقّق مما إذا كان المستخدم قد ثبَّت التطبيق على جهازه قبل الربط بصفحة معيّنة. في حال ضبط هذا الحقل، يجب أن يكون حقل iosAppLink متوفرًا أيضًا.
similarDestinationIds[]

string

أرقام تعريف الوجهات المتشابهة، مثل PAR,LON.
customMapping

string

حقل مخصّص يمكن أن يكون عدة مفاتيح لربط القيم مع فصلها بمحدِّدات (",", "|" و":")، بأشكال ": , , ... , | : ، ... , | ... | : ، ... ," على سبيل المثال، wifi: معظم | الطائرة: 320، 77 واط | الغرفة: 42 177 واط. 42 |

DemandGenCarouselCardAsset

مادة عرض بطاقة "الإعلان المتبدّل لزيادة الطلب"

تمثيل JSON 
{
  "marketingImageAsset": string,
  "squareMarketingImageAsset": string,
  "portraitMarketingImageAsset": string,
  "headline": string,
  "callToActionText": string
}
الحقول
marketingImageAsset

string

اسم مورد مادة العرض للصورة التسويقية المرتبطة بنسبة عرض إلى ارتفاع 1.91:1. يجب إدخال مادة عرض الصورة التسويقية هذه و/أو الصورة المربّعة.
squareMarketingImageAsset

string

اسم مورد مادة العرض للصورة التسويقية المربّعة المرتبطة. يجب إدخال مادة عرض الصورة التسويقية هذه و/أو الصورة التسويقية.
portraitMarketingImageAsset

string

اسم مورد مادة العرض للصورة التسويقية العمودية المرتبطة بنسبة عرض إلى ارتفاع تبلغ 4:5.
headline

string

مطلوبة. عنوان بطاقة لوحة العرض الدوّارة
callToActionText

string

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

DynamicTravelAsset

مادة عرض ديناميكية للسفر

تمثيل JSON 
{
  "destinationId": string,
  "originId": string,
  "title": string,
  "destinationName": string,
  "destinationAddress": string,
  "originName": string,
  "price": string,
  "salePrice": string,
  "formattedPrice": string,
  "formattedSalePrice": string,
  "category": string,
  "contextualKeywords": [
    string
  ],
  "similarDestinationIds": [
    string
  ],
  "imageUrl": string,
  "androidAppLink": string,
  "iosAppLink": string,
  "iosAppStoreId": string
}
الحقول
destinationId

string

مطلوبة. رقم تعريف الوجهة الذي يمكن أن يكون أي تسلسل من الأحرف والأرقام، ويجب أن يكون فريدًا ويتطابق مع قيم علامة تجديد النشاط التسويقي. مطلوبة.
originId

string

رقم تعريف المنشأ الذي يمكن أن يكون أي تسلسل من الأحرف والأرقام. يجب أن يكون تسلسل أرقام التعريف (رقم تعريف الوجهة + رقم تعريف المصدر) فريدًا.
title

string

مطلوبة. العنوان، على سبيل المثال، "حجز تذكرة القطار". مطلوبة.
destinationName

string

اسم الوجهة، على سبيل المثال، دبي.
destinationAddress

string

عنوان الوجهة الذي يمكن تحديده بأحد التنسيقات التالية. (1) المدينة، والولاية، والرمز، والبلد، على سبيل المثال، ماونتن فيو، كاليفورنيا، الولايات المتحدة الأمريكية. (2) العنوان الكامل، على سبيل المثال، 123 Boulevard St, Mountain View, CA 94043 (3) خط العرض وخط الطول بتنسيق DDD، على سبيل المثال، 41.40338، 2.17403.
originName

string

اسم نقطة الانطلاق، مثل لندن
price

string

يشير إلى السعر الذي يمكن أن يكون رقمًا متبوعًا برمز العملة الأبجدي وفقًا لمعيار ISO 4217. استخدِم "." كعلامة عشرية، مثلاً 100.00 SAR.
salePrice

string

يشير إلى السعر المخفَّض الذي يمكن أن يكون رقمًا متبوعًا برمز العملة الأبجدي وفقًا لمعيار ISO 4217. استخدِم "." كعلامة عشرية، مثلاً 80.00 SAR. يجب أن يكون أقل من حقل "السعر".
formattedPrice

string

السعر المنسَّق الذي يمكن أن يكون أي أحرف في حال ضبط هذه السمة، سيتمّ استخدام هذه السمة بدلاً من "price" (السعر) مثلاً، بدءًا من $100.00.
formattedSalePrice

string

السعر المخفَّض المنسَّق الذي يمكن أن يكون أي أحرف في حال ضبط هذه السمة، سيتمّ استخدام هذه السمة بدلاً من "sale price" (السعر المخفَّض)، على سبيل المثال، "معروض بسعر مخفَّض" بقيمة 80.00 SAR.
category

string

الفئة، مثل "سريع".
contextualKeywords[]

string

الكلمات الرئيسية السياقية، مثل قطارات باريس.
similarDestinationIds[]

string

أرقام تعريف الوجهات المتشابهة، على سبيل المثال، دبي
imageUrl

string

عنوان URL للصورة، على سبيل المثال، http://www.example.com/image.png. لن يتم تحميل الصورة كمادة عرض صورة.
iosAppStoreId

string (int64 format)

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

DynamicLocalAsset

مادة عرض محلية ديناميكية

تمثيل JSON 
{
  "dealId": string,
  "dealName": string,
  "subtitle": string,
  "description": string,
  "price": string,
  "salePrice": string,
  "imageUrl": string,
  "address": string,
  "category": string,
  "contextualKeywords": [
    string
  ],
  "formattedPrice": string,
  "formattedSalePrice": string,
  "androidAppLink": string,
  "similarDealIds": [
    string
  ],
  "iosAppLink": string,
  "iosAppStoreId": string
}
الحقول
dealId

string

مطلوبة. رقم تعريف الصفقة الذي يمكن أن يكون أي تسلسل من الأحرف والأرقام، ويجب أن يكون فريدًا وأن يتطابق مع قيم علامة تجديد النشاط التسويقي. مطلوبة.
dealName

string

مطلوبة. اسم الصفقة، على سبيل المثال، خصم% 50 في محلات بقالة ماونتن فيو. مطلوبة.
subtitle

string

العنوان الفرعي، مثل منتجات البقالة.
description

string

الوصف، على سبيل المثال، التوفير في فاتورتك الأسبوعية.
price

string

يشير إلى السعر الذي يمكن أن يكون رقمًا متبوعًا برمز العملة الأبجدي وفقًا لمعيار ISO 4217. استخدِم "." كعلامة عشرية، مثلاً 100.00 SAR.
salePrice

string

يشير إلى السعر المخفَّض (يمكن أن يكون رقمًا متبوعًا برمز العملة الأبجدي وفقًا لمعيار ISO 4217). استخدِم "." كعلامة عشرية، مثلاً 80.00 SAR. يجب أن يكون أقل من حقل "السعر".
imageUrl

string

عنوان URL للصورة، على سبيل المثال، http://www.example.com/image.png. لن يتم تحميل الصورة كمادة عرض صورة.
address

string

العنوان الذي يمكن تحديده بأحد التنسيقات التالية. (1) المدينة، والولاية، والرمز، والبلد، على سبيل المثال، ماونتن فيو، كاليفورنيا، الولايات المتحدة الأمريكية. (2) العنوان الكامل، على سبيل المثال، 123 Boulevard St, Mountain View, CA 94043 (3) خط العرض وخط الطول بتنسيق DDD، على سبيل المثال، 41.40338، 2.17403.
category

string

الفئة، مثل "طعام".
contextualKeywords[]

string

الكلمات الرئيسية السياقية، مثل قسائم "حفظ بقالة"
formattedPrice

string

السعر المنسَّق الذي يمكن أن يكون أي أحرف في حال ضبط هذه السمة، سيتمّ استخدام هذه السمة بدلاً من "price" (السعر) مثلاً، بدءًا من $100.00.
formattedSalePrice

string

السعر المخفَّض المنسَّق الذي يمكن أن يكون أي أحرف في حال ضبط هذه السمة، سيتمّ استخدام هذه السمة بدلاً من "sale price" (السعر المخفَّض)، على سبيل المثال، "معروض بسعر مخفَّض" بقيمة 80.00 SAR.
similarDealIds[]

string

أرقام تعريف الصفقات المتشابهة، على سبيل المثال، 1275.
iosAppStoreId

string (int64 format)

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

DynamicJobsAsset

مادة عرض ديناميكية للوظائف

تمثيل JSON 
{
  "jobId": string,
  "locationId": string,
  "jobTitle": string,
  "jobSubtitle": string,
  "description": string,
  "imageUrl": string,
  "jobCategory": string,
  "contextualKeywords": [
    string
  ],
  "address": string,
  "salary": string,
  "androidAppLink": string,
  "similarJobIds": [
    string
  ],
  "iosAppLink": string,
  "iosAppStoreId": string
}
الحقول
jobId

string

مطلوبة. معرّف الوظيفة الذي يمكن أن يكون أي تسلسل من الأحرف والأرقام، ويجب أن يكون فريدًا وأن يتطابق مع قيم علامة تجديد النشاط التسويقي. مطلوبة.
locationId

string

معرّف الموقع الذي يمكن أن يكون أي تسلسل من الأحرف والأرقام. يجب أن يكون تسلسل أرقام التعريف (معرّف الوظيفة + معرّف الموقع الجغرافي) فريدًا.
jobTitle

string

مطلوبة. المسمى الوظيفي، على سبيل المثال، مهندس برمجيات مطلوبة.
jobSubtitle

string

العنوان الفرعي للوظيفة، مثل المستوى الثاني.
description

string

الوصف، على سبيل المثال، تطبيق مهاراتك الفنية.
imageUrl

string

عنوان URL للصورة، على سبيل المثال، http://www.example.com/image.png. لن يتم تحميل الصورة كمادة عرض صورة.
jobCategory

string

فئة الوظيفة، مثل فني.
contextualKeywords[]

string

الكلمات الرئيسية السياقية، مثل وظيفة هندسة البرمجيات.
address

string

العنوان الذي يمكن تحديده بأحد التنسيقات التالية. (1) المدينة، والولاية، والرمز، والبلد، على سبيل المثال، ماونتن فيو، كاليفورنيا، الولايات المتحدة الأمريكية. (2) العنوان الكامل، على سبيل المثال، 123 Boulevard St, Mountain View, CA 94043 (3) خط العرض وخط الطول بتنسيق DDD، على سبيل المثال، 41.40338، 2.17403.
salary

string

الراتب، على سبيل المثال، 100000 دولار أمريكي.
similarJobIds[]

string

مُعرّفات الوظائف المتشابهة، على سبيل المثال، 1275.
iosAppStoreId

string (int64 format)

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

LocationAsset

مادة عرض موقع جغرافي

تمثيل JSON 
{
  "placeId": string,
  "businessProfileLocations": [
    {
      object (BusinessProfileLocation)
    }
  ],
  "locationOwnershipType": enum (LocationOwnershipType)
}
الحقول
placeId

string

تحدِّد أرقام تعريف الأماكن مكانًا بشكلٍ فريد في قاعدة بيانات "أماكن Google" وعلى "خرائط Google". هذا الحقل فريد لرقم تعريف عميل ونوع مادة عرض محدّدَين. اطّلع على https://developers.google.com/places/web-service/place-id لمعرفة المزيد من المعلومات عن رقم تعريف المكان.
businessProfileLocations[]

object (BusinessProfileLocation)

قائمة المواقع الجغرافية للنشاط التجاري للعميل. ولن يتم عرض ذلك إلا في حال مزامنة مادة عرض الموقع الجغرافي من حساب "الملف التجاري". من الممكن أن تكون لديك عدة بطاقات بيانات ملف تجاري ضمن الحساب نفسه تشير إلى رقم تعريف المكان نفسه.
locationOwnershipType

enum (LocationOwnershipType)

نوع ملكية الموقع الجغرافي. إذا كان النوع هو business_OWNER، فسيتم عرضه كإضافة موقع. إذا كان النوع "شريك تابع"، سيتم عرضه كموقع جغرافي للشركاء التابعين.

BusinessProfileLocation

بيانات الموقع الجغرافي في "الملف التجاري" التي تمت مزامنتها من حساب "الملف التجاري" المرتبط

تمثيل JSON 
{
  "labels": [
    string
  ],
  "storeCode": string,
  "listingId": string
}
الحقول
labels[]

string

التصنيف الذي حدّده المعلن للموقع الجغرافي في حساب "الملف التجاري" وتتم مزامنة هذه البيانات من حساب "الملف التجاري على Google".
storeCode

string

رمز متجر الملف التجاري الخاص بهذا الموقع الجغرافي وتتم مزامنة هذه البيانات من حساب "الملف التجاري على Google".
listingId

string (int64 format)

رقم تعريف النشاط لهذا الموقع الجغرافي في "الملف التجاري" تتم مزامنة هذه البيانات من حساب "الملف التجاري" المرتبط.

HotelPropertyAsset

مادة عرض لفندق.

تمثيل JSON 
{
  "placeId": string,
  "hotelAddress": string,
  "hotelName": string
}
الحقول
placeId

string

تحدِّد أرقام تعريف الأماكن مكانًا بشكلٍ فريد في قاعدة بيانات "أماكن Google" وعلى "خرائط Google". يمكنك الانتقال إلى https://developers.google.com/places/web-service/place-id لمعرفة مزيد من المعلومات.
hotelAddress

string

عنوان الفندق للقراءة فقط.
hotelName

string

اسم الفندق للقراءة فقط.