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

Find a Gmail label ID by name

See more GMail REST API Examples

Look up a label using its exact display name, including any parent/child path. Labels and their IDs belong to the authenticated mailbox. Use Gmail’s returned ID when applying a user label to messages.

Authorize the application with https://www.googleapis.com/auth/gmail.labels. 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()
success = http.HttpNoBody("GET","https://gmail.googleapis.com/gmail/v1/users/me/labels",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("labels") != 4):
    print("Expected a list of labels.")
    sys.exit()

label = chilkat.CkJsonObject()
success = reply.FindRecord2("labels","name","To review",True,label)
if (success != True):
    print("No label with that exact name. Check the name or create the label first.")
    sys.exit()

print("Label ID: " + label.stringOf("id"))