Neuerungen in Microsoft Graph

Microsoft Graph bietet ein einheitliches Programmiermodell, mit dem Sie auf Daten in Microsoft 365, Windows und Enterprise Mobility + Security zugreifen können. Dieser Artikel enthält Informationen zu den Neuerungen in Microsoft Graph-APIs, Dokumentation, SDKs und mehr.

Ausführlichere Updates auf API-Ebene finden Sie im Microsoft Graph-API-Änderungsprotokoll.

Ausführliche Informationen zu früheren Updates für Microsoft Graph finden Sie unter Microsoft Graph-Verlauf "Neuerungen".

Wichtig

Features in Preview-status können ohne vorherige Ankündigung geändert werden und werden möglicherweise nicht in allgemein verfügbare status heraufgestuft. Verwenden Sie keine Vorschaufeatures in Produktions-Apps.

Oktober 2026: Neu und allgemein verfügbar

Kalender

  • Die Eigenschaft isSharedWithMe der Kalenderressource wurde von Beta auf v1.0 aufgestuft. Die Eigenschaft wird verwendet, um die freigegebenen Kalender zu identifizieren.
  • Dem Kalenderressourcentyp wurde die Deltamethode hinzugefügt. Verwenden Sie es, um Kalender nachzuverfolgen, die im Postfach eines Benutzers hinzugefügt, gelöscht oder aktualisiert wurden.

E-Mail | Nachrichtenablaufverfolgung

Unterstützung für die Identifizierung von zurückgerufenen Nachrichten in der Nachrichtenablaufverfolgung hinzugefügt. Wird als unterstützter Wert der Eigenschaft status der exchangeMessageTrace-Ressource verwendetrecalled.

Oktober 2026: Neu nur in der Vorschau

Sicherung und Wiederherstellung | Microsoft 365 Backup und Speicher

  • Verfolgen Sie Administratoraktivitäten für Sicherungs- und Wiederherstellungsressourcen, einschließlich Richtlinienänderungen, Ausführung dynamischer Regeln, Offboarding und Abschluss von Wiederherstellungsaufgaben, mithilfe der activityLogBase-Ressource und ihrer abgeleiteten Typen.
  • Die Eigenschaft tags im restoreTaskActivityLog wurde zugunsten der restoreJobType-Eigenschaft entfernt. Verwenden Sie die restoreJobType-Eigenschaft mit Werten aus dem Enumerationstyp restoreJobType .
  • Das backupPolicyDeleted-Element wurde als neuer unterstützter Wert für die activityType-Eigenschaft der activityLogBase-Ressource und ihren abgeleiteten Typen hinzugefügt.

Geräte- und App-Verwaltung | Cloud-PC

Das Datum, an dem veraltete Bildeigenschaften auf cloudPcDeviceImage, cloudPcSourceDeviceImage und cloudPcGalleryImage vom 31. Januar 2024 bis zum 7. Dezember 2026 keine Daten mehr zurückgeben, wurde aktualisiert. Für "recommendedSku" ist kein Ersatz geplant. Lesen Sie die Anleitung zum Ersetzen von Eigenschaften in diesen Ressourcenthemen, und aktualisieren Sie die betroffenen Integrationen vor Ablauf des Stichtags.

Dateien

Die getSharePointApiUsage-Methode wurde aktualisiert, um SharePoint-Dienstpriorisierungsberichte zu unterstützen. Verwenden Sie diesen Bericht, um die Gesamtzahl der gesamten, standardmäßigen, schweren, abgerechneten Standard- und abgerechneten hohen API-Anforderungen nach Anwendung und Datum abzurufen.

Identität und Zugriff | Governance

  • Der Ressourcentyp accessDriftSummary und verwandte Methoden wurden hinzugefügt, um verwaltete Ressourcen zu identifizieren, deren tatsächlicher Zugriff von der Absicht des Zugriffspakets abweicht. Verwenden Sie ihn, um Zusammenfassungen der Abweichung aufzulisten und zu überprüfen, Abweichungsdetails abzurufen und Berichte über den Massenabgleich herunterzuladen. Details zu Zugriffsabweichungen Ermitteln Sie, ob jede betroffene Identität ein Benutzer oder eine Gruppe ist, indem Sie die identityType-Eigenschaft von entraDriftIdentityInfo verwenden.

E-Mail | Nachrichtenablaufverfolgung

Unterstützung für die Identifizierung von zurückgerufenen Nachrichten in der Nachrichtenablaufverfolgung hinzugefügt. Wird als unterstützter Wert der Eigenschaft status der exchangeMessageTrace-Ressource verwendetrecalled.

Postfachimport und -export

Sicherheit

Der detectionAction-Ressource und dem komplexen Typ incidentConfiguration wurde die Eigenschaft incidentConfiguration hinzugefügt. Verwenden Sie diese Einstellung, um Warnungen, die von einer benutzerdefinierten Erkennungsregel generiert wurden, von der automatischen Incidentkorrelation auszuschließen und eigenständige Incidents mit einer einzelnen Warnung zu erstellen.

Sicherheit | Abfrage des Überwachungsprotokolls

Der auditLogRecordType-Enumeration wurden 35 Elemente von PlannerCustomFieldDefinition bis MESRawEmailContentMetadata, und die entsprechenden abgeleiteten auditData-Typen hinzugefügt, um workloadspezifische Überwachungsereignisnutzlasten darzustellen.

Sicherheit | Datensicherheit und Compliance

Die Enumeration evaluationErrorType wurde aktualisiert, um kundenorientierte Gründe für unvollständige Richtlinienauswertungen zu verwenden, und die errorMessage-Eigenschaft wurde aus dem komplexen Typ evaluationErrorDetail entfernt. Verwenden Sie errorType , um zu ermitteln, warum eine Auswertung nicht abgeschlossen werden konnte.

Sicherheit | Arbeitsmappen

  • Der Ressourcentyp der Arbeitsmappe und verwandte Methoden wurden hinzugefügt, um mandantenbezogene Microsoft Security-Arbeitsmappendokumente zu verwalten. Verwenden Sie stabile IDs für wiederholbare Bereitstellungen, und ersetzen Sie den JSON-Inhalt einer Arbeitsmappe als vollständiges Dokument.

Teamarbeit und Kommunikation | Nachrichten

Unterstützung für das Festlegen und Entfernen benutzerdefinierter Emoji-Reaktionen in Chatnachrichten wurde hinzugefügt, indem ein Anzeigename (displayName), ein vom Dienst ausgegebener Bezeichner (reactionId) oder beides angegeben wird. Weitere Informationen finden Sie unter chatMessageReaction.

September 2026: Neu und allgemein verfügbar

Kalender | Arbeitszeiten und -orte

Den Ressourcen "workHoursAndLocationsSetting", "workPlanOccurrence" und "workPlanRecurrence " und zugehörigen Methoden wurde reine App-Unterstützung hinzugefügt. Apps können die Calendars.Read.All Anwendungsberechtigung verwenden, um die Einstellungen, Serien und Vorkommen eines Benutzers zu lesen sowie Calendars.ReadWrite.All diese zu erstellen, zu aktualisieren und zu löschen.

Benachrichtigungen ändern

Das unknownFutureValue Mitglied der changeType-Enumeration wurde von Beta auf v1.0 heraufgestuft. Die Enumeration wird von den Ressourcen changeNotification und commsNotification verwendet, um Änderungstypen für Benachrichtigungen zu identifizieren.

Dateien

Gruppen

Der Gruppenressource wurde die Eigenschaft onPremisesExtensionAttributes hinzugefügt. Verwenden Sie es, um auf die Erweiterungsattribute 1-15 zuzugreifen, die vom lokalen Active Directory synchronisiert werden.

Identität und Zugriff | Verzeichnisverwaltung

  • Der Ressourcentyp directoryRoleManagementDeletedItemContainer und verwandte Methoden wurden zu Version 1.0 hinzugefügt. Verwenden Sie diese APIs, um vorläufig gelöschte benutzerdefinierte Rollen aufzulisten und zu überprüfen, sie in der Sammlung aktiver Rollendefinitionen wiederherzustellen oder endgültig zu löschen.
  • Der Geräteressource wurde die Bereitstellungsaktion in Version 1.0 hinzugefügt, um genehmigten VDI-Anbietern (Virtual Desktop Infrastructure) die Bereitstellung von Geräten im Verzeichnis eines Kunden zu ermöglichen. Der Geräteressource wurde die Bereitstellungsaktion in Version 1.0 hinzugefügt, um genehmigten VDI-Anbietern (Virtual Desktop Infrastructure) die Bereitstellung von Geräten im Verzeichnis eines Kunden zu ermöglichen.

Identität und Zugriff | Governance

Identität und Zugriff | Identität und Anmeldung

  • Der Ressourcentyp resourceAccountKeyAuthenticationMethod und verwandte Methoden zum Verwalten der Anmeldeinformationen von Ressourcenkontoschlüsseln auf gemeinsam genutzten Geräten wurden hinzugefügt. Verwenden Sie die APIs zum Auflisten, Abrufen und Löschen von Anmeldeinformationen, die es Geräten wie Teams-Räume und Teams-Telefonen ermöglichen, sich ohne Benutzerinteraktion anzumelden.
  • Es wurden die Ressourcentypen anonymousCalendarSharingFreeBusyDetail, anonymousCalendarSharingFreeBusyReviewer und anonymousCalendarSharingFreeBusySimple hinzugefügt. Verwenden Sie diese mandantenübergreifenden Zugriffsrichtlinienfunktionen, um anonyme externe Benutzer zu autorisieren, Frei/Gebucht-Informationen im Kalender auf verschiedenen Detailebenen anzuzeigen.

Sicherheit | Abfrage des Überwachungsprotokolls

Der Ressource auditLogQuery wurden die Eigenschaften "isRecordCountLimitExceeded", "recordCountLimit" und "approximateReturnedRecordCount" hinzugefügt. Verwenden Sie diese Eigenschaften, um zu bestimmen, ob eine abgeschlossene Abfrage den Grenzwert für die Datensatzanzahl pro Suche überschritten hat, und um den anwendbaren Grenzwert und die ungefähre Anzahl der zurückgegebenen Datensätze zu überprüfen.

Teamarbeit und Kommunikation | Nachrichten

Die getAllRetainedMessages-Methode wurde aktualisiert, um den Export beibehaltener Versionen von Nachrichten aus privaten Kanälen zu unterstützen, die nach Abschluss der Speichermigration des Mandanten im privaten Kanal bearbeitet oder gelöscht wurden.

September 2026: Neu nur in der Vorschau

Agents

Der Ressource agentIdentityBlueprint wurde die isDisabled-Eigenschaft hinzugefügt. Verwenden Sie es, um eine Blaupause für die Agentidentität zu deaktivieren, ohne sie zu löschen.

Application

Der onPremisesPublishing-Ressource wurde die Eigenschaft isDeviceAccessEnabled hinzugefügt, um den Gerätezugriff für Microsoft Entra Private Access zu konfigurieren.

Sicherung und Wiederherstellung | Microsoft 365 Backup und Speicher

  • Dem Ressourcentyp restoreSessionBase wurde die Eigenschaft policyId hinzugefügt, um Wiederherstellungssitzungen auf eine Schutzrichtlinie zu beschränken.
  • Der Suchmethode restorePoint: wurde der optionale Parameter "policyId" hinzugefügt, um die Mitgliedschaft in Schutzeinheiten zu überprüfen und das Routing im Richtlinienbereich zu verbessern. Du kannst die Sammlung von Wiederherstellungspunkten auch filtern nach protectionUnit/policyId.

Sicherungsspeicher

  • Die getStatisticsByPolicy-Methode wurde hinzugefügt, um Schutzstatistiken auf Richtlinienebene für Microsoft 365-Backup-Speicher abzurufen. Verwenden Sie den Bericht, um geschützte und ungeschützte Artefakte über abgeschlossene, in Bearbeitung befindliche und fehlgeschlagene Zustände hinweg zu überwachen, Offboarding-Aktivitäten zu überprüfen und zu bestimmen, wann die Metriken zuletzt berechnet wurden.

Calendar | Places

  • Der Ressourcentyp stringDictionary wurde hinzugefügt, um benutzerdefinierte Schlüssel-Wert-Paare aus Zeichenfolgen darzustellen.
  • Die Eigenschaft customProperties wurde dem place resource-Typ hinzugefügt, um benutzerdefinierte Schlüssel-Wert-Paare aus Zeichenfolgen zu speichern.
  • Dem Ortsressourcentyp wurde die schreibgeschützte Eigenschaft lastUpdatedTime hinzugefügt, um anzugeben, wann der Ort zuletzt aktualisiert wurde.

Kalender | Arbeitszeiten und -orte

Den Ressourcen "workHoursAndLocationsSetting", "workPlanOccurrence" und "workPlanRecurrence " und zugehörigen Methoden wurde reine App-Unterstützung hinzugefügt. Apps können die Calendars.Read.All Anwendungsberechtigung verwenden, um die Einstellungen, Serien und Vorkommen eines Benutzers zu lesen sowie Calendars.ReadWrite.All diese zu erstellen, zu aktualisieren und zu löschen.

Benachrichtigungen ändern

Das unknownFutureValue Element wurde der changeType-Enumeration hinzugefügt, die von der changeNotification-Ressource verwendet wird, um vorwärtskompatible Änderungstypen für Benachrichtigungen zu unterstützen.

Geräte- und App-Verwaltung | Cloud-PC

  • Der cloudPC-Ressource wurde die Eigenschaft isDisasterRecoveryActive hinzugefügt, um anzugeben, ob der Cloud-PC nach einem Failover-Ereignis derzeit in seiner Notfallwiederherstellungsregion ausgeführt wird.
  • Verwenden Sie failoverInProgress and failbackInProgress als unterstützte Werte für die Eigenschaft status für die Ressourcen cloudPC und cloudPcStatusSummary.

Dateien

  • Der Parameter userObjectId wurde der getByUser-Methode der fileStorageContainer-Ressource hinzugefügt, um eine Liste von Dateispeichercontainern abzurufen, die einem Benutzer gehören, indem die Microsoft Entra ID-Objekt-ID des Benutzers übergeben wird.
  • Der Ressource fileStorageContainerCustomPropertyValue wurde die isPatternToken-Eigenschaft hinzugefügt, um anzugeben, ob es sich bei einem benutzerdefinierten Eigenschaftswert um ein urlTemplate Muster handelt, das Verbraucher vor der Verwendung auflösen müssen, und nicht um einen Literalwert.

Identität und Zugriff | Verzeichnisverwaltung

  • Der Ressourcentyp directoryRoleManagementDeletedItemContainer und verwandte Methoden zum Wiederherstellen von benutzerdefinierten Rollendefinitionen, die gelöscht wurden, wurden hinzugefügt. Verwenden Sie diese APIs, um vorläufig gelöschte benutzerdefinierte Rollen aufzulisten und zu überprüfen, sie in der Sammlung aktiver Rollendefinitionen wiederherzustellen oder endgültig zu löschen.
  • Der Geräteressource wurde die Bereitstellungsaktion hinzugefügt, um genehmigten VDI-Anbietern (Virtual Desktop Infrastructure) die Bereitstellung von Geräten im Verzeichnis eines Kunden zu ermöglichen.

Gruppen

  • Der Gruppenressource wurde die disableNesting-Eigenschaft hinzugefügt. Verwenden Sie es, um zu verhindern, dass andere Gruppen als Mitglieder einer Sicherheitsgruppe hinzugefügt werden.

Identität und Zugriff | Verzeichnisverwaltung

  • Der Geräteressource wurde die Bereitstellungsaktion hinzugefügt, um genehmigten VDI-Anbietern (Virtual Desktop Infrastructure) die Bereitstellung von Geräten im Verzeichnis eines Kunden zu ermöglichen.

Identität und Zugriff | Governance

  • Es wurde erläutert, dass die Get accessPackageResourceEnvironment-Methode SharePoint Online-Ressourcenumgebungen nur zurückgibt, wenn sie mit delegierten Berechtigungen aufgerufen wird. Eine SharePoint Online-Ressourcenumgebung entspricht einer SharePoint-Stammwebsite. Verwenden Sie daher zum Abrufen von Stammwebsiteinformationen mit Anwendungsberechtigungen die Methode "Websites auflisten " mit der $filter=siteCollection/root ne null Abfrageoption.
  • Unterstützung für Public Preview für Lebenszyklusrichtlinien hinzugefügt, die Agent-Identitäten und Gastbenutzer steuern. Verwenden Sie lifecyclePolicy und die abgeleiteten Richtlinientypen, um Umfang, Regeln, Workflowerzwingung, Auswirkungsbewertung und Verarbeitung von Berichten zu konfigurieren.
  • Zum Nachweis wurden Gastbenutzer-Lebenszyklusaktionen hinzugefügt, der angemeldete Benutzer als Sponsor hinzugefügt und der angemeldete Benutzer als Sponsor entfernt.

Identität und Zugriff | Identität und Anmeldung

Die requireCertificateSidAlignment-Eigenschaft wurde der x509CertificateAuthenticationMethodConfiguration-Ressource hinzugefügt. Verwenden Sie es, um während der zertifikatbasierten Authentifizierung die Ausrichtung der Zertifikats-SID für Hybrid- und reine Cloudbenutzer vorzuschreiben.

Identität und Zugriff | Überwachen & Zustands

People und Workplace Intelligence | Analyse

Dem Ressourcentyp searchHit wurde die Eigenschaft sensitivityLabel hinzugefügt, um Informationen zu Vertraulichkeitsbezeichnungen für die Suchergebnisressource bereitzustellen.

Berichte | Berichte zur Partnerabrechnung

Der Ressourcentyp "billedAggregatedUsage" und die zugehörige Exportmethode wurden für CSP-Partner hinzugefügt, um abgerechnete aggregierte Azure-Nutzungsberichte für eine bestimmte Rechnung zu generieren.

Sicherheit | Abfrage des Überwachungsprotokolls

Der Ressource auditLogQuery wurden die Eigenschaften "isRecordCountLimitExceeded", "recordCountLimit" und "approximateReturnedRecordCount" hinzugefügt. Verwenden Sie diese Eigenschaften, um zu bestimmen, ob eine abgeschlossene Abfrage den Grenzwert für die Datensatzanzahl pro Suche überschritten hat, und um den anwendbaren Grenzwert und die ungefähre Anzahl der zurückgegebenen Datensätze zu überprüfen.

Sicherheit | Datensicherheit und Compliance

  • Das contentFiltering Element wurde der userActivityTypes-Enumeration hinzugefügt, die von den Computeschutzbereichen für einen Benutzer und den Computeschutzbereichen für einen Mandanten verwendet wird, sodass Anwendungen bestimmen können, ob Richtlinien zur Verhinderung von Datenverlust die Inhaltsfilterung regeln, bevor Inhalte ausgewertet werden.
  • Die contentActivity-Ressource wurde aktualisiert, um die Berichterstellung für nicht abgeschlossene Richtlinienauswertungen "Sicher" standardmäßig zu unterstützen. Erzwingungsebenen können strukturierte Gründe für unvollständigeÜberprüfungen über die API zur Erfassung vorhandener Inhaltsaktivitäten übermitteln.
  • Dem Ressourcentyp policyScopeBase wurde die Eigenschaft policyConfiguration hinzugefügt. Erzwingungsebenen können die von den Schutzbereichs-APIs zurückgegebene effektive Konfiguration "standardmäßig sicher" verwenden, um zu bestimmen, ob Inhalte überwacht oder blockiert werden sollen, wenn die Richtlinienauswertung nicht abgeschlossen werden kann.

Aufgaben und Pläne

Der Planressourcentyp für Planner Graph V4 wurde hinzugefügt. Verwenden Sie diese APIs zum Erstellen und Verwalten von Plänen und Aufgaben mit umfangreicheren Planungs-, Abhängigkeits-, benutzerdefinierten Feld- und Chatfunktionen als die vorhandene Planner-API-Oberfläche.

Teamarbeit und Kommunikation | Nachrichten

Die getAllRetainedMessages-Methode wurde aktualisiert, um die Unterstützung für beibehaltene Nachrichtenversionen für private Kanäle zu dokumentieren, die nach Abschluss der Speichermigration des Mandanten erfasst wurden.

Zu Microsoft Graph beitragen

Gibt es Szenarien, die von Microsoft Graph unterstützt werden sollen?

  • Über das Microsoft Graph-Feedbackportal können Sie neue Features vorschlagen und darüber abstimmen. Einige neue Funktionen sind aus beliebten Anfragen der Entwicklercommunity entstanden. Das Microsoft Graph-Team bewertet regelmäßig die Kundenanforderungen und veröffentlicht neue Features für die Endpunkte Beta (https://graph.microsoft.com/beta) und V1.0 (https://graph.microsoft.com/v1.0).

  • Nehmen Sie am wöchentlichen Microsoft 365-Plattform-Communityaufruf teil, und werden Sie ein aktives Mitglied der Microsoft Graph-Community. Um den vollständigen Kalender der Entwickleraufrufe zu entdecken, besuchen Sie die Community-Seite von Microsoft 365 und Power Platform.

  • Nehmen Sie an unserem Forschungspanel teil, um Ihren Beitrag zu unseren Entwicklererfahrungen zu leisten.

Verwandte Inhalte

  • Zuletzt aktualisiert um