इस दस्तावेज़ में, Gmail API में फ़िल्टर इस्तेमाल करने का तरीका बताया गया है.
किसी खाते के लिए, फ़िल्टर करने के ऐडवांस नियमों को कॉन्फ़िगर करने के लिए, settings.filters रिसोर्स का इस्तेमाल किया जा सकता है. फ़िल्टर, आने वाले मैसेज की विशेषताओं या कॉन्टेंट के आधार पर, लेबल अपने-आप जोड़ सकते हैं या हटा सकते हैं. इसके अलावा, ईमेल को पुष्टि किए गए उपनामों पर फ़ॉरवर्ड कर सकते हैं.
Gmail फ़िल्टर बनाने, सूचीबद्ध करने, पाने या मिटाने के बारे में जानकारी पाने के लिए, settings.filters संसाधन देखें.
मैच करने की शर्तें
भेजने वाले का नाम, विषय, तारीख, साइज़, और मैसेज के कॉन्टेंट जैसी प्रॉपर्टी के हिसाब से मैसेज फ़िल्टर करें. फ़िल्टर सिर्फ़ कुछ मैसेज पर लागू होते हैं, पूरे ईमेल थ्रेड पर नहीं. Gmail के ऐडवांस खोज सिंटैक्स का इस्तेमाल करके की गई किसी भी क्वेरी का इस्तेमाल फ़िल्टर में भी किया जा सकता है. उदाहरण के लिए, फ़िल्टर के सामान्य पैटर्न में ये शामिल हैं:
| फ़िल्टर करें | मैच |
|---|---|
criteria.from='sender@example.com' |
sender@example.com से मिले ईमेल |
criteria.size=10485760criteria.sizeComparison='larger' |
10 एमबी से ज़्यादा साइज़ वाले ईमेल |
criteria.hasAttachment=true |
अटैचमेंट वाले ईमेल |
criteria.subject='[People with Pets]' |
विषय में [People with Pets] वाले ईमेल |
criteria.query='"my important project"' |
my important project वाले ईमेल |
criteria.negatedQuery='"secret knock"' |
ऐसे ईमेल जिनमें secret knock शामिल नहीं है |
अगर किसी फ़िल्टर में कई शर्तें मौजूद हैं, तो फ़िल्टर लागू करने के लिए, यह ज़रूरी है कि कोई मैसेज उन सभी शर्तों को पूरा करता हो.
कार्रवाइयां
फ़िल्टर करने की शर्त से मेल खाने वाले मैसेज पर Action लागू करें. Action की मदद से, पुष्टि किए गए ईमेल पते पर मैसेज फ़ॉरवर्ड किए जा सकते हैं. इसके अलावा, लेबल जोड़े और हटाए जा सकते हैं.
ईमेल की स्थिति बदलने के लिए, लेबल जोड़ें या हटाएं. उदाहरण के लिए, कुछ सामान्य कार्रवाइयां यहां दी गई हैं:
| कार्रवाई | असर |
|---|---|
action.removeLabelIds=['INBOX'] |
ईमेल को संग्रहित करें (इनबॉक्स में नहीं) |
action.removeLabelIds=['UNREAD'] |
'पढ़ा गया' के तौर पर मार्क करें |
action.removeLabelIds=['SPAM'] |
कभी स्पैम के तौर पर मार्क न करें |
action.removeLabelIds=['IMPORTANT'] |
कभी भी ज़रूरी के तौर पर मार्क न करें |
action.addLabelIds=['IMPORTANT'] |
ज़रूरी का निशान लगाएं |
action.addLabelIds=['TRASH'] |
ईमेल मिटाना |
action.addLabelIds=['STARRED'] |
'तारे के निशान वाला' के तौर पर मार्क करना |
action.addLabelIds=['<user label id>'] |
ईमेल को उपयोगकर्ता के तय किए गए लेबल से टैग करें. हर फ़िल्टर के लिए, उपयोगकर्ता के तय किए गए सिर्फ़ एक लेबल का इस्तेमाल किया जा सकता है. |
कोड सैंपल
यहां दिए गए कोड सैंपल में, किसी ईमेल सूची से मिले मैसेज को लेबल करने और संग्रहित करने का तरीका बताया गया है: