- تمثيل JSON
- StructuredSnippetFeedItem
- AppFeedItem
- AppStore
- TextMessageFeedItem
- PriceFeedItem
- PriceOffer
- PromotionFeedItem
- LocationFeedItem
- AffiliateLocationFeedItem
- HotelCalloutFeedItem
- ImageFeedItem
عنصر خلاصة للإضافة.
تمثيل JSON |
---|
{ "resourceName": string, "extensionType": enum ( |
الحقول | |
---|---|
resourceName |
غير قابل للتغيير. اسم المورد لعنصر الخلاصة في الإضافة. تكون أسماء موارد عناصر الإضافة في الخلاصة على النحو التالي:
|
extensionType |
النتائج فقط. نوع الإضافة لعنصر خلاصة الإضافة. هذا الحقل للقراءة فقط. |
adSchedules[] |
قائمة بالجداول الزمنية غير المتداخلة التي تحدّد جميع الفترات الزمنية التي قد يتم عرض عنصر الخلاصة فيها. يمكن إضافة 6 جداول زمنية كحدّ أقصى في اليوم. |
device |
الجهاز المستهدف |
targetedKeyword |
الكلمة الرئيسية المستهدفة. |
status |
النتائج فقط. حالة عنصر الخلاصة. هذا الحقل للقراءة فقط. |
id |
النتائج فقط. رقم تعريف هذا العنصر في الخلاصة. للقراءة فقط. |
startDateTime |
وقت البدء الذي يكون فيه العنصر هذا في الخلاصة فعّالاً ويمكن بدء عرضه. الوقت حسب المنطقة الزمنية للعميل. التنسيق هو "YYYY-MM-DD HH:MM:SS". أمثلة: "2018-03-05 09:15:00" أو "2018-02-01 14:34:30" |
endDateTime |
وقت الانتهاء الذي لم يعُد فيه هذا العنصر في الخلاصة فعّالاً وسيتوقّف عن عرض الإعلانات الوقت حسب المنطقة الزمنية للعميل. التنسيق هو "YYYY-MM-DD HH:MM:SS". أمثلة: "2018-03-05 09:15:00" أو "2018-02-01 14:34:30" |
targetedGeoTargetConstant |
ثابت الهدف الجغرافي المستهدف. |
حقل الاتحاد extension نوع الإضافة. يمكن أن تكون السمة "extension " واحدة فقط مما يلي: |
|
sitelinkFeedItem |
رابط أقسام الموقع. |
structuredSnippetFeedItem |
إضافة مقتطفات منظمة. |
appFeedItem |
إضافة التطبيق. |
callFeedItem |
إضافة المكالمة. |
calloutFeedItem |
إضافة وسائل الشرح. |
textMessageFeedItem |
إضافة الرسائل النصية |
priceFeedItem |
معلومات السعر الإضافية. |
promotionFeedItem |
إضافة عروض ترويجية. |
locationFeedItem |
النتائج فقط. إضافة موقع جغرافي. تتم مزامنة المواقع الجغرافية من الملف التجاري مع خلاصة. هذا الحقل للقراءة فقط. |
affiliateLocationFeedItem |
النتائج فقط. إضافة موقع المعلن. تتم تعبئة المواقع الجغرافية للخلاصات من خلال "إعلانات Google" استنادًا إلى رقم تعريف السلسلة. هذا الحقل للقراءة فقط. |
hotelCalloutFeedItem |
إضافة وسائل شرح الفنادق. |
imageFeedItem |
غير قابل للتغيير. إضافة صور قدَّمها المعلِن |
حقل الاتحاد serving_resource_targeting الاستهداف إما على مستوى الحملة أو المجموعة الإعلانية. لن يتم عرض عناصر الخلاصة التي تستهدف حملة أو مجموعة إعلانية إلا باستخدام هذا المورد. يمكن أن تكون السمة "serving_resource_targeting " واحدة فقط مما يلي: |
|
targetedCampaign |
الحملة المستهدفة. |
targetedAdGroup |
المجموعة الإعلانية المستهدفة. |
StructuredSnippetFeedItem
يمثل إضافة مقتطفات من الموقع.
تمثيل JSON |
---|
{ "values": [ string ], "header": string } |
الحقول | |
---|---|
values[] |
القيم في المقتطف. الحدّ الأقصى لحجم هذه المجموعة هو 10. |
header |
تمثّل هذه السمة عنوان المقتطف. يجب ألا تكون هذه السلسلة فارغة. |
AppFeedItem
يمثل إضافة تطبيق.
تمثيل JSON |
---|
{ "appStore": enum ( |
الحقول | |
---|---|
appStore |
متجر التطبيقات الذي ينتمي إليه التطبيق المُستهدف. هذا الحقل مطلوب. |
finalUrls[] |
قائمة بعناوين URL النهائية المحتملة بعد جميع عمليات إعادة التوجيه عبر النطاقات. يجب ألا تكون هذه القائمة فارغة. |
finalMobileUrls[] |
قائمة بعناوين URL النهائية المحتملة للأجهزة الجوّالة بعد جميع عمليات إعادة التوجيه عبر النطاقات. |
urlCustomParameters[] |
قائمة بالتعيينات التي تُستخدَم لاستبدال علامات المَعلمات المخصَّصة لعناوين URL في traceUrlTemplate و/أو finalUrls و/أو finalMobileUrls. |
linkText |
النص المرئي الذي يتم عرضه عند عرض الرابط في أحد الإعلانات. يجب ألا تكون هذه السلسلة فارغة، ويجب أن يتراوح طول هذه السلسلة بين 1 و25، بشكل شامل. |
appId |
رقم التعريف الخاص بالمتجر للتطبيق المُستهدف. يجب ألا تكون هذه السلسلة فارغة. |
trackingUrlTemplate |
نموذج عنوان URL لإنشاء عنوان URL للتتبّع. القيمة التلقائية هي "{lpurl}". |
finalUrlSuffix |
نموذج عنوان URL لإلحاق المَعلمات بعناوين URL للصفحات المقصودة التي يتم عرضها من خلال التتبُّع الموازي |
AppStore
نوع متجر التطبيقات في إضافة التطبيق.
عمليات التعداد | |
---|---|
UNSPECIFIED |
غير محدَّد. |
UNKNOWN |
يُستخدم للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار. |
APPLE_ITUNES |
Apple iTunes. |
GOOGLE_PLAY |
Google Play. |
TextMessageFeedItem
إضافة يمكن للمستخدمين النقر عليها لإرسال رسالة نصية إلى المعلن.
تمثيل JSON |
---|
{ "businessName": string, "countryCode": string, "phoneNumber": string, "text": string, "extensionText": string } |
الحقول | |
---|---|
businessName |
اسم النشاط التجاري الذي سيتم إرفاقه في بداية نص الرسالة. هذا الحقل مطلوب. |
countryCode |
رمز بلد من حرفين كبير لرقم هاتف المعلن. هذا الحقل مطلوب. |
phoneNumber |
رقم هاتف المعلن التي سيتم إرسال الرسالة إليه. مطلوبة. |
text |
النص المطلوب عرضه في الإعلان. هذا الحقل مطلوب. |
extensionText |
نص إضافة الرسائل الذي تمت تعبئته في تطبيق المراسلة. |
PriceFeedItem
يمثل معلومات السعر الإضافية.
تمثيل JSON |
---|
{ "type": enum ( |
الحقول | |
---|---|
type |
نوع معلومات السعر الإضافية لهذه الإضافة. |
priceQualifier |
مؤهِّل السعر لجميع العروض المتعلقة بمعلومات السعر الإضافية هذه. |
priceOfferings[] |
عروض الأسعار في معلومات السعر الإضافية هذه. |
trackingUrlTemplate |
نموذج عنوان URL للتتبع لجميع العروض المتعلقة بمعلومات السعر الإضافية هذه. |
languageCode |
رمز اللغة المستخدمة في معلومات السعر الإضافية هذه. |
finalUrlSuffix |
نموذج عنوان URL للتتبع لجميع العروض المتعلقة بمعلومات السعر الإضافية هذه. |
PriceOffer
يمثل عرض سعر واحدًا في معلومات السعر الإضافية.
تمثيل JSON |
---|
{ "price": { object ( |
الحقول | |
---|---|
price |
قيمة السعر لهذا العرض |
unit |
وحدة السعر لهذا العرض |
finalUrls[] |
قائمة بعناوين URL النهائية المحتملة بعد جميع عمليات إعادة التوجيه عبر النطاقات. |
finalMobileUrls[] |
قائمة بعناوين URL النهائية المحتملة للأجهزة الجوّالة بعد جميع عمليات إعادة التوجيه عبر النطاقات. |
header |
نص العنوان لهذا العرض الترويجي |
description |
نص الوصف لهذا العرض. |
PromotionFeedItem
يمثِّل إضافة عروض ترويجية.
تمثيل JSON |
---|
{ "discountModifier": enum ( |
الحقول | |
---|---|
discountModifier |
يشير إلى قيمة تعداد تعدِّل أهلية الخصم. |
occasion |
المناسبة التي استهدفها العرض الترويجي إذا تم تحديد مناسبة، يجب أن تقع فترة تحصيل القيمة ضمن النطاق الزمني المرتبط بهذه المناسبة. |
finalUrls[] |
قائمة بعناوين URL النهائية المحتملة بعد جميع عمليات إعادة التوجيه عبر النطاقات. هذا الحقل مطلوب. |
finalMobileUrls[] |
قائمة بعناوين URL النهائية المحتملة للأجهزة الجوّالة بعد جميع عمليات إعادة التوجيه عبر النطاقات. |
urlCustomParameters[] |
قائمة بالتعيينات التي تُستخدَم لاستبدال علامات المَعلمات المخصَّصة لعناوين URL في traceUrlTemplate و/أو finalUrls و/أو finalMobileUrls. |
promotionTarget |
وصف بتنسيق حر للمحتوى الذي يستهدفه العرض الترويجي هذا الحقل مطلوب. |
promotionStartDate |
هو تاريخ البدء الذي يكون فيه العرض الترويجي مؤهلاً للاستفادة منه. |
promotionEndDate |
هو التاريخ الأخير الذي يكون فيه العرض الترويجي مؤهّلاً للاستفادة منه. |
trackingUrlTemplate |
نموذج عنوان URL لإنشاء عنوان URL للتتبّع. |
finalUrlSuffix |
نموذج عنوان URL لإلحاق المَعلمات بعناوين URL للصفحات المقصودة التي يتم عرضها من خلال التتبُّع الموازي |
languageCode |
لغة العرض الترويجي. ويمثلها علامة BCP 47 اللغوية. |
حقل الاتحاد discount_type نوع الخصم، يمكن أن يشير إلى خصم بنسبة مئوية أو مبلغ خصم. يمكن أن يكون discount_type واحدًا مما يلي فقط: |
|
percentOff |
النسبة المئوية للخصم في العرض الترويجي بالمايكرو. المليون تساوي واحد في المئة. يجب إما هذا المبلغ أو مبلغ المال_off_amount. |
moneyAmountOff |
المبلغ المالي للخصم في العرض الترويجي يجب إما تحديد قيمة هذه السمة أو نسبة مئوية معينة. |
حقل الاتحاد promotion_trigger مشغِّل الترويج يمكن استخدام الرمز الترويجي أو العرض الترويجي حسب مبلغ الطلب المؤهَّل. يمكن أن تكون السمة "promotion_trigger " واحدة فقط مما يلي: |
|
promotionCode |
رمز يجب أن يستخدمه المستخدم ليكون مؤهلاً للاستفادة من العرض الترويجي. |
ordersOverAmount |
المبلغ الإجمالي الذي يجب أن يستوفيه المستخدم ليكون مؤهلاً للاستفادة من العرض الترويجي |
LocationFeedItem
يمثل إضافة موقع.
تمثيل JSON |
---|
{ "businessName": string, "addressLine1": string, "addressLine2": string, "city": string, "province": string, "postalCode": string, "countryCode": string, "phoneNumber": string } |
الحقول | |
---|---|
businessName |
اسم النشاط التجاري. |
addressLine1 |
السطر 1 من عنوان النشاط التجاري. |
addressLine2 |
السطر 2 من عنوان النشاط التجاري. |
city |
المدينة التي يقع فيها عنوان النشاط التجاري |
province |
المقاطعة التي يقع فيها عنوان النشاط التجاري. |
postalCode |
الرمز البريدي لعنوان النشاط التجاري. |
countryCode |
رمز بلد عنوان النشاط التجاري. |
phoneNumber |
رقم هاتف النشاط التجاري |
AffiliateLocationFeedItem
يُمثِّل إضافة موقع معلن.
تمثيل JSON |
---|
{ "businessName": string, "addressLine1": string, "addressLine2": string, "city": string, "province": string, "postalCode": string, "countryCode": string, "phoneNumber": string, "chainId": string, "chainName": string } |
الحقول | |
---|---|
businessName |
اسم النشاط التجاري. |
addressLine1 |
السطر 1 من عنوان النشاط التجاري. |
addressLine2 |
السطر 2 من عنوان النشاط التجاري. |
city |
المدينة التي يقع فيها عنوان النشاط التجاري |
province |
المقاطعة التي يقع فيها عنوان النشاط التجاري. |
postalCode |
الرمز البريدي لعنوان النشاط التجاري. |
countryCode |
رمز بلد عنوان النشاط التجاري. |
phoneNumber |
رقم هاتف النشاط التجاري |
chainId |
معرّف سلسلة البيع بالتجزئة التي يتم الإعلان عنها كبائع لمنتجك |
chainName |
اسم السلسلة. |
HotelCalloutFeedItem
تُمثِّل إضافة وسائل شرح للفنادق.
تمثيل JSON |
---|
{ "text": string, "languageCode": string } |
الحقول | |
---|---|
text |
نص وسيلة الشرح. يجب أن يتراوح طول هذه السلسلة بين 1 و25، بشكل شامل. |
languageCode |
لغة نص وسيلة الشرح للفندق. رمز اللغة المتوافق مع معيار IETF BCP 47 |
ImageFeedItem
يُمثِّل ذلك إضافة بصرية يقدِّمها المعلِن.
تمثيل JSON |
---|
{ "imageAsset": string } |
الحقول | |
---|---|
imageAsset |
مطلوبة. اسم مورد مادة عرض الصورة. |