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 prendre son adresse après avoir vu les résultats la 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 diffusez une série 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

À l'issue d'une série de validations, Google recommande d'appeler la méthode Fournissez l'API 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 l'une des méthodes provideValidationFeedback (REST) ou ProvideValidationFeedback (gRPC).

L'exemple suivant transmet un corps JSON à la requête définissant le paramètre 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é: <ph type="x-smartling-placeholder">
  </ph>
  • VALIDATED_VERSION_USED: version validée de l'adresse dans l'API Address Validation.
  • USER_VERSION_USED: version originale 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: a abandonné la transaction.

Consultez la 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 à celle de responseId valeur renvoyée par le premier appel de la fonction 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 celle de responseId. renvoyé par l'API après la première requête de validation.
• Utilisez cette même valeur pour toutes les demandes de suivi jusqu'à la série terminé.

Ce diagramme séquentiel illustre le flux à privilégier: