开始使用

开始发起 API 调用之前,您需要先为自己的 Google Play 开发者账号设置 API 权限。这需要在 Google Play 管理中心和 Google Cloud 控制台中进行相应的更改。以下操作说明介绍了开始使用 Google Play Developer API 所需的步骤。

  1. 创建 Google Cloud 项目。
  2. 为 Google Cloud 项目启用 Google Play Developer API。
  3. 设置一个对 Google Play 管理中心具有适当权限的服务账号,以便访问 Google Play Developer API。

创建 Google Cloud 项目

如果您已有要使用的 Google Cloud 项目,则可以跳过此步骤。

Google Cloud 控制台中创建项目。

如需进一步了解 Google Cloud 项目,请参阅创建和管理项目

启用 API

在设置完 Google Cloud 项目后,您需要为此项目启用 Google Play Developer API。

若要启用 Google Play Developer API,请执行以下操作:

  1. 前往 Google Cloud 控制台中的 Google Play Developer API 页面
  2. 点击启用

配置 OAuth 和服务账号

您需要使用 OAuth 客户端或服务账号来配置对 Google Play Developer API 的访问权限。在大多数情况下,您都应当使用服务账号来访问 API。

服务账号必须在安全的环境(例如您的服务器)中使用。您需要妥善管理服务账号凭据,避免将其泄露给任何无权使用该 API 的人员。

如果您需要代表个人用户访问该 API,您应当使用 OAuth 客户端 ID。例如,如果您的网站需要代表用户从网页客户端访问 Google Play Developer API,那么您可以使用客户端 ID。系统会使用用户的 Google 账号(而不是服务账号)对用户进行身份验证。这样,您就可以代表用户进行 API 调用,而不会影响服务账号凭据的安全。

  • 服务账号:由安全的软件服务来访问 API(最常见的方式)
  • OAuth 客户端:由用户访问 API

使用服务账号

您可以通过 Google Play 管理中心创建服务账号

  1. 在 Google Cloud 控制台中,前往服务账号
  2. 点击创建服务账号,然后按照以下步骤进行操作。
  3. 前往 Google Play 管理中心的用户和权限页面。
  4. 点击邀请新用户
  5. 在电子邮件地址字段中输入服务账号所用的电子邮件地址,并授予执行相关操作所需的权限。

    如需使用 Google Play 结算服务 API,您必须授予以下权限:

    • 查看财务数据、订单和用户取消订阅时对调查问卷的回复
    • 管理订单和订阅
  6. 点击邀请用户

此时,您应当能够通过服务账号访问 Google Play Developer API。如需了解详情,请参阅针对服务器对服务器应用使用 OAuth 2.0

使用 OAuth 客户端

借助 OAuth 客户端,您可以允许用户使用自己的凭据通过 API 执行操作。用户可执行的操作仅限于通过 Google Play 管理中心的用户和权限页面所允许的操作。

在创建 OAuth 客户端之前,您需要为产品配置品牌信息。如需了解详情,请参阅设置 OAuth 权限请求页面

  1. 在 Google Cloud 控制台中,前往 OAuth 权限请求页面
  2. 按照相关步骤创建 OAuth 权限请求页面。

如需创建 OAuth 客户端,请执行以下操作:

  1. 在 Google Cloud 控制台中,前往凭据
  2. 依次点击“创建凭据”>“OAuth 客户端 ID”。
  3. 选择应用类型,然后按照说明操作。

其他信息

如果您要开始在 Google Play 上使用 API,不妨参考以下实用的提示和技巧。

获取开发者 ID

有些 API 需要您提供 Google Play 管理中心的开发者 ID。这是在创建您的 Google Play 开发者账号时分配的一个长编号。您可以在 Google Play 管理中心内几乎任何页面(例如 API 权限页面)的网址中找到您的开发者 ID。

以 Google Play 管理中心的以下网址为例:

https://play.google.com/console/developers/1234567890123456789/api-access

在以上网址中,开发者 ID 为 1234567890123456789

注意:当应用从一个 Google Play 开发者账号转移到另一个 Google Play 开发者账号时,与该应用关联的开发者 ID 会发生变化。这意味着,在转移完成后,如果要对该应用进行 API 调用,您必须使用新 Google Play 开发者账号对应的开发者 ID。

专用 API

Google Play Developer API 包含多个专用 API,可让您对自己的应用执行特定类型的分析:

Reply to Reviews API
允许您查看用户对您应用的反馈并回复相应反馈。
Voided Purchases API
允许您在用户已废止购买交易的情况下,撤消针对相关应用内商品的访问权限。

客户端库

我们已提供客户端库,供您以编程方式访问 REST API。有关详情,请参阅客户端库和代码示例