如何读取命名范围内的数据？

Question

我浏览了 Google Sheets API v4 的文档，但找不到从 named 范围读取数据的方法。 我正在使用 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:

• 只能包含字母、数字和下划线。
• 不能以数字或单词“true”或“false”开头。
• 不能包含任何空格或标点符号。
• 必须为 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', [])

样本表：

使用 API 资源管理器的 spreadsheets.values.get 请求示例：

示例响应正文：

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