Obsługa zaktualizowanych adresów

W niektórych przypadkach możesz wykonywać wiele wywołań funkcji Interfejs API do weryfikacji adresu dla pojedynczego adresu. Klient może na przykład zdecydować, zmiany w adresie po zobaczeniu wyników pierwszego weryfikacji danych. Następnie przeprowadzasz drugą weryfikację dla zaktualizowanego adresu.

W tym dokumencie opisujemy 2 kluczowe działania, które możesz wykonać w przypadku serii dla tego samego adresu do interfejsu Address Validation API. Te działania są nie są rygorystyczne wymagania dotyczące użytkowania, ale mogą być pomocne ogólną jakość danych i reakcję 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 Udostępnij interfejs Validation Feedback API, aby wskazać ostateczny wynik wszystkie weryfikacje. Żądanie ustawia 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 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: pierwotna wersja przesłana 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: porzucił(a) transakcję.
Zapoznaj się z sekcją Podsumowanie weryfikacji w przewodniku.
  • Pole responseId określa, które wyniki weryfikacji adresów chcesz uzyskać w celu przekazywania opinii na temat: 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

Przy wysyłaniu kolejnego żądania interfejs API do weryfikacji adresu dla danego adresu ustaw w polu 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 sprawdzić adres.