Objective-C

Insert Email into GMail Folder

See more GMail REST API Examples

Directly inserts a message into only this user's mailbox similar to IMAP APPEND, bypassing most scanning and classification. Does not send a message.

This example will create a Chilkat Email object and upload/insert it into GMail. Then adds the "INBOX" label to the email to make it appear in INBOX

Objective-C

#import <CkoEmail.h>
#import <CkoStringBuilder.h>
#import <CkoHttp.h>
#import <CkoHttpResponse.h>
#import <NSString.h>
#import <CkoJsonObject.h>

BOOL success = NO;

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

CkoEmail *email = [[CkoEmail alloc] init];

// This example chooses to load an email from a file.
success = [email LoadEml: @"qa_data/eml/testEmail.eml"];
if (success == NO) {
    NSLog(@"%@",email.LastErrorText);
    return;
}

// Get the email as MIME.
CkoStringBuilder *sbMime = [[CkoStringBuilder alloc] init];
[email GetMimeSb: sbMime];

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

http.AuthToken = @"GMAIL-ACCESS-TOKEN";

// Upload to GMail (does not send, but just inserts).

// IMPORTANT: After uploading/inserting, you won't see the message in the Inbox.
// In your web browser, if you go to "All Mail", you will see it.

NSString *url = @"https://www.googleapis.com/upload/gmail/v1/users/me/messages?uploadType=media";
http.UncommonOptions = @"SendGzipped";
success = [http HttpSb: @"POST" url: url sb: sbMime charset: @"utf-8" contentType: @"message/rfc822" response: resp];
if (success == NO) {
    NSLog(@"%@",http.LastErrorText);
    return;
}

http.UncommonOptions = @"";

// A status code of 200 indicates success.
NSLog(@"%@%d",@"Response status code: ",[resp.StatusCode intValue]);
NSLog(@"%@",@"Response body:");
NSLog(@"%@",resp.BodyStr);

// The response body contains JSON.
// A sample successful JSON response:

// {
//  "id": "166f583051d36144",
//  "threadId": "166f5529e079a456"
// }

CkoJsonObject *json = [[CkoJsonObject alloc] init];
[json Load: resp.BodyStr];
NSString *id = [json StringOf: @"id"];

// Add the Inbox label to the inserted email so that it appears in Inbox.
NSLog(@"%@",@"---- Adding the Inbox label to the newly inserted email. ----");

// Create the following JSON to be sent in a POST to modify labels for this message.
// {
//   "addLabelIds": [
//     "INBOX"
//     ]
// }

CkoJsonObject *json2 = [[CkoJsonObject alloc] init];
[json2 UpdateString: @"addLabelIds[0]" value: @"INBOX"];

[http SetUrlVar: @"id" value: id];
url = @"https://www.googleapis.com/gmail/v1/users/me/messages/{$id}/modify";

success = [http HttpJson: @"POST" url: url json: json2 contentType: @"application/json" response: resp];
if (success == NO) {
    NSLog(@"%@",http.LastErrorText);
    return;
}

// A status code of 200 indicates success.
NSLog(@"%@%d",@"Response status code: ",[resp.StatusCode intValue]);
NSLog(@"%@",@"Response body:");
NSLog(@"%@",resp.BodyStr);

// The response body contains JSON.
// A sample successful JSON response:

// {
//  "id": "166f583051d36144",
//  "threadId": "166f583051d36144",
//  "labelIds": [
//   "INBOX"
//  ]
// }