# API 更新日志摘要

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

<details>

<summary>品牌</summary>

在以下位置查看 Brand 更新日志： [Integrations Portal](https://integrations.impact.com/impact-brand/changelog) 或通过 [RSS](https://integrations.impact.com/impact-brand/changelog.rss).

| 版本   | 变更                                                                                                                                    | 说明                                                                                                                  |
| ---- | ------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- |
| 13.0 | [新端点：PromoCodeExceptionLists](https://integrations.impact.com/impact-brand/v13.0/changelog/new-endpoint-promocodeexceptionlist)       | 这些 `PromoCodeExceptionLists` 端点允许您创建、更新、检索和删除促销代码例外列表。                                                              |
| 13.0 | [范围限定令牌](https://integrations.impact.com/impact-brand/v13.0/changelog/v13-scoped-tokens)                                              | impact.com 允许您创建范围限定令牌：具有详细、精细权限的 API 凭证，用于限制或允许访问特定 API 端点。                                                        |
| 13.0 | [迁移到 ReportExport](https://integrations.impact.com/impact-brand/v13.0/changelog/v13-migrate-to-reportexport)                          | 如果您通过 impact.com API 导出大量报表数据，现在正是切换到更高效的 `ReportExport` API 端点的时候——尤其是在旧版 `Reports` API 将于 2025 年 9 月 1 日实施限制的情况下。 |
| 13.0 | [新端点：Upload](https://integrations.impact.com/impact-brand/v13.0/changelog/v13-new-endpoint-upload)                                    | 新的 `Upload` 端点允许您通过 API 上传目录。                                                                                       |
| 13.0 | [Contracts 端点变更](https://integrations.impact.com/impact-brand/v13.0/changelog/v13-changes-to-contract-endpoint)                       | 这些 `Contracts` API 端点现已包含 Scheduled Terms。                                                                          |
| 12.0 | [/Ads 端点改进](https://integrations.impact.com/impact-brand/v13.0/changelog/v12-filter-ads-by-the-date-of-their-creation-or-last-update) | 我们增强了 `/Ads` 端点，使您能够更灵活地控制如何从 impact.com 检索广告详细信息。                                                                  |
| 12.0 | [Contracts 端点变更](https://integrations.impact.com/impact-brand/v13.0/changelog/v12-change-to-contracts-endpoint)                       | 于 2025 年 3 月 5 日， `ZeroPayoutHideReport` 字段已添加到 `/Contracts/<Id>` 品牌端点。                                             |
| 12.0 | [Catalogs 端点变更](https://integrations.impact.com/impact-brand/v13.0/changelog/changes-to-catalog-endpoints)                            | 于 2024 年 9 月 12 日， `Currency` 和 `ServiceAreas` 字段已添加到 `/Catalogs` 和 `/Catalogs/<CatalogId>` 品牌端点。                   |
| 12.0 | [新端点：LegalEntities](https://integrations.impact.com/impact-brand/v13.0/changelog/new-endpoint-legalentities)                          | 新的 `LegalEntities` 端点允许您检索与您的账户关联的法人实体信息，包括账单地址和间接税详细信息。                                                            |
| 12.0 | [Create a Partner 端点变更](https://integrations.impact.com/impact-brand/v13.0/changelog/changes-to-the-create-a-partner-endpoint)        | 于 2024 年 8 月 23 日，对 `Create a Partner` 端点实施了更改，包括添加 `PhoneNumber` 作为参数，以及弃用 `PromotionalMethods`.                   |
| 12.0 | [actions 和 action updates 的变更](https://integrations.impact.com/impact-brand/v13.0/changelog/changes-to-actions-and-action-updates)    | 于 2024 年 8 月 5 日，实施了多项更改以确保数据完整性并优化 API 性能，包括查询日期范围限制。                                                              |
| 11.0 | [确保您的数据始终保持最新！](https://integrations.impact.com/impact-brand/v13.0/changelog/ensure-your-data-is-always-fresh)                        | 响应中新增了新的标头值，以防止客户端缓存数据并接收不正确或过时的信息。                                                                                 |
| 11.0 | [延迟响应端点](https://integrations.impact.com/impact-brand/v13.0/changelog/deferred-response-endpoint)                                     | 这些 `DeferredResponse` 端点可用于创建或重放报表或点击作业。                                                                            |
| 11.0 | [Reports 端点分页变更](https://integrations.impact.com/impact-brand/v13.0/changelog/changes-to-the-reports-endpoint-pagination)             | 在 2023 年 10 月 2 日之后，任何发送到 `/Reports` API 端点且指定页面大小不是 20,000 的请求，都将返回页面大小恰好为 20,000 条记录。                             |
| 11.0 | [新端点：导出报表](https://integrations.impact.com/impact-brand/v13.0/changelog/new-endpoint-export-a-report)                                 | 这些 `ReportExport` 已添加该端点，用于安排异步导出报表的作业。                                                                             |
| 10.0 | [Clicks 端点已弃用](https://integrations.impact.com/impact-brand/v13.0/changelog/clicks-endpoint-will-soon-be-deprecated)                  | 这些 `Clicks` 端点已被弃用，并由新的 `Jobs` 和 `ClickExport` 功能取代。                                                                |
| 10.0 | [新端点：ClickExport 和 Jobs](https://integrations.impact.com/impact-brand/v13.0/changelog/new-endpoints-clickexport-jobs)                 | 两个新端点， `/ClickExport` 和 `/Jobs/`，已添加以扩展并简化检索点击数据的能力。                                                                |
| 10.0 | [Catalogs 端点更新](https://integrations.impact.com/impact-brand/v13.0/changelog/catalogs-endpoint-update)                                | 于 2022 年 3 月 1 日，impact.com 弃用了所有版本 9 及更早版本的产品目录 API 端点，要求用户升级到版本 10。                                               |

</details>

<details>

<summary>合作伙伴</summary>

在以下位置查看 Partner 更新日志： [Integrations Portal](https://integrations.impact.com/impact-publisher/changelog) 或通过 [RSS](https://integrations.impact.com/impact-publisher/changelog.rss).

| 版本   | 变更                                                                                                                                                                    | 说明                                                                                                                  |
| ---- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- |
| 15.0 | [新端点：创建身份验证会话](https://integrations.impact.com/impact-publisher/reference/create-an-identity-verification-session)                                                    | 这些 `IdentityVerification` 端点用于验证您的身份。该端点会创建或恢复一个身份验证会话，并返回一个可用于启动验证流程的 URL。                                         |
| 15.0 | [新端点：ExceptionLists 和 PromoCodeExceptionLists](https://integrations.impact.com/impact-publisher/v15.0/changelog/new-endpoints-exceptionlists-promocodeexceptionlists) | 新的 `ExceptionLists` 和 `PromoCodeExceptionLists` 端点允许您检索 SKU、类别和促销代码的例外列表及例外列表项。                                     |
| 15.0 | [范围限定令牌](https://integrations.impact.com/impact-publisher/v15.0/changelog/v15-scoped-tokens)                                                                          | impact.com 允许您创建范围限定令牌：具有详细、精细权限的 API 凭证，用于限制或允许访问特定 API 端点。                                                        |
| 15.0 | [迁移到 ReportExport](https://integrations.impact.com/impact-publisher/v15.0/changelog/v15-migrate-to-reportexport)                                                      | 如果您通过 impact.com API 导出大量报表数据，现在正是切换到更高效的 `ReportExport` API 端点的时候——尤其是在旧版 `Reports` API 将于 2025 年 9 月 1 日实施限制的情况下。 |
| 15.0 | [Contracts 端点变更](https://integrations.impact.com/impact-publisher/v15.0/changelog/v15-change-to-contract-endpoint)                                                    | 这些 `Contracts` API 端点现已包含 `Scheduled Terms`.                                                                        |
| 14.0 | [Contracts 端点变更](https://integrations.impact.com/impact-publisher/v15.0/changelog/v14-change-to-contracts-endpoint)                                                   | 于 2025 年 3 月 5 日， `ZeroPayoutHideReport` 字段已添加到 `/Contracts/<Id>` 和 `/Contracts` 合作伙伴端点。                            |
| 14.0 | [新端点：检索所需银行字段](https://integrations.impact.com/impact-publisher/v15.0/changelog/new-endpoint-retrieve-required-banking-fields)                                        | 这些 `/WithdrawalSettings/RequiredFields` 端点允许您检索指定国家/地区所需的银行字段，以及可选的支付方式。                                            |
| 14.0 | [Catalogs 端点变更](https://integrations.impact.com/impact-publisher/v15.0/changelog/change-to-catalogs-endpoint)                                                         | 于 2024 年 9 月 16 日， `Currency` 和 `ServiceAreas` 字段已添加到合作伙伴 `Catalogs` 端点。                                            |
| 14.0 | [actions 和 action updates 的变更](https://integrations.impact.com/impact-publisher/v15.0/changelog/changes-to-actions-and-action-updates)                                | 于 2024 年 8 月 5 日，实施了多项更改，以确保 `Actions` 和 `ActionUpdates` 查询的数据完整性并优化 API 性能。                                        |
| 14.0 | [确保您的数据始终保持最新！](https://integrations.impact.com/impact-publisher/v15.0/changelog/ensure-your-data-is-always-fresh)                                                    | 响应中新增了新的标头值，以防止客户端缓存数据并接收不正确或过时的信息。                                                                                 |
| 14.0 | [新端点：Tax Documents](https://integrations.impact.com/impact-publisher/v15.0/changelog/new-endpoints-tax-documents)                                                     | 已新增四个 Tax Document 端点，允许您检索、创建和列出税务文件。                                                                              |
| 14.0 | [Reports 端点分页变更](https://integrations.impact.com/impact-publisher/v15.0/changelog/changes-to-the-reports-endpoint-pagination)                                         | 在 2023 年 10 月 2 日之后，任何发送到 `/Reports` API 端点且指定页面大小不是 20,000 的请求，都将返回页面大小恰好为 20,000 条记录。                             |
| 12.0 | [新端点：导出报表](https://integrations.impact.com/impact-publisher/v15.0/changelog/new-endpoint-export-a-report)                                                             | 这些 `ReportExport` 已添加该端点，用于安排异步导出报表的作业。                                                                             |
| 12.0 | [Clicks 端点已弃用](https://integrations.impact.com/impact-publisher/v15.0/changelog/clicks-endpoint-will-soon-be-deprecated)                                              | 这些 `Clicks` 端点已被弃用，并由新的 `Jobs` 功能用于数据提取。                                                                            |
| 12.0 | [新端点：ClickExport 和 Jobs](https://integrations.impact.com/impact-publisher/v15.0/changelog/new-endpoints-clickexport-jobs)                                             | 两个新端点， `/ClickExport` 和 `/Jobs/`，已添加以扩展并简化检索点击数据的能力。                                                                |
| 12.0 | [Catalogs 端点版本更新](https://integrations.impact.com/impact-publisher/v15.0/changelog/catalogs-endpoint-versions-update)                                                 | 于 2022 年 3 月 1 日，impact.com 弃用了所有版本 11 及更早版本的产品目录 API 端点，要求更新到版本 12。                                                |

</details>

<details>

<summary>代理机构</summary>

在以下位置查看 Agency 更新日志： [Integrations Portal](https://integrations.impact.com/impact-agency/changelog) 或通过 [RSS](https://integrations.impact.com/impact-agency/changelog.rss).

| 版本  | 变更                                                                                                                        | 说明                                                                                                                  |
| --- | ------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- |
| 3.0 | [迁移到 ReportExport](https://integrations.impact.com/impact-agency/v3.0/changelog/v3)                                       | 如果您通过 impact.com API 导出大量报表数据，现在正是切换到更高效的 `ReportExport` API 端点的时候——尤其是在旧版 `Reports` API 将于 2025 年 9 月 1 日实施限制的情况下。 |
| 3.0 | [确保您的数据始终保持最新！](https://integrations.impact.com/impact-agency/v3.0/changelog/ensure-your-data-is-always-fresh)            | 响应中新增了新的标头值，以防止客户端缓存数据并接收不正确或过时的信息。                                                                                 |
| 3.0 | [Reports 端点分页变更](https://integrations.impact.com/impact-agency/v3.0/changelog/changes-to-the-reports-endpoint-pagination) | 在 2023 年 10 月 2 日之后，任何发送到 `/Reports` API 端点且指定页面大小不是 20,000 的请求，都将返回页面大小恰好为 20,000 条记录。                             |
| 2.0 | [新端点：导出报表](https://integrations.impact.com/impact-agency/v3.0/changelog/new-endpoint-export-a-report)                     | 这些 `ReportExport` 已添加该端点，用于安排异步导出报表的作业。                                                                             |

</details>