在某些情況下,您可能會對單一位址發出多次呼叫 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
欄位會指定您要提供意見回饋給哪些地址驗證結果。這個值必須與 first 呼叫 validateAddress 方法所傳回的responseId
值相同。
請參閱驗證意見回饋參考指南中的「要求主體」。 |
設定 previousResponseID
欄位
當您針對特定地址發出後續追蹤要求時,請設定 previousResponseId
欄位。
- 針對
previousResponseId
的值,請在提出第一個驗證要求後,使用 API 傳回的responseId
值。 - 在系列作業完成前,任何及所有後續要求都使用相同的值。
下方序列圖顯示偏好的流程: