Aktualisierte Adressen verarbeiten

In einigen Fällen senden Sie möglicherweise mehrere Aufrufe an die Address Validation API für eine einzelne Adresse. 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 Validierung 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 Überprüfungen empfiehlt Google, den Aufruf des Validation Feedback API bereitstellen, um das endgültige Ergebnis der alle Validierungen. 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 um die vom Nutzer zurückgegebene handelt. Address Validation API.
• responseId: Gibt die Antwort-ID der ersten Antwort des Address Validation API. Siehe Feld "previousResponseId" festlegen unten.

Verwenden Sie entweder die provideValidationFeedback (REST) oder ProvideValidationFeedback -Methode (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 wurde abgebrochen.

Siehe Ergebnis der Validierung im Referenzleitfaden.

• Im Feld responseId werden die Ergebnisse der Adressvalidierung angegeben. wenn es darum geht, Feedback zu geben. Dieser Wert muss mit responseId übereinstimmen. -Wert, der vom ersten Aufruf an den validateAddress aufrufen.

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 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 beginnt. abgeschlossen wird.

Dieses Sequenzdiagramm zeigt den bevorzugten Ablauf: