Kalender: Delta

Namespace: microsoft.graph

Abrufen einer Reihe von Kalenderressourcen , die im Postfach eines Benutzers hinzugefügt, aktualisiert oder gelöscht werden.

Normalerweise erfordert das Synchronisieren von Kalendern in einem Postfach in einem lokalen Speicher eine Runde mehrerer Delta-Funktionsaufrufe. Der erste Aufruf ist eine vollständige Synchronisierung. Jeder nachfolgende Delta-Aufruf in derselben Runde erhält die inkrementellen Änderungen (Hinzufügungen, Löschungen oder Aktualisierungen). Mithilfe von Deltas können Sie einen lokalen Speicher von Kalendern im angegebenen Postfach inkrementell verwalten und synchronisieren.

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) Calendars.Read Calendars.ReadBasic, Calendars.ReadWrite
Delegiert (persönliches Microsoft-Konto) Calendars.Read Calendars.ReadBasic, Calendars.ReadWrite
Anwendung Calendars.Read Calendars.ReadBasic, Calendars.ReadWrite

HTTP-Anforderung

Um mit der Nachverfolgung von Änderungen zu beginnen, stellen Sie eine Anforderung, die die Delta-Funktion für die Kalenderressource enthält.

Für inkrementelle Änderungen an der Kalenderliste im Postfach des Benutzers.

GET /me/calendars/delta
GET /users/{usersId}/calendars/delta

Abfrageparameter

Das Nachverfolgen von Änderungen führt zu einer Runde von mindestens einem Delta-Funktionsaufruf. Wenn Sie Abfrageparameter (außer $deltatoken und $skiptoken) verwenden, müssen Sie sie in der ursprünglichen Delta-Anforderung angeben. Microsoft Graph codiert automatisch alle angegebenen Parameter in den Tokenteil der @odata.nextLink - oder @odata.deltaLink-URL , die in der Antwort angegeben ist.

Geben Sie alle gewünschten Abfrageparameter nur in der anfänglichen Anforderung an.

Verwenden Sie in nachfolgenden Anforderungen die URL @odata.nextLink oder @odata.deltaLink aus der vorherigen Antwort. Die URL enthält bereits die codierten Abfrageparameter.

Abfrageparameter Typ Beschreibung
$deltatoken Zeichenfolge Ein Zustandstoken, das in der @odata.deltaLink-URL des vorherigen Delta-Funktionsaufrufs für dieselbe Kalenderliste zurückgegeben wurde und den Abschluss dieser Runde der Änderungsnachverfolgung angibt. Speichern Sie die gesamte @odata.deltaLink-URL , einschließlich dieses Tokens, und wenden Sie sie in der ersten Anforderung der nächsten Runde der Änderungsnachverfolgung für diese Kalenderliste an.
$skiptoken string Ein Zustandstoken, das in der @odata.nextLink-URL des vorherigen Delta-Funktionsaufrufs zurückgegeben wurde und angibt, dass weitere Änderungen in derselben Kalenderliste nachverfolgt werden müssen.

Optionale Abfrageparameter

Diese Methode unterstützt optionale OData-Abfrageparameter , um die Antwort anzupassen.

  • Sie können einen $select Abfrageparameter wie in jeder GET-Anforderung verwenden, um nur die Eigenschaften anzugeben, die Sie für eine optimale Leistung benötigen.
  • Die Delta-Funktion unterstützt die folgenden Abfrageparameter nicht: $expand, $filter, $orderbyund $search.

Anforderungsheader

Name Typ Beschreibung
Authorization string Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung.
Content-Type string application/json. Erforderlich.
Prefer string odata.maxpageSize={x}. Optional.

Anforderungstext

Geben Sie keinen Anforderungstext für diese Methode an.

Antwort

Bei erfolgreicher Ausführung gibt diese Funktion einen 200 OK Antwortcode und eine Auflistung von Kalenderobjekten im Antworttext zurück.

Beispiele

Anforderung

Das folgende Beispiel zeigt eine Anforderung ohne den $select Parameter. Ein Standardsatz von Eigenschaften wird nachverfolgt und zurückgegeben.

GET https://graph.microsoft.com/v1.0/me/calendars/delta

Antwort

Wenn die Anforderung erfolgreich ist, enthält die Antwort ein Zustandstoken, das entweder a $skipToken (in einem @odata.nextLink-Antwortheader ) oder ein $deltaToken (in einem @odata.deltaLink-Antwortheader ) ist. Sie zeigen jeweils an, ob Sie mit der Runde fortfahren sollten oder ob Sie alle Änderungen für diese Runde erhalten haben.

Die folgende Antwort zeigt einen $deltaToken in einem @odata.deltaLink-Antwortheader an.

Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.

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

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#Collection(calendar)",
    "value": [
        {
            "@odata.type": "#microsoft.graph.calendar",
            "id": "AQMkADRhZThkMDVjLTJmNDctNDUyZC05YjA2LTI2YzRmMTIxOWJhZQBGAAADVDIMnvGkNkGo5_ASLe7iUQcAvXegGcyc-0O1dA1ftrtB6QAAAgEGAAAAvXegGcyc-0O1dA1ftrtB6QAAAUSwewAAAA==",
            "name": "Calendar",
            "color": "auto",
            "hexColor": "",
            "groupClassId": "0006f0b7-0000-0000-c000-000000000046",
            "isDefaultCalendar": true,
            "changeKey": "vXegGcyc/0O1dA1ftrtB6QAAAEO+6Q==",
            "canShare": true,
            "canViewPrivateItems": true,
            "isShared": false,
            "isSharedWithMe": false,
            "canEdit": true,
            "calendarGroupId": null,
            "allowedOnlineMeetingProviders": [
                "teamsForBusiness"
            ],
            "defaultOnlineMeetingProvider": "teamsForBusiness",
            "isTallyingResponses": true,
            "isRemovable": false,
            "owner": {
                "name": "Samantha Booth",
                "address": "samanthab@contoso.com"
            }
        },
        {
            "@odata.type": "#microsoft.graph.calendar",
            "id": "AQMkADRhZThkMDVjLTJmNDctNDUyZC05YjA2LTI2YzRmMTIxOWJhZQBGAAADVDIMnvGkNkGo5_ASLe7iUQcAvXegGcyc-0O1dA1ftrtB6QAAAgEGAAAAvXegGcyc-0O1dA1ftrtB6QAAAU4pOwAAAA==",
            "name": "Birthdays",
            "color": "auto",
            "hexColor": "",
            "groupClassId": "0006f0b7-0000-0000-c000-000000000046",
            "isDefaultCalendar": false,
            "changeKey": "vXegGcyc/0O1dA1ftrtB6QAAAEzvog==",
            "canShare": false,
            "canViewPrivateItems": true,
            "isShared": false,
            "isSharedWithMe": false,
            "canEdit": false,
            "calendarGroupId": null,
            "allowedOnlineMeetingProviders": [],
            "defaultOnlineMeetingProvider": "unknown",
            "isTallyingResponses": false,
            "isRemovable": true,
            "owner": {
                "name": "Samantha Booth",
                "address": "samanthab@contoso.com"
            }
        }
    ],
    "@odata.deltaLink": "https://graph.microsoft.com/v1.0/me/calendars/delta?$deltatoken=LztZwWjo5IivWBhyxw5rAIPrk_3pGHcZr4U33FHo0HpyBLqdo9QZIWfEL4AW1jMLBmo-o1ybmYCWlzQ5elO2bEDejh9Z8kYv_z4nhmHoC5Y.7Wdj3MWiils6M--JMM9dMyiLCh-1he4AZCqBu-8i42o"
}
  • Zuletzt aktualisiert um