Obsługa zaktualizowanych adresów

W niektórych przypadkach możesz wykonać kilka wywołań interfejsu Address Validation API dla jednego adresu. Klient może na przykład zmienić adres po zapoznaniu się z wynikami 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. Nie są to ścisłe wymaganie dotyczące użycia, ale stanowiące pomocne działanie z Twojej strony, które poprawiają ogólną jakość danych i reagowanie 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. Zapoznaj się z sekcją Ustawianie pola poprzedniej odpowiedzi poniżej.

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

Poniższy przykład przekazuje treści JSON do żądania z definicją:

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 określa jedno z tych działań z Twojej strony:
  • 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, których wyników weryfikacji adresu dotyczy Twoja opinia. 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óconego 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: