Objective-C

Outlook --Download Attachments for a Specific Message

See more Outlook Examples

Demonstrates how to download the attachments for a particular email message.

Note: This example requires Chilkat v9.5.0.67 or greater.

This example applies to: Exchange Online | Office 365 | Hotmail.com | Live.com | MSN.com | Outlook.com | Passport.com

Objective-C

#import <CkoHttp.h>
#import <CkoStringBuilder.h>
#import <NSString.h>
#import <CkoJsonObject.h>
#import <CkoBinData.h>
#import <CkoDateTime.h>
#import <CkoFileAccess.h>

BOOL success = NO;

// This example requires the Chilkat API to have been previously unlocked.
// See Global Unlock Sample for sample code.

CkoHttp *http = [[CkoHttp alloc] init];

// Use your previously obtained access token here:
// See the following examples for getting an access token:
//    Get Microsoft Graph OAuth2 Access Token (Azure AD v2.0 Endpoint).
//    Get Microsoft Graph OAuth2 Access Token (Azure AD Endpoint).
//    Refresh Access Token (Azure AD v2.0 Endpoint).
//    Refresh Access Token (Azure AD Endpoint).

http.AuthToken = @"MICROSOFT_GRAPH_ACCESS_TOKEN";

CkoStringBuilder *sbResponse = [[CkoStringBuilder alloc] init];

// Sends:  GET /users/{user_id | userPrincipalName}/messages/{message_id}/attachments
// Note: It is also possible to use the literal string "me" for the current logged-on user.
// For example: GET /me/messages/{message_id}/attachments

[http ClearUrlVars];
[http SetUrlVar: @"userPrincipalName" value: @"chilkatsoft@outlook.com"];

// Assume we already have a message ID from previously listing the messages in a folder
NSString *messageId = @"AAMkADYzZWE3YmZmLWU0YzgtNGNkZC04MGE1LWFiYTFlNTRlY2QwYQBGAAAAAAAu7cUXL5YOTrdsUIw7-v8FBwBUcG0qWqkmQYqWLHQataQxAACnwqJUAABUcG0qWqkmQYqWLHQataQxAACnwrnOAAA=";
[http SetUrlVar: @"message_id" value: messageId];

// Send the request to download the attachments.
success = [http QuickGetSb: @"https://graph.microsoft.com/v1.0/users/{$userPrincipalName}/messages/{$message_id}/attachments" sbContent: sbResponse];
if ((success != YES) && ([http.LastStatus intValue] == 0)) {
    NSLog(@"%@",http.LastErrorText);
    return;
}

// The attachment data is contained within the JSON response.
CkoJsonObject *json = [[CkoJsonObject alloc] init];
[json LoadSb: sbResponse];
json.EmitCompact = NO;

NSLog(@"%@%d",@"Status code = ",[http.LastStatus intValue]);
if ([http.LastStatus intValue] != 200) {
    NSLog(@"%@",[json Emit]);
    NSLog(@"%@",@"Failed.");
}

// This is a sample JSON response.  The code for parsing and extracting/saving the attachments
// is shown below.

// 	{
// 	  "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('chilkatsoft%40outlook.com')/messages('AQMkADAwATM0MDAAMS1iNTcwLWI2NTEtMDACLTAwCgBGAAADsVyfxjDU406Ic4X7ill8xAcA5_vF7TKKdE6bGCRqXyl2PQAAAL8huv8AAADn68XtMop0TpsYJGpfKXY9AAAAwSju2wAAAA%3D%3D')/attachments",
// 	  "value": [
// 	    {
// 	      "@odata.type": "#microsoft.graph.fileAttachment",
// 	      "id": "AQMkADAwATM0MDAAMS1iNTcwLWI2NTEtMDACLTAwCgBGAAADsVyfxjDU406Ic4X7ill8xAcA5_vF7TKKdE6bGCRqXyl2PQAAAL8huv8AAADn68XtMop0TpsYJGpfKXY9AAAAwSju2wAAAAESABAAft6wtbaSJU6sgQLi98DI0Q==",
// 	      "lastModifiedDateTime": "2017-05-10T00:30:51Z",
// 	      "name": "fishing.pdf",
// 	      "contentType": "application/pdf",
// 	      "size": 295680,
// 	      "isInline": false,
// 	      "contentId": "F861B218BE380F44B16933097FDDACFC@namprd20.prod.outlook.com",
// 	      "contentLocation": null,
// 	      "contentBytes": "JVBERi0xLjMKJcfsj6 ... yZWYKMjk0MzY5CiUlRU9GCg=="
// 	    },
// 	    {
// 	      "@odata.type": "#microsoft.graph.fileAttachment",
// 	      "id": "AQMkADAwATM0MDAAMS1iNTcwLWI2NTEtMDACLTAwCgBGAAADsVyfxjDU406Ic4X7ill8xAcA5_vF7TKKdE6bGCRqXyl2PQAAAL8huv8AAADn68XtMop0TpsYJGpfKXY9AAAAwSju2wAAAAESABAAXS7qXQ-iRUCYXnhJpN8Ihg==",
// 	      "lastModifiedDateTime": "2017-05-10T00:30:51Z",
// 	      "name": "testCert.cer",
// 	      "contentType": "application/octet-stream",
// 	      "size": 1674,
// 	      "isInline": false,
// 	      "contentId": "5E51FA33EF0F8941ACC8260395CB1A33@namprd20.prod.outlook.com",
// 	      "contentLocation": null,
// 	      "contentBytes": "MIIFRjCCBC6gAwIBA ... 7pt3C5w=="
// 	    }
// 	  ]
// 	}

CkoStringBuilder *sbSavePath = [[CkoStringBuilder alloc] init];
CkoBinData *attachData = [[CkoBinData alloc] init];
CkoDateTime *lastMod = [[CkoDateTime alloc] init];
CkoFileAccess *fac = [[CkoFileAccess alloc] init];

int i = 0;
int numMessages = [[json SizeOfArray: @"value"] intValue];
while (i < numMessages) {
    json.I = [NSNumber numberWithInt: i];

    NSLog(@"%@%@",@"name: ",[json StringOf: @"value[i].name"]);
    NSLog(@"%@%@",@"contentType: ",[json StringOf: @"value[i].contentType"]);
    int sizeInBytes = [[json IntOf: @"value[i].size"] intValue];
    NSLog(@"%@%d",@"size: ",sizeInBytes);

    // Extract the data and save to a file.
    [sbSavePath SetString: @"qa_output/"];
    [sbSavePath Append: [json StringOf: @"value[i].name"]];

    [attachData Clear];
    [attachData AppendEncoded: [json StringOf: @"value[i].contentBytes"] encoding: @"base64"];
    [attachData WriteFile: [sbSavePath GetAsString]];

    // Get the last-modified date/time and set the output file's last-mod date/time..
    [lastMod SetFromTimestamp: [json StringOf: @"value[i].lastModifiedDateTime"]];
    [fac SetLastModified: [sbSavePath GetAsString] lastModified: lastMod];

    NSLog(@"%@",@"----");

    i = i + 1;
}

// The output of the above loop is:
// 
// 	name: fishing.pdf
// 	contentType: application/pdf
// 	size: 295680
// 	----
// 	name: testCert.cer
// 	contentType: application/octet-stream
// 	size: 1674
// 	----
//