Unity Ads API deprecation policy
Review Unity's guidelines on API deprecation. Check timelines, notifications, and exceptions for SDK changes.
読み終わるまでの所要時間 1 分最終更新 1日前
重要
These guidelines are effective beginning with the release of Unity Ads SDK 4.0.0.
- Label the API as deprecated, note the deprecation in the release notes, and (if applicable) update documentation and samples to provide a preferred alternative in the next major or minor release.
- Remove the deprecated API in a future major release; and
- Use reasonable efforts to provide no less than three (3) months' notice of the removal of a deprecated API by using a Deprecation Notice (refer to the section on Notifications).
Exceptions
Exceptions to the aforementioned deprecation guidelines are cases where:- Unity Ads must remove an API as a result of a change in applicable law or its rights under contract;
- Continuing to provide the functionality could create a security, compliance, data privacy or other regulatory risk, or otherwise expose Unity and/or its third party partners and clients to any risk of liability or harm (as determined by Unity in it sole discretion); or
- Continuing to provide the functionality could create a substantial economic or technical burden to Unity or to its third party partners and clients (including by overburdening, or threatening the integrity, performance or availability of, any underlying Unity services), as determined by Unity in its sole discretion.
Notifications
If an API becomes obsolete, Unity Ads will use reasonable efforts to provide a Deprecation Notice by using one or more of the following:- Developer communication(s) to the Unity Ads Monetization dashboard. The post will contain the Deprecation Notice, the alternative API (if available), and the target SDK version for removal;
- Official technical documentation updates containing the alternative API (if available); or
- Updates to the SDK changelog in a section that contains links to more detailed information about which classes are being deprecated, applicable replacement classes, and the projected end of life date.
What to expect
Wherever possible, API classes and their supported functionality are maintained in a manner that is compatible with earlier versions. If it is necessary to change something in a way that is not backwards compatible, Unity Ads creates a new resource, media type, or version, and the old resource or media type is maintained in accordance with the API deprecation policy. Unity Ads will provide the following information for all announced API deprecations:- The API to be removed
- The SDK version that it was deprecated
- The API to use instead for similar functionality
- The SDK version that it was (or will be) removed
- The reason for deprecating it