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

В некоторых случаях вам может потребоваться выполнить несколько вызовов API проверки адреса для одного адреса. Например, клиент может изменить свой адрес после просмотра результатов первой проверки. Затем вы выполняете вторую проверку для обновлённого адреса.

В этом документе описаны два ключевых действия, которые вы можете выполнить при отправке серии запросов на один и тот же адрес к API проверки адресов. Эти действия не являются строгим требованием, а лишь полезными для улучшения общего качества данных и скорости отклика системы.

  • Отправьте запрос на конечную точку provideValidationFeedback
  • Установите поле previousResponseID

Отправьте запрос provideValidationFeedback

По завершении серии валидаций Google рекомендует выполнить вызов Provide Validation Feedback API, чтобы сообщить об окончательном результате всех валидаций. Запрос устанавливает два поля:

  • 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 : abandoned the transaction.
См. Заключение по проверке в справочном руководстве.
  • Поле responseId указывает, по каким результатам проверки адреса вы предоставляете отзыв. Это значение должно совпадать со значением responseId , возвращаемым первым вызовом метода validateAddress .
См. Текст запроса в справочном руководстве по обратной связи по проверке.

Установите поле previousResponseID

При отправке последующего запроса API проверки адреса для заданного адреса задайте поле previousResponseId .

  • В качестве значения previousResponseId используйте значение из responseId , возвращаемое API после первого запроса проверки.
  • Используйте это же значение для всех последующих запросов до завершения серии.

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

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