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 seconde validation sur 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 constituent 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

À l'issue 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 côté :
  • 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 résultant d'une invite de l'utilisateur, mais qui n'a pas été revalidée avec l'API Address Validation.
  • UNUSED: a abandonné la transaction.

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

• 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 le premier appel à la méthode validateAddress.

Reportez-vous à la section Corps de la requête dans le guide de référence des commentaires de validation.

Définir le champ previousResponseID

Lors de l'envoi d'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 séquentiel illustre le flux préféré: