REST Resource: accounts.locations

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

object (TimePeriod)

這個地點營業的一系列次數。每個時段代表地點在一週中營業的時段。

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

enum (DayOfWeek)

表示這個期間從開始當天起算的day of the week。

string

以 24 小時 ISO 8601 擴充格式 (hh:mm) 表示的時間。有效值為 00:00-24:00，其中 24:00 代表指定日期欄位結束的午夜。

enum (DayOfWeek)

表示這個週期結束的day of the week。

string

以 24 小時 ISO 8601 擴充格式 (hh:mm) 表示的時間。有效值為 00:00-24:00，其中 24:00 代表指定日期欄位結束的午夜。

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

object (SpecialHourPeriod)

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

{
  "startDate": {
    object (Date)
  },
  "openTime": string,
  "endDate": {
    object (Date)
  },
  "closeTime": string,
  "isClosed": boolean
}

object (Date)

這個特殊時段的起始日期。

string

startDate 開啟地點時的實際時間，以 24 小時 ISO 8601 擴充格式表示。(hh:mm) 有效值為 00:00-24:00，其中 24:00 代表指定日期欄位結束的午夜。如果 isClosed 為 false，則必須指定。

object (Date)

這個特殊時段的結束日期。如未設定 endDate 欄位，請預設為 startDate 中指定的日期。如已設定，這個欄位必須等於或最多晚於 startDate後 1 天。

string

地點打烊時，endDate 的實際時間，以 24 小時 ISO 8601 擴充格式表示。(hh:mm) 有效值為 00:00-24:00，其中 24:00 代表指定日期欄位結束的午夜。如果 isClosed 為 false，則必須指定。

boolean

如果設為 True，系統會忽略 endDate、openTime 和 closeTime，且會將 startDate 中指定的日期視為整天沒有停業。

{
  "businessType": enum (BusinessType),

  // Union field coverageArea can be only one of the following:
  "radius": {
    object (PointRadius)
  },
  "places": {
    object (Places)
  }
  // End of list of possible types for union field coverageArea.
}

enum (BusinessType)

表示服務區域商家的type。

object (PointRadius)

僅供輸出。此商家以某點為中心的中心區域。

object (Places)

此商家透過一組地點指定的服務範圍。

{
  "latlng": {
    object (LatLng)
  },
  "radiusKm": number
}

object (LatLng)

經緯度，指定半徑定義區域的中心。

number

該地點周圍區域的距離 (以公里為單位)。

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

number

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

number

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

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

object (PlaceInfo)

以地點 ID 表示的區域。地點數量上限為 20 個地點。

{
  "name": string,
  "placeId": string
}

string

地點的本地化名稱。例如 Scottsdale, AZ。

string

地點的 ID。必須與 region 對應。

{
  "plusPageId": string,
  "placeId": string,
  "explicitNoPlaceId": boolean,
  "requestId": string
}

string

僅供輸出。如果這個地點有相關聯的 Google+ 專頁，系統就會填入這個地點的 Google+ 專頁 ID。

string

如果這個地點已經通過驗證，且該位置已連結至 Google 地圖上/出現在 Google 地圖上，這個欄位就會填入該位置的地點 ID。這個 ID 可用於多種 Places API。

如果這個地點未經驗證，如果地點已與 Google 地圖上顯示的地點相關聯，這個欄位就會填入資料。

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

額外的 explicitNoPlaceId 布林值代表是否刻意設定不設定的地點 ID。

boolean

僅供輸出。如果值為 true，代表這是刻意設定的地點 ID，與尚未建立任何關聯。

string

僅供輸出。用來建立這個位置的 requestId。如果這個地點不是在 Google My Business API 或商家檔案位置中建立的，則可能會留空。

{
  "adPhone": string
}

string

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

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

enum (OpenForBusiness)

指出該地點目前是否營業中。根據預設，所有地點都是營業中 (除非更新為已停業)。

boolean

僅供輸出。表示這個商家是否有資格恢復營業。

object (Date)

地點初次開啟的日期。如果不知道確切日期，則只能提供月份和年份。日期必須是過去的日期，或在未來一年內。

{
  "isGoogleUpdated": boolean,
  "isDuplicate": boolean,
  "isSuspended": boolean,
  "canUpdate": boolean,
  "canDelete": boolean,
  "isVerified": boolean,
  "needsReverification": boolean,
  "isPendingReview": boolean,
  "isDisabled": boolean,
  "isPublished": boolean,
  "isDisconnected": boolean,
  "isLocalPostApiDisabled": boolean,
  "canModifyServiceList": boolean,
  "canHaveFoodMenus": boolean,
  "hasPendingEdits": boolean,
  "hasPendingVerification": boolean,
  "canOperateHealthData": boolean,
  "canOperateLodgingData": boolean
}

boolean

僅供輸出。指出與這個地點相關聯的地點 ID 是否有更新資料。

boolean

僅供輸出。指出該地點是否與其他地點重複。

boolean

僅供輸出。指出該地點是否遭停權。使用者無法在 Google 產品中看到已停權的地點。如果你認為這是誤判，請參閱說明中心文章。

boolean

僅供輸出。用於指出地點是否可更新。

boolean

僅供輸出。指出能否使用 Google My Business API 刪除地點。

boolean

僅供輸出。表示地點是否已通過驗證。

boolean

僅供輸出。指出該地點是否需要重新驗證。

boolean

僅供輸出。指出該地點是否正在等待審核。

boolean

僅供輸出。用於指出地點是否已停用。

boolean

僅供輸出。指出地點是否已發布。

boolean

僅供輸出。指出該地點是否與 Google 地圖上的某個地點中斷連線。

boolean

僅供輸出。指出這個位置的 accounts.locations.localPosts 是否已停用。

boolean

僅供輸出。指出清單是否可修改 ServiceList。

boolean

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

boolean

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

boolean

僅供輸出。表示該地點是否有待處理的驗證要求。

boolean

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

boolean

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

{
  "attributeId": string,
  "valueType": enum (AttributeValueType),
  "values": [
    value
  ],
  "repeatedEnumValue": {
    object (RepeatedEnumAttributeValue)
  },
  "urlValues": [
    {
      object (UrlAttributeValue)
    }
  ]
}

string

屬性的 ID。屬性 ID 由 Google 提供。

enum (AttributeValueType)

僅供輸出。此屬性包含的值類型。這應用於決定如何解讀這個值。

value (Value format)

這項屬性的值。提供的值類型必須符合該屬性的預期；詳情請參閱 AttributeValueType。這是個重複欄位，當中可以提供多個屬性值。屬性類型僅支援一個值。

object (RepeatedEnumAttributeValue)

如果屬性值類型為 REPEATED_ENUM，這個類型就會包含屬性值，其他值欄位則必須留空。

object (UrlAttributeValue)

如果屬性值類型為「網址」，則這個欄位會包含這項屬性的值，而其他值欄位則須留空。

{
  "setValues": [
    string
  ],
  "unsetValues": [
    string
  ]
}

string

設定的列舉值。

string

未設定的列舉值。

{
  "url": string
}

string

網址。

{
  "duplicate": {
    object (Duplicate)
  },
  "mapsUrl": string,
  "newReviewUrl": string
}

object (Duplicate)

與這個地點重複的地點相關資訊。只有在 locationState.is_duplicate 為 true 時才會顯示。已淘汰：我們不再支援重複項目的詳細資訊。

string

地點在 Google 地圖上的連結。

string

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

{
  "locationName": string,
  "placeId": string,
  "access": enum (Access)
}

string

重複位置的資源名稱。只有在已驗證使用者有權存取該位置，而且該位置未刪除時，才會填寫此欄位。

string

重複地點的地點 ID。

enum (Access)

指出使用者是否可以存取重複的位置。

{
  "priceListId": string,
  "labels": [
    {
      object (Label)
    }
  ],
  "sourceUrl": string,
  "sections": [
    {
      object (Section)
    }
  ]
}

string

必要欄位。價格清單的 ID。你無法在這個地區複製價目表、專區和項目 ID。

object (Label)

必要欄位。價格清單的語言標記標籤。

string

擷取價格清單的來源網址 (選填)。舉例來說，這可能是系統自動剪輯來填入菜單資訊的網頁網址。

object (Section)

必要欄位。這份價目表的版面。每份價目表都必須包含至少一個版面。

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

string

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

string

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

string

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

{
  "sectionId": string,
  "labels": [
    {
      object (Label)
    }
  ],
  "sectionType": enum (SectionType),
  "items": [
    {
      object (Item)
    }
  ]
}

string

必要欄位。章節 ID。你無法在這個地區複製價目表、專區和項目 ID。

object (Label)

必要欄位。區段的語言標記標籤。版面名稱和說明建議不要超過 140 個半形字元。至少須指定一組標籤。

enum (SectionType)

選用設定。目前價目表部分的類型。預設值為 FOOD。

object (Item)

價目表這部分包含的商品。

{
  "itemId": string,
  "labels": [
    {
      object (Label)
    }
  ],
  "price": {
    object (Money)
  }
}

string

必要欄位。商品的 ID。你無法在這個地區複製價目表、專區和項目 ID。

object (Label)

必要欄位。項目的語言標記標籤。項目名稱的建議長度上限為 140 個半形字元，說明的長度則不超過 250 個半形字元。至少須指定一組標籤。

object (Money)

選用設定。商品的價格。

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

string

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

string (int64 format)

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

integer

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

{
  "description": string
}

string

請說出地點說明，任何人都無法編輯。

{
  "parentChain": string
}

string

這個位置所屬鏈結的資源名稱。How to find Chain ID

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

string

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

object (TimePeriod)

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