名前空間: microsoft.graph
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
可用性やユーザー アクティビティなど、ユーザーのプレゼンスに関する情報が含まれます。
このリソースは、 変更通知のサブスクライブをサポートします。
メソッド
| メソッド | 戻り値の型 | 説明 |
|---|---|---|
| プレゼンスを取得する | プレゼンス | ユーザーのプレゼンス情報を取得します。 |
| 複数のユーザーのプレゼンスを取得する | プレゼンス コレクション | 複数のユーザーのプレゼンス情報を取得します。 |
| プレゼンスを設定する | ユーザーのアプリケーションの プレゼンス セッション で可用性とアクティビティの状態を設定します。 | |
| 明確なプレゼンス | ユーザーのアプリケーションのプレゼンス セッションをクリアします。 | |
| ユーザー優先プレゼンスを設定する | ユーザーの優先可用性とアクティビティの状態を設定します。 | |
| ユーザー優先プレゼンスをクリアする | ユーザーの優先可用性とアクティビティの状態をクリアします。 | |
| ユーザーのステータス メッセージを設定する | ユーザーのプレゼンス 状態メッセージを設定します。 | |
| 自動位置情報の設定 | なし | ユーザーの自動作業場所を更新 します。 |
| 手動の場所を設定する | なし | ユーザーの手動作業場所信号を設定 します。 |
| 自動位置情報をクリアする | なし | ユーザーの自動作業場所シグナルをクリア します。 |
| 場所をクリアする | なし | 現在の日付の手動レイヤーと自動レイヤーの両方を含め、 ユーザーの作業場所シグナルをクリアします。 |
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
| アクティビティ | 文字列 | ユーザーの可用性に関する補足情報。 使用できる値は、 available、 away、 beRightBack、 busy、 doNotDisturb、 offline、 outOfOffice、 presenceUnknownです。 |
| availability | 文字列 | ユーザーの基本プレゼンス情報。 使用できる値は、 available、 away、 beRightBack、 busy、 doNotDisturb、 focusing、 inACall、 inAMeeting、 offline、 presenting、 presenceUnknownです。 |
| id | String | ユーザーの一意の識別子。 |
| outOfOfficeSettings | outOfOfficeSettings | ユーザーの不在時設定。 |
| sequenceNumber | 文字列 | プレゼンス オブジェクトのバージョンを表す辞書的に並べ替え可能な文字列スタンプ。 |
| statusMessage | presenceStatusMessage | ユーザーのプレゼンス 状態メッセージ。 |
| workLocation | userWorkLocation | ユーザーの集計された作業場所の状態を表します。 |
注:
- さまざまなプレゼンス状態の詳細については、「 Teams でのユーザープレゼンス」を参照してください。
- プレゼンス セッション、状態順列、タイムアウト、および信頼されたドメインの詳細については、「Microsoft Graph APIを使用してプレゼンス状態を管理する」を参照してください。
リレーションシップ
なし。
JSON 表記
次の JSON 表現は、リソースの種類を示しています。
{
"activity": "String",
"availability": "String",
"id": "String (identifier)",
"outOfOfficeSettings": {"@odata.type": "#microsoft.graph.outOfOfficeSettings"},
"sequenceNumber": "String",
"statusMessage": {"@odata.type": "#microsoft.graph.presenceStatusMessage"},
"workLocation": {"@odata.type": "microsoft.graph.userWorkLocation" }
}