ExtensionFeedItem

عنصر خلاصة للإضافة.

تمثيل JSON 
{
  "resourceName": string,
  "extensionType": enum (ExtensionType),
  "adSchedules": [
    {
      object (AdScheduleInfo)
    }
  ],
  "device": enum (FeedItemTargetDevice),
  "targetedKeyword": {
    object (KeywordInfo)
  },
  "status": enum (FeedItemStatus),
  "id": string,
  "startDateTime": string,
  "endDateTime": string,
  "targetedGeoTargetConstant": string,

  // Union field extension can be only one of the following:
  "sitelinkFeedItem": {
    object (SitelinkFeedItem)
  },
  "structuredSnippetFeedItem": {
    object (StructuredSnippetFeedItem)
  },
  "appFeedItem": {
    object (AppFeedItem)
  },
  "callFeedItem": {
    object (CallFeedItem)
  },
  "calloutFeedItem": {
    object (CalloutFeedItem)
  },
  "textMessageFeedItem": {
    object (TextMessageFeedItem)
  },
  "priceFeedItem": {
    object (PriceFeedItem)
  },
  "promotionFeedItem": {
    object (PromotionFeedItem)
  },
  "locationFeedItem": {
    object (LocationFeedItem)
  },
  "affiliateLocationFeedItem": {
    object (AffiliateLocationFeedItem)
  },
  "hotelCalloutFeedItem": {
    object (HotelCalloutFeedItem)
  },
  "imageFeedItem": {
    object (ImageFeedItem)
  }
  // End of list of possible types for union field extension.

  // Union field serving_resource_targeting can be only one of the following:
  "targetedCampaign": string,
  "targetedAdGroup": string
  // End of list of possible types for union field serving_resource_targeting.
}
الحقول
resourceName

string

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

customers/{customerId}/extensionFeedItems/{feed_item_id}
extensionType

enum (ExtensionType)

النتائج فقط. نوع الإضافة لعنصر خلاصة الإضافة. هذا الحقل للقراءة فقط.
adSchedules[]

object (AdScheduleInfo)

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

enum (FeedItemTargetDevice)

الجهاز المستهدف
targetedKeyword

object (KeywordInfo)

الكلمة الرئيسية المستهدفة.
status

enum (FeedItemStatus)

النتائج فقط. حالة عنصر الخلاصة. هذا الحقل للقراءة فقط.
id

string (int64 format)

النتائج فقط. رقم تعريف هذا العنصر في الخلاصة. للقراءة فقط.
startDateTime

string

وقت البدء الذي يكون فيه العنصر هذا في الخلاصة فعّالاً ويمكن بدء عرضه. الوقت حسب المنطقة الزمنية للعميل. التنسيق هو "YYYY-MM-DD HH:MM:SS". أمثلة: "2018-03-05 09:15:00" أو "2018-02-01 14:34:30"
endDateTime

string

وقت الانتهاء الذي لم يعُد فيه هذا العنصر في الخلاصة فعّالاً وسيتوقّف عن عرض الإعلانات الوقت حسب المنطقة الزمنية للعميل. التنسيق هو "YYYY-MM-DD HH:MM:SS". أمثلة: "2018-03-05 09:15:00" أو "2018-02-01 14:34:30"
targetedGeoTargetConstant

string

ثابت الهدف الجغرافي المستهدف.
حقل الاتحاد extension نوع الإضافة. يمكن أن تكون السمة "extension" واحدة فقط مما يلي:
structuredSnippetFeedItem

object (StructuredSnippetFeedItem)

إضافة مقتطفات منظمة.
appFeedItem

object (AppFeedItem)

إضافة التطبيق.
callFeedItem

object (CallFeedItem)

إضافة المكالمة.
calloutFeedItem

object (CalloutFeedItem)

إضافة وسائل الشرح.
textMessageFeedItem

object (TextMessageFeedItem)

إضافة الرسائل النصية
priceFeedItem

object (PriceFeedItem)

معلومات السعر الإضافية.
promotionFeedItem

object (PromotionFeedItem)

إضافة عروض ترويجية.
locationFeedItem

object (LocationFeedItem)

النتائج فقط. إضافة موقع جغرافي. تتم مزامنة المواقع الجغرافية من الملف التجاري مع خلاصة. هذا الحقل للقراءة فقط.
affiliateLocationFeedItem

object (AffiliateLocationFeedItem)

النتائج فقط. إضافة موقع المعلن. تتم تعبئة المواقع الجغرافية للخلاصات من خلال "إعلانات Google" استنادًا إلى رقم تعريف السلسلة. هذا الحقل للقراءة فقط.
hotelCalloutFeedItem

object (HotelCalloutFeedItem)

إضافة وسائل شرح الفنادق.
imageFeedItem

object (ImageFeedItem)

غير قابل للتغيير. إضافة صور قدَّمها المعلِن
حقل الاتحاد serving_resource_targeting الاستهداف إما على مستوى الحملة أو المجموعة الإعلانية. لن يتم عرض عناصر الخلاصة التي تستهدف حملة أو مجموعة إعلانية إلا باستخدام هذا المورد. يمكن أن تكون السمة "serving_resource_targeting" واحدة فقط مما يلي:
targetedCampaign

string

الحملة المستهدفة.
targetedAdGroup

string

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

StructuredSnippetFeedItem

يمثل إضافة مقتطفات من الموقع.

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

string

القيم في المقتطف. الحدّ الأقصى لحجم هذه المجموعة هو 10.
header

string

تمثّل هذه السمة عنوان المقتطف. يجب ألا تكون هذه السلسلة فارغة.

AppFeedItem

يمثل إضافة تطبيق.

تمثيل JSON 
{
  "appStore": enum (AppStore),
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "linkText": string,
  "appId": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string
}
الحقول
appStore

enum (AppStore)

متجر التطبيقات الذي ينتمي إليه التطبيق المُستهدف. هذا الحقل مطلوب.
finalUrls[]

string

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

string

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

object (CustomParameter)

قائمة بالتعيينات التي تُستخدَم لاستبدال علامات المَعلمات المخصَّصة لعناوين URL في traceUrlTemplate و/أو finalUrls و/أو finalMobileUrls.
linkText

string

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

string

رقم التعريف الخاص بالمتجر للتطبيق المُستهدف. يجب ألا تكون هذه السلسلة فارغة.
trackingUrlTemplate

string

نموذج عنوان URL لإنشاء عنوان URL للتتبّع. القيمة التلقائية هي "{lpurl}".
finalUrlSuffix

string

نموذج عنوان 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

string

اسم النشاط التجاري الذي سيتم إرفاقه في بداية نص الرسالة. هذا الحقل مطلوب.
countryCode

string

رمز بلد من حرفين كبير لرقم هاتف المعلن. هذا الحقل مطلوب.
phoneNumber

string

رقم هاتف المعلن التي سيتم إرسال الرسالة إليه. مطلوبة.
text

string

النص المطلوب عرضه في الإعلان. هذا الحقل مطلوب.
extensionText

string

نص إضافة الرسائل الذي تمت تعبئته في تطبيق المراسلة.

PriceFeedItem

يمثل معلومات السعر الإضافية.

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

enum (PriceExtensionType)

نوع معلومات السعر الإضافية لهذه الإضافة.
priceQualifier

enum (PriceExtensionPriceQualifier)

مؤهِّل السعر لجميع العروض المتعلقة بمعلومات السعر الإضافية هذه.
priceOfferings[]

object (PriceOffer)

عروض الأسعار في معلومات السعر الإضافية هذه.
trackingUrlTemplate

string

نموذج عنوان URL للتتبع لجميع العروض المتعلقة بمعلومات السعر الإضافية هذه.
languageCode

string

رمز اللغة المستخدمة في معلومات السعر الإضافية هذه.
finalUrlSuffix

string

نموذج عنوان URL للتتبع لجميع العروض المتعلقة بمعلومات السعر الإضافية هذه.

PriceOffer

يمثل عرض سعر واحدًا في معلومات السعر الإضافية.

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

object (Money)

قيمة السعر لهذا العرض
unit

enum (PriceExtensionPriceUnit)

وحدة السعر لهذا العرض
finalUrls[]

string

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

string

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

string

نص العنوان لهذا العرض الترويجي
description

string

نص الوصف لهذا العرض.

PromotionFeedItem

يمثِّل إضافة عروض ترويجية.

تمثيل JSON 
{
  "discountModifier": enum (PromotionExtensionDiscountModifier),
  "occasion": enum (PromotionExtensionOccasion),
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "promotionTarget": string,
  "promotionStartDate": string,
  "promotionEndDate": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string,
  "languageCode": string,

  // 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.
}
الحقول
discountModifier

enum (PromotionExtensionDiscountModifier)

يشير إلى قيمة تعداد تعدِّل أهلية الخصم.
occasion

enum (PromotionExtensionOccasion)

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

string

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

string

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

object (CustomParameter)

قائمة بالتعيينات التي تُستخدَم لاستبدال علامات المَعلمات المخصَّصة لعناوين URL في traceUrlTemplate و/أو finalUrls و/أو finalMobileUrls.
promotionTarget

string

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

string

هو تاريخ البدء الذي يكون فيه العرض الترويجي مؤهلاً للاستفادة منه.
promotionEndDate

string

هو التاريخ الأخير الذي يكون فيه العرض الترويجي مؤهّلاً للاستفادة منه.
trackingUrlTemplate

string

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

string

نموذج عنوان URL لإلحاق المَعلمات بعناوين URL للصفحات المقصودة التي يتم عرضها من خلال التتبُّع الموازي
languageCode

string

لغة العرض الترويجي. ويمثلها علامة BCP 47 اللغوية.
حقل الاتحاد discount_type نوع الخصم، يمكن أن يشير إلى خصم بنسبة مئوية أو مبلغ خصم. يمكن أن يكون discount_type واحدًا مما يلي فقط:
percentOff

string (int64 format)

النسبة المئوية للخصم في العرض الترويجي بالمايكرو. المليون تساوي واحد في المئة. يجب إما هذا المبلغ أو مبلغ المال_off_amount.
moneyAmountOff

object (Money)

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

string

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

object (Money)

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

LocationFeedItem

يمثل إضافة موقع.

تمثيل JSON 
{
  "businessName": string,
  "addressLine1": string,
  "addressLine2": string,
  "city": string,
  "province": string,
  "postalCode": string,
  "countryCode": string,
  "phoneNumber": string
}
الحقول
businessName

string

اسم النشاط التجاري.
addressLine1

string

السطر 1 من عنوان النشاط التجاري.
addressLine2

string

السطر 2 من عنوان النشاط التجاري.
city

string

المدينة التي يقع فيها عنوان النشاط التجاري
province

string

المقاطعة التي يقع فيها عنوان النشاط التجاري.
postalCode

string

الرمز البريدي لعنوان النشاط التجاري.
countryCode

string

رمز بلد عنوان النشاط التجاري.
phoneNumber

string

رقم هاتف النشاط التجاري

AffiliateLocationFeedItem

يُمثِّل إضافة موقع معلن.

تمثيل JSON 
{
  "businessName": string,
  "addressLine1": string,
  "addressLine2": string,
  "city": string,
  "province": string,
  "postalCode": string,
  "countryCode": string,
  "phoneNumber": string,
  "chainId": string,
  "chainName": string
}
الحقول
businessName

string

اسم النشاط التجاري.
addressLine1

string

السطر 1 من عنوان النشاط التجاري.
addressLine2

string

السطر 2 من عنوان النشاط التجاري.
city

string

المدينة التي يقع فيها عنوان النشاط التجاري
province

string

المقاطعة التي يقع فيها عنوان النشاط التجاري.
postalCode

string

الرمز البريدي لعنوان النشاط التجاري.
countryCode

string

رمز بلد عنوان النشاط التجاري.
phoneNumber

string

رقم هاتف النشاط التجاري
chainId

string (int64 format)

معرّف سلسلة البيع بالتجزئة التي يتم الإعلان عنها كبائع لمنتجك
chainName

string

اسم السلسلة.

HotelCalloutFeedItem

تُمثِّل إضافة وسائل شرح للفنادق.

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

string

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

string

لغة نص وسيلة الشرح للفندق. رمز اللغة المتوافق مع معيار IETF BCP 47

ImageFeedItem

يُمثِّل ذلك إضافة بصرية يقدِّمها المعلِن.

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

string

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