處理更新後的地址

在某些情況下，您可能會針對單一地址多次呼叫 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 值。
• 在系列完成前，所有後續要求都應使用這個值。

這個序列圖顯示偏好的流程：