Gbplocation Object


A GBP location is a site's stable record of one Google Business Profile location.

It holds the identifiers and operational metadata needed to work with that location on Google's behalf. It doesn't store the Google-owned profile data itself: name, address, opening hours, photos, reviews, attributes and insights are all retrieved live from Google on each call, so they're never stale here and never edited here.

id is Google's own location identifier, so you can use it to correlate a location with data you retrieve from Google directly.

The only personal data on a GBP location is serviceAreaPostalAddress, which is set for service-area businesses. It's often a home address, so it's stored encrypted and is covered by the site's data-deletion requests.

A Google account must be connected before locations can be imported, and before any call that reads or writes a specific location's profile. See the Connection API.

Two methods work without a connection, because they read Google's public catalog rather than a site's own profile: Search Google Locations, and List Attribute Metadata when called with categoryRegion. Both are useful before a site owner has connected anything.

Properties
accountIdstringimmutablemaxLength 255

Google GBP Account ID (the "Location Group" container). Required in every Google API URL: accounts/{account_id}/locations/{id}. The same Wix site can have locations across multiple accounts when a Gmail spans multiple GBP accounts.


createdDatestringRead-onlyformat date-time

Date and time the location was imported into Wix.


feedEntityIdstringmaxLength 288

Identity this location is published under in Google partner feeds, used as the entity ID, merchant ID or parent entity ID across Reserve with Google, Order with Google and Dine with Google.

Can be set once. A location that already has a value keeps it, and a request that tries to change it is rejected: Google has already ingested the value as the merchant's identity, so changing it withdraws the business from those feeds and can remove its booking and ordering buttons. Setting it on a location that doesn't have one yet is allowed.

Locations created through this API are given a value automatically, so you usually don't need to set it. Specify it only when migrating a location whose identity Google already knows.


googleLocationIdstringRead-onlyimmutablemaxLength 255

Google's location identifier for this location, the same value as id. Filter and sort on this field in Query GBP Locations.


idstringimmutableminLength 1maxLength 255

Google's opaque location identifier on the public API.


revisionstringRead-only

Revision number, incremented on every update. Used for optimistic locking.


serviceAreaPostalAddressPostalAddress

Saved postal address for service-area businesses. Used as the context parameter in Google's FetchVerificationOptions call for service-area verification flows. Null for storefront businesses.


updatedDatestringRead-onlyformat date-time

Date and time any field on this row last changed.

Did this help?