Google Business Performance API یک روش API
جدید دارد که امکان واکشی چندین «DailyMetrics» را در یک درخواست API فراهم میکند.
زمانبندی منسوخ شدن و دستورالعملهای انتقال از روش API reportInsights v4 به API عملکرد نمایه کسبوکار Google را مرور کنید.
REST Resource: categories
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
منبع: دسته
دستهای که توضیح میدهد این تجارت چیست (نه کاری که انجام میدهد). برای فهرستی از شناسههای دستهبندی معتبر و نگاشت نامهای قابل خواندن توسط انسان، به category.list مراجعه کنید.
نمایندگی JSON |
---|
{
"displayName": string,
"categoryId": string,
"serviceTypes": [
{
object (ServiceType )
}
],
"moreHoursTypes": [
{
object (MoreHoursType )
}
]
} |
فیلدها |
---|
displayName | string . نام قابل خواندن برای انسان این دسته. این هنگام خواندن مکان تنظیم می شود. هنگام تغییر مکان، categoryId باید تنظیم شود. توجه: این فیلد فقط در پاسخ ها استفاده می شود. هر مقداری که در اینجا در یک درخواست مشخص شده است نادیده گرفته می شود. |
categoryId | string . شناسه پایدار (ارائه شده توسط Google) برای این دسته. هنگام تغییر دسته (هنگام ایجاد یا به روز رسانی یک مکان)، categoryId باید مشخص شود. توجه: این فیلد فقط در پاسخ ها استفاده می شود. هر مقداری که در اینجا در یک درخواست مشخص شده است نادیده گرفته می شود. |
serviceTypes[] | object ( ServiceType ) . فهرستی از انواع خدماتی که برای این دسته کسب و کار موجود است. توجه: این فیلد فقط در پاسخ ها استفاده می شود. هر مقداری که در اینجا در یک درخواست مشخص شده است نادیده گرفته می شود. |
moreHoursTypes[] | object ( MoreHoursType ) فقط خروجی انواع ساعات بیشتری برای این دسته کسب و کار موجود است. |
نوع سرویس
پیامی که نوع خدماتی را که کسبوکار ارائه میدهد توصیف میکند.
نمایندگی JSON |
---|
{
"serviceTypeId": string,
"displayName": string
} |
فیلدها |
---|
serviceTypeId | string فقط خروجی شناسه پایدار (ارائه شده توسط Google) برای این نوع سرویس. |
displayName | string فقط خروجی نام نمایشی قابل خواندن توسط انسان برای نوع سرویس. |
MoreHoursType
انواع ساعات بیشتری که یک کسب و کار می تواند ارائه دهد، علاوه بر ساعات کاری معمولی خود.
نمایندگی JSON |
---|
{
"hoursTypeId": string,
"displayName": string,
"localizedDisplayName": string
} |
فیلدها |
---|
hoursTypeId | string فقط خروجی شناسه ثابت ارائه شده توسط Google برای این نوع ساعت. |
displayName | string فقط خروجی نام نمایشی انگلیسی قابل خواندن برای نوع ساعت. |
localizedDisplayName | string فقط خروجی نام نمایش محلی قابل خواندن برای نوع ساعت. |
روش ها |
---|
| فهرستی از دستههای کسبوکار را برای زبان ارائهشده و شناسههای GConcept برمیگرداند. |
| فهرستی از دسته های کسب و کار را برمی گرداند. |
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده 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. |"]]