Method: provideValidationFeedback
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
일련의 유효성 검사 시도 결과에 관한 의견 이는 동일한 주소에 대한 일련의 유효성 검사 호출 이후 마지막 호출이어야 하며 거래가 완료된 후 호출해야 합니다. 이 요청은 주소를 완전히 확인하는 데 필요한 일련의 v1.validateAddress 요청에 대해 한 번만 전송해야 합니다.
HTTP 요청
POST https://addressvalidation.googleapis.com/v1:provideValidationFeedback
URL은 gRPC 트랜스코딩 구문을 사용합니다.
요청 본문
요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.
| 필드 |
conclusion |
enum (ValidationConclusion)
필수 항목입니다. 일련의 유효성 검사 시도 결과입니다. 이 필드가 VALIDATION_CONCLUSION_UNSPECIFIED로 설정되면 INVALID_ARGUMENT 오류가 반환됩니다.
|
responseId |
string
필수 항목입니다. 이 의견의 응답 ID입니다. 일련의 주소 확인 시도 중 첫 번째 응답의 [responseId][google.maps.addressvalidation.v1.ValidateAddressRequest.response_id] 여야 합니다.
|
응답 본문
성공한 경우 응답 본문은 비어 있습니다.
ValidationConclusion
주소 검증에 필요한 일련의 주소 검증 요청 과정에서 발생할 수 있는 최종 결과
| 열거형 |
VALIDATION_CONCLUSION_UNSPECIFIED |
이 값은 사용되지 않습니다. ProvideValidationFeedbackRequest.conclusion 필드가 VALIDATION_CONCLUSION_UNSPECIFIED로 설정되면 INVALID_ARGUMENT 오류가 반환됩니다. |
VALIDATED_VERSION_USED |
Address Validation API에서 반환된 주소 버전이 거래에 사용되었습니다. |
USER_VERSION_USED |
사용자가 제공한 주소 버전이 거래에 사용되었습니다. |
UNVALIDATED_VERSION_USED |
마지막 유효성 검사 시도 후에 입력되었지만 재검증되지 않은 주소 버전이 거래에 사용되었습니다. |
UNUSED |
거래가 포기되어 주소가 사용되지 않았습니다. |
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-31(UTC)
[null,null,["최종 업데이트: 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. |"]]
