Getting started with Microsoft Graph API in a Xamarin Forms Application

Introduction:

Microsoft offer a different service in the Cloud, Mail, Calendar, Contact, Chat and files from common Microsoft portal and also if you want to integrate to your application, you can access unified API wrapper in the Microsoft graph SDK. In this article you will get understand, how to implement login authentication and Send mail using Microsoft graph API in the Xamarin Forms application   

Prerequisites:

1. Download and install Visual 2017 Community Edition or higher.
2. Create Microsoft Account (If you already register Microsoft account, it’s not required)

Getting Start Create Application:

Step 1: You can navigate following URL https://developer.microsoft.com/en-us/graph/quick-start for register app and create sample app.

Step 2: Select the platform and Microsoft will create simple app that connects to Office 365 and calls the Microsoft Graph API.

Step 3: Register APP ID: You can register the application using click on “Get an app ID” and it will navigate to Microsoft application registration portal where you will be able to get an App ID and redirect URL. You will need either a School / Work /corporate / Azure AD or Microsoft account.

Step 4: Registration Success: after login with your Microsoft account and wait for few second appid and redirect url will generate automatically. if you want to modify or manage your app, you can click on application registration portal .

Step 5: Manage App in Registration Portal: You can manage or edit application from portal in the following App Name, redirect URL, generate new password, application logo, update the permission and click on Save button.

Step 6: Download Sample Code: you can download and unzip the source code > open the source code using Visual Studio. in the Sample application have multiple platform support as iOS, Android, UWP. The code sample will introduce you to authentication and send an email from your account.

Step 7: Microsoft Graph Client Library:

Microsoft Graph Client Library allows you to call Office 365, Azure AD and other Microsoft services through a single unified developer experience so right click on your solution and verify below NuGet package installed in the solution.

 

Step 8: Configure the project:   Open the App.cs file from XamarinConnect PCL project > replace your client ID and add the user permission scope.

1. public static string ClientID = "< Update your Client ID > ";
2. public static PublicClientApplication IdentityClientApp = new PublicClientApplication(ClientID);
3. public static string[] Scopes = { "User.Read", "Mail.Send", "Files.ReadWrite" };

Step 8: Configure Send mail: Open the MainHelper.cs from XamarinConnect PCL project > update ComposeAndSendMailAsync method as per your requirement

4. public async Task ComposeAndSendMailAsync(string subject,
5.                                                            string bodyContent,
6.                                                            string recipients)
7.        {
8. 
   
9.            // Get current user photo
10.            Stream photoStream = await GetCurrentUserPhotoStreamAsync();
11. 
    
12. 
    
13.            // If the user doesn't have a photo, or if the user account is MSA, we use a default photo
14. 
    
15.            if (photoStream == null)
16.            {
17.                var assembly = typeof(MailHelper).GetTypeInfo().Assembly;
18.                photoStream = assembly.GetManifestResourceStream("XamarinConnect.test.jpg");
19.            }
20. 
    
21.            MemoryStream photoStreamMS = new MemoryStream();
22.            // Copy stream to MemoryStream object so that it can be converted to byte array.
23.            photoStream.CopyTo(photoStreamMS);
24. 
    
25.            DriveItem photoFile = await UploadFileToOneDriveAsync(photoStreamMS.ToArray());
26. 
    
27.            MessageAttachmentsCollectionPage attachments = new MessageAttachmentsCollectionPage();
28.            attachments.Add(new FileAttachment
29.            {
30.                ODataType = "#microsoft.graph.fileAttachment",
31.                ContentBytes = photoStreamMS.ToArray(),
32.                ContentType = "image/png",
33.                Name = "me.png"
34.            });
35. 
    
36.            // Get the sharing link and insert it into the message body.
37.            Permission sharingLink = await GetSharingLinkAsync(photoFile.Id);
38.            string bodyContentWithSharingLink = String.Format(bodyContent, sharingLink.Link.WebUrl);
39. 
    
40. 
    
41.            // Prepare the recipient list
42.            string[] splitter = { ";" };
43.            var splitRecipientsString = recipients.Split(splitter, StringSplitOptions.RemoveEmptyEntries);
44.            List<Recipient> recipientList = new List<Recipient>();
45. 
    
46.            foreach (string recipient in splitRecipientsString)
47.            {
48.                recipientList.Add(new Recipient { EmailAddress = new EmailAddress { Address = recipient.Trim() } });
49.            }
50. 
    
51.            try
52.            {
53.                var graphClient = AuthenticationHelper.GetAuthenticatedClient();
54. 
    
55.                var email = new Message
56.                {
57.                    Body = new ItemBody
58.                    {
59.                        Content = bodyContentWithSharingLink,
60.                        ContentType = BodyType.Html,
61.                    },
62.                    Subject = subject,
63.                    ToRecipients = recipientList,
64.                    Attachments = attachments
65.                };
66. 
    
67.                try
68.                {
69.                    await graphClient.Me.SendMail(email, true).Request().PostAsync();
70.                }
71.                catch (ServiceException exception)
72.                {
73.                    throw new Exception("We could not send the message: " + exception.Error == null ? "No error message returned." : exception.Error.Message);
74.                }
75. 
    
76. 
    
77.            }
78. 
    
79.            catch (Exception e)
80.            {
81.                throw new Exception("We could not send the message: " + e.Message);
82.            }
83.        }

Step 9: Run the Application:

1. Select iOS,android and Windows project and run the application .
2. Click on Connect Button from iOS/Android /Windows

3. Sign in with your personal or work or school account and grant the requested permissions.

4. Click on Send mail button. When the mail is sent, a Success message is displayed.

This mail message includes the photo as an attachment and also provides a sharing link to the uploaded file in OneDrive. Check your mail from Inbox or Spam.

Download Source Code:

You can download the complete source code from MSDN sample. 

Summary:

In this article, you learned about how to implement login authentication and Send mail using Microsoft graph API in the Xamarin Forms application.

If you have any questions/ feedback/ issues, please write in the comment box.