Microsoft Graph REST API v1.0 リファレンスMicrosoft Graph REST API v1.0 reference

v1.0 エンドポイント用の Microsoft Graph REST API リファレンスへようこそ。Welcome to Microsoft Graph REST API reference for the v1.0 endpoint.

v1.0 エンドポイントの API セット (https://graph.microsoft.com/v1.0) は、一般提供 (GA) ステータスで、顧客との厳密なレビューとフィードバック プロセスを経て、運用環境の実用的なニーズを満たすものとなっています。API sets on the v1.0 endpoint (https://graph.microsoft.com/v1.0) are in general availability (GA) status, and have gone through a rigorous review-and-feedback process with customers to meet practical, production needs. このエンドポイントの API の更新は、追加的なものであり、既存のアプリのシナリオを損なうものではありません。Updates to APIs on this endpoint are additive in nature and do not break existing app scenarios.

一般的なユース ケースCommon use cases

Microsoft Graph では、単一の Microsoft Graph REST エンドポイントで公開されている異なるサービスのエンティティやリレーションシップのナビゲーションが簡単に行うことができます。The power of Microsoft Graph lies in easy navigation of entities and relationships across different services exposed on a single Microsoft Graph REST endpoint.

これらのサービスの多くは、ユーザーおよびグループにとって、さまざまなシナリオを実現できるよう設計されています。A number of these services are designed to enable rich scenarios around a user and around a group.

V1.0 でのユーザー中心のユース ケースUser-centric use cases in v1.0

  1. ユーザー (Lisa) のプロファイルを取得し、写真を取得します。Get the profile and photo of a user, Lisa.
  2. Azure Active Directory に保存されている Lisa のマネージャーのプロファイル情報を取得し、直属の部下の ID を取得します。Get the profile information about Lisa's manager and IDs of her direct reports, all stored in Azure Active Directory.
  3. OneDrive for Business 上で、Lisa のファイルにアクセスし、最後にそのファイルを更新したユーザーを特定し、その人のプロファイルに移動します。Access Lisa's files on OneDrive for Business, find the identity of the last person who modified a file there, and navigate to that person's profile.
  4. Exchange Online 上の Lisa の予定表にアクセスし、向こう 2 週間で Lisa が彼女のチームとの会議に最適な時間を決定します。Access Lisa's calendar on Exchange Online and determine the best time for Lisa to meet with her team in the next two weeks.
  5. Lisa の予定表を購読し、変更履歴を記録し、Lisa が会議に自分の時間の 80% 以上を費やしている場合に報告します。Subscribe to and track changes in Lisa's calendar, tell Lisa when she is spending more than 80% of her time in meetings.
  6. Lisa が外出中のときに自動応答を設定します。Set automatic replies when Lisa is away from the office.
  7. コミュニケーション、コラボレーション、ビジネスのリレーションシップに基づいて、Lisa にもっとも関連のある人物を取得します。Get the people who are most relevant to Lisa, based on communication, collaboration, and business relationships.
  8. Lisa の OneDrive for Business 上の Excel ファイルの、グラフから、最新の販売計画を取得します。Get the latest sales projection from a chart in an Excel file in Lisa's OneDrive for Business.
  9. Planner で Lisa に割り当てられているタスクを検索します。Find the tasks assigned to Lisa in Planner.

V1.0 での Office 365 グループのユース ケースOffice 365 group use cases in v1.0

  1. 組織内の Office 365 グループに関するレポートを実行し、グループのメンバー間の通信がもっとも多いグループを特定します。Run a report on Office 365 groups in an organization and identify the group with the most communication among group members.
  2. この Office 365 グループの計画を検索し、その計画のタスクの割り当てを検索します。Find the plans of this Office 365 group, and the assignment of tasks in that plan.
  3. Office 365 グループ内で新しい会話を開始し、メンバーがワークロードを共有するために別のグループを作成するかどうかを決定します。Start a new conversation in the Office 365 group to determine if members want to create another group to share the workload.
  4. グループの既定のノートブックを取得し、調査の結果を記録する新しいページを作成します。Get the default notebook for the group and create a page to note the outcome of the investigation.

その他の API バージョンOther API versions

現在、Microsoft Graph REST API には、- v1.0 とベータ版の 2 つのバージョンがあります。There are currently 2 versions of Microsoft Graph REST APIs - v1.0 and beta. プレビューの状態にある新しいまたは拡張の API を検討する場合は 「Microsoft Graph ベータ エンドポイント リファレンス」を参照してください。If you're interested in new or enhanced APIs that are still in preview status, see Microsoft Graph beta endpoint reference. プレビュー状態の API は今後変更される可能性があり、予告なしに既存のシナリオが動作しなくなる場合があることにご注意ください。Be aware that APIs in preview status are subject to change, and may break existing scenarios without notice. ベータ版のエンドポイントの API に運用環境で依存関係を持たないようにしてください。Don't take a production dependency on APIs in the beta endpoint.

詳細については、「バージョン管理とサポート」を参照してください。Find more information about versioning and support.

連絡方法Connect with us

Microsoft Graph に追加したい API や機能がある場合Are there additional APIs or features you'd like to see in Microsoft Graph? 新しい機能のリクエストを UserVoice に投稿してください。Post new feature requests on UserVoice.

既存の Microsoft Graph API に対するフィードバックがある場合Have feedback for existing Microsoft Graph APIs? Github から連絡してください。Connect with us on Github.