Search Console の「検索パフォーマンス」を毎月手で書き出し、スプレッドシートに貼り、ブランド名を含む検索と含まない検索を正規表現で分けている。国別は上位3か国だけ、画像からの流入はそもそも見ていない。経営会議に出す数字を作る作業に、Web 担当者の半日が消えている。そんな会社向けの記事です。
Google は 2026年11月16日、Search Analytics API に3つの機能を追加しました。ブランド検索の分計(brandedClassification)、画像で探す検索の集計(type に webMultimodal)、複数の国・デバイスの一括フィルタ(filterLists)です。いずれも Search Console の画面では先に使えていたもので、API に来たことで「毎月のレポートを無人で作る」仕組みに組み込めるようになりました。
この記事では、Google の発表と API リファレンス、使用上限のページだけを根拠に、3つの機能の条件と落とし穴を整理します。そのうえで、月次レポートを Claude Code や Google Apps Script で自動化するときの手順、取得すべきリクエストの一覧、数字がずれる理由と検算の仕方、動かす前の点検表をまとめます。
結論 — 先に要点だけ
- 2026年11月16日の更新で、Search Analytics API に
brandedClassification(ブランド検索の分計)・webMultimodal(画像で探す検索)・filterLists(複数の国・デバイスの一括フィルタ)が入った。画面でしか見られなかった3つが、スクリプトから取れる。 - ブランド検索の分計は対象プロパティだけで使える。トップレベルのプロパティで、検索数と表示回数が十分なサイトが対象。対象外には行の無い応答が返り、
queryフィルタとは同時に使えない。 - 複数の国をまとめるのは
filterLists。従来のdimensionFilterGroupsはandしか使えないため、複数の値を並べると結果がゼロになる。countryとdeviceにしか使えない点も要注意。 - 月次レポートは「合計用の取得」と「内訳用の取得」を分ける。ページやクエリでグループ化すると行が落ちるので、合計はディメンション無しで取り、内訳は 25,000 行ずつページ送りする。
- 自動化の置き場は、読み取り専用スコープ・組織名義の認証・失敗の通知の3点を先に決める。Claude Code にスクリプトを書かせるなら、無人実行では許可する操作を絞り、出力は JSON で受け取る。
何が変わったか — 2026年11月16日の Search Analytics API 更新
Google 検索セントラルの Search Console チームは、開発者からの「独自レポートと自動化で使いたい」という要望に応える形で、検索パフォーマンス レポートの3つの機能を API に追加したと発表しました。
| 機能 | API での指定 | 画面での提供開始 | 主な条件 |
|---|---|---|---|
| ブランド検索の分計 | ディメンション/フィルタに brandedClassification(値は BRANDED と NON_BRANDED) | 2025年11月20日発表、2026年3月11日に対象サイト全体へ | 対象プロパティのみ。対象外は行の無い応答 |
| 画像で探す検索 | type に webMultimodal | 2026年9月24日から順次 | 一括エクスポートが有効なプロパティなら BigQuery でも取れる |
| 複数の国・デバイスの一括フィルタ | 新フィールド filterLists | 発表は LinkedIn の投稿 | 対応する値や組み合わせの規則はリファレンスで確認 |
※ 出典: Google 検索セントラル ブログ「New filtering and reporting capabilities in the Search Analytics API」(取得 2026-11)/同「Branded queries filter」(取得 2026-11)/同「Web multimodal in Search Console」(取得 2026-11)
発表文は「以前から Search Console では使えていた機能」と断っています。つまり新しいデータが増えたわけではなく、手作業で見ていたものをスクリプトに移せるようになった、という変更です。月次レポートの自動化を考えている会社にとっては、画面からの書き出しをやめる最後の理由が消えたことになります。
ブランド検索の分計 — brandedClassification の条件
ブランド検索(自社名で探された検索)と、それ以外の検索を分けるのは、SEO の成果を経営に説明するときの基本です。ブランド検索は広告や口コミの結果、非ブランド検索はコンテンツと技術の結果として読めるからです。
これまで API でこれをやるには、query に正規表現のフィルタを書き、ブランド名の表記ゆれを自分で列挙する必要がありました。新しい brandedClassification は Google 側の分類を使います。
| 項目 | 内容 |
|---|---|
| 分類の仕組み | Google 内部の AI を使った判定。全言語のブランド名、綴り間違い、ブランド名を含まないが自社固有の商品・サービスを指す検索も含む |
| 正規表現との違い | 「クエリでフィルタ」の正規表現・キーワード指定とは別物。一部の検索は誤分類されることがある |
| 対象プロパティ | トップレベルのプロパティだけ。https://example.com/path のようなパス指定や developers.google.com のようなサブドメインのプロパティは対象外 |
| 必要な規模 | 検索数と表示回数が十分にあるサイトだけ |
| データの開始日 | 2026年2月21日以降のデータで利用可 |
| 使えない組み合わせ | 同じリクエストで query フィルタと併用できない。演算子は equals だけ |
| 順位への影響 | 分類は Google 検索の順位に影響しない |
※ 出典: Google「Branded queries filter」Rollout and availability(取得 2026-11)/Search Console API リファレンス「Search Analytics: query」dimensionFilterGroups(取得 2026-11)
実務で最初に確かめるのは「自社のプロパティが対象か」です。Search Console の画面で検索パフォーマンスを開き、ブランドのフィルタが表示されるかを見ます。表示されない会社は、従来どおり query の正規表現でブランド名を分ける方法を続けることになります。
もう1点、プロパティの種類も関わります。ドメイン プロパティは www の有無や http/https、すべてのサブドメインを含みます。URL プレフィックス プロパティは指定したプレフィックスに一致する URL だけです。ブランド分計を使う前提なら、トップレベルのドメイン プロパティで運用しているかを確認してください。
※ 出典: Search Console ヘルプ「ドメイン プロパティと URL プレフィックス プロパティ」(取得 2026-11)
画像で探す検索 — type に webMultimodal
webMultimodal は、画像を入力にした検索の成果です。Google レンズ、Android の「かこって検索」、Google 検索への画像アップロード、Chrome の右クリック「この画像を検索」が含まれます。Search Console の画面では検索パフォーマンスの検索タイプに「multimodal」として入り、生成 AI 機能のレポートにも出ます。
検索タイプ(type の値) | 画面での表記(ヘルプの英語表記) | 何の成果か |
|---|---|---|
web(既定) | Web: text-based | 文字で入力された通常の検索 |
webMultimodal | Web: multimodal | 画像を入力にした検索(レンズ・かこって検索・画像アップロード) |
image | Image | 画像検索タブ |
video | Video | 動画検索 |
news | News | ニュース検索 |
discover / googleNews | — | Discover と Google ニュース(API のみの指定) |
※ 出典: Search Console API リファレンス「Search Analytics: query」type(取得 2026-11)/Search Console ヘルプ「検索パフォーマンス レポート」(取得 2026-11)/Google「Web multimodal in Search Console」(取得 2026-11)
数字が出るのは、この種類の検索から訪問があるサイトだけです。商品写真・店舗の外観・図版が多いサイト(EC、飲食、製造業の部品カタログなど)では意味のある列になります。文章中心の BtoB サイトでは空になることが多いので、月次レポートでは「ゼロでも列を残す」か「ゼロの月は省く」かを先に決めておきます。
Google の発表には、webMultimodal のデータは一括エクスポートが有効なプロパティなら BigQuery でも取れる、とあります。すでに BigQuery に流している会社は、API を叩かずに既存のテーブルで確かめられます。
複数の国・デバイスを一度に — filterLists
地域をまとめて見たい(EMEA・LATAM・DACH のような括り)、あるいは「モバイルとタブレットを合わせて見たい」という要望は多いのに、従来の API では1回のリクエストで表せませんでした。理由は dimensionFilterGroups の仕様にあります。
| 指定方法 | 使えるディメンション | 複数値の扱い | 注意点 |
|---|---|---|---|
dimensionFilterGroups[].filters[] | country・device・page・query・searchAppearance・brandedClassification | groupType は and のみ(or は未対応)。複数の国を並べると「すべてに一致」になり行が返らない | 演算子は contains equals notContains notEquals includingRegex excludingRegex(RE2 構文)。式は最大 4,096 文字 |
filterLists[](新) | country と device だけ | expressions[] に完全一致の値を列挙。1つでも一致すれば対象 | 同じディメンションを filters と filterLists の両方で指定できない |
※ 出典: Search Console API リファレンス「Search Analytics: query」dimensionFilterGroups / filterLists(取得 2026-11)
国コードは ISO 3166-1 alpha-3(日本は jpn)、デバイスは DESKTOP・MOBILE・TABLET です。月次レポートで「日本国内」と「海外合計」を分けるなら、国内は filters で country equals jpn、海外は filterLists に対象国を列挙する、という2回の取得になります。
API を使う前提 — 権限・スコープ・上限
スクリプトを書く前に、3つの前提を揃えます。どれも Web 担当者だけで決めず、情報システム部門と合わせて決める項目です。
認可の方式: Search Console API の認可は OAuth 2.0 だけで、他のプロトコルは使えません。スコープは読み書きの https://www.googleapis.com/auth/webmasters と、読み取り専用の https://www.googleapis.com/auth/webmasters.readonly の2つです。レポート作成に書き込みは不要なので、読み取り専用スコープで作るのが原則です。
※ 出典: Search Console API「Authorizing requests」(取得 2026-11)
プロパティへの権限: API で読めるのは、認可した Google アカウントが Search Console でアクセスできるプロパティです。権限は所有者・フル ユーザー・制限付きユーザー・関連付けの4段階で、制限付きユーザーでも検索パフォーマンスの閲覧はできます。ユーザーの追加は所有者だけが行え、「設定」の「ユーザーと権限」から Google アカウントのメールアドレスを指定します。メーリング グループは追加できません。レポート取得専用のアカウントは、制限付きユーザーで足ります。
※ 出典: Search Console ヘルプ「所有者、ユーザー、権限の管理」(取得 2026-11)
使用上限: 上限は2系統あります。1つは「負荷の割り当て」で、クエリが消費する内部リソースを10分の窓と1日の窓で測ります。もう1つは回数の上限です。
| 対象 | 上限 |
|---|---|
| 同じサイトへの Search Analytics 呼び出し | 1,200 QPM(1分あたり) |
| 同じユーザーからの呼び出し | 1,200 QPM |
| 同じ Google Cloud プロジェクト(API キー)からの呼び出し | 30,000,000 QPD(1日あたり)・40,000 QPM |
| 上限超過時の応答 | すべて同じ「quota exceeded」エラー(error_quotaExceeded) |
※ 出典: Search Console API「Usage Limits」(取得 2026-11)
月次レポートの取得は多くても数十回です。回数の上限に当たることはまずありません。当たるのは「負荷の割り当て」のほうで、長い期間をクエリとページでグループ化して一度に取ろうとしたときです。次の節の設計が、この負荷を避けるためのものです。
月次レポートの設計 — 何を毎月取るか
Google の「全データを取る方法」の案内は、月次レポートの設計指針としてそのまま使えます。要点は4つです。
| 指針 | 理由 |
|---|---|
合計を出す取得は page と query を含めない | ページやクエリでグループ化すると、妥当な時間で計算するために一部の行が落ちる |
1日分ずつ取り、startRow を 25,000 ずつ増やして行数 0 まで繰り返す | 1リクエストの最大行数は 25,000。検索タイプごとに1日 50,000 行までしか出ない |
| 検索タイプごとに別のリクエストにする | type は1つしか指定できない |
| 取得は 2〜3日前までのデータにする | データは通常 2〜3日遅れて確定する。dataState を省くと確定データだけ返る |
※ 出典: Search Console API「Querying all your search traffic」(取得 2026-11)/Search Console API リファレンス「Search Analytics: query」rowLimit / dataState(取得 2026-11)
この指針に沿って、月次レポートで毎月取るリクエストを一覧にします。会社の規模に関わらず、この6本があれば経営向けの1ページは組めます。
| # | 目的 | type | dimensions | フィルタ | 備考 |
|---|---|---|---|---|---|
| 1 | 月の合計(クリック・表示・CTR・順位) | web | date | なし | 日別の行を月で足す。page を入れない |
| 2 | ブランド/非ブランドの分計 | web | date, brandedClassification | なし | 対象外プロパティは行が無い。空なら #2b に切り替え |
| 2b | (代替)ブランド分計を正規表現で | web | date | query includingRegex にブランド名の表記ゆれ | 対象外プロパティ用。2回取る(含む/含まない) |
| 3 | 国内と海外 | web | date | 国内は country equals jpn、海外は filterLists に対象国 | 海外を1本で取れるのが今回の更新 |
| 4 | デバイス別 | web | date, device | なし | filterLists でモバイル+タブレットを束ねることも可 |
| 5 | 画像で探す検索 | webMultimodal | date | なし | 空の月が多い。列の扱いを先に決める |
| 6 | 上位ページの内訳 | web | page | なし | aggregationType を byPage。25,000 行ずつページ送り |
※ 出典: Search Console API リファレンス「Search Analytics: query」(取得 2026-11)/Google「New filtering and reporting capabilities in the Search Analytics API」(取得 2026-11)
#3 のリクエスト本文は次の形です。海外を1本にまとめる部分が filterLists です。
{
"startDate": "2026-10-01",
"endDate": "2026-10-31",
"type": "web",
"dimensions": ["date"],
"filterLists": [
{ "dimension": "country", "expressions": ["usa", "gbr", "deu", "fra", "sgp"] }
],
"rowLimit": 25000,
"startRow": 0
}
#2 のブランド分計は dimensions に brandedClassification を加えるだけです。query フィルタと同時に指定できない点、equals 以外の演算子が使えない点を忘れないでください。
{
"startDate": "2026-10-01",
"endDate": "2026-10-31",
"type": "web",
"dimensions": ["date", "brandedClassification"],
"rowLimit": 25000
}
応答の各行は keys(指定したディメンションの値が指定順に入る)と clicks・impressions・ctr・position です。ctr は 0 から 1.0 の小数で返るので、レポートでは 100 を掛けて百分率にします。行はクリック数の多い順、date でグループ化したときは日付の昇順です。
※ 出典: Search Console API リファレンス「Search Analytics: query」Response(取得 2026-11)
手順 — Claude Code にスクリプトを書かせ、定期実行する
ここからは、上の6本の取得を無人で回す手順です。コードを書く作業は Claude Code に任せ、人は仕様と確認の線を握るという分担にします。
ステップ1: 名義と権限を決める(人)
Google Cloud のプロジェクトは個人ではなく部署の管理下に作り、Search Console API を有効にします。レポート取得用の認可は読み取り専用スコープにし、Search Console 側では制限付きユーザーとして追加します。担当者が退職しても止まらない名義の考え方は、退職しても止まらない自動化の作り方に整理しています。
ステップ2: 仕様書を1枚書く(人)
上の表の6本のリクエスト、保存先(スプレッドシートか CSV か)、実行日(毎月3日など、確定データが揃う日)、失敗時の通知先を書きます。この1枚が Claude Code への指示そのものになります。曖昧なまま「月次レポートを自動化して」と頼むと、page と query を同時に含めた1本のリクエストで全部を取ろうとする実装になりがちです。
ステップ3: スクリプトを書かせる(Claude Code・対話)
仕様書を渡し、取得・ページ送り・集計・保存の4段に分けたスクリプトを書かせます。ページ送りは「startRow を 25,000 ずつ増やし、行数 0 で止める」と明示します。上限超過(quota exceeded)時は再試行ではなく停止して通知する、という方針も指示に含めます。
ステップ4: ひと月分で検算する(人)
Search Console の画面で同じ期間・同じ検索タイプの合計を見て、#1 の日別合計と突き合わせます。合計が合えば、内訳(#6)の合計が画面と違っていても異常ではありません(理由は次の節)。
ステップ5: 無人で動かす(Claude Code・非対話)
定期実行は OS のスケジューラや CI から claude -p で呼びます。スクリプト化した呼び出しには --bare が推奨されており、フック・スキル・プラグイン・MCP サーバー・自動メモリ・CLAUDE.md の自動読み込みを飛ばして起動します。無人実行では、許可する操作を --allowedTools で絞り、承認が必要な操作は --permission-mode dontAsk で拒否し、--permission-prompts none で「誰も答えない」ことを Claude に伝えます。
claude --bare -p "仕様書 docs/monthly-sc-report.md に従って scripts/sc_report.py を実行し、結果の要約を返す" \
--allowedTools "Read,Bash(python3 scripts/sc_report.py *)" \
--permission-mode dontAsk \
--permission-prompts none \
--output-format json
--output-format json にすると、応答に結果本文・セッション ID・費用の見積もり(total_cost_usd)が入り、終了コードは成功で 0、失敗で 0 以外になります。スケジューラ側はこの終了コードと JSON を見て、失敗を通知します。費用の値はクライアント側の見積もりで、実際の請求と異なることがあります。
定期実行の組み方そのものはClaude Code を決まった時刻に動かすに、止まったときの検知は自動化が止まっていないか確かめるに詳しく書いています。社内でこの手順を自分たちで組み、止め方まで決める進め方は、企業向けの有料の実務書にもまとめています。
Apps Script で組む場合 — 上限と名義
スプレッドシートに直接書きたい会社では、Google Apps Script から UrlFetchApp で API を呼ぶ構成も選べます。Claude Code にコードを書かせる分担は同じで、違うのは実行環境の上限と名義です。
| 項目 | 個人アカウント(gmail.com) | Google Workspace アカウント |
|---|---|---|
| URL Fetch の呼び出し | 20,000 回/日 | 100,000 回/日 |
| 1回の実行時間 | 6分 | 6分 |
| トリガーの合計実行時間 | 90分/日 | 6時間/日 |
| MailApp の送信先 | 100 件/日 | 1,500 件/日 |
※ 出典: Google「Quotas for Google Services」(取得 2026-11)
月次レポートの取得は数十回なので回数は問題になりませんが、1回の実行は6分で切られます。#6 の上位ページを 25,000 行ずつ何ページも取る処理は、1回の実行に詰め込まず、日付や検索タイプごとに実行を分けるか、途中経過をスプレッドシートに書いて続きから再開する作りにします。
名義も注意点です。インストール可能なトリガーは作成した人のアカウントで動きます。時間主導のトリガーは「午前9時」と指定しても9時から10時の間のどこかで動き、日によってその時刻は固定されます。担当者個人のアカウントでトリガーを作ると、退職時に止まります。部署用のアカウントで作り直す運用は、問い合わせメールの一次仕分けを Apps Script と Claude で自動化にも書いた考え方と同じです。
※ 出典: Google「Installable Triggers」(取得 2026-11)
数字がずれる理由と検算の手順
自動化した直後に必ず起きるのが「画面の数字と合わない」です。原因の多くは異常ではなく、集計単位の違いです。
集計単位が2種類ある: Search Console の画面では、クエリ・国・デバイス・日付はプロパティ単位、ページと検索での見え方はページ単位で集計されます。グラフの合計と表の合計が一致しないのはこのためです。API でも同じで、page でグループ化すると aggregationType が byPage になり、表示回数・クリック・順位・CTR の計算が変わります。
行が落ちる: page や query を含めると一部の行が落ちます。内訳の合計が合計行より小さいのは仕様です。
確定していない: 直近のデータは暫定で、数時間のうちに変わります。画面ではグラフの点線で示されます。API で dataState に all を指定すると暫定データが入り、応答の metadata に first_incomplete_date が返ります。月次レポートは dataState を省いて確定データだけにします。
※ 出典: Search Console ヘルプ「検索パフォーマンス レポート」(取得 2026-11)/Search Console API リファレンス「Search Analytics: query」aggregationType / dataState / metadata(取得 2026-11)
検算は次の順で行います。
- #1(
dateだけ)の月合計を、画面の同じ期間・検索タイプ「Web: text-based」(文字入力の検索)の合計と比べる。ここが合わなければ期間・検索タイプ・プロパティのどれかが違う。 - #2 のブランド+非ブランドの合計が #1 と一致するか見る。一致しなければ対象外プロパティの可能性が高く、行が空のはず。
- #3 の国内+海外が #1 より小さいのは正常。
filterListsに入れていない国の分が差になる。 - #6 のページ別合計が #1 より小さいのは正常。行の脱落と集計単位の違い。
- 月初に取った前月末の数日が、翌月の取得で変わっていないか、翌月に1回だけ再取得して比べる。
GA4 との差は別の話です。Search Console のクリックと GA4 のセッションが合わない理由は、Google 検索の流入を GA4・ログで見分けるで8つに整理しています。
BigQuery の一括エクスポートに移すべき会社
API のページ送りで追いつかない規模のサイトには、Search Console の一括データ エクスポート(BigQuery へ継続的に出力)があります。webMultimodal もこの経路で取れます。
| 項目 | 内容 |
|---|---|
| 設定に必要なもの | 請求が有効な Google Cloud プロジェクト、BigQuery API と BigQuery Storage API の有効化、データセット(ID は searchconsole で始める。複数プロパティは別データセット) |
| 権限 | Google 側のエクスポート用サービス アカウントに、プロジェクトの BigQuery ジョブユーザーと、BigQuery データ編集者のロールを付与 |
| 初回 | 設定から最大 48時間以内に初回エクスポートが走り、その日のデータを含む |
| 保持 | 期限を設定しなければ無期限に蓄積。パーティションの有効期限は 14日以上 |
| 費用 | 保存とクエリに BigQuery の料金。無料枠を超えた分が課金 |
| 制約 | テーブルのスキーマを変える(列を足す等)とエクスポートが失敗する。データセットの場所は後から変えにくい。設定前の過去データは含まれない(過去分は API かレポートで) |
※ 出典: Search Console ヘルプ「一括データ エクスポートの設定」(取得 2026-11)/Google「New filtering and reporting capabilities in the Search Analytics API」(取得 2026-11)
移す判断の目安は「#6 の上位ページ取得が検索タイプごとに1日 50,000 行の上限に当たる」「クエリ単位の全件が毎月必要」「すでに BigQuery を使う分析チームがいる」のどれかです。小規模なサイトでは API で十分で、BigQuery の運用コストのほうが重くなります。
セルフチェックリスト — 自動化を動かす前の12項目
印刷して、情報システム部門と Web 担当で一緒に埋めてください。
- プロパティはトップレベルのドメイン プロパティか(ブランド分計の前提)
- Search Console の画面でブランドのフィルタが表示されるか(対象プロパティか)
- Google Cloud プロジェクトは部署の管理下にあり、個人の所有になっていないか
- 認可のスコープは読み取り専用(
webmasters.readonly)か - 取得用アカウントの Search Console 権限は「制限付きユーザー」か
- 取得日は確定データが揃う日(月初から 2〜3日以上あと)か
- 合計用の取得に
page・queryを含めていないか - 複数の国の指定に
filterListsを使い、dimensionFilterGroupsに並べていないか -
brandedClassificationとqueryフィルタを同じリクエストで使っていないか - ページ送りは
startRowを 25,000 ずつ増やし、行数 0 で止める作りか -
quota exceededが出たら停止して通知する作りか(無限再試行になっていないか) - 無人実行の許可操作は
--allowedToolsで絞り、承認待ちは拒否する設定か
※ 出典: Search Console API リファレンス「Search Analytics: query」(取得 2026-11)/Search Console API「Querying all your search traffic」(取得 2026-11)/Claude Code「Run Claude Code programmatically」(取得 2026-11)
失敗パターン5つ
- 複数の国を
dimensionFilterGroupsに並べて結果がゼロ:groupTypeはandだけなので、「アメリカかつイギリス」に一致する行は無い。filterListsに移す。 - ブランド分計が空なのをバグと思い込む: 対象外のプロパティには行の無い応答が返る仕様。URL プレフィックスやサブドメインのプロパティは対象外。正規表現の代替(#2b)に切り替える。
pageとqueryを同時に入れた1本で全部を取り、合計が画面と合わない: 行が落ちるうえ集計単位も変わる。合計用と内訳用を分ける。- 月初1日に前月分を取り、月末の数日が暫定値のまま確定レポートになる: データは通常 2〜3日遅れる。取得日を後ろにずらし、翌月に再取得して差を確かめる。
- 担当者個人のアカウントで認可・トリガーを作り、退職で止まる: Apps Script のトリガーは作成者のアカウントで動く。部署名義で作り直す。
※ 出典: Search Console API リファレンス「Search Analytics: query」(取得 2026-11)/Search Console API「Querying all your search traffic」(取得 2026-11)/Google「Installable Triggers」(取得 2026-11)
公式ドキュメント集
| 資料 | 用途 |
|---|---|
| New filtering and reporting capabilities in the Search Analytics API | 2026年11月16日の発表本文 |
| Search Analytics: query リファレンス | すべてのパラメータと応答の仕様 |
| Querying all your search traffic | ページ送り・行の上限・取得の指針 |
| Usage Limits | 回数と負荷の上限 |
| Authorizing requests | OAuth 2.0 とスコープ |
| Branded queries filter | ブランド分計の仕組みと対象 |
| Web multimodal in Search Console | 画像で探す検索の範囲 |
| 所有者、ユーザー、権限の管理 | 取得用アカウントの権限 |
| 一括データ エクスポートの設定 | BigQuery へ移す条件 |
| Run Claude Code programmatically | claude -p の無人実行 |
| Quotas for Google Services | Apps Script の上限 |
よくある質問
Q. brandedClassification を指定したのに、行が1つも返ってきません。設定ミスですか?
設定ミスとは限りません。Google の発表は、ブランド検索の分計は対象となるプロパティだけで使え、対象外のプロパティには行の無い応答が返ると明記しています。対象はトップレベルのプロパティ(パス指定やサブドメインのプロパティは対象外)で、かつ検索数と表示回数が十分にあるサイトです。まず Search Console の画面でブランドのフィルタが出るかを確かめてください。
※ 出典: Google「New filtering and reporting capabilities in the Search Analytics API」(取得 2026-11)
Q. 画像で探す検索(webMultimodal)のデータは、画像検索(image)と何が違いますか?
webMultimodal は Google レンズ、Android の「かこって検索」、Google 検索への画像アップロードなど、画像を入力にした検索の成果です。従来の image は画像検索タブの成果で、別の検索タイプとして集計されます。月次レポートでは type を分けて2回取得し、別の列に置くのが安全です。
Q. 複数の国をまとめて見たいとき、filterLists と dimensionFilterGroups のどちらを使いますか?
複数の値の一致には filterLists を使います。dimensionFilterGroups の groupType は and だけが使え、or は未対応のため、1つのグループに複数の国を並べると全部に一致する行だけが返り、実質ゼロになります。filterLists は country と device にだけ使え、同じディメンションを filters と filterLists の両方で指定することはできません。
Q. API の数字と Search Console の画面の数字が合いません。どちらが正しいのですか?
どちらも正しく、集計の仕方が違います。クエリ・国・デバイス・日付はプロパティ単位、ページと検索での見え方はページ単位で集計されるため、合計がずれます。API でも page を含めるかどうかで同じことが起きます。合計を出す行は page と query を含めずに取り、内訳の行とは別に扱うのが基本です。
Q. 毎月の取得はどのくらいの頻度で API を叩けば十分ですか?
Google の案内は、1日分ずつ(startDate と endDate を同じ日にして)1日に1回取り、ページ送りは startRow を 25,000 ずつ増やして行数が 0 になるまで続ける方法です。データは通常 2〜3日遅れて確定するため、月初の数日は前月末の数日が未確定の場合があります。dataState を省くと確定データだけが返ります。
※ 出典: Search Console API「Querying all your search traffic」(取得 2026-11)
次の一歩
今日できるのは、Search Console の画面でブランドのフィルタが表示されるかを確かめ、上の12項目のチェックリストを情報システム部門と埋めることです。ブランド分計が使えるかどうかで、月次レポートの設計(#2 か #2b か)が決まります。
次に、6本のリクエストの仕様書を1枚にまとめ、Claude Code にひと月分の取得スクリプトを書かせて、画面の合計と突き合わせます。合計が合ってから無人実行に移してください。
「どの数字を経営に出すべきか」「ブランド分計をどう読むか」「レポートはできたが、非ブランド検索を増やす施策が決まらない」という段階なら、Tufe Company のSEO 対策とLLMO・AI 検索対策のページで提供範囲を確認のうえ、お問い合わせからご連絡ください。契約を前提にしない段階のご相談でも、現状のレポート項目を見たうえで、書面で整理してお返しします。自社サイトの AI 検索での見え方を先に確かめたい場合は、無料 LLMO チェックもあります。
更新履歴
- 2026-11-21: 初版公開