En algunos casos, puedes realizar varias llamadas 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, realizarás una segunda validación de la dirección actualizada.
Este documento describe dos medidas clave que puedes tomar al emitir una serie de para la misma dirección a la API de Address Validation. Estas acciones son no es 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 al Proporciona la API de 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 el que proporcionó el usuario o el que devolvió el 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 provideValidationFeedback (REST) o 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 proporciona el usuario.UNVALIDATED_VERSION_USED
: Es una versión que fue el resultado de un mensaje para el usuario, pero no lo 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 qué resultados de validación de dirección deseas para hacer comentarios. Este valor debe ser el mismo que el deresponseId
el valor que muestra la primera llamada a la validateAddress.
Consulta el Cuerpo de la solicitud en la guía de referencia de comentarios de validación. |
Establece el campo previousResponseID
Al emitir una solicitud de seguimiento, la API de Address Validation para una dirección determinada, establece
el campo previousResponseId
- Para el valor de
previousResponseId
, usa el valor deresponseId
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 comience la serie. de datos completados.
En este diagrama de secuencias, se muestra el flujo preferido: