Google Cloud API 是 Google Cloud Platform 服务的编程接口。它们是 Google Cloud Platform 的重要组成部分,让您可以为应用添加强大的能力(从计算能力、网络功能、存储能力,再到基于机器学习的数据分析)。
关于 Cloud API
Cloud API 作为网络 API 服务提供给客户,例如 Cloud Pub/Sub API。每个 Cloud API 通常在 googleapis.com
的一个或多个子网域(例如 pubsub.googleapis.com
)上运行,并且通过公共互联网和虚拟私有云 (VPC) 网络为客户端提供 JSON HTTP 和 gRPC 接口。客户端可以直接向 Cloud API 端点发送 HTTP 和 gRPC 请求,也可以使用客户端库发送。
Cloud API 属于 Google Cloud 控制台 API 库中的 Google 企业 API 类别。
Google Cloud API 有两种类型:
基于资源的 API,此 API 使用与所访问的资源关联的项目进行结算和配额计算。
基于客户端的 API,此 API 使用与访问资源的客户端关联的项目进行结算和配额计算。
访问 Cloud API
您可以使用我们的 API 从服务器应用访问 Cloud API客户端库很多热门编程语言(例如移动应用)Firebase SDK ,也可以使用第三方客户端。您还可以通过 Google Cloud CLI 或 Google Cloud 控制台访问 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:
- 将 Cloud Billing Budget API 与 Node.js 搭配使用。
- 使用 Python 的 Cloud Billing Budget API。
- 使用 Node.js 的 Cloud Logging。
- 使用 Python 与 Cloud Logging 交互。
- 使用 Go 的 Cloud Logging。
- 使用 Java 的 Cloud Logging。
- 使用 Node.js 进行语音转文字。
- 使用 Python 进行语音转文字。
- 使用 Go 进行语音转文字。
- 使用 Java 的语音转文字。
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 Cloud API 信息中心中查看此信息。您还可以在 Cloud Monitoring 中创建自定义信息中心和提醒。
如需了解详情,请参阅监控 API 使用量。
Google Enterprise API
Google Enterprise API 是高稳定性的 API,随时可供企业使用并提供支持服务选项。
如需了解详情,请参阅 Google Enterprise API。