Удаление нескольких фидов

Удаляет YML-фиды, загруженные в Вебмастер.

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

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

user-id

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

host-id

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

Пример

{
  "urls": [
    "https://example.com/some/path?a=b"
    "..."
  ]
}
<Data>
    <url>https://example.com/some/path?a=b</url>
</Data>

Имя

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

Тип

Описание

urls

Да

url

URL-адреса фидов, которые нужно удалить из Вебмастера.

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

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

Примеры

{
  "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

URL удаленного фида.

status

Да

string

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

  • OK — фид удален;

  • NOT_EXIST — фид не найден в Вебмастере.

Коды ответа

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

Код

Причина

Описание

200

OK

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>INVALID_USER_ID</error_code>
    <available_user_id>1</available_user_id>
    <error_message>Invalid user id. {user_id} should be used.</error_message>
</Data>

403

MANY_URLS_FOR_REMOVE

{
  "error_code": "MANY_URLS_FOR_REMOVE",
  "error_message": "some string"
}
<Data>
  <error_code>MANY_URLS_FOR_REMOVE</error_code>  
  <error_message>some string</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>HOST_NOT_VERIFIED</error_code>  
  <host_id>http:ya.ru:80</host_id>
  <error_message>some string</error_message>
</Data>

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

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

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

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

Смещение в списке. Минимальное значение — 0. Значение по умолчанию: 0.

Количество записей (1-100). Значение по умолчанию: 10.

Описание

Код ошибки.

Описание

Сообщение об ошибке.

Описание

Значение.

Описание

Поле.

Описание

ID запрошенного сайта.

Описание

ID сайта.

Описание

Признак подтверждения сайта.

Описание

ID файла Sitemap.

Описание

Список поддерживаемых типов контента.

Описание

Лимит на количество добавленных сайтов.

Описание

Лимит количества фидов.

Описание

Лимит количества добавленных фидов.

Описание

ID пользователя, от имени которого разрешен доступ.

Описание

Дата и время, до которого адрес доступен для создания задачи.

Описание

Список поддерживаемых типов контента.

Описание

Список поддерживаемых типов кодировки.

Описание

Максимальная длина.

Описание

Минимальная длина.

Описание

Доступное количество запросов в сутки.

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

Да

Тип

string

Описание

URL удаленного фида.

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

Да

Тип

string

Описание

URL удаленного фида.

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

Да

Тип

string

Описание

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

  • OK — фид удален;

  • NOT_EXIST — фид не найден в Вебмастере.