Update a location

The location's business name.

A short description of the business.

A short tagline/slogan for the business.

Your internal store code / reference for this location. An empty string clears it, on Google too.

URL of the location's logo image.

The primary language of the listing, as a code (e.g. "en").

Street address.

Street address, line 2.

City.

State or region, as an ISO code (e.g. "CA").

Postal or ZIP code.

Latitude. If you change the address without also setting this, it's re-derived automatically.

Longitude. If you change the address without also setting this, it's re-derived automatically.

Phone number.

Any additional phone numbers beyond the primary one.

Website URL.

Whether the business is open: OPEN, CLOSED_TEMPORARILY or CLOSED_PERMANENTLY. Send null to clear it.

When the business opened or will open, as YYYY-MM-DD. Send null to clear it.

The phone number Google Ads call extensions use for this location. Send null to clear it.

Chain membership and parent or child links as Google models them: parentChain (chains/{id} or null), parentLocation (a placeId and relationType) and childrenLocations (a list of the same). It replaces the stored value; send null to clear it.

A public contact email for the business.

General category id, from GET /api/v1/locations/categories. A location needs a category: send this, categoryName, or publisherCategories.google.

General category display name. A location needs a category: send this, categoryId, or publisherCategories.google. A name that doesn't match the catalog is kept as the display category.

Per-publisher PRIMARY category — currently only google is supported here (an id and a name are both required; passing one alone would clear the category). Facebook/Apple/Bing can only be changed in the location editor. Look up google's id/name pair with GET /api/v1/locations/publisher-categories.

Up to 9 extra categories, each an { id?, name }. A bare name is accepted and its id is resolved from the category catalog where one matches. Look up ids yourself with GET /api/v1/locations/categories.

Service-area settings on Master, for a business that serves customers at their location. Set businessType to CUSTOMER_LOCATION_ONLY to hide the street address: no publisher is sent a street it would show, even if one is stored. Send null to clear it. To set it for some publishers only, use publisherServiceAreas or applyToPublishers.

CUSTOMER_LOCATION_ONLY hides the address (service area only). CUSTOMER_AND_BUSINESS_LOCATION shows the address and the areas served.

Areas served, up to 20. Each is { name, placeId?, placeType? }. Google and Bing publish them. Facebook and Apple have no list of service areas, so for them only the hidden street applies.

Google Place ID of the area. Google only accepts places that have one, so a place without it is saved but not sent to Google.

A different service area for Google, Facebook, Apple or Bing, each in the same shape as serviceArea, stored as that publisher's own value. Send null for a publisher to remove its own value so it uses serviceArea again. Send it alongside serviceArea to set Master and publishers in one call. Can't be combined with applyToPublishers.

Service-area settings on Master, for a business that serves customers at their location. Set businessType to CUSTOMER_LOCATION_ONLY to hide the street address: no publisher is sent a street it would show, even if one is stored. Send null to clear it. To set it for some publishers only, use publisherServiceAreas or applyToPublishers.

CUSTOMER_LOCATION_ONLY hides the address (service area only). CUSTOMER_AND_BUSINESS_LOCATION shows the address and the areas served.

Areas served, up to 20. Each is { name, placeId?, placeType? }. Google and Bing publish them. Facebook and Apple have no list of service areas, so for them only the hidden street applies.

Google Place ID of the area. Google only accepts places that have one, so a place without it is saved but not sent to Google.

Service-area settings on Master, for a business that serves customers at their location. Set businessType to CUSTOMER_LOCATION_ONLY to hide the street address: no publisher is sent a street it would show, even if one is stored. Send null to clear it. To set it for some publishers only, use publisherServiceAreas or applyToPublishers.

CUSTOMER_LOCATION_ONLY hides the address (service area only). CUSTOMER_AND_BUSINESS_LOCATION shows the address and the areas served.

Areas served, up to 20. Each is { name, placeId?, placeType? }. Google and Bing publish them. Facebook and Apple have no list of service areas, so for them only the hidden street applies.

Google Place ID of the area. Google only accepts places that have one, so a place without it is saved but not sent to Google.

Service-area settings on Master, for a business that serves customers at their location. Set businessType to CUSTOMER_LOCATION_ONLY to hide the street address: no publisher is sent a street it would show, even if one is stored. Send null to clear it. To set it for some publishers only, use publisherServiceAreas or applyToPublishers.

CUSTOMER_LOCATION_ONLY hides the address (service area only). CUSTOMER_AND_BUSINESS_LOCATION shows the address and the areas served.

Areas served, up to 20. Each is { name, placeId?, placeType? }. Google and Bing publish them. Facebook and Apple have no list of service areas, so for them only the hidden street applies.

Google Place ID of the area. Google only accepts places that have one, so a place without it is saved but not sent to Google.

Service-area settings on Master, for a business that serves customers at their location. Set businessType to CUSTOMER_LOCATION_ONLY to hide the street address: no publisher is sent a street it would show, even if one is stored. Send null to clear it. To set it for some publishers only, use publisherServiceAreas or applyToPublishers.

CUSTOMER_LOCATION_ONLY hides the address (service area only). CUSTOMER_AND_BUSINESS_LOCATION shows the address and the areas served.

Areas served, up to 20. Each is { name, placeId?, placeType? }. Google and Bing publish them. Facebook and Apple have no list of service areas, so for them only the hidden street applies.

Google Place ID of the area. Google only accepts places that have one, so a place without it is saved but not sent to Google.

Social profile URLs: facebook, instagram, twitter, linkedin, youtube, tiktok, pinterest. On update only the keys you send change; null clears one. Published to Google as its url_* attributes and to Bing and Apple.

Payment methods accepted, e.g. "Visa", "American Express", "Cash only". Replaces the whole list; an empty list or null clears it. Published to Google as its pay_* attributes and to Apple and Bing.

Google Business Profile attributes, as a map of attribute id to value (e.g. { "attributes/wi_fi": "free" }). REPLACES the whole set, including url_* links such as appointment or dealer links, so read the current ones from GET /api/v1/locations/{id} and pass back everything you want kept. Ids Google doesn't offer for the location's category are not saved and come back in rejectedAttributes; the rest of the update still applies. Social, menu and payment ids (url_facebook, url_menu, pay_*, …) are also returned there: set those with socialLinks, menuUrl and paymentMethods.

The services or products this location offers — replaces the existing list.

The owner's name.

URL of the business's menu.

The year the business was established (e.g. 2012).

Internal tags for your own organization — not shown publicly. Replaces the existing list.

Internal labels for this location. Replaces the existing list.

The weekly regular-hours schedule — replaces the existing schedule entirely. One entry per day of the week.

Extra hour types beyond regular hours (delivery, takeout, happy hour, etc.), replaces the existing list.

One-off date overrides — holiday closures or a single day's special hours — replaces the existing list. Any calendar date works, not just named holidays.

The full business profile for one location: address, hours, categories, attributes, services, media, and status — everything update_location can change, plus what create returned.

Unique identifier for the location.

The location's business name.

A description of the business, or null.

A short tagline/slogan for the business, or null.

Your internal store code / reference for this location, or null.

URL of the location's logo image, or null.

Street address, line 1, or null.

Street address, line 2, or null.

City.

State or region.

Postal or ZIP code, or null.

Country, as an ISO-3166-1 alpha-2 code, or null.

Latitude, or null.

Longitude, or null.

Primary phone number, or null.

Any additional phone numbers beyond the primary one.

The location's website URL, or null.

A public contact email for the business, or null.

The general category's display name, or null.

The effective primary category's display name — per-publisher (Google) if set, else general — or null.

The location's primary Google category id (gcid), or null.

Up to 9 extra categories, each with an id (when resolved) and a display name.

Google Business Profile attributes, as the stored { id, value } list.

The attribute's value — a boolean for yes/no attributes, a string for single-choice ones, or an object with setValues/unsetValues for multi-select.

The services or products this location offers.

The owner's name, or null.

URL of the business's menu, or null.

Social profile URLs by network, or null.

Payment methods accepted, as display names.

The year the business was established, or null.

Internal tags for your own organization — not shown publicly.

Internal labels for this location.

The weekly regular-hours schedule, or null.

Extra hour types beyond regular hours (delivery, takeout, etc.), or null.

One-off date overrides — holiday closures or a single day's special hours — or null.

Service-area settings on Master, or null for a plain storefront.

CUSTOMER_LOCATION_ONLY hides the address (service area only). CUSTOMER_AND_BUSINESS_LOCATION shows the address and the areas served.

Areas served, up to 20. Each is { name, placeId?, placeType? }. Google and Bing publish them. Facebook and Apple have no list of service areas, so for them only the hidden street applies.

Per-publisher values that differ from Master, keyed by google, facebook, apple or bing. Each publisher publishes these values; a publisher without an entry for a field uses the Master value. Kept whether or not the publisher is connected.

Media items grouped by category (e.g. EXTERIOR, INTERIOR, FOOD_AND_DRINK, LOGO, TEAMS). Each item has a url, and optionally a label, kind (PHOTO or VIDEO), source, starred flag, and asset key.

ID of the client this location belongs to, or null.

Whether the location is archived.

When archival was requested (also the token cancel-archive matches on), as an ISO 8601 timestamp, or null if none is pending.

Google verification state: verified, pending, unverified, or unknown, or null.