使用入门

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

  • 设置一个新的 API 项目或一个现有的 API 项目
  • 管理 OAuth 客户端
  • 使用服务帐号访问 API
  • 访问用于分析应用的专用 API

关联您的 API 项目

您必须先将 Google Play 管理中心关联到一个 API 项目,然后才能访问 API。在大多数情况下,尽管当前 API 用户可以关联到现有 API 项目,但我们仍建议您创建新的 API 项目。切记,每个 API 项目只能关联到一个 Google Play 管理中心帐号。

创建新的 API 项目

  1. 在 Google Play 管理中心转到 API 访问权限页面。
  2. 接受服务条款。
  3. 点击创建新项目

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

使用现有 API 项目

如果您已是 Google Play Developer API 的用户,则可以执行以下这些步骤来关联到您现有的 API 项目。如果您想关联的 API 项目未列出,请确认您的 Google Play 管理中心帐号是否已指定为“所有者”,且 Google Play Developer API 已启用。

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

您的 Google Play 管理中心现已关联到 API 项目。使用第 1 版 Google Play Developer API 的用户请注意:更新到第 2 版后,第 1 版中的以下资源名称已发生变化:

设置 API 访问客户端

要使用 API,您必须配置以下任一身份验证方法。

对于代表非人类机器人运行的服务器应用(如持续集成系统),建议使用服务帐号。对于直接代表人类用户运行的客户端应用(如 IDE 插件),则可以使用 OAuth 客户端。

使用服务帐号

您还可以创建一个无需提供个人用户凭据便可从构建服务器访问 API 的服务帐号

  1. 在 Google Play 管理中心转到 API 访问权限页面。
  2. 点击服务帐号下的创建服务帐号
  3. 按照页面上的说明创建您的服务帐号。
  4. 在 Google Developers Console 中创建服务帐号后,请点击完成API 访问权限页面会自动刷新,您的服务帐号将随即列出。
  5. 点击授予访问权限,为服务帐号提供执行相关操作所需的权限。

此时,您应该能够通过服务帐号访问 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。有关详情,请参阅客户端库和代码示例