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

Unicode C
#include <C_CkJsonObjectW.h>
#include <C_CkHttpW.h>
#include <C_CkHttpResponseW.h>
#include <C_CkStringBuilderW.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkJsonObjectW token;
    HCkHttpW http;
    HCkHttpResponseW resp;
    HCkJsonObjectW reply;
    int total;
    HCkStringBuilderW baseUrl;
    HCkStringBuilderW url;
    HCkStringBuilderW pageToken;
    BOOL more;
    int count;
    int i;

    success = FALSE;

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

    token = CkJsonObjectW_Create();
    success = CkJsonObjectW_LoadFile(token,L"gmail-token.json");
    if (success != TRUE) {
        wprintf(L"Could not read gmail-token.json from the private working directory.\n");
        CkJsonObjectW_Dispose(token);
        return;
    }

    if ((CkJsonObjectW_JsonTypeOf(token,L"access_token") != 1) || (CkJsonObjectW_StringOfEquals(token,L"access_token",L"",TRUE) == TRUE)) {
        wprintf(L"An OAuth access token is required.\n");
        CkJsonObjectW_Dispose(token);
        return;
    }

    http = CkHttpW_Create();
    CkHttpW_putRequireSslCertVerify(http,TRUE);
    CkHttpW_putAuthToken(http,CkJsonObjectW_stringOf(token,L"access_token"));
    resp = CkHttpResponseW_Create();
    reply = CkJsonObjectW_Create();
    total = 0;
    baseUrl = CkStringBuilderW_Create();
    CkStringBuilderW_Append(baseUrl,L"https://gmail.googleapis.com/gmail/v1/users/me/messages?maxResults=100");
    url = CkStringBuilderW_Create();
    pageToken = CkStringBuilderW_Create();
    more = TRUE;
    while ((more == TRUE)) {
        CkStringBuilderW_SetString(url,CkStringBuilderW_getAsString(baseUrl));
        if (CkStringBuilderW_getLength(pageToken) > 0) {
            CkStringBuilderW_Append(url,L"&pageToken=");
            CkStringBuilderW_Append(url,CkHttpW_urlEncode(http,CkStringBuilderW_getAsString(pageToken)));
        }

        success = CkHttpW_HttpNoBody(http,L"GET",CkStringBuilderW_getAsString(url),resp);
        if (CkHttpResponseW_getStatusCode(resp) == 0) {
            wprintf(L"Gmail did not return an HTTP response.\n");
            CkJsonObjectW_Dispose(token);
            CkHttpW_Dispose(http);
            CkHttpResponseW_Dispose(resp);
            CkJsonObjectW_Dispose(reply);
            CkStringBuilderW_Dispose(baseUrl);
            CkStringBuilderW_Dispose(url);
            CkStringBuilderW_Dispose(pageToken);
            return;
        }

        if ((success != TRUE) || (CkHttpResponseW_getStatusCode(resp) < 200) || (CkHttpResponseW_getStatusCode(resp) >= 300)) {
            wprintf(L"Gmail HTTP %d\n",CkHttpResponseW_getStatusCode(resp));
            success = CkJsonObjectW_Load(reply,CkHttpResponseW_bodyStr(resp));
            if (success == TRUE) {
                wprintf(L"%s\n",CkJsonObjectW_stringOf(reply,L"error.message"));
            }

            CkJsonObjectW_Dispose(token);
            CkHttpW_Dispose(http);
            CkHttpResponseW_Dispose(resp);
            CkJsonObjectW_Dispose(reply);
            CkStringBuilderW_Dispose(baseUrl);
            CkStringBuilderW_Dispose(url);
            CkStringBuilderW_Dispose(pageToken);
            return;
        }

        success = CkJsonObjectW_Load(reply,CkHttpResponseW_bodyStr(resp));
        if (success != TRUE) {
            wprintf(L"Expected a Gmail JSON response.\n");
            CkJsonObjectW_Dispose(token);
            CkHttpW_Dispose(http);
            CkHttpResponseW_Dispose(resp);
            CkJsonObjectW_Dispose(reply);
            CkStringBuilderW_Dispose(baseUrl);
            CkStringBuilderW_Dispose(url);
            CkStringBuilderW_Dispose(pageToken);
            return;
        }

        //  Gmail can omit messages when the search or mailbox is empty.
        count = CkJsonObjectW_SizeOfArray(reply,L"messages");
        i = 0;
        while ((i < count)) {
            CkJsonObjectW_putI(reply,i);
            wprintf(L"%s  thread %s\n",CkJsonObjectW_stringOf(reply,L"messages[i].id"),CkJsonObjectW_stringOf(reply,L"messages[i].threadId"));
            total = total + 1;
            i = i + 1;
        }

        more = FALSE;
        if (CkJsonObjectW_JsonTypeOf(reply,L"nextPageToken") == 1) {
            CkStringBuilderW_SetString(pageToken,CkJsonObjectW_stringOf(reply,L"nextPageToken"));
            more = CkStringBuilderW_getLength(pageToken) > 0;
        }

    }

    wprintf(L"Messages listed: %d\n",total);


    CkJsonObjectW_Dispose(token);
    CkHttpW_Dispose(http);
    CkHttpResponseW_Dispose(resp);
    CkJsonObjectW_Dispose(reply);
    CkStringBuilderW_Dispose(baseUrl);
    CkStringBuilderW_Dispose(url);
    CkStringBuilderW_Dispose(pageToken);

    }