Google Connected Console で AppFunctions と Android MCP を使用して接続済みアプリを作成、管理する

Google Connected Console を使用して、Android アプリのオンデバイス AppFunctions を Gemini on Android と統合します。Android MCP 接続タイプの接続済みアプリを作成し、Google Play アプリにリンクすると、Android の Gemini がユーザーに代わってアプリ内で直接アクションをトリガーし、タスクを完了できるようになります。

このガイドでは、Google Connected Console でのセルフサービス ワークフローをエンドツーエンドで説明します。これには、コネクテッド アプリの作成、Google Play アプリのリンク、公開アプリカードの設定、App Bundle のアップロードと送信、オンデバイス プレビュー テスト、製品版の公開が含まれます。

前提条件

始める前に、次の準備をしてください。

  • Google Connected Console に登録されているデベロッパー アカウントへのアクセス:
    • 利用規約への同意: 組織が Google Connected Console でアプリ連携に初めてアクセスするときに、チームメンバーがアプリ連携を作成する前に、アカウント所有者または管理者がアプリ連携の利用規約を確認して同意する必要があります。
    • ユーザー権限: 既存のコネクテッド コンソールのデベロッパー アカウントに招待されたものの、コネクテッド アプリを作成できない場合は、アカウント所有者または管理者に、[ユーザーと権限] ページで [コネクテッド アプリの表示] または [コネクテッド アプリの作成と管理] の権限を付与するよう依頼してください。また、App Bundle をアップロードしてリリースを管理するには、関連する Google Play アプリのリリース管理権限も必要です。
  • Google 接続済み Console アカウントの既存の Google Play アプリ:
    • 接続済みアプリにリンクできるように、Google Play アプリが同じデベロッパー アカウントにすでに存在している必要があります。各 Google Play アプリは、1 つの Android MCP 接続済みアプリにのみリンクできます。
    • Google Play アプリに、アプリアイコンとサポートされている言語が設定されたデフォルトのストアの掲載情報があることを確認します。Android MCP 接続アプリが利用可能な場所は、Google Play アプリのストアの掲載情報の言語と国ターゲティングによって決まります。
  • AppFunctions が実装された Android App Bundle（.aab）:
    • オンデバイス Gemini アプリ統合でサポートされているプラットフォームである Android モバイル デバイスをターゲットとするように App Bundle を構成します。
  • 接続済みアプリのカテゴリと一般公開メタデータ: 接続済みアプリの一般公開情報を構成するアセットと詳細を準備します。
    • 接続済みアプリのカテゴリ: 接続済みアプリのドメインまたは業界カテゴリ。各カテゴリは、ベースライン機能の要件を定義しており、作成後に変更することはできません。
    • アプリ名: Google サービス全体でユーザーに表示される接続済みアプリの表示名。ユーザーが Gemini で @ を使用してアプリに言及するときに使用されます。
    • 接続済みアプリのアイコン: JPEG 形式または PNG 形式の 512 px × 512 px のアプリアイコン。最大ファイルサイズは 1 MB（1,024 KB）です。
    • アプリの説明: 接続済みアプリがユーザーに提供できる機能の簡単な説明。
    • アプリの機能: アプリのカテゴリで定義されているデフォルトの機能に加えて、アプリの接続を検討しているユーザーに対してアプリの機能を示すカスタム機能を 3 つ以上。
    • プロンプトの例: Gemini でアプリを呼び出す方法をユーザーに教え、ユーザーが質問できる内容を理解できるようにする、少なくとも 3 つのサンプル プロンプト。
    • ポリシーの URL: プライバシー ポリシーの一般公開されている URL。
    • 利用規約の URL: 利用規約の一般公開 URL。
    • ウェブサイトの URL （省略可）: アトリビューションのためにウェブサイトを指す、一般公開されている URL。

Gemini で AppFunctions を登録、テスト、公開する

前提条件を満たしたら、次の手順に沿って、Android MCP 接続済みアプリの登録、Google Play アプリのリンク、アプリの詳細の入力、AppFunctions のアップロードと送信、デバイスでのテスト、製品版への公開を行います。

ステップ 1: Android MCP 接続アプリを作成し、Google Play アプリにリンクする

接続済みアプリを作成して Google Play アプリにリンクする手順は次のとおりです。

  1. Google Connected Console にログインします。
  2. [ホーム] ページで、[アプリを作成] を選択します。
  3. [作成するものを選択] ダイアログで、次の操作を行います。
    • 接続済みアプリの利用規約に同意するよう求められたら、[利用規約を表示] を選択し、利用規約を確認して同意してから、[作成] を選択します。この契約に同意できるのはアカウント管理者のみです。
    • それ以外の場合は、[接続済みアプリ] カードで [作成] を選択します。
  4. [接続済みアプリに名前を付ける] ダイアログで、接続済みアプリの名前を入力します。これは、Google サービス全体で接続済みアプリを表示する名前であり、ユーザーが @ を使用して接続済みアプリに言及する方法です。[Next] を選択します。

  5. [接続済みアプリのカテゴリを選択] ダイアログで、[カテゴリを選択] メニューからアプリのドメイン、カテゴリ、業種を選択します。

  6. [Choose connection type] ダイアログで、[Android MCP] を選択します。

    MCP サーバー接続アプリの設定に関する詳細なチュートリアルについては、Google Play Console 統合ガイドをご覧ください。現時点では、接続済みアプリごとに選択できる接続タイプは 1 つのみで、後で変更することはできません。

  7. [接続されているアプリを作成] を選択します。

  8. [アプリを選択] ダイアログで、AppFunctions を含む（または含む予定の）Play アプリを見つけて選択します。検索を使用してリストをフィルタできます。

    • 別の接続済みアプリにすでにリンクされている Play アプリは選択できません。
    • リンクする Google Play アプリを正しく選択してください。Google Play アプリを選択すると、変更できなくなります。

接続済みアプリの管理の概要ページが開き、接続済みアプリの詳細の構成、接続済みアプリのバージョンの追跡、テスターの管理を続行できます。

ステップ 2: 接続済みアプリの詳細を入力する

AppFunctions を含む App Bundle をアップロードする前に、Gemini で接続済みアプリがユーザーにどのように表示されるかを設定します。

接続されているアプリの詳細を指定する手順は次のとおりです。

  1. 接続済みアプリの管理ページの [接続済みアプリの詳細を追加] にある [Android MCP] カードで、[アプリの詳細を追加]（既存の詳細を更新する場合は [管理]）を選択します。
  2. [アプリの詳細] ページの上部にある [接続アプリ名] フィールドを確認します。必要に応じて名前を更新できます。この名前は Google の各サービスでユーザーに表示されるほか、ユーザーが @ を使ってあなたのアプリをメンションする際にも使用されます。
  3. [公開情報] セクションの [アイコン] で、アプリアイコン（JPG または PNG、1 MB 以下、512 px x 512 px）をアップロードします。

  4. 次のフィールドに値を入力します。

    • 説明: 接続済みアプリの主な機能と接続済みアプリで行えることを、簡潔な 1 文（30 語未満）で入力します。このテキストはユーザーに表示され、モデルの指示としては使用されません。
    • 機能: 接続済みアプリが実行できる価値の高いタスクを 3 つ以上入力します。[Add capability] を選択して、エントリを追加します。機能の先頭に数字を入れないでください。1 つのエントリにつき 1 つの機能のみを含めます。接続済みアプリのカテゴリに事前定義された機能が含まれている場合、それらの機能はリストの上部に表示され、変更できません。
    • プロンプトの例: ユーザーがどのような質問ができるかを理解できるように、プロンプトの例を 3 つ以上入力します。[プロンプトの例を追加] を選択して、エントリを追加します。
      • 少なくとも 2 つのプロンプトの先頭を @<YourAppName> にしてください（例: @Order Tracker where is my last order?）。
      • アプリ名（Track my recent order on Order Tracker など）で始めずに、少なくとも 1 つのプロンプトで自然に <YourAppName> に言及します。
      • 番号付きの接頭辞（1.、2.、3.）を含めたり、プロンプトを引用符（"..."）で囲んだりしないでください。

    • 多言語ローカライズ: [説明]、[機能]、[プロンプトの例] の翻訳を提供するには、入力フィールド内の言語タグで各言語のテキストをラップします。次に例を示します。

      <en-US>
Play music, manage playlists, and discover artists
</en-US>
<es-ES>
Reproduce música, gestiona listas y descubre artistas
</es-ES>

      Connected Console はタグを自動的に検証し、検出された言語 / 地域を各フィールドの下に表示します（例: Found translations for 2 languages: en-US, es-ES）。

    • 利用規約の URL: 利用規約への有効な https:// または http:// リンクを入力します。

    • ポリシーの URL: プライバシー ポリシーへの有効な https:// または http:// リンクを入力します。

    • ウェブサイトの URL （省略可）: アトリビューションのためにウェブサイトへのリンクを入力します。

ステップ 3: AppFunctions を含む App Bundle をアップロードし、接続済みアプリを送信する

接続済みアプリの詳細を保存したら、AppFunctions を含む Android App Bundle をリンクされた Google Play アプリにアップロードし、接続済みアプリのバージョンをテスト用に送信します。

AppFunctions を含む App Bundle をアップロードする手順は次のとおりです。

  1. 接続済みアプリの管理ページの [Android MCP] カードで、[AppFunctions を含む App Bundle をアップロードする] の [アプリのアップロード] を選択して、リンクされた Google Play アプリの [テストとリリース] の概要に移動します。
  2. または、リンクされた Google Play アプリを Google Connected Console で直接開きます。Google Play アプリの左側のナビゲーション メニューで、[テスト] > [内部テスト]（または別のテストトラック）に移動し、[新しいリリースを作成]（未公開のリリースがすでにある場合は [リリースを編集]）を選択します。
  3. [App Bundle] で、[アップロード] を選択して AppFunctions を含む .aab バンドルをアップロードするか、ステップ 2 の完了後にバンドルをアップロードした場合は [ライブラリから追加] を選択します。
  4. アップロードが完了したら、リリースページの [App Bundle でアプリの機能が検出されました] セクションに移動します。接続されているアプリ名、バンドル バージョン コード、検出されたツールの数、言語の数、Google Play アプリの国ターゲティングが想定どおりに表示されていることを確認し、自動チェックで問題が報告されていないことを確認します。（検証エラーが表示された場合は、AppFunctions に関連する問題のトラブルシューティングの手順に沿ってから続行します）。
  5. リリース ページの下部にある [接続済みアプリを送信して続行] を選択します。

[接続済みアプリを送信して続行] を選択すると、AppFunctions のバージョンが Gemini に送信されてプレビュー テストが行われ、Google Play のリリースがリリース プレビュー ページに進みます。App Bundle のバージョン コードを増やすことなく、ローカルビルドを使用して AppFunctions を反復処理する場合は、Google Play のリリースを下書き状態のままにして、[保存して公開] を選択しないでください。Google Play でリリースを公開すると、その App Bundle のバージョン コードがロックされ、削除や再アップロードができなくなります。それ以降に変更を加える場合は、App Bundle のバージョン コードをインクリメントする必要があります。（テスターがサイドローディングではなく Google Play の内部テストトラックからアプリを直接インストールする場合は、内部テストのロールアウトを完了し、今後のアップロードでバージョン コードをインクリメントします）。

ステップ 4: 接続されているアプリのバージョンを確認する

Google Play のリリース ページから接続済みアプリを送信したら、接続済みアプリのバージョンがプレビューの準備ができていることを確認します。

  1. 接続済みアプリの管理ページの [Android MCP] カードで、[バージョン] の横にある [表示] を選択します。
  2. [バージョン] ページで、送信したバージョンが [テスターが利用可能] セクションに表示されていることを確認します（Version <N> • Submitted <Date> • Using AppFunctions from app bundle <versionCode> が表示されます）。
    • 任意のバージョン行で [表示] を選択すると、検出された AppFunctions と、そのバージョンでキャプチャされた読み取り専用のアプリの詳細のスナップショットを確認できます。
    • アップロードされた App Bundle から作成されたバージョンで、[接続済みアプリを送信して続行] をまだ選択していないものは、[送信待ち] に表示されます。

ステップ 5: 接続済みアプリをテストする

接続済みアプリをテスターが利用できるようにするには、[テスターを管理] ページでテスターを追加する必要があります。未公開の接続済みアプリを表示して操作できるのは、テスターリストに追加したユーザーのみです。テスターとして追加できるのは、@gmail.com アカウントを持つユーザーのみです。

  1. 接続済みアプリの概要ページの [アプリをテストする] カードで、[テスターを追加]（すでにテスターを追加している場合は [テスターを管理]）を選択します。
  2. [テスターの管理] ページで、既存のメーリング リストを選択するか、[メーリング リストを作成] を選択して、統合のテストを許可する Google アカウントを追加します。ご自身でアプリをテストする場合は、ご自身のメールアドレスも忘れずに追加してください。

  3. [保存] を選択します。

  4. Gemini アプリのテスターは、@ に続けて接続済みアプリの名前を入力し、メニューから選択することで、接続済みアプリを呼び出すことができます。Gemini でアプリを表示して接続するには、左側のナビゲーション バーで [設定とヘルプ] > [接続済みアプリ] に移動します。

デバイス上でテストする前に、各テスターが次の要件を満たしていることを確認します。

  • ステップ 5 で構成したメールリストに含まれている Google アカウントを使用して、Android スマートフォンまたはタブレットにログインしている。
  • バンドル バージョン コードがステップ 4 で送信されたバージョンと一致する Android アプリビルドを実行している。

統合を徹底的にテストすることをおすすめします。

  • すべてのプロンプトの例を試します。
  • 明示的な @<AppName> 呼び出しと自然言語クエリの両方をテストします。
  • AppFunction 全体で、ツール パラメータの処理、確認プロンプト、エンドツーエンドの実行を検証します。

テストに問題がなければ、接続済みアプリを Google に送信して審査を受ける準備が整います。

ステップ 6: 接続済みアプリをユーザーに公開する

サーバーホスト型の MCP 統合とは異なり、Android MCP 接続済みアプリでは、接続済みアプリの管理ページで個別の審査や公開アクションを行う必要はありません。代わりに、接続済みアプリのバージョンは Google によって審査され、AppFunctions App Bundle を含む Google Play アプリのバージョンを製品版にリリースすると、自動的に公開されます。

テストが完了し、ユーザーにリリースする準備が整ったら、次の操作を行います。

  1. Google Connected Console で、リンクされた Google Play アプリを開き、左側のナビゲーション メニューで [リリース] > [製品版] に移動します（または、テスト済みのリリースをテストトラックから製品版にプロモートします）。
  2. [新しいリリースを作成] を選択（または既存の製品版リリースの下書きを編集）し、[ライブラリから追加] または [アップロード] を使用して、検証済みの AppFunctions を含む App Bundle を追加します。
  3. [App Bundle でアプリの機能が検出されました] セクションに移動して、接続されているアプリのバージョン、ツールの数、ストアの掲載情報の言語数、Google Play アプリの国ターゲティングを確認し、自動チェックでブロックの問題が表示されないことを確認します。
  4. [接続済みアプリを送信して続行] を選択し、リリースの詳細を完了して、審査と公開のために Google Play アプリの製品版リリースを送信します。

Google Play アプリの製品版リリースが承認され、公開されたら、次の手順を行います。

  • Android MCP 接続済みアプリは、Google Play アプリの対象となる国と言語のユーザーが Android の Gemini で利用できるようになります。
  • 接続済みアプリの管理ページ（[接続済みアプリ] > [管理]）で、 [接続済みアプリのステータス] カードが [公開済み] に更新され、公開中の App Bundle のバージョン コードと公開日が表示されます。また、[バージョン] ページの [公開済み] にバージョンが表示されます。
  • 更新された AppFunctions ツールを後でリリースするには、バージョン コードを増やした新しい App Bundle をビルドし、テストトラックを使用してテストして、新しい製品版の Play リリースを公開します。接続済みアプリの公開メタデータ（機能やプロンプトの例など）も更新する場合は、新しいアプリバンドルをアップロードする前に、[接続済みアプリ] > [管理] > [アプリの詳細] で編集内容を保存します。

AppFunctions を調整するには、App Bundle を更新してください

Android アプリのバージョン コードをインクリメントせずに内部テスト中に AppFunctions を反復処理する場合は、再アップロードする前に、未公開のドラフト App Bundle を削除できます。

  1. Android プロジェクトの AppFunctions の実装を更新し、新しい .aab App Bundle を生成します。
  2. 以前の App Bundle を追加した未公開のリリースから削除します。
    1. Google Connected Console でリンクされた Google Play アプリを開き、左側のナビゲーション メニューで [内部テスト]（または未公開のリリースを含むトラック）を選択します。
    2. 未公開のリリースで [リリースを編集] を選択します。
    3. App Bundle を見つけて、その他メニュー（⋮）を選択し、[App Bundle を削除] を選択します。
    4. [下書きとして保存] を選択します。
  3. 未使用の App Bundle をライブラリから削除します。
    1. Google Play アプリの左側のナビゲーション メニューで、[最新のリリースとバンドル] を選択します（バンドルがリストに表示されない場合は、[すべての App Bundle を表示] を選択します）。
    2. App Bundle の詳細を開き、[App Bundle を削除] ボタンが使用可能な場合は、[App Bundle を削除] を選択します。これにより、バージョン コードが解放されるため、バージョン コードをインクリメントせずに、更新された App Bundle をアップロードできます。
  4. [App Bundle を削除] が使用できない場合（リリースがすでにトラックに公開されている場合など）、アプリのビルド構成で versionCode をインクリメントし、新しい App Bundle を生成して、ステップ 4 の説明に沿って新しいバージョンをアップロードして送信します。

AppFunctions に関連する問題のトラブルシューティング

自動チェックエラーと一般的な設定の問題を解決するには、次のガイダンスを使用します。

リリースに関する自動チェックのエラーを解決する

AppFunctions の自動チェックで特定された問題は、リリース準備ページ（[内部テスト版リリースを作成] など）と、接続されているアプリの [バージョン] ページの [失敗] セクション（[公開するには問題を修正してください] バッジ付き）に表示されます。

自動チェックで App Bundle に関する問題が報告された場合は、次の手順を行います。

  1. Android アプリコードの AppFunctions の根本的な問題を修正し、更新された App Bundle をビルドします。
  2. 以前のリリースがまだドラフトの状態で、同じバージョン コードを再利用する場合:
    1. Google Play アプリの左側のナビゲーション メニューで、[内部テスト]（または関連するトラック）を選択し、未公開のリリースで [リリースを編集] を選択します。
    2. App Bundle の横にあるその他メニュー（⋮）を選択し、[App Bundle を削除] を選択します。
    3. [下書きとして保存] を選択します。
    4. 左側のナビゲーション メニューで [最新のリリースとバンドル] を選択し（必要に応じて [すべての App Bundle を表示] を選択）、バンドルを選択して [App Bundle を削除] を選択します。
    5. 未公開のリリースに戻り、修正した App Bundle をアップロードして、[接続済みアプリを送信して続行] を選択します。
  3. 以前のバンドルを削除できない場合は、App Bundle の versionCode を増やし、新しいバンドルをリリースにアップロードして、[接続済みアプリを送信して続行] を選択します。

セットアップと統合に関する一般的な問題

次の表に、接続済みアプリの設定、バンドルのアップロード、テスト中に発生する可能性のある一般的な問題と、その原因と解決策を示します。

問題 コンソール メッセージまたは症状 原因 解決策
接続済みアプリの作成またはリンクの前にアップロードされた App Bundle [リリース] ページに [接続されているアプリを作成またはリンクする] が表示されます。 アップロードされた .aab には AppFunctions が含まれていますが、Google Play アプリが Android MCP 接続アプリにまだリンクされていません。 ステップ 1 からステップ 3 を完了して、接続済みアプリを作成し、[Android MCP] を選択して、Google Play アプリをリンクし、[アプリの詳細] を保存します。その後、App Bundle を削除して再アップロードするか、versionCode を増やした新しいバンドルをアップロードします。
接続済みアプリの詳細を保存する前に App Bundle がアップロードされた [リリース] ページに [接続済みアプリの詳細が必要です] と [接続済みアプリの詳細を入力してください] ボタンが表示されます。 Google Play アプリが Android MCP 接続済みアプリにリンクされているが、バンドルがアップロードされる前に [アプリの詳細] ページの必須項目が保存されていなかった。 [接続済みアプリの詳細を入力] を選択（または [接続済みアプリ] > [管理] > [アプリの詳細を追加] に移動）し、必須項目をすべて入力して保存します。その後、バンドルを削除して再アップロードするか、versionCode を増やした新しいバンドルをアップロードします。
リンク時に Google Play アプリを選択できない 対象の Google Play アプリに [リンク済み] バッジが表示されているか、[アプリを選択] ダイアログに表示されない。 各 Google Play アプリは 1 つの Android MCP 接続済みアプリにのみリンクできます。または、このデベロッパー アカウントで Google Play アプリがまだ作成されていません。 [接続済みのアプリ] で既存のエントリを確認し、別の接続済みアプリがすでに Google Play アプリにリンクされているかどうかを確認するか、リンクする前に Google Connected Console で Google Play アプリを作成してください。
接続されているアプリを作成できない 接続済みアプリを作成するオプションが表示されない、または接続済みアプリを作成すると権限または利用規約に関する警告が表示される。 ユーザー アカウントにアプリ連携の権限がないか、アカウント所有者または管理者がアプリ連携の利用規約にまだ同意していません。 アカウント所有者または管理者に、アプリ連携の利用規約に同意し、[ユーザーと権限] ページでアカウントに [アプリ連携の表示] または [アプリ連携の作成と管理] を付与するよう依頼してください。
接続されているアプリのバージョンが「送信待ち」のままになっている [接続済みアプリ] > [管理] > [バージョン] で、バンドル バージョンが [テスターが利用可能] ではなく [送信待ち] に表示されます。 アップロードされたバンドルで AppFunctions が検出されましたが、接続済みアプリのバージョンがリリース ページから送信されていません。 そのバンドルを含む Play アプリのリリースを開き、[接続済みアプリを送信して続行] を選択して、テスターがプレビューできるようにします。
アプリの詳細ページに表示されるサンプル プロンプトの検証エラー 公開アプリカード フォームを保存できず、[プロンプトの例] にエラーが表示される。 プロンプトがフォーマットまたはメンションのルールに準拠していないか、プロンプトの作成後にアプリ名が編集されました。 合計 3 ～ 4 個のプロンプトを指定します。少なくとも 2 つは @<YourAppName> で始め、少なくとも 1 つは @ を使用せずに <YourAppName> に自然に言及し、番号付きの接頭辞（1.、2.）または引用符（"..."）を削除します。
Android の Gemini でテスターに接続済みアプリが表示されない テスターは、[接続済みアプリ] で接続済みアプリを見つけることも、Android Gemini アプリで @ メンションを使用して接続済みアプリを見つけることもできません。 反映がまだ進行中であるか、テスター アカウントが対象外であるか、インストール済みのアプリのバージョンが一致していません。 送信後、20 分ほど待ちます（テスターを保存してから 10 分ほど待ちます）。テスターが、保存されたメールリストにある個人の @gmail.com アカウントを使用していること、Android スマートフォンまたはタブレットを使用していること、送信されたバンドル バージョンを正確にインストールしていることを確認します。