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

Найдите ответы на часто задаваемые вопросы об API бизнес-профилей Google.

Что такое API GBP?

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

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

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

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

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

Позволяет ли доступ к API GBP пользователю запрашивать данные из профиля Google Business Profile?

Нет. Даже если у вас есть доступ к API GBP, вы не сможете запрашивать данные из профиля Google Business Profile, если у вас нет доступа именно к этому конкретному профилю Google Business Profile .

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

Партнеры должны соблюдать правила Google Business Profile, а также все правила и условия использования API.

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

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

1. Зарегистрируйте аккаунт Google .
2. Попробуйте «Профиль компании» .
3. Создайте проект в консоли Google Cloud .
4. Запрос на доступ к API : Запросы рассматриваются в течение 14 дней.

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

Для работы с бизнес-профилем необходимо включить семь API в консоли Google Cloud:

• API Google My Business версии 4.9 включает в себя следующие важные функции вызова API:
  • FoodMenus
  • Media
  • Reviews
  • LocalPosts
• API для управления бизнес-аккаунтами
• Мой API для размещения деловых поездок
• API действий в моем рабочем месте
• API уведомлений для моего бизнеса
• API для проверки моего бизнеса
• Мой бизнес API для получения информации о бизнесе
• API для анализа производительности бизнес-профиля

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

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

Доступ к API Google Business Profile предоставляется на уровне проекта Google Cloud. Если пользователь A подал заявку на доступ к API Google Business Profile для проекта № 12345678, то доступ предоставляется для проекта № 12345678. Таким образом, любой пользователь, включая пользователя A, имеющий доступ к проекту Google Cloud, может совершать вызовы к API Google Business Profile. Партнеры должны контролировать доступ к проекту Google Cloud только в случае необходимости, чтобы избежать злоупотреблений.

У вас есть краткое описание API и примеры их возможностей?

Для получения информации о различных API и их возможностях обратитесь к таблице ниже.

API	Справочная документация	Примерные возможности
API управления учетными записями	Документация	Управление доступом к местоположению. Создает учетную запись с указанным именем и типом в рамках заданного родительского элемента. Отображает список всех учетных записей авторизованного пользователя. Отображает список ожидающих приглашений для указанной учетной записи. Перемещает местоположение из учетной записи, принадлежащей пользователю, в другую учетную запись. Обновляет информацию для администратора указанного местоположения.
API для получения бизнес-информации	Документация	API для управления бизнес-информацией позволяет управлять жизненным циклом профиля, а также добавлять или изменять информацию о компании в фунтах стерлингов. Позволяет продавцам получать, создавать, обновлять или удалять бизнес-профили Google. Позволяет продавцам получать или обновлять атрибуты профиля. Позволяет продавцам получать или искать сети магазинов и категории профилей.
API для размещения	Документация	Позволяет управлять данными о размещении, например, удобствами и политикой компании в Google. API предназначен специально для компаний, предоставляющих услуги размещения, таких как отели. API для размещения позволяет разработчикам обновлять атрибуты размещения в профиле Google Business.
API действий по размещению	Документация	Позволяет управлять ссылками на действия, совершаемые на объектах бизнеса. Перенаправляйте пользователей на такие действия, как запись на прием, бронирование столика и заказ доставки еды.
API уведомлений	Документация	Позволяет управлять настройками уведомлений для указанных учетных записей.
API проверок	Документация	Запускает процесс проверки местоположения. Сообщает обо всех доступных вариантах подтверждения для данного местоположения на определенном языке.
API для анализа производительности бизнес-профиля	Документация	Позволяет продавцам получать аналитические данные об эффективности своих бизнес-профилей в Google. Аналитические данные включают в себя информацию о посещениях бизнеса, запросах маршрута, кликах по звонкам, переходах на веб-сайт, бронированиях, заказах еды, взаимодействии с меню и многом другом.
Медиа API	Документация	Позволяет разработчикам API загружать фотографии и видео для бизнес-профиля.
API отзывов	Документация	Позволяет продавцам получать отзывы и отвечать на них в профиле компании.
API локальных сообщений	Документация	Позволяет продавцам получать, создавать или обновлять локальные публикации.
API меню еды	Документация	Позволяет продавцам получать, создавать или обновлять меню блюд для профиля компании.

Если у вас возникли вопросы по поводу имеющихся у вас данных или способов доступа к ним, заполните эту форму .

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

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

• Зарегистрируйтесь в качестве агентства для создания учетной записи в системе GBP Organization .
• Ознакомьтесь с понятиями групп пользователей и бизнес-групп .
• Обратитесь к этому руководству , чтобы понять, как управлять объектами от имени компаний.

Как компании предоставляют партнеру по API в фунтах стерлингов разрешение на управление информацией о своей компании?

Компании предоставляют доступ к партнеру 3P двумя способами:

• Настройка OAuth: обратитесь к этому руководству , чтобы понять, как партнерские платформы сторонних поставщиков используют учетные данные продавца для редактирования и доступа к данным профиля Google Business Profile от имени продавца или компании.

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

  Примечание: Мы настоятельно рекомендуем сторонним партнерам не указывать себя в качестве владельца GBP, а только в качестве управляющего.

Если у компании более 10 филиалов, есть ли способ провести массовую проверку?

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

Каковы лимиты квот для различных API?

Стандартные лимиты квот указаны в разделе « Лимиты использования» . Если вам необходимы более высокие лимиты, вы можете отправить запрос на стандартную квоту .

Какую квоту я могу запросить?

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

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

Нет. К сожалению, нет прямого способа создать поддельный список GBP в продакшене ни через пользовательский интерфейс GBP, ни через API и протестировать его.

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