إضافة خدمات

يمكن للأنشطة التجارية إضافة خدمات تقدّمها إلى بيانات ملفها التجاري. ويمكن أن يشمل ذلك الخدمات المقدَّمة في متجر معيّن أو الخدمات المقدَّمة في المواقع الجغرافية للعملاء.

الأهلية والتنسيق

لا يمكن لبعض الأنشطة التجارية إضافة خدمات إلى بيانات الملف التجاري. للتحقّق من الأهلية، يمكنك الاطّلاع على حالة canModifyServiceList في البيانات الوصفية.

يتم تمثيل الخدمة باعتبارها ServiceItem التي تتوافق مع التنسيقين التاليين:

  • StructuredServiceItem: يمكن تمثيل خدمات Google المحدَّدة مسبقًا على أنها StructuredServiceItem التي تحتوي على serviceTypeId.
  • FreeFormServiceItem: لتقديم خدمات مخصّصة، استخدِم FreeFormServiceItem يحتوي على تصنيف.

عرض الخدمات المحدّدة مسبقًا حسب اسم الفئة

للبحث عن الخدمات المحدَّدة مسبقًا ضمن فئة حسب اسم الفئة، استخدِم categories.list. يتم عرض طلب لجميع الفئات التي تتضمّن الاسم salon في سنغافورة في قسم "الطلبات" التالي.

الطلب

يجب ضبط CategoryView على FULL.

بروتوكول HTTP
GET https://mybusinessbusinessinformation.googleapis.com/v1/categories?regionCode=SG&languageCode=EN&filter=displayname=salon&view=FULL

الرد

تعرض الاستجابة الجزئية التالية جميع أنواع ServiceTypes المتوافقة.

{
    "categories": [
        {
            "name": "gcid:hair_salon",
            "displayName": "Hairdresser",
            "serviceTypes": [
                {
                    "serviceTypeId": "job_type_id:body_waxing",
                    "displayName": "Body Waxing"
                },
                {
                    "serviceTypeId": "job_type_id:hair_coloring",
                    "displayName": "Hair coloring"
                },
                {
                    "serviceTypeId": "job_type_id:hair_extensions",
                    "displayName": "Hair extensions"
                },
                {
                    "serviceTypeId": "job_type_id:hair_styling",
                    "displayName": "Hair styling"
                },
                {
                    "serviceTypeId": "job_type_id:manicures",
                    "displayName": "Manicures"
                },
                {
                    "serviceTypeId": "job_type_id:pedicures",
                    "displayName": "Pedicures"
                }
            ]
        }
}

سرد الخدمات المحدَّدة مسبقًا حسب رقم تعريف الفئة

للبحث عن الخدمات المحدَّدة مسبقًا حسب معرّف فئة معيّن، استخدِم categories.batchGet. يتضمّن قسم "الطلبات" التالي طلبًا للحصول على تفاصيل ضمن معرّف الفئة gcid:electrician في الولايات المتحدة.

الطلب

يجب ضبط CategoryView على FULL.

بروتوكول HTTP
GET https://mybusinessbusinessinformation.googleapis.com/v1/categories:batchGet?regionCode=US&languageCode=en&names=gcid:electrician&view=FULL

الرد

يحتوي الرد على جميع أنواع ServiceTypes المتوافقة لـ gcid:electrician.

{
    "categories": [
        {
            "name": "gcid:electrician",
            "displayName": "Electrician",
            "serviceTypes": [
                {
                    "serviceTypeId": "job_type_id:construction",
                    "displayName": "Construction"
                },
                {
                    "serviceTypeId": "job_type_id:electric_car_charger",
                    "displayName": "Install electric car charger"
                },
                {
                    "serviceTypeId": "job_type_id:electrician_remodeling",
                    "displayName": "Remodeling"
                },
                {
                    "serviceTypeId": "job_type_id:general_repairs",
                    "displayName": "General repairs"
                },
                {
                    "serviceTypeId": "job_type_id:install_fan",
                    "displayName": "Install fan"
                },
                {
                    "serviceTypeId": "job_type_id:install_ground_wire",
                    "displayName": "Install ground wire"
                },
                {
                    "serviceTypeId": "job_type_id:install_light_fixtures",
                    "displayName": "Install light fixtures"
                },
                {
                    "serviceTypeId": "job_type_id:install_outdoor_lighting",
                    "displayName": "Install outdoor lighting"
                },
                {
                    "serviceTypeId": "job_type_id:install_outlets_switches",
                    "displayName": "Install outlets or switches"
                },
                {
                    "serviceTypeId": "job_type_id:install_security_system",
                    "displayName": "Install security system"
                },
                {
                    "serviceTypeId": "job_type_id:installation",
                    "displayName": "Installation"
                },
                {
                    "serviceTypeId": "job_type_id:relocate_outlets_switches",
                    "displayName": "Relocate outlets or switches"
                },
                {
                    "serviceTypeId": "job_type_id:repair_fan",
                    "displayName": "Repair fan"
                },
                {
                    "serviceTypeId": "job_type_id:repair_light_fixtures",
                    "displayName": "Repair light fixtures"
                },
                {
                    "serviceTypeId": "job_type_id:repair_outlets_switches",
                    "displayName": "Repair outlets or switches"
                },
                {
                    "serviceTypeId": "job_type_id:repair_panel",
                    "displayName": "Repair panel"
                },
                {
                    "serviceTypeId": "job_type_id:replace_upgrade_panel",
                    "displayName": "Replace or upgrade panel"
                },
                {
                    "serviceTypeId": "job_type_id:restore_power",
                    "displayName": "Restore power"
                }
            ]
        }
    ]
}

إدراج الخدمات الحالية في بطاقة بيانات

للحصول على قائمة حالية بالخدمات، استخدِم locations.get وsetreadMask=serviceItems

الطلب

بروتوكول HTTP
GET https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}?readMask=serviceItems

الرد

وفي ما يلي نموذج للرد

{
    "serviceItems": [
        {
            "structuredServiceItem": {
                "serviceTypeId": "job_type_id:hair_coloring"
            }
        },
        {
            "isOffered": true,
            "structuredServiceItem": {
                "serviceTypeId": "job_type_id:hair_styling"
            }
        },
        {
            "isOffered": true,
            "freeFormServiceItem": {
                "categoryId": "gcid:barber_shop",
                "label": {
                    "displayName": "Student Cuts"
                }
            }
        }
    ]
}

ضبط الخدمات لبطاقة بيانات

لتعديل الخدمات، استخدِم locations.patch وupdateMask=serviceItems. لا تتوفّر إمكانية تحديث الخدمات الفردية.

لضبط الخدمات باستخدام StructuredServiceItem وFreeFormServiceItem، يُرجى الاطّلاع على المثال التالي:

بروتوكول HTTP
PATCH
https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}?updateMask=serviceItems
{
   "serviceItems":[
      {
         "isOffered":false,
         "structuredServiceItem":{
            "serviceTypeId":"job_type_id:hair_coloring"
         }
      },
      {
         "isOffered":true,
         "structuredServiceItem":{
            "serviceTypeId":"job_type_id:hair_styling"
         }
      },
      {
         "isOffered":true,
         "freeFormServiceItem":{
            "categoryId":"gcid:hair_salon",
            "label":{
               "displayName":"Student Cuts"
            }
         }
      }
   ]
}