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 Address Validation API cho một địa chỉ duy nhất. Ví dụ: khách hàng có thể thay đổi địa chỉ sau khi xem kết quả của lần xác thực đầu tiên. Sau đó, bạn thực hiện quy trình xác thực lần thứ hai đối với địa chỉ đã cập nhật.

Tài liệu này mô tả 2 hành động chính mà bạn có thể thực hiện khi đưa ra một loạt yêu cầu cho cùng một địa chỉ đến Address Validation API. Đây không phải là yêu cầu bắt buộc về việc sử dụng, nhưng là một hành động hữu ích củ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 quy trình xác thực, Google đề xuất gọi API Cung cấp ý kiến phản hồi về quy trình xác thực để cho biết kết quả cuối cùng của tất cả các quy trình xác thực. Yêu cầu này đặt 2 trường:

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

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

Ví dụ sau đây truyền một nội dung JSON vào yêu cầu xác định 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 thao tác sau đây từ phía bạn:
    • VALIDATED_VERSION_USED: phiên bản đã xác thực của địa chỉ từ Address Validation API.
    • 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 là kết quả của lời nhắc cho người dùng, nhưng không xác thực lại bằng Address Validation API.
    • UNUSED: bỏ ngang giao dịch.
Hãy xem phần Kết luận về quy trình 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ỉ mà bạn đang cung cấp ý kiến phản hồi. Giá trị này phải giống với giá trị responseId do 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ề thông tin phản hồi xác thực.

Đặt trường previousResponseID

Khi đưa ra yêu cầu tiếp theo cho Address Validation API đối với một địa chỉ nhất định, hãy đặt trường previousResponseId.

  • Đối với giá trị của previousResponseId, hãy sử dụng giá trị từ responseId do API trả về sau yêu cầu xác thực đầu tiên.
  • Hãy sử dụng cùng giá trị này cho mọi yêu cầu tiếp theo cho đến khi chuỗi 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ỉ.