處理更新後的地址

在某些情況下，您可以針對單一地址對 Address Validation API 進行多次呼叫。例如，客戶可能會在看到首次驗證結果後變更地址。然後對更新後的地址進行第二次驗證。

本文件說明對同一個位址發出一系列要求並傳送至 Address Validation API 時，您可以採取的兩項主要動作。這些動作並非嚴格的使用要求，而您可採取實用的行動，改善整體資料品質和系統回應。

  • 傳送要求至 provideValidationFeedback 端點
  • 設定 previousResponseID 欄位

傳送provideValidationFeedback要求

完成一系列驗證程序後，Google 建議您呼叫「提供驗證意見回饋 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 驗證地址。