locationIdstringerforderlich
The id of the location to update (required) — the id returned by create_location.
namestringoptional
The location's business name.
descriptionstringoptional
The business description.
taglinestringoptional
A short tagline/slogan for the business.
storeCodestringoptional
Your internal store code / reference for this location.
logoUrlstringoptional
URL of the location's logo image.
languageCodestringoptional
The primary language of the listing, as a code (e.g. "en").
streetstringoptional
Street address, line 1.
street1stringoptional
Street address, line 2.
stateIsostringoptional
State or region, as an ISO code (e.g. "CA").
postalCodestringoptional
Postal or ZIP code.
latitudenumberoptional
Latitude. If you change the address without setting coordinates, they're re-derived automatically.
longitudenumberoptional
Longitude. If you change the address without setting coordinates, they're re-derived automatically.
phonestringoptional
Primary phone number.
additionalPhonesstring[]optional
Any additional phone numbers (replaces the existing list).
websitestringoptional
The location's website URL.
businessEmailstringoptional
A public contact email for the business.
categoryIdstringoptional
General category id — look it up with list_categories.
categoryNamestringoptional
General category display name (from list_categories).
publisherCategoriesobjectoptional
Per-publisher PRIMARY category, one per publisher — each an { id, name } looked up with list_publisher_categories. This is what a publisher actually shows and ranks on; the general category above does not override it. Google's id is a gcid (e.g. "gcid:cookie_shop"). Note the value is stored but only reaches the publisher once that publisher is connected for this location.
idstringoptional
The publisher's own category id (from list_publisher_categories)
namestringoptional
The category's display name
idstringoptional
The publisher's own category id (from list_publisher_categories)
namestringoptional
The category's display name
idstringoptional
The publisher's own category id (from list_publisher_categories)
namestringoptional
The category's display name
idstringoptional
The publisher's own category id (from list_publisher_categories)
namestringoptional
The category's display name
additionalCategoriesobject[]optional
Up to 9 extra categories, each an { id?, name } (replaces the existing list). A bare name is accepted and its id is resolved from the category catalog where one matches.
namestringoptional
Category name
attributesobjectoptional
Google Business Profile attributes, as a map of attribute id to value — e.g. { "attributes/is_owned_by_women": true, "attributes/wi_fi": "free" }. REPLACES the whole set, so read the current ones with get_location_by_id and pass back everything you want kept. Values are a boolean for yes/no attributes, a string for single-choice ones, or { setValues: [...], unsetValues: [...] } for multi-select. Google only accepts attributes its catalog allows for this location's category and country — unsupported ids are dropped when publishing rather than failing the update. Don't set social-link, menu-URL or payment attributes here; use socialLinks, menuUrl and the payment fields instead.
servicesobject[]optional
The services or products this location offers (replaces the existing list). Each entry is { name, description?, price?, currency?, googleServiceTypeId? }. price is a number in the listed currency (e.g. 12.5 with currency "USD"); omit both for services with no set price.
namestringoptional
Service or product name (required).
descriptionstringoptional
Short description — this is where long-tail keywords belong.
pricenumberoptional
Price as a number, in `currency`.
currencystringoptional
ISO 4217 currency code, e.g. "USD".
googleServiceTypeIdstringoptional
Google's service-type id, when it maps to one of Google's predefined services. There's currently no tool to look these up — omit it and the service is still saved, just without that Google-specific mapping.
ownerNamestringoptional
The owner's name.
menuUrlstringoptional
URL of the business's menu.
yearEstablishednumberoptional
The year the business was established (e.g. 2012).
tagsstring[]optional
Internal tags for your own organization — not shown publicly (replaces the existing list).
labelsstring[]optional
Internal labels for this location (replaces the existing list).
regularHoursobject[]optional
The weekly regular-hours schedule — replaces the existing schedule entirely. Pass one entry per day of the week (7 entries, one for each of MONDAY–SUNDAY).
day"MONDAY" | "TUESDAY" | "WEDNESDAY" | "THURSDAY" | "FRIDAY" | "SATURDAY" | "SUNDAY"optional
Day of week.
closedbooleanoptional
true if closed all day.
periodsobject[]optional
Open/close intervals for this day. Omit or leave empty when closed. For 24-hour, use a single period { open: "00:00", close: "24:00" }.
openstringoptional
Open time, 24h "HH:MM" (e.g. "09:00").
closestringoptional
Close time, 24h "HH:MM" — use "24:00" for midnight/end-of-day.
moreHoursobject[]optional
Extra hour types beyond regular hours (delivery, takeout, happy hour, etc.), replaces the existing list. Each entry is { hoursTypeId, label?, days }, where days is the same weekly-schedule shape as regularHours. Common hoursTypeId values: DELIVERY, TAKEOUT, PICKUP, DRIVE_THROUGH, BREAKFAST, LUNCH, DINNER, BRUNCH, HAPPY_HOUR, KITCHEN, ONLINE_SERVICE_HOURS, ACCESS, SENIOR_HOURS.
hoursTypeIdstringoptional
The more-hours type id, e.g. "DELIVERY".
labelstringoptional
Optional display label for this hours type.
daysobject[]optional
Weekly schedule for this hours type, same shape as regularHours.
day"MONDAY" | "TUESDAY" | "WEDNESDAY" | "THURSDAY" | "FRIDAY" | "SATURDAY" | "SUNDAY"optional
Day of week.
closedbooleanoptional
true if closed all day.
periodsobject[]optional
Open/close intervals for this day. Omit or leave empty when closed. For 24-hour, use a single period { open: "00:00", close: "24:00" }.
openstringoptional
Open time, 24h "HH:MM" (e.g. "09:00").
closestringoptional
Close time, 24h "HH:MM" — use "24:00" for midnight/end-of-day.
specialHoursobject[]optional
One-off date overrides — holiday closures or a single day's special hours — replaces the existing list. Each entry is { date, closed, open?, close? } where date is any calendar date as "YYYY-MM-DD" (not limited to named holidays — use this for requests like "mark this Sunday, Aug 2 2026, as closed"). When closed is false, pass open/close as 24h "HH:MM".
datestringoptional
The date, as "YYYY-MM-DD".
closedbooleanoptional
true if closed all day on this date.
openstringoptional
Open time, 24h "HH:MM", when not closed.
closestringoptional
Close time, 24h "HH:MM", when not closed.
applyToPublishers("google" | "facebook" | "apple" | "bing")[]optional
Advanced: change these values for specific publishers only instead of the shared default. Allowed values: "google", "facebook", "apple", "bing". Omit to update the shared details that every publisher inherits.