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

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

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

一般的なユース ケース

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

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

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

• ユーザーのプロファイルと写真を取得します。
• ユーザーのマネージャーと直接レポートの ID のプロファイル情報を取得します。すべてMicrosoft Entra 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 ベータ エンドポイント リファレンス」を参照してください。

注意

プレビュー状態の API は変更される可能性があり、予告なく既存のシナリオを中断する可能性があります。 エンドポイント内の API に対して運用上の依存関係を取得 beta しないでください。

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

新機能

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

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

関連コンテンツ

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