Gérer les adresses mises à jour

Dans certains cas, vous pouvez effectuer plusieurs appels à l'API Address Validation pour une seule 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 mise à jour.

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 une action utile de votre part 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 la méthode ProvideValidationFeedback (gRPC).

L'exemple suivant transmet un corps JSON à la requête qui définit 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 côté :
  • VALIDATED_VERSION_USED: version validée de l'adresse de l'API Address Validation.
  • USER_VERSION_USED: version d'origine fournie par l'utilisateur.
  • UNVALIDATED_VERSION_USED: version issue d'une invite à l'utilisateur, mais non validée à nouveau avec l'API Address Validation.
  • UNUSED: la transaction a été abandonnée.

Consultez la section Conclusion de la validation du guide de référence.

• Le champ responseId spécifie les résultats de validation des adresses pour lesquels vous envoyez des commentaires. Cette valeur doit être identique à la valeur responseId renvoyée par le premier appel de la méthode validateAddress.

Consultez la section 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 requête 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 requête de validation.
• Utilisez cette même valeur pour toutes les requêtes de suivi jusqu'à la fin de la série.

Ce diagramme de séquence montre le flux recommandé: