Aktualisierte Adressen verarbeiten

In einigen Fällen senden Sie möglicherweise mehrere Aufrufe an die Address Validation API für eine einzelne Adresse. Zum Beispiel könnte der Kunde nach der Anzeige der Ergebnisse des ersten Validierung. 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 mehrere für dieselbe Adresse an die Address Validation API senden. Diese Aktionen sind keine strikte Nutzungsanforderung, sondern eine hilfreiche Maßnahme Ihrerseits, der Datenqualität und der Systemreaktion.

• Eine Anfrage an den Endpunkt provideValidationFeedback 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. Die Anfrage legt zwei Felder fest:

• 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 ein JSON-Text an die Anfrage übergeben, mit der die Fazit:

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 identifiziert eine der folgenden Aktionen aus Ihrem Seite: <ph type="x-smartling-placeholder">
  </ph>
  • VALIDATED_VERSION_USED: die validierte Version der Adresse aus die Address Validation API.
  • USER_VERSION_USED: Die vom Nutzer bereitgestellte Originalversion.
  • UNVALIDATED_VERSION_USED: eine Version, die das Ergebnis einer Aufforderung zum ohne die Address Validation API noch einmal zu überprüfen.
  • UNUSED: Die Transaktion wurde abgebrochen.

• 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.

Feld previousResponseID festlegen

Wenn Sie eine Folgeanfrage stellen, legen Sie für die Address Validation API für eine bestimmte Adresse Folgendes fest: Das Feld previousResponseId.

• 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: