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 przeprowadzasz drugą weryfikację dla 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
  • Ustawianie pola previousResponseID

Wysyłanie prośby provideValidationFeedback

Po zakończeniu serii weryfikacji Google zaleca wywołanie Udostępnij interfejs Validation Feedback API, aby wskazać ostateczny wynik wszystkie weryfikacje. Żądanie zawiera 2 pola:

  • conclusion – wskazuje wersję weryfikacji używaną w usłudze, było to źródło podane przez użytkownika czy zwrócone przez Interfejs API weryfikacji adresu.
  • responseId – wskazuje identyfikator pierwszej odpowiedzi z tagu Interfejs API weryfikacji adresu. Zobacz Ustawianie pola poprzedniej odpowiedzi poniżej.

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

Poniższy przykład przekazuje treści JSON do żądania definiującego wniosek:

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 poniższych działań rejestrowanych przez strona:
    • VALIDATED_VERSION_USED: zweryfikowana wersja adresu z interfejsu Address Validation API.
    • USER_VERSION_USED: oryginalna wersja dostarczona przez użytkownika.
    • UNVALIDATED_VERSION_USED: wersja, która była wynikiem wyświetlenia prośby o zgodę na użytkownika, ale nie zweryfikował go ponownie za pomocą interfejsu Address Validation API.
    • UNUSED: transakcja została przerwana.
Zapoznaj się z sekcją Podsumowanie weryfikacji w przewodniku.
  • Pole responseId określa, w przypadku których wyników weryfikacji adresu przekazujesz opinię. Ta wartość musi być taka sama jak wartość responseId wartość zwracaną przez pierwsze wywołanie funkcji validateAddress.
Przeczytaj sekcję Treść żądania w przewodniku po opiniach dotyczących weryfikacji.

Ustawianie pola previousResponseID

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

  • Jako wartości parametru previousResponseId użyj wartości z responseId zwracanych przez interfejs API po pierwszym żądaniu weryfikacji.
  • Używaj tej samej wartości we wszystkich kolejnych żądaniach aż do serii .

Ten schemat sekwencji przedstawia preferowany przepływ:

Użyj identyfikatora odpowiedzi, aby zweryfikować adres.