要开始发起 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 项目
- 转到 Google Play 管理中心的 API 权限页面。
- 接受《服务条款》。
- 点击创建新项目。
系统会自动生成一个 API 项目,并将其关联到您的 Google Play 管理中心。
使用现有 API 项目
如果您已是 Google Play Developer API 的用户,则可以执行以下这些步骤来关联到您现有的 API 项目。如果您想关联的 API 项目未列出,请确认您的 Google Play 管理中心帐号已指定为“所有者”,且 Google Play Developer API 已启用。
- 转到 Google Play 管理中心的 API 权限页面。
- 接受《API 服务条款》。
- 选择您想关联的项目。
- 点击关联。
设置 API 访问客户端
要使用 API,您必须配置以下任一身份验证方法。
对于代表非人类机器人运行的服务器应用(如持续集成系统),建议使用服务帐号。对于直接代表人类用户运行的客户端应用(如 IDE 插件),则可以使用 OAuth 客户端。
使用服务帐号
您还可以创建一个无需提供个人用户凭据便可从构建服务器访问 API 的服务帐号:
- 转到 Google Play 管理中心的 API 权限页面。
- 点击服务帐号下的创建服务帐号。
- 按照页面上的说明创建您的服务帐号。
- 在 Google Play 管理中心创建服务帐号后,点击完成。API 权限页面会自动刷新,您的服务帐号将随即列出。
- 点击授予访问权,为服务帐号提供执行相关操作所需的权限。
此时,您应该能够通过服务帐号访问 API。 有关详情,请参阅针对服务器对服务器应用使用 OAuth 2.0。
使用 OAuth 客户端
借助 OAuth 客户端,您可以允许用户使用自己的凭据通过 API 执行操作。 用户可执行的操作仅限于通过 Google Play 管理中心的用户和权限页面允许的操作。
- 转到 Google Play 管理中心的 API 权限页面。
- 点击 OAuth 客户端下的创建 OAuth 客户端。
- 配置您产品的品牌信息,然后点击继续。
- 点击创建客户端 ID。
您的新 OAuth 客户端的详细信息以列表形式显示在此页面上。
专用 API
Google Play Developer API 包含多个专用 API,可让您对自己的应用执行特定类型的分析:
- Reply to Reviews API
- 允许您查看用户对您应用的反馈并回复相应反馈。
- Voided Purchases API
- 允许您撤消针对应用内商品(与用户已废止的购买交易相关)的访问权限。
客户端库
我们已提供客户端库,供您以编程方式访问 REST API。有关详情,请参阅客户端库和代码示例。