Gmail में मैसेज और थ्रेड को टैग करने, व्यवस्थित करने, और कैटगरी में बांटने के लिए, लेबल का इस्तेमाल किया जा सकता है. लेबल का मैसेज और थ्रेड के साथ कई-से-कई रिलेशनशिप होता है: एक मैसेज या थ्रेड पर कई लेबल लागू किए जा सकते हैं और एक लेबल को कई मैसेज या थ्रेड पर लागू किया जा सकता है.
लेबल create, पाने, सूची बनाने, अपडेट करने या मिटाने के तरीके के बारे में जानने के लिए, लेबल का रेफ़रंस देखें.
लेबल मैनेज करने के लिए, आपको https://www.googleapis.com/auth/gmail.labels स्कोप का इस्तेमाल करना होगा. स्कोप के बारे में ज़्यादा जानकारी के लिए, Gmail API से जुड़ी अनुमति और पुष्टि की जानकारी देखें.
लेबल के टाइप
लेबल दो तरह के होते हैं: रिज़र्व SYSTEM लेबल और कस्टम USER लेबल.
सिस्टम लेबल, आम तौर पर Gmail के वेब इंटरफ़ेस में पहले से तय किए गए एलिमेंट से जुड़े होते हैं. जैसे, इनबॉक्स. सिस्टम लेबल के नाम रिज़र्व हैं. किसी SYSTEM लेबल के नाम से मिलता-जुलता नाम वाला कोई USER लेबल नहीं बनाया जा सकता. नीचे दी गई टेबल में, Gmail के सबसे सामान्य सिस्टम लेबल की सूची दी गई है:
| नाम | मैन्युअल तरीके से लागू किया जा सकता है | नोट |
|---|---|---|
INBOX |
हां | |
SPAM |
हाँ | |
TRASH |
हाँ | |
UNREAD |
हाँ | |
STARRED |
हाँ | |
IMPORTANT |
हां | |
SENT |
नहीं | यह विकल्प, drafts.send या
messages.send के साथ भेजे गए मैसेज पर अपने-आप लागू होता है. साथ ही, यह From हेडर में messages.insert और उपयोगकर्ता के ईमेल के साथ डाले गए मैसेज पर भी लागू होता है. इसके अलावा, यह वेब इंटरफ़ेस के ज़रिए उपयोगकर्ता के भेजे गए मैसेज पर भी लागू होता है. |
DRAFT |
नहीं | Gmail API या Gmail इंटरफ़ेस की मदद से बनाए गए सभी
draft मैसेज पर अपने-आप लागू होता है. |
CATEGORY_PERSONAL |
हां | यह Gmail इंटरफ़ेस के निजी टैब में दिखने वाले मैसेज से जुड़ा होता है. |
CATEGORY_SOCIAL |
हां | यह Gmail इंटरफ़ेस के सोशल टैब में दिखने वाले मैसेज से जुड़ा होता है. |
CATEGORY_PROMOTIONS |
हां | यह Gmail इंटरफ़ेस के प्रमोशन टैब में दिखने वाले मैसेज से जुड़ा होता है. |
CATEGORY_UPDATES |
हां | यह उन मैसेज से जुड़ा होता है जो Gmail इंटरफ़ेस के अपडेट टैब में दिखते हैं. |
CATEGORY_FORUMS |
हां | यह Gmail इंटरफ़ेस के फ़ोरम टैब में दिखने वाले मैसेज से जुड़ा होता है. |
मैसेज और थ्रेड पर लेबल मैनेज करना
लेबल सिर्फ़ मैसेज पर मौजूद होते हैं. उदाहरण के लिए, अगर किसी थ्रेड पर लेबल की सूची बनाई जाती है, तो आपको उन लेबल की सूची मिलती है जो थ्रेड में मौजूद किसी भी मैसेज पर मौजूद हैं. ऐसा हो सकता है कि किसी थ्रेड के हर मैसेज पर लेबल न हो. मैसेज पर एक से ज़्यादा लेबल लागू किए जा सकते हैं. हालांकि, ड्राफ़्ट किए गए मैसेज पर लेबल लागू नहीं किए जा सकते.
थ्रेड में लेबल जोड़ना या हटाना
किसी थ्रेड में लेबल जोड़ने या हटाने पर, थ्रेड के सभी मौजूदा मैसेज पर वह लेबल जोड़ दिया जाता है या हटा दिया जाता है.
अगर लेबल जोड़ने के बाद किसी थ्रेड में मैसेज जोड़े जाते हैं, तो नए मैसेज को थ्रेड से जुड़ा मौजूदा लेबल नहीं मिलता. उन मैसेज में लेबल जोड़ने के लिए, थ्रेड में फिर से लेबल जोड़ें.
किसी थ्रेड से जुड़े लेबल जोड़ने या हटाने के लिए, threads.modify का इस्तेमाल करें.
मैसेज में लेबल जोड़ना या हटाना
जब किसी मैसेज में कोई लेबल जोड़ा जाता है, तो वह लेबल उस मैसेज में जुड़ जाता है और उस थ्रेड से जुड़ जाता है जिससे वह मैसेज जुड़ा है. लेबल, थ्रेड में मौजूद अन्य मैसेज में नहीं जोड़ा जाता.
अगर किसी मैसेज से लेबल हटाया जाता है और थ्रेड में उस लेबल वाला सिर्फ़ वह मैसेज है, तो थ्रेड से भी लेबल हट जाता है.
किसी मैसेज पर लागू किए गए लेबल जोड़ने या हटाने के लिए, messages.modify का इस्तेमाल करें.