Gérer les adresses mises à jour

Dans certains cas, vous pouvez effectuer plusieurs appels API Address Validation pour une adresse unique. 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 sont ce n'est pas une exigence d'utilisation stricte, mais une action de votre part 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 celui fourni par l'utilisateur ou de celui renvoyé API Address Validation.
  • responseId : indique l'ID de la première réponse du 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 définissant le 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 dans l'API Address Validation.
    • USER_VERSION_USED : version d'origine fournie par l'utilisateur.
    • UNVALIDATED_VERSION_USED: version résultant d'une invite à l'utilisateur, mais ne l'a pas revalidée avec l'API Address Validation.
    • UNUSED : la transaction a été abandonnée.
Consultez la section Conclusion de la validation dans le guide de référence.
  • Le champ responseId indique les résultats de validation d'adresse dont vous êtes pour lesquelles vous donnez votre avis. 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 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 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é :

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