Microsoft.Graph
5.56.1
Prefix Reserved
dotnet add package Microsoft.Graph --version 5.56.1
NuGet\Install-Package Microsoft.Graph -Version 5.56.1
<PackageReference Include="Microsoft.Graph" Version="5.56.1" />
paket add Microsoft.Graph --version 5.56.1
#r "nuget: Microsoft.Graph, 5.56.1"
// Install Microsoft.Graph as a Cake Addin #addin nuget:?package=Microsoft.Graph&version=5.56.1 // Install Microsoft.Graph as a Cake Tool #tool nuget:?package=Microsoft.Graph&version=5.56.1
Microsoft Graph .NET Client Library
Integrate the Microsoft Graph API into your .NET project!
The Microsoft Graph .NET Client Library targets .NetStandard 2.0.
Installation via NuGet
To install the client library via NuGet:
- Search for
Microsoft.Graph
in the NuGet Library, or - Type
Install-Package Microsoft.Graph
into the Package Manager Console.
Getting started
1. Register your application
Register your application to use Microsoft Graph API using the Microsoft Application Registration Portal.
2. Authenticate for the Microsoft Graph service
The Microsoft Graph .NET Client Library supports the use of TokenCredential classes in the Azure.Identity library.
You can read more about available Credential classes here and examples on how to quickly setup TokenCredential instances can be found here.
The recommended library for authenticating against Microsoft Identity (Azure AD) is MSAL.
For an example of authenticating a UWP app using the V2 Authentication Endpoint, see the Microsoft Graph UWP Connect Library.
3. Create a Microsoft Graph client object with an authentication provider
An instance of the GraphServiceClient class handles building requests,
sending them to Microsoft Graph API, and processing the responses. To create a
new instance of this class, you need to provide an instance of
IAuthenticationProvider
which can authenticate requests to Microsoft Graph.
For more information on initializing a client instance, see the library overview
4. Make requests to the graph
Once you have completed authentication and have a GraphServiceClient, you can begin to make calls to the service. The requests in the SDK follow the format of the Microsoft Graph API's RESTful syntax.
For example, to retrieve a user's default drive:
var drive = await graphClient.Me.Drive.GetAsync();
GetAsync
will return a Drive
object on success and throw a
ApiException
on error.
To get the current user's root folder of their default drive:
// Get the user's driveId
var drive = await graphClient.Me.Drive.GetAsync();
var userDriveId = drive.Id;
// use the driveId to get the root drive
var rootItem = await graphClient.Drives[userDriveId].Root.GetAsync();
GetAsync
will return a DriveItem
object on success and throw a
ApiException
on error.
For a general overview of how the SDK is designed, see overview.
The following sample applications are also available:
- Microsoft Graph UWP Connect Sample
- Microsoft Graph UWP Snippets Sample
- Microsoft Graph MeetingBot sample for UWP
- Microsoft Graph Connect Sample for ASP.NET 4.6
- Microsoft Graph Snippets Sample for ASP.NET 4.6
- Microsoft Graph SDK Snippets Library for Xamarin.Forms
- Microsoft Graph Connect Sample for Xamarin Forms
- Microsoft Graph Meeting Manager Sample for Xamarin.Forms
- Microsoft Graph Property Manager Sample for Xamarin Native
Documentation and resources
- Overview
- Collections
- Errors
- Headers
- Microsoft Graph API
- Release notes
- Blog - Microsoft Graph .NET SDK updates 3/16/20
Notes
Upgrading from v1
Between 1.x and 3.x there were some minor possibly breaking changes:
- .NET Standard minimum version bumped from
netStandard1.3
tonetstandard2.0
- .NET Framework minimum version bumped from
net45
tonet461
- a change in enum order for
GiphyRatingType
ParticipantInfo
becameInvitationParticipantInfo
CallRecordRequestBody
becameCallRecordResponseRequestBody
Upgrading to v4
Between 3.x and 4.x there were some major breaking changes:
- .NET Standard minimum version bumped from
netStandard1.3
tonetstandard2.0
- .NET Framework minimum version bumped from
net45
tonet462
- Replacing Newtosoft.Json with System.Text.Json
- Upgrading Microsoft.Graph.Core dependency to version 2.0.0
View the upgrade guide here.
Upgrading to v5
Between 4.x and 5.x there were several major breaking changes as the SDK now uses Kiota for code generation.
View the upgrade guide here.
Issues
To view or log issues, see issues.
This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.
Other resources
- NuGet Package: https://www.nuget.org/packages/Microsoft.Graph
Building library locally
If you are looking to build the library locally for the purposes of contributing code or running tests, you will need to:
- Have the .NET Core SDK (> 1.0) installed
- Run
dotnet restore
from the command line in your package directory - Run
nuget restore
andmsbuild
from CLI or run Build from Visual Studio to restore Nuget packages and build the project
Due to long file names you may need to run
git config --system core.longpaths true
before cloning the repo to your system.
Additionally for Windows OS, set the value of the parameter
HKLM\SYSTEM\CurrentControlSet\Control\FileSystem
LongPathsEnabled
to1
, before opening the solution in VS
License
Copyright (c) Microsoft Corporation. All Rights Reserved. Licensed under the MIT license. See Third Party Notices for information on the packages referenced via NuGet.
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net5.0 is compatible. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
.NET Core | netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
.NET Standard | netstandard2.0 is compatible. netstandard2.1 is compatible. |
.NET Framework | net461 was computed. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed. |
MonoAndroid | monoandroid was computed. |
MonoMac | monomac was computed. |
MonoTouch | monotouch was computed. |
Tizen | tizen40 was computed. tizen60 was computed. |
Xamarin.iOS | xamarinios was computed. |
Xamarin.Mac | xamarinmac was computed. |
Xamarin.TVOS | xamarintvos was computed. |
Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETStandard 2.0
- Microsoft.Graph.Core (>= 3.1.19)
-
.NETStandard 2.1
- Microsoft.Graph.Core (>= 3.1.19)
-
net5.0
- Microsoft.Graph.Core (>= 3.1.19)
NuGet packages (201)
Showing the top 5 NuGet packages that depend on Microsoft.Graph:
Package | Downloads |
---|---|
Microsoft.Identity.Web.MicrosoftGraph
This package enables ASP.NET Core web apps and web APIs to use the Microsoft identity platform (formerly Azure AD v2.0). This package is specifically used for web applications, which sign-in users and call Microsoft Graph, and for protected web APIs that call Microsoft Graph. |
|
GSF.Security
Library of core security framework for implementing role-based security with integrated Active Directory, local account and database style authentication across various .NET application types. |
|
PnP.Framework
PnP Framework contains the PnP Provisioning engine and a ton of extension methods that will make you more productive while developing for Microsoft 365. |
|
SharePointPnPCoreOnline
Retired - please use PnP Framework (https://github.com/pnp/pnpframework) going forward. Core CSOM extension methods for SharePoint Online add-in model development. This will increase productivity of the developers by abstracting complex operations. |
|
Rystem.Content.Infrastructure.M365.Sharepoint
Rystem.Content helps you to integrate with azure services or to create an abstraction layer among your infrastructure and your business. |
GitHub repositories (55)
Showing the top 5 popular GitHub repositories that depend on Microsoft.Graph:
Repository | Stars |
---|---|
microsoft/semantic-kernel
Integrate cutting-edge LLM technology quickly and easily into your apps
|
|
unoplatform/uno
Build Mobile, Desktop and WebAssembly apps with C# and XAML. Today. Open source and professionally supported.
|
|
Azure/azure-sdk-for-net
This repository is for active development of the Azure SDK for .NET. For consumers of the SDK we recommend visiting our public developer docs at https://learn.microsoft.com/dotnet/azure/ or our versioned developer docs at https://azure.github.io/azure-sdk-for-net.
|
|
lukencode/FluentEmail
All in one email sender for .NET. Supports popular senders (SendGrid, MailGun, etc) and Razor templates.
|
|
microsoft/onefuzz
A self-hosted Fuzzing-As-A-Service platform
|
Version | Downloads | Last updated |
---|---|---|
5.56.1 | 34,859 | 8/28/2024 |
5.56.0 | 2,296,782 | 6/6/2024 |
5.55.0 | 173,465 | 5/31/2024 |
5.54.0 | 162,400 | 5/24/2024 |
5.53.0 | 275,642 | 5/16/2024 |
5.52.0 | 269,065 | 5/8/2024 |
5.51.0 | 128,802 | 5/2/2024 |
5.50.0 | 195,921 | 4/25/2024 |
5.49.0 | 374,239 | 4/17/2024 |
5.48.0 | 276,645 | 4/9/2024 |
5.47.0 | 105,874 | 4/5/2024 |
5.46.0 | 261,825 | 3/27/2024 |
5.45.0 | 160,393 | 3/22/2024 |
5.44.0 | 787,192 | 2/28/2024 |
5.43.0 | 313,767 | 2/21/2024 |
5.42.0 | 245,081 | 2/14/2024 |
5.41.0 | 996,823 | 2/1/2024 |
5.40.0 | 555,627 | 1/24/2024 |
5.39.0 | 288,678 | 1/17/2024 |
5.38.0 | 493,687 | 1/4/2024 |
5.37.0 | 383,710 | 12/14/2023 |
5.36.0 | 735,359 | 11/22/2023 |
5.35.0 | 272,857 | 11/16/2023 |
5.34.0 | 251,189 | 11/8/2023 |
5.33.0 | 169,070 | 11/3/2023 |
5.32.0 | 240,449 | 10/26/2023 |
5.31.0 | 254,327 | 10/19/2023 |
5.30.0 | 147,117 | 10/12/2023 |
5.29.0 | 124,991 | 10/6/2023 |
5.28.0 | 381,180 | 9/21/2023 |
5.27.0 | 163,869 | 9/14/2023 |
5.26.0 | 169,884 | 9/6/2023 |
5.25.0 | 169,287 | 8/31/2023 |
5.24.0 | 289,417 | 8/24/2023 |
5.23.0 | 129,428 | 8/18/2023 |
5.22.0 | 267,085 | 8/10/2023 |
5.21.0 | 209,057 | 8/2/2023 |
5.20.0 | 114,350 | 7/27/2023 |
5.19.0 | 184,168 | 7/19/2023 |
5.18.0 | 196,882 | 7/12/2023 |
5.17.0 | 218,771 | 7/5/2023 |
5.16.0 | 162,927 | 6/29/2023 |
5.15.0 | 265,164 | 6/21/2023 |
5.14.0 | 177,149 | 6/15/2023 |
5.13.0 | 227,609 | 6/9/2023 |
5.12.0 | 546,454 | 5/25/2023 |
5.11.0 | 242,705 | 5/17/2023 |
5.10.0 | 203,080 | 5/11/2023 |
5.9.0 | 149,019 | 5/4/2023 |
5.8.0 | 130,627 | 4/28/2023 |
5.7.0 | 182,069 | 4/20/2023 |
5.6.0 | 241,722 | 4/13/2023 |
5.5.0 | 377,701 | 4/6/2023 |
5.4.0 | 178,110 | 3/29/2023 |
5.3.0 | 211,140 | 3/22/2023 |
5.2.0 | 191,540 | 3/15/2023 |
5.1.0 | 143,588 | 3/8/2023 |
5.0.0 | 212,503 | 2/28/2023 |
5.0.0-rc.5 | 9,056 | 2/9/2023 |
5.0.0-rc.4 | 3,433 | 1/27/2023 |
5.0.0-rc.3 | 2,577 | 1/18/2023 |
5.0.0-rc.2 | 1,278 | 1/11/2023 |
5.0.0-rc.1 | 5,335 | 12/16/2022 |
5.0.0-preview.14 | 64,464 | 11/23/2022 |
5.0.0-preview.13 | 35,296 | 10/19/2022 |
5.0.0-preview.12 | 3,196 | 9/28/2022 |
5.0.0-preview.11 | 1,595 | 9/14/2022 |
5.0.0-preview.10 | 66,831 | 7/20/2022 |
5.0.0-preview.9 | 2,272 | 7/13/2022 |
5.0.0-preview.8 | 20,170 | 6/21/2022 |
5.0.0-preview.7 | 975 | 6/9/2022 |
5.0.0-preview.6 | 628 | 6/2/2022 |
5.0.0-preview.5 | 4,727 | 5/20/2022 |
5.0.0-preview.4 | 4,549 | 5/6/2022 |
5.0.0-preview.3 | 3,304 | 4/20/2022 |
5.0.0-preview.2 | 956 | 4/5/2022 |
5.0.0-preview.1 | 1,370 | 3/24/2022 |
4.54.0 | 3,548,935 | 2/16/2023 |
4.53.0 | 888,259 | 2/8/2023 |
4.52.0 | 1,021,912 | 1/25/2023 |
4.51.0 | 912,176 | 1/17/2023 |
4.50.0 | 565,884 | 1/5/2023 |
4.49.0 | 869,012 | 12/15/2022 |
4.48.0 | 1,188,699 | 11/23/2022 |
4.47.0 | 1,086,798 | 11/9/2022 |
4.46.0 | 618,992 | 11/2/2022 |
4.45.0 | 959,295 | 10/19/2022 |
4.44.0 | 362,327 | 10/12/2022 |
4.43.0 | 295,367 | 10/5/2022 |
4.42.0 | 514,512 | 9/28/2022 |
4.41.0 | 432,534 | 9/22/2022 |
4.40.0 | 411,683 | 9/14/2022 |
4.39.0 | 1,561,051 | 9/6/2022 |
4.38.0 | 357,219 | 8/31/2022 |
4.37.0 | 401,233 | 8/25/2022 |
4.36.0 | 1,471,215 | 8/12/2022 |
4.35.0 | 861,521 | 7/21/2022 |
4.34.0 | 3,636,610 | 7/6/2022 |
4.33.0 | 620,583 | 6/29/2022 |
4.32.0 | 400,807 | 6/21/2022 |
4.31.0 | 217,748 | 6/16/2022 |
4.30.0 | 395,866 | 6/8/2022 |
4.29.0 | 1,124,337 | 5/18/2022 |
4.28.0 | 449,937 | 5/11/2022 |
4.27.0 | 299,065 | 5/4/2022 |
4.26.0 | 130,276 | 4/29/2022 |
4.25.0 | 973,507 | 4/13/2022 |
4.24.0 | 328,654 | 4/5/2022 |
4.23.0 | 145,673 | 3/30/2022 |
4.22.0 | 397,392 | 3/22/2022 |
4.21.0 | 330,889 | 3/16/2022 |
4.20.0 | 224,380 | 3/9/2022 |
4.19.0 | 584,374 | 2/24/2022 |
4.18.0 | 600,318 | 2/10/2022 |
4.17.0 | 982,128 | 1/27/2022 |
4.16.0 | 297,643 | 1/19/2022 |
4.15.0 | 382,804 | 1/13/2022 |
4.14.0 | 878,123 | 1/5/2022 |
4.13.0 | 553,526 | 12/22/2021 |
4.12.0 | 261,474 | 12/15/2021 |
4.11.0 | 2,297,546 | 11/25/2021 |
4.10.0 | 640,561 | 11/11/2021 |
4.9.0 | 607,444 | 11/3/2021 |
4.8.0 | 160,695 | 10/28/2021 |
4.7.0 | 622,866 | 10/14/2021 |
4.6.0 | 1,233,269 | 9/23/2021 |
4.5.0 | 640,529 | 9/9/2021 |
4.4.0 | 273,714 | 9/2/2021 |
4.3.0 | 333,149 | 8/19/2021 |
4.2.0 | 617,317 | 8/12/2021 |
4.1.0 | 166,763 | 8/5/2021 |
4.0.0 | 519,809 | 7/23/2021 |
4.0.0-preview.7 | 15,753 | 6/18/2021 |
4.0.0-preview.6 | 14,594 | 6/7/2021 |
4.0.0-preview.5 | 7,910 | 5/21/2021 |
4.0.0-preview.4 | 14,950 | 5/7/2021 |
4.0.0-preview.3 | 9,946 | 4/22/2021 |
4.0.0-preview.2 | 11,043 | 4/1/2021 |
4.0.0-preview.1 | 22,971 | 3/17/2021 |
3.35.0 | 4,348,164 | 6/15/2021 |
3.34.0 | 340,750 | 6/10/2021 |
3.33.0 | 2,421,647 | 5/20/2021 |
3.32.0 | 409,042 | 5/12/2021 |
3.31.0 | 222,913 | 5/7/2021 |
3.30.0 | 758,201 | 4/20/2021 |
3.29.0 | 579,263 | 4/2/2021 |
3.28.0 | 276,607 | 3/25/2021 |
3.27.0 | 908,820 | 3/10/2021 |
3.26.0 | 323,361 | 3/4/2021 |
3.25.0 | 444,011 | 2/18/2021 |
3.24.0 | 455,318 | 2/10/2021 |
3.23.0 | 518,509 | 1/29/2021 |
3.22.0 | 512,215 | 1/20/2021 |
3.21.0 | 1,221,363 | 12/8/2020 |
3.20.0 | 1,113,895 | 11/19/2020 |
3.19.0 | 1,215,063 | 10/27/2020 |
3.18.0 | 547,128 | 10/14/2020 |
3.17.0 | 215,210 | 10/10/2020 |
3.16.0 | 237,833 | 10/7/2020 |
3.15.0 | 571,491 | 9/24/2020 |
3.14.0 | 220,633 | 9/15/2020 |
3.13.0 | 135,775 | 9/10/2020 |
3.12.0 | 864,207 | 8/26/2020 |
3.11.0 | 15,830 | 8/25/2020 |
3.10.0 | 150,132 | 8/18/2020 |
3.9.0 | 844,432 | 7/28/2020 |
3.8.0 | 1,143,102 | 6/16/2020 |
3.7.0 | 194,013 | 6/9/2020 |
3.6.0 | 655,253 | 5/21/2020 |
3.5.0 | 329,272 | 5/12/2020 |
3.4.0 | 216,238 | 5/1/2020 |
3.3.0 | 383,479 | 4/14/2020 |
3.2.0 | 123,467 | 4/7/2020 |
3.1.0 | 215,001 | 4/1/2020 |
3.0.1 | 358,451 | 3/18/2020 |
1.21.0 | 7,596,171 | 12/11/2019 |
1.20.0 | 698,616 | 11/6/2019 |
1.19.0 | 153,859 | 10/29/2019 |
1.18.0 | 295,280 | 10/15/2019 |
1.17.0 | 823,689 | 8/15/2019 |
1.16.0 | 684,923 | 7/2/2019 |
1.15.0 | 1,226,424 | 5/1/2019 |
1.14.0 | 1,420,088 | 3/25/2019 |
1.14.0-preview | 21,824 | 2/25/2019 |
1.13.0-preview | 27,077 | 12/18/2018 |
1.12.0 | 1,364,206 | 10/31/2018 |
1.11.0 | 302,865 | 9/19/2018 |
1.10.0 | 407,107 | 7/6/2018 |
1.9.0 | 1,633,486 | 5/3/2018 |
1.8.1 | 216,918 | 3/26/2018 |
1.7.0 | 192,312 | 12/14/2017 |
1.6.2 | 156,480 | 10/6/2017 |
1.6.1 | 2,937 | 10/5/2017 |
1.6.0 | 11,650 | 9/26/2017 |
1.5.1 | 74,510 | 8/24/2017 |
1.5.0 | 49,449 | 8/8/2017 |
1.4.0 | 248,112 | 6/12/2017 |
1.3.0 | 188,005 | 5/10/2017 |
1.2.1 | 103,527 | 2/13/2017 |
1.2.0 | 120,539 | 11/8/2016 |
1.1.1 | 115,162 | 9/27/2016 |
1.0.1 | 230,343 | 4/21/2016 |
1.0.0 | 12,005 | 3/30/2016 |
0.2.8-rc | 11,123 | 6/24/2015 |