Proporcionar comentarios de validación de dirección

Para ayudarnos a mejorar la calidad de la API de Address Validation, tienes la opción de enviar comentarios a Google para informarnos si el usuario final acepta una dirección validada. Estos comentarios nos ayudan a mejorar la precisión general de la API.

Solicitud de comentarios de validación de direcciones

Para proporcionar comentarios después de una llamada a un método de validación de direcciones, realiza una llamada al método provideValidationFeedback (REST) o al método ProvideValidationFeedback (gRPC). En el siguiente ejemplo, se realiza una solicitud POST a la API de REST:

https://addressvalidation.googleapis.com/v1:provideValidationFeedback?key=YOUR_API_KEY

Pasa un cuerpo de JSON a la solicitud POST que define la conclusión de la validación de la dirección:

{
  "conclusion": "VALIDATED_VERSION_USED",
  "responseId": "de22bed8-7f52-44cb-8526-faceac57150a"
}

Aquí:

  • El campo conclusion debe reflejar el resultado real de la validación.

    En este ejemplo, pasas VALIDATED_VERSION_USED como el valor del campo conclusion para indicar que la dirección que terminaste usando era la que mostró la API.

    Si en algún momento usas la dirección proporcionada por el usuario final, pasa USER_VERSION_USED.

    Para ver todos los valores posibles de conclusion, consulta ValidationConclusion.

  • El campo responseId especifica para qué resultados de validación de direcciones proporcionas comentarios. Este valor debe ser el mismo que el valor responseId que muestra una llamada anterior al método validateAddress.

    Para ver ejemplos sobre cómo llamar al método validateAddress, consulta Valida una dirección.

Cómo configurar responseID

Cada llamada a la API de Address Validation muestra un valor único en el campo responseId de la respuesta.

En algunos casos, puedes realizar varias llamadas a la API de Address Validation para una sola dirección. Por ejemplo, el usuario final puede realizar cambios en 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.

Si se debe volver a validar una dirección que intentas validar, pasa el responseId de la primera respuesta en el campo previousResponseId de todas las solicitudes de seguimiento a la API de Address Validation.

Cada respuesta a estas solicitudes de seguimiento contiene un responseId nuevo, pero continúa usando el valor del primer responseId en previousResponseId hasta que se complete la validación.

Para obtener más información sobre cómo validar una dirección actualizada, consulta Cómo validar una dirección actualizada.

Al final de una serie de validaciones, te recomendamos que llames a la API de Provide Validation Feedback para informarnos el resultado final de todas las validaciones. Pasa el responseId de la primera respuesta en la solicitud de la API de Provide Validation Feedback.

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

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