Sample code for 30+ languages & platforms
CkPython Requires Chilkat v11.0.0+

Send a Gmail message with a file attachment

See more GMail REST API Examples

Live send. Prepare a small file named attachment.pdf and replace the sample addresses. Add the file as a MIME attachment and upload the complete message as message/rfc822. The response is a Gmail Message. For larger uploads or unreliable connections, see Google’s resumable upload guidance.

Authorize the application with https://www.googleapis.com/auth/gmail.send. The example reads the access token from gmail-token.json in a private working directory. Authorize a desktop application.

Google documentation

Chilkat CkPython Downloads

CkPython
import sys
import chilkat

success = False

#  Assumes Chilkat is unlocked. See Global Unlock Sample.

token = chilkat.CkJsonObject()
success = token.LoadFile("gmail-token.json")
if (success != True):
    print("Could not read gmail-token.json from the private working directory.")
    sys.exit()

if ((token.JsonTypeOf("access_token") != 1) or (token.StringOfEquals("access_token","",True) == True)):
    print("An OAuth access token is required.")
    sys.exit()

http = chilkat.CkHttp()
http.put_RequireSslCertVerify(True)
http.put_AuthToken(token.stringOf("access_token"))
resp = chilkat.CkHttpResponse()
reply = chilkat.CkJsonObject()
email = chilkat.CkEmail()
#  Use the authorized mailbox or one of its configured send-as addresses.
email.put_From("Sender <sender@example.com>")
success = email.AddTo("Recipient","recipient@example.net")
if (success != True):
    print(email.lastErrorText())
    sys.exit()

email.put_Subject("Sample message")
email.put_Charset("utf-8")
email.put_Body("Hello from the Gmail API.")
fileData = chilkat.CkBinData()
success = fileData.LoadFile("attachment.pdf")
if (success != True):
    print("Could not read attachment.pdf.")
    sys.exit()

success = email.AddAttachmentBd("attachment.pdf",fileData,"application/pdf")
if (success != True):
    print(email.lastErrorText())
    sys.exit()

mime = chilkat.CkBinData()
success = email.GetMimeBd(mime)
if (success != True):
    print(email.lastErrorText())
    sys.exit()

success = http.HttpBd("POST","https://gmail.googleapis.com/upload/gmail/v1/users/me/messages/send?uploadType=media",mime,"message/rfc822",resp)
if (resp.get_StatusCode() == 0):
    print("Gmail did not return an HTTP response.")
    sys.exit()

if ((success != True) or (resp.get_StatusCode() < 200) or (resp.get_StatusCode() >= 300)):
    print("Gmail HTTP " + str(resp.get_StatusCode()))
    success = reply.Load(resp.bodyStr())
    if (success == True):
        print(reply.stringOf("error.message"))

    sys.exit()

success = reply.Load(resp.bodyStr())
if (success != True):
    print("Expected a Gmail JSON response.")
    sys.exit()

if ((reply.JsonTypeOf("id") != 1) or (reply.StringOfEquals("id","",True) == True)):
    print("Expected id in the response.")
    sys.exit()

print("Gmail message ID: " + reply.stringOf("id"))