A API Verifications e a API Business Information foram lançadas. O trabalho de migração é obrigatório. Consulte nossa programação da descontinuação para ver mais informações sobre endpoints obsoletos. Você também pode se inscrever na nossa lista de e-mails para receber informações relacionadas.

Adicionar serviços

As empresas podem incluir os serviços que oferecem nas fichas do GMB (Google Meu Negócio), como aqueles prestados em uma loja ou no local do cliente.

Qualificação e formato

Nem todas as empresas podem adicionar serviços à ficha do GMB. Para verificar a qualificação, confira o estado de canModifyServiceList em Metadata.

Um serviço é representado como um ServiceItem, compatível com os dois formatos a seguir:

  • StructuredServiceItem: os serviços predefinidos do Google podem ser representados como StructuredServiceItem, que contém um serviceTypeId.
  • FreeFormServiceItem: para oferecer serviços personalizados, use um FreeFormServiceItem que contenha um marcador.

Como listar serviços predefinidos por nome de categoria

Para pesquisar serviços predefinidos em uma categoria pelo nome dela, use categories.list. Uma solicitação de todas as categorias que incluem o nome salon em Singapura é mostrada na seção "Solicitação" a seguir.

Solicitação

O parâmetro CategoryView precisa ser definido como FULL.

HTTP
GET https://mybusinessbusinessinformation.googleapis.com/v1/categories?regionCode=SG&languageCode=EN&filter=displayname=salon&view=FULL

Resposta

A resposta parcial a seguir retorna todos os ServiceTypes compatíveis.

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

Listar serviços predefinidos por ID de categoria

Para pesquisar serviços predefinidos pelo ID de categoria específico, use categories.batchGet. Uma solicitação de detalhes com o ID de categoria gcid:electrician nos Estados Unidos é mostrada na seção "Solicitação" a seguir.

Solicitação

O parâmetro CategoryView precisa ser definido como FULL.

HTTP
GET https://mybusinessbusinessinformation.googleapis.com/v1/categories:batchGet?regionCode=US&languageCode=en&names=gcid:electrician&view=FULL

Resposta

A resposta contém todos os ServiceTypes compatíveis para 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"
                }
            ]
        }
    ]
}

Listar serviços existentes em uma ficha

Para ver a lista atual dos serviços, use locations.get e defina readMask=serviceItems

Solicitação

HTTP
GET https://mybusinessbusinessinformation.googleapis.com/v1/locations/{locationId}?readMask=serviceItems

Resposta

Veja abaixo um exemplo de resposta

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

Definir serviços para uma ficha da empresa

Para atualizar serviços, use locations.patch e updateMask=serviceItems. Não é possível atualizar serviços separadamente.

Para definir serviços com um StructuredServiceItem e um FreeFormServiceItem, consulte o exemplo a seguir:

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