- 資源:位置
- JSON 表示法
- PhoneNumbers
- 類別
- 類別
- ServiceType
- MoreHoursType
- PostalAddress
- BusinessHours
- TimePeriod
- DayOfWeek
- TimeOfDay
- SpecialHours
- SpecialHourPeriod
- 日期
- ServiceAreaBusiness
- BusinessType
- 地點介面集
- PlaceInfo
- AdWordsLocationExtensions
- LatLng
- OpenInfo
- OpenForBusiness
- 中繼資料
- 設定檔
- RelationshipData
- RelevantLocation
- RelationType
- MoreHours
- ServiceItem
- StructuredServiceItem
- FreeFormServiceItem
- 標籤
- 金額
- 方法
資源:位置
JSON 表示法 |
---|
{ "name": string, "languageCode": string, "storeCode": string, "title": string, "phoneNumbers": { object ( |
欄位 | |
---|---|
name |
這個地點的 Google ID,格式為: |
languageCode |
無法變更。地點使用的語言。請在建立期間設定,且無法更新。 |
storeCode |
選用設定。這個位置的外部 ID,在某帳戶內不得重複。藉此將該地點與您自己的記錄建立關聯。 |
title |
必要欄位。位置名稱必須如實反映商家的實際名稱,且與店面、網站和文具一致,客戶所知的名稱必須一致。您可將相關資訊加入資源的其他欄位 (例如 |
phoneNumbers |
選用設定。可供客戶與商家聯絡的不同電話號碼。 |
categories |
選用設定。描述商家的不同類別。 |
storefrontAddress |
選用設定。請提供精確、精確的地址,用來說明您的商家所在地點。我們不接受位於偏遠地區的郵政信箱或信箱。目前,您最多可以在地址中指定五個 |
websiteUri |
選用設定。此商家的網址。如果可以,請使用能代表這個個別商家所在地點的網址,而非代表所有地點或品牌的一般網站/網址。 |
regularHours |
選用設定。商家的營業時間。 |
specialHours |
選用設定。商家的特殊營業時間。通常包括假日營業時間及一般營業時間以外的其他時間。會覆寫一般營業時間。這個欄位必須不含一般營業時間,才能設定。 |
serviceArea |
選用設定。服務範圍商家在客戶的所在地提供服務。如果這個商家是區域服務商家,這個欄位會說明商家提供的區域。 |
labels[] |
選用設定。一組任意形式的字串,讓您可以標記商家。這些標籤「不會」向使用者顯示,只有您自己看得到。每個標籤的長度必須介於 1 至 255 個字元之間。 |
adWordsLocationExtensions |
選用設定。AdWords 中顯示的額外資訊。 |
latlng |
選用設定。使用者提供的經緯度。建立位置時,如果提供的地址地理編碼成功,系統就會忽略這個欄位。只有在建立期間接受使用者提供的 |
openInfo |
選用設定。表示地點目前是否營業中的標記。 |
metadata |
僅供輸出。其他不開放使用者編輯的資訊。 |
profile |
選用設定。用自己的方式介紹商家,並向使用者介紹商家和產品的獨特故事。 除了住宿類別 (例如飯店、汽車旅館、旅舍) 外,所有類別都必須提供這個欄位。 |
relationshipData |
選用設定。與這個地點相關的所有地點和連鎖店。 |
moreHours[] |
選用設定。其他部門或特定客戶的詳細營業時間。 |
serviceItems[] |
選用設定。商家支援的服務清單。任何服務都可以剪髮、安裝熱水器等。系統會自動移除重複的服務項目。 |
PhoneNumbers
一組商家的電話號碼。在更新期間,您必須同時設定這兩個欄位。用戶端不得只使用更新遮罩更新主要或額外的電話號碼。建議使用國際電話號碼格式,例如「+1 415 555 0132」,詳情請參閱 https://developers.google.com/style/phone-numbers#international-phone-numbers)。
JSON 表示法 |
---|
{ "primaryPhone": string, "additionalPhones": [ string ] } |
欄位 | |
---|---|
primaryPhone |
必要欄位。盡量直接與個別商家地點聯絡的電話號碼。請提供本地電話號碼,避免使用客服中心的客服專線號碼。 |
additionalPhones[] |
選用設定。除了主要電話號碼外,貴商家最多還可以登錄兩組電話號碼 (僅限手機或市話,不接受傳真)。 |
類別
描述商家的一組類別。在更新期間,您必須同時設定這兩個欄位。用戶端不得使用更新遮罩個別更新主要或其他類別。
JSON 表示法 |
---|
{ "primaryCategory": { object ( |
欄位 | |
---|---|
primaryCategory |
必要欄位。與這個地點所屬核心商家最相符的類別。 |
additionalCategories[] |
選用設定。其他用來描述您商家的類別。類別可協助客戶準確找到感興趣的服務。為確保商家資訊正確且上線,請盡量減少描述整體核心業務的類別。盡可能選用足以代表您主要業務的精確類別。 |
類別
說明商家性質 (而非業務內容) 的類別。如需有效類別 ID 清單,以及這些 ID 對應至使用者可理解的名稱,請參閱 categories.list
。
JSON 表示法 |
---|
{ "name": string, "displayName": string, "serviceTypes": [ { object ( |
欄位 | |
---|---|
name |
必要欄位。這個類別的固定 ID (由 Google 提供)。修改類別時 (建立或更新位置時),必須指定值。 |
displayName |
僅供輸出。使用者可理解的類別名稱。系統會在讀取位置時設定這個字串。修改位置時,必須設定 |
serviceTypes[] |
僅供輸出。此業務類別適用所有服務類型的清單。 |
moreHoursTypes[] |
僅供輸出。這個業務類別可用的更多營業時間類型。 |
ServiceType
商家所提供服務類型的訊息。
JSON 表示法 |
---|
{ "serviceTypeId": string, "displayName": string } |
欄位 | |
---|---|
serviceTypeId |
僅供輸出。這個服務類型的固定 ID (由 Google 提供)。 |
displayName |
僅供輸出。使用者容易理解的服務類型的顯示名稱。 |
MoreHoursType
商家除了一般營業時間外,還有更多營業時間類型。
JSON 表示法 |
---|
{ "hoursTypeId": string, "displayName": string, "localizedDisplayName": string } |
欄位 | |
---|---|
hoursTypeId |
僅供輸出。Google 針對這個營業時間類型提供的固定 ID。 |
displayName |
僅供輸出。使用者容易理解的營業時間類型英文顯示名稱。 |
localizedDisplayName |
僅供輸出。營業時間類型的本地化顯示名稱。 |
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 |
所有新的修訂版本都必須能夠與舊的修訂版本回溯相容。 |
regionCode |
必要欄位。地址所在國家/地區的 CLDR 地區代碼。這個代碼絕非透過推測而得出,並且是由使用者自行確保該值正確無誤。詳情請參閱 https://cldr.unicode.org/ 和 https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html。例如:瑞士的地區代碼為「CH」。 |
languageCode |
選用設定。這個地址內容的 BCP-47 語言代碼 (如果已知)。通常是輸入表單的 UI 語言,或是符合地址的國家/地區所用的其中一個語言,或是使用音譯的對應項目。這個欄位可能會影響某些國家/地區的格式設定,但是不會影響資料的正確性,也絕不會影響任何驗證或其他非格式的相關作業。 如果不知道這個值為何,則應省略該值 (而非指定可能不正確的預設值)。 例如:「zh-Hant」、「ja」、「ja-Latn」、「en」。 |
postalCode |
選用設定。地址的郵遞區號。並非所有國家/地區都使用郵遞區號或要求必須填寫郵遞區號,不過在使用郵遞區號時,可能會對地址其他部分觸發額外的驗證作業 (例如美國對州/郵遞區號的驗證)。 |
sortingCode |
選用設定。國家/地區專屬的其他分類代碼。大多數國家/地區並不使用這個代碼。在使用分類代碼的國家/地區中,這個值為與「CEDEX」相似的字串,後面選擇性加上一個數字 (例如「CEDEX 7」),或是只有單一數字,並用來表示「區段代碼」(牙買加)、「寄送區域指示碼」(馬拉威) 或「郵局指示碼」(如象牙海岸)。 |
administrativeArea |
選用設定。最高行政區,用於國家/地區的郵遞地址。例如,此值可以是州、省或縣。以西班牙為例來具體說明,此欄位的值為省,而非自治區 (例如「巴塞隆納」省,而不是「加泰隆尼亞」自治區)。許多國家/地區的郵寄地址並沒有使用行政區。例如,就瑞士而言,該欄位應該留空不填。 |
locality |
選用設定。一般是指地址的縣市/鄉鎮部分。例如:美國城市、義大利市鎮、英國郵鎮。如為未明確定義縣市或其縣市不適用此結構的地區,請將 locality 留白,改用 addressLines。 |
sublocality |
選用設定。地址的縣市以下行政區,例如社區、自治市鎮和區等。 |
addressLines[] |
非結構化的地址行,說明地址的低層級項目。 由於 addressLines 中的值不會有類型資訊,而且有時在單一欄位中可能會包含多個值 (例如「Austin, TX」),因此地址行的順序務必要明確。地址行的順序應為該地址所在國家/地區的「信封書寫順序」。在信封書寫順序可能不盡相同的地區 (如日本),可使用 address_language 讓地址更明確 (例如「ja」表示由大到小的排序,而「ja-Latn」或「en」則表示由小到大)。如此一來,您便可以根據語言來選取明確度最高的地址行。 地址允許的最小結構表示法是包含一個 regionCode,並將其餘所有資訊放置在 addressLines 中。您可以在幾乎不使用地理定位的情况下,設定這類地址的格式,但至少在地址局部解析完畢之前,您無法對地址的任何組成部分進行語意推論。 如要處理完全非結構化的地址,我們建議您只建立包含 regionCode 和 addressLines 的地址,並使用地理定位來進行 (而非猜測地址的哪些部分應該是縣市還是行政區)。 |
recipients[] |
選用設定。地址的收件人。在某些情況下,這個欄位可能會包含多行資訊。舉例來說,此欄位可能包含「代收者」資訊。 |
organization |
選用設定。地址中的機構名稱。 |
BusinessHours
代表這個地點營業的時間範圍。保存一組 [TimePeriod][google.mybusiness.mybusinessinformation.v1.TimePeriod] 執行個體。
JSON 表示法 |
---|
{
"periods": [
{
object ( |
欄位 | |
---|---|
periods[] |
必要欄位。這個地點營業的一系列次數。每個時段代表地點在一週中營業的時段。 |
TimePeriod
代表商家營業的時間範圍,從指定的營業時間開始,到指定結束日/時間結束為止。打烊時間必須晚於開幕時間,例如當天稍晚或隨後幾天。
JSON 表示法 |
---|
{ "openDay": enum ( |
欄位 | |
---|---|
openDay |
必要欄位。表示這個期間從開始當天起算的 |
openTime |
必要欄位。有效值為 00:00-24:00,其中 24:00 代表指定日期欄位結束的午夜。 |
closeDay |
必要欄位。表示這個週期結束的 |
closeTime |
必要欄位。有效值為 00:00-24:00,其中 24:00 代表指定日期欄位結束的午夜。 |
DayOfWeek
代表星期幾。
列舉 | |
---|---|
DAY_OF_WEEK_UNSPECIFIED |
未指定星期幾。 |
MONDAY |
週一 |
TUESDAY |
週二 |
WEDNESDAY |
星期三 |
THURSDAY |
週四 |
FRIDAY |
星期五 |
SATURDAY |
Saturday (週六) |
SUNDAY |
星期日 |
TimeOfDay
代表一天中的時間。日期和時區並不需要指定,或是在其他位置上指定。API 可選擇允許閏秒。相關類型為 google.type.Date
和 google.protobuf.Timestamp
。
JSON 表示法 |
---|
{ "hours": integer, "minutes": integer, "seconds": integer, "nanos": integer } |
欄位 | |
---|---|
hours |
時段,採用 24 小時格式。值應介於 0 到 23 之間。API 可選擇允許使用「24:00:00」這類的值來表示營業打烊時間等情況。 |
minutes |
一天內的分鐘。值必須介於 0 到 59 之間。 |
seconds |
當下時間的秒數。正常情況下,值必須介於 0 到 59 之間。如果 API 允許閏秒,則可允許值為 60。 |
nanos |
秒數的小數,以奈秒為單位。值必須介於 0 到 999,999,999 之間。 |
SpecialHours
代表一個地點的營業時間與正常營業時間不同的時間範圍。
JSON 表示法 |
---|
{
"specialHourPeriods": [
{
object ( |
欄位 | |
---|---|
specialHourPeriods[] |
必要欄位。商家一般營業時間的例外狀況清單。 |
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 ( |
欄位 | |
---|---|
startDate |
必要欄位。這個特殊時段的起始日期。 |
openTime |
選用設定。有效值為 00:00-24:00,其中 24:00 代表指定日期欄位結束的午夜。如果 |
endDate |
選用設定。這個特殊時段的結束日期。如未設定 |
closeTime |
選用設定。有效值為 00:00-24:00,其中 24:00 代表指定日期欄位結束的午夜。如果 |
closed |
選用設定。如果設為 True,系統會忽略 |
日期
代表完整或部分日曆的日期,例如生日。您可在其他位置指定日期和時間,或沒有其他選擇。日期以公曆為相對於公曆。可能代表下列其中一種:
- 完整日期,具有非零的年、月和日值。
- 月和日,出現零年 (例如週年紀念日)。
- 一個自己的年,分別為 0 個月和 0 天。
- 年份和月份,數字為零 (例如信用卡到期日)。
相關類型:
google.type.TimeOfDay
google.type.DateTime
google.protobuf.Timestamp
JSON 表示法 |
---|
{ "year": integer, "month": integer, "day": integer } |
欄位 | |
---|---|
year |
日期的年份。必須為 1 到 9999,或是 0 才能指定不含年份的日期。 |
month |
一年中的月份。必須為 1 到 12 或 0,才能指定不含月份和日的年份。 |
day |
一個月中的第幾天。值必須介於 1 到 31 之間,且為該年和月份計算而得;設為 0 可以只指定年份,也可以只指定年份和月份,但日期可不算。 |
ServiceAreaBusiness
服務範圍商家在顧客的營業地點提供服務 (例如鎖匠或水電工)。
JSON 表示法 |
---|
{ "businessType": enum ( |
欄位 | |
---|---|
businessType |
必要欄位。表示服務範圍商家的 [類型] [google.mybusiness.businessinfo.v1.ServiceAreaBusiness.BusinessType]。 |
places |
此商家透過一組地點指定的服務範圍。 |
regionCode |
無法變更。這個服務範圍商家所在國家/地區的 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 ( |
欄位 | |
---|---|
placeInfos[] |
以地點 ID 表示的區域。地點數量上限為 20 個地點。 |
PlaceInfo
定義以地點 ID 表示的區域。
JSON 表示法 |
---|
{ "placeName": string, "placeId": string } |
欄位 | |
---|---|
placeName |
必要欄位。地點的本地化名稱。例如 |
placeId |
必要欄位。地點的 ID。必須對應一個區域。(https://developers.google.com/places/web-service/supported_types#table3) |
AdWordsLocationExtensions
AdWords 中顯示的額外資訊。
JSON 表示法 |
---|
{ "adPhone": string } |
欄位 | |
---|---|
adPhone |
必要欄位。顯示在 AdWords 地點額外資訊中的備用電話號碼,而非位置的主要電話號碼。 |
LatLng
代表經緯度組合的物件。以一對雙精準數表示經度度數和緯度度數。除非另有指定,否則這個物件必須符合 WGS84 標準。此外,值必須在正規化範圍內。
JSON 表示法 |
---|
{ "latitude": number, "longitude": number } |
欄位 | |
---|---|
latitude |
緯度度數,必須介於 [-90.0, +90.0] 的範圍之間。 |
longitude |
經度度數,必須介於 [-180.0, +180.0] 的範圍之間。 |
OpenInfo
商家營業狀態的相關資訊。
JSON 表示法 |
---|
{ "status": enum ( |
欄位 | |
---|---|
status |
必要欄位。指出該地點目前是否營業中。根據預設,所有地點都是營業中 (除非更新為已停業)。 |
canReopen |
僅供輸出。表示這個商家是否有資格恢復營業。 |
openingDate |
選用設定。地點初次開啟的日期。如果不知道確切日期,則只能提供月份和年份。日期必須是過去的日期,或在未來一年內。 |
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 |
僅供輸出。指出與這個地點相關聯的地點 ID,是否含有需要由用戶端更新或拒絕的更新。如果設定了布林值,應呼叫 |
hasPendingEdits |
僅供輸出。指出這個地點的任何房源是否處於編輯待處理狀態。 |
canDelete |
僅供輸出。指出是否可以使用 API 刪除地點。 |
canOperateLocalPost |
僅供輸出。指出該商家資訊是否可管理當地貼文。 |
canModifyServiceList |
僅供輸出。指出商家資訊是否可以修改服務清單。 |
canHaveFoodMenus |
僅供輸出。說明商家資訊是否適用於食物選單。 |
canOperateHealthData |
僅供輸出。指出該位置是否能對健康資料執行操作。 |
canOperateLodgingData |
僅供輸出。指出地點是否能在住宿資料上運作。 |
placeId |
僅供輸出。如果這個地點出現在 Google 地圖上,這個欄位會填入該位置的地點 ID。這個 ID 可用於多種 Places API。 您可以在 Create 呼叫期間設定此欄位,但無法在 Update 中設定。 |
duplicateLocation |
僅供輸出。這個地點重複的位置資源。 |
mapsUri |
僅供輸出。地點在 Google 地圖上的連結。 |
newReviewUri |
僅供輸出。消費者在 Google 搜尋上對該地點留下評論的網頁連結。 |
canHaveBusinessCalls |
僅供輸出。說明商家資訊是否可撥打商家電話。 |
hasVoiceOfMerchant |
僅供輸出。表示商家資訊是否包含商家的 Voice。如果布林值為 false,則應呼叫 locations.getVoiceOfMerchantState API,瞭解為何這些地區未提供商家 Voice。 |
設定檔
與地點設定檔相關的所有資訊。
JSON 表示法 |
---|
{ "description": string } |
欄位 | |
---|---|
description |
必要欄位。請說出地點說明,任何人都無法編輯。 |
RelationshipData
與此地點相關的所有家長和兒童地點資訊。
JSON 表示法 |
---|
{ "parentLocation": { object ( |
欄位 | |
---|---|
parentLocation |
與這個地點相關的上層位置。 |
childrenLocations[] |
與這個地點相關的兒童地點清單。 |
parentChain |
這個位置所屬鏈結的資源名稱。[如何尋找連鎖店 ID] [Locations.SearchChains] |
RelevantLocation
與目前位置相關的其他地點相關資訊。關係可以是 DEPARTMENT_OF 或 INDEPENDENT_ESTABLISHMENT_OF,而此處指定的位置可位於位置的任一側 (父項/子項)。
JSON 表示法 |
---|
{
"placeId": string,
"relationType": enum ( |
欄位 | |
---|---|
placeId |
必要欄位。使用 placeID 指定關係另一側的位置。 |
relationType |
必要欄位。關係的類型。 |
RelationType
要指定的類型關係。
列舉 | |
---|---|
RELATION_TYPE_UNSPECIFIED |
未指定類型。 |
DEPARTMENT_OF |
這代表 2 個地點之間的關係,屬於同一實體區域、相同的品牌/上層管理機構/機構,但具有不同的重要屬性 (例如營業時間或電話號碼)。舉例來說,「Costco Pharmacy」是「Costco 批發商」的部門, |
INDEPENDENT_ESTABLISHMENT_IN |
這是指兩個營業地點共同分在同一處,但分別屬於不同公司的情況 (例如,位於捷運地下街的星巴克、購物中心內的商店)。 |
MoreHours
地點在特定類型的商家營業的期間。
JSON 表示法 |
---|
{
"hoursTypeId": string,
"periods": [
{
object ( |
欄位 | |
---|---|
hoursTypeId |
必要欄位。營業時間類型。客戶應致電 {#link businessCategories:BatchGet},取得各地點類別支援的營業時間類型。 |
periods[] |
必要欄位。這個地點的營業次數集合。每個時段代表地點在一週中營業的時段。 |
ServiceItem
描述單一服務項目的訊息。用來說明商家提供的服務類型。例如理髮並非服務。
JSON 表示法 |
---|
{ "price": { object ( |
欄位 | |
---|---|
price |
選用設定。代表服務項目的貨幣價格。建議您在加入價格時,一併設定 currencyCode 和 unit。這會視為服務項目的固定價格。 |
聯集欄位 service_item_info 。請一律設定下列其中一個欄位。service_item_info 只能是下列其中一項: |
|
structuredServiceItem |
選用設定。這個欄位會設定結構化資料的大小寫。 |
freeFormServiceItem |
選用設定。這個欄位會設為任意形式服務資料的值。 |
StructuredServiceItem
代表商家提供的結構化服務。例如:ilet_installation。
JSON 表示法 |
---|
{ "serviceTypeId": string, "description": string } |
欄位 | |
---|---|
serviceTypeId |
必要欄位。 |
description |
選用設定。結構化服務項目的說明。長度上限為 300 個半形字元。 |
FreeFormServiceItem
代表商家提供的任意形式服務。這些服務並未包含在 Google 的結構服務資料中。商家透過 Geomerchant 途徑手動輸入此類服務的名稱。
JSON 表示法 |
---|
{
"category": string,
"label": {
object ( |
欄位 | |
---|---|
category |
必要欄位。此欄位代表類別名稱 (即類別的固定 ID)。 |
label |
必要欄位。項目的語言標記標籤。項目名稱的建議長度上限為 140 個半形字元,說明的長度則不超過 250 個半形字元。只有在輸入內容為自訂服務項目時,才需要設定這個欄位。標準化服務類型應透過 serviceTypeId 更新。 |
標籤
顯示價格清單、專區或商品時使用的標籤。
JSON 表示法 |
---|
{ "displayName": string, "description": string, "languageCode": string } |
欄位 | |
---|---|
displayName |
必要欄位。價格清單、專區或商品的顯示名稱。 |
description |
選用設定。價格清單、專區或商品的說明。 |
languageCode |
選用設定。這些字串適用的 BCP-47 語言代碼。每種語言只能設定一組標籤。 |
金額
代表金額與其貨幣類型。
JSON 表示法 |
---|
{ "currencyCode": string, "units": string, "nanos": integer } |
欄位 | |
---|---|
currencyCode |
ISO 4217 定義的貨幣代碼 (由三個字母組成)。 |
units |
金額的整數單位。舉例來說,如果 |
nanos |
金額的十億分之一 (10^-9) 單位數量。這個值必須介於 -999,999,999 和 +999,999,999 (含) 之間。如果 |
方法 |
|
---|---|
|
建立由登入使用者擁有的新位置。 |
|
列出指定帳戶的營業地點。 |