使用入门

本页面介绍开发者如何开始使用 Google Cloud API。

如果您是首次使用 Google Cloud API，可以按照本指南中的步骤，使用 curl 命令调用 API。在开发应用时，您可以使用 curl 命令对 API 进行实验。

创建 Google 账号

要在应用中使用 Google Cloud API，您首先需要拥有一个 Google 账号。这样您就可以使用 Google 开发者产品，包括 Google Cloud 控制台、gcloud CLI、Cloud Logging 和 Cloud Monitoring。如果您是 Google Cloud 新手，请创建一个账号来评估我们的产品在实际场景中的表现。新客户还可获享 $300 赠金，用于运行、测试和部署工作负载。

创建 Google 项目

要使用 Cloud API，您还需要拥有一个 Google 项目。一个项目等效于一个开发者账号。它充当您的 Google Cloud 资源的资源容器。它还为使用 Google Cloud 服务提供了一个隔离边界，从而使您可以在项目级层独立管理配额限制和结算。使用的遥测和信息中心也按项目分组。如果您还没有项目，可以使用 Google Cloud 控制台创建一个。

一个项目可以拥有各种各样的资源，包括 API 密钥、OAuth 客户端、服务账号、Compute Engine 虚拟机、Cloud Storage 存储分区和 BigQuery 数据集。当应用调用 Cloud API 时，拥有应用凭证的项目称为客户端项目，而拥有目标资源的项目称为资源项目。一个 API 请求可能涉及多个资源，从而涉及多个资源项目。

如果您出于任何原因想要停止使用 Google Cloud，可以使用 Google Cloud 控制台删除您的项目。在经过保留期限之后，您的项目和项目中的所有资源都将被删除。请注意，不同类型的数据的保留期限有所不同。

发现 API

在使用任何 Cloud API 之前，您应该先使用 Google Cloud 控制台 API 库浏览可用的 Cloud API，并找出最符合您业务需求的 API。如需详细了解特定 Cloud API，请访问其公共文档网站，例如 Spanner API。

启用 API

某些 Cloud API 默认处于启用状态。要使用默认未启用的 Cloud API，您必须为项目启用该 API。您可能需要为多个项目启用一个 API，具体取决于应用涉及的服务和项目（包括客户端项目和资源项目）。如果您启用依赖于其他 API 的 API，这些 API 也会同时启用。

启用 API 需要您接受 API 的服务条款和结算责任。您需要获得项目的 serviceusage.services.enable 权限才能启用 API。如需了解详情，请参阅 Service Usage 访问权限控制。

此外，要启用的服务必须是公共服务，否则服务所有者必须向用户授予专用服务的 servicemanagement.services.bind 权限。如需了解详情，请参阅 Service Management 访问权限控制。

要使用 Console 为项目启用 API，请执行以下操作：

  1. 前往 Google Cloud 控制台 API 库。
  2. 从项目列表中选择您要使用的项目。
  3. 在 API 库中，选择要启用的 API。如果您在查找 API 时需要帮助，请使用搜索字段和/或过滤器。
  4. 在 API 页面上，点击启用。

如果您不再使用某项目的 API，则可以在同一页面上停用该 API，以避免滥用和意外结算费用。您还可以使用 gcloud CLI 和 Service Usage API 启用和停用 Cloud API：

$ gcloud services enable pubsub.googleapis.com
$ gcloud services disable pubsub.googleapis.com

启用结算功能

有些 Google API 会收取使用费。您需要为项目启用结算功能，才能在项目中开始使用这些 API。在项目中使用 API 产生的费用都将计入与该项目关联的结算账号。

如果您没有结算帐号，请转到 Google Cloud Console 结算页面，然后按照说明创建一个。然后将您的结算账号关联到您的项目。

向 API 进行身份验证

向 API 进行身份验证的方式取决于您的开发环境以及 API 支持的身份验证方法。

设置应用默认凭据以在各种环境中使用是最常用的方法，建议大多数应用使用。如果 API 支持 API 密钥，您可以选择其他方式。 如果您的应用需要访问最终用户拥有的 Cloud 资源，您需要创建 OAuth 2.0 客户端 ID 并使用身份验证库。

如需了解身份验证的一般信息，请参阅 Google 身份验证。

构建应用

如果您要使用 Cloud API 构建应用，我们建议您使用 Google Cloud 客户端库（如果有的话）。客户端库处理常见的 API 功能，以方便您进行身份验证、错误处理、重试和载荷验证。您需要在初始化期间将应用凭据传递给客户端库，以便客户端库可以代表您的应用调用 Google Cloud API。

请参阅以下分步指南，它们使用适用于某些常用 API 的客户端库：

如需了解详情，请参阅客户端库说明。

更多信息