Aktualisierte Adressen verarbeiten

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 Wert responseId ü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 der responseId, 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: