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 cambiar su dirección después de ver los resultados de la primera validación. Luego, realiza una segunda validación en la dirección actualizada.

En este documento, se describen dos acciones clave que puedes realizar cuando envías 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 hacer 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 devolvió la API de Address Validation.
  • responseId: Indica el ID de la respuesta de la primera respuesta de la API de Address Validation. Consulta Cómo establecer 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: Es 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 una instrucción para el usuario, pero no se volvió a validar con la API de Address Validation.
    • UNUSED: Abandonó la transacción.
Consulta Validation Conclusion en la guía de referencia.
  • El campo responseId especifica para qué resultados de validación de direcciones proporcionas comentarios. Este valor debe ser el mismo que el valor de responseId que devolvió 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 de responseId que devolvió 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 secuencia, se muestra el flujo preferido:

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