Method: spreadsheets.getByDataFilter
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
返回具有指定 ID 的电子表格。调用方必须指定电子表格 ID。
此方法与 spreadsheets.get 的不同之处在于,该方法允许通过指定 dataFilters
参数来选择要返回的电子表格数据的子集。您可以指定多个 DataFilters
。指定一个或多个数据过滤器会返回电子表格中与任何过滤器匹配的范围相交的部分。
默认情况下,不会返回网格内的数据。您可以通过以下两种方式之一添加网格数据:
对于大型电子表格,最佳做法是只检索您需要的特定电子表格字段。
HTTP 请求
POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}:getByDataFilter
网址采用 gRPC 转码语法。
路径参数
参数 |
spreadsheetId |
string
要请求的电子表格。
|
请求正文
请求正文中包含结构如下的数据:
JSON 表示法 |
{
"dataFilters": [
{
object (DataFilter )
}
],
"includeGridData": boolean
} |
字段 |
dataFilters[] |
object (DataFilter )
DataFilters 用于选择要从电子表格中检索的范围。
|
includeGridData |
boolean
如果应返回网格数据,则为 true。如果在请求中设置了字段掩码,则忽略此参数。
|
响应正文
如果成功,则响应正文包含一个 Spreadsheet
实例。
授权范围
需要以下 OAuth 范围之一:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/spreadsheets
有关详情,请参阅授权指南。
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2024-09-05。
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"没有我需要的信息"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"太复杂/步骤太多"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"内容需要更新"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"翻译问题"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"示例/代码问题"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"其他"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"易于理解"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"解决了我的问题"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"其他"
}]
{"lastModified": "\u6700\u540e\u66f4\u65b0\u65f6\u95f4 (UTC)\uff1a2024-09-05\u3002"}
[[["易于理解","easyToUnderstand","thumb-up"],["解决了我的问题","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["没有我需要的信息","missingTheInformationINeed","thumb-down"],["太复杂/步骤太多","tooComplicatedTooManySteps","thumb-down"],["内容需要更新","outOfDate","thumb-down"],["翻译问题","translationIssue","thumb-down"],["示例/代码问题","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["最后更新时间 (UTC):2024-09-05。"]]