लेबल मैनेज करें

इस दस्तावेज़ में, Gmail API का इस्तेमाल करके थ्रेड और मैसेज पर लेबल मैनेज करने का तरीका बताया गया है.

Gmail में, मैसेज और थ्रेड को टैग करने, व्यवस्थित करने, और कैटगरी में बांटने के लिए लेबल का इस्तेमाल किया जा सकता है. किसी लेबल का, मैसेज और थ्रेड के साथ मेनी-टू-मेनी रिलेशनशिप होता है. इसका मतलब है कि किसी एक मैसेज या थ्रेड पर कई लेबल लागू किए जा सकते हैं. साथ ही, किसी एक लेबल को कई मैसेज या थ्रेड पर लागू किया जा सकता है.

लेबल बनाने, पाने, सूची बनाने, अपडेट करने या मिटाने के तरीके के बारे में जानकारी पाने के लिए, labels संसाधन देखें.

लेबल मैनेज करने के लिए, आपको https://www.googleapis.com/auth/gmail.labels नॉन-सेंसिटिव स्कोप का इस्तेमाल करना होगा. स्कोप के बारे में ज़्यादा जानकारी के लिए, Gmail API के स्कोप चुनना लेख पढ़ें.

लेबल के टाइप

लेबल दो तरह के होते हैं: रिज़र्व किए गए SYSTEM लेबल और कस्टम USER लेबल.

सिस्टम लेबल आम तौर पर, Gmail के वेब इंटरफ़ेस में पहले से तय किए गए एलिमेंट से जुड़े होते हैं. जैसे, INBOX. सिस्टम लेबल के नाम रिज़र्व किए जाते हैं. किसी भी SYSTEM लेबल के नाम से USER लेबल नहीं बनाया जा सकता. नीचे दी गई टेबल में, Gmail के कुछ सबसे सामान्य सिस्टम लेबल दिए गए हैं:

नाम	मैन्युअल तरीके से लागू किया जा सकता है	नोट
INBOX	हां
SPAM	हाँ
TRASH	हाँ
UNREAD	हाँ
STARRED	हाँ
IMPORTANT	हां
SENT	नहीं	यह लेबल, इन मैसेज पर अपने-आप लागू होता है: drafts.send या messages.send के साथ भेजा गया हो. messages.insert के साथ डाला जाता है और उपयोगकर्ता का ईमेल पता From हेडर में होता है. उपयोगकर्ता ने वेब इंटरफ़ेस के ज़रिए भेजा हो.
DRAFT	नहीं	Gmail API या Gmail इंटरफ़ेस से बनाए गए सभी draft मैसेज पर अपने-आप लागू होता है.
CATEGORY_PERSONAL	हां	यह उन मैसेज से जुड़ा होता है जो Gmail इंटरफ़ेस के निजी टैब में दिखते हैं.
CATEGORY_SOCIAL	हां	यह Gmail इंटरफ़ेस के सोशल टैब में दिखने वाले मैसेज से जुड़ा होता है.
CATEGORY_PROMOTIONS	हां	यह उन मैसेज से जुड़ा होता है जो Gmail इंटरफ़ेस के प्रमोशन टैब में दिखते हैं.
CATEGORY_UPDATES	हां	यह उन मैसेज से जुड़ा होता है जो Gmail इंटरफ़ेस के अपडेट टैब में दिखते हैं.
CATEGORY_FORUMS	हां	यह Gmail इंटरफ़ेस के फ़ोरम टैब में दिखने वाले मैसेज से जुड़ा होता है.

थ्रेड और मैसेज पर लेबल मैनेज करना

लेबल सिर्फ़ मैसेज पर मौजूद होते हैं. किसी थ्रेड पर मौजूद लेबल की सूची पाने पर, आपको उन लेबल की सूची मिलती है जो थ्रेड में मौजूद किसी भी मैसेज पर मौजूद होते हैं. ऐसा हो सकता है कि किसी थ्रेड में मौजूद हर मैसेज पर कोई लेबल न हो.

ड्राफ़्ट मैसेज पर लेबल लागू नहीं किए जा सकते.

थ्रेड में लेबल जोड़ना या हटाना

किसी थ्रेड में लेबल जोड़ने या हटाने पर, थ्रेड में मौजूद सभी मैसेज में वह लेबल जुड़ जाता है या हट जाता है.

अगर किसी थ्रेड में लेबल जोड़ने के बाद मैसेज जोड़े जाते हैं, तो नए मैसेज में थ्रेड से जुड़ा मौजूदा लेबल नहीं दिखता. उन मैसेज में लेबल जोड़ने के लिए, थ्रेड में लेबल को फिर से जोड़ें.

किसी थ्रेड से जुड़े लेबल जोड़ने या हटाने के लिए, threads.modify का इस्तेमाल करें.

ईमेल में लेबल जोड़ना या हटाना

किसी मैसेज में लेबल जोड़ने पर, वह लेबल उस मैसेज में जुड़ जाता है. साथ ही, वह उस थ्रेड से जुड़ जाता है जिसमें वह मैसेज शामिल होता है. थ्रेड में मौजूद अन्य मैसेज में लेबल नहीं जोड़ा जाता.

अगर किसी मैसेज से कोई लेबल हटाया जाता है और वह उस लेबल के साथ थ्रेड में मौजूद इकलौता मैसेज था, तो लेबल को थ्रेड से भी हटा दिया जाता है.

किसी मैसेज पर लगाए गए लेबल जोड़ने या हटाने के लिए, messages.modify का इस्तेमाल करें.