如何读取BigQuery数据连接器生成的Google Sheets标签数据？

结论：可以通过Sheets API读取BigQuery数据连接器生成的标签数据，报错是因为标签名称的使用方式有误。 #

问题原因 #

BigQuery数据连接器创建的标签，内部实际名称和界面显示名称可能不一致。比如界面显示为Teams，但API识别的真实名称可能带有后缀（如Teams (BigQuery)）或特殊格式，直接用显示名称构造范围会触发“无效范围”的400错误。

解决步骤 #

1. 获取标签实际名称
   调用Sheets API的spreadsheets.get接口，获取目标表格的所有标签属性，重点查看sheets[].properties.title字段，这里的值才是API能识别的真实标签名称。

2. 正确构造范围字符串

• 如果实际名称包含空格、特殊字符，需要用单引号包裹标签名，比如实际名称是Teams (BigQuery)，则范围应写为：'Teams (BigQuery)'!A1:C10
• 如果实际名称和显示名称一致仍报错，检查是否存在隐藏特殊字符（如全角空格），以API返回的title值为准。

3. 验证权限
   确保你的API服务账号拥有该表格的读取权限，BigQuery连接的标签不会额外限制权限，和普通标签权限规则一致。

示例代码片段（获取标签名称） #

# 调用spreadsheets.get获取标签信息
service = build('sheets', 'v4', credentials=creds)
spreadsheet_id = "你的表格ID"
result = service.spreadsheets().get(spreadsheetId=spreadsheet_id).execute()
sheets = result.get('sheets', [])
for sheet in sheets:
    print(f"标签实际名称: {sheet['properties']['title']}, SheetID: {sheet['properties']['sheetId']}")

内容的提问来源于stack exchange，提问作者Mauricio