- การแสดง JSON
- สารบัญ
- PaymentData
- PaymentResult
- PaymentInfo
- PaymentMethodDisplayInfo
- โปรโมชัน
- PurchaseOrderExtension
- PurchaseError
- TicketOrderExtension
- TicketEvent
- EventCharacter
รายการที่สั่งซื้อ หมายเหตุ: 1. สตริงทั้งหมดในทุกระดับต้องมีอักขระน้อยกว่า 1,000 ตัว เว้นแต่จะระบุไว้เป็นอย่างอื่น 2. ช่องที่ซ้ำทั้งหมดในทุกระดับต้องมีจำนวนน้อยกว่า 50 ช่อง ยกเว้นจะระบุไว้เป็นอย่างอื่น 3. การประทับเวลาทั้งหมดในทุกระดับต้องเป็นการประทับเวลาที่ถูกต้อง (หากระบุไว้)
การแสดง JSON | |
---|---|
{ "googleOrderId": string, "merchantOrderId": string, "userVisibleOrderId": string, "userVisibleStateLabel": string, "buyerInfo": { object ( |
ช่อง | ||
---|---|---|
googleOrderId |
รหัสคำสั่งซื้อที่ Google กำหนด |
|
merchantOrderId |
ต้องระบุ: รหัสคำสั่งซื้อภายในที่ผู้ขายกำหนด รหัสนี้ต้องไม่ซ้ำกันและจำเป็นสำหรับการดำเนินการอัปเดตคำสั่งซื้อครั้งต่อๆ ไป รหัสนี้อาจถูกกำหนดเป็น googleOrderId ที่ระบุหรือค่าเฉพาะอื่นๆ โปรดทราบว่ารหัสที่ปรากฏต่อผู้ใช้คือ uservisibleOrderId ซึ่งอาจเป็นค่าอื่นที่ใช้งานง่ายกว่า ความยาวสูงสุดคือ 128 อักขระ |
|
userVisibleOrderId |
รหัสสำหรับผู้ใช้ที่อ้างถึงลำดับปัจจุบัน รหัสนี้ควรสอดคล้องกับรหัสที่แสดงสำหรับคำสั่งซื้อนี้ในบริบทอื่นๆ รวมถึงเว็บไซต์ แอป และอีเมล |
|
userVisibleStateLabel |
เลิกใช้งานแล้ว: ใช้สถานะ Order Extensions แทน ป้ายกำกับที่ผู้ใช้มองเห็นได้สำหรับสถานะของคำสั่งซื้อนี้ |
|
buyerInfo |
ข้อมูลเกี่ยวกับผู้ซื้อ |
|
image |
รูปภาพที่เกี่ยวข้องกับคำสั่งซื้อ |
|
createTime |
ต้องระบุ: วันที่และเวลาที่สร้างคำสั่งซื้อ การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่แม่นยำเป็นหน่วยนาโนวินาที ตัวอย่าง: |
|
lastUpdateTime |
วันที่และเวลาอัปเดตคำสั่งซื้อครั้งล่าสุด จำเป็นสำหรับคำสั่งซื้ออัปเดต การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่แม่นยำเป็นหน่วยนาโนวินาที ตัวอย่าง: |
|
transactionMerchant |
ผู้ขายที่อำนวยความสะดวกในการชำระเงิน ซึ่งอาจต่างจากผู้ให้บริการระดับรายการโฆษณา ตัวอย่าง: คำสั่งซื้อ Expedia ที่มีรายการโฆษณาจาก ANA |
|
contents |
ต้องระบุ: เนื้อหาคำสั่งซื้อซึ่งเป็นกลุ่มรายการโฆษณา |
|
priceAttributes[] |
ราคา ส่วนลด ภาษี และอื่นๆ |
|
followUpActions[] |
ติดตามผลที่ระดับคำสั่งซื้อ |
|
paymentData |
ข้อมูลที่เกี่ยวข้องกับการชำระเงินสำหรับคำสั่งซื้อ |
|
termsOfServiceUrl |
ลิงก์ไปยังข้อกำหนดในการให้บริการที่ใช้กับคำสั่งซื้อ/คำสั่งซื้อที่เสนอ |
|
note |
หมายเหตุที่แนบมากับคำสั่งซื้อ |
|
promotions[] |
โปรโมชันทั้งหมดที่เชื่อมโยงกับคำสั่งซื้อนี้ |
|
disclosures[] |
การเปิดเผยข้อมูลที่เกี่ยวข้องกับคำสั่งซื้อนี้ |
|
vertical |
เลิกใช้งานแล้ว: ใช้ประเภทธุรกิจแทน คุณสมบัติเหล่านี้จะใช้กับรายการโฆษณาทั้งหมด เว้นแต่จะมีการลบล้างในรายการโฆษณาบางรายการ ประเภทธุรกิจนี้ต้องตรงกับประเภทประเภทธุรกิจระดับรายการโฆษณา ค่าที่เป็นไปได้คือ ออบเจ็กต์ที่มีช่องประเภทที่กำหนดเอง ช่องเพิ่มเติม |
|
ฟิลด์การรวม verticals คุณสมบัติเหล่านี้จะใช้กับรายการโฆษณาทั้งหมด เว้นแต่จะมีการลบล้างในรายการโฆษณาบางรายการ ประเภทธุรกิจนี้ต้องตรงกับประเภทประเภทธุรกิจระดับรายการโฆษณา verticals ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
||
purchase |
ใบสั่งซื้อ |
|
ticket |
สั่งซื้อตั๋ว |
เนื้อหา
Wrapper สำหรับรายการโฆษณา
การแสดง JSON | |
---|---|
{
"lineItems": [
{
object ( |
ช่อง | |
---|---|
lineItems[] |
รายชื่อรายการโฆษณาของคำสั่งซื้อ ต้องมีรายการโฆษณาอย่างน้อย 1 รายการและอนุญาตได้สูงสุด 50 รายการ รายการโฆษณาทั้งหมดต้องอยู่ในประเภทธุรกิจเดียวกัน |
PaymentData
ข้อมูลการชำระเงินที่เกี่ยวข้องกับคำสั่งซื้อ
การแสดง JSON | |
---|---|
{ "paymentResult": { object ( |
ช่อง | |
---|---|
paymentResult |
ผลการชำระเงินที่ผู้รวมระบบใช้ในการทำธุรกรรมให้เสร็จสมบูรณ์ ระบบจะป้อนข้อมูลในช่องนี้โดยการดำเนินการใน Google หากประสบการณ์การชำระเงินได้รับการจัดการโดย Actions-on-Google |
paymentInfo |
ข้อมูลการชำระเงินเกี่ยวกับคำสั่งซื้อที่เป็นประโยชน์สำหรับการโต้ตอบที่ผู้ใช้เห็น |
PaymentResult
ผู้รวมบริการใช้ผลการชำระเงินสำหรับการทำธุรกรรมให้เสร็จสมบูรณ์
การแสดง JSON | |
---|---|
{ // Union field |
ช่อง | ||
---|---|---|
ฟิลด์การรวม result มีการระบุข้อมูลการชำระเงินด้วยบริการของ Google หรือวิธีการชำระเงินของผู้ขาย result ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
||
googlePaymentData |
ข้อมูลวิธีการชำระเงินที่ Google ให้ไว้ หากผู้ประมวลผลการชำระเงินของคุณอยู่ในรายการผู้ประมวลผลการชำระเงินที่ Google รองรับ โปรดดูที่ https://developers.google.com/pay/api/ ไปที่ผู้ประมวลผลการชำระเงินผ่านลิงก์เพื่อดูรายละเอียดเพิ่มเติม หรือดูรายละเอียดเปย์โหลดในเอกสารประกอบต่อไปนี้ https://developers.google.com/pay/api/payment-data-cryptography |
|
merchantPaymentMethodId |
วิธีการชำระเงินที่ผู้ขาย/การดำเนินการที่ผู้ใช้เลือก |
PaymentInfo
ข้อมูลการชำระเงินเกี่ยวกับคำสั่งซื้อที่ดำเนินการ โปรโตคอลนี้บันทึกข้อมูลที่เป็นประโยชน์สำหรับการโต้ตอบที่แสดงต่อผู้ใช้
การแสดง JSON | |
---|---|
{ "paymentMethodDisplayInfo": { object ( |
ช่อง | |
---|---|
paymentMethodDisplayInfo |
ข้อมูลที่แสดงของวิธีการชำระเงินที่ใช้ทำธุรกรรม |
paymentMethodProvenance |
แหล่งที่มาของวิธีการชำระเงินที่ใช้ทำธุรกรรม ผู้ใช้อาจลงทะเบียนวิธีการชำระเงินเดียวกันทั้งกับ Google และผู้ขาย |
PaymentMethodDisplayInfo
ผู้รวมบริการใช้ผลการชำระเงินสำหรับการทำธุรกรรมให้เสร็จสมบูรณ์
การแสดง JSON | |
---|---|
{
"paymentType": enum ( |
ช่อง | |
---|---|
paymentType |
ประเภทของการชำระเงิน |
paymentMethodDisplayName |
ชื่อวิธีการชำระเงินที่แสดงต่อผู้ใช้ เช่น VISA **** 1234 บัญชีกระแสรายวัน **** 5678 |
โปรโมชัน
โปรโมชัน/ข้อเสนอที่เพิ่มลงในรถเข็น
การแสดง JSON | |
---|---|
{ "coupon": string } |
ช่อง | |
---|---|
coupon |
ต้องระบุ: รหัสคูปองที่ใช้กับข้อเสนอนี้ |
PurchaseOrderExtension
ส่วนขยายคำสั่งซื้อสำหรับประเภทธุรกิจการซื้อ คุณสมบัติเหล่านี้ใช้ได้กับรายการโฆษณาทั้งหมดในคำสั่งซื้อ เว้นแต่จะมีการลบล้างในรายการโฆษณา
การแสดง JSON | |
---|---|
{ "status": enum ( |
ช่อง | |
---|---|
status |
ต้องระบุ: สถานะโดยรวมของคำสั่งซื้อ |
userVisibleStatusLabel |
ป้ายกำกับ/สตริงที่ผู้ใช้มองเห็นสำหรับสถานะ ความยาวสูงสุดที่อนุญาตคือ 50 อักขระ |
type |
ต้องระบุ: ประเภทของการซื้อ |
returnsInfo |
ข้อมูลการคืนสินค้าสำหรับคำสั่งซื้อ |
fulfillmentInfo |
ข้อมูลการดำเนินการตามคำสั่งซื้อ |
extension |
ช่องอื่นๆ ที่แลกเปลี่ยนกันระหว่างผู้ขายและ Google ออบเจ็กต์ที่มีช่องประเภทที่กำหนดเอง ช่องเพิ่มเติม |
purchaseLocationType |
สถานที่ซื้อ (ที่ร้านค้า / ออนไลน์) |
errors[] |
ไม่บังคับ: ข้อผิดพลาดเนื่องจากคำสั่งซื้อนี้ถูกปฏิเสธ |
PurchaseError
ข้อผิดพลาดที่อาจปฏิเสธใบสั่งซื้อได้
การแสดง JSON | |
---|---|
{ "type": enum ( |
ช่อง | |
---|---|
type |
ต้องระบุ: ข้อมูลนี้แสดงเหตุผลที่ผู้ขายปฏิเสธคำสั่งซื้อแบบละเอียด |
description |
คำอธิบายข้อผิดพลาดเพิ่มเติม |
entityId |
รหัสเอนทิตีที่ตรงกับข้อผิดพลาด ตัวอย่างซึ่งสามารถสอดคล้องกับ LineItemId / ItemOptionId |
updatedPrice |
มีความเกี่ยวข้องในกรณีที่มีข้อผิดพลาดประเภท PRICE_CHANGED / INCORRECT_PRICE |
availableQuantity |
มีสินค้าพร้อมจำหน่ายแล้ว ใช้ได้ในกรณี AVAILABILITY_CHANGED |
TicketOrderExtension
เนื้อหาการสั่งซื้อสำหรับการสั่งซื้อตั๋ว เช่น ภาพยนตร์ กีฬา ฯลฯ
การแสดง JSON | |
---|---|
{
"ticketEvent": {
object ( |
ช่อง | |
---|---|
ticketEvent |
เหตุการณ์นี้จะใช้กับตั๋วของรายการโฆษณาทั้งหมด |
TicketEvent
แสดงกิจกรรมเดียว
การแสดง JSON | |
---|---|
{ "type": enum ( |
ช่อง | |
---|---|
type |
ต้องระบุ: ประเภทของตั๋วกิจกรรม เช่น ภาพยนตร์ คอนเสิร์ต |
name |
ต้องระบุ: ชื่อเหตุการณ์ ตัวอย่างเช่น หากกิจกรรมเป็นภาพยนตร์ ควรเป็นชื่อภาพยนตร์ |
description |
คำอธิบายกิจกรรม |
url |
URL ไปยังข้อมูลกิจกรรม |
location |
สถานที่จัดกิจกรรมหรือองค์กร |
eventCharacters[] |
ตัวละครที่เกี่ยวข้องกับกิจกรรมนี้ อาจเป็นผู้กำกับการแสดงภาพยนตร์ หรือผู้แสดงคอนเสิร์ต ฯลฯ |
startDate |
เวลาเริ่มต้น |
endDate |
เวลาสิ้นสุด |
doorTime |
เวลาเข้างาน ซึ่งอาจต่างจากเวลาเริ่มต้นกิจกรรม เช่น กิจกรรมเริ่มเวลา 9:00 น. แต่เวลาเข้าคือ 8:30 น. |
EventCharacter
ตัวละครในเหตุการณ์ 1 ตัว เช่น ผู้จัด นักแสดง เป็นต้น
การแสดง JSON | |
---|---|
{ "type": enum ( |
ช่อง | |
---|---|
type |
ประเภทของตัวละครในกิจกรรม เช่น นักแสดงหรือผู้กำกับ |
name |
ชื่อตัวละคร |
image |
ภาพของตัวละคร |