Method: spreadsheets.developerMetadata.search

返回与指定 DataFilter 匹配的所有开发者元数据。如需了解详情，请参阅读取、写入和搜索元数据。

如果提供的 DataFilter 表示 DeveloperMetadataLookup 对象，则此方法会返回该对象选择的所有 DeveloperMetadata 条目。如果 DataFilter 表示电子表格中的某个位置，此方法将返回与该区域相交的位置关联的所有开发者元数据。

HTTP 请求

POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/developerMetadata:search

网址采用 gRPC 转码语法。

路径参数

参数
spreadsheetId

string

要从中检索元数据的电子表格的 ID。

请求正文

请求正文中包含结构如下的数据：

JSON 表示法 
{
  "dataFilters": [
    {
      object (DataFilter)
    }
  ]
}
字段
dataFilters[]

object (DataFilter)

描述用于确定要返回哪些 DeveloperMetadata 条目的条件的数据过滤条件。与任何指定过滤条件匹配的 DeveloperMetadata 都会包含在响应中。

响应正文

对开发者元数据搜索请求的回复。

如果成功，响应正文将包含结构如下的数据：

JSON 表示法 
{
  "matchedDeveloperMetadata": [
    {
      object (MatchedDeveloperMetadata)
    }
  ]
}
字段
matchedDeveloperMetadata[]

object (MatchedDeveloperMetadata)

符合搜索请求条件的元数据。

授权范围

需要以下 OAuth 范围之一：

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/spreadsheets

如需了解详情，请参阅授权指南。

MatchedDeveloperMetadata

开发者元数据条目以及原始请求中与该条目匹配的数据过滤条件。

JSON 表示法 
{
  "developerMetadata": {
    object (DeveloperMetadata)
  },
  "dataFilters": [
    {
      object (DataFilter)
    }
  ]
}
字段
developerMetadata

object (DeveloperMetadata)

与指定过滤条件匹配的开发者元数据。
dataFilters[]

object (DataFilter)

与返回的开发者元数据匹配的所有过滤条件。