REST Resource: accounts.locations

{
  "primaryPhone": string,
  "additionalPhones": [
    string
  ]
}

string

必要欄位。可以盡量直接聯絡到您個別商家所在地點的電話號碼。請提供本地電話號碼，避免使用總公司/客服中心聯絡電話。

string

選用設定。除了主要電話號碼外，您的商家最多還可以登錄兩組電話號碼 (僅限手機或市話，不接受傳真號碼)。

{
  "primaryCategory": {
    object (Category)
  },
  "additionalCategories": [
    {
      object (Category)
    }
  ]
}

object (Category)

必要欄位。這個類別與這個地點所處的核心業務最相符。

object (Category)

選用設定。可描述貴商家的其他類別。類別可協助客戶正確地找到感興趣的服務。為確保商家資訊正確並上線，請盡量減少用來描述整體核心業務的類別。盡可能選用足以代表您主要業務的精確類別。

{
  "name": string,
  "displayName": string,
  "serviceTypes": [
    {
      object (ServiceType)
    }
  ],
  "moreHoursTypes": [
    {
      object (MoreHoursType)
    }
  ]
}

string

必要欄位。這個類別的固定 ID (由 Google 提供)。修改類別時 (建立或更新位置時，必須指定這個值)。

string

僅供輸出。使用者可理解的類別名稱。讀取位置時即會設定這個選項。修改位置時，必須設定 category_id。

object (ServiceType)

僅供輸出。列出這個業務類別提供的所有服務類型。

object (MoreHoursType)

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

{
  "serviceTypeId": string,
  "displayName": string
}

string

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

string

僅供輸出。服務類型的使用者可理解的顯示名稱。

{
  "hoursTypeId": string,
  "displayName": string,
  "localizedDisplayName": string
}

string

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

string

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

string

僅供輸出。使用者可理解的本地化顯示名稱，代表營業時間類型。

{
  "revision": integer,
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "sortingCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ],
  "recipients": [
    string
  ],
  "organization": string
}

integer

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

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

string

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

string

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

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

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

string

選用設定。地址的郵遞區號。並非所有國家/地區都使用郵遞區號或要求必須填寫郵遞區號，不過在使用郵遞區號時，可能會對地址其他部分觸發額外的驗證作業 (例如美國對州/郵遞區號的驗證)。

string

選用設定。國家/地區專屬的其他分類代碼。大多數國家/地區並不使用這個代碼。在使用分類代碼的國家/地區中，這個值為與「CEDEX」相似的字串，後面選擇性加上一個數字 (例如「CEDEX 7」)，或是只有單一數字，並用來表示「區段代碼」(牙買加)、「寄送區域指示碼」(馬拉威) 或「郵局指示碼」(如象牙海岸)。

string

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

string

選用設定。一般是指地址的縣市/鄉鎮部分。例如：美國城市、義大利市鎮、英國郵鎮。如為未明確定義縣市或其縣市不適用此結構的地區，請將 locality 留白，改用 addressLines。

string

選用設定。地址的縣市以下行政區，例如社區、自治市鎮和區等。

string

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

由於 addressLines 中的值不會有類型資訊，而且有時在單一欄位中可能會包含多個值 (例如「Austin, TX」)，因此地址行的順序務必要明確。地址行的順序應為該地址所在國家/地區的「信封書寫順序」。在信封書寫順序可能不盡相同的地區 (如日本)，可使用 address_language 讓地址更明確 (例如「ja」表示由大到小的排序，而「ja-Latn」或「en」則表示由小到大)。如此一來，您便可以根據語言來選取明確度最高的地址行。

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

如要處理完全非結構化的地址，我們建議您只建立包含 regionCode 和 addressLines 的地址，並使用地理定位來進行 (而非猜測地址的哪些部分應該是縣市還是行政區)。

string

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

string

選用設定。地址中的機構名稱。

{
  "periods": [
    {
      object (TimePeriod)
    }
  ]
}

object (TimePeriod)

必要欄位。這個地點的營業時間集合。每個時段都代表地點在當週營業的時段。

{
  "openDay": enum (DayOfWeek),
  "openTime": {
    object (TimeOfDay)
  },
  "closeDay": enum (DayOfWeek),
  "closeTime": {
    object (TimeOfDay)
  }
}

enum (DayOfWeek)

必要欄位。表示這個經期開始的 day of the week。

object (TimeOfDay)

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

enum (DayOfWeek)

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

object (TimeOfDay)

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

{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}

integer

一天的營業時間，以 24 小時製表示。值應介於 0 到 23 之間。API 可選擇允許使用「24:00:00」這類的值來表示營業打烊時間等情況。

integer

一天內的分鐘數。值必須介於 0 到 59 之間。

integer

時間的秒數。正常情況下，值必須介於 0 到 59 之間。如果 API 允許閏秒，則可允許值為 60。

integer

秒數的小數，以奈秒表示。值必須介於 0 到 999,999,999 之間。

{
  "specialHourPeriods": [
    {
      object (SpecialHourPeriod)
    }
  ]
}

object (SpecialHourPeriod)

必要欄位。商家一般營業時間的例外狀況清單。

{
  "startDate": {
    object (Date)
  },
  "openTime": {
    object (TimeOfDay)
  },
  "endDate": {
    object (Date)
  },
  "closeTime": {
    object (TimeOfDay)
  },
  "closed": boolean
}

object (Date)

必要欄位。這個特殊營業時間的開始日期。

object (TimeOfDay)

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

object (Date)

選用設定。這個特殊營業時間結束的日期。如未設定 endDate 欄位，預設值為 startDate 中指定的日期。在設定的情況下，這個欄位必須等於或最多在 startDate 後 1 天。

object (TimeOfDay)

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

boolean

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

{
  "year": integer,
  "month": integer,
  "day": integer
}

integer

日期的年份。這個值必須介於 1 至 9999，或 0 之間可指定不含年份的日期。

integer

一年中的月份。必須介於 1 到 12 之間，或 0 可以指定不含月份和日期的年份。

integer

一個月中的第幾天。這個值必須介於 1 至 31 之間，且有效的年份和月份；或 0 可讓您指定本身或年份和月份，但這些日期不明顯。

{
  "businessType": enum (BusinessType),
  "places": {
    object (Places)
  },
  "regionCode": string
}

enum (BusinessType)

必要欄位。表示 [type] [google.mybusiness.businessinfo.v1.ServiceAreaBusiness.BusinessType] 是服務範圍商家。

object (Places)

這個商家透過一組地點定義的服務區域。

string

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

此為 CUSTOMER_LOCATION_ONLY 商家的必填欄位，在其他情況下會遭到忽略。

這裡指定的區域可能會與這個商家提供服務的區域不同 (例如服務範圍商家並非位於商家所在地的區域)。

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

{
  "placeInfos": [
    {
      object (PlaceInfo)
    }
  ]
}

object (PlaceInfo)

地點 ID 代表的區域。最多不得超過 20 個地點。

{
  "placeName": string,
  "placeId": string
}

string

必要欄位。地點的本地化名稱。例如 Scottsdale, AZ。

string

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

{
  "adPhone": string
}

string

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

{
  "latitude": number,
  "longitude": number
}

number

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

number

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

{
  "status": enum (OpenForBusiness),
  "canReopen": boolean,
  "openingDate": {
    object (Date)
  }
}

enum (OpenForBusiness)

必要欄位。說明地點目前是否營業中。除非更新為已停業，否則所有地點都預設為營業中。

boolean

僅供輸出。表示這個商家是否可以恢復營業。

object (Date)

選用設定。地點初次開幕的日期。如果不知道確切日期，則只能提供月份和年份。日期必須是過去的日期，或不超過未來一年的時間。

{
  "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
}

boolean

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

boolean

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

boolean

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

boolean

僅供輸出。指出商家資訊能否管理在地貼文。

boolean

僅供輸出。指出清單內容是否可以修改服務清單。

boolean

僅供輸出。指出房源是否提供餐點菜單。

boolean

僅供輸出。指出位置能否使用健康資料。

boolean

僅供輸出。指出營業地點是否能處理住宿資料。

string

僅供輸出。如果這個地點出現在 Google 地圖上，系統會在這個欄位填入該地點的地點 ID。這個 ID 可用於不同的 Places API。

在建立呼叫期間可以設定此欄位，但不能針對「更新」設定。

string

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

string

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

string

僅供輸出。Google 搜尋上的網頁連結，客戶可以在這裡留下該地點的評論。

boolean

僅供輸出。指出商家資訊是否符合使用商家來電的資格。

boolean

僅供輸出。指出商家資訊是否包含商家語音。如果這個布林值為 false，應呼叫 locations.getVoiceOfMerchantState API 以取得其沒有 Voice of Merchant 的詳細原因。

{
  "description": string
}

string

必要欄位。請說出地點的說明，其他人無法編輯。

{
  "parentLocation": {
    object (RelevantLocation)
  },
  "childrenLocations": [
    {
      object (RelevantLocation)
    }
  ],
  "parentChain": string
}

object (RelevantLocation)

這個位置所屬的上層地點。

object (RelevantLocation)

與這個位置相關的子項地點清單。

string

這個位置所屬連鎖店的資源名稱。[如何尋找連鎖店 ID] [Locations.SearchChains]

{
  "placeId": string,
  "relationType": enum (RelationType)
}

string

必要欄位。根據 PlaceID 指定關係另一端的位置。

enum (RelationType)

必要欄位。關係的類型。

{
  "hoursTypeId": string,
  "periods": [
    {
      object (TimePeriod)
    }
  ]
}

string

必要欄位。營業時間類型。客戶應呼叫 {#link businessCategories:BatchGet}，取得其營業地點類別的支援時段類型。

object (TimePeriod)

必要欄位。這個地點的營業時間集合。每個時段都代表地點在當週營業的時段。

{
  "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.
}

object (Money)

選用設定。代表服務項目的貨幣價格。建議在加入價格時設定 currencyCode 和單位。系統會將此視為服務項目的固定價格。

object (StructuredServiceItem)

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

object (FreeFormServiceItem)

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

{
  "serviceTypeId": string,
  "description": string
}

string

必要欄位。serviceTypeId 欄位是 Google 提供的專屬 ID，可在 ServiceType 中找到。這項資訊是由「categories.batchGet」遠端程序呼叫 (RPC) 服務提供。

string

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

{
  "category": string,
  "label": {
    object (Label)
  }
}

string

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

object (Label)

必要欄位。項目標籤。項目名稱建議不要超過 140 個半形字元，說明則不超過 250 個半形字元。只有在輸入內容是自訂服務項目時，才需要設定這個欄位。標準化服務類型應透過 serviceTypeId 更新。

{
  "displayName": string,
  "description": string,
  "languageCode": string
}

string

必要欄位。價格清單、專區或商品的顯示名稱。

string

選用設定。價格清單、專區或商品的說明。

string

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

{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}

string

ISO 4217 定義的貨幣代碼 (由三個字母表示)。

string (int64 format)

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

integer

金額的十億分之一 (10^-9) 單位數量。這個值必須介於 -999,999,999 和 +999,999,999 (含) 之間。如果 units 為正數，nanos 必須為正數或零。如果 units 為零，nanos 可以是正數、零或負數。如果 units 為負數，nanos 必須為負數或零。例如 $-1.75 美元的呈現方式為 units=-1 和 nanos=-750,000,000。