Microsoft Graph API を使用してアプリにユーザーと職場のインテリジェンスを統合するUse the Microsoft Graph API to integrate people and workplace intelligence in an app

重要

/betaMicrosoft Graph のバージョンの api は変更される可能性があります。APIs under the /beta version in Microsoft Graph are subject to change. 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。Use of these APIs in production applications is not supported.

Microsoft Graph を使用すると、人々、そのプロファイル、対話するドキュメント、および作業パターンに関する有用なデータにアクセスでき、ユーザーのソーシャル コンテキストでの動きをサポートできます。Microsoft Graph enables access to useful data about people, their profile, documents they interact with, and work patterns, and supports gestures in a user's social context.

ユーザーに関する特有の情報を集約して抽出するAggregate and extract specific information about people

機能: ユーザーFeature: People

person リソースと People API を使用して、メール、連絡先、およびソーシャル ネットワークから、個人に関する情報を集約することができます。Use the person resource and the People API to aggregate information about a person from across mail, contacts, and social networks. 結果は、複数のコミュニケーション、コラボレーション、およびビジネスのリレーションシップを基に、関連性によって並べられます。The results are ordered by their relevance based on multiple communication, collaboration, and business relationships. API を使用すると、条件に基づいて、個人の閲覧、並べ替え、選択、フィルター、または検索を行うことができます。The API lets you browse, sort, select, filter, or search for persons based on your criteria.

ユーザーが組織内の別のユーザーをコンテキスト化することを支援するHelp users contextualize others in their organization

機能: プロファイル (プレビュー)Feature: Profile (preview)

組織内の別のユーザーをコンテキスト化しようとしているユーザーは、通常、個人のプロフィールまたはプロフィール カードを表示します。People who seek to contextualize others within their organization commonly view a person's profile or profile card.

profile リソースは、テナント内のユーザーに関する豊富な情報源であり、個人の情報を保存および取得するための軽量なメカニズムを提供します。The profile resource is a rich source of information about people within a tenant and provides a lightweight mechanism for storing and retrieving information about a person.

組織内のユーザーのエクスペリエンスをカスタマイズするPersonalize people experiences within your organization

機能: プロファイル カードのカスタマイズ (プレビュー)Feature: Profile card customization (preview)

管理者は、組織内の Microsoft 365 全体で使用されるプロファイル カードに表示される情報をカスタマイズできます。Provides the ability for an administrator to customize the information shown on the profile card used across Microsoft 365 within their organization.

profileCardProperty リソースは、組織が共有されたユーザー エクスペリエンスに表示される Microsoft 365 プロファイル カードのユーザーの特性を表します。The profileCardProperty resource represents an attribute of a user on the Microsoft 365 profile card for an organization to surface in a shared, people experience.

ユーザーの作業に最も関連性の高いドキュメントの取得を支援するHelp users get the most relevant documents for their work

機能: ドキュメントのインサイトFeature: Document insights

Insights API を使用して、ユーザーに最適なドキュメントを特定する:Use the insights API to identify the most relevant documents for a user:

@- メンションを管理するManage @-Mentions

機能: @- メンション (プレビュー)Feature: @-mentions (preview)

ソーシャルの世界では、メッセージ内で受信者に通知して注意を引くために受信者に呼びかけることが一般的に行われています。Calling out a recipient to notify and get the recipient's attention in a message is a common social gesture. mention リソースと Mentions API には、メッセージ内で受信者に呼びかけたり、ユーザーが @-メンションを使用して通知しているすべてのメッセージを取得したり、メッセージの内の各メンションを取得したりする軽量のメカニズムが備わっています。The mention resource and the Mentions API provide a light-weight mechanism to call out a recipient in a message, get all the messages in which a user is notified using an @-mention, or get each mention in a message.

ユーザーが自分の仕事のパターンに関する洞察を得られるよう支援するHelp users gain insights into their work patterns

機能: 分析 (プレビュー)Feature: Analytics (preview)

Analytics API を使用して、ユーザーのアクティビティ統計および関連する設定を取得します。Use the analytics API to get activity statistics and related settings for a user:

  • 設定: analytics API がユーザーの結果を返すには、現在のユーザー分析設定に有効な MyAnalytics ライセンスが表示され、MyAnalytics の使用が選択され、グラフ対応のクラウドホスト型メールボックスが必要です。settings: For the analytics API to return results for a user, the current user analytics settings must show a valid MyAnalytics license, be opted in to using MyAnalytics, and have a cloud-hosted mailbox that’s graph-enabled.
  • activityStatistics: 通話チャット (インスタント メッセージ)電子メール、勤務時間中および勤務時間外の会議に費やされた時間数や集中作業に利用できる時間数を含む、ユーザーが時間を費やした Microsoft 365 アクティビティの最後の週全体 (または指定された時間範囲) のデータを取得します。activityStatistics: Gets data for the last complete week (or the specified time range) for the Microsoft 365 activities that a user spent time on, including the number of hours spent on calls, chats (instant messages), email, and meetings during and outside of working hours and the number of hours available for focused work.

新機能What's new

この API セットに関する 最新機能や更新プログラム を検索してください。Find out about the latest new features and updates for these API sets.