提供地址验证反馈

为了帮助我们提高 Address Validation API 的质量,您可以选择向 Google 提供反馈,让我们知道最终用户是否接受经过验证的地址。该反馈有助于我们提高 API 的整体准确性。

地址验证反馈请求

如需在调用地址验证方法后提供反馈,请调用 ProvideValidationFeedback 方法 (REST) 或 ProvideValidationFeedback 方法 (gRPC)。以下示例向 REST API 发出 POST 请求:

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

JSON 正文传递给 POST 请求,定义地址验证的总结:

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

其中:

  • conclusion 字段应反映验证的实际结果。

    在此示例中,您将 VALIDATED_VERSION_USED 作为 conclusion 字段的值传递,以表明您最终使用的地址是 API 返回的地址。

    如果您最终使用最终用户提供的地址,请传递 USER_VERSION_USED

    如需了解 conclusion 的所有可能的值,请参阅 ValidationConclusion

  • responseId 字段指定您要针对哪些地址验证结果提供反馈。此值必须与之前调用 validateAddress 方法返回的 responseId 值相同。

    如需查看调用 validateAddress 方法的示例,请参阅验证地址

如何设置responseID

每个 Address Validation API 调用都会在响应的 responseId 字段中返回一个唯一值。

在某些情况下,您可能会对单个地址多次调用 Address Validation API。例如,最终用户可能会在看到首次验证的结果后更改其地址。然后,您对更新后的地址执行第二次验证。

如果要验证的地址需要重新验证,请将所有后续请求 previousResponseId 字段中的第一个响应的 responseId 传递给 Address Validation API。

这些后续请求的每个响应都包含新的 responseId,但请在previousResponseId期间使用第一个 responseId 的值,直到验证完成为止。

如需详细了解如何验证更新后的地址,请参阅验证更新后的地址

在一系列验证结束时,我们建议您调用提供 Validation Feedback API,告诉我们所有验证的最终结果。在“提供验证反馈”API 请求中的第一个响应中传递 responseId

以下序列图显示了所需的流程:

使用回复 ID 验证地址。