Las empresas pueden agregar los servicios que proporcionan a la ficha de su Perfil de Negocio. Esto podría incluir los servicios que se proporcionan dentro de una tienda o los que se ofrecen en las ubicaciones de los clientes.
Elegibilidad y formato
No todas las empresas pueden agregar servicios a la ficha de su Perfil de Negocio. Para comprobar si es apto, comprueba el estado de canModifyServiceList en Metadatos.
Un servicio se representa como un ServiceItem, que admite los dos formatos siguientes:
- StructuredServiceItem: Los servicios predefinidos de Google se pueden representar como un
StructuredServiceItem, que contiene unserviceTypeId. - FreeFormServiceItem: Para ofrecer servicios personalizados, usa un
FreeFormServiceItemque contenga una etiqueta.
Crea una lista de servicios predefinidos por nombre de categoría
Para buscar servicios predefinidos en una categoría por nombre de categoría, usa categories.list. En la siguiente sección Solicitud, se muestra una solicitud para todas las categorías que incluyen el nombre salon en Singapur.
Solicitud
CategoryView debe configurarse como FULL.
GET https://mybusinessbusinessinformation.googleapis.com/v1/categories?regionCode=SG&languageCode=EN&filter=displayname=salon&view=FULL
Respuesta
La siguiente respuesta parcial muestra todos los ServiceTypes compatibles.
{
"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"
}
]
}
}
Enumerar servicios predefinidos por ID de categoría
Para buscar servicios predefinidos por ID de categoría específico, usa categories.batchGet. En la siguiente sección Solicitud, se muestra una solicitud de detalles bajo el ID de categoría gcid:electrician en Estados Unidos.
Solicitud
CategoryView debe configurarse como FULL.
GET https://mybusinessbusinessinformation.googleapis.com/v1/categories:batchGet?regionCode=US&languageCode=en&names=gcid:electrician&view=FULL
Respuesta
La respuesta contiene todos los ServiceTypes compatibles con 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"
}
]
}
]
}
Enumera los servicios existentes en una ficha
Para obtener una lista actual de servicios, usa locations.get y configurareadMask=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"
}
}
}
]
}
Cómo configurar servicios para una ficha
Para actualizar servicios, usa locations.patch y updateMask=serviceItems. No se admite la actualización de servicios individuales.
Para configurar servicios con un StructuredServiceItem y un 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"
}
}
}
]
}