--- title: "POST /v1/{+parent}/locations" method: POST path: "/v1/{+parent}/locations" tags: ["accounts"] --- # POST /v1/{+parent}/locations `POST /v1/{+parent}/locations` Creates a new Location that will be owned by the logged in user. ## Path parameters - `parent` string, required ## Query parameters - `requestId` string - `validateOnly` boolean ## Request body - Location — A location. See the [help center article] (https://support.google.com/business/answer/3038177) for a detailed description of these fields, or the [category endpoint](/my-business/reference/rest/v4/categories) for a list of valid business categories. - `regularHours` BusinessHours — Represents the time periods that this location is open for business. Holds a collection of TimePeriod instances. - `periods` TimePeriod[] — Required. A collection of times that this location is open for business. Each period represents a range of hours when the location is open during the week. - `openTime` TimeOfDay — Represents a time of day. The date and time zone are either not significant or are specified elsewhere. An API may choose to allow leap seconds. Related types are google.type.Date and `google.protobuf.Timestamp`. - `nanos` integer — Fractions of seconds, in nanoseconds. Must be greater than or equal to 0 and less than or equal to 999,999,999. - `seconds` integer — Seconds of a minute. Must be greater than or equal to 0 and typically must be less than or equal to 59. An API may allow the value 60 if it allows leap-seconds. - `hours` integer — Hours of a day in 24 hour format. Must be greater than or equal to 0 and typically must be less than or equal to 23. An API may choose to allow the value "24:00:00" for scenarios like business closing time. - `minutes` integer — Minutes of an hour. Must be greater than or equal to 0 and less than or equal to 59. - `closeDay` 'DAY_OF_WEEK_UNSPECIFIED' | 'MONDAY' | 'TUESDAY' | 'WEDNESDAY' | 'THURSDAY' | 'FRIDAY' | 'SATURDAY' | 'SUNDAY' — Required. Indicates the day of the week this period ends on. - `openDay` 'DAY_OF_WEEK_UNSPECIFIED' | 'MONDAY' | 'TUESDAY' | 'WEDNESDAY' | 'THURSDAY' | 'FRIDAY' | 'SATURDAY' | 'SUNDAY' — Required. Indicates the day of the week this period starts on. - `closeTime` TimeOfDay — Represents a time of day. The date and time zone are either not significant or are specified elsewhere. An API may choose to allow leap seconds. Related types are google.type.Date and `google.protobuf.Timestamp`. - `nanos` integer — Fractions of seconds, in nanoseconds. Must be greater than or equal to 0 and less than or equal to 999,999,999. - `seconds` integer — Seconds of a minute. Must be greater than or equal to 0 and typically must be less than or equal to 59. An API may allow the value 60 if it allows leap-seconds. - `hours` integer — Hours of a day in 24 hour format. Must be greater than or equal to 0 and typically must be less than or equal to 23. An API may choose to allow the value "24:00:00" for scenarios like business closing time. - `minutes` integer — Minutes of an hour. Must be greater than or equal to 0 and less than or equal to 59. - `adWordsLocationExtensions` AdWordsLocationExtensions — Additional information that is surfaced in AdWords. - `adPhone` string — Required. An alternate phone number to display on AdWords location extensions instead of the location's primary phone number. - `profile` Profile — All information pertaining to the location's profile. - `description` string — Required. Description of the location in your own voice, not editable by anyone else. - `moreHours` MoreHours[] — Optional. More hours for a business's different departments or specific customers. - `hoursTypeId` string — Required. Type of hours. Clients should call {#link businessCategories:BatchGet} to get supported hours types for categories of their locations. - `periods` TimePeriod[] — Required. A collection of times that this location is open. Each period represents a range of hours when the location is open during the week. - `openTime` TimeOfDay — Represents a time of day. The date and time zone are either not significant or are specified elsewhere. An API may choose to allow leap seconds. Related types are google.type.Date and `google.protobuf.Timestamp`. - `nanos` integer — Fractions of seconds, in nanoseconds. Must be greater than or equal to 0 and less than or equal to 999,999,999. - `seconds` integer — Seconds of a minute. Must be greater than or equal to 0 and typically must be less than or equal to 59. An API may allow the value 60 if it allows leap-seconds. - `hours` integer — Hours of a day in 24 hour format. Must be greater than or equal to 0 and typically must be less than or equal to 23. An API may choose to allow the value "24:00:00" for scenarios like business closing time. - `minutes` integer — Minutes of an hour. Must be greater than or equal to 0 and less than or equal to 59. - `closeDay` 'DAY_OF_WEEK_UNSPECIFIED' | 'MONDAY' | 'TUESDAY' | 'WEDNESDAY' | 'THURSDAY' | 'FRIDAY' | 'SATURDAY' | 'SUNDAY' — Required. Indicates the day of the week this period ends on. - `openDay` 'DAY_OF_WEEK_UNSPECIFIED' | 'MONDAY' | 'TUESDAY' | 'WEDNESDAY' | 'THURSDAY' | 'FRIDAY' | 'SATURDAY' | 'SUNDAY' — Required. Indicates the day of the week this period starts on. - `closeTime` TimeOfDay — Represents a time of day. The date and time zone are either not significant or are specified elsewhere. An API may choose to allow leap seconds. Related types are google.type.Date and `google.protobuf.Timestamp`. - `nanos` integer — Fractions of seconds, in nanoseconds. Must be greater than or equal to 0 and less than or equal to 999,999,999. - `seconds` integer — Seconds of a minute. Must be greater than or equal to 0 and typically must be less than or equal to 59. An API may allow the value 60 if it allows leap-seconds. - `hours` integer — Hours of a day in 24 hour format. Must be greater than or equal to 0 and typically must be less than or equal to 23. An API may choose to allow the value "24:00:00" for scenarios like business closing time. - `minutes` integer — Minutes of an hour. Must be greater than or equal to 0 and less than or equal to 59. - `metadata` Metadata — Additional non-user-editable information about the location. - `canOperateHealthData` boolean — Output only. Indicates whether the location can operate on Health data. - `mapsUri` string — Output only. A link to the location on Maps. - `newReviewUri` string — Output only. A link to the page on Google Search where a customer can leave a review for the location. - `canHaveFoodMenus` boolean — Output only. Indicates if the listing is eligible for food menu. - `duplicateLocation` string — Output only. The location resource that this location duplicates. - `isParticularlyPersonalPlace` boolean — Output only. - `hasGoogleUpdated` boolean — Output only. Indicates whether the place ID associated with this location has updates that need to be updated or rejected by the client. If this boolean is set, you should call the `getGoogleUpdated` method to look up information that's needs to be verified. - `hasVoiceOfMerchant` boolean — Output only. Indicates if the listing has Voice of Merchant. If this boolean is false, you should call the locations.getVoiceOfMerchantState API to get details as to why they do not have Voice of Merchant. - `canDelete` boolean — Output only. Indicates whether the location can be deleted using the API. - `canModifyServiceList` boolean — Output only. Indicates if the listing can modify the service list. - `placeId` string — Output only. If this locationappears on Google Maps, this field is populated with the place ID for the location. This ID can be used in various Places APIs. This field can be set during Create calls, but not for Update. - `canHaveBusinessCalls` boolean — Output only. Indicates if the listing is eligible for business calls. - `hasPendingEdits` boolean — Output only. Indicates whether any of this Location's properties are in the edit pending state. - `canOperateLodgingData` boolean — Output only. Indicates whether the location can operate on Lodging data. - `canOperateLocalPost` boolean — Output only. Indicates if the listing can manage local posts. Deprecated: This field is no longer populated and will be removed in a future version. - `languageCode` string — Immutable. The language of the location. Set during creation and not updateable. - `title` string — 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"). - `storefrontAddress` PostalAddress — Represents a postal address, such as for postal delivery or payments addresses. With a postal address, a postal service can deliver items to a premise, P.O. box, or similar. A postal address is not intended to model geographical locations like roads, towns, or mountains. In typical usage, an address would be created by user input or from importing existing data, depending on the type of process. Advice on address input or editing: - Use an internationalization-ready address widget such as https://github.com/google/libaddressinput. - Users should not be presented with UI elements for input or editing of fields outside countries where that field is used. For more guidance on how to use this schema, see: https://support.google.com/business/answer/6397478. - `addressLines` string[] — Unstructured address lines describing the lower levels of an address. Because values in `address_lines` do not have type information and may sometimes contain multiple values in a single field (for example, "Austin, TX"), it is important that the line order is clear. The order of address lines should be "envelope order" for the country or region of the address. In places where this can vary (for example, Japan), `address_language` is used to make it explicit (for example, "ja" for large-to-small ordering and "ja-Latn" or "en" for small-to-large). In this way, the most specific line of an address can be selected based on the language. The minimum permitted structural representation of an address consists of a `region_code` with all remaining information placed in the `address_lines`. It would be possible to format such an address very approximately without geocoding, but no semantic reasoning could be made about any of the address components until it was at least partially resolved. Creating an address only containing a `region_code` and `address_lines` and then geocoding is the recommended way to handle completely unstructured addresses (as opposed to guessing which parts of the address should be localities or administrative areas). - `organization` string — Optional. The name of the organization at the address. - `languageCode` string — Optional. BCP-47 language code of the contents of this address (if known). This is often the UI language of the input form or is expected to match one of the languages used in the address' country/region, or their transliterated equivalents. This can affect formatting in certain countries, but is not critical to the correctness of the data and will never affect any validation or other non-formatting related operations. If this value is not known, it should be omitted (rather than specifying a possibly incorrect default). Examples: "zh-Hant", "ja", "ja-Latn", "en". - `recipients` string[] — Optional. The recipient at the address. This field may, under certain circumstances, contain multiline information. For example, it might contain "care of" information. - `administrativeArea` string — Optional. Highest administrative subdivision which is used for postal addresses of a country or region. For example, this can be a state, a province, an oblast, or a prefecture. For Spain, this is the province and not the autonomous community (for example, "Barcelona" and not "Catalonia"). Many countries don't use an administrative area in postal addresses. For example, in Switzerland, this should be left unpopulated. - `postalCode` string — Optional. Postal code of the address. Not all countries use or require postal codes to be present, but where they are used, they may trigger additional validation with other parts of the address (for example, state or zip code validation in the United States). - `revision` integer — The schema revision of the `PostalAddress`. This must be set to 0, which is the latest revision. All new revisions **must** be backward compatible with old revisions. - `sortingCode` string — Optional. Additional, country-specific, sorting code. This is not used in most regions. Where it is used, the value is either a string like "CEDEX", optionally followed by a number (for example, "CEDEX 7"), or just a number alone, representing the "sector code" (Jamaica), "delivery area indicator" (Malawi) or "post office indicator" (Côte d'Ivoire). - `locality` string — Optional. Generally refers to the city or town portion of the address. Examples: US city, IT comune, UK post town. In regions of the world where localities are not well defined or do not fit into this structure well, leave `locality` empty and use `address_lines`. - `sublocality` string — Optional. Sublocality of the address. For example, this can be a neighborhood, borough, or district. - `regionCode` string — Required. CLDR region code of the country/region of the address. This is never inferred and it is up to the user to ensure the value is correct. See https://cldr.unicode.org/ and https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html for details. Example: "CH" for Switzerland. - `relationshipData` RelationshipData — Information of all parent and children locations related to this one. - `parentLocation` RelevantLocation — Information about another location that is related to current one. The relation can be any one of DEPARTMENT_OF or INDEPENDENT_ESTABLISHMENT_OF, and the location specified here can be on either side (parent/child) of the location. - `relationType` 'RELATION_TYPE_UNSPECIFIED' | 'DEPARTMENT_OF' | 'INDEPENDENT_ESTABLISHMENT_IN' — Required. The type of the relationship. - `placeId` string — Required. Specify the location that is on the other side of the relation by its placeID. - `parentChain` string — The resource name of the Chain that this location is member of. How to find Chain ID - `childrenLocations` RelevantLocation[] — The list of children locations that this location has relations with. - `relationType` 'RELATION_TYPE_UNSPECIFIED' | 'DEPARTMENT_OF' | 'INDEPENDENT_ESTABLISHMENT_IN' — Required. The type of the relationship. - `placeId` string — Required. Specify the location that is on the other side of the relation by its placeID. - `categories` Categories — A collection of categories that describes the business. During updates, both fields must be set. Clients are prohibited from individually updating the primary or additional categories using the update mask. - `primaryCategory` Category — A category describing what this business is (not what it does). For a list of valid category IDs, and the mappings to their human-readable names, see `categories.list`. - `serviceTypes` ServiceType[] — Output only. A list of all the service types that are available for this business category. - `serviceTypeId` string — Output only. A stable ID (provided by Google) for this service type. - `displayName` string — Output only. The human-readable display name for the service type. - `displayName` string — Output only. The human-readable name of the category. This is set when reading the location. When modifying the location, `category_id` must be set. - `name` string — Required. A stable ID (provided by Google) for this category. The value must be specified when modifying the category (when creating or updating a location). - `moreHoursTypes` MoreHoursType[] — Output only. More hours types that are available for this business category. - `hoursTypeId` string — Output only. A stable ID provided by Google for this hours type. - `displayName` string — Output only. The human-readable English display name for the hours type. - `localizedDisplayName` string — Output only. The human-readable localized display name for the hours type. - `additionalCategories` Category[] — Optional. Additional categories to describe your business. Categories help your customers find accurate, specific results for services they're interested in. To keep your business information accurate and live, make sure that you use as few categories as possible to describe your overall core business. Choose categories that are as specific as possible, but representative of your main business. - `serviceTypes` ServiceType[] — Output only. A list of all the service types that are available for this business category. - `serviceTypeId` string — Output only. A stable ID (provided by Google) for this service type. - `displayName` string — Output only. The human-readable display name for the service type. - `displayName` string — Output only. The human-readable name of the category. This is set when reading the location. When modifying the location, `category_id` must be set. - `name` string — Required. A stable ID (provided by Google) for this category. The value must be specified when modifying the category (when creating or updating a location). - `moreHoursTypes` MoreHoursType[] — Output only. More hours types that are available for this business category. - `hoursTypeId` string — Output only. A stable ID provided by Google for this hours type. - `displayName` string — Output only. The human-readable English display name for the hours type. - `localizedDisplayName` string — Output only. The human-readable localized display name for the hours type. - `openInfo` OpenInfo — Information related to the opening state of the business. - `status` 'OPEN_FOR_BUSINESS_UNSPECIFIED' | 'OPEN' | 'CLOSED_PERMANENTLY' | 'CLOSED_TEMPORARILY' — Required. Indicates whether or not the Location is currently open for business. All locations are open by default, unless updated to be closed. - `openingDate` Date — Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp - `year` integer — Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year. - `month` integer — Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day. - `day` integer — Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant. - `canReopen` boolean — Output only. Indicates whether this business is eligible for re-open. - `serviceItems` ServiceItem[] — Optional. List of services supported by merchants. A service can be haircut, install water heater, etc. Duplicated service items will be removed automatically. - `price` Money — Represents an amount of money with its currency type. - `currencyCode` string — The three-letter currency code defined in ISO 4217. - `nanos` integer — Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be positive or zero. If `units` is zero, `nanos` can be positive, zero, or negative. If `units` is negative, `nanos` must be negative or zero. For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000. - `units` string, int64 — The whole units of the amount. For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar. - `freeFormServiceItem` FreeFormServiceItem — Represents a free-form service offered by the merchant. These are services that are not exposed as part of our structure service data. The merchant manually enters the names for such services using a geomerchant surface. - `label` Label — Label to be used when displaying the price list, section, or item. - `languageCode` string — Optional. The BCP-47 language code that these strings apply for. Only one set of labels may be set per language. - `displayName` string — Required. Display name for the price list, section, or item. - `description` string — Optional. Description of the price list, section, or item. - `category` string — Required. This field represents the category name (i.e. the category's stable ID). The `category` and `service_type_id` should match the possible combinations provided in the `Category` message. - `structuredServiceItem` StructuredServiceItem — Represents a structured service offered by the merchant. For eg: toilet_installation. - `serviceTypeId` string — Required. The `service_type_id` field is a Google provided unique ID that can be found in `ServiceType`. This information is provided by `BatchGetCategories` rpc service. - `description` string — Optional. Description of structured service item. The character limit is 300. - `websiteUri` string — 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. - `storeCode` string — 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. - `latlng` LatLng — An object that represents a latitude/longitude pair. This is expressed as a pair of doubles to represent degrees latitude and degrees longitude. Unless specified otherwise, this object must conform to the WGS84 standard. Values must be within normalized ranges. - `latitude` number, double — The latitude in degrees. It must be in the range [-90.0, +90.0]. - `longitude` number, double — The longitude in degrees. It must be in the range [-180.0, +180.0]. - `specialHours` SpecialHours — Represents a set of time periods when a location's operational hours differ from its normal business hours. - `specialHourPeriods` SpecialHourPeriod[] — Required. A list of exceptions to the business's regular hours. - `startDate` Date — Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp - `year` integer — Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year. - `month` integer — Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day. - `day` integer — Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant. - `closeTime` TimeOfDay — Represents a time of day. The date and time zone are either not significant or are specified elsewhere. An API may choose to allow leap seconds. Related types are google.type.Date and `google.protobuf.Timestamp`. - `nanos` integer — Fractions of seconds, in nanoseconds. Must be greater than or equal to 0 and less than or equal to 999,999,999. - `seconds` integer — Seconds of a minute. Must be greater than or equal to 0 and typically must be less than or equal to 59. An API may allow the value 60 if it allows leap-seconds. - `hours` integer — Hours of a day in 24 hour format. Must be greater than or equal to 0 and typically must be less than or equal to 23. An API may choose to allow the value "24:00:00" for scenarios like business closing time. - `minutes` integer — Minutes of an hour. Must be greater than or equal to 0 and less than or equal to 59. - `openTime` TimeOfDay — Represents a time of day. The date and time zone are either not significant or are specified elsewhere. An API may choose to allow leap seconds. Related types are google.type.Date and `google.protobuf.Timestamp`. - `nanos` integer — Fractions of seconds, in nanoseconds. Must be greater than or equal to 0 and less than or equal to 999,999,999. - `seconds` integer — Seconds of a minute. Must be greater than or equal to 0 and typically must be less than or equal to 59. An API may allow the value 60 if it allows leap-seconds. - `hours` integer — Hours of a day in 24 hour format. Must be greater than or equal to 0 and typically must be less than or equal to 23. An API may choose to allow the value "24:00:00" for scenarios like business closing time. - `minutes` integer — Minutes of an hour. Must be greater than or equal to 0 and less than or equal to 59. - `endDate` Date — Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp - `year` integer — Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year. - `month` integer — Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day. - `day` integer — Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant. - `closed` boolean — Optional. If true, `end_date`, `open_time`, and `close_time` are ignored, and the date specified in `start_date` is treated as the location being closed for the entire day. - `serviceArea` ServiceAreaBusiness — Service area businesses provide their service at the customer's location (for example, a locksmith or plumber). - `regionCode` string — Immutable. CLDR region code of the country/region that this service area business is based in. See http://cldr.unicode.org/ and http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html for details. Example: "CH" for Switzerland. This field is required for CUSTOMER_LOCATION_ONLY businesses, and is ignored otherwise. The region specified here can be different from regions for the areas that this business serves (e.g. service area businesses that provide services in regions other than the one that they are based in). If this location requires verification after creation, the address provided for verification purposes *must* be located within this region, and the business owner or their authorized representative *must* be able to receive postal mail at the provided verification address. - `businessType` 'BUSINESS_TYPE_UNSPECIFIED' | 'CUSTOMER_LOCATION_ONLY' | 'CUSTOMER_AND_BUSINESS_LOCATION' — Required. Indicates the type of the service area business. - `places` Places — Defines the union of areas represented by a set of places. - `placeInfos` PlaceInfo[] — The areas represented by place IDs. Limited to a maximum of 20 places. - `placeId` string — Required. The ID of the place. Must correspond to a region. (https://developers.google.com/places/web-service/supported_types#table3) - `placeName` string — Required. The localized name of the place. For example, `Scottsdale, AZ`. - `labels` string[] — 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. - `name` string — Google identifier for this location in the form: `locations/{location_id}`. - `phoneNumbers` PhoneNumbers — A collection of phone numbers for the business. During updates, both fields must be set. Clients may not update just the primary or additional phone numbers using the update mask. International phone format is preferred, such as "+1 415 555 0132", see more in (https://developers.google.com/style/phone-numbers#international-phone-numbers). - `additionalPhones` string[] — Optional. Up to two phone numbers (mobile or landline, no fax) at which your business can be called, in addition to your primary phone number. - `primaryPhone` string — Required. A phone number that connects to your individual business location as directly as possible. Use a local phone number instead of a central, call center helpline number whenever possible. ## Response `200` Successful response --- [API](https://skmtc.net/google/apis/mybusinessbusinessinformation.md) · [All operations](https://skmtc.net/google/apis/mybusinessbusinessinformation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/mybusinessbusinessinformation/versions/b00c15a5fe4a/schema)