API 更新日志摘要

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

品牌

在以下位置查看 Brand 更新日志： 集成门户.

版本	变更	描述
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	新端点：上传	新的 上传 端点允许您通过 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	确保您的数据始终是最新的！	响应中添加了新的 header 值，以防止客户端缓存数据并接收错误或过时的信息。
11.0	延迟响应端点	该 DeferredResponse 端点可用于创建或重放报告或 clicks 作业。
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 更新日志： 集成门户 或通过 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 日，已实施变更以确保数据完整性并优化以下 API 性能： Actions 和 ActionUpdates 查询。
14.0	确保您的数据始终是最新的！	响应中添加了新的 header 值，以防止客户端缓存数据并接收错误或过时的信息。
14.0	新端点：税务文档	已添加四个新的税务文档端点，使您能够检索、创建和列出税务文档。
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 更新日志： 集成门户 或通过 RSS.

版本	变更	描述
3.0	迁移到 ReportExport	如果您通过 impact.com API 导出大量报告数据，现在是时候切换到更高效的 ReportExport API 端点了——尤其是随着即将对旧版 Reports API 于 2025 年 9 月 1 日实施限制。
3.0	确保您的数据始终是最新的！	响应中添加了新的 header 值，以防止客户端缓存数据并接收错误或过时的信息。
3.0	Reports 端点分页变更	在 2023 年 10 月 2 日之后，对 /Reports API 端点发出的任何请求，如果指定的页面大小不是 20,000，则将返回恰好 20,000 条记录的页面大小。
2.0	新端点：导出报告	该 ReportExport 端点已添加，用于安排异步导出报告的作业。