(.NET Core C#) Send GMail with BCC Recipients using REST API

See more GMail REST API Examples

Demonstrates how to send an email with BCC recipients using the GMail REST API.

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

Chilkat .NET Downloads

Chilkat .NET Assemblies

Chilkat for .NET Core

Chilkat for Mono

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

bool success;

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

// 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...

// -----------------------------------------------------------------------------------------
// This section of this example demonstrates how to add BCC recipients.
// 
// Technically, an email should never contain a "Bcc" MIME header because it would
// effectively nullify the purpose of BCC -- which means "Blind Carbon Copy".
// Email recipients should not be able to see the BCC recipients.
// Chilkat never adds a "Bcc" header field.
// However.. in this case, the GMail REST server will look for the Bcc header field,
// and will include those email addresses when sending, and also removes the Bcc header
// from the email that is sent.
// 
// Starting in Chilkat v9.5.0.91, we can tell the email object to add the Bcc header
// using the "UseBccHeader" UncommonOptions.  For example:
email.UncommonOptions = "UseBccHeader";
email.AddBcc("Joe","joe@example.com");
email.AddBcc("Dave","dave@example.com");
// ...
// -----------------------------------------------------------------------------------------

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.
string cid = email.AddRelatedFile("qa_data/jpg/starfish.jpg");
Chilkat.StringBuilder sbHtml = new Chilkat.StringBuilder();
sbHtml.Append("<html><body>This is a <b>test</b><br><img src=\"cid:STARFISH_CID\"/></body></html>");
int 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.
Chilkat.StringBuilder sbMime = new Chilkat.StringBuilder();
email.GetMimeSb(sbMime);
sbMime.Encode("base64url","utf-8");

// The body of the HTTP request will be JSON..
Chilkat.JsonObject json = new Chilkat.JsonObject();
json.UpdateSb("raw",sbMime);

// Send the email...
Chilkat.Http http = new Chilkat.Http();
http.AuthToken = "GMAIL-ACCESS-TOKEN";

string url = "https://www.googleapis.com/gmail/v1/users/me/messages/send";
Chilkat.HttpResponse resp = http.PostJson3(url,"application/json",json);
if (http.LastMethodSuccess != true) {
    Debug.WriteLine(http.LastErrorText);
    return;
}

// A status code of 200 indicates success.
Debug.WriteLine("Response status code: " + Convert.ToString(resp.StatusCode));
Debug.WriteLine("Response body:");
Debug.WriteLine(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"
//  ]
// }