Microsoft Graph REST API v1.0 エンドポイント リファレンス

  • [アーティクル]

v1.0 エンドポイント用の Microsoft Graph REST API リファレンスへようこそ。

v1.0 エンドポイントの API セット (https://graph.microsoft.com/v1.0) は、一般提供 (GA) ステータスで、顧客との厳密なレビューとフィードバック プロセスを経て、運用環境の実用的なニーズを満たすものとなっています。 このエンドポイントの API の更新は、追加的なものであり、既存のアプリのシナリオを損なうものではありません。

一般的なユース ケース

Microsoft Graph では、単一の Microsoft Graph REST エンドポイントで公開されている異なるサービスのエンティティやリレーションシップのナビゲーションが簡単に行うことができます。

これらのサービスの多くは、ユーザーおよびグループにとって、さまざまなシナリオを実現できるよう設計されています。

V1.0 でのユーザー中心のユース ケース

  1. ユーザー (Lisa) のプロファイルを取得し、写真を取得します。
  2. リサのマネージャーと彼女の直属のレポートの ID に関するプロファイル情報を取得します。すべてMicrosoft Entra ID に格納されています。
  3. OneDrive for Business 上で、Lisa のファイルにアクセスし、最後にそのファイルを更新したユーザーを特定し、その人のプロファイルに移動します。
  4. Exchange Online 上の Lisa の予定表にアクセスし、向こう 2 週間で Lisa が彼女のチームとの会議に最適な時間を決定します。
  5. Lisa の予定表を購読し、変更履歴を記録し、Lisa が会議に自分の時間の 80% 以上を費やしている場合に報告します。
  6. Lisa が外出中のときに自動応答を設定します。
  7. コミュニケーション、コラボレーション、ビジネスのリレーションシップに基づいて、Lisa にもっとも関連のある人物を取得します。
  8. Lisa の OneDrive for Business 上の Excel ファイルの、グラフから、最新の販売計画を取得します。
  9. Planner で Lisa に割り当てられているタスクを検索します。

V1.0 でのMicrosoft 365 グループのユース ケース

  1. 組織内の Microsoft 365 グループに関するレポートを実行し、グループのメンバー間の通信がもっとも多いグループを特定します。
  2. この Microsoft 365 グループの計画を検索し、その計画のタスクの割り当てを検索します。
  3. Microsoft 365 グループ内で新しい会話を開始し、メンバーがワークロードを共有するために別のグループを作成するかどうかを決定します。
  4. グループの既定のノートブックを取得し、調査の結果を記録する新しいページを作成します。

その他の API バージョン

現在、Microsoft Graph REST API には、- v1.0 とベータ版の 2 つのバージョンがあります。 プレビューの状態にある新しいまたは拡張の API を検討する場合は 「Microsoft Graph ベータ エンドポイント リファレンス」を参照してください。 プレビュー状態の API は今後変更される可能性があり、予告なしに既存のシナリオが動作しなくなる場合があることにご注意ください。 ベータ版のエンドポイントの API に運用環境で依存関係を持たないようにしてください。

詳細については、「バージョン管理とサポート」を参照してください。

v1.0 エンドポイントを呼び出す

v1.0 エンドポイントへの Microsoft Graph API 要求では、次のパターンを使用する必要があります。

https://graph.microsoft.com/v1.0/{resource}?[query_parameters]

詳細については、「Microsoft Graph API を使用する」を参照してください。

新機能

v1.0 エンドポイントで 最新機能や更新プログラム を検索してください。

連絡方法

Microsoft Graph に追加したい API や機能がある場合 「Microsoft 365 開発者プラットフォームのアイデア フォーラム」で新しい機能のリクエストを投稿しましょう。

既存の Microsoft Graph API に対するフィードバックがある場合 GitHub で接続してください。