google-sheets-api - 如何读取命名范围内的数据？

Question

我已经阅读了 Google Sheets API v4 的文档，但找不到从命名范围读取数据的方法。
我正在使用 Python，具体来说，并在寻找以下内容:

named_range = 'My Beautiful Range'
service = build('sheets', 'v4', credentials=creds)
sheet = service.spreadsheets()
result = sheet.values().get(spreadsheetId=my_id,
                            namedRange=named_range).execute()
values = result.get('values', [])

有这样的API吗？

Answer 1

是的，两者都是 spreadsheets.values.get和 spreadsheets.get接受命名范围作为它们的 range parameter .
请记住，您的命名范围应该有效并且存在于您尝试访问的电子表格中。
笔记:
Valid Range Names:

只能包含字母、数字和下划线。

不能以数字或“真”或“假”字样开头。

不能包含任何空格或标点符号。

必须为 1–250 个字符。

不能是 A1 或 R1C1 语法。例如，如果给范围命名为“A1:B2”或“R1C1:R2C2”，则可能会出现错误。

示例代码:

named_range = 'MyBeautifulRange'
result = sheet.values().get(spreadsheetId=my_id,
                            range=named_range).execute()
values = result.get('values', [])

sample 表:

sample spreadsheets.values.get使用 API Explorer 请求:

示例响应正文:

{
  "range": "Sheet1!A1:B3",
  "majorDimension": "ROWS",
  "values": [
    [
      "A1",
      "B1"
    ],
    [
      "A2",
      "B2"
    ],
    [
      "A3",
      "B3"
    ]
  ]
}