隆重推出新的 Search Console URL Inspection API

2022 年 1 月 31 日，星期一

今天，我们推出了新的 Google Search Console URL Inspection API，它让您能够以编程方式访问您在 Search Console 中所管理资源的网址级数据。

借助 Search Console API，您可以通过外部应用和产品在 Search Console 以外访问相应数据。开发者和搜索引擎优化 (SEO) 工具已使用这些 API 构建自定义解决方案，以便查看、添加或移除资源和站点地图，以及针对搜索效果数据运行高级查询。

借助新的 URL Inspection API，我们为开发者提供了用于调试和优化其网页的新工具。您可以请求获取 Search Console 中与已编入索引的网址版本相关的数据；该 API 将返回网址检查工具中当前可获取的已编入索引的信息。

使用新 API

如需了解如何使用这个新 API，请查看 API 开发者文档。请求参数包括您要检查的网址以及 Search Console 中定义的资源网址。

响应内容包括分析结果，其中包含来自 Search Console 的信息，囊括索引状态、AMP、富媒体搜索结果和在移动设备上的易用性。如需了解详情，请参阅参数列表和解读结果：编入索引的网址。

调用该 API 后，您会收到包含所有相关结果的响应或错误消息（如果请求失败）。如果响应中缺少特定的分析结果，则表明无法对所检查的网址执行相应分析。以下是通过该 API 收到的响应示例。 

  {
  "inspectionResult": {
    "inspectionResultLink": "https://search.google.com/search-console/inspect?resource_id=https://developers.google.com/search/&id=odaUL5Dqq3q8n0EicQzawg&utm_medium=link",
    "indexStatusResult": {
      "verdict": "PASS",
      "coverageState": "Indexed, not submitted in sitemap",
      "robotsTxtState": "ALLOWED",
      "indexingState": "INDEXING_ALLOWED",
      "lastCrawlTime": "2022-01-31T08:39:51Z",
      "pageFetchState": "SUCCESSFUL",
      "googleCanonical": "https://developers.google.com/search/help/site-appearance-faq",
      "userCanonical": "https://developers.google.com/search/help/site-appearance-faq",
      "referringUrls": [
        "https://developers.google.com/search/updates",
        "https://developers.google.com/search/help/crawling-index-faq"
      ],
      "crawledAs": "MOBILE"
    },
    "mobileUsabilityResult": {
      "verdict": "PASS"
    },
    "richResultsResult": {
      "verdict": "PASS",
      "detectedItems": [
        {
          "richResultType": "Breadcrumbs",
          "items": [
            {
              "name": "Unnamed item"
            }
          ]
        },
        {
          "richResultType": "FAQ",
          "items": [
            {
              "name": "Unnamed item"
            }
          ]
        }
      ]
    }
  }
}

可能的用例

在构建新 API 的过程中，我们咨询了多位 SEO 人员和发布商，了解他们会如何借助该 API 打造利用这些数据的解决方案。下面是一些突出的用例：

  • SEO 工具和代理机构可以持续监控重要网页和单个网页调试选项。例如，检查用户声明的规范网页与 Google 选择的规范网页之间的差异，或者调试解决一组网页中的结构化数据问题。
  • CMS 和插件开发者可以为现有网页增添网页级或模板级数据洞见和持续检查。例如，监控关键网页在一段时间内的变化，以诊断问题并帮助确定修复优先级。

用量限额

您可以在开发者文档中找到对 Search Console API 用量限额的更详细的说明。具体就 URL Inspection API 而言，系统会为每个 Search Console 网站资源设定配额（为查询同一个网站而调用该 API 的次数）：

  • 每天 2000 次查询
  • 每分钟 600 次查询

反馈

我们相信，这一新 API 将为生态系统带来利用 Google 搜索数据进行创新的新机会；我们一直期待看到开发者和 SEO 人员运用 Search Console API 构建的解决方案。

如果您有任何疑问或反馈，欢迎在 Twitter 上与我们联系，或在搜索中心社区中发帖提问。

发布者：Daniel Waisberg 和 Dori Rosenberg，Search Console 团队