Microsoft Graph REST API の新しいバージョンがリリースされると、以前のバージョンは廃止されます。 Microsoft は、バージョンを廃止する少なくとも 24 か月前に非推奨として宣言します。 同様に、一般提供 (GA) に達した個々の API の場合、Microsoft は、API を GA バージョンから削除する少なくとも 24 か月前に非推奨として宣言します。
API が非推奨と指定された場合、できるだけ早く最新バージョンへ移行することを強くお勧めします。 場合によっては、元の API が非推奨になった直後に、新しいアプリケーションで新しい API の使用を開始する必要があることをお知らせします。 そのような場合、現在非推奨 APIを使用しているアクティブなアプリケーションのみが使用し続けることができます。
API コントラクトと非バックワード互換性の変更
Microsoft Graph にはバージョン更新の変更履歴があります。 これらの変更は、 Microsoft Graph の変更ログに一覧表示されます。 新しい機能とデータが Microsoft Graph に追加されると、API に対するバックワード互換性のない変更に対して API バージョン番号がインクリメントされます。
非バックワード互換性の変更の例を次に示します。
URL またはリソースに関する基本的な要求や応答の変更
宣言済みプロパティの型の削除、変更と、その名前の変更
API と API パラメーターの削除または名前の変更
必須の要求ヘッダーの追加
次に、下位互換性のある変更の例を示します。
Null 許容型プロパティや既定値を持つプロパティの追加
列挙型へのメンバーの追加
オープン拡張情報の削除、変更と、その名前の変更
注釈の削除、変更と、その名前の変更
既存のコレクションへのページングの導入
エラー コードの変更
プロパティの順序の変更
リソース ID のような不透明な文字列の長さまたは形式の変更
手記: 時間の経過と同時に、下位互換性のある変更の一覧を更新します。 独自のクライアント プロクシ (WCF クライアントなど) を作成する場合、ガイドラインとしては Microsoft Graph API サービスにあらかじめ定義されていないプロパティや派生型をクライアント アプリケーションが受け入れることができるように準備してください。 Microsoft Graph API は「Microsoft REST API ガイドライン」の「バージョン管理のモデル」セクションの説明に従っています。
バージョン
現在、以下のバージョンの Microsoft Graph API が使用できます。
ベータ版
一般に、API はベータ版でデビューし、https://graph.microsoft.com/beta エンドポイントでアクセスできます。 ベータ版 API のドキュメントは、「Microsoft Graph ベータ エンドポイント リファレンス」を参照してください。 ベータ版には随時 API の重大な変更と廃止が発生することがあります。 運用アプリケーションでのベータ API の使用はサポートされていません。
ベータ版の機能が現行バージョンに採用される保証はありません。 Microsoft Graph API チームは、ベータ機能が一般提供の準備ができていると判断すると、その機能を最新バージョンに追加します。 機能の昇格によって現在のバージョンに破壊的変更が発生する場合は、バージョン番号がインクリメントされ、新しいバージョンが現在のバージョンになります。
現在のバージョン
Microsoft Graph の現在のバージョンは、v1.0 です。 これらの API はエンドポイントで https://graph.microsoft.com/v1.0 アクセスできます。 Microsoft Graph API v1.0 バージョンには、一般公開され、運用環境で使用できる機能が含まれています。 v1.0 API のドキュメントについては、「 Microsoft Graph v1.0 エンドポイント リファレンス」を参照してください。
プレビューの状態
Microsoft Graph の API または機能には、その動作がベータ エンドポイントで 一意 であることを示す "(プレビュー)" というラベルが付けられます。
v1.0 バージョンのほとんどの API と機能の動作は、ベータ版バージョンと同等です。 一部の API は、次のいずれかの理由で "プレビュー" としてマークされています。
API はベータ版でのみ使用できます
API の動作は、ベータ版では v1.0 とは異なります
ベータ エンドポイント内の他の API と同様に、プレビューとしてマークされている API に重大な変更を予告なく導入できます。 運用アプリのベータ エンドポイントから API にアクセスしないでください。