# 通过 API 修改或撤销操作中的项目

除了修改和撤销操作外，impact.com 还允许您修改和撤销操作的项目级详细信息。

{% hint style="info" %}
**注意：** impact.com 对每个操作允许最多 1000 次修改。如果您之后需要进行更多修改， [联系支持](https://app.impact.com/support/portal.ihtml).
{% endhint %}

#### 通过 API 修改操作中的项目

如果您在项目级别跟踪（即在报告转化时传递项目数据），您可以使用 API 修改操作中项目的数量或报告的收入金额。

要修改操作中的项目，您将需要：

* 该 `ActionId` 操作的。
* 该 `原因` 用于更新该操作（当修改操作中的项目时，始终提交 `ORDER_UPDATE`).
* 该 `Sku` 要修改的项目的（可以在通过 API 检索操作时找到）。
* 新的 `数量` 项目的值。
* 新的收入 `金额` 项目的值——仅当此值发生更改时在调用中包含此项（例如，报告的项目收入金额被错误地报告）。

一旦您拥有所有这些值，请参阅下面的示例调用以了解如何修改操作中的项目。

<details>

<summary>示例调用与响应</summary>

**新的项目数量**

```bash
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 'Sku={Sku}' \
  -d 'Quantity={Quantity}' \
  -d 'Reason=ORDER_UPDATE' \
```

**新的项目收入金额**

```bash
  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 'Sku={Sku}' \
    -d 'Amount={Amount}' \
    -d 'Reason=ORDER_UPDATE' \
```

</details>

<details>

<summary>示例响应</summary>

```json
{
  "Status": "QUEUED",
  "QueuedUri": "/Advertisers/{AccountSID}/APISubmissions/A-86b9-56992f50eefe"
}
```

</details>

<details>

<summary>参数参考</summary>

| `AccountId` | 您在 impact.com 帐户的 API 帐户 ID 值。 [了解如何查找此值](https://help.impact.com/brand/zh/account-administration/account-settings/api-tokens/manage-api-access-tokens-as-a-brand). |
| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `AuthToken` | 您在 impact.com 帐户的 API 授权令牌值。 [了解如何查找此值](https://help.impact.com/brand/zh/account-administration/account-settings/api-tokens/manage-api-access-tokens-as-a-brand).   |
| `ActionId`  | 要修改的操作的 ID 值。                                                                                                                                                       |
| `Sku`       | 项目的库存保有单位值（SKU）——可在通过 API 检索操作时找到。                                                                                                                                  |
| `数量`        | 项目的新数量值。                                                                                                                                                            |
| `原因`        | 在撤销或修改项目时，始终提交 `ORDER_UPDATE` 作为原因。                                                                                                                                 |
| `金额`        | 项目的新收入金额值。                                                                                                                                                          |

</details>

#### 通过 API 撤销操作中的项目

如果您在项目级别跟踪（即在报告转化时传递项目数据），您可以通过设置来撤销一个或多个项目， `数量` 以 `0`.

要撤销操作中的项目，您将需要：

* 该 `ActionId` 操作的。
* 该 `原因` 用于更新该操作（当撤销操作中的项目时，始终提交 `ORDER_UPDATE`).
* 该 `Sku` 要撤销的项目的（可以在通过 API 检索操作时找到）。
* 新的 `数量` 项目的值——在这种情况下， `0`

一旦您拥有所有这些值，请参阅下面的示例调用以了解如何在操作中撤销项目。

<details>

<summary>示例调用与响应</summary>

```bash
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 'Sku={Sku}' \
  -d 'Quantity=0' \
  -d 'Reason=ORDER_UPDATE'
```

</details>

<details>

<summary>示例响应</summary>

```json
{
  "Status": "QUEUED",
  "QueuedUri": "/Advertisers/{AccountSID}/APISubmissions/A-86b9-56992f50eefe"
}  
```

</details>

<details>

<summary>参数参考</summary>

| `AccountId` | 您在 impact.com 帐户的 API 帐户 ID 值。 [了解如何查找此值](https://help.impact.com/brand/zh/account-administration/account-settings/api-tokens/manage-api-access-tokens-as-a-brand). |
| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `AuthToken` | 您在 impact.com 帐户的 API 授权令牌值。 [了解如何查找此值](https://help.impact.com/brand/zh/account-administration/account-settings/api-tokens/manage-api-access-tokens-as-a-brand).   |
| `ActionId`  | 要修改的操作的 ID 值。                                                                                                                                                       |
| `Sku`       | 项目的库存保有单位值（SKU）——可在通过 API 检索操作时找到。                                                                                                                                  |
| `数量`        | 项目的新数量值。                                                                                                                                                            |
| `原因`        | 在撤销或修改项目时，始终提交 `ORDER_UPDATE` 作为原因。                                                                                                                                 |

</details>
