Dart Requires Chilkat v11.0.0+

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

Dart

import 'package:chilkat/chilkat.dart';

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

  final email = CkEmail();

  // This example chooses to load an email from a file.
  try {
    email.loadEml('qa_data/eml/testEmail.eml');
  } on ChilkatException catch (e) {
    print(e.lastErrorText);
    return;
  }

  // Get the email as MIME.
  final sbMime = CkStringBuilder();
  email.getMimeSb(sbMime);

  final http = CkHttp();
  final resp = CkHttpResponse();

  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.

  var url = 'https://www.googleapis.com/upload/gmail/v1/users/me/messages?uploadType=media';
  http.uncommonOptions = 'SendGzipped';
  try {
    http.httpSb('POST', url, sbMime, 'utf-8', 'message/rfc822', resp);
  } on ChilkatException catch (e) {
    print(e.lastErrorText);
    return;
  }

  http.uncommonOptions = '';

  // A status code of 200 indicates success.
  print('Response status code: ${resp.statusCode}');
  print('Response body:');
  print(resp.bodyStr);

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

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

  final json = CkJsonObject();
  json.load(resp.bodyStr);
  final id = json.stringOf('id');

  // Add the Inbox label to the inserted email so that it appears in Inbox.
  print('---- 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"
  //     ]
  // }

  final json2 = CkJsonObject();
  json2.updateString('addLabelIds[0]', 'INBOX');

  http.setUrlVar('id', id);
  url = 'https://www.googleapis.com/gmail/v1/users/me/messages/{\$id}/modify';

  try {
    http.httpJson('POST', url, json2, 'application/json', resp);
  } on ChilkatException catch (e) {
    print(e.lastErrorText);
    return;
  }

  // A status code of 200 indicates success.
  print('Response status code: ${resp.statusCode}');
  print('Response body:');
  print(resp.bodyStr);

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

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