Live SDK から Microsoft Graph に移行する
プロファイル、カレンダー、連絡先、ファイルへの接続に Live SDK または Live Connect API を使用している場合、機能を維持するためにアプリを更新する必要があります。
1 年を超えて Live SDK と Live Connect API には「使用されていない」とマークが付けられています。 Office 開発者ブログ で発表されたように、これらの API は終焉を迎えており、2018 年 11 月 1 日 より後には利用できなくなります。
2017 年 12 月 1 日 以降、プロファイルと連絡先のデータは Live Connect API から利用できなくなります。 2017 年 6 月 から、カレンダーのデータは Live Connect から利用はできなくなっています。
Live Connect API はすべて https://apis.live.net/v5.0 からホストされています。 以下の例すべてでこのプレフィックスを使用します。
Microsoft Graph に切り替える
Live SDK および Live Connect API で今まで利用可能だった機能は、Microsoft Graph で利用可能です。 引き続き Microsoft サービスと統合するには、開発者は、これらのサービスのタイムラインが廃止される前に、アプリを更新して Microsoft Graph を使用する必要があります。
Live Connect の機能と類似して、Microsoft Graph には、アプリが扱うユーザー データの種類に応じて利用可能ないくつかのリソースがあります。
ライブラリ
Microsoft Graph は Live SDK と類似して、アプリケーションと統合可能なクライアント ライブラリを多くのプラットフォーム用に提供しています。
アクセス許可
Microsoft Graph では、Live Connect とは異なるアクセス許可のスコープのセットを使用します。 アプリで Microsoft Graph API にアクセスするには、アクセス許可のスコープを切り替える必要があります。 そのために、アプリはサインインへの同意と新しいアクセス許可への同意を求めるダイアログをユーザーに表示する必要があります。
詳細については「Microsoft Graph のアクセス許可のリファレンス」を参照してください。
| Live Connect のスコープ | Microsoft Graph のアクセス許可 | 説明 |
|---|---|---|
wl.basic |
Contacts.Read |
アプリで、ユーザーの連絡先を読み取ることができるようにします。 |
wl.offline_access |
offline_access |
現在アプリを使用していない場合も、アプリでユーザー データの読み取りと更新ができるようにします。 |
wl.signin |
openid |
ユーザーが職場または学校アカウントでアプリにサインインできるようにします。またアプリで、ユーザーの基本的なプロファイル情報を読み取れるようにします。 |
wl.skydrive |
Files.Read |
アプリで、サインインしているユーザーのファイルを読み取れるようにします。 |
wl.skydrive_update |
Files.ReadWrite |
アプリで、サインインしているユーザーのファイルを読み取り、作成、更新、削除できるようにします。 |
wl.contacts_create |
Contacts.ReadWrite |
アプリで、ユーザーの連絡先の作成、読み取り、更新、削除を行えるようにします。 |
wl.contacts_calendar |
Calendars.Read.Shared |
アプリで、ユーザー自身の連絡先と共有の連絡先を含む、ユーザーがアクセス許可を得ている連絡先を読み取ることができるようにします。 |
wl.contacts_photos |
Contacts.Read |
アプリで、ユーザーの連絡先を読み取ることができるようにします。 |
wl.contacts_skydrive |
Files.ReadWrite.All |
アプリで、サインインしているユーザーがアクセス可能なすべてのファイルを読み取り、作成、更新、削除できるようにします。 |
wl.calendars |
Calendars.Read |
アプリは、ユーザーの予定表内のイベントを読み取ることができます。 |
wl.calendars_update |
Calendars.ReadWrite |
ユーザーのカレンダー内のイベントをアプリで作成、読み取り、更新、削除できるようにします。 |
wl.emails |
Mail.Read |
アプリで、ユーザー メールボックス内のメールを読み取ることができるようにします。 |
wl.events_create |
Calendars.ReadWrite |
ユーザーのカレンダー内のイベントをアプリで作成、読み取り、更新、削除できるようにします。 |
wl.photos |
Files.Read |
アプリがサインインしているユーザーのファイルを読み取り、写真を含めることができます。 |
office.onenote_create |
Notes.ReadWrite |
サインインしているユーザーの代わりに、アプリで OneNote ノートブックの読み取り、共有、および変更を実行できるようにします。 |
一意識別子
Microsoft Graph では、Live ConnectやLive SDKとは異なるスキームを一意の識別子に使用します。 Microsoft Graph でLive Connectから識別子を使用することはできません。
アプリケーションでは、検索、パスベースのナビゲーション、またはユーザーに項目の再選択を求めて、既知のアイテムの識別子を再検出する必要があります。
Identity API
ID API 機能は、 2017 年 12 月 1 日にユーザー データの返しを停止します。
次の表は、Live Connect API のメソッドと Microsoft Graph の同等のメソッドの概要を示しています。 REST パスの形式は似ていますが、応答データは同じ形式に従いません。 Microsoft Graph SDK を使用するか、JSON マッピングを更新して Microsoft Graph リソース形式を使用する必要があります。
| Live Connect API | Microsoft Graph API | メモ |
|---|---|---|
GET /me |
GET /me |
試してみる。 ユーザーのプロファイル、表示名、および追加情報を返します。 |
GET /me/picture |
GET /me/photo/$value |
試してみる。 ユーザーのプロフィール写真を返します。 |
連絡先 API
連絡先 API 機能は、 2017 年 12 月 1 日にユーザー データの返しを停止します。
次の表は、Live Connect API のメソッドと Microsoft Graph の同等のメソッドの概要を示しています。 REST パスの形式は似ていますが、応答データは同じ形式に従いません。 Microsoft Graph SDK を使用するか、JSON マッピングを更新して Microsoft Graph リソース形式を使用する必要があります。
| Live Connect API | Microsoft Graph API | メモ |
|---|---|---|
GET /me/contacts |
GET /me/contacts |
試してみる。 ユーザーの個人連絡先の一覧を返します。 |
GET /{contact-id} |
GET /me/contacts/{contact-id} |
試してみる。 指定した連絡先のデータを返します。 |
POST /{contact-id} |
POST /me/contacts |
新しい連絡先を作成 します。 |
カレンダー API
予定表 API では 、2017 年 6 月の時点でユーザー データが返されなくなります。
次の表は、Live Connect API のメソッドと Microsoft Graph の同等のメソッドの概要を示しています。 REST パスの形式は似ていますが、応答データは同じ形式に従いません。 Microsoft Graph SDK を使用するか、JSON マッピングを更新して Microsoft Graph リソース形式を使用する必要があります。
| Live Connect API | Microsoft Graph API | メモ |
|---|---|---|
GET /me/calendars |
GET /me/calendars |
試してみる ユーザーの予定表の一覧を返 します。 |
GET /{calendar-id} |
GET /me/events |
試してみる ユーザーの予定表から イベント を返します。 |
POST /{calendar-id} |
POST /me/events |
ユーザーの予定表に新しい イベント を作成します。 |
OneDrive REST API
Live Connect API の OneDrive 部分は、2018 年 11 月 1 日の時点では機能しなくなります。
次の表は、Live Connect API のメソッドと Microsoft Graph の同等のメソッドの概要を示しています。
REST パスの形式は似ていますが、応答データは同じ形式に従いません。 Microsoft Graph SDK を使用するか、JSON マッピングを更新して Microsoft Graph リソース形式を使用する必要があります。
ユーザーの OneDrive の内容の移動の詳細については、「 DriveItem リソースを取得する」を参照してください。
| Live Connect API | Microsoft Graph API | メモ |
|---|---|---|
GET /folder.a6b2a7e8f2515e5e.A6B2A7E8F2515E5E!110 |
GET /me/drive/items/A6B2A7E8F2515E5E!110 |
試してみる。 フォルダーのメタデータを取得します。 |
GET /me/skydrive/camera_roll |
GET /me/drive/special/cameraroll |
ユーザーのカメラ ロール バックアップ フォルダーを取得します。 |
GET /me/skydrive/files |
GET /me/drive/root/children |
試してみる。 OneDrive ルート フォルダーの内容を一覧表示します。 |
GET /me/skydrive/my_documents |
GET /me/drive/special/documents |
ユーザーのドキュメント フォルダーを取得します。 |
GET /me/skydrive/my_photos |
GET /me/drive/special/photos |
ユーザーの写真フォルダーを取得します。 |
GET /me/skydrive/public_documents |
該当なし | ユーザーのパブリック共有フォルダーを取得します。 この概念は OneDrive から削除されており、Microsoft Graph では使用できません。 |
GET /me/skydrive/quota |
GET /me/drive?$select=quota |
試してみる。 使用済み領域や残りの領域など、ユーザーの OneDrive のクォータ情報を返します。 |
GET /me/skydrive/recent |
GET /me/drive/recent |
現在のユーザーと共有されているファイルとフォルダーの一覧を返します。 |
GET /me/skydrive/shared |
GET /me/drive/sharedWithMe |
現在のユーザーと共有されているファイルとフォルダーの一覧を返します。 |
GET /me/skydrive |
GET /me/drive/root |
試してみる。 ユーザーの OneDrive 内のルート フォルダーを取得します。 |
GET /skydrive/get_item_preview |
GET /me/drive/items/{item-id}/thumbnails |
OneDrive のファイルまたはフォルダーで使用可能なサムネイルを返します。 |
Web アプリのファイル ピッカー
Live SDKの一部として提供された OneDrive ファイル ピッカー機能は、OneDrive ファイル ピッカーを使用して使用できるようになりました。
バージョン 5 のLive SDK (OneDrive ファイル ピッカー) は、2018 年 11 月 1 日以降は機能しなくなります。
その他のリソース
Microsoft Graph の使用方法の詳細については、 Microsoft Graph クイック スタートを試してください。