REST Resource: accounts.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

必要欄位。位置名稱必須如實反映商家的實際名稱,且與店面、網站和文具一致,客戶所知的名稱必須一致。您可將相關資訊加入資源的其他欄位 (例如 AddressCategories)。請勿在名稱中加入不必要的資訊,例如使用「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)

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

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 清單,以及這些 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

選用設定。最高行政區,用於國家/地區的郵遞地址。例如,此值可以是州、省或縣。以西班牙為例來具體說明,此欄位的值為省,而非自治區 (例如「巴塞隆納」省,而不是「加泰隆尼亞」自治區)。許多國家/地區的郵寄地址並沒有使用行政區。例如,就瑞士而言,該欄位應該留空不填。

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 代表指定日期欄位結束的午夜。

closeDay

enum (DayOfWeek)

必要欄位。表示這個週期結束的day of the week

closeTime

object (TimeOfDay)

必要欄位。有效值為 00:00-24:00,其中 24:00 代表指定日期欄位結束的午夜。

DayOfWeek

代表星期幾。

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

TimeOfDay

代表一天中的時間。日期和時區並不需要指定,或是在其他位置上指定。API 可選擇允許閏秒。相關類型為 google.type.Dategoogle.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 小時的範圍。openTimestartDate 必須早於 closeTimeendDatecloseTimeendDate 可以延長至指定 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,系統會忽略 endDateopenTimecloseTime,且會將 startDate 中指定的日期視為整天沒有停業。

日期

代表完整或部分日曆的日期,例如生日。您可在其他位置指定日期和時間,或沒有其他選擇。日期以公曆為相對於公曆。可能代表下列其中一種:

  • 完整日期,具有非零的年、月和日值。
  • 月和日,出現零年 (例如週年紀念日)。
  • 一個自己的年,分別為 0 個月和 0 天。
  • 年份和月份,數字為零 (例如信用卡到期日)。

相關類型:

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 表示該地點已暫停營業。

Metadata

地點的其他 (無法編輯)。

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
}
欄位
hasGoogleUpdated

boolean

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

hasPendingEdits

boolean

僅供輸出。指出這個地點的任何房源是否處於編輯待處理狀態。

canDelete

boolean

僅供輸出。指出是否可以使用 API 刪除地點。

canOperateLocalPost

boolean

僅供輸出。指出該商家資訊是否可管理當地貼文。

canModifyServiceList

boolean

僅供輸出。指出商家資訊是否可以修改服務清單。

canHaveFoodMenus

boolean

僅供輸出。說明商家資訊是否適用於食物選單。

canOperateHealthData

boolean

僅供輸出。指出該位置是否能對健康資料執行操作。

canOperateLodgingData

boolean

僅供輸出。指出地點是否能在住宿資料上運作。

placeId

string

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

您可以在 Create 呼叫期間設定此欄位,但無法在 Update 中設定。

duplicateLocation

string

僅供輸出。這個地點重複的位置資源。

mapsUri

string

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

newReviewUri

string

僅供輸出。消費者在 Google 搜尋上對該地點留下評論的網頁連結。

canHaveBusinessCalls

boolean

僅供輸出。說明商家資訊是否可撥打商家電話。

hasVoiceOfMerchant

boolean

僅供輸出。表示商家資訊是否包含商家的 Voice。如果布林值為 false,則應呼叫 locations.getVoiceOfMerchantState API,瞭解為何這些地區未提供商家 Voice。

設定檔

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

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

必要欄位。使用 placeID 指定關係另一側的位置。

relationType

enum (RelationType)

必要欄位。關係的類型。

RelationType

要指定的類型關係。

列舉
RELATION_TYPE_UNSPECIFIED 未指定類型。
DEPARTMENT_OF 這代表 2 個地點之間的關係,屬於同一實體區域、相同的品牌/上層管理機構/機構,但具有不同的重要屬性 (例如營業時間或電話號碼)。舉例來說,「Costco Pharmacy」是「Costco 批發商」的部門,
INDEPENDENT_ESTABLISHMENT_IN 這是指兩個營業地點共同分在同一處,但分別屬於不同公司的情況 (例如,位於捷運地下街的星巴克、購物中心內的商店)。

MoreHours

地點在特定類型的商家營業的期間。

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

string

必要欄位。營業時間類型。客戶應致電 {#link businessCategories:BatchGet},取得各地點類別支援的營業時間類型。

periods[]

object (TimePeriod)

必要欄位。這個地點的營業次數集合。每個時段代表地點在一週中營業的時段。

ServiceItem

描述單一服務項目的訊息。用來說明商家提供的服務類型。例如理髮並非服務。

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

  // Union field service_item_info can be only one of the following:
  "structuredServiceItem": {
    object (StructuredServiceItem)
  },
  "freeFormServiceItem": {
    object (FreeFormServiceItem)
  }
  // End of list of possible types for union field service_item_info.
}
欄位
price

object (Money)

選用設定。代表服務項目的貨幣價格。建議您在加入價格時,一併設定 currencyCode 和 unit。這會視為服務項目的固定價格。

聯集欄位 service_item_info。請一律設定下列其中一個欄位。service_item_info 只能是下列其中一項:
structuredServiceItem

object (StructuredServiceItem)

選用設定。這個欄位會設定結構化資料的大小寫。

freeFormServiceItem

object (FreeFormServiceItem)

選用設定。這個欄位會設為任意形式服務資料的值。

StructuredServiceItem

代表商家提供的結構化服務。例如:ilet_installation。

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

string

必要欄位。serviceTypeId 欄位是 Google 提供的專屬 ID,您可以在 ServiceType 中找到。這項資訊是由「categories.batchGet」安全單次點擊出價服務提供。

description

string

選用設定。結構化服務項目的說明。長度上限為 300 個半形字元。

FreeFormServiceItem

代表商家提供的任意形式服務。這些服務並未包含在 Google 的結構服務資料中。商家透過 Geomerchant 途徑手動輸入此類服務的名稱。

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

string

必要欄位。此欄位代表類別名稱 (即類別的固定 ID)。categoryserviceTypeId 應與 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

列出指定帳戶的營業地點。