업데이트된 주소 처리

경우에 따라 단일 주소에 대한 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에서 반환함
• 시리즈가 종료될 때까지 모든 후속 요청에 동일한 값을 사용합니다. 나타냅니다.

다음 시퀀스 다이어그램은 권장 흐름을 보여줍니다.