Abonnementressourcentyp

Mit einem Abonnement kann eine Client-App Benachrichtigungen zu Daten in Microsoft Graph erhalten. Für die folgenden Datensätze sind derzeit Abonnements aktiviert:

  1. E-Mail, Ereignisse und Kontakte aus Outlook
  2. Unterhaltungen aus Office-Gruppen.
  3. Laufwerkstammelemente aus OneDrive

JSON-Darstellung

Es folgt eine JSON-Darstellung der Ressource.

{
  "changeType": "string",
  "notificationUrl": "string",
  "resource": "string",
  "expirationDateTime": "string (timestamp)",
  "id": "string (identifier)",
  "clientState": "string"
}

Eigenschaften

Eigenschaft Typ Beschreibung
changeType string Gibt den Typ der Änderung in der abonnierten Ressource an, die eine Benachrichtigung auslöst. Unterstützte Werte sind: created, updated, deleted. Es können mehrere Werte mithilfe einer durch Trennzeichen getrennten Liste zusammen verwendet werden.
notificationUrl string Die URL des Endpunkts, der die Benachrichtigungen erhält. Diese URL muss das HTTPS-Protokoll verwenden.
Ressourcen string Gibt die Ressource an, deren Änderungen überwacht werden. Schließen Sie die Basis-URL nicht mit ein („https://graph.microsoft.com/v1.0/“).
expirationDateTime dateTime Gibt Datum und Uhrzeit für das Ablaufen des Webhook-Abonnements an. Die Zeit wird in UTC angegeben und kann eine Dauer aus der Erstellung des Abonnements sein, die von der abonnierten Ressource abweicht. Maximal zulässige Werte finden Sie in der unten aufgeführten Tabelle.
clientState string Gibt den Wert der clientState-Eigenschaft an, die in jeder Benachrichtigung vom Dienst gesendet wird. Die Höchstlänge beträgt 128 Zeichen. Der Client kann prüfen, ob die Benachrichtigung vom Dienst stammt, indem er den Wert der mit dem Abonnement gesendeten clientState-Eigenschaft mit dem Wert der mit jeder Benachrichtigung empfangenen clientState-Eigenschaft vergleicht.
id string Eindeutige ID für das Abonnement. Schreibgeschützt.

Maximal zulässige Ablaufzeit pro Ressource

Ressource Maximal zulässige Ablaufzeit
Mail 4230 Minuten.
Kalender 4230 Minuten.
Kontakte 4230 Minuten.
Gruppenunterhaltungen 4230 Minuten.
Laufwerkstammelemente 86400 Minuten.

Beziehungen

Keine

Methoden

Methode Rückgabetyp Beschreibung
Create subscription Abonnement Abonniert eine Listener-Anwendung zum Empfangen von Benachrichtigungen, wenn Microsoft Graph-Daten geändert werden.
Update subscription Abonnement Erneuert ein Abonnement durch Aktualisierung der Ablaufzeit.
Get subscription Abonnement Dient zum Lesen der Eigenschaften und der Beziehungen des subscription-Objekts.
Delete subscription Keine Löscht ein subscription-Objekt.