ImportJSON 技术文档

1. 安装指南

安装步骤：

1. 打开 Google Sheets。
2. 点击菜单栏中的 工具，选择 脚本编辑器。
3. 在脚本编辑器中，删除任何现有代码。
4. 复制并粘贴 ImportJSON.gs 文件的内容。
5. 点击 文件，选择 保存，并给脚本一个合适的名称。
6. 关闭脚本编辑器，返回 Google Sheets。

安装完成后，您可以在 Google Sheets 中使用 =ImportJSON() 函数。

2. 项目的使用说明

ImportJSON 项目为 Google Sheets 提供了一个 =ImportJSON() 函数，允许用户直接从任何 URL 导入 JSON 数据。以下是使用该函数的基本步骤：

1. 在 Google Sheets 中，选择一个空白单元格。

2. 使用以下格式输入函数：

   =ImportJSON("URL", "JSONPath")
   

   其中 URL 是您想要导入 JSON 数据的地址，JSONPath 是您想要提取的 JSON 数据路径。

   例子：

   =ImportJSON("https://mysafeinfo.com/api/data?list=bestnovels&format=json&rows=20&alias=cnt=count,avg=average_rank,tt=title,au=author,yr=year", "/title")
   

3. 按下回车键，函数将返回指定路径下的数据。

可用函数：

• ImportJSON: 用于从 URL 导入 JSON 数据。
• ImportJSONFromSheet: 用于从 Google Sheets 的其他工作表中导入 JSON 数据。
• ImportJSONViaPost: 用于使用 POST 参数从 URL 导入 JSON 数据。
• ImportJSONBasicAuth: 用于使用 HTTP Basic 认证从 URL 导入 JSON 数据。
• ImportJSONAdvanced: 用于脚本开发者扩展库的功能。

3. 项目API使用文档

ImportJSON 项目中的函数可以按照以下方式使用：

• ImportJSON(url, [path], [noHeaders], [fetchOptions])

  • url: JSON 数据的 URL。
  • path: JSON 数据的路径，用于指定要导入的数据部分。
  • noHeaders: 可选参数，如果设置为 true，则不返回表头。
  • fetchOptions: 可选参数，用于设置请求的选项。

• ImportJSONFromSheet(sheet, [startRow], [startColumn], [endRow], [endColumn], [path])

  • sheet: 包含 JSON 数据的工作表名称。
  • startRow: 开始解析的行号。
  • startColumn: 开始解析的列号。
  • endRow: 结束解析的行号。
  • endColumn: 结束解析的列号。
  • path: JSON 数据的路径。

• ImportJSONViaPost(url, [path], [noHeaders], [fetchOptions], [postParams])

  • url: JSON 数据的 URL。
  • path: JSON 数据的路径。
  • noHeaders: 可选参数，如果设置为 true，则不返回表头。
  • fetchOptions: 可选参数，用于设置请求的选项。
  • postParams: POST 请求的参数。

• ImportJSONBasicAuth(url, [path], [noHeaders], [fetchOptions], [username], [password])

  • url: JSON 数据的 URL。
  • path: JSON 数据的路径。
  • noHeaders: 可选参数，如果设置为 true，则不返回表头。
  • fetchOptions: 可选参数，用于设置请求的选项。
  • username: HTTP Basic 认证的用户名。
  • password: HTTP Basic 认证的密码。

4. 项目安装方式

请参考本文档的“安装指南”部分进行安装。简而言之，您需要将 ImportJSON.gs 脚本内容复制并粘贴到 Google Sheets 的脚本编辑器中，保存并返回 Google Sheets 以开始使用 =ImportJSON() 函数。