如何导出并重新导入GCP Looker Studio（原DataStudio）仪表盘

一、导出仪表盘JSON定义 #

Looker Studio没有直接的「导出为代码」按钮，但可以通过API或脚本获取完整的仪表盘配置（包含所有面板、样式、数据源关联等核心定义）。

方法1：用REST API手动导出 #

1. 在Google Cloud Console启用Looker Studio API，创建服务账号并授予目标仪表盘的编辑权限，下载服务账号的密钥JSON文件。
2. 生成访问令牌（可通过gcloud命令行：gcloud auth application-default print-access-token）。
3. 调用reports.get接口获取定义，示例curl命令：

curl -X GET \
  'https://datastudio.googleapis.com/v1/reports/[你的仪表盘ID]?fields=definition' \
  -H 'Authorization: Bearer [生成的访问令牌]'

返回内容即为完整的仪表盘JSON定义，直接保存为文件即可。

方法2：用Google Apps Script批量导出 #

如果要处理多个仪表盘，脚本批量导出更高效：

1. 打开Google Apps Script编辑器，新建空白项目。
2. 粘贴以下代码（替换为你的仪表盘ID）：

function exportReportDef() {
  const reportId = "替换为你的仪表盘ID";
  const apiEndpoint = `https://datastudio.googleapis.com/v1/reports/${reportId}?fields=definition`;
  const authToken = ScriptApp.getOAuthToken();
  
  const response = UrlFetchApp.fetch(apiEndpoint, {
    headers: { "Authorization": `Bearer ${authToken}` }
  });
  
  const defJson = JSON.parse(response.getContentText());
  // 保存到Google Drive
  DriveApp.createFile(`Report_${reportId}_def.json`, JSON.stringify(defJson, null, 2), MimeType.JSON);
}

3. 运行脚本并授权，完成后可在Google Drive中找到导出的JSON文件。

二、导入仪表盘定义到新环境 #

通过API的reports.create接口，可将导出的JSON定义转换成新仪表盘：

1. 使用同一访问令牌，发送POST请求：

curl -X POST \
  'https://datastudio.googleapis.com/v1/reports' \
  -H 'Authorization: Bearer [访问令牌]' \
  -H 'Content-Type: application/json' \
  -d '{
    "title": "测试环境仪表盘副本",
    "definition": [这里粘贴导出的JSON定义内容]
  }'

2. 请求成功后会返回新仪表盘ID，直接访问对应Looker Studio URL即可看到完全复制的仪表盘。

三、自动化低环境仪表盘部署（避免手动构建） #

1. 模板化配置：将生产环境仪表盘定义作为基础模板，用脚本批量替换其中的数据源ID（比如把生产数据源换成测试环境数据源）。
2. 批量自动化：编写脚本循环处理所有需同步的仪表盘，自动完成「导出生产定义→替换环境参数→导入低环境」的全流程，无需手动操作面板。
3. 版本控制：将仪表盘JSON定义存入Git仓库，可追踪配置变更，还能针对不同环境创建分支，按需部署不同版本的仪表盘。

内容的提问来源于stack exchange，提问作者so-random-dude