google-gax 是 Google Cloud 的 API 客户端库，用于响应式并发编程，具有客户端重试、请求日志记录、超时和元数据传输等功能。
安装 google-gax
你可以通过 npm 管理器安装 google-gax：
--- ------- ---------- ------
如果你使用 yarn 管理器，则可以使用以下命令来安装：
---- --- ----------
初始化 google-gax
在使用 google-gax 前，你需要初始化它。以下是如何进行初始化：
----- - ---------- - - -------------------------------
----- - ---- - - --- ------------
------------ ------------------------
------- --------------------------------------------------
---
----- - ---------------- - - ----------------------
----- --------- - --- ------------------------------------ - ---- ---以上代码中，我们创建了 GoogleAuth 实例和 GoogleApiFactory 实例。auth 参数会指向一个已设置好的凭据，这将用于客户端授权。
你需要将 [apiName] 替换为你要使用的 API 的名称。可以在 Google Cloud Console 控制台上的 APIs & Services 页面中找到 API 的名称。
调用 API
在初始化了 google-gax 之后，你可以调用 API 了。以下是使用 google-gax 操作 Google Cloud Storage的示例：
----- - ------ - - ----------------------
----- - -------- - -- - - - -------
----- - ---------------- - - ----------------------
----- -------- ------------ -
----- ---------- - --- ------------------------
------------ ------------------------
------- --------------------------------------------------
--
----- --------- - --- ------------------------------------ - ----- ---------- ---
----- ------- - ----- ------------------------------- ---------- -------------- ---
-----------------------------
-
-------------以上代码中，我们使用操作 Google Cloud Storage 的 API listBuckets 获取 PROJECT_ID 下的存储桶。在调用时，我们将 [PROJECT_ID] 替换为实际的项目 ID。
使用元数据传输服务
google-gax 还支持使用元数据传输服务，以在客户端之间共享元数据。以下是如何在客户端之间共享有关 API 请求的元数据：
----- - ---------- - - ------------------------------- ----- - ---- - - --- ------------- ----- - -------- - - ---------------- ----- -------- - --- ----------- ------------------------------------- --------------- ----- - ---------------- - - ---------------------- ----- --------- - --- ------------------------------------ - ----- -------- ---
以上代码中，我们使用 Metadata 函数创建了一个元数据对象。我们向元数据对象中添加了一个 x-goog-request-params 标头，它是通过 * 支持任何未识别的标头和查询参数的泛型查询参数。
这是用于元数据传输的 HTTP 请求头文件的一个示例：
---- ----------------------------------- -------- -------------------- ---------- ---------------------- -----------------------
结束语
google-gax 将为你的应用程序带来许多优点，如请求日志记录、客户端重试、超时等。在使用 google-gax 时，请务必初始化它并调用需要使用的 API。同时，也可以使用元数据传输服务传输有关 API 请求的元数据。
来源：JavaScript中文网 ，转载请联系管理员！ 本文地址：https://www.javascriptcn.com/post/google-gax