フルフィルメント アクションのスキーマ

このオブジェクトの型。親の Cart オブジェクトが ProposedOrder の一部である場合は、このフィールドを省略します。

値: type.googleapis.com/google.actions.v2.orders.Cart

カートの ID（省略可）。

このカートと提携している販売者。

必須。

ユーザーが注文する商品やサービスのリスト。

1 個以上のアイテムを選択してください。

このカートに適用されるプロモーション。現在サポートされているプロモーションは 1 つのみです。

注文または配送手順に関するメモ。

ユーザーに関する詳細（フルフィルメント設定など）を定義します。

表示したい注文を受け取る人の名前。このフィールドは、firstName と lastName が指定されていない場合に使用します。

例: Lovefood Ordering

注文を受け取るユーザーのメールアドレス。

例: ilovefood@example.com

注文を受け取る担当者の名。

例: Lovefood

注文を受け取る人の姓。

例: Ordering

注文を受けた担当者の電話番号（国コードを含む）。

例: +16501234567

注文を受け取るユーザーが Google アカウントでログインしているかどうかを示します。

必須。

注文に関する情報を更新しました。

目安のお届け日数（ISO 8601 タイムスタンプ形式）: 「{year}-{month}-{day}T{hour}:{min}:{sec}[.{frac_sec}]Z」または持続時間の形式: 「P(n)Y(n)M(n)DT(n)H(n)M(n)S」。たとえば、PT90M は 90 分の期間を表します。デフォルト値の「PT0M」は、優先配信時間が可能な限り早いことを指定します。参照: https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representationsこの情報を使用して、購入手続きの応答時の目安のお届け日数を更新します。

例: PT90M

必須。

購入手続き時に事前定義された免責条項メッセージを表示する。

パートナーは、この注文に対して N の金額を販売者に請求します。

パートナーは、注文ごとに N ～ M の金額をレストランに請求します。

パートナーは、この注文に対して N% の手数料を販売者に請求します。

パートナーは、注文ごとに N% ～ M% の手数料を販売者に請求します。

請求される料金の下限

請求される料金の上限

請求料金の割合の下限。

請求される料金の割合の上限。

この拡張機能のタイプ。このフィールドは常に「type.googleapis.com/google.actions.v2.orders.FoodCartExtension」に設定されます。

値: type.googleapis.com/google.actions.v2.orders.FoodCartExtension

注文を受け取る人の連絡先情報。詳細には、ユーザーの名前、電話番号、メールアドレスが含まれます。

必須。

ユーザーのフルフィルメント設定。

CheckoutRequestMessage では、このフィールドに配送先住所を指定します。注文が配送の場合は必須です。テイクアウトまたは受け取りの注文の場合、このフィールドはメッセージには含まれません。

必須。

この拡張機能のタイプ。

値: type.googleapis.com/google.actions.v2.orders.FoodErrorExtension

必須。

発生したエラーを表す FoodOrderError オブジェクトの配列。カートまたは商品アイテムごとに 1 つのエラーを推奨します。

1 個以上のアイテムを選択してください。

次の場合に必須 foodOrderErrors.error = "UNAVAILABLE_SLOT", "PROMO_EXPIRED", "PROMO_NOT_APPLICABLE", "PROMO_NOT_RECOGNIZED", "PROMO_ORDER_INELIGIBLE", "PROMO_USER_INELIGIBLE", "AVAILABILITY_CHANGED", "INCORRECT_PRICE", "INVALID", "NOT_FOUND", or "PRICE_CHANGED"。

修正後の新しい ProposedOrder。元の ProposedOrder に回復可能なエラーがある場合、このオブジェクトを返します。たとえば、カート内の 1 つ以上の項目の価格が変更された場合、それは復元可能なエラーです。有効な ProposedOrder に関する回復可能なエラーは確認ステージに進みます。ユーザーにカートの確認を求める必要はありません。

次の場合に必須 foodOrderErrors.error = "UNAVAILABLE_SLOT", "PROMO_EXPIRED", "PROMO_NOT_APPLICABLE", "PROMO_NOT_RECOGNIZED", "PROMO_ORDER_INELIGIBLE", "PROMO_USER_INELIGIBLE", "AVAILABILITY_CHANGED", "INCORRECT_PRICE", "INVALID", "NOT_FOUND", or "PRICE_CHANGED"。

ユーザーに対して選択されたデフォルトの支払い方法。

お客様が利用できるその他のお支払い方法。

必須。

この拡張機能のタイプ。このフィールドは常に「type.googleapis.com/google.actions.v2.orders.FoodItemExtension」に設定されます。

値: type.googleapis.com/google.actions.v2.orders.FoodItemExtension

オプションには、アドオン項目、またはアドオンのセットを含むアドオン グループを指定できます。

Google によって割り当てられた一意の ID。FoodOrderError または AsyncOrderUpdateRequest を送信するときに、このフィールドを使用して、同じ offerId のアイテムが複数含まれているかどうかを区別できます。

例: 39231093

商品アイテムのオファー ID。

例: 912835081

オプション名。

例: Honey Mustard

オプションに関するメモ。

アイテムであるオプションの場合、アイテム数。

例: 3

オプションのサブオプション（ある場合）。

例: [ { "id": "71283712", "offerId": "51209121", "name": "BBQ Sauce", "price": { "currencyCode": "USD", "units": "3", "nanos": 780000000 }, "quantity": 2 }, { "id": "102941024", "offerId": "12084102", "name": "Ketchup", "price": { "currencyCode": "USD", "units": "2", "nanos": 980000000 }, "quantity": 6 } ]

必須。

次の場合に必須 error = "AVAILABILITY_CHANGED", "INCORRECT_PRICE", "PRICE_CHANGED", "INVALID", or "NOT_FOUND"。

商品アイテム単位のエラーの場合、このフィールドは必須です。Google が割り当てたメニュー項目用の LineItem.id またはアドオン用の FoodItemOption.id です。

エラーの説明。この説明は内部ロギング用であり、ユーザーには表示されません。

次の場合に必須 error = "PRICE_CHANGED"。

エラーの原因となった商品アイテムの新しい価格。エラーが「PRICE_CHANGED」の場合のみ必須。

次の場合に必須 error = "INVALID", or "NOT_FOUND"。

エラーの原因となった商品アイテムの新しい購入可能数量。エラーが「INVALID」の場合にのみ必須「NOT_FOUND」が返されます。「INVALID」の値は 0 にする必要があります"NOT_FOUND" を返します。

この拡張機能のタイプ。このフィールドは常に「type.googleapis.com/google.actions.v2.orders.FoodOrderExtension」に設定されます。

値: type.googleapis.com/google.actions.v2.orders.FoodOrderExtension

注文で利用可能なフルフィルメント オプションを表します。

マーケティング チャネルへのオプトインを求めるユーザー リクエスト。デフォルトでは、ユーザーの同意なしにマーケティング コンテンツを送信することはできません。optinFor リマーケティングが true の場合、そのユーザーを登録できます。optinForRLSA が false または存在しない場合は、購読ステータスをシステムにそのまま維持する必要があります。ユーザーは Google 経由でオプトアウトすることはできません。マーケティング チャネルで提供される登録解除機能を通じてのみオプトアウトできます。このフラグは SubmitOrderRequestMessage にのみ存在します。

このフルフィルメント オプションの一意の識別子（存在する場合）。

必須。

このフルフィルメント オプションの有効期限が切れる日時。

このオプションの費用。

存在する場合は配信順序を示します。

必須。

画像の URL。画像は 72x72 ピクセル以上にする必要があります。最適な結果を得るには、216 x 216 ピクセル以上の画像を使用してください。画像は 6 MB 未満、64 メガピクセル未満である必要があります。

次の場合に必須 type = "REGULAR"。

カート内の LineItem（ProposedOrder.cart.lineItems[0].id）の場合、注文の作成時に Google が作成した一意の ID です。配送料や税金などのアイテムを追加する ProposedOrder（ProposedOrder.otherItems[0].id）の LineItem の場合、id の値はプロバイダによって定義されます。たとえば、カート内に、準備手順が異なる同じ商品アイテムが 2 つあります（トッピングが異なるミディアム ピザ 2 つなど）。この場合、両方のアイテムの基本特典 ID は同じです。注文更新リクエストを送信して商品アイテムが不承認であることを示す場合は、この ID を曖昧性除去として使用します。言い換えれば、特定のトッピングがないという理由でピザが拒否された場合、ID は Google が参照している注文に含まれる商品を判別するのに役立ちます。otherItems を除き必須フィールドです。

必須。

広告申込情報の名前。ユーザーに表示される文字列で、可能な場合は先頭を大文字にして表記する必要があります（「配送料」、「サービス料」、「税金」など）。ユーザーの場合、このフィールドは 100 文字で切り捨てられます。

必須。

次の場合に必須 type = "REGULAR"。

アイテムの数。ProposedOrder.otherItems には適用されません。

項目の説明。

必須。

1 つまたは複数のアイテムの価格。この値は、この広告申込情報のすべての商品やサービスの合計価格を表します（アドオンの費用を加算し、数量を掛けます）。たとえば、1,000 円のアイテムの数量が 3 の場合、価格は 3,000 円になります。基本価格が 5 ドルでアドオンが 1 ドルのピザ 1 枚の場合、価格は 6 ドルになります。基本価格が 5 ドルで、アドオンが 1 ドルのピザ 2 つ（数量 = 2）の場合、価格は 12 ドルになります。各 LineItem には、価格が「0」であっても価格を指定する必要があります。type が DISCOUNT の場合は、値を負数として指定します（「-2」など）。

省略可。type が「REGULAR」の場合にのみ有効です。ユーザーによる商品アイテム固有のメモは、購入手続きリクエストと注文送信リクエストのこのフィールドで送信できます。メモが提供されると、販売者にメモが届くようにします。これは、リクエスト内に subLines[0].note として含まれます。これは、リクエスト内に存在する場合、このフィールドに指定される唯一の値です。

1 項目以下の項目で指定します。

次の場合に必須 type = "REGULAR"。

アイテムの MenuItem のオファー ID。ProposedOrder.otherItems には適用されません。

食品アイテムのアドオンを定義します。

ビジネスの住所を表示します。

例: 1350 CHARLESTON ROAD, MOUNTAIN VIEW, CA, United States

例: 90210

都市の名前。

例: Los Angeles

場所に関するメモ（ゲートコードなど）。500 文字以下にしてください。

例: Gate code is #111

販売者の ID。指定すると、レストラン フィードの Restaurant.@id と一致します。

例: https://www.exampleprovider.com/merchant/id1

必須。

ユーザーに表示される販売者の名前。

例: Falafel Bite

必須。

3 文字の通貨コード（ISO 4217 形式）。

例: USD

金額の整数部分。たとえば、currencyCode が「USD」の場合、「1」になります。単位は 1 米ドルです。

例: 36

金額の小数部分をナノ（10^-9）単位で表した数。値は -999,999,999 ～+999,999,999 の範囲で指定する必要があります。次のルールを使用します。単位が正の場合、nanos は正またはゼロにする必要があります。単位が 0 の場合、ナノは正、ゼロ、負のいずれかになります。単位が負の場合、ナノは負またはゼロでなければなりません。たとえば、$-1.75 は、units = -1、nanos = -750,000,000 と表されます。

例: 730000000

必須。

注文の原因となった注文。

必須。

Google によって割り当てられたオーダー ID。この ID は注文のライフサイクル全体で不変である必要があります。この ID はエンドユーザーには表示されません。

必須。

この注文が作成された日時。

必須。

この注文の支払いに対応するお支払い情報。

必須。

更新が送信された注文の識別に使用される、インテグレータのシステム内の注文の一意の ID。「CREATED」の OrderUpdate で customer_visible_order_id が 1 回以上指定されていない場合この ID は Google の注文カードに表示される、入力済みのユーザーに表示される ID です。

必須。

注文の新しいステータス。

必須。

注文が更新された時刻。

サポートへの問い合わせや注文詳細の表示など、注文後の操作。

1 個以上のアイテムを選択してください。 6 項目以内にしてください。

次の場合に必須 orderState.state = "REJECTED"。

次の場合に必須 orderState.state = "CANCELLED"。

このフィールドは非推奨です。

このフィールドは非推奨です。

次の場合に必須 orderState.state = "CONFIRMED", "IN_PREPARATION", or "READY_FOR_PICKUP"。

ユーザーに表示される注文 ID を領収書に記載します。

注文の合計金額。

配送予定日や受け取りの間隔など、注文更新の詳細を定義します。

推定集荷時間（ISO 8601 タイムスタンプ形式）: 「{year}-{month}-{day}T{hour}:{min}:{sec}[.{frac_sec}]Z」または持続時間の形式: 「P(n)Y(n)M(n)DT(n)H(n)M(n)S」。たとえば、PT90M は 90 分の期間を表します。デフォルト値の「PT0M」は、優先乗車時刻が可能な限り早いことを示します。参照: https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representationsこれを使用して、購入手続きの応答時の予想受け取り時間を更新します。

例: PT90M

必須。

2 文字の国コード。

例: US

郵便番号です。

例: 94043

その国 / 地域の住所に使用される最上位の行政区域。州、県、都道府県を指定できます。

例: CA

この場所の市区町村。地域区分が十分に定義されていない地域や、この構造に適合しない地域では、locality を指定せず、代わりに addressLines フィールドを使用してください。

例: Mountain View

番地の指定に使用できる 1 つ以上の行。不明確な地域区分が含まれている可能性があるため、このフィールドには変更しないでください。

例: [ "1350 Charleston Road" ]

注文の受信者のリスト。このフィールドは、billingAddress でのみ使用できます。

必須。

プロモーション クーポンコード。

必須。

必須。

プロモーション クーポンコード。

提案された注文の ID（省略可）。

必須。

ユーザーのアイテム。

プロバイダが追加したアイテム（配送料、その他の手数料、税金など）。otherItem には、ユーザーが追加したチップや割引が含まれている場合もあります。

10 アイテム以下で指定する必要があります。

提案された注文に関連付けられている画像。

必須。

提案された注文の合計金額。

必須。

料理の注文のフルフィルメント情報を定義します。

注文前に UI に表示される免責条項メッセージに対応します。

必須。

必須。

お支払いの詳細を含む注文。

後続の取引がサンドボックス環境で行われるかどうかを示します。

必須。

カートの購入手続きで想定される引数が含まれています。

1 個のアイテムのみが必要です。

必須。

会話の一意の ID。

必須。

「actions.foodordering.intent.CHECKOUT」に設定します。購入手続きのリクエスト メッセージまたは「actions.intent.TRANSACTION_DECISION」の場合注文リクエスト送信のメッセージを 送信する必要があります

必須。

精算するカートまたは注文を行う

1 個のアイテムのみが必要です。

ユーザーが注文したかった食品の詳細。

false に設定します。

値: False

必須。

カートでの購入手続きに対するレスポンスが含まれます。

必須。

CheckoutRequestMessage または SubmitOrderRequestMessage に対するレスポンスが含まれています。

必須。

トランザクションで使用するために提案された順序。

必須。

ユーザーのデフォルトの支払い方法。

お客様が利用できるその他のお支払い方法。

必須。

必須。

1 個のアイテムのみが必要です。

アイテム、税金、割引をチェックしました。

この更新が送信された注文がサンドボックスの支払いであることを示します。

必須。

リクエストの OrderUpdate が含まれます。

必須。

表示ラベル。正しくレンダリングされるように、文頭を 30 文字以下にしてください。

例: Contact us

必須。

必須。

OrderState.state が「CANCELLED」の場合に、不承認となった理由として表示可能。

例: Restaurant closed

この拡張機能のタイプ。このフィールドは常に「type.googleapis.com/google.actions.v2.orders.FoodOrderUpdateExtension」に設定されます。

値: type.googleapis.com/google.actions.v2.orders.FoodOrderUpdateExtension

注文した商品が配達される予定または受け取り可能な推定時間。文字列は ISO 8601 形式で、単一の固定時間ではなく間隔に対応する必要があります。使用できる規則は、間隔、期間、日付/時刻です。このフィールドは、情報が利用可能になったとき、または到着が早すぎる、到着が遅れるなど、変更がある場合に、SubmitOrderResponseMessage または AsyncOrderUpdateRequestMessage で送信できます。

例: 2017-07-17T13:00:00Z/2017-07-17T13:30:00Z

注文後に発生したエラーを示します。カートまたは商品アイテムごとに 1 つのエラーを推奨します。RejectedInfo に含まれていないエラーには、FoodOrderUpdateExtension.FoodOrderErrors を使用します。

1 個以上のアイテムを選択してください。

FoodOrderingUpdateExtension メッセージで estimateFulfillmentTimeIso8601 を使用

FoodOrderingUpdateExtension メッセージで estimateFulfillmentTimeIso8601 を使用

変更の理由。価格変更の場合は必須。

必須。

ボタンをクリックまたはタップすることでトリガーされるアクション。適用可能な接頭辞のリストは orderManagementActionType によって異なります。「EMAIL」: 接頭辞は「mailto」にする必要があります。「CALL」: 接頭辞は「tel」にする必要があります。「CUSTOMER_SERVICE」: 接頭辞は「mailto」、「tel」、「http」、または「https」である必要があります。

例: https://www.google.com

必須。

必須。

必須。

必須。

ユーザーに表示される状態の表示文字列。文頭を大文字にします（アルファベットの場合）。

例: Your order has been received

必須。

注文が「CONFIRMED」、「IN_TRANSIT」、または「FULFILLED」の場合は必須です。このフィールドは、この注文の単一のユーザー向けの ID（通常はレストランの注文 ID）で、インテグレータの領収書と Google 注文カードの両方に表示されます。ユーザーは、この ID を使用して、プロバイダやインテグレータとのカスタマー サービスの注文を参照できる必要があります。この ID を指定する必要があるのは、OrderUpdate で 1 回のみです。指定されるまで、actionOrderId は userVisibleOrderId になります。たとえば、レストランが注文を確認するまで userVisibleOrderId を取得できないことがあります。確認したら、OrderUpdate と Receipt を含む AsyncOrderUpdateRequestMessage を送信する必要があります。

必須。

内部ロギングに使用される拒否の理由。このフィールドはユーザーには表示されません。

必須。

必須。

領収書に表示されるお支払い方法の名前。

例: Taco Points Total

paymentType「ON_FULFILLMENT」の追加データ。たとえば、このフィールドを使用して、フルフィルメントで現金またはカードを利用できるかどうかを指定できます。

取引を完了するには、請求先住所の形式が必要です。MIN: 名前、国コード、郵便番号。FULL: 名前、番地、地域区分、地域、国コード、郵便番号。

必須。

カード取引の認証でサポートされるフィールド。

1 個以上のアイテムを選択してください。

必須。

お客様がサポートしており、Google Pay API でもサポートされている 1 つ以上のカード ネットワーク。

1 個以上のアイテムを選択してください。

請求先住所が必要な場合は true に設定します。請求先住所のリクエストは、取引を処理するために必要な場合にのみ行ってください。データ リクエストが増えると、購入手続きが煩雑になり、コンバージョン率の低下につながります。

billingAddressRequired が true に設定されている場合に返される想定フィールド。

TimesofMoney を使用する場合は true に設定し、他のすべての決済代行業者の場合は false に設定します。

必須。

以前に指定された GoogleProvidedPaymentOptions に従って、提携している Google Pay 決済代行業者にユーザーに請求するための支払いトークンを含む、Base 64 でエンコードされた文字列。

お支払いの請求先住所。

文字列としての PaymentDataRequest JSON。このオブジェクトを使用して、サイトでの Google Pay API のサポートを構成します。

代わりに facilitationSpecification を使用してください。エージェントがサポートするカード ネットワークのタイプ。

このフィールドは非推奨です。

代わりに facilitationSpecification を使用してください。支払いタイプとしてプリペイド カードを許可するかどうか。

このフィールドは非推奨です。

代わりに facilitationSpecification を使用してください。請求先住所が必須かどうか。

このフィールドは非推奨です。

このフィールドは非推奨です。

Google Pay から発行された Google 販売者 ID。

必須。

UTF-8 でエンコードされた販売者名。販売者名は支払いシートに表示されます。

注文のフルフィルメント時にユーザーが利用できる支払いオプションのリスト。

必須。

例: braintree

必須。

API のメジャー バージョン。

値: 2

必須。

マイナー API バージョン。

値: 0

必須。

（Google Pay 販売者 ID）支払いデータをリクエストする販売者に関する情報。

必須。

Google Pay API でサポートされている 1 つ以上のお支払い方法のサポートを指定します。

必須。

ユーザーが取引に同意したかどうかに基づく取引の承認に関する詳細。このフィールドには、合計金額と価格ステータスが含まれます。

必須。

領収書に表示する支払い方法の、ユーザーに表示される名前。

必須。

アクションで使用できるトークン。これは、CheckoutResponseMessage で支払いオプションとして GoogleProvidedPaymentOptions を指定した場合のみ指定します。

必須。

サポートされているお支払い方法の短い識別子。現在サポートされているのは CARD のみです。

値: CARD

必須。

指定されたお支払い方法のタイプを構成するために必要なパラメータ。

必須。

支払い情報を受け取るアカウントまたは復号プロバイダを設定する。このプロパティは、お支払い方法が CARD の場合は必須です。

actionProvidedOptions とは相互に排他的。GPay を使用したオンライン決済に使用します。

必須。

代わりに facilitationSpecification を使用してください。使用できるトークンのタイプ。

代わりに facilitationSpecification を使用してください。

必須。

必須。

必須。

ISO 4217 英字通貨コード。

トランザクションの試行を識別する一意の ID。販売者は、既存の ID を使用するか、Google Pay で取引を試みる際に特定の ID を生成できます。このフィールドは、Google Transaction Events API にコールバックを送信する場合は必須です。

必須。

「ESTIMATED」を使用してください設定されます。合計金額は、請求先住所に基づいて収集されたレスポンスの詳細（消費税など）に基づいて調整される場合があります。

値: ESTIMATED

必須。

取引の合計金額。小数点以下 2 桁の小数点精度が適用されます。このフィールドには、cart.totalPrice と同じ値を指定する必要があります。