تتضمّن واجهة برمجة التطبيقات
لأداء الأعمال في Google طريقة واجهة برمجة تطبيقات
جديدة تتيح جلب عدة "مقاييس يومية" في طلب واحد لواجهة برمجة التطبيقات.
يُرجى مراجعة
الجدول الزمني للإيقاف وتعليمات نقل البيانات من طريقة v4 reportInsights API إلى واجهة برمجة التطبيقات الخاصة بأداء "الملف التجاري على Google".
REST Resource: categories
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
المرجع: الفئة
فئة تصف ماهية هذا النشاط التجاري (وليس ما يقدّمه). للحصول على قائمة بمعرّفات الفئات الصالحة وعمليات الربط وأسمائها التي يمكن للمستخدمين قراءتها، يُرجى الاطّلاع على categories.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)
النتائج فقط. أنواع ساعات العمل الإضافية المتاحة لفئة النشاط التجاري هذه.
|
ServiceType
رسالة تصف نوع الخدمة التي يقدّمها النشاط التجاري
| تمثيل 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 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 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. |"]]
