LineItem

รายการโฆษณา 1 รายการมีประเภทธุรกิจ 1 รายการ คำสั่งซื้อหรือรถเข็นอาจมีรายการโฆษณาแนวตั้งหลายรายการ ควรกำหนดรายการโฆษณาย่อย/ส่วนเสริม ฯลฯ ในโปรโตแนวตั้งโดยขึ้นอยู่กับกรณีการใช้งาน หมายเหตุ: 1. สตริงทั้งหมดในทุกระดับต้องมีอักขระน้อยกว่า 1,000 ตัว เว้นแต่จะระบุไว้เป็นอย่างอื่น 2. ช่องที่ซ้ำทั้งหมดในทุกระดับต้องมีจำนวนน้อยกว่า 50 รายการ เว้นแต่จะระบุไว้เป็นอย่างอื่น 3. หากระบุไว้ การประทับเวลาทั้งหมดในทุกระดับจะต้องเป็นการประทับเวลาที่ถูกต้อง

การแสดง JSON 
{
  "id": string,
  "name": string,
  "userVisibleStateLabel": string,
  "provider": {
    object (Merchant)
  },
  "priceAttributes": [
    {
      object (PriceAttribute)
    }
  ],
  "followUpActions": [
    {
      object (Action)
    }
  ],
  "recipients": [
    {
      object (UserInfo)
    }
  ],
  "image": {
    object (Image)
  },
  "description": string,
  "notes": [
    string
  ],
  "disclosures": [
    {
      object (Disclosure)
    }
  ],
  "vertical": {
    "@type": string,
    field1: ...,
    ...
  },

  // Union field verticals can be only one of the following:
  "purchase": {
    object (PurchaseItemExtension)
  },
  "reservation": {
    object (ReservationItemExtension)
  }
  // End of list of possible types for union field verticals.
}
ช่อง
id

string

ต้องระบุ: ตัวระบุที่ผู้ขายกำหนดสำหรับรายการโฆษณา ใช้เพื่อระบุรายการโฆษณาที่มีอยู่ในการนำการอัปเดตบางส่วนไปใช้ ความยาวสูงสุดคือ 64 อักขระ
name

string

ชื่อบรรทัดรายการตามที่แสดงในใบเสร็จ ความยาวสูงสุดคือ 100 อักขระ
userVisibleStateLabel
(deprecated)

string

เลิกใช้งานแล้ว โปรดใช้สถานะระดับแนวตั้งแทน เช่น ใช้ PurchaseOrderExtension.status สำหรับการซื้อ ป้ายกำกับที่ผู้ใช้มองเห็นได้สำหรับสถานะของรายการโฆษณานี้
provider

object (Merchant)

ผู้ให้บริการของรายการโฆษณาหนึ่งๆ หากแตกต่างจากคำสั่งซื้อโดยรวม ตัวอย่าง: คำสั่งซื้อด้วย ANA ผู้ให้บริการรายการโฆษณาของ Expedia
priceAttributes[]

object (PriceAttribute)

ราคาและการปรับระดับรายการโฆษณา
followUpActions[]

object (Action)

ติดตามผลการดำเนินการที่รายการโฆษณา
recipients[]

object (UserInfo)

ลูกค้าระดับรายการโฆษณา ซึ่งไม่ใช่ผู้ซื้อระดับคำสั่งซื้อ ตัวอย่าง: ผู้ใช้ X จองร้านอาหารโดยใช้ชื่อผู้ใช้ ข
image

object (Image)

รูปภาพขนาดเล็กที่เชื่อมโยงกับรายการนี้ (หากมี)
description

string

คำอธิบายรายการโฆษณา
notes[]

string

หมายเหตุเพิ่มเติมที่เกี่ยวข้องกับรายการโฆษณานี้ เช่น นโยบายการยกเลิก
disclosures[]

object (Disclosure)

การเปิดเผยข้อมูลที่เชื่อมโยงกับรายการโฆษณานี้
vertical
(deprecated)

object

เลิกใช้งานแล้ว: ใช้ประเภทธุรกิจแทน ต้องระบุ: เนื้อหาเชิงความหมายของรายการโฆษณาตามประเภท/ประเภทธุรกิจ ธุรกิจทุกประเภทควรมีรายละเอียดการดำเนินการตามคำสั่งซื้อของตัวเอง ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้ google.actions.orders.v3.verticals.purchase.PurchaseItemExtension google.actions.orders.v3.verticals.reservation.ReservationItemExtension google.actions.orders.v3.verticals.ticket.TicketItemExtension

ออบเจ็กต์ที่มีช่องประเภทที่กำหนดเอง ช่องเพิ่มเติม "@type" จะมี URI ที่ระบุประเภท ตัวอย่างเช่น { "id": 1234, "@type": "types.example.com/standard/id" }
ช่องการรวม verticals ต้องระบุ: เนื้อหาเชิงความหมายของรายการโฆษณาตามประเภท/ประเภทธุรกิจ ธุรกิจทุกประเภทควรมีรายละเอียดการดำเนินการตามคำสั่งซื้อของตัวเอง verticals ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
purchase

object (PurchaseItemExtension)

คำสั่งซื้อ เช่น สินค้า อาหาร ฯลฯ
reservation

object (ReservationItemExtension)

การสั่งจอง เช่น ร้านอาหาร ตัดผม ฯลฯ

PurchaseItemExtension

เนื้อหาของรายการโฆษณาของประเภทธุรกิจการซื้อ

การแสดง JSON 
{
  "status": enum (PurchaseStatus),
  "userVisibleStatusLabel": string,
  "type": enum (PurchaseType),
  "productId": string,
  "quantity": integer,
  "unitMeasure": {
    object (MerchantUnitMeasure)
  },
  "returnsInfo": {
    object (PurchaseReturnsInfo)
  },
  "fulfillmentInfo": {
    object (PurchaseFulfillmentInfo)
  },
  "itemOptions": [
    {
      object (ItemOption)
    }
  ],
  "extension": {
    "@type": string,
    field1: ...,
    ...
  },
  "productDetails": {
    object (ProductDetails)
  }
}
ช่อง
status

enum (PurchaseStatus)

ต้องระบุ: สถานะระดับรายการโฆษณา
userVisibleStatusLabel

string

จำเป็น: ป้ายกำกับ/สตริงที่มองเห็นได้สำหรับผู้ใช้สำหรับสถานะ ความยาวสูงสุดคือ 50 อักขระ
type

enum (PurchaseType)

ต้องระบุ: ประเภทของการซื้อ
productId
(deprecated)

string

รหัสผลิตภัณฑ์หรือข้อเสนอที่เชื่อมโยงกับรายการโฆษณานี้
quantity

integer

จำนวนสินค้า
unitMeasure

object (MerchantUnitMeasure)

มาตรวัดหน่วย ระบุขนาดของรายการในหน่วยที่เลือก ระบบจะใช้ขนาดร่วมกับราคาที่ใช้งานอยู่เพื่อกำหนดราคาต่อหน่วย
returnsInfo

object (PurchaseReturnsInfo)

แสดงข้อมูลสำหรับรายการโฆษณานี้ หากไม่ได้ตั้งค่า รายการโฆษณานี้จะรับค่าข้อมูลการคืนสินค้าระดับคำสั่งซื้อ
fulfillmentInfo

object (PurchaseFulfillmentInfo)

ข้อมูลการดำเนินการตามรายการโฆษณานี้ หากไม่ได้ตั้งค่า รายการโฆษณานี้จะรับค่าข้อมูลการดำเนินการตามคำสั่งซื้อระดับคำสั่งซื้อ
itemOptions[]

object (ItemOption)

ส่วนเสริมหรือรายการย่อยเพิ่มเติม
extension

object

ฟิลด์พิเศษใดๆ ที่แลกเปลี่ยนระหว่างผู้ขายกับ Google

ออบเจ็กต์ที่มีช่องประเภทที่กำหนดเอง ช่องเพิ่มเติม "@type" จะมี URI ที่ระบุประเภท ตัวอย่างเช่น { "id": 1234, "@type": "types.example.com/standard/id" }
productDetails

object (ProductDetails)

รายละเอียดเกี่ยวกับผลิตภัณฑ์

MerchantUnitMeasure

มาตรวัดราคาต่อหน่วยของผู้ขาย

การแสดง JSON 
{
  "measure": number,
  "unit": enum (Unit)
}
ช่อง
measure

number

ค่า: ตัวอย่าง 1.2
unit

enum (Unit)

หน่วย: ตัวอย่าง POUND, GRAM

ItemOption

แสดงส่วนเสริมหรือรายการย่อย

การแสดง JSON 
{
  "id": string,
  "name": string,
  "prices": [
    {
      object (PriceAttribute)
    }
  ],
  "note": string,
  "quantity": integer,
  "productId": string,
  "subOptions": [
    {
      object (ItemOption)
    }
  ]
}
ช่อง
id

string

สำหรับตัวเลือกที่เป็นสินค้า ให้ระบุรหัสสินค้าที่ไม่ซ้ำกัน
name

string

ชื่อตัวเลือก
prices[]

object (PriceAttribute)

ราคารวมของตัวเลือก
note

string

หมายเหตุที่เกี่ยวข้องกับตัวเลือก
quantity

integer

สำหรับตัวเลือกที่เป็นสินค้า จำนวน
productId

string

รหัสผลิตภัณฑ์หรือข้อเสนอที่เชื่อมโยงกับตัวเลือกนี้
subOptions[]

object (ItemOption)

เพื่อกำหนดตัวเลือกย่อยอื่นๆ ที่ฝังอยู่

ProductDetails

รายละเอียดเกี่ยวกับผลิตภัณฑ์

การแสดง JSON 
{
  "productId": string,
  "gtin": string,
  "plu": string,
  "productType": string,
  "productAttributes": {
    string: string,
    ...
  }
}
ช่อง
productId

string

รหัสผลิตภัณฑ์หรือข้อเสนอที่เชื่อมโยงกับรายการโฆษณานี้
gtin

string

หมายเลขสินค้าการค้าสากลของผลิตภัณฑ์ มีประโยชน์หากไม่มีรหัสข้อเสนอใน Merchant Center ไม่บังคับ
plu

string

รหัสค้นหาราคาหรือที่เรียกกันโดยทั่วไปว่ารหัส PLU, หมายเลข PLU, PLU, รหัสการผลิต หรือฉลากผลิต เป็นระบบตัวเลขที่ใช้ระบุผลิตภัณฑ์จำนวนมากซึ่งจำหน่ายในซูเปอร์มาร์เก็ตและซูเปอร์มาร์เก็ตโดยไม่ซ้ำกัน
productType

string

หมวดหมู่ผลิตภัณฑ์ที่กำหนดโดยผู้ขาย เช่น "หน้าแรก > ร้านขายของชำ > ผลิตภัณฑ์จากนมและ ไข่ > นม > นมเต็ม"
productAttributes

map (key: string, value: string)

รายละเอียดผลิตภัณฑ์ที่ผู้ขายระบุ เช่น { "allergen": "peanut" } มีประโยชน์หากไม่มีรหัสข้อเสนอใน Merchant Center ไม่บังคับ

ออบเจ็กต์ที่มีรายการคู่ "key": value ตัวอย่างเช่น { "name": "wrench", "mass": "1.3kg", "count": "3" }

ReservationItemExtension

เนื้อหาของรายการโฆษณาสำหรับการสั่งซื้อการจอง เช่น ร้านอาหาร การตัดผม ฯลฯ รหัสถัดไป: 15

การแสดง JSON 
{
  "status": enum (ReservationStatus),
  "userVisibleStatusLabel": string,
  "type": enum (ReservationType),
  "reservationTime": {
    object (Time)
  },
  "userAcceptableTimeRange": {
    object (Time)
  },
  "confirmationCode": string,
  "partySize": integer,
  "staffFacilitators": [
    {
      object (StaffFacilitator)
    }
  ],
  "location": {
    object (Location)
  },
  "extension": {
    "@type": string,
    field1: ...,
    ...
  }
}
ช่อง
status

enum (ReservationStatus)

ต้องระบุ: สถานะการจอง
userVisibleStatusLabel

string

จำเป็น: ป้ายกำกับ/สตริงที่มองเห็นได้สำหรับผู้ใช้สำหรับสถานะ ความยาวสูงสุดคือ 50 อักขระ
type

enum (ReservationType)

ประเภทการจอง ยกเลิกการตั้งค่าหากไม่มีตัวเลือกประเภทที่เกี่ยวข้อง
reservationTime

object (Time)

เวลาที่มีการกำหนดเวลาให้บริการ/เหตุการณ์ อาจเป็นช่วงเวลา วันที่ หรือวันที่และเวลาที่แน่นอน
userAcceptableTimeRange

object (Time)

ช่วงเวลาที่ผู้ใช้ยอมรับได้
confirmationCode

string

รหัสยืนยันสำหรับการจองนี้
partySize

integer

จำนวนคน
staffFacilitators[]

object (StaffFacilitator)

ผู้อำนวยความสะดวกพนักงานที่จะให้บริการจอง เช่น ช่างทำผม
location

object (Location)

ตำแหน่งของบริการ/กิจกรรม
extension

object

ฟิลด์พิเศษใดๆ ที่แลกเปลี่ยนระหว่างผู้ขายกับ Google

ออบเจ็กต์ที่มีช่องประเภทที่กำหนดเอง ช่องเพิ่มเติม "@type" จะมี URI ที่ระบุประเภท ตัวอย่างเช่น { "id": 1234, "@type": "types.example.com/standard/id" }

StaffFacilitator

ข้อมูลเกี่ยวกับพนักงานบริการ

การแสดง JSON 
{
  "name": string,
  "image": {
    object (Image)
  }
}
ช่อง
name

string

ชื่อวิทยากรของพนักงาน เช่น "จอห์น สมิธ"
image

object (Image)

รูปภาพของผู้แสดง