Sample code for 30+ languages & platforms
C++

Find a Label ID by Name

See more GMail REST API Examples

Lookup the ID of a GMail label by the label name.

Chilkat C++ Downloads

C++
#include <CkHttp.h>
#include <CkStringBuilder.h>
#include <CkJsonObject.h>

void ChilkatSample(void)
    {
    bool success = false;

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

    CkHttp http;
    http.put_AuthToken("GMAIL-ACCESS-TOKEN");

    const char *userId = "me";
    http.SetUrlVar("userId",userId);

    const char *url = "https://www.googleapis.com/gmail/v1/users/{$userId}/labels";

    // Get the list of GMail labels as JSON.
    CkStringBuilder sb;
    success = http.QuickGetSb(url,sb);
    if (success != true) {
        std::cout << http.lastErrorText() << "\r\n";
        return;
    }

    CkJsonObject json;
    json.LoadSb(sb);
    json.put_EmitCompact(false);
    std::cout << json.emit() << "\r\n";

    if (http.get_LastStatus() != 200) {
        std::cout << "Failed." << "\r\n";
        return;
    }

    // The JSON returned looks like this:
    // {
    //   "labels": [
    //     {
    //       "id": "Label_5",
    //       "name": "QA",
    //       "messageListVisibility": "show",
    //       "labelListVisibility": "labelShow",
    //       "type": "user"
    //     },
    //     {
    //       "id": "Label_21",
    //       "name": "[Gmail]/testFolder",
    //       "type": "user"
    //     },
    //     {
    //       "id": "CATEGORY_PERSONAL",
    //       "name": "CATEGORY_PERSONAL",
    //       "type": "system"
    //     },
    // 	...

    // The name of the label is generally known because it's what we visually see.
    // The id is what we need to get.  Assuming the name is unique,
    // find the JSON record having name=<desired name>
    // For example...
    CkJsonObject *jRecord = json.FindRecord("labels","name","QA",false);
    if (json.get_LastMethodSuccess() == true) {
        std::cout << "The id of QA is: " << jRecord->stringOf("id") << "\r\n";
        delete jRecord;
    }

    jRecord = json.FindRecord("labels","name","[Gmail]/testFolder",false);
    if (json.get_LastMethodSuccess() == true) {
        std::cout << "The id of [Gmail]/testFolder is: " << jRecord->stringOf("id") << "\r\n";
        delete jRecord;
    }

    jRecord = json.FindRecord("labels","name","questions",false);
    if (json.get_LastMethodSuccess() == true) {
        std::cout << "The id of questions is: " << jRecord->stringOf("id") << "\r\n";
        delete jRecord;
    }

    // Output:

    // The id of QA is: Label_5
    // The id of [Gmail]/testFolder is: Label_21
    // The id of questions is: Label_43
    }