Sample code for 30+ languages & platforms
Xbase++ 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 Xbase++ Downloads

Xbase++
LOCAL nSuccess
LOCAL oToken
LOCAL oHttp
LOCAL oResp
LOCAL oReply
LOCAL nTotal
LOCAL oBaseUrl
LOCAL oUrl
LOCAL oPageToken
LOCAL nMore
LOCAL nCount
LOCAL i

nSuccess := 0

//  Assumes Chilkat is unlocked. See Global Unlock Sample.

oToken := CreateObject("Chilkat.JsonObject")
nSuccess := oToken:LoadFile("gmail-token.json")
IF (nSuccess != 1)
    ? "Could not read gmail-token.json from the private working directory."
    oToken:destroy()
    RETURN
ENDIF

IF ((oToken:JsonTypeOf("access_token") != 1) .OR. (oToken:StringOfEquals("access_token", "", 1) == 1))
    ? "An OAuth access token is required."
    oToken:destroy()
    RETURN
ENDIF

oHttp := CreateObject("Chilkat.Http")
oHttp:RequireSslCertVerify := 1
oHttp:AuthToken := oToken:StringOf("access_token")
oResp := CreateObject("Chilkat.HttpResponse")
oReply := CreateObject("Chilkat.JsonObject")
nTotal := 0
oBaseUrl := CreateObject("Chilkat.StringBuilder")
oBaseUrl:Append("https://gmail.googleapis.com/gmail/v1/users/me/messages?maxResults=100")
oUrl := CreateObject("Chilkat.StringBuilder")
oPageToken := CreateObject("Chilkat.StringBuilder")
nMore := 1
DO WHILE (nMore == 1)
    oUrl:SetString(oBaseUrl:GetAsString())
    IF (oPageToken:Length > 0)
        oUrl:Append("&pageToken=")
        oUrl:Append(oHttp:UrlEncode(oPageToken:GetAsString()))
    ENDIF

    nSuccess := oHttp:HttpNoBody("GET", oUrl:GetAsString(), oResp)
    IF (oResp:StatusCode == 0)
        ? "Gmail did not return an HTTP response."
        oToken:destroy()
        oHttp:destroy()
        oResp:destroy()
        oReply:destroy()
        oBaseUrl:destroy()
        oUrl:destroy()
        oPageToken:destroy()
        RETURN
    ENDIF

    IF ((nSuccess != 1) .OR. (oResp:StatusCode < 200) .OR. (oResp:StatusCode >= 300))
        ? "Gmail HTTP " + Str(oResp:StatusCode)
        nSuccess := oReply:Load(oResp:BodyStr)
        IF (nSuccess == 1)
            ? oReply:StringOf("error.message")
        ENDIF

        oToken:destroy()
        oHttp:destroy()
        oResp:destroy()
        oReply:destroy()
        oBaseUrl:destroy()
        oUrl:destroy()
        oPageToken:destroy()
        RETURN
    ENDIF

    nSuccess := oReply:Load(oResp:BodyStr)
    IF (nSuccess != 1)
        ? "Expected a Gmail JSON response."
        oToken:destroy()
        oHttp:destroy()
        oResp:destroy()
        oReply:destroy()
        oBaseUrl:destroy()
        oUrl:destroy()
        oPageToken:destroy()
        RETURN
    ENDIF

    //  Gmail can omit messages when the search or mailbox is empty.
    nCount := oReply:SizeOfArray("messages")
    i := 0
    DO WHILE (i < nCount)
        oReply:I := i
        ? oReply:StringOf("messages[i].id") + "  thread " + oReply:StringOf("messages[i].threadId")
        nTotal := nTotal + 1
        i := i + 1
    ENDDO
    nMore := 0
    IF (oReply:JsonTypeOf("nextPageToken") == 1)
        oPageToken:SetString(oReply:StringOf("nextPageToken"))
        nMore := oPageToken:Length > 0
    ENDIF

ENDDO
? "Messages listed: " + Str(nTotal)

oToken:destroy()
oHttp:destroy()
oResp:destroy()
oReply:destroy()
oBaseUrl:destroy()
oUrl:destroy()
oPageToken:destroy()