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

Reply to a message in its existing Gmail thread

See more GMail REST API Examples

Live send. Supply the Gmail ID of a received message and use an authorized From address. Fetch its raw MIME so Chilkat.Email can parse encoded headers and recipient addresses. Send a plain-text reply to Reply-To, falling back to From. The reply goes to the original sender or reply address.

The request supplies Gmail’s threadId and matching Subject. The MIME In-Reply-To contains the original RFC Message-ID. References preserves the conversation ancestry and appends that Message-ID. Select a message with a valid Message-ID and review its recipient before running this sending example. Authorize both gmail.readonly and gmail.send, or use gmail.modify as shown below.

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_CkBinDataW.h>
#include <C_CkEmailW.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkJsonObjectW token;
    HCkHttpW http;
    HCkHttpResponseW resp;
    HCkJsonObjectW reply;
    HCkStringBuilderW url;
    const wchar_t *threadId;
    HCkBinDataW originalMime;
    HCkEmailW original;
    const wchar_t *messageIdHeader;
    HCkEmailW email;
    const wchar_t *replyAddress;
    HCkStringBuilderW references;
    const wchar_t *previousReferences;
    HCkBinDataW mime;
    HCkJsonObjectW request;

    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();
    url = CkStringBuilderW_Create();
    CkStringBuilderW_Append(url,L"https://gmail.googleapis.com/gmail/v1/users/me/messages/");
    CkStringBuilderW_Append(url,L"GMAIL_MESSAGE_ID");
    CkStringBuilderW_Append(url,L"?format=raw");
    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(url);
        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(url);
        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(url);
        return;
    }

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

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

    threadId = CkJsonObjectW_stringOf(reply,L"threadId");
    originalMime = CkBinDataW_Create();
    success = CkJsonObjectW_BytesOf(reply,L"raw",L"base64url",originalMime);
    if (success != TRUE) {
        wprintf(L"%s\n",CkJsonObjectW_lastErrorText(reply));
        CkJsonObjectW_Dispose(token);
        CkHttpW_Dispose(http);
        CkHttpResponseW_Dispose(resp);
        CkJsonObjectW_Dispose(reply);
        CkStringBuilderW_Dispose(url);
        CkBinDataW_Dispose(originalMime);
        return;
    }

    original = CkEmailW_Create();
    success = CkEmailW_SetFromMimeBd(original,originalMime);
    if (success != TRUE) {
        wprintf(L"%s\n",CkEmailW_lastErrorText(original));
        CkJsonObjectW_Dispose(token);
        CkHttpW_Dispose(http);
        CkHttpResponseW_Dispose(resp);
        CkJsonObjectW_Dispose(reply);
        CkStringBuilderW_Dispose(url);
        CkBinDataW_Dispose(originalMime);
        CkEmailW_Dispose(original);
        return;
    }

    messageIdHeader = CkEmailW_getHeaderField(original,L"Message-ID");
    if ((CkEmailW_getLastMethodSuccess(original) != TRUE) || (messageIdHeader == L"")) {
        wprintf(L"The original message needs a Message-ID for this threaded reply.\n");
        CkJsonObjectW_Dispose(token);
        CkHttpW_Dispose(http);
        CkHttpResponseW_Dispose(resp);
        CkJsonObjectW_Dispose(reply);
        CkStringBuilderW_Dispose(url);
        CkBinDataW_Dispose(originalMime);
        CkEmailW_Dispose(original);
        return;
    }

    email = CkEmailW_Create();
    CkEmailW_putFrom(email,L"Sender <sender@example.com>");
    //  Use the parsed Reply-To mailbox list when present, otherwise use From.
    replyAddress = CkEmailW_replyTo(original);
    if (replyAddress == L"") {
        replyAddress = CkEmailW_ck_from(original);
    }

    success = CkEmailW_AddMultipleTo(email,replyAddress);
    if (success != TRUE) {
        wprintf(L"%s\n",CkEmailW_lastErrorText(email));
        CkJsonObjectW_Dispose(token);
        CkHttpW_Dispose(http);
        CkHttpResponseW_Dispose(resp);
        CkJsonObjectW_Dispose(reply);
        CkStringBuilderW_Dispose(url);
        CkBinDataW_Dispose(originalMime);
        CkEmailW_Dispose(original);
        CkEmailW_Dispose(email);
        return;
    }

    if (CkEmailW_getNumTo(email) == 0) {
        wprintf(L"The original message has no usable reply address.\n");
        CkJsonObjectW_Dispose(token);
        CkHttpW_Dispose(http);
        CkHttpResponseW_Dispose(resp);
        CkJsonObjectW_Dispose(reply);
        CkStringBuilderW_Dispose(url);
        CkBinDataW_Dispose(originalMime);
        CkEmailW_Dispose(original);
        CkEmailW_Dispose(email);
        return;
    }

    CkEmailW_putSubject(email,CkEmailW_subject(original));
    CkEmailW_putCharset(email,L"utf-8");
    CkEmailW_putBody(email,L"Thank you for your message.");
    CkEmailW_AddHeaderField(email,L"In-Reply-To",messageIdHeader);
    references = CkStringBuilderW_Create();
    previousReferences = CkEmailW_getHeaderField(original,L"References");
    if ((CkEmailW_getLastMethodSuccess(original) == TRUE) && (previousReferences != L"")) {
        CkStringBuilderW_Append(references,previousReferences);
        CkStringBuilderW_Append(references,L" ");
    }

    CkStringBuilderW_Append(references,messageIdHeader);
    CkEmailW_AddHeaderField(email,L"References",CkStringBuilderW_getAsString(references));
    mime = CkBinDataW_Create();
    success = CkEmailW_GetMimeBd(email,mime);
    if (success != TRUE) {
        wprintf(L"%s\n",CkEmailW_lastErrorText(email));
        CkJsonObjectW_Dispose(token);
        CkHttpW_Dispose(http);
        CkHttpResponseW_Dispose(resp);
        CkJsonObjectW_Dispose(reply);
        CkStringBuilderW_Dispose(url);
        CkBinDataW_Dispose(originalMime);
        CkEmailW_Dispose(original);
        CkEmailW_Dispose(email);
        CkStringBuilderW_Dispose(references);
        CkBinDataW_Dispose(mime);
        return;
    }

    request = CkJsonObjectW_Create();
    success = CkJsonObjectW_UpdateBd(request,L"raw",L"base64url",mime);
    if (success != TRUE) {
        wprintf(L"%s\n",CkJsonObjectW_lastErrorText(request));
        CkJsonObjectW_Dispose(token);
        CkHttpW_Dispose(http);
        CkHttpResponseW_Dispose(resp);
        CkJsonObjectW_Dispose(reply);
        CkStringBuilderW_Dispose(url);
        CkBinDataW_Dispose(originalMime);
        CkEmailW_Dispose(original);
        CkEmailW_Dispose(email);
        CkStringBuilderW_Dispose(references);
        CkBinDataW_Dispose(mime);
        CkJsonObjectW_Dispose(request);
        return;
    }

    success = CkJsonObjectW_UpdateString(request,L"threadId",threadId);
    if (success != TRUE) {
        wprintf(L"%s\n",CkJsonObjectW_lastErrorText(request));
        CkJsonObjectW_Dispose(token);
        CkHttpW_Dispose(http);
        CkHttpResponseW_Dispose(resp);
        CkJsonObjectW_Dispose(reply);
        CkStringBuilderW_Dispose(url);
        CkBinDataW_Dispose(originalMime);
        CkEmailW_Dispose(original);
        CkEmailW_Dispose(email);
        CkStringBuilderW_Dispose(references);
        CkBinDataW_Dispose(mime);
        CkJsonObjectW_Dispose(request);
        return;
    }

    success = CkHttpW_HttpJson(http,L"POST",L"https://gmail.googleapis.com/gmail/v1/users/me/messages/send",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);
        CkStringBuilderW_Dispose(url);
        CkBinDataW_Dispose(originalMime);
        CkEmailW_Dispose(original);
        CkEmailW_Dispose(email);
        CkStringBuilderW_Dispose(references);
        CkBinDataW_Dispose(mime);
        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);
        CkStringBuilderW_Dispose(url);
        CkBinDataW_Dispose(originalMime);
        CkEmailW_Dispose(original);
        CkEmailW_Dispose(email);
        CkStringBuilderW_Dispose(references);
        CkBinDataW_Dispose(mime);
        CkJsonObjectW_Dispose(request);
        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(url);
        CkBinDataW_Dispose(originalMime);
        CkEmailW_Dispose(original);
        CkEmailW_Dispose(email);
        CkStringBuilderW_Dispose(references);
        CkBinDataW_Dispose(mime);
        CkJsonObjectW_Dispose(request);
        return;
    }

    if ((CkJsonObjectW_JsonTypeOf(reply,L"id") != 1) || (CkJsonObjectW_StringOfEquals(reply,L"id",L"",TRUE) == TRUE)) {
        wprintf(L"Expected id in the response.\n");
        CkJsonObjectW_Dispose(token);
        CkHttpW_Dispose(http);
        CkHttpResponseW_Dispose(resp);
        CkJsonObjectW_Dispose(reply);
        CkStringBuilderW_Dispose(url);
        CkBinDataW_Dispose(originalMime);
        CkEmailW_Dispose(original);
        CkEmailW_Dispose(email);
        CkStringBuilderW_Dispose(references);
        CkBinDataW_Dispose(mime);
        CkJsonObjectW_Dispose(request);
        return;
    }

    wprintf(L"Sent reply ID: %s\n",CkJsonObjectW_stringOf(reply,L"id"));
    wprintf(L"Thread ID: %s\n",CkJsonObjectW_stringOf(reply,L"threadId"));


    CkJsonObjectW_Dispose(token);
    CkHttpW_Dispose(http);
    CkHttpResponseW_Dispose(resp);
    CkJsonObjectW_Dispose(reply);
    CkStringBuilderW_Dispose(url);
    CkBinDataW_Dispose(originalMime);
    CkEmailW_Dispose(original);
    CkEmailW_Dispose(email);
    CkStringBuilderW_Dispose(references);
    CkBinDataW_Dispose(mime);
    CkJsonObjectW_Dispose(request);

    }