Gérer les adresses mises à jour

Dans certains cas, vous pouvez effectuer plusieurs appels à l'API Address Validation pour une même adresse. Par exemple, le client peut modifier son adresse après avoir vu les résultats de la première validation. Vous effectuez ensuite une deuxième validation de l'adresse modifiée.

Ce document décrit deux actions clés que vous pouvez effectuer lorsque vous envoyez une série de requêtes pour la même adresse à l'API Address Validation. Ces actions ne sont pas une exigence d'utilisation stricte, mais elles sont utiles pour améliorer la qualité globale des données et la réponse du système.

  • Envoyer une requête au point de terminaison provideValidationFeedback
  • Définir le champ previousResponseID

Envoyer une requête provideValidationFeedback

À la fin d'une série de validations, Google recommande d'appeler l'API Provide Validation Feedback pour indiquer le résultat final de toutes les validations. La requête définit deux champs :

  • conclusion : indique la version de validation que vous avez utilisée dans votre service, qu'il s'agisse de celle fournie par l'utilisateur ou de celle renvoyée par l'API Address Validation.
  • responseId : indique l'ID de réponse de la première réponse de l'API Address Validation. Consultez la section Définir le champ previousResponseId ci-dessous.

Utilisez la méthode provideValidationFeedback (REST) ou ProvideValidationFeedback (gRPC).

L'exemple suivant transmet un corps JSON à la requête définissant la conclusion :

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"
  • Le champ conclusion identifie l'une des actions suivantes de votre part :
    • VALIDATED_VERSION_USED : version validée de l'adresse à partir de l'API Address Validation.
    • USER_VERSION_USED : version d'origine fournie par l'utilisateur.
    • UNVALIDATED_VERSION_USED : version qui résulte d'une invite à l'utilisateur, mais qui n'a pas été revalidée avec l'API Address Validation.
    • UNUSED : a abandonné la transaction.
Consultez Conclusion de la validation dans le guide de référence.
  • Le champ responseId spécifie les résultats de la validation d'adresse pour lesquels vous fournissez des commentaires. Cette valeur doit être identique à la valeur responseId renvoyée par le premier appel de la méthode validateAddress.
Consultez Corps de la requête dans le guide de référence sur les commentaires de validation.

Définir le champ previousResponseID

Lorsque vous envoyez une demande de suivi à l'API Address Validation pour une adresse donnée, définissez le champ previousResponseId.

  • Pour la valeur de previousResponseId, utilisez la valeur de responseId renvoyée par l'API après la première demande de validation.
  • Utilisez cette même valeur pour toutes les demandes de suivi jusqu'à la fin de la série.

Le diagramme de séquence suivant illustre le flux recommandé :

Utilisez l'ID de réponse pour valider une adresse.