As empresas podem incluir os serviços que oferecem nas fichas do Perfil da empresa, como aqueles prestados em uma loja ou no local do cliente.
Qualificação e formato
Nem todas as empresas podem adicionar serviços à ficha do Perfil da empresa. Para verificar a qualificação, confira o estado de canModifyServiceList em Metadata.
Um serviço é representado como um ServiceItem, compatível com os dois formatos a seguir:
- StructuredServiceItem: os serviços predefinidos do Google podem ser representados como
StructuredServiceItem, que contém umserviceTypeId. - FreeFormServiceItem: para oferecer serviços personalizados, use um
FreeFormServiceItemque contenha um marcador.
Como listar serviços predefinidos por nome de categoria
Para pesquisar serviços predefinidos em uma categoria pelo nome dela, use categories.list. Uma solicitação de todas as categorias que incluem o nome salon em Singapura é mostrada na seção "Solicitação" a seguir.
Solicitação
O parâmetro CategoryView precisa ser definido como FULL.
GET https://mybusinessbusinessinformation.googleapis.com/v1/categories?regionCode=SG&languageCode=EN&filter=displayname=salon&view=FULL
Resposta
A resposta parcial a seguir retorna todos os ServiceTypes compatíveis.
{
"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"
}
]
}
}
Listar serviços predefinidos por ID de categoria
Para pesquisar serviços predefinidos pelo ID de categoria específico, use categories.batchGet. Uma solicitação de detalhes com o ID de categoria gcid:electrician nos Estados Unidos é mostrada na seção "Solicitação" a seguir.
Solicitação
O parâmetro CategoryView precisa ser definido como FULL.
GET https://mybusinessbusinessinformation.googleapis.com/v1/categories:batchGet?regionCode=US&languageCode=en&names=gcid:electrician&view=FULL
Resposta
A resposta contém todos os ServiceTypes compatíveis para 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"
}
]
}
]
}
Listar serviços existentes em uma ficha
Para ver a lista atual dos serviços, use locations.get e defina readMask=serviceItems
Solicitação
GET https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}?readMask=serviceItems
Resposta
Veja abaixo um exemplo de resposta
{
"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"
}
}
}
]
}
Definir serviços para uma ficha da empresa
Para atualizar serviços, use locations.patch e updateMask=serviceItems. Não é possível atualizar serviços separadamente.
Para definir serviços com um StructuredServiceItem e um FreeFormServiceItem, consulte o exemplo a seguir:
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"
}
}
}
]
}