Processar endereços atualizados

Em alguns casos, você pode fazer várias chamadas para o API Address Validation para um único endereço. Por exemplo, o cliente pode fazer muda de endereço depois de ver os resultados da primeira validação. Em seguida, você realiza uma segunda validação no endereço atualizado.

Este documento descreve duas ações principais que você pode realizar ao emitir uma série de solicitações do mesmo endereço para a API Address Validation. Essas ações são não é uma exigência de uso estrita, mas uma ação útil de sua parte para melhorar na qualidade geral dos dados e na resposta do sistema.

  • Enviar uma solicitação para o endpoint provideValidationFeedback
  • Definir o campo previousResponseID

Enviar uma solicitação de provideValidationFeedback

Ao final de uma série de validações, o Google recomenda fazer uma chamada para o Fornecer a API Validation Feedback para indicar o resultado final de todas as validações. A solicitação define dois campos:

  • conclusion: indica a versão de validação usada no seu serviço. se foi aquela fornecida pelo usuário ou aquela retornada do API Address Validation.
  • responseId: indica o ID da primeira resposta do API Address Validation. Consulte Definir o campo previousResponseId a seguir.

Use o método provideValidationFeedback método (REST) ou ProvideValidationFeedback (gRPC).

O exemplo a seguir passa um corpo JSON à solicitação, definindo o conclusão:

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"
  • O campo conclusion identifica uma das seguintes ações do seu lado:
    • VALIDATED_VERSION_USED: a versão validada do endereço de a API Address Validation.
    • USER_VERSION_USED: a versão original fornecida pelo usuário.
    • UNVALIDATED_VERSION_USED: uma versão resultante de uma solicitação para o usuário, mas não o revalidou com a API Address Validation.
    • UNUSED: abandonou a transação.
Consulte Conclusão da validação no guia de referência.
  • O campo responseId especifica para quais resultados de validação de endereço você está fornecer feedback. Esse valor precisa ser igual ao atributo responseId valor retornado pela primeira chamada para o método validateAddress.
Consulte Corpo da solicitação no guia de referência de feedback de validação.

Definir o campo previousResponseID

Ao emitir uma solicitação de acompanhamento à API Address Validation para um determinado endereço, defina o campo previousResponseId.

  • Para o valor de previousResponseId, use o valor de responseId. retornados pela API após a primeira solicitação de validação.
  • Use esse mesmo valor para todas as solicitações de acompanhamento até que a série é concluída.

Este diagrama de sequência mostra o fluxo preferido:

Use o ID de resposta para validar um endereço.