Aktualisierte Adressen verarbeiten

In einigen Fällen können Sie für eine einzelne Adresse mehrere Aufrufe der Address Validation API ausführen. Beispielsweise kann der Kunde Änderungen an seiner Adresse vornehmen, nachdem er die Ergebnisse der ersten Überprüfung 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 Maßnahmen sind keine strikte Nutzungsanforderung, sondern eine hilfreiche Maßnahme Ihrerseits, um die allgemeine Datenqualität und die Systemantwort zu verbessern.

• Anfrage an den provideValidationFeedback-Endpunkt senden
• Feld previousResponseID festlegen

provideValidationFeedback-Anfrage senden

Am Ende einer Reihe von Validierungen empfiehlt Google, die API „Provide Validation Feedback“ aufzurufen, um das endgültige Ergebnis aller Validierungen anzugeben. In der Anfrage werden zwei Felder festgelegt:

• conclusion: Gibt die in Ihrem Dienst verwendete Validierungsversion an, d. h., ob es sich um die vom Nutzer angegebene oder die von der Address Validation API zurückgegebene Version handelt.
• responseId: Gibt die Antwort-ID der ersten Antwort von der Address Validation API an. Weitere Informationen finden Sie unten im Abschnitt Feld „previousResponseId“ festlegen.

Verwenden Sie entweder die Methode provideValidationFeedback (REST) oder die Methode ProvideValidationFeedback (gRPC).

Im folgenden Beispiel wird der Anfrage ein JSON-Text übergeben, der die Schlussfolgerung definiert:

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 dir 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 auf eine Aufforderung an den Nutzer zurückzuführen ist, aber nicht noch einmal mit der Address Validation API validiert wurde.
  • UNUSED: die Transaktion abgebrochen hat.

Weitere Informationen finden Sie im Leitfaden unter Validierungsergebnis.

• Im Feld responseId geben Sie an, für welche Ergebnisse der Adressüberprüfung Sie Feedback geben. Dieser Wert muss mit dem responseId-Wert übereinstimmen, der beim ersten Aufruf der Methode validateAddress zurückgegeben wurde.

Weitere Informationen finden Sie im Referenzhandbuch für Feedback zur Validierung unter Request Body (Anfragetext).

Feld previousResponseID festlegen

Wenn Sie eine Folgeanfrage an die Address Validation API für eine bestimmte Adresse senden, müssen Sie das Feld previousResponseId festlegen.

• Verwenden Sie für den Wert von previousResponseId den Wert von responseId, der nach der ersten Validierungsanfrage von der API zurückgegeben wurde.
• Verwenden Sie diesen Wert für alle Folgeanfragen, bis die Reihe abgeschlossen ist.

Dieses Sequenzdiagramm zeigt den bevorzugten Ablauf: