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)

一份對應清單，用於替換 trackUrlTemplate、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)

一份對應清單，用於替換 trackUrlTemplate、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 萬相當於百分之一。必須提供這筆金額或 pay_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

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