使用入门

若要开始发起 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 项目。如果您想关联的 API 项目未列出,请确认您的 Google Play 管理中心帐号已指定为“所有者”,且 Google Play Developer API 已启用。

  1. 转到 Google Play 管理中心的 API 权限页面。
  2. 接受《API 服务条款》。
  3. 选择您想关联的项目。
  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. 按照页面上的说明创建您的服务帐号。
  4. 在 Google Play 管理中心创建服务帐号后,点击完成API 权限页面会自动刷新,您的服务帐号将随即列出。
  5. 点击授予访问权,为服务帐号提供执行相关操作所需的权限。

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

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

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

使用 OAuth 客户端

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

  1. 转到 Google Play 管理中心的 API 权限页面。
  2. 点击 OAuth 客户端下的创建 OAuth 客户端
  3. 配置您产品的品牌信息,然后点击继续
  4. 点击创建客户端 ID

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

专用 API

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

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

客户端库

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