Microsoft Graph 更改日志

此更改日志涵盖了 Microsoft Graph 变更,包括 v1.0 和 beta 终结点 Microsoft Graph API。

有关 Microsoft Graph API 已知问题的详细信息,请参阅已知问题

2017 年 8 月

OneNote

更改类型 版本 说明
添加项 v1.0 和 Beta site 添加了 onenote 导航属性。
添加项 Beta 添加了用于复制操作的目标 siteCollectionId 和目标 siteId 参数。例如:CopyNotebook

2017 年 7 月

组设置

更改类型 版本 说明
添加项 v1.0 添加了组设置支持。
新资源类型:groupSettinggroupSettingTemplatesettingValuesettingTemplateValue
更改 v1.0 将属性 classification 和导航属性settings 添加到

Intune API

更改类型 版本 说明
添加项 Beta iosMobileAppConfiguration 上添加了 assign 操作
添加项 Beta managedDevice 上添加了 syncDevice 操作
更改 Beta androidGeneralDeviceConfiguration 实体添加了 appsInstallAllowListappsLaunchBlockListappsHideList 属性
更改 Beta androidManagedAppProtection 实体添加了 disableAppEncryptionIfDeviceEncryptionIsEnabled 属性
更改 Beta defaultManagedAppProtection 实体添加了 disableAppEncryptionIfDeviceEncryptionIsEnabled 属性
更改 Beta deviceComplianceDeviceStatus 实体添加了 complianceGracePeriodExpirationDateTime 属性
更改 Beta deviceComplianceSettingState 实体添加了 complianceGracePeriodExpirationDateTime 属性
更改 Beta deviceConfigurationDeviceStatus 实体添加了 complianceGracePeriodExpirationDateTime 属性
更改 Beta deviceManagement 实体添加了 subscriptions 属性
更改 Beta deviceManagementExchangeConnector 实体添加了 version 属性
更改 Beta iosUpdateConfiguration 实体添加了 utcTimeOffsetInMinutes 属性
更改 Beta iosUpdateDeviceStatus 实体添加了 complianceGracePeriodExpirationDateTime 属性
更改 Beta macOSWiFiConfiguration 实体添加了 preSharedKey 属性
更改 Beta managedDevice 实体添加了 phoneNumberandroidSecurityPatchLeveluserDisplayName 属性
更改 Beta managedDeviceMobileAppConfigurationDeviceStatus 实体添加了 userNamedeviceModelplatformcomplianceGracePeriodExpirationDateTime 属性
更改 Beta mobileAppInstallStatus 实体添加了 userPrincipalName 属性
更改 Beta onPremisesConditionalAccessSettings 实体添加了 overrideDefaultRule 属性
更改 Beta userAppInstallStatus 实体添加了 userPrincipalName 属性
更改 Beta windows10TeamGeneralConfiguration 实体添加了 connectAppBlockAutoLaunchdeviceAccountBlockExchangeServicesdeviceAccountEmailAddressdeviceAccountExchangeServerAddressdeviceAccountRequirePasswordRotationdeviceAccountSessionInitiationProtocolAddresssettingsBlockMyMeetingsAndFilessettingsBlockSessionResumesettingsBlockSigninSuggestionssettingsDefaultVolumesettingsScreenTimeoutInMinutessettingsSessionTimeoutInMinutessettingsSleepTimeoutInMinutes 属性
更改 Beta defaultManagedAppProtection 实体添加了 deploymentSummary 导航属性
更改 Beta deviceCompliancePolicySettingState 复杂类型添加了 settingNameuserIduserNameuserEmailcurrentValue 属性
更改 Beta settingNameuserIduserNameuserEmailcurrentValue 属性添加到了 deviceConfigurationSettingState 复杂类型中
更改 Beta deviceOperatingSystemSummary 复杂类型添加了 unknownCount 属性

2017 年 6 月

Project Rome

更改类型 版本 说明
添加项 Beta 添加了以下资源和 API:
活动
创建或替换活动
删除活动
历史记录项
创建或替换历史记录项
删除历史记录项

Outlook 日历

更改类型 版本 说明
添加项 v1.0 将以下 4 个 calendar属性升级到 v1.0:canEditcanSharecanViewPrivateItemsowner

Intune API

更改类型 版本 说明
添加项 Beta 添加的新实体:
defaultDeviceCompliancePolicy
deviceConfigurationUserStateSummary
deviceManagementScriptDeviceState
deviceManagementScriptRunSummary
deviceManagementScriptUserState
iosUpdateDeviceStatus
windowsManagedDevice
windowsManagementAppHealthState
windowsManagementAppHealthSummary
添加项 Beta 新增了复杂类型:
bitLockerFixedDrivePolicy
bitLockerRecoveryOptions
bitLockerRemovableDrivePolicy
deleteUserFromSharedAppleDeviceActionResult
iosNetworkUsageRule
删除 Beta 删除了以下实体:
deviceManagementScriptState
删除 Beta 用户上删除了 wipeByDeviceTag 操作
更改 Beta androidEnterpriseWiFiConfiguration 实体添加了 innerAuthenticationProtocolForEapTtlsinnerAuthenticationProtocolForPeapouterIdentityPrivacyTemporaryValue 属性
更改 Beta androidEnterpriseWiFiConfiguration 实体删除了 nonEapAuthenticationMethodForEapTtlsnonEapAuthenticationMethodForPeapenableOuterIdentityPrivacy 属性
更改 Beta androidManagedAppProtection 实体添加了 deployedAppCount 属性
更改 Beta complianceSettingStateSummary 实体删除了 instanceDisplayNamesettingPlatform 属性
更改 Beta defaultManagedAppProtection 实体添加了 deployedAppCount 属性
更改 Beta deviceCompliancePolicyGroupAssignment 实体添加了 excludeGroup 属性
更改 Beta deviceCompliancePolicySettingStateSummary 实体删除了 instanceDisplayNamesettingPlatform 属性
更改 Beta deviceComplianceSettingState 实体删除了 devicePlatform 属性
更改 Beta deviceConfiguration 实体添加了 assignmentStatusassignmentProgressassignmentErrorMessage 属性
更改 Beta deviceManagement 实体添加了 intuneBrand 属性
更改 Beta deviceManagementScript 实体添加了 enforceSignatureCheckfileName 属性
更改 Beta iosEnterpriseWiFiConfiguration 实体添加了 innerAuthenticationProtocolForEapTtlsouterIdentityPrivacyTemporaryValue 属性
更改 Beta iosEnterpriseWiFiConfiguration 实体删除了 nonEapAuthenticationMethodForEapTtlsenableOuterIdentityPrivacy 属性
更改 Beta iosGeneralDeviceConfiguration 实体添加了 classroomAppForceUnpromptedScreenObservationkeyboardBlockDictationnetworkUsageRuleswiFiConnectOnlyToConfiguredNetworks 属性
更改 Beta iosManagedAppProtection 实体添加了 deployedAppCount 属性
更改 Beta iosWiFiConfiguration 实体添加了 preSharedKey 属性
更改 Beta macOSEnterpriseWiFiConfiguration 实体添加了 innerAuthenticationProtocolForEapTtlsouterIdentityPrivacyTemporaryValue 属性
更改 Beta macOSEnterpriseWiFiConfiguration 实体删除了 nonEapAuthenticationMethodForEapTtlsenableOuterIdentityPrivacy 属性
更改 Beta managedAppPolicy 实体删除了 lastModifiedTimedeployedAppCount 属性
更改 Beta managedDevice 实体添加了 serialNumber 属性
更改 Beta managedDevice 实体删除了 managementAgents 属性
更改 Beta targetedManagedAppConfiguration 实体添加了 deployedAppCount 属性
更改 Beta windows10EndpointProtectionConfiguration 实体添加了 bitLockerFixedDrivePolicybitLockerRemovableDrivePolicy 属性
更改 Beta windows10GeneralConfiguration 实体添加了 enterpriseCloudPrintDiscoveryEndPointenterpriseCloudPrintOAuthAuthorityenterpriseCloudPrintOAuthClientIdentifierenterpriseCloudPrintResourceIdentifierenterpriseCloudPrintDiscoveryMaxLimitenterpriseCloudPrintMopriaDiscoveryResourceIdentifieredgeBlockAddressBarDropdownedgeBlockCompatibilityListedgeClearBrowsingDataOnExitedgeAllowStartPagesModificationedgeDisableFirstRunPageedgeBlockLiveTileDataCollectionedgeSyncFavoritesWithInternetExplorer 属性
更改 Beta windowsManagementApp 实体添加了 availableVersion 属性
更改 Beta windowsManagementApp 实体删除了 onboardingStatusdeployedVersionlastModifiedTime 属性
更改 Beta windowsStoreForBusinessApp 实体添加了 packageIdentityName 属性
更改 Beta androidManagedAppProtection 实体添加了 mobileAppIdentifierDeploymentsdeploymentSummary 导航属性
更改 Beta defaultManagedAppProtection 实体添加了 mobileAppIdentifierDeployments 导航属性
更改 Beta deviceManagement 实体添加了 deviceConfigurationUserStateSummariesiosUpdateStatuses 导航属性
更改 Beta deviceManagement 实体删除了 complianceSettingStateSummaries 导航属性
更改 Beta deviceManagementScript 实体添加了 runSummarydeviceRunStatesuserRunStates 导航属性
更改 Beta deviceManagementScript 实体删除了 runStates 导航属性
更改 Beta iosManagedAppProtection 实体添加了 mobileAppIdentifierDeploymentsdeploymentSummary 导航属性
更改 Beta managedAppPolicy 实体删除了 mobileAppIdentifierDeploymentsdeploymentSummary 导航属性
更改 Beta targetedManagedAppConfiguration 实体添加了 mobileAppIdentifierDeploymentsdeploymentSummary 导航属性
更改 Beta windowsManagementApp 实体添加了 healthSummaryhealthStates 导航属性
更改 Beta appInstallationFailure 复杂类型添加了 applicationIdappNameplatformIduserFailuresdeviceFailures 属性
更改 Beta bitLockerSystemDrivePolicy 复杂类型添加了 encryptionMethodstartupAuthenticationRequiredstartupAuthenticationBlockWithoutTpmChipstartupAuthenticationTpmUsagestartupAuthenticationTpmPinUsagestartupAuthenticationTpmKeyUsagestartupAuthenticationTpmPinAndKeyUsagerecoveryOptionsprebootRecoveryEnableMessageAndUrl 属性
更改 Beta deviceCompliancePolicySettingState 复杂类型删除了 settingNameuserIduserNameuserEmailcurrentValue 属性
更改 Beta deviceConfigurationSettingState 复杂类型删除了 settingNameuserIduserNameuserEmailcurrentValue 属性
更改 Beta deviceManagementSettings 复杂类型添加了 windowsCommercialIdwindowsCommercialIdLastModifiedTime 属性
更改 Beta vpnServer 复杂类型添加了 address 属性

2017 年 5 月

应用程序 API 更改

更改类型 版本 说明
更改 Beta 应用程序 API 更新。这是第一组更改,其中包括应用程序实体的属性重命名和重构。
新实体:apiinformationalUrlinstalledClientpermissionScopepreauthorizedApplicationWeb
删除的属性:addIns、appRoles、availableToOtherOrganizations、knownClientApplications、oauth2AllowUrlPathMatching、recordConsentConditions。
重命名的属性:
appId 重命名为 id,identifierUris 重命名为 applicationAliases,availableToOtherTenants 重命名为 orgRestrictions,mainLogo 重命名为 logo,oauth2Permissions 重命名为 publishedPermissionsScopes,publicClient 重命名为 allowPublicClient,replyUrls 重命名为 redirectUrls。
新属性:tags。

删除已弃用的 Planner API

更改类型 版本 说明
删除 Beta 删除了以下实体:
task
plan
bucket

taskDetails
planDetails
taskBoardTaskFormat

planTaskBoard

Project Rome

更改类型 版本 说明
添加项 Beta 添加了对 Project Rome 的支持,包括获取设备列表发送命令到设备查看命令状态
添加项 Beta 增加了对用户活动historyItems 的支持,其中包括 upsert 活动upsert historyItem

管理单元属性更改

更改类型 版本 说明
更改 Beta 已将 scopedRoleMembership 实体的 roleMemberInfo 属性类型更改为 identity
更改 Beta 已将 user 实体的导航属性 scopedAdministratorOf 更改为 scopedRoleMemberOf
更改 Beta 已将 administrativeUnit 实体的导航属性 scopedAdministrators 更改为 scopedRoleMembers
更改 Beta 已将 directoryRole 实体的导航属性 scopedAdministrators 更改为 scopedMembers

在预览中添加用户和组 Webhook 支持

更改类型 版本 说明
更改 Beta 添加了用户和组的 Webhooks 支持

向 v1.0 添加 delta 查询

更改类型 版本 说明
添加项 v1.0 向 V1.0 添加 delta 函数支持。添加到以下实体,以执行 delta 查询
contact
contactFolder
event
group
mailFolder
message
user
有关示例,请参阅以下文章:
获取组的增量更改
获取文件夹中邮件的增量更改
获取用户的增量更改
更改 Beta 将其他可选查询筛选功能(按 id)添加到 usersgroups

添加了对已删除项目的用户资源支持

更改类型 版本 说明
添加项 Beta 添加了对还原并永久删除用户的支持。

添加了 OnPremisesProvisioningError

更改类型 版本 说明
添加项 beta 新实体:OnPremisesProvisioningError
更改 beta usergrouporgcontact 添加了 OnPremisesProvisioningError 属性。

添加了 deletedDateTime 属性

更改类型 版本 说明
更改 beta user 实体添加了 deletedDateTime 属性。
更改 beta group 实体添加了 deletedDateTime 属性。
更改 beta application 实体添加了 deletedDateTime 属性。

向 v1.0 添加了域操作

更改类型 版本 说明
添加项 v1.0 domains 上添加了操作
新实体:
domain
domainDnsRecord
domainDnsCnameRecord
domainDnsMxRecord
domainDnsSrvRecord
domainDnsTxtRecord
domainDnsUnavailableRecord
新操作:
verify

向 v1.0 添加了合同

更改类型 版本 说明
添加项 v1.0 新实体:
contract

向 v1.0 添加了 licenseDetails

更改类型 版本 说明
添加项 v1.0 新实体:
licenseDetails
更改 v1.0 针对 users 的新 licensedetails 导航属性

驱动器 API

更改类型 版本 说明
添加项 v1.0 添加了 baseItem 资源类型,其中包含 driveItem 中的基本属性。
添加项 v1.0 和 Beta thumbnail 添加了 sourceItemId 属性。
sharepointIds 添加了 siteUrl 属性。
shared 添加了 sharedBysharedDateTime 属性。
remoteItem 添加了 shared 属性。
driveitemReference 添加了 sharepointIds 属性。
fileSystemInfo 添加了 lastAccessedDateTime
sharedDriveItem 添加了 driveItemsite 导航属性。
baseItem 添加了 parentReference 属性。
更改 v1.0 和 Beta 已将 driveItemsharedDriveItem 更改为从 baseItem 继承。
已将 identity 标记为“开放类型”。
更改 Beta sharingLink 添加了 configuratorUrlWebHtml 属性。
folder 资源类型添加了 folderView 资源类型和 view 属性。
driveItem 添加了 listItem 导航属性。
drive 添加了 list 导航属性。

扩展(开放扩展)

更改类型 版本 说明
添加项 v1.0 支持下列资源中的 openTypeExtensiondevicegrouporganizationuser
添加项 v1.0 和 beta 当用户使用个人 Microsoft 帐户登录时,在下列资源中支持开放扩展:event、post、group、message、contact 和 user。(除了这些资源,还有 device、group、organization 和 user,它们会在用户使用工作或学校帐户登录时支持开放扩展。)
添加项 v1.0 和 beta 支持 $expand 在下列资源中