Mitunter führen Sie mehrere Aufrufe der Address Validation API für eine einzelne Adresse aus. Beispielsweise kann es sein, dass ein Kunde seine Adresse ändert, nachdem er die Ergebnisse der ersten Validierung gesehen hat. Anschließend führen Sie eine zweite Überprüfung der aktualisierten Adresse durch.
In diesem Dokument werden zwei wichtige Maßnahmen beschrieben, die Sie ergreifen können, wenn Sie eine Reihe von Anfragen für dieselbe Adresse an die Address Validation API senden. Diese Aktionen sind keine strikte Anforderung an die Nutzung, sondern eine hilfreiche Maßnahme Ihrerseits, um die Datenqualität und die Systemreaktion insgesamt zu verbessern.
- Anfrage an den Endpunkt
provideValidationFeedback
senden - Feld
previousResponseID
festlegen
provideValidationFeedback
-Anfrage senden
Am Ende einer Reihe von Validierungen empfiehlt Google, einen Aufruf an die Provide Validation Feedback API zu senden, um das Endergebnis aller Validierungen anzugeben. In der Anfrage werden zwei Felder festgelegt:
conclusion
: Gibt die Validierungsversion an, die Sie in Ihrem Dienst verwendet haben. Dabei spielt es keine Rolle, ob es sich um die vom Nutzer bereitgestellte oder die von der Address Validation API zurückgegebene Version handelt.responseId
: Gibt die Antwort-ID der ersten Antwort der Address Validation API an. Weitere Informationen finden Sie unten im Abschnitt Feld "PreviousResponseId" festlegen.
Verwenden Sie entweder die Methode provideValidationFeedback (REST) oder ProvideValidationFeedback (gRPC).
Im folgenden Beispiel wird ein JSON-Text an die Anfrage übergeben, mit der die Schlussfolgerung festgelegt wird:
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"
- Im Feld
conclusion
wird eine der folgenden Aktionen von Ihrer Seite angegeben:VALIDATED_VERSION_USED
: Die validierte Version der Adresse aus der Address Validation API.USER_VERSION_USED
: die vom Nutzer bereitgestellte Originalversion.UNVALIDATED_VERSION_USED
: Eine Version, die das Ergebnis einer Aufforderung an den Nutzer war, sie aber nicht noch einmal mit der Address Validation API validiert wurde.UNUSED
: Die Transaktion wurde abgebrochen.
Siehe Validierungsergebnis im Referenzleitfaden. |
- Das Feld
responseId
gibt an, für welche Ergebnisse der Adressvalidierung Sie Feedback geben. Dieser Wert muss mit dem WertresponseId
übereinstimmen, der vom ersten Aufruf der Methode validateAddress zurückgegeben wird.
Siehe Anfragetext im Referenzhandbuch für Validierungsfeedback. |
Feld previousResponseID
festlegen
Wenn Sie eine Folgeanfrage für eine bestimmte Adresse an die Address Validation API senden, müssen Sie das Feld previousResponseId
festlegen.
- Verwenden Sie für den Wert von
previousResponseId
den Wert aus derresponseId
, der von der API nach der ersten Validierungsanfrage zurückgegeben wird. - Verwenden Sie denselben Wert für alle Folgeanfragen, bis die Serie abgeschlossen ist.
Dieses Sequenzdiagramm zeigt den bevorzugten Ablauf: