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

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

Получение текущего статуса

Вызвав метод locations.getVoiceOfMerchantState для адреса компании, можно получить его текущий статус. Если поле hasVoiceOfMerchant имеет логическое значение true, то адрес уже имеет хорошую репутацию и никаких действий не требуется. Если же действие gain_voice_of_merchant в ответе содержит значение verify, вам необходимо завершить процесс подтверждения. Чтобы получить более подробную информацию, следуйте инструкциям ниже.

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

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

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

HTTP
POST
https://mybusinessverifications.googleapis.com/v1/{locationId}:fetchVerificationOptions

{
  "languageCode": "en"
}

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

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

HTTP
POST
https://mybusinessverifications.googleapis.com/v1/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"
  }
}

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

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

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

HTTP
GET
https://mybusinessverifications.googleapis.com/v1/locations/{locationId}
/verifications

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

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

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

HTTP
POST
https://mybusinessverifications.googleapis.com/v1/locations/{locationId}
/verifications/{verificationId}:complete

{
  "pin": "123456"
}

Рекомендации по подтверждению профиля компании в Google с помощью API

Создание адресов

С помощью GBP Business Information API вы можете интегрировать функции создания адресов в вашу платформу. При отправке продавцу запроса на добавление нового адреса выполните следующие действия:

Получите всю необходимую информацию о компании продавца, такую как название, адрес и сфера деятельности.

  1. Вызовите конечную точку googleLocations.search.
  2. В запросе к API укажите название компании, ее сферу деятельности, адрес, телефон, URL сайта и другие необходимые данные

Вы также можете найти потенциально совпадающие адреса, выполнив следующие действия:

  1. Запросите возможные совпадения адресов.
  2. Предложите продавцу выбрать правильный вариант.
  3. Если в ответе на запрос есть параметр requestAdminRightsUrl, помогите продавцу получить доступ к этому адресу и право собственности на него в сервисе "Профиль компании в Google".
  4. Если параметр requestAdminRightsUrl отсутствует, создайте новый адрес на основе идентификатора, переданного в ответе на запрос.
  5. Подтвердите новый адрес.

Примечание. Если вы отправили запрос на проверку адреса и не получили ни одного возможного совпадения, создайте новый адрес, указав пустой идентификатор места, и подтвердите его.

Подтверждение адресов

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

  1. Вызовите метод accounts.locations.list, чтобы получить список всех адресов для аккаунта Google.
  2. Выберите нужный вариант.
  3. Вызовите API-метод GetVoiceOfMerchant, чтобы проверить, нужно ли этому адресу подтверждение.
  4. Если подтверждение требуется (согласно полученному ответу), вызовите метод fetchVerificationOptions, чтобы узнать о доступных способах.
  5. Убедитесь, что в данных verificationOption указан правильный адрес компании, номер телефона и адрес электронной почты.
  6. После того как продавец выберет оптимальный для него способ подтверждения, вызовите метод locations.verify, чтобы инициировать соответствующую процедуру. Убедитесь, что она выполняется. Для этого воспользуйтесь методом locations.verifications.list.
  7. Вызовите метод locations.verification.complete, указав маркер продавца.
  8. Вызовите API-метод GetVoiceOfMerchant. Если вы получили HasVoiceOfMerchant = true, адрес подтвержден успешно.

Примечание. Продавец может не выполнять процедуру подтверждения, если для его адреса доступен метод AUTO.

Дополнительную информацию о подтверждении профиля компании в Google вы найдете в этой статье Справочного центра.

Руководство по способам подтверждения для доверенных партнеров