閱讀英文 編輯

共用方式為

What's new in Microsoft Graph

  • 發行項

Microsoft Graph provides a unified programmability model that you can use to access data in Microsoft 365, Windows, and Enterprise Mobility + Security. This article provides information about what's new in Microsoft Graph APIs, documentation, SDKs, and more.

For more detailed API-level updates, see the Microsoft Graph API changelog.

For details about previous updates to Microsoft Graph, see Microsoft Graph what's new history.

重要

Features in preview status are subject to change without notice, and might not be promoted to generally available (GA) status. Don't use preview features in production apps.

February 2025: New and generally available

Device and app management | Cloud printing

Use the printerDiscoverySettings property on printSettings to specify settings that affect printer discovery when using Universal Print.

Security

Added teamsMessageEvidence as a supported alert evidence.

Security | eDiscovery

Teamwork and communications | Calls and online meetings

Teamwork and communications | Messaging

  • Get all members from a channel, including direct and indirect members of a shared channel.
  • Create a one-on-one chat with installed apps.
  • Create a one-on-one chat with RSC-granted apps.

February 2025: New in preview only

Backup storage

Security | eDiscovery

  • Added the itemsToInclude, cloudAttachmentVersion, documentVersion, additionalDataOptions, and statisticsOptions as supported properties and parameters across various resources and actions of the eDiscovery API.
  • Enabled contentQuery as a supported parameter for the update operation of the ediscoveryHoldPolicy resource.
  • List and delete a userSource or siteSource object.
  • Delete a unifiedGroupSource.

Device and app management | Cloud PC

Identity and access | Identity and sign-in

Replaced the following API operations for managing custom authentication extensions:

Old endpoint Recommended endpoint
GET /identity/authenticationEventListeners/{listenerId}/microsoft.graph.onAttributeCollectionStartListener/handler/microsoft.graph.onAttributeCollectionStartCustomExtensionHandler/customExtension

GET /identity/authenticationEventListeners/{listenerId}/microsoft.graph.onAttributeCollectionSubmitListener/handler/microsoft.graph.onAttributeCollectionSubmitCustomExtensionHandler/customExtension

GET /identity/authenticationEventListeners/{listenerId}/microsoft.graph.OnEmailOtpSendListener/handler/microsoft.graph.OnOtpSendCustomExtensionHandler/customExtension		 GET /identity/customAuthenticationExtensions/{customAuthenticationExtensionId}
PUT /identity/authenticationEventListeners/{listenerId}/microsoft.graph.onAttributeCollectionStartListener/handler/microsoft.graph.onAttributeCollectionStartCustomExtensionHandler/customExtension/$ref

PUT /identity/authenticationEventListeners/{listenerId}/microsoft.graph.onAttributeCollectionSubmitListener/handler/microsoft.graph.onAttributeCollectionSubmitCustomExtensionHandler/customExtension/$ref

PUT /identity/authenticationEventListeners/{listenerId}/microsoft.graph.onEmailOtpSendListener/handler/microsoft.graph.onOtpSendCustomExtensionHandler/customExtension/$ref		 PATCH /identity/customAuthenticationExtensions/{customAuthenticationExtensionId}

Security

Added teamsMessageEvidence as a supported alert evidence.

Sites and lists

Enabled the application permission Sites.Archive.All for the site: archive and site: unarchive methods.

Tasks and plans

  • List Planner plans owned by a shared channel in Teams.
  • Updated the request URL of the List businessScenarioTasks method to require the $filter query parameter to scope the request to an externalObjectId, externalContextId, or a groupId.

Teamwork and communications | Calls and online meetings

Enabled the allowRecording, allowTranscription, anonymizeIdentityForRoles, broadcastSettings, and watermarkProtection as supported properties in the update operation of the onlineMeeting.

Teamwork and communications | Messaging

  • Introduced the following more granular delegated and application permissions for retrieving all members of a channel:
    • Use the ChannelMember.Read.All delegated permission instead of the Group.Read.All delegated permission.
    • Use the ChannelMember.Read.Group and ChannelMember.ReadWrite.Group application permissions for resource-specific consent.
  • Create a one-on-one chat with RSC-granted apps.

January 2025: New and generally available

Files

Updated the endpoint of the fileStorageContainer: restore method.

Identity and access | Identity and sign-in

Added riskEventType entry for the Suspicious API Traffic detection for service principals.

Microsoft Graph Bicep templates

You can now deploy the user resource in a Bicep template for your infrastructure as code (IaC) projects. For more information, see the Microsoft.Graph users Bicep reference.

Teamwork and communications | Calls and online meetings

  • Microsoft Teams custom meeting templates allow you to specify values for many of the meeting options available to meeting organizers. Use the meetingTemplateId property on onlineMeeting to create an online meeting with a meeting template.
  • Use the allowBreakoutRooms, allowLiveShare, allowPowerPointSharing, and allowWhiteboard to indicate whether breakout rooms, live share, PowerPoint live, and whiteboard features are enabled in an onlineMeeting or virtualEventSession.
  • Use the allowedLobbyAdmitters property on onlineMeeting to get or set the users who can admit from the lobby.
  • Use the allowRecording and allowTranscription properties on the onlineMeeting and virtualEventSession to indicate whether recording or transcription is enabled for a meeting or virtual event session.

Teamwork and communications | Messaging

  • Get a chat message with an @mention for everyone.
  • Get a chat message that has a forwarded message as an attachment.
  • Use the isHiddenForAllMembers property to indicate whether a chat is hidden from all its members.

January 2025: New in preview only

Change notifications

Enabled change notifications support to the methods to list, get, create, update, delete, and reauthorize a subscription for aiInteraction.

Device and app management | Cloud PC

Files

Updated the endpoint of the fileStorageContainer: restore method.

Identity and access | Directory management

  • Use the alternativeNames property on device to get or set alternative names for a device.
  • Use the deviceTemplate resource and its associated methods to manage device templates for devices in Microsoft Entra ID.
  • Use the mutualTlsOauthConfiguration resource and its associated methods to manage certificate authorities that are permitted to issue certificates for a specific set of objects used for mTLS.

Identity and access | Identity and sign-in

Added support for configuring a custom email provider for one-time passcodes (OTP) in Microsoft Entra External ID by using the following objects:

  • The onOtpSendCustomExtension resource type to configure the custom authentication extension that contains configuration details of the external service that might be an Azure Function.
  • The onEmailOtpSendListener resource type to configure the event listener that is triggered to send the OTP prompt to the user, based on the configuration details in the onOtpSendCustomExtension object.

The functionality also allows you to configure the default fallback option when the custom authentication extension isn't successfully called.

Industry data ETL

Use the start operation on the industryDataRun resource to perform an on-demand run, with throttling limits of up to five successful runs every 12 hours.

Mailbox import and export

Use the new mailbox import and export APIs in Microsoft Graph to build solutions that integrate with mailbox resources for data import and export scenarios. For more information, see Overview of the mailbox import and export APIs in Microsoft Graph.

Reports | Identity and access reports

Added attributeCollectionStart, attributeCollectionSubmit, and emailOtpSend as supported values for the eventType property of the appliedAuthenticationEventListener resource.

Sites and lists

Archive or unarchive a SharePoint site.

Tasks and plans

Use the teamsChannel container type to create plans in shared channels in Microsoft Teams.

Teamwork and communications | Calls and online meetings

Get change notifications for Microsoft Teams emergency call event updates.

Teamwork and communications | Messaging

Get a chat message that includes a Microsoft Loop component as two attachments.

Contribute to Microsoft Graph

Are there scenarios you'd like Microsoft Graph to support?

  • Suggest and vote for new features by using the Microsoft Graph Feedback Portal. Some new features originate as popular requests from the developer community. The Microsoft Graph team regularly evaluates customer needs and releases new features to the beta (https://graph.microsoft.com/beta) and v1.0 (https://graph.microsoft.com/v1.0) endpoints.

  • Join the weekly Microsoft 365 platform community call and become an active member of the Microsoft Graph community. To discover the full calendar of developer calls, visit the Microsoft 365 and Power Platform community page.

  • Join our research panel to provide your input on our developer experiences.

Related content