本文へ移動
技術を、自社の仕事に。
判断と実行を助けるメディア

記事を検索

Search Console APIで指名検索を分ける

目次 · 7項目

検索のレポートで「表示回数が増えた」と報告しても、その中身が社名での検索(指名検索)なのか、まだ会社を知らない人の検索なのかで、意味は大きく違います。社名を含む検索語を正規表現で除く作り方は手間がかかり、表記ゆれの漏れも出ます。

Search Consoleの画面では、2025年11月から順に指名検索の絞り込み(branded queries filter)が、2026年9月から画像を使った検索(Web マルチモーダル)の数字が使えるようになっていました。2026年11月16日、GoogleはSearch Centralのブログで、これらと国・端末の複数指定を、Search Analytics APIでも使えるようにしたと発表しました。本記事では、発表、APIのリファレンス、Discovery文書(APIの機械向けの定義)から、増えた項目と、レポートの自動化で書き換える箇所を整理します。

増えた項目は3つ

Discovery文書では、googleapis/google-api-nodejs-clientのリポジトリに2026年11月17日に取り込まれた変更で、版(revision)が 20260805 から 20261115 に上がり、この3つが加わりました。リファレンスは小文字のキャメルケース(brandedClassification・webMultimodal)で、Discovery文書は大文字(BRANDED_CLASSIFICATION・WEB_MULTIMODAL)で書いています。

項目使う場所資料の説明
BRANDED_CLASSIFICATIONdimensions(集計の切り口)とフィルタの dimension指名検索かどうか(BRANDED・NON_BRANDED)で分ける・絞る。フィルタの演算子は「一致」だけ
filterListsdimensionFilterGroups の中1つの切り口に複数の値をOR(いずれか)で指定。COUNTRY と DEVICE のみ、値は最大1000件(Discovery文書)
WEB_MULTIMODALtype(旧 searchType)Google レンズ、Androidの「かこって検索」、Google検索への画像のアップロードからの検索結果

対象の操作は、これまでと同じ searchanalytics.query(POST webmasters/v3/sites/{siteUrl}/searchAnalytics/query)で、スコープも webmasters・webmasters.readonly のままです。

指名検索とそれ以外に分ける

dimensions に BRANDED_CLASSIFICATION を入れると、行が BRANDED と NON_BRANDED に分かれて返ります。月ごとの推移を見るなら DATE と組み合わせます。

{
  "startDate": "2026-10-01",
  "endDate": "2026-10-31",
  "dimensions": ["BRANDED_CLASSIFICATION"],
  "type": "WEB"
}

指名検索以外だけのページ別の数字が欲しいときは、フィルタで絞ります。

{
  "startDate": "2026-10-01",
  "endDate": "2026-10-31",
  "dimensions": ["PAGE"],
  "dimensionFilterGroups": [{
    "filters": [{
      "dimension": "BRANDED_CLASSIFICATION",
      "operator": "EQUALS",
      "expression": "NON_BRANDED"
    }]
  }],
  "rowLimit": 1000
}

リファレンスと発表には、使う前に知っておきたい条件が書かれています。

  • データは2026年2月21日から。 それより前の期間は分けられません。
  • 対象のプロパティが限られる。 最上位のプロパティ(https://example.com/path のようなURLの一部や、サブドメインのプロパティではないもの)で、検索語と表示回数が十分にあるサイトだけです。対象外のプロパティでは、行が1つも返りません。
  • 検索語のフィルタと一緒に使えない。 BRANDED_CLASSIFICATION で分ける・絞る問い合わせに、QUERY のフィルタを同じリクエストで組み合わせることはできません。フィルタの演算子は「一致」(EQUALS)だけです。

判定は正規表現ではなく、Googleの「AIの支援を受けた社内のしくみ」で行われると、2025年11月の画面の機能の発表に書かれています。社名のあらゆる言語での表記、打ち間違い、社名を含まなくてもそのサイト独自の商品やサービスを指す検索語も指名検索に含み、ときどき判定を誤ることもあるとされています。自社で正規表現を使って分けていた数字とは一致しない前提で、切り替える月に両方を並べて差を確かめます。

国・端末をまとめて指定する

これまでのフィルタ(filters)は、1つの条件に1つの値しか書けません。しかもグループの中の条件のつなぎ方(groupType)に指定できるのは AND だけです(リファレンスでは「or」は「まだ対応していない」とされています)。「日本か米国」の数字が欲しいときは、国ごとに問い合わせて足し合わせる、といった工夫が必要でした。filterLists を使うと、1つの切り口に値の一覧を渡し、どれかに完全一致する行をまとめて取れます。

"dimensionFilterGroups": [{
  "filterLists": [{
    "dimension": "COUNTRY",
    "expressions": ["jpn", "usa"]
  }]
}]

国は3文字の国コード(ISO 3166-1 alpha-3)、端末は DESKTOP・MOBILE・TABLET です。filterLists は COUNTRY と DEVICE だけで使え、検索語やページには使えません。同じ切り口(たとえば国)を、1つのリクエストの中で filters と filterLists の両方に書くこともできません。フィルタのグループどうしはこれまでどおりANDで組み合わさるため、「指名検索以外」かつ「日本か米国」のような条件も書けます。発表も、これらのフィルタは組み合わせて使えると説明しています。

WEB_MULTIMODAL は画像を使った検索

検索の種類(type)に WEB_MULTIMODAL が加わりました。リファレンスの説明は「Google レンズ、Androidの『かこって検索』、Google検索への画像のアップロードからの検索結果」です。Search Consoleの画面では、2026年9月24日の発表で同じ種類の数字が見られるようになっていました(画面の機能の発表とヘルプには、Chromeの画像検索も含むと書かれています)。発表によると、BigQueryへの一括データエクスポートを使っているプロパティでは、エクスポートにもこのデータが入ります。既存の WEB(「すべて」のタブ)の数字とどう重なるか・分かれるかは、資料からは読み取れませんでした。画像で探される検索についてはマルチモーダル検索の記事で扱いました。

レポートを作り直すときの順番(編集部の提案)

  1. 対象のプロパティかを確かめる。 最上位のプロパティで BRANDED_CLASSIFICATION を集計し、行が返るかを見ます。返らなければ、これまでの作り方を続けます。
  2. いまの作り方を残す。 社名・商品名の正規表現で分けている場合は、その式と出力を切り替え前の月の分だけ保存します。検索語のフィルタとは同じリクエストで組み合わせられないため、正規表現の集計は別のリクエストのまま残します。
  3. 同じ期間で並べる。 2026年2月21日以降の同じ月を BRANDED_CLASSIFICATION でも集計し、指名検索の表示回数・クリック数の差を確かめます。差が大きい検索語は、上の2つ目の例の dimensions に QUERY を足して調べます(リファレンスが禁じているのは検索語のフィルタとの組み合わせです。検索語で分ける集計が通るかは、呼び出しでは確かめていません)。
  4. 報告の言葉を決める。 「指名検索以外の表示回数」を新しい定点の数字にするなら、どこから基準が変わったかをレポートに書いておきます。
  5. 国・端末の問い合わせをまとめる。 国や端末ごとに分けて問い合わせ、足し合わせていた処理は、filterLists で1回にまとめられます。まとめた後の合計が、足し合わせた数字と合うかを確かめます。

Search Consoleで測れる範囲が広がった例としてはソーシャルの投稿の記事も参考になります。

確かめていないこと

  • 実際の呼び出し。検証用のSearch Consoleのプロパティでの呼び出しは行っていません。値を大文字・小文字のどちらで送っても通るか、BRANDED_CLASSIFICATION と QUERY を一緒に集計できるかも確かめていません。
  • APIで分けた数字と、Search Consoleの画面の指名検索の絞り込みの数字が一致するか。

2026年11月18日に、Search Console APIのDiscovery文書(searchconsole.googleapis.com、revision 20261116)と、googleapis/google-api-nodejs-clientの変更(コミット 03c13e6、2026年11月17日)を確認しました。11月20日に、Search Centralのブログの発表(2026年11月16日)、Search Analytics APIのリファレンス(最終更新 2026-11-16)、指名検索の絞り込みとWeb マルチモーダルの画面の機能の発表、Search Consoleのヘルプ、Discovery文書(revision 20261118)を確認しました(資料調査)。APIの呼び出しは行っていません。

Search Consoleのデータを使ったレポートの自動化や、検索からの集客の見直しは、グリームハブにご相談いただけます。お問い合わせからご連絡ください。

参考資料

この記事を共有XFacebook
鈴木 翔

技術の可能性に魅了され、学生時代からプログラミングとデジタルアートの分野に深い関心を持つ

この記事のテーマを、自社の次の一歩へ

Webサイトで、実現したいことから。

使う人の目的、必要な機能、更新の体制を整理し、制作・改善で最初に取り組むことを考えます。

  • サイトの目的
  • 機能と使いやすさ
  • 公開後の運用
Web制作・改善を相談する

構想段階からご相談いただけます。この記事の情報を相談フォームに引き継ぎます。

最新記事をメールで受け取る・Web制作ガイドを読む
無料ダウンロード

Web制作 費用・発注・集客 完全ガイド【2026年版】

費用相場・制作会社の選び方・集客戦略をPDFにまとめました。

The PDF and newsletter emails are currently in Japanese.

メルマガにも登録されます。いつでも解除可能です。