{"id":1082,"date":"2015-11-07T00:00:00","date_gmt":"2015-11-07T08:00:00","guid":{"rendered":"http:\/\/officedevblogs.wpengine.com\/?p=1082"},"modified":"2021-11-15T11:38:08","modified_gmt":"2021-11-15T19:38:08","slug":"update-4-on-office-365-unified-api","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/update-4-on-office-365-unified-api\/","title":{"rendered":"Update 4 on Office 365 unified API"},"content":{"rendered":"
\n

Hi all, this is the fourth update for Office 365 unified API, we’re announcing another set of breaking changes.  These changes will roll in to the \/beta endpoint on 11\/9 noon PST.  Here is the list of major changes, along with a full list of ALL changes called out later in the post:<\/span><\/p>\n

 <\/span><\/p>\n

1.      <\/span>With this update all unified API responses will be returned using lowerCamelCasing for all namespaces, entity types, complex types, and property names.  Requests may be case insensitive.<\/p>\n

2.      <\/span>There are a large number of renames (and property removals) in this update, the chief ones being:<\/p>\n

a.      <\/span>A rename of objectId<\/b> to id <\/b>on the DirectoryObject<\/b> entity type.  This impacts a large number of existing entity types as it is a base type for many entity types.<\/p>\n

b.      <\/span>A rename of entity type tenantDetail<\/b> to organization<\/b>. <\/p>\n

c.      <\/span>A rename of entity type item <\/b>to driveItem<\/b><\/p>\n

3.      <\/span>The event entity type has a few updates, such as removing the reminder <\/b>property and replacing with ReminderMinutesBeforeStart <\/b>and IsReminderOn.  <\/b>Additionally the start<\/b> and end <\/b>properties now become complex types of DateTime and <\/b>Timezone, with Timezone being required when creating and updating events.  More details can also be found here<\/a>, and in the examples please , <\/span>replace “…\/api\/” in that blog post with “https:\/\/graph.microsoft.com\/<\/a>”.<\/p>\n

4.      <\/span>Group permission scopes – Group.Read.All and Group.ReadWrite.All will now require<\/b> administrators to consent to apps requesting these scopes.  Any apps that have already been consented using these permissions will continue to work. We plan to introduce additional Group permission scopes shortly, that will allow users to consent to apps that need to access Office 365 group content.<\/p>\n

5.      <\/span>Additionally <\/b>we’re providing a heads-up<\/b> that at some later time after<\/b> 11\/9,  querying to get the Office 365 groups a user is a member of will be changed. We will likely no longer support the \/joinedGroups navigation property.  We will update this post with more information on what the new search syntax will look like.<\/p>\n

 <\/span><\/p>\n

Remember Office 365 unified API is currently in preview, we are working hard to release it soon, as part of this we will continue making some changes, including breaking changes, in \/beta to incorporate feedback and improve the API as we get ready for v1.0.  Once v1.0 launches, we will continue to update \/beta on a regular basis, even with potentially breaking changes, but versioned end points will not have breaking changes once they’re released.<\/span><\/p>\n

 <\/span><\/p>\n

Please continue to provide your feedback and questions via stackoverflow and uservoice. Thank you for your input and happy coding.<\/span><\/p>\n

 <\/span><\/p>\n

~ Dan Kershaw and Yina Arenas for the Office 365 unified API team<\/span><\/p>\n

\n

Full change list details:<\/h3>\n

The following is a comprehensive list of all the breaking changes that will appear with this update, to the \/beta version. <\/p>\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Name<\/th>\nType<\/th>\nBreaking Changes<\/th>\n<\/tr>\n
DirectoryObject<\/td>\nEntity Type<\/td>\nNOTE:<\/b> A large number entities inherit from DirectoryObject, and will be impacted with the following changes: <\/p>\n
    \n
  • Renamed property:<\/b> \n
      \n
    • objectId -> id<\/li>\n<\/ul>\n<\/li>\n
    • Removed properties:<\/b> \n
        \n
      • objectType<\/li>\n
      • deletionTimeStamp<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/td>\n<\/tr>\n
OrgContact<\/td>\nEntity Type<\/td>\n\n
    \n
  • Renamed properties:<\/b> \n
      \n
    • dirSyncEnabled -> onPremisesSyncEnabled<\/li>\n
    • lastDirSyncDateTime -> onPremisesLastSyncDateTime<\/li>\n<\/ul>\n<\/li>\n
    • physicalDeliveryOfficeName -> officeLocation<\/li>\n
    • mobile -> mobilePhone<\/li>\n
    • Removed properties:<\/b> \n
        \n
      • facsimileTelephoneNumber<\/li>\n
      • provisioningErrors<\/li>\n
      • sipProxyAddress<\/li>\n
      • telephoneNumber \n
          \n
        • NOTE:<\/b> Added businessPhones (Edm.String collection) to replace telephoneNumber, allowing the developer to store multiple business phone numbers. Any pre-existing telephoneNumber and facsimileTelephoneNumber will be populated into businessPhones.<\/li>\n<\/ul>\n<\/li>\n
        • thumbNailPhoto<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/td>\n<\/tr>\n
Device<\/td>\nEntity Type<\/td>\n\n
    \n
  • Type changed for property:<\/b> \n
      \n
    • deviceId type changed from Edm.Guid -> Edm.String<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n
        \n
      • Renamed properties:<\/b> \n
          \n
        • approximateLastLogonTimestamp -> approximateLastSignInDateTime<\/li>\n
        • deviceObjectVersion -> deviceVersion<\/li>\n
        • deviceOSType -> operatingSystem<\/li>\n
        • deviceOSVersion -> operatingSystemVersion<\/li>\n
        • devicePhysicalIds -> physicalIds<\/li>\n
        • deviceTrustType -> trustType<\/li>\n
        • dirSyncEnabled -> onPremisesSyncEnabled<\/li>\n
        • lastDirSyncDateTime -> onPremisesLastSyncDateTime<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/td>\n<\/tr>\n
DirectoryRole<\/td>\nEntity Type<\/td>\n\n
    \n
  • Removed Property:<\/b><\/li>\n
      \n
    • isSystem<\/li>\n<\/ul>\n<\/ul>\n<\/td>\n<\/tr>\n
Event<\/td>\nEntity Type<\/td>\n\n
    \n
  • Type changed for property:<\/b> \n
      \n
    • start changed from Edm.DateTime -> complex type DateTimeTimeZone<\/li>\n
    • end changed from Edm.DateTime -> complex type DateTimeTimeZone<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n
        \n
      • Removed properties:<\/b> \n
          \n
        • Reminder \n
            \n
          • NOTE:<\/b> Replaced with reminderMinutesBeforeStart and IsReminderOn<\/li>\n<\/ul>\n<\/li>\n
              <\/ul>\n<\/ul>\n<\/li>\n<\/ul>\n<\/td>\n<\/tr>\n
Group<\/td>\nEntity Type<\/td>\n\n
    \n
  • Renamed properties:<\/b> \n
      \n
    • dirSyncEnabled -> onPremisesSyncEnabled<\/li>\n
    • companyLastDirSyncDateTime -> onPremisesLastSyncDateTime<\/li>\n<\/ul>\n<\/li>\n
    • Removed properties:<\/b> \n
        \n
      • provisioningErrors<\/li>\n
      • isPublic \n
          \n
        • NOTE:<\/b> Added visibility (Edm.String) to replace isPublic. This property is required to be set when groupTypes is set to [“Unified”]. Allowed values are “public” and “private”.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/td>\n<\/tr>\n
TenantDetails<\/td>\nEntity Type<\/td>\n\n
    \n
  • Entity type itself is renamed to organization<\/li>\n<\/ul>\n
      \n
    • Renamed properties:<\/b> \n
        \n
      • dirSyncEnabled -> onPremisesSyncEnabled<\/li>\n
      • lastDirSyncDateTime -> onPremisesLastSyncDateTime<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n
          \n
        • Removed properties:<\/b> \n
            \n
          • provisioningErrors<\/li>\n
          • telephoneNumber \n
              \n
            • NOTE:<\/b> Added businessPhones (Edm.String collection) to replace telephoneNumber, allowing the developer to store multiple business phone numbers. Any pre-existing telephoneNumber will be populated in businessPhones.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/td>\n<\/tr>\n
User<\/td>\nEntity Type<\/td>\n\n
    \n
  • Renamed properties:<\/b> \n
      \n
    • dirSyncEnabled -> onPremisesSyncEnabled<\/li>\n
    • immutableId ->onPremisesImmutableId<\/li>\n
    • lastDirSyncDateTime -> onPremisesLastSyncDateTime<\/li>\n
    • physicalDeliveryOfficeName -> officeLocation<\/li>\n
    • mobile -> mobilePhone<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n
        \n
      • Removed properties:<\/b> \n
          \n
        • facsimileTelephoneNumber<\/li>\n
        • provisioningErrors<\/li>\n
        • sipProxyAddress<\/li>\n
        • otherMails<\/li>\n
        • telephoneNumber \n
            \n
          • NOTE: Added businessPhones (Edm.String collection) to replace telephoneNumber, allowing the developer to store multiple business phone numbers. Any pre-existing telephoneNumber and facsimileTelephoneNumber will be populated into businessPhones.<\/b><\/li>\n<\/ul>\n<\/li>\n
          • thumbNailPhoto<\/li>\n
          • rootFolder navigation<\/b><\/li>\n
          • joinedGroups navigation<\/b> \n
              \n
            • NOTE:<\/b> in its place you’ll have to perform the following query instead: ..\/me\/memberOf?$filter=groupTypes eq ‘Unified’<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/td>\n<\/tr>\n
AssignedPlan<\/td>\nComplex Type<\/td>\n\n
    \n
  • Renamed Property:<\/b> \n
      \n
    • forceChangePasswordNextLogin -> forceChangePasswordNextSignIn<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/td>\n<\/tr>\n
PasswordProfile<\/td>\nComplex Type<\/td>\n\n
    \n
  • Renamed Property:<\/b> \n
      \n
    • assignedTimestamp -> assignedDateTime<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/td>\n<\/tr>\n
SubscribedSku<\/td>\nComplex Type<\/td>\n\n
    \n
  • Renamed Property:<\/b> \n
      \n
    • objectId -> id<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/td>\n<\/tr>\n
VerifiedDomain<\/td>\nComplex Type<\/td>\n\n
    \n
  • Renamed Property:<\/b> \n
      \n
    • default -> isDefault<\/li>\n
    • Initial -> isInitial<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/td>\n<\/tr>\n
Photo<\/td>\nComplex Type<\/td>\n\n
    \n
  • Renamed the complex type to<\/b> profilePhoto<\/li>\n<\/ul>\n<\/td>\n<\/tr>\n
Location<\/td>\nComplex Type<\/td>\n\n
    \n
  • Renamed the complex type<\/b> to geoCoordinates \n
      \n
    • NOTE:<\/b> This is used by the location property on the Item entity type<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/td>\n<\/tr>\n
GeoCoordinates<\/td>\nComplex Type<\/td>\n\n
    \n
  • Renamed the complex type<\/b> to outlookGeoCoordinates \n
      \n
    • NOTE:<\/b> This is used by the coordinates property on the Location complex type<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/td>\n<\/tr>\n
RecurrenceRange<\/td>\nComplex Type<\/td>\n\n
    \n
  • Property Type changed<\/b> \n
      \n
    • StartDate and EndDate types have been changed to Edm.Date<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/td>\n<\/tr>\n
delta<\/td>\nFunction<\/td>\n\n
    \n
  • Function removed<\/b><\/li>\n<\/ul>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table><\/div>\n<\/p><\/div>\n","protected":false},"excerpt":{"rendered":"

    Hi all, this is the fourth update for Office 365 unified API, we’re announcing another set of breaking changes.  These changes will roll in to the \/beta endpoint on 11\/9 noon PST.  Here is<\/p>\n","protected":false},"author":69076,"featured_media":25159,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[11],"tags":[],"class_list":["post-1082","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-office-add-ins"],"acf":[],"blog_post_summary":"

    Hi all, this is the fourth update for Office 365 unified API, we’re announcing another set of breaking changes.  These changes will roll in to the \/beta endpoint on 11\/9 noon PST.  Here is<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts\/1082","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/users\/69076"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/comments?post=1082"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts\/1082\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/media\/25159"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/media?parent=1082"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/categories?post=1082"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/tags?post=1082"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}