Google Search Console

Google Search Console はコネクタです。MeDo アプリを 1 つの Search Console アカウントに接続し、確認済みプロパティの一覧、検索パフォーマンスの参照、既知 URL の検査、確認後のサイトマップ一覧／送信を可能にします。アプリが見られるのは、接続したアカウントが見られる範囲だけです。

#作れるもの

• 検索パフォーマンスのダッシュボード。 オーナーの確認済みプロパティを一覧し、明示した期間のクリック、表示回数、CTR、平均掲載順位を表示します。
• URL 検査ツール。 既知の 1 ページがインデックスされているかを確認し、カバレッジ状態を表示します。
• サイトマップ監視。 送信済みフィードを一覧し、最終送信／ダウンロード時刻を読み、既存サイトマップを確認後に送信します。
• プロパティ登録（任意）。 オーナーが明示した URL-prefix プロパティを登録します。登録は所有権の確認ではなく、未確認の残りをこのコネクタから削除することはできません。

オーナーの実際の検索・カバレッジデータが必要なアプリに向いています。順位の編集、ドメイン確認、Indexing API のクライアントではありません。詳しくは制限をご覧ください。

#ビルド例

次のいずれかをプロンプト欄に貼り付けてください。最初の例が最小の出発点です。

Use @Google Search Console to build a private SEO dashboard that lists my verified properties and shows last week's clicks, impressions, CTR, and average position.

Use @Google Search Console to build a private URL inspection tool where I paste one page URL and see whether it is indexed.

Use @Google Search Console to build a sitemap monitor that lists submitted feeds for a chosen property and shows last submitted and downloaded times.

Use @Google Search Console to build a private sitemap tool that previews an existing feed path and submits it only after I confirm.

書き方で結果が変わります。「サイトオーナー向けの非公開 SEO ダッシュボード」と「サイトを一覧するページ」では、まったく別のアプリが生成されます。

#準備と接続

アプリが使う Search Console プロパティをすでに所有または管理できる Google アカウントが必要です。API キー、Google Cloud プロジェクト、課金設定は不要です。

1. サイドバーの Skills & Connectors（スキルとコネクタ） を開き、Google Search Console を検索します。
2. Google Search Console のカードを開き、Connect（接続） をクリックします。
3. Google アカウントにサインインし、MeDo が求めるアクセスを許可します。
4. ボタンが Connected（接続済み） に変われば成功です。アプリ側に何かを貼り付ける必要はありません。

接続前にビルドを始めると、MeDo が気づいて返信の下に Search Console の接続ボタンを出します。そちらでも接続できます。ボタンが出ない場合は、上記のコネクタカードを使ってください。

#アプリでの使い方

• アプリは作成者が接続した Search Console アカウントを使い、訪問者ごとの Google アカウントではありません。 プロパティや分析を見られる訪問者は、同じアカウントを見ます。これらのページはアプリ自身のサインインの後ろに置き、権限のある人だけに制限してください。「private」というタイトルだけではアクセス制御になりません。
• プロパティ URL は接続アカウントからそのままコピーします。 Search Console が返す siteUrl を使い、sc-domain: や URL-prefix を手で組み立てないでください。
• 分析には明示した期間が必要です。 開始日と終了日は YYYY-MM-DD です。空行はその期間に表示がなかったことを意味し、URL が未インデックスであることではありません。データは 2〜3 日遅れることがあります。
• 検索クエリは公開ページに出さないでください。 クエリは機微になり得ます。オーナーが公開を受け入れる場合を除き、既定のダッシュボードはプロパティ合計などクエリ以外の次元を使ってください。
• サイトマップ送信とプロパティ登録は先に確認します。 MeDo はプロパティまたはフィードパスをプレビューし、明示確認を待ちます。結果が不明な書き込みは再実行しないでください。
• アプリ固有のメモはアプリに残します。 順位メモ、アラートスナップショット、ページメモは、実際のプロパティまたはページ URL をキーにしてアプリのテーブルに保存します。Search Console のフィールドではありません。

#制限とトラブルシューティング

アプリに「Connection required」と出る。 Search Console 接続はアプリオーナーのものです。オーナーにコネクタカードを開いて Connect を押してもらい、再読み込みしてください。

分析が 0 になる。 その期間にまだ表示がないか、データが着地していないことがほとんどで、黙って失敗したわけではありません。日付を広げるか、2〜3 日の遅延を待ってから、カバレッジ欠落として扱ってください。

サイトマップ送信やプロパティ登録の結果が不明。 もう一度押さないでください。先にプロパティまたはフィード一覧を読みます。再実行すると別の残りを登録したり、同じフィードを再送信したりします。

訪問者に見せたくない検索データが見えている。 接続は共有です。アプリにサインインとサーバー側の制限を追加してください。アクセスとロールの管理をご覧ください。

#関連ページ

• コネクタカタログ — 他のコネクタと用途。
• スキルとコネクタ — スキルの呼び出し、料金、制限。
• サインインとユーザーの管理 — 接続データを出す前に、アプリ自身のアカウントを用意する。