Google Cloud API

Google Cloud API 是编程接口，可让您将计算、网络、存储和机器学习服务集成到应用中。您可以通过 JSON HTTP 或 gRPC 端点调用这些网络 API，通常使用客户端库或 Google Cloud CLI 等工具。

关于 Cloud API

Cloud API 作为网络 API 服务向客户公开，例如 Pub/Sub API。每个 Cloud API 通常在 googleapis.com 的一个或多个子网域（例如 pubsub.googleapis.com）上运行，并且通过公共互联网和虚拟私有云 (VPC) 网络为客户端提供 JSON HTTP 和 gRPC 接口。客户端可以直接向 Cloud API 端点发送 HTTP 和 gRPC 请求，也可以使用客户端库发送。

Cloud API 属于 Google Cloud 控制台 API 库中的 Google Enterprise API 类别。

Google Cloud API 有两种类型：

  • 基于资源的 API，此 API 使用与所访问的资源关联的项目进行结算和配额计算，即使访问资源的请求者与不同的项目相关联也是如此。

  • 基于客户端的 API，此 API 要求向 API 发出的请求指定客户端项目。此客户端项目是用于结算和配额的项目。您可以通过多种方式在请求中指定客户端项目。如需详细了解结算和配额归因，请参阅如何确定配额项目。

访问 Cloud API

您可以使用我们的 API 从服务器应用访问 Cloud API客户端库很多热门编程语言（例如移动应用）Firebase SDK，也可以使用第三方客户端。您还可以通过 Google Cloud CLI、Google Cloud 控制台或 Google Cloud MCP 服务器访问 Cloud API。

如果您刚开始接触 Cloud API，请参阅使用入门以了解如何使用 Cloud API。

支持 HTTP 和 gRPC

所有 Cloud API 都提供了一个简单的 JSON HTTP 接口，您可以直接调用该接口，也可以使用 Google API 客户端库调用该接口。大多数 Cloud API 还提供 gRPC 接口，您可以使用 Google Cloud 客户端库调用该接口，从而获得更好的性能和易用性。此外，您还可以使用第三方客户端。

如需详细了解我们的客户端库，请参阅客户端库说明。

如需详细了解如何在使用 Google API 时进行身份验证，请参阅 Google 的身份验证方法和使用客户端库时进行身份验证。

TLS 加密

所有 Cloud API 仅接受使用 TLS 加密的安全请求。

  • 如果您使用的是我们的一个客户端库，则传输库会为您处理传输加密。
  • 如果您使用的是自己的 gRPC 客户端，则需要按照 gRPC 身份验证指南中的说明向 Google 进行身份验证（需要进行 TLS）。
  • 如果您要创建自己的 HTTP 客户端，请参阅我们的 HTTP 准则。

如需详细了解如何保护流向 Google Cloud 服务的流量，请参阅传输加密安全指南。

Private Service Connect

出于安全和合规性方面的原因，企业客户通常希望以私密方式访问 Cloud API。您可以使用 Private Service Connect 在 VPC 网络中设置和管理此类访问权限。

如需了解详情，请参阅配置 Private Service Connect。

分步示例

请参阅以下分步指南，了解如何使用客户端库调用一些常用 API：

API 设计指南

无论接口类型如何，所有 Cloud API 都采用 API 设计指南中所述的面向资源的设计原则，这样可确保 Cloud API 提供简单、一致的开发者体验。 您可以参考我们的 API 设计指南，更好地了解 Cloud API。

如果您想研究 Cloud API 的接口定义，可以访问 GitHub 上的 Google API 代码库。

限制您的用量

Cloud API 由数百万名开发者和用户共用。为确保公平使用并最大限度地减少滥用风险，所有 Cloud API 都设有使用速率限制和资源用量配额，通常称为配额。您还可以通过降低自己的配额上限，使用这些配额来控制您在 Google Cloud 产品上的支出。如果您的配额超出默认限制，您需要提交增加配额的申请。

如需了解详情，请参阅设置 API 使用量上限。

监控您的使用情况

大多数 Cloud API 都可为您提供您的项目对该 API 的使用详情，包括流量水平、错误率和延迟时间。它有助于您对使用 Cloud API 的应用进行快速分类。您可以在 Google Cloud 控制台中的 Google CloudAPI 信息中心中查看此信息。您还可以在 Cloud Monitoring 中创建自定义信息中心和提醒。

如需了解详情，请参阅监控 API 使用情况。

Google Enterprise API

Google Enterprise API 是高稳定性的 API，随时可供企业使用并提供支持服务选项。

如需了解详情，请参阅 Google Enterprise API。