Асинхронная загрузка фида
Асинхронно добавляет YML-фиды для загрузки в Вебмастер. Используйте этот метод, если фиды долго генерируются.
Загружая фид, вы соглашаетесь с условиями использования сервиса.
Формат запроса
POST https://api.webmaster.yandex.net/v4/user/{user-id}/hosts/{host-id}/feeds/add/start
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. |
Пример
{
"feed": {
"url": "https://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 | Идентификаторы регионов, для которых сформирован фид. Можно указать несколько идентификатор через запятую (например, |
Формат ответа
Примеры
{
"requestId": "c7fe80c0-36e3-11e6-8b2d-df96aa592c0a"
}
<Data>
<requestId>c7fe80c0-36e3-11e6-8b2d-df96aa592c0a</requestId>
</Data>
Имя | Обязательный | Тип | Описание |
---|---|---|---|
requestId | Да | UUID | Идентификатор загрузки. Используйте его для отслеживания статуса с помощью метода GET /v4/user/{user_id}/hosts/{host_id}/feeds/add/info. |
Имя | Обязательный | Тип | Описание |
---|---|---|---|
requestId | Да | UUID | Идентификатор загрузки. Используйте его для отслеживания статуса с помощью метода GET /v4/user/{user_id}/hosts/{host_id}/feeds/add/info. |
Коды ответа
Чтобы посмотреть структуру ответа подробнее, нажмите на причину.
Код | Причина | Описание |
---|---|---|
200 | OK | |
403 | FEEDS_LIMIT_EXCEEDED | |
403 | INVALID_USER_ID | |
404 | HOST_NOT_VERIFIED | Не подтверждены права на управление сайтом. |
404 | FEED_ALREADY_ADDED | |
404 | ONLY_HTTPS | |
404 | INCORRECT_URL | |
404 | WRONG_REGION | |
Код | Причина | Описание |
---|---|---|
200 | OK | |
403 | FEEDS_LIMIT_EXCEEDED | |
403 | INVALID_USER_ID | |
404 | HOST_NOT_VERIFIED | Не подтверждены права на управление сайтом. |
404 | FEED_ALREADY_ADDED | |
404 | ONLY_HTTPS | |
404 | INCORRECT_URL | |
404 | WRONG_REGION | |