पते की पुष्टि करने के बारे में सुझाव दें

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

पते की पुष्टि करने के लिए सुझाव, शिकायत या राय का अनुरोध

पते की पुष्टि करने के किसी तरीके पर कॉल करने के बाद सुझाव देने के लिए, provideValidateFeedback तरीका (REST) या वेलाइज़ेशनफ़ीडबैक तरीका (gRPC) कॉल करें. यहां दिए गए उदाहरण में, REST API को पोस्ट करने का अनुरोध किया गया है:

https://addressvalidation.googleapis.com/v1:provideValidationFeedback?key=YOUR_API_KEY

पते की पुष्टि का नतीजा तय करने के लिए, पोस्ट अनुरोध के लिए एक JSON का हिस्सा पास करें:

{
  "conclusion": "VALIDATED_VERSION_USED",
  "responseId": "de22bed8-7f52-44cb-8526-faceac57150a"
}

जगह:

  • conclusion फ़ील्ड से, पुष्टि का असल नतीजा दिखना चाहिए.

    इस उदाहरण में, conclusion फ़ील्ड की वैल्यू के तौर पर VALIDATED_VERSION_USED को पास किया जाता है. इससे यह पता चलता है कि एपीआई ने वही पता इस्तेमाल किया था जिसका इस्तेमाल आपने किया था.

    अगर आप आखिर में असली उपयोगकर्ता के दिए गए पते का इस्तेमाल करते हैं, तो USER_VERSION_USED पास करें.

    conclusion के लिए सभी संभावित वैल्यू के लिए, VerificationConclusion देखें.

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

    validateAddress तरीके को कॉल करने के बारे में जानने के लिए, पते की पुष्टि करना सेक्शन देखें.

responseID को सेट करने का तरीका

पते की पुष्टि करने वाले हर एपीआई कॉल के लिए, रिस्पॉन्स के responseId फ़ील्ड में एक यूनीक वैल्यू दिखती है.

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

अगर किसी ऐसे पते की फिर से पुष्टि करनी है जिसकी पुष्टि करनी है, तो सभी फ़ॉलो-अप अनुरोधों के previousResponseId फ़ील्ड में, पहले जवाब से responseId को पते की पुष्टि करने वाले एपीआई में भेजें.

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

अपडेट किए गए पते की पुष्टि करने के बारे में ज़्यादा जानने के लिए, अपडेट किए गए पते की पुष्टि करना लेख पढ़ें.

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

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

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