Las empresas pueden agregar los servicios que ofrecen a las fichas de sus Perfiles de Negocio. Esto podría incluir los servicios prestados en una tienda o los que se ofrecen en las ubicaciones del cliente.
Elegibilidad y formato
No todas las empresas pueden agregar servicios a la ficha de su Perfil de Negocio. Para comprobar la elegibilidad, 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
FreeFormServiceItem
que contenga una Label.
Muestra una lista de servicios predefinidos por nombre de categoría
Para buscar servicios predefinidos de 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 incluyan el nombre salon
en Singapur.
Solicitud
CategoryView debe establecerse en 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ífica, usa categories.batchGet. En la siguiente sección Solicitud, se muestra una solicitud de detalles con el ID de categoría gcid:electrician
en Estados Unidos.
Solicitud
CategoryView debe establecerse en 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" } ] } ] }
Enumerar los servicios existentes de una ficha
Para obtener una lista actual de los servicios, usa locations.get y configurareadMask=serviceItems
.
Solicitud
GET https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}?readMask=serviceItems
Respuesta
A continuación, se incluye una respuesta de ejemplo
{ "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" } } } ] }
Establece los 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" } } } ] }