處理更新後的地址

在某些情況下，您可能會針對單一地址多次呼叫 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 值相同。
請參閱驗證意見參考指南中的「Request Body」一節。

設定 previousResponseID 欄位

針對特定地址發出 Address Validation API 後續要求時，請設定 previousResponseId 欄位。

  • 針對 previousResponseId 的值，請使用 第一個驗證要求後，API 傳回的 responseId 值。
  • 在系列活動結束前，請為所有後續要求使用相同的值。

下圖是所需流程的順序圖：

使用回應 ID 驗證地址。