Skip to main content

एंटरप्राइज़ नियमों और क्वेरी के साथ शुरुआत करना

एंटरप्राइज़ ऑपरेटरों का उपयोग करने वाले प्रोडक्ट, आपके द्वारा सेट किए गए फ़िल्टरिंग नियमों के आधार पर आपको सोशल डेटा उपलब्ध कराते हैं। नियम एक या अधिक ‘क्लॉज़’ से मिलकर बनते हैं, जहाँ क्लॉज़ एक कीवर्ड, सटीक वाक्यांश या कई एंटरप्राइज़ ऑपरेटरों में से कोई एक हो सकता है। एंटरप्राइज़ ऑपरेटरों के साथ नियम बनाना शुरू करने से पहले, नीचे दिए गए सिंटैक्स की समीक्षा कर लें, उपलब्ध ऑपरेटरों की सूची देख लें, और नियम बनाने से जुड़ी सीमाओं को समझ लें। आपको यह भी समझना चाहिए कि नियमों का तार्किक रूप से मूल्यांकन कैसे किया जाता है, जैसा कि “संचालन का क्रम” अनुभाग में बताया गया है। एक से अधिक क्लॉज़ को “and” और “or” दोनों लॉजिक के साथ जोड़ा जा सकता है। कृपया ध्यान दें: “and” लॉजिक क्लॉज़ के बीच एक स्पेस से दर्शाया जाता है, जबकि “or” लॉजिक अपर-केस OR से दर्शाया जाता है।  हर नियम अधिकतम 2,048 वर्णों का हो सकता है, और पॉज़िटिव क्लॉज़ (वे चीज़ें जिन्हें आप मैच करना या फ़िल्टर करना चाहते हैं) तथा नेगेटिव क्लॉज़ (वे चीज़ें जिन्हें आप बाहर रखना चाहते हैं और मैच नहीं करना चाहते) की संख्या पर कोई सीमा नहीं है।  

नियम और क्वेरी बनाना

कीवर्ड मिलान कीवर्ड मिलान, खोज इंटरफ़ेस में इस्तेमाल होने वाली क्वेरी जैसा होता है। उदाहरण के लिए, नीचे दिया गया एंटरप्राइज़ ऑपरेटर नियम उन गतिविधियों से मेल खाएगा जिनके टेक्स्ट में “social” शब्द मौजूद हो। social खाली स्थान के साथ शब्दों को AND करना एक और कीवर्ड जोड़ना, मिलान ढूँढने के लिए एक और शर्त जोड़ने जैसा है। उदाहरण के लिए, यह नियम केवल उन गतिविधियों से मेल खाएगा जिनके टेक्स्ट में “social” और “media” दोनों मौजूद हों, चाहे उनका क्रम कोई भी हो – शब्दों के बीच का खाली स्थान बूलियन AND लॉजिक की तरह काम करता है। यदि आप अपने नियम में स्पष्ट रूप से AND शामिल करते हैं, तो उसे rules endpoint अस्वीकार कर देगा। social media बड़े अक्षरों वाले OR के साथ शब्दों को OR करना हालाँकि, कई स्थितियों में बूलियन OR लॉजिक की आवश्यकता होती है। यह भी आसानी से किया जा सकता है। ध्यान दें कि OR ऑपरेटर बड़े अक्षरों में होना चाहिए; छोटे अक्षरों में लिखा गया ‘or’ एक सामान्य कीवर्ड माना जाएगा। social OR data शब्दों को निषेध करना कुछ अन्य स्थितियों में कुछ खास कीवर्ड वाले नतीजों को बाहर करना पड़ सकता है (बूलियन NOT लॉजिक)। उदाहरण के लिए, ‘happy’ वाली गतिविधियाँ, लेकिन टेक्स्ट में ‘birthday’ वाला कोई भी परिणाम शामिल न हो। social -personality कोष्ठकों के साथ समूह बनाना इस तरह के लॉजिक को कोष्ठकों के साथ समूहित करके जोड़ा जा सकता है, और इसे कहीं अधिक जटिल क्वेरी तक विस्तारित किया जा सकता है। (social OR data) (academic OR research) -personality -information -university हालाँकि, यह तो बस शुरुआत है – ऊपर दिए गए उदाहरण केवल कीवर्ड के लिए tokenized matching पर आधारित हैं, जबकि एंटरप्राइज़ प्रोडक्ट टेक्स्ट पर अलग-अलग प्रकार के मिलान करने के लिए ऑपरेटर भी प्रदान करते हैं। सटीक मिलान "social media research" उपस्ट्रिंग मिलान contains:info निकटता मिलान "social media research"~3 इसके अलावा, दूसरे ऑपरेटर आपको केवल टेक्स्ट ही नहीं, बल्कि social data के विशिष्ट पहलुओं के आधार पर भी फ़िल्टर करने देते हैं।  वह उपयोगकर्ता जो पोस्ट कर रहा है from:XDeveloeprs Boulder, CO, United States में Pearl St. के 10 miles के भीतर geo-tag किए गए ट्वीट्स point_radius:[-105.27346517 40.01924738 10.0mi] सब कुछ एक साथ जोड़ना इन्हें ऊपर बताए गए उसी तरह के लॉजिक का उपयोग करके टेक्स्ट फ़िल्टर के साथ जोड़ा जा सकता है। (social OR data) (academic OR research OR "social media research") point_radius:[-105.27346517 40.01924738 10.0mi] lang:en -personality -information -university

बूलियन सिंटैक्स

पिछले अनुभाग के उदाहरणों में बूलियन लॉजिक और ग्रुपिंग के विभिन्न प्रकारों का उपयोग किया गया था। प्रत्येक के सिंटैक्स और आवश्यकताओं के बारे में अतिरिक्त जानकारी के लिए नीचे दी गई तालिका देखें। कृपया ध्यान दें: ऑपरेटर positive या negative, दोनों प्रकार के हो सकते हैं। Positive Operators यह निर्धारित करते हैं कि आप परिणामों में क्या शामिल करना चाहते हैं। उदाहरण के लिए, has:hashtags ऑपरेटर कहता है “मुझे ऐसी गतिविधियाँ चाहिए जिनमें hashtags हों।” Negative Operators यह निर्धारित करते हैं कि आप परिणामों से क्या बाहर करना चाहते हैं, और इन्हें ऊपर बताए गए बूलियन NOT लॉजिक का उपयोग करके बनाया जाता है। उदाहरण के लिए, -has:hashtags का अर्थ है “ऐसी किसी भी गतिविधि को बाहर करें जिसमें hashtags हों, भले ही वे अन्यथा मेरी rule से मेल खाती हों।” Premium operator products में positive और negative clauses की संख्या पर कोई प्रतिबंध नहीं है, बशर्ते अधिकतम लंबाई 2,048 वर्ण हो।  

संचालन का क्रम

जब किसी एक नियम में AND और OR फ़ंक्शनैलिटी को मिलाया जाता है, तो निम्नलिखित संचालन क्रम यह तय करता है कि आपके नियम का मूल्यांकन कैसे किया जाएगा।
  1. AND लॉजिक से जुड़े ऑपरेटर पहले संयोजित किए जाते हैं
  2. फिर, OR लॉजिक से जुड़े ऑपरेटर लागू किए जाते हैं
उदाहरण:
  • apple OR iphone ipad का मूल्यांकन apple OR (iphone ipad) के रूप में किया जाएगा
  • ipad iphone OR android का मूल्यांकन (iphone ipad) OR android के रूप में किया जाएगा
अस्पष्टता से बचने और यह सुनिश्चित करने के लिए कि आपके नियमों का मूल्यांकन इच्छित तरीके से हो, जहाँ उपयुक्त हो वहाँ कोष्ठकों का उपयोग करके शब्दों को समूहित करें। उदाहरण के लिए:
  • (apple OR iphone) ipad
  • iphone (ipad OR android)

विराम चिह्न, डायक्रिटिक्स, और केस सेंसिटिविटी

यदि आप एंटरप्राइज़ ऑपरेटर के लिए अक्षर-उच्चारण चिह्नों या डायक्रिटिक्स के साथ कोई keyword या hashtag rule निर्दिष्ट करते हैं, तो वह डायक्रिटिक्स का ध्यान रखते हुए पोस्ट टेक्स्ट (hashtags या keywords) से मेल खाएगी। Diacr**í**tica keyword या #cumplea**ñ**os hashtag वाली rule “Diacrítica” या “#cumpleaños” से मेल खाएगी, लेकिन “Diacritica” या “#cumpleanos” से नहीं, जिनमें tilde í या eñe नहीं है। उच्चारण चिह्नों या डायक्रिटिक्स वाले अक्षरों को सामान्य अक्षरों की तरह ही माना जाता है और उन्हें शब्द-सीमा के रूप में नहीं माना जाता। उदाहरण के लिए, cumpleaños की rule केवल उन activities से मेल खाएगी जिनमें cumpleaños शब्द शामिल हो, और उन activities से मेल नहीं खाएगी जिनमें cumplea, cumplean, या os शामिल हों। सभी ऑपरेटर का मूल्यांकन case-insensitive तरीके से किया जाता है। उदाहरण के लिए, Cat rule निम्न सभी से मेल खाएगी: “cat”, “CAT”, “Cat”।

PowerTrack नियम टैग

जैसा कि हमारे “Matching rules” पेज में बताया गया है, हर नियम को एक टैग के साथ बनाया जा सकता है। इन टैगों का फ़िल्टरिंग पर कोई असर नहीं पड़ता, लेकिन आपके ऐप के भीतर नियमों के तार्किक समूह बनाने के लिए इनका उपयोग किया जा सकता है। हर नियम में केवल एक ही टैग हो सकता है, और इसकी अधिकतम लंबाई 255 वर्ण है। “Matching rules” पेज में बताए अनुसार, API के माध्यम से नियम बनाते समय टैग JSON-स्वरूपित नियम के साथ शामिल किए जाते हैं।

नियमों को JSON फ़ॉर्मैट में रखना

API के ज़रिए स्ट्रीम में कोई नियम जोड़ने या हटाने के लिए, नियमों का JSON फ़ॉर्मैट में होना ज़रूरी है। मूल रूप से, इसका मतलब है कि हर नियम को नीचे दी गई संरचना में रखना होगा: {"value":"insert_rule_here"} डबल-कोट्स वाले नियम अगर नियम में exact-match या अन्य operators से जुड़े डबल-कोट वर्ण () शामिल हैं, तो उन्हें बैकस्लैश का उपयोग करके escape करना होगा, ताकि उन्हें JSON फ़ॉर्मैट की संरचना से अलग पहचाना जा सके। "social data" @XDevelopers JSON फ़ॉर्मैट में नियम इस तरह होगा: {"value":"\"social data\" @XDevelopers"} डबल-कोट string literals वाले नियम exact-match के भीतर किसी डबल-कोट वर्ण को string literal के रूप में शामिल करने के लिए, उसे double-escape करना होगा। उदाहरण के लिए, उस नियम के लिए जो सटीक वाक्यांश “Toys “R” Us” से मेल खाता है, जिसमें “R” के चारों ओर डबल-कोट्स भी शामिल हैं, उसका plain-text representation इस तरह दिखेगा: "Toys \"R\" Us" इसे JSON फ़ॉर्मैट में बदलने के लिए, आपको नीचे दी गई संरचना का उपयोग करना चाहिए: {"value":"\"Toys \\\"R\\\" Us\""} Tags वाले नियम जैसा कि ऊपर बताया गया है, अपने नियम के साथ एक वैकल्पिक टैग शामिल करने के लिए, नियम के value के साथ बस एक अतिरिक्त टैग field जोड़ें। {"value":"\"social data\" @XDevelopers","tag":"RULE-TAG-01"} API अनुरोधों के लिए फ़ॉर्मैटिंग API के ज़रिए स्ट्रीम में नियम जोड़ते या हटाते समय, JSON फ़ॉर्मैट में दिए गए कई नियमों को comma से अलग किया जाना चाहिए और नीचे दिखाए अनुसार JSON “नियम” array में रखा जाना चाहिए: {"rules":[{"value":"from:XDevelopers"},{"value":"\social data\" @XDevelopers","tag":"RULE-TAG-01"}]}

Quote Tweets से मेल खाने वाले ऑपरेटर

PowerTrack API और Historical PowerTrack API का उपयोग करते समय, नीचे दिए गए ऑपरेटर उद्धृत मूल पोस्ट और नए Quote Tweet, दोनों की सामग्री से मेल खाएँगे। हालाँकि, यदि आप Search API का उपयोग कर रहे हैं, तो ये ऑपरेटर केवल Quote Tweet की सामग्री से मेल खाएँगे और उद्धृत मूल पोस्ट की किसी भी सामग्री से मेल नहीं खाएँगे।
  • Keywords
  • Phrases
  • Proximity
  • #hashtags
  • @mentions
  • $cashtags
  • url:
  • url_contains:
  • has:links
  • has:mentions
  • has:hashtags
  • has:media
  • has:symbols
  • is:quote
  • is:reply

एंटरप्राइज़ ऑपरेटर

नीचे PowerTrack और Historical PowerTrack के साथ उपलब्ध ऑपरेटर दिए गए हैं। इनमें से कुछ 30-Day और Full-Archive search APIs में भी उपलब्ध हैं। उपलब्ध ऑपरेटरों की उत्पाद-वार सूची के लिए इस तालिका देखें।  नीचे दी गई सूची वर्तमान में समर्थित भाषाओं और उनके संबंधित BCP 47 भाषा पहचानकर्ताओं को दर्शाती है: उदाहरण: (@XDevelopers OR to:XDevelopers) lang:es नोट: भाषा ऑपरेटर, X द्वारा निर्धारित और पोस्ट के lang attribute में सेट की गई, विशिष्ट पोस्ट भाषा से मेल खाता है।  X Entities JSON attributes के बारे में अधिक जानकारी के लिए यहाँ देखें।  यदि किसी पोस्ट के लिए भाषा का वर्गीकरण नहीं किया जा सकता है, तो पोस्ट का lang ‘und’ (undefined के लिए) पर सेट किया जाएगा।

उत्पाद-वार ऑपरेटर

नियम और फ़िल्टरिंग: एंटरप्राइज़

सभी एंटरप्राइज़ ऑपरेटर, PowerTrack और Historical PowerTrack APIs के साथ उपलब्ध हैं। हालांकि, एंटरप्राइज़ Search APIs में केवल कुछ ऑपरेटर ही उपलब्ध हैं, जैसा कि इस पेज पर बताया गया है। गहरे नीले टैग यह दिखाते हैं कि अलग-अलग एंटरप्राइज़ products के लिए कौन-से ऑपरेटर उपलब्ध हैं: PowerTrack Search