Загрузка нескольких фидов

Позволяет добавлять до 50 YML-фидов одновременно для загрузки в Вебмастер.

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

Формат запроса

POST https://api.webmaster.yandex.net/v4/user/{user-id}/hosts/{host-id}/feeds/batch/add

user-id

Тип: int64. ID пользователя. Необходим для вызова любых ресурсов API Яндекс Вебмастера. Чтобы получить его, используйте метод GET /v4/user.

host-id

Тип: string. ID сайта. Чтобы получить его, используйте метод GET /v4/user/{user‑id}/hosts.

Пример

{
  "feeds": [
    {
      "url": "http://example.com/some/path?a=b",
      "type": "REALTY",
      "regionIds": [
        225
      ]
    }
  ]
}

<Data>
    <feed>
        <url>https://example.com/some/path?a=b</url>
        <type>REALTY</type>
        <regionIds>225</region_ids>
    </feed>
</Data>

Имя

Обязательный

Тип

Описание

url

Да

url

URL фида.

Если на вашем сайте настроена авторизация для доступа к YML-файлу, вы можете передавать логин и пароль вместе с URL, по которому он доступен. Например: https://yandex:WE9h4FfBml@example.com/feed.yml.

type

Да

string

Категория бизнеса, для которого загружен фид. Возможные значения:

  • REALTY — продажа или аренда квартир, офисов, домов и других построек;

  • VACANCY — предложения работы;

  • GOODS — продажа электроники, бытовой техники, строительных материалов, книг, запчастей и пр.;

  • DOCTORS — информация об услугах врачей (например, прием педиатра);

  • CARS — продажа автомобилей, мотоциклов и других средств передвижения;

  • SERVICES — объявления исполнителей бытовых и других услуг (например, перевозка мебели);

  • EDUCATION — объявления об образовательных курсах или уроках, которые проводятся онлайн (например, курсы программирования).

  • ACTIVITY — продажа билетов на развлекательные услуги.

regionIds

Да

int32

Идентификаторы регионов, для которых сформирован фид. Можно указать несколько идентификатор через запятую (например, 1, 2). Если значение не передано, задается значение 225 (Россия).

Формат ответа

Примеры

{
  "feeds": [
    {
      "url": "https://example.com/some/path?a=b",
      "status": "OK"
    }
  ]
}

<Data>
    <feed>
        <url>https://example.com/some/path?a=b</url>
        <status>OK</status>
    </feed>
</Data>

Имя

Обязательный

Тип

Описание

url

Да

string

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

status

Да

string

Статус загрузки YML-фида. Возможные значения:

  • OK — загрузка завершена;

  • NOT_HTTPS — сайт не поддерживает протокол HTTPS (метод доступен для сайтов, которые работают на протоколе HTTPS);

  • FEED_ALREADY_ADDED — указанный фид уже загружен в Вебмастер;

  • BAD_HTTP_CODE — URL фида отвечает кодом, который отличается от 200 OK (подробно о кодах статусов HTTP см. в Справке);

  • BAD_MIME_TYPE — в фиде указан некорректный тип данных;

  • TIMED_OUT — истекло время ожидания ответа;

  • INCORRECT_URL — URL фида указан неправильно;

  • WRONG_REGION — регион не поддерживается (см. список регионов).

Коды ответа

Чтобы посмотреть структуру ответа подробнее, нажмите на причину.

Код

Причина

Описание

200

OK

403

FEEDS_LIMIT_EXCEEDED

 
{
 "error_code": "FEEDS_LIMIT_EXCEEDED",
 "limit": 1,
 "error_message": "explicit error message"
}

<Data>
  <[error_code](*error_code)>FEEDS_LIMIT_EXCEEDED</error_code>
  <[limit](*limit_feed)>1</limit>
  <[error_message](*error_message)>explicit error message</error_message>
</Data>

403

BATCH_LIMIT_EXCEEDED

 
{
 "error_code": "BATCH_LIMIT_EXCEEDED",
 "limit": 1,
 "error_message": "explicit error message"
}

<Data>
  <[error_code](*error_code)>BATCH_LIMIT_EXCEEDED</error_code>
  <[limit](*limit_feed_add)>1</limit>
  <[error_message](*error_message)>explicit error message</error_message>
</Data>

403

INVALID_USER_ID

 
{
  "error_code": "INVALID_USER_ID",
  "available_user_id": 1,
  "error_message": "Invalid user id. {user_id} should be used."
}

<Data>
    <[error_code](*error_code)>INVALID_USER_ID</error_code>
    <[available_user_id](*available_user_id)>1</available_user_id>
    <[error_message](*error_message)>Invalid user id. {user_id} should be used.</error_message>
</Data>

403

FEEDS_CATEGORY_BAN

 
{
  "error_code": "FEEDS_CATEGORY_BAN",
  "error_message": "explicit error message"
}

<Data>
    <[error_code](*error_code)>FEEDS_CATEGORY_BAN</error_code>
    <[error_message](*error_message)>explicit error message</error_message>
</Data>

404

HOST_NOT_VERIFIED

Не подтверждены права на управление сайтом.

{
  "error_code": "HOST_NOT_VERIFIED",
  "host_id": "http:ya.ru:80",
  "error_message": "some string"
}

<Data>
  <[error_code](*error_code)>HOST_NOT_VERIFIED</error_code>  
  <[host_id](*host_id)>http:ya.ru:80</host_id>
  <[error_message](*error_message)>some string</error_message>
</Data>

Узнайте больше

Тип: int64. ID пользователя. Необходим для вызова любых ресурсов API Яндекс Вебмастера. Чтобы получить его, используйте метод GET /v4/user.

Тип: string. ID сайта. Чтобы получить его, используйте метод GET /v4/user/{user‑id}/hosts.

Обязательный

Да

Тип

url

Описание

URL фида.

Если на вашем сайте настроена авторизация для доступа к YML-файлу, вы можете передавать логин и пароль вместе с URL, по которому он доступен. Например: https://yandex:WE9h4FfBml@example.com/feed.yml.

Обязательный

Да

Тип

string

Описание

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

Обязательный

Да

Тип

string

Описание

Категория бизнеса, для которого загружен фид. Возможные значения:

  • REALTY — продажа или аренда квартир, офисов, домов и других построек;

  • VACANCY — предложения работы;

  • GOODS — продажа электроники, бытовой техники, строительных материалов, книг, запчастей и пр.;

  • DOCTORS — информация об услугах врачей (например, прием педиатра);

  • CARS — продажа автомобилей, мотоциклов и других средств передвижения;

  • SERVICES — объявления исполнителей бытовых и других услуг (например, перевозка мебели);

  • EDUCATION — объявления об образовательных курсах или уроках, которые проводятся онлайн (например, курсы программирования).

  • ACTIVITY — продажа билетов на развлекательные услуги.

Обязательный

Да

Тип

int32

Описание

Идентификаторы регионов, для которых сформирован фид. Можно указать несколько идентификатор через запятую (например, 1, 2). Если значение не передано, задается значение 225 (Россия).

Обязательный

Да

Тип

string

Описание

Статус загрузки YML-фида. Возможные значения:

  • OK — загрузка завершена;

  • NOT_HTTPS — сайт не поддерживает протокол HTTPS (метод доступен для сайтов, которые работают на протоколе HTTPS);

  • FEED_ALREADY_ADDED — указанный фид уже загружен в Вебмастер;

  • BAD_HTTP_CODE — URL фида отвечает кодом, который отличается от 200 OK (подробно о кодах статусов HTTP см. в Справке);

  • BAD_MIME_TYPE — в фиде указан некорректный тип данных;

  • TIMED_OUT — истекло время ожидания ответа;

  • INCORRECT_URL — URL фида указан неправильно;

  • WRONG_REGION — регион не поддерживается (см. список регионов).

Предыдущая
Получение статуса асинхронной загрузки фида
Следующая
Получение информации о загруженных фидах