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

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

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

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

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

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

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

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: Address Validation API से पुष्टि किया गया पता.
  • USER_VERSION_USED: उपयोगकर्ता ने जो ओरिजनल वर्शन दिया है.
  • UNVALIDATED_VERSION_USED: यह ऐसा वर्शन है जो उपयोगकर्ता को दिए गए प्रॉम्प्ट का नतीजा है. हालांकि, Address Validation API से इसकी दोबारा पुष्टि नहीं की गई है.
  • UNUSED: लेन-देन पूरा नहीं किया.

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

previousResponseID फ़ील्ड सेट करना

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

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

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