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

कुछ मामलों में, एक ही पते के लिए 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 फ़ील्ड से पता चलता है कि पते की पुष्टि के किन नतीजों के लिए आपको सुझाव/राय देनी है. यह वैल्यू, validateAddress तरीके के पहले कॉल से मिली responseId वैल्यू के बराबर होनी चाहिए.

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

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

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

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

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