准备就绪

本主题列出并描述了在您可以在应用中销售产品之前需要采取的设置步骤。总的来说，此设置包括创建开发者帐号、创建和配置要出售的产品，以及启用和配置用于出售和管理产品的 API。本主题还描述了如何配置实时开发者通知，以便在产品状态发生更改时收到通知。

设置 Google Play 开发者帐号

要在 Google Play 上发布您的应用和游戏，请使用 Google Play 管理中心。您还可以使用 Google Play 管理中心管理与结算相关的产品和设置。

要访问 Google Play 管理中心，您需要 设置 Google Play 开发者帐号.

要在 Google Play 上销售付费应用和应用内购买，您还必须在 Google Payments Center 中设置个人资料，然后将该个人资料链接到您的 Google Play 开发者帐号。要了解如何将您的个人资料链接到您的帐号，或了解如何检查您是否已拥有已链接的帐号和个人资料，请参阅 将 Google Play 开发者帐号链接到您的付款个人资料.

在 Google Play 管理中心启用与结算相关的功能

设置开发者帐号后，您必须发布包含 Google Play 结算库的应用版本。此步骤是启用 Google Play 管理中心中与结算相关的功能所必需的，例如配置要出售的产品。

添加库依赖项

要集成 Google Play 的结算系统，首先在您的应用中添加对 Google Play 结算库的依赖项。此库提供对连接您到 Google Play 的 Android API 的访问权限。从那里，您可以访问购买信息、查询购买更新、提示用户进行新购买等等。

Google Play 结算库可从 Google 的 Maven 存储库 获取。将依赖项添加到您的应用的 build.gradle 文件中，如下所示

Groovy

dependencies {
    def billing_version = "7.0.0"

    implementation "com.android.billingclient:billing:$billing_version"
}

Kotlin

dependencies {
    val billing_version = "7.0.0"

    implementation("com.android.billingclient:billing:$billing_version")
}

如果您使用的是 Kotlin，Play 结算库 KTX 模块包含 Kotlin 扩展和协程支持，使您能够在使用 Google Play 的结算系统时编写惯用的 Kotlin 代码。要将这些扩展包含在您的项目中，请将以下依赖项添加到您的应用的 build.gradle 文件中，如下所示

Groovy

dependencies {
    def billing_version = "7.0.0"

    implementation "com.android.billingclient:billing-ktx:$billing_version"
}

Kotlin

dependencies {
    val billing_version = "7.0.0"

    implementation("com.android.billingclient:billing-ktx:$billing_version")
}

本页上的 Kotlin 代码示例在可能的情况下利用 KTX。

上传您的应用

将库添加到您的应用后，构建并发布您的应用。对于此步骤，创建您的应用，然后发布到任何轨道，包括 内部测试轨道.

创建和配置您的产品

在为您的应用启用 Google Play 结算功能后，您需要配置要出售的产品。

创建一次性产品和订阅的步骤类似。对于每个产品，您都需要提供唯一的商品 ID、标题、描述和定价信息。订阅还需要其他必要信息，例如为基本计划选择自动续订或预付费续订类型。

Google Play 管理中心提供一个 Web 界面，您可以使用它来管理您的产品。

  • 要创建和配置一次性产品，请参阅 创建托管商品。请注意，Google Play 管理中心将一次性产品称为托管商品。

  • 要创建和配置订阅，请参阅 创建订阅.

除了 Web 界面之外，您还可以使用 inappproducts REST 资源（用于应用内商品）和 monetization.subscriptions REST 资源（用于 Google Play 开发者 API 中的订阅商品）来管理您的产品。

配置 Google Play 开发者 API

Google Play 开发者 API 是一个服务器到服务器的 API，它补充了 Android 上的 Google Play 结算库。此 API 提供了 Google Play 结算库中没有的功能，例如安全地验证购买并向您的用户发放退款。

作为将 Google Play 结算系统集成到您的应用的一部分，您必须通过 Google Play 管理中心配置对 Google Play 开发者 API 的访问。有关说明，请参阅 Google Play 开发者 API 入门.

配置对 Google Play 开发者 API 的访问后，请确保您已授予查看财务数据权限，这对于访问与结算相关的功能是必要的。有关最佳实践以及有关配置权限的更多信息，请参阅 添加开发者帐户用户和管理权限.

配置实时开发者通知

实时开发者通知 (RTDN) 是一种机制，用于在用户应用内的权利发生变化时接收来自 Google 的通知。RTDN 利用了 Google Cloud Pub/Sub，它允许您接收推送到您设置的 URL 或使用 客户端库 轮询的数据。这些通知使您可以立即对订阅状态更改做出反应，从而避免了轮询 Google Play 开发者 API 的需要。请注意，对 Google Play 开发者 API 的低效使用会导致 API 配额限制。

Cloud Pub/Sub 是一款完全托管的实时消息传递服务，您可以使用它在独立应用程序之间发送和接收消息。Google Play 使用 Cloud Pub/Sub 在您订阅的主题上发布推送通知。

要接收通知，您需要创建一个后端服务器来使用发送到您主题的消息。然后，您的服务器可以通过响应对已注册端点的 HTTPS 请求或使用 Cloud Pub/Sub 客户端库 来使用这些消息。这些库可用于多种语言。您还可以在本主题的 创建 Pub/Sub 订阅 部分中找到更多信息。

确定定价和配额

有关定价和配额的详细信息，请参阅 定价 和 配额.

估计数据使用量

订阅通知的数据部分每个请求约为 1KB 的数据。每个发布和拉取都需要单独的请求，或每个通知大约 2KB 的数据。每月的通知数量取决于您的计费周期和用户的行为。您应该至少在每个计费周期内收到每个用户的通知。

设置 Cloud Pub/Sub

要启用实时开发者通知，您必须先使用您自己的 Google Cloud Platform (GCP) 项目设置 Cloud Pub/Sub，然后为您的应用启用通知。

要使用 Cloud Pub/Sub，您必须拥有启用了 Cloud Pub/Sub API 的 GCP 项目。如果您不熟悉 GCP 和 Cloud Pub/Sub，请参阅 快速入门指南.

创建主题

要开始接收通知，您必须创建一个 主题，Google Play 应该将通知发布到该主题。要创建主题，请按照 创建主题 中的说明进行操作。

创建 Pub/Sub 订阅

要接收发布到主题的消息，您必须为该主题创建一个 Pub/Sub 订阅。要创建 Pub/Sub 订阅，请执行以下操作

  1. 阅读 Cloud Pub/Sub 订阅者指南 以确定是否将订阅配置为推送订阅或拉取订阅。
    • 推送订阅允许 Cloud Pub/Sub 通过发出 HTTPS 请求将通知发送到您的安全后端。
    • 拉取订阅要求您的安全后端服务器向 Cloud Pub/Sub 服务器发出请求以检索消息。
  2. 按照 添加订阅 中的说明创建订阅。

授予对您主题的发布权限

Cloud Pub/Sub 要求您授予 Google Play 对您主题发布通知的权限。

  1. 打开 Google Cloud Console.
  2. 选择您的项目，然后单击左侧导航中的Pub/Sub。

  3. 找到您的主题，并打开权限详细信息。

    accessing configuration for the permissions topic
    图 1. 访问权限主题的配置。

  4. 添加服务帐户 [email protected]，并授予其Pub/Sub 发布者角色。

    adding google play service account as pub/sub publisher
    图 2. 添加 Google Play 服务帐户作为 Pub/Sub 发布者。

  5. 单击保存以完成主题设置。

    a configured topic
    图 3. 已配置的主题。

为您的应用启用实时开发者通知

要为您的应用启用实时开发者通知，请执行以下操作

  1. 打开 Google Play 管理中心.
  2. 选择您的应用。
  3. 转到获利 > 获利设置。

  4. 滚动到页面顶部的实时开发者通知部分。

    Real-time developer notifications section
    图 4. 实时开发者通知部分。

  5. 选中启用实时通知。

  6. 在主题名称字段中，输入您之前配置的完整 Cloud Pub/Sub 主题名称。主题名称应采用以下格式 projects/{project_id}/topics/{topic_name}，其中 project_id 是您项目的唯一标识符，而 topic_name 是您之前创建的主题的名称。

  7. 单击发送测试消息以发送测试消息。执行测试发布有助于确保一切正常设置和配置。如果测试发布成功，将显示一条消息，表明测试发布已成功。如果您为此主题附加了订阅，您应该会收到测试消息。

    对于拉取订阅，请转到 Cloud Console 中的订阅，单击查看消息，然后继续拉取消息。您应该确认您已拉取的任何消息，以避免 Cloud Pub/Sub 重复传递。对于 推送订阅，请检查您的推送端点是否已收到测试消息。成功响应代码将用作消息确认。

    如果发布失败，将显示错误。确保主题名称正确，并且 [email protected] 服务帐户对该主题具有Pub/Sub 发布者访问权限。

  8. 选择您要接收的通知类型。

    • 获取订阅和所有作废购买的通知 - 接收与订阅和作废购买相关的实时开发者通知。您不会收到一次性产品购买的通知。
    • 获取订阅和一次性产品的全部通知 - 接收所有订阅和作废购买事件的通知。您还将收到一次性产品购买事件，例如 ONE_TIME_PRODUCT_PURCHASED 和 ONE_TIME_PRODUCT_CANCELED。请参阅 一次性购买生命周期，详细了解这些购买事件。

  9. 单击保存更改。

验证您的配置

要接收实时开发者通知，您应该创建一个安全的后端服务器来使用发送到您的 Cloud Pub/Sub 主题的消息。

您可以使用上一节中所述的 Google Play 管理中心中的发送测试消息按钮来测试您的配置。如果您尚未配置后端服务器来使用通知，您可以使用 gcloud 命令行工具来验证配置。有关使用 gcloud 处理消息的说明，请参阅 从订阅中拉取消息.

后续步骤