Пример управления YML-фидами для дополненного представления в поиске

Примечание. Дополненное представление в поиске находится в режиме бета-тестирования.

Вы можете бесплатно показывать больше товаров и предложений потенциальным клиентам в результатах поиска Яндекса. Пользователи смогут ближе познакомиться с вашими предложениями и товарами прямо в поисковой выдаче и еще на этапе поиска понять, есть ли на вашем сайте то, что им нужно. Подробно о возможностях

Данные передаются Яндексу в формате YML-файла (фида). Стандарт YML (Yandex Market Language) разработан Яндексом и основан на стандарте XML.

Поддерживается YML-файл с расширением xml, yml или в виде архива gzip. Убедитесь, что HTTP-заголовок Content-type, который передает ваш сервер, содержит тип ресурса application/xml, application/octet-stream или text/xml.

С помощью API Вебмастера вы можете управлять ранее подготовленным фидом: загружать и удалять. Операции доступны для сайтов, которые используют протокол HTTPS.

Ниже приведен пример работы с фидами.

  1. Шаг 1. Получите OAuth-токен
  2. Шаг 2. Получите идентификатор пользователя
  3. Шаг 3. Добавьте сайт в Вебмастер и подтвердите права
  4. Шаг 4. Загрузите фид в Вебмастер
  5. Шаг 5. Проверьте список загруженных в Вебмастер фидов
  6. Что дальше

Шаг 1. Получите OAuth-токен

Для работы с API получите авторизационный токен. Передавайте его в каждом запросе в HTTP-заголовке Authorization.

Шаг 2. Получите идентификатор пользователя

Идентификатор пользователя нужен при вызове ресурсов API. Он передается в path-параметре user-id. Чтобы получить идентификатор, используйте метод GET /v4/user.

Идентификатор пользователя возвращается в поле user-id.

Шаг 3. Добавьте сайт в Вебмастер и подтвердите права

  1. Чтобы добавить сайт в Вебмастер, используйте метод POST /v4/user/{user-id}/hosts.
  2. Чтобы подтвердить права на управление сайтов в Вебмастере, воспользуйтесь инструкцией.

Шаг 4. Загрузите фид в Вебмастер

API Вебмастера позволяет загрузить несколько фидов:

Если фиды долго генерируются, используйте метод POST /v4/user/{user_id}/hosts/{host_id}/feeds/add/start. Он позволяет асинхронно выполнить загрузку фида — параллельно можно запустить до 50 загрузок.

Затем отслеживайте статус загрузки каждого из фидов с помощью метода GET /v4/user/{user_id}/hosts/{host_id}/feeds/add/info.

Загружая фид, вы соглашаетесь с условиями использования сервиса.

Шаг 5. Проверьте список загруженных в Вебмастер фидов

Для этого используйте метод GET /v4/user/{user_id}/hosts/{host_id}/feeds/list.

Что дальше

Яндекс Вебмастер проверит фид. Если он содержит ошибки, в Вебмастере рядом с фидом появится сообщение об ошибках:

  • для услуг и предложений на странице Услуги и предложения в поиске → Фиды и ошибки;
  • для товарных фидов на странице Товары в поиске → Ошибки.

Исправьте ошибки — в течение некоторого времени Вебмастер проверит фид снова.

Также информация о сайте и предложениях будет проверена службой контроля качества в течение нескольких дней. Фид может быть отклонен за нарушение правил.