{"id":13409,"date":"2023-04-03T09:51:15","date_gmt":"2023-04-03T16:51:15","guid":{"rendered":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/?p=13409"},"modified":"2023-06-27T08:43:05","modified_gmt":"2023-06-27T15:43:05","slug":"skype-for-business-usage-reports-deprecation-in-microsoft-graph-production-and-beta-endpoints","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/skype-for-business-usage-reports-deprecation-in-microsoft-graph-production-and-beta-endpoints\/","title":{"rendered":"Skype for Business usage reports deprecation in Microsoft Graph production and beta endpoints\u00a0"},"content":{"rendered":"

Updated June 27, 2023:<\/strong> We\u2019ve heard your feedback and will be adjusting the retirement plan for these APIs to be in accordance with the Microsoft Lifecyle Policy<\/a>. All the customers will start to notice that the Skype for Business usage report APIs will stop containing usage measures in the API response starting from July 31, 2023. While customers can expect the APIs to continue to accept requests from clients, the response may not contain usage measures for Skype for Business. The service will be fully retired on July 31, 2025<\/strong>.<\/span><\/p>\n

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~<\/p>\n

Microsoft Graph is the modern API for the Microsoft 365 platform.\u00a0 We make continuous, significant investments in its security, performance, and features to ensure it meets the needs of our own product teams as well as the global ecosystem of developers who build applications using its capabilities. <\/span>\u00a0<\/span><\/p>\n

While we\u2019re investing in Microsoft Graph, we\u2019re also examining our legacy surface areas. Some of our existing legacy services become obsolete based on the new functionality, and they no longer provide the best way to access Microsoft 365 data. <\/span><\/p>\n

In July 2019, we <\/span>announced<\/span><\/a> the retirement of Skype for Business Online. <\/span>Today we are announcing the <\/span>deprecation of all <\/span><\/b>Skype for Business usage and active users reports in Microsoft Graph v1.0 and beta endpoints, in worldwide\/GCC cloud deployments. <\/span><\/b>They will be decommissioned starting on April 30, 2023. Once the deprecation is complete, the service will be retired, and developers may no longer access it from worldwide\/GCC clouds.<\/span>\u00a0<\/span><\/p>\n

A detailed list of the Skype for Business usage reports in the Microsoft Graph is below. <\/span>Similar capabilities can be found in the Microsoft Teams <\/span>device usage<\/span><\/a> and <\/span>user activity<\/span><\/a> reports.<\/span>\u00a0<\/span><\/p>\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Microsoft 365 usage reports in Microsoft Graph<\/span><\/b>\u00a0<\/span><\/td>\nFunction<\/span><\/b>\n(v1.0 link)<\/span>\u00a0<\/span><\/td>\n<\/tr>\n
\n

reportRoot:getSkypeForBusinessActivityUserDetail<\/p>\n<\/td>\n

Get user detail<\/span><\/a>\u00a0<\/span>\u00a0<\/span><\/td>\n<\/tr>\n
\n

reportRoot: getSkypeForBusinessActivityCounts<\/p>\n<\/td>\n

Get activity counts<\/span><\/a>\u00a0<\/span><\/td>\n<\/tr>\n
\n

reportRoot: getSkypeForBusinessActivityUserCounts<\/p>\n<\/td>\n

Get user counts<\/span><\/a>\u00a0<\/span><\/td>\n<\/tr>\n
\n

reportRoot: getSkypeForBusinessDeviceUsageUserDetail<\/p>\n<\/td>\n

Get user detail<\/span><\/a>\u00a0<\/span><\/td>\n<\/tr>\n
\n

reportRoot: getSkypeForBusinessDeviceUsageDistributionUserCounts<\/p>\n<\/td>\n

Get distribution user counts<\/span><\/a>\u00a0<\/span><\/td>\n<\/tr>\n
\n

reportRoot: getSkypeForBusinessDeviceUsageUserCounts<\/p>\n<\/td>\n

Get user counts<\/span><\/a>\u00a0<\/span><\/td>\n<\/tr>\n
\n

reportRoot: getSkypeForBusinessOrganizerActivityCounts<\/p>\n<\/td>\n

Get activity counts<\/span><\/a>\u00a0<\/span><\/td>\n<\/tr>\n
\n

reportRoot: getSkypeForBusinessOrganizerActivityUserCounts<\/p>\n<\/td>\n

Get user counts<\/span><\/a>\u00a0<\/span><\/td>\n<\/tr>\n
\n

reportRoot: getSkypeForBusinessOrganizerActivityMinuteCounts<\/p>\n<\/td>\n

Get minute counts<\/span><\/a>\u00a0<\/span><\/td>\n<\/tr>\n
\n

reportRoot: getSkypeForBusinessParticipantActivityCounts<\/p>\n<\/td>\n

Get activity counts<\/span><\/a>\u00a0<\/span><\/td>\n<\/tr>\n
\n

reportRoot: getSkypeForBusinessParticipantActivityUserCounts<\/p>\n<\/td>\n

Get user counts<\/span><\/a>\u00a0<\/span><\/td>\n<\/tr>\n
\n

reportRoot: getSkypeForBusinessParticipantActivityMinuteCounts<\/p>\n<\/td>\n

Get minute counts<\/span><\/a>\u00a0<\/span><\/td>\n<\/tr>\n
\n

reportRoot: getSkypeForBusinessPeerToPeerActivityCounts<\/p>\n<\/td>\n

Get activity counts<\/span><\/a>\u00a0<\/span><\/td>\n<\/tr>\n
\n

reportRoot: getSkypeForBusinessPeerToPeerActivityUserCounts<\/p>\n<\/td>\n

Get user counts<\/span><\/a>\u00a0<\/span><\/td>\n<\/tr>\n
\n

reportRoot: getSkypeForBusinessPeerToPeerActivityMinuteCounts<\/p>\n<\/td>\n

Get minute counts<\/span><\/a>\u00a0<\/span><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

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

Skype for Business related attributes will be set as 0 or placeholder value from the Microsoft 365 active users reports responses below. Add those attributes will be removed once Skype for Business is deprecated from all clouds.<\/span>\u00a0<\/span><\/p>\n\n\n\n\n\n\n
Microsoft 365 active users reports in Microsoft Graph<\/span><\/b>\u00a0<\/span><\/td>\nRemoved attributes in API response<\/span><\/b>\u00a0<\/span><\/td>\n <\/p>\n

Function<\/span><\/b> (v1.0 link)<\/span>\u00a0<\/span><\/p>\n

\u00a0<\/span><\/td>\n<\/tr>\n

\n

reportRoot:\ngetOffice365ActiveUserDetail<\/span><\/b>\u00a0<\/span><\/p>\n<\/td>\n

\n
    \n
  • Has Skype for Business License<\/span>\u00a0<\/span><\/li>\n
  • Skype For Business Last Activity Date<\/span>\u00a0<\/span><\/li>\n
  • Skype for Business License Assign Date<\/span>\u00a0<\/span><\/li>\n<\/ul>\n

    \u00a0<\/span><\/td>\n

Get user detail<\/span><\/a>\u00a0<\/span><\/td>\n<\/tr>\n
\n

reportRoot:\ngetOffice365ActiveUserCounts<\/span><\/b>\u00a0<\/span><\/p>\n<\/td>\n

\n
    \n
  • Skype for Business<\/span>\u00a0<\/span><\/li>\n<\/ul>\n

    \u00a0<\/span><\/td>\n

Get user counts<\/span><\/a>\u00a0<\/span><\/td>\n<\/tr>\n
\n

reportRoot: getOffice365ServicesUserCounts<\/span><\/b>\u00a0<\/span><\/p>\n<\/td>\n

\n
    \n
  • Skype for Business Active<\/span>\u00a0<\/span><\/li>\n
  • Skype for Business Inactive<\/span>\u00a0<\/span><\/li>\n<\/ul>\n

    \u00a0<\/span><\/td>\n

Get services user counts<\/span><\/a>\u00a0<\/span><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

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

What do I need to do?<\/h2>\n

Please review the below information on how to get started with <\/span>Microsoft Teams<\/span><\/a>. For additional assistance please reach out to your Microsoft account team.<\/span>\u00a0<\/span><\/p>\n