Las empresas pueden añadir a sus fichas de Perfil de Empresa los servicios que ofrecen, ya sea en tiendas o donde se encuentren sus clientes.
Requisitos y formato
No todas las empresas pueden añadir servicios a sus fichas de Perfil de Empresa. Para comprobar si una empresa puede hacerlo, consulta el estado de canModifyServiceList en Metadatos.
Cada servicio se representa mediante un objeto ServiceItem que admite los dos formatos siguientes:
- StructuredServiceItem: los servicios predefinidos de Google se pueden representar como objetos
StructuredServiceItemque contienenserviceTypeId. - FreeFormServiceItem: para ofrecer servicios personalizados, usa un objeto
FreeFormServiceItemque contenga una etiqueta.
Mostrar servicios predefinidos por nombre de categoría
Para buscar servicios predefinidos de una categoría introduciendo el nombre de la categoría, usa categories.list. En la siguiente sección, "Solicitud", se muestra una solicitud de todas las categorías de Singapur que incluyan el nombre salon.
Solicitud
El valor de CategoryView debe ser FULL.
GET https://mybusinessbusinessinformation.googleapis.com/v1/categories?regionCode=SG&languageCode=EN&filter=displayname=salon&view=FULL
Respuesta
La siguiente respuesta parcial devuelve todos los valores compatibles del objeto 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"
}
]
}
}
Mostrar servicios predefinidos por ID de categoría
Para buscar servicios predefinidos introduciendo el ID de una categoría, usa categories.batchGet. En la siguiente sección, "Solicitud", se muestra una solicitud de los detalles de las categorías de Estados Unidos que tengan el ID gcid:electrician.
Solicitud
El valor de CategoryView debe ser FULL.
GET https://mybusinessbusinessinformation.googleapis.com/v1/categories:batchGet?regionCode=US&languageCode=en&names=gcid:electrician&view=FULL
Respuesta
La respuesta contiene todos los valores compatibles del objeto ServiceTypes correspondientes a 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"
}
]
}
]
}
Mostrar servicios disponibles de una ficha
Para obtener una lista actual de servicios, usa locations.get y define el valor readMask=serviceItems.
Solicitud
GET https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}?readMask=serviceItems
Respuesta
A continuación, se muestra un ejemplo de respuesta:
{
"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"
}
}
}
]
}
Incluir servicios en fichas
Para actualizar los servicios, usa locations.patch y updateMask=serviceItems. No se pueden actualizar servicios individualmente.
Para configurar servicios con un objeto StructuredServiceItem y con un objeto FreeFormServiceItem, consulta el siguiente ejemplo:
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"
}
}
}
]
}