Sample code for 30+ languages & platforms
Chilkat2-Python

BatchModify - Add a Label to each Message in Search Results

See more GMail REST API Examples

Searchs GMail for messages meeting a criteria and adds a label to each message found.

Chilkat Chilkat2-Python Downloads

Chilkat2-Python
import sys
import chilkat2

success = False

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

http = chilkat2.Http()
http.AuthToken = "GMAIL-ACCESS-TOKEN"

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

query = "subject:questions"
http.SetUrlVar("query",query)

url = "https://www.googleapis.com/gmail/v1/users/{$userId}/messages?q={$query}"

sb = chilkat2.StringBuilder()
success = http.QuickGetSb(url,sb)
if (success == False):
    print(http.LastErrorText)
    sys.exit()

json = chilkat2.JsonObject()
json.LoadSb(sb)
json.EmitCompact = False
print(json.Emit())

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

# If successful, the received JSON looks like this:
# {
#   "messages": [
#     {
#       "id": "166f583051d36144",
#       "threadId": "166f583051d36144"
#     },
#     {
#       "id": "166f5815e1f36144",
#       "threadId": "166f5815e1f36144"
#     },
# 	...
#     {
#       "id": "166f580639e36144",
#       "threadId": "166f580639e36144"
#     },
#     {
#       "id": "15dbc2e28ec789c6",
#       "threadId": "15dbc2e28ec789c6"
#     }
#   ],
#   "nextPageToken": "13434766102274844688",
#   "resultSizeEstimate": 103
# }
# 

# Next, we'll be sending an HTTP POST to add the label "questions" to each message in the
# search results.  The JSON to be sent for the batchModify is this:

# 	{
# 	  "ids": [
# 	    string
# 	  ],
# 	  "addLabelIds": [
# 	    string
# 	  ],
# 	  "removeLabelIds": [
# 	    string
# 	  ]
# 	}

# We'll omit "removeLabelIds" because we're not removing any labels.
# We are parsing the JSON search results, and at the same time building the batchModify JSON.

json2 = chilkat2.JsonObject()

i = 0
numMessages = json.SizeOfArray("messages")
while (i < numMessages) :
    json.I = i
    id = json.StringOf("messages[i].id")
    json2.I = i
    json2.UpdateString("ids[i]",id)
    i = i + 1

# We need the id of the label (not the name).
# I know the name of the label is "questions", but I need to know the id.
# See this example: Get Label Id by Name
# The id of my label named "questions" is "Label_43"
labelId = "Label_43"
json2.UpdateString("addLabelIds[0]",labelId)
json2.UpdateNewArray("removeLabelIds")

json2.EmitCompact = False
print(json2.Emit())

# Send the batchModify
url = "https://www.googleapis.com/gmail/v1/users/{$userId}/messages/batchModify"
resp = chilkat2.HttpResponse()
success = http.HttpJson("POST",url,json2,"application/json",resp)
if (success == False):
    print(http.LastErrorText)
    sys.exit()

print("status = " + str(resp.StatusCode))

# A 204 response status indicate success.
if (resp.StatusCode != 204):
    print(resp.BodyStr)
    print("Failed.")
    sys.exit()

# The 204 response has an empty response body..

print("BatchModify success!")