开始使用

您需要先为自己的 Google Play 开发者帐号设置 API 权限,才能开始发起 API 调用。这会涉及到在 Google Play 管理中心和 Google Cloud Console 中进行更改。下面的操作说明介绍了开始使用 Google Play Developer API 所需的四个步骤。

  1. 将您的开发者帐号与新的或现有的 Google Cloud 项目相关联。
  2. 为关联的 Google Cloud 项目启用 Google Play Developer API。
  3. 在关联的 Google Cloud 项目中为 Google Play Developer API 授权一个 API 密钥。
  4. 设置一个具有适当 Google Play 管理中心权限的服务帐号,以便访问 Google Play Developer API。

关联帐号和项目

您必须先将 Google Play 开发者帐号关联到 Google Cloud 项目,然后才能访问 Google Play Developer API。在大多数情况下,我们建议您为自己的 Google Play 开发者帐号新建一个专用的 Google Cloud 项目,不过您也可以关联现有项目。请注意,每个 Google Play 开发者帐号只能关联到一个 Google Cloud 项目。如果您的同一个 Google Play 开发者帐号中有多个应用,这些应用必须都共用同一个 Google Cloud 项目。

创建一个新项目

  1. 前往 Google Play 管理中心的 API 权限页面。
  2. 点击创建新项目

系统会自动创建 Google Cloud 项目,并将其关联到您的 Google Play 开发者帐号。

使用现有项目

如果您已是 Google Cloud Console 的用户,可以按以下步骤关联到现有的 Google Cloud 项目:

  1. 前往 Google Play 管理中心的 API 权限页面。
  2. 选择您想关联的项目。如果您的项目未列出,请确认是否已在您要关联的 Google Cloud 项目中将您的用户帐号指定为“所有者”。
  3. 点击关联现有项目

启用 API

在设置完关联的 Google Cloud 项目后,您需要为此项目启用 Google Play Developer API。为此,您必须是 Google Cloud 项目的所有者。

  1. 前往 Google Play 管理中心的 API 权限页面。
  2. API 下,找到 Google Play Developer API,然后点击开启

此操作会直接更新 Google Cloud 项目,且更改会立即生效。

授权 API 密钥

若要使用该 API,您在关联的 Google Cloud 项目中要有获得 Google Play Developer API 使用授权的 API 密钥。请在 Google Play 管理中心内进行相关设置。

配置 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 Play 管理中心的 API 权限页面。
  2. 服务帐号下,点击了解如何创建服务帐号
  3. 按照说明创建您的服务帐号。

    在创建帐号的过程中,您需要向自己的服务帐号授予对 Google Cloud 项目的访问权限,这样它才能显示在 Google Play 管理中心内。

  4. 在 Google Play 管理中心创建服务帐号后,点击完成API 权限页面的“服务帐号”部分会自动刷新,您的服务帐号将随即列出。

  5. 点击授予访问权,为服务帐号提供执行相关操作所需的权限。

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

    • 查看财务数据、订单和用户取消订阅时对调查问卷的书面回复
    • 管理订单和订阅

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

使用 OAuth 客户端

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

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

  1. 前往 Google Play 管理中心的 API 权限页面。
  2. 点击 OAuth 客户端下的配置 OAuth 权限请求页面
  3. 配置产品的品牌信息。
  4. 完成配置后,点击刷新 OAuth 权限请求信息。此部分会相应更新,您不会再看到与品牌信息有关的消息。

如需使用 Google Play 管理中心创建 OAuth 客户端,请按以下步骤操作:

  1. 前往 Google Play 管理中心的 API 权限页面。
  2. 点击 OAuth 客户端下的创建新的 OAuth 客户端
  3. 按照页面上的说明创建 OAuth 客户端。
  4. 在 Google Play 管理中心创建 OAuth 客户端后,点击完成API 权限页面的 OAuth 客户端部分会自动刷新,您的 OAuth 客户端会随即列出。

    有时新的 OAuth 客户端不会立即显示在页面上。在这种情况下,请点击刷新 OAuth 客户端

新 OAuth 客户端的详细信息会以列表形式显示在此页面上。

其他信息

如果您要开始在 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。有关详情,请参阅客户端库和代码示例