破壊的変更 - AST API

AST API は絶えず変化しています。 変更の大部分は単に新しい機能を追加するだけですが、統合を調整する必要がある破壊的変更が発生することがあります。

このページでは、AST API の破壊的変更と見なされる変更について説明します。 また、破壊的変更と見なされない変更の例も示します。

注:

Xandr は、早期通知を提供することなく、バグを修正し、サービス ポリシーと法的義務 の一部 に準拠するように機能を調整し、アルファ版とベータ版の機能と製品を変更する権利を留保します。

破壊的変更

次の種類の変更は、破壊的変更と見なされます。

• イベント ハンドラー応答のフィールドの名前を削除または変更する (adObj api)
• イベント ハンドラーコールバック関数定義からのオブジェクトの削除
• AST メソッドの名前を削除または変更する (または showTag()などdefineTag())
• フィールドのデータ型の変更 (たとえば、オブジェクトの配列に変換された ID の配列)

注:

AST API に破壊的変更を導入する場合、45 日間の運用 (/ast.js) バージョンとして破壊的変更なしで AST のバージョンをサポートします。 この 45 日間に、新しいバージョン (破壊的変更を含む) が静的 URL (/v1.0.1/ast.js) で使用できるようになります。 45 日後に、破壊的変更バージョンが運用 URL に昇格されます。 AST の最新バージョンはすべて静的 URL を介して使用できるため、代わりに特定のバージョンを呼び出すことで、破壊的変更なしでバージョンを引き続き使用できます。

さらに、これらの変更と、破壊的変更期間中に各バージョンに正しく到達する方法を AST ユーザーに通知します。

AST プロトコルに対する破壊的変更は、 AST リリース履歴 ページで発表されます。 重大な変更が事前に通知されるように、更新プログラムをサブスクライブすることをお勧めします。 (Xandr クライアントの場合、破壊的変更はリリース ノートでも発表されます)。

破壊的でない変更の例

次の種類の変更は、破壊的変更とは見なされません。 このリストは網羅的ではありません。これらは、破壊的でない変更のほんの一例です。

• 必須ではない新しいフィールドの追加
• 新しい AST メソッドの追加
• フィールドを削除せずにフィールドを廃止する
• オブジェクト内のフィールド、配列内のオブジェクトなどの順序を変更します。