Español – América Latina Português – Brasil Games dev center Android Developers Games dev center 本页介绍了如何使用 Google Play 管理中心为 Android 游戏设置 Google Play 游戏服务。您可以在 Play 管理中心集中管理游戏服务，并配置用于对游戏进行授权和身份验证的元数据。 如需将游戏添加到 Play 管理中心，请按以下常规步骤操作： 为游戏创建游戏项目，并指定游戏的名称和说明等详细信息。 为游戏创建游戏项目，并指定游戏的名称和说明等详细信息。 创建必要的凭据以对游戏进行授权和身份验证，并将这些凭据关联到 Google Play 游戏服务。 创建必要的凭据以对游戏进行授权和身份验证，并将这些凭据关联到 Google Play 游戏服务。 在配置 Google Play 游戏服务之前，请完成以下步骤。 创建 Google Play 开发者账号 您必须在 Play 管理中心内设置 Google Play 开发者账号。如需了解详情，请参阅 注册 Google Play 开发者账号 。 您必须在 Play 管理中心内设置 Google Play 开发者账号。如需了解详情，请参阅 注册 Google Play 开发者账号 。 授予修改权限：若要在 Play 管理中心内修改 Play 游戏服务设置，您的团队必须拥有管理 Play 游戏服务的权限。如需了解详情，请参阅 添加开发者账号用户并管理权限 。 授予修改权限：若要在 Play 管理中心内修改 Play 游戏服务设置，您的团队必须拥有管理 Play 游戏服务的权限。如需了解详情，请参阅 添加开发者账号用户并管理权限 。 创建 Google Cloud 项目 您必须已设置 Google Cloud 项目。如需了解详情，请参阅 开始使用 Google Cloud 如需使用 Play 管理中心，您必须为项目启用计划使用的 API。 启用 Google Play 游戏服务 API 如需登录，请进入 Google Play 管理中心 。如果您之前没有在 Play 管理中心注册过，系统会提示您进行注册。 将游戏添加到 Play 管理中心 如需添加游戏，请按以下步骤操作： 在 Play 管理中心内创建一个应用，并指定应用类型是游戏。如需了解详情，请参阅 创建和设置应用 。 在 Play 管理中心内创建一个应用，并指定应用类型是游戏。如需了解详情，请参阅 创建和设置应用 。 依次前往 拓展用户 > Play 游戏服务 > 设置和管理 > 配置 。 依次前往 拓展用户 > Play 游戏服务 > 设置和管理 > 配置 。 指定您的游戏是否已使用 Google API（例如 Firebase）。请务必选择正确的选项；否则，游戏在使用 Google API 时可能会遇到问题。选项如下： 否，我的游戏没有使用 Google API ：如果要创建新游戏，或者从未为游戏设置过 Google API，请选择此选项。输入游戏名称，然后点击 创建 。 是，我的游戏已经使用了 Google API ：如果已为游戏设置 Google API，请选择此选项。如果属于这种情况，您会在 Google Cloud 控制台中看到项目列表。从列表中选择项目，然后点击 使用 。 使用现有的 Play 游戏服务项目 ：如果要使用现有的 Play 游戏服务项目，请选择此选项。您将看到自己账号下的现有 Play 游戏服务项目列表。从列表中选择游戏项目，然后点击 使用 。这并不是一个常见选择，但如果要在 Play 管理中心内创建新游戏以更改软件包名称，或者免费版和付费版游戏的软件包名称不同，则可以选择此选项。 系统会创建一个 Play 游戏服务游戏项目，并在 Google Cloud 控制台 中为您创建相应条目。 指定您的游戏是否已使用 Google API（例如 Firebase）。请务必选择正确的选项；否则，游戏在使用 Google API 时可能会遇到问题。选项如下： 否，我的游戏没有使用 Google API ：如果要创建新游戏，或者从未为游戏设置过 Google API，请选择此选项。输入游戏名称，然后点击 创建 。 否，我的游戏没有使用 Google API ：如果要创建新游戏，或者从未为游戏设置过 Google API，请选择此选项。输入游戏名称，然后点击 创建 。 是，我的游戏已经使用了 Google API ：如果已为游戏设置 Google API，请选择此选项。如果属于这种情况，您会在 Google Cloud 控制台中看到项目列表。从列表中选择项目，然后点击 使用 。 是，我的游戏已经使用了 Google API ：如果已为游戏设置 Google API，请选择此选项。如果属于这种情况，您会在 Google Cloud 控制台中看到项目列表。从列表中选择项目，然后点击 使用 。 使用现有的 Play 游戏服务项目 ：如果要使用现有的 Play 游戏服务项目，请选择此选项。您将看到自己账号下的现有 Play 游戏服务项目列表。从列表中选择游戏项目，然后点击 使用 。这并不是一个常见选择，但如果要在 Play 管理中心内创建新游戏以更改软件包名称，或者免费版和付费版游戏的软件包名称不同，则可以选择此选项。 使用现有的 Play 游戏服务项目 ：如果要使用现有的 Play 游戏服务项目，请选择此选项。您将看到自己账号下的现有 Play 游戏服务项目列表。从列表中选择游戏项目，然后点击 使用 。这并不是一个常见选择，但如果要在 Play 管理中心内创建新游戏以更改软件包名称，或者免费版和付费版游戏的软件包名称不同，则可以选择此选项。 系统会创建一个 Play 游戏服务游戏项目，并在 Google Cloud 控制台 中为您创建相应条目。 在 属性 部分，点击 修改属性 以添加信息，例如游戏的说明、类别和图形资源。以下是配置属性的一些准则： 测试时只需要显示名称。您必须先填写其他字段，然后才能发布游戏。 游戏的显示名称和说明应与您在游戏的 Play 商品详情中设置的一致。 如需了解有关创建图形资源的准则，请参阅 添加预览资源以展示您的应用 和 Google Play 精选图片准则 。 在 属性 部分，点击 修改属性 以添加信息，例如游戏的说明、类别和图形资源。以下是配置属性的一些准则： 测试时只需要显示名称。您必须先填写其他字段，然后才能发布游戏。 测试时只需要显示名称。您必须先填写其他字段，然后才能发布游戏。 游戏的显示名称和说明应与您在游戏的 Play 商品详情中设置的一致。 游戏的显示名称和说明应与您在游戏的 Play 商品详情中设置的一致。 如需了解有关创建图形资源的准则，请参阅 添加预览资源以展示您的应用 和 Google Play 精选图片准则 。 如需了解有关创建图形资源的准则，请参阅 添加预览资源以展示您的应用 和 Google Play 精选图片准则 。 生成 OAuth 2.0 客户端 ID 您的游戏必须具有 OAuth 2.0 客户端 ID，才能通过身份验证并获得授权，以调用 Google Play 游戏服务。如需为 Play 游戏服务设置凭据（即客户端 ID 与游戏之间的关联），请使用 Google Cloud 创建客户端 ID。然后，在 Google Play 管理中心内添加凭据，并将客户端 ID 与游戏相关联。 如需更详细的说明，请参阅以下步骤： 配置 OAuth 权限请求页面 如果您尚未配置 OAuth 权限请求页面， 凭据 部分将显示一条消息，提示您进行配置。 点击 配置 。系统会打开一个对话框，其中包含更多说明以及指向 Google Cloud 的深层链接。 确保权限请求页面对游戏面向的所有用户都可用。最终范围列表需要包含 games 、 games_lite 、 和 drive.appdata ；这些范围都无需进行应用验证。我们建议您立即发布权限请求页面。如果无法做到这一点，您可以向测试人员显示权限请求页面，以允许他们对游戏进行身份验证。 如果您已完成 OAuth 权限请求页面的设置，请点击 完成 。 Google Play 管理中心会自动刷新；如果配置成功，您将能够创建凭据： 若要授权您的游戏与 Google Play 游戏服务通信，您必须使用已获授权的 OAuth2 客户端 ID 创建凭据。

在 凭据 部分，点击 添加凭据 。 在向导中，选择是要创建 Android 凭据（如果您的游戏 APK 将对用户进行身份验证并使用 Play 游戏服务 API），还是创建游戏服务器凭据（如果您的游戏服务器将使用 Play 游戏服务 API）。 按照凭据类型对应的说明操作。 确保“名称”字段中的名称与游戏名称一致。 选择是否启用 反盗版功能 。 接下来，选择要用于此游戏项目的 OAuth 客户端 ID。如果您已有 OAuth2 客户端 ID，请选择一个。不过，您通常需要创建新 ID。点击 创建 OAuth 客户端 。系统会打开一个对话框，其中包含指向 Google Cloud 的链接。 在 Google Cloud 中，请按以下步骤操作： 选择 Android 作为应用类型。 在 名称 字段中输入游戏的名称。 在 软件包名称 字段中输入 Android 应用的 软件包 名称 。 如果您的游戏通过 Play 商店分发，请使用 Google Play 应用签名 。从 Play 管理中心的应用签名页面复制 SHA-1 指纹。 如果您自行管理密钥库和签名密钥，请使用 Keytool 实用程序 获取发布证书和调试 证书的 SHA-1 指纹。 如需获取发布证书指纹，请运行以下命令： keytool -list -keystore <path-to-production-keystore> -v 如需获取调试证书指纹，请运行以下命令： keytool -list -keystore <path-to-debug-keystore> -v 注意：在 Windows 上，调试密钥库位于 C:\Users\<USERNAME>\.android\debug.keystore 。在 Mac 或 Linux 上，调试密钥库通常位于 ~/.android/debug.keystore 。 如果您自行管理密钥库和签名密钥，请使用 Keytool 实用程序 获取发布证书和调试 证书的 SHA-1 指纹。 如需获取发布证书指纹，请运行以下命令： keytool -list -keystore <path-to-production-keystore> -v 如需获取调试证书指纹，请运行以下命令： keytool -list -keystore <path-to-debug-keystore> -v 注意：在 Windows 上，调试密钥库位于 C:\Users\<USERNAME>\.android\debug.keystore 。在 Mac 或 Linux 上，调试密钥库通常位于 ~/.android/debug.keystore 。 可选：如果您已使用 Unity Hub 创建新密钥库 ，请勿按照 上一步中的说明创建新证书。请使用您在 Unity 中创建的 SHA-1 指纹。 使用以下命令将 SHA-1 指纹输出到终端： 可选：如果您已使用 Unity Hub 创建新密钥库 ，请勿按照 上一步中的说明创建新证书。请使用您在 Unity 中创建的 SHA-1 指纹。 使用以下命令将 SHA-1 指纹输出到终端： keytool -list -keystore <var>path</var>/<var>name_of_keystore</var>.keystore -v keytool 实用程序会提示您输入密钥库的密码。然后，keytool 会将指纹输出到终端。 将 SHA-1 指纹粘贴到 签名证书指纹 (SHA-1) 字段中。 如需详细了解 Android 上的 OAuth 2.0，请参阅 对 OAuth2 服务 进行身份验证。 在对话框中点击 完成 后，系统将刷新可用的客户端 ID。从下拉菜单中选择您创建的凭据，然后点击 保存更改 。系统会将凭据创建为草稿，以便您在游戏中对 Play 游戏服务进行身份验证。 您可能需要创建两个凭据：一个使用发布证书指纹，另一个使用调试证书指纹。请务必为这两个凭据使用相同的软件包名称。这样一来，Google Play 游戏服务就可以识别使用任一证书签名的关联 APK 发出的调用。如需详细了解 Android 证书签名，请参阅 为应用签名 。 确保“名称”字段中的名称与游戏名称一致。 接下来，选择要用于此游戏项目的 OAuth 客户端 ID。如果您已有 OAuth2 客户端 ID，请选择一个。不过，您通常需要创建新 ID。点击 创建 OAuth 客户端 。系统会打开一个对话框，其中包含指向 Google Cloud 的链接。 在 Google Cloud 中，请按以下步骤操作： 选择 Web 应用 作为应用类型。 在 名称 字段中输入游戏的名称。 如需详细了解 Android 上的 OAuth 2.0，请参阅 对 OAuth2 服务进行身份验证 。 在对话框中点击 完成 后，系统将刷新可用的客户端 ID。从下拉菜单中选择您创建的凭据，然后点击 保存更改 。系统会将凭据创建为草稿，以便您通过游戏服务器对 Play 游戏服务进行身份验证。如需详细了解如何将 Play 游戏服务与游戏服务器配合使用，请参阅 启用 Google Play 游戏服务的服务器端访问 。 为了确保 Google Play 游戏服务可以在您的游戏中正常运行，您应先测试游戏服务，然后再将游戏更改发布到 Google Play 上。 如果您的游戏处于未发布状态，请将测试人员的用户账号添加到许可名单，为其授予访问权限。否则，测试人员在尝试访问 Play 游戏服务端点 （例如 平台身份验证 端点）时，会遇到 OAuth 和 404 错误。 如果用户拥有已获授权的测试账号，将有权访问您尚未发布的 Play 游戏服务游戏项目，并可以测试您配置的 Play 游戏服务能否正常运行。 您可以通过以下两种方式让测试人员为您的游戏使用 Play 游戏服务 API： 在个人级别，添加个人电子邮件地址。 在个人级别，添加个人电子邮件地址。 在组级别，为 Play 管理中心发布轨道启用 Play 游戏服务。 在组级别，为 Play 管理中心发布轨道启用 Play 游戏服务。 如需将各个测试人员添加到游戏项目，请执行以下操作： 在 Google Play 管理中心内打开游戏的 测试人员 标签页 ( 依次选择 > 拓展用户 > Play 游戏服务 > 设置和 管理 )。 在显示的对话框中，输入您希望添加为测试人员的 Google 账号的电子邮件地址（以英文逗号分隔或者每行一个电子邮件地址）。 点击 添加 ，将用户保存为测试人员。您添加的测试人员账号应在几小时内就能访问 Play 游戏服务。 如需向某个组授予测试访问权限，请启用发布轨道以访问 Play 游戏服务： Google Play 可让您通过发布轨道功能将应用的预发布版本分发给可控范围内的一组受信任用户。如需了解详情，请参阅 Google Play 帮助网站上的设置开放式测试、封闭式测试或内部测试 。 您可以向有权在指定发布轨道上测试 APK 的所有用户授予游戏的测试访问权限。这与单独将他们添加到测试人员列表相同。为此，请按以下步骤操作： 打开 PGS 测试人员 部分（依次选择 拓展用户 > Play 游戏服务 > 设置和管理 > 测试人员 ），然后 选择 发布轨道 标签页。在此页面上，您还可以查看已为 Play 游戏服务测试启用的轨道列表。 选择要为 Play 游戏服务测试启用的一个或多个轨道。 选定的发布轨道现在将显示在已为 Play 游戏服务测试启用的轨道列表中。 仅当您在 Google Play 管理中心内已有一款 Android 应用与游戏相关联时，才能使用此功能。 为了规避常见的设置错误，在设置游戏以使用 Google Play 游戏服务时，请务必遵循以下建议。 如需查看其他提示，请参阅 Android 问题排查指南 。 完成初始设置任务后，您就可以 为游戏启用 Play 游戏服务功能 ，例如游戏存档、排行榜和成就。 本页面上的内容和代码示例受 内容许可 部分所述许可的限制。Java 和 OpenJDK 是 Oracle 和/或其关联公司的注册商标。 最后更新时间 (UTC)：2026-06-16。