プレゼンスの取得Get presence

名前空間: microsoft.graphNamespace: microsoft.graph

重要

/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.

ユーザーのプレゼンス情報を取得します。Get a user's presence information.

アクセス許可Permissions

これらの Api を呼び出すには、次のいずれかのアクセス許可が必要です。One of the following permissions is required to call these APIs. アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。To learn more, including how to choose permissions, see Permissions.

アクセス許可の種類Permission type アクセス許可 (特権の小さいものから大きいものへ)Permissions (from least to most privileged)
委任 (職場または学校のアカウント)Delegated (work or school account) Presence.Read、Presence.Read.AllPresence.Read, Presence.Read.All
委任 (個人用 Microsoft アカウント)Delegated (personal Microsoft account) サポートされません。Not Supported.
アプリケーションApplication サポートされません。Not Supported.

HTTP レポートHTTP Requests

GET /me/presence
GET /users/{id}/presence
GET /communications/presences

要求ヘッダーRequest Headers

名前Name 説明Description
AuthorizationAuthorization Bearer {token}.Bearer {token}. Required.Required.

要求本文Request body

このメソッドには、要求本文を指定しません。Do not supply a request body for this method.

応答Response

成功した場合、このメソッドは応答 200 OK コードと、応答本文でプレゼンスオブジェクトを返します。If successful, this method returns a 200 OK response code and a presence object in the response body.

Examples

例 1: 独自のプレゼンス情報を取得するExample 1: Get your own presence information

次の例は、独自のプレゼンス情報を取得する方法を示しています。The following example shows how to get your own presence information. この操作には、プレゼンスの読み取りアクセス許可が必要です。This operation requires the Presence.Read permission.

要求Request

GET https://graph.microsoft.com/beta/me/presence

応答Response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 1574

{  
    "id": "fa8bf3dc-eca7-46b7-bad1-db199b62afc3",
    "availability": "Available",
    "activity": "Available"
}

例 2: 別のユーザーのプレゼンス情報を取得するExample 2: Get the presence information of another user

次の例は、別のユーザーのプレゼンス情報を取得する方法を示しています。The following example shows how to get the presence information for another user. この操作には、存在するすべてのアクセス許可が必要です。This operation requires the Presence.Read.All permission.

要求Request

GET https://graph.microsoft.com/beta/users/66825e03-7ef5-42da-9069-724602c31f6b/presence

応答Response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 1574

{
    "id": "66825e03-7ef5-42da-9069-724602c31f6b",
    "availability": "DoNotDisturb",
    "activity": "Presenting"
}

例 3: 別のユーザーのプレゼンス情報を取得するExample 3: Get the presence information of another user

次の例は、別のユーザーのプレゼンス情報を取得する方法を示しています。The following example shows how to get the presence information for another user. この操作には、存在するすべてのアクセス許可が必要です。This operation requires the Presence.Read.All permission.

要求Request

GET https://graph.microsoft.com/beta/communications/presences/dc74d9bb-6afe-433d-8eaa-e39d80d3a647

応答Response

HTTP/1.1 200 OK

{
    "value": [
        {
            "id": "dc74d9bb-6afe-433d-8eaa-e39d80d3a647",
            "availability": "Away",
            "activity": "BeRightBack"
        }
    ]
}