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

कुछ मामलों में, एक ही पते के लिए 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: पते की पुष्टि करने वाले एपीआई से मिले पते का पुष्टि किया गया वर्शन.
    • USER_VERSION_USED: उपयोगकर्ता का दिया गया ओरिजनल वर्शन.
    • UNVALIDATED_VERSION_USED: यह वह वर्शन है जो उपयोगकर्ता को दिए गए प्रॉम्प्ट के नतीजे के तौर पर मिला था. हालांकि, Address Validation API की मदद से इसकी फिर से पुष्टि नहीं की गई.
    • UNUSED: लेन-देन पूरा नहीं किया.
रेफ़रंस गाइड में, पुष्टि का नतीजा देखें.
  • responseId फ़ील्ड से पता चलता है कि पते की पुष्टि के किन नतीजों के लिए आपको सुझाव/राय देनी है. यह वैल्यू, validateAddress तरीके के पहले कॉल से मिली responseId वैल्यू के बराबर होनी चाहिए.
पुष्टि करने के बारे में सुझाव/राय देने या शिकायत करने से जुड़ी गाइड में अनुरोध का मुख्य हिस्सा देखें.

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

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

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

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

किसी पते की पुष्टि करने के लिए, रिस्पॉन्स आईडी का इस्तेमाल करें.