메뉴 피드 및 주문 처리 장바구니 항목 매핑
고객이 메뉴 피드의 항목을 장바구니에 추가하고 결제하면 Google은 이러한 항목을 처리 엔드포인트로 전송하여 가격과 재고를 확인합니다. 가격 및 재고가 확인되면 고객이 주문할 수 있습니다. 이 섹션에서는 메뉴 피드 항목을 처리 장바구니 항목에 매핑하는 방법을 설명합니다.
이 섹션의 샘플은 메뉴 피드와 장바구니 스키마의 제거된 버전입니다. 메뉴 피드와 장바구니 객체 간의 매핑을 보여주는 필드만 표시됩니다. 전체 스키마는 Menu 및 Cart를 참고하세요.
장바구니에 추가된 Menu 피드의 상품은 결제 및 주문 제출 모두에서
Cart 객체에 전송됩니다.
- 간단한
MenuItem는lineItems배열에서LineItem로 표시되며offerId는 메뉴 피드에서 선택된 메뉴 항목의offer.id입니다. - 필수
MenuItemOption가 있는MenuItem은lineItems배열에LineItem로 표시되며, 여기서offerId은 메뉴 피드에서 선택된 메뉴 항목 옵션offer.id입니다. LineItem의AddOnMenuItem은FoodItemExtension의options배열에FoodItemOption로 표시됩니다. 각 옵션에는 메뉴 피드에서 선택된 부가기능 메뉴 항목의offer.id에 해당하는offerId가 있습니다. AddOnMenuItem에는 각 옵션 내에서subOptions로 표시되는 중첩 AddOnMenuItem도 있을 수 있습니다.
다음 예에서는 메뉴 피드와 처리 장바구니 사이에 메뉴 항목을 매핑합니다.
JSON
이 예에는 간단한 메뉴 항목 목록이 포함되어 있습니다.
메뉴 피드의 메뉴 항목:
{
"@type": "Menu",
"@id": "menu_id",
"hasMenuItem": [
{
"@type": "MenuItem",
"@id": "menuitem_id_1",
"offers": [
{
"@type": "Offer",
"@id": "menuitem_offer_id_1",
"price": "p_1",
"priceCurrency": "USD"
}
]
},
{
"@type": "MenuItem",
"@id": "menuitem_id_2",
"offers": [
{
"@type": "Offer",
"@id": "menuitem_offer_id_2",
"price": "p_2",
"priceCurrency": "USD"
}
]
}
]
}
주문 처리 장바구니에 매핑된 메뉴 항목:
{
"@type": "Cart",
"lineItems": [
{
"offerId": "menuitem_offer_id_1",
"price": {
"amount": {
"currencyCode": "USD",
"units": "dollar(q_1*p_1)",
"nanos": "cent(q_1*p_1)"
}
},
"quantity": "q_1"
},
{
"offerId": "menuitem_offer_id_2",
"price": {
"amount": {
"currencyCode": "USD",
"units": "dollar(q_2*p_2)",
"nanos": "cent(q_2*p_2)"
}
},
"quantity": "q_2"
}
]
}
JSON
이 예에는 하나 이상의 AddOnMenuItems가 있는 메뉴 항목이 포함되어 있습니다.
메뉴 피드의 메뉴 항목:
{
"@type": "Menu",
"@id": "menu_id",
"hasMenuItem": [
{
"@type": "MenuItem",
"@id": "menuitem_id_1",
"offers": [
{
"@type": "Offer",
"@id": "menuitem_offer_id_1",
"price": "p_1",
"priceCurrency": "USD"
}
],
"menuAddOn": [
{
"@type": "MenuAddOnSection",
"@id": "menuaddon_section_id_1",
"hasMenuItem": [
{
"@type": "AddOnMenuItem",
"@id": "menuitem_addon_id_1",
"offers": [
{
"@type": "Offer",
"@id": "menuitem_addon_offer_id_1",
"price": "addon_p_1",
"priceCurrency": "USD"
}
]
},
{
"@type": "AddOnMenuItem",
"@id": "menuitem_addon_id_2",
"offers": [
{
"@type": "Offer",
"@id": "menuitem_addon_offer_id_2",
"price": "addon_p_2",
"priceCurrency": "USD"
}
]
}
]
}
]
},
{
"@type": "MenuItem",
"@id": "menuitem_id_2",
"offers": [
{
"@type": "Offer",
"@id": "menuitem_offer_id_2",
"price": "p_2",
"priceCurrency": "USD"
}
]
}
]
}
주문 처리 장바구니에 매핑된 메뉴 항목:
{
"@type": "Cart",
"lineItems": [
{
"offerId": "menuitem_offer_id_1",
"price": {
"amount": {
"currencyCode": "USD",
"units": "dollar(q_1*(p_1 + addon_q_1*addon_p_1 + addon_q_2*addon_p_2))",
"nanos": "cent(q_1*(p_1 + addon_q_1*addon_p_1 + addon_q_2*addon_p_2))"
}
},
"quantity": "q_1",
"extension": {
"@type": "FoodItemExtension",
"options": [
{
"offerId": "menuitem_addon_offer_id_1",
"price": {
"currencyCode": "USD",
"units": "dollar(addon_q_1*addon_p_1)",
"nanos": "cent(addon_q_1*addon_p_1)"
},
"quantity": "addon_q_1"
},
{
"offerId": "menuitem_addon_offer_id_2",
"price": {
"currencyCode": "USD",
"units": "dollar(addon_q_2*addon_p_2)",
"nanos": "cent(addon_q_2*addon_p_2)"
},
"quantity": "addon_q_2"
}
]
}
},
{
"offerId": "menuitem_offer_id_2",
"price": {
"amount": {
"currencyCode": "USD",
"units": "dollar(q_2*p_2)",
"nanos": "cent(q_2*p_2)"
}
},
"quantity": "q_2"
}
]
}
JSON
이 예에는 메뉴 항목 옵션, AddOnMenuItems 및 중첩된 AddOnMenuItems가 있는 메뉴 항목이 포함되어 있습니다.
메뉴 피드의 메뉴 항목:
{
"@type": "MenuItem",
"@id": "menuitem_id_1",
"hasMenuItemOptions": [
{
"@type": "MenuItemOption",
"value": {
"@type": "PropertyValue",
"name": "OPTION",
"value": "Large",
"offers": [
{
"@type": "Offer",
"@id": "menuitem_option_offer_id_1",
"price": "p_1",
"priceCurrency": "USD"
}
],
"menuAddOn": [
{
"@type": "AddOnMenuSection",
"@id": "menuitem_option_addon_section_id_1",
"hasMenuItem": [
{
"@type": "AddOnMenuItem",
"@id": "menuitem_option_addon_id_1",
"offers": [
{
"@type": "Offer",
"@id": "menuitem_option_addon_offer_id_1",
"price": "addon_p_1",
"priceCurrency": "USD"
}
]
},
{
"@type": "AddOnMenuItem",
"@id": "menuitem_option_addon_id_2",
"offers": [
{
"@type": "Offer",
"@id": "menuitem_option_addon_offer_id_2",
"price": "addon_p_2",
"priceCurrency": "USD"
}
],
"menuAddOn": [
{
"@type": "AddOnMenuSection",
"@id": "menuitem_option_subaddon_section_id_1",
"hasMenuItem": [
{
"@type": "AddOnMenuItem",
"@id": "menuitem_option_subaddon_id_1",
"offers": [
{
"@type": "Offer",
"@id": "menuitem_option_subaddon_offer_id_1",
"price": "subaddon_p_1",
"priceCurrency": "USD"
}
]
}
]
}
]
}
]
}
]
}
}
]
}
주문 처리 장바구니에 매핑된 메뉴 항목:
{
"@type": "Cart",
"lineItems": [
{
"offerId": "menuitem_option_offer_id_1",
"price": {
"amount": {
"currencyCode": "USD",
"units": "dollar(q_1*(p_1 + addon_q_1*addon_p_1 + addon_q_2*(addon_p_2 + subaddon_q_1*subaddon_p_1)))",
"nanos": "cent(q_1*(p_1 + addon_q_1*addon_p_1 + addon_q_2*(addon_p_2 + subaddon_q_1*subaddon_p_1)))"
}
},
"quantity": "q_1",
"extension": {
"@type": "FoodItemExtension",
"options": [
{
"offerId": "menuitem_option_addon_offer_id_1",
"price": {
"currencyCode": "USD",
"units": "dollar(addon_q_1*addon_p_1)",
"nanos": "cent(addon_q_1*addon_p_1)"
},
"quantity": "addon_q_1"
},
{
"offerId": "menuitem_option_addon_offer_id_2",
"price": {
"currencyCode": "USD",
"units": "dollar(addon_q_2*(addon_p_2 + subaddon_q_1*subaddon_p_1))",
"nanos": "cent(addon_q_2*(addon_p_2 + subaddon_q_1*subaddon_p_1))"
},
"quantity": "addon_q_2",
"subOptions": [
{
"offerId": "menuitem_option_subaddon_offer_id_1",
"price": {
"currencyCode": "USD",
"units": "dollar(subaddon_q_1*subaddon_p_1)",
"nanos": "cent(subaddon_q_1*subaddon_p_1)"
},
"quantity": "subaddon_q_1"
}
]
}
]
}
}
]
}
오류 처리
CheckoutRequestMessage를 처리하는 중에 문제가 발생하면 CheckoutResponse가 아닌 FoodErrorExtension가 포함된 CheckoutResponseMessage를 사용하여 응답할 수 있습니다. 이 응답을 사용하여 처리 중에 발생한 하나 이상의 오류를 식별할 수 있습니다.
오류를 처리하는 방법에는 두 가지가 있습니다.
- 복구 가능한 오류: 사용자가 주문을 제출하기 위해 장바구니를 수정하지 않아도
됩니다. 예를 들어
Cart의 항목에 가격이 변경되었다고 판단될 경우correctedProposedOrder및paymentOptions과 함께 오류 유형PRICE_CHANGED의FoodOrderError로 응답할 수 있습니다. Google은 사용자에게 변경사항을 알리지만 사용자는correctedProposedOrder를 사용하여 제출하도록 허용합니다. 사용자는 원하는 경우 뒤로 돌아가서 장바구니를 수정할 수도 있습니다. 새CheckoutRequestMessage또는SubmitOrderRequestMessage를 수신합니다. - 복구할 수 없는 오류: 사용자가 주문을 제출하기 전에 장바구니를 수정해야 합니다. 예를 들어 식당이 문을 닫았다고 판단되면
CLOSED오류 유형의FoodOrderError로 응답할 수 있습니다. Google은 사용자에게 이 사실을 알리고 상호작용을 관리하여 새 레스토랑으로 업데이트합니다. 새 장바구니에 대한 새CheckoutRequestMessage를 받게 됩니다.
일반적으로 장바구니 수준 오류는 복구할 수 없고 상품 수준 오류는 복구할 수 있도록 만듭니다. 오류 유형 및 의미의 전체 목록은 FoodOrderError를 참고하세요.
가격 변경 처리
결제 중 가격 변경
고객의 결제 요청을 처리하는 동안 가격 문제가 발생하면 다음 단계를 따르세요.
- 오류 처리에 설명된 대로
FoodErrorExtension가 포함된CheckoutResponseMessage를 사용하여CheckoutRequestMessage에 응답합니다. - 오류 응답에서
correctedProposedOrder.cart을 사용하여 가격을 올바른 값으로 업데이트합니다. Google은 수정된 주문을 접수하며 새CheckoutRequestMessage를 발행할 수 있습니다.
결제 후 ProposedOrder 변경 여부와 관계없이 Google은 최종 사용자에게 주문 확인 페이지를 표시합니다.
ProposedOrder가 수정된 경우 Google은 추가 경고를 표시하여 사용자에게 변경사항을 알릴 수 있습니다. 사용자가 주문에 동의하면
결제 요청이 더 이상 발생하지 않습니다. 이 흐름은 수정된 ProposedOrder와 함께 주문 제출을 계속합니다.
하지만 사용자는 언제든지 마음이 바뀌어 장바구니를 다시 수정할 수 있습니다. 이러한 방식으로 장바구니가 업데이트되면 Google은 새 CheckoutRequestMessage를 전송합니다.
주문 제출 중 가격 변경
주문 제출을 처리하는 동안 가격 문제가 발생하면(actions.intent.TRANSACTION_DECISION 인텐트가 트리거됨) 오류로 응답하거나 응답에서 가격을 업데이트하지 마세요. SubmitOrderRequestMessage의 가격, 수량 또는 기타 세부정보가 데이터와 일치하지 않으면 orderState를 REJECTED로 설정하여 응답하여 주문이 요청된 대로 배치할 수 없음을 나타냅니다.
그런 다음 주문 및 결제 세부정보가 유효하면 orderState를 CREATED 또는 CONFIRMED로 설정합니다. 또한 actionOrderId를 포함하여 시스템에서 주문 ID를 나타냅니다. 이 ID는 후속 업데이트를 보낼 때 사용해야 합니다.
결제를 처리할 수 없고 이미 SubmitOrderRequestMessage를
전송한 경우 orderState를 REJECTED로 설정하여
AsyncOrderUpdateRequestMessage를
전송하여 사용자에게 주문이 처리되지 않는다고 알릴 수 있습니다.
주문 제출 후 가격 변경
고객이 주문을 제출할 때 사용한 가격과 다른 가격이 표시되면 비동기 주문 업데이트 구현의 설명대로 새 가격으로 AsyncOrderUpdateRequestMessage를 발행할 수 있습니다.
비동기 주문 업데이트를 사용하여 가격을 업데이트하려면 다음 단계를 따르세요.
lineItemUpdates[x].price에서 가격을 변경하세요. 이 값은 부가기능을 포함한 항목의 총비용에 수량을 곱한 값입니다. 자세한 내용은LineItem의price필드에 대한 설명을 참고하세요.lineItemUpdates[x].reason로 설명을 입력하세요.lineItemUpdates[x].orderState를CONFIRMED로 설정합니다.
AsyncOrderUpdateRequestMessage를 전송하기 전이나 후에 결제 수단에 대한 청구를 시도할 수 있습니다. 거래가 실패하면(가격 델타가 너무 높기 때문일 수 있음) OrderUpdate에서 다음 설정과 함께 AsyncOrderUpdateRequestMessage를 전송하여 Google에 실패를 알립니다.
orderState를REJECTED로 설정합니다.label필드에 실패를 설명합니다.
결제 확인
4단계: 결제 구현에서 설명한 대로 처리 엔드포인트는 수신되는 모든 CheckoutRequestMessage에서 유효성 검사를 실행하고 CheckoutResponseMessage로 응답해야 합니다.
다음은 성공적인 유효성 검사를 위한 CheckoutResponseMessage의 예입니다.
| 사용 사례 | 구현 방법 |
|---|---|
| 사용 사례 1: 검증 성공 | CheckoutResponse를 반환합니다. ProposedOrder 및 PaymentOptions가 있어야 합니다.
ProposedOrder에는 세금, 수수료, 장바구니의 총 가격이 포함됩니다. |
JSON
{
"expectUserResponse": false,
"finalResponse": {
"richResponse": {
"items": [
{
"structuredResponse": {
"checkoutResponse": {
"proposedOrder": {
"id": "sample_proposed_order_id_1",
"otherItems": [
{
"name":"New customer discount",
"price": {
"type":"ESTIMATE",
"amount": {
"currencyCode":"USD",
"units":"-5",
"nanos": -500000000
}
},
"type": "DISCOUNT"
},
{
"name": "Delivery fee",
"price": {
"type": "ESTIMATE",
"amount": {
"currencyCode": "USD",
"units": "3",
"nanos": 500000000
}
},
"type": "DELIVERY"
},
{
"name": "Tax",
"price": {
"type": "ESTIMATE",
"amount": {
"currencyCode": "USD",
"units": "1",
"nanos": 500000000
}
},
"type": "TAX"
}
],
"cart": {
"merchant": {
"id": "https://www.exampleprovider.com/merchant/id1",
"name": "Falafel Bite"
},
"lineItems": [
{
"name": "Pita Chips",
"type": "REGULAR",
"id": "sample_item_offer_id_1",
"offerId": "https://www.exampleprovider.com/menu/item/offer/id1",
"quantity": 1,
"price": {
"type": "ESTIMATE",
"amount": {
"currencyCode": "USD",
"units": "2",
"nanos": 750000000
}
},
"subLines": [
{
"note": "Notes for this item."
}
],
"extension": {
"@type": "type.googleapis.com/google.actions.v2.orders.FoodItemExtension",
"options": [
{
"id": "sample_addon_offer_id_1",
"offerId": "https://www.exampleprovider.com/menu/item/addon/offer/id1",
"name": "Honey Mustard",
"price": {
"currencyCode": "USD"
},
"quantity": 1
},
{
"id": "sample_addon_offer_id_2",
"offerId": "https://www.exampleprovider.com/menu/item/addon/offer/id2",
"name": "BBQ Sauce",
"price": {
"currencyCode": "USD",
"nanos": 500000000
},
"quantity": 1
}
]
}
},
{
"name": "Chicken Shwarma Wrap",
"type": "REGULAR",
"id": "sample_item_offer_id_2",
"offerId": "https://www.exampleprovider.com/menu/item/offer/id2",
"quantity": 1,
"price": {
"type": "ESTIMATE",
"amount": {
"currencyCode": "USD",
"units": "8"
}
},
"extension": {
"@type": "type.googleapis.com/google.actions.v2.orders.FoodItemExtension"
}
},
{
"name": "Greek Salad",
"type": "REGULAR",
"id": "sample_item_offer_id_3",
"offerId": "https://www.exampleprovider.com/menu/item/offer/id3",
"quantity": 1,
"price": {
"type": "ESTIMATE",
"amount": {
"currencyCode": "USD",
"units": "9",
"nanos": 990000000
}
},
"extension": {
"@type": "type.googleapis.com/google.actions.v2.orders.FoodItemExtension"
}
},
{
"name": "Prawns Biryani",
"type": "REGULAR",
"id": "sample_item_offer_id_4",
"offerId": "https://www.exampleprovider.com/menu/item/offer/id4",
"quantity": 1,
"price": {
"type": "ESTIMATE",
"amount": {
"currencyCode": "USD",
"units": "15",
"nanos": 990000000
}
},
"extension": {
"@type": "type.googleapis.com/google.actions.v2.orders.FoodItemExtension"
}
}
],
"extension": {
"@type": "type.googleapis.com/google.actions.v2.orders.FoodCartExtension",
"fulfillmentPreference": {
"fulfillmentInfo": {
"delivery": {
"deliveryTimeIso8601": "P90M"
}
}
},
"location": {
"coordinates": {
"latitude": 37.788783,
"longitude": -122.41384
},
"formattedAddress": "1350 CHARLESTON ROAD, MOUNTAIN VIEW, CA, United States",
"zipCode": "94043",
"city": "Mountain View",
"postalAddress": {
"regionCode": "US",
"postalCode": "94043",
"administrativeArea": "CA",
"locality": "Mountain View",
"addressLines": [
"1350 Charleston Road"
]
},
"notes": "Gate code is #111"
}
}
},
"totalPrice": {
"type": "ESTIMATE",
"amount": {
// Represents $36.73
"currencyCode": "USD",
"units": "36",
"nanos": 730000000
}
},
"extension": {
"@type": "type.googleapis.com/google.actions.v2.orders.FoodOrderExtension",
"availableFulfillmentOptions": [
{
"fulfillmentInfo": {
"delivery": {
"deliveryTimeIso8601": "P90M"
}
},
"expiresAt": "2017-07-17T12:30:00Z"
}
]
}
},
"paymentOptions": {
"googleProvidedOptions": {
"tokenizationParameters": {
"tokenizationType": "PAYMENT_GATEWAY",
"parameters": {
"gateway": "stripe",
"stripe:publishableKey": "pk_live_stripe_client_key",
"stripe:version": "2017-04-06"
}
},
"supportedCardNetworks": [
"AMEX",
"DISCOVER",
"MASTERCARD",
"JCB",
"VISA"
],
"prepaidCardDisallowed": true
}
}
}
}
}
]
}
}
}
배송지 주소 확인
처리 엔드포인트는 각 CheckoutRequestMessage에 포함된 배달 주소의 유효성을 검사해야 합니다.
배송지 주소에 문제가 있는 경우(예: 배송 서비스 범위를 벗어나는 경우) 처리에서 반환된 CheckoutResponseMessage에는 적절한 유형의 FoodOrderError가 포함되어야 합니다.
| 사용 사례 | 구현 방법 |
|---|---|
| 사용 사례 1: 배송지 주소가 범위를 벗어났거나 배송지 주소에 문제가 있어 검증에 실패했습니다. | 오류 유형 OUT_OF_SERVICE_AREA의 FoodOrderError와 함께 FoodErrorExtension를 반환합니다. |
JSON
{
"expectUserResponse": false,
"finalResponse": {
"richResponse": {
"items": [
{
"structuredResponse": {
"error": {
"@type": "type.googleapis.com/google.actions.v2.orders.FoodErrorExtension",
"foodOrderErrors": [
{
"error": "OUT_OF_SERVICE_AREA",
"description": "Sorry, the restaurant cannot deliver to your address."
}
]
}
}
}
]
}
}
}
최소 주문 금액 검증
처리 엔드포인트는 각 CheckoutRequestMessage의 최소 주문 금액을 검증해야 합니다.
최소 주문 금액이 충족되지 않으면 처리에서 반환된 CheckoutResponseMessage에 오류 유형 REQUIREMENTS_NOT_MET의 FoodOrderError가 포함되어야 합니다.
| 사용 사례 | 구현 방법 |
|---|---|
| 사용 사례 1: 최소 주문 금액이 충족되지 않아 검증에 실패했습니다. | 오류 유형 REQUIREMENTS_NOT_MET의 FoodOrderError와 함께 FoodErrorExtension를 반환합니다. |
JSON
{
"expectUserResponse": false,
"finalResponse": {
"richResponse": {
"items": [
{
"structuredResponse": {
"error": {
"@type": "type.googleapis.com/google.actions.v2.orders.FoodErrorExtension",
"foodOrderErrors": [
{
"error": "REQUIREMENTS_NOT_MET",
"description": "The cart subtotal must be over $20."
}
]
}
}
}
]
}
}
}
주문 기간 유효성 검사
처리 엔드포인트는 각 CheckoutRequestMessage의 주문 기간에 영향을 줄 수 있는 요소의 유효성을 검사해야 합니다.
예를 들어 레스토랑이 문을 닫았거나 더 이상 주문을 받지 않는 경우 처리에 의해 반환된 CheckoutResponseMessage에는 각각 CLOSED 또는 NO_CAPACITY 오류 유형의 FoodOrderError가 포함되어야 합니다.
| 사용 사례 | 구현 방법 |
|---|---|
| 사용 사례 1: 레스토랑이 폐업했거나 더 이상 지원되지 않아 검증에 실패했습니다. | 오류 유형 CLOSED의 FoodOrderError와 함께 FoodErrorExtension를 반환합니다. |
| 사용 사례 2: 음식점이 바쁘고 현재 주문을 받지 않아 검증에 실패했습니다. | 오류 유형 NO_CAPACITY의 FoodOrderError와 함께 FoodErrorExtension를 반환합니다. |
JSON
{
"expectUserResponse": false,
"finalResponse": {
"richResponse": {
"items": [
{
"structuredResponse": {
"error": {
"@type": "type.googleapis.com/google.actions.v2.orders.FoodErrorExtension",
"foodOrderErrors": [
{
"error": "CLOSED",
"description": "The restaurant is closed."
}
]
}
}
}
]
}
}
}
JSON
{
"expectUserResponse": false,
"finalResponse": {
"richResponse": {
"items": [
{
"structuredResponse": {
"error": {
"@type": "type.googleapis.com/google.actions.v2.orders.FoodErrorExtension",
"foodOrderErrors": [
{
"error": "NO_CAPACITY",
"description": "Sorry, the restaurant is busy at the moment."
}
]
}
}
}
]
}
}
}
장바구니 상품 확인
처리 엔드포인트는 CheckoutRequestMessage에 포함된 각 장바구니 항목의 가격 및 재고를 검증해야 합니다.
재고 또는 가격이 변경된 경우 처리에서 반환된 CheckoutResponseMessage에는 각각 AVAILABILITY_CHANGED 또는 PRICE_CHANGED 오류 유형의 FoodOrderError가 포함되어야 합니다.
| 사용 사례 | 구현 방법 |
|---|---|
| 사용 사례 1: 일부 메뉴 항목 또는 맞춤설정이 유효하지 않거나 재고가 없어 검증에 실패했습니다. | 오류 유형 AVAILABILITY_CHANGED의 correctedProposedOrder, PaymentOptions, FoodOrderError로 FoodErrorExtension를 반환합니다. 잘못된 항목은 CorrectedProposedOrder에서 삭제해야 합니다. |
| 사용 사례 2: 일부 메뉴 항목 또는 맞춤설정이 유효하지 않거나 재고가 없어 검증에 실패했습니다. 수정된 장바구니가 더 이상 최소 주문 금액 요구사항을 충족하지 않습니다. | AVAILABILITY_CHANGED 및 REQUIREMENTS_NOT_MET 오류 유형의 FoodOrderError와 함께 FoodErrorExtension를 반환합니다. |
| 사용 사례 3: 일부 메뉴 항목 또는 맞춤설정 가격이 변경되어 검증에 실패했습니다. | 오류 유형 PRICE_CHANGED의 correctedProposedOrder, PaymentOptions, FoodOrderError로 FoodErrorExtension를 반환합니다. 오래된 가격은 CorrectedProposedOrder에서 업데이트해야 합니다. |
| 사용 사례 4: 일부 메뉴 항목 또는 맞춤설정 가격이 변경되어 검증에 실패했습니다. 수정된 장바구니가 더 이상 최소 주문 금액 요구사항을 충족하지 않습니다. | PRICE_CHANGED 및 REQUIREMENTS_NOT_MET 오류 유형의 FoodOrderError와 함께 FoodErrorExtension를 반환합니다. |
JSON
{
"expectUserResponse": false,
"finalResponse": {
"richResponse": {
"items": [
{
"structuredResponse": {
"error": {
"@type": "type.googleapis.com/google.actions.v2.orders.FoodErrorExtension",
"foodOrderErrors": [
{
"error": "AVAILABILITY_CHANGED",
"id": "sample_item_offer_id_1",
"description": "The item is no longer available."
},
{
"error": "AVAILABILITY_CHANGED",
"id": "sample_item_offer_id_2",
"description": "The item is no longer available."
}
],
"correctedProposedOrder": {
"id": "sample_corrected_proposed_order_id_1",
"otherItems": [
{
"name":"New customer discount",
"price": {
"type":"ESTIMATE",
"amount": {
"currencyCode":"USD",
"units":"-5",
"nanos": -500000000
}
},
"type": "DISCOUNT"
},
{
"name": "Delivery fee",
"price": {
"type": "ESTIMATE",
"amount": {
"currencyCode": "USD",
"units": "3",
"nanos": 500000000
}
},
"type": "DELIVERY"
},
{
"name": "Tax",
"price": {
"type": "ESTIMATE",
"amount": {
"currencyCode": "USD",
"units": "1",
"nanos": 500000000
}
},
"type": "TAX"
}
],
"cart": {
"merchant": {
"id": "https://www.exampleprovider.com/merchant/id1",
"name": "Falafel Bite"
},
"lineItems": [
{
"name": "Greek Salad",
"type": "REGULAR",
"id": "sample_item_offer_id_3",
"offerId": "https://www.exampleprovider.com/menu/item/offer/id3",
"quantity": 1,
"price": {
"type": "ESTIMATE",
"amount": {
"currencyCode": "USD",
"units": "9",
"nanos": 990000000
}
},
"extension": {
"@type": "type.googleapis.com/google.actions.v2.orders.FoodItemExtension"
}
},
{
"name": "Prawns Biryani",
"type": "REGULAR",
"id": "sample_item_offer_id_4",
"offerId": "https://www.exampleprovider.com/menu/item/offer/id4",
"quantity": 1,
"price": {
"type": "ESTIMATE",
"amount": {
"currencyCode": "USD",
"units": "15",
"nanos": 990000000
}
},
"extension": {
"@type": "type.googleapis.com/google.actions.v2.orders.FoodItemExtension"
}
}
],
"extension": {
"@type": "type.googleapis.com/google.actions.v2.orders.FoodCartExtension",
"fulfillmentPreference": {
"fulfillmentInfo": {
"delivery": {
"deliveryTimeIso8601": "P90M"
}
}
},
"location": {
"coordinates": {
"latitude": 37.788783,
"longitude": -122.41384
},
"formattedAddress": "1350 CHARLESTON ROAD, MOUNTAIN VIEW, CA, United States",
"zipCode": "94043",
"city": "Mountain View",
"postalAddress": {
"regionCode": "US",
"postalCode": "94043",
"administrativeArea": "CA",
"locality": "Mountain View",
"addressLines": [
"1350 Charleston Road"
]
},
"notes": "Gate code is #111"
}
}
},
"totalPrice": {
"type": "ESTIMATE",
"amount": {
"currencyCode": "USD",
"units": "36",
"nanos": 730000000
}
},
"extension": {
"@type": "type.googleapis.com/google.actions.v2.orders.FoodOrderExtension",
"availableFulfillmentOptions": [
{
"fulfillmentInfo": {
"delivery": {
"deliveryTimeIso8601": "P90M"
}
},
"expiresAt": "2017-07-17T12:30:00Z"
}
]
}
},
"paymentOptions": {
"googleProvidedOptions": {
"tokenizationParameters": {
"tokenizationType": "PAYMENT_GATEWAY",
"parameters": {
"gateway": "stripe",
"stripe:publishableKey": "pk_live_stripe_client_key",
"stripe:version": "2017-04-06"
}
},
"supportedCardNetworks": [
"AMEX",
"DISCOVER",
"MASTERCARD",
"JCB",
"VISA"
],
"prepaidCardDisallowed": true
}
}
}
}
}
]
}
}
}
JSON
{
"expectUserResponse": false,
"finalResponse": {
"richResponse": {
"items": [
{
"structuredResponse": {
"error": {
"@type": "type.googleapis.com/google.actions.v2.orders.FoodErrorExtension",
"foodOrderErrors": [
{
"error": "REQUIREMENTS_NOT_MET",
"description": "The cart subtotal must be over $20."
},
{
"error": "AVAILABILITY_CHANGED",
"id": "cart_lineitem_id"
"description": "cart_lineitem_id is no longer available."
}
]
}
}
}
]
}
}
}
JSON
{
"expectUserResponse": false,
"finalResponse": {
"richResponse": {
"items": [
{
"structuredResponse": {
"error": {
"@type": "type.googleapis.com/google.actions.v2.orders.FoodErrorExtension",
"foodOrderErrors": [
{
"error": "PRICE_CHANGED",
"id": "sample_item_offer_id_1",
"description": "The price has changed.",
"updatedPrice": {
"currencyCode": "USD",
"units": "2",
"nanos": 750000000
}
},
{
"error": "PRICE_CHANGED",
"id": "sample_item_offer_id_2",
"description": "The price has changed.",
"updatedPrice": {
"currencyCode": "USD",
"units": "8"
}
}
],
"correctedProposedOrder": {
"id": "sample_corrected_proposed_order_id_1",
"otherItems": [
{
"name":"New customer discount",
"price": {
"type":"ESTIMATE",
"amount": {
"currencyCode":"USD",
"units":"-5",
"nanos": -500000000
}
},
"type": "DISCOUNT"
},
{
"name": "Delivery fee",
"price": {
"type": "ESTIMATE",
"amount": {
"currencyCode": "USD",
"units": "3",
"nanos": 500000000
}
},
"type": "DELIVERY"
},
{
"name": "Tax",
"price": {
"type": "ESTIMATE",
"amount": {
"currencyCode": "USD",
"units": "1",
"nanos": 500000000
}
},
"type": "TAX"
}
],
"cart": {
"merchant": {
"id": "https://www.exampleprovider.com/merchant/id1",
"name": "Falafel Bite"
},
"lineItems": [
{
"name": "Pita Chips",
"type": "REGULAR",
"id": "sample_item_offer_id_1",
"offerId": "https://www.exampleprovider.com/menu/item/offer/id1",
"quantity": 1,
"price": {
"type": "ESTIMATE",
"amount": {
"currencyCode": "USD",
"units": "2",
"nanos": 750000000
}
},
"subLines": [
{
"note": "Notes for this item."
}
],
"extension": {
"@type": "type.googleapis.com/google.actions.v2.orders.FoodItemExtension",
"options": [
{
"id": "sample_addon_offer_id_1",
"offerId": "https://www.exampleprovider.com/menu/item/addon/offer/id1",
"name": "Honey Mustard",
"price": {
"currencyCode": "USD"
},
"quantity": 1
},
{
"id": "sample_addon_offer_id_2",
"offerId": "https://www.exampleprovider.com/menu/item/addon/offer/id2",
"name": "BBQ Sauce",
"price": {
"currencyCode": "USD",
"nanos": 500000000
},
"quantity": 1
}
]
}
},
{
"name": "Chicken Shwarma Wrap",
"type": "REGULAR",
"id": "sample_item_offer_id_2",
"offerId": "https://www.exampleprovider.com/menu/item/offer/id2",
"quantity": 1,
"price": {
"type": "ESTIMATE",
"amount": {
"currencyCode": "USD",
"units": "8"
}
},
"extension": {
"@type": "type.googleapis.com/google.actions.v2.orders.FoodItemExtension"
}
},
{
"name": "Greek Salad",
"type": "REGULAR",
"id": "sample_item_offer_id_3",
"offerId": "https://www.exampleprovider.com/menu/item/offer/id3",
"quantity": 1,
"price": {
"type": "ESTIMATE",
"amount": {
"currencyCode": "USD",
"units": "9",
"nanos": 990000000
}
},
"extension": {
"@type": "type.googleapis.com/google.actions.v2.orders.FoodItemExtension"
}
},
{
"name": "Prawns Biryani",
"type": "REGULAR",
"id": "sample_item_offer_id_4",
"offerId": "https://www.exampleprovider.com/menu/item/offer/id4",
"quantity": 1,
"price": {
"type": "ESTIMATE",
"amount": {
"currencyCode": "USD",
"units": "15",
"nanos": 990000000
}
},
"extension": {
"@type": "type.googleapis.com/google.actions.v2.orders.FoodItemExtension"
}
}
],
"extension": {
"@type": "type.googleapis.com/google.actions.v2.orders.FoodCartExtension",
"fulfillmentPreference": {
"fulfillmentInfo": {
"delivery": {
"deliveryTimeIso8601": "P90M"
}
}
},
"location": {
"coordinates": {
"latitude": 37.788783,
"longitude": -122.41384
},
"formattedAddress": "1350 CHARLESTON ROAD, MOUNTAIN VIEW, CA, United States",
"zipCode": "94043",
"city": "Mountain View",
"postalAddress": {
"regionCode": "US",
"postalCode": "94043",
"administrativeArea": "CA",
"locality": "Mountain View",
"addressLines": [
"1350 Charleston Road"
]
},
"notes": "Gate code is #111"
}
}
},
"totalPrice": {
"type": "ESTIMATE",
"amount": {
"currencyCode": "USD",
"units": "36",
"nanos": 730000000
}
},
"extension": {
"@type": "type.googleapis.com/google.actions.v2.orders.FoodOrderExtension",
"availableFulfillmentOptions": [
{
"fulfillmentInfo": {
"delivery": {
"deliveryTimeIso8601": "P90M"
}
},
"expiresAt": "2017-07-17T12:30:00Z"
}
]
}
},
"paymentOptions": {
"googleProvidedOptions": {
"tokenizationParameters": {
"tokenizationType": "PAYMENT_GATEWAY",
"parameters": {
"gateway": "stripe",
"stripe:publishableKey": "pk_live_stripe_client_key",
"stripe:version": "2017-04-06"
}
},
"supportedCardNetworks": [
"AMEX",
"DISCOVER",
"MASTERCARD",
"JCB",
"VISA"
],
"prepaidCardDisallowed": true
}
}
}
}
}
]
}
}
}
JSON
{
"expectUserResponse": false,
"finalResponse": {
"richResponse": {
"items": [
{
"structuredResponse": {
"error": {
"@type": "type.googleapis.com/google.actions.v2.orders.FoodErrorExtension",
"foodOrderErrors": [
{
"error": "REQUIREMENTS_NOT_MET",
"description": "The cart subtotal must be over $20."
},
{
"error": "PRICE_CHANGED",
"id": "cart_lineitem_id"
"description": "cart_lineitem_id price has been updated."
"updatedPrice": {
"currencyCode": "USD",
"units": "2",
"nanos": 750000000
}
}
]
}
}
}
]
}
}
}
주문 확인 제출
7단계: 제출 주문 구현에서 설명한 대로 처리 엔드포인트는 수신되는 모든 SubmitOrderRequestMessage에서 유효성 검사를 실행하고 SubmitOrderResponseMessage로 응답해야 합니다.
다음은 성공적인 유효성 검사를 위한 SubmitOrderResponseMessage의 예입니다.
| 사용 사례 | 구현 방법 |
|---|---|
| 사용 사례 1: 주문이 생성됨 | 주문 상태가 CREATED인 SubmitOrderResponseMessage actionOrderId, userVisibleId, orderManagementActions, estimatedFulfillmentTime가 있어야 합니다. |
| 사용 사례 2: 결제 문제로 인해 주문이 거부됨 | 주문 상태가 REJECTED인 SubmitOrderResponseMessage PAYMENT_DECLINED 유형의 actionOrderId, userVisibleId, orderManagementActions, rejectionInfo가 있어야 합니다. |
| 사용 사례 3: 사용자가 금지된 것으로 표시되어 주문이 거부됨 | 주문 상태가 REJECTED인 SubmitOrderResponseMessage INELIGIBLE 유형의 actionOrderId, userVisibleId, orderManagementActions, rejectionInfo가 있어야 합니다. |
| 사용 사례 4: 사용자 정보가 불완전하거나 잘못되어 주문이 거부되었습니다. | 주문 상태가 REJECTED인 SubmitOrderResponseMessage INELIGIBLE 유형의 actionOrderId, userVisibleId, orderManagementActions, rejectionInfo가 있어야 합니다. |
| 사용 사례 5: 알 수 없는 이유로 주문이 거부됨 | 주문 상태가 REJECTED인 SubmitOrderResponseMessage UNKNOWN 유형의 actionOrderId, userVisibleId, orderManagementActions, rejectionInfo가 있어야 합니다. |
JSON
{
"expectUserResponse": false,
"finalResponse": {
"richResponse": {
"items": [
{
"structuredResponse": {
"orderUpdate": {
"actionOrderId": "sample_action_order_id",
"orderState": {
"state": "CREATED",
"label": "Order received"
},
"updateTime": "2017-05-10T02:30:00.000Z",
"orderManagementActions": [
{
"type": "CUSTOMER_SERVICE",
"button": {
"title": "Contact customer service",
"openUrlAction": {
"url": "mailto:support@example.com"
}
}
},
{
"type": "EMAIL",
"button": {
"title": "Email restaurant",
"openUrlAction": {
"url": "mailto:person@example.com"
}
}
},
{
"type": "CALL",
"button": {
"title": "Call restaurant",
"openUrlAction": {
"url": "tel:+16505554679"
}
}
},
{
"type": "VIEW_DETAILS",
"button": {
"title": "View order",
"openUrlAction": {
"url": "https://orderview.partner.com?orderid=sample_action_order_id"
}
}
}
]
}
}
}
]
}
}
}
JSON
{
"expectUserResponse": false,
"finalResponse": {
"richResponse": {
"items": [
{
"structuredResponse": {
"orderUpdate": {
"actionOrderId": "sample_action_order_id",
"orderState": {
"state": "REJECTED",
"label": "Order rejected"
},
"updateTime": "2017-05-10T02:30:00.000Z",
"rejectionInfo": {
"type": "PAYMENT_DECLINED",
"reason": "Insufficient funds"
},
"orderManagementActions": [
{
"type": "CUSTOMER_SERVICE",
"button": {
"title": "Contact customer service",
"openUrlAction": {
"url": "mailto:support@example.com"
}
}
},
{
"type": "EMAIL",
"button": {
"title": "Email restaurant",
"openUrlAction": {
"url": "mailto:person@example.com"
}
}
},
{
"type": "CALL",
"button": {
"title": "Call restaurant",
"openUrlAction": {
"url": "tel:+16505554679"
}
}
},
{
"type": "VIEW_DETAILS",
"button": {
"title": "View order",
"openUrlAction": {
"url": "https://orderview.partner.com?orderid=sample_action_order_id"
}
}
}
]
}
}
}
]
}
}
}
JSON
{
"expectUserResponse": false,
"finalResponse": {
"richResponse": {
"items": [
{
"structuredResponse": {
"orderUpdate": {
"actionOrderId": "sample_action_order_id",
"orderState": {
"state": "REJECTED",
"label": "Order rejected"
},
"updateTime": "2017-05-10T02:30:00.000Z",
"rejectionInfo": {
"type": "INELIGIBLE",
"reason": "Sorry, we are not able to take orders from this user"
},
"orderManagementActions": [
{
"type": "CUSTOMER_SERVICE",
"button": {
"title": "Contact customer service",
"openUrlAction": {
"url": "mailto:support@example.com"
}
}
},
{
"type": "EMAIL",
"button": {
"title": "Email restaurant",
"openUrlAction": {
"url": "mailto:person@example.com"
}
}
},
{
"type": "CALL",
"button": {
"title": "Call restaurant",
"openUrlAction": {
"url": "tel:+16505554679"
}
}
},
{
"type": "VIEW_DETAILS",
"button": {
"title": "View order",
"openUrlAction": {
"url": "https://orderview.partner.com?orderid=sample_action_order_id"
}
}
}
]
}
}
}
]
}
}
}
JSON
{
"expectUserResponse": false,
"finalResponse": {
"richResponse": {
"items": [
{
"structuredResponse": {
"orderUpdate": {
"actionOrderId": "sample_action_order_id",
"orderState": {
"state": "REJECTED",
"label": "Order rejected"
},
"updateTime": "2017-05-10T02:30:00.000Z",
"rejectionInfo": {
"type": "INELIGIBLE",
"reason": "Sorry, the phone number must not be blank"
},
"orderManagementActions": [
{
"type": "CUSTOMER_SERVICE",
"button": {
"title": "Contact customer service",
"openUrlAction": {
"url": "mailto:support@example.com"
}
}
},
{
"type": "EMAIL",
"button": {
"title": "Email restaurant",
"openUrlAction": {
"url": "mailto:person@example.com"
}
}
},
{
"type": "CALL",
"button": {
"title": "Call restaurant",
"openUrlAction": {
"url": "tel:+16505554679"
}
}
},
{
"type": "VIEW_DETAILS",
"button": {
"title": "View order",
"openUrlAction": {
"url": "https://orderview.partner.com?orderid=sample_action_order_id"
}
}
}
]
}
}
}
]
}
}
}
JSON
{
"expectUserResponse": false,
"finalResponse": {
"richResponse": {
"items": [
{
"structuredResponse": {
"orderUpdate": {
"actionOrderId": "sample_action_order_id",
"orderState": {
"state": "REJECTED",
"label": "Order rejected"
},
"updateTime": "2017-05-10T02:30:00.000Z",
"rejectionInfo": {
"type": "UNKNOWN",
"reason": "Sorry, there is something wrong with this order."
},
"orderManagementActions": [
{
"type": "CUSTOMER_SERVICE",
"button": {
"title": "Contact customer service",
"openUrlAction": {
"url": "mailto:support@example.com"
}
}
},
{
"type": "EMAIL",
"button": {
"title": "Email restaurant",
"openUrlAction": {
"url": "mailto:person@example.com"
}
}
},
{
"type": "CALL",
"button": {
"title": "Call restaurant",
"openUrlAction": {
"url": "tel:+16505554679"
}
}
},
{
"type": "VIEW_DETAILS",
"button": {
"title": "View order",
"openUrlAction": {
"url": "https://orderview.partner.com?orderid=sample_action_order_id"
}
}
}
]
}
}
}
]
}
}
}