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

Synchronize Gmail message IDs and labels between runs

See more GMail REST API Examples

Maintain gmail-sync.json containing the mailbox address, a string historyId, and a small local cache of message IDs, thread IDs, and labels. The first run scans the complete mailbox including Spam and Trash. Later runs follow all history pages and refresh only messages affected by additions, deletions, or label changes. A message GET returning 404 removes that message from the local cache.

An expired history checkpoint causes a full rebuild. The full scan records a checkpoint before listing messages, so the next run also reconciles changes made during the scan. Incremental runs save the final history response checkpoint only after every affected message has been processed. The cache and checkpoint are committed together, with a previous-file recovery path. History IDs remain strings throughout.

Run in a private directory and serialize runs sharing the cache. The sample holds the cache in memory for clarity. Larger applications can use database upserts and deletions, committing the checkpoint in the same transaction. The cache contains message identifiers and labels. Fetch MIME or selected headers when the application needs message content.

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_CkFileAccessW.h>
#include <C_CkStringArrayW.h>
#include <C_CkStringBuilderW.h>
#include <C_CkStringTableW.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkJsonObjectW token;
    HCkHttpW http;
    HCkHttpResponseW resp;
    HCkJsonObjectW reply;
    HCkFileAccessW files;
    int fileStatus;
    int backupStatus;
    HCkJsonObjectW state;
    const wchar_t *mailbox;
    const wchar_t *baseline;
    BOOL fullSync;
    const wchar_t *checkpoint;
    HCkStringArrayW ids;
    HCkStringBuilderW baseUrl;
    HCkStringBuilderW url;
    const wchar_t *pageToken;
    BOOL more;
    HCkStringTableW changeTypes;
    HCkJsonObjectW record;
    HCkStringBuilderW eventPath;
    int h;
    int t;
    int j;
    int m;
    HCkJsonObjectW messages;
    HCkJsonObjectW cachedMessage;
    int i;
    const wchar_t *messageId;

    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();
    files = CkFileAccessW_Create();
    //  Recover the previous complete file if a run stopped during replacement.
    fileStatus = CkFileAccessW_FileExists3(files,L"gmail-sync.json");
    if (fileStatus < 0) {
        wprintf(L"Could not inspect gmail-sync.json.\n");
        CkJsonObjectW_Dispose(token);
        CkHttpW_Dispose(http);
        CkHttpResponseW_Dispose(resp);
        CkJsonObjectW_Dispose(reply);
        CkFileAccessW_Dispose(files);
        return;
    }

    if (fileStatus == 0) {
        backupStatus = CkFileAccessW_FileExists3(files,L"gmail-sync.json.previous");
        if (backupStatus < 0) {
            wprintf(L"Could not inspect the backup file.\n");
            CkJsonObjectW_Dispose(token);
            CkHttpW_Dispose(http);
            CkHttpResponseW_Dispose(resp);
            CkJsonObjectW_Dispose(reply);
            CkFileAccessW_Dispose(files);
            return;
        }

        if (backupStatus == 1) {
            success = CkFileAccessW_FileRename(files,L"gmail-sync.json.previous",L"gmail-sync.json");
            if (success != TRUE) {
                wprintf(L"Could not restore the previous complete file.\n");
                CkJsonObjectW_Dispose(token);
                CkHttpW_Dispose(http);
                CkHttpResponseW_Dispose(resp);
                CkJsonObjectW_Dispose(reply);
                CkFileAccessW_Dispose(files);
                return;
            }

            fileStatus = 1;
        }

    }

    state = CkJsonObjectW_Create();
    if (fileStatus == 1) {
        success = CkJsonObjectW_LoadFile(state,L"gmail-sync.json");
        if (success != TRUE) {
            wprintf(L"Could not read the existing synchronization state.\n");
            CkJsonObjectW_Dispose(token);
            CkHttpW_Dispose(http);
            CkHttpResponseW_Dispose(resp);
            CkJsonObjectW_Dispose(reply);
            CkFileAccessW_Dispose(files);
            CkJsonObjectW_Dispose(state);
            return;
        }

        if ((CkJsonObjectW_JsonTypeOf(state,L"historyId") != 1) || (CkJsonObjectW_JsonTypeOf(state,L"messages") != 3) || (CkJsonObjectW_JsonTypeOf(state,L"emailAddress") != 1)) {
            wprintf(L"The synchronization state is incomplete. Restore its previous complete copy.\n");
            CkJsonObjectW_Dispose(token);
            CkHttpW_Dispose(http);
            CkHttpResponseW_Dispose(resp);
            CkJsonObjectW_Dispose(reply);
            CkFileAccessW_Dispose(files);
            CkJsonObjectW_Dispose(state);
            return;
        }

    }

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

    if ((CkJsonObjectW_JsonTypeOf(reply,L"emailAddress") != 1) || (CkJsonObjectW_StringOfEquals(reply,L"emailAddress",L"",TRUE) == TRUE)) {
        wprintf(L"Expected emailAddress in the response.\n");
        CkJsonObjectW_Dispose(token);
        CkHttpW_Dispose(http);
        CkHttpResponseW_Dispose(resp);
        CkJsonObjectW_Dispose(reply);
        CkFileAccessW_Dispose(files);
        CkJsonObjectW_Dispose(state);
        return;
    }

    if ((CkJsonObjectW_JsonTypeOf(reply,L"historyId") != 1) || (CkJsonObjectW_StringOfEquals(reply,L"historyId",L"",TRUE) == TRUE)) {
        wprintf(L"Expected historyId in the response.\n");
        CkJsonObjectW_Dispose(token);
        CkHttpW_Dispose(http);
        CkHttpResponseW_Dispose(resp);
        CkJsonObjectW_Dispose(reply);
        CkFileAccessW_Dispose(files);
        CkJsonObjectW_Dispose(state);
        return;
    }

    mailbox = CkJsonObjectW_stringOf(reply,L"emailAddress");
    baseline = CkJsonObjectW_stringOf(reply,L"historyId");
    if (fileStatus == 1) {
        if (CkJsonObjectW_StringOfEquals(state,L"emailAddress",mailbox,FALSE) != TRUE) {
            wprintf(L"Use a separate synchronization file for this mailbox.\n");
            CkJsonObjectW_Dispose(token);
            CkHttpW_Dispose(http);
            CkHttpResponseW_Dispose(resp);
            CkJsonObjectW_Dispose(reply);
            CkFileAccessW_Dispose(files);
            CkJsonObjectW_Dispose(state);
            return;
        }

    }

    fullSync = fileStatus == 0;
    checkpoint = baseline;
    ids = CkStringArrayW_Create();
    CkStringArrayW_putUnique(ids,TRUE);
    baseUrl = CkStringBuilderW_Create();
    url = CkStringBuilderW_Create();
    pageToken = L"";
    more = TRUE;

    if (fullSync != TRUE) {
        CkStringBuilderW_SetString(baseUrl,L"https://gmail.googleapis.com/gmail/v1/users/me/history?maxResults=500&startHistoryId=");
        CkStringBuilderW_Append(baseUrl,CkHttpW_urlEncode(http,CkJsonObjectW_stringOf(state,L"historyId")));
        changeTypes = CkStringTableW_Create();
        success = CkStringTableW_Append(changeTypes,L"messagesAdded");
        if (success != TRUE) {
            wprintf(L"%s\n",CkStringTableW_lastErrorText(changeTypes));
            CkJsonObjectW_Dispose(token);
            CkHttpW_Dispose(http);
            CkHttpResponseW_Dispose(resp);
            CkJsonObjectW_Dispose(reply);
            CkFileAccessW_Dispose(files);
            CkJsonObjectW_Dispose(state);
            CkStringArrayW_Dispose(ids);
            CkStringBuilderW_Dispose(baseUrl);
            CkStringBuilderW_Dispose(url);
            CkStringTableW_Dispose(changeTypes);
            return;
        }

        success = CkStringTableW_Append(changeTypes,L"messagesDeleted");
        if (success != TRUE) {
            wprintf(L"%s\n",CkStringTableW_lastErrorText(changeTypes));
            CkJsonObjectW_Dispose(token);
            CkHttpW_Dispose(http);
            CkHttpResponseW_Dispose(resp);
            CkJsonObjectW_Dispose(reply);
            CkFileAccessW_Dispose(files);
            CkJsonObjectW_Dispose(state);
            CkStringArrayW_Dispose(ids);
            CkStringBuilderW_Dispose(baseUrl);
            CkStringBuilderW_Dispose(url);
            CkStringTableW_Dispose(changeTypes);
            return;
        }

        success = CkStringTableW_Append(changeTypes,L"labelsAdded");
        if (success != TRUE) {
            wprintf(L"%s\n",CkStringTableW_lastErrorText(changeTypes));
            CkJsonObjectW_Dispose(token);
            CkHttpW_Dispose(http);
            CkHttpResponseW_Dispose(resp);
            CkJsonObjectW_Dispose(reply);
            CkFileAccessW_Dispose(files);
            CkJsonObjectW_Dispose(state);
            CkStringArrayW_Dispose(ids);
            CkStringBuilderW_Dispose(baseUrl);
            CkStringBuilderW_Dispose(url);
            CkStringTableW_Dispose(changeTypes);
            return;
        }

        success = CkStringTableW_Append(changeTypes,L"labelsRemoved");
        if (success != TRUE) {
            wprintf(L"%s\n",CkStringTableW_lastErrorText(changeTypes));
            CkJsonObjectW_Dispose(token);
            CkHttpW_Dispose(http);
            CkHttpResponseW_Dispose(resp);
            CkJsonObjectW_Dispose(reply);
            CkFileAccessW_Dispose(files);
            CkJsonObjectW_Dispose(state);
            CkStringArrayW_Dispose(ids);
            CkStringBuilderW_Dispose(baseUrl);
            CkStringBuilderW_Dispose(url);
            CkStringTableW_Dispose(changeTypes);
            return;
        }

        record = CkJsonObjectW_Create();
        eventPath = CkStringBuilderW_Create();
        while ((more == TRUE)) {
            CkStringBuilderW_SetString(url,CkStringBuilderW_getAsString(baseUrl));
            CkStringBuilderW_Append(url,L"&pageToken=");
            CkStringBuilderW_Append(url,CkHttpW_urlEncode(http,pageToken));
            success = CkHttpW_HttpNoBody(http,L"GET",CkStringBuilderW_getAsString(url),resp);
            if (CkHttpResponseW_getStatusCode(resp) == 404) {
                wprintf(L"History checkpoint expired. Rebuilding the cache.\n");
                fullSync = TRUE;
                more = FALSE;
            }
            else {
                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);
                    CkFileAccessW_Dispose(files);
                    CkJsonObjectW_Dispose(state);
                    CkStringArrayW_Dispose(ids);
                    CkStringBuilderW_Dispose(baseUrl);
                    CkStringBuilderW_Dispose(url);
                    CkStringTableW_Dispose(changeTypes);
                    CkJsonObjectW_Dispose(record);
                    CkStringBuilderW_Dispose(eventPath);
                    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);
                    CkFileAccessW_Dispose(files);
                    CkJsonObjectW_Dispose(state);
                    CkStringArrayW_Dispose(ids);
                    CkStringBuilderW_Dispose(baseUrl);
                    CkStringBuilderW_Dispose(url);
                    CkStringTableW_Dispose(changeTypes);
                    CkJsonObjectW_Dispose(record);
                    CkStringBuilderW_Dispose(eventPath);
                    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);
                    CkFileAccessW_Dispose(files);
                    CkJsonObjectW_Dispose(state);
                    CkStringArrayW_Dispose(ids);
                    CkStringBuilderW_Dispose(baseUrl);
                    CkStringBuilderW_Dispose(url);
                    CkStringTableW_Dispose(changeTypes);
                    CkJsonObjectW_Dispose(record);
                    CkStringBuilderW_Dispose(eventPath);
                    return;
                }

                h = 0;
                while ((h < CkJsonObjectW_SizeOfArray(reply,L"history"))) {
                    CkJsonObjectW_putI(reply,h);
                    success = CkJsonObjectW_ObjectOf2(reply,L"history[i]",record);
                    if (success != TRUE) {
                        wprintf(L"%s\n",CkJsonObjectW_lastErrorText(reply));
                        CkJsonObjectW_Dispose(token);
                        CkHttpW_Dispose(http);
                        CkHttpResponseW_Dispose(resp);
                        CkJsonObjectW_Dispose(reply);
                        CkFileAccessW_Dispose(files);
                        CkJsonObjectW_Dispose(state);
                        CkStringArrayW_Dispose(ids);
                        CkStringBuilderW_Dispose(baseUrl);
                        CkStringBuilderW_Dispose(url);
                        CkStringTableW_Dispose(changeTypes);
                        CkJsonObjectW_Dispose(record);
                        CkStringBuilderW_Dispose(eventPath);
                        return;
                    }

                    t = 0;
                    while ((t < CkStringTableW_getCount(changeTypes))) {
                        j = 0;
                        while ((j < CkJsonObjectW_SizeOfArray(record,CkStringTableW_stringAt(changeTypes,t)))) {
                            CkStringBuilderW_SetString(eventPath,CkStringTableW_stringAt(changeTypes,t));
                            CkStringBuilderW_Append(eventPath,L"[");
                            CkStringBuilderW_AppendInt(eventPath,j);
                            CkStringBuilderW_Append(eventPath,L"].message.id");
                            success = CkStringArrayW_Append(ids,CkJsonObjectW_stringOf(record,CkStringBuilderW_getAsString(eventPath)));
                            if (success != TRUE) {
                                wprintf(L"%s\n",CkStringArrayW_lastErrorText(ids));
                                CkJsonObjectW_Dispose(token);
                                CkHttpW_Dispose(http);
                                CkHttpResponseW_Dispose(resp);
                                CkJsonObjectW_Dispose(reply);
                                CkFileAccessW_Dispose(files);
                                CkJsonObjectW_Dispose(state);
                                CkStringArrayW_Dispose(ids);
                                CkStringBuilderW_Dispose(baseUrl);
                                CkStringBuilderW_Dispose(url);
                                CkStringTableW_Dispose(changeTypes);
                                CkJsonObjectW_Dispose(record);
                                CkStringBuilderW_Dispose(eventPath);
                                return;
                            }

                            j = j + 1;
                        }

                        t = t + 1;
                    }

                    h = h + 1;
                }

                pageToken = L"";
                if (CkJsonObjectW_JsonTypeOf(reply,L"nextPageToken") == 1) {
                    pageToken = CkJsonObjectW_stringOf(reply,L"nextPageToken");
                }

                more = pageToken != L"";
                if (more != TRUE) {
                    if ((CkJsonObjectW_JsonTypeOf(reply,L"historyId") != 1) || (CkJsonObjectW_StringOfEquals(reply,L"historyId",L"",TRUE) == TRUE)) {
                        wprintf(L"Expected historyId in the response.\n");
                        CkJsonObjectW_Dispose(token);
                        CkHttpW_Dispose(http);
                        CkHttpResponseW_Dispose(resp);
                        CkJsonObjectW_Dispose(reply);
                        CkFileAccessW_Dispose(files);
                        CkJsonObjectW_Dispose(state);
                        CkStringArrayW_Dispose(ids);
                        CkStringBuilderW_Dispose(baseUrl);
                        CkStringBuilderW_Dispose(url);
                        CkStringTableW_Dispose(changeTypes);
                        CkJsonObjectW_Dispose(record);
                        CkStringBuilderW_Dispose(eventPath);
                        return;
                    }

                    checkpoint = CkJsonObjectW_stringOf(reply,L"historyId");
                }

            }

        }

    }

    if (fullSync == TRUE) {
        //  Rebuild in memory. Any failure leaves the committed file available for a retry.
        CkStringArrayW_Clear(ids);
        CkJsonObjectW_Clear(state);
        success = CkJsonObjectW_UpdateString(state,L"emailAddress",mailbox);
        if (success != TRUE) {
            wprintf(L"%s\n",CkJsonObjectW_lastErrorText(state));
            CkJsonObjectW_Dispose(token);
            CkHttpW_Dispose(http);
            CkHttpResponseW_Dispose(resp);
            CkJsonObjectW_Dispose(reply);
            CkFileAccessW_Dispose(files);
            CkJsonObjectW_Dispose(state);
            CkStringArrayW_Dispose(ids);
            CkStringBuilderW_Dispose(baseUrl);
            CkStringBuilderW_Dispose(url);
            CkStringTableW_Dispose(changeTypes);
            CkJsonObjectW_Dispose(record);
            CkStringBuilderW_Dispose(eventPath);
            return;
        }

        success = CkJsonObjectW_UpdateNewObject(state,L"messages");
        if (success != TRUE) {
            wprintf(L"%s\n",CkJsonObjectW_lastErrorText(state));
            CkJsonObjectW_Dispose(token);
            CkHttpW_Dispose(http);
            CkHttpResponseW_Dispose(resp);
            CkJsonObjectW_Dispose(reply);
            CkFileAccessW_Dispose(files);
            CkJsonObjectW_Dispose(state);
            CkStringArrayW_Dispose(ids);
            CkStringBuilderW_Dispose(baseUrl);
            CkStringBuilderW_Dispose(url);
            CkStringTableW_Dispose(changeTypes);
            CkJsonObjectW_Dispose(record);
            CkStringBuilderW_Dispose(eventPath);
            return;
        }

        checkpoint = baseline;
        pageToken = L"";
        more = TRUE;
        while ((more == TRUE)) {
            CkStringBuilderW_SetString(url,L"https://gmail.googleapis.com/gmail/v1/users/me/messages?maxResults=500&includeSpamTrash=true&pageToken=");
            CkStringBuilderW_Append(url,CkHttpW_urlEncode(http,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);
                CkFileAccessW_Dispose(files);
                CkJsonObjectW_Dispose(state);
                CkStringArrayW_Dispose(ids);
                CkStringBuilderW_Dispose(baseUrl);
                CkStringBuilderW_Dispose(url);
                CkStringTableW_Dispose(changeTypes);
                CkJsonObjectW_Dispose(record);
                CkStringBuilderW_Dispose(eventPath);
                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);
                CkFileAccessW_Dispose(files);
                CkJsonObjectW_Dispose(state);
                CkStringArrayW_Dispose(ids);
                CkStringBuilderW_Dispose(baseUrl);
                CkStringBuilderW_Dispose(url);
                CkStringTableW_Dispose(changeTypes);
                CkJsonObjectW_Dispose(record);
                CkStringBuilderW_Dispose(eventPath);
                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);
                CkFileAccessW_Dispose(files);
                CkJsonObjectW_Dispose(state);
                CkStringArrayW_Dispose(ids);
                CkStringBuilderW_Dispose(baseUrl);
                CkStringBuilderW_Dispose(url);
                CkStringTableW_Dispose(changeTypes);
                CkJsonObjectW_Dispose(record);
                CkStringBuilderW_Dispose(eventPath);
                return;
            }

            m = 0;
            while ((m < CkJsonObjectW_SizeOfArray(reply,L"messages"))) {
                CkJsonObjectW_putI(reply,m);
                success = CkStringArrayW_Append(ids,CkJsonObjectW_stringOf(reply,L"messages[i].id"));
                if (success != TRUE) {
                    wprintf(L"%s\n",CkStringArrayW_lastErrorText(ids));
                    CkJsonObjectW_Dispose(token);
                    CkHttpW_Dispose(http);
                    CkHttpResponseW_Dispose(resp);
                    CkJsonObjectW_Dispose(reply);
                    CkFileAccessW_Dispose(files);
                    CkJsonObjectW_Dispose(state);
                    CkStringArrayW_Dispose(ids);
                    CkStringBuilderW_Dispose(baseUrl);
                    CkStringBuilderW_Dispose(url);
                    CkStringTableW_Dispose(changeTypes);
                    CkJsonObjectW_Dispose(record);
                    CkStringBuilderW_Dispose(eventPath);
                    return;
                }

                m = m + 1;
            }

            pageToken = L"";
            if (CkJsonObjectW_JsonTypeOf(reply,L"nextPageToken") == 1) {
                pageToken = CkJsonObjectW_stringOf(reply,L"nextPageToken");
            }

            more = pageToken != L"";
        }

    }

    messages = CkJsonObjectW_Create();
    success = CkJsonObjectW_ObjectOf2(state,L"messages",messages);
    if (success != TRUE) {
        wprintf(L"%s\n",CkJsonObjectW_lastErrorText(state));
        CkJsonObjectW_Dispose(token);
        CkHttpW_Dispose(http);
        CkHttpResponseW_Dispose(resp);
        CkJsonObjectW_Dispose(reply);
        CkFileAccessW_Dispose(files);
        CkJsonObjectW_Dispose(state);
        CkStringArrayW_Dispose(ids);
        CkStringBuilderW_Dispose(baseUrl);
        CkStringBuilderW_Dispose(url);
        CkStringTableW_Dispose(changeTypes);
        CkJsonObjectW_Dispose(record);
        CkStringBuilderW_Dispose(eventPath);
        CkJsonObjectW_Dispose(messages);
        return;
    }

    cachedMessage = CkJsonObjectW_Create();
    i = 0;
    while ((i < CkStringArrayW_getCount(ids))) {
        messageId = CkStringArrayW_getString(ids,i);
        CkStringBuilderW_SetString(url,L"https://gmail.googleapis.com/gmail/v1/users/me/messages/");
        CkStringBuilderW_Append(url,CkHttpW_urlEncode(http,messageId));
        CkStringBuilderW_Append(url,L"?format=minimal&fields=id,threadId,labelIds");
        success = CkHttpW_HttpNoBody(http,L"GET",CkStringBuilderW_getAsString(url),resp);
        if (CkHttpResponseW_getStatusCode(resp) == 404) {
            if (CkJsonObjectW_HasMember(messages,messageId) == TRUE) {
                success = CkJsonObjectW_Delete(messages,messageId);
                if (success != TRUE) {
                    wprintf(L"%s\n",CkJsonObjectW_lastErrorText(messages));
                    CkJsonObjectW_Dispose(token);
                    CkHttpW_Dispose(http);
                    CkHttpResponseW_Dispose(resp);
                    CkJsonObjectW_Dispose(reply);
                    CkFileAccessW_Dispose(files);
                    CkJsonObjectW_Dispose(state);
                    CkStringArrayW_Dispose(ids);
                    CkStringBuilderW_Dispose(baseUrl);
                    CkStringBuilderW_Dispose(url);
                    CkStringTableW_Dispose(changeTypes);
                    CkJsonObjectW_Dispose(record);
                    CkStringBuilderW_Dispose(eventPath);
                    CkJsonObjectW_Dispose(messages);
                    CkJsonObjectW_Dispose(cachedMessage);
                    return;
                }

            }

            wprintf(L"Removed from cache: %s\n",messageId);
        }
        else {
            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);
                CkFileAccessW_Dispose(files);
                CkJsonObjectW_Dispose(state);
                CkStringArrayW_Dispose(ids);
                CkStringBuilderW_Dispose(baseUrl);
                CkStringBuilderW_Dispose(url);
                CkStringTableW_Dispose(changeTypes);
                CkJsonObjectW_Dispose(record);
                CkStringBuilderW_Dispose(eventPath);
                CkJsonObjectW_Dispose(messages);
                CkJsonObjectW_Dispose(cachedMessage);
                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);
                CkFileAccessW_Dispose(files);
                CkJsonObjectW_Dispose(state);
                CkStringArrayW_Dispose(ids);
                CkStringBuilderW_Dispose(baseUrl);
                CkStringBuilderW_Dispose(url);
                CkStringTableW_Dispose(changeTypes);
                CkJsonObjectW_Dispose(record);
                CkStringBuilderW_Dispose(eventPath);
                CkJsonObjectW_Dispose(messages);
                CkJsonObjectW_Dispose(cachedMessage);
                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);
                CkFileAccessW_Dispose(files);
                CkJsonObjectW_Dispose(state);
                CkStringArrayW_Dispose(ids);
                CkStringBuilderW_Dispose(baseUrl);
                CkStringBuilderW_Dispose(url);
                CkStringTableW_Dispose(changeTypes);
                CkJsonObjectW_Dispose(record);
                CkStringBuilderW_Dispose(eventPath);
                CkJsonObjectW_Dispose(messages);
                CkJsonObjectW_Dispose(cachedMessage);
                return;
            }

            if (CkJsonObjectW_StringOfEquals(reply,L"id",messageId,TRUE) != TRUE) {
                wprintf(L"Unexpected message ID in the response.\n");
                CkJsonObjectW_Dispose(token);
                CkHttpW_Dispose(http);
                CkHttpResponseW_Dispose(resp);
                CkJsonObjectW_Dispose(reply);
                CkFileAccessW_Dispose(files);
                CkJsonObjectW_Dispose(state);
                CkStringArrayW_Dispose(ids);
                CkStringBuilderW_Dispose(baseUrl);
                CkStringBuilderW_Dispose(url);
                CkStringTableW_Dispose(changeTypes);
                CkJsonObjectW_Dispose(record);
                CkStringBuilderW_Dispose(eventPath);
                CkJsonObjectW_Dispose(messages);
                CkJsonObjectW_Dispose(cachedMessage);
                return;
            }

            success = CkJsonObjectW_UpdateNewObject(messages,messageId);
            if (success != TRUE) {
                wprintf(L"%s\n",CkJsonObjectW_lastErrorText(messages));
                CkJsonObjectW_Dispose(token);
                CkHttpW_Dispose(http);
                CkHttpResponseW_Dispose(resp);
                CkJsonObjectW_Dispose(reply);
                CkFileAccessW_Dispose(files);
                CkJsonObjectW_Dispose(state);
                CkStringArrayW_Dispose(ids);
                CkStringBuilderW_Dispose(baseUrl);
                CkStringBuilderW_Dispose(url);
                CkStringTableW_Dispose(changeTypes);
                CkJsonObjectW_Dispose(record);
                CkStringBuilderW_Dispose(eventPath);
                CkJsonObjectW_Dispose(messages);
                CkJsonObjectW_Dispose(cachedMessage);
                return;
            }

            success = CkJsonObjectW_ObjectOf2(messages,messageId,cachedMessage);
            if (success != TRUE) {
                wprintf(L"%s\n",CkJsonObjectW_lastErrorText(messages));
                CkJsonObjectW_Dispose(token);
                CkHttpW_Dispose(http);
                CkHttpResponseW_Dispose(resp);
                CkJsonObjectW_Dispose(reply);
                CkFileAccessW_Dispose(files);
                CkJsonObjectW_Dispose(state);
                CkStringArrayW_Dispose(ids);
                CkStringBuilderW_Dispose(baseUrl);
                CkStringBuilderW_Dispose(url);
                CkStringTableW_Dispose(changeTypes);
                CkJsonObjectW_Dispose(record);
                CkStringBuilderW_Dispose(eventPath);
                CkJsonObjectW_Dispose(messages);
                CkJsonObjectW_Dispose(cachedMessage);
                return;
            }

            success = CkJsonObjectW_Load(cachedMessage,CkJsonObjectW_emit(reply));
            if (success != TRUE) {
                wprintf(L"%s\n",CkJsonObjectW_lastErrorText(cachedMessage));
                CkJsonObjectW_Dispose(token);
                CkHttpW_Dispose(http);
                CkHttpResponseW_Dispose(resp);
                CkJsonObjectW_Dispose(reply);
                CkFileAccessW_Dispose(files);
                CkJsonObjectW_Dispose(state);
                CkStringArrayW_Dispose(ids);
                CkStringBuilderW_Dispose(baseUrl);
                CkStringBuilderW_Dispose(url);
                CkStringTableW_Dispose(changeTypes);
                CkJsonObjectW_Dispose(record);
                CkStringBuilderW_Dispose(eventPath);
                CkJsonObjectW_Dispose(messages);
                CkJsonObjectW_Dispose(cachedMessage);
                return;
            }

            wprintf(L"Cached message: %s\n",messageId);
        }

        i = i + 1;
    }

    success = CkJsonObjectW_UpdateString(state,L"historyId",checkpoint);
    if (success != TRUE) {
        wprintf(L"%s\n",CkJsonObjectW_lastErrorText(state));
        CkJsonObjectW_Dispose(token);
        CkHttpW_Dispose(http);
        CkHttpResponseW_Dispose(resp);
        CkJsonObjectW_Dispose(reply);
        CkFileAccessW_Dispose(files);
        CkJsonObjectW_Dispose(state);
        CkStringArrayW_Dispose(ids);
        CkStringBuilderW_Dispose(baseUrl);
        CkStringBuilderW_Dispose(url);
        CkStringTableW_Dispose(changeTypes);
        CkJsonObjectW_Dispose(record);
        CkStringBuilderW_Dispose(eventPath);
        CkJsonObjectW_Dispose(messages);
        CkJsonObjectW_Dispose(cachedMessage);
        return;
    }

    //  Prepare the complete replacement before moving the last committed file.
    success = CkJsonObjectW_WriteFile(state,L"gmail-sync.json.new");
    if (success != TRUE) {
        wprintf(L"Could not write the replacement file.\n");
        CkJsonObjectW_Dispose(token);
        CkHttpW_Dispose(http);
        CkHttpResponseW_Dispose(resp);
        CkJsonObjectW_Dispose(reply);
        CkFileAccessW_Dispose(files);
        CkJsonObjectW_Dispose(state);
        CkStringArrayW_Dispose(ids);
        CkStringBuilderW_Dispose(baseUrl);
        CkStringBuilderW_Dispose(url);
        CkStringTableW_Dispose(changeTypes);
        CkJsonObjectW_Dispose(record);
        CkStringBuilderW_Dispose(eventPath);
        CkJsonObjectW_Dispose(messages);
        CkJsonObjectW_Dispose(cachedMessage);
        return;
    }

    if (CkFileAccessW_FileExists(files,L"gmail-sync.json") == TRUE) {
        if (CkFileAccessW_FileExists(files,L"gmail-sync.json.previous") == TRUE) {
            success = CkFileAccessW_FileDelete(files,L"gmail-sync.json.previous");
            if (success != TRUE) {
                wprintf(L"Could not rotate the previous backup.\n");
                CkJsonObjectW_Dispose(token);
                CkHttpW_Dispose(http);
                CkHttpResponseW_Dispose(resp);
                CkJsonObjectW_Dispose(reply);
                CkFileAccessW_Dispose(files);
                CkJsonObjectW_Dispose(state);
                CkStringArrayW_Dispose(ids);
                CkStringBuilderW_Dispose(baseUrl);
                CkStringBuilderW_Dispose(url);
                CkStringTableW_Dispose(changeTypes);
                CkJsonObjectW_Dispose(record);
                CkStringBuilderW_Dispose(eventPath);
                CkJsonObjectW_Dispose(messages);
                CkJsonObjectW_Dispose(cachedMessage);
                return;
            }

        }

        success = CkFileAccessW_FileRename(files,L"gmail-sync.json",L"gmail-sync.json.previous");
        if (success != TRUE) {
            wprintf(L"Could not retain the previous complete file.\n");
            CkJsonObjectW_Dispose(token);
            CkHttpW_Dispose(http);
            CkHttpResponseW_Dispose(resp);
            CkJsonObjectW_Dispose(reply);
            CkFileAccessW_Dispose(files);
            CkJsonObjectW_Dispose(state);
            CkStringArrayW_Dispose(ids);
            CkStringBuilderW_Dispose(baseUrl);
            CkStringBuilderW_Dispose(url);
            CkStringTableW_Dispose(changeTypes);
            CkJsonObjectW_Dispose(record);
            CkStringBuilderW_Dispose(eventPath);
            CkJsonObjectW_Dispose(messages);
            CkJsonObjectW_Dispose(cachedMessage);
            return;
        }

    }

    success = CkFileAccessW_FileRename(files,L"gmail-sync.json.new",L"gmail-sync.json");
    if (success != TRUE) {
        wprintf(L"Could not commit the replacement. The previous complete file is retained.\n");
        CkJsonObjectW_Dispose(token);
        CkHttpW_Dispose(http);
        CkHttpResponseW_Dispose(resp);
        CkJsonObjectW_Dispose(reply);
        CkFileAccessW_Dispose(files);
        CkJsonObjectW_Dispose(state);
        CkStringArrayW_Dispose(ids);
        CkStringBuilderW_Dispose(baseUrl);
        CkStringBuilderW_Dispose(url);
        CkStringTableW_Dispose(changeTypes);
        CkJsonObjectW_Dispose(record);
        CkStringBuilderW_Dispose(eventPath);
        CkJsonObjectW_Dispose(messages);
        CkJsonObjectW_Dispose(cachedMessage);
        return;
    }

    wprintf(L"Synchronization committed. Cached messages: %d\n",CkJsonObjectW_getSize(messages));
    wprintf(L"Saved history ID: %s\n",checkpoint);


    CkJsonObjectW_Dispose(token);
    CkHttpW_Dispose(http);
    CkHttpResponseW_Dispose(resp);
    CkJsonObjectW_Dispose(reply);
    CkFileAccessW_Dispose(files);
    CkJsonObjectW_Dispose(state);
    CkStringArrayW_Dispose(ids);
    CkStringBuilderW_Dispose(baseUrl);
    CkStringBuilderW_Dispose(url);
    CkStringTableW_Dispose(changeTypes);
    CkJsonObjectW_Dispose(record);
    CkStringBuilderW_Dispose(eventPath);
    CkJsonObjectW_Dispose(messages);
    CkJsonObjectW_Dispose(cachedMessage);

    }