json - 以 JSON 格式访问(新型、公共(public))Google 工作表

Question

如何访问(新型)Google 工作表的内容和 JSON？我的目标是从 JavaScript 访问值，所以我需要能够通过 HTTP 下载 JSON。

示例:如何从 this sheet 下载数据JSON 格式？

我试图通过网络搜索找到答案，但最终失败了:

• 网络上的许多教程都是从在 url 中查找 key=... 值的指令开始的。我导出工作表时得到的 URL 是 https://docs.google.com/spreadsheets/d/1mhv1lpzufTruZhzrY-ms0ciDVKYiFJLWCMpi4OOuqvI/pubhtml?gid=1822753188&single=true 并且没有 key= ... 在里面。

• "Accessing A Public Google Sheet" 的答案似乎表明我应该尝试https://docs.google.com/spreadsheets/d/1mhv1lpzufTruZhzrY-ms0ciDVKYiFJLWCMpi4OOuqvI/export?format=csv&id=1mhv1lpzufTruZhzrY-ms0ciDVKYiFJLWCMpi4OOuqvI&gid=1822753188获取 CSV 版本，但这对我不起作用:我得到的是登录页面而不是数据。

• 我找到了使用 Google Apps 脚本的方法，但这些方法似乎需要用户在浏览器中进行一些操作，而不是提供下载链接。

Answer 1

如果您想使用最新的 API (v4)，您需要执行以下操作:

1. 生成电子表格 API key (请参阅下面的说明)。
2. 让您的工作表可公开访问。

3. 使用请求的形式:

   https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID/values/RANGE?key=API_KEY
   

然后你会得到一个干净的 JSON 响应:

{
  "range": "Sheet1!A1:D5",
  "majorDimension": "ROWS",
  "values": [
    ["Item", "Cost", "Stocked", "Ship Date"],
    ["Wheel", "$20.50", "4", "3/1/2016"],
    ["Door", "$15", "2", "3/15/2016"],
    ["Engine", "$100", "1", "30/20/2016"],
    ["Totals", "$135.5", "7", "3/20/2016"]
  ],
}

请注意，如果要指定页面的全部内容，则 Sheet1 等标识符为 perfectly valid .

见 Basic Reading了解更多信息。

---

从 v4 API 开始，all requests must be accompanied通过标识符(例如 API key ):

Requests to the Google Sheets API for public data must be accompanied by an identifier, which can be an API key or an access token.

按照链接文档中的步骤在 credentials page 上创建 API key .

确保:

1. 在 Google Cloud Platform 上创建一个新应用。
2. 创建一个新的 API key 。
3. 添加 Google 表格 API。 (API 管理器 > 仪表板 > 启用 API)

---

请注意，您可以 still access public data无需强制用户登录:

In the new Sheets API v4, there is no explicit declaration of visibility. API calls are made using spreadsheet IDs. If the application does not have permission to access specified spreadsheet, an error is returned. Otherwise the call proceeds.

请注意，您不需要将工作表发布到网络上。您需要做的就是确保知道链接的任何人都可以访问该工作表。

(即，当您在 Google Sheets API 上单击 创建凭据 时，选择“其他非 UI”、“用户数据”，它会显示“无法从没有 UI 的平台访问用户数据，因为它需要用于登录的用户交互。”您可以放心地忽略该消息。API key 是您真正需要的，因为这是公共(public)数据。)

---

常见错误信息:

The request is missing a valid API key.

您没有在调用中包含 key= 参数。

API key not valid. Please pass a valid API key. Google developers console

您提供的 API key 不正确。确保您正确输入了 key 。如果您还没有 key ，请访问 Google developers console并创建一个。

API Key not found. Please pass a valid API key.
Google developer console API key

您的 API key 可能正确，但您很可能没有添加 Google 表格权限。转到 Google 开发者控制台 API key 页面并添加工作表权限。

The caller does not have permission

您的工作表未设置为可公开访问。