处理更新后的地址

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

本文档介绍了您在向 Google Cloud 控制台发出一系列 向 Address Validation API 发送针对同一地址的请求。这些操作包括 这并非严格的使用要求,但可以帮助您提高 整体数据质量和系统响应。

  • provideValidationFeedback 端点发送请求
  • 设置 previousResponseID 字段

发送 provideValidationFeedback 请求

在一系列验证结束时,Google 建议您调用 提供 Validation Feedback API 以指明 所有验证。该请求设置了两个字段:

  • conclusion - 表示您在服务中使用的验证版本。 无论它是用户提供的网址,还是从 Address Validation API。
  • responseId - 表示响应中的第一个响应的 ID 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 字段用于标识您的 侧面: <ph type="x-smartling-placeholder">
      </ph>
    • VALIDATED_VERSION_USED:来自 的已验证地址版本 地址验证 API。
    • USER_VERSION_USED:用户提供的原始版本。
    • UNVALIDATED_VERSION_USED:提示 但未使用 Address Validation API 重新验证该地址。
    • UNUSED:放弃了交易。
请参阅参考指南中的验证结论
  • responseId 字段用于指定您要验证的地址验证结果 提供反馈。此值必须与 responseId 相同 首次调用返回的值, validateAddress 方法。
请参阅验证反馈参考指南中的请求正文

设置 previousResponseID 字段

针对指定地址发出后续请求时,将 Address Validation API 设置为 previousResponseId 字段中的值。

  • 对于 previousResponseId 的值,请使用 responseId 中的值 第一个验证请求之后返回的值。
  • 对该系列图书发布之前的所有后续要求使用相同的值 。

以下序列图显示了首选流程:

使用响应 ID 验证地址。