Где изменение становится шире задачи
Пусть кампания имеет дневной лимит 9000 рублей, расписание на понедельник и вторник и две целевые географии. Менеджер говорит: «Завтра снизь лимит до 7000». Команда продукта должна принять два решения. Когда выполнить задачу? Какие настройки может изменить агент? В этом разборе время уже согласовано, задача агента сводится к одному полю.
Агент может хранить параметры кампании в одной структуре, где есть расписание, лимит и география показов. Но если отправить эту структуру целиком, пустое поле в ней может стать командой на удаление. Например, модель ничего не сказала о расписании, промежуточная библиотека заполнила пропуск значением null, а платформа обработала это как сброс. Менеджер увидит правильную цифру лимита и может заметить сдвиг в расписании лишь на следующий день.
В тесте отделите запись о намерении от тела сетевого запроса. Намерение может храниться как «изменить дневной лимит до 7000, прочие поля сохранить». Адаптер платформы преобразует его в запись, которую понимает нужная операция. Именно адаптер отвечает за то, чтобы поля, отсутствующие в намерении, не появились в запросе с новыми значениями. Проверять следует отправленные байты или максимально близкую к ним запись тестового клиента.
Что именно означает пропуск
JSON Merge Patch описывает изменения по структуре исходного объекта. При работе с объектом пропущенное поле сохраняет прежнее значение. Поле со значением null удаляется. Поле со списком заменяет прежний список целиком. Например, отправка пустого массива расписания оставит в объекте пустое расписание. Как рекламная платформа интерпретирует пустое расписание, определяет её собственный контракт. Это может быть ошибка проверки или отдельное состояние. RFC 7396
В таком формате запрос с одним полем дневного лимита меняет именно его. Если расписание устроено как массив, команда «добавь среду» требует передать полный ожидаемый список либо использовать другой метод, который умеет добавлять отдельные элементы. Передача массива из одной среды уберёт понедельник и вторник в модели Merge Patch. Документация Kubernetes показывает ту же особенность замены списка на примере списка контейнеров. Она помогает проверить понимание механизма и ничего не говорит о доступности метода в рекламном кабинете. Kubernetes, обновление объектов
JSON Patch, описанный в другом документе IETF, передаёт явные операции с путями. Пример операции replace указывает, какое конкретно поле нужно заменить. Операция remove описывает удаление отдельно. Для массива путь может указывать на отдельный элемент, но позиция зависит от состояния списка. Если список уже изменился, операция по индексу может обратиться к другому элементу. При выборе формата руководствуйтесь документацией площадки и проверьте способ защиты от параллельных изменений. RFC 6902
Сам метод HTTP PATCH не гарантирует перечисленные правила. Кабинет может принимать собственный формат, например список обновляемых полей или отдельную команду для бюджета. Спросите, какие значения он различает, что делает с пропущенными полями и возвращает ли ошибку при неподдерживаемом свойстве. Если документация неоднозначна, разрешите агенту изменения только после контрольного прогона.
Как составить контрольную выгрузку
В учебном наборе все строки начинаются с одной кампании. Между тестами она восстанавливается в исходное состояние. Лимит 9000 рублей и расписание на два дня заданы вручную. Колонки показывают то, что отправил клиент, и то, что ожидается от модели Merge Patch. Пустое поле в CSV поясняется словами, чтобы его можно было отличить от null и пустого массива даже в табличном редакторе.
Первая строка меняет только лимит. Ожидаем получить лимит 7000 и прежние понедельник с вторником. Во второй строке клиент отправляет тот же лимит и null вместо расписания. В модели расписание исчезает, поэтому такой запрос нужно остановить до отправки. В третьей строке клиент отправляет пустой массив. Само поле сохраняется, список дней становится пустым. Эти два результата дают разные записи при чтении объекта. В четвёртой строке клиент хотел добавить среду, но передал только её. Итоговый список содержит одну среду. Последняя строка добавляет среду с полным ожидаемым списком.
Первые проверки можно выполнить на локальной имитации с заданными правилами. Следующий шаг нужен для фактической платформы. Возьмите выделенную тестовую кампанию без активной доставки, снимите состояние перед изменением, передайте один запрос и сравните ответ с повторным чтением. Для рабочего теста нужны оба наблюдения: фактический запрос и подтверждённое состояние. Если площадка применяет изменения с задержкой, повторно запросите настройки в срок, указанный в документации. Тест с имитацией показывает поведение адаптера и не заменяет проверку кабинета.
После каждой попытки проверяйте расписание, географию, статус, ограничения бюджета и список креативов. Состав полей зависит от операции. Например, для смены лимита два списка сравнивают по смыслу, если кабинет гарантирует свободный порядок. В расписании сверяют дни и интервалы вместе с часовым поясом. Иначе тест может принять смену порядка за ошибку и пропустить смену фактического времени показов.
Что разрешить агенту на старте
В пилоте заведите отдельное действие для смены дневного лимита. Оно принимает идентификатор кампании и согласованную сумму. Дальше адаптер строит запрос по известному договору с площадкой. Не давайте языковой модели собирать произвольный объект кампании. Команда разработки выбирает поддерживаемую операцию, а медийная команда задаёт допустимый диапазон и условия согласования. Служебную информацию вроде причины изменения сохраняйте в журнале, если она не нужна самой операции.
Перед отправкой сравните набор изменяемых полей с тем, что согласовал менеджер. Для изменения одного лимита ожидается одно бизнес-поле. Если клиент внезапно добавил расписание, отклоните запрос и оставьте в журнале понятную причину. Это полезно даже когда площадка сегодня игнорирует лишнее поле: у другой версии API или у следующего поставщика поведение может отличаться. Если по контракту обязательны дополнительные технические реквизиты, отделите их от перечня настроек, которые изменяются.
Сброс настройки оформляйте отдельным действием. Менеджеру нужно видеть, что произойдёт: настройка будет удалена, установлена в пустое значение или получит значение по умолчанию. Если это зависит от версии кабинета, агент должен передать задачу человеку. После отклонённой операции не пытайтесь отправить более широкий запрос, чтобы получить успешный ответ. Сначала выясните, какой вызов поддерживает поставщик и можно ли выполнить его в пределах выданного разрешения.
Как принять интеграцию в российской команде
Назначьте одного человека от закупки и одного от разработки. Первый задаёт исходные значения и проверяет, что ожидаемый результат имеет смысл для кампании. Второй фиксирует фактический запрос и ответ. Для внутреннего кабинета попросите назвать версию операции. Для подрядчика достаточно попросить результат теста на доступной ему площадке, сопоставить его с документацией и договориться о сроке повторной проверки при обновлении API.
Храните в журнале идентификатор теста, версию адаптера, разрешённое изменение, фактически отправленные поля и подтверждённое состояние. В тестовых примерах используйте вымышленные кампании. В журнале реальной интеграции исключайте секреты, персональные данные и поля, которые не нужны для разбора. Если кабинет не позволяет наблюдать результаты с достаточной точностью, пусть агент предлагает изменения, а человек применяет их вручную.
Проверьте, что происходит между подготовкой запроса и его отправкой. Например, в 14:00 адаптер готовит снижение лимита для ночной смены. К моменту отправки менеджер уже мог изменить кампанию вручную. Когда платформа поддерживает условное обновление, привяжите его к актуальной версии. Если такой возможности нет, перечитайте кампанию перед отправкой, проверьте признаки конфликта и передайте сомнительные случаи человеку. Простая проверка чтением уменьшает число ошибок, но не устраняет гонку между чтением и записью.
Критерий приёмки можно записать в одной строке: запрос затронул только согласованные настройки, целевое значение подтверждено, соседние настройки сохранились, а человек может воспроизвести проверку по журналу. При провале любой части найдите источник расхождения до расширения доступа агента. О подтверждении результата после ответа платформы см. отдельный разбор. О привязке изменения к согласованной версии см. материал о согласовании. Термины собраны в глоссарии.





