Sample code for 30+ languages & platforms
Zig

Send GMail with Attachments

See more GMail REST API Examples

Demonstrates how to send an email containing attachments using the GMail REST API.

Chilkat Zig Downloads

Zig
const std = @import("std");
const chilkat = @import("chilkat");

pub fn main(init: std.process.Init) !void {
    const alloc = init.arena.allocator();

    // This example requires the Chilkat API to have been previously unlocked.
    // See Global Unlock Sample for sample code.

    // Use the Chilkat Email API to create or load an email.
    const email = try chilkat.Email.init();
    defer email.deinit();

    // The From name/address don't need to be specified.
    // GMail will automatically use your Gmail address if the following 2 lines are omitted.
    email.setFromName("My Name");
    email.setFromAddress("my_account_name@gmail.com");

    email.addTo("John Smith", "somebody@somewhere.com") catch {};
    // To add more recipients, make additional calls to AddTo or AddCC, one per recipient...

    email.setSubject("This is a test GMail email created using Chilkat.");
    email.setCharset("utf-8");
    email.addPlainTextAlternativeBody("This is a test") catch {};

    // Create an HTML email body with an embedded image.
    const cid = try email.addRelatedFile(alloc, "qa_data/jpg/starfish.jpg");
    const sb_html = try chilkat.StringBuilder.init();
    defer sb_html.deinit();
    sb_html.append("<html><body>This is a <b>test</b><br><img src=\"cid:STARFISH_CID\"/></body></html>") catch {};
    _ = sb_html.replace("STARFISH_CID", cid);

    email.addHtmlAlternativeBody(try sb_html.getAsString(alloc)) catch {};

    // Add some attachments..
    var mime_type: [:0]const u8 = email.addFileAttachment(alloc, "qa_data/helloWorld.pdf") catch {
        std.debug.print("Failed to add PDF attachment.\n", .{});
        return;
    };

    mime_type = email.addFileAttachment(alloc, "qa_data/msword/sample2.docx") catch {
        std.debug.print("Failed to add MS-Word attachment.\n", .{});
        return;
    };

    // OK.. we now have an HTML email with 2 attachments..
    const sb_mime = try chilkat.StringBuilder.init();
    defer sb_mime.deinit();
    email.getMimeSb(sb_mime) catch {};

    // Send the email.  (GMail has a 5MB limit on the total email size.)
    const http = try chilkat.Http.init();
    defer http.deinit();
    http.setAuthToken("GMAIL-ACCESS-TOKEN");

    // Send using the simple upload request for the Gmail API
    const url = "https://www.googleapis.com/upload/gmail/v1/users/me/messages/send?uploadType=media";

    const resp = try chilkat.HttpResponse.init();
    defer resp.deinit();
    http.httpSb("POST", url, sb_mime, "utf-8", "message/rfc822", resp) catch {
        std.debug.print("{s}\n", .{try http.getLastErrorText(alloc)});
        return;
    };

    // A status code of 200 indicates success.
    std.debug.print("Response status code: {d}\n", .{resp.getStatusCode()});
    std.debug.print("Response body:\n", .{});
    std.debug.print("{s}\n", .{try resp.getBodyStr(alloc)});

    // The response body contains JSON.
    // Use the online tool at Generate JSON Parsing Code
    // to generate JSON parsing code.

    // A sample successful JSON response:

    // {
    //  "id": "166f0d4ac39e50bf",
    //  "threadId": "166f0d4ac39e50bf",
    //  "labelIds": [
    //   "SENT"
    //  ]
    // }
}