Feedback zur Adressenbestätigung geben

Sie können Google dabei helfen, die Qualität der Address Validation API zu verbessern. Optional können Sie Google Feedback geben, um uns mitzuteilen, ob eine bestätigte Adresse vom Endnutzer akzeptiert wird. Dieses Feedback hilft uns, die Gesamtgenauigkeit der API zu verbessern.

Feedbackanfrage für Adresse

Wenn Sie nach einem Aufruf einer Methode zur Adressüberprüfung Feedback geben möchten, rufen Sie die Methode ProvideValidationFeedback (REST) oder ProvideValidationFeedback (gRPC) auf. 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-Textkörper an die POST-Anfrage, mit der die Schlussfolgerung der Adressbestätigung definiert wird:

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

Wobei:

• Das Feld conclusion sollte das tatsächliche Ergebnis der Überprüfung widerspiegeln.

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

  Wenn Sie stattdessen 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 Adressvalidierung durchgeführt wird. Dieser Wert muss mit dem responseId-Wert übereinstimmen, der bei einem vorherigen Aufruf der Methode validAddress 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 die Address Validation API für eine einzelne Adresse mehrmals aufrufen. Beispielsweise kann der Endnutzer Ä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.

Wenn eine Adresse, die Sie validieren 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 Folgeanfragen enthält einen neuen responseId. Verwende 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 Ihnen, die „Validation Feedback API“ aufzurufen, um uns über das Endergebnis aller Validierungen zu informieren. Übergib die responseId aus der ersten Antwort in der Anfrage zur Validation Feedback API.

Dieses Sequenzdiagramm zeigt den gewünschten Ablauf: