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

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

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

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

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

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

• conclusion — से पता चलता है कि पुष्टि करने के लिए आपने अपनी सेवा में किस वर्शन का इस्तेमाल किया है. फिर चाहे वह वही अनुरोध हो जिसे उपयोगकर्ता ने उपलब्ध कराया था या पते की पुष्टि करने वाला एपीआई.
• 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 की वैल्यू का इस्तेमाल करें पहले पुष्टि के अनुरोध के बाद, एपीआई से यह नतीजा मिलता है.
• सीरीज़ आने तक, किसी भी और सभी फ़ॉलोअप अनुरोधों के लिए इस वैल्यू का इस्तेमाल करें पूरा करता है.

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