Class GmailLabel

Gmailलेबल

यह किसी उपयोगकर्ता के 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);

पैरामीटर

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

वापसी का टिकट

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

अनुमति देना

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

• https://mail.google.com/

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

• removeFromThread(thread)

---

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);

पैरामीटर

नाम	टाइप	ब्यौरा
threads	GmailThread[]	लेबल किए जाने वाले थ्रेड का कलेक्शन.

वापसी का टिकट

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

अनुमति देना

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

• https://mail.google.com/

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

• removeFromThreads(threads)

---

deleteLabel()

इस लेबल को मिटाता है.

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

थ्रो

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

अनुमति देना

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

• https://mail.google.com/

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

• getName()

---

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());
}

पैरामीटर

नाम	टाइप	ब्यौरा
start	Integer	शुरू होने वाले थ्रेड का इंडेक्स.
max	Integer	लौटाए जाने वाले थ्रेड की ज़्यादा से ज़्यादा संख्या.

वापसी का टिकट

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);

पैरामीटर

नाम	टाइप	ब्यौरा
thread	GmailThread	थ्रेड को लेबल नहीं किया गया हो.

वापसी का टिकट

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

अनुमति देना

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

• https://mail.google.com/

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

• addToThread(thread)

---

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);

पैरामीटर

नाम	टाइप	ब्यौरा
threads	GmailThread[]	अनलेबल किए जाने वाले थ्रेड का कलेक्शन.

वापसी का टिकट

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

अनुमति देना

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

• https://mail.google.com/

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

• addToThreads(threads)