Controla direcciones actualizadas

En algunos casos, puedes realizar varias llamadas a la API de Address Validation para una sola dirección. Por ejemplo, el cliente puede realizar 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 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, pero son 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
  • Establece el campo previousResponseID

Enviar una solicitud de 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 mostró la API de Address Validation.
  • responseId: Indica el ID de respuesta de la primera respuesta de la API de Address Validation. Consulta Establece 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 lado:
    • VALIDATED_VERSION_USED: Es la versión validada de la dirección desde 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 al usuario, pero que no se volvió a validar con la API de Address Validation.
    • UNUSED: Se 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 envías comentarios. Este valor debe ser el mismo que el valor responseId que muestra la primera llamada al método validateAddress.
Consulta el Cuerpo de la solicitud en la guía de referencia de comentarios de validación.

Establece el campo previousResponseID

Cuando emites 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 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.