Controla direcciones actualizadas

En algunos casos, es posible que realices varias llamadas a la API de Address Validation para una sola dirección. Por ejemplo, el cliente podría hacer cambios en su dirección después de ver los resultados de la primera validación. Luego, realizas una segunda validación en la dirección actualizada.

En este documento, se describen dos acciones clave que puedes realizar cuando emites una serie de solicitudes para la misma dirección a la API de Address Validation. Estas acciones no son un requisito de uso estricto, sino una acción útil de tu parte para mejorar la calidad general de los datos y la respuesta del sistema.

  • Envía una solicitud al extremo provideValidationFeedback
  • Configura el campo previousResponseID

Envía una solicitud provideValidationFeedback

Al final de una serie de validaciones, Google recomienda realizar una llamada a la API de Provide Validation Feedback para indicar el resultado final de todas las validaciones. La solicitud establece dos campos:

  • conclusion: Indica la versión de validación que usaste en tu servicio, ya sea la que proporcionó el usuario o la que se muestra de la API de Address Validation.
  • responseId: Indica el ID de respuesta de la primera respuesta de la API de Address Validation. Consulta Cómo configurar el campo previousResponseId a continuación.

Usa el método provideValidationFeedback (REST) o el método ProvideValidationFeedback (gRPC).

En el siguiente ejemplo, se pasa un cuerpo JSON a la solicitud que define la conclusión:

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"
  • El campo conclusion identifica una de las siguientes acciones de tu parte:
    • VALIDATED_VERSION_USED: La versión validada de la dirección de la API de Address Validation.
    • USER_VERSION_USED: Es la versión original que proporcionó el usuario.
    • UNVALIDATED_VERSION_USED: Es una versión que fue el resultado de un mensaje para el usuario, pero no se volvió a validar con la API de Address Validation.
    • UNUSED: abandonó la transacción.
Consulta Conclusión de la validación en la guía de referencia.
  • El campo responseId especifica para qué resultados de validación de direcciones estás proporcionando comentarios. Este valor debe ser el mismo que el valor responseId que muestra la primera llamada al método validateAddress.
Consulta Cuerpo de la solicitud en la guía de referencia de comentarios de validación.

Configura el campo previousResponseID

Cuando envíes una solicitud de seguimiento a la API de Address Validation para una dirección determinada, configura el campo previousResponseId.

  • Para el valor de previousResponseId, usa el valor del responseId que muestra la API después de la primera solicitud de validación.
  • Usa este mismo valor para todas las solicitudes de seguimiento hasta que se complete la serie.

En este diagrama de secuencias, se muestra el flujo preferido:

Usa el ID de respuesta para validar una dirección.