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

Управление подтверждением

Если ваша платформа позволяет пользователям управлять информацией об их компаниях в Google, вы можете добавить функцию подтверждения данных. Тогда пользователи смогут подтверждать адреса своих компаний на вашем сайте, не переходя в интерфейс сервиса "Google Мой бизнес".

Ниже приведена схема процесса подтверждения.

Рис. 1. Схема процесса подтверждения адреса компании в сервисе "Google Мой бизнес"

Получение текущего состояния подтверждения

Вызвав метод accounts.locations.get для определенного адреса компании, можно получить текущий статус этого адреса. Если поле location.LocationState.isVerified имеет логическое значение true, то адрес уже подтвержден. В противном случае его можно подтвердить согласно инструкциям, приведенным далее в этой статье.

Получение информации о доступных способах подтверждения

С помощью метода accounts.locations.fetchVerificationOptions можно потребовать, чтобы продавец выбрал один из способов подтверждения информации о компании.

Чтобы получить информацию о доступных способах подтверждения, используйте следующий запрос:

HTTP
POST
https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}
:fetchVerificationOptions

{
  "languageCode": "en"
}

Запуск процесса подтверждения

Если способ подтверждения уже выбран, то с помощью метода accounts.locations.verify можно запустить процесс подтверждения. В результате адрес компании получит статус подтвержденного или будет возвращена ошибка.

HTTP
POST
https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}
:verify

// Use only one of the below verification methods

// For postcard verification:
{
  "method": "ADDRESS",
  "languageCode": "en",
  "addressInput": {
    "mailerContactName": "Ann Droyd"
  }
}

// For phone verification:
{
  "method": "PHONE_CALL",
  "languageCode": "en",
  "phoneInput": {
    "phoneNumber": "800-555-0136"
  }
}

// For SMS verification:
{
  "method": "SMS",
  "languageCode": "en",
  "phoneInput": {
    "phoneNumber": "800-555-0136"
  }
}

// For email verification:
{
  "method": "EMAIL",
  "languageCode": "en",
  "emailInput": {
    "emailAddress": "ex@google.com"
  }
}

Получение текущего статуса подтверждения

Вызов метода accounts.locations.verifications позволяет получить текущий статус подтверждения и историю указанного адреса.

Чтобы получить текущий статус подтверждения, используйте следующий запрос:

HTTP
GET
https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}
/verifications

Завершение начатого подтверждения

Иногда для завершения процесса подтверждения требуется указать PIN-код и вызвать метод accounts.locations.verifications.complete.

Чтобы завершить начатое подтверждение, используйте следующий запрос:

HTTP
POST
https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}
/verifications/{verificationId}:complete

{
  "pin": "123456"
}