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

Create an unsent Gmail draft

See more GMail REST API Examples

Build a MIME message and place its base64url encoding in message.raw inside the Draft resource. Save the returned draft ID to update or send the draft later. The nested message ID identifies its current message and can change when the draft is replaced.

Authorize the application with https://www.googleapis.com/auth/gmail.compose. 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.")
mime = chilkat.CkBinData()
success = email.GetMimeBd(mime)
if (success != True):
    print(email.lastErrorText())
    sys.exit()

request = chilkat.CkJsonObject()
success = request.UpdateBd("message.raw","base64url",mime)
if (success != True):
    print(request.lastErrorText())
    sys.exit()

success = http.HttpJson("POST","https://gmail.googleapis.com/gmail/v1/users/me/drafts",request,"application/json",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("Draft ID: " + reply.stringOf("id"))
print("Current message ID: " + reply.stringOf("message.id"))