처리에서 사용자가 수령을 예약할 수 있도록 지원을 추가할 수 있습니다.
음식 배달 주문을
예약할 수 있습니다 이 지원을 구현하기 전
사용자의 영업시간을 지정하는 서비스 인벤토리 피드를 만듭니다.
인벤토리 피드 스키마에 설명된 대로 사전 주문을 할 수 있습니다.
(AdvanceServiceDeliveryHoursSpecification)
사전 주문 슬롯
Google은 최대 7일까지 15분 단위로 사전 주문 슬롯을 제안합니다.
주문 처리 시간에 따라 미리 예약하거나
AdvanceServiceDeliveryHoursSpecification)을 입력합니다.
제안된 미리 주문 슬롯을 가져오려면
결제 시 FoodCartExtension 객체의 fulfillmentPreference 필드:
PickupInfo.pickupTimeIso8601DeliveryInfo.deliveryTimeIso8601
결제 시 사전 주문 구현
아래 표에는 처리의 사용자가 주문하려고 할 때 결제 시 응답 응답
| 시나리오 | 처리 동작 |
|---|---|
| 요청한 시간대에 대해 사전 주문을 처리할 수 있습니다. | P0M 동의('최대한 빨리') 또는
다음 항목으로 ProposedOrder을(를) 만들어 FUTURE_SLOT 장바구니를 만듭니다.
있습니다. 슬롯을 허용하는 결제 응답의 예는 다음을 참조하세요.
이 코드 스니펫에 포함되어야 합니다. |
| 요청한 시간대에 대해 사전 주문을 처리할 수 없습니다. | 처리는 다음을 실행해야 합니다.
<ph type="x-smartling-placeholder">
대체 슬롯을 제안하는 결제 응답의 예는 다음을 참조하세요. 이 코드 스니펫에 포함되어야 합니다. |
주문 처리를 위한 대체 슬롯
결제 시 Google에서 제안한 미리 주문 시간대가 적합하지 않은 경우
fulfillment는 CheckoutResponseMessage를 사용하여 대안을 제안할 수 있습니다.
객체를 지정합니다.
대체 사전 주문 시간대를 지정하려면
FoodErrorExtension을 클릭하고 다음 값을 설정합니다.
foodOrderErrors매개변수에 오류 유형 (예:UNAVAILABLE_SLOT,NO_CAPACITY또는CLOSED).correctedProposedOrder매개변수에 대체P0M또는availableFulfillmentOptions를 통한FUTURE_SLOT값
대체 시간대는 주문일로부터 7일 이내여야 합니다. 사용자가 요청한 장바구니가 광고를 표시할 수 있는 충족되어야 합니다.
예를 들어 점심 특판 행사가 월요일부터 금요일까지만 제공된다고 가정해 보겠습니다. 오전 11시부터 오후 1시까지입니다. 그런 다음 사용자가 장바구니에 점심 특선을 추가하려고 하지만 사용할 수 없습니다. 이 경우 처리는 장바구니에 점심 특선을 보관하고 오전 11시~오후 1시 시간대만 반환 앞으로 7일 동안
correctedProposedOrder.Cart.fulfillmentPreference 객체를 생략해야 합니다.
확인하시기 바랍니다.
예약 가능한 시간대가 없거나 음식점이나 서비스가
사전 주문을 지원하는 경우
correctedProposedOrder
처리와 Google 간의 JSON 메시지는 아래 예를 참고하세요. 사전 주문에 대한 결제 요청 및 응답 흐름에서 선주문이 가능한 음식점 또는 서비스
예: 배송 슬롯이 포함된 CheckoutRequest
아래 스니펫은 사전 주문이 포함된 결제 요청의 예를 보여줍니다. 있습니다.
{
"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": "Cucina Venti"
},
"lineItems": [
{
"name": "Sizzling Prawns Dinner",
"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": "16",
"nanos": 750000000
}
},
}
],
"extension": {
"@type": "type.googleapis.com/google.actions.v2.orders.FoodCartExtension",
"fulfillmentPreference": {
"fulfillmentInfo": {
"delivery": {
// Deliver at 6:30PM.
"deliveryTimeIso8601": "2017-12-14T18:30:00-07:00"
}
}
},
"location": {
...
}
}
}
}
]
}
]
}
예: 슬롯을 수락하는 CheckoutResponse
아래 스니펫은 fulfillment가 제안된 사전 주문 슬롯을 수락합니다.
{
"expectUserResponse": false,
"finalResponse": {
"richResponse": {
"items": [
{
"structuredResponse": {
"checkoutResponse": {
"proposedOrder": {
"id": "sample_proposed_order_id_1",
"cart": {
"merchant": {
"id": "https://www.exampleprovider.com/merchant/id1",
"name": "Falafel Bite"
},
"lineItems": [
{
"name": "Sizzling Prawns Dinner",
"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": "16",
"nanos": 750000000
}
},
}
],
"extension": {
"@type": "type.googleapis.com/google.actions.v2.orders.FoodCartExtension",
"fulfillmentPreference": {
"fulfillmentInfo": {
"delivery": {
// Same as the time in the request.
"deliveryTimeIso8601": "2017-12-14T18:30:00-07:00"
}
}
},
"location": {
...
}
}
},
"totalPrice": {
"type": "ESTIMATE",
"amount": {
// Represents $16.75
"currencyCode": "USD",
"units": "16",
"nanos": 750000000
}
},
"extension": {
"@type": "type.googleapis.com/google.actions.v2.orders.FoodOrderExtension",
// Send whole proposed order back.
"availableFulfillmentOptions": [
"fulfillmentInfo": {
"delivery": {
// Same as the time in the request.
"deliveryTimeIso8601": "2017-12-14T18:30:00-07:00"
}
}
]
}
},
"paymentOptions": {
...
}
}
}
}
]
}
}
}
예: 대체 슬롯이 포함된 CheckoutResponse
아래 스니펫은 fulfillment가
대체 사전 주문 슬롯을 제안합니다. Note that the
correctedProposedOrder.Cart.fulfillmentPreference 객체는
있습니다.
{
"expectUserResponse": false,
"finalResponse": {
"richResponse": {
"items": [
{
"structuredResponse": {
"error": {
"@type": "type.googleapis.com/google.actions.v2.orders.FoodErrorExtension",
"foodOrderErrors": [
{
"error": "UNAVAILABLE_SLOT", // Cart level error
"description": "The restaurant is closed."
}
],
"correctedProposedOrder": {
// Send whole original cart back,
// without the fulfillmentPreference.
"cart": {
...
},
"otherItems": {
...
},
"totalPrice": {
...
},
"extension": {
"@type": "type.googleapis.com/google.actions.v2.orders.FoodOrderExtension",
"availableFulfillmentOptions": [
"fulfillmentInfo": {
"delivery": {
"deliveryTimeIso8601": "2017-12-14T19:00:00-07:00"
}
},
"fulfillmentInfo": {
"delivery": {
"deliveryTimeIso8601": "2017-12-14T19:30:00-07:00"
}
},
"fulfillmentInfo": {
"delivery": {
"deliveryTimeIso8601": "2017-12-14T20:00:00-07:00"
}
}
]
}
},
"paymentOptions": {
...
}
}
}
}
]
}
}
}
주문 제출 시 사전 주문 구현
주문 제출 시 사전 주문 슬롯에 문제가 있으면
SubmitOrderResponseMessage에는 이유를 포함해야 합니다 (예:
UNAVAILABLE_SLOT 또는 UNKNOWN)을 RejectionInfo 객체에 입력합니다.
다음에서 주문 상태를 CREATED에서 CONFIRMED로 업데이트합니다.
제공업체가 주문을 수락하면 OrderState 객체입니다.
사용자에게 보내는 확인 이메일에서
선택한 시간대를 확인하세요.
주문 처리를 통해 나중에 음식점으로 주문이 전송되는 경우 Google에 다음을 전송하세요. 비동기 주문 업데이트 작업을 사용하여 업데이트합니다.
처리의 주문 제출 응답의 OrderUpdate 객체에서 또는
후속 비동기식 주문 업데이트에는
estimatedFulfillmentTimeIso8601를 다음과 같이 설정한 값
- 주문 상태가
CREATED또는CONFIRMED이면 값을 사용자가 사전 주문을 위해 예약한 배달 또는 수령 시간입니다. - 식당의 예상 배송 기간이 더 정확할 때 또는 서비스의 경우 값을 배송 또는 수령 시간의 예상 시간으로 설정합니다.
예: 게재 슬롯이 있는 SubmitOrderRequest
아래 스니펫은 표시됩니다.
{
"inputs": [
{
"intent": "actions.intent.TRANSACTION_DECISION",
"arguments": [
{
"transactionDecisionValue": {
"order": {
"finalOrder": {
"cart": {
"notes": "Guest prefers their food to be hot when it is delivered.",
"merchant": {
"id": "https://www.exampleprovider.com/merchant/id1",
"name": "Cucina Venti"
},
"lineItems": [
{
"name": "Sizzling Prawns Dinner",
"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": "16",
"nanos": 750000000
}
}
}
],
"extension": {
"@type": "type.googleapis.com/google.actions.v2.orders.FoodCartExtension",
"fulfillmentPreference": {
"fulfillmentInfo": {
"delivery": {
"deliveryTimeIso8601": "2017-12-14T18:30:00-07:00"
}
}
}
"contact": {
...
}
}
},
"totalPrice": {
"type": "ESTIMATE",
"amount": {
"currencyCode": "USD",
"units": "16",
"nanos": 750000000
}
},
"id": "sample_final_order_id",
"extension": {
// Send whole proposed order back.
"availableFulfillmentOptions": [
"fulfillmentInfo": {
"delivery": {
"deliveryTimeIso8601": "2017-12-14T18:30:00-07:00"
}
]
}
},
"googleOrderId": "sample_google_order_id",
"orderDate": "2017-07-17T12:00:00Z",
"paymentInfo": {
...
}
}
}
}
]
}
]
}
예: 주문을 수락하는 SubmitOrderResponse
아래 스니펫은 fulfillment가 사용자의 사전 주문을 수락했음을 확인합니다.
{
"expectUserResponse": false,
"finalResponse": {
"richResponse": {
"items": [
{
"structuredResponse": {
"orderUpdate": {
"actionOrderId": "sample_action_order_id",
"orderState": {
"state": "CREATED",
"label": "Order placed"
},
"receipt": {
"userVisibleOrderId": "userVisibleId1234"
},
"updateTime": "2017-07-17T12:00:00Z",
"orderManagementActions": [
...
],
"infoExtension": {
"@type": "type.googleapis.com/google.actions.v2.orders.FoodOrderUpdateExtension",
// Same as the user selected time.
"estimatedFulfillmentTimeIso8601": "2017-12-14T18:30:00-07:00"
}
}
}
}
]
}
}
}
예: SubmitOrderResponse가 슬롯 사용 불가로 인해 주문 거부
아래 스니펫은 처리에서 슬롯을 사용할 수 없어 사용자의 사전 주문을 거부합니다.
{
"expectUserResponse": false,
"finalResponse": {
"richResponse": {
"items": [
{
"structuredResponse": {
"orderUpdate": {
"actionOrderId": "sample_action_order_id",
"orderState": {
"state": "REJECTED",
"label": "Unavailable slot"
},
"rejectionInfo": {
// Note that this UNAVAILABLE_SLOT is different from the enum
// with the same name proposed for FoodOrderError.
"state": "UNAVAILABLE_SLOT",
"label": "Unavailable slot"
},
"updateTime": "2017-07-17T12:00:00Z",
"orderManagementActions": [
...
]
}
}
}
]
}
}
}
사전 주문 예
AdvanceServiceDeliveryHoursSpecification 유형을 사용하여
사용자가 미리 주문을 예약할 수 있도록 배송 또는 수령 시간을 제공합니다.
참고: 두 개의 별도 기간을 지정해야 합니다.
: 사용자가 상품을 주문할 수 있는 시점을 지정하는 주문 기간
주문, 주문이 처리되는 시기를 지정하는 처리 기간이 포함됩니다. 이
OpeningHoursSpecificationServiceDeliveryHoursSpecificationAdvanceServiceDeliveryHoursSpecification
다음 예에서는 사전 주문 수락을 위한 서비스의 시간을 정의합니다. 15분의 서비스 간격으로 사용됩니다
{ "hoursAvailable": [ { "@type": "OpeningHoursSpecification", "opens": "T00:00:00", // Ordering available 24 hours "closes": "T23:59:59", "deliveryHours": [ { "@type": "ServiceDeliveryHoursSpecification", "opens": "T09:00:00", // ASAP orders b/w 9am and 8:59:59pm "closes": "T21:00:00", "deliveryLeadTime": { "value": "60", "unitCode": "MIN" } }, { "@type": "AdvanceServiceDeliveryHoursSpecification", "opens": "T10:00:00", // Delivery between 10AM and 7:59:59PM "closes": "T20:00:00", "serviceTimeInterval": "PT15M", // in slots spaced 15 minutes apart (ISO8601) "advanceBookingRequirement": { "minValue": 60, // The slot should be at least 60 mins away "maxValue": 8640, // but not more than 6 days away "unitCode": "MIN" } } ] } ] }
다음 예는 서비스가 공개되도록 지정하는 방법을 보여줍니다. 크리스마스 당일에는 당일 주문 가능하지만 있습니다. 이 예시는 다음 시나리오를 지원합니다.
- 12월 25일에 주문하면 당일 배송이 가능합니다.
- 사용자는 12월 25일에 예정된 배송 상품에 대해 사전 주문을 할 수 있습니다. 12월 27일에 사용할 수 있습니다.
- 사용자는 12월 22일에 예정된 배송 상품에 대해 사전 주문을 할 수 없습니다. 12월 25일입니다.
{ "specialOpeningHoursSpecification": { "@type": "AdvanceServiceDeliveryHoursSpecification", "validFrom": "2018-12-25T00:00:00-07:00", "validThrough": "2018-12-26T00:00:00-07:00", "opens": "T00:00:00", // No advance ordering "closes": "T00:00:00" } }
다음 예는 서비스가 닫혀 있다고 지정할 수 있는 방법을 보여줍니다. 당일 주문 또는 사전 주문은 크리스마스 당일이지만 향후 예정이 있는 사전 주문. 이 예시에서는 다음을 지원합니다. 시나리오:
- 사용자는 12월 25일에 당일 배송 주문을 할 수 없습니다.
- 사용자는 12월 25일에 예정된 배송 상품에 대해 사전 주문을 할 수 있습니다. 12월 27일에 사용할 수 있습니다.
- 사용자는 12월 22일에 예정된 배송 상품에 대해 사전 주문을 할 수 없습니다. 12월 25일입니다.
{ "specialOpeningHoursSpecification": [ { "@type": "ServiceDeliveryHoursSpecification", "validFrom": "2018-12-25T00:00:00-07:00", "validThrough": "2018-12-26T00:00:00-07:00", "opens": "T00:00:00", // No ASAP ordering on Christmas "closes": "T00:00:00" }, { "@type": "AdvanceServiceDeliveryHoursSpecification", "validFrom": "2018-12-25T00:00:00-07:00", "validThrough": "2018-12-26T00:00:00-07:00", "opens": "T00:00:00", // Orders cannot be scheduled for Christmas "closes": "T00:00:00" } ] }
다음 샘플 서비스는 연중 무휴 주문을 수락하고 다음에서 배송합니다. 평일 오전 10시~오후 2시 59분 59초:
... { "@type": "OpeningHoursSpecification", "opens": "T00:00:00", "closes": "T23:59:59", "deliveryHours": { "@type": "AdvanceServiceDeliveryHoursSpecification", "opens": "T10:00:00", // Delivery starts at 10:00AM "closes": "T15:00:00", // Delivery ends at 3:00PM. Delivery from 10AM-2:59:59PM. "dayOfWeek": [ "Monday", "Tuesday", "Wednesday", "Thursday", "Friday" ], "serviceTimeInterval": "PT15M", // in slots spaced 15 minutes apart "advanceBookingRequirement": { "minValue": 60, // The slot should be at least 60 mins away "maxValue": 8640, // but not more than 6 days away "unitCode": "MIN" } } } ...
다음 샘플 서비스는 매일 오전 8시~오후 4시 59분 59의 주문을 수락합니다. 고객은 1시간 이내에 배송을 선택하거나 배송 상품 중 하나를 슬롯:
... { "@type": "OpeningHoursSpecification", "opens": "T08:00:00", // Ordering opens at 8:00AM "closes": "T17:00:00", // Ordering closes at 5:00PM, last order at 4:59:59PM "deliveryHours": [ { "@type": "ServiceDeliveryHoursSpecification", "opens": "T08:00:00", "closes": "T17:00:00", "deliveryLeadTime": { "@type": "QuantitativeValue", "value": "60", // If no exact deliveryLeadTime, put a maximum time "unitCode": "MIN" } }, { "@type": "AdvanceServiceDeliveryHoursSpecification", "opens": "T08:00:00", "closes": "T17:00:00", "serviceTimeInterval": "PT15M", // in slots spaced 15 minutes apart "advanceBookingRequirement": { "minValue": 90, // The slot should be at least 90 mins away "maxValue": 8640, // but not more than 6 days away "unitCode": "MIN" } } ] } ...
다음 샘플은 매장이 오전 8시~오후 4시 59분 59초에 문을 여는 케이스를 보여줍니다. 평일, 주말에는 오전 8시~오후 6시 59분입니다 주문은 연중무휴 24시간 접수되지 않습니다.
... { // On weekdays, ordering open from 8AM-4:59:59PM. "@type": "OpeningHoursSpecification", "opens": "T08:00:00", "closes": "T17:00:00", "dayOfWeek": [ "Monday", "Tuesday", "Wednesday", "Thursday", "Friday" ], "deliveryHours": [ { // Fulfillment between 8AM-4:59:59PM on weekdays. "@type": "AdvanceServiceDeliveryHoursSpecification", "opens": "T08:00:00", "closes": "T17:00:00", "dayOfWeek": [ "Monday", "Tuesday", "Wednesday", "Thursday", "Friday" ], "serviceTimeInterval": "PT15M", "advanceBookingRequirement": { "minValue": 60, "maxValue": 8640, "unitCode": "MIN" } }, { // Fulfillment between 8AM-6:59:59PM on weekends (even for orders placed on a // weekday). "@type": "AdvanceServiceDeliveryHoursSpecification", "opens": "T08:00:00", "closes": "T19:00:00", "dayOfWeek": [ "Saturday", "Sunday" ], "serviceTimeInterval": "PT15M", "advanceBookingRequirement": { "minValue": 60, "maxValue": 8640, "unitCode": "MIN" } } ] }, { // On weekends, one can place orders upto 6:59:59PM. "@type": "OpeningHoursSpecification", "opens": "T08:00:00", "closes": "T19:00:00", "dayOfWeek": [ "Saturday", "Sunday" ], "deliveryHours": [ { // But fulfillment on weekdays is only till 4:59:59PM. "@type": "AdvanceServiceDeliveryHoursSpecification", "opens": "T08:00:00", "closes": "T17:00:00", "dayOfWeek": [ "Monday", "Tuesday", "Wednesday", "Thursday", "Friday" ], "serviceTimeInterval": "PT15M", "advanceBookingRequirement": { "minValue": 60, "maxValue": 8640, "unitCode": "MIN" } }, { // Fulfillment on weekends is till 6:59:59PM. "@type": "AdvanceServiceDeliveryHoursSpecification", "opens": "T08:00:00", "closes": "T19:00:00", "dayOfWeek": [ "Saturday", "Sunday" ], "serviceTimeInterval": "PT15M", "advanceBookingRequirement": { "minValue": 60, "maxValue": 8640, "unitCode": "MIN" } } ] } ...