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

Mark a Gmail message as read or archive it

See more GMail REST API Examples

Choose read or archive and supply a Gmail message ID. Marking a message as read removes UNREAD. Archiving removes INBOX while keeping the message available elsewhere in the mailbox. Each run performs the selected action on one message. Removing a label that is already absent is safe to repeat.

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

Note
This example is intended for running within a Chilkat.Js embedded JavaScript engine. All Chilkat JavaScript examples require Chilkat v11.4.0 or greater.
JavaScript
var success = false;

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

var token = new CkJsonObject();
success = token.LoadFile("gmail-token.json");
if (success !== true) {
    console.log("Could not read gmail-token.json from the private working directory.");
    return;
}

if ((token.JsonTypeOf("access_token") !== 1) || (token.StringOfEquals("access_token","",true) == true)) {
    console.log("An OAuth access token is required.");
    return;
}

var http = new CkHttp();
http.RequireSslCertVerify = true;
http.AuthToken = token.StringOf("access_token");
var resp = new CkHttpResponse();
var reply = new CkJsonObject();
var action = "read";
var request = new CkJsonObject();
if (action == "read") {
    success = request.UpdateString("removeLabelIds[0]","UNREAD");
    if (success !== true) {
        console.log(request.LastErrorText);
        return;
    }

}
else {
    if (action !== "archive") {
        console.log("Choose read or archive.");
        return;
    }

    success = request.UpdateString("removeLabelIds[0]","INBOX");
    if (success !== true) {
        console.log(request.LastErrorText);
        return;
    }

}

var url = new CkStringBuilder();
url.Append("https://gmail.googleapis.com/gmail/v1/users/me/messages/");
url.Append("GMAIL_MESSAGE_ID");
url.Append("/modify");
success = http.HttpJson("POST",url.GetAsString(),request,"application/json",resp);
if (resp.StatusCode == 0) {
    console.log("Gmail did not return an HTTP response.");
    return;
}

if ((success !== true) || (resp.StatusCode < 200) || (resp.StatusCode >= 300)) {
    console.log("Gmail HTTP " + resp.StatusCode);
    success = reply.Load(resp.BodyStr);
    if (success == true) {
        console.log(reply.StringOf("error.message"));
    }

    return;
}

success = reply.Load(resp.BodyStr);
if (success !== true) {
    console.log("Expected a Gmail JSON response.");
    return;
}

if ((reply.JsonTypeOf("id") !== 1) || (reply.StringOfEquals("id","",true) == true)) {
    console.log("Expected id in the response.");
    return;
}

console.log("Completed " + action + " for message " + reply.StringOf("id"));