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

Send a Gmail message with a file attachment

See more GMail REST API Examples

Live send. Prepare a small file named attachment.pdf and replace the sample addresses. Add the file as a MIME attachment and upload the complete message as message/rfc822. The response is a Gmail Message. For larger uploads or unreliable connections, see Google’s resumable upload guidance.

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 C Downloads

C
#include <C_CkJsonObject.h>
#include <C_CkHttp.h>
#include <C_CkHttpResponse.h>
#include <C_CkEmail.h>
#include <C_CkBinData.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkJsonObject token;
    HCkHttp http;
    HCkHttpResponse resp;
    HCkJsonObject reply;
    HCkEmail email;
    HCkBinData fileData;
    HCkBinData mime;

    success = FALSE;

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

    token = CkJsonObject_Create();
    success = CkJsonObject_LoadFile(token,"gmail-token.json");
    if (success != TRUE) {
        printf("Could not read gmail-token.json from the private working directory.\n");
        CkJsonObject_Dispose(token);
        return;
    }

    if ((CkJsonObject_JsonTypeOf(token,"access_token") != 1) || (CkJsonObject_StringOfEquals(token,"access_token","",TRUE) == TRUE)) {
        printf("An OAuth access token is required.\n");
        CkJsonObject_Dispose(token);
        return;
    }

    http = CkHttp_Create();
    CkHttp_putRequireSslCertVerify(http,TRUE);
    CkHttp_putAuthToken(http,CkJsonObject_stringOf(token,"access_token"));
    resp = CkHttpResponse_Create();
    reply = CkJsonObject_Create();
    email = CkEmail_Create();
    //  Use the authorized mailbox or one of its configured send-as addresses.
    CkEmail_putFrom(email,"Sender <sender@example.com>");
    success = CkEmail_AddTo(email,"Recipient","recipient@example.net");
    if (success != TRUE) {
        printf("%s\n",CkEmail_lastErrorText(email));
        CkJsonObject_Dispose(token);
        CkHttp_Dispose(http);
        CkHttpResponse_Dispose(resp);
        CkJsonObject_Dispose(reply);
        CkEmail_Dispose(email);
        return;
    }

    CkEmail_putSubject(email,"Sample message");
    CkEmail_putCharset(email,"utf-8");
    CkEmail_putBody(email,"Hello from the Gmail API.");
    fileData = CkBinData_Create();
    success = CkBinData_LoadFile(fileData,"attachment.pdf");
    if (success != TRUE) {
        printf("Could not read attachment.pdf.\n");
        CkJsonObject_Dispose(token);
        CkHttp_Dispose(http);
        CkHttpResponse_Dispose(resp);
        CkJsonObject_Dispose(reply);
        CkEmail_Dispose(email);
        CkBinData_Dispose(fileData);
        return;
    }

    success = CkEmail_AddAttachmentBd(email,"attachment.pdf",fileData,"application/pdf");
    if (success != TRUE) {
        printf("%s\n",CkEmail_lastErrorText(email));
        CkJsonObject_Dispose(token);
        CkHttp_Dispose(http);
        CkHttpResponse_Dispose(resp);
        CkJsonObject_Dispose(reply);
        CkEmail_Dispose(email);
        CkBinData_Dispose(fileData);
        return;
    }

    mime = CkBinData_Create();
    success = CkEmail_GetMimeBd(email,mime);
    if (success != TRUE) {
        printf("%s\n",CkEmail_lastErrorText(email));
        CkJsonObject_Dispose(token);
        CkHttp_Dispose(http);
        CkHttpResponse_Dispose(resp);
        CkJsonObject_Dispose(reply);
        CkEmail_Dispose(email);
        CkBinData_Dispose(fileData);
        CkBinData_Dispose(mime);
        return;
    }

    success = CkHttp_HttpBd(http,"POST","https://gmail.googleapis.com/upload/gmail/v1/users/me/messages/send?uploadType=media",mime,"message/rfc822",resp);
    if (CkHttpResponse_getStatusCode(resp) == 0) {
        printf("Gmail did not return an HTTP response.\n");
        CkJsonObject_Dispose(token);
        CkHttp_Dispose(http);
        CkHttpResponse_Dispose(resp);
        CkJsonObject_Dispose(reply);
        CkEmail_Dispose(email);
        CkBinData_Dispose(fileData);
        CkBinData_Dispose(mime);
        return;
    }

    if ((success != TRUE) || (CkHttpResponse_getStatusCode(resp) < 200) || (CkHttpResponse_getStatusCode(resp) >= 300)) {
        printf("Gmail HTTP %d\n",CkHttpResponse_getStatusCode(resp));
        success = CkJsonObject_Load(reply,CkHttpResponse_bodyStr(resp));
        if (success == TRUE) {
            printf("%s\n",CkJsonObject_stringOf(reply,"error.message"));
        }

        CkJsonObject_Dispose(token);
        CkHttp_Dispose(http);
        CkHttpResponse_Dispose(resp);
        CkJsonObject_Dispose(reply);
        CkEmail_Dispose(email);
        CkBinData_Dispose(fileData);
        CkBinData_Dispose(mime);
        return;
    }

    success = CkJsonObject_Load(reply,CkHttpResponse_bodyStr(resp));
    if (success != TRUE) {
        printf("Expected a Gmail JSON response.\n");
        CkJsonObject_Dispose(token);
        CkHttp_Dispose(http);
        CkHttpResponse_Dispose(resp);
        CkJsonObject_Dispose(reply);
        CkEmail_Dispose(email);
        CkBinData_Dispose(fileData);
        CkBinData_Dispose(mime);
        return;
    }

    if ((CkJsonObject_JsonTypeOf(reply,"id") != 1) || (CkJsonObject_StringOfEquals(reply,"id","",TRUE) == TRUE)) {
        printf("Expected id in the response.\n");
        CkJsonObject_Dispose(token);
        CkHttp_Dispose(http);
        CkHttpResponse_Dispose(resp);
        CkJsonObject_Dispose(reply);
        CkEmail_Dispose(email);
        CkBinData_Dispose(fileData);
        CkBinData_Dispose(mime);
        return;
    }

    printf("Gmail message ID: %s\n",CkJsonObject_stringOf(reply,"id"));


    CkJsonObject_Dispose(token);
    CkHttp_Dispose(http);
    CkHttpResponse_Dispose(resp);
    CkJsonObject_Dispose(reply);
    CkEmail_Dispose(email);
    CkBinData_Dispose(fileData);
    CkBinData_Dispose(mime);

    }