Dart
Send GMail using REST API

Demonstrates how to send an email using the GMail REST API.
Chilkat Dart Downloads

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.

  // Use the Chilkat Email API to create or load an email.
  final email = CkEmail();

  // The From name/address don't need to be specified. 
  // GMail will automatically use your Gmail address if the following 2 lines are omitted.
  email.fromName = 'My Name';
  email.fromAddress = 'my_account_name@gmail.com';

  email.addTo('John Smith', 'somebody@somewhere.com');
  // To add more recipients, make additional calls to AddTo or AddCC, one per recipient...

  email.subject = 'This is a test GMail email created using Chilkat.';
  email.charset = 'utf-8';
  email.addPlainTextAlternativeBody('This is a test');

  // Create an HTML email body with an embedded image.
  final cid = email.addRelatedFile('qa_data/jpg/starfish.jpg');
  final sbHtml = CkStringBuilder();
  sbHtml.append('<html><body>This is a <b>test</b><br><img src="cid:STARFISH_CID"/></body></html>');
  final numReplacements = sbHtml.replace('STARFISH_CID', cid);

  email.addHtmlAlternativeBody(sbHtml.getAsString());

  // OK.. we now have an HTML email with an embedded JPG image
  // We'll need to get the full MIME of the email encoded to a base64url string.
  final sbMime = CkStringBuilder();
  email.getMimeSb(sbMime);
  sbMime.encode('base64url', 'utf-8');

  // The body of the HTTP request will be JSON..
  final json = CkJsonObject();
  json.updateSb('raw', sbMime);

  // Send the email...
  final http = CkHttp();
  http.authToken = 'GMAIL-ACCESS-TOKEN';

  final url = 'https://www.googleapis.com/gmail/v1/users/me/messages/send';
  final resp = CkHttpResponse();
  try {
    http.httpJson('POST', url, json, '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.
  // Use the online tool at Generate JSON Parsing Code
  // to generate JSON parsing code.

  // A sample successful JSON response:

  // {
  //  "id": "166f0d4ac39e50bf",
  //  "threadId": "166f0d4ac39e50bf",
  //  "labelIds": [
  //   "SENT"
  //  ]
  // }
}