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 )

پسوند Callout.

textMessageFeedItem

object ( TextMessageFeedItem )

پسوند پیام متنی

priceFeedItem

object ( PriceFeedItem )

تمدید قیمت.

promotionFeedItem

object ( PromotionFeedItem )

تمدید تبلیغات.

locationFeedItem

object ( LocationFeedItem )

فقط خروجی پسوند مکان. مکان‌ها از نمایه کسب‌وکار در فید همگام‌سازی می‌شوند. این فیلد فقط خواندنی است.

affiliateLocationFeedItem

object ( AffiliateLocationFeedItem )

فقط خروجی پسوند مکان وابسته مکان‌های فید توسط Google Ads بر اساس شناسه زنجیره‌ای پر می‌شوند. این فیلد فقط خواندنی است.

hotelCalloutFeedItem

object ( HotelCalloutFeedItem )

برنامه افزودنی هتل Callout.

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 در trackingUrlTemplate، finalUrls و/یا finalMobileUrls استفاده می شود.

linkText

string

متن قابل مشاهده که هنگام نمایش پیوند در یک آگهی نمایش داده می شود. این رشته نباید خالی باشد و طول این رشته باید بین 1 تا 25 باشد.

appId

string

شناسه مخصوص فروشگاه برای برنامه هدف. این رشته نباید خالی باشد.

trackingUrlTemplate

string

قالب URL برای ساخت URL ردیابی. مقدار پیش فرض "{lpurl}" است.

finalUrlSuffix

string

الگوی URL برای الحاق پارامترها به URLهای صفحه فرود که با ردیابی موازی ارائه می شوند.

AppStore

فروشگاه App در یک برنامه افزودنی تایپ کنید.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است.
APPLE_ITUNES اپل آیتونز.
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 پیگیری برای همه پیشنهادات این پسوند قیمت.

پیشنهاد قیمت

نشان دهنده یک پیشنهاد قیمت در یک پسوند قیمت است.

نمایندگی 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 در trackingUrlTemplate، 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)

درصد تخفیف در تبلیغات در میکرو. یک میلیون معادل یک درصد است. این یا money_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

ضروری. نام منبع دارایی تصویر.