Class GmailLabel

GmailLabel

यह लेबल, उपयोगकर्ता के Gmail खाते में बनाया गया होता है.

तरीके

तरीकारिटर्न टाइपसंक्षिप्त विवरण
addToThread(thread)GmailLabelयह लेबल, दिए गए थ्रेड में जोड़ता है और थ्रेड को रीफ़्रेश करने के लिए मजबूर करता है (GmailThread.refresh()).
addToThreads(threads)GmailLabelयह लेबल, दिए गए थ्रेड में जोड़ता है और थ्रेड को रीफ़्रेश करने के लिए मजबूर करता है.
deleteLabel()voidयह लेबल मिटाता है.
getId()Stringयह लेबल का आईडी दिखाता है.
getName()Stringयह लेबल का नाम दिखाता है.
getThreads()GmailThread[]यह उन थ्रेड को दिखाता है जिन्हें इस लेबल से मार्क किया गया है.
getThreads(start, max)GmailThread[]यह इस लेबल से मार्क किए गए थ्रेड की रेंज दिखाता है.
getUnreadCount()Integerयह इस लेबल से टैग किए गए, नहीं पढ़े गए थ्रेड की संख्या दिखाता है.
removeFromThread(thread)GmailLabelयह लेबल, दिए गए थ्रेड से हटाता है और थ्रेड को रीफ़्रेश करने के लिए मजबूर करता है.
removeFromThreads(threads)GmailLabelयह लेबल, दिए गए थ्रेड से हटाता है और थ्रेड को रीफ़्रेश करने के लिए मजबूर करता है.

ज़्यादा जानकारी वाला दस्तावेज़

addToThread(thread)

यह लेबल, दिए गए थ्रेड में जोड़ता है और थ्रेड को रीफ़्रेश करने के लिए मजबूर करता है (GmailThread.refresh()).

// label the first thread in the inbox with the label MyLabel
const label = GmailApp.getUserLabelByName('MyLabel');
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
label.addToThread(firstThread);

पैरामीटर

नामटाइपब्यौरा
threadGmailThreadवह थ्रेड जिसे लेबल करना है.

वापसी का टिकट

GmailLabel — यह लेबल, चेन बनाने के लिए.

अनुमति देना

इस तरीके का इस्तेमाल करने वाले स्क्रिप्ट के लिए, यहां दिए गए एक या उससे ज़्यादा स्कोप या इससे जुड़े REST API से सही स्कोप के साथ अनुमति की ज़रूरत होती है:

  • https://mail.google.com/

इन्हें भी देखें


addToThreads(threads)

यह लेबल, दिए गए थ्रेड में जोड़ता है और थ्रेड को रीफ़्रेश करने के लिए मजबूर करता है. हर बैच में, ज़्यादा से ज़्यादा 100 थ्रेड के लिए लेबल जोड़े जा सकते हैं.

// label the first three threads in the inbox with the label MyLabel
const label = GmailApp.getUserLabelByName('MyLabel');
const threads = GmailApp.getInboxThreads(0, 3);
label.addToThreads(threads);

पैरामीटर

नामटाइपब्यौरा
threadsGmailThread[]लेबल किए जाने वाले थ्रेड की सूची.

वापसी का टिकट

GmailLabel — यह लेबल, चेन बनाने के लिए.

अनुमति देना

इस तरीके का इस्तेमाल करने वाले स्क्रिप्ट के लिए, यहां दिए गए एक या उससे ज़्यादा स्कोप या इससे जुड़े REST API से सही स्कोप के साथ अनुमति की ज़रूरत होती है:

  • https://mail.google.com/

इन्हें भी देखें


deleteLabel()

यह लेबल मिटाता है.

const label = GmailApp.getUserLabelByName('MyLabel');
label.deleteLabel();

थ्रॉ

Error — अगर लेबल मिटाया नहीं जा सकता

अनुमति देना

इस तरीके का इस्तेमाल करने वाले स्क्रिप्ट के लिए, यहां दिए गए एक या उससे ज़्यादा स्कोप या इससे जुड़े REST API से सही स्कोप के साथ अनुमति की ज़रूरत होती है:

  • https://mail.google.com/

इन्हें भी देखें


getId()

यह लेबल का आईडी दिखाता है.

const label = GmailApp.getUserLabelByName('MyLabel');
console.log(label.getId());

वापसी का टिकट

String — लेबल का आईडी.

अनुमति देना

इस तरीके का इस्तेमाल करने वाले स्क्रिप्ट के लिए, यहां दिए गए एक या उससे ज़्यादा स्कोप या इससे जुड़े REST API से सही स्कोप के साथ अनुमति की ज़रूरत होती है:

  • https://mail.google.com/

getName()

यह लेबल का नाम दिखाता है.

const label = GmailApp.getUserLabelByName('MyLabel');
Logger.log(label.getName());  // logs MyLabel

वापसी का टिकट

String — लेबल का नाम.

अनुमति देना

इस तरीके का इस्तेमाल करने वाले स्क्रिप्ट के लिए, यहां दिए गए एक या उससे ज़्यादा स्कोप या इससे जुड़े REST API से सही स्कोप के साथ अनुमति की ज़रूरत होती है:

  • https://mail.google.com/

getThreads()

यह उन थ्रेड को दिखाता है जिन्हें इस लेबल से मार्क किया गया है.

अगर सभी थ्रेड का साइज़ इतना बड़ा है कि सिस्टम उसे हैंडल नहीं कर सकता, तो यह कॉल काम नहीं करता. अगर थ्रेड का साइज़ पता नहीं है और वह बहुत बड़ा हो सकता है, तो कृपया getThreads(start, max) का इस्तेमाल करें. साथ ही, हर कॉल में वापस पाने के लिए थ्रेड की रेंज तय करें.

// Log the subject lines of the threads labeled with MyLabel
const label = GmailApp.getUserLabelByName('MyLabel');
const threads = label.getThreads();
for (let i = 0; i < threads.length; i++) {
  Logger.log(threads[i].getFirstMessageSubject());
}

वापसी का टिकट

GmailThread[] — इस लेबल से मार्क किए गए थ्रेड की सूची.

अनुमति देना

इस तरीके का इस्तेमाल करने वाले स्क्रिप्ट के लिए, यहां दिए गए एक या उससे ज़्यादा स्कोप या इससे जुड़े REST API से सही स्कोप के साथ अनुमति की ज़रूरत होती है:

  • https://mail.google.com/

getThreads(start, max)

यह इस लेबल से मार्क किए गए थ्रेड की रेंज दिखाता है.

// log the subject lines of up to the first 30 threads with the label MyLabel
const label = GmailApp.getUserLabelByName('MyLabel');
const threads = label.getThreads(0, 30);
for (let i = 0; i < threads.length; i++) {
  Logger.log(threads[i].getFirstMessageSubject());
}

पैरामीटर

नामटाइपब्यौरा
startIntegerशुरुआती थ्रेड का इंडेक्स.
maxIntegerवापस पाने के लिए थ्रेड की ज़्यादा से ज़्यादा संख्या.

वापसी का टिकट

GmailThread[] — इस लेबल से मार्क किए गए थ्रेड की सूची.

अनुमति देना

इस तरीके का इस्तेमाल करने वाले स्क्रिप्ट के लिए, यहां दिए गए एक या उससे ज़्यादा स्कोप या इससे जुड़े REST API से सही स्कोप के साथ अनुमति की ज़रूरत होती है:

  • https://mail.google.com/

getUnreadCount()

यह इस लेबल से टैग किए गए, नहीं पढ़े गए थ्रेड की संख्या दिखाता है.

// log the number of unread threads labeled with MyLabel
const label = GmailApp.getUserLabelByName('MyLabel');
Logger.log(label.getUnreadCount());

वापसी का टिकट

Integer — लेबल किए गए, नहीं पढ़े गए थ्रेड की संख्या.

अनुमति देना

इस तरीके का इस्तेमाल करने वाले स्क्रिप्ट के लिए, यहां दिए गए एक या उससे ज़्यादा स्कोप या इससे जुड़े REST API से सही स्कोप के साथ अनुमति की ज़रूरत होती है:

  • https://mail.google.com/

removeFromThread(thread)

यह लेबल, दिए गए थ्रेड से हटाता है और थ्रेड को रीफ़्रेश करने के लिए मजबूर करता है.

// remove the label MyLabel from the first thread in the inbox
const label = GmailApp.getUserLabelByName('MyLabel');
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
label.removeFromThread(firstThread);

पैरामीटर

नामटाइपब्यौरा
threadGmailThreadवह थ्रेड जिससे लेबल हटाना है.

वापसी का टिकट

GmailLabel — यह लेबल, चेन बनाने के लिए.

अनुमति देना

इस तरीके का इस्तेमाल करने वाले स्क्रिप्ट के लिए, यहां दिए गए एक या उससे ज़्यादा स्कोप या इससे जुड़े REST API से सही स्कोप के साथ अनुमति की ज़रूरत होती है:

  • https://mail.google.com/

इन्हें भी देखें


removeFromThreads(threads)

यह लेबल, दिए गए थ्रेड से हटाता है और थ्रेड को रीफ़्रेश करने के लिए मजबूर करता है. हर बैच में, ज़्यादा से ज़्यादा 100 थ्रेड से लेबल हटाए जा सकते हैं.

// remove the label MyLabel from the first three threads in the inbox
const label = GmailApp.getUserLabelByName('MyLabel');
const threads = GmailApp.getInboxThreads(0, 3);
label.removeFromThreads(threads);

पैरामीटर

नामटाइपब्यौरा
threadsGmailThread[]वह थ्रेड जिनसे लेबल हटाना है.

वापसी का टिकट

GmailLabel — यह लेबल, चेन बनाने के लिए.

अनुमति देना

इस तरीके का इस्तेमाल करने वाले स्क्रिप्ट के लिए, यहां दिए गए एक या उससे ज़्यादा स्कोप या इससे जुड़े REST API से सही स्कोप के साथ अनुमति की ज़रूरत होती है:

  • https://mail.google.com/

इन्हें भी देखें