google-api - 使用基于列表的提要 API 和 "sq"参数从 Google 电子表格中检索一系列行

Question

我的目标是在标准 cURL 调用(API 的协议(protocol)方法)中使用 sq 参数从 Google Worksheet 检索一系列行。我知道 the Google Sheets documentation explains the sq parameter by way of example .在该文档示例中，它使用带有比较运算符的列标题名称，但是有没有办法使用 sq 参数检索由开始和结束行索引指定的行范围？

我知道可以使用 Google 的可视化 API 来做这样的事情，但我用来检索数据的 Google 表格的 URL 似乎需要“重建”以匹配可视化 API。我需要提取电子表格“ key ”，然后重建 URL as per documentation (scroll to the bottom) .作为一名开发人员，我有点厌倦了执行任何字符串操作来制定 URL，因此我可以简单地从 Google 表格中提取一系列行。

无需借助基于单元格的 API 提要即可检索一系列行的最佳做法是什么？

编辑:我查看了Google's Query Language reference (version 0.7)并发现using offset together with limit could grab a range of rows with an SQL statement .但是，当我尝试对这些进行查询时，它不适用于 sq url中的参数。我尝试对 sq 的值进行 URL 编码参数也可以确定，但没有运气。好像是 sq参数值只能引用基于列表的提要中的列标题。有人知道是不是这样吗？在我的 cURL 调用中，这是我尝试过的一些 URL(cURL 请求已通过身份验证):

https://spreadsheets.google.com/feeds/list/{key}/od6/private/full?sq=limit+3+offset+3 //returns Parse error: null

https://spreadsheets.google.com/feeds/list/{key}/od6/private/full?sq=limit%203%20offset%203 //URL encoded value for sq returns Parse error: null

https://spreadsheets.google.com/feeds/list/{key}/od6/private/full?sq="limit 3 offset 3 //Returns HTML marked up error with Error 400 (Bad Request)!! as <title>

我们可以用 sq 做什么范围？ Google，它在任何地方都有记录吗？

Answer 1

好吧，经过更多的探索，并阅读了David Bullock's回答this SO thread , 我前往 Google's old Protocol Reference documentation --适用于 API 版本 2.0。我通读了the Queries section并且很高兴地报告，即使是最新的 API 版本，start-index 和 max-results 参数仍然适用于基于列表的提要 URL。

因此，例如，假设您有一个包含 100 行的特定工作表的 href，您可以使用类似这样的方法来检索第 50 行到第 67 行:

https://spreadsheets.google.com/feeds/list/{key}/od6/private/full?start-index=50&max-results=17

虽然这目前令人满意，但如果这些参数会被弃用， 最好从 Google 那里知道。我假设它们将被弃用，因为当前的 API 文档中没有对它们的引用。如果能直接收到来自 Google 的消息会很棒，但现在我将只使用这些经典参数。