Order

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

การแสดง JSON 
{
  "googleOrderId": string,
  "merchantOrderId": string,
  "userVisibleOrderId": string,
  "userVisibleStateLabel": string,
  "buyerInfo": {
    object (UserInfo)
  },
  "image": {
    object (Image)
  },
  "createTime": string,
  "lastUpdateTime": string,
  "transactionMerchant": {
    object (Merchant)
  },
  "contents": {
    object (Contents)
  },
  "priceAttributes": [
    {
      object (PriceAttribute)
    }
  ],
  "followUpActions": [
    {
      object (Action)
    }
  ],
  "paymentData": {
    object (PaymentData)
  },
  "termsOfServiceUrl": string,
  "note": string,
  "promotions": [
    {
      object (Promotion)
    }
  ],
  "disclosures": [
    {
      object (Disclosure)
    }
  ],
  "vertical": {
    "@type": string,
    field1: ...,
    ...
  },

  // Union field verticals can be only one of the following:
  "purchase": {
    object (PurchaseOrderExtension)
  },
  "ticket": {
    object (TicketOrderExtension)
  }
  // End of list of possible types for union field verticals.
}
ช่อง
googleOrderId

string

รหัสคำสั่งซื้อที่ Google กำหนด
merchantOrderId

string

ต้องระบุ: รหัสคำสั่งซื้อภายในที่ผู้ขายกำหนด รหัสนี้ต้องไม่ซ้ำกัน และจำเป็นสำหรับการดำเนินการอัปเดตคำสั่งซื้อในครั้งต่อๆ ไป โดยอาจกำหนดเป็น googleOrderId ที่ระบุ หรือค่าที่ไม่ซ้ำกันอื่นๆ โปรดทราบว่ารหัสที่แสดงแก่ผู้ใช้คือ userVisibleOrderId ซึ่งอาจจะเป็นค่าอื่นที่ใช้งานง่ายกว่า ความยาวสูงสุดคือ 128 อักขระ
userVisibleOrderId

string

รหัสที่แสดงต่อผู้ใช้ซึ่งอ้างอิงถึงคำสั่งซื้อปัจจุบัน รหัสนี้ควรสอดคล้องกับรหัสที่แสดงสำหรับคำสั่งซื้อนี้ในบริบทอื่นๆ รวมถึงเว็บไซต์ แอป และอีเมล
userVisibleStateLabel
(deprecated)

string

เลิกใช้งานแล้ว: ใช้สถานะ Orderชิ้นงานแทน ป้ายกำกับที่ปรากฏต่อผู้ใช้สำหรับสถานะของคำสั่งซื้อนี้
buyerInfo

object (UserInfo)

เกี่ยวกับผู้ซื้อ
image

object (Image)

รูปภาพที่เชื่อมโยงกับคำสั่งซื้อ
createTime

string (Timestamp format)

ต้องระบุ: วันที่และเวลาที่สร้างคำสั่งซื้อ

การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่แม่นยำเป็นหน่วยนาโนวินาที ตัวอย่าง: "2014-10-02T15:01:23.045123456Z"
lastUpdateTime

string (Timestamp format)

วันที่และเวลาอัปเดตคำสั่งซื้อครั้งล่าสุด จำเป็นสำหรับการอัปเดตคำสั่งซื้อ

การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่แม่นยำเป็นหน่วยนาโนวินาที ตัวอย่าง: "2014-10-02T15:01:23.045123456Z"
transactionMerchant

object (Merchant)

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

object (Contents)

ต้องระบุ: สั่งซื้อเนื้อหาที่เป็นกลุ่มรายการโฆษณา
priceAttributes[]

object (PriceAttribute)

ราคา ส่วนลด ภาษี และอื่นๆ
followUpActions[]

object (Action)

ติดตามผลที่ระดับคำสั่งซื้อ
paymentData

object (PaymentData)

ข้อมูลที่เกี่ยวข้องกับการชำระเงินสำหรับคำสั่งซื้อ
termsOfServiceUrl

string

ลิงก์ไปยังข้อกำหนดในการให้บริการที่ใช้กับคำสั่งซื้อ/คำสั่งซื้อที่เสนอ
note

string

แนบโน้ตไปกับคำสั่งซื้อแล้ว
promotions[]

object (Promotion)

โปรโมชันทั้งหมดที่เชื่อมโยงกับคำสั่งซื้อนี้
disclosures[]

object (Disclosure)

การเปิดเผยที่เชื่อมโยงกับคำสั่งซื้อนี้
vertical
(deprecated)

object

เลิกใช้งานแล้ว: ใช้ประเภทธุรกิจแทน พร็อพเพอร์ตี้เหล่านี้จะมีผลกับรายการโฆษณาทั้งหมด เว้นแต่จะมีการลบล้างในรายการโฆษณาบางรายการ ประเภทธุรกิจนี้ต้องตรงกับประเภทประเภทธุรกิจระดับรายการโฆษณา ค่าที่เป็นไปได้: google.actions.orders.v3.verticals.purchase.PurchaseOrderExtension google.actions.orders.v3.verticals.ticket.TicketOrderExtension

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

object (PurchaseOrderExtension)

ใบสั่งซื้อ
ticket

object (TicketOrderExtension)

ลำดับตั๋ว

เนื้อหา

Wrapper สำหรับรายการโฆษณา

การแสดง JSON 
{
  "lineItems": [
    {
      object (LineItem)
    }
  ]
}
ช่อง
lineItems[]

object (LineItem)

รายชื่อรายการโฆษณาของคำสั่งซื้อ โดยต้องมีอย่างน้อย 1 บรรทัดรายการ แต่ไม่เกิน 50 บรรทัด รายการโฆษณาทั้งหมดต้องอยู่ในประเภทธุรกิจเดียวกัน

PaymentData

ข้อมูลการชำระเงินที่เกี่ยวข้องกับคำสั่งซื้อ

การแสดง JSON 
{
  "paymentResult": {
    object (PaymentResult)
  },
  "paymentInfo": {
    object (PaymentInfo)
  }
}
ช่อง
paymentResult

object (PaymentResult)

ผลลัพธ์การชำระเงินที่ผู้รวมระบบใช้เพื่อดำเนินการธุรกรรมให้เสร็จสมบูรณ์ ระบบจะป้อนข้อมูลในช่องนี้โดยการดำเนินการใน Google หากประสบการณ์การชำระเงินได้รับการจัดการโดย actions-on-Google
paymentInfo

object (PaymentInfo)

ข้อมูลการชำระเงินเกี่ยวกับคำสั่งซื้อที่เป็นประโยชน์ในการโต้ตอบที่แสดงต่อผู้ใช้

PaymentResult

ผลการชำระเงินที่ผู้รวมระบบใช้เพื่อทำธุรกรรมให้เสร็จสมบูรณ์

การแสดง JSON 
{

  // Union field result can be only one of the following:
  "googlePaymentData": string,
  "merchantPaymentMethodId": string
  // End of list of possible types for union field result.
}
ช่อง
ช่องการรวม result มีการระบุข้อมูลการชำระเงินของ Google หรือวิธีการชำระเงินของผู้ขาย result ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
googlePaymentData

string

ข้อมูลวิธีการชำระเงินที่ Google ระบุ หากผู้ประมวลผลการชำระเงินของคุณอยู่ในรายการผู้ประมวลผลการชำระเงินที่ Google รองรับที่นี่ https://developers.google.com/pay/api/ ไปที่ผู้ประมวลผลการชำระเงินผ่านลิงก์เพื่อดูรายละเอียดเพิ่มเติม หรือดูรายละเอียดเพย์โหลดในเอกสารประกอบต่อไปนี้ https://developers.google.com/pay/api/payment-data-cryptography
merchantPaymentMethodId

string

ผู้ขาย/การดำเนินการระบุวิธีการชำระเงินที่ผู้ใช้เลือก

PaymentInfo

ข้อมูลการชำระเงินเกี่ยวกับคำสั่งซื้อที่ดำเนินการ Proto นี้จะบันทึกข้อมูลที่เป็นประโยชน์ในการโต้ตอบที่แสดงต่อผู้ใช้

การแสดง JSON 
{
  "paymentMethodDisplayInfo": {
    object (PaymentMethodDisplayInfo)
  },
  "paymentMethodProvenance": enum (PaymentMethodProvenance)
}
ช่อง
paymentMethodDisplayInfo

object (PaymentMethodDisplayInfo)

ข้อมูลที่แสดงของวิธีการชำระเงินที่ใช้สำหรับธุรกรรม
paymentMethodProvenance

enum (PaymentMethodProvenance)

แหล่งที่มาของวิธีการชำระเงินที่ใช้สำหรับธุรกรรม ผู้ใช้อาจลงทะเบียนวิธีการชำระเงินเดียวกันกับทั้ง Google และผู้ขายแล้ว

PaymentMethodDisplayInfo

ผลการชำระเงินที่ผู้รวมระบบใช้เพื่อทำธุรกรรมให้เสร็จสมบูรณ์

การแสดง JSON 
{
  "paymentType": enum (PaymentType),
  "paymentMethodDisplayName": string
}
ช่อง
paymentType

enum (PaymentType)

ประเภทของการชำระเงิน
paymentMethodDisplayName

string

ชื่อวิธีการชำระเงินที่ผู้ใช้มองเห็นได้ เช่น VISA **** 1234 บัญชีกระแสรายวัน **** 5678

โปรโมชัน

โปรโมชัน/ข้อเสนอที่เพิ่มลงในรถเข็น

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

string

ต้องระบุ: รหัสคูปองที่ใช้กับข้อเสนอนี้

PurchaseOrderExtension

ส่วนขยายคำสั่งซื้อสำหรับประเภทธุรกิจการซื้อ คุณสมบัติเหล่านี้จะมีผลกับรายการโฆษณาทั้งหมดในคำสั่งซื้อ เว้นแต่จะมีการลบล้างในรายการโฆษณา

การแสดง JSON 
{
  "status": enum (PurchaseStatus),
  "userVisibleStatusLabel": string,
  "type": enum (PurchaseType),
  "returnsInfo": {
    object (PurchaseReturnsInfo)
  },
  "fulfillmentInfo": {
    object (PurchaseFulfillmentInfo)
  },
  "extension": {
    "@type": string,
    field1: ...,
    ...
  },
  "purchaseLocationType": enum (PurchaseLocationType),
  "errors": [
    {
      object (PurchaseError)
    }
  ]
}
ช่อง
status

enum (PurchaseStatus)

ต้องระบุ: สถานะโดยรวมสำหรับคำสั่งซื้อ
userVisibleStatusLabel

string

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

enum (PurchaseType)

ต้องระบุ: ประเภทของการซื้อ
returnsInfo

object (PurchaseReturnsInfo)

ข้อมูลการคืนสินค้าสำหรับคำสั่งซื้อ
fulfillmentInfo

object (PurchaseFulfillmentInfo)

ข้อมูลการดำเนินการสำหรับคำสั่งซื้อ
extension

object

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

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

enum (PurchaseLocationType)

สถานที่ซื้อ (ในร้าน / ออนไลน์)
errors[]

object (PurchaseError)

ไม่บังคับ: ข้อผิดพลาดเนื่องจากคำสั่งซื้อนี้ถูกปฏิเสธ

PurchaseError

ข้อผิดพลาดที่อาจปฏิเสธใบสั่งซื้อได้

การแสดง JSON 
{
  "type": enum (ErrorType),
  "description": string,
  "entityId": string,
  "updatedPrice": {
    object (PriceAttribute)
  },
  "availableQuantity": integer
}
ช่อง
type

enum (ErrorType)

ต้องระบุ: ข้อมูลนี้เป็นเหตุผลอย่างละเอียดที่ผู้ขายปฏิเสธคำสั่งซื้อ
description

string

คำอธิบายข้อผิดพลาดเพิ่มเติม
entityId

string

รหัสเอนทิตีที่สอดคล้องกับข้อผิดพลาด ตัวอย่างนี้อาจสอดคล้องกับ LineItemId / ItemOptionId
updatedPrice

object (PriceAttribute)

เกี่ยวข้องในกรณีของข้อผิดพลาดประเภท PRICE_CHANGED / INCORRECT_PRICE
availableQuantity

integer

จำนวนสินค้าที่พร้อมจำหน่ายในขณะนี้ ใช้ได้ในกรณี AVAILABILITY_CHANGED

TicketOrderExtension

สั่งซื้อเนื้อหาสำหรับคำสั่งซื้อตั๋ว เช่น ภาพยนตร์ กีฬา ฯลฯ

การแสดง JSON 
{
  "ticketEvent": {
    object (TicketEvent)
  }
}
ช่อง
ticketEvent

object (TicketEvent)

มีการใช้เหตุการณ์กับตั๋วรายการโฆษณาทั้งหมด

TicketEvent

แสดงเหตุการณ์เดียว

การแสดง JSON 
{
  "type": enum (Type),
  "name": string,
  "description": string,
  "url": string,
  "location": {
    object (Location)
  },
  "eventCharacters": [
    {
      object (EventCharacter)
    }
  ],
  "startDate": {
    object (Time)
  },
  "endDate": {
    object (Time)
  },
  "doorTime": {
    object (Time)
  }
}
ช่อง
type

enum (Type)

ต้องระบุ: ประเภทตั๋วกิจกรรม เช่น ภาพยนตร์ คอนเสิร์ต
name

string

ต้องระบุ: ชื่อเหตุการณ์ ตัวอย่างเช่น หากกิจกรรมเป็นภาพยนตร์ ก็ควรเป็นชื่อภาพยนตร์
description

string

คำอธิบายของกิจกรรม
url

string

URL ไปยังข้อมูลกิจกรรม
location

object (Location)

สถานที่ที่จัดกิจกรรมหรือองค์กรตั้งอยู่
eventCharacters[]

object (EventCharacter)

ตัวละครที่เกี่ยวข้องกับกิจกรรมนี้ อาจเป็นผู้กำกับหรือนักแสดงกิจกรรมภาพยนตร์ หรือผู้แสดงคอนเสิร์ต เป็นต้น
startDate

object (Time)

เวลาเริ่มต้น
endDate

object (Time)

เวลาสิ้นสุด
doorTime

object (Time)

เวลาเริ่มงาน ซึ่งอาจต่างจากเวลาเริ่มต้นของกิจกรรม เช่น กิจกรรมเริ่มเวลา 9.00 น. แต่เริ่มงานเวลา 8.30 น.

EventCharacter

อักขระเหตุการณ์ 1 ตัว เช่น ผู้จัดงาน นักแสดง ฯลฯ

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

enum (Type)

ประเภทอักขระของเหตุการณ์ เช่น นักแสดงหรือผู้กำกับ
name

string

ของตัวละคร
image

object (Image)

รูปภาพของตัวละคร