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

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

エンドポイント (https://graph.microsoft.com/v1.0) 上の v1.0 API セットは一般提供 (GA) 状態であり、実用的な運用環境のニーズを満たすために、お客様との厳格なレビューとフィードバック プロセスを経ています。 このエンドポイント上の API への更新は本質的に付加的であり、既存のアプリ シナリオを損ないません。

一般的なユース ケース

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

これらのサービスの一部は、 ユーザーグループの周りの豊富なシナリオを可能にするように設計されています。

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

  1. ユーザー (Lisa) のプロファイルを取得し、写真を取得します。
  2. Microsoft Entra IDに保存されている、リサのマネージャー彼女の直属のレポートの ID に関するプロファイル情報を取得します。
  3. OneDrive で Lisa のファイルにアクセスし、そこでファイルを変更した最後のユーザーの ID を見つけて、そのユーザーのプロファイルに移動します。
  4. Exchange Online 上の Lisa の予定表にアクセスし、向こう 2 週間で Lisa が彼女のチームとの会議に最適な時間を決定します。
  5. リサの予定表の変更をサブスクライブして追跡し、会議で 80% 以上の時間を費やしている場合にリサに伝えます。
  6. Lisa が外出中のときに自動応答を設定します。
  7. コミュニケーション、コラボレーション、ビジネスのリレーションシップに基づいて、Lisa にもっとも関連のある人物を取得します。
  8. Lisa の OneDrive の 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 に対して運用上の依存関係を取得 beta しないでください。

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

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

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

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

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

新機能

v1.0 エンドポイントの 新機能 を確認します。

Microsoft Graph API の変更の詳細については、API の変更 ログ を参照してください。