在某些情况下,您可能会针对单个地址多次调用 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
字段
针对指定地址发出后续请求时,请设置 previousResponseId
字段。
- 对于
previousResponseId
的值,请使用第一个验证请求后 API 返回的responseId
中的值。 - 对任何及所有后续请求都使用相同的值,直到系列完成。
以下序列图显示了首选流程: