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

Журнал изменений

Версия 4.9

Новые функции

MoreHours: MoreHours.; MoreHourTypes можно получить для каждой категории с помощью метода categories.batchGet.

Изменения в поведении

Прекращение поддержки аккаунтов версии 4.x: accounts, accounts.admins, accounts.invitations и accounts.locations.admins больше не поддерживаются в Google My Business API. Более подробные сведения вы можете найти в истории изменений.
Публикации с призывами к действию (CallToAction): Во II квартале 2021 года публикации CallToAction с параметром GET_OFFER ActionType перестанут работать.

Версия 4.8

Новые функции

Жилье и удобства: Получение и обновление атрибутов для категории "Жилье и удобства". Подробнее…; Добавление конечной точки GetGoogleUpdated для категории "Жилье".; Поддержка логического значения canOperateLodgingData в LocationState
Атрибуты поставщиков медицинских услуг: Получение и обновление атрибутов поставщиков медицинских услуг. Подробнее…; Поддержка логического значения canOperateHealthData в LocationState
Комплекс страховых услуг: Список страховых услуг, подтвержденных для конкретных адресов. Подробнее…

Изменения в поведении

Идентификаторы отзывов: Идентификаторы отзывов преобразованы в новый формат. Теперь они будут возвращаться во всех применимых запросах API. В течение краткого периода при запросах API будут по-прежнему использоваться старые идентификаторы, однако в соответствии с нашими правилами крайне важно обновить все идентификаторы в системе в течение 30 дней. Используйте для этого конечную точку listReviews.
Компании, обслуживающие определенную территорию: Начиная с I квартала 2021 года Address больше не будет возвращаться в объекте Location для кампаний типа CUSTOMER_LOCATION_ONLY.

Версия 4.7

Новые функции

Блюда и меню: Получение и обновление объектов FoodMenu. Подробнее…

Версия 4.6

Новые функции

Списки услуг: Теперь вы можете получать и обновлять данные об услугах, которые предлагает компания. Подробнее…
Поддержка логического значения canModifyServiceList в LocationState: Указывает, допускается ли для адреса изменение списков услуг. Подробнее…
Предварительно установленные ServiceTypes для категорий: Предварительно установленные типы услуг теперь доступны в виде объекта для категорий. Подробнее…
CategoryView: Возможность указывать представление BASIC или FULL для категорий. Представление FULL возвращает дополнительную информацию, например типы услуг. Подробнее…
Метод Categories.BatchGet: Этот новый метод позволяет указывать список категорий и возвращать информацию только о них. Подробнее…

Версия 4.5 COVID-19 обновление 2

Новые функции

Оповещение об изменениях в связи с пандемией COVID-19: Вы можете создать публикацию типа COVID_19 с помощью API. Подробнее…

Версия 4.5 COVID-19 обновление 1

Новые функции

Временно закрыто: Вы можете присвоить компании статус CLOSED_TEMPORARILY с помощью API. Подробнее…

Версия 4.5

Новые функции

Pub/Sub для вопросов и ответов: Вы можете получать уведомления Cloud Pub/Sub о новых или измененных вопросах и ответах, связанных с адресом. Подробнее…
Pub/Sub для статуса кампании: Вы можете получать уведомления Cloud Pub/Sub об изменениях статуса даных о компании. Подробнее…

Версия 4.4

Новые функции

Подтверждение местных компаний: Теперь API поддерживает подтверждение данных о местных компаниях. Подробнее…
Счетчик подписчиков: Теперь вы можете получать метаданные о подписчиках. Подробнее…
Группы пользователей и адресов: Теперь с помощью API можно создавать группы пользователей и адресов. Подробнее…
Новое поле hasPendingEdits для LocationState: Указывает, находятся ли свойства адреса на проверке. Подробнее…

Изменение некоторых аспектов работы

Дата открытия: Вы можете указать дату открытия компании в будущем.
PointRadius: PointRadius теперь доступен только для чтения. Для создания или изменения данных о местных компаниях необходимо использовать Places.

Версия 4.3

Новые функции

API для вопросов и ответов: Вы можете получать вопросы, публиковать ответы, а также размещать заранее подготовленные ответы на часто задаваемые вопросы об адресах компании. Подробнее…
Массовое чтение отзывов: Получайте отзывы о нескольких адресах с помощью единого запроса. Подробнее…
Рекомендации GoogleLocations: Узнайте, какие адреса могут, по мнению Google, принадлежать вам. Подробнее…
Сообщение о проблемах с GoogleLocation: Вы можете сообщить о проблемах с результатами запроса RecommendedGoogleLocations или GoogleLocations. Подробнее…
Список услуг для разделов PriceList: Укажите для раздела PriceList, что там перечислено: блюда или услуги. Подробнее…
Описание медиаобъектов: Добавьте подпись при загрузке нового медиаобъекта. Подробнее…
Статистика CHAINS_QUERIES: Узнайте, сколько раз адрес был показан в результатах поиска, связанных с названием сети. Подробнее…

Изменения в поведении

Уведомления для управляющих аккаунтов и групп адресов: Аккаунты, настроенные для получения уведомлений Pub/Sub, теперь также будут получать такие уведомления для всех компаний в рамках управляющего аккаунта или групп адресов, для которых у них есть права администратора.
ListLocations для управляющих аккаунтов и групп адресов: При вызове accounts.locations.list для управляющего аккаунта или группы теперь будет показываться список всех адресов, к которым у этого аккаунта есть доступ.

Версия 4.2

Новые функции

API для подтверждения: Составляет список всех способов подтверждения, которые доступны для неподтвержденных адресов, и запускает их реализацию. Подробнее…
GoogleLocations API: Ищет в Google существующие адреса, которые вы можете подтвердить, или получает ссылку для запроса доступа к подтвержденным адресам. Подробнее…
Расширенные фильтры для адресов: Вы можете дополнительно отфильтровать результаты, полученные по запросу Locations.List. Подробнее…
Сеть, к которой принадлежит адрес: Указывает, что адрес принадлежит к определенной сети (например, "Ашан", "Лента" и т. п.). Подробнее…
Информация об организации: Информация об управляющих аккаунтах теперь будет показываться как часть объекта Account. Подробнее…
Фото профиля автора: URL для фото профилей тех, кто оставляет отзывы, теперь включены в объект review. Подробнее…

Версия 4.1

Новые функции

Медиаобъекты, предоставленные клиентом: Теперь вы можете получать и просматривать данные о фотографиях и видео, загруженных пользователями для адресов, которыми вы владеете и управляете. Подробнее…
API для управления администраторами: Теперь вы можете составлять списки приглашений, связанных с аккаунтами и адресами в рамках вашего аккаунта, а также принимать и отклонять такие приглашения. Подробнее…
Profile (описание, предоставленное продавцом): Расскажите о компании в своем стиле. Поделитесь с пользователями уникальной историей своего бренда, товаров и услуг. Подробнее…
Поле openingDate: Укажите дату, когда ваша компания начнет работать по этому адресу. Подробнее…
Специальные предложения: Новый тип публикаций в Google. Расскажите пользователям о специальных предложениях и выгодных сделках. Подробнее…

Версия 4

Новые функции

Публикации в Google: Теперь вы можете делать публикации в Google прямо через API.
Загрузка фотографий: Фотографии теперь можно загружать не только с помощью URL, но и непосредственно через API.
Включение и фильтрация уведомлений: Вы можете указать, какие уведомления необходимо отправлять в темы Pub/Sub. Впоследствии этот механизм можно будет включить вместо отправки всем пользователям.
Уведомления UPDATED_REVIEW: Теперь вы можете подписаться на уведомления об изменениях в отзывах.
Поддержка групп пользователей: Google My Business API теперь поддерживает аккаунты с группами пользователей.

Устранение обратной несовместимости

Фотографии, которые ранее были доступны в поле объектов location, теперь стали ресурсом в рамках адреса (accounts/account_ID/locations/location_ID/photos).
Поле адреса Country переименовано в region_code, а sub_locality – в sublocality.
Удалено поле Ownership, ранее признанное устаревшим.
Ранее совладельцев аккаунтов и адресов было невозможно отличить от основных владельцев при работе с API. Все они показывались как OWNER. Теперь у основных владельцев будет роль OWNER, а у всех остальных – CO_OWNER.
Объект AccountType.BUSINESS переименован в AccountType.LOCATION_GROUP.
При использовании маски поля для обновления адресов указывайте update_mask вместо field_mask.
Сообщение о категории, которое использовалось для primary_category и additional_categories, больше не будет представлено в удобочитаемом виде. Чтобы получить переведенные и понятные названия категорий, необходимо использовать соответствующий сервис в Google My Business API.

Версия 3.3

Новые функции

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

Разные меню для одного и того же адреса.
Разные разделы в рамках одного меню.
Списки пунктов меню с названием, описанием, ценой и фотографиями.

Версия 3.2

Новые функции

Статистика: Теперь с помощью API вы можете получать статистику об адресах и показатели для маршрутов.
Уведомления: Вы можете подписаться на уведомления в реальном времени (Google Update).

Устранение обратной несовместимости

Поля languageCodes и platforms, которые не использовались для UrlAttributeValue, были удалены.
SAME в устаревшем перечислении для права собственности теперь применяется только в том случае, если у адреса, который является дубликатом этого, тот же основной владелец. Раньше применялись более сложные расчеты.

Версия 3.1

Новые функции

Уведомления: Теперь вы можете подписаться на уведомления о новых отзывах в реальном времени.
URL карт: В запросы для адресов добавлены URL Google Карт, чтобы пользователи могли с легкостью перейти в этот сервис.
Статусы адресов: Дополнительные статусы адресов, которые указывают, опубликованы ли данные, находятся ли они на рассмотрении и не были ли отключены.
Пометка о восстановлении: Пометка canReopen указывает на адреса, которые отмечены как закрытые навсегда, но могут быть восстановлены.
Атрибуты: Поддержка атрибутов URL и Enum.
Конечная точка категории: Вы можете получить список категорий, которые поддерживаются для вашей страны и языка. Это заменяет файлы CSV.

Версия 3

Новые функции

Отзывы: Теперь вы можете получать отзывы о компании и отвечать на них с помощью API.
Атрибуты: С помощью атрибутов вы можете указать дополнительные сведения об адресах. Доступные возможности зависят от категории.
Поиск нужных адресов: Находите места на картах и вручную связывайте их с адресами своей компании.
Перенос адреса: Новое действие: Location :transfer. Позволяет перенести адрес из одного аккаунта компании или пользователя в другой.
Главное фото: Вы можете указать, какая фотография должна показываться первой в Google Картах и Поиске.
Новые фильтры для поиска: Новые фильтры для поиска, в том числе any_google_updates, is_suspended и is_duplicate.
Новые статусы адресов: Теперь доступны также следующие статусы адресов: is_verified и needs_reverification.
Усовершенствованные URL фотографий: API теперь принимает URL фотографий без суффикса, указывающего на графический формат.

Устранение обратной несовместимости

Фотографии адресов теперь можно обновлять только с помощью +страницы. Ранее они принимались без уведомлений.
Поля location_name и category_name теперь поддерживают только вывод. Используйте идентификаторы категорий только при настройке категорий.
В масках полей больше не требуется использовать префикс location. для включенных полей.
Операции создания и обновления теперь принимают адрес в теле запроса. Остальные параметры перенесены в строку запроса.

Версия 2

Устранение обратной несовместимости

В вызовах CreateLocation теперь обязательно должен быть элемент request_id. Идентификаторы мест должны быть уникальными, чтобы в аккаунте не было дубликатов. Попытки создать адрес с тем же идентификатором запроса, что и у ранее добавленного, просто вернут уже имеющийся адрес. Дубликат не появится в аккаунте.
- Параметр business_hours в адресе теперь называется regular_hours.