Atención: Se ha lanzado la versión 4.8 de la API. Consulta el registro de cambios. Las cadenas aún pueden hacer publicaciones relacionadas con el COVID‑19.

Añadir servicios

Las empresas pueden añadir a sus fichas de Google My Business los servicios que ofrecen en tiendas o donde se encuentren sus clientes.

Requisitos y formato

No todas las empresas pueden añadir servicios a sus fichas de Google My Business. Para comprobar si una empresa puede hacerlo, consulta el estado de canModifyServiceList en LocationState.

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 StructuredServiceItem que contienen serviceTypeId.
  • FreeFormServiceItem: para ofrecer servicios personalizados, usa un objeto FreeFormServiceItem que 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.

HTTP
GET https://mybusiness.googleapis.com/v4/categories?regionCode=SG&languageCode=EN&searchTerm=salon&view=FULL

Respuesta

La siguiente respuesta parcial devuelve todos los valores compatibles del objeto ServiceTypes.

{
    "categories": [
        {
            "displayName": "Hairdresser",
            "categoryId": "gcid:hair_salon",
            "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.

HTTP
GET https://mybusiness.googleapis.com/v4/categories:batchGet?regionCode=US&languageCode=en&categoryIds=gcid:electrician&view=FULL

Respuesta

La respuesta contiene todos los valores compatibles del objeto ServiceTypes correspondientes a gcid:electrician.

{
    "categories": [
        {
            "displayName": "Electrician",
            "categoryId": "gcid: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 en una ficha

Para obtener una lista actual de servicios, usa locations.getServiceList.

Solicitud

HTTP
GET https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/serviceList

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.updateServiceList 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:

HTTP
PATCH
https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/serviceList?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"
            }
         }
      }
   ]
}