Aktualisierte Adressen verarbeiten

In einigen Fällen müssen Sie möglicherweise mehrere Aufrufe der Address Validation API für eine einzelne Adresse ausführen. Beispielsweise kann es sein, dass der Kunde seine Adresse ändert, nachdem er die Ergebnisse der ersten Validierung gesehen hat. Anschließend führen Sie eine zweite Bestätigung für die aktualisierte 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 Nutzungsanforderung, sondern eine hilfreiche Maßnahme, um die allgemeine Datenqualität und Systemreaktion zu verbessern.

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

provideValidationFeedback-Anfrage senden

Am Ende einer Reihe von Validierungen empfiehlt Google, die Provide Validation Feedback API aufzurufen, 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, unabhängig davon, 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 unter Das Feld „previousResponseId“ festlegen.

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

Im folgenden Beispiel wird ein JSON-Text an die Anfrage übergeben, in dem 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"

• Das Feld conclusion gibt eine der folgenden Aktionen von Ihrer Seite an:
  • VALIDATED_VERSION_USED: die bestätigte Version der Adresse aus der Address Validation API.
  • USER_VERSION_USED: Die vom Nutzer bereitgestellte Originalversion.
  • UNVALIDATED_VERSION_USED: Eine Version, die das Ergebnis eines Prompts an den Nutzer war, aber nicht mit der Address Validation API neu validiert wurde.
  • UNUSED: Die Transaktion wurde abgebrochen.

• Im Feld responseId wird angegeben, für welche Ergebnisse der Adressvalidierung Sie Feedback geben. Dieser Wert muss mit dem responseId-Wert übereinstimmen, der vom ersten Aufruf der Methode validateAddress zurückgegeben wird.

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 für den Wert von previousResponseId den Wert aus 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: