Firmy mogą dodawać do swoich wizytówek w Profilu Firmy świadczone przez siebie usługi Może to obejmować usługi świadczone w sklepie lub usługi oferowane w lokalizacjach klienta.
Wymagania i format
Nie wszystkie firmy mogą dodawać usługi do wizytówki w Profilu Firmy. Aby sprawdzić kwalifikację, sprawdź stan canModifyServiceList w metadanych.
Usługa jest reprezentowana jako element ServiceItem, który obsługuje te 2 formaty:
- StructuredServiceItem: wstępnie zdefiniowane usługi Google mogą mieć postać
StructuredServiceItem, która zawieraserviceTypeId. - FreeFormServiceItem: aby oferować usługi niestandardowe, użyj właściwości
FreeFormServiceItem, która zawiera etykietę.
Wyświetlanie listy wstępnie zdefiniowanych usług według nazwy kategorii
Aby wyszukać wstępnie zdefiniowane usługi w ramach kategorii według nazwy kategorii, użyj parametru categories.list. Żądanie dotyczące wszystkich kategorii zawierających imię i nazwisko salon w Singapurze znajdziesz w następnej sekcji „Prośba”.
Prośba
Element CategoryView musi mieć wartość FULL.
GET https://mybusinessbusinessinformation.googleapis.com/v1/categories?regionCode=SG&languageCode=EN&filter=displayname=salon&view=FULL
Odpowiedź
Poniższa odpowiedź częściowa zwraca wszystkie obsługiwane typy 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"
}
]
}
}
Wyświetl wstępnie zdefiniowane usługi według identyfikatora kategorii
Aby wyszukać wstępnie zdefiniowane usługi według identyfikatora kategorii, użyj polecenia categories.batchGet. Prośba o szczegóły w ramach identyfikatora kategorii gcid:electrician w Stanach Zjednoczonych zostanie wyświetlona w następnej sekcji „Prośba”.
Prośba
Element CategoryView musi mieć wartość FULL.
GET https://mybusinessbusinessinformation.googleapis.com/v1/categories:batchGet?regionCode=US&languageCode=en&names=gcid:electrician&view=FULL
Odpowiedź
Odpowiedź zawiera wszystkie obsługiwane typy ServiceTypes dla 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"
}
]
}
]
}
Wyświetlanie listy istniejących usług w wizytówce
Aby zobaczyć aktualną listę usług, użyj locations.get i ustaw readMask=serviceItems
Prośba
GET https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}?readMask=serviceItems
Odpowiedź
Poniżej znajduje się przykładowa odpowiedź
{
"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"
}
}
}
]
}
Ustawianie usług dla wizytówki
Aby zaktualizować usługi, użyj locations.patch i updateMask=serviceItems. Aktualizowanie poszczególnych usług nie jest obsługiwane.
Oto przykład, jak ustawić usługi za pomocą elementów StructuredServiceItem i 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"
}
}
}
]
}