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

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

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

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

یک سرویس به صورت ServiceItem نمایش داده می‌شود که از دو فرمت زیر پشتیبانی می‌کند:

  • StructuredServiceItem : سرویس‌های از پیش تعریف‌شده‌ی گوگل می‌توانند به صورت یک StructuredServiceItem نمایش داده شوند که شامل یک serviceTypeId است.
  • FreeFormServiceItem : برای ارائه خدمات سفارشی، از FreeFormServiceItem که حاوی یک Label است استفاده کنید.

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

برای جستجوی خدمات از پیش تعریف شده تحت یک دسته بندی بر اساس نام دسته بندی، از categories.list استفاده کنید. درخواستی برای همه دسته بندی ها که شامل نام salon در سنگاپور است، در بخش درخواست زیر نشان داده شده است.

درخواست

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

اچ‌تی‌پی 
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 تنظیم شود.

اچ‌تی‌پی 
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 را تنظیم کنید.

درخواست

اچ‌تی‌پی 
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 ، به مثال زیر مراجعه کنید:

اچ‌تی‌پی 
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"
            }
         }
      }
   ]
}