Часто задаваемые вопросы

Что такое GBP API?

Business Profile API – это интерфейсы программирования, которые позволяют разработчикам создавать приложения для управления аккаунтами сервиса "Профиль компании" и данными об адресах. С помощью этих API продавцы или их представители могут управлять показом данных в Google и предоставлять другим пользователям права администратора. Кроме того, API поддерживают управление пользовательскими данными, такими как фотографии, записи и отзывы.

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

Кто может получить доступ к GBP API?

Доступ к GBP API надо запрашивать. Мы одобряем запросы всех компаний и физических лиц, у которых есть законное коммерческое основание для использования GBP API. Например, чтобы подтвердить законность, нужно:

  • использовать действительный корпоративный адрес электронной почты в домене компании;
  • поддерживать актуальность данных на сайте компании.

Можно ли с помощью GBP API отправлять запросы к данным профиля компании в Google?

Отправлять запросы можно только в том случае, если у вас есть доступ к определенному профилю компании в Google.

Какие правила действуют для пользователей GBP API?

Необходимо соблюдать правила сервиса "Профиль компании в Google", а также правила и Условия использования API.

Как пользователи могут получить доступ к GBP API?

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

  1. Создайте аккаунт Google
  2. Поработайте с профилем компании
  3. Создайте проект в Google API Console
  4. Запросите доступ к API (запросы рассматриваются в течение 14 дней)

Как получить доступ к определенному API из набора GBP API?

В Google API Console нужно включить восемь API, связанных с профилем компании:

  • Google My Business API 4.9, включающий следующие функции вызова API:
    • FoodMenus
    • Media
    • Reviews
    • LocalPosts
  • My Business Account Management API;
  • My Business Lodging API;
  • My Business Place Actions API;
  • My Business Notifications API;
  • My Business Verifications API;
  • My Business Business Information API;
  • My Business Q&A API;
  • Business Profile Performance API.

Если запрос на использование GBP API будет одобрен, вы получите стандартную квоту по умолчанию для всех восьми API.

Как работает доступ к GBP API?

Доступ к GBP API предоставляется на уровне проекта Google Cloud. Допустим, пользователь А запросил доступ к Google Business Profile API для проекта 12345678 и получил доступ для этого проекта. После этого любой пользователь с доступом к этому проекту Google Cloud, включая пользователя А, сможет вызывать все Google Business Profile API. Чтобы избежать злоупотреблений, необходимо самостоятельно следить за доступом к проекту Google Cloud и предоставлять его, только когда это необходимо.

Какие возможности есть у разных API?

Ниже приводится таблица с примерами возможностей API.

API Справочная документация Примеры возможностей
Account Management API Документация
  • Управление доступом к адресу.
  • Создание дочернего аккаунта определенного типа с собственным названием.
  • Создание списка всех аккаунтов для авторизованного пользователя.
  • Создание списка приглашений, ожидающих ответа, для определенного аккаунта.
  • Перенос адреса из аккаунта, принадлежащего пользователю, в другой аккаунт.
  • Изменение администратора определенного адреса.
Business Information API Документация
  • Управление жизненным циклом профиля. Добавление в профиль информации о компании и управление ею.
  • Получение, создание, обновление и удаление профилей компании в Google для продавцов.
  • Получение и обновление атрибутов профиля для продавцов.
  • Получение и поиск сетей и категорий профиля для продавцов.
Lodging API Документация
  • Управление информацией о жилье, например об удобствах и правилах проживания, для компаний в Google. Этот API предназначен для компаний, которые предлагают жилье, например для гостиниц. Разработчики могут с его помощью менять атрибуты жилья в профиле компании.
Place Actions API Документация
  • Управление ссылками для действий, связанных с местами, для компаний.
  • Перенаправление пользователей на страницы, где можно записаться на прием, забронировать столик, заказать доставку еды и т. д.
Notifications API Документация
  • Управление настройками уведомлений для определенных аккаунтов.
Verifications API Документация
  • Инициация проверки адреса.
  • Создание списка всех доступных способов проверки на определенном языке.
Q&A API Документация
  • Управление вопросами и ответами об адресах.
Business Profile Performance API Документация
  • Получение статистики эффективности страниц в Google для продавцов.
  • Доступны следующие данные: показы сведений о компании, запросы маршрутов, клики-звонки, клики с переходом на сайт, бронирования, заказы еды, взаимодействия с меню и т. п.
Media API Документация
  • Загрузка фото и видео в профиль компании для разработчиков.
Reviews API Документация
  • Получение отзывов и возможность отвечать на них в профиле компании для продавцов.
Local Posts API Документация
  • Получение, создание и обновление местных публикаций для продавцов.
FoodMenus API Документация
  • Получение, создание и обновление меню в профиле компании для продавцов.

Какой должна быть структура аккаунта партнера для использования GBP API?

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

Как компания может предоставить партнеру доступ к GBP API?

Дать доступ стороннему партнеру можно двумя способами:

  • С помощью OAuth. Ознакомьтесь с руководством, в котором рассказывается, как сторонние партнеры используют учетные данные продавцов, чтобы просматривать и изменять данные в профиле компании от имени продавцов.

  • Доступ с правами владельца или администратора. Если продавец является основным владельцем профиля, он может добавить стороннего партнера в качестве администратора. После этого партнеру не нужно будет использовать учетные данные продавца для работы с GBP API и доступа к данным профиля.

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

Если у компании 10 или больше адресов, можно ли подтвердить их массово?

Да. Если у вас 10 и более профилей, вы можете запросить массовое подтверждение. Опубликованными подтвержденными адресами, входящими в сети, можно управлять с помощью Business Profile API так же, как и обычными. Однако есть ряд исключений. Например, менеджеры адресов имеют другой набор прав и могут предоставлять себе возможность управлять адресами, которые входят во франшизу.

Каковы квоты на использование разных API?

Квоты приводятся в статье Лимиты на использование. Если вам необходимо превысить ограничения, отправьте стандартный запрос.

Какое увеличение квоты я могу запросить?

Ресурсы API ограничены. Служба поддержки GBP API определит, может ли ваш запрос быть выполнен, на основе использования квоты в прошлые периоды. Если вы в среднем используете менее 70 % текущей квоты, вам может быть отказано в ее увеличении.

Могут ли партнеры по GBP API создавать тестовые аккаунты для разработки?

Нет. Мы не предоставляем возможность создать поддельный профиль компании и проверить его в интерфейсе сервиса или через API.

Поддельные страницы компаний обычно помечаются модераторами и блокируются. Вы можете, например, использовать реальную страницу клиента в нерабочие часы (не меняйте важную информацию, такую как название, адрес или категория компании), или создать страницу для вашей компании. Если вы хотите протестировать ответы API, чтобы подтвердить страницу, или выполнить другое действие, для которого требуется тестовая страница, используйте фиктивные ответы API.