Feedback zur Adressenbestätigung geben

Sie können uns dabei helfen, die Qualität der Address Validation API zu verbessern, wenn Sie Google Feedback geben, damit wir wissen, ob eine bestätigte Adresse vom Endnutzer akzeptiert wurde. Dieses Feedback hilft uns, die Genauigkeit der API insgesamt zu verbessern.

Feedbackanfrage zur Adressüberprüfung

Wenn Sie nach einem Aufruf einer Methode zur Adressüberprüfung Feedback geben möchten, führen Sie einen Aufruf der Methode ProvideValidationFeedback (REST) oder ProvideValidationFeedback (gRPC) aus. Im folgenden Beispiel wird eine POST-Anfrage an die REST API gesendet:

https://addressvalidation.googleapis.com/v1:provideValidationFeedback?key=YOUR_API_KEY

Übergeben Sie einen JSON-Text an die POST-Anfrage, die das Ergebnis der Adressvalidierung definiert:

{
  "conclusion": "VALIDATED_VERSION_USED",
  "responseId": "de22bed8-7f52-44cb-8526-faceac57150a"
}

Wobei:

• Das Feld conclusion sollte das tatsächliche Ergebnis der Validierung widerspiegeln.

  In diesem Beispiel übergeben Sie VALIDATED_VERSION_USED als Wert im Feld conclusion, um anzugeben, dass die Adresse, die Sie verwendet haben, von der API zurückgegeben wurde.

  Wenn Sie schließlich die vom Endnutzer angegebene Adresse verwenden, übergeben Sie USER_VERSION_USED.

  Alle möglichen Werte für conclusion finden Sie unter ValidationConclusion.

• Das Feld responseId gibt an, für welche Ergebnisse die Validierung der Adresse Sie Feedback geben. Dieser Wert muss mit dem Wert responseId übereinstimmen, der von einem vorherigen Aufruf der Methode validateAddress zurückgegeben wurde.

  Beispiele zum Aufrufen der Methode validateAddress finden Sie unter Adresse validieren.

responseID festlegen

Jeder Address Validation API-Aufruf gibt im Feld responseId der Antwort einen eindeutigen Wert zurück.

In einigen Fällen können Sie für eine einzelne Adresse mehrere Aufrufe an die Address Validation API senden. Beispielsweise kann der Endnutzer Änderungen an seiner Adresse vornehmen, nachdem er die Ergebnisse der ersten Validierung gesehen hat. Dann führen Sie eine zweite Überprüfung der aktualisierten Adresse durch.

Wenn eine Adresse, die Sie überprüfen möchten, noch einmal validiert werden muss, übergeben Sie responseId aus der ersten Antwort im Feld previousResponseId in allen Folgeanfragen an die Address Validation API.

Jede Antwort auf diese Follow-up-Anfragen enthält einen neuen responseId, verwendet jedoch weiterhin den Wert vom ersten responseId im previousResponseId, bis die Validierung abgeschlossen ist.

Weitere Informationen zum Validieren einer aktualisierten Adresse finden Sie unter Aktualisierte Adresse validieren.

Am Ende einer Reihe von Validierungen empfehlen wir, die Validation Feedback API aufzurufen und uns das Endergebnis aller Validierungen mitzuteilen. Übergeben Sie responseId aus der ersten Antwort in der Anfrage zur Validation Feedback API.

Dieses Sequenzdiagramm zeigt den gewünschten Ablauf: