הוספת שירותים

עסקים יכולים להוסיף שירותים שהם מספקים לדף העסקי שלהם ב'פרופיל העסק ב-Google'. הדרישה הזו יכולה לכלול שירותים שמסופקים בתוך חנות או שירותים שמוצעים במיקומים של לקוחות.

דרישות הסף והפורמט

לא כל העסקים יכולים להוסיף שירותים לדף העסקי שלהם ב'פרופיל העסק ב-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"
            }
         }
      }
   ]
}