Transactions API のサポートは 2023 年 6 月 13 日に終了します。2023 年 5 月 3 日に終了します。詳細については、
会話型アクションの廃止をご覧ください。
設計ガイドライン
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
取引フローでユーザーを案内する会話を設計します。ここで説明するサンプルは、独自の取引アクションを設計する際のガイドとして利用できます。
例
設計のヒント
対話が自然な会話のように聞こえるようにします。これは、実際の人が話すように聞こえます。
TTS/音声で読み上げられるテキストは、チャットのふきだしに表示されるテキストと完全に一致する必要はありません。チャットのふきだしが音声ダイアログのサブセットである場合に適しています。
訪問者に挨拶して、会話に参加させましょう。何が必要かを尋ねて
ヒントをいくつか提示します
カートへの商品追加を促す前に、バックエンド チェックを行い、スロットフィルを追加し、actions.type.TransactionRequirementsCheckResult
スロットタイプを使用して、ユーザーが Google アシスタントに対して支払いが設定されていることを確認します。
音声に関しては、他のモバイル / ウェブ エクスペリエンスと同じ問題に対応するための準備をしておいてください。たとえば、特定のサイズや色が品切れの場合に同様の商品を提供し、再入荷したときに通知が届くよう登録するようユーザーを招待します。
注文概要は、API を介して渡されたデータで作成されます。「Google でお支払い」ラベルは、Google が支払いを行っていることをユーザーが把握するのに役立ちます。
ユーザーに住所情報などの情報をリクエストする場合は、まず、リクエストを行う理由とそれがユーザーにとってどのようなメリットがあるのかを説明します。
Google は、ユーザーの設定に基づいて、購入の承認方法(認証は不要、パスワード、指紋のいずれか)を提示します。リスク評価では、カードの CVV の確認など、追加の認証手順が開始されることがあります。
支払いが完了したら、領収書と注文確認を必ず送信してください。ユーザーが最終販売責任を負う商業者であることをユーザーが理解し、Google ではなく、注文に関するすべての詳細情報についてフォローアップすることが重要です。
デフォルトでは、取引は画面付きのサーフェス(Android スマートフォンなど)または音声のみのサーフェス(Google Home など)で実行できます。
音声のみのトランザクションを適切にサポートするには、ユーザーに完全なトランザクション エクスペリエンスの流れを案内する優れた会話エクスペリエンスを特別に設計してください。
取引のインテントによっては画面が必要になることがあります。こうした機能のほとんど(新しい配送先住所の追加、支払いに関する問題の解決、アカウントのリンクなど)は、スマートフォンに自動的に引き継がれます。画面への表示に最適な会話への追加(カード作成用のリッチ レスポンスの表示、販売者の利用規約やプライバシー ポリシーの表示など)があれば、現在のサーフェスが RICH_RESPONSE
または WEB_LINK
のcapabilitiesをサポートしているかどうかを確認し、サポートされていない場合は新しいサーフェスに転送する必要があります。
アクションで音声のみのトランザクションをサポートしない場合は、Actions Console の [デプロイ] > [サーフェス機能] に移動し、[アクションで画面出力を要求する] を [はい] に設定することで、Actions プロジェクトで画面を要求するように設定できます。
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-07-25 UTC。
[null,null,["最終更新日 2025-07-25 UTC。"],[[["\u003cp\u003eDesign conversational transactional flows, similar to natural human interactions, guiding users through the process.\u003c/p\u003e\n"],["\u003cp\u003eUtilize provided examples and design tips to create effective and user-friendly transactional Actions.\u003c/p\u003e\n"],["\u003cp\u003eEnsure clear communication, address potential issues proactively, and inform users about Google's role in payment processing.\u003c/p\u003e\n"],["\u003cp\u003eOptimize for both screen and voice-only interactions by tailoring the conversation and utilizing surface capabilities effectively.\u003c/p\u003e\n"],["\u003cp\u003eCustomize the user experience by enabling or disabling screen requirements based on your Action's functionalities.\u003c/p\u003e\n"]]],[],null,["# Design guidelines\n\nDesign a conversation to guide users through your transactional\nflows. We've provided reference examples that you can use as a guide\nwhen designing your own transactional Actions.\n\nExamples\n--------\n\n[](https://docs.google.com/presentation/d/1Zw-Cg4ODJWpEViJJT_LugxvFv1VeOB7Hw54wNQemrfg) [Shoe store Example](https://docs.google.com/presentation/d/1Zw-Cg4ODJWpEViJJT_LugxvFv1VeOB7Hw54wNQemrfg) \n[](https://docs.google.com/presentation/d/1RBVzklC8n7nPU98lRt1CkzDSFcBlaQf5PWVtlr58OQQ) [Ticketing example](https://docs.google.com/presentation/d/1RBVzklC8n7nPU98lRt1CkzDSFcBlaQf5PWVtlr58OQQ) \n[](https://docs.google.com/presentation/d/1icd64B_mJvba6lmhlfmUy35sejy5n-LsYYkvPXzUXgA) [Flower Shop Example](https://docs.google.com/presentation/d/1icd64B_mJvba6lmhlfmUy35sejy5n-LsYYkvPXzUXgA)\n\nDesign tips\n-----------\n\n- Make sure the dialogs\n [sound natural and conversational](/assistant/conversational/df-asdk/design)\n --- the way a real person would talk.\n\n- The text spoken by your TTS/voice does not have to exactly match the text\n shown in your chat bubbles. It works well if the chat bubbles are a subset\n of the spoken dialog.\n\n- Greet your visitors and get them engaged. Ask what they need and offer a\n few suggestion chips to get them started.\n\n- Before inviting the user to add items to the cart, do a backend check by\n adding slot filling and using the `actions.type.TransactionRequirementsCheckResult`\n slot type to confirm the user has payments set up for their Google Assistant.\n\n- Be prepared to respond to the same issues with voice as with other mobile\n or web experiences. For example, offer a similar item when you're out of a\n certain size or color, or invite users to sign up to be notified when the\n item is back in stock.\n\n- Note that the order summary is built with the data you pass via the API.\n The \"Pay with Google\" label helps users understand that Google facilitated\n the payment.\n\n- When requesting info from your users, like their address info, first let\n them know why you are making the request and how it will benefit them.\n\n- Google will present the purchase authorization method (either no auth\n required, password, or fingerprint) based on the user's settings. Sometimes\n our risk assessment will kick off an additional auth step like confirming\n CVV for a card.\n\n- After the payment is complete, be sure to send a receipt and an order\n confirmation. It's important that users understand that you are the merchant\n of record, and will follow up with all details about the order, not Google.\n\n- By default transactions can be performed on either a surface with a\n screen (such as an Android phone) or a voice-only surface (such as a Google Home).\n\n - To best support voice-only transactions, take extra care to design\n a [good conversational experience](/assistant/conversational/df-asdk/design)\n that walks users through the full transaction experience.\n\n - Note that some transactions intents may require a screen. Most of these\n (e.g. adding a new delivery address, fixing payment issues, account linking)\n will be handed off to the phone automatically. If there are any additions\n to the conversation that are best displayed on a screen\n (e.g. presenting rich responses for card building, displaying a merchant\n ToS or privacy policy), you should check if the current surface supports\n the `RICH_RESPONSE` or `WEB_LINK`\n [capabilities](/assistant/conversational/reference/rest/v1/TopLevel/fulfill#capability),\n and transfer to a new surface if not.\n\n - If you would rather not support voice-only transactions with your\n Action, you can set your Actions project to require a screen by\n navigating to **Deploy \\\u003e Surface capabilities** in the\n [Actions console](https://console.actions.google.com) and setting\n **Do your Actions require a screen output** to **Yes**."]]