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

Send an email with the Gmail API

See more GMail REST API Examples

Live send. Replace the sender and recipient with addresses you control. Build a plain-text message, encode its complete MIME bytes as base64url in the raw field, and save the returned Gmail message ID for later use. The ID identifies the message in the mailbox.

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

void ChilkatSample(void)
    {
    BOOL success;
    HCkJsonObjectW token;
    HCkHttpW http;
    HCkHttpResponseW resp;
    HCkJsonObjectW reply;
    HCkEmailW email;
    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();
    email = CkEmailW_Create();
    //  Use the authorized mailbox or one of its configured send-as addresses.
    CkEmailW_putFrom(email,L"Sender <sender@example.com>");
    success = CkEmailW_AddTo(email,L"Recipient",L"recipient@example.net");
    if (success != TRUE) {
        wprintf(L"%s\n",CkEmailW_lastErrorText(email));
        CkJsonObjectW_Dispose(token);
        CkHttpW_Dispose(http);
        CkHttpResponseW_Dispose(resp);
        CkJsonObjectW_Dispose(reply);
        CkEmailW_Dispose(email);
        return;
    }

    CkEmailW_putSubject(email,L"Sample message");
    CkEmailW_putCharset(email,L"utf-8");
    CkEmailW_putBody(email,L"Hello from the Gmail API.");
    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);
        CkEmailW_Dispose(email);
        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);
        CkEmailW_Dispose(email);
        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);
        CkEmailW_Dispose(email);
        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);
        CkEmailW_Dispose(email);
        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);
        CkEmailW_Dispose(email);
        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);
        CkEmailW_Dispose(email);
        CkBinDataW_Dispose(mime);
        CkJsonObjectW_Dispose(request);
        return;
    }

    wprintf(L"Gmail message ID: %s\n",CkJsonObjectW_stringOf(reply,L"id"));


    CkJsonObjectW_Dispose(token);
    CkHttpW_Dispose(http);
    CkHttpResponseW_Dispose(resp);
    CkJsonObjectW_Dispose(reply);
    CkEmailW_Dispose(email);
    CkBinDataW_Dispose(mime);
    CkJsonObjectW_Dispose(request);

    }