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)

僅供輸出。此動態饋給項目的 ID。唯讀。
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)

Promotion extension.
locationFeedItem

object (LocationFeedItem)

僅供輸出。地點額外資訊。地點會從商家檔案同步至動態饋給。這是唯讀欄位。
affiliateLocationFeedItem

object (AffiliateLocationFeedItem)

僅供輸出。經銷地點額外資訊。動態饋給地點是由 Google Ads 根據連鎖店 ID 填入。這是唯讀欄位。
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

所有跨網域重新導向後方的可能最終到達網址清單。這份清單不得留空。
finalMobileUrls[]

string

所有跨網域重新導向完成後的最終行動版網址清單。
urlCustomParameters[]

object (CustomParameter)

一份對應清單，用於在追蹤 UrlTemplate、FinalUrls 和/或 finalMobileUrls 中替換網址自訂參數代碼。
linkText

string

連結在廣告中時顯示的文字。此字串不得空白，且該字串的長度必須介於 1 到 25 (含) 之間。
appId

string

目標應用程式的商店專屬 ID。此字串不得空白。
trackingUrlTemplate

string

用來建構追蹤網址的網址範本。預設值為「{lpurl}」。
finalUrlSuffix

string

網址範本，以便將參數附加至使用並行追蹤功能放送的到達網頁網址。

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

這則價格額外資訊所有商品的追蹤網址範本。
languageCode

string

這則價格額外資訊使用的語言代碼。
finalUrlSuffix

string

這則價格額外資訊所有商品的追蹤網址範本。

PriceOffer

代表價格額外資訊中的一項價格優惠。

JSON 表示法 
{
  "price": {
    object (Money)
  },
  "unit": enum (PriceExtensionPriceUnit),
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "header": string,
  "description": string
}
欄位
price

object (Money)

這項優惠的價格值。
unit

enum (PriceExtensionPriceUnit)

這項優惠的價格單位。
finalUrls[]

string

所有跨網域重新導向後方的可能最終到達網址清單。
finalMobileUrls[]

string

所有跨網域重新導向完成後的最終行動版網址清單。
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

所有跨網域重新導向後方的可能最終到達網址清單。這是必填欄位。
finalMobileUrls[]

string

所有跨網域重新導向完成後的最終行動版網址清單。
urlCustomParameters[]

object (CustomParameter)

一份對應清單，用於在追蹤 UrlTemplate、FinalUrls 和/或 finalMobileUrls 中替換網址自訂參數代碼。
promotionTarget

string

促銷活動指定目標的任意形式說明。這是必填欄位。
promotionStartDate

string

符合兌換促銷活動資格的開始日期。
promotionEndDate

string

最近一次可兌換促銷優惠的日期。
trackingUrlTemplate

string

用來建構追蹤網址的網址範本。
finalUrlSuffix

string

網址範本，以便將參數附加至使用並行追蹤功能放送的到達網頁網址。
languageCode

string

促銷活動的語言。以 BCP 47 語言標記表示。
聯集欄位 discount_type。折扣類型，可設為折扣百分比或金額。「discount_type」只能採用下列其中一種設定：
percentOff

string (int64 format)

促銷活動折扣百分比 (以微秒為單位)。100 萬等於 1%。必須提供此金額或 amount_off_amount。
moneyAmountOff

object (Money)

促銷活動折扣金額。這部分的值只能設為 %Off。
聯集欄位 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)

廣告中宣傳的賣家零售連鎖店 ID。
chainName

string

連鎖店名稱。

HotelCalloutFeedItem

代表飯店摘要額外資訊。

JSON 表示法 
{
  "text": string,
  "languageCode": string
}
欄位
text

string

摘要文字。此字串長度必須介於 1 到 25 (含) 之間。
languageCode

string

飯店摘要文字的語言。符合 IETF BCP 47 的語言代碼。

ImageFeedItem

代表廣告客戶提供的圖片額外資訊。

JSON 表示法 
{
  "imageAsset": string
}
欄位
imageAsset

string

必要欄位。圖片素材資源的資源名稱。