Method: provideValidationFeedback
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Comentarios sobre el resultado de la secuencia de intentos de validación. Esta debe ser la última llamada realizada después de una secuencia de llamadas de validación para la misma dirección, y se debe llamar una vez concluida la transacción. Esto solo se debe enviar una vez para la secuencia de solicitudes v1.validateAddress necesarias para validar una dirección por completo.
Solicitud HTTP
POST https://addressvalidation.googleapis.com/v1:provideValidationFeedback
La URL usa la sintaxis de la transcodificación gRPC.
Cuerpo de la solicitud
El cuerpo de la solicitud contiene datos con la siguiente estructura:
| Campos |
conclusion |
enum (ValidationConclusion)
Obligatorio. El resultado de la secuencia de intentos de validación. Si este campo se configura como VALIDATION_CONCLUSION_UNSPECIFIED, se mostrará un error INVALID_ARGUMENT.
|
responseId |
string
Obligatorio. El ID de la respuesta a la que corresponde este comentario. Debería ser el [responseId][google.maps.addressvalidation.v1.ValidateAddressRequest.response_id] de la primera respuesta en una serie de intentos de validación de dirección.
|
Cuerpo de la respuesta
Si se ejecuta correctamente, el cuerpo de la respuesta está vacío.
ValidationConclusion
Son los posibles resultados finales de la secuencia de solicitudes de validación de direcciones necesarias para validar una dirección.
| Enumeraciones |
VALIDATION_CONCLUSION_UNSPECIFIED |
Este valor no se usa. Si el campo ProvideValidationFeedbackRequest.conclusion se configura como VALIDATION_CONCLUSION_UNSPECIFIED, se mostrará un error INVALID_ARGUMENT. |
VALIDATED_VERSION_USED |
Para la transacción, se usó la versión de la dirección que muestra la API de Address Validation. |
USER_VERSION_USED |
La versión de la dirección que proporcionó el usuario se usó para la transacción |
UNVALIDATED_VERSION_USED |
Para la transacción, se utilizó una versión de la dirección ingresada después del último intento de validación, pero que no se volvió a validar. |
UNUSED |
Se abandonó la transacción y no se usó la dirección. |
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-08-31 (UTC)
[null,null,["Última actualización: 2025-08-31 (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. |"]]
