В апреле 2022 г. мы начнем отключать некоторые конечные точки Google Business Profile API. Чтобы избежать перерывов в работе, вам необходимо обновить свою интеграцию. Ознакомьтесь с графиком прекращения поддержки и инструкциями.

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

Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

Если на вашей платформе можно редактировать данные о компании в 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"
}