경우에 따라 주소 하나에 대해 Address Validation API를 여러 번 호출할 수 있습니다. 예를 들어 고객은 1차 검증 결과를 확인한 후에 주소를 변경할 수 있습니다. 그런 다음 업데이트된 주소에 대해 두 번째 검증을 수행합니다.
이 문서에서는 Address Validation API에 동일한 주소에 대해 일련의 요청을 실행할 때 취할 수 있는 두 가지 주요 작업을 설명합니다. 이러한 작업은 엄격한 사용 요구사항은 아니지만, 전반적인 데이터 품질과 시스템 응답을 개선하는 데 도움이 되는 작업입니다.
provideValidationFeedback
엔드포인트에 요청 전송previousResponseID
필드 설정
provideValidationFeedback
요청 보내기
일련의 유효성 검사가 끝나면 Offer Validation Feedback API를 호출하여 모든 유효성 검사의 최종 결과를 나타내는 것이 좋습니다. 이 요청은 다음 두 필드를 설정합니다.
conclusion
- 사용자가 제공한 버전이든 Address Validation API에서 반환된 버전이든 상관없이 서비스에서 사용된 유효성 검사 버전을 나타냅니다.responseId
- Address Validation API의 첫 번째 응답의 응답 ID를 나타냅니다. 아래의 previousResponseId 필드 설정을 참고하세요.
provideValidationFeedback 메서드 (REST) 또는 ProvideValidationFeedback 메서드 (gRPC) 중 하나를 사용합니다.
다음 예에서는 JSON 본문을 요청에 전달하여 결론을 정의합니다.
curl -X POST -d '{ "conclusion": "VALIDATED_VERSION_USED", "responseId": "de22bed8-7f52-44cb-8526-faceac57150a" }' \ -H 'Content-Type: application/json' \ "https://addressvalidation.googleapis.com/v1:provideValidationFeedback?key=API_KEY"
conclusion
필드는 사용자 측의 다음 작업 중 하나를 나타냅니다.VALIDATED_VERSION_USED
: Address Validation API에서 검증된 주소 버전입니다.USER_VERSION_USED
: 사용자가 제공한 원래 버전입니다.UNVALIDATED_VERSION_USED
: 사용자에게 보낸 메시지의 결과이지만 Address Validation API로 재검증하지 않은 버전입니다.UNUSED
: 거래를 포기했습니다.
참조 가이드의 검증 결론을 확인하세요. |
responseId
필드는 의견을 제공할 주소 유효성 검사 결과를 지정합니다. 이 값은 validateAddress 메서드에 대한 첫 번째 호출에서 반환된responseId
값과 동일해야 합니다.
유효성 검사 의견 참조 가이드에서 요청 본문을 참고하세요. |
previousResponseID
필드 설정
특정 주소에 대해 Address Validation API에 대한 후속 요청을 할 때 previousResponseId
필드를 설정합니다.
previousResponseId
값에는 첫 번째 유효성 검사 요청 후에 API에서 반환한responseId
의 값을 사용합니다.- 시리즈가 완료될 때까지 모든 후속 요청에 동일한 값을 사용합니다.
다음 시퀀스 다이어그램은 선호하는 흐름을 보여줍니다.