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)

Application Store ที่มีแอปพลิเคชันเป้าหมายอยู่ ต้องระบุฟิลด์นี้
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

ส่วนขยายข้อความของส่วนขยายข้อความจะปรากฏขึ้นในแอปรับส่งข้อความ

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)

Enum ที่แก้ไขคุณสมบัติของส่วนลด
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)

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

รหัสของเชนร้านค้าปลีกที่โฆษณาในฐานะผู้ขายผลิตภัณฑ์ของคุณ
chainName

string

ชื่อเชน

HotelCalloutFeedItem

แสดงส่วนขยายไฮไลต์สำหรับโรงแรม

การแสดง JSON 
{
  "text": string,
  "languageCode": string
}
ช่อง
text

string

ข้อความไฮไลต์ ความยาวของสตริงนี้ควรอยู่ระหว่าง 1 ถึง 25 เท่านั้น
languageCode

string

ภาษาของข้อความไฮไลต์สำหรับโรงแรม รหัสภาษาที่เป็นไปตามมาตรฐาน IETF BCP 47

ImageFeedItem

แสดงส่วนขยายรูปภาพที่ผู้ลงโฆษณาให้ไว้

การแสดง JSON 
{
  "imageAsset": string
}
ช่อง
imageAsset

string

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