ご購入手続き後 呼び出し、 ユーザーが更新されたカートに税金、配送料、割引、 返金されますお客様が注文を確定して送信し、 Google からフルフィルメント エンドポイントに、 表示されます。ウェブサービスは、この注文を受信して処理し、 注文のステータスを Google に返します。
このセクションでは、Google から送信される注文リクエスト メッセージの形式について説明します。
（SubmitOrderRequestMessage）と、レスポンス メッセージの形式
必要があります。
SubmitOrderResponseMessage。
注文フルフィルメントのライフサイクルについて詳しくは、
フルフィルメントの概要。
注文フルフィルメントの実装
エンドツーエンドの注文機能と連携するために構築する注文エンドツーエンド ウェブサービスは、
Google から注文メッセージを受信するための URL エンドポイントを含めます。注文用
処理すると、ウェブサービスは JSON で SubmitOrderRequestMessage を受け取ります。
Google からの POST リクエストとしてフォーマットされます。このリクエストには顧客注文が含まれ
。注文の送信を受け取ったとき
ウェブサービスで次のことを行う必要があります。
- カードの確認や不正行為の検出など、取引の適格性を確認します。
- システムで注文を作成します。
- 支払い方法を承認し、必要に応じてご利用の決済代行業者の Charge API を呼び出します。
- 注文の適切なステータス（
CREATED）を返します。CONFIRMEDまたはREJECTED。
注文を処理した後、フルフィルメント コードでレスポンスを提供する必要があります
SubmitOrderResponseMessage JSON メッセージの形式で Google に返されます。
エンドツーエンドの注文フルフィルメント ウェブサービスの詳細 フルフィルメントの概要をご覧ください。
注文リクエスト メッセージ
お客様がエンドツーエンドの注文フローで注文する場合、
Google は、JSON メッセージを含むリクエストをウェブサービスに送信します。
SubmitOrderRequestMessage には、次のデータが含まれます。
- インテント: すべての注文送信リクエスト本文の
inputs[0].intentフィールドactions.intent.TRANSACTION_DECISION文字列値が含まれています。 - Order:商品の
inputs[0].arguments[0].transactionDecisionValueフィールド 注文リクエストの送信リクエストには、注文内容を表すOrderオブジェクトが 顧客の注文内容と支払い明細が表示されます。 - サンドボックス フラグ: 注文送信リクエストの
isInSandboxフィールドは、 取引がサンドボックス決済を使用しているかどうか
注文リクエストの例
次に SubmitOrderRequestMessage の例を示します。
JSON
{
"user": {},
"conversation": {
"conversationId": "CTKbKfUlHCyDEdcz_5PBJTtf"
},
"inputs": [
{
"intent": "actions.intent.TRANSACTION_DECISION",
"arguments": [
{
"transactionDecisionValue": {
"order": {
"finalOrder": {
"cart": {
"merchant": {
"id": "restaurant/Restaurant/QWERTY",
"name": "Tep Tep Chicken Club"
},
"lineItems": [
{
"name": "Spicy Fried Chicken",
"type": "REGULAR",
"id": "299977679",
"quantity": 2,
"price": {
"type": "ESTIMATE",
"amount": {
"currencyCode": "AUD",
"units": "39",
"nanos": 600000000
}
},
"offerId": "MenuItemOffer/QWERTY/scheduleId/496/itemId/143",
"extension": {
"@type": "type.googleapis.com/google.actions.v2.orders.FoodItemExtension"
}
}
],
"extension": {
"@type": "type.googleapis.com/google.actions.v2.orders.FoodCartExtension",
"fulfillmentPreference": {
"fulfillmentInfo": {
"delivery": {
"deliveryTimeIso8601": "P0M"
}
}
},
"location": {
"coordinates": {
"latitude": -33.8376441,
"longitude": 151.0868736
},
"formattedAddress": "Killoola St, 1, Concord West NSW 2138",
"zipCode": "2138",
"city": "Concord West",
"postalAddress": {
"regionCode": "AU",
"postalCode": "2138",
"administrativeArea": "NSW",
"locality": "Concord West",
"addressLines": [
"Killoola St",
"1"
]
}
},
"contact": {
"displayName": "Hab Sy",
"email": "hab9878.sy@gmail.com",
"phoneNumber": "+61000000000",
"firstName": "Hab",
"lastName": "Sy"
}
}
},
"otherItems": [
{
"name": "Delivery fee",
"type": "DELIVERY",
"price": {
"type": "ESTIMATE",
"amount": {
"currencyCode": "AUD",
"units": "3",
"nanos": 500000000
}
}
},
{
"name": "Subtotal",
"type": "SUBTOTAL",
"price": {
"type": "ESTIMATE",
"amount": {
"currencyCode": "AUD",
"units": "39",
"nanos": 600000000
}
}
}
],
"totalPrice": {
"type": "ESTIMATE",
"amount": {
"currencyCode": "AUD",
"units": "43",
"nanos": 100000000
}
},
"extension": {
"@type": "type.googleapis.com/google.actions.v2.orders.FoodOrderExtension"
}
},
"googleOrderId": "01412971004192156198",
"orderDate": "2020-10-22T09:02:06.173Z",
"paymentInfo": {
"displayName": "Pay when you get your food",
"paymentType": "ON_FULFILLMENT"
}
}
}
}
]
}
],
"directActionOnly": true,
"isInSandbox": true
}
注文応答メッセージ
注文エンドツーエンド ウェブサービスは、リクエストを受け取ると、
SubmitOrderResponseMessage を返します。
次のデータ:
OrderUpdate: 注文の状態を含むオブジェクト。 サポートへの問い合わせ、注文後の確認など、ユーザーが 注文の詳細の表示（finalResponse.richResponse.items[0].structuredResponse.orderUpdateフィールド 返されます。
注文更新フィールド
ウェブサービスが SubmitOrderResponseMessage を送信する際、
次のフィールドを含む OrderUpdate フィールド:
actionOrderId: 注文の一意の ID。一意に識別される システム内の注文を識別して、後続の 確認できます。orderState: 注文の状態を表すOrderStateオブジェクト。orderManagementActions: ユーザーが実行できる注文後の操作。次に例を示します。 カスタマーサポートへの問い合わせや 注文明細の閲覧といった操作を行えますtotalPrice: 注文の合計金額。これは省略可能です。送信のみ 注文の送信後に注文の合計価格が変更された場合。
注文は次のいずれかの状態になります。
CREATED: フルフィルメント エンドポイントで注文が正常に処理されました。 プロバイダがまだ注文を確定していない。CONFIRMED: フルフィルメント エンドポイントで注文が正常に処理されました。 プロバイダが注文を確定した場合です。REJECTED: 問題が発生したため、フルフィルメント エンドポイントが処理できませんでした 注文の作成または確認。これには、支払いに関する問題が含まれることがあります。
注文を REJECTED ステータスに設定する場合は、
OrderUpdate の rejectionInfo フィールド。使用
FoodOrderUpdateExtension.FoodOrderErrors 値の組み合わせ
UNKNOWN 型の rejectionInfo。説明を指定します。
注文レスポンスの例
次に SubmitOrderResponseMessage の例を示します。
JSON
{
"finalResponse": {
"richResponse": {
"items": [
{
"structuredResponse": {
"orderUpdate": {
"actionOrderId": "1603357328160",
"orderState": {
"state": "CONFIRMED",
"label": "Pending"
},
"updateTime": "2020-10-22T02:02:08-07:00",
"orderManagementActions": [
{
"type": "CUSTOMER_SERVICE",
"button": {
"title": "Call customer service",
"openUrlAction": {
"url": "tel:+61234561000"
}
}
},
{
"type": "VIEW_DETAILS",
"button": {
"title": "View order details",
"openUrlAction": {
"url": "https://partner.com/view/orderstatus"
}
}
}
],
"receipt": {
"userVisibleOrderId": "BXZ-1603357328"
}
}
}
}
]
}
}
}
リクエストに失敗しました
送信リクエストが失敗した場合は、SubmitOrderResponseMessage で次の値を設定する必要があります。
OrderState.state が REJECTED になります。レスポンスは
RejectionType を含む RejectionInfo が含まれます。
エラータイプを記述します。
失敗のレスポンスの例
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"
}
}
}
]
}
}
}
]
}
}
}
注文の実装を送信する
注文送信 API を実装する際は、以下の手順を行う必要があります。
検証
- サービス、カート、プロモーションの検証は、設定 ご購入手続き。
- 次のいずれかのタイプで RejectionInfo を返します。 必要な場合:
| RejectionInfoType | ユースケース |
|---|---|
UNAVAILABLE_SLOT |
フルフィルメントの日時が無効になりました。 |
PROMO_USER_INELIGIBLE |
リクエストの Contact オブジェクトのメールを使用して、ユーザーがプロモーションの対象であることを確認します。プロモーション付きの注文の送信を実装するの例をご覧ください。 |
INELIGIBLE |
|
PAYMENT_DECLINED |
お支払いを処理できません。たとえば、残高不足が原因となっている可能性があります。 |
UNKNOWN |
その他の検証エラーの場合。 |
検証がある場合は、OrderState.state を REJECTED に設定します。
表示されます。拒否の具体的な理由を入力することもできます。
FoodOrderUpdateExtension.foodOrderErrors を使用します。例を見る:
注文の検証を送信します。
支払いを処理する
- カートの価格、手数料、割引、税金、税金を追加して、
totalPriceを計算します。 チップが支払われます。totalPriceは、返されるtotalPriceと同じでなければなりません。 CheckoutResponseMessage と チップをユーザーが変更できる場合は、チップの金額。料金をご覧ください。 注文の送信中の変更をご覧ください。 - 注文ステータスを含むレスポンスが返された場合、注文と支払いを処理する
CREATEDまたはCONFIRMED。 - 生成された型を使用して有効なレスポンス形式が返されることを確認する スキーマから自動的に作成されます。 クライアント ライブラリを生成します。
- こちらの
GoogleProvidedPaymentInstrument。
instrumentToken支払いを処理します。RejectionInfoを次の型で返します。 お支払いを処理できない場合はPAYMENT_DECLINED。プロセス のお支払いをご確認ください。 - 注文がメールで処理された直後にユーザーに通知する SMS。
レスポンスを返す
- 次の場合は、OrderState.
stateをCREATEDまたはCONFIRMEDに設定します。 エラーはありません。 - エラーがある場合は、OrderState.
stateをREJECTEDに設定します。 含まれず、RejectionInfoオブジェクトを 対応する RejectionInfoType となります。 - OrderUpdate.
orderManagementActionsを設定します。