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

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

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

一般的なユース ケース

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

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

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

• ユーザーのプロファイルと写真を取得します。
• Microsoft Entra ID に格納されているすべてのユーザーのマネージャーと直接レポートの ID のプロファイル情報を取得します。
• OneDrive でユーザーのファイルにアクセスし、そこでファイルを変更した最後のユーザーの ID を見つけて、そのユーザーのプロファイルに移動します。
• Exchange Online でユーザーの予定表にアクセスし、今後 2 週間でチームと会う最適な時期を決定します。
• ユーザーの予定表の変更をサブスクライブして追跡し、会議で 80% を超える時間を費やしている場合にユーザーに通知します。
• ユーザーがオフィスから離れているときに自動応答を設定します。
• コミュニケーション、コラボレーション、ビジネス関係に基づいて、ユーザーに最も関連性の高いユーザーを取得します。
• ユーザーの OneDrive の Excel ファイル内の グラフ から最新の売上プロジェクションを取得します。
• Planner でユーザーに割り当てられているタスクを見つけます。

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

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

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

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

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

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

Microsoft Graph ベータ エンドポイント

現時点では、v1.0 とベータ版の 2 つのバージョンの Microsoft Graph REST API を使用できます。

プレビューの状態にある新しいまたは拡張の API を検討する場合は 「Microsoft Graph ベータ エンドポイント リファレンス」を参照してください。

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

新機能

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

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

関連コンテンツ

• Microsoft Graph の概要
• Microsoft Graph Explorer
• Microsoft Graph のクイック スタート
• Microsoft Graph SDK を使用する