Microsoft Graph のバージョン管理、サポートと重大な変更の方針Versioning, support, and breaking change policies for Microsoft Graph

この記事は Microsoft Graph のサポート重大な変更の方針と、現在使用可能な Microsoft Graph API のバージョンについて説明します。This article describes the support and breaking change policies for Microsoft Graph and the versions of the Microsoft Graph API that are currently available.

サポート ポリシーと廃止の情報Support policy and deprecation information

Microsoft Graph は Microsoft ライフサイクル ポリシーに従います。Microsoft Graph follows the Microsoft Lifecycle Policy.

Microsoft Graph REST API と Microsoft Graph SDK の新しいバージョンがリリースされると、それ以前のバージョンは廃止されます。Microsoft は API または SDK が廃止される少なくとも 24 か月前までにそれ以前のバージョンを非推奨に指定します。As new versions of the Microsoft Graph REST APIs and Microsoft Graph SDKs are released, earlier versions will be retired. Microsoft will declare a version as deprecated at least 24 months in advance of retiring an API or an SDK.

API のメジャー バージョンを新しくする場合 (たとえば、v1.0 から v2.0 へ)、現在のバージョン (この例では v1.0) が即時に非推奨になり、この発表から 24 か月後以降、サポートが打ち切られます。When we increment the major version of the API (for example, from v1.0 to v2.0), we are announcing that the current version (in this example, v1.0) is immediately deprecated and we will no longer support it 24 months after the announcement. サービスのセキュリティと信頼性向上のためにこのポリシーを変更することがあります。We might make exceptions to this policy for service security or health reliability issues.

API が非推奨と指定された場合、できるだけ早く最新バージョンへ移行することを強くお勧めします。When an API is marked as deprecated, we strongly recommend that you migrate to the latest version as soon as possible. 場合によっては、元のAPIが非推奨になってからすぐに、新しいアプリケーションで新しい APIの使用を開始する必要があることを、お知らせします。In some cases, we will announce that new applications will have to start using the new APIs a short time after the original APIs are deprecated. そのような場合、現在非推奨 APIを使用しているアクティブなアプリケーションのみが使用し続けることができます。In those cases, only active applications that currently use the deprecated APIs can continue to use them.

API コントラクトと下位互換性のない変更API contract and non-backward compatible changes

Microsoft Graph にはバージョン更新の変更履歴があります。バージョン更新に伴う変更は Microsoft Graph Microsoft Graph の変更ログに表示されています。Microsoft Graph には新しい機能とデータが追加されたため、下位互換性のない変更が加えられた API では、バージョン番号を更新しています。Microsoft Graph has a log of changes across versions. These changes are listed in the Microsoft Graph Changelog. As new functionality and data is added to Microsoft Graph, we will increment the API version number for any non-backward compatible changes to the API.

次に、下位互換性のない変更の例を示します。The following are examples of non-backward compatible changes:

  • URL またはリソースに関する基本的な要求や応答の変更Changes to the URL or fundamental request/response associated with a resource
  • 宣言済みプロパティの型の削除、変更と、その名前の変更Removal, rename, or change to the type of a declared property
  • API と API パラメーターの削除または名前の変更Removal or rename of APIs or API parameters
  • 必須の要求ヘッダーの追加Addition of a required request header

次に、下位互換性のある変更の例を示します。The following are examples of backward compatible changes:

  • Null 許容型プロパティや既定値を持つプロパティの追加Addition of properties that are nullable or have a default value
  • 列挙型へのメンバーの追加Addition of a member to an enumeration
  • オープン拡張情報の削除、変更と、その名前の変更Removal, rename, or change to the type of an open extension
  • 注釈の削除、変更と、その名前の変更Removal, rename, or change to the type of an annotation
  • 既存のコレクションへのページングの導入Introduction of paging to existing collections
  • エラー コードの変更Changes to error codes
  • プロパティの順序の変更Changes to the order of properties
  • リソース ID のような不透明な文字列の長さまたは形式の変更Changes to the length or format of opaque strings, such as resource IDs

注: 下位互換性のある変更の一覧は適時変更されます。独自のクライアント プロクシ (WCF クライアントなど) を作成する場合は、ガイドラインとしては Microsoft Graph API サービスにあらかじめ定義されていないプロパティや派生型をクライアント アプリケーションが受け入れることができるように準備してください。Microsoft Graph API は「Microsoft REST API ガイドライン」の「バージョン管理のモデル」セクションの説明に従っています。Note: Over time, we will update the list of backward compatible changes. If you generate your own client proxies (like WCF clients), our guidance is that your client applications should be prepared to receive properties and derived types not previously defined by the Microsoft Graph API service. Microsoft Graph API follows the guidance described in the Model Versioning section in the Microsoft REST API guidelines.

バージョンVersions

現在、以下のバージョンの Microsoft Graph API が使用できます。The following versions of the Microsoft Graph API are currently available.

ベータ版Beta version

Microsoft Graph API のベータ版は、https://graph.microsoft.com/betaで公開されており、現在_プレビュー段階_ の機能が含まれています。Exposed under https://graph.microsoft.com/beta, the Microsoft Graph API beta version contains features that are currently in preview. ベータ版 API のドキュメントは、「Microsoft Graph ベータ エンドポイント リファレンス」を参照してください。For beta API documentation, see Microsoft Graph beta endpoint reference. ベータ版には随時重大な変更が発生することがあります。Expect breaking changes to the beta version from time to time. 本番環境が /beta API に依存することのないようにしてください。Do not take a production dependency on /beta APIs.

ベータ版の機能が現行バージョンに採用される保証はありません。Microsoft Graph API チームの判断でベータ版の機能が一般提供 (GA) に十分なものとなったとき、その機能が最新バージョンに追加されます。機能の採用が現行バージョンに重大な変更を招く場合は、バージョン番号が更新され、新規バージョンが現行バージョンに変わります。開発者コミュニティは、新機能や既存のベータ版 API 機能の現行バージョンでの採用希望などの機能の要望を UserVoice に投稿できます。We make no guarantees that a beta feature will be promoted to the current version. When the Microsoft Graph API team believes that a beta feature is ready for general availability (GA), we will add that feature to the latest current version. If the promotion of the feature would result in a breaking change to the current version, the version number will be incremented, with the new version becoming the current version. Our developer community can post feature request on UserVoice, including requests for new features as well as requests to promote existing beta APIs to the current version.

現在のバージョンCurrent version

Microsoft Graph の現在のバージョンは、v1.0 です。Microsoft Graph API /v1.0 バージョンは https://graph.microsoft.com/v1.0 で一般提供されており、一般的に利用可能で本番環境での運用準備が整った機能が含まれています。v1.0 API のドキュメントの各部は、目次から参照できます。The current version of Microsoft Graph is v1.0. Exposed under https://graph.microsoft.com/v1.0, the Microsoft Graph API /v1.0 version contains features that are generally available and ready for production use. You can browse the documentation for the v1.0 APIs in the table of contents.

非推奨およびサポートされないバージョンDeprecated and unsupported versions

現在、Microsoft Graph には非推奨のバージョンはありません。There are currently no deprecated versions of Microsoft Graph.

利用規約Terms of use

Microsoft Graph API を使用すると、Microsoft API 使用条件に同意したことになります。By using the Microsoft Graph APIs, you agree to the Terms of Use.

お客様からのフィードバックは重要です。StackOverflow でご連絡いただけます。ご質問には {MicrosoftGraph} のタグを付けてください。Your feedback is important to us. Connect with us on StackOverflow. Tag your questions with {MicrosoftGraph}.