Obsługa zaktualizowanych adresów

W niektórych przypadkach możesz wykonać wiele wywołań interfejsu Address Billing API dla jednego adresu. Klient może na przykład zmienić swój adres po zobaczeniu wyników pierwszej weryfikacji. Następnie przeprowadzasz 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 Verificationation API. Działania te nie są rygorystyczne, ale pomagają zwiększyć 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 Query weryfikacji danych w celu wskazania końcowego wyniku wszystkich weryfikacji. Prośba ustawia 2 pola:

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

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

Ten przykład przekazuje treść 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 identyfikuje jedno z tych działań po Twojej stronie:
  • VALIDATED_VERSION_USED: zweryfikowana wersja adresu z interfejsu Address Verificationation API.
  • USER_VERSION_USED: pierwotna wersja udostępniona przez użytkownika.
  • UNVALIDATED_VERSION_USED: wersja, która była wynikiem promptu skierowanego do użytkownika, ale nie została ponownie zweryfikowana za pomocą interfejsu Address Verificationation API.
  • UNUSED: porzucił transakcję.

W przewodniku znajdziesz Wniosek dotyczący weryfikacji.

• Pole responseId określa wyniki weryfikacji adresu, których dotyczy Twoja opinia. Ta wartość musi być taka sama jak wartość responseId zwrócona przez pierwsze wywołanie metody validateAddress.

Zapoznaj się z sekcją Treść żądania w przewodniku po weryfikacji opinii.

Ustawianie pola previousResponseID

Wysyłając kolejne żądanie do interfejsu Address Billingation API dla danego adresu, skonfiguruj pole previousResponseId.

• Jako wartości previousResponseId użyj wartości z metody responseId zwróconej przez interfejs API po pierwszym żądaniu weryfikacji.
• Używaj tej samej wartości w przypadku wszystkich kolejnych żądań do momentu zakończenia serii.

Na tym schemacie sekwencji widać preferowany przepływ: