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)
  },
  "discoveryCarouselCardAsset": {
    object (DiscoveryCarouselCardAsset)
  },
  "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 في traceUrlTemplate و/أو FinalUrls و/أو lastMobileUrls.
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)

النتائج فقط. الحقل FieldType لمادة العرض هذه.
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)

طرق تم ضبطها لتقديم بيانات العملاء المحتملين التي تم جمعها إلى المعلِن. يمكن ضبط طريقة واحدة فقط تتم كتابتها على أنّها WebhookDelivery.
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)

النسبة المئوية للخصم في العرض الترويجي 1000000 = 100%. يجب إدخال إما هذا المبلغ أو مبلغ FinanceAmount.
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، بشكل شامل. يجب أن يتراوح طول كل قيمة بين حرف واحد و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)

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

string

إجراء الإحالة الناجحة المطلوب إسناد إحالة ناجحة عبر الاتصال إليه. وفي حال تم تركها بدون ضبط، يتم استخدام إجراء الإحالة الناجحة التلقائي. لن يكون لهذا الحقل تأثير إلا في حال ضبط callConversionReportingState على USE_Resource_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

عرض سعر واحد ضمن مادة عرض السعر

تمثيل 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

مطلوبة. اسم النشاط، مثل Boulevard Bungalow مطلوبة.
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

رقم التعريف 2 الذي يمكن أن يكون أي تسلسل من الأحرف والأرقام، مثل الأحمر. يجب أن يكون تسلسل أرقام التعريف (رقم التعريف + رقم التعريف 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

السعر المخفَّض المنسَّق الذي يمكن أن يكون بأي أحرف. في حال ضبطها، سيتم استخدام هذه السمة بدلاً من سمة "السعر المخفَّض"، على سبيل المثال: سعر مخفَّض بقيمة 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

السعر المخفَّض المنسَّق الذي يمكن أن يكون بأي أحرف. في حال ضبطها، سيتم استخدام هذه السمة بدلاً من "السعر المخفَّض"، على سبيل المثال، سعر مخفَّض بقيمة 80.00 ريال سعودي.
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

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

string (int64 format)

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

string

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

string

حقل مخصّص يمكن أن يكون عدة مفاتيح لتعيين قيم مفصولة بمحدِّدات (",", "|" و":")، على شكل ": , , ... , | : , ... , | ... | : , ... ," على سبيل المثال، شبكة Wi-Fi: معظم | الطائرة: 320، 77W | رحلات جوية: 43 | ..

DiscoveryCarouselCardAsset

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

تمثيل 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

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

string

الفئة، مثل "النسخ الاحتياطي السريع".
contextualKeywords[]

string

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

string

أرقام تعريف الوجهات المتشابهة، مثل NYC.
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

السعر المخفَّض المنسَّق الذي يمكن أن يكون بأي أحرف. في حال ضبطها، سيتم استخدام هذه السمة بدلاً من "السعر المخفَّض"، على سبيل المثال، سعر مخفَّض بقيمة 80.00 ريال سعودي.
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

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

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

string

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

string

رمز متجر "الملف التجاري" لهذا الموقع الجغرافي وتتم مزامنة هذه البيانات من حساب "الملف التجاري".
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

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