Места на борту из бизнес-профиля

Бизнес-профиль – это бесплатный и простой в использовании инструмент для компаний и организаций, с помощью которого они могут управлять своим присутствием в Интернете в Google, включая Поиск и Карты.

Google Business Profile API предоставляет интерфейс для управления информацией о местоположении компании в Google. Предприятие может предоставить доступ через согласие OAuth другому предприятию для управления своим профилем от его имени.

Управляемые компании в бизнес-профиле уже прошли проверку в процессе проверки бизнес-профиля. Вы можете расширить поток согласия OAuth бизнес-профиля, чтобы подключить эти компании к бизнес-сообщениям и автоматически проверить их для запуска в бизнес-сообщениях.

Это более масштабируемый и быстрый метод запуска бизнес-сообщений, который рекомендуется для включения обмена сообщениями для местоположения бизнес-профиля.

Предпосылки

Вы должны быть существующим партнером бизнес-профиля и иметь доступ к API бизнес-профиля Google. Если вы этого не сделаете, выполните предварительные требования бизнес-профиля, чтобы подать заявку на доступ.

Получив доступ к Google Business Profile API, следуйте инструкциям по базовой настройке и настройке OAuth, прежде чем продолжить.

Включить бизнес-сообщения для подтвержденного местоположения бизнес-профиля

На следующей диаграмме показано, как ваша веб-служба может использовать проверку местоположения бизнес-профиля бренда для агента бизнес-сообщений. Подробные инструкции см. ниже.

Блок-схема автоматической проверки агентов с помощью проверки бизнес-профиля

  1. В существующем потоке согласия OAuth, где владелец бизнес-профиля предоставляет вам доступ для вызова API-интерфейсов бизнес-профиля Google от его имени, обновите области API, чтобы включить

    • https://www.googleapis.com/auth/business.manage
    • https://www.googleapis.com/auth/бизнескоммуникации

    Обе области необходимы для успешной автоматической проверки местоположения агента и бизнеса.

  2. Создайте агент с displayName именем, совпадающим с именем хотя бы одного из списков бизнес-профилей Google, принадлежащих учетным данным OAuth, полученным на предыдущем шаге. Ищите местоположения с помощью Google Business Profile API , чтобы найти названия компаний.

    Для совпадения имен,

    • Регистр символов нечувствителен.
    • Полное имя агента должно точно совпадать с первым словом или словами в названии местоположения бизнес-профиля. Например, агент с именем «GBP Bakery» соответствует «GBP Bakery Mountain View», «GBP Bakery» и «GBP Bakery solarvale», но не соответствует «Bakery San Francisco».

  3. Для каждого местоположения в бизнес-профиле создайте местоположение с одинаковым placeId . placeId для местоположения бизнес-профиля содержится в объекте LocationKey , когда местоположение извлекается из API бизнес-профиля Google.

  4. С созданным вами агентом и полученным токеном OAuth запросите проверку агента .

    В запросе подтверждения требуется контактная информация бренда. Однако в процессе проверки бренду не будет отправлено электронное письмо, если имя агента совпадает с именем бизнес-профиля и если вы получили токен OAuth с правильными областями действия.

    Если вы сделали это правильно, выходные данные запроса на проверку должны немедленно вернуть состояние verificationState VERIFICATION_STATE_VERIFIED . Если verificationState возвращает другое значение, вероятно, вы использовали неправильный токен OAuth при отправке запроса или агент не может быть сопоставлен с местоположением бизнес-профиля.

  5. Используя один и тот же токен OAuth, запросите подтверждение местоположения для всех местоположений, принадлежащих компании, в бизнес-профиле.

    Как и в случае с проверкой агента, если вы сделали это правильно, выходные данные запроса на проверку должны немедленно возвращать статус verificationState VERIFICATION_STATE_VERIFIED . Если verificationState возвращает другое значение, вероятно, вы использовали неверный токен OAuth при отправке запроса или местоположение бизнес-профиля не является заявленным и подтвержденным бизнесом.

  6. Запустите агент с точкой входа LOCATION .

  7. Включите обмен сообщениями для определенных мест, запустив места, которые вы хотите сделать доступными через Поиск и Карты. После начала процесса запуска сообщения для каждой запущенной локации становятся доступны пользователям в течение нескольких часов.

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