Обработка обновленных адресов

В некоторых случаях вы можете выполнить несколько вызовов 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 после первого запроса проверки.
  • Используйте это же значение для всех последующих запросов до завершения серии.

Эта диаграмма последовательности показывает предпочтительный поток:

Используйте идентификатор ответа для проверки адреса.