Gmailにてラベル名を指定せずに取得する

Question

前提・実現したいこと

GASでGmailを操作する際のメソッドについての質問です。
Gmailのラベル操作に関するメソッドにおいては、私の調べる限りではいずれの操作も”特定のラベル名を指定して” 取得や操作をするものしか用意されていないように思います。
私のやりたいことは「特定のスレッドに付加されているラベル名一覧を取得する」ということなのですが、このような操作を直接的に行えるメソッドは用意されていないのでしょうか？
GmailApp.getUserLabels() で全ラベルを取得し、ループで一つずつ一致を確認することで実装できるかもしれませんが、ラベル数が多い場合にはタイムアウトすることが懸念されるのでもっとスマートな方法を探しております。
熟練の皆様のお知恵をお貸しください。

Answer 1

もし該当するThreadをすでに取得できているならGmailThread.getLabels()でそのスレッドのラベルだけを取得することができます。

Class GmailThread | Apps Script | Google Developpers

GmailThread.getLabels()のドキュメントから例を引用します。

// 受信箱にある最初のスレッドについているラベルの名前をロギング
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var labels = firstThread.getLabels();
for (var i = 0; i < labels.length; i++) {
  Logger.log(labels[i].getName());
}

なお、GmailApp.getChatThreads()やGmailApp.getInboxThreads()など、下記ドキュメントの「Brief description」に「〜irrespective of labels」とあるものはラベルに関係なくスレッドを取得できる関数です。

Class GmailApp | Apps Script | Google Developpers

Comments

[taka.syuka]

ありがとうございます！やはり存在していたのですね！
本家本元のヘルプページもご紹介くださり感謝です。
ブックマークして今後活用したいと思います。