Chilkat2-Python
Send GMail with BCC Recipients using REST API

Demonstrates how to send an email with BCC recipients using the GMail REST API.
Chilkat Chilkat2-Python Downloads

Chilkat2-Python
import sys
import chilkat2

success = False

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

# The body of the HTTP request will be JSON..
json = chilkat2.JsonObject()
json.UpdateSb("raw",sbMime)

# Send the email...
http = chilkat2.Http()
http.AuthToken = "GMAIL-ACCESS-TOKEN"

url = "https://www.googleapis.com/gmail/v1/users/me/messages/send"
resp = chilkat2.HttpResponse()
success = http.HttpJson("POST",url,json,"application/json",resp)
if (success == False):
    print(http.LastErrorText)
    sys.exit()

# A status code of 200 indicates success.
print("Response status code: " + str(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"
#  ]
# }