處理更新後的地址

在某些情況下，您可以對 單一地址的 Address Validation API。舉例來說，客戶可能在 系統根據 驗證。然後對更新後的地址進行第二次驗證。

本文件說明發布一系列 向 Address Validation API 傳送相同地址的要求。這些動作 並非嚴格的使用規定，而是有助您進行可改善的 整體資料品質和系統回應

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

傳送provideValidationFeedback要求

完成一系列驗證後，Google 建議您呼叫 提供 Validation Feedback API 指出 所有驗證作業這項要求會設定兩個欄位：

  • conclusion — 指出您在服務中使用的驗證版本。 不論內容是由使用者提供， Address Validation API。
  • responseId — 表示來自 Address Validation API。請參閱「設定 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 欄位會指定您要進行的地址驗證結果 提供意見回饋。這個值必須與 responseId 相同 第一個呼叫 validateAddress 方法。
請參閱驗證意見回饋參考指南中的「要求主體」。

設定 previousResponseID 欄位

針對指定地址發出後續追蹤要求時，將 Address Validation API 來進行 previousResponseId 欄位。

  • 針對 previousResponseId 的值，請使用 responseId 的值。 第一個驗證要求之後 API 傳回的回應。
  • 對所有後續要求都使用相同的值 完成。

下方序列圖顯示偏好的流程：

使用回應 ID 驗證地址。