Method: provideValidationFeedback
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Opinia na temat wyniku sekwencji prób weryfikacji. Powinno to być ostatnie wywołanie po serii wywołań weryfikacji dla tego samego adresu. Powinno być ono wywoływane po zakończeniu transakcji. Należy je wysłać tylko raz w przypadku sekwencji żądań v1.validateAddress niezbędnych do pełnej weryfikacji adresu.
Żądanie HTTP
POST https://addressvalidation.googleapis.com/v1:provideValidationFeedback
Adres URL używa składni transkodowania gRPC.
Treść żądania
Treść żądania zawiera dane o następującej strukturze:
| Pola |
conclusion |
enum (ValidationConclusion)
Wymagane. Wynik sekwencji prób weryfikacji. Jeśli to pole ma wartość VALIDATION_CONCLUSION_UNSPECIFIED, zwracany jest błąd INVALID_ARGUMENT.
|
responseId |
string
Wymagane. Identyfikator odpowiedzi, której dotyczy ta opinia. Powinien to być identyfikator [responseId][google.maps.addressvalidation.v1.ValidateAddressRequest.response_id] z pierwszej odpowiedzi w serii prób weryfikacji adresu.
|
Treść odpowiedzi
Jeśli operacja się uda, treść odpowiedzi będzie pusta.
ValidationConclusion
Możliwe końcowe wyniki sekwencji próśb o weryfikację adresu, które są niezbędne do zweryfikowania adresu.
| Wartości w polu enum |
VALIDATION_CONCLUSION_UNSPECIFIED |
Ta wartość nie jest używana. Jeśli pole ProvideValidationFeedbackRequest.conclusion ma wartość VALIDATION_CONCLUSION_UNSPECIFIED, zostanie zwrócony błąd INVALID_ARGUMENT. |
VALIDATED_VERSION_USED |
Wersja adresu zwrócona przez interfejs Address Validation API została użyta w transakcji. |
USER_VERSION_USED |
Wersja adresu podana przez użytkownika, która została użyta do zrealizowania transakcji |
UNVALIDATED_VERSION_USED |
W przypadku transakcji użyto wersji adresu podanego po ostatniej próbie weryfikacji, która nie została ponownie zweryfikowana. |
UNUSED |
Transakcja została porzucona i adres nie został użyty. |
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-08-31 UTC.
[null,null,["Ostatnia aktualizacja: 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. |"]]
