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)

列出要用來在 trackingUrlTemplate、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)

列出要用來在 trackingUrlTemplate、finalUrls 和/或 finalMobileUrls 中替換網址自訂參數標記的對應清單。
promotionTarget

string

說明促銷活動的指定目標 (形式不拘)。這是必填欄位。
promotionStartDate

string

促銷活動可兌換的開始日期。
promotionEndDate

string

促銷活動可兌換的最後一天。
trackingUrlTemplate

string

用於建立追蹤網址的網址範本。
finalUrlSuffix

string

用於將參數附加至透過並行追蹤功能提供的到達網頁網址的網址範本。
languageCode

string

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

string (int64 format)

促銷活動的折扣百分比，以微量為單位。一百萬等於百分之 1必須提供此金額或 refund_off_amount。
moneyAmountOff

object (Money)

促銷活動折扣金額。必須提供此值或 percentOff。
聯集欄位 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

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