Google Business Performance API 的
NEW API 方法可擷取單一 API 要求中的多個「DailyMetrics」。
請詳閱
淘汰時間表和從 v4 reportInsights API 方法遷移至 Google Business Profile Performance API 的操作說明。
REST Resource: categories
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
資源:Category
JSON 表示法 |
{
"displayName": string,
"categoryId": string,
"serviceTypes": [
{
object (ServiceType )
}
],
"moreHoursTypes": [
{
object (MoreHoursType )
}
]
} |
欄位 |
displayName |
string
,直接在 Google Cloud 控制台實際操作。使用者可理解的類別名稱。讀取位置時即會設定這個選項。修改位置時,必須設定 categoryId 。 注意:這個欄位僅適用於回應,系統會忽略要求中指定的任何值。
|
categoryId |
string
,直接在 Google Cloud 控制台實際操作。這個類別的固定 ID (由 Google 提供)。修改類別時 (建立或更新位置時,必須指定 categoryId )。 注意:這個欄位僅適用於回應,系統會忽略要求中指定的任何值。
|
serviceTypes[] |
object (ServiceType )
,直接在 Google Cloud 控制台實際操作。列出這個業務類別提供的所有服務類型。 注意:這個欄位僅適用於回應,系統會忽略要求中指定的任何值。
|
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
僅供輸出。使用者可理解的本地化顯示名稱,代表營業時間類型。
|
方法 |
|
針對指定的語言和 G 概念 ID 傳回業務類別清單。 |
|
傳回業務類別清單。 |
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-07-25 (世界標準時間)。
[null,null,["上次更新時間:2025-07-25 (世界標準時間)。"],[[["\u003cp\u003e\u003cstrong\u003eCategory\u003c/strong\u003e resource describes a business's type using a stable \u003ccode\u003ecategoryId\u003c/code\u003e and provides human-readable names (\u003ccode\u003edisplayName\u003c/code\u003e).\u003c/p\u003e\n"],["\u003cp\u003eEach \u003cstrong\u003eCategory\u003c/strong\u003e can optionally include \u003cstrong\u003eServiceType\u003c/strong\u003e and \u003cstrong\u003eMoreHoursType\u003c/strong\u003e information detailing the services offered and special hours.\u003c/p\u003e\n"],["\u003cp\u003e\u003cstrong\u003eServiceType\u003c/strong\u003e objects provide specific service details with unique IDs (\u003ccode\u003eserviceTypeId\u003c/code\u003e) and human-readable names (\u003ccode\u003edisplayName\u003c/code\u003e).\u003c/p\u003e\n"],["\u003cp\u003e\u003cstrong\u003eMoreHoursType\u003c/strong\u003e objects specify additional hours beyond regular business hours using an ID (\u003ccode\u003ehoursTypeId\u003c/code\u003e) and localized display names.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can access and utilize Category data using the \u003ccode\u003ebatchGet\u003c/code\u003e and \u003ccode\u003elist\u003c/code\u003e methods documented in the \u003cstrong\u003eMethods\u003c/strong\u003e section.\u003c/p\u003e\n"]]],[],null,["# REST Resource: categories\n\n- [Resource: Category](#Category)\n - [JSON representation](#Category.SCHEMA_REPRESENTATION)\n - [ServiceType](#Category.ServiceType)\n - [JSON representation](#Category.ServiceType.SCHEMA_REPRESENTATION)\n - [MoreHoursType](#Category.MoreHoursType)\n - [JSON representation](#Category.MoreHoursType.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: Category\n------------------\n\nA category describing what this business is (not what it does). For a list of valid category IDs, and the mappings to their human-readable names, see [categories.list](https://developers.google.com/my-business/reference/rest/v4/categories/list).\n\n| JSON representation ||\n|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| ``` { \"displayName\": string, \"categoryId\": string, \"serviceTypes\": [ { object (/my-business/reference/rest/v4/categories#Category.ServiceType) } ], \"moreHoursTypes\": [ { object (/my-business/reference/rest/v4/categories#Category.MoreHoursType) } ] } ``` |\n\n| Fields ||\n|--------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `displayName` | `string` . The human-readable name of the category. This is set when reading the location. When modifying the location, `categoryId` must be set. Note: This field is used in responses only. Any value specified here in a request is ignored. |\n| `categoryId` | `string` . A stable ID (provided by Google) for this category. The `categoryId` must be specified when modifying the category (when creating or updating a location). Note: This field is used in responses only. Any value specified here in a request is ignored. |\n| `serviceTypes[]` | `object (`[ServiceType](/my-business/reference/rest/v4/categories#Category.ServiceType)`)` . A list of all the service types that are available for this business category. Note: This field is used in responses only. Any value specified here in a request is ignored. |\n| `moreHoursTypes[]` | `object (`[MoreHoursType](/my-business/reference/rest/v4/categories#Category.MoreHoursType)`)` Output only. More hours types that are available for this business category. |\n\n### ServiceType\n\nA message describing a service type that the business offers.\n\n| JSON representation ||\n|------------------------------------------------------------|---|\n| ``` { \"serviceTypeId\": string, \"displayName\": string } ``` |\n\n| Fields ||\n|-----------------|-------------------------------------------------------------------------------|\n| `serviceTypeId` | `string` Output only. A stable ID (provided by Google) for this service type. |\n| `displayName` | `string` Output only. The human-readable display name for the service type. |\n\n### MoreHoursType\n\nMore hours types that a business can offers, in addition to its regular hours.\n\n| JSON representation ||\n|------------------------------------------------------------------------------------------|---|\n| ``` { \"hoursTypeId\": string, \"displayName\": string, \"localizedDisplayName\": string } ``` |\n\n| Fields ||\n|------------------------|-------------------------------------------------------------------------------------|\n| `hoursTypeId` | `string` Output only. A stable ID provided by Google for this hours type. |\n| `displayName` | `string` Output only. The human-readable English display name for the hours type. |\n| `localizedDisplayName` | `string` Output only. The human-readable localized display name for the hours type. |\n\n| Methods ------- ||\n|--------------------------------------------------------------------|-----------------------------------------------------------------------------------|\n| ### [batchGet](/my-business/reference/rest/v4/categories/batchGet) | Returns a list of business categories for the provided language and GConcept ids. |\n| ### [list](/my-business/reference/rest/v4/categories/list) | Returns a list of business categories. |"]]