मकसद
डेवलपर के तौर पर, आपको अक्सर ऐसे डेटासेट के साथ काम करना होता है जिनमें ग्राहक के पते शामिल होते हैं शायद उसकी क्वालिटी अच्छी न हो. आपको यह पक्का करना होगा कि ग्राहक आईडी की पुष्टि से लेकर डिलीवरी वगैरह तक के इस्तेमाल के उदाहरण.
पते की पुष्टि करना API, Google Ads का प्रॉडक्ट है Google Maps Platform, जिसका इस्तेमाल पते की पुष्टि करने के लिए किया जा सकता है. हालांकि, इस टूल का इस्तेमाल एक बार में एक पते को प्रोसेस करती है. इस दस्तावेज़ में, हम जानेंगे कि एपीआई टेस्टिंग से लेकर अलग-अलग स्थितियों में, हाई वॉल्यूम वाले पते की पुष्टि करने की सुविधा पते की पुष्टि करना.
उपयोग के उदाहरण
अब हम इस्तेमाल के उन मामलों को समझेंगे जिनमें बड़ी संख्या में पते की पुष्टि की जाती है उपयोगी.
टेस्ट करना
आम तौर पर, पते की पुष्टि करने वाले एपीआई को टेस्ट करने के लिए, पते. ये पते, कॉमा सेपरेटेड वैल्यू वाली फ़ाइल में हो सकते हैं और पते की क्वालिटी की पुष्टि करने के लिए.
पतों की एक बार की जाने वाली पुष्टि
पते की पुष्टि करने वाले एपीआई में शामिल होने के दौरान, आपको उपयोगकर्ता डेटाबेस के लिए मौजूदा पतों का डेटाबेस.
पते की बार-बार पुष्टि करना
पतों की पुष्टि बार-बार की जाती है. इसके लिए कई मामलों की ज़रूरत होती है:
- कैप्चर की गई जानकारी के लिए, शायद आपने पतों की पुष्टि करने के लिए जॉब शेड्यूल किए हों दिन के दौरान, उदाहरण के लिए, खरीदारों के साइनअप, ऑर्डर की जानकारी, डिलीवरी से लेकर शेड्यूल करने में मदद मिलती है.
- आपको ऐसे डेटा डंप मिल सकते हैं जिनमें अलग-अलग डिपार्टमेंट, उदाहरण के लिए, बिक्री से लेकर मार्केटिंग तक. वह नया विभाग पते इस्तेमाल करने से पहले अक्सर उनकी पुष्टि करना चाहते हैं.
- सर्वे या अलग-अलग प्रमोशन और बाद में, आपके पते इकट्ठा किए जा सकते हैं को अपडेट किया गया है. आप इन पतों की पुष्टि करना चाहते हैं और उन्हें सिस्टम में डालते समय उन्हें सही कर दें.
तकनीकी चीज़ों की पूरी जानकारी
इस दस्तावेज़ के लिए, हम मानते हैं कि:
- आपने Address Verified API को ग्राहक के पतों के साथ कॉल किया है डेटाबेस (जैसे, ग्राहक की जानकारी वाला डेटाबेस)
- आप अपने डेटाबेस में अलग-अलग पतों के लिए वैधता फ़्लैग को कैश मेमोरी में सेव कर सकते हैं.
- वैधता की जानकारी देने वाले फ़्लैग, पते की पुष्टि करने वाले एपीआई से तब वापस लाए जाते हैं, जब व्यक्तिगत ग्राहक लॉग इन करता है.
प्रोडक्शन के लिए कैश मेमोरी
Address Verified API का इस्तेमाल करते समय, आपको अक्सर एपीआई कॉल से मिला रिस्पॉन्स. हालांकि हमारी शर्तों सेवा पाने की सीमा कौनसा डेटा कैश मेमोरी में सेव किया जा सकता है, Address Validation API से कैश मेमोरी में सेव किया गया कोई भी डेटा किसी उपयोगकर्ता खाते के लिए कैश मेमोरी में सेव किया जाना चाहिए. इसका मतलब है कि डेटाबेस में, पते या पते के मेटाडेटा को उपयोगकर्ता के ईमेल पते में कैश मेमोरी में सेव किया जाना चाहिए या अन्य प्राथमिक आईडी चुनें.
हाई वॉल्यूम वाले पते की पुष्टि करने के लिए, डेटा कैश मेमोरी में सेव किए गए डेटा को पते की पुष्टि करने वाला एपीआई किसी सेवा के लिए खास शर्तें, सेक्शन 11.3 में बताया गया है. इस जानकारी के आधार पर, आपके पास ये विकल्प हैं तय करें कि क्या उपयोगकर्ता का पता अमान्य हो सकता है, और इस स्थिति में आपको आपके साथ अगले इंटरैक्शन के दौरान सही पते के लिए उपयोगकर्ता को का इस्तेमाल करें.
- AddressComponent से मिलने वाला डेटा
ऑब्जेक्ट
confirmationLevel
inferred
spellCorrected
replaced
unexpected
अगर आपको पते की किसी भी जानकारी को कैश मेमोरी में सेव करना है, तो कैश मेमोरी में सेव किया जाना चाहिए. ऐसा सिर्फ़ उपयोगकर्ता की सहमति से किया जाना चाहिए. इससे यह पक्का होता है कि उपयोगकर्ता ठीक है इस बात की जानकारी है कि कोई विशिष्ट सेवा अपना पता क्यों संग्रहित कर रही है और वे अपना ईमेल पता शेयर करने की शर्तों को पूरा करते हैं.
उपयोगकर्ता की सहमति का एक उदाहरण किसी ई-कॉमर्स पते से सीधे तौर पर इंटरैक्शन करना है चेकआउट पेज पर फ़ॉर्म भरने के लिए. यह समझना ज़रूरी है कि आपके पास कैश मेमोरी में सेव किए गए और पैकेज भेजने के लिए पता प्रोसेस करना.
उपयोगकर्ता की सहमति से, formattedAddress
और अन्य मुख्य कॉम्पोनेंट को कैश मेमोरी में सेव किया जा सकता है
पहले से चुना हुआ है. हालांकि, हेडलेस (सिर्फ़ बैक-एंड पर काम करने की सुविधा) होने पर, उपयोगकर्ता
सहमति देता है, क्योंकि पते की पुष्टि बैकएंड से की जाती है. इसलिए,
बिना ग्राफ़िक यूज़र इंटरफ़ेस वाले इस वीडियो में, बहुत सीमित जानकारी को कैश मेमोरी में सेव किया जा सकता है.
जवाब को समझना
अगर पते की पुष्टि करने वाले एपीआई के रिस्पॉन्स में ये मार्कर शामिल हैं, तो यह पक्का कर सकते हैं कि इनपुट पता, डिलीवर की जा सकने वाली क्वालिटी का हो:
- फ़ैसले में
addressComplete
मार्कर ऑब्जेक्टtrue
है, - फ़ैसले में शामिल
validationGranularity
ऑब्जेक्टPREMISE
याSUB_PREMISE
है - AddressComponent में से कोई नहीं
इन्हें इसके तौर पर मार्क किया गया है:
Inferred
(ध्यान दें: inferred=true
ऐसा तब हो सकता है, जबaddressComplete=true
)spellCorrected
replaced
unexpected
, और
confirmationLevel
: पुष्टि का स्तर AddressComponentCONFIRMED
याUNCONFIRMED_BUT_PLAUSIBLE
पर सेट है
अगर एपीआई के रिस्पॉन्स में ऊपर दिए गए मार्कर शामिल नहीं हैं, तो पता डालें की क्वालिटी खराब हो सकती थी. साथ ही, अपने डेटाबेस में फ़्लैग को कैश मेमोरी में सेव किया जा सकता है, ताकि उसे. कैश मेमोरी में सेव किए गए फ़्लैग बताते हैं कि पूरे पते की क्वालिटी खराब है. हालांकि, स्पेल सही जैसे ज़्यादा जानकारी वाले फ़्लैग से यह पता चलता है कि पते की क्वालिटी से जुड़ी समस्या है. पते के साथ अगले ग्राहक इंटरैक्शन पर इससे पते की पुष्टि करने वाले एपीआई को कॉल किया जा सकता है. इससे पहले ही अपने कारोबार के हिसाब से name@yourcompany.com जैसा कोई ईमेल पता बनाएं. पते की पुष्टि करने वाला एपीआई, सही पता दिखाएगा को यूज़र इंटरफ़ेस (यूआई) प्रॉम्प्ट का इस्तेमाल करके दिखाया जा सकता है. ग्राहक के फ़ॉर्मैट किए गए पते को स्वीकार करने के बाद तो रिस्पॉन्स से यह कैश मेमोरी में सेव किया जा सकता है:
formattedAddress
postalAddress
addressComponent componentNames
याUspsData standardizedAddress
हेडलेस (सिर्फ़ बैक-एंड पर काम करने की सुविधा देने वाला) पते की पुष्टि करने की सुविधा लागू करना
ऊपर दी गई चर्चा के आधार पर:
- अक्सर पते से मिले जवाब के कुछ हिस्से को कैश मेमोरी में सेव करना ज़रूरी होता है कारोबार की वजहों से पुष्टि करने वाला एपीआई.
- हालांकि, इनकी शर्तों इस इलाके में उपलब्ध है Google Maps Platform यह तय करता है कि कौनसा डेटा कैश मेमोरी में सेव किया जा सकता है.
यहां दिए गए सेक्शन में, हम दो चरणों में पुष्टि की प्रक्रिया के बारे में चर्चा करेंगे. और पते की पुष्टि के लिए, सेवा की शर्तों को पूरा करते हैं.
पहला चरण:
पहले चरण में, हम देखेंगे कि ज़्यादा ट्रैफ़िक वाले ईमेल पतों को कैसे लागू किया जाए की पुष्टि करने के लिए इस्तेमाल किया जा रहा है. इस प्रोसेस से, आपको ये काम करने में मदद मिलेगी पते की पुष्टि करने वाले एपीआई के रिस्पॉन्स से मिले खास फ़ील्ड को सेवा का अनुपालन करने वाला तरीका.
डायग्राम A: यहां दिया गया डायग्राम दिखाता है कि डेटा पाइपलाइन को कैसे बेहतर बनाया जा सकता है पते की पुष्टि करने वाले लॉजिक का इस्तेमाल करें.
सेवा की शर्तों के मुताबिक, आपके पास नीचे दिए गए डेटा को
addressComponent
:
confirmationLevel
inferred
spellCorrected
replaced
unexpected
इसलिए, लागू करने के इस चरण के दौरान, हम ऊपर बताई गई बातों को कैश मेमोरी में सेव कर लेंगे फ़ील्ड को उपयोगकर्ता आईडी में डालें.
ज़्यादा जानकारी के लिए, असल डेटा स्ट्रक्चर को स्वीकार करते हैं.
दूसरा चरण:
पहले चरण में, हमें सुझाव मिला कि इनपुट डेटासेट में मौजूद कुछ पते अच्छी क्वालिटी का नहीं होना चाहिए. अगले चरण में, हम इन फ़्लैग किए गए पतों को और उन्हें उपयोगकर्ता को प्रस्तुत करना होगा और उन्हें संग्रहित किए गए आइटम को ठीक करने के लिए उनकी सहमति लेनी होगी इससे पहले ही अपने कारोबार के हिसाब से name@yourcompany.com जैसा कोई ईमेल पता बनाएं.
डायग्राम B: इस डायग्राम में दिखाया गया है कि उपयोगकर्ता का एंड से एंड इंटिग्रेशन कैसे होता है सहमति का फ़्लो ऐसा दिख सकता है:
- जब उपयोगकर्ता लॉग इन करता है, तो सबसे पहले यह देख लें कि आपने पुष्टि करने वाले किसी फ़्लैग को कैश मेमोरी में सेव किया है या नहीं आपके सिस्टम में.
- अगर उसमें कोई फ़्लैग मौजूद है, तो उसे ठीक करने के लिए आपको उपयोगकर्ता को यूज़र इंटरफ़ेस (यूआई) दिखाना चाहिए और उनका पता अपडेट करना.
- अपडेट किए गए या कैश मेमोरी में सेव किए गए कोड का इस्तेमाल करके, Address Validation API को फिर से कॉल किया जा सकता है और सही पता उपयोगकर्ता को दिखाएं.
- अगर पते की गुणवत्ता अच्छी है, तो Address Validation API
formattedAddress
. - अगर आपने सुधार कर लिया है, तो आपके पास उस पते को उपयोगकर्ता को दिखाने का विकल्प भी होता है किया गया हो या कोई सुधार न होने पर चुपचाप स्वीकार किया जाता हो.
- उपयोगकर्ता के न्योता स्वीकार करने के बाद, डेटाबेस में
formattedAddress
को कैश मेमोरी में सेव किया जा सकता है.
नतीजा
हाई वॉल्यूम वाले पते की पुष्टि करने की सुविधा, इस्तेमाल का एक आम उदाहरण है. इस सुविधा का इस्तेमाल आम तौर पर किया जा सकता है इस्तेमाल करते हैं. इस दस्तावेज़ में कुछ खास स्थितियों को दिखाने की कोशिश की गई है. साथ ही, इस तरह के समाधान को लागू करने का तरीका बताने वाला डिज़ाइन पैटर्न प्लैटफ़ॉर्म की सेवा की शर्तें.
हमने इसके अलावा, हाई वॉल्यूम वाले पते के इस्तेमाल के बारे में एक रेफ़रंस भी लिखा है GitHub पर ओपन सोर्स लाइब्रेरी के तौर पर पुष्टि करना. शुरू करने के लिए इसे देखें तेज़ आवाज़ में पते की पुष्टि करने की सुविधा को तेज़ कर दिया है. साथ ही, इस लेख पर जाएं डिज़ाइन पैटर्न हैं.
अगले चरण
भरोसेमंद पतों की मदद से चेकआउट, डिलीवरी, और कार्रवाइयों को बेहतर बनाएं व्हाइटपेपर और संपर्क जानकारी की मदद से चेकआउट, डिलीवरी, और ऑपरेशन को बेहतर बनाना पुष्टि वेबिनार.
आगे पढ़ने के लिए सुझाव:
- बहुत ज़्यादा संख्या में पते की पुष्टि करने के आवेदन
- GitHub पर Python लाइब्रेरी
- पते का डेमो एक्सप्लोर करें पुष्टि
योगदानकर्ता
Google इस लेख को मैनेज करता है. मूल रूप से इन योगदान देने वालों ने इसे लिखा है.
अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है
मुख्य लेखक:
हेनरिक वाल्व | सॉल्यूशंस इंजीनियर
थॉमस एंगलरेट | सुविधाएं
इंजीनियर
सार्थक गांगुली | सुविधाएं
इंजीनियर