Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
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ỉ 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 sẽ 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ả hai 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 nghiêm ngặt về việc sử dụng, mà là một hành động hữu ích để 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, bạn nên thực hiện lệnh gọi đến API Cung cấp phản hồi xác thực để cho biết kết quả cuối cùng của tất cả quy trình xác thực. Yêu cầu này đặt hai 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ừ 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 previousResponseId ở bên dưới.
Trường responseId chỉ định kết quả xác thực địa chỉ mà bạn đang cung cấp phản hồi. Giá trị này phải giống với giá trị responseId mà lệnh gọi đầu tiên trả về cho phương thức validateAddress.
Xem phần Phần thân yêu cầu trong hướng dẫn tham khảo về phản hồi xác thực.
Đặt trường previousResponseID
Khi đưa ra yêu cầu tiếp theo cho API Xác thực địa chỉ cho 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.
Sử dụng cùng một giá trị này cho mọi yêu cầu tiếp theo cho đến khi loạt tin nhắn hoàn tất.
[[["Dễ hiểu","easyToUnderstand","thumb-up"],["Giúp tôi giải quyết được vấn đề","solvedMyProblem","thumb-up"],["Khác","otherUp","thumb-up"]],[["Thiếu thông tin tôi cần","missingTheInformationINeed","thumb-down"],["Quá phức tạp/quá nhiều bước","tooComplicatedTooManySteps","thumb-down"],["Đã lỗi thời","outOfDate","thumb-down"],["Vấn đề về bản dịch","translationIssue","thumb-down"],["Vấn đề về mẫu/mã","samplesCodeIssue","thumb-down"],["Khác","otherDown","thumb-down"]],["Cập nhật lần gần đây nhất: 2024-12-05 UTC."],[[["\u003cp\u003eWhen validating an address multiple times, use the \u003ccode\u003eprovideValidationFeedback\u003c/code\u003e endpoint to inform Google of the final address version used.\u003c/p\u003e\n"],["\u003cp\u003eInclude the original response ID in the \u003ccode\u003eprovideValidationFeedback\u003c/code\u003e request and set the \u003ccode\u003epreviousResponseId\u003c/code\u003e for subsequent validation calls to improve data quality and response time.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003econclusion\u003c/code\u003e field in the feedback request indicates whether the user's original, a validated, or another address version was ultimately used.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003epreviousResponseId\u003c/code\u003e helps the API understand the context of the address validation sequence and potentially optimize results.\u003c/p\u003e\n"]]],[],null,["In some cases, you might make multiple calls to the\nAddress Validation API for a single address. For example, the customer might make\nchanges to their address after seeing the results of the first\nvalidation. You then perform a second validation on the updated address.\n\nThis document describes two key actions you can take when you issue a series of\nrequests for the same address to the Address Validation API. These actions are\nnot a strict usage requirement, but a helpful action on your part to improve\noverall data quality and system response.\n\n- Send a request to the `provideValidationFeedback` endpoint\n- Set the `previousResponseID` field\n\nSend a `provideValidationFeedback` request\n\nAt the end of a series of validations, Google recommends making a call to the\nProvide Validation Feedback API to indicate the final outcome of\nall the validations. The request sets two fields:\n\n- `conclusion` --- Indicates the validation version you used in your service, whether it was the one provided by the user, or the one returned from the Address Validation API.\n- `responseId` --- Indicates the response ID of the **first** response from the Address Validation API. See [Set the previousResponseId field](#followup-requests) below.\n\nUse either the\n[provideValidationFeedback](/maps/documentation/address-validation/reference/rest/v1/TopLevel/provideValidationFeedback)\nmethod (REST) or\n[ProvideValidationFeedback](/maps/documentation/address-validationreference/rpc/google.maps.addressvalidation.v1#google.maps.addressvalidation.v1.AddressValidation.ProvideValidationFeedback)\nmethod (gRPC).\n\nThe following example passes a [JSON body](/maps/documentation/address-validation/reference/rest/v1/TopLevel/validateAddress#request-body) to the request defining the\nconclusion: \n\n```json\ncurl -X POST -d '{\n \"conclusion\": \"VALIDATED_VERSION_USED\",\n \"responseId\": \"de22bed8-7f52-44cb-8526-faceac57150a\"\n}' \\\n-H 'Content-Type: application/json' \\\n\"https://addressvalidation.googleapis.com/v1:provideValidationFeedback?key=\u003cvar translate=\"no\"\u003eAPI_KEY\u003c/var\u003e\"\n```\n\n- The `conclusion` field identifies one of the following actions from your side:\n - `VALIDATED_VERSION_USED`: the validated version of the address from the Address Validation API.\n - `USER_VERSION_USED`: the original version provided by the user.\n - `UNVALIDATED_VERSION_USED`: a version that was a result of a prompt to the user, but did not re-validate it with the Address Validation API.\n - `UNUSED`: abandoned the transaction.\n\n|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| See [Validation Conclusion](/maps/documentation/address-validation/reference/rest/v1/TopLevel/provideValidationFeedback#validationconclusion) in the reference guide. |\n\n- The `responseId` field specifies which address validation results you are providing feedback for. This value must be the same as the `responseId` value returned by the **first** call to the [validateAddress](/maps/documentation/address-validation/reference/rest/v1/TopLevel/validateAddress) method.\n\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| See [Request Body](/maps/documentation/address-validation/reference/rest/v1/TopLevel/provideValidationFeedback#request-body) in the validation feedback reference guide. |\n\nSet the `previousResponseID` field\n\nWhen issuing a follow-up request the Address Validation API for a given address, set\nthe `previousResponseId` field.\n\n- For the value of the `previousResponseId`, use the value from the `responseId` returned by API after the **first** validation request.\n- Use this same value for any and all followup requests until the series completes.\n\nThis sequence diagram shows the preferred flow:"]]
