- การแสดง 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ชิ้นงานแทน ป้ายกำกับที่ปรากฏต่อผู้ใช้สำหรับสถานะของคำสั่งซื้อนี้ |
|
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
ข้อมูลการชำระเงินเกี่ยวกับคำสั่งซื้อที่ดำเนินการ Proto นี้จะบันทึกข้อมูลที่เป็นประโยชน์ในการโต้ตอบที่แสดงต่อผู้ใช้
การแสดง 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 |
รูปภาพของตัวละคร |