Search Analytics APIに、ブランド クエリの分類・Googleレンズなどの検索・複数の国や端末の一括指定が加わった。画面にあった機能がプログラムからも使える ── 自社の報告を作り直す前に確かめる13項目(2026年11月時点)
Search Analytics APIに、ブランド クエリの分類・Googleレンズなどの検索・複数の国や端末の一括指定が加わった。画面にあった機能がプログラムからも使える ── 自社の報告を作り直す前に確かめる13項目(2026年11月時点)
目次
- 01 何が公開されたか — Search Analytics APIに、ブランド クエリの分類・Lensなどの検索・複数の国や端末の一括指定が加わった
- 02 なぜ・背景 — 画面にあった機能が、プログラムからも使えるようになった
- 03 用語 — 発表に出てくる言葉を、先に分けておく
- 04 型別 — 適用範囲、書かれていないこと、確かめる手順
- 05 明日、担当サイトで確認できること
- 06 代替・他の選択肢 — 画面、API、一括エクスポート、連携部品は、取れる範囲が違う
- 07 当サイトで確かめたこと — この記事の時点では、確かめていない
- 08 このテーマの、ここまで — 「Search Consoleの数字を、どう読み、どう取るか」を、当サイトが扱ってきた記録
- 09 この記事のまとめ
01 何が公開されたか — Search Analytics APIに、ブランド クエリの分類・Lensなどの検索・複数の国や端末の一括指定が加わった
出典について
この記事は、2026年11月17日に開いて読んだ次のページの内容を書いている。Google Search CentralブログのSearch Analytics APIの更新の発表(表示された日付は2026年11月16日)、Search Console APIのクエリの説明ページ、ブランド クエリのフィルタの発表、Search Consoleヘルプのブランド クエリの説明と検索パフォーマンスの説明、APIの利用上限の説明、すべてのデータを取る方法の説明、BigQueryへの一括エクスポートの説明である。英語の原文はこの記事では引用せず、読んだ内容を日本語でまとめた。読んだページに書かれていなかったことは、書かれていなかったと書き、この記事では確かめていない。
発表の中身
Googleは2026年11月16日の日付で、Search Console の成果レポートにあった3つの機能を、Search Analytics API でも使えるようにしたと、Search Centralブログに書いた。書き手はSearch Consoleのチームの3人である。Search Analytics APIは、Search Consoleの検索パフォーマンスのデータを、画面ではなくプログラムで取り出すための窓口で、自社の報告の表や、Looker Studio、スプレッドシートなどに数字を流し込む仕事の元になることがある。ブログは、この窓口に、ブランド クエリの分類、ウェブのマルチモーダル検索、複数の国や端末の一括指定の3つが加わったと書いている。
ブログが挙げる使い道は、大きな報告の自動化、ブランドの検索語を細かい正規表現で並べていた作業をブランドか否かの分類に置き換えること、マルチモーダルの数字を自社のダッシュボードに流すこと、地域をまとめた見方(ブログの例では、EMEAやLATAM、DACHのような括り)で絞り込むことである。どれも、新しい検索の数字が増えるというより、数字の取り出し方が増える、という種類の更新だと読める。
3つの選択肢
1つ目は、ブランド クエリの分類である。API では、brandedClassification という項目で、データを分けたり絞ったりできる。ブランドの検索と、そうでない検索を、同じ期間で比べるためのものだ。ブログは、これが使えるのは対象になるプロパティだけで、それ以外のプロパティでは、応答に行が返らない、と書いている。
2つ目は、検索の種類(type)に webMultimodal を指定する方法である。ブログは、Google レンズ、Android の「かこって検索」(Circle to Search)、Google 検索での画像のアップロードによる検索の成績が返ると書く。一括エクスポートを有効にしているプロパティでは、同じデータが BigQuery にも出ると書いている。
3つ目は、filterLists という項目で、複数の国や端末を、1回の問い合わせで指定できることである。国ごと、端末ごとに問い合わせを分けて、後でまとめる作り方をしている報告では、その手間を減らせる更新である。ただし、この部分は、手作業でやっていた集計の結果と、新しい方法の結果が同じになるかを、自分で確かめてから乗り換えるのがよい。
発表が書いていないこと
ブログには、問い合わせの具体例(リクエストの書き方)と、filterListsの書式の細かい説明、指定できる値の一覧は載っていない。詳しくは API の説明ページを見る、という形である。そのため、この記事では、書き方の説明を、ブログではなく、説明ページから拾った。説明ページに書かれている範囲だけを書き、書かれていない動きは、書かれていないと書く。
02 なぜ・背景 — 画面にあった機能が、プログラムからも使えるようになった
画面に先にあった3つ
ブログは、この3つが、先にSearch Consoleの成果レポート(画面)に加わっていたと書く。そのうちブランド クエリのフィルタは、Googleが2025年11月20日の日付で発表したものである。発表のページには、2026年3月11日付けで、対象になる全てのサイトに広がったという追記がある。つまり、画面での提供が先に始まり、約1年後に、API が追いついた形になる。
検索の種類としてのウェブのマルチモーダルは、検索パフォーマンスの説明ページに、すでに書かれていた。説明ページは、利用者がスマートフォンのカメラなどで画像を使って検索したときの検索流入を含む種類だと説明している。画面で見られた数字が、プログラムでも取れるようになった、というのが、今回の更新の一言の説明になる。
ブランド クエリの分類は、キーワードの一致で決まるのではない
ブランド クエリのフィルタの発表は、分類が、キーワードの一致ではなく、Googleの内部の、AIを使った仕組みで決まる、と書いている。ブランド名は、あらゆる言語で、つづりの誤りも含めて認識される、と書く。さらに、ブランド名を含まなくても、そのサイトに固有の商品やサービスを指す検索語は、ブランドとして扱われることがある、とも書いている。ヘルプの説明ページは、ブランド クエリを、ブランド名、ドメイン、ブランド固有の商品やサービスを含む検索語と書き、よくあるつづりの誤りや言い換えも含むと書いている。
実務のヒント
これまで正規表現で「ブランド名を含む検索語」を数えていた報告は、新しい分類と、数字が一致しなくて当たり前である。理由は、分類の作り方が違うからだ。新しい分類は、固有の商品名だけの検索語も、つづりの誤りも、拾うことがある。逆に、自社の正規表現には入っていても、Googleがブランドとは見なさない検索語もありうる。乗り換えの前に、同じ1週間を両方の方法で数え、差を表にしておく。
なぜ、自社の報告を作り直す前に確かめるのか
新しい選択肢が加わると、報告を作り直したくなる。だが、作り直す前に確かめることが、いくつかある。1つは、自社のプロパティが、ブランド分類の対象かどうかである。対象でなければ、行が返らないので、報告の表が空になる。もう1つは、既存の取得の仕組みが、新しい項目を足したときに、行が0のまま、エラーも出さず通り過ぎないかである。3つ目は、複数の国を1回で指定した結果が、国ごとに分けて足した結果と、同じ数字になるかである。この記事の05は、この3つを軸に、13項目にまとめた。
03 用語 — 発表に出てくる言葉を、先に分けておく
この記事で使う9つの言葉
表は、読んだページの説明を、筆者が整理したものである。ページによって使い方が違う言葉は、右の列で、どのページかを分けた。
| 言葉 | 読んだページが書く意味 | 読んだページ |
|---|---|---|
| Search Analytics API | 検索パフォーマンスのデータを、プログラムから取り出す窓口 | APIの説明ページ |
| brandedClassification | ブランドの検索語と、そうでない検索語を分ける項目。絞り込みの値は、BRANDEDとNON_BRANDEDの2つ。絞り込みで使えるのは「等しい」だけで、検索語の絞り込みとは組み合わせられない | APIの説明ページ |
| ブランド クエリ | ブランド名、ドメイン、ブランド固有の商品やサービスを含む検索語。よくあるつづりの誤りや言い換えも含む | Search Consoleヘルプ |
| webMultimodal | 検索の種類(type)の値。Googleレンズ、かこって検索、画像のアップロードによる検索を含む | ブログ、APIの説明ページ |
| filterLists | 1つの軸(国や端末)について、複数の値を並べて指定する項目。並べた値のどれかに等しい行が選ばれる | APIの説明ページ |
| プロパティ | Search Consoleで登録するサイトの単位。ドメインのもの、URLの先頭を指定するもの、サブドメインのものなどがある | ブランド クエリの発表 |
| 行(row) | APIの応答の1行。軸の組み合わせごとに、クリック数などが入る | APIの説明ページ |
| rowLimit | 1回の応答で受け取る行の最大数。1から25,000までで、既定は1,000 | APIの説明ページ |
| 一括エクスポート | Search Consoleのデータを、BigQueryに毎日出し続ける仕組み。期限を決めなければ、データは溜まり続ける | Search Consoleヘルプ |
「ブランドでない」は、「ブランド以外が全部」ではない
ブランド クエリのヘルプは、ブランドでない検索語を、ブランド名を含まない検索語と書き、より一般的な検索が多いと説明している。ここで注意したいのは、分類できない検索語や、データが足りない行が、どちらにも入らない場合があるかどうかは、読んだページに書かれていないことである。BRANDEDとNON_BRANDEDの合計が、全体の合計と一致するかは、自分のデータで確かめる項目として、05に入れた。
「type」と「検索の種類」
APIの説明ページでは、typeが、検索の種類を指定する項目である。値は、discover、googleNews、news、image、video、web、webMultimodalの7つが並び、既定はwebと書かれている。typeを省いた既存の問い合わせは、説明ページの書き方に従えば、webの数字を返す。画面でいう「ウェブ」の検索結果と、「ウェブ: マルチモーダル」は、別の種類として分かれている。画面の説明ページは、マルチモーダルを、画像を使って検索したときの検索流入を含むものとして書いている。2つの数字を足すのか、別々に見るのかは、読んだページには書かれていない。
用語
マルチモーダル検索は、文字だけでなく、画像や音声など、複数の形で検索すること。この記事で出てくるのは、画像を使う検索である。Googleレンズでカメラに写したものを検索する、スクリーンショットの一部を丸で囲んで検索する(かこって検索)、写真をアップロードして検索する、といった使い方が当たる。
04 型別 — 適用範囲、書かれていないこと、確かめる手順
適用範囲: 誰に関係する話か
関係するのは、Search Consoleのデータを、プログラムや連携部品で取り出して報告している人である。自社でスクリプトを持つ運用担当者、制作会社に報告の作成を頼んでいる発注側のディレクター、Looker Studioやスプレッドシートの連携で数字を見ている担当者が当たる。画面だけで数字を見ている人には、今回の更新は直接は関係しない。画面にはすでにあった機能だからである。ただし、画面で使えない自社のプロパティの種類(たとえばサブドメインのプロパティ)は、APIでも同じ制限を受けるはずだと考えておく。これはこの記事の読みで、ブログが明記している文ではない。
確かめていないこと
この記事は、次のことを確かめていない。ブランド分類の精度や、どの種類の検索語がどちらに入るか。マルチモーダルの数字が、実際にどのくらいの量になるか。複数の国を1回で指定した結果が、分けて集計した結果と同じ数字になること。Looker Studioやスプレッドシートの取り込みの部品が、新しい項目に対応しているかどうか。ブランド分類が使えない場合の、応答の細かい形。これらは、読んだページに、この記事が根拠にできる説明が見つからなかった。書かれていないことを、書かれていないまま持っておくのが、この記事の立場である。
手順: 報告を作り直す前に、確かめる順番
手順は、3つの段に分ける。1段目は、公式のページで、新しい項目の名前と制約を、書き写す。2段目は、自社のプロパティの種類と、既存の取得の仕組みを、書き出す。3段目は、新しい項目を足した問い合わせを、1日分だけ試し、行が返るか、合計が合うかを見る。報告そのものを作り直すのは、3段が終わってからにする。この順番は、公式が出したものではなく、この記事の筆者が、確かめやすさで並べたものである。
2段目で見る、プロパティの種類
ブランド クエリの発表は、対象を、トップレベルのプロパティに限り、URLの途中までを指定するプロパティとサブドメインのプロパティは対象外、と書いている。さらに、問い合わせや表示回数が十分な量のあるサイトだけが対象だと書く。ヘルプの説明ページも、サブプロパティと表示回数の少ないサイトでは使えない、と書いている。APIの説明ページは、brandedClassificationのデータが、2026年2月21日から使えること、トップレベルのプロパティで、十分な量があるものだけが対象であることを書いている。画面でフィルタが出ないプロパティは、APIでも行が返らない可能性が高い、と考えて確かめる。
05 明日、担当サイトで確認できること
このリストの使い方
このリストは、Search Consoleの画面、公式のページ、自社の取得の仕組み(スクリプトまたは連携部品の設定)を開いた状態で、上から順に進める。この13項目は、公式が出した確認項目ではなく、発表と説明ページの内容から筆者が選んだものである。画面や項目の名前は、時期や言語で違うことがあるので、近い名前のものに読み替える。チェックの状態は、ブラウザに保存され、サーバーには送られない。数を書く項目は、記録の表に書き写す。
13項目
- Search Centralブログの発表を開き、表示された日付と、新しい選択肢の名前を、記録の表に書き写す(3つあるかを数える)
- APIのクエリの説明ページを開き、軸の一覧にbrandedClassificationがあるかを、ある・ないで記録の表に書く
- 同じ説明ページで、typeの値にwebMultimodalがあるかを書き、typeを省いたときの既定の値を書き写す
- 同じ説明ページで、filterListsの説明を開き、同じ軸をfiltersとfilterListsの両方で指定できるかを、できる・できないで書く
- Search Consoleのプロパティの一覧を開き、APIで取っているプロパティの種類(ドメイン・URLの先頭を指定・サブドメイン)を、プロパティごとに書く(件数を数える)
- Search Consoleヘルプのブランド クエリの説明を開き、使えない条件を2つ、記録の表に書き写す
- 成果レポートを開き、ブランド クエリの絞り込みが画面に出るプロパティの数を数えて書く(0なら0と書く)
- 自社の取得スクリプトか連携部品の設定を開き、typeを指定しているかを、指定している値で書く(なければ「指定なし」と書く)
- 同じ設定で、応答の行が0だったときの動き(止まる・空のまま進む・エラーを出す)を、設定かコードを読んで、1つに決めて書く
- 新しい項目を足す前の設定で、直近1日分のクリック数の合計を取り、足した設定でも取り、同じか違うかを書く
- 既存の報告の元の表を開き、国や端末で絞る列の数を数えて書く(0なら0と書く)
- 取得の1回あたりのrowLimitと、1日分の取得行数の合計を書き、25,000行の上限に当たる日があるかを、ある・ないで書く
- ここまでの結果を、確かめた日付と一緒に記録の表にまとめ、報告を作り直すか、今のまま続けるかを、一言で書き、次に確かめる日を、1か月後の日付で書く
06 代替・他の選択肢 — 画面、API、一括エクスポート、連携部品は、取れる範囲が違う
取り出す方法を並べる
表は、読んだページの内容と、一般的な運用を、筆者が整理したものである。公式の文書に、どれを選ぶべきという記述は無い。
| 方法 | 取り出せる範囲 | 読んだページに書かれていること |
|---|---|---|
| 成果レポート(画面) | 画面の表と、そこからの書き出し | マルチモーダルの種類を持つ。最新のデータは暫定で、数時間で変わることがあると書く |
| Search Analytics API | 軸・種類・絞り込みを指定した行 | 1回の応答は最大25,000行。1日・1つの検索の種類あたり、クリック数の多い順に最大5万行が出る。ページと検索語で分けると、一部が落ちることがある |
| BigQueryへの一括エクスポート | プロパティのデータを毎日出し続ける | 期限を決めなければ、データは溜まり続ける。マルチモーダルは、有効なプロパティで出ると、今回のブログが書く |
| 連携部品(Looker Studioなど) | 部品が対応する範囲 | 新しい項目への対応は、この記事では確かめていない |
行の数の上限と、新しい項目の関係
すべてのデータを取る方法の説明ページは、Search Analyticsの方法が、1日につき1つの検索の種類あたり、最大5万行を、クリック数の多い順に出すと書いている。1回の応答の最大は25,000行で、続きを取るには、startRowを25,000ずつ増やして、同じ問い合わせをもう一度出す。ページや検索語で分けると、システムが一部のデータを落とすことがある、とも書く。正確な合計を取りたいときは、ページと検索語の軸を外す、と書いている。軸を増やすほど、行は細かく分かれ、上限に当たりやすくなる。新しい項目を足して、軸の数を増やす場合は、行の数の上限に当たらないかを、先に確かめる。
利用の上限
APIの利用上限の説明ページは、Search Analyticsの負荷の上限を、10分の短い期間と、1日の長い期間の2つで測ると書く。短い期間の上限を超えたら、15分待って再開し、問い合わせを1日の中に散らす。ページと検索語で分けた問い合わせは、負荷が最も大きく、期間が広いほど負荷が増える、とも書く。1秒あたりの問い合わせの上限は、サイトごと・利用者ごとに、1分あたり1,200回と書かれている。国や端末を分けて何度も問い合わせていた仕組みを、filterListsで1回にまとめると、問い合わせの回数は減ると考えられる。ただし、そうなるかは、この記事では確かめていない。
注意
この表の上限の数字は、2026年11月17日に読んだ説明ページに書かれていたもので、将来変わることがある。自社の取得の仕組みを作るときは、その時点の説明ページの数字を、記録の表に書き写して使う。
07 当サイトで確かめたこと — この記事の時点では、確かめていない
2026年11月17日の時点で確かめていないこと
この記事は、公式のページを2026年11月17日に読んで書いた。当サイトのSearch Consoleのプロパティで、ブランド クエリの絞り込みが出るか、APIでbrandedClassificationを指定したときに行が返るか、webMultimodalで行が返るか、複数の国を1回で指定した結果が分けた結果と同じになるかは、この記事を書いた時点では、確かめていない。05章の13項目も、当サイトで行ったかどうかは、確かめていない。当サイトの住所は、サブドメインの形をしている。ブランド クエリの発表は、サブドメインのプロパティを対象外と書くので、当サイトのプロパティでは、行が返らないかもしれない。これはこの記事の読みで、確かめたことではない。
これから確かめること
この記事を本番に出したあと、運営の担当者が、05章の3番目から9番目までと、12番目を、当サイトのプロパティで行い、結果を、この章の末尾に日付つきで追記する。ただし、画面の名前や、設定の中身、プロパティごとの結果の詳細は書かない。確かめられなかった項目は、確かめられなかったと書く。
実務のヒント
確かめた結果は、行が返った・返らなかったの2つに分けて、日付つきで記録に残す。返らなかったときの理由は、推測で埋めない。理由が分からないときは、理由は分からない、と書いておくと、数か月後に読み返したとき、確かめ直す出発点になる。
08 このテーマの、ここまで — 「Search Consoleの数字を、どう読み、どう取るか」を、当サイトが扱ってきた記録
数字の読み方についての記録
当サイトは、Search Consoleの数字の読み方を、何度か扱ってきた。Google の数字は 11 ヶ月、壊れていたは、Search Consoleのバグで、数字が長い期間おかしかったことを扱った。Search Console の通知 65 件のうち 33 件が未読だったは、通知の既読の管理を扱った。Search Consoleに「検索の生成AI」の設定が加わったは、画面に新しい設定が加わった日に、自分の画面を開いて確かめた記録である。Search Consoleが教えてくれることは、データを読む力そのものを扱った古い記事である。AIに表示された回数を知っているかは、複数の道具で同じ数字を見る難しさを書いた。
「0件」に、探した数を書いていなかったは、0件と書くときに、探した数も書く大切さを扱った。「0件」は安心ではない、「N件」は危険ではないは、0件が安心とは限らず、N件が危険とも限らないことを扱った。今回の更新で言えば、ブランド分類で行が0だったとき、それが「該当なし」なのか「対象外」なのかを、分けて書く必要がある。
当サイトのほかの記事との対応
画像から探された実績が、2つのレポートに別々の形で現れることは、画像から探された実績は、2つのレポートに別々の形で現れるが扱った。端末別に分けた見方は、第三者の調査では、CTRがデスクトップで下がりモバイルで上がったが、順位別のCTRの数字の違いは、検索順位別CTRは調査によって数字が違うが扱っている。Search Consoleと連携したGA4のレポートで、検索語を読むときの注意は、GA4の標準のレポートには自然検索の検索語の欄が見つからず、検索クエリはSearch Consoleと連携したレポートに現れる。少ない検索語はSearch Consoleに出ず、連携のレポートも同じデータを使うので同じと読めるが扱った。数字が約1年間、多く表示されていた不具合は、Search Consoleに重大エラー、インプレッションが約1年間も過大表示が、AIの成果レポートで見える範囲は、Search ConsoleのAIパフォーマンスレポート、結局どこまで見えるようになったのかが扱っている。
この記事の位置
この記事は、APIに加わった3つの選択肢、書かれていないこと、報告を作り直す前に確かめることを、混ぜずに分けるための記事である。ブランド分類の精度や、マルチモーダルの数字の大きさは、この記事では判断しない。確認の項目は、発表と説明ページから筆者が選んだもので、公式が確認項目として出したものではない。
2026年11月17日 — この記事の確認日
この記事の内容は、2026年11月17日に、ページを開いて読み、日本語でまとめた。ブログに表示された日付は、2026年11月16日である。次に確かめる日は、2026年12月17日を目安にする。
現在の貴方のIPアドレス
このサイトで書いている人
WEBサイト