在 Google Connected Console 中，使用 AppFunctions 和 Android MCP 建立及管理連結的應用程式

使用 Google Connected Console，將 Android 應用程式的裝置端 AppFunctions 與 Android 版 Gemini 整合。只要建立 Android MCP 連線類型的連結應用程式，並連結至 Play 應用程式，Android 版 Gemini 就能代表使用者，直接在應用程式中觸發動作及完成工作。

本指南將逐步引導您完成 Google Connected Console 的端對端自助工作流程，包括建立連結的應用程式、連結 Google Play 應用程式、設定公開應用程式資訊卡、上傳及提交應用程式套件、裝置端預覽測試，以及發布正式版。

必要條件

開始前，請確認您具備以下項目：

  • 在 Google Connected Console 中存取已註冊的開發人員帳戶：
    • 接受服務條款：貴組織首次在 Google Connected Console 存取連結的應用程式時，帳戶擁有者或管理員必須先詳閱並接受《連結的應用程式服務條款》，團隊成員才能建立連結的應用程式。
    • 使用者授權：如果您受邀加入現有的 Connected Console 開發人員帳戶，但無法建立連結的應用程式，請要求帳戶擁有者或管理員在「使用者和權限」頁面，授予您「查看連結的應用程式」或「建立及管理連結的應用程式」權限。您也需要相關 Play 應用程式的版本管理權限，才能上傳應用程式套件及管理版本。
  • Google Connected Console 帳戶中現有的 Play 應用程式：
    • Play 應用程式必須已存在於同一個開發人員帳戶中，才能連結至連結的應用程式。每個 Play 應用程式只能連結至一個 Android MCP 連結的應用程式。
    • 確認 Play 應用程式有預設商店資訊，並設定應用程式圖示和支援語言。Play 應用程式的商店資訊語言和指定國家/地區，會決定 Android MCP 連結應用程式的供應地區。
  • 已實作 AppFunctions 的 Android App Bundle (.aab)：
    • 設定應用程式套件，指定 Android 行動裝置為目標，這是裝置端 Gemini 應用程式整合支援的平台。
  • 連結應用程式類別和公開中繼資料：準備連結應用程式公開顯示的素材資源和詳細資料：
    • 連結應用程式類別：連結應用程式的領域或產業類別。每個類別都會定義基準功能需求，建立後即無法變更。
    • 應用程式名稱：連結應用程式在 Google 產品中顯示的名稱，也是使用者在 Gemini 中用 @ 提及應用程式時使用的名稱。
    • 連結的應用程式圖示：512 px x 512 px 的應用程式圖示，格式為 JPEG 或 PNG，檔案大小上限為 1 MB (1,024 KB)。
    • 應用程式說明：簡要說明連結的應用程式可為使用者提供哪些功能。
    • 應用程式功能：除了應用程式類別定義的預設功能外，至少要提供三項自訂功能，向使用者說明應用程式能執行的動作，協助他們決定是否連結。
    • 範例提示詞：至少三個範例提示詞，教導使用者如何在 Gemini 中叫用應用程式，並協助他們瞭解可詢問哪些問題。
    • 政策網址：公開的隱私權政策網址。
    • 服務條款網址：公開的服務條款網址。
    • 網站網址 (選填)：公開可存取的網址，指向您的網站以供歸因。

使用 Gemini 註冊、測試及發布 AppFunction

符合必要條件後，請完成下列步驟，註冊 Android MCP 連結的應用程式、連結 Google Play 應用程式、填入應用程式詳細資料、上傳並提交 AppFunctions、在裝置端測試，以及發布至正式版群組。

步驟 1：建立 Android MCP 連結應用程式，並連結至 Play 應用程式

如要建立連結的應用程式，並連結至 Play 應用程式，請按照下列步驟操作：

  1. 登入 Google Connected Console。
  2. 在「首頁」中，選取「建立應用程式」。
  3. 在「選擇要建立的項目」對話方塊中：
    • 如果系統提示您接受《連結應用程式服務條款》，請選取「View terms」(查看條款)，詳閱並接受協議，然後選取「Create」(建立)。只有帳戶管理員可以接受協議。
    • 否則，請選取「連結的應用程式」資訊卡中的「建立」。
  4. 在「Give your connected app a name」(為連結的應用程式命名) 對話方塊中，輸入連結應用程式的名稱。這個名稱會顯示在各項 Google 產品中，也能供使用者加上 @ 號來提及您的連結應用程式。選取「下一步」。

  5. 在「Select a connected app category」(選取連結應用程式類別) 對話方塊中，從「Select a category」(選取類別) 選單選取應用程式的網域、類別或產業。

  6. 在「Choose connection type」對話方塊中，選擇「Android MCP」。

    如需設定 MCP 伺服器連結應用程式的詳細逐步操作說明，請參閱 Google Play 管理中心整合指南。目前，每個連結的應用程式只能選擇一種連結類型，且日後無法變更。

  7. 選取「建立連結的應用程式」。

  8. 在「Select app」對話方塊中，找出並選取包含 (或將包含) AppFunctions 的 Play 應用程式。您可以使用搜尋功能篩選清單。

    • 如果 Play 應用程式已連結至其他應用程式，則無法選取。
    • 請務必選取要連結的 Play 應用程式。選定 Play 應用程式後即無法變更。

系統會開啟連結應用程式的管理總覽頁面，您可以在這裡繼續設定連結應用程式詳細資料、追蹤連結應用程式版本，以及管理測試人員。

步驟 2：提供連結應用程式詳細資料

上傳任何含有 AppFunctions 的應用程式套件前，請先設定連結應用程式在 Gemini 的顯示方式。

請按照下列步驟提供連結應用程式詳細資料：

  1. 在連結應用程式的管理頁面中，找到「Android MCP」資訊卡，然後在「新增連結應用程式詳細資料」下方，選取「新增應用程式詳細資料」 (如要更新現有詳細資料，請選取「管理」)。
  2. 在「App details」(應用程式詳細資料) 頁面頂端，確認「Connected app name」(連結的應用程式名稱) 欄位。您可以視需要更新名稱。這個名稱會顯示在各項 Google 產品中，也能供使用者加上 @ 來提及您的應用程式。
  3. 在「Public details」部分的「Icon」下方，上傳應用程式圖示 (JPG 或 PNG，大小不超過 1 MB，尺寸為 512 x 512 像素)。

  4. 填寫下列欄位：

    • 說明：請輸入簡潔的單句摘要 (不超過 30 個字)，說明連結應用程式的主要功能和用途。這段文字會向使用者顯示，不會做為模型指令。
    • 功能：輸入至少三項連結應用程式可執行的重要工作。選取「Add capability」即可新增更多項目。請勿在功能開頭加入數字。 每項只能填入一項功能。如果連結應用程式的類別包含預先定義的功能，這些功能會顯示在清單頂端，且無法修改。
    • 範例提示詞：輸入至少三個範例提示詞，協助使用者瞭解可以提出哪些問題。選取「新增範例提示詞」即可新增項目。
      • 至少有兩個提示以 @<YourAppName> 開頭 (例如 @Order Tracker where is my last order?)。
      • 在至少一個提示中自然提及<YourAppName>，但不要以應用程式名稱開頭 (例如Track my recent order on Order Tracker)。
      • 請勿加入編號前置字元 (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)。

    • 服務條款網址：輸入有效的 https:// 或 http:// 服務條款連結。

    • 政策網址：輸入有效的 https:// 或 http:// 隱私權政策連結。

    • 網站網址 (選填)：輸入網站連結，用於標示來源。

步驟 3：上傳含有 AppFunctions 的應用程式套件，並提交連結的應用程式

儲存連結應用程式詳細資料後，請將包含 AppFunctions 的 Android App Bundle 上傳至連結的 Play 應用程式，並提交連結應用程式版本進行測試。

如要上傳含有 AppFunctions 的應用程式套件，請按照下列步驟操作：

  1. 在連結應用程式的管理頁面中，前往「Android MCP」資訊卡的「上傳包含 AppFunctions 的應用程式套件」部分，然後選取「上傳應用程式套件」，前往連結 Play 應用程式的「測試及發布」總覽。
  2. 或者，您也可以直接在 Google Connected Console 中開啟連結的 Play 應用程式。在 Play 應用程式的左側導覽選單中，依序前往「Testing」>「Internal testing」 (或其他測試群組)，然後選取「Create new release」 (如果您已有草稿版本，請選取「Edit release」)。
  3. 在「應用程式套件」下方，選取「上傳」，上傳含有 AppFunctions 的 .aab 套件。如果您在完成步驟 2 後上傳套件，請選取「從檔案庫新增」。
  4. 上傳完成後，請前往版本頁面的「在應用程式套件中偵測到應用程式函式」部分。確認連結的應用程式名稱、套件版本代碼、偵測到的工具數量、語言數量，以及 Play 應用程式指定國家/地區皆正確無誤，並確認自動檢查未回報任何問題。(如果出現任何驗證錯誤，請先按照「排解與 AppFunctions 相關的問題」中的指示操作，再繼續)。
  5. 在版本頁面底部，選取「提交連結的應用程式並繼續」。

選取「提交連結的應用程式並繼續」，會將 AppFunctions 版本提交至 Gemini 進行預覽測試，並將 Play 版本推進至版本預覽頁面。如要使用本機建構項目疊代 AppFunctions，而不增加應用程式套件的版本代碼，請將 Play 版本保留在草稿狀態，不要選取「儲存並發布」。發布 Play 版本後，該套件版本代碼就會鎖定，無法刪除及重新上傳。如要進行後續變更，請提高應用程式套件版本代碼。(如果測試人員直接從 Google Play 的內部測試群組安裝應用程式，而非側載，請完成內部測試推出作業，並在日後上傳時遞增版本代碼)。

步驟 4：確認連結的應用程式版本

從 Play 版本頁面提交連結的應用程式後，請確認連結的應用程式版本已可預覽：

  1. 在連結應用程式的管理頁面中，找到「Android MCP」資訊卡，然後選取「版本」旁邊的「查看」。
  2. 在「版本」頁面中，確認提交的版本顯示在「可供測試人員使用」部分 (顯示 Version <N> • Submitted <Date> • Using AppFunctions from app bundle <versionCode>)。
    • 在任一版本列上選取 View，即可檢查偵測到的 AppFunctions，以及為該版本擷取的唯讀「應用程式詳細資料」App details快照。
    • 如果版本是透過上傳的應用程式套件建立，但您尚未選取「Submit connected app and continue」(提交連結的應用程式並繼續)，則會顯示在「Pending submission」(待提交) 下方。

步驟 5：測試連結的應用程式

如要讓測試人員使用連結的應用程式，您必須在「管理測試人員」頁面新增測試人員。只有新增至測試人員名單的使用者，才能查看及使用未發布的連結應用程式。您只能新增擁有 @gmail.com 帳戶的測試人員。

  1. 在連結應用程式的總覽頁面，找到「測試應用程式」資訊卡，然後選取「新增測試人員」 (如果已新增測試人員，則選取「管理測試人員」)。
  2. 在「Manage testers」(管理測試人員) 頁面中，選取現有的電子郵件名單，或選取「Create email list」(建立電子郵件名單)，新增有權測試整合項目的 Google 帳戶。如要自行測試應用程式，請務必加入自己的電子郵件地址。

  3. 選取「儲存」。

  4. 測試人員只要在 Gemini 應用程式中輸入 @，並加上連結的應用程式名稱，然後從選單中選取，即可叫用連結的應用程式。您也可以在 Gemini 中查看及連結應用程式，只要在左側導覽列中依序前往「設定與說明」>「連結的應用程式」即可。

在裝置端測試前，請確認每位測試人員都符合下列規定：

  • 使用步驟 5 設定的電子郵件清單中的 Google 帳戶，登入 Android 手機或平板電腦。
  • 執行確切的 Android 應用程式建構作業，其套件版本代碼與步驟 4 中提交的版本相符。

建議您徹底測試整合作業：

  • 試用所有範例提示詞。
  • 測試明確叫用 @<AppName> 和自然語言查詢。
  • 驗證工具參數處理、確認提示，以及 AppFunctions 的端對端執行。

測試結果符合預期後，即可將連結的應用程式提交給 Google 審查。

步驟 6：向使用者發布連結的應用程式

與伺服器託管的 MCP 整合不同，Android MCP 連結應用程式不需要在「連結的應用程式管理」頁面進行個別審查或發布動作。而是由 Google 審查連結的應用程式版本，並在您將含有 AppFunctions 應用程式套件的 Play 應用程式版本發布至正式版時，自動發布。

完成測試並準備好向使用者推出時，請按照下列步驟操作：

  1. 在 Google Connected Console 中，開啟連結的 Play 應用程式，然後在左側導覽選單中依序前往「Release」>「Production」(或將測試版本從測試群組升級至「Production」)。
  2. 選取「建立新版本」 (或編輯現有的正式版草稿)，然後使用「從媒體庫新增」或「上傳」，新增含有已驗證 AppFunctions 的應用程式套件。
  3. 前往「在應用程式套件中偵測到 AppFunctions」部分，確認連結的應用程式版本、工具數量、商店資訊語言數量，以及 Google Play 應用程式指定國家/地區，並確保自動檢查未顯示任何阻礙問題。
  4. 選取「提交連結的應用程式並繼續」，填妥版本詳細資料，然後提交 Play 應用程式正式版，進行審查及推出。

Play 應用程式正式版通過核准並推出後，請按照下列步驟操作：

  • Android MCP 連結應用程式會在 Android 版 Gemini 中推出，供 Play 應用程式指定國家/地區和語言的使用者存取。
  • 在連結應用程式的管理頁面 (依序點選「連結的應用程式」>「管理」)，「連結的應用程式狀態」資訊卡會更新為「已發布」，並顯示正式版應用程式套件版本代碼和發布日期。此外，「版本」頁面的「已發布」下方也會顯示該版本。
  • 如要日後推出更新版 AppFunctions 工具，請建構版本代碼遞增的新應用程式套件，使用測試群組進行測試，然後發布新的 Play 正式版。如要一併更新連結應用程式的公開中繼資料 (例如功能或範例提示)，請先依序前往「連結的應用程式」>「管理」>「應用程式詳細資料」儲存編輯內容，再上傳新的應用程式套件。

更新應用程式套件以調整 AppFunctions

如果您想在內部測試期間疊代 AppFunctions，而不增加 Android 應用程式的版本代碼，可以先移除並刪除未發布的草稿應用程式套件，再重新上傳：

  1. 更新 Android 專案中的 AppFunctions 實作，並產生新的 .aab 應用程式套件。
  2. 從您新增舊版應用程式套件的所有草稿版本中，移除該套件：
    1. 在 Google Connected Console 中開啟連結的 Play 應用程式，然後在左側導覽選單中選取「Internal testing」(內部測試) (或包含草稿版本的測試群組)。
    2. 在草稿版本上，選取「編輯版本」。
    3. 找出應用程式套件，選取三點選單 (⋮)，然後選取「Remove app bundle」(移除應用程式套件)。
    4. 選取「儲存為草稿」。
  3. 從程式庫中刪除未使用的應用程式套件：
    1. 在 Play 應用程式的左側導覽選單中，選取「Latest releases and bundles」(最新版本和套件) (如果未看到套件，請選取「View all app bundles」(查看所有應用程式套件))。
    2. 開啟應用程式套件的詳細資料，如果「刪除應用程式套件」按鈕可用，請選取「刪除應用程式套件」。這樣就能釋出版本代碼，讓您上傳更新後的應用程式套件，而不必提高版本代碼。
  4. 如果無法使用「Delete app bundle」(例如版本已發布至測試群組)，請在應用程式建構設定中遞增 versionCode，產生新的應用程式套件，然後按照步驟 4 的說明上傳並提交新版本。

排解 AppFunctions 相關問題

請按照下列指引，解決自動檢查錯誤和常見設定問題。

解決版本自動檢查錯誤

AppFunctions 自動檢查發現的問題，會顯示在版本準備頁面 (例如「建立內部測試版本」)，以及連結應用程式「版本」頁面的「失敗」部分 (附有「修正問題即可發布」徽章)。

如果自動檢查回報應用程式套件有問題，請按照下列步驟操作：

  1. 修正 Android 應用程式程式碼中的基礎 AppFunctions 問題，並建構更新後的應用程式套件。
  2. 如果先前的版本仍是草稿，而您想重複使用相同的版本代碼：
    1. 在 Play 應用程式的左側導覽選單中，選取「內部測試」 (或相關測試群組)，然後在草稿版本上選取「編輯版本」。
    2. 選取應用程式套件旁邊的三點選單 (⋮)，然後選取「Remove app bundle」。
    3. 選取「儲存為草稿」。
    4. 在左側導覽選單中，選取「最新版本和套件」(視需要選取「查看所有應用程式套件」)，然後依序選取套件和「刪除應用程式套件」。
    5. 返回草稿版本，上傳修正後的應用程式套件，然後選取「提交連結的應用程式並繼續」。
  3. 如果無法刪除先前的套件，請增加應用程式套件的 versionCode，將新套件上傳至版本，然後選取「提交連結的應用程式並繼續」。

常見的設定和整合問題

下表說明在設定連結應用程式、上傳套件或測試時，可能遇到的常見問題，以及原因和解決方法：

問題 控制台訊息或症狀 原因 解析度
在建立或連結已連結的應用程式前，上傳應用程式套件 「版本」頁面會顯示「建立或連結連結的應用程式」。 上傳的 .aab 含有 AppFunctions，但 Play 應用程式尚未連結至 Android MCP 連結應用程式。 完成步驟 1 至步驟 3，建立連結的應用程式、選取「Android MCP」、連結 Play 應用程式，然後儲存「應用程式詳細資料」。接著，刪除並重新上傳應用程式套件，或上傳 versionCode 遞增的新套件。
先上傳應用程式套件，再儲存連結的應用程式詳細資料 版本頁面會顯示「需要提供連結應用程式詳細資料」和「提供連結應用程式詳細資料」按鈕。 Play 應用程式已連結至 Android MCP 連結應用程式，但上傳套件前未儲存「應用程式詳細資料」頁面的必填欄位。 選取「提供連結應用程式詳細資料」 (或依序前往「連結應用程式」>「管理」>「新增應用程式詳細資料」)，填妥並儲存所有必填欄位，然後刪除並重新上傳套件，或上傳 versionCode 遞增的新套件。
連結時無法選取 Play 應用程式 目標 Play 應用程式顯示「已連結」徽章，或未顯示在「選取應用程式」對話方塊中。 每個 Play 應用程式只能連結至一個 Android MCP 連結應用程式，或尚未在這個開發人員帳戶中建立 Play 應用程式。 請查看「已連結的應用程式」下方的現有項目，確認是否有其他已連結的應用程式連結至您的 Play 應用程式，或先在 Google Connected Console 中建立 Play 應用程式，再進行連結。
無法建立連結的應用程式 沒有建立連結應用程式的選項，或建立連結應用程式時顯示權限或《服務條款》警告。 您的使用者帳戶缺少連結的應用程式權限，或帳戶擁有者/管理員尚未接受《連結的應用程式服務條款》。 請要求帳戶擁有者或管理員接受《連結的應用程式服務條款》，並在「使用者和權限」頁面授予您帳戶「查看連結的應用程式」或「建立及管理連結的應用程式」權限。
連結的應用程式版本卡在「待提交」狀態 在「連結的應用程式」>「管理」>「版本」，套件版本會顯示在「待提交」下方，而非「可供測試人員使用」。 Google Connected Console 偵測到您上傳的套件含有 AppFunctions，但您尚未透過版本頁面提交連結的應用程式版本。 開啟含有該套件的 Play 應用程式版本，然後選取「提交連結的應用程式並繼續」，測試人員即可預覽。
「應用程式詳細資料」頁面上的範例提示驗證錯誤 無法儲存公開應用程式資訊卡表單，且「範例提示」下方會顯示錯誤訊息。 提示不符合格式或提及規則，或是在撰寫提示後編輯了應用程式名稱。 請提供三到四個提示詞：至少兩個以「@<YourAppName>」開頭，至少一個自然提及「<YourAppName>」且不含「@」，並移除編號前置字元 (1.、2.) 或前後引號 ("...")。
測試人員在 Android 版 Gemini 中看不到連結的應用程式 測試人員無法在「連結的應用程式」下方，或透過 Android Gemini 應用程式中的 @ 提及功能，找到連結的應用程式。 傳播作業仍在進行中、測試人員帳戶不符合資格，或安裝版應用程式版本不符。 提交後請等待約 20 分鐘 (儲存測試人員後最多等待 10 分鐘)。確認測試人員使用已儲存電子郵件清單中的個人 @gmail.com 帳戶、Android 手機或平板電腦，並已安裝提交的確切套件版本。