API変更履歴の概要

以下は、Brand、Partner、および Agency API の最近の更新の要約です。新機能、主要な変更点、および廃止通知が含まれます。

ブランド

Brand チェンジログを次で表示してください： Integrations ポータル または RSS.

バージョン	変更	説明
13.0	新しいエンドポイント：PromoCodeExceptionLists	この PromoCodeExceptionLists エンドポイントを使用すると、プロモコード例外リストを作成、更新、取得、削除できます。
13.0	スコープ付きトークン	impact.com ではスコープ付きトークンを作成できます。これらは詳細かつ細かく調整された権限を持つ API 資格情報で、特定の API エンドポイントへのアクセスを制限または許可します。
13.0	ReportExport への移行	影響力の大きい量のレポートデータを impact.com API 経由でエクスポートする場合は、より効率的な ReportExport API エンドポイントに切り替える時期です。特に、従来の Reports API が 2025 年 9 月 1 日に制限される予定があるためです。
13.0	新しいエンドポイント：Upload	新しい Upload エンドポイントでは、カタログを API 経由でアップロードできます。
13.0	Contracts エンドポイントの変更	この Contracts API エンドポイントに Scheduled Terms が含まれるようになりました。
12.0	/Ads エンドポイントの改善	私たちは /Ads エンドポイントを強化し、impact.com から広告の詳細を取得する方法に対する制御を向上させました。
12.0	Contracts エンドポイントの変更	2025 年 3 月 05 日に、 ZeroPayoutHideReport フィールドが追加されました。 /Contracts/<Id> ブランド エンドポイントに。
12.0	Catalogs エンドポイントの変更	2024 年 9 月 12 日に、 Currency および ServiceAreas フィールドが追加されました。 /Catalogs および /Catalogs/<CatalogId> ブランド エンドポイントに。
12.0	新しいエンドポイント：LegalEntities	新しい LegalEntities エンドポイントでは、請求先住所や間接税の詳細を含む、アカウントに関連付けられた法的実体の情報を取得できます。
12.0	Create a Partner エンドポイントの変更	2024 年 8 月 23 日に、次の変更が実施されました： Create a Partner エンドポイントに対して、 PhoneNumber をパラメータとして追加し、 PromotionalMethods.
12.0	を非推奨にしました。	アクションおよびアクション更新への変更
11.0	2024 年 8 月 5 日に、データ整合性を確保し API パフォーマンスを最適化するための変更が実施され、クエリの日付範囲の制限などが含まれます。	データが常に最新であることを確認してください！
11.0	クライアントがデータをキャッシュして誤ったまたは古い情報を受け取らないように、レスポンスに新しいヘッダー値が追加されました。	この Deferred Response エンドポイント DeferredResponse
11.0	エンドポイントは、レポートまたはクリックのジョブを作成または再実行するために使用できます。	Reports エンドポイントのページネーションの変更 2023 年 10 月 2 日以降、 /Reports
11.0	API エンドポイントに対してページサイズを 20,000 以外で指定したリクエストは、正確に 20,000 レコードのページサイズを返します。	この ReportExport 新しいエンドポイント：レポートのエクスポート
10.0	このエンドポイントは、レポートを非同期にエクスポートするジョブをスケジュールするために追加されました。	この Clicks エンドポイントは非推奨になりました Clicks エンドポイントは非推奨となり、新しい および Jobs および
10.0	ClickExport	機能に置き換えられました。 新しいエンドポイント：ClickExport & Jobs および 2 つの新しいエンドポイント、/ClickExport
10.0	/Jobs/	が追加され、クリックデータを取得する機能が拡張および簡素化されました。

Catalogs エンドポイントの更新

2022 年 3 月 1 日に、impact.com は製品カタログ API エンドポイントのバージョン 9 以下をすべて非推奨とし、ユーザーにバージョン 10 へアップグレードすることを要求しました。 Integrations ポータル または RSS.

バージョン	変更	説明
15.0	パートナー	この Partner チェンジログを次で表示してください： 新しいエンドポイント：本人確認セッションの作成
15.0	IdentityVerification	新しい エンドポイントは本人確認を行います。このエンドポイントは本人確認セッションを作成または再開し、確認フローを開始するための URL を返します。 および PromoCodeExceptionLists 新しいエンドポイント：ExceptionLists & PromoCodeExceptionLists
15.0	スコープ付きトークン	impact.com ではスコープ付きトークンを作成できます。これらは詳細かつ細かく調整された権限を持つ API 資格情報で、特定の API エンドポイントへのアクセスを制限または許可します。
15.0	ReportExport への移行	影響力の大きい量のレポートデータを impact.com API 経由でエクスポートする場合は、より効率的な ReportExport API エンドポイントに切り替える時期です。特に、従来の Reports API が 2025 年 9 月 1 日に制限される予定があるためです。
15.0	Contracts エンドポイントの変更	この Contracts ExceptionLists エンドポイントを使用すると、SKU、カテゴリ、およびプロモコードの例外リストと例外リスト項目を取得できます。.
14.0	Contracts エンドポイントの変更	2025 年 3 月 05 日に、 ZeroPayoutHideReport フィールドが追加されました。 /Contracts/<Id> および API エンドポイントに Scheduled Terms
14.0	/Contracts	この パートナー エンドポイントが含まれるようになりました。 新しいエンドポイント：必要な銀行情報フィールドの取得
14.0	/WithdrawalSettings/RequiredFields	エンドポイントを使用すると、指定した国の必須銀行フィールドおよびオプションで支払い方法を取得できます。 Currency および ServiceAreas Catalogs エンドポイントへの変更 2024 年 9 月 16 日に、 フィールドがパートナー
14.0	を非推奨にしました。	Catalogs エンドポイントに追加されました。 および 2024 年 8 月 5 日に、データ整合性を確保し API パフォーマンスを最適化するための変更が、 Actions
14.0	2024 年 8 月 5 日に、データ整合性を確保し API パフォーマンスを最適化するための変更が実施され、クエリの日付範囲の制限などが含まれます。	データが常に最新であることを確認してください！
14.0	および	ActionUpdates
14.0	エンドポイントは、レポートまたはクリックのジョブを作成または再実行するために使用できます。	Reports エンドポイントのページネーションの変更 2023 年 10 月 2 日以降、 /Reports
12.0	API エンドポイントに対してページサイズを 20,000 以外で指定したリクエストは、正確に 20,000 レコードのページサイズを返します。	この ReportExport 新しいエンドポイント：レポートのエクスポート
12.0	このエンドポイントは、レポートを非同期にエクスポートするジョブをスケジュールするために追加されました。	この Clicks エンドポイントは非推奨になりました Clicks エンドポイントは非推奨となり、新しい クエリに対して実施されました。
12.0	ClickExport	機能に置き換えられました。 新しいエンドポイント：ClickExport & Jobs および 2 つの新しいエンドポイント、/ClickExport
12.0	新しいエンドポイント：税務書類	4 つの新しい税務書類エンドポイントが追加され、税務書類の取得、作成、一覧表示が可能になりました。

データ抽出のための機能。

Catalogs エンドポイントのバージョン更新について：2022 年 3 月 1 日に、impact.com は製品カタログ API エンドポイントのバージョン 11 以下をすべて非推奨とし、バージョン 12 への更新を求めました。 Integrations ポータル または RSS.

バージョン	変更	説明
3.0	ReportExport への移行	影響力の大きい量のレポートデータを impact.com API 経由でエクスポートする場合は、より効率的な ReportExport API エンドポイントに切り替える時期です。特に、従来の Reports API が 2025 年 9 月 1 日に制限される予定があるためです。
3.0	2024 年 8 月 5 日に、データ整合性を確保し API パフォーマンスを最適化するための変更が実施され、クエリの日付範囲の制限などが含まれます。	データが常に最新であることを確認してください！
3.0	エンドポイントは、レポートまたはクリックのジョブを作成または再実行するために使用できます。	Reports エンドポイントのページネーションの変更 2023 年 10 月 2 日以降、 /Reports
2.0	API エンドポイントに対してページサイズを 20,000 以外で指定したリクエストは、正確に 20,000 レコードのページサイズを返します。	この ReportExport 新しいエンドポイント：レポートのエクスポート