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 tabeliresponseId
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: