Изменение данных сегмента, созданного из файла

Изменяет данные указанного сегмента. При обновлении сегментов нужно использовать структуру файла, которая была при первичной загрузке сегмента.

  1. Синтаксис запроса
  2. В теле запроса
  3. Формат ответа

Синтаксис запроса

segmentId — идентификатор сегмента, данные которого вы хотите изменить.

https://api-audience.yandex.ru/v1/management/segment/{segmentId}/modify_data
 ? modification_type=<uploading_segment_modification_type>
 & [check_size=<boolean>]
modification_type *Тип изменения данных: добавление или удаление данных, перезаписывание файла целиком. При добавлении данные должны совпадать с исходным форматом (захешированная или незахешированая информация).

Допустимые значения:

  • subtraction — удаление данных из файла.
  • addition — добавление данных в файл.
  • replace — перезаписывание файла целиком.
check_sizeПараметр позволяет создавать сегменты меньше 100 записей. Такие сегменты нельзя использовать для рекламы в Директе, пока их размер не превысит 100 записей.

Значение по умолчанию: true

modification_type *Тип изменения данных: добавление или удаление данных, перезаписывание файла целиком. При добавлении данные должны совпадать с исходным форматом (захешированная или незахешированая информация).

Допустимые значения:

  • subtraction — удаление данных из файла.
  • addition — добавление данных в файл.
  • replace — перезаписывание файла целиком.
check_sizeПараметр позволяет создавать сегменты меньше 100 записей. Такие сегменты нельзя использовать для рекламы в Директе, пока их размер не превысит 100 записей.

Значение по умолчанию: true

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

В теле запроса


POST http://api-audience.yandex.ru/v1/management/segment/111/modify_data?modification_type=addition
Content-Type: multipart/form-data; boundary=--------------------------5b2a52c5c90f668a
Context-Length: 331

--------------------------5b2a52c5c90f668a
Content-Disposition: form-data; name="file"; filename="data.tsv"
Content-Type: application/octet-stream

aaaaaaaa-bbbb-cccc-1111-222222222200
aaaaaaaa-bbbb-cccc-1111-222222222201
--------------------------5b2a52c5c90f668a--

Пример запроса

POST https://api-audience.yandex.ru/v1/management/segment/{segmentId}/modify_data?modification_type=addition, subtraction, replace

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


{
    "segment" :  < _uploading_segment > 
}
Параметры Описание
segment Сегмент с заданными параметрами.
Параметры Описание
segment Сегмент с заданными параметрами.