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

Mark a Gmail message as read or archive it

See more GMail REST API Examples

Choose read or archive and supply a Gmail message ID. Marking a message as read removes UNREAD. Archiving removes INBOX while keeping the message available elsewhere in the mailbox. Each run performs the selected action on one message. Removing a label that is already absent is safe to repeat.

Authorize the application with https://www.googleapis.com/auth/gmail.modify. 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()
action = "read"
request = chilkat.CkJsonObject()
if (action == "read"):
    success = request.UpdateString("removeLabelIds[0]","UNREAD")
    if (success != True):
        print(request.lastErrorText())
        sys.exit()

else:
    if (action != "archive"):
        print("Choose read or archive.")
        sys.exit()

    success = request.UpdateString("removeLabelIds[0]","INBOX")
    if (success != True):
        print(request.lastErrorText())
        sys.exit()

url = chilkat.CkStringBuilder()
url.Append("https://gmail.googleapis.com/gmail/v1/users/me/messages/")
url.Append("GMAIL_MESSAGE_ID")
url.Append("/modify")
success = http.HttpJson("POST",url.getAsString(),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("Completed " + action + " for message " + reply.stringOf("id"))