快速入门：为开发环境设置 Service Usage

为开发环境设置 Service Usage

本页介绍如何设置开发环境以使用 Service Usage API。

• 对于大多数操作用例，启用和停用服务的最简单方法是使用 Google Cloud Console。
• 如果您需要创建脚本，可以使用 Google Cloud CLI。
• 如果您需要针对 Service Usage API 进行编程，请使用某个客户端库。
• 如需试用 API，您可以按照本指南中的备用设置说明进行操作，并使用 curl 命令来测试 API，而无需设置完整的应用开发环境。

设置环境以直接调用 API

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

注意：如果您使用 Google Cloud Console 或 gcloud 命令行界面列出、启用或停用服务，则无需完成本部分中的说明。

启用 Service Usage API

要使用 Service Usage API，必须首先在要使用该 API 的 Cloud 项目中启用它：

1. 转到 Google Cloud Console 的 API 库页面。
   转到“API 库”页面
2. 选择要用于访问该服务的 Cloud 项目。
3. 在“API 库”页面上，点击启用。
4. 确保您的用户帐号具有 Service Usage Admin 角色。

用 curl 进行测试

1. 定义一个方便的 shell 别名，以便调用 Google REST API：

   alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'
   

2. 使用您的项目标识符设置环境变量 PROJECT_ID：

   PROJECT_ID="my-project-id"
   

3. 确保您已登录 &gcloud3：

   gcloud auth login
   

4. 使用 gcloud 查找项目的编号，并将其保存到环境变量中：

   PROJECT_NUMBER=`gcloud projects list --filter="projectId=${PROJECT_ID}" --format="value(PROJECT_NUMBER)"`
   

5. 列出此项目中已启用的 API 和服务：

   gcurl "https://serviceusage.googleapis.com/v1/projects/${PROJECT_NUMBER}/services?filter=state:ENABLED&fields=services.config.title,services.config.name"
   

   如果您看到如下输出结果，则说明您的设置已成功：

   {
   "services": [
     {
       "config": {
         "name": "bigquery.googleapis.com",
         "title": "BigQuery API"
       }
     },
     {
       "config": {
         "name": "bigquerystorage.googleapis.com",
         "title": "BigQuery Storage API"
       }
     },
     ...
   

后续步骤

按照列出服务列出 Cloud 项目中已启用或可用的 API 和服务。