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

List Gmail message IDs across all pages

See more GMail REST API Examples

List message and thread IDs for the authenticated user. Continue with nextPageToken until it is absent. A message ID is a Gmail identifier, distinct from the RFC Message-ID header. Use it in the reading examples. Spam and Trash are excluded by default.

Authorize the application with https://www.googleapis.com/auth/gmail.readonly. 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()
total = 0
baseUrl = chilkat.CkStringBuilder()
baseUrl.Append("https://gmail.googleapis.com/gmail/v1/users/me/messages?maxResults=100")
url = chilkat.CkStringBuilder()
pageToken = chilkat.CkStringBuilder()
more = True
while (more == True) :
    url.SetString(baseUrl.getAsString())
    if (pageToken.get_Length() > 0):
        url.Append("&pageToken=")
        url.Append(http.urlEncode(pageToken.getAsString()))

    success = http.HttpNoBody("GET",url.getAsString(),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()

    #  Gmail can omit messages when the search or mailbox is empty.
    count = reply.SizeOfArray("messages")
    i = 0
    while (i < count) :
        reply.put_I(i)
        print(reply.stringOf("messages[i].id") + "  thread " + reply.stringOf("messages[i].threadId"))
        total = total + 1
        i = i + 1

    more = False
    if (reply.JsonTypeOf("nextPageToken") == 1):
        pageToken.SetString(reply.stringOf("nextPageToken"))
        more = pageToken.get_Length() > 0

print("Messages listed: " + str(total))