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 و/أو lastMobileUrls.
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 و/أو lastMobileUrls.
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

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