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

Create a user label in Gmail

See more GMail REST API Examples

Create a label with a chosen display name. Gmail returns the ID used to apply the label to messages. If a user label with that name already exists, look up its ID instead of creating a duplicate. System label names are reserved.

Authorize the application with https://www.googleapis.com/auth/gmail.labels. The example reads the access token from gmail-token.json in a private working directory. Authorize a desktop application.

Google documentation

Chilkat CkJava Downloads

CkJava
import com.chilkatsoft.*;

public class ChilkatExample {

  static {
    try {
        System.loadLibrary("chilkat");
    } catch (UnsatisfiedLinkError e) {
      System.err.println("Native code library failed to load.\n" + e);
      System.exit(1);
    }
  }

  public static void main(String argv[])
  {
    boolean success = false;

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

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

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

    CkHttp http = new CkHttp();
    http.put_RequireSslCertVerify(true);
    http.put_AuthToken(token.stringOf("access_token"));
    CkHttpResponse resp = new CkHttpResponse();
    CkJsonObject reply = new CkJsonObject();
    CkJsonObject request = new CkJsonObject();
    request.UpdateString("name","To review");
    request.UpdateString("labelListVisibility","labelShow");
    request.UpdateString("messageListVisibility","show");
    success = http.HttpJson("POST","https://gmail.googleapis.com/gmail/v1/users/me/labels",request,"application/json",resp);
    if (resp.get_StatusCode() == 0) {
        System.out.println("Gmail did not return an HTTP response.");
        return;
        }

    if ((success != true) || (resp.get_StatusCode() < 200) || (resp.get_StatusCode() >= 300)) {
        System.out.println("Gmail HTTP " + resp.get_StatusCode());
        success = reply.Load(resp.bodyStr());
        if (success == true) {
            System.out.println(reply.stringOf("error.message"));
            }

        return;
        }

    success = reply.Load(resp.bodyStr());
    if (success != true) {
        System.out.println("Expected a Gmail JSON response.");
        return;
        }

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

    System.out.println("Created label: " + reply.stringOf("name"));
    System.out.println("Label ID: " + reply.stringOf("id"));
  }
}