本頁面由 Cloud Translation API 翻譯而成。

DataFilter

JSON 表示法
DeveloperMetadataLookup
- JSON 表示法
DeveloperMetadataLocationMatchingStrategy

這個篩選器說明瞭應從要求選取或傳回哪些資料。

JSON 表示法

JSON 表示法
{ // Union field `filter` can be only one of the following: "developerMetadataLookup": { object (`DeveloperMetadataLookup`) }, "a1Range": string, "gridRange": { object (`GridRange`) } // End of list of possible types for union field `filter`. }

{

  // Union field filter can be only one of the following:
  "developerMetadataLookup": {
    object (DeveloperMetadataLookup)
  },
  "a1Range": string,
  "gridRange": {
    object (GridRange)
  }
  // End of list of possible types for union field filter.
}

欄位
聯集欄位 `filter`。可能會限制所選資料的篩選器類型。`filter` 只能是下列其中一項：
`developerMetadataLookup`	`object (DeveloperMetadataLookup)` 選取與開發人員中繼資料相關聯的資料，且該中繼資料與此 `DeveloperMetadataLookup` 所述的條件相符。
`a1Range`	`string` 請選取符合指定 A1 範圍的資料。
`gridRange`	`object (GridRange)` 選取符合 `GridRange` 所述範圍的資料。

DeveloperMetadataLookup

選取符合所有指定欄位的 DeveloperMetadata。舉例來說，如果只指定中繼資料 ID，系統會考量具有該特定不重複 ID 的 DeveloperMetadata。如果指定中繼資料鍵，系統會考量該鍵的所有開發人員中繼資料。如果您已指定鍵、顯示設定和位置類型，系統會考量所有與該類型位置相關聯的開發人員中繼資料，並使用該鍵和顯示設定。一般來說，這會選取與所有指定欄位交集相符的所有 DeveloperMetadata；您可以指定任何欄位或欄位組合。

JSON 表示法

JSON 表示法
{ "locationType": enum (`DeveloperMetadataLocationType`), "metadataLocation": { object (`DeveloperMetadataLocation`) }, "locationMatchingStrategy": enum (`DeveloperMetadataLocationMatchingStrategy`), "metadataId": integer, "metadataKey": string, "metadataValue": string, "visibility": enum (`DeveloperMetadataVisibility`) }

{
  "locationType": enum (DeveloperMetadataLocationType),
  "metadataLocation": {
    object (DeveloperMetadataLocation)
  },
  "locationMatchingStrategy": enum (DeveloperMetadataLocationMatchingStrategy),
  "metadataId": integer,
  "metadataKey": string,
  "metadataValue": string,
  "visibility": enum (DeveloperMetadataVisibility)
}

欄位
`locationType`	`enum (DeveloperMetadataLocationType)` 將所選的開發人員中繼資料限制為與指定類型位置相關聯的項目。舉例來說，如果這個欄位指定為 `ROW`，這個查詢只會考量與資料列相關聯的開發人員中繼資料。如未指定欄位，系統會考量所有位置類型。如果 `locationMatchingStrategy` 指定為 INTERSECTING，或 `metadataLocation` 指定為非試算表位置，則這個欄位不得指定為 `SPREADSHEET`：試算表中繼資料不得與任何其他開發人員中繼資料位置重疊。將 `locationMatchingStrategy` 指定為 EXACT 時，也必須指定這個欄位。
`metadataLocation`	`object (DeveloperMetadataLocation)` 將所選開發人員中繼資料限制為與指定位置相關聯的項目。這個欄位會根據指定的 `locationMatchingStrategy`，比對精確位置或所有交疊位置。
`locationMatchingStrategy`	`enum (DeveloperMetadataLocationMatchingStrategy)` 決定此查詢如何比對位置。如果將這個欄位指定為「EXACT」，系統只會比對與指定確切位置相關聯的開發人員中繼資料。如果這個欄位指定為 INTERSECTING，則會比對交集位置的相關聯開發人員中繼資料。如未指定，這個欄位會假設預設值為 `INTERSECTING`。如果指定這個欄位，就必須一併指定 `metadataLocation`。
`metadataId`	`integer` 將所選的開發人員中繼資料限制為與 `DeveloperMetadata.metadata_id` 相符的資料。
`metadataKey`	`string` 將所選的開發人員中繼資料限制為與 `DeveloperMetadata.metadata_key` 相符的資料。
`metadataValue`	`string` 將所選的開發人員中繼資料限制為與 `DeveloperMetadata.metadata_value` 相符的資料。
`visibility`	`enum (DeveloperMetadataVisibility)` 將所選的開發人員中繼資料限制為與 `DeveloperMetadata.visibility` 相符的資料。如未指定，則要求專案的所有開發人員中繼資料瀏覽權限都會納入考量。

DeveloperMetadataLocationMatchingStrategy

列舉可用於比對開發人員中繼資料位置的策略。

列舉
`DEVELOPER_METADATA_LOCATION_MATCHING_STRATEGY_UNSPECIFIED`	預設值。不能使用這個值。
`EXACT_LOCATION`	表示指定位置應完全相符。舉例來說，如果第三列指定為位置，這個比對策略只會比對與第三列相關聯的開發人員中繼資料。系統不會考慮其他位置的相關中繼資料。
`INTERSECTING_LOCATION`	表示指定的位置應與該確切位置以及所有交集的位置相符。舉例來說，如果將第 3 列指定為地點，則這個比對策略會符合第 3 列的相關開發人員中繼資料，以及與第 3 列交集地點的相關中繼資料。舉例來說，如果 B 欄有相關聯的開發人員中繼資料，這個比對策略也會比對該位置，因為 B 欄與第三列相交。