v1

latestOpenAPI 3.0.0Creative Commons Attribution 3.02026-07-13114857.3 KB
accounts

Creates a new Location that will be owned by the logged in user.

post/v1/{+parent}/locations

Path parameters

parentstring required

Required. The name of the account in which to create this location.

Query parameters

requestIdstring

Optional. A unique request ID for the server to detect duplicated requests. We recommend using UUIDs. Max length is 50 characters.

validateOnlyboolean

Optional. If true, the request is validated without actually creating the location.

Request body

languageCodestring

Immutable. The language of the location. Set during creation and not updateable.

titlestring

Required. Location name should reflect your business's real-world name, as used consistently on your storefront, website, and stationery, and as known to customers. Any additional information, when relevant, can be included in other fields of the resource (for example, Address, Categories). Don't add unnecessary information to your name (for example, prefer "Google" over "Google Inc. - Mountain View Corporate Headquarters"). Don't include marketing taglines, store codes, special characters, hours or closed/open status, phone numbers, website URLs, service/product information, location/address or directions, or containment information (for example, "Chase ATM in Duane Reade").

websiteUristring

Optional. A URL for this business. If possible, use a URL that represents this individual business location instead of a generic website/URL that represents all locations, or the brand.

storeCodestring

Optional. External identifier for this location, which must be unique within a given account. This is a means of associating the location with your own records.

labelsstring[]

Optional. A collection of free-form strings to allow you to tag your business. These labels are NOT user facing; only you can see them. Must be between 1-255 characters per label.

namestring

Google identifier for this location in the form: locations/{location_id}.

Response

Successful response