# Unity Ads SDK API 弃用政策

> 查看 Unity 的 API 弃用准则。了解 SDK 更改的时间表、通知和例外。

> **Important:**
>
> 这些准则从 Unity Ads SDK 4.0.0 版开始生效。

Unity 鼓励您在开发时使用最能满足您需求的 API 集。但是，仍然鼓励所有开发者尽可能频繁地更新到最新的 SDK 版本。

为了确保 Unity 广告提供一致的最佳开发体验，必须继续发展和扩展 SDK 及其 API 类。随着我们适应平台和市场的变化，API 类会变得过时，需要替换为更高效的版本。

如果 Unity Ads 打算移除某个 API 类，或以破坏先前支持的功能的方式对其进行更改，Unity 将努力做到：

* 将 API 标记为[已弃用](#deprecation)，在发行说明中记录此弃用，并（如果适用）更新文档和示例，以便在下一个[主要或次要版本](##semantic-versioning)中提供偏好的替代方案。
* 在未来的主要版本中移除已弃用的 API。
* 以合理的方式尽可能通过使用弃用通知（请参阅[通知](#notifications)部分）提供不少于三 (3) 个月的关于移除已弃用 API 的通知。

## 异常##exceptions

上述弃用准则的例外情况如下：

* 由于适用法律或合同权利发生变化，Unity Ads 必须移除 API。
* 继续提供相关功能可能会产生安全性、合规性、数据隐私或其他监管风险，或在其他方面使 Unity 和/或其第三方合作伙伴和客户面临任何责任或损害风险（由 Unity 自行确定）。
* 继续提供相关功能可能会给 Unity 或其第三方合作伙伴和客户带来巨大的经济或技术负担（包括加重任何基础 Unity 服务的负担或威胁其完整性、性能或可用性；由 Unity 自行确定）。

## 通知##notifications

如果 API 过时，Unity Ads 将以合理的方式尽可能通过以下一种或多种方式提供弃用通知：

* 开发者在 [Unity Monetization（变现）后台](https://cloud.unity.com/monetization)上发布帖子。该帖子将包含弃用通知、替代 API（如果可用）以及要移除的目标 SDK 版本。
* 官方在[技术文档](/grow/ads.md)更新中说明替代 API（如果可用）；或
* 更新 SDK 变更日志中的一个部分以提供一些链接，通过这些链接即可查看要弃用的类、适用的替换类以及预计的生命周期结束日期等更多详细信息。

## 期望目标##what

在维护 API 类及其支持的功能时，我们希望尽可能确保与早期版本兼容。如果需要以不向后兼容的方式更改某些内容，Unity 广告会创建新资源、媒体类型或版本，并根据 API 弃用政策维护旧资源或媒体类型。

Unity Ads 将为所有已宣布的 API 弃用情况提供以下信息：

* 要移除的 API
* 已弃用的 SDK 版本
* 具有类似功能的换用 API
* 已移除（或将要移除）的 SDK 版本
* 弃用原因

## 这些准则的变更##changes

这些准则如有更改，恕不另行通知，Unity 保留自行决定随时修改其 API 弃用流程的权利。

## 定义和概念##definitions-and-concepts

### 弃用##deprecation

已弃用的 API 类仍可使用，但未来将不再受支持，并将在未来的版本中移除。

### 弃用通知##deprecation-notice

提供在即将发布的 SDK 版本中将替换 API 类的预先通知。这是开发者升级代码的好时机。

### 语义版本控制##semantic-versioning

Unity Ads SDK 遵循[语义版本控制标准](https://semver.org/)。只会在发布的主要版本中移除 API 类。

### API 向后兼容性##backward-compatability

Unity 尝试提供 API 参考中介绍的所有公共 API 的向后兼容性。开发者必须使用 API 参考中列出的支持的 API 来确保兼容性。