{"id":9136,"date":"2021-12-13T10:34:26","date_gmt":"2021-12-13T18:34:26","guid":{"rendered":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/?p=9136"},"modified":"2022-10-13T21:09:31","modified_gmt":"2022-10-14T04:09:31","slug":"announcing-delta-query-support-for-the-microsoft-graph-assignments-api","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/announcing-delta-query-support-for-the-microsoft-graph-assignments-api\/","title":{"rendered":"Announcing delta query support for the Microsoft Graph Assignments API"},"content":{"rendered":"<p>We&#8217;ve listened to our customers and received many requests for the ability to track changes to education resources. We are pleased to announce that the Assignments API in Microsoft Graph now supports delta queries for certain education resource types such as <a href=\"https:\/\/docs.microsoft.com\/en-us\/graph\/api\/resources\/educationassignment?view=graph-rest-beta\"><strong>educationAssignment<\/strong><\/a> and <a href=\"https:\/\/docs.microsoft.com\/en-us\/graph\/api\/resources\/educationcategory?view=graph-rest-beta\"><strong>educationCategory<\/strong><\/a>. This update has been rolled out to the beta endpoint.<\/p>\n<h3>What are delta queries?<\/h3>\n<p>Delta queries give applications the ability to query newly created or updated entities without having to perform a full read of the entire collection \u2013 essentially a GET changes API.<\/p>\n<p>For education resources, that means an API caller can issue a delta query to get newly created or updated assignments, including submission resource changes, without the need to issue multiple GET assignments API calls.<\/p>\n<p>This allows an application to proactively monitor changes and efficiently track and get state changes. Consider an application that needs to cache or store data locally, and keep that data up to date, or track changes to data for any other reasons. The benefits of using these new GET calls include:<\/p>\n<ul>\n<li>Minimizes duplication \u2013 no need to retrieve data an application already has<\/li>\n<li>Minimizes network traffic \u2013 smaller payloads and fewer roundtrip requests<\/li>\n<li>Reduce throttling likelihood &#8211; reduces the likelihood of reaching a throttling threshold<\/li>\n<li>Better application performance \u2013 reduction in call latencies and fewer roundtrip requests<\/li>\n<\/ul>\n<h3>Additional resources<\/h3>\n<p>For more information and examples, see the following topics:<\/p>\n<ul>\n<li><a href=\"https:\/\/docs.microsoft.com\/en-us\/graph\/delta-query-overview\">Delta query overview<\/a><\/li>\n<li><a href=\"https:\/\/docs.microsoft.com\/en-us\/learn\/modules\/msgraph-changenotifications-trackchanges\/\">Tutorial: Use Change Notifications and Track Changes with Microsoft Graph<\/a><\/li>\n<li><a href=\"https:\/\/docs.microsoft.com\/en-us\/graph\/api\/educationassignment-delta?view=graph-rest-beta&amp;tabs=http\">Delta query API: educationAssignment<\/a><\/li>\n<li><a href=\"https:\/\/docs.microsoft.com\/en-us\/graph\/api\/educationcategory-delta?view=graph-rest-beta&amp;tabs=http\">Delta query API: educationCategory<\/a><\/li>\n<\/ul>\n<p>Happy coding!<\/p>\n<p>&nbsp;<\/p>\n","protected":false},"excerpt":{"rendered":"<p>We are pleased to announce that the Assignments API in Microsoft Graph now supports delta queries for certain education resource types such as educationAssignment and educationCategory.<\/p>\n","protected":false},"author":69077,"featured_media":9149,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[3],"tags":[211],"class_list":["post-9136","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-microsoft-graph","tag-education"],"acf":[],"blog_post_summary":"<p>We are pleased to announce that the Assignments API in Microsoft Graph now supports delta queries for certain education resource types such as educationAssignment and educationCategory.<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts\/9136","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\/69077"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/comments?post=9136"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts\/9136\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/media\/9149"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/media?parent=9136"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/categories?post=9136"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/tags?post=9136"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}