Method: provideValidationFeedback
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Feedback sull'esito della sequenza di tentativi di convalida. Dovrebbe essere l'ultima chiamata effettuata dopo una sequenza di chiamate di convalida per lo stesso indirizzo e dovrebbe essere chiamata una volta completata la transazione. Deve essere inviato una sola volta per la sequenza di v1.validateAddress richieste necessarie per convalidare completamente un indirizzo.
Richiesta HTTP
POST https://addressvalidation.googleapis.com/v1:provideValidationFeedback
L'URL utilizza la sintassi di transcodifica gRPC.
Corpo della richiesta
Il corpo della richiesta contiene dati con la seguente struttura:
| Campi |
conclusion |
enum (ValidationConclusion)
Obbligatorio. Il risultato della sequenza di tentativi di convalida. Se questo campo viene impostato su VALIDATION_CONCLUSION_UNSPECIFIED, verrà restituito un errore INVALID_ARGUMENT.
|
responseId |
string
Obbligatorio. L'ID della risposta a cui fa riferimento questo feedback. Dovrebbe essere il valore [responseId][google.maps.addressvalidation.v1.ConvalidaAddressRequest.response_id] della prima risposta di una serie di tentativi di convalida dell'indirizzo.
|
Corpo della risposta
In caso di esito positivo, il corpo della risposta è vuoto.
ValidationConclusion
I possibili risultati finali della sequenza di richieste di convalida dell'indirizzo necessarie per convalidare un indirizzo.
| Enum |
VALIDATION_CONCLUSION_UNSPECIFIED |
Questo valore non è utilizzato. Se il campo ProvideValidationFeedbackRequest.conclusion è impostato su VALIDATION_CONCLUSION_UNSPECIFIED, verrà restituito un errore INVALID_ARGUMENT. |
VALIDATED_VERSION_USED |
La versione dell'indirizzo restituito dall'API Address Validation è stata utilizzata per la transazione. |
USER_VERSION_USED |
La versione dell'indirizzo fornito dall'utente è stata utilizzata per la transazione |
UNVALIDATED_VERSION_USED |
Per la transazione è stata utilizzata una versione dell'indirizzo inserito dopo l'ultimo tentativo di convalida, ma che non è stata riconvalidata. |
UNUSED |
La transazione è stata abbandonata e l'indirizzo non è stato utilizzato. |
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-08-31 UTC.
[null,null,["Ultimo aggiornamento 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. |"]]
