概要
Javascript APIに新しい機能が追加されると、バージョン番号が上がります。クライアントはAPIリクエストにバージョン番号を含めることができます。サーバーは、リクエストされたバージョンをサポートする限り、クライアントが理解できる応答を返します。
マイナーバージョンの変更は下位互換性を意図しているため、サーバーはクライアントがリクエストしたよりも後のバージョンで応答する可能性があります。たとえば、クライアントがバージョン2.0をリクエストしている場合に、サーバーがバージョンを2.1に設定して応答を送信することがあります。
APIの大幅な変更は、メジャーバージョン番号を変更することで反映されます。サーバーは、常にクライアントがリクエストしたのと同じメジャーバージョン番号を使用して応答を返します。サーバーが同じメジャーバージョン番号を使用して応答を送信できない場合は、エラーが返されます。
バージョン |
説明 |
|---|---|
1.0 |
Javascript APIの初期リリース。セキュリティが無効でユーザー認証なしのレポートのみをサポート。 |
1.1 |
ユーザー認証を含むように更新。 |
2.0 |
Javascript APIのメジャー更新。ダッシュボードの埋め込み、レポートとダッシュボードのフィルタリング強化、操作性やUIの強化多数。 |
2.1 |
ユニバーサル識別子によるレポートおよびフィルターのロードをサポートするように更新。 |