โปรโมชัน

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

ประเภทส่วนลดที่รองรับมีดังนี้

  • รหัสโปรโมชันที่ Google เป็นผู้สนับสนุน: รหัสโปรโมชันที่สร้างขึ้นโดยอัตโนมัติ ป้อนข้อมูลล่วงหน้าโดย Google หรือป้อนโดยผู้ใช้
  • รหัสโปรโมชันของบุคคลที่สาม: รหัสโปรโมชันที่ให้ผู้ใช้ป้อน ที่มาจากบริการสั่งอาหารของคุณ
  • ส่วนลดอัตโนมัติที่บุคคลที่สามได้รับการสนับสนุน: ส่วนลดที่อาหารของคุณ ระบบจะใช้บริการสั่งซื้อโดยอัตโนมัติโดยไม่มีรหัสโปรโมชัน

ไม่ว่าจะเป็นส่วนลดประเภทใดก็ตาม Google จะโทรไปยังจุดชำระเงินค่าอาหารของคุณ การดำเนินการตามคำสั่งซื้อเพื่อยืนยันและใช้ส่วนลด

ในฐานะนักพัฒนาบริการสั่งอาหาร คุณต้องทำการเปลี่ยนแปลงบางอย่าง กับการใช้งานของคุณเพื่อคำนวณส่วนลดสำหรับรหัสโปรโมชันที่ถูกต้องหรือส่ง ข้อผิดพลาดสำหรับรหัสโปรโมชันที่ไม่ถูกต้อง จัดการการแลกใช้รหัสโปรโมชัน และติดตามข้อมูลทางบัญชีสำหรับการจ่ายเงินชดเชย

วิธีประมวลผลโปรโมชัน

หากต้องการใช้การดำเนินการตามคำสั่งซื้อที่รองรับโปรโมชัน ให้ทำดังนี้

  1. ตั้งค่าการผสานรวมโปรโมชัน (ข้ามส่วนนี้ หากคุณไม่ได้ใช้รหัสส่งเสริมการขายที่ Google สนับสนุน)
  2. ใช้การชำระเงินด้วยโปรโมชัน
  3. ใช้ลำดับการส่งกับโปรโมชัน

ตั้งค่าการผสานรวมโปรโมชัน

ส่วนนี้จะอธิบายวิธีตั้งค่าการผสานรวมโปรโมชันหากคุณมีแผนจะใช้ รหัสโปรโมชันที่ Google สนับสนุน กรณีที่ต้องการรองรับแค่รหัสโปรโมชันหรือ ที่ผู้สนับสนุนบุคคลที่สาม คุณสามารถระบุการตั้งค่าของคุณเองและข้าม ส่วนนี้

Google ระบุประเภทของโปรโมชันที่จะสนับสนุนและติดต่อที่คุณต้องตั้งค่า การผสานรวม เราจะให้รายละเอียดต่อไปนี้

  • จำนวนส่วนลด
  • มูลค่าขั้นต่ำของรถเข็น
  • วันที่เริ่มต้นและวันที่สิ้นสุดสำหรับการใช้รหัสโปรโมชัน
  • จํานวนเงินสูงสุดที่ตั้งงบประมาณไว้สําหรับแคมเปญโปรโมชัน
  • จำนวนครั้งที่สามารถใช้รหัสโปรโมชันได้

ตัวอย่างรหัสโปรโมชัน:

  • FopaNewUser: 10% (เปอร์เซ็นต์คงที่) พร้อมส่วนลดสูงสุด $50
  • FopaMoreThan50: $10 (ส่วนลดเป็นจำนวนเงินคงที่)

หาก Google ตัดสินใจหยุดใช้โค้ดดังกล่าว คุณจะได้รับการติดต่อ

ตั้งค่าการชำระเงิน

โปรดติดต่อที่ปรึกษา EAP ของ Google เพื่อตั้งค่ากระบวนการชำระเงิน Google จะคืนเงินให้เฉพาะธุรกรรมที่เกี่ยวข้องกับโปรโมชันที่ Google สนับสนุนเท่านั้น หากสถานะการสั่งซื้อสุดท้ายเป็นอย่างใดอย่างหนึ่งต่อไปนี้

  • CONFIRMED
  • IN_TRANSIT
  • READY_FOR_PICKUP
  • IN_PREPARATION
  • FULFILLED

ใช้การชำระเงินที่มีโปรโมชัน

ส่วนนี้จะอธิบายการใช้การประมวลผลการชำระเงินเมื่อคุณให้การสนับสนุน รหัสโปรโมชัน (สนับสนุนโดย Google หรือบุคคลที่สาม) สำหรับ ส่วนลดอัตโนมัติที่ได้รับการสนับสนุนจากบุคคลที่สาม คุณเพียงแค่ต้องส่งคืนส่วนลดเท่านั้น รายการโฆษณาใน CheckoutResponseMessage (ไม่มีการตรวจสอบรหัสโปรโมชัน )

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

หากต้องการตรวจสอบว่าผู้ใช้ได้ใช้รหัสโปรโมชันเป็นครั้งแรกหรือไม่ ให้ดำเนินการดังนี้ ดังต่อไปนี้:

  • รหัสโปรโมชันที่ Google สนับสนุน: Google จะตรวจสอบว่าผู้ใช้ที่กลับมาเป็น พยายามใช้รหัสโปรโมชันเดิมอีกครั้ง คุณไม่จำเป็นต้องดำเนินการใดๆ
  • รหัสโปรโมชันของบุคคลที่สามหรือส่วนลดอัตโนมัติ: หากมี ไม่ได้ใช้การลิงก์บัญชีและการเลือกรับของผู้ใช้ คุณจะไม่สามารถตรวจสอบ รายละเอียดของผู้ใช้ระหว่างการประมวลผลคำขอชำระเงิน ให้ตรวจสอบข้อมูลนี้แทน ระหว่างการประมวลผล SubmitOrderRequestMessage โดยใช้ Contact รายละเอียด (เช่น อีเมลของผู้ใช้) จาก FoodCartExtension ออบเจ็กต์

ระบุข้อผิดพลาดหรือคํานวณส่วนลดสําหรับการดําเนินการตามคําสั่งซื้อโดยอิงตามข้อมูลล่าสุด คำขอชำระเงิน เมื่อดำเนินการดังกล่าว โปรดตรวจสอบว่าระบบไม่ได้อัปเดตอยู่เสมอ ข้อมูลรัฐ

ตรวจสอบความถูกต้องของรหัสโปรโมชัน

การดำเนินการตามคำสั่งซื้อควรตรวจสอบความถูกต้องหรือการมีสิทธิ์ของโปรโมชันนั้นๆ ตามข้อกำหนด เช่น วันที่หมดอายุ การใช้งานสูงสุด และ ส่วนลดสูงสุด จากนั้นตอบสนองอย่างเหมาะสมใน CheckoutResponseMessage ด้วยส่วนลดที่คำนวณแล้ว หรือด้วย foodOrderErrors หากรหัสโปรโมชัน ไม่สามารถใช้ได้ หากคุณพบข้อผิดพลาดเกี่ยวกับรหัสโปรโมชัน ให้ทำตาม ตามที่อธิบายไว้ในหัวข้อจัดการข้อผิดพลาดเกี่ยวกับโปรโมชัน

ข้อมูลโค้ดต่อไปนี้แสดงตัวอย่าง foodOrderErrors สำหรับรหัสโปรโมชัน ตรวจสอบว่า correctedProposedOrder ไม่มีโปรโมชัน 

"foodOrderErrors": [
  {
    "error": "PROMO_NOT_APPLICABLE",
    // Copy promotions.coupon string from CheckoutRequest as the ID
    "id": "GoogleNewUser",
    "description": "Promotion could not be applied"
  }
],
"correctedProposedOrder": {// required ...},
"paymentOptions": {// required ...}

ส่วนลดที่คำนวณ

หากรหัสโปรโมชันถูกต้อง การดำเนินการตามคำสั่งซื้อควรคำนวณส่วนลด ดอลลาร์และส่งกลับ CheckoutResponseMessage พร้อมการคำนวณ ในอาร์เรย์ otherItems ราคารวมของคำสั่งซื้อต้องไม่ เชิงลบ หากจำนวนเงินส่วนลดมากกว่าจำนวนเงินในรถเข็น โปรดส่งกลับ จำนวนดอลลาร์สูงสุดเพื่อแสดงราคาคำสั่งซื้อรวมเป็น $0

ข้อมูลโค้ดต่อไปนี้แสดงตัวอย่างส่วน CheckoutResponseMessage สำหรับ ส่วนลดโปรโมชัน ได้แก่

"proposedOrder": {
   "otherItems": [
      . . .
      {
        "name": "Discount",
        // copy promotions.coupon field from CheckoutRequest as the id
        "id": "GoogleNewUser",
        "price": {
          "type": "ESTIMATE",
          "amount": {
          "currencyCode": "USD",
          "units": "-3",
          "nanos": -500000000
        }
      },
      "type": "DISCOUNT",
    }
  ]
}

เผยแพร่โปรโมชันที่ไม่ได้ใช้

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

จัดการข้อผิดพลาดเกี่ยวกับโปรโมชัน

หากการดำเนินการตามคำสั่งซื้อระบุว่ารหัสโปรโมชันจาก CheckoutRequestMessage ไม่ถูกต้อง (เช่น หมดอายุแล้ว ไม่ถูกต้อง หรือไม่รู้จัก) ให้ส่ง CheckoutResponseMessage ที่มี foodOrderError ที่มีรหัสข้อผิดพลาดและข้อความเหตุผลที่เกี่ยวข้อง พร้อมทั้ง ออบเจ็กต์ correctedProposedOrder และ paymentOptions

หากการดำเนินการของคุณพบข้อผิดพลาดเกี่ยวกับรหัสโปรโมชันหลายรายการจากคำขอเดียวกัน ส่งกลับข้อผิดพลาดที่ไม่สามารถกู้คืนได้ ก่อนที่จะส่งคืนข้อผิดพลาดที่สามารถกู้คืนได้ จัดลำดับความสำคัญของการตรวจสอบดังนี้ (จากสูงไปต่ำ)

  • PROMO_NOT_RECOGNIZED
  • PROMO_EXPIRED
  • PROMO_USER_INELIGIBLE
  • PROMO_ORDER_INELIGIBLE
  • PROMO_NOT_APPLICABLE

ตัวอย่าง

ต่อไปนี้คือตัวอย่างของคำขอชำระเงินที่มีรหัสโปรโมชัน

{
    "accessToken": "test_access_token",
    "lastSeen": "2018-06-22T19:25:39Z"
  },
  "conversation": {
    "conversationId": "XYZ"
  },
  "inputs": [
    {
      "intent": "actions.foodordering.intent.CHECKOUT",
      "arguments": [
        {
          "extension": {
            "@type": "type.googleapis.com/google.actions.v2.orders.Cart",
            "merchant": {
              "id": "https://www.exampleprovider.com/merchant/id1",
              "name": "Falafel Bite"
            },
            "lineItems": [
              {
                "name": "Falafel Tray",
                "type": "REGULAR",
                "id": "sample_item_offer_id_1",
                "quantity": 1,
                "price": {
                  "type": "ESTIMATE",
                  "amount": {
                    "currencyCode": "USD",
                    "units": "9",
                    "nanos": 950000000
                  }
                },
                "offerId": "https://www.exampleprovider.com/menu/item/offer/id1",
                "extension": {
                  "@type": "type.googleapis.com/google.actions.v2.orders.FoodItemExtension"
                }
              }
            ],
            "promotions": [
              {
                "coupon": "FOPAACTIVECODE"
              }
            ],
            "extension": {
              "@type": "type.googleapis.com/google.actions.v2.orders.FoodCartExtension",
              "fulfillmentPreference": {
                "fulfillmentInfo": {
                  "pickup": {
                    "pickupTimeIso8601": "P0M"
                  }
                }
              }
            }
          }
        }
      ]
    }
  ],
  "directActionOnly": true,
  "isInSandbox": true
}

นี่คือการตอบกลับการชำระเงินที่เกี่ยวข้องจากการดำเนินการตามคำสั่งซื้อในกรณีที่โปรโมชัน รหัสถูกต้อง:

{
  "expectUserResponse": false,
  "finalResponse": {
    "richResponse": {
      "items": [
        {
          "structuredResponse": {
            "checkoutResponse": {
              "proposedOrder": {
                "otherItems": [
                  {
                    "name": "Delivery Fees",
                    "price": {
                      "type": "ESTIMATE",
                      "amount": {
                        "currencyCode": "USD",
                        "units": "3",
                        "nanos": 500000000
                      }
                    },
                    "type": "DELIVERY"
                  },
                  {
                    "name": "Tax",
                    "price": {
                      "type": "ESTIMATE",
                      "amount": {
                        "currencyCode": "USD",
                        "units": "1",
                        "nanos": 370000000
                      }
                    },
                    "type": "TAX"
                  },
                  {
                    "name": "Promotion",
                    "price": {
                      "type": "ESTIMATE",
                      "amount": {
                        "currencyCode": "USD",
                        "units": "-5",
                        "nanos": 0
                      }
                    },
                    "id": "FOPAACTIVECODE",
                    "type": "DISCOUNT"
                  }
                ],
                "cart": {
                  "merchant": {
                    "id": "https://www.exampleprovider.com/merchant/id1",
                    "name": "Falafel Bite"
                  },
                  "lineItems": [
                    {
                      "name": "Falafel Tray",
                      "type": "REGULAR",
                      "id": "2529103",
                      "quantity": 1,
                      "price": {
                        "type": "ESTIMATE",
                        "amount": {
                          "currencyCode": "USD",
                          "units": "9",
                          "nanos": 950000000
                        }
                      },
                      "offerId": "https://www.exampleprovider.com/menu/item/offer/id1",
                      "extension": {
                        "@type": "type.googleapis.com/google.actions.v2.orders.FoodItemExtension"
                      }
                    }
                  ],
                  "promotions": [
                    {
                      "coupon": "FOPAACTIVECODE"
                    }
                  ],
                  "extension": {
                    "@type": "type.googleapis.com/google.actions.v2.orders.FoodCartExtension",
                    "fulfillmentPreference": {
                      "fulfillmentInfo": {
                        "pickup": {
                          "pickupTimeIso8601": "P0M"
                        }
                      }
                    }
                  }
                },
                "totalPrice": {
                  "type": "ESTIMATE",
                  "amount": {
                    "currencyCode": "USD",
                    "units": "9",
                    "nanos": 820000000
                  }
                },
                "extension": {
                  "@type": "type.googleapis.com/google.actions.v2.orders.FoodOrderExtension",
                  "availableFulfillmentOptions": [
                    {
                      "fulfillmentInfo": {
                        "pickup": {
                          "pickupTimeIso8601": "P0M"
                        }
                      },
                      "expiresAt": "2018-06-22T19:30:52.596Z"
                    }
                  ]
                }
              },
              "orderOptions": {},
              "paymentOptions": {
                "googleProvidedOptions": {
                  "tokenizationParameters": {
                    "tokenizationType": "PAYMENT_GATEWAY",
                    "parameters": {
                      "gateway": "stripe",
                      "stripe:publishableKey": "example_stripe_client_key",
                      "stripe:version": "2017-04-06"
                    }
                  },
                  "supportedCardNetworks": [
                    "AMEX",
                    "DISCOVER",
                    "MASTERCARD",
                    "VISA",
                    "JCB"
                  ],
                  "prepaidCardDisallowed": true
                }
              }
            }
          }
        }
      ],
      "suggestions": []
    }
  }
}

ตัวอย่างการตอบกลับการชำระเงินหากรหัสโปรโมชันไม่ถูกต้องมีดังนี้

{
  "expectUserResponse": false,
  "finalResponse": {
    "richResponse": {
      "items": [
        {
          "structuredResponse": {
            "error": {
              "foodOrderErrors": [
                {
                  "error": "PROMO_NOT_RECOGNIZED",
                  "id": "SOMEPROMO",
                  "description": "Coupon not found"
                }
              ],
              "correctedProposedOrder": {
                "cart": {
                  "merchant": {
                    "id": "https://www.exampleprovider.com/merchant/id1",
                    "name": "Falafel Bite"
                  },
                  "lineItems": [
                    {
                      "id": "sample_item_offer_id_4",
                      "name": "Prawns Biryani",
                      "type": "REGULAR",
                      "quantity": 1,
                      "price": {
                        "type": "ESTIMATE",
                        "amount": {
                          "currencyCode": "USD",
                          "units": "18",
                          "nanos": 750000000
                        }
                      },
                      "offerId": "https://www.exampleprovider.com/menu/item/offer/id4",
                      "extension": {
                        "@type": "type.googleapis.com/google.actions.v2.orders.FoodItemExtension"
                      }
                    }
                  ],
                  "extension": {
                    "fulfillmentPreference": {
                      "fulfillmentInfo": {
                        "pickup": {
                          "pickupTimeIso8601": "P0M"
                        }
                      }
                    },
                    "@type": "type.googleapis.com/google.actions.v2.orders.FoodCartExtension"
                  },
                  "promotions": []
                },
                "otherItems": [
                  {
                    "name": "Tax",
                    "type": "TAX",
                    "price": {
                      "type": "ESTIMATE",
                      "amount": {
                        "currencyCode": "USD",
                        "units": "1",
                        "nanos": 650000000
                      }
                    }
                  }
                ],
                "termsOfServiceUrl": "https://exampleprovider.com/terms",
                "totalPrice": {
                  "type": "ESTIMATE",
                  "amount": {
                    "currencyCode": "USD",
                    "units": "20",
                    "nanos": 400000000
                  }
                },
                "extension": {
                  "availableFulfillmentOptions": [
                    {
                      "fulfillmentInfo": {
                        "pickup": {
                          "pickupTimeIso8601": "PT0M"
                        }
                      }
                    }
                  ],
                  "@type": "type.googleapis.com/google.actions.v2.orders.FoodOrderExtension"
                }
              },
              "paymentOptions": {
                "googleProvidedOptions": {
                  "prepaidCardDisallowed": false,
                  "billingAddressRequired": true,
                  "tokenizationParameters": {
                    "tokenizationType": "PAYMENT_GATEWAY",
                    "parameters": {
                      "gateway": "braintree",
                      "braintree:apiVersion": "v1",
                      "braintree:sdkVersion": "1.4.0",
                      "braintree:merchantId": "example_braintree_merchant_ID",
                      "braintree:clientKey": "example_braintree_client_key",
                      "braintree:authorizationFingerprint": "example_braintree_fingerprint"
                    }
                  }
                }
              },
              "@type": "type.googleapis.com/google.actions.v2.orders.FoodErrorExtension"
            }
          }
        }
      ]
    }
  }
}

ใช้ลำดับการส่งที่มีโปรโมชัน

ในการดำเนินการตามคำสั่งซื้อการส่งของคุณ ให้ตรวจสอบว่านี่เป็นครั้งแรกที่ ผู้ใช้กำลังใช้รหัสโปรโมชัน ระหว่างSubmitOrderRequestMessage คุณสามารถตรวจสอบสิ่งนี้ได้โดยใช้รายละเอียด Contact (เช่น อีเมลของผู้ใช้) จากออบเจ็กต์ FoodCartExtension

นอกจากนี้ คุณควรตรวจสอบความเกี่ยวข้องของรหัสโปรโมชันอีกครั้ง โดยทำดังนี้

  • หากใช้รหัสได้: ยืนยันคำสั่งซื้อและทำเครื่องหมายคูปองที่แลกสิทธิ์
  • หากโค้ดใช้ไม่ได้แล้ว: ให้ปฏิเสธคำสั่งซื้อด้วย ข้อผิดพลาด PROMO_NOT_APPLICABLE รายการ คุณระบุเหตุผลการปฏิเสธที่เจาะจงได้ ใช้กลไกเดียวกันกับ FoodOrderUpdateExtension

ตัวอย่าง

ตัวอย่างคำขอให้สั่งซื้อพร้อมโปรโมชันมีดังนี้

{
  "conversation": {
    "conversationId": "example_conversation_ID"
  },
  "inputs": [
    {
      "intent": "actions.intent.TRANSACTION_DECISION",
      "arguments": [
        {
          "transactionDecisionValue": {
            "order": {
              "finalOrder": {
                "cart": {
                  "merchant": {
                    "id": "https://www.exampleprovider.com/merchant/id1",
                    "name": "Falafel Bite"
                  },
                  "lineItems": [
                    {
                      "name": "Falafel Tray",
                      "type": "REGULAR",
                      "id": "sample_item_offer_id_1",
                      "quantity": 1,
                      "price": {
                        "type": "ESTIMATE",
                        "amount": {
                          "currencyCode": "USD",
                          "units": "9",
                          "nanos": 950000000
                        }
                      },
                      "offerId": "https://www.exampleprovider.com/menu/item/addon/offer/id1",
                      "extension": {
                        "@type": "type.googleapis.com/google.actions.v2.orders.FoodItemExtension"
                      }
                    }
                  ],
                  "promotions": [
                    {
                      "coupon": "FOPAACTIVECODE"
                    }
                  ],
                  "extension": {
                    "@type": "type.googleapis.com/google.actions.v2.orders.FoodCartExtension",
                    "fulfillmentPreference": {
                      "fulfillmentInfo": {
                        "pickup": {
                          "pickupTimeIso8601": "P0M"
                        }
                      }
                    },
                    "contact": {
                      "displayName": "Food Ordering",
                      "email": "example.provider@gmail.com",
                      "phoneNumber": "+19993334444",
                      "firstName": "Food",
                      "lastName": "Ordering"
                    }
                  }
                },
                "otherItems": [
                  {
                    "name": "Delivery Fees",
                    "type": "DELIVERY",
                    "price": {
                      "type": "ESTIMATE",
                      "amount": {
                        "currencyCode": "USD",
                        "units": "3",
                        "nanos": 500000000
                      }
                    }
                  },
                  {
                    "name": "Tax",
                    "type": "TAX",
                    "price": {
                      "type": "ESTIMATE",
                      "amount": {
                        "currencyCode": "USD",
                        "units": "1",
                        "nanos": 370000000
                      }
                    }
                  },
                  {
                    "name": "Promotion",
                    "type": "DISCOUNT",
                    "price": {
                      "type": "ESTIMATE",
                      "amount": {
                        "currencyCode": "USD",
                        "units": "-5"
                      }
                    },
                    "id": "FOPAACTIVECODE"
                  },
                  {
                    "name": "Subtotal",
                    "type": "SUBTOTAL",
                    "price": {
                      "type": "ESTIMATE",
                      "amount": {
                        "currencyCode": "USD",
                        "units": "9",
                        "nanos": 950000000
                      }
                    }
                  },
                  {
                    "name": "Tip",
                    "type": "GRATUITY",
                    "price": {
                      "type": "ESTIMATE",
                      "amount": {
                        "currencyCode": "USD"
                      }
                    }
                  }
                ],
                "totalPrice": {
                  "type": "ESTIMATE",
                  "amount": {
                    "currencyCode": "USD",
                    "units": "9",
                    "nanos": 820000000
                  }
                },
                "extension": {
                  "@type": "type.googleapis.com/google.actions.v2.orders.FoodOrderExtension"
                }
              },
              "googleOrderId": "example_google_order_ID",
              "orderDate": "2018-06-22T19:30:59.502Z",
              "paymentInfo": {
                "displayName": "example_display_name",
                "googleProvidedPaymentInstrument": {
                  "instrumentToken": "example_instrument_token"
                },
                "paymentType": "PAYMENT_CARD"
              },
              "locale": "en"
            }
          }
        }
      ]
    }
  ],
  "directActionOnly": true,
  "isInSandbox": true
}

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

{
  "expectUserResponse": false,
  "finalResponse": {
    "richResponse": {
      "items": [
        {
          "structuredResponse": {
            "orderUpdate": {
              "actionOrderId": "example_action_order_ID",
              "orderState": {
                "state": "CREATED",
                "label": "Order is created with partner."
              },
              "updateTime": "2018-06-22T19:31:01.556Z",
              "orderManagementActions": [
                {
                  "type": "CALL_RESTAURANT",
                  "button": {
                    "title": "Call Us",
                    "openUrlAction": {
                      "url": "tel:+1-111-111-1111"
                    }
                  }
                },
                {
                  "type": "EMAIL",
                  "button": {
                    "title": "Email Us",
                    "openUrlAction": {
                      "url": "mailto:example.provider@gmail.com"
                    }
                  }
                },
                {
                  "type": "CUSTOMER_SERVICE",
                  "button": {
                    "title": "Customer Service",
                    "openUrlAction": {
                      "url": "http://www.google.com"
                    }
                  }
                }
              ]
            }
          }
        }
      ],
      "suggestions": []
    }
  }
}

ต่อไปนี้คือตัวอย่างการตอบกลับคำสั่งซื้อการส่ง หากรหัสโปรโมชันไม่ถูกต้อง

"orderUpdate": {
  "actionOrderId": "sample_action_order_id",
  "orderState": {
    "state": "REJECTED",
    "label": "Order rejected."
  },
  "updateTime": "2017-05-10T02:30:00.000Z",
  "rejectionInfo": {
    "type": "PROMO_NOT_APPLICABLE",
    "reason": "Sorry, there's something wrong. Try another code?"
  },
  "orderManagementActions": [
    {
      "type": "CUSTOMER_SERVICE",
      "button": {
        "title": "Contact customer service",
        "openUrlAction": {
          "url": "mailto:support@example.com"
        }
      }
    },
    {
      "type": "EMAIL",
      "button": {
        "title": "Email restaurant",
        "openUrlAction": {
          "url": "mailto:example.provider@example.com"
        }
      }
    },
    {
      "type": "CALL_RESTAURANT",
      "button": {
        "title": "Call restaurant",
        "openUrlAction": {
          "url": "tel:+19993334444"
        }
      }
    }
  ],
  "infoExtension": {
    "@type": "type.googleapis.com/google.actions.v2.orders.FoodOrderUpdateExtension",
    "foodOrderErrors": [
      {
        "error": "PROMO_USER_INELIGIBLE",
        "description": "Sorry, you can only use this promotion once."
      }
    ]
  }
}