اضافه کردن خدمات

کسب‌وکارها می‌توانند خدماتی را که ارائه می‌کنند به فهرست‌های نمایه کسب‌وکار خود اضافه کنند. این می تواند شامل خدمات ارائه شده در یک فروشگاه یا خدمات ارائه شده در مکان های مشتری باشد.

واجد شرایط بودن و قالب

همه مشاغل نمی توانند خدماتی را به فهرست نمایه کسب و کار خود اضافه کنند. برای بررسی واجد شرایط بودن، وضعیت canModifyServiceList را در Metadata بررسی کنید.

یک سرویس به عنوان 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

پاسخ

پاسخ جزئی زیر همه ServiceType های پشتیبانی شده را برمی گرداند.

{
    "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"
                }
            ]
        }
}

خدمات از پیش تعریف شده را بر اساس شناسه دسته فهرست کنید

برای جستجوی خدمات از پیش تعریف شده بر اساس شناسه دسته خاص، از category.batchGet استفاده کنید. یک درخواست برای جزئیات زیر دسته شناسه gcid:electrician در ایالات متحده در بخش درخواست زیر نشان داده شده است.

درخواست کنید

CategoryView باید روی FULL تنظیم شود.

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

پاسخ

پاسخ شامل تمام ServiceType های پشتیبانی شده برای 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"
            }
         }
      }
   ]
}