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 类别。
访问 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 客户端库调用,这能提供更好的性能和可用性。此外,您还可以使用第三方客户端。
如需详细了解我们的客户端库,请参阅客户端库说明。
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。
- 将 Cloud Logging 与 Python 搭配使用。
- 使用 Go 的 Cloud Logging。
- 通过 Java 使用 Cloud Logging。
- 使用 Node.js 实现 Speech-to-Text。
- 使用 Python 进行语音转文字。
- 使用 Go 进行语音转文字。
- 使用 Java 实现 Speech-to-Text。
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。