Обновления API Search Console

Среда, 9 декабря 2020 г.

Несколько месяцев назад мы анонсировали модернизацию инфраструктуры API
для повышения производительности Search Console API по мере роста спроса. Сегодня мы рады сообщить о новых обновлениях:

• Добавление свежих данных и фильтра новостей в Search Console API
• Поддержка свойств домена в Sitemaps API
• Рекомендации о том, как мигрировать документ Discovery

Если вы делаете собственные вызовы к API, читайте дальше.

Свежие данные и фильтр новостей в Search Console API

Отчет об эффективности теперь поддерживает свежие данные возрастом менее одного дня. Вы можете получить доступ к этим данным через API, передав параметр запроса
dataState со значением all. Данные, которые вы получите для этого значения, также будут включать свежие данные, которые еще не являются окончательными. Если вы хотите получать только окончательные данные, final вы можете либо передать этот параметр с этим значением, либо не передавать его вообще, и по умолчанию вы получите только окончательные данные.

Несколько месяцев назад мы добавили вкладку «Новости» в фильтр поиска в отчет об эффективности . Эта информация теперь также доступна в API, и вы можете получить к ней доступ, установив значение параметра
searchType в запросе на.

news

Поддержка свойств домена в Sitemaps API
Sitemaps API теперь поддерживает свойства домена, как это уже делают другие API Search Console. Вы можете запрашивать, добавлять и удалять файлы Sitemap длясвойств домена

, например:

GET https://www.googleapis.com/webmasters/v3/sites/sc-domain:example.com/sitemaps

Миграция документа Discovery Мы прекратим поддержку в документе обнаружения Webmasters. Если вы запрашиваете Search Console API с помощьювнешней библиотеки API , или запрашиваете документ Discovery API Webmasters

напрямую, вам потребуется обновить вызовы API, чтобы учесть следующие изменения.

Изменения в библиотеке API Информацию об изменениях в библиотеке API см. в руководствах по быстрому старту для Java
и Python

, где представлено обновленное руководство по использованию API.

Java Для всех импортов, связанных со службой Webmasters, измените пакет webmasters на пакет searchconsole.v1 , а имя службыWebmasters — наSearchConsole

• . Примеры:

  Импорт службы API:

  import com.google.api.services.webmasters.Webmasters;

• import com.google.api.services.searchconsole.v1.SearchConsole;

  Импорт объекта ответа:

  import com.google.api.services.webmasters.model.WmxSite;

import com.google.api.services.searchconsole.v1.model.WmxSite; Обратите внимание, что, помимо объекта службы, остальные объекты API остались прежними, изменился только пакет

.

Python

При создании объекта службы Webmasters внесите следующее изменение:

webmasters_service = build('webmasters', 'v3', http=http)

webmasters_service = build(‘searchconsole’, ‘v1’, http=http)

Опять же, поведение объектов не изменилось.

Прямой запрос документа Discovery

• Изменения запросов документа Discovery включают:

  Изменение URL

  https://www.googleapis.com/discovery/v1/apis/webmasters/v3/rest

• https://searchconsole.googleapis.com/$discovery/rest
  • Изменение содержимого Поле name изменилось с webmasters на searchconsole дополнительно searchconsole.
  • The version field changed from v3 to v1.

If you have any questions, you can ask in the Search Central community или on Twitter.

Posted by Nati Yosephian, Gilad Amar, and Michael Huzman, Search Console team