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

Inspect the MIME parts of a Gmail message

See more GMail REST API Examples

Supply a Gmail message ID and request format=full. Walk the root payload and every nested parts array, including a single-part root. For each part, show its MIME type, filename, and size. A body.attachmentId can be passed to the attachment download example. Inline body.data is already included as base64url.

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 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()
url = chilkat.CkStringBuilder()
url.Append("https://gmail.googleapis.com/gmail/v1/users/me/messages/")
url.Append("GMAIL_MESSAGE_ID")
url.Append("?format=full")
success = http.HttpNoBody("GET",url.getAsString(),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("payload") != 3):
    print("Expected a MIME payload.")
    sys.exit()

#  Queue paths into the original JSON document so any MIME nesting depth is supported.
paths = chilkat.CkStringTable()
success = paths.Append("payload")
if (success != True):
    print("Could not queue the root part.")
    sys.exit()

part = chilkat.CkJsonObject()
childPath = chilkat.CkStringBuilder()
p = 0
while (p < paths.get_Count()) :
    success = reply.ObjectOf2(paths.stringAt(p),part)
    if (success != True):
        print("Could not read a MIME part.")
        sys.exit()

    print("Part: " + part.stringOf("mimeType") + "  bytes: " + str(part.IntOf("body.size")))
    if (part.JsonTypeOf("filename") == 1):
        if (part.StringOfEquals("filename","",True) != True):
            print("Filename: " + part.stringOf("filename"))

    if (part.JsonTypeOf("body.attachmentId") == 1):
        print("Attachment ID: " + part.stringOf("body.attachmentId"))
    else:
        if (part.JsonTypeOf("body.data") == 1):
            print("Body data is available in this part.")

    j = 0
    while (j < part.SizeOfArray("parts")) :
        childPath.SetString(paths.stringAt(p))
        childPath.Append(".parts[")
        childPath.AppendInt(j)
        childPath.Append("]")
        success = paths.Append(childPath.getAsString())
        if (success != True):
            print("Could not queue a child part.")
            sys.exit()

        j = j + 1

    p = p + 1