使用入门

若要开始发起 API 调用,您需要直接从 Google Play 管理中心管理 Google Play Developer API。该 API 只能由您 Google Play 开发者帐号的所有者管理。以下说明内容介绍了如何执行下列操作:

  • 设置新的或现有的 Google Cloud 项目
  • 管理 OAuth 客户端
  • 使用服务帐号访问 Google Play Developer API
  • 访问用于分析应用的专用 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. 接受《服务条款》。
  3. 点击创建新项目

系统会自动生成 Google Cloud 项目,并将其关联到您的 Google Play 管理中心。

使用现有项目

如果您已是 Google Play Developer API 的用户,可以通过执行以下这些步骤来关联到现有的 API 项目:

  1. 转到 Google Play 管理中心的 API 权限页面。
  2. 接受《API 服务条款》。
  3. 选择您想关联的项目。

    如果您的项目未列出,请确认

    • 您的 Google Play 管理中心帐号已指定为“所有者”
    • 已为该项目启用 Google Play Developer API
  4. 点击关联现有项目

配置 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. 按照页面上的说明创建您的服务帐号。

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

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

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

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

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

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

使用 OAuth 客户端

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

在创建 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 客户端的详细信息会以列表形式显示在此页面上。

获取您的开发者 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。有关详情,请参阅客户端库和代码示例