次の方法で共有


presence: setPresence

名前空間: microsoft.graph

ユーザーのプレゼンス セッションの状態をアプリケーションとして設定します。

プレゼンス セッション、状態順列、タイムアウトの詳細については、「Microsoft Graph APIを使用してプレゼンス状態を管理する」を参照してください。

この API は、次の国内クラウド展開で使用できます。

グローバル サービス 米国政府機関 L4 米国政府機関 L5 (DOD) 21Vianet が運営する中国

アクセス許可

この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、「アクセス許可のリファレンス」を参照してください。

アクセス許可の種類 最小特権アクセス許可 より高い特権のアクセス許可
委任 (職場または学校のアカウント) Presence.ReadWrite 注意事項なし。
委任 (個人用 Microsoft アカウント) サポートされていません。 サポートされていません。
アプリケーション Presence.ReadWrite.All 注意事項なし。

HTTP 要求

POST /users/{id}/presence/setPresence

要求ヘッダー

名前 説明
Authorization ベアラー {token}。 必須です。 認証と認可についての詳細をご覧ください。
Content-Type application/json. 必須です。

要求本文

要求本文で、次のパラメーターを含む JSON オブジェクトを指定します。

パラメーター 説明
sessionId string アプリケーションのプレゼンス セッションの ID。
availability string ベース プレゼンス情報。
アクティビティ string 可用性に関する補足情報。
expirationDuration duration アプリ プレゼンス セッションの有効期限。 値は ISO 8601 形式で表示されます。

指定しない場合、既定の有効期限は 5 分です。 有効な期間の範囲は、5 ~ 240 分 (PT5M から PT4H) です。

重要

要求に sessionId アプリケーションの ID を指定します。

サポートされている availabilityactivity の組み合わせは次のとおりです。

availability アクティビティ Description
使用可能 使用可能 プレゼンス セッションを [使用可能] としてUpdatesします。
多忙 InACall プレゼンス セッションを [ビジー] (InACall) としてUpdatesします。
多忙 InAConferenceCall プレゼンス セッションを [ビジー] (InAConferenceCall) としてUpdatesします。
留守 留守 プレゼンス セッションを [退席] としてUpdatesします。
DoNotDisturb 提示 プレゼンス セッションを DoNotDisturb、Presenting としてUpdatesします。

応答

成功した場合、このメソッドは 200 OK 応答コードを返します。

次の要求は、ユーザー fa8bf3dc-eca7-46b7-bad1-db199b62afc3のプレゼンス セッションを設定する ID 22553876-f5ab-4529-bffb-cfe50aa89f87を持つアプリケーションを示しています。

要求

POST https://graph.microsoft.com/v1.0/users/fa8bf3dc-eca7-46b7-bad1-db199b62afc3/presence/setPresence
Content-Type: application/json

{
  "sessionId": "22553876-f5ab-4529-bffb-cfe50aa89f87",
  "availability": "Available",
  "activity": "Available",
  "expirationDuration": "PT1H"
}

応答

HTTP/1.1 200 OK