篩選過的報表

新版 Search Ads 360 Reporting API 現已開放使用。這個新 API 提供更靈活彈性的功能，協助您建立自訂報表，並將這些資料整合至報表應用程式和程序。進一步瞭解如何使用及遷移至新版 Search Ads 360 Reporting API。

根據預設，報表會包含要求指定 reportScope 中的所有資料。如果希望報表只包含一組符合一組條件的資料，可以在報表中新增一或多個篩選器。系統只會傳回符合所有篩選條件的資料列。

舉例來說，您可以要求為特定代理商的所有關鍵字製作報表。接著，您可以指定篩選器，讓報表只顯示到達網頁網址開頭為 www.example.com 和 www.another-example.com 的關鍵字。

"filters": [
  {
    "column" : { "columnName": "keywordLandingPage" },
    "operator" : "startsWith",
    "values" : [
      "http://www.example.com",
      "http://www.another-example.com"
    ]
  }
]

每個篩選器會指定要篩選的資料欄、運算子以及應位於指定資料欄的值清單：

"filters": [
  {
   "column" : column to filter on,
   "operator" : operator specifying the type of filter,
   "values" : list of values
  },
  { ... another filter can go here ... }
]

注意：無法篩選部分資料欄。在「報表類型」參考資料中，每一欄都會顯示為 Filterable。

篩選器運算子

所有篩選器均須區分大小寫。也就是說，含有「www.Sprockets.com」的篩選器，不會與包含「www.sprockets.com」的資料欄進行比對。

業者	說明	支援的值數量
equals	資料欄必須與指定值完全相符。	1
notEquals	資料欄不得與指定值相符。	1
in	這一欄必須與篩選器清單中的其中一個值完全相符。 不適用於清單資料類型 (例如 String list)。	變數
lessThan	資料欄所含的值必須小於指定值。 如果您為「Boolean」欄指定這個篩選器，Search Ads 360 API 會將 false 轉換成 0 和 true 的數值，並轉換成 1。如果為 String 資料欄指定這個篩選器，API 會比較字母順序。 不適用於清單資料類型 (例如 String list)。	1
greaterThan	資料欄所含的值必須大於篩選器清單中的其中一個值。 如果您為 Boolean 欄指定這個篩選器，API 會將 false 轉換為 0 和 true 的數值， 為 1。如果為 String 資料欄指定這個篩選器，API 會比較字母順序。 不適用於清單資料類型 (例如 String list)。	1
lessThanOrEqual	資料欄所含的值必須小於或等於篩選器清單中的其中一個值。 如果您為 Boolean 欄指定這個篩選器，API 會將 false 轉換為 0 和 true 的數值， 為 1。如果為 String 資料欄指定這個篩選器，API 會比較字母順序。 不適用於清單資料類型 (例如 String list)。	1
greaterThanOrEqual	資料欄所含的值必須大於或等於篩選器清單中的其中一個值。 如果您為 Boolean 欄指定這個篩選器，API 會將 false 轉換為 0 和 true 的數值， 為 1。如果為 String 資料欄指定這個篩選器，API 會比較字母順序。 不適用於清單資料類型 (例如 String list)。	1
isNull	此欄必須留空。舉例來說，假設您在關鍵字報表中為 keywordMaxCpc 欄指定 isNull，報表就只會包含未指定最高單次點擊出價的關鍵字。	0
isNotNull	資料欄必須包含值。	0
startsWith	資料欄的開頭必須是篩選器清單中的其中一個字串。 僅適用於 String 欄。	變數
containsSubstring	這個資料欄必須包含篩選器清單中指定的完整或部分字串。 例如，含有下列值的 containsSubstring 篩選器： ["ham", "cheese"] 會傳回具有下列值的資料列： hamburger cheeseburger 但不會傳回含有下列值的資料列： lobster roll lettuce high amplitude (high amplitude 含有子字串「h am」，但所有字元 (包括空格) 都會由篩選器評估) 僅適用於 String 欄。	變數
doesNotContainSubstring	資料欄不得包含篩選器清單中的任何字串。 舉例來說，如果 doesNotContainSubstring 篩選器含有下列值： ["ham", "cheese"] 會傳回含有下列值的資料列： lobster roll lettuce 但不會傳回含有下列值的資料列： hamburger cheeseburger 僅適用於 String 欄。	變數
containsElement	資料欄必須包含篩選器清單中至少一個值。僅適用於包含清單資料類型的資料欄 (例如 String list)。 舉例來說，在 campaign 報表中，有包含值的 containsElement 篩選器： ["foo", "bar"] 篩選 effectiveLabels 欄時，只會傳回標籤為 foo、bar 或同時加上兩者的廣告活動。	變數