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

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

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

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

provideValidationFeedback के लिए अनुरोध भेजें

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

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

provideValidationFeedback तरीके (REST) याProvideValidationFeedback

यहां दिए गए उदाहरण में, नतीजा तय करने वाले अनुरोध के लिए 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: यह ऐसा वर्शन है जो उपयोगकर्ता को प्रॉम्प्ट की वजह से मिला था, लेकिन इसकी पुष्टि करने वाले एपीआई के ज़रिए दोबारा पुष्टि नहीं की गई.
  • UNUSED: लेन-देन छोड़ दिया गया.

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

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

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

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

दिए गए पते के लिए, फ़ॉलो-अप अनुरोध जारी करने के दौरान, पते की पुष्टि करने वाले एपीआई के लिए, previousResponseId फ़ील्ड सेट करें.

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

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