API 更新日志摘要

以下是 Brand、Partner 和 Agency API 的最新更新摘要，包括新功能、关键变更和弃用通知。

品牌

在以下位置查看 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> 品牌端点。
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	actions 和 action updates 的变更	于 2024 年 8 月 5 日，实施了多项更改以确保数据完整性并优化 API 性能，包括查询日期范围限制。
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	两个新端点， /ClickExport 和 /Jobs/，已添加以扩展并简化检索点击数据的能力。
10.0	Catalogs 端点更新	于 2022 年 3 月 1 日，impact.com 弃用了所有版本 9 及更早版本的产品目录 API 端点，要求用户升级到版本 10。

合作伙伴

在以下位置查看 Partner 更新日志： Integrations Portal 或通过 RSS.

版本	变更	说明
15.0	新端点：创建身份验证会话	这些 IdentityVerification 端点用于验证您的身份。该端点会创建或恢复一个身份验证会话，并返回一个可用于启动验证流程的 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 合作伙伴端点。
14.0	新端点：检索所需银行字段	这些 /WithdrawalSettings/RequiredFields 端点允许您检索指定国家/地区所需的银行字段，以及可选的支付方式。
14.0	Catalogs 端点变更	于 2024 年 9 月 16 日， Currency 和 ServiceAreas 字段已添加到合作伙伴 Catalogs 端点。
14.0	actions 和 action updates 的变更	于 2024 年 8 月 5 日，实施了多项更改，以确保 Actions 和 ActionUpdates 查询的数据完整性并优化 API 性能。
14.0	确保您的数据始终保持最新！	响应中新增了新的标头值，以防止客户端缓存数据并接收不正确或过时的信息。
14.0	新端点：Tax Documents	已新增四个 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	两个新端点， /ClickExport 和 /Jobs/，已添加以扩展并简化检索点击数据的能力。
12.0	Catalogs 端点版本更新	于 2022 年 3 月 1 日，impact.com 弃用了所有版本 11 及更早版本的产品目录 API 端点，要求更新到版本 12。

代理机构

在以下位置查看 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 已添加该端点，用于安排异步导出报表的作业。