## Change log ### v1alpha The following updates are available in `v1alpha`. #### Edit Status for Locations and Attributes - Added [`locations.getExtended`](https://developers.google.com/my-business/reference/businessinformation/rest/v1alpha/locations/getExtended) (`GET /v1alpha/{name=locations/*}:getExtended`) to retrieve [`ExtendedLocation`](https://developers.google.com/my-business/reference/businessinformation/rest/v1alpha/locations/getExtended#ExtendedLocation), which includes the merchant-provided `Location` (`locationProvidedByMerchant`), the consumer-facing `Location` (`locationSeenByConsumers`), and a map of top-level field names to [`ExtendedFieldData`](https://developers.google.com/my-business/reference/businessinformation/rest/Shared.Types/ExtendedFieldData). - Added [`locations.attributes.getExtended`](https://developers.google.com/my-business/reference/businessinformation/rest/v1alpha/locations.attributes/getExtended) (`GET /v1alpha/{name=locations/*/attributes}:getExtended`) to retrieve [`ExtendedAttributes`](https://developers.google.com/my-business/reference/businessinformation/rest/v1alpha/locations.attributes/getExtended#ExtendedAttributes), which pairs `attributeProvidedByMerchant` and `attributeSeenByConsumers` with [`ExtendedFieldData`](https://developers.google.com/my-business/reference/businessinformation/rest/Shared.Types/ExtendedFieldData) for each attribute. - Added [`ExtendedFieldData`](https://developers.google.com/my-business/reference/businessinformation/rest/Shared.Types/ExtendedFieldData) to provide per-field and per-attribute edit metadata, including [`EditLifecycleStage`](https://developers.google.com/my-business/reference/businessinformation/rest/Shared.Types/EditLifecycleStage) (such as `EDIT_LIFECYCLE_STAGE_PENDING` or `EDIT_LIFECYCLE_STAGE_REJECTED`), [`PolicyViolation`](https://developers.google.com/my-business/reference/businessinformation/rest/Shared.Types/PolicyViolation) rejection reasons, last edit `updateTime`, and edit origin [`Source`](https://developers.google.com/my-business/reference/businessinformation/rest/Shared.Types/Source) (`SOURCE_API`, `SOURCE_UI`). - See [Check edit status for locations and attributes](https://developers.google.com/my-business/content/edit-status) for usage examples. ### v1 #### API Access The 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. #### Endpoint URL Endpoints 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/` The path name for locations endpoints has changed from `accounts/accountId/locations/locationId` to `locations/locationId` #### Location Updates - `locationName` has been renamed to `title`. - `websiteUrl` has been renamed to `websiteUri`. - `accounts.locations.list` and `locations.get` now requires a readMask. - `primaryPhone` and `additionalPhones` are now part of [PhoneNumbers](https://developers.google.com/my-business/reference/businessinformation/rest/v1/accounts.locations#Location.PhoneNumbers). - `primaryCategory` and `additionalCategories` are now part of [Categories](https://developers.google.com/my-business/reference/businessinformation/rest/v1/accounts.locations#categories). - `address` has been renamed to `storefrontAddress`. - `accounts.locations.clearAssociation` has been updated to `locations.clearLocationAssociation`. - `serviceItems` are now read and updated directly from the Location object. #### Attributes - New `Attributes` object and corresponding [locations.attributes.getGoogleUpdated](https://developers.google.com/my-business/reference/businessinformation/rest/v1/locations.attributes/getGoogleUpdated) endpoint to get the Google updated version. - `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. #### Service Area Businesses - Businesses of type `CUSTOMER_LOCATION_ONLY` are no longer required to fill out an address. - Addition of `regionCode` in [ServiceAreaBusiness](https://developers.google.com/my-business/reference/businessinformation/rest/v1/accounts.locations#Location.ServiceAreaBusiness). It must be set for businesses of type `CUSTOMER_LOCATION_ONLY`. #### Deprecated Endpoints and Objects - Removal of `LocationKey` object. The existing fields have been moved into [Metadata](https://developers.google.com/my-business/reference/businessinformation/rest/v1/accounts.locations#Location.Metadata). - Removal of `PriceLists` object. It has been replaced by FoodMenus and ServiceLists. - Removal of `LocationState` object. Most of the existing fields have been moved into [Metadata](https://developers.google.com/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](https://developers.google.com/my-business/reference/verifications/rest). Use method [locations.getVoiceOfMerchantState](https://developers.google.com/my-business/reference/verifications/rest/v1/locations/getVoiceOfMerchantState) for next steps in order to gain voice of merchant. - The endpoints `googleLocations.report` and `accounts.locations.findMatchingLocations` have been deprecated. - `TransferLocation` endpoint has been moved to `locations.transfer` under the Account Management API.