Встроенные адреса из профиля компании

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

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

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

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

Предварительные условия

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

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

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

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

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

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

    • https://www.googleapis.com/auth/business.manage
    • https://www.googleapis.com/auth/businesscommunication

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

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

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

    • Регистр символов нечувствителен.
    • Полное имя агента должно точно совпадать с первым словом или словами в названии местоположения в профиле компании. Например, агент с именем «GBP Bakery» соответствует «Gbp Bakery Mountain View», «Gbp Bakery» и «GBP Bakery Sunnyvale», но не соответствует «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 .