Aktualisierte Adressen verarbeiten

In einigen Fällen kann die Address Validation API für eine einzelne Adresse mehrmals aufgerufen werden. Beispielsweise kann der Kunde Änderungen an seiner Adresse vornehmen, nachdem er die Ergebnisse der ersten Validierung gesehen hat. Anschließend führen Sie eine zweite Validierung der aktualisierten Adresse durch.

In diesem Dokument werden zwei wichtige Maßnahmen beschrieben, die Sie ausführen können, wenn Sie eine Reihe von Anfragen für dieselbe Adresse an die Address Validation API senden. Diese Aktionen sind keine strikte Nutzungsanforderung, sondern eine hilfreiche Maßnahme Ihrerseits, um die Datenqualität insgesamt und die Systemreaktion zu verbessern.

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

provideValidationFeedback-Anfrage senden

Am Ende einer Reihe von Validierungen empfiehlt Google, die Deploy Validation Feedback API aufzurufen, um das Endergebnis aller Validierungen anzugeben. Die Anfrage legt zwei Felder fest:

• conclusion: Gibt die Validierungsversion an, die Sie in Ihrem Dienst verwendet haben, unabhängig davon, ob es sich um die vom Nutzer bereitgestellte oder die von der Address Validation API zurückgegebene Version handelte.
• 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 definiert 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 können Sie eine der folgenden Aktionen angeben:
  • 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 Nutzeraufforderung war, aber nicht mit der Address Validation API noch einmal validiert wurde.
  • UNUSED: Die Transaktion wurde abgebrochen.

Siehe Ergebnis der Validierung im Referenzleitfaden.

• Das Feld responseId gibt an, für welche Ergebnisse der Adressvalidierung Sie Feedback geben. Dieser Wert muss mit dem responseId-Wert übereinstimmen, der vom ersten Aufruf an die Methode validateAddress zurückgegeben wurde.

Weitere Informationen finden Sie im Referenzleitfaden für Validierungsfeedback unter Anfragetext.

Feld previousResponseID festlegen

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

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

Dieses Sequenzdiagramm zeigt den bevorzugten Ablauf: