Transactions API のサポートは 2023 年 6 月 13 日に終了します。2023 年 5 月 3 日に終了します。詳細については、会話型アクションの廃止をご覧ください。

このページは Cloud Translation API によって翻訳されました。

販売者が管理する決済方法で物理的取引を構築する

このガイドでは、Actions プロジェクトの開発プロセスについて説明します。管理対象のお支払い方法を使用した物理的な商品の取引を含む確認できます。

取引の流れ

Actions プロジェクトで販売者が管理する決済方法を使用して現物取引を処理する場合、次のフローを使用します。

ユーザーのアカウントをリンクする - ユーザーが支払いを使用できるようにします。追加するには、[アカウントのリンク] を使用します。 Google アカウントとサービスアカウントを関連付けることができます。
情報を収集する（省略可） - データの性質に応じて、会話の早い段階でユーザーから以下の情報を収集します。 <ph type="x-smartling-placeholder">
1. 取引要件を検証する - 会話の取引セクションの冒頭で、ユーザーが取引を行うための要件（支払い情報が適切に設定され、使用できるようになるとカートの作成に使用できます
2. 配送先住所のリクエスト - 取引で配達が必要な場合ユーザーから 1 つ取得します。
注文を作成する - お客様に「カートアセンブリ」ユーザーは購入する商品を選べます
注文を提案 - カートが完成したら、次に注文を提案します。正しいことを確認します。注文が確認されると、注文の詳細と支払いトークンを含むレスポンスが届きます。
注文を確定して領収書を送信する - 注文が確定されたら、在庫追跡や他の納品サービスを更新し、ユーザーに領収書を送信します。
注文の最新情報を送信する - 注文フルフィルメントの期間中は、 Orders に PATCH リクエストを送信して、注文の最新情報をユーザーに提供します API

で確認できます。

制限と審査のガイドライン

取引を伴うアクションには追加のポリシーが適用されます。これは、取引に関するアクションの審査に最大 6 週間かかることがあるためそういう時間を確保することですレビュープロセスを容易にするため必ず遵守してください取引に関するポリシーとガイドライン提出してください。

現物商品を販売するアクションは次の国でのみデプロイできます。

オーストラリア
ブラジル
カナダ
インドネシア

日本
メキシコ
カタール
ロシア

シンガポール
スイス
タイ
トルコ
英国
米国

プロジェクトのビルド

トランザクションに関する会話の例については、Node.js のトランザクションサンプルです。

プロジェクトの設定

アクションを作成するときは、取引を実行することを指定する必要があります。 Actions Console を使用します。

プロジェクトとフルフィルメントを設定する手順は次のとおりです。

新しいプロジェクトを作成するか、既存のプロジェクトをインポートします。
[デプロイ] > [ディレクトリ情報] の順に移動します。
[その他の情報] >トランザクション >[Do your Actions] というチェックボックスをオンにして「トランザクション API を使用して物理的な商品の取引を実行する」という質問です。

ユーザーのアカウントをリンクする（省略可）

独自のお支払い方法を使用してユーザーに請求する場合は、次のリンクをおすすめします。そのユーザーが独自のサービスを使用して取得したアカウントを使用して保存されているお支払い方法に請求することもできます。

認証フローの音声ユーザーインターフェースを設計する

で確認できます。

ユーザーが確認済みかどうかを確認し、アカウントのリンクのフローを開始する

Actions Console で Actions Builder プロジェクトを開きます。
アクションでアカウントのリンクを開始するための新しいシーンを作成します。 <ph type="x-smartling-placeholder">
1. [Scenes] をクリックします。
2. 追加（+）アイコンをクリックして新しいシーンを追加します。
新しく作成したシーンで、追加アイコンをクリックします。 [Conditions] アイコンをクリックします。
会話に関連付けられたユーザーが確認できます。チェックに失敗した場合、アクションはアカウントのリンクを実行できませんアクセスが許可されることが確認されると、機能も用意されています。
1. [Condition] の Enter new expression フィールドに、次のロジックを入力します。 user.verificationStatus != "VERIFIED"
2. [トランジション] で、アカウントのリンクを必要としないシーンを選択します。または、ゲスト専用機能へのエントリポイントとなるシーン。

[Conditions] のアイコンをクリックします。
ユーザーがまだリンクしていない場合にアカウントのリンクフローをトリガーする条件を追加します。関連付けられます。
1. [Condition] の下にある Enter new expression フィールドに、次のロジックを入力します。 user.verificationStatus == "VERIFIED"
2. [Transition] で、[Account Linking] システムシーンを選択します。
3. [保存] をクリックします。

保存後、<SceneName>_AccountLinking という新しいアカウントリンクシステムシーンが作成されますがプロジェクトに追加されます。

アカウントのリンクシーンをカスタマイズする

[Scenes] で、アカウントリンクのシステムシーンを選択します。
[プロンプトを送信] をクリックし、ユーザーに説明する短い文を追加します。アクションが ID にアクセスする必要がある理由（「設定を保存するため」など）。
[保存] をクリックします。

[条件] で [ユーザーがアカウントのリンクを正常に完了した場合] をクリックします。
ユーザーがアカウントのリンクに同意した場合のフローの処理方法を構成します。たとえば、Webhook を呼び出して、必要なカスタムビジネスロジックを処理します。元のシーンに戻ります
[保存] をクリックします。

[条件] で、[ユーザーがアカウントのリンクをキャンセルまたは拒否した場合] をクリックします。
ユーザーがリンクに同意しなかった場合のフローの進め方を設定します。あります。たとえば、確認応答メッセージを送信し、シーンにリダイレクトします。アカウントのリンクを必要としない機能を提供する。
[保存] をクリックします。

[条件] で [システムエラーまたはネットワークエラーが発生した場合] をクリックします。
アカウントのリンクのフローを実行できない場合のフローの進め方を設定するシステムエラーまたはネットワークエラーのために完了した。たとえば、確認応答メッセージを送信し、シーンにリダイレクトします。アカウントのリンクを必要としない機能を提供する。
[保存] をクリックします。

情報を収集する（省略可）

取引要件を確認する（省略可）

ユーザーが購入の意思を示したら取引を実行できることを確認する必要があります。たとえば、呼び出されたとき、アクションは「靴を注文しますか？ アカウント残高の確認ですか？」ユーザーが「靴を注文して」と言った場合は、お客様は続行し、利用の妨げとなっている設定を修正する機会を提供できます取引を続行できないようにしますそのためには、トランザクション要件チェックを行うシーンです。

トランザクション要件チェックシーンを作成する

[Scenes] タブで、TransactionRequirementsCheck という名前の新しいシーンを追加します。
[スロット充填] で [+] をクリックして、新しいスロットを追加します。
[Select type] で [actions.type.TransactionRequirementsCheckResult] を選択します。選択します
スロット名のフィールドで、スロットに「TransactionRequirementsCheck」という名前を付けます。
[スロット値のライトバックをカスタマイズする] チェックボックスを有効にします（デフォルトで有効になっています）。
[保存] をクリックします。

トランザクション要件の確認では、次のいずれかの結果になります。

要件を満たしている場合、セッションパラメータは「成功」ユーザーの注文の作成に進むことができます。
1 つ以上の要件を満たせない場合、セッションパラメータが設定されます。繰り返しフィールドがありますその場合は、会話を離れて会話を終了することもできます。
- 障害状態の原因となったエラーがユーザーによって修正できる場合は、デバイスにプロンプトが表示され、問題を解決するようユーザーに促します。もし行われる場合、ハンドオフはユーザーのスマートフォンで開始されました

トランザクション要件チェック結果の処理

[Scenes] タブで、新しく作成した TransactionRequirementsCheck 個のシーン。
[Condition] で、[+] をクリックして新しい条件を追加します。

テキストフィールドに次の条件構文を入力して、成功条件：

scene.slots.status == "FINAL" && session.params.TransactionRequirementsCheck.resultType == "CAN_TRANSACT"

先ほど追加した条件にカーソルを合わせて、上矢印アイコンをクリックします。 if scene.slots.status == "FINAL" より前に配置する必要があります。
[プロンプトを送信] を有効にし、簡単なプロンプトでユーザーに知らせる取引を行う準備ができている:
```
candidates:
  - first_simple:
      variants:
        - speech: >-
            You are ready to purchase physical goods.
```
[Transition] で別のシーンを選択し、手続きを進めます
条件 else if scene.slots.status == "FINAL" を選択します。
[プロンプトを送信] を有効にし、簡単なプロンプトでユーザーに知らせる取引を行うことができません。
```
candidates:
  - first_simple:
      variants:
        - speech: Transaction requirements check failed.
```
次の場合に会話を終了するには、[切り替え] で [会話を終了] を選択します。ユーザーが取引を行えない状況です

配送先住所をリクエストする（省略可）

取引に配送先住所が必要な場合は、リクエストする必要があります。許可されません。合計金額を割り出すのに便利かもしれませんが、お客様がサービス提供地域内にいることを確認するため。そのためには、ユーザーにプロンプトを表示するシーンに移行する必要があります。配送先住所。

配達先住所のシーンを作成する

[Scenes] タブで、DeliveryAddress という名前の新しいシーンを追加します。
[スロット充填] で [+] をクリックして、新しいスロットを追加します。
[Select type] で、スロットタイプとして actions.type.DeliveryAddressValue を選択します。
スロット名のフィールドで、スロットに「TransactionDeliveryAddress」という名前を付けます。
[スロット値のライトバックをカスタマイズする] チェックボックスを有効にします（デフォルトで有効になっています）。
[保存] をクリックします。

スロットを構成するときに、reason を指定して、アドレスを取得するアシスタントのリクエストの前に文字列を追加します。デフォルトは reason 文字列は「to know Where to send the order（注文の配送先を知るため）」です。そのためアシスタントはお客様に次のように尋ねられます。「注文の配送先を確認するには、配送先住所が必要です」

画面表示が使用できるサーフェスの場合、ユーザーは取引に使用する住所を選択します。また、住所をまだ指定していない場合は、新しい住所を入力できます。
音声のみのサーフェスでは、アシスタントはユーザーに権限を求めます。取引のデフォルトの住所を共有している。以前に行ったことがない場合住所を入力すると、会話が電話に渡されエントリーされます。

配送先住所の結果を処理する手順は次のとおりです。

[Scenes] タブで、新しく作成した DeliveryAddress シーンを選択します。
[Condition] で、[+] をクリックして新しい条件を追加します。

テキストフィールドに次の条件構文を入力して、成功条件：

scene.slots.status == "FINAL" && session.params.TransactionDeliveryAddress.userDecision == "ACCEPTED"

先ほど追加した条件にカーソルを合わせて、上矢印アイコンをクリックします。 if scene.slots.status == "FINAL" より前に配置する必要があります。

[プロンプトを送信] を有効にし、ユーザーが操作できるようにする簡単なプロンプトを入力します。次の宛先に送信されます

candidates:
  - first_simple:
      variants:
        - speech: >-
            Great! Your order will be delivered to
            $session.params.TransactionDeliveryAddress.location.postalAddress.locality
            $session.params.TransactionDeliveryAddress.location.postalAddress.administrativeArea
            $session.params.TransactionDeliveryAddress.location.postalAddress.regionCode
            $session.params.TransactionDeliveryAddress.location.postalAddress.postalCode

[トランジション] で別のシーンを選択し、ユーザーが続行できるようにします。表示されます。
条件 else if scene.slots.status == "FINAL" を選択します。
[プロンプトを送信] を有効にし、簡単なプロンプトでユーザーに知らせる取引を行うことができません。
```
candidates:
  - first_simple:
      variants:
        - speech: I failed to get your delivery address.
```
[切り替え] で [会話を終了] を選択して、会話を終了します。ユーザーが取引を行えない場合

注文を作成する

必要なユーザー情報を入手したら、ユーザーが注文を行うカートアセンブリを構築します。すべてのアクションはカートアセンブリフローが若干異なる場合があります。提供します。

最も基本的なカートアセンブリのエクスペリエンスでは、ユーザーがリストから商品を選択して追加するただし、会話をデザインして簡単に向上させることができますカートアセンブリのエクスペリエンスを作成し、ユーザーは「はい」か「いいえ」で答える簡単な質問で、最近購入した商品を再注文できます。上位の「おすすめ」のカルーセルやリストカードをユーザーに表示することもできます。または「推奨」あります。

「リッチコンテンツユーザーの選択肢を提示するユーザーが会話をデザインできるようにして音声だけで操作できますベストプラクティスと例については、優れたカートアセンブリ体験を提供するには、トランザクション設計ガイドライン

注文を作成する

会話を通じて、ユーザーが求めているものを購入してから、Order オブジェクトを作成します。

Order には少なくとも次のものが含まれている必要があります。

buyerInfo - 商品を購入しようとしているユーザーに関する情報。
transactionMerchant - 仲介役を担った販売者に関する情報あります。
contents - lineItems として列挙される注文の実際の内容。
priceAttributes - 注文の料金の詳細（合計金額など）割引額と税金を含めた注文額です

で確認できます。

詳しくは、Order レスポンスドキュメントをご覧ください。必要に応じて異なるフィールドを使用します。

次のサンプルコードは、省略可能なフィールドを含む完全な注文を示しています。

const order = {
  createTime: '2019-09-24T18:00:00.877Z',
  lastUpdateTime: '2019-09-24T18:00:00.877Z',
  merchantOrderId: orderId, // A unique ID String for the order
  userVisibleOrderId: orderId,
  transactionMerchant: {
    id: 'http://www.example.com',
    name: 'Example Merchant',
  },
  contents: {
    lineItems: [
      {
        id: 'LINE_ITEM_ID',
        name: 'Pizza',
        description: 'A four cheese pizza.',
        priceAttributes: [
          {
            type: 'REGULAR',
            name: 'Item Price',
            state: 'ACTUAL',
            amount: {
              currencyCode: 'USD',
              amountInMicros: 8990000,
            },
            taxIncluded: true,
          },
          {
            type: 'TOTAL',
            name: 'Total Price',
            state: 'ACTUAL',
            amount: {
              currencyCode: 'USD',
              amountInMicros: 9990000,
            },
            taxIncluded: true,
          },
        ],
        notes: [
          'Extra cheese.',
        ],
        purchase: {
          quantity: 1,
          unitMeasure: {
            measure: 1,
            unit: 'POUND',
          },
          itemOptions: [
            {
              id: 'ITEM_OPTION_ID',
              name: 'Pepperoni',
              prices: [
                {
                  type: 'REGULAR',
                  state: 'ACTUAL',
                  name: 'Item Price',
                  amount: {
                    currencyCode: 'USD',
                    amountInMicros: 1000000,
                  },
                  taxIncluded: true,
                },
                {
                  type: 'TOTAL',
                  name: 'Total Price',
                  state: 'ACTUAL',
                  amount: {
                    currencyCode: 'USD',
                    amountInMicros: 1000000,
                  },
                  taxIncluded: true,
                },
              ],
              note: 'Extra pepperoni',
              quantity: 1,
              subOptions: [],
            },
          ],
        },
      },
    ],
  },
  buyerInfo: {
    email: 'janedoe@gmail.com',
    firstName: 'Jane',
    lastName: 'Doe',
    displayName: 'Jane Doe',
  },
  priceAttributes: [
    {
      type: 'SUBTOTAL',
      name: 'Subtotal',
      state: 'ESTIMATE',
      amount: {
        currencyCode: 'USD',
        amountInMicros: 9990000,
      },
      taxIncluded: true,
    },
    {
      type: 'DELIVERY',
      name: 'Delivery',
      state: 'ACTUAL',
      amount: {
        currencyCode: 'USD',
        amountInMicros: 2000000,
      },
      taxIncluded: true,
    },
    {
      type: 'TAX',
      name: 'Tax',
      state: 'ESTIMATE',
      amount: {
        currencyCode: 'USD',
        amountInMicros: 3780000,
      },
      taxIncluded: true,
    },
    {
      type: 'TOTAL',
      name: 'Total Price',
      state: 'ESTIMATE',
      amount: {
        currencyCode: 'USD',
        amountInMicros: 15770000,
      },
      taxIncluded: true,
    },
  ],
  followUpActions: [
    {
      type: 'VIEW_DETAILS',
      title: 'View details',
      openUrlAction: {
        url: 'http://example.com',
      },
    },
    {
      type: 'CALL',
      title: 'Call us',
      openUrlAction: {
        url: 'tel:+16501112222',
      },
    },
    {
      type: 'EMAIL',
      title: 'Email us',
      openUrlAction: {
        url: 'mailto:person@example.com',
      },
    },
  ],
  termsOfServiceUrl: 'http://www.example.com',
  note: 'Sale event',
  promotions: [
    {
      coupon: 'COUPON_CODE',
    },
  ],
  purchase: {
    status: 'CREATED',
    userVisibleStatusLabel: 'CREATED',
    type: 'FOOD',
    returnsInfo: {
      isReturnable: false,
      daysToReturn: 1,
      policyUrl: 'http://www.example.com',
    },
    fulfillmentInfo: {
      id: 'FULFILLMENT_SERVICE_ID',
      fulfillmentType: 'DELIVERY',
      expectedFulfillmentTime: {
        timeIso8601: '2019-09-25T18:00:00.877Z',
      },
      location: location,
      price: {
        type: 'REGULAR',
        name: 'Delivery Price',
        state: 'ACTUAL',
        amount: {
          currencyCode: 'USD',
          amountInMicros: 2000000,
        },
        taxIncluded: true,
      },
      fulfillmentContact: {
        email: 'johnjohnson@gmail.com',
        firstName: 'John',
        lastName: 'Johnson',
        displayName: 'John Johnson',
      },
    },
    purchaseLocationType: 'ONLINE_PURCHASE',
  },
};

注文オプションとプレゼンテーションオプションを作成する

ユーザーが注文を確定する前に、表示されます。このカードの表示方法は、次の方法でカスタマイズできます。さまざまな順序や表示のオプションを設定します。

以下は、必要な注文と提示オプションです。配送先住所（注文確認カードにあるユーザーのメールアドレスを含む）:

const orderOptions = {
      'requestDeliveryAddress': true,
      'userInfoOptions': {
        'userInfoProperties': ['EMAIL']
      }
    };

const presentationOptions = {
      'actionDisplayName': 'PLACE_ORDER'
    };

支払いパラメータを作成する

paymentParameters オブジェクトにフィールドを持つ merchantPaymentOption が含まれている（注文に対するユーザーの支払い方法が記述されている）以下に例を示します。お支払いパラメータ: Visa クレジットカード

const paymentParamenters = {
      'merchantPaymentOption': {
        'defaultMerchantPaymentMethodId': '12345678',
        'managePaymentMethodUrl': 'https://example.com/managePayment',
        'merchantPaymentMethod': [{
          'paymentMethodDisplayInfo': {
            'paymentMethodDisplayName': 'VISA **** 1234',
            'paymentType': 'PAYMENT_CARD'
          },
          'paymentMethodGroup': 'Payment method group',
          'paymentMethodId': '12345678',
          'paymentMethodStatus': {
            'status': 'STATUS_OK',
            'statusMessage': 'Status message'
          }
        }]
      }
    };

注文データをセッションパラメータに保存する

フルフィルメントから、注文データを session パラメータに保存します。 order オブジェクトは、同じセッションのシーン間で使用されます。

conv.session.params.order = {
    '@type': 'type.googleapis.com/google.actions.transactions.v3.TransactionDecisionValueSpec',
    order: order,
    orderOptions: orderOptions,
    presentationOptions: presentationOptions,
    paymentParameters: paymentParameters
};

注文内容を表示する

注文を作成したら、確認または拒否できる注文をユーザーに提示する必要があります。そのためには、トランザクション決定を行うシーンに移行する必要があります。

取引決定シーンを作成する

[Scenes] タブで、TransactionDecision という名前の新しいシーンを追加します。
[スロット充填] で [+] をクリックして、新しいスロットを追加します。
[Select type] で、プルダウンから actions.type.TransactionDecisionValue を選択します。スロットタイプを指定します。
スロット名のフィールドで、スロットに「TransactionDecision」という名前を付けます。
[スロット値のライトバックをカスタマイズする] チェックボックスを有効にします（デフォルトで有効になっています）。
[スロットの設定] で、プルダウンから [セッションパラメータを使用] を選択します。
[スロットの設定] で、使用するセッションパラメータの名前を入力します。を使用して注文をテキストフィールド（$session.params.order）に保存します。
[保存] をクリックします。

TransactionDecisionValue スロットを埋めようとすると、アシスタントは次の処理を開始します。渡した Order が直接レンダリングされる、組み込みのエクスペリエンスカートのプレビューカードお客様は「注文して」と話しかけて取引を拒否し、クレジットカードや住所などのお支払い方法の変更、または変更のリクエスト確認できます。

ユーザーはこの時点で注文内容の変更をリクエストできます。今回は変更後は、フルフィルメントが注文変更リクエストを処理できるようにカートの組み立て作業を完了します

取引判断の結果を処理する

TransactionDecisionValue スロットがいっぱいになると、ユーザーの応答は、トランザクションの決定はセッションパラメータに格納されます。この値に含まれるもの次のとおりです。

ORDER_ACCEPTED
ORDER_REJECTED
DELIVERY_ADDRESS_UPDATED
CART_CHANGE_REQUESTED
USER_CANNOT_TRANSACT。

トランザクションの決定結果を処理するには:

[Scenes] タブで、新しく作成した TransactionDecision シーンを選択します。
[Condition] で、[+] をクリックして新しい条件を追加します。

テキストフィールドに次の条件構文を入力して、成功条件を確認します。

scene.slots.status == "FINAL" && session.params.TransactionDecision.transactionDecision == "ORDER_ACCEPTED"

先ほど追加した条件にカーソルを合わせて、上矢印アイコンをクリックします。 if scene.slots.status == "FINAL" より前に配置する必要があります。

[プロンプトを送信] を有効にし、簡単なプロンプトでユーザーに知らせる注文が完了しています。

candidates:
  - first_simple:
      variants:
        - speech: >-
            Transaction completed! Your order
            $session.params.TransactionDecision.order.merchantOrderId is all
            set!

[切り替え] で [会話を終了] を選択して、会話を終了します。
[Condition] で、[+] をクリックして新しい条件を追加します。

テキストフィールドに次の条件構文を入力して、失敗条件:

  scene.slots.status == "FINAL" && session.params.TransactionDecision.transactionDecision == "ORDER_REJECTED"

先ほど追加した条件にカーソルを合わせて、上矢印アイコンをクリックします。 if scene.slots.status == "FINAL" より前に配置する必要があります。
[プロンプトを送信] を有効にし、簡単なプロンプトでユーザーに知らせる注文が拒否されました。
```
candidates:
  - first_simple:
      variants:
        - speech: Look like you don't want to order anything. Goodbye.
```
[切り替え] で [会話を終了] を選択して、会話を終了します。
条件 else if scene.slots.status == "FINAL" を選択します。

[プロンプトを送信] を有効にし、ユーザーが操作できるようにする簡単なプロンプトを入力します。取引ができないことを知らせる:

candidates:
  - first_simple:
      variants:
        - speech: >-
            Transaction failed with status
            $session.params.TransactionDecision.transactionDecision

[切り替え] で [会話を終了] を選択して、会話を終了します。ユーザーが取引を行えない場合

注文を確定して領収書を送る

TransactionDecisionValue スロットが ORDER_ACCEPTED の結果を返す場合、「確認」に必要な処理はすべて直ちに行う必要があります。（独自のデータベースに永続化してユーザーに請求するなど）。

この回答で会話を終了することもできますが、その場合は返信して会話を前進させましょう。このイニシャルを orderUpdate の場合、「折りたたまれた状態の領収書カード」がユーザーに表示されます。これに加えて、できます。このカードには、お客様が注文履歴

注文の確認時に、注文オブジェクトに userVisibleOrderId この注文に関してユーザーに表示される ID です。既存のこのフィールドの merchantOrderId。

OrderUpdate オブジェクトの一部には、フォローアップアクションオブジェクトを含める必要があります。ユーザーが注文した注文の詳細の一番下に URL ボタンとして表示されますアシスタントの注文履歴で確認できます。

少なくとも、 VIEW_DETAILS 注文ごとにフォローアップアクションを行いますこれにはモバイルアプリやウェブサイトでの注文を表す
また、法的な条件をすべて満たした正式な領収書をメールで送付する必要があります。取引を行うための要件として、レシートカードに加えて必要があります。

最初の注文の更新情報を送信するには:

[Scenes] タブから、TransactionDecision シーンを選択します。

[Condition] で、成功の結果を確認する条件を選択します。 ORDER_ACCEPTED:

  scene.slots.status == "FINAL" && session.params.TransactionDecision.transactionDecision == "ORDER_ACCEPTED"

この条件に対して [Call your webhook] を有効にし、インテントを指定します。ハンドラ名（例: update_order）

Webhook のコードで、最初の注文を送信するためのインテントハンドラを追加します。更新:

app.handle('update_order', conv => {
  const currentTime = new Date().toISOString();
  let order = conv.session.params.TransactionDecision.order;
  conv.add(new OrderUpdate({
    'updateMask': {
      'paths': [
        'purchase.status',
        'purchase.user_visible_status_label'
      ]
    },
    'order': {
      'merchantOrderId': order.merchantOrderId,
      'lastUpdateTime': currentTime,
      'purchase': {
        'status': 'CONFIRMED',
        'userVisibleStatusLabel': 'Order confirmed'
      },
    },
    'reason': 'Reason string
  }));
});

注文の更新情報を送信する

全期間を通じて、注文のステータスをユーザーに通知し続ける必要があります。HTTP を送信してユーザーの注文の最新情報を送信する注文のステータスと詳細を含む PATCH リクエストを Orders API に送信します。

Orders API に非同期リクエストを設定する

Orders API への注文更新リクエストはアクセス権によって承認されるあります。Orders API で注文の更新を PATCH するには、JSON をダウンロードしてください。サービスアカウントキーを使用して ID を交換し、サービスアカウントキーに、署名なしトークンの HTTP リクエストの Authorization ヘッダー。

サービスアカウントキーを取得するには、次の手順に従います。

Google Cloud コンソールで次の操作を行います。 メニュー 💻? > に移動API とサービス >クルデンシャル >認証情報を作成 >サービスアカウントキー。
[サービスアカウント] で [新しいサービスアカウント] を選択します。
サービスアカウントを service-account に設定します。
[役割] を [プロジェクト] > [オーナー] に設定します。
キータイプを [JSON] に設定します。
[作成] を選択します。
非公開の JSON サービスアカウントキーがローカルマシンにダウンロードされます。

注文更新コードで、サービスキーを署名なしトークンと交換できます Google API クライアントライブラリと "https://www.googleapis.com/auth/actions.order.developer" スコープ。詳しくは、 API クライアントライブラリのインストール手順と例 GitHub ページ。

order-update.js については、 Node.js サンプル鍵交換の例をご覧ください。

注文の更新情報を送信する

サービスアカウントキーを OAuth 署名なしトークンと交換したら、承認済みの PATCH リクエストとして注文の更新情報を Orders API に送信できます。

Orders API の URL: PATCH https://actions.googleapis.com/v3/orders/${orderId}

リクエストに次のヘッダーを指定します。

"Authorization: Bearer token" は、OAuth 署名なしトークンに置き換えますサービスアカウントキーを交換した場所。
"Content-Type: application/json"。

PATCH リクエストは、次の形式の JSON 本文を使用します。

{ "orderUpdate": OrderUpdate }

OrderUpdate オブジェクトは、次のトップレベルフィールドで構成されています。

updateMask - 更新する注文のフィールド。更新するには、注文ステータス値を purchase.status, purchase.userVisibleStatusLabel に設定します。
order - 更新の内容。Deployment を更新する場合は、更新した Order オブジェクトに値を設定します。注文のステータスを更新する場合（例: "CONFIRMED" から "SHIPPED" など）、オブジェクトには次のフィールドがあります。
- merchantOrderId - Order オブジェクトで設定したのと同じ ID。
- lastUpdateTime - この更新のタイムスタンプ。
- purchase - 以下を含むオブジェクト。 <ph type="x-smartling-placeholder">
  - status - PurchaseStatus としての注文のステータス。例: 「SHIPPED」または「DELIVERED」。
  - userVisibleStatusLabel - 詳細情報を提供するユーザー向けのラベル（「ご注文は発送され、あります。
userNotification （省略可） - A userNotification この更新の送信時にユーザーのデバイスに表示できるオブジェクトです。備考このオブジェクトを含めても、通知がアクセスします。

次のサンプルコードは、バージョンを更新する OrderUpdate の例を示しています。 DELIVERED への注文のステータス:

// Import the 'googleapis' module for authorizing the request.
const {google} = require('googleapis');
// Import the 'request-promise' module for sending an HTTP POST request.
const request = require('request-promise');
// Import the OrderUpdate class from the client library.
const {OrderUpdate} = require('@assistant/conversation');

// Import the service account key used to authorize the request.
// Replacing the string path with a path to your service account key.
// i.e. const serviceAccountKey = require('./service-account.json')

// Create a new JWT client for the Actions API using credentials
// from the service account key.
let jwtClient = new google.auth.JWT(
    serviceAccountKey.client_email,
    null,
    serviceAccountKey.private_key,
    ['https://www.googleapis.com/auth/actions.order.developer'],
    null,
);

// Authorize the client
let tokens = await jwtClient.authorize();

// Declare order update
const orderUpdate = new OrderUpdate({
    updateMask: {
      paths: [
        'purchase.status',
        'purchase.user_visible_status_label'
      ]
    },
    order: {
      merchantOrderId: orderId, // Specify the ID of the order to update
      lastUpdateTime: new Date().toISOString(),
      purchase: {
        status: 'DELIVERED',
        userVisibleStatusLabel: 'Order delivered',
      },
    },
    reason: 'Order status updated to delivered.',
});

// Set up the PATCH request header and body,
// including the authorized token and order update.
let options = {
  method: 'PATCH',
  uri: `https://actions.googleapis.com/v3/orders/${orderId}`,
  auth: {
    bearer: tokens.access_token,
  },
  body: {
    header: {
      isInSandbox: true,
    },
    orderUpdate,
  },
  json: true,
};

// Send the PATCH request to the Orders API.
try {
  await request(options);
} catch (e) {
  console.log(`Error: ${e}`);
}

購入ステータスを設定する

注文の更新の status 注文の現在の状態を示す必要がありますアップデートの order.purchase.status 次のいずれかの値を使用します。

CREATED - ユーザーが注文を承諾しています。アクションからみると、バックエンドで手動処理が必要な状態です。
CONFIRMED - 注文は有効で、納品へ向け処理中です。
IN_PREPARATION - 注文は発送または配達の準備中です（食品など）調理中や梱包中の商品などです
READY_FOR_PICKUP - 注文を受け取る準備ができています。
DELIVERED - 受取人への配達が完了しました。
OUT_OF_STOCK - 注文の 1 つ以上の商品が在庫切れです。
CHANGE_REQUESTED - ユーザーが注文の変更をリクエストし、変更があります。
RETURNED - 配送後にユーザーから返品されました。
REJECTED - 注文を処理または請求できない場合。あるいは、注文を有効にできない場合。
CANCELLED - ユーザーが注文をキャンセルしました。

注文状況に関連するステータスごとにあります。たとえば、取引で次の処理を手動で行う必要がある場合。注文後に注文を記録すると、次の期限までに CREATED の注文更新情報を送信します。追加の処理が行われます。すべての注文でステータス値が必要になるとは限りません。

プロジェクトをテストする

プロジェクトをテストする際に、Actions Console でサンドボックスモードを有効にできます。支払い方法に請求せずにアクションをテストできます。サンドボックスモードを有効にする手順は次のとおりです。

Actions Console で、ナビゲーションの [Test]（テスト）をクリックします。
[設定] をクリックします。
[Development Sandbox] オプションを有効にします。

現物取引の場合は、isInSandbox フィールドを true に設定することもできます。選択できます。この操作は、アクセスすることもできます。isInSandbox を使用するコードスニペットについては、以下をご覧ください。 [注文の最新情報を送信する] セクション。

トラブルシューティング

テスト中に問題が発生した場合は、取引に関するトラブルシューティングの手順をご覧ください。

販売者が管理する決済方法で物理的取引を構築する

取引の流れ

制限と審査のガイドライン

プロジェクトのビルド

プロジェクトの設定

ユーザーのアカウントをリンクする（省略可）

認証フローの音声ユーザー インターフェースを設計する

ユーザーが確認済みかどうかを確認し、アカウントのリンクのフローを開始する

アカウントのリンクシーンをカスタマイズする

情報を収集する（省略可）

取引要件を確認する（省略可）

トランザクション要件チェックシーンを作成する

トランザクション要件チェック結果の処理

配送先住所をリクエストする（省略可）

配達先住所のシーンを作成する

注文を作成する

注文を作成する

注文オプションとプレゼンテーション オプションを作成する

支払いパラメータを作成する

注文データをセッション パラメータに保存する

注文内容を表示する

取引決定シーンを作成する

取引判断の結果を処理する

注文を確定して領収書を送る

注文の更新情報を送信する

Orders API に非同期リクエストを設定する

注文の更新情報を送信する

購入ステータスを設定する

プロジェクトをテストする

トラブルシューティング

認証フローの音声ユーザーインターフェースを設計する

注文オプションとプレゼンテーションオプションを作成する

注文データをセッションパラメータに保存する