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 でのユーザー中心のユース ケース
- ユーザー (Lisa) のプロファイルを取得し、写真を取得します。
- Microsoft Entra IDに保存されている、リサのマネージャーと彼女の直属のレポートの ID に関するプロファイル情報を取得します。
- OneDrive で Lisa のファイルにアクセスし、そこでファイルを変更した最後のユーザーの ID を見つけて、そのユーザーのプロファイルに移動します。
- Exchange Online 上の Lisa の予定表にアクセスし、向こう 2 週間で Lisa が彼女のチームとの会議に最適な時間を決定します。
- リサの予定表の変更をサブスクライブして追跡し、会議で 80% 以上の時間を費やしている場合にリサに伝えます。
- Lisa が外出中のときに自動応答を設定します。
- コミュニケーション、コラボレーション、ビジネスのリレーションシップに基づいて、Lisa にもっとも関連のある人物を取得します。
- Lisa の OneDrive の Excel ファイルの グラフ から最新の売上プロジェクションを取得します。
- Planner で Lisa に割り当てられているタスクを検索します。
V1.0 でのMicrosoft 365 グループのユース ケース
- 組織内の Microsoft 365 グループに関するレポートを実行し、グループのメンバー間の通信がもっとも多いグループを特定します。
- この Microsoft 365 グループの計画を検索し、その計画のタスクの割り当てを検索します。
- Microsoft 365 グループ内で新しい会話を開始し、メンバーがワークロードを共有するために別のグループを作成するかどうかを決定します。
- グループの既定のノートブックを取得し、調査の結果を記録する新しいページを作成します。
その他の 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 の変更 ログ を参照してください。
関連コンテンツ
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示