处理更新后的地址

在某些情况下，您可能会针对单个地址多次调用 Address Validation API。例如，客户在看到第一次验证的结果后，可能会更改地址。然后，您需要对更新后的地址进行第二次验证。

本文档介绍了当您向 Address Validation API 发出针对同一地址的一系列请求时可以执行的两项关键操作。这些操作并非严格的使用要求，但对您来说，采取这些操作有助于提高整体数据质量和系统响应速度。

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

发送 provideValidationFeedback 请求

在一系列验证结束后，Google 建议调用 Provide Validation Feedback API 来指明所有验证的最终结果。该请求会设置两个字段：

  • conclusion - 表示您在服务中使用的验证版本，无论是用户提供的版本，还是从 Address Validation API 返回的版本。
  • responseId - 表示 Address Validation API 中第一个响应的响应 ID。请参阅下文中的设置 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 字段用于标识您执行的以下操作之一：
    • VALIDATED_VERSION_USED：Address Validation API 中经过验证的地址版本。
    • USER_VERSION_USED：用户提供的原始版本。
    • UNVALIDATED_VERSION_USED：系统向用户提示后生成的版本，但未使用 Address Validation API 对其进行重新验证。
    • UNUSED：放弃了事务。
请参阅参考指南中的验证结论。
  • responseId 字段指定您要提供反馈的地址验证结果。此值必须与对 validateAddress 方法的首次调用返回的 responseId 值相同。
请参阅验证反馈参考指南中的请求正文。

设置 previousResponseID 字段

针对给定地址向 Address Validation API 发出后续请求时，请设置 previousResponseId 字段。

  • 对于 previousResponseId 的值，请使用 API 在第一次验证请求后返回的 responseId 中的值。
  • 在系列请求完成之前，请对所有后续请求使用相同的值。

下图序列图展示了首选流程：

使用响应 ID 验证地址。