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

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

Google Pay を使用した現物商品取引の構築

このガイドでは、Actions プロジェクトの開発プロセスについて説明します。物理的な商品の取引を組み込んでおり、支払いに Google Pay を使用しています。

取引の流れ

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

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

で確認できます。

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

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

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

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

日本
メキシコ
ロシア

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

プロジェクトのビルド

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

セットアップ

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

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

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

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

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

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

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

[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 オブジェクトには、次のトークン化パラメータが含まれます。使用する予定の Google Pay 決済代行業者に応じて変更してください。（Stripe、Braintree、ACI など）。

const paymentParamenters = {
      'googlePaymentOption': {
        // facilitationSpec is expected to be a serialized JSON string
        'facilitationSpec': JSON.stringify({
          'apiVersion': 2,
          'apiVersionMinor': 0,
          'merchantInfo': {
            'merchantName': 'Example Merchant',
          },
          'allowedPaymentMethods': [
            {
              'type': 'CARD',
              'parameters': {
                'allowedAuthMethods': ['PAN_ONLY', 'CRYPTOGRAM_3DS'],
                'allowedCardNetworks': [
                  'AMEX', 'DISCOVER', 'JCB', 'MASTERCARD', 'VISA'],
              },
              'tokenizationSpecification': {
                'type': 'PAYMENT_GATEWAY',
                'parameters': {
                  'gateway': 'example',
                  'gatewayMerchantId': 'exampleGatewayMerchantId',
                },
              },
            },
          ],
          'transactionInfo': {
            'totalPriceStatus': 'FINAL',
            'totalPrice': '15.77',
            'currencyCode': 'USD',
          },
        }),
      },
    };

tokenizationSpecification オブジェクトの内容は、サービスごとに異なります。。次の表に、各ゲートウェイで使用されるパラメータを示します。

</ph> <ph type="x-smartling-placeholder">

</ph>

例

"parameters": {
  "gateway": "example",
  "gatewayMerchantId": "exampleGatewayMerchantId"
}