在某些情况下,您可能会针对单个地址多次调用 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
中的值。 - 在系列请求完成之前,请对所有后续请求使用相同的值。
以下序列图显示了首选流程: