Gemini アプリや Google 検索などの Google サービス全体でアプリ連携を設計するためのガイドライン。
概要
MCP 接続アプリを使用すると、ユーザーは該当する Google プロダクトの大規模言語モデル(LLM)を接続して、アプリのデータを読み書きできます。アプリが会話のコンテキストを共有するため、ユーザーはタブやアプリを切り替えることなく、タスクを簡単に完了できます。これらのガイドラインを確認して、接続されたアプリが該当する Google サービス全体で公開されるようにしてください。
接続済みアプリを作成する
アプリ連携機能を使用する場面
次のシナリオに対応する接続アプリケーションを構築します。
- 注文、予約、スケジュールの確定など、開始と終了が明確なタスク。
- ユーザーがすぐに適用できる実用的な情報。
- データの分析、ドキュメントの確認、プロジェクトの調整など、自然な会話型ワークフロー。
- AI が実現できることを大幅に拡大するコア機能。
ツールは、予約やドキュメントの作成など、AI の支援を受けてユーザーがアクションを完了できるようにすることが理想的です。基盤モデルによってプロセスを簡素化できる複雑なアクションに焦点を当てます。
避けるべきこと
コネクテッド アプリを設計する際は、次のパターンを避けてください。
- プルダウン、コンテキスト メニュー、ポップオーバー パネル: これらの要素は、コンテナの境界でクリップされるか、ホスト サーフェスの UI と競合します。
- ネストされたスクロール: スクロール コンテナ内でのスクロールは避けてください。
- 多層ビュー: パンくずリストやドリルイン インターフェースは使用しないでください。
- 長いプロセス: 表示モードの範囲を超えるフローは避けてください。
- スタンドアロン ウェブアプリ: 完全なウェブアプリは複製しないでください。
- 期待に応えられない: ユーザーは、コネクテッド アプリが読み込まれると、基本的なレベルのユーティリティを期待します。単一のボタンなど、ささいな機能をレンダリングするためだけにアプリを作成しないでください。
- 自動リダイレクト: ユーザーが明確に表示された外部リンクをクリックしない限り、外部ウェブサイトやネイティブ アプリを自動的に起動しないでください。
コンテナとレイアウト
ホストコンテナは、モデルの回答とともに接続済みアプリをフレーム表示します。これらのコンテナは、パートナーのアトリビューション、一貫した枠線、該当する Google サービス全体でのレスポンシブなサイズ設定を提供します。
コンテナの構造
- ヘッダー: パートナーのアイコンと正式名称が表示されます。
- コンテンツ: インライン カードまたは横方向のカルーセルとして表示されます。
- レスポンス テキストのペア設定: 表示モードは常にモデルのレスポンス テキストに付随します。この結合されたレイアウトを考慮して設計します。
- UI スタイル: 該当する Google サービス全体でホストコンテナのスタイルを継承します。
レスポンシブな動作
接続済みアプリは、さまざまなコンテナ幅とデバイスのビューポートでレンダリングされます。固定サイズを避ける:
- 水平方向にリフローする: 水平方向のクリッピングなしで、コンパクトなサイドバー、モバイル画面、ワイドなデスクトップ フィードの間で適切に適応する柔軟なレイアウトを使用します。
- コンテンツを縦方向に合わせる: インライン コンテナを、読みやすい高さまでコンテンツに合わせて拡大できるようにします。カードに固定の空きスペースを埋め込んだり、コンテンツを垂直スクロールバーに閉じ込めたりしないでください。
- デバイス入力を尊重する: モバイルではネイティブのタッチ ジェスチャーとセーフエリアをサポートし、パソコンではホバー状態をサポートします。
避けるべきこと
- パディングの重複を避ける: 接続済みアプリには、システム標準を満たすためのデフォルトの内部パディングが含まれています。意図しないスペースを避けるため、内部コンテンツから余分なパディングを削除します。
- 不均衡な角丸を避ける: 内部の形状をホスト コンテナの角丸に比例させ、角が過度に尖ったり丸くなったりしないようにします。
- 独自のストロークを追加しない: コンテナには、デフォルトでシステム定義の枠線スタイルが含まれています。内部コンポーネントの周囲に余分な枠線やストロークを適用しないでください。
表示モード
表示モードは、拡張機能が該当する Google サービスの回答とともにビジュアル UI を直接表示する方法を定義します。インライン カードまたは全画面表示の 2 つのメイン表示モードのいずれかを使用します。
インライン カード
インライン カードは、レスポンス フローに直接埋め込まれた、軽量で単一目的のコンポーネントです。インライン カードは、簡単な確認、構造化データの検査、1 ステップのアクションに使用します。
インライン カードを使用するケース
- ステータスの更新と確認。
- シンプルなデータ表示または選択。
- 簡単な要約と、必要に応じて詳細な説明。
- 会話を続けるためのクイック操作。
コンテンツの密度と切り捨てのガードレール
- タイトルのクランプ: カードのタイトルを 1 ~ 2 行に制限し、省略記号で切り詰めることで、ヘッダーがアクションをビューの外に押し出さないようにします。
- 本文とメタデータの制限: 補足コピーは 2 ~ 3 行に制限し、アイテムごとのメタデータは 2 ~ 3 個のスキャン可能な属性に制限します。
- 簡潔な CTA コピー: 動詞を先頭に置いたアクション ラベル(「テーブルを予約する」、「注文を確定する」など)を使用し、カードのフッターにはメインの CTA を 1 つと、オプションのサブアクションを 1 つだけ表示します。
カルーセルの定義: カルーセルには、スクロールしても疲れないように 3 ~ 8 枚のカードを含める必要があります。すべてのカードの高さと幅は同じにする必要があります。カードのタイトルは 1 ~ 2 行に収め、メタデータはカードあたり 2 ~ 3 フィールドに制限します。
インライン カードの操作
インライン カードは、ユーザーが会話を続けられるように、迅速で直接的なアクションに重点を置く必要があります。
- インライン アクション: ユーザーがカード内で直接アクションを実行できるようにします。たとえば、テキストの編集、アイテムの追加、タスクのチェックオフなどです。
- 状態の更新: 複雑なユーザー アクションをエンティティ内ではなく、スレッドに直接反映します。たとえば、ユーザーが宿泊を予約すると、会話に「予約済み」ラベルを表示する更新されたカードが生成されます。
カルーセルのパソコン向けナビゲーション
- ホバー メカニクス: ナビゲーション アイコンボタンはデフォルトでは非表示のままで、コンテナにカーソルを合わせると表示されます。
- オーバーフロー スクリム: 開始状態では右端のスクリムが表示され、中央では両端が表示され、終了状態では左端が表示されます。
カルーセルのモバイル エクスペリエンス
- タッチ操作: ネイティブの水平スワイプを使用します。カルーセル カード間にギャップがあります。
- カードのピーク: 開始状態では左パディングを使用し、中央ではパディングを使用せず、終了状態では右パディングを使用します。
インライン カードで避けるべきこと
- ネストされたスクロールを避ける: 内部の垂直スクロールバーは含めないでください。
- マルチビュー ドリルを避ける: インライン カード内では、パンくずリスト、マルチタブビュー、マルチステップ ドリルダウンを使用しないでください。複雑なフローは全画面表示に移動します。
- メニューに表示されるコントロールを避ける: プルダウン、ポップオーバー、コンテキスト メニューは、コンテナのクリッピングや z-index の競合の原因となるため、使用しないでください。
- 重複する入力を避ける: 該当する Google サービスにはすでに入力があるため、カード内に別の入力を配置しないでください。
- 内部の縦スクロールを避ける: スクロール可能なコンテナをカード内に配置しないでください。スクロール トラップが発生し、モバイル ナビゲーションが低下します。
- ポップオーバーを避ける: ポップオーバーはコンテンツを覆い、UI を煩雑にするため、ツールチップやポップオーバー オーバーレイを使用して重要な詳細を表示しないでください。
- プルダウン メニューを避ける: プルダウン セレクタ内にアクションを埋め込まないでください。メイン アクションを明示的なボタンとして表示する。
- カルーセルでスクロール オーバーフローを非表示にしない: 隣接するカードが少し見えるようにして、スクロールするとさらにコンテンツが表示されることをユーザーが認識できるようにします。
- カスタム エラー コンポーネントを避ける: カスタム エラー状態は使用しないでください。ホスト UI は、エクスペリエンス全体で一貫して標準のエラー コンポーネントを提供します。
- モーダルの使用を避ける: MCP アプリはモーダルをサポートしていません。より広いスペースが必要な場合は、代わりに全画面モードに切り替えるオプションを提供してください。
全画面表示
全画面モードは、インライン カードに収まらない、リッチでマルチステップのタスクやデータ量の多いワークフローの没入型キャンバスとして使用します。
全画面表示を使用するタイミング
- 不動産物件、メニュー、インタラクティブ マップなどの高密度なコンテンツを閲覧する。
- インライン カード以外の専用スペースを必要とするキャンバスや図の編集など、複雑なワークフロー。
- データと分析。たとえば、詳細なダッシュボード、データの可視化、詳細な分析ツールなど、注意を集中する必要があるもの。
全画面表示のレイアウトと操作
- ヘッダー: アプリの帰属情報とアクションを含む、システム提供のヘッダーバーを表示します。
- セーフエリアのインセット: コンテンツが重ならないように、ヘッダーバーの下に明確なスペースを確保します。
- 閉じる、開く: 全画面表示で開くボタンと、全画面表示のヘッダーに閉じるボタンを表示します。
全画面表示で避けるべきこと
- ネイティブ アプリの複製を避ける: 全画面表示を使用して、複数のステップからなるタスクに集中できるようにし、エンゲージメントを高めます。
- 入力の重複を避ける: 該当する Google サービスにはすでに入力があるため、パートナーはビュー内にもう 1 つ入力を配置しないでください。
- フローティング パネルを避ける: フローティング モーダルやフローティング ドラッグ可能なインスペクタ ツールバーは、インターフェースを乱雑にし、ホスト サーフェス オーバーレイと競合するため、使用しないでください。
- セーフエリアの重複を避ける: インタラクティブ要素が、ホスト サーフェスのツールバーやシステム インジケーター(ステータスバーやホームバーなど)と重ならないようにします。
対応ガイドライン
ユーザーが接続済みアプリ内でコンテンツを操作する方法、アクションがホストの会話と同期する方法、複雑なワークフローを外部アプリまたはウェブサイトに引き継ぐタイミング。
アプリ UI と会話の分業
接続済みアプリと会話型プロンプトを補完的なレイヤとして設計します。
- 接続されたアプリの UI を使用して直接操作する: テキスト プロンプトの入力が面倒または曖昧になる場合は、地図のパン、構造化されたオプションの比較、複数フィールドのフォーム コントロール、視覚的な選択など、空間ブラウジングに UI を使用します。
- 自由形式のインテントにホスト会話を使用する: 自然言語のフォローアップ、マルチステップの合成、広範な探索クエリに会話を使用します。
段階的に明かしていく
- 段階的な開示: ユーザーのニーズに応える最もコンパクトな表示モード(インライン カードまたはカルーセル)から始め、必要に応じて二次的な詳細を表示し([もっと見る])、詳細な探索が必要な場合にのみ全画面表示にエスカレーションします。
- 非表示メニューではなく表示コントロール: 主要なアクションは、ホバーのみのツールバー、右クリックのコンテキスト メニュー、モバイル ビューポートで失敗する長押しジェスチャーに埋め込むのではなく、明示的なボタンまたは切り替えとして表示します。
外部への引き継ぎとリンク
一部の機能は、埋め込み iframe の範囲を超えているか、ネイティブ OS とハードウェア機能を必要とします。アプリまたはサイトにリンクするタイミング:
- ネイティブ OS またはハードウェアに依存する機能(ライブ ナビゲーション、カメラやセンサーによるキャプチャ、継続的なバックグラウンド音声や位置情報のトラッキングなど)。
- 規制対象またはセキュリティに配慮したフロー(最終的な支払いの決済や本人確認など)。
- 全画面表示を超える深いワークスペース(フル機能のオーサリング スイートや複雑なエンタープライズ ダッシュボードなど)。
引き継ぎの設計
- 外部リンクのアフォーダンスを明確に示す: 外部ハンドオフ ボタンには、必ず明示的な起動インジケーター(
open_in_newアイコンなど)と、リンク先を明記したラベル(「Google マップで開く」など)を組み合わせます。 - コンテキストを保持したディープリンク: 会話で確立されたすべてのパラメータを、ホストの外部リンク API(
openLink)を介してディープリンク URL に渡します。これにより、ユーザーはアプリを切り替えた後に選択内容を再入力する必要がなくなります。
避けるべきこと
- 自動リダイレクトを避ける: ユーザーをホスト サーフェスから自動的に移動させないでください。ホスト サーフェスを離れるには、常にユーザーが明示的にクリックする必要があります。
- 「ティーザー」カードやリンクのみのカードを避ける: ユーザーをウェブサイトに誘導する静的なバナーやボタンをレンダリングすることのみを目的とした接続済みアプリを構築しないでください。
- 予告なしのコンテキスト切り替えを避ける: 外部アプリやブラウザタブが開くことを示さずに、外部リンクをカード内アクションと同じスタイルにしないでください。
画像のガイドライン
該当する Google サービスでは、認知負荷を軽減するために、軽量でニュートラルな UI 要素と、コントラストを抑えたデザインを優先しています。
ビジュアルの原則
コア設計原則を適用して、コネクテッド アプリ全体の視覚的な密度と美しさを管理します。
- 軽量で最小限の UI: ストロークとコンテナ要素を減らして、すっきりとした視覚密度を維持します。
- ニュートラル カラーのバランス: ニュートラルなグレーの色合いを優先し、アクセント カラーはメインの CTA に使用します。
- エレベーション: 柔らかい表面の塗りつぶしを適用し、ドロップ シャドウを全画面モードとカルーセル ナビゲーション コントロールのみに限定します。
- スタイルの継承: 色、タイポグラフィ、角丸を適用して、該当するすべての Google サービスでアプリがネイティブに感じられるようにします。
色
該当する Google サービスでは、色を 2 つの機能グループに分類しています。構造レイアウト用のシステムカラーと、主要なブランド モーメント用のアクセント カラーです。これらのセマンティック ロールを使用することで、明確な視覚的階層が確保され、プロダクト全体でテーマが自動的に適用されます。
システムカラーのロール
構造色を、接続済みアプリ全体で一貫した UI ロールにマッピングします。
- 背景サーフェス: カードコンテナとネストされたグループには、ホストが提供するニュートラルなサーフェス色を使用します。カスタムの単色塗りつぶし、グラデーション、パターンでコンテナの背景をオーバーライドしないでください。
- テキストとコンテンツの階層: タイトルとキー値にはメインのコンテンツの色、本文と補助ラベルにはセカンダリの落ち着いたトーン、運用メタデータにはセマンティック ステータスの色(ポジティブ、警告、クリティカル)を使用します。
- 枠線と区切り線: 構造的な枠線と区切り線には、控えめなシステム アウトライン カラーを使用して、ビジュアル ウェイトを加えることなくコンテンツを分離します。
- プライマリ アクセント: プライマリ CTA ボタンには、システム アクセントまたはパートナー ブランドカラーを使用します。
パートナー ブランドの適用領域
コネクテッド アプリ全体でのパートナー ブランドカラーの配置をガイドする:
- 推奨: ブランドカラーは、メインの行動を促すフレーズのボタン、ロゴ、重要なハイライトの瞬間にのみ適用します。
- 非推奨: カードの背景、本文テキスト、タイトル、構造的な枠線、セカンダリ インタラクティブ コントロールにブランドカラーを適用しないでください。
テーマ設定とライトモード / ダークモード
コネクテッド アプリは、ライトモードとダークモードの両方、およびダイナミック サーフェス パレット全体で一貫性を感じられるようにする必要があります。
- 静的な 16 進数値ではなくセマンティック トークンを使用する: サーフェス、テキスト、枠線をホスト サーフェスのセマンティック カラー トークンにバインドして、インターフェースがライトモードとダークモードの間で自動的に適応するようにします。
- 両方のテーマに合わせてブランドのアクセント カラーを調整する: ブランドのアクセント カラーが、両方のテーマでユーザー補助のコントラストを維持できるようにします。デフォルトのブランドカラーが、ダークモードのサーフェスに対して暗すぎる、または鮮やかすぎる場合は、ダークモードでは少し明るいバリエーションや彩度を下げたバリエーションを使用します。
- テーマ対応のメディアとロゴを使用する: アイコン、ロゴ、イラストを透明な背景でエクスポートして、ダークモードで真っ白な境界ボックスが表示されないようにします。
アイコン
コネクテッド アプリでは、クリーンなアウトライン アイコンを使用して、該当する Google サービス全体で視覚的な調和とスキャン性を維持します。
アイコンのスタイルとサイズ
接続済みアプリ全体でのガイドアイコンの形状、色、サイズのしきい値:
- アウトライン化された丸みのある形状: 均一なストローク幅と丸みのあるキャップを持つモノクロのアウトライン アイコン(Google Material Symbols Outlined など)を使用するか、ホスト インターフェースのビジュアル ウェイトに一致する調和のとれたパートナー アイコンセットを使用します。
- ニュートラルな色付け: 機能的な UI アイコンには、ブランドカラーではなく、プライマリまたはセカンダリのコンテンツ カラーを使用して色付けします。これにより、アイコンはプライマリ CTA と競合することなく、読み取り階層をサポートします。
- サイズ設定の境界: アイコンは 16px(コンパクトなインライン メタデータの場合)~32px(目立つカードや機能ヘッダーの場合)の範囲に収め、ビューポート全体で読みやすさと比率を維持します。
ユーザー補助
該当する Google サービスは、WCAG 2.1 AA およびマテリアル デザイン 3 の標準に準拠したユーザー補助機能を適用しています。
ユーザー補助の主な柱
- 色のコントラスト: ライトモードとダークモードの両方で、サーフェスの背景に対するテキストのコントラスト比を 4.5:1 以上(WCAG AA)に設定します。
- 最小テキストサイズ: 13 ポイントのタイプサイズを適用します。
- タップ ターゲット: コントロールのインタラクティブなターゲット領域を、モバイルでは 48x48 ピクセル以上、パソコンでは 24x24 ピクセル以上にします。
- キーボード フォーカス: インタラクティブなカード コンポーネント全体で、表示されるフォーカス インジケーター リングと論理的なタブ移動順序を維持します。
- 動的メディアの代替テキスト: パートナーから提供されたすべての画像、サムネイル、地図のピン、データのビジュアリゼーションに、わかりやすい代替テキストを指定します。
- ライブ状態のアナウンス(
aria-live):aria-live="polite"領域を使用して、[もっと見る] 行の展開、アイテムのフィルタリング、インライン アクションの完了など、カード内の動的な状態変化をアナウンスします。 - モーションの軽減(
prefers-reduced-motion): スケルトンのシマー効果とカルーセルのスライド遷移を静的または即時の状態変化に置き換えることで、ユーザーのprefers-reduced-motionメディアクエリを尊重します。 - コンテンツのオーバーフローと切り捨て: 長いテキスト ブロックは 3 ~ 5 行に制限し、アクセス可能な「続きを読む」アクションを配置して、レイアウトの崩れを防ぎ、読みやすさを維持します。