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)

เอาต์พุตเท่านั้น ส่วนขยายสถานที่ตั้ง สถานที่ตั้งจะซิงค์จาก Business Profile ไปยังฟีด ช่องนี้เป็นแบบอ่านอย่างเดียว
affiliateLocationFeedItem

object (AffiliateLocationFeedItem)

เอาต์พุตเท่านั้น ส่วนขยายสถานที่ตั้งของแอฟฟิลิเอต สถานที่ตั้งฟีดจะสร้างขึ้นโดย Google Ads โดยอิงตามรหัสเชน ช่องนี้เป็นแบบอ่านอย่างเดียว
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 ใน TrackingUrlTemplate,finalUrls และ/หรือFinalMobileUrls
linkText

string

ข้อความที่มองเห็นได้ซึ่งแสดงเมื่อมีการแสดงลิงก์ในโฆษณา สตริงนี้ต้องไม่ว่างเปล่า และความยาวของสตริงนี้ควรอยู่ระหว่าง 1 ถึง 25
appId

string

รหัสเฉพาะร้านค้าสำหรับแอปพลิเคชันเป้าหมาย ต้องระบุสตริงนี้
trackingUrlTemplate

string

เทมเพลต URL สำหรับการสร้าง URL ติดตาม ค่าเริ่มต้นคือ "{lpurl}"
finalUrlSuffix

string

เทมเพลต URL สำหรับการเพิ่มพารามิเตอร์ต่อท้าย URL ของหน้า Landing Page ที่แสดงพร้อมการติดตามพร้อมกัน

AppStore

ประเภท App Store ในส่วนขยายแอป

Enum
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

รหัสประเทศที่เป็นตัวอักษร 2 ตัวตัวพิมพ์ใหญ่ของหมายเลขโทรศัพท์ของผู้ลงโฆษณา ต้องระบุฟิลด์นี้
phoneNumber

string

หมายเลขโทรศัพท์ของผู้ลงโฆษณาที่จะส่งข้อความถึง ต้องระบุ
text

string

ข้อความที่จะแสดงในโฆษณา ต้องระบุฟิลด์นี้
extensionText

string

ส่วนขยายข้อความText ที่สร้างไว้ในแอปรับส่งข้อความ

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 ใน TrackingUrlTemplate,finalUrls และ/หรือFinalMobileUrls
promotionTarget

string

คำอธิบายรูปแบบอิสระของการกำหนดเป้าหมายโปรโมชัน ต้องระบุฟิลด์นี้
promotionStartDate

string

วันที่เริ่มต้นของโปรโมชันที่มีสิทธิ์แลกรับได้
promotionEndDate

string

วันสุดท้ายที่คุณมีสิทธิ์แลกรับโปรโมชัน
trackingUrlTemplate

string

เทมเพลต URL สำหรับการสร้าง URL ติดตาม
finalUrlSuffix

string

เทมเพลต URL สำหรับการเพิ่มพารามิเตอร์ต่อท้าย URL ของหน้า Landing Page ที่แสดงพร้อมการติดตามพร้อมกัน
languageCode

string

ภาษาของโปรโมชัน แสดงเป็นแท็กภาษา BCP 47
ฟิลด์สหภาพ discount_type ประเภทส่วนลด อาจเป็นส่วนลดเป็นเปอร์เซ็นต์หรือส่วนลดเป็นจำนวนเงินก็ได้ discount_type ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
percentOff

string (int64 format)

เปอร์เซ็นต์ส่วนลดในโปรโมชันในระดับไมโคร 1 ล้านเท่ากับ 1 เปอร์เซ็นต์ ต้องระบุจำนวนเงินนี้หรือจำนวนเงินส่วนลด [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

ต้องระบุ ชื่อทรัพยากรของชิ้นงานรูปภาพ