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)

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

object (PriceAttribute)

ราคาและการปรับค่าใช้จ่ายระดับรายการโฆษณา
followUpActions[]

object (Action)

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

object (UserInfo)

ลูกค้าระดับรายการโฆษณา ซึ่งอาจแตกต่างจากผู้ซื้อระดับคำสั่งซื้อ ตัวอย่าง: ผู้ใช้ ก จองร้านอาหารภายใต้ชื่อผู้ใช้ ข
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

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

string

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

string

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

map (key: string, value: string)

รายละเอียดผลิตภัณฑ์ที่ผู้ขายระบุ เช่น { "allergen": "peanut" } ซึ่งจะเป็นประโยชน์ในกรณีที่ไม่มี OfferId ไว้ใน 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)

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