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 Extensions แทน ป้ายกำกับที่ผู้ใช้มองเห็นได้สำหรับสถานะของคำสั่งซื้อนี้
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

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

การแสดง 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)

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