Envoyer des commentaires sur la validation de l'adresse

Pour nous aider à améliorer la qualité de l'API Address Validation, vous pouvez éventuellement envoyer des commentaires à Google afin de nous indiquer si une adresse validée est acceptée par l'utilisateur final. Ces commentaires nous aident à améliorer la précision globale de l'API.

Répondre à la demande de commentaires sur la validation

Pour fournir des commentaires après un appel à une méthode de validation d'adresse, appelez la méthode provideValidationFeedback (REST) ou ProvideValidationFeedback (gRPC). L'exemple suivant envoie une requête POST à l'API REST:

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

Transmettez un corps JSON à la requête POST définissant la conclusion de la validation de l'adresse:

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

Où :

• Le champ conclusion doit refléter le résultat réel de la validation.

  Dans cet exemple, vous transmettez VALIDATED_VERSION_USED en tant que valeur du champ conclusion pour indiquer que l'adresse que vous avez finalement utilisée est celle renvoyée par l'API.

  Si vous finissez par utiliser l'adresse fournie par l'utilisateur final, transmettez USER_VERSION_USED.

  Pour connaître toutes les valeurs possibles pour conclusion, consultez ValidationConclusion.

• Le champ responseId spécifie les résultats de validation d'adresse pour lesquels vous fournissez des commentaires. Cette valeur doit être identique à la valeur responseId renvoyée par un appel précédent à la méthode validateAddress.

  Pour obtenir des exemples d'appel de la méthode validateAddress, consultez la section Valider une adresse.

Configurer responseID

Chaque appel de l'API Address Validation renvoie une valeur unique dans le champ responseId de la réponse.

Dans certains cas, vous pouvez effectuer plusieurs appels à l'API Address Validation pour une seule adresse. Par exemple, l'utilisateur final peut modifier son adresse après avoir vu les résultats de la première validation. Vous effectuez ensuite une deuxième validation sur l'adresse mise à jour.

Si une adresse que vous essayez de valider doit être de nouveau validée, transmettez l'responseId de la première réponse dans le champ previousResponseId de toutes les requêtes de suivi à l'API Address Validation.

Chaque réponse à ces requêtes de suivi contient un nouveau responseId, mais continuez à utiliser la valeur du premier responseId dans le previousResponseId jusqu'à la fin de la validation.

Pour en savoir plus sur la validation d'une adresse mise à jour, consultez la section Valider une adresse mise à jour.

À la fin d'une série de validations, nous vous recommandons d'appeler l'API Provide Validation Feedback pour nous faire part du résultat final de toutes les validations. Transmettez l'responseId à partir de la première réponse de la requête de l'API Provide Validation Feedback.

Ce schéma de séquence illustre le flux souhaité: