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

Apply a Gmail label to search results in batches

See more GMail REST API Examples

Choose a Gmail search query and an existing label name. Resolve the label ID, collect all matching message IDs before changing any labels, then submit at most 1,000 IDs per batchModify call. Empty searches send no updates. For large mailboxes, spool IDs to persistent storage. Completed batches stay applied if a later request fails; adding the same label again is safe.

Authorize the application with https://www.googleapis.com/auth/gmail.modify. 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>
#include <C_CkStringTableW.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkJsonObjectW token;
    HCkHttpW http;
    HCkHttpResponseW resp;
    HCkJsonObjectW reply;
    HCkJsonObjectW label;
    HCkStringBuilderW labelId;
    HCkStringTableW ids;
    HCkStringBuilderW baseUrl;
    const wchar_t *searchQuery;
    HCkStringBuilderW url;
    HCkStringBuilderW pageToken;
    BOOL more;
    int count;
    int i;
    HCkJsonObjectW request;
    int done;
    int n;

    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();
    success = CkHttpW_HttpNoBody(http,L"GET",L"https://gmail.googleapis.com/gmail/v1/users/me/labels",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);
        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);
        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);
        return;
    }

    if (CkJsonObjectW_JsonTypeOf(reply,L"labels") != 4) {
        wprintf(L"Expected a list of labels.\n");
        CkJsonObjectW_Dispose(token);
        CkHttpW_Dispose(http);
        CkHttpResponseW_Dispose(resp);
        CkJsonObjectW_Dispose(reply);
        return;
    }

    label = CkJsonObjectW_Create();
    success = CkJsonObjectW_FindRecord2(reply,L"labels",L"name",L"To review",TRUE,label);
    if (success != TRUE) {
        wprintf(L"No label with that exact name. Check the name or create the label first.\n");
        CkJsonObjectW_Dispose(token);
        CkHttpW_Dispose(http);
        CkHttpResponseW_Dispose(resp);
        CkJsonObjectW_Dispose(reply);
        CkJsonObjectW_Dispose(label);
        return;
    }

    labelId = CkStringBuilderW_Create();
    success = CkJsonObjectW_StringOfSb(label,L"id",labelId);
    if (success != TRUE) {
        wprintf(L"Could not read the label ID.\n");
        CkJsonObjectW_Dispose(token);
        CkHttpW_Dispose(http);
        CkHttpResponseW_Dispose(resp);
        CkJsonObjectW_Dispose(reply);
        CkJsonObjectW_Dispose(label);
        CkStringBuilderW_Dispose(labelId);
        return;
    }

    ids = CkStringTableW_Create();
    baseUrl = CkStringBuilderW_Create();
    CkStringBuilderW_Append(baseUrl,L"https://gmail.googleapis.com/gmail/v1/users/me/messages?maxResults=500");
    searchQuery = L"has:attachment";
    CkStringBuilderW_Append(baseUrl,L"&q=");
    CkStringBuilderW_Append(baseUrl,CkHttpW_urlEncode(http,searchQuery));
    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);
            CkJsonObjectW_Dispose(label);
            CkStringBuilderW_Dispose(labelId);
            CkStringTableW_Dispose(ids);
            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);
            CkJsonObjectW_Dispose(label);
            CkStringBuilderW_Dispose(labelId);
            CkStringTableW_Dispose(ids);
            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);
            CkJsonObjectW_Dispose(label);
            CkStringBuilderW_Dispose(labelId);
            CkStringTableW_Dispose(ids);
            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);
            success = CkStringTableW_Append(ids,CkJsonObjectW_stringOf(reply,L"messages[i].id"));
            if (success != TRUE) {
                wprintf(L"Could not retain a message ID.\n");
                CkJsonObjectW_Dispose(token);
                CkHttpW_Dispose(http);
                CkHttpResponseW_Dispose(resp);
                CkJsonObjectW_Dispose(reply);
                CkJsonObjectW_Dispose(label);
                CkStringBuilderW_Dispose(labelId);
                CkStringTableW_Dispose(ids);
                CkStringBuilderW_Dispose(baseUrl);
                CkStringBuilderW_Dispose(url);
                CkStringBuilderW_Dispose(pageToken);
                return;
            }

            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;
        }

    }

    //  Search is complete. Apply the label to each group and track confirmed progress.
    request = CkJsonObjectW_Create();
    done = 0;
    while ((done < CkStringTableW_getCount(ids))) {
        CkJsonObjectW_Clear(request);
        CkJsonObjectW_UpdateString(request,L"addLabelIds[0]",CkStringBuilderW_getAsString(labelId));
        n = 0;
        while (((n < 1000) && ((done + n) < CkStringTableW_getCount(ids)))) {
            CkJsonObjectW_putI(request,n);
            CkJsonObjectW_UpdateString(request,L"ids[i]",CkStringTableW_stringAt(ids,done + n));
            n = n + 1;
        }

        success = CkHttpW_HttpJson(http,L"POST",L"https://gmail.googleapis.com/gmail/v1/users/me/messages/batchModify",request,L"application/json",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);
            CkJsonObjectW_Dispose(label);
            CkStringBuilderW_Dispose(labelId);
            CkStringTableW_Dispose(ids);
            CkStringBuilderW_Dispose(baseUrl);
            CkStringBuilderW_Dispose(url);
            CkStringBuilderW_Dispose(pageToken);
            CkJsonObjectW_Dispose(request);
            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);
            CkJsonObjectW_Dispose(label);
            CkStringBuilderW_Dispose(labelId);
            CkStringTableW_Dispose(ids);
            CkStringBuilderW_Dispose(baseUrl);
            CkStringBuilderW_Dispose(url);
            CkStringBuilderW_Dispose(pageToken);
            CkJsonObjectW_Dispose(request);
            return;
        }

        done = done + n;
        wprintf(L"Messages labeled so far: %d\n",done);
    }

    wprintf(L"Total messages labeled: %d\n",done);


    CkJsonObjectW_Dispose(token);
    CkHttpW_Dispose(http);
    CkHttpResponseW_Dispose(resp);
    CkJsonObjectW_Dispose(reply);
    CkJsonObjectW_Dispose(label);
    CkStringBuilderW_Dispose(labelId);
    CkStringTableW_Dispose(ids);
    CkStringBuilderW_Dispose(baseUrl);
    CkStringBuilderW_Dispose(url);
    CkStringBuilderW_Dispose(pageToken);
    CkJsonObjectW_Dispose(request);

    }