В некоторых случаях вы можете выполнить несколько вызовов API проверки адреса для одного адреса. Например, клиент может внести изменения в свой адрес после просмотра результатов первой проверки. Затем вы выполняете вторую проверку обновленного адреса.
В этом документе описаны два ключевых действия, которые вы можете предпринять при отправке серии запросов на один и тот же адрес в API проверки адреса. Эти действия не являются строгим требованием к использованию, а являются полезными действиями с вашей стороны для улучшения общего качества данных и реакции системы.
- Отправьте запрос в конечную точку
provideValidationFeedback
. - Установите поле
previousResponseID
Отправьте запрос provideValidationFeedback
.
В конце серии проверок Google рекомендует вызвать API-интерфейс Provide Validation Feedback, чтобы указать окончательный результат всех проверок. Запрос устанавливает два поля:
-
conclusion
— указывает версию проверки, которую вы использовали в своей службе, независимо от того, была ли она предоставлена пользователем или возвращена из API проверки адреса. -
responseId
— указывает идентификатор первого ответа от API проверки адреса. См. раздел Установка поля previousResponseId ниже.
Используйте либо метод ProvideValidationFeedback (REST), либо метод ProvideValidationFeedback (gRPC).
В следующем примере в запрос передается тело JSON , определяющее заключение:
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"
- В поле
conclusion
указывается одно из следующих действий с вашей стороны:-
VALIDATED_VERSION_USED
: проверенная версия адреса из API проверки адреса. -
USER_VERSION_USED
: исходная версия, предоставленная пользователем. -
UNVALIDATED_VERSION_USED
: версия, которая была получена в результате запроса пользователя, но не была повторно проверена с помощью API проверки адреса. -
UNUSED
: транзакция отменена.
-
См. Заключение валидации в справочном руководстве. |
- Поле
responseId
указывает, по каким результатам проверки адреса вы предоставляете отзыв. Это значение должно совпадать со значениемresponseId
, возвращаемым при первом вызове метода validateAddress .
См. «Тело запроса» в справочном руководстве по отзывам о проверке. |
Установите поле previousResponseID
При выдаче последующего запроса API проверки адреса для данного адреса установите поле previousResponseId
.
- В качестве значения
previousResponseId
используйте значение изresponseId
возвращенного API после первого запроса проверки. - Используйте это же значение для всех последующих запросов до завершения серии.
Эта диаграмма последовательности показывает предпочтительный поток: