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)

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