Ya está disponible la API de Q&A. Es obligatorio llevar a cabo la migración. Consulta nuestro programa de desactivación para obtener más información sobre los puntos finales obsoletos.
La versión 1.1 de la API Notifications ya está disponible. Consulta el registro de cambios para obtener más información. También puedes registrarte en nuestra lista de distribución para recibir las novedades.

Añadir servicios

Organízate con las colecciones Guarda y clasifica el contenido según tus preferencias.

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

HTTP
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

HTTP
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:

HTTP
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"
            }
         }
      }
   ]
}