Google Search Console

Google Search Console 是一個連接器：它把 MeDo 應用程式連接到一個 Search Console 帳戶，讓應用程式可以列出已驗證物業、讀取搜尋表現、檢查已知網址，並在確認後列出或提交 sitemap。應用程式看到的一切都來自你連接的帳戶。

#可以建立什麼

• 搜尋表現看板。 列出業主已驗證的物業，並依明確日期範圍顯示點擊、曝光、CTR 與平均排名。
• 網址檢查工具。 檢查單一已知頁面是否已收錄，並顯示涵蓋狀態。
• Sitemap 監視。 列出已提交的 feed、讀取最近提交與下載時間，並在確認後提交既有 sitemap。
• 物業登記（可選）。 登記業主明確要求的 URL-prefix 物業。登記不等於驗證，且此連接器無法刪除未驗證殘留。

當應用程式需要業主真實的搜尋與收錄資料時，Search Console 就很合適。它不是排名編輯器、域名驗證工具，也不是 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 帳戶。 能看到物業或分析的訪客，看到的都是同一個帳戶。這些頁面必須放在應用程式自己的登入之後，並限制給應有權限的人。標題寫「私人」本身不是存取控制。
• 物業網址要從已連接帳戶原樣複製。 使用 Search Console 回傳的 siteUrl，不要自行拼 sc-domain: 或 URL-prefix。
• 分析必須指定日期範圍。 使用 YYYY-MM-DD 起訖日。空列代表該區間沒有曝光，不代表網址未收錄。資料可能延遲兩到三天。
• 查詢詞不要放到公開頁。 搜尋查詢可能敏感。預設看板應使用物業合計或其他非查詢維度，除非業主接受公開這些流量。
• 提交 sitemap 與登記物業都要先確認。 MeDo 會預覽物業或 feed 路徑，等明確確認。結果不明時不要重試寫入。
• 應用程式自己的筆記留在應用程式裡。 排名備註、告警快照與頁面備註應存在應用程式資料表，並以真實物業或頁面網址為鍵，它們不是 Search Console 欄位。

#限制與疑難排解

應用程式出現「Connection required」。 Search Console 連接收歸應用程式業主。請業主打開連接器卡片並點擊 Connect，然後重新載入。

分析顯示 0。 通常代表該區間還沒有曝光，或資料尚未入帳，不是默默失敗。先擴大日期或等兩到三天延遲，再把它當成收錄問題。

提交 sitemap 或登記物業的結果不明。 不要再按一次。先讀物業或 feed 列表；重試可能再登記一筆殘留，或對同一 feed 再提交一次。

訪客不該看到搜尋資料時卻看得到。 連接是共用的。為應用程式加上登入與伺服器端限制，見管理存取與角色。

#相關內容

• 連接器目錄 — 其他連接器及其用途。
• 技能與連接器 — 技能如何調用、計價與限制。
• 管理登入與使用者 — 在公開已連接資料前，先給應用程式自己的帳戶。