업데이트된 주소 처리

경우에 따라 단일 주소에 대해 Address Validation API를 여러 번 호출할 수 있습니다. 예를 들어 고객이 첫 번째 유효성 검사 결과를 확인한 후 주소를 변경할 수 있습니다. 그런 다음 업데이트된 주소에 대해 두 번째 유효성 검사를 실행합니다.

이 문서에서는 동일한 주소에 대해 Address Validation API에 일련의 요청을 발행할 때 취할 수 있는 두 가지 주요 작업을 설명합니다. 이러한 작업은 엄격한 사용 요구사항이 아니라 전반적인 데이터 품질과 시스템 응답을 개선하기 위한 유용한 작업입니다.

• provideValidationFeedback 엔드포인트에 요청 전송
• previousResponseID 필드 설정

provideValidationFeedback 요청 전송

일련의 검증이 끝나면 Google은 Provide Validation Feedback API를 호출하여 모든 검증의 최종 결과를 나타낼 것을 권장합니다. 요청은 다음 두 필드를 설정합니다.

• conclusion - 서비스에서 사용한 유효성 검사 버전을 나타냅니다. 사용자가 제공한 버전인지 주소 유효성 검사 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 값을 사용합니다.
• 시리즈가 완료될 때까지 모든 후속 요청에 동일한 값을 사용하세요.

이 시퀀스 다이어그램은 선호되는 흐름을 보여줍니다.