与 Google Play 的初始集成

将您的 Google Play 账号连接到 Adapty，使我们的服务器能够读取您的 Play Store 产品、验证购买记录，并接收 Android 订阅事件。

整个配置过程大约需要一小时。如果您希望在单个窗口内完成所有操作，Adapty 看板内置的用户引导也涵盖了相同内容。

开始之前

与 Apple 不同，Google 将其开发者生态拆分为两个独立产品——Google Play Console 和 Google Cloud Console——本文所涉及的配置同时跨越这两个平台。

涉及内容

• 服务账号：专为机器而非个人创建的 Google 账号。你需要新建一个服务账号，以便授予 Adapty 访问 Google Cloud 和 Google Play 控制台的权限。
• Google Cloud Console：Google 的通用基础设施平台。Play Store 本身没有 API 凭据，因此需要在此处创建。使用 Cloud Console 启用 Developer API、创建服务账号，并为其授予部分必要权限。Adapty 需要这些权限来接收续订、取消和退款通知。允许 Adapty 向 Google 进行身份验证的服务账号密钥文件也可从此处下载。
• Google Play Console：用于发布应用和销售订阅的平台。使用 Play Console 为服务账号授予其余必要权限，Adapty 需要这些权限来读取你的产品并验证购买记录。此外，你还可以在这里开启实时开发者通知（RTDN），建立 Play Store 与 Adapty 之间的通信渠道。

所需访问权限

Google 默认会为新组织中的所有成员授予 Project Creator 权限，因此你很可能已经拥有该权限。但在管控严格的企业组织中，该权限可能已被取消。

所需资源

一个 Google Cloud 项目。 如果还没有，请创建一个，或复用已有项目。你将使用该项目启用 Developer API 并为 Adapty 创建服务账号。

项目与你的 Play Console 应用相互独立。一个项目可以管理多个应用的通信。每个应用在项目内都有自己专属的 topic（消息队列）。

在将 Google 服务连接到 Adapty 时，整个过程需要使用同一个项目。建议选择团队拥有的项目，而非个人项目——密钥和主题将在应用的整个生命周期内存在于该项目中。

初始集成清单

1. 在 Google Cloud Console 中启用 Developer API。
2. 在 Google Cloud Console 中创建服务账号。
3. 在 Google Play Console 中为服务账号授予必要权限。
4. 在 Google Cloud Console 中生成服务账号密钥文件。
5. 在 Adapty 看板中将密钥文件和包名上传到 Adapty。新服务账号至少需要 24 小时才能激活，在此之前 Adapty 无法读取您的产品——如需跳过等待，请在 Google Play Console 中编辑并保存任意产品描述。
6. 在 Google Play Console 中使用 Adapty 生成的主题名称启用实时开发者通知（RTDN）。
7. 为您应用所使用的每个框架安装 Adapty SDK：
   • Android
   • React Native
   • Flutter
   • Kotlin Multiplatform
   • Unity
   • Capacitor
8. 正式发布前，请在真实设备上测试应用内购买。

后续步骤

完成集成后，你可以开始使用 Adapty 的各项功能。

展示付费墙需要在集成基础上编写应用代码：至少需要展示付费墙，如果你自行渲染付费墙，还需要处理购买流程。