Загрузка нескольких фидов
Позволяет добавлять до 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 | Тип: host id (string). ID сайта. Чтобы получить его, используйте метод GET /v4/user/{user-id}/hosts. |
user-id | Тип: int64. ID пользователя. Необходим для вызова любых ресурсов API Яндекс Вебмастера. Чтобы получить его, используйте метод GET /v4/user. |
host-id | Тип: host id (string). ID сайта. Чтобы получить его, используйте метод GET /v4/user/{user-id}/hosts. |
Пример
{
"feeds": [
{
"url": "http://example.com/some/path?a=b",
"type": "REALTY",
"regionIds": [
225
]
}
]
}
Имя | Обязательный | Тип | Описание |
---|---|---|---|
url | Да | url | URL фида. Если на вашем сайте настроена авторизация для доступа к YML-файлу, вы можете передавать логин и пароль вместе с URL, по которому он доступен. Например: https://yandex:WE9h4FfBml@example.com/feed.yml. |
type | Да | string | Категория бизнеса, для которого загружен фид. Возможные значения:
|
regionIds | Да | int32 | Идентификаторы регионов, для которых сформирован фид. Можно указать несколько идентификатор через запятую (например, |
Имя | Обязательный | Тип | Описание |
---|---|---|---|
url | Да | url | URL фида. Если на вашем сайте настроена авторизация для доступа к YML-файлу, вы можете передавать логин и пароль вместе с URL, по которому он доступен. Например: https://yandex:WE9h4FfBml@example.com/feed.yml. |
type | Да | string | Категория бизнеса, для которого загружен фид. Возможные значения:
|
regionIds | Да | int32 | Идентификаторы регионов, для которых сформирован фид. Можно указать несколько идентификатор через запятую (например, |
Формат ответа
Примеры
Имя | Обязательный | Тип | Описание |
---|---|---|---|
url | Да | string | Идентификатор загрузки. Используйте его для отслеживания статуса с помощью метода GET /v4/user/{user_id}/hosts/{host_id}/feeds/add/info. |
status | Да | string | Статус загрузки YML-фида. Возможные значения:
|
Имя | Обязательный | Тип | Описание |
---|---|---|---|
url | Да | string | Идентификатор загрузки. Используйте его для отслеживания статуса с помощью метода GET /v4/user/{user_id}/hosts/{host_id}/feeds/add/info. |
status | Да | string | Статус загрузки YML-фида. Возможные значения:
|
Коды ответа
Чтобы посмотреть структуру ответа подробнее, нажмите на причину.
Код | Причина | Описание |
---|---|---|
200 | OK | |
403 | FEEDS_LIMIT_EXCEEDED | |
403 | BATCH_LIMIT_EXCEEDED | |
403 | INVALID_USER_ID | |
404 | HOST_NOT_VERIFIED | Не подтверждены права на управление сайтом. |
Код | Причина | Описание |
---|---|---|
200 | OK | |
403 | FEEDS_LIMIT_EXCEEDED | |
403 | BATCH_LIMIT_EXCEEDED | |
403 | INVALID_USER_ID | |
404 | HOST_NOT_VERIFIED | Не подтверждены права на управление сайтом. |