替代计费 API

符合条件的开发者能够在其应用中向某些国家/地区的使用者提供替代计费系统，并将产生的交易报告给 Google。根据您分发应用的位置和资格，应用可以构建两种版本的替代计费

本指南介绍了这两种情况下需要使用的 API。在使用这些 API 之前，您应查看计划页面并注册相关计划。

术语表

本指南遵循的术语约定

  • 替代计费 API：用于向用户显示任何适用的屏幕并使开发者能够报告在其开发者替代计费系统上完成的交易的 API。
  • 替代计费系统：开发者的替代计费系统，可以与 Google Play 的计费系统一起提供，也可以单独提供（须符合资格要求）。
  • 外部交易：在 Google Play 计费系统之外发生的交易。
  • 外部交易令牌：通过 Play 计费库提供给开发者的令牌，供开发者在用户完成替代计费系统时使用。此令牌用于通知 Google Play 购买成功。
  • 外部交易 ID：开发者生成的唯一标识符，用于识别交易。

提供带用户选择的替代计费

本部分介绍了如何为您的用户提供替代计费以及选择使用 Google Play 计费系统的方法。在使用这些 API 之前，请确保以下事项

其他建议的 Google Play 计费集成模块与开发者当前的集成相同。

此外，我们建议您准备好Google Play 开发者 API 集成设置，因为后端集成将利用它。

在 Play Console 中配置

已完成相应用户选择计划的替代计费注册并已集成替代计费 API 的开发者可以通过Play Console管理其替代计费设置。

  • 对于每个符合条件的应用，您可以选择是否提供替代计费系统。
  • 根据指南上传付款方式徽标，并遵循所有格式规范。不符合这些指南的图片将不会在用户选择屏幕上显示您的替代计费系统。（注意：包含付款方式徽标是可选的，但强烈建议。）
  • 如果您提供订阅，请提供所需的订阅管理链接。
模拟 UI，仅供说明之用，如有更改，恕不另行通知。

用户体验

客户端 API 支持以下功能

  • Google Play 呈现和管理适用的信息和用户选择屏幕。
  • 如果用户选择使用 Google Play 的计费系统，则计费流程将继续使用 Google Play 的标准计费界面。

开发者应用。

计费选择屏幕。

仅供说明之用。

用户选择屏幕

用户选择屏幕为用户提供选择使用开发者的替代计费系统或 Google Play 的计费系统的选项。

替代计费选项的结构

用户选择屏幕上的替代计费选项包含以下 UI 元素

  1. 应用图标。
  2. 应用名称。
  3. 包含开发者提供的付款方式的图片素材。
  4. 其他指示器（以及更多 UI 元素不是图片素材的一部分）。

付款方式图片素材

单个图片素材由多个付款方式卡片组成，必须遵循这些指南中定义的规范。

尺寸

192dp X 20dp

卡片间距

8dp

文件格式

PNG，透明背景

付款方式变体

开发者可以选择他们希望在图片素材中包含的可用付款方式图标的数量，最多 5 个。

图片中不应包含其他图片或文本。

卡片规范

图片素材中包含的付款方式卡片必须遵循以下关于尺寸、间距和样式的指南。

卡片尺寸 32dp X 20dp
内边距 3dp
轮廓 1dp（尺寸包含内部描边），半径 2dp，#E0E0E0
卡片背景 纯色（最好是白色）

后续步骤

要开始将替代计费 API 与用户选择集成，请遵循应用内集成和后端集成的详细指南应用内集成和后端集成。

仅提供替代计费

本节介绍如何为用户提供替代计费，而无需选择使用 Google Play 的计费系统。在使用这些 API 之前，请确保以下事项

我们建议准备好Google Play 开发者 API 集成设置，因为后端集成将利用它。

在 Play Console 中配置

已完成注册并已集成替代计费 API 的开发者可以通过Play Console管理其替代计费设置。

  • 对于每个符合条件的应用，选择在每个可用国家/地区选择加入或退出仅提供替代计费（无用户选择）功能。
模拟 UI，仅供说明之用，如有更改，恕不另行通知。

用户信息屏幕

信息屏幕帮助用户了解在符合条件的应用中仅提供替代计费系统。在启用替代计费后，用户在应用中进行首次购买时，将显示信息屏幕。此消息不会显示在同一用户在同一设备上对您的应用进行的后续购买中。请注意，在某些情况下（例如用户清除设备缓存时），对话框可能会再次显示给用户。

后续步骤

要开始集成替代计费 API，请遵循应用内集成和后端集成的详细指南应用内集成和后端集成。