नए रिकॉर्ड को परिणाम कॉलम से मैप करें
GenderAPI ऐड-ऑन में एक Workflows इंटरफ़ेस है, जो शीट के नए रिकॉर्ड को लिंग कॉलम और दूसरे वैकल्पिक परिणाम कॉलम से मैप कर सकता है। इसे सही शीट के लिए कॉन्फ़िगर करें, फिर इस ऑटोमेशन पर निर्भर होने से पहले असल में आए एक रिकॉर्ड की जाँच करें।
ऐड-ऑन का अपना वर्कफ़्लो सीधे V2 को कॉल करने वाले HTTP ऑपरेशन से अलग है। इसे चालू करने का तरीका, निष्पादन का समय और आउटपुट फ़ील्ड इंस्टॉल किए गए ऐड-ऑन और Google अकाउंट पर निर्भर करते हैं। नई पंक्तियों के हर स्रोत के लिए तुरंत अपडेट की गारंटी नहीं है।
वर्कफ़्लो बनाएँ और उसका टेस्ट करें
- GenderAPI ऐड-ऑन इंस्टॉल करके खोलें, फिर साइडबार मेन्यू में Workflows खोलें।
- शीट और अपनी API कुंजी चुनें। मूल कॉलम के अनुसार विश्लेषण का मेथड चुनें: name, email या username।
- मूल कॉलम को एक अलग लिंग कॉलम से मैप करें। probability, देश और पहचाने गए पहले नाम के लिए टारगेट कॉलम सिर्फ़ तभी जोड़ें जब सच में ज़रूरत हो।
- वर्कफ़्लो बनाने से पहले सभी मैपिंग जाँचें। इंटरफ़ेस कॉलम के बीच टकराव रोकता है और यह भी बता सकता है कि कोई वर्कफ़्लो पहले से मौजूद है या सीमा पूरी हो चुकी है।
- प्रोडक्शन डेटा जिस तरीके से आता है, उसी तरीके से एक प्रतिनिधि रिकॉर्ड जोड़ें। पक्का करें कि परिणाम सही पंक्ति में दिखे और कोई मौजूदा फ़ील्ड न बदले।
- एक अनसुलझे मान और एक रन त्रुटि का टेस्ट करें, फिर तय करें कि छूटी या विफल पंक्तियों को कैसे ढूँढना और उनकी समीक्षा करनी है।
ऐड-ऑन वर्कफ़्लो के फ़ील्ड कॉन्फ़िगर करें
| सेटिंग | प्रकार | इसे कैसे इस्तेमाल करें |
|---|---|---|
| API कुंजी | क्रेडेंशियल | सही अकाउंट चुनें और पक्का करें कि क्रेडिट उपलब्ध हैं। |
| शीट | शीट का चयन | वह शीट जिसके रिकॉर्ड यह वर्कफ़्लो प्रोसेस करेगा। |
| मेथड | विकल्प | name, email या username। चुना गया मेथड तय करता है कि इनपुट को कैसे समझा जाए। |
| मूल कॉलम | कॉलम संदर्भ | हर रिकॉर्ड का वह मान जिसका विश्लेषण करना है। |
| लिंग कॉलम | कॉलम संदर्भ | इनपुट और दूसरे परिणामों से अलग एक टारगेट स्थान। |
| probability, देश, पहचाना गया पहला नाम | वैकल्पिक टारगेट स्थान | ऐड-ऑन के अतिरिक्त परिणामों के लिए अलग कॉलम। |
जाँचें कि नई पंक्तियाँ शीट में असल में कैसे आती हैं
हाथ से मान डालना, फ़ॉर्म सबमिट करना और CRM से रिकॉर्ड इम्पोर्ट करना अलग-अलग इवेंट हैं। Google के दस्तावेज़ों के अनुसार स्क्रिप्ट निष्पादन और API अनुरोध आम तौर पर इंस्टॉल किए जा सकने वाले ट्रिगर चालू नहीं करते। ऐड-ऑन के सार्वजनिक पेज पर उसका सटीक इम्प्लीमेंटेशन नहीं बताया गया है: जिस डेटा स्रोत का इस्तेमाल करना है, उसी का टेस्ट करें।
यह न मानें कि नया बना वर्कफ़्लो बाद में पहले से मौजूद पंक्तियाँ प्रोसेस करेगा। उन रिकॉर्ड के लिए साइडबार में एक रेंज चुनकर बल्क प्रोसेसिंग करें और दर्ज करें कि कौन-सी पंक्तियाँ प्रोसेस हो चुकी हैं।
अपेक्षित अपडेट न हो, तो वही रिकॉर्ड दोबारा भेजने से पहले वर्कफ़्लो, अनुमतियाँ, कुंजी का बैलेंस, कॉलम मैपिंग और प्लेटफ़ॉर्म की त्रुटियाँ जाँचें।
परिणाम कॉलम पढ़ें
मूल मान को परिणाम के पास ही रखें। नाम पर आधारित संबंध से किसी व्यक्ति का खुद बताया गया लिंग तय नहीं होता, और लौटाया गया देश निवास या नागरिकता साबित नहीं करता।
- पूरे डेटासेट को प्रोसेस करने से पहले एक सामान्य परिणाम, एक अस्पष्ट इनपुट और एक विफल रन जाँचें।
- खाली सेल, टेक्स्ट null और फ़ॉर्मूला त्रुटि अलग-अलग मान हैं। अज्ञात परिणाम दिखाने का तरीका सोच-समझकर एक जैसा रखें, लेकिन त्रुटियाँ न छिपाएँ।
- अज्ञात या अनिश्चित मामलों में तटस्थ शब्द इस्तेमाल करें, और व्यक्ति की दी हुई जानकारी को अनुमान से अलग रखें।
| परिणाम | प्रकार | इसे कैसे इस्तेमाल करें |
|---|---|---|
| Gender | टेक्स्ट या अनसुलझा मान | male या female सिर्फ़ सफल परिणाम होने पर सेव करें। अनसुलझे मान को अज्ञात के रूप में सेव करें और त्रुटि संदेश अलग से जाँचें। |
| Probability | संख्या (अगर उपलब्ध हो) | पुराने समय से चला आ रहा एक कॉन्फिडेंस संकेत। यह V2 के confidence फ़ील्ड से मेल नहीं खाता और आपके डेटा पर मापी गई सटीकता नहीं है। |
| Country | टेक्स्ट (अगर उपलब्ध हो) | खोज से लौटाया गया संदर्भ। इसे ग्राहक के सत्यापित देश से अलग रखें। |
| Found / normalized name | टेक्स्ट (अगर उपलब्ध हो) | प्रोसेसिंग में इस्तेमाल हुआ या निकाला गया पहला नाम। ईमेल पता या यूज़रनेम अस्पष्ट हो, तो यह मान जाँचें। |
क्रेडिट, सीमाओं और दोबारा चलाने की योजना बनाएँ
रजिस्टर किए गए मुफ़्त GenderAPI अकाउंट में हर दिन 200 क्रेडिट मिलते हैं। यह अकाउंट का बैलेंस है, यह वादा नहीं कि हर वर्कफ़्लो से 200 पहचाने गए परिणाम मिलेंगे। शुरू करने से पहले चुनी गई कुंजी का बैलेंस और टूल के मौजूदा प्रोसेसिंग विकल्प जाँचें।
ऐड-ऑन और फ़ाइल प्रोसेसिंग अपनी-अपनी प्रक्रिया से चलते हैं। V2 REST API की बैच सीमाएँ, AI विकल्प और हर अनुरोध के बिलिंग फ़ील्ड इन टूल पर अपने-आप लागू नहीं होते। दोबारा चलाने या दोबारा गणना से नए अनुरोध जा सकते हैं और क्रेडिट लग सकते हैं, इसलिए इसे मुफ़्त न मानें।
छोटे सैंपल से शुरू करें, मिले परिणाम सेव करें और दोबारा चलाने से पहले विफल पंक्तियों की समीक्षा करें। अगर आपको सिर्फ़ किसी एक्सपोर्ट या टारगेट सिस्टम का अपडेट ठीक करना है, तो मौजूदा परिणाम दोबारा इस्तेमाल करें।
V2 API सीधे कब इस्तेमाल करें
अगर आपके ऐप्लिकेशन को साफ़ तौर पर तय AI विकल्प और हर आइटम के लिए V2 की status, source, confidence_kind और usage जानकारी चाहिए, तो एक अलग HTTP इंटीग्रेशन कॉन्फ़िगर करें। V2 के अनुरोध और रिस्पॉन्स के नियमों का पालन करें: ऐड-ऑन के अपने फ़ॉर्मूले या मौजूदा ऐड-ऑन में V2 फ़ील्ड के नाम जोड़ने से उनका व्यवहार नहीं बदलता।
अक्सर पूछे जाने वाले सवाल
क्या CRM से होने वाला हर इम्पोर्ट ऐड-ऑन का वर्कफ़्लो चालू करता है?
ऐसा न मानें। जिस CRM या ऑटोमेशन का आप असल में इस्तेमाल करते हैं, उसके एक रिकॉर्ड से टेस्ट करें। Google हाथ से किए बदलाव, फ़ॉर्म सबमिशन और API से होने वाले अपडेट में अंतर करता है। इंस्टॉल किए गए ऐड-ऑन का असली व्यवहार जाँचें।
क्या शीट की पहले से मौजूद पंक्तियाँ प्रोसेस की जा सकती हैं?
साइडबार में एक रेंज चुनकर बल्क प्रोसेसिंग करें। नई पंक्तियों के लिए वर्कफ़्लो बनाने का मतलब यह नहीं कि मौजूदा रिकॉर्ड भी प्रोसेस होंगे।
कितने वर्कफ़्लो बनाए जा सकते हैं?
इंटरफ़ेस कोई सीमा दिखा सकता है, लेकिन यह गाइड बिना जाँची संख्या नहीं देती। इंस्टॉल किया गया संस्करण जाँचें और ज़रूरत हो, तो जिन वर्कफ़्लो की अब ज़रूरत नहीं उन्हें हटा दें।
V2 के source और usage फ़ील्ड कैसे मिलेंगे?
एक अलग V2 HTTP इंटीग्रेशन बनाएँ, जैसे Make या Zapier की दस्तावेज़ित गाइड के अनुसार। यह न मानें कि ऐड-ऑन के कॉलम में V2 रिस्पॉन्स की संरचना होती है।
स्रोत और दस्तावेज़ीकरण
इस गाइड की पिछली समीक्षा को हुई। इंस्टॉलेशन का तरीका प्लेटफ़ॉर्म के दस्तावेज़ीकरण में जाँचें; अलग V2 इंटीग्रेशन बनाने के लिए नीचे दिया API दस्तावेज़ीकरण इस्तेमाल करें।