Service Management API 使用入门

本页描述如何设置开发环境来使用 Service Management API。使用 Service Management API 的最简单方法(不仅仅是使用 Google Cloud Console 网络用户界面),对于大多数操作用例,我们的建议是通过 gcloud 命令行接口。如果您需要针对 Service Management API 进行编程,则可以使用我们提供的某一客户端库。若要试用该 API,您可以按照下面的备用设置说明进行操作,并使用 curl 命令来使用该 API,而无需设置完整的应用开发环境。

使用 gcloud 进行设置

  1. 登录您的 Google Cloud 帐号。如果您是 Google Cloud 新手,请创建一个帐号来评估我们的产品在实际场景中的表现。新客户还可获享 $300 赠金,用于运行、测试和部署工作负载。
  2. 在 Google Cloud Console 的项目选择器页面上,选择或创建一个 Google Cloud 项目。

    转到“项目选择器”

  3. 启用 Service Management API。

    启用 API

  4. 安装并初始化 Cloud SDK
  5. 在 Google Cloud Console 的项目选择器页面上,选择或创建一个 Google Cloud 项目。

    转到“项目选择器”

  6. 启用 Service Management API。

    启用 API

  7. 安装并初始化 Cloud SDK

设置为直接调用 API

本节描述了通过使用 curl 命令的 Service Management API 设置本地环境以进行试验所必需的基本步骤。这种设置适用于需要针对 Service Management API 进行编程的开发者。

初始设置

  1. 转到 Cloud Console 服务帐号页面。
    转到“服务帐号”页面
  2. 点击选择以选择您要用于访问服务的 Google Cloud 项目。
  3. 创建一个服务帐号。如需了解如何创建服务帐号,请参阅创建和管理服务帐号。 如要按照本节中的说明进行操作,必须授予服务帐号 roles/servicemanagement.admin 角色。如需了解如何向服务帐号授予角色,请参阅向服务帐号授予角色
  4. 转到 Cloud Console API 凭据页面。
    转到“API 凭据”页面
  5. 为新服务帐号创建服务帐号密钥,并将其 JSON 凭据文件下载到本地计算机上。本指南中的示例假设文件路径为 ~/credentials.json。如要了解如何创建服务帐号密钥,请参阅创建和管理服务帐号密钥
  6. 在本地计算机上安装 oauth2l,以便与 Google OAuth 系统进行互动。

用 curl 进行测试

  1. 首先验证您的初始设置:

    $ oauth2l header --json ~/credentials.json cloud-platform
    
  2. 完成 OAuth 流程后,您应该会看到如下所示的输出:

    Authorization: Bearer y29.xxxxxxx
    
  3. 为调用 Google REST API 定义一个方便的 shell 别名:

    $ alias gcurl='curl -H "$(oauth2l header --json ~/credentials.json cloud-platform)" -H "Content-Type: application/json"'
    
  4. 尝试列出公共可访问服务:

    $ gcurl https://servicemanagement.googleapis.com/v1/services
    

    如果您看到一个服务列表,则设置成功。

后续步骤

如果您要创建托管式服务但没有使用 Cloud Endpoints,请按照下列步骤操作:

  1. 按照创建和删除服务来创建托管式服务。这将创建一个顶级托管式服务资源。
  2. 按照管理服务配置中的说明提交服务配置,以描述该服务所使用的功能。

  3. 按照发布服务配置中的说明来发布您的服务配置。