إضافة خدمات

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

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

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

يتم تمثيل الخدمة على أنّها ServiceItem، وهو تنسيقان:

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

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

للبحث عن خدمات محدّدة مسبقًا ضمن فئة حسب اسم الفئة، استخدِم 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"
            }
         }
      }
   ]
}