Xử lý các địa chỉ đã cập nhật

Trong một số trường hợp, bạn có thể thực hiện nhiều lệnh gọi đến API xác thực địa chỉ cho một địa chỉ. Ví dụ: khách hàng có thể thực hiện thay đổi địa chỉ của họ sau khi thấy kết quả về xác thực. Sau đó, bạn thực hiện lần xác thực thứ hai cho địa chỉ đã cập nhật.

Tài liệu này mô tả hai hành động chính mà bạn có thể thực hiện khi phát hành một loạt các yêu cầu cho cùng một địa chỉ với API Xác thực địa chỉ. Những thao tác này không phải là một yêu cầu nghiêm ngặt về mức sử dụng, mà là một hành động hữu ích từ phía bạn để cải thiện chất lượng dữ liệu tổng thể và phản hồi của hệ thống.

  • Gửi yêu cầu đến điểm cuối provideValidationFeedback
  • Đặt trường previousResponseID

Gửi yêu cầu provideValidationFeedback

Khi kết thúc một loạt các xác thực, Google khuyên bạn nên gọi đến Cung cấp API phản hồi xác thực để cho biết kết quả cuối cùng của tất cả các lần xác thực. Yêu cầu này thiết lập 2 trường:

  • conclusion – Cho biết phiên bản xác thực bạn đã sử dụng trong dịch vụ của mình, cho dù đó là mã do người dùng cung cấp hay được trả về từ API xác thực địa chỉ.
  • responseId – Cho biết mã phản hồi của phản hồi đầu tiên từ API xác thực địa chỉ. Hãy xem phần Đặt trường trướcResponseId bên dưới.

Sử dụng provideValidationFeedback phương thức (REST) hoặc ProvideValidationFeedback (gRPC).

Ví dụ sau đây truyền nội dung JSON đến yêu cầu xác định phần tử kết luận:

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"
  • Trường conclusion xác định một trong các hành động sau của bên cạnh:
    • VALIDATED_VERSION_USED: phiên bản địa chỉ đã được xác thực trong API Xác thực địa chỉ.
    • USER_VERSION_USED: phiên bản gốc do người dùng cung cấp.
    • UNVALIDATED_VERSION_USED: một phiên bản nhận được từ lời nhắc người dùng, nhưng không xác thực lại địa chỉ đó bằng API xác thực địa chỉ.
    • UNUSED: đã bỏ giao dịch.
Xem Kết luận xác thực trong hướng dẫn tham khảo.
  • Trường responseId chỉ định kết quả xác thực địa chỉ dành cho bạn gửi ý kiến phản hồi về. Giá trị này phải giống với responseId giá trị được lệnh gọi đầu tiên trả về cho phương thức validateAddress.
Xem phần Nội dung yêu cầu trong hướng dẫn tham khảo về ý kiến phản hồi xác thực.

Đặt trường previousResponseID

Khi gửi yêu cầu theo dõi API xác thực địa chỉ cho một địa chỉ cụ thể, hãy đặt trường previousResponseId.

  • Đối với giá trị của previousResponseId, hãy sử dụng giá trị từ responseId mà API trả về sau yêu cầu xác thực đầu tiên.
  • Sử dụng cùng một giá trị này cho mọi yêu cầu theo dõi cho đến loạt yêu cầu hoàn tất.

Sơ đồ trình tự này cho thấy quy trình ưu tiên:

Sử dụng mã phản hồi để xác thực địa chỉ.