Unity Ads API の非推奨ポリシー
API の非推奨に関する Unity のガイドラインを確認します。SDK の変更のタイムライン、通知、例外を確認します。
読み終わるまでの所要時間 1 分最終更新 7日前
重要
これらのガイドラインは、Unity Ads SDK 4.0.0 のリリースから有効になります。
開発時にニーズに合った最適なAPIセットを使用することが推奨されますが、推奨されるベスト プラクティスは、すべての開発者ができるだけ頻繁に最新のSDKバージョンに更新することです。
Unity Ads が最適化された一貫性のある開発体験を配信するようにするために、SDK とその API クラスの進化と拡張を継続する必要があります。プラットフォームと市場の変化に適応していくと、API クラスは古くなり、より効果的なバージョンに置き換えることが必要になります。
Unity Ads が API クラスを削除しようとする場合、またはそれまでサポートされていた機能が破棄されるような方法で変更しようとする場合、Unity は以下のように努めます。
- API に 非推奨 のラベルを付け、廃止予定であることをリリース注に注記します。また、(該当する場合は) ドキュメントとサンプルを更新して、次の メジャーまたはマイナーリリース で推奨される代替機能を提供します。
- 非推奨の API は将来のメジャーリリースで削除します。かつ
- 非推奨通知を使用した非推奨の API の削除の通知期間が 3 か月未満とならないよう、十分に努力します (通知 のセクションを参照してください)。
例外
上記の非推奨ガイドラインに対する例外は以下のような場合です。
- Unity Ads が、適用法または契約に基づくその権利の変更の結果として API を削除する必要がある場合。
- 機能の提供を継続すると、セキュリティ、コンプライアンス、データプライバシー、またはその他の規制上のリスクを生じさせる可能性があるか、Unity またはそのサードパーティパートナーとクライアント、あるいはその両者を、不利益または損害のリスク (Unity が独自の裁量で決定) にさらす可能性がある場合。または
- 機能の提供を継続すると、Unity が独自の裁量で決定するとおり、Unity またはそのサードパーティパートナーとクライアントに相当な経済的または技術的負担を生じさせる可能性がある場合 (基になるいずれかの Unity サービスに対する過度の負担、またはその整合性、パフォーマンスまたは可用性に対する脅威を含む)。
お知らせ
API が古くなると、Unity Ads は以下の 1 つ以上を使用して非推奨通知を提供するよう十分に努力します。
- Unity Ads の Monetization (収益化) ダッシュボード への開発者コミュニケーション。この掲載には、非推奨通知、代替 API (使用可能な場合) および削除の対象となる SDK バージョンが含まれます。
- 代替 API (使用可能な場合) を含む公式 技術ドキュメント の更新。または
- SDK 変更ログの、非推奨になるクラス、適用可能な置換クラス、サポート終了予定日に関する詳細情報へのリンクを含むセクションの更新。
サービス内容
可能な限り、API クラスとそれによりサポートされる機能は、以前のバージョンと互換性のある形式で維持されます。後方互換性のない方法で変更が必要な場合、Unity Ads は新しいリソース、メディアタイプ、またはバージョンを作成し、古いリソースまたはメディアタイプは API 非推奨ポリシーに従って維持されます。
Unity Ads は、発表されたすべての API 廃止予定について以下の情報を提供します。
- 削除対象の API
- それが非推奨となる SDK バージョン
- 同様の機能を実現するために代わりに使用する API
- それが削除された (または削除される予定の) SDK バージョン
- 非推奨の理由
本ガイドラインに対する変更
本ガイドラインは予告なく変更されることがあり、Unity はその API の廃止プロセスを独自の裁量でいつでも変更する権利を留保します。
定義と概念
非推奨
非推奨の API クラスは引き続き使用できますが、将来的にサポートされなくなり、今後のリリースで削除される予定です。
非推奨通知
今後の SDK リリースで API クラスが置換されることを事前に通知します。これは、開発者が自身のコードをアップグレードするのに適したタイミングです。
セマンティックバージョニング
Unity Ads SDK は セマンティックバージョニング標準 に従います。API クラスは、メジャーバージョンリリースでのみ削除されます。
API 後方互換性
Unity は、API リファレンスに記載されているすべてのパブリック API に後方互換性を提供するよう努めています。開発者は、API リファレンスに一覧されているサポート対象の API を使用して互換性を確保する必要があります。