История изменений

Версия 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.