Search Analytics API 補上三種篩選:品牌字、多模態與多國家裝置
如果你們每週都用 API 或串接工具產出 Search Console 報表,這次的更新值得花十分鐘看。Google 在 2026 年 11 月 16 日的 Search Central 部落格宣布,Search Analytics API 補上三項原本只有控制台才有的切法:品牌字與非品牌字、網頁多模態搜尋,以及一次篩選多個國家或裝置。意思是,你自己做的報表終於可以和控制台用同一套分類。下面先講官方說了什麼,再講串接前該確認的限制,最後是台灣網站可以先動手的地方。
官方這次補了什麼
- brandedClassification把查詢分成品牌與非品牌,只支援 equals,值為 BRANDED 或 NON_BRANDED,且只對符合資格的資源有資料
- type=webMultimodal查 Google Lens、Circle to Search 與上傳圖片搜尋的表現,要與一般網頁搜尋分開查
- filterLists一次篩選多個國家或裝置,文件目前只允許 country 與 device 兩個維度
- 併用與限制三者可以搭配,但 brandedClassification 不能和 query 篩選放在同一個請求
過去一年,Search Console 控制台的成效報告已經陸續加上品牌查詢篩選、網頁多模態搜尋報表,以及多國家與多裝置篩選。這次的變動是把這三項帶進 API,方便你自訂報表,或把它接進自動化流程。官方也說明,三個篩選可以併用,例如看特定區域的品牌字成長,或看多模態搜尋在主要市場與裝置上哪些頁面表現較好。
brandedClassification:品牌字與非品牌字
brandedClassification 讓你把表現依品牌或非品牌分組,或直接拿來當篩選條件。官方強調它和控制台一樣,只對符合資格的資源提供資料;不符合的資源,回應裡不會有任何資料列。API 文件進一步寫明:這個欄位只支援 equals 運算子,值為 BRANDED 或 NON_BRANDED,資料從 2026 年 2 月 21 日開始,而且只提供給查詢量與曝光量足夠的頂層資源。至於「足夠」是多少,我們查到的文件沒有給出數字。
type=webMultimodal:看圖搜尋的表現
type 多了 webMultimodal 這個值,涵蓋 Google Lens、Android 的 Circle to Search,以及在 Google 搜尋上傳圖片的表現。如果你的資源有啟用大量資料匯出,官方說這份資料也會進 BigQuery。要注意 type 一次只填一個值,預設是 web,所以多模態和一般網頁搜尋是兩次查詢,不會混在同一份數字裡。
filterLists:一次篩選多個國家或裝置
過去想看好幾個國家的合計,你得分別請求再自己加總。filterLists 讓你在一個請求裡列出多個值,只要資料列符合其中任何一個就會被納入。官方舉的例子是 EMEA、LATAM、DACH 這類國家組合,再搭配裝置。這只是官方的舉例,不代表台灣網站要照做。依文件,filterLists 的維度目前只能是 country 或 device;國家用三碼 ISO 代碼,裝置值是 DESKTOP、MOBILE、TABLET。
串接前要先看的限制
官方文件裡有幾條規則,不先看清楚,報表跑出來容易空白或報錯:
brandedClassification不能和query篩選放在同一個請求裡。- 同一個請求中,同一個維度不能同時出現在
filters和filterLists。 dimensionFilterGroups的groupType目前只支援and,「或」還不支援。- 官方文件寫明,API 受內部限制,不會回傳全部資料列,而是回傳較前面的列;單次最多取 25,000 列,要用
startRow分頁。
最後一點常被忽略:你在 API 看到的列數,不一定等於控制台完整的資料量。報表要拿來做決策,別預設兩邊逐列一致。
在台灣網站上可以怎麼做
先在控制台確認你有沒有資格
品牌字分類不是每個資源都看得到。你可以先登入 Search Console,打開成效報告,看有沒有品牌查詢的篩選選項。控制台看不到,API 多半也不會有資料,這時就不必花時間改程式。另外,文件寫的是只支援頂層資源(top-level properties),且查詢量與曝光量要足夠。若你們的資源不是頂層資源,請先在控制台確認看不看得到這個篩選。
多模態與一般網頁要分開看
很多中小企業站的圖片、商品照或菜單照,確實會被看圖搜尋帶來曝光。webMultimodal 的好處,是你終於能獨立看這塊。做法是每週多跑一次請求,type 設為 webMultimodal,維度先放 page,看哪些頁面有表現,再回頭檢查那些頁面的圖片說明、檔名與周邊文字。官方沒有說明這類搜尋的量在一般網站上通常多大,所以先觀察,不要預設它很重要。
選一份既有報表試跑
不要一次重做所有報表。選一份你們每週本來就在看的,例如「各裝置的非品牌字點擊」,改成用 API 的新選項跑一次,和控制台同期間的畫面對照。差距若在文件說的限制範圍內,就可以放進例行流程。如果報表是代理商或工具商做的,請他們確認工具是否已支援這三個選項;沒支援的話,比較穩的做法是先在控制台人工看,不要自己硬改請求。
串接前檢查清單
- 控制台有沒有品牌查詢篩選,資源類型是不是頂層資源。
- 請求裡有沒有同時用了
brandedClassification與query篩選。 country用的是不是三碼代碼,device是不是大寫的官方值。- 多模態與一般網頁搜尋,是否各自一個請求。
- 是否需要分頁,
rowLimit與startRow設對了沒。 - 欄位與可用值,一律以官方 API 文件為準,別參考第三方文章裡的舊範例。
還沒說清楚的地方
官方沒有說品牌字的分類邏輯細節,也沒有說多模態搜尋的資料量級,更沒說這些資料會不會再擴充到更多資源。這些你都不用猜,先把報表跑起來,記下日期與觀察結果,之後官方補充再對照即可。有想把 Search Console 資料接進自動化報表的需求,可以聯絡我們的免付費電話 0800-250-555 或 LINE @szt9406q。
參考來源
發布:2026-11-22|最後更新:2026-11-22