Social ratings APIs are being retired.
From Microsoft 365 Message Center Archive by Merill Fernando · Microsoft may not have sent this notice to your tenant.What the notice says
Microsoft’s text, safely structuredThis message is intended to notify all customers utilizing social ratings APIs that Microsoft will start retiring a number of these APIs starting January 2024. If your organization is not using the social ratings APIs, you can safely disregard this message.
For a comprehensive list of the APIs scheduled for retirement, please refer to the information provided below.
Microsoft has decided to retire the following APIs:
- CountRatingsOnUrl (string URL)
- GetRatingsOfUser (string userAccountName)
- GetRatingsOnUrl (string URL)
- GetRatingOnUrl (string URL)
- GetRatingOfUserOnUrl (string userAccountName, string URL)
- DeleteRating (string URL)
All of these APIs pertain to the social rating functionality ([MS-UPSDWS]: Glossary | Microsoft Learn).
The rationale behind this choice is that these APIs are superfluous and consistently yield empty results when called, leading to an inefficient utilization of customers' computing resources if they continue to make requests to them. Please be aware that in the event these APIs are invoked after they are retired, an exception with the message 'This API is deprecated; you should stop invoking the API and remove references.' will be returned.
When this will happen
January 1, 2024.
How this will affect your organization
Our telemetry data indicates that these APIs have almost no usage and should not have any impact on our customers. Nevertheless, we kindly request our customers to exercise due diligence and verify that they eliminate any reliance on the aforementioned APIs. As previously mentioned, these APIs do not provide any data and are therefore entirely superfluous.
What you can do to prepare
If your organization has taken any dependency on the above-mentioned APIs, we ask you to please remove this dependency. Below, we have provided alternative existing social ratings APIs that can serve as replacements if required:
- SetRating (string URL, int rating, string title, FeedbackData analysisDataEntry)
- PropagateRating (string URL)
- GetRatingAverageOnUrl (string URL)
What changed
Between archive captures, newest first… (string URL) All of these APIs pertain to the social rating functionality
(MS-UPSDWS:([MS-UPSDWS]: Glossary | Microsoft Learn). The rationale behind this choice is that these … you should stop invoking the API and remove references.' will be returned.When[When this willhappen:happen:] January 1, 2024.How[How this will affect yourorganization:organization:] Our telemetry data indicates that these APIs have almost no usage and … these APIs do not provide any data and are therefore entirely superfluous.What[What you can do toprepare:prepare:] If your organization has taken any dependency on the above-mentioned APIs, we …- · first version seen
Learn more
Links from the notice and their documentation checks- [MS-UPSDWS]: Glossary | Microsoft LearnNot read yet
Related public changes
No related announcements were found in the saved public history. Check the source for newer announcements.
Not confirmed here
What this page cannot tell you- Whether your tenant is affected: this is Microsoft's notice, not a check of your settings.
- 1 linked page has not been read yet.