Anwesenheit abrufen

Namespace: microsoft.graph

Ruft die Anwesenheitsinformationen eines Benutzers ab.

Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.

Weltweiter Service	US Government L4	US Government L5 (DOD)	China, betrieben von 21Vianet
✅	✅	✅	❌

Berechtigungen

Wählen Sie die Berechtigungen aus, die für diese API als am wenigsten privilegiert markiert sind. Verwenden Sie eine höhere Berechtigung oder Berechtigungen nur, wenn Ihre App dies erfordert. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.

Berechtigungstyp	Berechtigungen mit den geringsten Berechtigungen	Berechtigungen mit höheren Berechtigungen
Delegiert (Geschäfts-, Schul- oder Unikonto)	Presence.Read	Presence.Read.All
Delegiert (persönliches Microsoft-Konto)	Nicht unterstützt	Nicht unterstützt
Application	Presence.Read.All	Presence.ReadWrite.All

Hinweis

Sie können keine Anwendungsberechtigungen verwenden, um auf APIs unter dem /me Pfad zuzugreifen.
Die maximale Anforderungsrate für diese API beträgt 1.500 Anforderungen innerhalb eines Zeitraums von 30 Sekunden pro Anwendung und Mandant.

HTTP-Anforderung

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

Hinweis

Sie müssen die ID des Benutzers übergeben, um seine Anwesenheitsinformationen zu erhalten.
Wenn Sie oder GET /communications/presences/{id}aufrufenGET /users/{id}/presence, ersetzen Sie durch {id} die GUID des Benutzers.
Beispiele zum Abrufen des eindeutigen Bezeichners für einen Benutzer finden Sie unter Abrufen des Benutzers.

Anforderungsheader

Name	Beschreibung
Authorization	Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung.

Anforderungstext

Geben Sie keinen Anforderungstext für diese Methode an.

Antwort

Wenn die Methode erfolgreich verläuft, werden der 200 OK Antwortcode und ein Anwesenheitsobjekt im Antworttext zurückgegeben.

Beispiele

Beispiel 1: Abrufen eigener Anwesenheitsinformationen

Das folgende Beispiel zeigt, wie Sie Ihre eigenen Anwesenheitsinformationen abrufen. Für diesen Vorgang ist die Presence.Lesen-Berechtigung erforderlich.

Anforderung

GET https://graph.microsoft.com/v1.0/me/presence


// Code snippets are only available for the latest version. Current version is 5.x

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Me.Presence.GetAsync();



// Code snippets are only available for the latest major version. Current major version is $v1.*

// Dependencies
import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
	  //other-imports
)


// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
presence, err := graphClient.Me().Presence().Get(context.Background(), nil)


// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

Presence result = graphClient.me().presence().get();


const options = {
	authProvider,
};

const client = Client.init(options);

let presence = await client.api('/me/presence')
	.get();


<?php
use Microsoft\Graph\GraphServiceClient;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);


$result = $graphServiceClient->me()->presence()->get()->wait();


Import-Module Microsoft.Graph.CloudCommunications

# A UPN can also be used as -UserId.
Get-MgUserPresence -UserId $userId


# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python

result = await graph_client.me.presence.get()

Antwort

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

{
  "id": "fa8bf3dc-eca7-46b7-bad1-db199b62afc3",
  "availability": "Available",
  "activity": "Available",
  "outOfOfficeSettings": {
    "message": null,
    "isOutOfOffice": false
  },
  "sequenceNumber": "A0129311063"
}

Beispiel 2: Abrufen der Anwesenheitsinformationen eines anderen Benutzers

Das folgende Beispiel zeigt, wie Die Anwesenheitsinformationen für einen anderen Benutzer abgerufen werden. Für diesen Vorgang ist die Berechtigung Presence.Read.All erforderlich.

Anforderung

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


// Code snippets are only available for the latest version. Current version is 5.x

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Users["{user-id}"].Presence.GetAsync();



// Code snippets are only available for the latest major version. Current major version is $v1.*

// Dependencies
import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
	  //other-imports
)


// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
presence, err := graphClient.Users().ByUserId("user-id").Presence().Get(context.Background(), nil)


// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

Presence result = graphClient.users().byUserId("{user-id}").presence().get();


const options = {
	authProvider,
};

const client = Client.init(options);

let presence = await client.api('/users/66825e03-7ef5-42da-9069-724602c31f6b/presence')
	.get();


<?php
use Microsoft\Graph\GraphServiceClient;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);


$result = $graphServiceClient->users()->byUserId('user-id')->presence()->get()->wait();


Import-Module Microsoft.Graph.CloudCommunications

Get-MgUserPresence -UserId $userId


# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python

result = await graph_client.users.by_user_id('user-id').presence.get()

Antwort

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

{
  "id": "66825e03-7ef5-42da-9069-724602c31f6b",
  "availability": "DoNotDisturb",
  "activity": "Presenting",
  "outOfOfficeSettings": {
    "message": null,
    "isOutOfOffice": false
  },
  "sequenceNumber": "A0129311063"
}

Beispiel 3: Abrufen der Anwesenheitsinformationen eines anderen Benutzers

Das folgende Beispiel zeigt, wie Die Anwesenheitsinformationen für einen anderen Benutzer abgerufen werden. Für diesen Vorgang ist die Berechtigung Presence.Read.All erforderlich.

Anforderung

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


// Code snippets are only available for the latest version. Current version is 5.x

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Communications.Presences["{presence-id}"].GetAsync();



// Code snippets are only available for the latest major version. Current major version is $v1.*

// Dependencies
import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
	  //other-imports
)


// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
presences, err := graphClient.Communications().Presences().ByPresenceId("presence-id").Get(context.Background(), nil)


// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

Presence result = graphClient.communications().presences().byPresenceId("{presence-id}").get();


const options = {
	authProvider,
};

const client = Client.init(options);

let presence = await client.api('/communications/presences/dc74d9bb-6afe-433d-8eaa-e39d80d3a647')
	.get();


<?php
use Microsoft\Graph\GraphServiceClient;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);


$result = $graphServiceClient->communications()->presences()->byPresenceId('presence-id')->get()->wait();


Import-Module Microsoft.Graph.CloudCommunications

Get-MgCommunicationPresence -PresenceId $presenceId


# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python

result = await graph_client.communications.presences.by_presence_id('presence-id').get()

Antwort

HTTP/1.1 200 OK

{
  "value": [
    {
      "id": "dc74d9bb-6afe-433d-8eaa-e39d80d3a647",
      "availability": "Away",
      "activity": "BeRightBack",
      "outOfOfficeSettings": {
        "message": null,
        "isOutOfOffice": false
      },
      "sequenceNumber": "A0129311063"
    }
  ]
}

Feedback

War diese Seite hilfreich?

Last updated on 2025-07-30

Freigeben über

Anwesenheit abrufen

Berechtigungen

HTTP-Anforderung

Anforderungsheader

Anforderungstext

Antwort

Beispiele

Beispiel 1: Abrufen eigener Anwesenheitsinformationen

Anforderung

Antwort

Beispiel 2: Abrufen der Anwesenheitsinformationen eines anderen Benutzers

Anforderung

Antwort

Beispiel 3: Abrufen der Anwesenheitsinformationen eines anderen Benutzers

Anforderung

Antwort

Feedback

Zusätzliche Ressourcen