CkPython

Find a Label ID by Name

See more GMail REST API Examples

Lookup the ID of a GMail label by the label name. CkPython

import sys
import chilkat

success = False

# This example requires the Chilkat API to have been previously unlocked.
# See Global Unlock Sample for sample code.

http = chilkat.CkHttp()
http.put_AuthToken("GMAIL-ACCESS-TOKEN")

userId = "me"
http.SetUrlVar("userId",userId)

url = "https://www.googleapis.com/gmail/v1/users/{$userId}/labels"

# Get the list of GMail labels as JSON.
sb = chilkat.CkStringBuilder()
success = http.QuickGetSb(url,sb)
if (success != True):
    print(http.lastErrorText())
    sys.exit()

json = chilkat.CkJsonObject()
json.LoadSb(sb)
json.put_EmitCompact(False)
print(json.emit())

if (http.get_LastStatus() != 200):
    print("Failed.")
    sys.exit()

# The JSON returned looks like this:
# {
#   "labels": [
#     {
#       "id": "Label_5",
#       "name": "QA",
#       "messageListVisibility": "show",
#       "labelListVisibility": "labelShow",
#       "type": "user"
#     },
#     {
#       "id": "Label_21",
#       "name": "[Gmail]/testFolder",
#       "type": "user"
#     },
#     {
#       "id": "CATEGORY_PERSONAL",
#       "name": "CATEGORY_PERSONAL",
#       "type": "system"
#     },
# 	...

# The name of the label is generally known because it's what we visually see.
# The id is what we need to get.  Assuming the name is unique,
# find the JSON record having name=<desired name>
# For example...
# jRecord is a CkJsonObject
jRecord = json.FindRecord("labels","name","QA",False)
if (json.get_LastMethodSuccess() == True):
    print("The id of QA is: " + jRecord.stringOf("id"))

# jRecord is a CkJsonObject
jRecord = json.FindRecord("labels","name","[Gmail]/testFolder",False)
if (json.get_LastMethodSuccess() == True):
    print("The id of [Gmail]/testFolder is: " + jRecord.stringOf("id"))

# jRecord is a CkJsonObject
jRecord = json.FindRecord("labels","name","questions",False)
if (json.get_LastMethodSuccess() == True):
    print("The id of questions is: " + jRecord.stringOf("id"))

# Output:

# The id of QA is: Label_5
# The id of [Gmail]/testFolder is: Label_21
# The id of questions is: Label_43