REST Resource: accounts.locations

資源：Location

位置。如要查看這些欄位的詳細說明，請參閱說明中心文章；如要查看有效業務類別清單，請參閱類別端點。

JSON 表示法 
{
  "name": string,
  "languageCode": string,
  "storeCode": string,
  "title": string,
  "phoneNumbers": {
    object (PhoneNumbers)
  },
  "categories": {
    object (Categories)
  },
  "storefrontAddress": {
    object (PostalAddress)
  },
  "websiteUri": string,
  "regularHours": {
    object (BusinessHours)
  },
  "specialHours": {
    object (SpecialHours)
  },
  "serviceArea": {
    object (ServiceAreaBusiness)
  },
  "labels": [
    string
  ],
  "adWordsLocationExtensions": {
    object (AdWordsLocationExtensions)
  },
  "latlng": {
    object (LatLng)
  },
  "openInfo": {
    object (OpenInfo)
  },
  "metadata": {
    object (Metadata)
  },
  "profile": {
    object (Profile)
  },
  "relationshipData": {
    object (RelationshipData)
  },
  "moreHours": [
    {
      object (MoreHours)
    }
  ],
  "serviceItems": [
    {
      object (ServiceItem)
    }
  ]
}
欄位
name

string

ID。這個地點的 Google ID，格式為：locations/{locationId}。
languageCode

string

不可變動。地點的語言。在建立時設定，無法更新。
storeCode

string

(選用步驟) 這個地點的外部 ID，在指定帳戶中不得重複。這是將地點與您自己的記錄建立關聯的方式。
title

string

必填。地點名稱應反映商家的實際名稱，與店面、網站和文具上使用的名稱一致，且為顧客所熟知。如有其他相關資訊，可加入資源的其他欄位 (例如 Address、Categories)。請勿在名稱中加入不必要的資訊 (例如，建議使用「Google」，而非「Google Inc. - Mountain View Corporate Headquarters」)。請勿加入行銷標語、商店代碼、特殊字元、營業時間或營業/停業狀態、電話號碼、網站網址、服務/產品資訊、地點/地址或路線，或所在位置資訊 (例如「Duane Reade 內的 Chase ATM」)。
phoneNumbers

object (PhoneNumbers)

(選用步驟) 顧客可與商家聯絡的不同電話號碼。
categories

object (Categories)

(選用步驟) 描述商家的不同類別。
storefrontAddress

object (PostalAddress)

(選用步驟) 精確明白的地址，說明商家所在地點。我們不接受郵政信箱或位在偏遠地區的信箱地址。目前，您最多可以在地址中指定五個 addressLines 值。這個欄位僅適用於有店面的商家。請勿為 CUSTOMER_LOCATION_ONLY 類型的地點設定這個欄位，否則系統會捨棄提供的值。
websiteUri

string

(選用步驟) 這個商家的網址。如果可以，請使用代表這個個別商家地點的網址，而非代表所有地點或品牌的通用網站/網址。
regularHours

object (BusinessHours)

(選用步驟) 商家的營業時間。
specialHours

object (SpecialHours)

(選用步驟) 商家的特殊營業時間。通常包括節慶營業時間，以及其他非正常營業時間。這些時間會覆寫正常營業時間。必須先設定一般營業時間，才能設定這個欄位。
serviceArea

object (ServiceAreaBusiness)

(選用步驟) 無店面區域商家會在顧客所在地提供服務。如果這個商家是無店面區域商家，這個欄位會說明商家的服務範圍。
labels[]

string

(選用步驟) 一組任意形式的字串，可用來標記商家。這些標籤不會向使用者顯示，只有您看得到。每個標籤的長度必須介於 1 到 255 個字元之間。
adWordsLocationExtensions

object (AdWordsLocationExtensions)

(選用步驟) AdWords 中顯示的其他資訊。
latlng

object (LatLng)

(選用步驟) 使用者提供的經緯度。建立地點時，如果提供的地址成功進行地理編碼，系統會忽略這個欄位。只有在建立期間接受使用者提供的 latlng 值，或透過 Google 商家檔案網站更新 latlng 值時，系統才會在 GET 要求中傳回這個欄位。只有核准的用戶端可以更新這個欄位。
openInfo

object (OpenInfo)

(選用步驟) 指出地點目前是否營業中的標記。
metadata

object (Metadata)

僅供輸出。其他使用者無法編輯的資訊。
profile

object (Profile)

(選用步驟) 用自己的話描述商家，並與使用者分享商家和產品/服務的獨特故事。

除了住宿類別 (例如飯店、汽車旅館、旅館) 以外，所有類別都必須填寫這個欄位。
relationshipData

object (RelationshipData)

(選用步驟) 與這個地點相關的所有地點和連鎖店。
moreHours[]

object (MoreHours)

(選用步驟) 商家不同部門或特定顧客的詳細營業時間。
serviceItems[]

object (ServiceItem)

(選用步驟) 商家支援的服務清單。服務可以是剪髮、安裝熱水器等。重複的服務項目會自動移除。

PhoneNumbers

商家電話號碼集合。更新時，必須設定這兩個欄位。用戶端不得使用更新遮罩，只更新主要或額外電話號碼。建議使用國際電話號碼格式，例如「+1 415 555 0132」，詳情請參閱 https://developers.google.com/style/phone-numbers#international-phone-numbers)。

JSON 表示法 
{
  "primaryPhone": string,
  "additionalPhones": [
    string
  ]
}
欄位
primaryPhone

string

必填。可直接聯絡個別商家地點的電話號碼。盡可能提供商家所在地點的當地電話號碼，而不是客服中心代表號。
additionalPhones[]

string

(選用步驟) 除了主要電話號碼，最多可提供兩組商家電話號碼 (手機或市話，不得為傳真)。

類別

描述商家的類別集合。更新時，必須設定這兩個欄位。用戶端不得使用更新遮罩，個別更新主要或額外類別。

JSON 表示法 
{
  "primaryCategory": {
    object (Category)
  },
  "additionalCategories": [
    {
      object (Category)
    }
  ]
}
欄位
primaryCategory

object (Category)

必填。最能描述這個地點核心業務的類別。
additionalCategories[]

object (Category)

(選用步驟) 用來描述商家的其他類別。類別可協助顧客找到準確、具體的服務搜尋結果。為確保商家資訊正確且符合現況，請盡量使用最少的類別來說明整體核心業務。選擇類別時，請盡可能具體明確，但要能代表主要業務。

類別

描述商家性質 (而非業務內容) 的類別。如需有效類別 ID 清單，以及與人類可讀名稱的對應關係，請參閱 categories.list。

JSON 表示法 
{
  "name": string,
  "displayName": string,
  "serviceTypes": [
    {
      object (ServiceType)
    }
  ],
  "moreHoursTypes": [
    {
      object (MoreHoursType)
    }
  ]
}
欄位
name

string

必填。這個類別的穩定 ID (由 Google 提供)。修改類別 (建立或更新地點) 時，必須指定這個值。
displayName

string

僅供輸出。人類可讀的類別名稱。讀取位置時會設定這個值。修改位置時，必須設定 category_id。
serviceTypes[]

object (ServiceType)

僅供輸出。這個業務類別可用的所有服務類型清單。
moreHoursTypes[]

object (MoreHoursType)

僅供輸出。這個業務類別可用的其他營業時間類型。

ServiceType

說明商家提供的服務類型。

JSON 表示法 
{
  "serviceTypeId": string,
  "displayName": string
}
欄位
serviceTypeId

string

僅供輸出。這個服務類型的穩定 ID (由 Google 提供)。
displayName

string

僅供輸出。服務類型的顯示名稱，人類可讀。

MoreHoursType

商家除了常規營業時間外，還可提供更多營業時間類型。

JSON 表示法 
{
  "hoursTypeId": string,
  "displayName": string,
  "localizedDisplayName": string
}
欄位
hoursTypeId

string

僅供輸出。Google 為這個營業時間類型提供的穩定 ID。
displayName

string

僅供輸出。營業時間類型的英文顯示名稱，人類可讀。
localizedDisplayName

string

僅供輸出。營業時間類型的在地化顯示名稱，人類可讀。

PostalAddress

代表郵寄地址，例如郵寄地址或付款地址。郵政服務可根據郵寄地址，將物品寄送到建築物、郵政信箱或類似地點。郵寄地址並非用於模擬道路、城鎮或山脈等地理位置。

一般情況下，地址會由使用者輸入或從現有資料匯入，具體取決於程序類型。

輸入或編輯地址的建議：

  • 使用支援國際化的地址小工具，例如 https://github.com/google/libaddressinput。
  • 如果使用者所在國家/地區不使用某個欄位，就不應向他們顯示該欄位的輸入或編輯 UI 元素。

如要進一步瞭解如何使用這個結構定義，請參閱 https://support.google.com/business/answer/6397478。

JSON 表示法 
{
  "revision": integer,
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "sortingCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ],
  "recipients": [
    string
  ],
  "organization": string
}
欄位
revision

integer

PostalAddress 的結構定義修訂版本。這個欄位的值必須設為 0，即代表最新的修訂版本。

所有新的修訂版本都必須能夠與舊的修訂版本回溯相容。
regionCode

string

必填。地址所在國家/地區的 CLDR 地區代碼。這個代碼絕非透過推測而得出，並且是由使用者自行確保該值正確無誤。詳情請參閱 https://cldr.unicode.org/ 和 https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html。例如：瑞士的地區代碼為「CH」。
languageCode

string

選填。這個地址內容的 BCP-47 語言代碼 (如果已知)。通常是輸入表單的 UI 語言，或是符合地址的國家/地區所用的其中一個語言，或是使用音譯的對應項目。這個欄位可能會影響某些國家/地區的格式設定，但是不會影響資料的正確性，也絕不會影響任何驗證或其他非格式的相關作業。

如果不知道這個值為何，則應省略該值 (而非指定可能不正確的預設值)。

例如：「zh-Hant」、「ja」、「ja-Latn」、「en」。
postalCode

string

(選用步驟) 地址的郵遞區號。並非所有國家/地區都使用或要求提供郵遞區號，但如果使用郵遞區號，則可能需要與地址的其他部分進行額外驗證 (例如美國的州或郵遞區號驗證)。
sortingCode

string

(選用步驟) 國家/地區專屬的其他分類代碼。大多數國家/地區並不使用這個代碼。使用時，值可以是「CEDEX」等字串，後面可加上數字 (例如「CEDEX 7」)，也可以是單一數字，代表「部門代碼」(牙買加)、「送貨區域指標」(馬拉威) 或「郵局指標」(象牙海岸)。
administrativeArea

string

(選用步驟) 最高行政區，用於國家/地區的郵遞地址。例如，此值可以是州、省或縣。如果是西班牙，請填寫省份而非自治區 (例如「Barcelona」而非「Catalonia」)。許多國家/地區的郵寄地址並沒有使用行政區。舉例來說，在瑞士，這個欄位應留空。
locality

string

(選用步驟) 通常是指地址中的城市或鄉鎮部分。例如：美國城市、義大利市鎮、英國郵鎮。如果世界上的某些地區沒有明確定義或不適用這個結構，請將 locality 留空，並使用 addressLines。
sublocality

string

(選用步驟) 地址的縣市以下行政區，例如鄰里、自治區或行政區。
addressLines[]

string

非結構化的地址行，說明地址的低層級項目。

addressLines 中的值沒有類型資訊，有時單一欄位可能包含多個值 (例如「Austin, TX」)，因此行順序必須清楚。地址行的順序應為地址所在國家/地區的「信封順序」。在可能有所不同的地方 (例如日本)，address_language 可用來明確指定 (例如「ja」表示由大到小的順序，「ja-Latn」或「en」表示由小到大)。這樣一來，系統就能根據語言選取最明確的地址行。

地址的最小結構化表示法包含 regionCode，其餘資訊則全部放在 addressLines 中。您可以在幾乎不使用地理定位的情况下，設定這類地址的格式，但至少在地址局部解析完畢之前，您無法對地址的任何組成部分進行語意推論。

如要處理完全非結構化的地址，建議您建立只包含 regionCode 和 addressLines 的地址，然後進行地理編碼，而不是猜測地址的哪些部分應為鄉鎮市區或行政區。
recipients[]

string

(選用步驟) 地址的收件人。在某些情況下，這個欄位可能會包含多行資訊。舉例來說，此欄位可能包含「代收者」資訊。
organization

string

(選用步驟) 地址中的機構名稱。

BusinessHours

代表這個地點的營業時間。包含 [TimePeriod][google.mybusiness.mybusinessinformation.v1.TimePeriod] 執行個體的集合。

JSON 表示法 
{
  "periods": [
    {
      object (TimePeriod)
    }
  ]
}
欄位
periods[]

object (TimePeriod)

必填。這個地點的營業時間。每個時段代表一週內營業地點的營業時間範圍。

TimePeriod

代表商家營業時間範圍，從指定的營業日期/時間開始，到指定的營業日期/時間結束。結束時間必須晚於開始時間，例如當天稍晚或隔天。

JSON 表示法 
{
  "openDay": enum (DayOfWeek),
  "openTime": {
    object (TimeOfDay)
  },
  "closeDay": enum (DayOfWeek),
  "closeTime": {
    object (TimeOfDay)
  }
}
欄位
openDay

enum (DayOfWeek)

必填。表示這個期間的開始day of the week。
openTime

object (TimeOfDay)

必填。有效值為 00:00-24:00，其中 24:00 代表指定日期欄位結束時的午夜。注意：在 Proto3 JSON 對應中，系統會省略預設的零值 (00:00)，並為 openTime 產生 {}。
closeDay

enum (DayOfWeek)

必填。表示這個期間結束的day of the week。
closeTime

object (TimeOfDay)

必填。有效值為 00:00-24:00，其中 24:00 代表指定日期欄位結束時的午夜。注意：在 Proto3 JSON 對應中，系統會省略預設零值 (00:00)，並為 closeTime 產生 {}。

DayOfWeek

代表星期幾。

列舉
DAY_OF_WEEK_UNSPECIFIED 未指定星期幾。
MONDAY 星期一
TUESDAY 週二
WEDNESDAY 週三
THURSDAY 週四
FRIDAY Friday (週五)
SATURDAY Saturday (週六)
SUNDAY 星期日

TimeOfDay

代表一天中的時間。日期和時區並不需要指定，或是在其他位置上指定。API 可選擇允許閏秒。相關類型為 google.type.Date 和 google.protobuf.Timestamp。

JSON 表示法 
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
欄位
hours

integer

一天中的小時，以 24 小時制表示。必須大於或等於 0，且通常必須小於或等於 23。API 可選擇允許使用「24:00:00」這類的值來表示營業打烊時間等情況。
minutes

integer

一小時中的某分鐘。必須大於或等於 0，且小於或等於 59。
seconds

integer

一分鐘內的第幾秒。必須大於或等於 0，且通常必須小於或等於 59。如果 API 允許閏秒，則可允許值為 60。
nanos

integer

秒數的小數部分，以奈秒為單位。必須大於或等於 0，且小於或等於 999,999,999。

SpecialHours

代表一組時間範圍，此時地點的營業時間與正常營業時間不同。

JSON 表示法 
{
  "specialHourPeriods": [
    {
      object (SpecialHourPeriod)
    }
  ]
}
欄位
specialHourPeriods[]

object (SpecialHourPeriod)

必填。商家正常營業時間的例外狀況清單。

SpecialHourPeriod

代表地點營業時間與正常營業時間不同的單一時間範圍。特殊營業時間範圍不得超過 24 小時。openTime 和 startDate 必須早於 closeTime 和 endDate。closeTime和endDate可延長至指定startDate隔天的上午 11:59。舉例來說，下列輸入內容有效：

startDate=2015-11-23, openTime=08:00, closeTime=18:00
startDate=2015-11-23, endDate=2015-11-23, openTime=08:00,
closeTime=18:00 startDate=2015-11-23, endDate=2015-11-24,
openTime=13:00, closeTime=11:59

下列輸入內容無效：

startDate=2015-11-23, openTime=13:00, closeTime=11:59
startDate=2015-11-23, endDate=2015-11-24, openTime=13:00,
closeTime=12:00 startDate=2015-11-23, endDate=2015-11-25,
openTime=08:00, closeTime=18:00
JSON 表示法 
{
  "startDate": {
    object (Date)
  },
  "openTime": {
    object (TimeOfDay)
  },
  "endDate": {
    object (Date)
  },
  "closeTime": {
    object (TimeOfDay)
  },
  "closed": boolean
}
欄位
startDate

object (Date)

必填。特殊營業時間的開始日期。
openTime

object (TimeOfDay)

(選用步驟) 有效值為 00:00 至 24:00，其中 24:00 代表指定日期欄位結束時的午夜。如果 closed 為 false，則必須指定。
endDate

object (Date)

(選用步驟) 特殊營業時間結束的日期。如未設定 endDate 欄位，則預設為 startDate 中指定的日期。如果設定這個欄位，值必須等於或晚於 startDate，且最多晚 1 天。
closeTime

object (TimeOfDay)

(選用步驟) 有效值為 00:00-24:00，其中 24:00 代表指定日期欄位結束時的午夜。如果 closed 為 false，則必須指定。
closed

boolean

(選用步驟) 如果設為 true，系統會忽略 endDate、openTime 和 closeTime，並將 startDate 中指定的日期視為地點全天不營業。

日期

代表完整或部分日曆日期，例如生日。時間和時區已在其他地方指定，或不重要。日期是根據公曆計算。這可能代表下列其中一項：

  • 完整日期，年、月、日值不為零。
  • 月和日，年份為零 (例如週年紀念日)。
  • 只有年份，月份和日期為零。
  • 年和月，日為零 (例如信用卡到期日)。

相關類型：

JSON 表示法 
{
  "year": integer,
  "month": integer,
  "day": integer
}
欄位
year

integer

日期的年份。必須介於 1 至 9999 之間，或輸入 0 指定不含年份的日期。
month

integer

一年中的月份。必須介於 1 到 12 之間，或設為 0 來指定不含月和日的年份。
day

integer

日期。必須介於 1 到 31 之間，且為有效的年月日，或設為 0，指定單獨年份或不重要的年月日。

ServiceAreaBusiness

無店面區域商家會在顧客所在地點提供服務 (例如鎖匠或水電工)。

JSON 表示法 
{
  "businessType": enum (BusinessType),
  "places": {
    object (Places)
  },
  "regionCode": string
}
欄位
businessType

enum (BusinessType)

必填。表示區域服務商家的 [類型] [google.mybusiness.businessinfo.v1.ServiceAreaBusiness.BusinessType]。
places

object (Places)

(選用步驟) 這個商家服務的區域，由一組地點定義。
regionCode

string

不可變動。這個區域服務商家所在國家/地區的 CLDR 區域代碼。詳情請參閱 http://cldr.unicode.org/ 和 http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html。例如：瑞士的地區代碼為「CH」。

如果商家類型為 CUSTOMER_LOCATION_ONLY，則必須填寫這個欄位，否則系統會忽略這個欄位。

此處指定的區域可以與商家服務的區域不同 (例如，無店面區域商家在非其所在地的區域提供服務)。

如果這個地點在建立後需要驗證，則用於驗證的地址必須位於這個區域內，且業主或其授權代表必須能夠在提供的驗證地址接收郵件。

BusinessType

指出這家商家是否僅在顧客所在地提供服務 (例如拖吊車)，或同時在地址和現場提供服務 (例如設有用餐區且提供外送服務的披薩店)。

列舉
BUSINESS_TYPE_UNSPECIFIED 僅供輸出。不指定。
CUSTOMER_LOCATION_ONLY 僅在周邊地區提供服務 (不在公司地址)。如果商家從 CUSTOMER_AND_BUSINESS_LOCATION 更新為 CUSTOMER_LOCATION_ONLY，則位置更新必須包含欄位遮罩 storefrontAddress，並將欄位設為空白。
CUSTOMER_AND_BUSINESS_LOCATION 在公司地址和周邊地區提供服務。

地點

定義一組地點所代表的區域聯集。

JSON 表示法 
{
  "placeInfos": [
    {
      object (PlaceInfo)
    }
  ]
}
欄位
placeInfos[]

object (PlaceInfo)

(選用步驟) 地點 ID 代表的區域。最多 20 個地點。

PlaceInfo

定義地點 ID 代表的區域。

JSON 表示法 
{
  "placeName": string,
  "placeId": string
}
欄位
placeName

string

必填。地點的本地化名稱。例如 Scottsdale, AZ。
placeId

string

必填。地點 ID。必須對應至區域。(https://developers.google.com/places/web-service/supported_types#table3)

AdWordsLocationExtensions

AdWords 中顯示的其他資訊。

JSON 表示法 
{
  "adPhone": string
}
欄位
adPhone

string

必填。在 AdWords 地點額外資訊中顯示的備用電話號碼，而非地點的主要電話號碼。

LatLng

代表經緯度組合的物件。這個物件會同時指出經度和緯度的度數。除非另有指定，否則這個物件必須符合 WGS84 標準。此外，值必須在正規化範圍內。

JSON 表示法 
{
  "latitude": number,
  "longitude": number
}
欄位
latitude

number

緯度度數，必須介於 [-90.0, +90.0] 的範圍之間。
longitude

number

經度度數，必須介於 [-180.0, +180.0] 的範圍之間。

OpenInfo

與商家營業狀態相關的資訊。

JSON 表示法 
{
  "status": enum (OpenForBusiness),
  "canReopen": boolean,
  "openingDate": {
    object (Date)
  }
}
欄位
status

enum (OpenForBusiness)

必填。指出地點目前是否營業中。根據預設，所有地點都會顯示為營業中，除非你將狀態更新為「已停業」。
canReopen

boolean

僅供輸出。指出這個商家是否符合重新營業的資格。
openingDate

object (Date)

(選用步驟) 地點首次營業的日期。如果不知道確切日期，可以只提供月份和年份。日期必須是過去或未來一年內。

OpenForBusiness

指出地點的狀態。

列舉
OPEN_FOR_BUSINESS_UNSPECIFIED 不指定。
OPEN 表示營業地點營業中。
CLOSED_PERMANENTLY 表示地點已永久歇業。
CLOSED_TEMPORARILY 表示地點已暫停營業。

中繼資料

地點的其他資訊，使用者無法編輯。

JSON 表示法 
{
  "hasGoogleUpdated": boolean,
  "hasPendingEdits": boolean,
  "canDelete": boolean,
  "canOperateLocalPost": boolean,
  "canModifyServiceList": boolean,
  "canHaveFoodMenus": boolean,
  "canOperateHealthData": boolean,
  "canOperateLodgingData": boolean,
  "placeId": string,
  "duplicateLocation": string,
  "mapsUri": string,
  "newReviewUri": string,
  "canHaveBusinessCalls": boolean,
  "hasVoiceOfMerchant": boolean,
  "isParticularlyPersonalPlace": boolean
}
欄位
hasGoogleUpdated

boolean

僅供輸出。指出與這個地點相關聯的地點 ID 是否有更新，需要由用戶端更新或拒絕。如果設定這個布林值，請呼叫 getGoogleUpdated 方法，查詢需要驗證的資訊。
hasPendingEdits

boolean

僅供輸出。指出這個地點是否有任何屬性處於待編輯狀態。
canDelete

boolean

僅供輸出。指出是否可以使用 API 刪除位置。
canOperateLocalPost
(deprecated)

boolean

僅供輸出。已淘汰：這個欄位不會再填入資料，並將在日後推出的版本中移除。
canModifyServiceList

boolean

僅供輸出。表示商家資訊是否可修改服務清單。
canHaveFoodMenus

boolean

僅供輸出。指出商家資訊是否符合菜單資格。
canOperateHealthData

boolean

僅供輸出。指出該位置是否可處理健康資料。
canOperateLodgingData

boolean

僅供輸出。指出該地點是否可操作住宿資料。
placeId

string

僅供輸出。如果這個地點顯示在 Google 地圖上，這個欄位會填入該地點的地點 ID。這個 ID 可用於多種 Places API。

這個欄位可在建立呼叫時設定，但無法在更新時設定。
duplicateLocation

string

僅供輸出。與這個地點重複的地點資源。
mapsUri

string

僅供輸出。Google 地圖上的地點連結。
newReviewUri

string

僅供輸出。Google 搜尋頁面的連結，顧客可在該頁面為地點撰寫評論。
canHaveBusinessCalls

boolean

僅供輸出。指出商家資訊是否符合商家通話資格。
hasVoiceOfMerchant

boolean

僅供輸出。指出商家資訊是否包含「商家心聲」。如果這個布林值為 false，請呼叫 locations.getVoiceOfMerchantState API，瞭解商家沒有 Voice of Merchant 的原因。
isParticularlyPersonalPlace

boolean

僅供輸出。指出地點是否歸類為隱私保密地點。這表示定位記錄功能會受到限制。如果認為這項處置有誤，請參閱說明中心文章。

個人資料

與地點設定檔相關的所有資訊。

JSON 表示法 
{
  "description": string
}
欄位
description

string

必填。你對地點的描述，其他人無法編輯。

RelationshipData

與這個地點相關的所有上層和下層地點資訊。

JSON 表示法 
{
  "parentLocation": {
    object (RelevantLocation)
  },
  "childrenLocations": [
    {
      object (RelevantLocation)
    }
  ],
  "parentChain": string
}
欄位
parentLocation

object (RelevantLocation)

(選用步驟) 與這個位置相關聯的上層位置。
childrenLocations[]

object (RelevantLocation)

(選用步驟) 與這個地點相關聯的子地點清單。
parentChain

string

(選用步驟) 這個地點所屬連鎖店的資源名稱。[如何找出連鎖店 ID] [Locations.SearchChains]

RelevantLocation

與目前地點相關的其他地點資訊。關係可以是 DEPARTMENT_OF 或 INDEPENDENT_ESTABLISHMENT_OF，這裡指定的位置可以是位置的任一端 (父項/子項)。

JSON 表示法 
{
  "placeId": string,
  "relationType": enum (RelationType)
}
欄位
placeId

string

必填。使用地點 ID 指定關係另一端的地點。
relationType

enum (RelationType)

必填。關係類型。

RelationType

要指定的類型關係。

列舉
RELATION_TYPE_UNSPECIFIED 未指定類型。
DEPARTMENT_OF 這代表 2 個地點之間的關係，這 2 個地點共用一個實體區域、相同品牌/高階管理/組織，但具有不同的重要屬性，例如營業時間或電話號碼。舉例來說，Costco Pharmacy 是 Costco Wholesale 的部門。
INDEPENDENT_ESTABLISHMENT_IN 這代表 2 個地點位於同一實體位置，但屬於不同公司 (例如 Safeway 內的星巴克、購物中心內的商店)。

MoreHours

營業地點提供特定類型服務的時間範圍。

JSON 表示法 
{
  "hoursTypeId": string,
  "periods": [
    {
      object (TimePeriod)
    }
  ]
}
欄位
hoursTypeId

string

必填。營業時間類型。用戶端應呼叫 {#link businessCategories:BatchGet}，取得營業地點類別支援的營業時間類型。
periods[]

object (TimePeriod)

必填。這個地點的營業時間集合。每個時段代表一週內營業地點的營業時間範圍。

ServiceItem

描述單一服務項目的訊息。用於說明商家提供的服務類型。舉例來說，剪髮可以是一項服務。

JSON 表示法 
{
  "price": {
    object (Money)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "structuredServiceItem": {
    object (StructuredServiceItem)
  },
  "freeFormServiceItem": {
    object (FreeFormServiceItem)
  }
  // End of mutually exclusive fields.
}
欄位
price

object (Money)

(選用步驟) 代表服務項目的貨幣價格。建議您在加入價格時設定 currencyCode 和 units。這會視為服務項目的固定價格。
請務必設定下列其中一個欄位。以下是互斥欄位清單。回應中最多會設定下列其中一個欄位：
structuredServiceItem

object (StructuredServiceItem)

(選用步驟) 這個欄位會設定結構化服務資料。
freeFormServiceItem

object (FreeFormServiceItem)

(選用步驟) 如果服務資料為任意形式，系統會設定這個欄位。
互斥欄位結束。

StructuredServiceItem

代表商家提供的結構化服務。例如：toilet_installation。

JSON 表示法 
{
  "serviceTypeId": string,
  "description": string
}
欄位
serviceTypeId

string

必填。serviceTypeId 欄位是 Google 提供的專屬 ID，可在 ServiceType 中找到。這項資訊由 categories.batchGet RPC 服務提供。
description

string

(選用步驟) 結構化服務項目的說明。字元限制為 300 個。

FreeFormServiceItem

代表商家提供的任意形式服務。這些服務不會在結構化服務資料中公開。商家會使用 Geomerchant 介面，手動輸入這類服務的名稱。

JSON 表示法 
{
  "category": string,
  "label": {
    object (Label)
  }
}
欄位
category

string

必填。這個欄位代表類別名稱 (即類別的固定 ID)。category 和 serviceTypeId 應與 Category 訊息中提供的可能組合相符。
label

object (Label)

必填。項目的語言標記標籤。建議項目名稱不超過 140 個半形字元，說明不超過 250 個半形字元。只有在輸入內容為自訂服務項目時，才應設定這個欄位。請使用 serviceTypeId 更新標準化服務類型。

標籤

顯示價目表、部分或項目時使用的標籤。

JSON 表示法 
{
  "displayName": string,
  "description": string,
  "languageCode": string
}
欄位
displayName

string

必填。價目表、專區或品項的顯示名稱。
description

string

(選用步驟) 價目表、部分或項目的說明。
languageCode

string

(選用步驟) 這些字串適用的 BCP-47 語言代碼。每種語言只能設定一組標籤。

金額

代表金額與其貨幣類型。

JSON 表示法 
{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}
欄位
currencyCode

string

ISO 4217 定義的三碼貨幣代碼。
units

string (int64 format)

金額的整數單位。舉例來說，如果 currencyCode 為 "USD"，則 1 個單位為 1 美元。
nanos

integer

金額的奈米 (10^-9) 單位數量。這個值必須介於 -999,999,999 和 +999,999,999 (含) 之間。如果 units 為正值，nanos 必須為正值或零。如果 units 為零，則 nanos 可為正值、零或負值。如果 units 為負值，nanos 就必須為負值或零。例如，$-1.75 美元的表式方式為 units=-1 和 nanos=-750,000,000。

方法

create

 建立新的位置，由登入的使用者擁有。

list

 列出指定帳戶的地點。