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

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

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

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

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

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

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

इनमें से किसी एक का इस्तेमाल करें provideValidationFeedback तरीका (REST) या ProvideValidationFeedback तरीका चुनें (gRPC).

नीचे दिए गए उदाहरण में, निष्कर्ष:

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

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

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

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

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

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