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 ベータ エンドポイント リファレンス」を参照してください。
注意
プレビュー状態の API は変更される可能性があり、予告なく既存のシナリオを中断する可能性があります。
beta エンドポイントの API に運用環境の依存関係を設定しないでください。
詳細については、「 バージョン管理とサポート」を参照してください。
新機能
v1.0 エンドポイントの 新機能 を確認します。
v1.0 での Microsoft Graph API の変更の詳細については、 API の変更ログを参照してください。