Address Validation API의 품질을 개선할 수 있도록 최종 사용자가 확인된 주소를 수락했는지 여부를 Google에 알릴 수 있습니다(선택사항). 이러한 의견은 API의 전반적인 정확성을 개선하는 데 도움이 됩니다.
주소 확인 의견 요청
주소 유효성 검사 메서드를 호출한 후 의견을 제공하려면 provideValidationFeedback 메서드 (REST) 또는 ProvideValidationFeedback 메서드 (gRPC)를 호출합니다. 다음 예에서는 REST API에 POST 요청을 합니다.
https://addressvalidation.googleapis.com/v1:provideValidationFeedback?key=YOUR_API_KEY
주소 유효성 검사의 결과를 정의하는 JSON 본문을 POST 요청에 전달합니다.
{
"conclusion": "VALIDATED_VERSION_USED",
"responseId": "de22bed8-7f52-44cb-8526-faceac57150a"
}
각 항목의 의미는 다음과 같습니다.
conclusion필드는 유효성 검사의 실제 결과를 반영해야 합니다.이 예시에서는
VALIDATED_VERSION_USED를conclusion필드 값으로 전달하여 사용한 주소가 API에서 반환된 주소임을 나타냅니다.최종적으로 최종 사용자가 제공한 주소를 사용할 경우
USER_VERSION_USED를 전달합니다.conclusion에 가능한 모든 값은 ValidationConclusion을 참조하세요.responseId필드는 의견을 제공할 주소 유효성 검사 결과를 지정합니다. 이 값은 이전에 validateAddress 메서드를 호출할 때 반환된responseId값과 같아야 합니다.validateAddress메서드 호출에 대한 예는 주소 유효성 검사를 참고하세요.
responseID 설정 방법
각 Address Validation API 호출은 응답의 responseId 필드에 고유한 값을 반환합니다.
경우에 따라 단일 주소에 Address Validation API를 여러 번 호출할 수 있습니다. 예를 들어 최종 사용자가 첫 번째 유효성 검사 결과를 본 후 주소를 변경할 수 있습니다. 그런 다음 업데이트된 주소에 대해 두 번째 유효성 검사를 수행합니다.
검증하려는 주소를 다시 검증해야 하는 경우 모든 후속 요청의 previousResponseId 필드에 있는 첫 번째 응답의 responseId를 Address Validation API에 전달합니다.
이러한 후속 요청 요청에 대한 각 응답에는 새 responseId가 포함되지만 유효성 검사가 완료될 때까지 previousResponseId의 첫 번째 responseId 값을 계속 사용합니다.
업데이트된 주소 검증에 대한 자세한 내용은 업데이트된 주소 검증을 참고하세요.
일련의 검증이 끝나면 Provide Validation Feedback API를 호출하여 모든 검증의 최종 결과를 Google에 알리는 것이 좋습니다. Provide Validation Feedback API 요청의 첫 번째 응답의 responseId를 전달합니다.
다음 시퀀스 다이어그램은 원하는 흐름을 보여줍니다.
