Obsługa zaktualizowanych adresów

W niektórych przypadkach możesz wielokrotnie wywoływać interfejs Address Validation API dla jednego adresu. Klient może na przykład zmienić adres po zapoznaniu się z wynikami pierwszej weryfikacji. Następnie przeprowadzasz drugą weryfikację dla zaktualizowanego adresu.

W tym dokumencie opisujemy 2 kluczowe działania, które możesz wykonać po wysłaniu do interfejsu Address Validation API serii żądań 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.

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

Wyślij prośbę o: provideValidationFeedback

Po zakończeniu serii weryfikacji Google zaleca wywołanie interfejsu API Provide Validation Feedback API w celu wskazania końcowego wyniku wszystkich weryfikacji. Żądanie ustawia 2 pola:

  • conclusion – wskazuje wersję weryfikacji użytą w usłudze, niezależnie od tego, czy została ona udostępniona przez użytkownika, czy zwrócona przez interfejs API weryfikacji adresów.
  • responseId – wskazuje identyfikator pierwszej odpowiedzi 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 interfejsu Address Validation API.
    • USER_VERSION_USED: pierwotna wersja przesłana przez użytkownika.
    • UNVALIDATED_VERSION_USED: wersja, która powstała w wyniku wyświetlenia komunikatu użytkownikowi, ale nie została ponownie zweryfikowana za pomocą interfejsu Address Validation API.
    • UNUSED: porzucił(a) transakcję.
Zapoznaj się z sekcją Podsumowanie weryfikacji w przewodniku.
  • Pole responseId określa wyniki weryfikacji adresu, na temat których przekazujesz opinię. Ta wartość musi być taka sama jak wartość responseId zwracana przez pierwsze wywołanie metody validateAddress.
Przeczytaj sekcję Treść żądania w przewodniku po opiniach dotyczących weryfikacji.

Ustawianie pola previousResponseID

Podczas wysyłania kolejnego żądania do interfejsu Address Validation API dla danego adresu ustaw wartość w polu previousResponseId.

  • Jako wartości identyfikatora previousResponseId użyj wartości z tabeli responseId zwró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 schemat sekwencji przedstawia preferowany przepływ:

Użyj identyfikatora odpowiedzi, aby sprawdzić adres.