Business Information API
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
更新日志
v1
API 权限
Business Information API 将需要从 GCP Console 启用。OAuth 范围保持不变。
端点网址
可以通过 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 对象读取和更新。
属性
上门服务商家
CUSTOMER_LOCATION_ONLY
类型的商家不再需要填写地址。
- 在 ServiceAreaBusiness 中添加了
regionCode
。必须为 CUSTOMER_LOCATION_ONLY
类型的商家设置此值。
已弃用的端点和对象
- 移除了
LocationKey
对象。现有字段已移至元数据。
- 移除了
PriceLists
对象。该字段已被 FoodMenus 和 ServiceLists 取代。
- 移除了
LocationState
对象。大多数现有字段已移至元数据。虽然元数据包含一个布尔值,用于查看商家是否拥有对业务的完全控制权(商家发言权),但与暂停和验证相关的更详细的字段已移至 Verifications API。在获取商家发言权的后续步骤中使用方法 locations.getVoiceOfMerchantState。
- 端点
googleLocations.report
和 accounts.locations.findMatchingLocations
已弃用。
- 端点
TransferLocation
已移至 Account Management API 下的 locations.transfer
。
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-08-29。
[null,null,["最后更新时间 (UTC):2025-08-29。"],[[["\u003cp\u003eThe Business Information API now uses \u003ccode\u003ehttps://mybusinessbusinessinformation.googleapis.com/v1/\u003c/code\u003e as the base endpoint and requires enabling in the GCP Console.\u003c/p\u003e\n"],["\u003cp\u003eLocation data structure has been updated, renaming or relocating fields like \u003ccode\u003elocationName\u003c/code\u003e, \u003ccode\u003ewebsiteUrl\u003c/code\u003e, \u003ccode\u003eprimaryPhone\u003c/code\u003e, \u003ccode\u003eprimaryCategory\u003c/code\u003e, and \u003ccode\u003eaddress\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eA new \u003ccode\u003eAttributes\u003c/code\u003e object and \u003ccode\u003egetGoogleUpdated\u003c/code\u003e endpoint have been introduced for managing business attributes, and \u003ccode\u003eattributes.list\u003c/code\u003e now includes a \u003ccode\u003eshow_all\u003c/code\u003e parameter.\u003c/p\u003e\n"],["\u003cp\u003eService area businesses (\u003ccode\u003eCUSTOMER_LOCATION_ONLY\u003c/code\u003e) no longer require an address but need a \u003ccode\u003eregionCode\u003c/code\u003e, while \u003ccode\u003eLocationKey\u003c/code\u003e, \u003ccode\u003ePriceLists\u003c/code\u003e, and \u003ccode\u003eLocationState\u003c/code\u003e objects are deprecated.\u003c/p\u003e\n"],["\u003cp\u003eSome endpoints have been moved or deprecated, including \u003ccode\u003egoogleLocations.report\u003c/code\u003e, \u003ccode\u003eaccounts.locations.findMatchingLocations\u003c/code\u003e, and \u003ccode\u003eTransferLocation\u003c/code\u003e.\u003c/p\u003e\n"]]],["The Business Information API requires enabling in the GCP Console, with a new endpoint URL: `https://mybusinessbusinessinformation.googleapis.com/v1/`. Location endpoints' path changed to `locations/locationId`. Updates include renaming fields like `locationName` to `title` and incorporating `PhoneNumbers` and `Categories`. `Attributes` now includes a `getGoogleUpdated` endpoint, with `show_all` parameter. Service area businesses (type `CUSTOMER_LOCATION_ONLY`) now require `regionCode`. Deprecated objects include `LocationKey`, `PriceLists`, `LocationState`, and removed endpoints `googleLocations.report`, `accounts.locations.findMatchingLocations`, and `TransferLocation` moved.\n"],null,["# Business Information API\n\n\u003cbr /\u003e\n\nChange log\n----------\n\n### v1\n\n#### API Access\n\nThe Business Information API will need to be enabled from the [GCP Console](https://console.developers.google.com/apis/library/mybusinessbusinessinformation.googleapis.com). The OAuth scope remains the same.\n\n#### Endpoint URL\n\nEndpoints for all business information, attributes, categories, chains and locations search are accessible at `https://mybusinessbusinessinformation.googleapis.com/v1/` instead of `https://mybusiness.googleapis.com/v4/`\n\nThe path name for locations endpoints has changed from `accounts/accountId/locations/locationId` to `locations/locationId`\n\n#### Location Updates\n\n- `locationName` has been renamed to `title`.\n- `websiteUrl` has been renamed to `websiteUri`.\n- `accounts.locations.list` and `locations.get` now requires a readMask.\n- `primaryPhone` and `additionalPhones` are now part of [PhoneNumbers](/my-business/reference/businessinformation/rest/v1/accounts.locations#Location.PhoneNumbers).\n- `primaryCategory` and `additionalCategories` are now part of [Categories](/my-business/reference/businessinformation/rest/v1/accounts.locations#categories).\n- `address` has been renamed to `storefrontAddress`.\n- `accounts.locations.clearAssociation` has been updated to `locations.clearLocationAssociation`.\n- `serviceItems` are now read and updated directly from the Location object.\n\n#### Attributes\n\n- New `Attributes` object and corresponding [locations.attributes.getGoogleUpdated](/my-business/reference/businessinformation/rest/v1/locations.attributes/getGoogleUpdated) endpoint to get the Google updated version.\n- `attributes.list` has a `show_all` parameter allowing clients to see all the various attributes that can be set for a particular category and region combination.\n\n#### Service Area Businesses\n\n- Businesses of type `CUSTOMER_LOCATION_ONLY` are no longer required to fill out an address.\n- Addition of `regionCode` in [ServiceAreaBusiness](/my-business/reference/businessinformation/rest/v1/accounts.locations#Location.ServiceAreaBusiness). It must be set for businesses of type `CUSTOMER_LOCATION_ONLY`.\n\n#### Deprecated Endpoints and Objects\n\n- Removal of `LocationKey` object. The existing fields have been moved into [Metadata](/my-business/reference/businessinformation/rest/v1/accounts.locations#Location.Metadata).\n- Removal of `PriceLists` object. It has been replaced by FoodMenus and ServiceLists.\n- Removal of `LocationState` object. Most of the existing fields have been moved into [Metadata](/my-business/reference/businessinformation/rest/v1/accounts.locations#Location.Metadata). Although Metadata contains a boolean to see whether the merchant has full control of the business (voice of merchant), more detailed suspension and verification related fields have been moved to the [Verifications API](/my-business/reference/verifications/rest). Use method [locations.getVoiceOfMerchantState](/my-business/reference/verifications/rest/v1/locations/getVoiceOfMerchantState) for next steps in order to gain voice of merchant.\n- The endpoints `googleLocations.report` and `accounts.locations.findMatchingLocations` have been deprecated.\n- `TransferLocation` endpoint has been moved to `locations.transfer` under the Account Management API."]]