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 識別碼，格式為：locations/{locationId}。
languageCode

string

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

string

選用設定。這個位置的外部 ID，在特定帳戶中不得重複。這是指將該地點與您的記錄建立關聯的方式。
title

string

必要欄位。地點名稱應反映商家的實際名稱，與店面、網站和文具上一致，也就是消費者所熟知的商家名稱。任何相關的額外資訊 (如有) 都可以加到資源的其他欄位 (例如 Address、Categories)。請勿在姓名中加入不必要的資訊 (例如，建議您使用「Google」，而非「Google Inc. - Mountain View 公司總部」)。請勿加入行銷標語、商店代碼、特殊字元、營業時間、營業時間、休息/開業狀態、電話號碼、網站網址、服務/產品資訊、地點/地址或路線，或是補充資訊 (例如「杜恩讀取中的首席 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)

選用設定。使用者提供的經緯度。建立位置時，如果提供的地址地理編碼成功，系統就會忽略這個欄位。只有在 get 請求中，使用者提供的 latlng 值在建立時接受，或者 latlng 值已透過 Google 商家檔案網站更新時，才會傳回這個欄位。這個欄位只能由核准的客戶更新。
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

 更新特定地點的屬性。