Obsługa zaktualizowanych adresów

W niektórych przypadkach możesz wykonać kilka wywołań interfejsu Address Validation API dla jednego adresu. Na przykład klient może wprowadzić zmiany w adresie po otrzymaniu wyników pierwszej weryfikacji. Następnie przeprowadź drugą weryfikację zaktualizowanego adresu.

W tym dokumencie opisano 2 podstawowe działania, które możesz wykonać, wysyłając serię żądań do interfejsu API weryfikacji adresów dotyczących tego samego adresu. Te działania nie są ścisłym wymogiem, ale mogą pomóc w poprawie ogólnej jakości danych i działania systemu.

• Wysyłanie żądania do punktu końcowego provideValidationFeedback
• Ustaw pole previousResponseID

Wysyłanie prośby provideValidationFeedback

Pod koniec serii weryfikacji Google zaleca wywołanie interfejsu Provide Validation Feedback API, aby wskazać ostateczny wynik wszystkich weryfikacji. Żądanie zawiera 2 pola:

• conclusion – wskazuje wersję walidacji użytą w usłudze, niezależnie od tego, czy została ona podana przez użytkownika, czy zwrócona przez interfejs Address Validation API.
• responseId – wskazuje identyfikator odpowiedzi pierwszej z interfejsu Address Validation API. Poniżej znajdziesz informacje o ustawianiu pola previousResponseId.

Użyj metody provideValidationFeedback (REST) lub ProvideValidationFeedback (gRPC).

W tym przykładzie żądaniu zdefiniowanemu w zakończeniu przekazujemy treść JSON:

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"

• Pole conclusion wskazuje, że wykonałeś/-aś jedną z tych czynności:
  • VALIDATED_VERSION_USED: zweryfikowana wersja adresu z Address Validation API.
  • USER_VERSION_USED: oryginalna wersja dostarczona przez użytkownika.
  • UNVALIDATED_VERSION_USED: wersja, która została przesłana przez użytkownika, ale nie została ponownie zweryfikowana za pomocą interfejsu Address Validation API.
  • UNUSED: transakcja została przerwana.

Więcej informacji znajdziesz w sekcji Wnioski z weryfikacji w przewodniku.

• Pole responseId określa, do których wyników weryfikacji adresu chcesz przesłać opinię. Ta wartość musi być taka sama jak wartość responseIdzwrócona przez pierwsze wywołanie metody validateAddress.

Więcej informacji znajdziesz w sekcji Treść żądania w przewodniku dotyczącym opinii o sprawdzeniu.

Ustaw pole previousResponseID

Wysyłając kolejne żądanie do interfejsu Address Validation API dotyczące danego adresu, ustaw pole previousResponseId.

• Jako wartość parametru previousResponseId użyj wartości parametru responseIdzwróconej przez interfejs API po pierwszym żądaniu weryfikacji.
• Używaj tej samej wartości w przypadku wszystkich kolejnych żądań, aż do zakończenia serii.

Ten diagram sekwencji pokazuje preferowany przepływ danych: