在 Google Connected Console 中使用 AppFunctions 和 Android MCP 创建和管理关联的应用

使用 Google Connected Console 将 Android 应用的设备端 AppFunctions 与 Android 上的 Gemini 集成。通过创建 Android MCP 连接类型的关联应用并将其关联到您的 Play 应用，您可以让 Android 版 Gemini 代表用户直接在您的应用中触发操作和完成任务。

本指南将引导您完成 Google Connected Console 中的端到端自助工作流程，包括创建关联的应用、关联 Play 应用、配置公开应用卡片、上传和提交 app bundle、在设备上进行预览测试，以及发布正式版。

前提条件

在开始之前，请确保您拥有以下各项：

  • 拥有对 Google Connected Console 中已注册开发者账号的访问权限：
    • 接受服务条款：贵组织首次在 Google Connected Console 中访问“关联的应用”时，账号所有者或管理员必须先查看并接受《关联的应用服务条款》，然后团队成员才能创建关联的应用。
    • 用户权限：如果您受邀加入现有的 Connected Console 开发者账号，但无法创建关联的应用，请让账号所有者或管理员在用户和权限页面上向您授予查看关联的应用或创建和管理关联的应用权限。您还需要拥有相关 Play 应用的版本管理权限，才能上传 app bundle 和管理版本。
  • 您的 Google Connected Console 账号中已有 Play 应用：
    • 您的 Play 应用必须已存在于同一开发者账号中，这样您才能将其与关联的应用相关联。每个 Play 应用只能关联到一个 Android MCP 关联的应用。
    • 确保您的 Play 应用具有配置了应用图标和支持的语言的默认商品详情。您的 Play 应用的商品详情语言和国家/地区定位设置决定了您的 Android MCP 关联应用在哪些国家/地区提供。
  • 已实现 AppFunctions 的 Android App Bundle (.aab)：
    • 将 app bundle 配置为以 Android 移动设备为目标平台，这是设备端 Gemini 应用集成支持的平台。
  • 关联的应用类别和面向公众的元数据：准备构成关联的应用公开展示内容的素材资源和详细信息：
    • 关联的应用类别：关联的应用所属的领域或行业类别。每个类别都定义了基准功能要求，且在创建后无法更改。
    • 应用名称：关联的应用在各种 Google 产品中向用户显示的名称，也是用户在 Gemini 中使用 @ 提及您的应用时所用的名称。
    • 关联的应用图标：512 像素 x 512 像素的应用图标，采用 JPEG 或 PNG 格式，文件大小上限为 1 MB (1,024 KB)。
    • 应用说明：简明扼要地说明关联的应用能为用户提供哪些功能。
    • 应用功能：除了应用类别定义的任何默认功能外，至少还要提供三项自定义功能，以便用户在决定是否关联时了解应用的功能。
    • 示例提示：至少三个示例提示，用于指导用户如何在 Gemini 中调用您的应用，并帮助他们了解可以提出哪些要求。
    • 政策网址：您的隐私权政策的公开网址。
    • 服务条款网址：服务条款的公开网址。
    • 网站网址 （可选）：指向您网站的公开网址，用于注明出处。

使用 Gemini 注册、测试和发布 AppFunctions

满足前提条件后，请完成以下步骤：注册 Android MCP 关联的应用、关联 Play 应用、填写应用详细信息、上传并提交 AppFunctions、在设备上测试，以及发布到正式版。

第 1 步：创建 Android MCP 关联应用，并将其关联到您的 Play 应用

如需创建关联的应用并将其关联到您的 Play 应用，请按以下步骤操作：

  1. 登录 Google Connected Console。
  2. 在首页上，选择创建应用。
  3. 在选择要创建的内容对话框中：
    • 如果系统提示您接受《关联的应用服务条款》，请选择查看条款，查看并接受协议，然后选择创建。 只有账号管理员才能接受协议。
    • 否则，请在关联的应用卡片中选择创建。
  4. 在为关联的应用命名对话框中，输入关联的应用的名称。这是关联的应用在各种 Google 产品中显示的名称，也是用户使用 @ 提及关联的应用时所用的名称。选择下一步。

  5. 在选择关联的应用类别对话框中，从选择类别菜单中选择应用的网域、类别或行业。

  6. 在选择连接类型对话框中，选择 Android MCP。

    如需详细了解如何设置 MCP 服务器关联的应用，请参阅 Google Play 管理中心集成指南。目前，您只能为每个关联的应用选择一种连接类型，并且以后无法更改。

  7. 选择创建关联的应用。

  8. 在选择应用对话框中，找到包含（或将包含）AppFunctions 的 Play 应用，然后选择该应用。您可以使用搜索功能过滤列表。

    • 无法选择已与其他关联应用相关联的 Play 应用。
    • 请务必选择要关联的正确 Play 应用。选择 Play 应用后，便无法更改。

系统会打开关联应用的管理概览页面，您可以在其中继续配置关联应用详细信息、跟踪关联应用版本以及管理测试人员。

第 2 步：提供关联的应用详细信息

在上传任何包含 AppFunctions 的 app bundle 之前，请先配置关联的应用在 Gemini 中向用户显示的方式。

请按照以下步骤提供关联的应用详细信息：

  1. 在关联应用的“管理”页面上，在添加关联应用详细信息下的 Android MCP 卡片中，选择添加应用详细信息（如果要更新现有详细信息，请选择管理）。
  2. 在应用详细信息页面顶部，验证关联的应用名称字段。您可以根据需要更新名称。此名称会在各种 Google 产品中向用户显示，并且会在用户使用 @ 提及您的应用时使用。
  3. 在公开详细信息部分的图标下，上传应用图标（JPG 或 PNG 格式，大小不超过 1 MB，尺寸为 512 像素 x 512 像素）。

  4. 填写以下字段：

    • 说明：输入简明扼要的单句摘要（不超过 30 个字词），描述关联应用的主要功能和用途。此文本会向用户显示，不会用作模型指令。
    • 功能：输入关联的应用可以执行的至少三项高价值任务。选择添加功能以添加更多条目。请勿在功能开头添加数字。 每个条目只能包含一项功能。如果关联的应用类别包含预定义的功能，这些功能会显示在列表顶部，且无法修改。
    • 示例提示：输入至少三个示例提示，帮助用户了解他们可以提出哪些问题。选择添加示例提示以添加条目。
      • 请确保至少有两个提示以 @<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 的 app bundle，并提交关联的应用

保存关联的应用详细信息后，将包含 AppFunctions 的 Android App Bundle 上传到关联的 Play 应用，然后提交关联的应用版本进行测试。

如需上传包含 AppFunctions 的 app bundle，请按以下步骤操作：

  1. 在已关联应用的“管理”页面上，找到 Android MCP 卡片，在上传包含 AppFunctions 的 app bundle 下，选择上传 app bundle，前往已关联 Play 应用的测试和发布概览。
  2. 或者，直接在 Google Connected Console 中打开关联的 Play 应用。在 Play 应用的左侧导航菜单中，依次前往测试 > 内部测试（或其他测试轨道），然后选择创建新版本（如果您已有草稿版本，则选择修改版本）。
  3. 在 App bundle 下，选择上传，上传包含 AppFunctions 的 .aab bundle；或者，如果您在完成第 2 步后上传了 bundle，请选择从内容库添加。
  4. 上传完成后，前往发布页面上的在您的 app bundle 中检测到应用函数部分。确认关联的应用名称、软件包版本代码、检测到的工具数量、语言数量和 Play 应用国家/地区定位设置均符合预期，并验证自动化检查未报告任何问题。（如果出现任何验证错误，请先按照排查与 AppFunctions 相关的问题中的说明操作，然后再继续。）
  5. 在发布页面底部，选择提交关联的应用并继续。

选择提交关联的应用并继续会将您的 AppFunctions 版本提交给 Gemini 进行预览测试，并将您的 Play 版本推进到版本预览页面。如果您想使用本地 build 迭代 AppFunctions，而不增加 app bundle 的版本代码，请将 Play 版本保留为草稿状态，不要选择保存并发布。发布 Play 版本会锁定该 app bundle 版本代码，使其无法再被删除和重新上传。 后续任何更改都需要递增 App Bundle 版本代码。（如果测试人员直接从 Google Play 的内部测试轨道安装应用，而不是旁加载，请完成内部测试发布，并在日后上传时递增版本代码。）

第 4 步：验证已关联的应用版本

从 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 手机或平板电脑。
  • 运行 bundle 版本代码与第 4 步中提交的版本相匹配的确切 Android 应用 build。

我们建议您全面测试集成：

  • 试用所有示例提示。
  • 测试显式 @<AppName> 调用和自然语言查询。
  • 验证 AppFunctions 中的工具参数处理、确认提示和端到端执行。

如果您对测试结果感到满意，就可以将关联的应用提交给 Google 进行审核。

第 6 步：向用户发布关联的应用

与服务器托管的 MCP 集成不同，Android MCP 关联应用不需要在“关联应用管理”页面上执行单独的审核或发布操作。而是由 Google 审核您的关联应用版本，并在您将包含 AppFunctions app bundle 的 Google Play 应用版本发布到正式版轨道时自动发布。

完成测试并准备好向用户发布后，请执行以下操作：

  1. 在 Google Connected Console 中，打开关联的 Play 应用，然后在左侧导航菜单中依次前往版本 > 正式版（或将已测试的版本从测试轨道提升到正式版）。
  2. 选择创建新版本（或修改现有的正式版草稿），然后使用从库中添加或上传添加包含已验证 AppFunctions 的 app bundle。
  3. 前往在您的 app bundle 中检测到 AppFunctions 部分，确认关联的应用版本、工具数量、商品详情语言数量和 Google Play 应用国家/地区定位，并确保自动检查未显示任何阻碍性问题。
  4. 选择提交关联的应用并继续，填写版本详情，然后提交 Play 应用正式版以供审核和发布。

当您的 Play 应用正式版获得批准并发布后：

  • 您的 Android MCP 关联应用将在 Android 版 Gemini 中提供给您 Play 应用所定位的国家/地区和语言的用户。
  • 在关联应用的“管理”页面（关联的应用 > 管理）上，关联的应用状态卡片会更新为已发布，并显示已发布 app bundle 的版本代码和发布日期，且该版本会显示在版本页面的已发布下。
  • 如需在日后发布更新后的 AppFunctions 工具，请构建一个版本代码递增的新 app bundle，使用测试轨道对其进行测试，然后发布新的 Production Play 版本。如果您还想更新关联应用的公开元数据（例如功能或示例提示），请在上传新的 app bundle 之前，前往关联的应用 > 管理 > 应用详细信息保存这些修改。

更新 app bundle 以调整 AppFunctions

如果您想在内部测试期间迭代 AppFunctions，而不增加 Android 应用的版本号，可以先移除并删除未发布的草稿 app bundle，然后再重新上传：

  1. 更新 Android 项目中的 AppFunctions 实现，并生成新的 .aab app bundle。
  2. 从您添加了旧 app bundle 的所有草稿版本中移除该 app bundle：
    1. 在 Google Connected Console 中打开关联的 Play 应用，然后在左侧导航菜单中选择内部测试（或包含草稿版本的轨道）。
    2. 在草稿版本上，选择修改版本。
    3. 找到该 app bundle，选择三点状菜单 (⋮)，然后选择移除 app bundle。
    4. 选择保存为草稿。
  3. 从您的资源库中删除未使用的 app bundle：
    1. 在 Play 应用的左侧导航菜单中，选择最新版本和 bundle（如果您没有看到列出的 bundle，请选择查看所有 app bundle）。
    2. 打开 app bundle 的详细信息，如果删除 app bundle 按钮可用，请选择删除 app bundle。这样可以释放版本代码，以便您上传更新后的 app bundle，而无需递增版本代码。
  4. 如果删除 app bundle 不可用（例如，因为该版本已发布到轨道），请在应用 build 配置中递增 versionCode，生成新的 app bundle，然后按照第 4 步中的说明上传并提交新版本。

排查与 AppFunctions 相关的问题

请按照以下指南解决自动检查错误和常见设置问题。

解决发布版本的自动检查错误

AppFunctions 自动化检查发现的所有问题都会显示在版本准备页面（例如创建内部测试版本）上，以及关联应用的版本页面上的失败部分（带有修正问题后才能发布标记）下。

如果自动化检查报告您的 app bundle 存在问题，请执行以下步骤：

  1. 在 Android 应用代码中修正底层 AppFunctions 问题，并构建更新后的 app bundle。
  2. 如果您的上一个版本仍为草稿，并且您想重复使用相同的版本代码，请执行以下操作：
    1. 在 Play 应用的左侧导航菜单中，选择内部测试（或相关轨道），然后选择草稿版本上的修改版本。
    2. 选择 app bundle 旁边的三点状菜单 (⋮)，然后选择移除 app bundle。
    3. 选择保存为草稿。
    4. 在左侧导航菜单中，选择最新版本和 app bundle（如有需要，请选择查看所有 app bundle），选择相应 bundle，然后选择删除 app bundle。
    5. 返回草稿版本，上传已修复的 app bundle，然后选择提交关联的应用并继续。
  3. 如果无法删除之前的 app bundle，请递增 app bundle 的 versionCode，将新的 app bundle 上传到您的版本，然后选择提交关联的应用并继续。

常见设置和集成问题

下表介绍了您在关联应用设置、软件包上传或测试期间可能会遇到的常见问题，以及这些问题的原因和解决方法：

问题 控制台消息或症状 原因 分辨率
在创建或关联关联的应用之前上传了 app bundle “发布”页面显示创建或关联已关联的应用。 上传的 .aab 包含 AppFunctions，但 Play 应用尚未与 Android MCP 关联应用相关联。 完成第 1 步到第 3 步，以创建关联的应用、选择 Android MCP、关联您的 Play 应用，并保存应用详细信息。然后，删除并重新上传该 app bundle，或上传一个 versionCode 递增的新 bundle。
在保存关联应用的应用详细信息之前上传了 app bundle “发布”页面会显示需要提供关联的应用的详细信息和提供关联的应用的详细信息按钮。 该 Play 应用已关联到 Android MCP 关联的应用，但在上传 app bundle 之前，应用详细信息页面上的必填字段未保存。 选择提供关联应用详情（或前往关联的应用 > 管理 > 添加应用详情），填写并保存所有必填字段，然后删除并重新上传该 bundle，或上传一个 versionCode 递增的新 bundle。
关联时无法选择 Play 应用 目标 Play 应用显示已关联标记，或未显示在选择应用对话框中。 每个 Play 应用只能关联到一个 Android MCP 关联应用，或者此开发者账号中尚未创建该 Play 应用。 请检查关联的应用下的现有条目，看看是否有其他关联的应用已关联到您的 Play 应用，或者先在 Google Connected Console 中创建 Play 应用，然后再进行关联。
无法创建关联的应用 没有创建关联应用的选项，或者创建关联应用时显示权限或服务条款警告。 您的用户账号缺少关联的应用权限，或者账号所有者或管理员尚未接受《关联的应用服务条款》。 请让账号所有者或管理员接受《关联的应用服务条款》，并在用户和权限页面上向您的账号授予查看关联的应用或创建和管理关联的应用权限。
关联的应用版本卡在“待提交”状态 在关联的应用 > 管理 > 版本中，您的软件包版本会显示在待提交下，而不是可供测试人员使用下。 Google Connected Console 在您上传的 app bundle 中检测到了 AppFunctions，但您尚未通过“发布”页面提交关联的应用版本。 打开包含该 app bundle 的 Play 应用版本，然后选择提交关联的应用并继续，以便测试人员可以预览该应用。
“应用详情”页面上的示例提示验证错误 公开应用卡片表单无法保存，并在示例提示下显示错误。 提示不符合格式或提及规则，或者在撰写提示后修改了应用名称。 总共提供 3 到 4 个提示：至少有 2 个提示以 @<YourAppName> 开头，至少有 1 个提示自然地提及 <YourAppName>，不使用 @，并移除编号前缀（1.、2.）或外侧引号 ("...")。
测试人员在 Android 版 Gemini 中看不到关联的应用 测试人员无法在关联的应用下找到关联的应用，也无法在 Android Gemini 应用中使用 @ 提及功能。 传播仍在进行中、测试人员账号不符合条件，或已安装的应用版本不匹配。 请在提交后等待大约 20 分钟（保存测试人员后最多等待 10 分钟）。确认测试人员使用的是已保存电子邮件列表中的个人 @gmail.com 账号，使用的是 Android 手机或平板电脑，并且已安装提交的确切 bundle 版本。