Method: provideValidationFeedback
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Feedback zum Ergebnis der Sequenz von Validierungsversuchen. Dies sollte der letzte Aufruf nach einer Reihe von Validierungsaufrufen für dieselbe Adresse sein und sollte nach Abschluss der Transaktion aufgerufen werden. Dies sollte nur einmal für die Sequenz von v1.validateAddress-Anfragen gesendet werden, die zur vollständigen Validierung einer Adresse erforderlich sind.
HTTP-Anfrage
POST https://addressvalidation.googleapis.com/v1:provideValidationFeedback
Die URL verwendet die Syntax der gRPC-Transcodierung.
Anfragetext
Der Anfragetext enthält Daten mit folgender Struktur:
| Felder |
conclusion |
enum (ValidationConclusion)
Erforderlich. Das Ergebnis der Sequenz der Validierungsversuche. Wenn dieses Feld auf VALIDATION_CONCLUSION_UNSPECIFIED gesetzt ist, wird ein INVALID_ARGUMENT-Fehler zurückgegeben.
|
responseId |
string
Erforderlich. Die ID der Antwort, auf die sich dieses Feedback bezieht. Dies sollte die [responseId][google.maps.addressvalidation.v1.ValidateAddressRequest.response_id] aus der ersten Antwort einer Reihe von Versuchen zur Adressvalidierung sein.
|
Antworttext
Wenn der Vorgang erfolgreich ist, ist der Antworttext leer.
ValidationConclusion
Die möglichen endgültigen Ergebnisse der Sequenz von Anfragen zur Adressvalidierung, die zum Bestätigen einer Adresse erforderlich sind.
| Enums |
VALIDATION_CONCLUSION_UNSPECIFIED |
Dieser Wert wird nicht verwendet. Wenn das Feld ProvideValidationFeedbackRequest.conclusion auf VALIDATION_CONCLUSION_UNSPECIFIED gesetzt ist, wird der Fehler INVALID_ARGUMENT zurückgegeben. |
VALIDATED_VERSION_USED |
Die Version der von der Address Validation API zurückgegebenen Adresse wurde für die Transaktion verwendet. |
USER_VERSION_USED |
Die Version der vom Nutzer angegebenen Adresse wurde für die Transaktion verwendet |
UNVALIDATED_VERSION_USED |
Für die Transaktion wurde eine Version der Adresse verwendet, die nach dem letzten Bestätigungsversuch eingegeben wurde, aber nicht noch einmal validiert wurde. |
UNUSED |
Die Transaktion wurde abgebrochen und die Adresse nicht verwendet. |
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-08-31 (UTC).
[null,null,["Zuletzt aktualisiert: 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. |"]]
