Три разных подтверждения

Первое подтверждение касается самого запроса. Сервис мог принять его и выдать идентификатор операции, которую выполнит позже. В опубликованном руководстве Google AIP-151 для долгих операций есть объект, по которому клиент проверяет выполнение и получает итог либо ошибку. Это общая рекомендация для API, а не описание конкретной рекламной платформы. AIP-151

Второе подтверждение означает, что операция завершилась с определённым результатом. Если сервис сообщает об успешном завершении, отдельное чтение кампании всё равно может временно показывать более ранние данные. В документации AWS EC2 приведён пример, когда создание ресурса завершилось, а следующее обращение по его идентификатору ещё возвращает отсутствие объекта. AWS рекомендует сверять состояние с повторным чтением и увеличивать интервал. Пример поясняет механизм задержки. Он не устанавливает такую задержку в рекламном кабинете. AWS EC2 API

Третье подтверждение даёт чтение объекта, который важен пользователю. Оно должно показать именно тот лимит и ту кампанию, о которых шла речь. Если правила кампании применяются по расписанию, отдельно уточните время вступления лимита в силу. Новая цифра в настройках сама по себе не подтверждает, что прежний расход уже ограничен.

Что агенту сохранить перед записью

Сохраните идентификатор кабинета и кампании, исходное значение, согласованное новое значение и время отправки. Если API отдаёт версию объекта или отметку изменения, добавьте её в журнал. После ответа запишите идентификатор операции и результат. По журналу можно понять, возвращает ли API старые настройки или кто-то уже изменил лимит. По возможности читайте состояние из того метода, который поставщик называет основным для настроек кампании. Экспорт аналитики может обновляться по другому расписанию.

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

Четыре прогона перед внедрением

В учебном журнале у кампании A сначала есть только номер операции. Когда операция завершится, понадобится контрольное чтение. В кампании B операция успешна, но чтение показывает старую версию и прежние 9 000 рублей. Ожидание ещё не истекло. На втором чтении видна следующая версия и новые 7 000 рублей. Только тогда запись получает статус подтверждённой.

Кампания C показывает другое значение в более новой версии. В этом тесте оператор успел поменять лимит сам. Агент оставляет обе записи и сообщает о конфликте. У кампании D по истечении согласованного окна по-прежнему видна старая версия. Результат остаётся неподтверждённым. Журнал не требует считать запрос провалившимся и не даёт права автоматически писать поверх возможного изменения.

Для проверки выберите стенд, где можно задавать порядок ответов. Два прогона должны отличаться только тем, успело ли обновиться чтение. В остальных меняйте состояние операции или версию записи, сохраняя тот же лимит задания. Это учебная модель ответа API. Допустимое время ожидания и возможность увидеть версии проверяют у поставщика отдельно.

Как принять автоматизацию в российском кабинете

Попросите команду интеграции показать, что агент корректно отражает промежуточный статус на конкретной площадке. Для ручного режима без номера операции достаточно сохранить квитанцию ответа, сделать контрольное чтение и согласовать правило эскалации. По данным доставки отдельно проверьте, идёт ли реклама и начал ли новый лимит ограничивать расход.

В интерфейсе оператора полезны конкретные статусы. «Команда принята» означает, что система вернула квитанцию. «Лимит подтверждён» означает, что при повторном запросе API вернул согласованный лимит. «Нужна сверка» показывает конфликт или истёкшее ожидание. Как защищаться от создания второй кампании при повторе команды, разбираем в статье об идемпотентности. Как связать команду с утверждённой версией, см. разбор согласования и глоссарий.