संग्रह की मदद से व्यवस्थित रहें
अपनी प्राथमिकताओं के आधार पर, कॉन्टेंट को सेव करें और कैटगरी में बांटें.
कुछ मामलों में, एक ही पते के लिए Address Validation API को कई कॉल किए जा सकते हैं. उदाहरण के लिए, पहली बार पुष्टि करने के नतीजे देखने के बाद, ग्राहक अपने पते में बदलाव कर सकता है. इसके बाद, आपको अपडेट किए गए पते की दूसरी बार पुष्टि करनी होगी.
इस दस्तावेज़ में, एक ही पते के लिए Address Validation API को कई अनुरोध भेजने पर, दो मुख्य कार्रवाइयों के बारे में बताया गया है. ये कार्रवाइयां, इस्तेमाल की ज़रूरी शर्तें नहीं हैं. हालांकि, डेटा की क्वालिटी और सिस्टम के जवाब को बेहतर बनाने के लिए, ये कार्रवाइयां करना आपके लिए मददगार हो सकता है.
provideValidationFeedback एंडपॉइंट पर अनुरोध भेजना
previousResponseID फ़ील्ड सेट करना
provideValidationFeedback अनुरोध भेजना
पुष्टि की पूरी प्रक्रिया के आखिर में, Google का सुझाव है कि आप Provide Validation Feedback API को कॉल करें. इससे, आपको सभी पुष्टि के नतीजों के बारे में पता चलेगा. अनुरोध में दो फ़ील्ड सेट किए जाते हैं:
conclusion — इससे पता चलता है कि आपने अपनी सेवा में पुष्टि करने के लिए किस वर्शन का इस्तेमाल किया है. इससे यह भी पता चलता है कि यह वर्शन, उपयोगकर्ता ने दिया है या Address Validation API से मिला है.
responseId — इससे पता चलता है कि Address Validation API से मिले पहले रिस्पॉन्स का रिस्पॉन्स आईडी क्या है. previousResponseId फ़ील्ड सेट करना देखें.
responseId फ़ील्ड से पता चलता है कि पते की पुष्टि के किन नतीजों के लिए आपको सुझाव/राय देनी है. यह वैल्यू, validateAddress तरीके के पहले कॉल से मिली responseId वैल्यू के बराबर होनी चाहिए.
पुष्टि से जुड़े सुझाव/राय/शिकायत/राय देने के लिए रेफ़रंस गाइड में, अनुरोध का मुख्य हिस्सा देखें.
previousResponseID फ़ील्ड सेट करना
किसी पते के लिए, Address Validation API से फ़ॉलो-अप अनुरोध करते समय, previousResponseId फ़ील्ड सेट करें.
previousResponseId की वैल्यू के लिए, पुष्टि के पहले अनुरोध के बाद एपीआई से मिली responseId की वैल्यू का इस्तेमाल करें.
सीरीज़ पूरी होने तक, सभी फ़ॉलोअप अनुरोधों के लिए एक ही वैल्यू का इस्तेमाल करें.
[[["समझने में आसान है","easyToUnderstand","thumb-up"],["मेरी समस्या हल हो गई","solvedMyProblem","thumb-up"],["अन्य","otherUp","thumb-up"]],[["वह जानकारी मौजूद नहीं है जो मुझे चाहिए","missingTheInformationINeed","thumb-down"],["बहुत मुश्किल है / बहुत सारे चरण हैं","tooComplicatedTooManySteps","thumb-down"],["पुराना","outOfDate","thumb-down"],["अनुवाद से जुड़ी समस्या","translationIssue","thumb-down"],["सैंपल / कोड से जुड़ी समस्या","samplesCodeIssue","thumb-down"],["अन्य","otherDown","thumb-down"]],["आखिरी बार 2024-12-05 (UTC) को अपडेट किया गया."],[[["\u003cp\u003eWhen validating an address multiple times, use the \u003ccode\u003eprovideValidationFeedback\u003c/code\u003e endpoint to inform Google of the final address version used.\u003c/p\u003e\n"],["\u003cp\u003eInclude the original response ID in the \u003ccode\u003eprovideValidationFeedback\u003c/code\u003e request and set the \u003ccode\u003epreviousResponseId\u003c/code\u003e for subsequent validation calls to improve data quality and response time.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003econclusion\u003c/code\u003e field in the feedback request indicates whether the user's original, a validated, or another address version was ultimately used.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003epreviousResponseId\u003c/code\u003e helps the API understand the context of the address validation sequence and potentially optimize results.\u003c/p\u003e\n"]]],[],null,["In some cases, you might make multiple calls to the\nAddress Validation API for a single address. For example, the customer might make\nchanges to their address after seeing the results of the first\nvalidation. You then perform a second validation on the updated address.\n\nThis document describes two key actions you can take when you issue a series of\nrequests for the same address to the Address Validation API. These actions are\nnot a strict usage requirement, but a helpful action on your part to improve\noverall data quality and system response.\n\n- Send a request to the `provideValidationFeedback` endpoint\n- Set the `previousResponseID` field\n\nSend a `provideValidationFeedback` request\n\nAt the end of a series of validations, Google recommends making a call to the\nProvide Validation Feedback API to indicate the final outcome of\nall the validations. The request sets two fields:\n\n- `conclusion` --- Indicates the validation version you used in your service, whether it was the one provided by the user, or the one returned from the Address Validation API.\n- `responseId` --- Indicates the response ID of the **first** response from the Address Validation API. See [Set the previousResponseId field](#followup-requests) below.\n\nUse either the\n[provideValidationFeedback](/maps/documentation/address-validation/reference/rest/v1/TopLevel/provideValidationFeedback)\nmethod (REST) or\n[ProvideValidationFeedback](/maps/documentation/address-validationreference/rpc/google.maps.addressvalidation.v1#google.maps.addressvalidation.v1.AddressValidation.ProvideValidationFeedback)\nmethod (gRPC).\n\nThe following example passes a [JSON body](/maps/documentation/address-validation/reference/rest/v1/TopLevel/validateAddress#request-body) to the request defining the\nconclusion: \n\n```json\ncurl -X POST -d '{\n \"conclusion\": \"VALIDATED_VERSION_USED\",\n \"responseId\": \"de22bed8-7f52-44cb-8526-faceac57150a\"\n}' \\\n-H 'Content-Type: application/json' \\\n\"https://addressvalidation.googleapis.com/v1:provideValidationFeedback?key=\u003cvar translate=\"no\"\u003eAPI_KEY\u003c/var\u003e\"\n```\n\n- The `conclusion` field identifies one of the following actions from your side:\n - `VALIDATED_VERSION_USED`: the validated version of the address from the Address Validation API.\n - `USER_VERSION_USED`: the original version provided by the user.\n - `UNVALIDATED_VERSION_USED`: a version that was a result of a prompt to the user, but did not re-validate it with the Address Validation API.\n - `UNUSED`: abandoned the transaction.\n\n|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| See [Validation Conclusion](/maps/documentation/address-validation/reference/rest/v1/TopLevel/provideValidationFeedback#validationconclusion) in the reference guide. |\n\n- The `responseId` field specifies which address validation results you are providing feedback for. This value must be the same as the `responseId` value returned by the **first** call to the [validateAddress](/maps/documentation/address-validation/reference/rest/v1/TopLevel/validateAddress) method.\n\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| See [Request Body](/maps/documentation/address-validation/reference/rest/v1/TopLevel/provideValidationFeedback#request-body) in the validation feedback reference guide. |\n\nSet the `previousResponseID` field\n\nWhen issuing a follow-up request the Address Validation API for a given address, set\nthe `previousResponseId` field.\n\n- For the value of the `previousResponseId`, use the value from the `responseId` returned by API after the **first** validation request.\n- Use this same value for any and all followup requests until the series completes.\n\nThis sequence diagram shows the preferred flow:"]]
