# API経由で一括変更または取り消しする

<a href="https://pxa.impact.com/student/activity/2268418?sid=0c0e3e5c-54c9-4435-9bee-ebcdccb7f292&#x26;sid_i=0?utm_source=app.impact.com&#x26;utm_medium=owned-platform&#x26;utm_content=&#x26;utm_campaign=help-center" class="button primary">PXAコースを受講する</a>

アクションの内容に何らかの変更（例：注文のキャンセル、商品の返品など）があった場合、API を使用してその内容を変更（または取り消し）し、アクションのコミッション額を変更できます。&#x20;

### どの送信方法が適していますか？

### API の取り消しオプション：

* [API 経由でアクション内の1つ以上のアイテムを変更または取り消す](https://integrations.impact.com/impact-brand/reference/update-an-action-item)
* [API 経由でアクション全体を取り消す](https://integrations.impact.com/impact-brand/reference/reverse-an-action)

### 前提条件：次を取得する *ActionId* 値

API 経由でアクションデータを変更するには、その `ActionId` 値が必要です。これを使用して、API 経由で変更したいアクションを見つけることができます。

* 呼び出し時に日付範囲を指定できます。指定しない場合、エンドポイントは既定で直近30日間のアクションを表示します。
* [レート制限が](https://integrations.impact.com/impact-brand/reference/rate-limits) 適用されます。
* 次を表示 [すべてのアクションを一覧表示](https://integrations.impact.com/impact-brand/reference/list-all-actions) API エンドポイントのドキュメントで詳細をご確認ください。

### よくある質問

<details>

<summary>アクション（またはアクション項目）に対して行った変更／取り消しをリセットするにはどうすればよいですか？</summary>

アクションがロック日の前に変更または取り消しされている場合、 `RESET` を理由として送信し、アクションを既定の状態に戻すことができます：

```programlisting
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` コードにより、レポートで正しく表示されない場合があります（例：収益値が誤って計算されることがあります）。

</details>

<details>

<summary>ディスポジションコードと理由の違いは何ですか？</summary>

どちらも *ディスポジションコード* および *理由* は同じ文脈で使用されます — *理由* は API が既定で受け入れる事前定義済みのコードであり、対して *ディスポジションコード* は設定可能なカスタム理由です。 [ディスポジションコードの詳細はこちら](https://help.impact.com/brand/ja/nitsuitebitaidesuka/platform-features/tracking/set-up-tracking/manage-disposition-codes).

対応する理由コード：

</details>

<details>

<summary>変更／取り消しがアクションに適用された時期を確認するにはどうすればよいですか？</summary>

次を使用できます [action updates](https://integrations.impact.com/impact-brand/reference/the-action-update-object) エンドポイントを使うと、アクションが最後に更新された時刻と現在の状態を確認できます。

{% hint style="info" %}
**注意:** ある `ActionUpdatesID` 値は `ActionId` 値とは異なります。アクションの更新を取得するには、 `ActionUpdatesID` 値を使用する必要があります。
{% endhint %}

</details>