Method: index.inspect

查看指定網址的索引狀態,或可建立索引的狀態。目前,只有 Google 索引中的版本狀態可用;您無法測試線上網址的索引能力。

HTTP 要求

POST https://searchconsole.googleapis.com/v1/urlInspection/index:inspect

這個網址使用 gRPC 轉碼語法。

要求主體

要求主體的資料會採用以下結構:

JSON 表示法
{
  "inspectionUrl": string,
  "siteUrl": string,
  "languageCode": string
}
欄位
inspectionUrl

string

必要欄位。要檢查的完整網址。必須位於「siteUrl」指定的資源。

siteUrl

string

必要欄位。Search Console 中定義的資源網址。請注意, 網址前置字元屬性必須包含結尾的 / 標記。 範例:網址前置字元資源為 https://www.example.com/,網域資源則為 sc-domain:example.com

languageCode

string

選填欄位,IETF BCP-47 語言代碼,用於表示已翻譯的問題訊息內容 (例如「en-US」、「de-CH」)。預設值為「en-US」。

回應主體

如果成功,回應主體即會包含具有以下結構的資料:

索引狀態檢查回應。

JSON 表示法
{
  "inspectionResult": {
    object (UrlInspectionResult)
  }
}
欄位
inspectionResult

object (UrlInspectionResult)

網址檢查結果。

授權範圍

需要下列其中一種 OAuth 範圍:

  • https://www.googleapis.com/auth/webmasters
  • https://www.googleapis.com/auth/webmasters.readonly

詳情請參閱 OAuth 2.0 總覽