通过 API（Web 服务）批量修改或撤销

参加 PXA 课程

如果某个操作的任何内容发生变化（例如，订单被取消、商品被退回等），您可以使用 API 对其进行修改（或撤销），从而更改该操作的佣金金额。

批处理撤销选项：

• 通过 API 修改或撤销操作中的一个或多个项目

• 通过 API 撤销整个操作

先决条件：检索 ActionId 值

要修改操作数据，您需要其 ActionId 值。然后可以使用此值通过 API 查找要修改的操作。

• 您可以在调用中指定日期范围——否则，该端点默认为显示最近 30 天的操作。

• 速率限制 适用。

• 查看 列出所有操作 API 端点文档以了解更多信息。

常见问题

如何重置对某个操作（或操作项）所做的修改/撤销？

如果在操作的锁定日期之前对其进行了修改或撤销，您可以提交 RESET 作为将操作更新回默认状态的原因：

curl 'https://api.impact.com/Advertisers/{AccountSID}/Actions' \
  -X PUT \
  -u '{AccountSID}:{AuthToken}' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/x-www-form-urlencoded' \
  -d 'ActionId={ActionId}' \
  -d 'Reason=RESET'

通过 RESET 代码重置的操作可能在报告中显示不正确（例如，收入值可能计算不正确）。

处置代码与原因有何不同？

两者 处置代码 和 原因 在相同的上下文中使用—— 原因 是 API 默认接受的预定义代码，而 处置代码 是您可以配置的自定义原因。 了解有关处置代码的更多信息.

支持的原因代码：

如何查看何时对操作应用了修改/撤销？

您可以使用 操作更新 端点来查看操作的最后更新时间及其当前状态。

注意： 一个 ActionUpdatesID 值不同于一个 ActionId 值——您必须使用 ActionUpdatesID 值来检索某个操作的更新。