Obsługa zaktualizowanych adresów

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

W tym dokumencie opisujemy 2 kluczowe działania, które możesz wykonać, gdy wysyłasz serię żądań dotyczących tego samego adresu do interfejsu Address Validation API. Te działania nie są ścisłym wymaganiem dotyczącym użytkowania, ale mogą pomóc w poprawie ogólnej jakości danych i reakcji systemu.

  • Wyślij żądanie do punktu końcowego provideValidationFeedback.
  • Ustawianie pola previousResponseID

Wysyłanie prośby provideValidationFeedback

Po zakończeniu serii weryfikacji Google zaleca wywołanie interfejsu Provide Validation Feedback API, aby wskazać ostateczny wynik wszystkich weryfikacji. Żądanie ustawia 2 pola:

  • conclusion – wskazuje wersję weryfikacji używaną w usłudze, niezależnie od tego, czy była to wersja podana przez użytkownika, czy zwrócona przez interfejs Address Validation API.
  • responseId – identyfikator odpowiedzi pierwszej odpowiedzi z interfejsu Address Validation API. Zobacz sekcję Ustawianie pola previousResponseId poniżej.

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

W tym przykładzie do żądania przekazywana jest treść JSON, która określa zakończenie:

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 jedną z tych czynności po Twojej stronie:
    • VALIDATED_VERSION_USED: zweryfikowana wersja adresu z interfejsu Address Validation API.
    • USER_VERSION_USED: oryginalna wersja przesłana przez użytkownika.
    • UNVALIDATED_VERSION_USED: wersja, która powstała w wyniku promptu do użytkownika, ale nie została ponownie zweryfikowana za pomocą interfejsu Address Validation API.
    • UNUSED: porzucił(-a) transakcję.
Więcej informacji znajdziesz w sekcji Wniosek z weryfikacji w przewodniku.
  • Pole responseId określa, w przypadku których wyników weryfikacji adresu przesyłasz opinię. Ta wartość musi być taka sama jak wartość responseId zwrócona przez pierwsze wywołanie metody validateAddress.
Więcej informacji znajdziesz w sekcji Treść żądania w przewodniku po opiniach o sprawdzaniu poprawności.

Ustawianie pola previousResponseID

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

  • W przypadku wartości previousResponseId użyj wartości z responseId zwróconej przez interfejs API po pierwszym żądaniu weryfikacji.
  • Używaj tej samej wartości w przypadku wszystkich kolejnych żądań, dopóki seria się nie zakończy.

Ten diagram sekwencji pokazuje preferowany przepływ:

Użyj identyfikatora odpowiedzi, aby zweryfikować adres.