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

List Gmail labels and their IDs

See more GMail REST API Examples

Read the mailbox label catalog and display each label’s type, ID, and name. System labels include INBOX and TRASH. Use the returned ID in message modification requests. Fetch an individual label if you also need its message or thread counts.

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();
    success = http.HttpNoBody("GET","https://gmail.googleapis.com/gmail/v1/users/me/labels",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("labels") != 4) {
        System.out.println("Expected a list of labels.");
        return;
        }

    int i = 0;
    while ((i < reply.SizeOfArray("labels"))) {
        reply.put_I(i);
        System.out.println(reply.stringOf("labels[i].type") + "  " + reply.stringOf("labels[i].id") + "  " + reply.stringOf("labels[i].name"));
        i = i+1;
        }
  }
}