REST Resource: locations

資源：位置

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

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

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

string

無法變更。地點使用的語言。請在建立期間設定，且無法更新。
storeCode

string

選用設定。這個位置的外部 ID，在某帳戶內不得重複。藉此將該地點與您自己的記錄建立關聯。
title

string

必要欄位。位置名稱必須如實反映商家的實際名稱，且與店面、網站和文具一致，客戶所知的名稱必須一致。您可將相關資訊加入資源的其他欄位 (例如 Address、Categories)。請勿在名稱中加入不必要的資訊，例如使用「Google」而非「Google Inc. - 山景城公司總部」。請勿加入行銷標語、商店代碼、特殊字元、營業時間或營業中/營業中狀態、電話號碼、網站網址、服務/產品資訊、地點/地址或路線，或是防裝資訊 (例如「杜恩大安森林公園」)。
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)

選用設定。商家支援的服務清單。任何服務都可以剪髮、安裝熱水器等。系統會自動移除重複的服務項目。

方法

delete

 刪除位置。

get

 傳回指定位置。

getAttributes

 查詢特定地點的所有屬性。

getGoogleUpdated

 取得指定位置的 Google 更新版本。

patch

 更新指定的位置。

updateAttributes

 更新特定地點的屬性。