API変更履歴の概要

以下は、Brand、Partner、Agency API の最近の更新の概要です。新機能、主な変更点、非推奨のお知らせが含まれます。

Brand

Brand の変更履歴は次の場所でご覧ください： Integrations Portal または 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 月 5 日に、 ZeroPayoutHideReport フィールドが /Contracts/<Id> brand エンドポイントに追加されました。
12.0	Catalogs エンドポイントの変更	2024 年 9 月 12 日に、 Currency および ServiceAreas フィールドが /Catalogs および /Catalogs/<CatalogId> brand エンドポイントに追加されました。
12.0	新しいエンドポイント: LegalEntities	新しい LegalEntities エンドポイントでは、アカウントに関連付けられた法的事業体について、請求先住所や間接税の詳細を含む法的事業体情報を取得できます。
12.0	Create a Partner エンドポイントの変更	2024 年 8 月 23 日に、 Create a Partner エンドポイントに変更が実施され、 PhoneNumber をパラメータとして追加し、 PromotionalMethods.
12.0	を非推奨にすることが含まれました。	アクションおよびアクション更新の変更
11.0	データを常に最新の状態に保ちましょう！	クライアントがデータをキャッシュして誤った情報や古い情報を受け取るのを防ぐため、レスポンスに新しいヘッダー値が追加されました。
11.0	遅延レスポンス エンドポイント	この DeferredResponse エンドポイントは、レポートまたはクリックのジョブを作成または再実行するために使用できます。
11.0	Reports エンドポイントのページネーションの変更	2023 年 10 月 2 日以降、 /Reports API エンドポイントに対して 20,000 以外のページサイズを指定したリクエストは、正確に 20,000 レコードのページサイズを返します。
11.0	新しいエンドポイント: レポートのエクスポート	この ReportExport エンドポイントが追加され、レポートを非同期でエクスポートするジョブをスケジュールできるようになりました。
10.0	Clicks エンドポイントは非推奨になりました	この Clicks エンドポイントは非推奨となり、新しい Jobs および ClickExport 機能に置き換えられました。
10.0	新しいエンドポイント: ClickExport と Jobs	2 つの新しいエンドポイント、 /ClickExport および /Jobs/が追加され、クリックデータを取得する機能が拡張および簡素化されました。
10.0	Catalogs エンドポイント更新	2022 年 3 月 1 日に、impact.com はバージョン 9 以前のすべての製品カタログ API エンドポイントを非推奨とし、ユーザーにバージョン 10 への更新を求めました。

Partner

Partner の変更履歴は次の場所でご覧ください： Integrations Portal または RSS.

バージョン	変更	説明
15.0	新しいエンドポイント: ID 検証セッションを作成する	この IdentityVerification エンドポイントは本人確認を行います。このエンドポイントは ID 検証セッションを作成または再開し、検証フローを開始するために使用できる URL を返します。
15.0	新しいエンドポイント: ExceptionLists と PromoCodeExceptionLists	新しい ExceptionLists および PromoCodeExceptionLists エンドポイントでは、SKU、カテゴリ、プロモコードの例外リストおよび例外リスト項目を取得できます。
15.0	スコープ付きトークン	impact.com では、スコープ付きトークンを作成できます。これは、特定の API エンドポイントへのアクセスを制限または許可する、詳細で細かく調整された権限を持つ API 認証情報です。
15.0	ReportExport への移行	impact.com API を介して大量のレポートデータをエクスポートしている場合、より効率的な ReportExport API エンドポイントに切り替えるのは今です。特に、従来の Reports API に 2025 年 9 月 1 日から制限が予定されているためです。
15.0	Contracts エンドポイントの変更	この Contracts API エンドポイントに現在 Scheduled Terms.
14.0	Contracts エンドポイントの変更	2025 年 3 月 5 日に、 ZeroPayoutHideReport フィールドが /Contracts/<Id> および /Contracts partner エンドポイントが含まれます。
14.0	新しいエンドポイント: 必須の銀行情報フィールドを取得	この /WithdrawalSettings/RequiredFields エンドポイントでは、指定した国の必須の銀行情報フィールドと、必要に応じて支払い方法を取得できます。
14.0	Catalogs エンドポイントの変更	2024 年 9 月 16 日に、 Currency および ServiceAreas フィールドが partner の Catalogs エンドポイントに追加されました。
14.0	を非推奨にすることが含まれました。	2024 年 8 月 5 日に、 Actions および ActionUpdates クエリのデータ整合性を確保し、API パフォーマンスを最適化するための変更が実施されました。
14.0	データを常に最新の状態に保ちましょう！	クライアントがデータをキャッシュして誤った情報や古い情報を受け取るのを防ぐため、レスポンスに新しいヘッダー値が追加されました。
14.0	新しいエンドポイント: 税務書類	4 つの新しい Tax Document エンドポイントが追加され、税務書類の取得、作成、一覧表示が可能になりました。
14.0	Reports エンドポイントのページネーションの変更	2023 年 10 月 2 日以降、 /Reports API エンドポイントに対して 20,000 以外のページサイズを指定したリクエストは、正確に 20,000 レコードのページサイズを返します。
12.0	新しいエンドポイント: レポートのエクスポート	この ReportExport エンドポイントが追加され、レポートを非同期でエクスポートするジョブをスケジュールできるようになりました。
12.0	Clicks エンドポイントは非推奨になりました	この Clicks エンドポイントは非推奨となり、新しい Jobs データ抽出のための機能。
12.0	新しいエンドポイント: ClickExport と Jobs	2 つの新しいエンドポイント、 /ClickExport および /Jobs/が追加され、クリックデータを取得する機能が拡張および簡素化されました。
12.0	Catalogs エンドポイントのバージョン更新	2022 年 3 月 1 日に、impact.com はバージョン 11 以前のすべての製品カタログ API エンドポイントを非推奨とし、バージョン 12 への更新を求めました。

Agency

Agency の変更履歴は次の場所でご覧ください： Integrations Portal または RSS.

バージョン	変更	説明
3.0	ReportExport への移行	impact.com API を介して大量のレポートデータをエクスポートしている場合、より効率的な ReportExport API エンドポイントに切り替えるのは今です。特に、従来の Reports API に 2025 年 9 月 1 日から制限が予定されているためです。
3.0	データを常に最新の状態に保ちましょう！	クライアントがデータをキャッシュして誤った情報や古い情報を受け取るのを防ぐため、レスポンスに新しいヘッダー値が追加されました。
3.0	Reports エンドポイントのページネーションの変更	2023 年 10 月 2 日以降、 /Reports API エンドポイントに対して 20,000 以外のページサイズを指定したリクエストは、正確に 20,000 レコードのページサイズを返します。
2.0	新しいエンドポイント: レポートのエクスポート	この ReportExport エンドポイントが追加され、レポートを非同期でエクスポートするジョブをスケジュールできるようになりました。