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)

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