请注意，您正在查看 Looker 文档。如需查看 Looker Studio 文档，请访问 https://support.google.com/looker-studio。

下载 Looker JAR 文件

我们建议您在更新 Looker 之前创建 Looker 实例的备份。如需查看相关说明，请参阅创建备份文档页面。

如需为客户托管的部署安装或更新 Looker 应用，您必须下载 Looker JAR 文件。本页介绍了下载 Looker JAR 文件的两种方法：

使用下载 Looker JAR 文件网页
调用该 API

在下载 JAR 文件之前，您必须接受最终用户许可协议 (EULA)，您可以在下载 Looker JAR 文件网页（使用本页上的规范）中找到该协议。每个下载 JAR 文件的用户必须仅接受此最终用户许可协议一次。（如果最终用户许可协议日后更新，每位用户还必须接受更高版本。）

使用下载 Looker JAR 文件网页

您可以通过以下链接访问下载 Looker JAR 文件网页：https://download.looker.com/validate：

输入您的 Looker 许可编号。
输入您的电子邮件地址。必须是私人托管的电子邮件域名。
选择要下载的 Looker 版本。

如果您选择最新版本，则会下载当前 Looker 版本的 Looker JAR 文件。如果您选择特定版本，则需要准确输入 Looker 核心 JAR 文件名。

每个版本的 JAR 文件的命名惯例包括版本号中的 . 并遵循设定的模式。例如，Looker 22.2 的 JAR 文件名为 looker-22.2.jar 和 looker-dependencies-22.2.jar。
选择下载。

如果您尚未接受最终用户许可协议，系统会显示最终用户许可协议接受表单。选择阅读条款及条件即可完整查看最终用户许可协议。接下来，输入您的名字和姓氏，然后选中我同意条款及条件旁边的复选框。最后，选择下载。
选择 Download 1/2 以下载 Looker 核心 JAR 文件。然后，选择 Download 2/2 以下载 Looker 依赖项 JAR 文件。此链接会在 10 分钟后失效。如果链接失效，您可以重新开始下载流程。

调用 API

您必须先通过下载 Looker JAR 文件网页接受最终用户许可协议，然后才能通过调用 API 下载 JAR 文件。

然后，您可以使用任何所需方法（JavaScript、Java、Ruby、shell 命令等）向 HTTPS 端点发出 POST 请求。为使这些请求有效，您必须使用 POST 方法将 API 载荷发送到 https://apidownload.looker.com/download。API 载荷必须包含 lic、email 和 latest 的值。

latest 属性表示 Looker JAR 的版本。如需下载适用于当前 Looker 版本 (looker-latest.jar) 的最新版 JAR 文件，请指定 "latest" 即可。如需下载特定版本，请将 latest 设为 "specific"，在 API 载荷中再添加一个名为 specific 的键值对，将所需的核心 JAR 文件名设为值。

您只需要调用该 API 一次；初始响应将同时包含下载链接，并且可用时间为 10 分钟。您需要单独下载这两个 JAR 文件。

以下是使用 ES6 (JavaScript) 编写请求的两个示例。如需请求最新版本，请执行以下操作：

    axios({
        url: "https://apidownload.looker.com/download",
        method: "post",
        data: {
            lic: "YOUR-LOOK-ERLI-CENS-EKEY",
            email: "contact@email.com",
            latest: "latest"
        }
    }).then(function (response) {
        console.log(response.data);
    })

如需请求特定 JAR 版本（例如 Looker 22.2），请运行以下命令：none data: { lic: "YOUR-LOOK-ERLI-CENS-EKEY", email: "contact@email.com", latest: "specific", specific: "looker-22.2-latest.jar" }

以下是向 HTTPS 端点发出 POST 请求的两个示例 shell 命令。

如需使用 wget 命令请求特定版本的 JAR 文件（例如 Looker 22.2），请运行以下命令：

wget -O- --header=Content-Type:application/json\
--post-data='{"lic": "YOURLOOKERLICENSE", "email": "contact@email.com", "latest":"specific",\
"specific":"looker-22.2-latest.jar"}'\
"https://apidownload.looker.com/download"

wget -O- --header=Content-Type:application/json\
--post-data='{"lic": "YOURLOOKERLICENSE", "email": "contact@email.com", "latest":"specific",\
"specific":"looker-dependencies-22.2-latest.jar"}'\
"https://apidownload.looker.com/download"

如需使用一系列 curl 和 wget 命令请求最新的 JAR 文件，以便在本地下载并保存文件，请执行以下操作：

curl -X POST -H 'Content-Type: application/json' -d '{"lic": "YOURLOOKERLICENSE", "email": "contact@email.com", "latest":"latest"}'
https://apidownload.looker.com/download > api_response.json

wget -O "looker-latest.jar" "$(cat api_response.json | jq -r '.url')"

wget -O "looker-dependencies-latest.jar" "$(cat api_response.json | jq -r '.depUrl')"

或者，如果您已安装 jq 和 wget，则可以使用以下 shell 命令示例。

如需使用一系列 wget 命令请求最新的 JAR 文件，请执行以下操作：

wget -O "looker-latest.jar" "$(shell curl -s -X POST -H 'Content-Type: application/json'\
-d "{\"lic\": \"$(YOURLOOKERLICENSE)\", \"email\": \"$(contact@email.com)\",\"latest\":\"latest\"}\
"https://apidownload.looker.com/download | jq .url -r)"

wget -O "looker-dependencies-latest.jar" "$(shell curl -s -X POST -H 'Content-Type: application/json'\
-d "{\"lic\": \"$(YOURLOOKERLICENSE)\", \"email\": \"$(contact@email.com)\",\"latest\":\"latest\"}\
"https://apidownload.looker.com/download | jq .depUrl -r)"

您也可以下载 JAR 的其他版本，方法是将 LOOKER_VERSION 设置为 latest、22.2-latest 或以下一系列命令示例中的其他支持的版本。例如，如需为 Looker 22.2 请求核心文件和依赖项文件，请使用以下代码： none export LOOKER_VERSION="22.2-latest" none wget -O "looker$(LOOKER_VERSION).jar" "$(shell curl -s -X POST -H 'Content-Type: application/json'\ -d "{\"lic\": \"$(YOURLOOKERLICENSE)\", \"email\": \"$(contact@email.com)\",\"latest\":\"specific\",\ \"specific\":\"looker-$(LOOKER_VERSION).jar\"} "https://apidownload.looker.com/download | jq .url -r)" none wget -O "looker-dependencies$(LOOKER_VERSION).jar" "$(shell curl -s -X POST -H\ 'Content-Type: application/json' -d "{\"lic\": \"$(YOURLOOKERLICENSE)\", \"email\":\ \"$(contact@email.com)\",\"latest\":\"specific\", \"specific\":\"looker-dependencies-$(LOOKER_VERSION).jar\"}\ "https://apidownload.looker.com/download | jq .depUrl -r)"

成功的响应将同时包含下载网址和 JAR 文件的 SHA-256 哈希。

API 载荷错误（例如输入参数缺失或输入错误）会导致“请求正文无效”响应。如果请求 specific 版本时提供不正确的许可密钥或省略 specific 值，将会导致“请求无效”响应。

下载两个 JAR 文件时遇到问题可能会导致 splitJarMessage 字段中显示消息。

如果您之前尚未接受最新的最终用户许可协议，响应将包含三个字段：eulaMessage、eulaText 和 eulaNeeded。eulaMessage 表示您必须先通过下载 Looker JAR 文件网页接受最终用户许可协议，然后 API 会返回下载网址。