Новый URL Inspection API в Search Console

Понедельник, 31 января 2022 г.

Представляем URL Inspection API – новый инструмент, позволяющий автоматизировать проверку URL ресурсов, которыми вы управляете в Google Search Console.

Наши API предоставляют возможность внешним приложениям и продуктам получать доступ к данным из Search Console. Разработчики используют эти API, чтобы просматривать, удалять и добавлять ресурсы и файлы Sitemap, а также получать данные об эффективности сайтов в Google Поиске с помощью расширенных запросов.

URL Inspection API можно использовать при отладке и оптимизации страниц, чтобы получать из Search Console актуальные данные о проиндексированной версии URL, доступные в инструменте проверки URL.

Как использовать новый API

Информацию о работе с новым инструментом можно найти в документации по API для разработчиков. Параметры запроса содержат URL, который вы хотите проверить, и URL ресурса, указанный в Search Console.

В ответе будут результаты анализа URL из Search Console, в том числе статус индексирования, а также сведения об удобстве просмотра страницы на мобильных устройствах, о возможности ее показа в виде расширенного результата и о наличии AMP-версии страницы. Чтобы лучше разобраться в этих результатах, ознакомьтесь со списком параметров или изучите раздел Интерпретация результатов проверки проиндексированной страницы.

Отправив вызов с помощью API, вы получите ответ со всеми запрашиваемыми данными или сообщение об ошибке, если выполнить запрос не удалось. Если в ответе отсутствует какой-либо результат, значит выполнить нужную проверку выбранного URL не удалось. Вот пример ответа, который вы можете получить от 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 мы консультировались с издателями и специалистами по поисковой оптимизации, чтобы узнать, каким они видят его практическое применение. Вот наиболее типичные варианты использования:

  • Специалисты по поисковой оптимизации могут реализовать постоянный мониторинг важных страниц и настроить алгоритмы отладки отдельных страниц. Например, можно находить расхождения между URL канонических страниц, выбранными пользователем и установленными Google, или устранять проблемы со структурированными данными в выбранной группе страниц.
  • Разработчики систем управления контентом и плагинов могут получать статистику на уровне страниц или шаблонов, а также настраивать регулярные проверки существующих страниц. Например, можно отслеживать изменения на ключевых страницах, чтобы выявлять возможные проблемы и оперативно их устранять.

Лимиты на использование

С более подробным описанием ограничений на использование API Search Console можно ознакомиться в документации для разработчиков. Для URL Inspection API действуют следующие ограничения на уровне ресурса в Search Console (подсчитываются вызовы, которые относятся к одному и тому же сайту):

  • 2000 запросов в день;
  • 600 запросов в минуту.

Нам интересно ваше мнение

Мы надеемся, что URL Inspection API поможет разработчикам и SEO-специалистам создавать новые решения для работы с данными Google Поиска.

Если у вас есть вопросы или предложения, вы можете связаться с нами в Твиттере или попробовать найти информацию на справочном форуме Центра Google Поиска.