अपडेट किए गए पते मैनेज करना

कुछ मामलों में, कभी-कभी एक ही पते की पुष्टि के लिए, Address Validation API को कई बार कॉल किया जा सकता है. उदाहरण के लिए, पहली बार पुष्टि के नतीजे देखने के बाद, ग्राहक अपने पते में बदलाव कर सकता है. इसके बाद, अपडेट किए गए पते की दोबारा पुष्टि करें.

इस दस्तावेज़ में उन दो मुख्य कार्रवाइयों के बारे में बताया गया है जो Address Validation API को एक ही पते के लिए कई अनुरोध जारी करते समय की जा सकती हैं. इन कार्रवाइयों का इस्तेमाल इस्तेमाल करने के लिए ज़रूरी नहीं है. हालांकि, इनसे डेटा की क्वालिटी और सिस्टम के रिस्पॉन्स को बेहतर बनाने में मदद मिलती है.

• provideValidationFeedback एंडपॉइंट पर अनुरोध भेजें
• previousResponseID फ़ील्ड को सेट करें

provideValidationFeedback का अनुरोध भेजें

पुष्टि करने की सीरीज़ के आखिर में, Google का सुझाव है कि आप सभी पुष्टि के आखिरी नतीजों के बारे में बताने के लिए, Validation Feedback API को कॉल करें. अनुरोध दो फ़ील्ड सेट करता है:

• conclusion — से पता चलता है कि आपने अपनी सेवा में पुष्टि करने के लिए कौनसा वर्शन इस्तेमाल किया है. भले ही, वह वर्शन उपयोगकर्ता ने दिया हो या फिर Address Validation API से मिला वर्शन.
• responseId — यह पते की पुष्टि करने वाले एपीआई से मिले पहले रिस्पॉन्स के रिस्पॉन्स आईडी को दिखाता है. नीचे पिछलाResponseId फ़ील्ड सेट करें देखें.

इनमें से किसी एक provideValidationFeedback मेथड (REST) या ProvideValidationFeedback मेथड (gRPC) का इस्तेमाल करें.

इस उदाहरण में, नतीजे के बारे में बताने वाले अनुरोध में JSON का मुख्य हिस्सा पास किया गया है:

curl -X POST -d '{
  "conclusion": "VALIDATED_VERSION_USED",
  "responseId": "de22bed8-7f52-44cb-8526-faceac57150a"
}' \
-H 'Content-Type: application/json' \
"https://addressvalidation.googleapis.com/v1:provideValidationFeedback?key=API_KEY"

• conclusion फ़ील्ड, आपकी तरफ़ से इनमें से किसी एक कार्रवाई की पहचान करता है:
  • VALIDATED_VERSION_USED: पते की पुष्टि करने वाले एपीआई से मिले पते का पुष्टि किया गया वर्शन.
  • USER_VERSION_USED: उपयोगकर्ता की ओर से दिया गया मूल वर्शन.
  • UNVALIDATED_VERSION_USED: वह वर्शन जो लोगों को निर्देश देने पर मिला था, लेकिन उसने Address Validation API की मदद से उसकी दोबारा पुष्टि नहीं की थी.
  • UNUSED: लेन-देन को छोड़ दिया गया.

रेफ़रंस गाइड में पुष्टि करने का तरीका देखें.

• responseId फ़ील्ड से पता चलता है कि पते की पुष्टि के लिए किस नतीजे के लिए सुझाव दिया जा रहा है. यह वैल्यू वही होनी चाहिए जो responseId की वैल्यू, first कॉल के दौरान मिले और validateAddress तरीके से मिली वैल्यू के बराबर हो.

पुष्टि करने से जुड़े सुझाव की रेफ़रंस गाइड में अनुरोध का मुख्य हिस्सा देखें.

previousResponseID फ़ील्ड को सेट करें

दिए गए पते के लिए, Address Validation API का फ़ॉलो-अप अनुरोध जारी करते समय previousResponseId फ़ील्ड सेट करें.

• previousResponseId की वैल्यू के लिए, पहले पुष्टि करने के अनुरोध के बाद, एपीआई से मिली responseId की वैल्यू का इस्तेमाल करें.
• सीरीज़ पूरी होने तक, किसी भी और सभी फ़ॉलोअप अनुरोधों के लिए इसी वैल्यू का इस्तेमाल करें.

इस क्रम का डायग्राम, पसंदीदा फ़्लो दिखाता है: