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, realizarás una segunda validación de 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
• 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 el 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 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 de 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 de la API de Address Validation.
  • USER_VERSION_USED: Es la versión original que proporciona el usuario.
  • UNVALIDATED_VERSION_USED: Es una versión que fue el resultado de un mensaje al usuario, pero que no la volvió a validar con la API de Address Validation.
  • UNUSED: Se abandonó la transacción.

Consulta la Conclusión de la validación en la guía de referencia.

• El campo responseId especifica para qué resultados de validación de dirección proporcionas 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 emitas una solicitud de seguimiento, 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 el mismo valor para todas las solicitudes de seguimiento hasta que finalice la serie.

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