Package google.mybusiness.v4

上次對這個位置執行比對演算法的時間。

FollowersMetadata

某個地點的追蹤者中繼資料。

欄位

name

string

此 <帳戶>/{account_id}/locations/{location_id}/followers/metadata 的資源名稱

count

uint64

該地點的追蹤者總數。

FoodMenu

供應餐點的商家菜單。

欄位
`labels[]`	`MenuLabel` 必要欄位。選單的語言標記標籤。例如「菜單」、「午餐特餐」。顯示名稱的長度不得超過 140 個半形字元，說明不得超過 1,000 個半形字元。至少須指定一組標籤。
`source_url`	`string` 選用設定。有要前往的選單來源網址。
`sections[]`	`FoodMenuSection` 必要欄位。選單的各個部分。
`cuisines[]`	`Cuisine` 選用設定。餐點菜單料理資訊。強烈建議您提供這個欄位。

料理

餐廳的飲食資訊。

列舉
`CUISINE_UNSPECIFIED`	未指定料理
`AMERICAN`	美式餐廳
`ASIAN`	亞洲料理
`BRAZILIAN`	巴西料理
`BREAK_FAST`	早餐
`BRUNCH`	早午餐
`CHICKEN`	雞
`CHINESE`	中式餐點
`FAMILY`	家庭式料理
`FAST_FOOD`	速食
`FRENCH`	法式餐廳
`GREEK`	希臘料理
`GERMAN`	德國料理
`HAMBURGER`	漢堡
`INDIAN`	印度餐廳
`INDONESIAN`	印尼料理
`ITALIAN`	義式餐廳
`JAPANESE`	日式餐廳
`KOREAN`	韓式餐廳
`LATIN_AMERICAN`	拉丁美洲餐廳
`MEDITERRANEAN`	地中海料理
`MEXICAN`	墨西哥餐廳
`PAKISTANI`	巴基斯坦料理
`PIZZA`	披薩
`SEAFOOD`	海鮮
`SPANISH`	西班牙料理
`SUSHI`	壽司
`THAI`	泰式料理
`TURKISH`	土耳其料理
`VEGETARIAN`	素食料理
`VIETNAMESE`	越南料理
`OTHER_CUISINE`	其他美食

FoodMenuItem

章節項目。這可以是料理本身，也可以包含多個 FoodMenuItemOption。

欄位

labels[]

MenuLabel

必要欄位。這個選單項目的語言標記標籤。顯示名稱的長度不得超過 140 個半形字元，說明不得超過 1,000 個半形字元。至少須指定一組標籤。

attributes

FoodMenuItemAttributes

必要欄位。商品的詳細屬性。指定商品選項後，系統會將其視為基本屬性，並填入各個選項。

options[]

FoodMenuItemOption

選用設定。這個選項適用於提供多個不同選項的商品，使用者必須做出選擇。例如「一般」和「大」披薩。指定選項後，項目層級的標籤和屬性會自動成為第一個選項的標籤和屬性。客戶只需要在此欄位中指定其他食物選項。

FoodMenuItemAttributes

食品/甜點的屬性。

欄位
`price`	`Money` 必要欄位。食物的價格。
`spiciness`	`Spiciness` 選用設定。食物的辣度水平。
`allergen[]`	`Allergen` 選用設定。與食物相關的過敏原。強烈建議您提供這個欄位。
`dietary_restriction[]`	`DietaryRestriction` 選用設定。食物的飲食資訊。強烈建議您提供這個欄位。
`nutrition_facts`	`NutritionFacts` 選用設定。食物選項的營養資訊。強烈建議您提供這個欄位。
`ingredients[]`	`Ingredient` 選用設定。餐點選擇的食材。
`serves_num_people`	`int32` 選用設定。這個餐點選項可供應人數。
`preparation_methods[]`	`PreparationMethod` 選用設定。餐點選項準備方法。
`portion_size`	`PortionSize` 選用設定。訂單大小，以商品單位表示。(例如 4 個「肉串」、6 件「罐子」)
`media_keys[]`	`string` 選用設定。菜餚相關媒體的媒體鍵。僅支援相片媒體，如果有多個相關相片，系統會將第一張相片視為首選相片。

name

string

要產生帳戶號碼的帳戶名稱。

GetAccountRequest

Account.GetAccount 的要求訊息。

欄位

name

string

要擷取的帳戶名稱。

GetChainRequest

Locations.GetChain 要求訊息。

欄位

name

string

鏈結的資源名稱，格式為 chains/{chain_place_id}。

GetCustomerMediaItemRequest

Media.GetCustomerMediaItem 的要求訊息。

欄位

name

Google 更新的欄位。

HealthProviderAttributes

與這個位置連結的醫療提供者屬性。

欄位

name

string

必要欄位。這個地點的 Google ID，格式為：accounts/{account_id}/locations/{location_id}/healthProviderAttributes

insurance_networks[]

InsuranceNetwork

選用設定。當地接種保險網絡清單。

InsuranceNetwork

單一保險網絡。下一個 ID：5

欄位
`network_id`	`string` 必要欄位。Google 產生的這個保險網絡 ID。
`network_names`	`map<string, string>` 僅供輸出。以要求語言呈現的網路顯示名稱對應，語言為鍵，本地化顯示名稱為值。系統預設會設定英文的顯示名稱。
`payer_names`	`map<string, string>` 僅供輸出。付款人顯示名稱對應 (以要求語言表示)，語言為金鑰，本地化顯示名稱為值。系統預設會設定英文的顯示名稱。
`state`	`NetworkState` 僅供輸出。這個保險網的州別。

InternalError

內部故障說明。

欄位

error_details[]

ErrorDetail

針對個別失敗情況提供詳細資料。

邀請

僅供輸出。代表待回覆的邀請。

欄位
`name`	`string` 邀請的資源名稱。
`role`	`AdminRole` 帳戶中受邀的角色。
聯集欄位 `target`。表示這項邀請的目標對象。`target` 只能是下列其中一項：
`target_account`	`Account` 這封邀請的填入帳戶都含有使用者。
`target_location`	`TargetLocation` 這項邀請的目標地區。

TargetLocation

代表待回覆邀請的指定地區。

欄位

location_name

string

受邀使用者的位置名稱。

location_address

string

使用者受邀地點的地址。

ListAccountAdminsRequest

AccessControl.ListAccountAdmins 的要求訊息。

欄位

parent

string

要從哪個帳戶名稱擷取管理員名單。

ListAccountAdminsResponse

AccessControl.ListAccountAdmins 的回應訊息。

欄位

admins[]

Admin 執行個體的集合。

ListAccountsRequest

要求關於 accounts.ListAccounts 的訊息。

欄位
`page_size`	`int32` 每頁要擷取的帳戶數量。預設值為 20，下限為 2，頁面大小上限為 20。
`page_token`	`string` 指定後，系統會擷取帳戶的下一頁。如果呼叫 `accounts.list` 傳回的結果超過要求的頁面大小，就會傳回 `pageToken`。
`name`	`string` 要擷取直接存取帳戶清單的帳戶資源名稱。這個方式僅適用於「機構」和「使用者群組」。如果空白，系統會為已驗證使用者傳回 `ListAccounts`。
`filter`	`string` 篩選器會限制要傳回的帳戶。回應只會包含符合篩選條件的項目。如果 `filter` 空白，系統就不會套用任何限制條件，且會為要求的帳戶擷取所有帳戶 (分頁)。舉例來說，含有 `type=USER_GROUP` 篩選器的要求只會傳回使用者群組。

ListAccountsResponse

Account.ListAccounts 的回應訊息。

欄位

accounts[]

Account

使用者有權存取的帳戶集合。除非已篩除，否則執行查詢者的個人帳戶一律是搜尋結果的第一個項目。

next_page_token

string

如果帳戶數量超過請求的頁面大小，系統會在這個欄位填入權杖，以便在後續呼叫 accounts.list 時擷取下一個帳戶。如果沒有更多帳戶，回應中就不會出現這個欄位。

ListAnswersRequest

AskAndAnswers.ListAnswers 的要求訊息

欄位
`parent`	`string` 要擷取答案的問題名稱。
`page_size`	`int32` 每頁要擷取的答案數。`page_size` 的預設值和最大值為 10。
`page_token`	`string` 如果有指定，系統會擷取下一頁的答案。
`order_by`	`string` 傳回答案的順序。有效選項包括「update_time desc」和「up votes_count desc」，這會傳回依要求欄位遞減排序的答案。預設的排序順序為「update_time desc」。

ListAnswersResponse

FAQAndAnswers.ListAnswers 的回應訊息

欄位

answers[]

Answer

請求的答案。

total_size

int32

這個問題在所有網頁中張貼的答案總數。

next_page_token

string

如果答案數量超過要求的頁面大小上限，系統會在這個欄位填入一個符記，以便在後續呼叫時擷取下一頁的答案。如果沒有其他答案，回應中就不會顯示這個欄位。

ListAttributeMetadataRequest

Locations.ListAttributeMetadata 的要求訊息。如果提供位置資源名稱，系統就會使用該位置填入其餘條件。如果沒有，則應提供類別和國家/地區。

欄位
`name`	`string` 用來查詢可用屬性的位置資源名稱。
`category_id`	`string` 主要類別固定 ID 來尋找可用的屬性。
`country`	`string` 使用 ISO 3166-1 alpha-2 國家/地區代碼來尋找可用屬性。
`language_code`	`string` 要取得屬性顯示名稱的 BCP 47 語言代碼。如果沒有這個語言，系統將以英文提供。
`page_size`	`int32` 每頁應包含的屬性數量。預設值為 200，最小值為 1。
`page_token`	`string` 指定時，系統會擷取屬性中繼資料的下一頁。如果呼叫 `attributes.list` 傳回的結果超過要求的頁面大小，就會傳回 `pageToken`。

ListAttributeMetadataResponse

Locations.ListAttributeMetadata。

欄位

attributes[]

AttributeMetadata

可用屬性的一組屬性中繼資料。

next_page_token

string

如果屬性數量超過要求的頁面大小，系統會在這個欄位填入一個符記，以便在後續呼叫 attributes.list 時擷取下一頁的屬性。如果沒有其他屬性，回應中就不會顯示這個欄位。

ListBusinessCategoriesRequest

欄位
`region_code`	`string` ISO 3166-1 alpha-2 國家/地區代碼。
`language_code`	`string` BCP 47 語言代碼。如果沒有支援的語言，則預設為英文。
`search_term`	`string` 使用者的選用篩選器字串。
`page_size`	`int32` 每頁要擷取的類別數量。預設值為 100，下限為 1，頁面大小上限為 100。
`page_token`	`string` 如果有指定，系統會擷取下一頁的類別。
`view`	`CategoryView` 選用設定。指定要在回應中傳回 Category 資源的哪些部分。

InsuranceNetworkService.ListInsuranceNetworks 的要求訊息

欄位
`parent`	`string` 必要欄位。要列出保險網絡的地區名稱。名稱的格式為：accounts/{account_id}/locations/{location_id}
`language_code`	`string` 選用設定。語言的 BCP 47 代碼。如未提供語言代碼，則預設為英文。目前僅支援「en」。
`page_size`	`int32` 每頁要傳回的保險網絡。預設值為 5,000。頁面大小上限為 10000。
`page_token`	`string` 若指定，系統會傳回保險網的下一頁。

ListInsuranceNetworksResponse

InsuranceNetworkService.ListInsuranceNetworks 的回應訊息

欄位

networks[]

InsuranceNetwork

Google 支援的保險網絡清單。

next_page_token

string

如果保險網路數量超過要求的網頁大小，系統會在這個欄位填入代碼，以便在後續呼叫 ListInsuranceNetworks 時擷取保險網的下一頁。

ListInvitationsRequest

AccessControl.List 邀請 s 的要求訊息。

欄位

parent

string

要擷取邀請清單的帳戶名稱。

target_type

TargetType

指定要在回應中顯示的目標類型。

TargetType

邀請適用的目標類型。

列舉
`ALL`	列出所有目標類型的邀請。此為預設值。
`ACCOUNTS_ONLY`	僅列出帳戶類型的邀請。
`LOCATIONS_ONLY`	僅列出「地區」類型的邀請。

ListInvitationsResponse

AccessControl.List 邀請 s 的回應訊息。

欄位

invitations[]

Invitation

帳戶中待處理的地點邀請。這裡列出的邀請數不得超過 1000。

ListLocalPostsRequest

ListLocalPosts 的要求訊息

欄位

parent

string

要列出當地貼文的地區名稱。

page_size

int32

每頁要傳回的當地貼文數量。預設值為 20。頁面大小下限為 1，檔案大小上限為 100。

page_token

string

若指定，系統會傳回當地貼文的下一頁。

ListLocalPostsResponse

ListLocalPosts 的回應訊息

欄位

local_posts[]

LocalPost

傳回的當地貼文清單。

next_page_token

string

如果當地貼文數量超過要求的頁面大小，系統會在這個欄位填入權杖，並在後續呼叫 ListLocalPosts 時擷取當地貼文的下一頁。

ListLocationAdminsRequest

要求 AccessControl.ListLocationAdmins 的訊息。

欄位

parent

string

要列出管理員的地點名稱。

ListLocationAdminsResponse

AccessControl.ListLocationAdmins 的回應訊息。

欄位

admins[]

LocationDrivingDirectionMetrics

Admin 執行個體的集合。

ListLocationsRequest

Locations.ListLocations 的要求訊息。

欄位
`parent`	`string` 要擷取營業地點的帳戶名稱。如果 `Account` 屬於 `AccountType` 個人，則系統只會傳回該帳戶直接擁有的地點，否則會傳回該帳戶的所有可存取位置資訊 (無論是直接或間接傳回)。
`page_size`	`int32` 每頁要擷取的位置數量。預設值為 100，下限為 1，頁面大小上限為 100。
`page_token`	`string` 若指定，函式會擷取接下來 `page` 的位置。當位置超過要求的頁面大小時，呼叫 `ListLocations` 會傳回網頁權杖。
`filter`	`string` 篩選器會限制要傳回的地點。回應只會包含符合篩選條件的項目。如果 `filter` 空白，系統會套用限制條件，為要求的帳戶擷取所有位置 (分頁)。如要進一步瞭解有效的欄位和使用方式範例，請參閱使用位置資料指南。
`language_code (deprecated)`	`string` 這個項目現已淘汰！要取得顯示位置資源的 BCP 47 語言。如果 Google 助理不支援該語言，系統將以當地語言提供。如果兩者皆無法使用，將會以英文提供。已淘汰，2020 年 8 月 15 日過後，這個欄位將不再套用。而是一律使用地點的語言。
`order_by`	`string` 要求的排序順序。下列 SQL 語法應以半形逗號分隔多個欄位。預設的排序順序是遞增。如要指定遞減順序，請加入後置字元「 desc」。order_by 的有效欄位為 location_name 和 store_code。例如：「location_name、store_code desc」、「location_name」或「store_code desc」

ListLocationsResponse

Locations.ListLocations 的回應訊息。

欄位

locations[]

Location

地點。

next_page_token

string

如果地點數量超過要求的頁面大小，系統會在這個欄位填入權杖，以便在後續呼叫 ListLocations 時擷取下一頁的位置。如果沒有其他地點，回應中就不會顯示這個欄位。

total_size

int32

清單中位置的約略數量，與分頁無關。

ListMediaItemsRequest

Media.ListMediaItems 的要求訊息。

欄位

parent

string

要列出媒體項目的位置名稱。

page_size

int32

每頁要傳回的媒體項目數量。預設值為 100，這也是可透過 Google My Business API 新增至某個地點的媒體項目數量上限。頁面大小上限為 2500。

page_token

string

如有指定，系統會傳回媒體項目的下一頁。

ListMediaItemsResponse

Media.ListMediaItems 的回應訊息。

欄位

media_items[]

MediaItem

傳回的媒體項目清單。

total_media_item_count

int32

這個位置的媒體項目總數 (與分頁無關)。

next_page_token

string

如果媒體項目數量超過要求的頁面大小，系統會在這個欄位填入符記，以便在後續呼叫 ListMediaItems 時擷取媒體項目的下一頁。

ListQuestionsRequest

AskAndAnswers.ListQuestions 的要求訊息

欄位
`parent`	`string` 要擷取問題的地點名稱。
`page_size`	`int32` 每頁要擷取的問題數量。`page_size` 的預設值和最大值為 10。
`page_token`	`string` 如果有指定，系統會擷取下一頁的問題。
`answers_per_question`	`int32` 每個問題要擷取的答案數量。`answers_per_question` 的預設值和最大值為 10。
`filter`	`string` 篩選器會限制要傳回的問題。目前唯一支援的篩選器是「ignore_answered=true」
`order_by`	`string` 傳回問題的訂單。有效選項包括「update_time desc」和「uperation_count desc」，這會傳回依要求欄位遞減排序的問題。預設的排序順序為「update_time desc」。

ListQuestionsResponse

FAQAndAnswers.ListQuestions 的回應訊息

欄位

questions[]

Question

請求的問題

total_size

int32

這個地點在所有網頁上張貼的問題總數。

next_page_token

string

如果問題數量超過要求的頁面大小上限，系統會在這個欄位填入一個符記，以便在後續呼叫時擷取下一頁的問題。如果沒有其他問題，回覆中就不會顯示這個欄位。

ListRecommendedGoogleLocationsRequest

要求訊息，列出商家檔案帳戶的建議地點。

欄位

name

string

要擷取建議的 Google 位置的帳戶資源名稱。

page_size

int32

每頁要擷取的位置數量。預設值為 25，下限為 1，頁面大小上限為 100。

page_token

string

如果指定，系統會擷取下一頁的位置。

ListRecommendedGoogleLocationsResponse

GoogleLocations.ListRecommendedGoogleLocations 的回應訊息。

也包含自上次系統向這個商家檔案帳戶建議後，其他商家檔案使用者聲明擁有權的地點。

欄位

google_locations[]

GoogleLocation

建議商家檔案帳戶的地點。每個項目都代表 Google 地圖上顯示的 GoogleLocation。地點會按照與商家檔案帳戶的關聯性遞減排序。

total_size

int32

這個商家檔案帳戶的建議地點總數 (不受分頁影響)。

next_page_token

string

在分頁期間，如果下一頁中還有更多可擷取的位置，系統會在此欄位填入一個符記，以便在後續呼叫中擷取下一頁的位置。如果沒有其他可擷取的地點，回應中就不會出現這個欄位。

ListReviewsRequest

Review.ListReviews 要求訊息。

欄位
`parent`	`string` 要擷取評論的地點名稱。
`page_size`	`int32` 每網頁要擷取的評論數量。`page_size` 上限為 50。
`page_token`	`string` 如果有指定，系統會擷取下一頁的評論。
`order_by`	`string` 指定要做為評論排序依據的欄位。如未指定，傳回的評論順序會預設為 `update_time desc`。要排序的有效訂單為 `rating`、`rating desc` 和 `update_time desc`。

ListReviewsResponse

Review.ListReviews 的回應訊息。

欄位
`reviews[]`	`Review` 評論。
`average_rating`	`double` 此地點所有評論的平均星級評等 (以 1 到 5 分表示，5 代表最高評分)。
`total_review_count`	`int32` 這個地點的評論總數。
`next_page_token`	`string` 如果評論數超過要求的頁面大小，系統會在這個欄位填入一個符記，以便在後續呼叫 ListReview 時擷取下一頁的評論。如果沒有任何評論，回應中就不會顯示這個欄位。

ListVerificationsRequest

要求有關 Verifications.ListVerifications 的訊息。

欄位

parent

string

驗證要求所屬位置的資源名稱。

page_size

int32

每網頁包含的驗證數量上限。如未設定，請全部傳回。

page_token

string

如果有指定，系統會傳回下一頁驗證。

ListVerificationsResponse

Verifications.ListVerifications 的回應訊息。

欄位

verifications[]

Verification

驗證清單。

next_page_token

string

如果驗證次數超過要求的頁面大小，系統會在這個欄位填入一個符記，以擷取後續呼叫的下一頁驗證。如果沒有其他屬性，回應中就不會顯示這個欄位。

LocalPost

代表地區的當地貼文。

欄位
`name`	`string` 僅供輸出。這則當地貼文的 Google ID，格式為：`accounts/{account_id}/locations/{location_id}/localPosts/{local_post_id}`
`language_code`	`string` 當地貼文的語言。
`summary`	`string` 當地貼文的說明/內文。
`call_to_action`	`CallToAction` 使用者點按促銷活動後會前往的網址。系統會忽略「`OFFER`」主題類型。
`create_time`	`Timestamp` 僅供輸出。建立貼文的時間。
`update_time`	`Timestamp` 僅供輸出。使用者上次修改貼文的時間。
`event`	`LocalPostEvent` 活動資訊。主題類型 `EVENT` 和 `OFFER` 必填。
`state`	`LocalPostState` 僅供輸出。貼文的狀態，指出貼文生命週期的哪個部分。
`media[]`	`MediaItem` 與 post 相關聯的媒體。source_url 是 LocalPost MediaItem 唯一支援的資料欄位。
`search_url`	`string` 僅供輸出。Google 搜尋中的當地貼文連結。這個連結可用於透過社群媒體、電子郵件、簡訊等管道分享貼文。
`topic_type`	`LocalPostTopicType` 必要欄位。貼文的主題類型：標準、活動、優惠或快訊。
`alert_type`	`AlertType` 要建立貼文的快訊類型。這個欄位僅適用於「topic_type 快訊」貼文，其運作方式屬於「快訊」的子類型。
`offer`	`LocalPostOffer` 優惠貼文的其他資料。只有在 topic_type 為 OFFER 時，才需要設定這個屬性。

LocalPostState

表示發布內容的狀態

列舉
`LOCAL_POST_STATE_UNSPECIFIED`	未指定州。
`REJECTED`	這則貼文因違反內容政策而遭到拒絕。
`LIVE`	這則貼文已發布，且目前會顯示在搜尋結果中。
`PROCESSING`	系統正在處理這則貼文，因此不會在搜尋結果中顯示。

LocalPostEvent

與當地貼文相關活動的所有資訊。

欄位

title

string

事件的名稱。

schedule

TimeInterval

活動的開始和結束日期/時間。

LocalPostMetrics

針對當地貼文要求的所有指標，

欄位

local_post_name

string

metric_values[]

MetricValue

要求指標的值清單。

LocalPostOffer

優惠貼文的特定欄位。

欄位

coupon_code

string

選用設定。可在店面或線上提供的優惠代碼。

redeem_online_url

string

選用設定。線上兌換連結。

terms_conditions

string

選用設定。優惠條款及細則。

LocalPostTopicType

當地貼文的主題類型，用於選取建立並轉譯貼文的不同範本。

列舉
`LOCAL_POST_TOPIC_TYPE_UNSPECIFIED`	未指定文章類型。
`STANDARD`	貼文包含摘要和圖片等基本資訊。
`EVENT`	貼文包含基本資訊和活動。
`OFFER`	貼文包含基本資訊、活動和優惠相關內容 (例如優待券代碼)
`ALERT`	與進行中活動相關的高優先順序且及時公告。這類貼文並非一律開放編輯。

位置

地點。如需這些欄位的詳細說明，請參閱說明中心文章；如需有效業務類別清單，請參閱類別端點。

欄位
`name`	`string` 這個地點的 Google ID，格式為：`accounts/{account_id}/locations/{location_id}` 比對內容時，這個欄位不會填入。
`language_code`	`string` 地點使用的語言。請在建立期間設定，且無法更新。
`store_code`	`string` 這個位置的外部 ID，在單一帳戶中不得重複。藉此將該地點與您自己的記錄建立關聯。
`location_name`	`string` 位置名稱必須如實反映商家的實際名稱，且與店面、網站和文具一致，客戶所知的名稱必須一致。您可將相關資訊加入資源的其他欄位 (例如 `Address`、`Categories`)。請勿在名稱中加入不必要的資訊，例如使用「Google」而非「Google Inc. - 山景城公司總部」。請勿加入行銷標語、商店代碼、特殊字元、營業時間或營業中/營業中狀態、電話號碼、網站網址、服務/產品資訊、地點/地址或路線，或是防裝資訊 (例如「杜恩大安森林公園」)。
`primary_phone`	`string` 盡量直接與個別商家地點聯絡的電話號碼。請提供本地電話號碼，避免使用客服中心的客服專線號碼。
`additional_phones[]`	`string` 除了主要電話號碼外，貴商家最多還可以登錄兩組電話號碼 (僅限手機或市話，不接受傳真)。
`address`	`PostalAddress` 請提供精確、精確的地址，用來說明您的商家所在地點。我們不接受位於偏遠地區的郵政信箱或信箱。目前，您最多可以在地址中指定五個 `address_lines` 值。
`primary_category`	`Category` 與這個地點所屬核心商家最相符的類別。
`additional_categories[]`	`Category` 其他用來描述您商家的類別。類別可協助客戶準確找到感興趣的服務。為確保商家資訊正確且上線，請盡量減少描述整體核心業務的類別。盡可能選用足以代表您主要業務的精確類別。
`website_url`	`string` 此商家的網址。如果可以，請使用能代表這個個別商家所在地點的網址，而非代表所有地點或品牌的一般網站/網址。
`regular_hours`	`BusinessHours` 商家的營業時間。
`special_hours`	`SpecialHours` 商家的特殊營業時間。通常包括假日營業時間及一般營業時間以外的其他時間。會覆寫一般營業時間。
`service_area`	`ServiceAreaBusiness` 服務範圍商家在客戶的所在地提供服務。如果這個商家是區域服務商家，這個欄位會說明商家提供的區域。
`location_key`	`LocationKey` 可將這個商家連結到其他 Google 資源 (例如 Google+ 專頁和 Google 地圖地點) 的一組金鑰。
`labels[]`	`string` 一組任意形式的字串，讓您可以標記商家。這些標籤「不會」向使用者顯示，只有您自己看得到。每個標籤的長度不得超過 255 個字元。
`ad_words_location_extensions`	`AdWordsLocationExtensions` AdWords 中顯示的額外資訊。
`latlng`	`LatLng` 使用者提供的經緯度。建立位置時，如果提供的地址地理編碼成功，系統就會忽略這個欄位。只有在建立期間接受使用者提供 `latlng` 值，或透過商家檔案網站更新 `latlng` 值時，get 要求才會傳回這個欄位。無法更新這個欄位。
`open_info`	`OpenInfo` 表示地點目前是否營業中的標記。
`location_state`	`LocationState` 僅供輸出。代表位置狀態的一組布林值。
`attributes[]`	`Attribute` 此位置的屬性。
`metadata`	`Metadata` 僅供輸出。其他不開放使用者編輯的資訊。
`price_lists[] (deprecated)`	`PriceList` 透過這個欄位編輯的服務內容可能會有所延遲。請改為參閱 Business Information API 第 1 版。已淘汰：這個地區的價格清單資訊。
`profile`	`Profile` 用自己的方式介紹商家，並向使用者介紹商家和產品的獨特故事。
`relationship_data`	`RelationshipData` 與這個地點相關的所有地點和連鎖店。
`more_hours[]`	`MoreHours` 其他部門或特定客戶的詳細營業時間。

Metadata

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

欄位

duplicate
(deprecated)

Duplicate

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

maps_url

string

地點在 Google 地圖上的連結。

new_review_url

string

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

Duplicate

與這個地點重複的地點相關資訊。

欄位

location_name

string

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

place_id

string

重複地點的地點 ID。

access

Access

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

存取權

使用者對重複位置的存取層級。這會取代擁有權，建議改用。

列舉
`ACCESS_UNSPECIFIED`	未指定。
`ACCESS_UNKNOWN`	無法判斷使用者是否能存取重複的位置。
`ALLOWED`	使用者可以存取副本的位置。
`INSUFFICIENT`	使用者無法存取重複的位置。

RelationshipData

與此地點相關的所有家長和兒童地點資訊。

欄位

parent_chain

string

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

LocationDrivingDirectionMetrics

將使用者通常來自哪些地區編入索引。系統會計算各個區域前往這個地點的行車路線要求數量，藉此擷取這項資料。

欄位

location_name

string

這個指標值所屬的位置資源名稱。

top_direction_sources[]

TopDirectionSources

按來源區域劃分的行車路線要求。按照慣例，這些結果是按數量排序，最多為 10 筆結果。

time_zone

string

地點的時區 (IANA 時區 ID，例如「歐洲/倫敦」)。

TopDirectionSources

駕駛路線要求來源最高的區域。

欄位

day_count

int32

資料匯總的天數。

region_counts[]

RegionCount

按數量遞減排序的區域。

RegionCount

與相關要求數量相關聯的區域。

欄位

latlng

LatLng

區域中心。

label

string

使用者可理解的區域標籤。

count

int64

來自這個區域的駕駛路線要求數量。

LocationKey

位置的替代/代理鍵參照。

欄位
`plus_page_id`	`string` 僅供輸出。如果這個地點有相關聯的 Google+ 專頁，系統就會填入這個地點的 Google+ 專頁 ID。
`place_id`	`string` 如果這個地點已經通過驗證，且該位置已連結至 Google 地圖上/出現在 Google 地圖上，這個欄位就會填入該位置的地點 ID。這個 ID 可用於多種 Places API。如果這個地點未經驗證，如果地點已與 Google 地圖上顯示的地點相關聯，這個欄位就會填入資料。您可以在 Create 呼叫期間設定此欄位，但無法在 Update 中設定。額外的 `explicit_no_place_id` 布林值代表是否刻意設定不設定的地點 ID。
`explicit_no_place_id`	`bool` 僅供輸出。如果值為 true，代表這是刻意設定的地點 ID，與尚未建立任何關聯。
`request_id`	`string` 僅供輸出。用來建立這個位置的 `request_id`。如果這個地點不是在 Google My Business API 或商家檔案位置中建立的，則可能會留空。

LocationMetrics

這是指在某個時間範圍內，與地點相關的一系列指標和 BreakdownMetrics。

欄位

location_name

string

這些值所屬的位置資源名稱。

time_zone

string

地點的 IANA 時區。

metric_values[]

MetricValue

要求指標的值清單。

LocationReview

代表評論與位置資訊。

欄位

name

string

位置資源名稱。

review

Review

地點評論。

LocationState

包含一組反映位置狀態的布林值。

欄位
`is_google_updated`	`bool` 僅供輸出。指出與這個地點相關聯的地點 ID 是否有更新資料。
`is_duplicate`	`bool` 僅供輸出。指出該地點是否與其他地點重複。
`is_suspended`	`bool` 僅供輸出。指出該地點是否遭停權。使用者無法在 Google 產品中看到已停權的地點。如果你認為這是誤判，請參閱說明中心文章。
`can_update`	`bool` 僅供輸出。用於指出地點是否可更新。
`can_delete`	`bool` 僅供輸出。指出能否使用 Google My Business API 刪除地點。
`is_verified`	`bool` 僅供輸出。表示地點是否已通過驗證。
`needs_reverification`	`bool` 僅供輸出。指出該地點是否需要重新驗證。
`is_pending_review`	`bool` 僅供輸出。指出該地點是否正在等待審核。
`is_disabled`	`bool` 僅供輸出。用於指出地點是否已停用。
`is_published`	`bool` 僅供輸出。指出地點是否已發布。
`is_disconnected`	`bool` 僅供輸出。指出該地點是否與 Google 地圖上的某個地點中斷連線。
`is_local_post_api_disabled`	`bool` 僅供輸出。指出這個位置的 accounts.locations.localPosts 是否已停用。
`can_modify_service_list`	`bool` 僅供輸出。指出清單是否可修改 ServiceList。
`can_have_food_menus`	`bool` 僅供輸出。說明商家資訊是否適用於食物選單。
`has_pending_edits`	`bool` 僅供輸出。指出這個地點的任何房源是否處於編輯待處理狀態。
`has_pending_verification`	`bool` 僅供輸出。表示該地點是否有待處理的驗證要求。
`can_operate_health_data`	`bool` 僅供輸出。指出該位置是否能對健康資料執行操作。
`can_operate_lodging_data`	`bool` 僅供輸出。指出地點是否能在住宿資料上運作。

MatchedLocation

代表可能與位置相符的結果。

欄位

location

Location

幾乎已填入的位置，可做為可能的比對結果。未填入的欄位包括但不限於：名稱 (比對位置無法透過 GetLocation 和 BatchGetLocations 擷取)；store_code；service_area 涵蓋範圍詳細資料；labels；ad_words_location_extensions；photos

is_exact_match

bool

這是完全相符的結果嗎？

MediaItem

單一媒體項目。

欄位
`name`	`string` 此媒體項目的資源名稱。`accounts/{account_id}/locations/{location_id}/media/{media_key}`
`media_format`	`MediaFormat` 此媒體項目的格式。媒體項目建立時必須設定，而且在其他要求中皆為唯讀。設定完成後即無法更新。
`location_association`	`LocationAssociation` 呼叫 `CreatePhoto` 時必須提供。說明這個媒體項目如何連結至其位置。必須是類別 (例如 EXTERIOR) 或價格清單項目的 ID。透過 `CreateMediaItem` 將媒體新增到地點時，此為必要條件。如果是其他類型的媒體 (例如當地貼文中的相片)，系統則不會顯示這類內容。
`google_url`	`string` 僅供輸出。此媒體項目的 Google 代管網址。這個網址可能會隨時間變動，因此不是靜態網址。影片會顯示重疊的播放圖示的預覽圖片。
`thumbnail_url`	`string` 僅供輸出。此媒體項目的縮圖網址 (如有提供)。
`create_time`	`Timestamp` 僅供輸出。這個媒體項目的建立時間。
`dimensions`	`Dimensions` 僅供輸出。尺寸 (寬度和高度)，以像素為單位。
`insights`	`MediaInsights` 僅供輸出。這個媒體項目的統計資料。
`attribution`	`Attribution` 僅供輸出。客戶媒體項目的歸因資訊。您必須向使用者顯示這個作者資訊，且不得刪除或修改出處。
`description`	`string` 這個媒體項目的說明。說明無法透過 Google My Business API 修改，但可在建立不是封面相片的媒體項目時設定。
聯集欄位 `data`。媒體項目的資料來源。建立新的媒體項目時，必須提供網址或資料參照。除了 `PROFILE` 和 `COVER` 類別以外，所有相片的短邊都必須至少測量出 250 像素，且檔案大小至少為 10240 個位元組。所有上傳的相片都必須符合商家檔案相片規範。`data` 只能是下列其中一項：
`source_url`	`string` 可從公開存取的網址擷取媒體項目。建立這個項目或 data_ref 時，必須設為指定媒體項目的來源。如果在建立媒體項目時使用 `source_url`，系統就會在擷取媒體項目時填入該來源網址。無法更新這個欄位。
`data_ref`	`MediaItemDataRef` 僅限輸入。透過 `StartUploadMediaItemData` 方法取得的媒體項目二進位資料的參照。建立媒體項目時 `sourceUrl` 或 `dataRef` 都必須設定。

歸因

客戶媒體項目的作者資訊，例如貢獻者的名稱和個人資料相片。

欄位
`profile_name`	`string` 要做為媒體項目歸因的使用者名稱。
`profile_photo_url`	`string` 來源使用者個人資料相片縮圖的網址。
`takedown_url`	`string` 下架頁面的網址，當中可以檢舉不當的媒體項目。
`profile_url`	`string` 歸因使用者的 Google 地圖個人資料網頁網址。

尺寸

媒體項目的尺寸。

欄位

width_pixels

int32

媒體項目的寬度，以像素為單位。

height_pixels

int32

媒體項目的高度，以像素為單位。

LocationAssociation

媒體項目與位置的關聯方式。

欄位

聯集欄位 location_attachment_type。位置媒體必須包含相關聯的價格清單項目類別或 ID。非地點媒體 (例如當地貼文相片) 不得未提供任何資訊。location_attachment_type 只能是下列其中一項：

category

Category

這張相片所屬的類別。

price_list_item_id

string

與這張地點相片相關聯的價格清單項目 ID。

類別

媒體項目類別列舉。

列舉
`CATEGORY_UNSPECIFIED`	未指定的類別。
`COVER`	封面相片。一個地點只有一張封面相片。
`PROFILE`	個人資料相片。一個地點只有一張個人資料相片。
`LOGO`	標誌相片。
`EXTERIOR`	外部媒體。
`INTERIOR`	室內媒體。
`PRODUCT`	產品媒體。
`AT_WORK`	「工作」媒體。
`FOOD_AND_DRINK`	飲食媒體。
`MENU`	選單媒體。
`COMMON_AREA`	公共區域媒體。
`ROOMS`	聊天室媒體。
`TEAMS`	團隊媒體。
`ADDITIONAL`	其他未分類的媒體。

MediaFormat

媒體格式的列舉，

列舉
`MEDIA_FORMAT_UNSPECIFIED`	未指定格式。
`PHOTO`	媒體項目是相片。這個版本僅支援相片。
`VIDEO`	媒體項目是影片。

MediaInsights

媒體項目的深入分析和統計資料。

欄位

view_count

int64

僅供輸出。媒體項目的瀏覽次數。

MediaItemDataRef

參照透過 Google My Business API 上傳的 MediaItem 的相片二進位資料。

使用 StartUploadMediaItemData 建立資料參照，並在將位元組上傳到 [UpdateMedia] 後，接著呼叫 CreateMediaItem 時使用這項參照。

欄位

resource_name

string

這個媒體項目二進位資料的專屬 ID。用於使用 [UpdateMedia] 上傳相片資料，以及用 CreateMediaItem 從這些位元組建立新的媒體項目。

上傳位元組的範例：curl -X POST -T{path_to_file} "http://mybusiness.googleapis.com/upload/v1/media/{resource_name}?upload_type=media"

針對 CreateMediaItem 呼叫，請將此值設為 MediaItem data_ref。

MenuLabel

顯示選單及其各種子元件時使用的標籤。

欄位

display_name

string

必要欄位。元件的顯示名稱。

description

string

選用設定。元件的補充資訊。

language_code

string

選用設定。BCP 47 語言代碼。如果沒有支援的語言，則預設為英文。

指標

資源相關資料的指標。

列舉
`METRIC_UNSPECIFIED`	未指定指標。
`ALL`	要求所有可用指標的簡要說明。「全部」納入的指標，會因要求深入分析的資源而異。
`QUERIES_DIRECT`	直接搜尋位置時，資源顯示的次數。
`QUERIES_INDIRECT`	資源因類別搜尋 (例如餐廳) 而顯示的次數。
`QUERIES_CHAIN`	資源因所屬連鎖店或販售的品牌進行搜尋而獲得的次數。例如星巴克, 愛迪達。這是 QUERIES_INDIRECT 的子集。
`VIEWS_MAPS`	資源在 Google 地圖上獲得觀看的次數。
`VIEWS_SEARCH`	資源在 Google 搜尋上的瀏覽次數。
`ACTIONS_WEBSITE`	網站的點擊次數。
`ACTIONS_PHONE`	電話號碼的點按次數。
`ACTIONS_DRIVING_DIRECTIONS`	查詢行車路線的次數。
`PHOTOS_VIEWS_MERCHANT`	商家上傳的媒體項目觀看次數。
`PHOTOS_VIEWS_CUSTOMERS`	客戶上傳的媒體項目瀏覽次數。
`PHOTOS_COUNT_MERCHANT`	商家目前上線的媒體項目總數。
`PHOTOS_COUNT_CUSTOMERS`	客戶目前已上線的媒體項目總數。
`LOCAL_POST_VIEWS_SEARCH`	當地貼文在 Google 搜尋上獲得的觀看次數。
`LOCAL_POST_ACTIONS_CALL_TO_ACTION`	Google 上行動號召按鈕的點擊次數。

MetricOption

可指定在回應中如何顯示資料的選項。

列舉
`METRIC_OPTION_UNSPECIFIED`	未指定指標選項。要求中將預設為 AGGREGATED_TOTAL。
`AGGREGATED_TOTAL`	傳回整個時間範圍內的匯總值。這是預設值。
`AGGREGATED_DAILY`	傳回跨時間範圍內的每日時間戳記值。
`BREAKDOWN_DAY_OF_WEEK`	傳回的值會按星期幾細分。僅適用於 ACTIONS_PHONE。
`BREAKDOWN_HOUR_OF_DAY`	傳回的值會按一天中的時段細分。僅適用於 ACTIONS_PHONE。

MetricRequest

傳回單一指標值的要求，以及這些值的傳回選項。

欄位

metric

Metric

要求的指標。

options[]

MetricOption

傳回值時應的顯示方式。

MetricValue

從開始時間開始的單一指標值。

欄位

metric

Metric

要套用值的指標。

total_value

DimensionalMetricValue

這項指標的總匯總值。已為 AGGREGATED_TOTAL 選項設定。

dimensional_values[]

DimensionalMetricValue

這項指標的維度值。

MoreHours

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

欄位

hours_type_id

string

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

periods[]

TimePeriod

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

MoreHoursType

商家除了一般營業時間外，還有更多營業時間類型。

欄位

hours_type_id

string

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

display_name

string

僅供輸出。使用者容易理解的營業時間類型英文顯示名稱。

localized_display_name

string

僅供輸出。營業時間類型的本地化顯示名稱。

NetworkState

與這個地點相關的保險網絡狀態。

列舉
`NETWORK_STATE_UNSPECIFIED`	預設值。
`ACCEPTED`	此網路已接受此網路。
`PENDING_ADD`	有一項待處理的要求要將這個聯播網加入已接受清單。
`PENDING_DELETE`	有一項待處理的要求，希望我們將這個聯播網從已接受的清單中移除。
`NOT_ACCEPTED`	此位置不接受此網路。

NotificationType

傳送至 Cloud Pub/Sub 主題的通知類型。

列舉
`NOTIFICATION_TYPE_UNSPECIFIED`	沒有通知類型。不會比對任何通知。
`GOOGLE_UPDATE`	該地點有需要審查的 Google 資訊更新。通知中的 location_name 欄位會顯示 Google 資訊更新的地點資源名稱。
`NEW_REVIEW`	該地點已新增評論。通知中的 review_name 欄位會提供新增評論的資源名稱，而 location_name 會顯示位置的資源名稱。
`UPDATED_REVIEW`	有關該地點的評論已更新。通知中的 review_name 欄位會提供新增評論的資源名稱，而 location_name 會顯示位置的資源名稱。
`NEW_CUSTOMER_MEDIA`	Google 地圖使用者新增了媒體項目。通知將提供新媒體項目的資源名稱。
`NEW_QUESTION`	該地點就會新增一個問題。通知內容會提供問題的資源名稱。
`UPDATED_QUESTION`	地點的問題已更新。通知內容會提供問題的資源名稱。
`NEW_ANSWER`	地點即會新增答案。通知內容會提供問題和答案的資源名稱。
`UPDATED_ANSWER`	地點的答案已更新。通知內容會提供問題和答案的資源名稱。
`UPDATED_LOCATION_STATE`	地點的 LocationState 已更新。「通知」會包含已更新 LocationState 欄位的欄位遮罩。

通知

Google Cloud Pub/Sub 主題，可在位置更新或有新的評論時發布通知。每個帳戶只能有一個通知設定資源。

欄位

name

string

僅供輸出。通知資源名稱。

topic_name

string

Google Cloud Pub/Sub 主題會在這個帳戶管理的地點更新時接收通知。如未設定，系統不會發布任何通知。

mybusiness-api-pubsub@system.gserviceaccount.com 帳戶必須至少具備 Cloud Pub/Sub 主題的「發布」權限。

notification_types[]

NotificationType

會傳送至 Cloud Pub/Sub 主題的通知類型。至少須指定一個值。如要完全停止接收通知，請使用 DeleteNotifications。

NutritionFacts

這則訊息代表食物的營養成分。

欄位
`calories`	`CaloriesFact` 選用設定。菜餚的卡路里。
`total_fat`	`NutritionFact` 選用設定。特定食物的脂肪資訊。
`cholesterol`	`NutritionFact` 選用設定。特定食物的膽固醇資訊。
`sodium`	`NutritionFact` 選用設定。特定食物的鈉資訊。
`total_carbohydrate`	`NutritionFact` 選用設定。特定食物的碳水化合物資訊。
`protein`	`NutritionFact` 選用設定。特定食物的蛋白質資訊。

CaloriesFact

此訊息表示卡路里資訊，使用範圍上限和下限。必須指定較低的金額。下限與上限皆為非負數。

欄位

lower_amount

int32

必要欄位。卡路里較少

upper_amount

int32

選用設定。卡路里上限

unit

EnergyUnit

必要欄位。指定卡路里資訊的單位。

EnergyUnit

可能的食物能量單位 (卡路里)。

列舉
`ENERGY_UNIT_UNSPECIFIED`	未指定能源單位
`CALORIE`	卡路里
`JOULE`	焦耳

MassUnit

可能的質量單位。

列舉
`MASS_UNIT_UNSPECIFIED`	未指定質量單位
`GRAM`	Gram
`MILLIGRAM`	毫克

NutritionFact

此訊息表示營養資訊，包含上限和下限範圍，能以質量單位表示。必須指定較低的金額。下限與上限皆為非負數。

欄位

lower_amount

double

必要欄位。營養量較低

upper_amount

double

選用設定。營養含量上限

unit

MassUnit

必要欄位。特定營養資訊的單位。

OpenInfo

商家營業狀態的相關資訊。

欄位

status

OpenForBusiness

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

can_reopen

bool

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

opening_date

Date

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

OpenForBusiness

表示地點的狀態。

列舉
`OPEN_FOR_BUSINESS_UNSPECIFIED`	未指定。
`OPEN`	表示地點營業中。
`CLOSED_PERMANENTLY`	表示該地點已永久停業。
`CLOSED_TEMPORARILY`	表示該地點已暫停營業。這個值僅適用於已發布的地點 (即 location_state.is_published = true)。將狀態欄位更新為這個值時，用戶端必須明確將 `update_mask` 設為 `open_info.status`。這次更新通話期間無法再設定其他更新遮罩。這項暫時性限制將於近期放寬，不久後就會放寬。

PermissionLevel

指出已驗證使用者對這個帳戶的存取層級。

列舉
`PERMISSION_LEVEL_UNSPECIFIED`	未指定。
`OWNER_LEVEL`	使用者俱備擁有者層級權限。
`MEMBER_LEVEL`	使用者擁有成員層級權限。

PhoneInput

PHONE_CALL/SMS 驗證的輸入內容。

欄位

phone_number

string

應撥打或接收 SMS 的電話號碼。且必須是適用選項中其中一個電話號碼。

PlaceInfo

定義以地點 ID 表示的區域。

欄位

name

string

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

place_id

string

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

地點介面集

用於定義由一組地點代表的區域聯集。

欄位

place_infos[]

PlaceInfo

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

PointRadius

以特定點 (經緯度) 為中心的半徑範圍。

欄位

latlng

LatLng

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

radius_km

float

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

PreparationMethod

食物的製備方式。

列舉
`PREPARATION_METHOD_UNSPECIFIED`	未指定準備方法
`BAKED`	烘焙法
`BARBECUED`	烤肉方法
`BASTED`	烘焙法
`BLANCHED`	傾斜法
`BOILED`	沸化方法
`BRAISED`	宣揚法務
`CODDLED`	已編碼的方法
`FERMENTED`	發酵方法
`FRIED`	收尾法
`GRILLED`	燒烤方法
`KNEADED`	Kneaded 方法
`MARINATED`	邊界方法
`PAN_FRIED`	平移方法
`PICKLED`	所選方法
`PRESSURE_COOKED`	施壓加壓方式
`ROASTED`	旋轉方法
`SAUTEED`	理想方法
`SEARED`	密封方法
`SIMMERED`	模擬方法
`SMOKED`	煙燻方法
`STEAMED`	蒸汽化方法
`STEEPED`	陡峭的方法
`STIR_FRIED`	熱炒
`OTHER_METHOD`	其他方式

PriceList

已淘汰：商品價格資訊清單。價格清單由一或多份價格清單組成，每個清單都包含一或多個專區，內含一或多個商品。舉例來說，食物價格清單可能代表早餐/午餐/晚餐菜單，而菜單包括漢堡/牛排/海鮮。

欄位
`price_list_id`	`string` 必要欄位。價格清單的 ID。你無法在這個地區複製價目表、專區和項目 ID。
`labels[]`	`Label` 必要欄位。價格清單的語言標記標籤。
`source_url`	`string` 擷取價格清單的來源網址 (選填)。舉例來說，這可能是系統自動剪輯來填入菜單資訊的網頁網址。
`sections[]`	`Section` 必要欄位。這份價目表的版面。每份價目表都必須包含至少一個版面。

章節

價格清單的一個部分，包含一或多個商品。

欄位
`section_id`	`string` 必要欄位。章節 ID。你無法在這個地區複製價目表、專區和項目 ID。
`labels[]`	`Label` 必要欄位。區段的語言標記標籤。版面名稱和說明建議不要超過 140 個半形字元。至少須指定一組標籤。
`section_type`	`SectionType` 選用設定。目前價目表部分的類型。預設值為 FOOD。
`items[]`	`Item` 價目表這部分包含的商品。

項目

單一清單項目。價格清單上的每項商品子類都應有專屬的商品和價格資料。

欄位

item_id

string

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

labels[]

Label

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

price

Money

選用設定。商品的價格。

SectionType

版面類型。

列舉
`SECTION_TYPE_UNSPECIFIED`	未指定。
`FOOD`	區段包含代表食物的項目。
`SERVICES`	區段包含代表服務的項目。

設定檔

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

欄位

description

string

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

問題

代表單一問題及部分答案。

欄位
`name`	`string` 僅供輸出。問題的專屬名稱。帳戶//locations//questions/*
`author`	`Author` 僅供輸出。問題的作者。
`upvote_count`	`int32` 僅供輸出。問題的認同票數。
`text`	`string` 問題的文字。其中應包含至少 3 個字詞，且總長度大於或等於 10 個字元。長度上限為 4096 個半形字元。
`create_time`	`Timestamp` 僅供輸出。寫入問題時的時間戳記。
`update_time`	`Timestamp` 僅供輸出。上次修改問題時的時間戳記。
`top_answers[]`	`Answer` 僅供輸出。問題的答案清單，依認同票數排序。視要求參數而定 (answers_per_question) 可能未必是完整的答案清單
`total_answer_count`	`int32` 僅供輸出。這個問題張貼的答案總數。

RepeatedEnumAttributeValue

value_type 為 REPEATED_ENUM 的屬性值。當中包含兩份值 ID 清單，分別設為 (true) 和未設定 (false) 的值。缺少的值會視為不明。至少須指定一個值。

欄位

set_values[]

string

設定的列舉值。

unset_values[]

string

未設定的列舉值。

ReportGoogleLocationRequest

要求回報 GoogleLocation 的訊息。

欄位
`name`	`string` [GoogleLocation] 的資源名稱，格式為 `googleLocations/{googleLocationId}`。
`location_group_name`	`string` 選用設定。回報這個 Google 位置的地區群組名稱，格式為 `accounts/{account_id}`。
`report_reason_elaboration`	`string` 選用設定。輸入文字，說明使用者檢舉這個地點的原因。長度上限為 512 個半形字元。
`report_reason_language_code`	`string` 選用設定。`report_reason_elaboration` 中所用語言的 BCP 47 代碼。
聯集欄位 `report_reason`。系統回報這個地點的原因。必須提供原因。`report_reason` 只能是下列其中一項：
`report_reason_bad_location`	`BadLocationReason` 使用者回報這個地點的原因與地點本身有關。
`report_reason_bad_recommendation`	`BadRecommendationReason` 建議問題影響到使用者回報這個地點的原因。如果商家檔案帳戶推薦了該地點，這份報表就非常實用。

BadLocationReason

地點本身資料品質有問題時，系統回報地點的一組可能原因。

列舉
`BAD_LOCATION_REASON_UNSPECIFIED`	未指定。
`NOT_A_LOCATION`	建議的位置並非實際位置。
`PERMANENTLY_CLOSED`	建議的地點已永久停業。
`DOES_NOT_EXIST`	建議的位置不存在。
`SPAM`	建議的地點為垃圾內容、不實或令人反感。
`NOT_A_BUSINESS`	建議的地點為私人或住家。
`MOVED`	建議的位置已移至新位置。應搭配指定新地址的 `report_reason_elaboration`。
`DUPLICATE`	建議的地點與另一個地點重複。

BadRecommendationReason

建議品質有問題時，回報地點的一組可能原因 (系統向使用者建議這個地點時)。

列舉
`BAD_RECOMMENDATION_REASON_UNSPECIFIED`	未指定。
`NOT_A_STORE_FRONT`	建議的地點並非店面。
`NOT_PART_OF_SUGGESTED_CHAIN`	建議位置不屬於傳回位置的 `chain_display_name` 中建議的鏈結。應一併附上指定正確鏈結名稱的 `report_reason_elaboration`。
`IRRELEVANT`	建議的位置與使用者無關。應隨附 `report_reason_elaboration`，說明建議不相關的原因。

ReportLocalPostInsightsRequest

Insights.ReportLocalPostInsights 要求訊息

欄位

name

string

必要欄位。要擷取深入分析的地點名稱。

local_post_names[]

string

必要欄位。要擷取洞察資料的貼文清單。所有貼文都必須屬於 name 欄位中指定名稱的位置。

basic_request

BasicMetricsRequest

要求在報表中納入基本指標洞察。此要求適用於所有所要求的貼文。

ReportLocalPostInsightsResponse

Insights.ReportLocalPostInsights 的回應訊息

欄位

name

string

local_post_metrics[]

LocalPostMetrics

每要求一則與這個位置相應的貼文，只能有一個項目。

time_zone

string

地點的時區 (IANA 時區 ID，例如「歐洲/倫敦」)。

ReportLocationInsightsRequest

Insights.ReportLocationInsights 的要求訊息。

欄位
`name`	`string` 帳戶資源名稱。
`location_names[]`	`string` 要擷取洞察資料的地點集合，由名稱指定。
`basic_request`	`BasicMetricsRequest` 要求在報表中納入基本指標洞察。
`driving_directions_request`	`DrivingDirectionMetricsRequest` 要求將有關行車路線要求的深入分析資訊納入報告中。

ReportLocationInsightsResponse

Insights.ReportLocationInsights 的回應訊息。

欄位

location_metrics[]

LocationMetrics

按位置劃分的指標值集合。

location_driving_direction_metrics[]

行車方向相關指標的一組值。

立即詳閱

僅供輸出。代表某地點的評論。

欄位
`name`	`string` 資源名稱。審查方式為 `accounts/{account_id}/locations/{location_id}/reviews/{review_id}`
`review_id`	`string` 經過加密的專屬 ID。
`reviewer`	`Reviewer` 評論的作者。
`star_rating`	`StarRating` 評論的星級評等。
`comment`	`string` 含有標記的純文字評論內文。
`create_time`	`Timestamp` 撰寫評論的時間戳記。
`update_time`	`Timestamp` 上次修改評論的時間戳記。
`review_reply`	`ReviewReply` 這個地點的擁有者/管理員對這則評論的回覆。

評論者

代表評論的作者。

欄位

profile_photo_url

string

評論者的個人資料相片連結。只有在 is_anonymous 為 false 時才會填入。

display_name

string

評論者的名稱。只有在 is_anonymous 為 false 時，才會填入評論者的真實姓名。

is_anonymous

bool

指出評論者是否選擇保持匿名。

StarRating

星級評等 (滿分五顆星)，其中五分是最高分。

列舉
`STAR_RATING_UNSPECIFIED`	未指定。
`ONE`	一顆星 (滿分 5 顆星)。
`TWO`	2 顆星 (滿分 5 顆星)。
`THREE`	3 顆星 (滿分 5 顆星)。
`FOUR`	4 顆星 (滿分 5 顆星)。
`FIVE`	最高星級評等。

ReviewReply

代表營業地點擁有者/管理員對評論的回覆。

欄位

comment

string

回覆內文 (含有標記的純文字)。長度上限為 4096 個位元組。

update_time

僅供輸出。上次修改回覆的時間戳記。

SearchChainsRequest

Locations.SearchChains 的要求訊息。

欄位

chain_display_name

string

使用鏈結名稱搜尋鏈結。支援完全/部分/模糊/相關查詢。範例："walmart、"wal-mart"、"walmmmart"、"聃"

result_count

int32

這項查詢傳回的相符鏈結數量上限。預設值為 10。可能的值上限為 500。

SearchChainsResponse

Locations.SearchChains 的回應訊息。

欄位

chains[]

Chain

與 SearchChainsRequest 中查詢的 ChaininC_display_name 相符的鏈結。如果沒有相符項目，這個欄位會留空。結果會依關聯性排序。

SearchGoogleLocationsRequest

要求 GoogleLocations.SearchGoogleLocations 的訊息。

欄位
`result_count`	`int32` 要傳回的相符項目數量。預設值為 3，最多 10。請注意，如果要求更多，延遲時間可能會增加。沒有分頁。
聯集欄位 `search_query`。搜尋查詢。能以位置物件或字串查詢的形式提供。`search_query` 只能是下列其中一項：
`location`	`Location` 要搜尋的位置。如有提供，系統會找出與提供的地點詳細資料相符的地點。
`query`	`string` 要搜尋的文字查詢。查詢字串的搜尋結果會比提供確切位置來得準確，但可提供較不精確的符合項目。

SearchGoogleLocationsResponse

GoogleLocations.SearchGoogleLocations 的回應訊息。

欄位

google_locations[]

GoogleLocation

可能與指定要求相符的 GoogleLocation 集合，按精確度由高至低列出。

ServiceAreaBusiness

服務範圍商家在顧客的營業地點提供服務 (例如鎖匠或水電工)。

欄位
`business_type`	`BusinessType` 表示服務區域商家的`type`。
聯集欄位 `coverageArea`。指出商家提供服務的涵蓋範圍。`coverageArea` 只能是下列其中一項：
`radius`	`PointRadius` 僅供輸出。此商家以某點為中心的中心區域。
`places`	`Places` 此商家透過一組地點指定的服務範圍。

BusinessType

指出此商家是否只在消費者的所在地點 (例如拖車車) 提供現場服務，或者同時在地址和現場提供服務 (例如設有用餐區的披薩店，以及代客送貨服務)。

列舉
`BUSINESS_TYPE_UNSPECIFIED`	僅供輸出。未指定。
`CUSTOMER_LOCATION_ONLY`	只在周邊地區提供服務 (不在商家地址附近)。
`CUSTOMER_AND_BUSINESS_LOCATION`	在商家地址和周邊區域提供服務。

ServiceBusinessContext

服務商家驗證的其他資料。

欄位

address

PostalAddress

地點的驗證地址。這些資訊可用於啟用更多驗證選項或傳送明信片。

ServiceList

包含一或多個服務項目的服務清單。

欄位

name

string

必要欄位。這個地點的 Google ID，格式為：accounts/{account_id}/locations/{location_id}/serviceList

service_items[]

ServiceItem

這份服務清單中的服務項目。系統會自動移除重複的服務項目。

ServiceItem

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

欄位
`is_offered`	`bool` 選用設定。這個欄位會決定商家是否提供輸入服務。
`price`	`Money` 選用設定。代表服務項目的貨幣價格。加入價格時，建議您設定 currency_code 和 unit。
聯集欄位 `service_item_info`。請一律設定下列其中一個欄位。`service_item_info` 只能是下列其中一項：
`structured_service_item`	`StructuredServiceItem` 這個欄位會設定結構化資料的大小寫。
`free_form_service_item`	`FreeFormServiceItem` 這個欄位會設為任意形式服務資料的值。

FreeFormServiceItem

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

欄位

category_id

string

必要欄位。category_id 和 service_type_id 應與 Category 訊息中提供的可能組合相符。

label

Label

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

StructuredServiceItem

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

欄位

service_type_id

string

必要欄位。service_type_id 欄位是 Google 提供的專屬 ID，您可以在 ServiceTypeMetadata 中找到。這項資訊是由 BatchGetBusinessCategories rpc 服務提供。

description

string

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

ServiceType

商家所提供服務類型的訊息。

欄位

service_type_id

string

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

display_name

string

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

SpecialHourPeriod

代表某個地點的營業時間與正常營業時間不同的時間範圍。特殊時段必須代表小於 24 小時的範圍。open_time 和 start_date 必須早於 close_time 和 end_date。close_time 和 end_date 可以延長至指定 start_date 之後的當天凌晨 11:59。舉例來說，以下為有效的輸入內容：

start_date=2015-11-23, open_time=08:00, close_time=18:00
start_date=2015-11-23, end_date=2015-11-23, open_time=08:00,
close_time=18:00 start_date=2015-11-23, end_date=2015-11-24,
open_time=13:00, close_time=11:59

下列輸入內容無效：

start_date=2015-11-23, open_time=13:00, close_time=11:59
start_date=2015-11-23, end_date=2015-11-24, open_time=13:00,
close_time=12:00 start_date=2015-11-23, end_date=2015-11-25,
open_time=08:00, close_time=18:00

欄位
`start_date`	`Date` 這個特殊時段的起始日期。
`open_time`	`string` `start_date` 開啟地點時的實際時間，以 24 小時 ISO 8601 擴充格式表示。(hh:mm) 有效值為 00:00-24:00，其中 24:00 代表指定日期欄位結束的午夜。如果 `is_closed` 為 false，則必須指定。
`end_date`	`Date` 這個特殊時段的結束日期。如未設定 `end_date` 欄位，請預設為 `start_date` 中指定的日期。如已設定，這個欄位必須等於或最多晚於 `start_date`後 1 天。
`close_time`	`string` 地點打烊時，`end_date` 的實際時間，以 24 小時 ISO 8601 擴充格式表示。(hh:mm) 有效值為 00:00-24:00，其中 24:00 代表指定日期欄位結束的午夜。如果 `is_closed` 為 false，則必須指定。
`is_closed`	`bool` 如果設為 True，系統會忽略 `end_date`、`open_time` 和 `close_time`，且會將 `start_date` 中指定的日期視為整天沒有停業。

SpecialHours

代表一個地點的營業時間與正常營業時間不同的時間範圍。

欄位

special_hour_periods[]

SpecialHourPeriod

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

辣度

食品的辣度。

列舉
`SPICINESS_UNSPECIFIED`	未指定等級
`MILD`	輕微辣度的象徵。
`MEDIUM`	中度鼓勵。
`HOT`	表示熱辣。最高最高峰。

StartUploadMediaItemDataRequest

Media.StartUploadMediaItemData 的要求訊息。

欄位

parent

string

要新增這個媒體項目的位置資源名稱。

TimeInterval

時間間隔 (含頭尾)。這個欄位必須包含所有有效欄位。

欄位
`start_date`	`Date` 此期間的開始日期。
`start_time`	`TimeOfDay` 這個時間範圍的開始時間。
`end_date`	`Date` 此期間的結束日期。
`end_time`	`TimeOfDay` 這段期間的結束時間。

TimePeriod

代表商家營業的時間範圍，從指定的營業時間開始，到指定結束日/時間結束為止。打烊時間必須晚於開幕時間，例如當天稍晚或隨後幾天。

欄位
`open_day`	`DayOfWeek` 表示這個期間從開始當天起算的`day of the week`。
`open_time`	`string` 以 24 小時 ISO 8601 擴充格式 (hh:mm) 表示的時間。有效值為 00:00-24:00，其中 24:00 代表指定日期欄位結束的午夜。
`close_day`	`DayOfWeek` 表示這個週期結束的`day of the week`。
`close_time`	`string` 以 24 小時 ISO 8601 擴充格式 (hh:mm) 表示的時間。有效值為 00:00-24:00，其中 24:00 代表指定日期欄位結束的午夜。

TimeRange

時間範圍。系統會在範圍內提取資料，並將這個範圍內的資料轉換成半開公開值 (即 [start_time, end_time)]。

欄位

start_time

範圍開始的 Epoch 紀元時間戳記 (含首尾)。

end_time

範圍結束的 Epoch 紀元時間戳記 (不含)。

TransferLocationRequest

要求 Locations.TransferLocation 的訊息。

欄位

name

string

要轉移的地點名稱。

to_account

string

要接收位置的帳戶資源名稱 (例如「accounts/8675309」)。

UpdateAccountAdminRequest

AccessControl.UpdateAccountAdmin 的要求訊息。

欄位

name

string

待更新管理員的資源名稱。

admin

更新後的管理員。注意：唯一可編輯的欄位為 role。所有其他欄位都會遭到忽略。

UpdateAccountRequest

帳戶.UpdateAccount 的要求訊息。

欄位

name

string

要更新的帳戶名稱。

account

Account

已更新的帳戶資訊。注意：唯一可編輯的欄位為 account_name。

validate_only

bool

如果為 true，表示該要求已通過驗證，而不會實際更新帳戶。

UpdateFoodMenusRequest

FoodMenu.UpdateFoodMenus 的要求訊息

欄位

food_menus

FoodMenus

必要欄位。更新後的飲食菜單資訊。如要取消設定選單，請更新選單區域，

update_mask

HealthProviderAttributes

選用設定。要更新的特定欄位。如果沒有指定遮罩，系統會將此視為完整的更新，並將所有欄位設為傳入的值，要求中可能包含未設定的空白欄位。無法個別更新重複欄位的項目。注意：FoodMenus 的「name」是無法更新的資源 ID。

UpdateHealthProviderAttributesRequest

HealthProviderAttributes.UpdateHealthProviderAttributes 的要求訊息

欄位

health_provider_attributes

必要欄位。更新的健康提供者屬性。

update_mask

選用設定。要更新的特定欄位。如果沒有指定遮罩，系統會將此視為完整的更新，並將所有欄位設為傳入的值，要求中可能包含未設定的空白欄位。在 V1 中，只有 surer_networks 欄位要更新。我們稍後會支援更多屬性。

UpdateLocalPostRequest

要求 UpdateLocalPost 的訊息。

欄位

name

string

要更新的當地貼文名稱。

local_post

LocalPost

更新後的當地貼文資訊。

update_mask

要更新的特定欄位。您必須在遮罩中指定要更新的每個欄位。

UpdateLocationAdminRequest

要求 AccessControl.UpdateLocationAdmin 的訊息。

欄位

name

string

待更新管理員的資源名稱。

admin

更新後的管理員。注意：唯一可編輯的欄位為 role。所有其他欄位都會遭到忽略。

UpdateLocationRequest

Locations.UpdateLocation 的要求訊息。

欄位
`name`	`string` 要更新的地點名稱。
`location`	`Location` 更新的位置資訊。
`update_mask`	`FieldMask` 要更新的特定欄位。如果沒有指定遮罩，系統會將此視為完整的更新，並將所有欄位設為傳入的值，要求中可能包含未設定的空白欄位。
`validate_only`	`bool` 如果為 true，表示要求已在驗證，而不會實際更新位置。
`attribute_mask`	`FieldMask` 要更新的屬性 ID。系統只會更新遮罩中註記的屬性。如果遮罩中有屬性出現在遮罩中，且位置沒有，系統將移除該屬性。空白的遮罩會更新所有屬性。設定這個欄位時，update_mask 應包含屬性做為其中一個要更新的欄位。

UpdateMediaItemRequest

Media.UpdateMediaItem 的要求訊息。

欄位

name

string

要更新的媒體項目名稱。

media_item

MediaItem

要更新的媒體項目。

只能更新類別或價格清單項目 ID。

update_mask

要更新的特定欄位。如果沒有指定遮罩，系統會將此視為完整的更新，並將所有可編輯的欄位設為傳入的值。

UpdateNotificationsRequest

Account.UpdateNotifications 的要求訊息。

欄位

name

string

通知設定資源名稱。

notifications

Notifications

更新後的通知設定。

UpdateQuestionRequest

FAQAndAnswers.UpdateQuestion 的要求訊息

欄位

name

string

要更新的問題名稱。

question

Question

更新的問題。

UpdateReviewReplyRequest

要求 Review.UpdateReviewReply。

欄位

name

string

要回覆的評論名稱。

review_reply

ReviewReply

對評論的回覆。如果已有回覆，則舊回覆會取代舊回覆。

UpdateServiceListRequest

更新服務清單要求訊息。

欄位

service_list

ServiceList

選用設定。更新後的服務清單資訊。如果將這個欄位留空，API 會刪除 ServiceList。如果設定了 ServiceList，API 將取代原本的 ServiceList。

update_mask