업데이트된 주소 처리

경우에 따라 단일 주소에 대한 Address Validation API입니다. 예를 들어 고객은 첫 번째 사이트의 결과를 확인한 후 주소가 변경된 경우 있습니다. 그런 다음 업데이트된 주소에 대해 두 번째 검증을 수행합니다.

이 문서에서는 일련의 프로세스를 실행할 때 취할 수 있는 두 가지 주요 작업에 대해 설명합니다. Address Validation API에 동일한 주소에 대한 요청을 전송합니다 이러한 작업은 엄격한 사용 요구사항은 아니지만 서비스 개선에 도움이 되는 조치입니다. 전반적인 데이터 품질과 시스템 응답을 확인할 수 있습니다

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

provideValidationFeedback 요청 보내기

일련의 유효성 검사가 끝나면 검증 피드백 API를 제공하여 최종 결과를 표시합니다. 확인해야 합니다 이 요청은 다음 두 필드를 설정합니다.

  • conclusion - 서비스에서 사용한 유효성 검사 버전을 나타냅니다. 사용자가 제공한 것이든 Address Validation API
  • responseId — 다음에서 보낸 첫 번째 응답의 응답 ID를 나타냅니다. Address Validation API 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 입력란은 사이트에서의 다음 작업 중 하나를 나타냅니다. 측면: <ph type="x-smartling-placeholder">
      </ph>
    • VALIDATED_VERSION_USED: 주소의 확인된 버전입니다. Address Validation API를 사용하는 것이 좋습니다
    • USER_VERSION_USED: 사용자가 제공한 원래 버전입니다.
    • UNVALIDATED_VERSION_USED: 다음 프롬프트의 결과인 버전입니다. Address Validation API로 재검증하지는 않았습니다.
    • UNUSED: 거래를 포기했습니다.
참조 가이드의 검증 결론을 확인하세요.
  • responseId 필드는 주소 확인 결과를 지정합니다. 도움이 될 수 있습니다 이 값은 responseId와 같아야 합니다. 첫 번째 호출에서 반환한 값이 validateAddress 메서드와 함께 사용할 수 있습니다.
유효성 검사 의견 참조 가이드에서 요청 본문을 참고하세요.

previousResponseID 필드 설정

후속 요청을 할 때 특정 주소에 대한 Address Validation API는 previousResponseId 필드

  • previousResponseId 값에는 responseId의 값을 사용합니다. 첫 번째 유효성 검사 요청 후 API에서 반환함
  • 시리즈가 종료될 때까지 모든 후속 요청에 동일한 값을 사용합니다. 나타냅니다.

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

응답 ID를 사용하여 주소를 검증합니다.