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 項目的條件。符合任一指定篩選條件的開發人員中繼資料會包含在回應中。

回應主體

開發人員中繼資料搜尋要求的回應。

如果成功，回應主體即會包含具有以下結構的資料：

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)

與傳回的開發人員中繼資料相符的所有篩選器。