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

Download the original Gmail message as EML

See more GMail REST API Examples

Supply a Gmail message ID and request format=raw. Decode the complete MIME message directly to bytes and save them in downloaded.eml. Parse those same bytes with Chilkat.Email to read the subject, sender, and attachment count without a text-encoding round trip.

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

Google documentation

Chilkat Python Downloads

Python
import sys
import chilkat2

success = False

# Assumes Chilkat is unlocked. See Global Unlock Sample.

token = chilkat2.JsonObject()
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 = chilkat2.Http()
http.RequireSslCertVerify = True
http.AuthToken = token.StringOf("access_token")
resp = chilkat2.HttpResponse()
reply = chilkat2.JsonObject()
url = chilkat2.StringBuilder()
url.Append("https://gmail.googleapis.com/gmail/v1/users/me/messages/")
url.Append("GMAIL_MESSAGE_ID")
url.Append("?format=raw")
success = http.HttpNoBody("GET",url.GetAsString(),resp)
if (resp.StatusCode == 0):
    print("Gmail did not return an HTTP response.")
    sys.exit()

if ((success != True) or (resp.StatusCode < 200) or (resp.StatusCode >= 300)):
    print("Gmail HTTP " + str(resp.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("raw") != 1) or (reply.StringOfEquals("raw","",True) == True)):
    print("Expected raw in the response.")
    sys.exit()

mime = chilkat2.BinData()
success = reply.BytesOf("raw","base64url",mime)
if (success != True):
    print("Could not decode the raw MIME.")
    sys.exit()

success = mime.WriteFile("downloaded.eml")
if (success != True):
    print("Could not write downloaded.eml.")
    sys.exit()

email = chilkat2.Email()
success = email.SetFromMimeBd(mime)
if (success != True):
    print(email.LastErrorText)
    sys.exit()

print("From: " + email.From)
print("Subject: " + email.Subject)
print("Attachments: " + str(email.NumAttachments))