إضافة خدمات

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

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

لا يمكن لبعض الأنشطة التجارية إضافة خدمات إلى بطاقة بياناتها على "الملف التجاري". للتأكّد من الأهلية، يُرجى التحقّق من حالة 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 وعيِّنهاreadMask=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"
            }
         }
      }
   ]
}