पुष्टि करने वाला लॉजिक बनाएं

इस दस्तावेज़ में पते की जांच करने वाला एक सिस्टम बनाने की प्रक्रिया के बारे में बताया गया है. पते की पुष्टि करने वाले एपीआई से अलग-अलग तरह के रिस्पॉन्स को हैंडल करने की सुविधा मिलती है. इसमें बताया गया है कि रिस्पॉन्स का सही तरीके से इस्तेमाल करने, अन्य सिग्नल की जांच करने के लिए, अपना लॉजिक बनाएं के बारे में जानकारी मिलेगी. साथ ही, अपने ग्राहकों को ज़्यादा जानकारी कब और कैसे देनी चाहिए.

आम तौर पर, एपीआई रिस्पॉन्स इन तरीकों से तय करता है कि आपके सिस्टम को एक पते का प्रबंधन करें:

  • अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है ठीक करें—पते की क्वालिटी अच्छी नहीं है. आपको ज़्यादा जानकारी देनी चाहिए.
  • अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है पुष्टि करें—पता अच्छी क्वालिटी का है, लेकिन उसमें है डालें. आप पुष्टि करने के लिए.
  • अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है स्वीकार करें—पता अच्छी क्वालिटी का है. आप दिया गया पता स्वीकार करें.

मुख्य मकसद

यह दस्तावेज़, एपीआई के रिस्पॉन्स का सबसे सही विश्लेषण करने और सिस्टम में बदलाव करने में आपकी मदद करता है दिए गए पतों के साथ आगे की कार्रवाईयां तय करेंगे. नीचे दिए गए स्यूडोकोड, संभावित फ़्लो को दिखाता है.

if (the API response indicates significant problems in the address)
    FIX - prompt the user to fix the address
else if (the API response indicates less significant problems in the address)
    CONFIRM - confirm with the user that the address is correct
else
    ACCEPT - continue with the address returned by the API.

सटीक तर्क आपकी स्थिति पर निर्भर करता है - लागू करने से जुड़े दिशा-निर्देश देखें देखें. इस लॉजिक को लागू करने के लिए, ओपन सोर्स का इस्तेमाल भी किया जा सकता है. जो एक्सटेंडेड कॉम्पोनेंट लाइब्रेरी में मौजूद हो.

वर्कफ़्लो की खास जानकारी

नीचे दी गई टेबल में, आपके सिस्टम से जुड़ी दो कार्रवाइयों के बारे में खास जानकारी दी गई है:

  1. समस्या को ठीक करने, उसकी पुष्टि करने, और उसे स्वीकार करने के तरीके के आधार पर, इस्तेमाल के लिए वर्कफ़्लो.
  2. जवाब में मौजूद पहला सिग्नल जिसकी जांच करनी होती है. सिग्नल यहां बताई गई क्वेरी verdict प्रॉपर्टी से ली गई हैं. ये सिर्फ़ एक से ज़्यादा नहीं हैं सिग्नल भेजे जाते हैं, लेकिन पते के बारे में शुरुआती इंडिकेटर देते हैं क्वालिटी. हर तरह का व्यवहार इस दस्तावेज़ के किसी सेक्शन से जुड़ा हुआ है उन सिग्नल के बारे में बताएं जिनकी आपको जांच करनी पड़ सकती है.
आपके सिस्टम का व्यवहार
अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है पता ठीक करें

verdict से मिले जवाब से पता चलता है कि अहम जानकारी मौजूद नहीं है दी जानी चाहिए. वह पता जो शायद पते की पुष्टि करने वाला एपीआई, डिलीवर करने लायक क्वालिटी वाला न हो.

वर्कफ़्लो

  1. अगर ज़रूरी हो, तो पते के कॉम्पोनेंट की जांच करें.
  2. ग्राहक को पते से जुड़ी समस्याओं को ठीक करने के लिए कहें.
  3. अपडेट किए गए पते की पुष्टि का अनुरोध करें.
  4. (ज़रूरी नहीं) एपीआई के लिए सुझाव एंडपॉइंट पर अनुरोध भेजें. अपडेट किए गए पते मैनेज करना देखें.
  5. पते के साथ आगे बढ़ें.

फ़ैसले के सिग्नल

इनमें से कोई भी लागू होगा:
अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है पते की पुष्टि करें

verdict से मिला जवाब बताता है कि डिलीवर किया जा सकता है पते में बदलाव कर दिया है, लेकिन मूल इनपुट में बदलाव किए हैं: की स्पेलिंग ठीक की जाती है या ऐसा डेटा जिसकी पुष्टि की जा सकती है.

वर्कफ़्लो

  1. सुधार करने की ज़रूरत है:
    1. अगर ज़रूरी हो, तो पते के कॉम्पोनेंट की जांच करें.
    2. अपडेट किए गए पते की पुष्टि का अनुरोध करें.
    3. (ज़रूरी नहीं) एपीआई के लिए सुझाव एंडपॉइंट पर अनुरोध भेजें. अपडेट किए गए पते मैनेज करना देखें.
    4. पते के साथ आगे बढ़ें.
  2. किसी बदलाव की ज़रूरत नहीं है:
    1. (ज़रूरी नहीं) एपीआई के लिए सुझाव एंडपॉइंट पर अनुरोध भेजें. अपडेट किए गए पते मैनेज करना देखें.
    2. पते के साथ आगे बढ़ें.

फ़ैसले के सिग्नल

नीचे दिए गए सभी लागू होते हैं:

  • validationGranularity में ROUTE शामिल होता है या बेहतर. जानकारी का लेवल देखें वैल्यू.
  • addressComplete true है.
  • hasInferredComponents फ़ील्ड की वैल्यू true है या फिर hasReplacedComponents फ़ील्ड true है.
अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है पता स्वीकार करें

पता की पुष्टि करने वाले एपीआई से मिले रिस्पॉन्स का मतलब है कि पते की क्वालिटी अच्छी है.

वर्कफ़्लो

दिए गए पते के साथ आगे बढ़ें.

फ़ैसले के सिग्नल

नीचे दिए गए सभी लागू होते हैं:

  • validationGranularity में PREMISE शामिल होता है या बेहतर. जानकारी का लेवल देखें.
  • addressComplete true है.
  • कोई कॉम्पोनेंट नहीं या उसका अनुमान लगाया गया या कोई कॉम्पोनेंट बदला गया.

लागू करने के लिए सलाह

यह तय करते समय कि सिस्टम, Address Verified API से मिलने वाले सिग्नल के जवाब कैसे देता है, तो इन सुझावों से आपको ज़्यादा असरदार जवाब देने में मदद मिल सकती है मॉडल. हालांकि, ये सिर्फ़ सुझाव हैं. इसलिए, ध्यान रखें कि आपके कारोबार के मॉडल से मेल खाना चाहिए.

सलाह जानकारी
जोखिम का स्तर

लेवल को ध्यान में रखें प्रॉम्प्ट के बीच संतुलन बनाते समय, अपनी स्थिति के हिसाब से दिए गए पते को स्वीकार करना और उसमें सुधार करना.

पते की पुष्टि करने वाला एपीआई, कई तरह के सिग्नल दिखाता है जिन्हें जोखिम के लेवल के साथ शामिल करके, पुष्टि की प्रोसेस को ऑप्टिमाइज़ किया जा सकता है प्रोसेस.

उदाहरण के लिए, अगर किसी पते में अपुष्ट सड़क संख्या है, तो आप फिर भी इसे स्वीकार करें. दूसरी ओर, अगर आपके कारोबार के लिए ज़रूरी है पता सटीक है, तो आप अपने उपयोगकर्ता को संकेत दे सकते हैं. उदाहरण के लिए, किसी भी कैटगरी में आ सकता है. ऐसी सड़क संख्या जिसकी पुष्टि नहीं हुई है पता स्वीकार करें - उदाहरण में.
पते स्वीकार करें

अपने सिस्टम को मूल एंट्री स्वीकार करने की अनुमति देना एक अच्छा तरीका है अगर ग्राहक सवालों का जवाब नहीं देता है.

इन मामलों में, हो सकता है कि ग्राहक ने वह पता डाला हो जो में नहीं है जैसे, कोई नया सामान बनाने में.
सुझाव दें

पते की पुष्टि करने का अनुरोध फिर से जारी करके, ये काम किए जा सकते हैं साथ ही, provideValidationFeedback एंडपॉइंट पर अनुरोध भेजें.

इससे Google को पता चलता है कि आपने आखिरी जवाब को कैसे मैनेज किया. अपडेट किए गए पते मैनेज करना देखें.

किसी पते को ठीक करना

पते की जानकारी ठीक करें, जब नतीजों में साफ़ तौर पर पता चले कि वह सही नहीं था डिलीवर किया जा सकता है. इसके बाद, आपका सिस्टम ग्राहक से ज़रूरी शर्तें पूरी करने के लिए कह सकता है इसके बाद, डिलीवरी पाने के लिए अपना वर्कफ़्लो फिर से जारी किया जाता है इससे पहले ही अपने कारोबार के हिसाब से name@yourcompany.com जैसा कोई ईमेल पता बनाएं.

सिग्नल ठीक करें

पते की पुष्टि करने वाला एपीआई कई सिग्नल की मदद से यह बताता है कि पते की जानकारी ठीक की जानी चाहिए.

1. पुष्टि करने का स्तर और कुछ कॉम्पोनेंट मौजूद नहीं हैं

ये दो सिग्नल, किसी समस्या वाले पते का सबसे अच्छा संकेत देते हैं:

  • जब भी validationGranularity फ़ील्ड OTHER हो, तो आपके सिस्टम को गड़बड़ी के बारे में ज़्यादा जानने के लिए, पते के कॉम्पोनेंट के सिग्नल की जांच करना समस्या हुई और उसे कैसे ठीक किया जाए.
  • जब भी पोस्ट-प्रोसेस किया गया address ऑब्जेक्ट missingComponentTypes फ़ील्ड है, तो आपके सिस्टम को उस कॉम्पोनेंट की जांच करनी चाहिए. छूटे हुए कॉम्पोनेंट भी किसी पते को अधूरे कॉन्टेंट के तौर पर दिखाते हैं और उसे डिलीवर नहीं किया जा सकता.

2. पेज के लिए सही ऑडियंस तय करने के दूसरे तरीके

पते की पुष्टि करने वाला एपीआई, मदद करने के लिए दूसरे सिग्नल भी देता है विशिष्ट समस्याओं का विश्लेषण करें:

संदिग्ध कॉम्पोनेंट जब किसी कॉम्पोनेंट के लिए पुष्टि करने के लेवल की सूची यह होती है UNCOMFIRMED_AND_SUSPICIOUS, शायद यह कॉम्पोनेंट गलत.
कॉम्पोनेंट की समस्या को हल नहीं किया गया एक unresolvedToken इनपुट का वह हिस्सा है जिसकी पहचान पते के मान्य हिस्से के रूप में नहीं की गई है.

3. अमेरिका के पते के सिग्नल

सिर्फ़ अमेरिका के पतों पर लागू कुछ फ़ील्ड से काम का सिग्नल मिलता है कि इस पते पर डिलीवरी नहीं की जा सकती और इसे ठीक किया जाना चाहिए. किसी ऐसे पते के लिए जिसे ठीक करने के बाद, आपको यह जानकारी दिखेगी:

dpvConfirmation N, D या खाली.

dpvConfirmation के बारे में जानकारी पाने के लिए, इसे देखें अमेरिका के पते मैनेज करें.

पते के उदाहरण

पते की पुष्टि करें

जब नतीजे से पता चलता है कि Address Validation API से मिला है, तब पते की पुष्टि की जाती है पता कॉम्पोनेंट का अनुमान लगाया जाता है या उसमें बदलाव किया जाता है, ताकि सत्यापित पता. इन मामलों में, आपके पास डिलीवर किया जाने वाला पता होता है, लेकिन आपको पूरा भरोसा होगा कि नतीजे के तौर पर मिला पता वही है जिसका मकसद ग्राहक.

ग्राहक को सही प्रॉम्प्ट देने के लिए, आपका लॉजिक एपीआई को कौनसी कार्रवाई या फ़्लैग किया गया, यह तय करने के लिए सेवा के फ़्लैग किए गए कॉम्पोनेंट कॉम्पोनेंट पर लागू किया जाता है, जैसे कि inferred, replaced या spellCorrected. रेफ़रंस में AddressComponent देखें.

सिग्नल की पुष्टि करें

पते की पुष्टि करने वाला एपीआई कई सिग्नल की मदद से यह बताता है कि पते की पुष्टि होनी चाहिए.

1. पुष्टि की जानकारी का स्तर

ROUTE या इससे बेहतर का validationGranularity स्वीकार किया जा सकता है, लेकिन या तो PREMISE या SUBPREMISE, डिलीवर करने की संभावना का बेहतर सिग्नल देता है.

2. पेज के लिए सही ऑडियंस तय करने के दूसरे तरीके

ग्राहक से पता डालने की पुष्टि करते समय, यह फ़ैसला भी इस जानकारी से यह तय होता है कि किन कॉम्पोनेंट की जांच करनी है:

अनुमानित डेटा जब hasInferredComponents फ़ील्ड true हो, तो आपको पता है कि एपीआई ने अन्य पतों से इकट्ठा की गई जानकारी भरी है कॉम्पोनेंट.
बदला गया डेटा जब hasReplacedComponents फ़ील्ड true होता है, तो एपीआई ने, डाले गए डेटा की जगह वह डेटा डाल दिया है जो पते को मान्य लगता है.

3. अमेरिका के पते के सिग्नल

सिर्फ़ अमेरिका के पतों पर लागू होने वाले कुछ फ़ील्ड दिखाते हैं कि आपके लॉजिक को ग्राहक से जानकारी की पुष्टि करें. इनमें से कोई एक स्थिति लागू होगी:

dpvConfirmation S

dpvConfirmation के बारे में जानकारी पाने के लिए, इसे देखें अमेरिका के पते मैनेज करें.
पते का जवाब इसमें missingComponentType फ़ील्ड शामिल है, जिसकी वैल्यू subpremise.

पते की पुष्टि करने के उदाहरण

पता स्वीकार करें

आप पते की पुष्टि तब करें, जब नतीजा बहुत ज़्यादा भरोसेमंद हो यह पता डिलीवर किया जा सकता है और इसका इस्तेमाल, खरीदार से इंटरैक्शन के बिना किया जा सकता है काफ़ी कम जानकारी है.

सिग्नल स्वीकार करें

पते की पुष्टि करने वाला एपीआई कई सिग्नल की मदद से यह बताता है कि पते की पुष्टि होनी चाहिए.

1. पुष्टि की जानकारी का स्तर

PREMISE या इससे बेहतर का validationGranularity स्वीकार किया जा सकता है, लेकिन कुछ मामलों में, ROUTE अब भी डिलीवर किया जा सकने वाला पता दिखाता है.

2. पेज के लिए सही ऑडियंस तय करने के दूसरे तरीके

अच्छी क्वालिटी वाले पते के नतीजे में यह जानकारी भी दी जानी चाहिए:

  • कोई बदला गया डेटा नहीं है. इस मामले में, hasReplacedComponents: FALSE.
  • कोई कॉम्पोनेंट नहीं बताया गया है. इस मामले में, hasInferredComponents: FALSE.

3. अमेरिका के पते के सिग्नल

सिर्फ़ अमेरिका के पतों पर लागू होने वाले कुछ फ़ील्ड, अच्छी क्वालिटी वाले पते का संकेत देते हैं जिसे डिलीवर किया जा सकता है. अमेरिका के मान्य पते के लिए, आपको फ़ॉलो किया जा रहा है:

dpvConfirmation Y

dpvConfirmation के बारे में जानकारी पाने के लिए, इसे देखें अमेरिका के पते मैनेज करें.

पते के उदाहरण स्वीकार करना

पीछे जाएं
मूल जवाब को समझना