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