Пример управления YML-фидами для дополненного представления в поиске
Примечание
Дополненное представление в поиске находится в режиме бета-тестирования.
Вы можете бесплатно показывать больше услуг и предложений потенциальным клиентам в результатах поиска Яндекса. Пользователи смогут ближе познакомиться с вашими предложениями и услугами прямо в поисковой выдаче и еще на этапе поиска понять, есть ли на вашем сайте то, что им нужно. Подробно см. Дополненное представление в поиске Яндекса.
Данные передаются Яндексу в формате YML-файла (фида). Стандарт YML (Yandex Market Language) разработан Яндексом и основан на стандарте XML.
Поддерживается YML-файл с расширением xml, yml или в виде архива gzip. Убедитесь, что HTTP-заголовок Content-type, который передает ваш сервер, содержит тип ресурса application/xml, application/octet-stream или text/xml.
С помощью API Вебмастера вы можете управлять ранее подготовленным фидом: загружать, проверять статус и ошибки, удалять. Операции доступны для сайтов, которые используют протокол HTTPS.
Ниже приведен пример работы с фидами.
Шаг 1. Получите OAuth-токен
Для работы с API получите авторизационный токен. Передавайте его в каждом запросе в HTTP-заголовке Authorization.
Шаг 2. Получите идентификатор пользователя
Идентификатор пользователя нужен при вызове ресурсов API. Он передается в path-параметре user-id. Чтобы получить идентификатор, используйте метод GET /v4/user.
Идентификатор пользователя возвращается в поле user-id.
Шаг 3. Добавьте сайт в Вебмастер и подтвердите права
- Чтобы добавить сайт в Вебмастер, используйте метод POST /v4/user/{user-id}/hosts.
- Чтобы подтвердить права на управление сайтом в Вебмастере, воспользуйтесь инструкцией.
Шаг 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/.
Чтобы передать одновременно до 50 фидов, используйте метод POST /v4/user/{user_id}/hosts/{host_id}/feeds/batch/add/.
Загружая фид, вы соглашаетесь с условиями использования сервиса.
Шаг 5. Получите информацию о фиде
После загрузки фид будет проверен. Проверка занимает некоторое время. Статус проверки и число ошибок по фиду можно получить методом GET /v4/user/{user_id}/hosts/{host_id}/feeds/info/ — передайте URL фида в параметре url.
Если в ответе status — ERROR, в фиде есть ошибки.
Тот же статус можно посмотреть в интерфейсе Вебмастера: Услуги и предложения в поиске → Фиды и ошибки.
Шаг 6. Получите ошибки и исправьте фид
Для этого используйте метод GET /v4/user/{user_id}/hosts/{host_id}/feeds/problems/ — передайте URL фида в параметре url.
Прочитайте сообщения об ошибках и исправьте их. В течение некоторого времени фид будет проверен снова.