是否记录了 gcloud 输出格式（特别是每个命令的 JSON）？

Question

我正在尝试通过gcloud 的--format json 格式使用可识别TypeScript 的JavaScript 环境(SLIME) 编写gcloud 工具的脚本。脚本集成运行良好，但对于每个命令，我想使用 TypeScript 功能来约束预期的返回类型，并正在权衡如何以及是否要这样做。现在，我不得不手动检查 JSON 输出，以确定命令发出的属性是什么，值是什么——输出的形状是什么。

1. 但我希望我不必这样做。 gcloud 工具返回的 JSON 值是否存在现有的 TypeScript 声明文件？
2. 如果必须，我希望我可以生成 TypeScript 声明文件。 gcloud 工具返回的响应形状是否有任何机器可读的定义？如果这很重要，我对--format json 特别感兴趣，但我怀疑它确实如此。我怀疑所有格式都是从一个规范结构生成的； documentation 建议将这些称为“资源”，但我无法确定资源格式的位置，甚至每个命令返回的资源都可能记录在案。
3. 如果无法生成 TypeScript 声明文件，是否有任何人类可读的文档可以指定来自 gcloud 工具的 JSON 响应的形状？还是对每个命令进行反复试验是唯一的方法？

Answer 1

gcloud .... --log-http 将向您展示底层 HTTP 方法。

APIs Explorer 允许您通过任何 API|服务搜索 HTTP 方法。它记录了请求和响应类型。

Google 为每个 API|服务提供的 SDK 包含资源的特定语言实现，因此您无需为受支持的语言重新创建这些。虽然支持 JavaScript，但我不确定 TypeScript 是否特别支持。

与大多数服务相关联的 Discovery 文档和许多服务的最新 gRPC Protobuf 定义应该也提供了一种获取 TypeScript 定义的方法。

如果可以，请使用现有的 SDK。我将寻找从这些中获取 TypeScript 定义的方法。如果 Google 尚未提供这些，那么它是合理的要求。

Google 提供多种类型的客户端库：

1. 原来的和 Google 范围内的（每个 Google 服务）都有所谓的API Client Libraries。在 Google 对 JavaScript SDK for the API Client Libraries 的复制中，有对 TypeScript types 的引用。
2. 对于 Google Cloud（仅限），有 Google Cloud Client Libraries。对于 JavaScript（Google 使用 Node.JS），有一个可用的惯用库（与等效 API 客户端库的主要区别）库的 comprehensive list，并且在发布 TypeScript 类型时有一个 issue（我没有读过它）为他们。
3. 最后（！？）Google 越来越多地发布其服务的底层协议缓冲区定义（请参阅名称有些混乱的 Google APIs 存储库）。 Google 在内部使用 protobufs，并且 protobufs 越来越多地直接或通过 gRPC Transcoding 及其 API 公开。我不确定您将如何获得 TypeScript 类型（直接从原型；或通过转码）。