Method: provideValidationFeedback
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Обратная связь о результатах последовательности попыток проверки. Это должен быть последний вызов после последовательности вызовов проверки для одного и того же адреса, и его следует вызывать после завершения транзакции. Его следует отправлять только один раз для последовательности запросов v1.validateAddress
необходимых для полной проверки адреса.
HTTP-запрос
POST https://addressvalidation.googleapis.com/v1:provideValidationFeedback
URL-адрес использует синтаксис транскодирования gRPC .
Тело запроса
Тело запроса содержит данные следующей структуры:
Поля |
---|
conclusion | enum ( ValidationConclusion ) Необходимый. Результат последовательности попыток проверки. Если для этого поля установлено значение VALIDATION_CONCLUSION_UNSPECIFIED , будет возвращена ошибка INVALID_ARGUMENT . |
responseId | string Необходимый. Идентификатор ответа, для которого предназначен этот отзыв. Это должен быть [responseId][google.maps.addressvalidation.v1.ValidateAddressRequest.response_id] из первого ответа в серии попыток проверки адреса. |
Тело ответа
В случае успеха тело ответа пустое.
ВалидацияЗаключение
Возможные окончательные результаты последовательности запросов проверки адреса, необходимых для проверки адреса.
Перечисления |
---|
VALIDATION_CONCLUSION_UNSPECIFIED | Это значение не используется. Если для поля ProvideValidationFeedbackRequest.conclusion установлено значение VALIDATION_CONCLUSION_UNSPECIFIED , будет возвращена ошибка INVALID_ARGUMENT . |
VALIDATED_VERSION_USED | Для транзакции использовалась версия адреса, возвращенная API проверки адреса. |
USER_VERSION_USED | Для транзакции была использована версия адреса, предоставленная пользователем. |
UNVALIDATED_VERSION_USED | Для транзакции использовалась версия адреса, введенная после последней попытки проверки, но не проверенная повторно. |
UNUSED | Транзакция была отменена, а адрес не использовался. |
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-08-29 UTC.
[null,null,["Последнее обновление: 2025-08-29 UTC."],[[["\u003cp\u003eProvide feedback on the outcome of address validation attempts using the \u003ccode\u003eProvideValidationFeedback\u003c/code\u003e method.\u003c/p\u003e\n"],["\u003cp\u003eThe feedback request body includes the validation conclusion and the initial response ID.\u003c/p\u003e\n"],["\u003cp\u003ePossible validation conclusions include using the validated, user-provided, or an unvalidated address version, or abandoning the transaction.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eProvideValidationFeedback\u003c/code\u003e request should be sent only once after the transaction is concluded.\u003c/p\u003e\n"],["\u003cp\u003eA successful feedback submission results in an empty response body.\u003c/p\u003e\n"]]],[],null,["# Method: provideValidationFeedback\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n- [ValidationConclusion](#ValidationConclusion)\n\nFeedback about the outcome of the sequence of validation attempts. This should be the last call made after a sequence of validation calls for the same address, and should be called once the transaction is concluded. This should only be sent once for the sequence of `v1.validateAddress` requests needed to validate an address fully.\n\n### HTTP request\n\n`POST https://addressvalidation.googleapis.com/v1:provideValidationFeedback`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"conclusion\": enum (/maps/documentation/address-validation/reference/rest/v1/TopLevel/provideValidationFeedback#ValidationConclusion), \"responseId\": string } ``` |\n\n| Fields ||\n|--------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `conclusion` | `enum (`[ValidationConclusion](/maps/documentation/address-validation/reference/rest/v1/TopLevel/provideValidationFeedback#ValidationConclusion)`)` Required. The outcome of the sequence of validation attempts. If this field is set to `VALIDATION_CONCLUSION_UNSPECIFIED`, an `INVALID_ARGUMENT` error will be returned. |\n| `responseId` | `string` Required. The ID of the response that this feedback is for. This should be the \\[responseId\\]\\[google.maps.addressvalidation.v1.ValidateAddressRequest.response_id\\] from the first response in a series of address validation attempts. |\n\n### Response body\n\nIf successful, the response body is empty.\n\nValidationConclusion\n--------------------\n\nThe possible final outcomes of the sequence of address validation requests needed to validate an address.\n\n| Enums ||\n|-------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `VALIDATION_CONCLUSION_UNSPECIFIED` | This value is unused. If the `ProvideValidationFeedbackRequest.conclusion` field is set to `VALIDATION_CONCLUSION_UNSPECIFIED`, an `INVALID_ARGUMENT` error will be returned. |\n| `VALIDATED_VERSION_USED` | The version of the address returned by the Address Validation API was used for the transaction. |\n| `USER_VERSION_USED` | The version of the address provided by the user was used for the transaction |\n| `UNVALIDATED_VERSION_USED` | A version of the address that was entered after the last validation attempt but that was not re-validated was used for the transaction. |\n| `UNUSED` | The transaction was abandoned and the address was not used. |"]]