Business Information API

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

Версия 1

Доступ к API

Business Information API необходимо включить в GCP Console. Область действия OAuth остается прежней.

URL конечной точки

Конечные точки для всей информации о компании, а также всех атрибутов, категорий, филиалов и адресов теперь доступны по адресу https://mybusinessbusinessinformation.googleapis.com/v1/, а не https://mybusiness.googleapis.com/v4/.

Название пути для конечных точек адресов изменилось с accounts/accountId/locations/locationId на locations/locationId.

Обновления адресов

  • Вместо locationName теперь используется title.
  • Вместо websiteUrl теперь используется websiteUri.
  • Для accounts.locations.list и locations.get теперь необходимо использовать readMask.
  • primaryPhone и additionalPhones теперь входят в состав PhoneNumbers.
  • primaryCategory и additionalCategories теперь входят в состав Categories.
  • Вместо address теперь используется storefrontAddress.
  • Вместо accounts.locations.clearAssociation теперь используется locations.clearLocationAssociation.
  • serviceItems теперь считывается непосредственно из объекта Location и обновляется там же.

Атрибуты

  • Добавлен новый объект Attributes и соответствующая конечная точка locations.attributes.getGoogleUpdated для получения версии с изменениями, внесенными Google.
  • В attributes.list есть параметр show_all, позволяющий клиентам видеть все атрибуты, которые можно задать для определенной комбинации категории и региона.

Компании, обслуживающие определенную территорию

  • Компаниям типа CUSTOMER_LOCATION_ONLY больше не нужно заполнять поле адреса.
  • Для ServiceAreaBusiness добавлено поле regionCode, которое необходимо заполнять для компаний типа CUSTOMER_LOCATION_ONLY.

Конечные точки и объекты, которые больше не поддерживаются

  • Удален объект LocationKey. Существующие поля перемещены в Metadata.
  • Удален объект PriceLists. Вместо него теперь используются FoodMenus и ServiceLists.
  • Удален объект LocationState. Большинство существующих полей перемещены в Metadata. Хотя объект Metadata содержит логику для проверки того, управляет ли продавец компанией, поля с более детальными данными о блокировке и проверке перемещены в Verifications API. Используйте метод locations.getVoiceOfMerchantState, чтобы выполнить действия, необходимые для передачи продавцу права на управление.
  • Конечные точки googleLocations.report и accounts.locations.findMatchingLocations больше не поддерживаются.
  • Конечная точка TransferLocation перемещена в locations.transfer (Account Management API).