Registro de alterações

v4.9

Novos recursos

MoreHours
Agora, é possível definir mais horários de funcionamento como parte da ficha da empresa.
MoreHourTypes pode ser recuperado para cada categoria usando categories.batchGet.

Mudanças no comportamento

Descontinuação de uso das contas v4.x
accounts, accounts.admins, accounts.invitations e accounts.locations.admins agora estão desativados na API Google My Business. Consulte o registro de alterações da descontinuação de uso para mais informações.
Postagens com call-to-action
No segundo trimestre de 2021, postagens de CallToAction com o ActionType GET_OFFER não serão mais válidas.

v4.8

Novos recursos

Comodidades de hospedagem
Recuperação e atualização das acomodações de hospedagem. Mais informações
Adição do endpoint GetGoogleUpdated da hospedagem.
Adição do valor booleano canOperateLodgingData ao LocationState
.
Atributos para profissionais de saúde
Recuperação e atualização de HealthProviderAttributes. Mais informações
Inclusão do valor booleano canOperateHealthData em LocationState
.
Redes de seguros
Lista das redes de seguros aceitas pelos locais. Mais informações

Mudanças no comportamento

IDs de avaliação
Os códigos de avaliação estão com um novo formato. O novo ID será retornado em todas as respostas de API aplicáveis. Durante um curto período, os IDs de avaliação antigos ainda serão resolvidos se forem usados para chamar a API, mas é essencial atualizar todos aqueles que tiverem sido armazenados no seu sistema em até 30 dias, conforme exigido pelas nossas políticas, chamando o endpoint listReviews.
Empresa de serviço local
No primeiro trimestre de 2021, Address não será mais retornado no objeto Location para empresas com CUSTOMER_LOCATION_ONLY.

v4.7

Novos recursos

Cardápios
Agora é possível
recuperar e atualizar FoodMenus. Mais informações

v4.6

Novos recursos

Listas de serviços
Agora você pode recuperar e atualizar os serviços de uma empresa. Mais informações
Adição do valor booleano canModifyServiceList ao LocationState.
Indica se um local está qualificado para modificar as listas de serviços. Mais informações
ServiceTypes predefinidos para categorias
Os tipos de serviço predefinidos agora são incluídos no objeto categories. Mais informações
CategoryView
Agora é possível especificar uma visualização BASIC ou FULL para categorias. A visualização FULL retornará detalhes adicionais, como tipos de serviço. Mais informações
Método Categories.BatchGet
Com esse novo método, você pode inserir uma lista de categorias e retornar informações apenas sobre elas. Mais informações

Atualização 2 da v4.5 para COVID-19

Novos recursos

Tipo de postagem de alerta sobre a COVID-19
Agora você pode criar uma postagem sobre COVID_19 usando a API. Mais informações.

Atualização 1 da v4.5 para COVID-19

Novos recursos

Temporariamente fechado
Agora você pode definir uma empresa como CLOSED_TEMPORARILY usando a API. Mais informações.

v4.5

Novos recursos

Pub/Sub para perguntas e respostas
Agora você pode receber notificações do Google Cloud Pub/Sub sobre perguntas e respostas novas/atualizadas em um local. Mais informações.
Pub/Sub para estado da ficha da empresa
Agora você pode receber notificações do Google Cloud Pub/Sub sobre alterações no estado da ficha da empresa. Mais informações.

v4.4

Novos recursos

Verificações de empresas de serviços locais
Agora as empresas de serviços locais podem ser verificadas usando a API. Mais informações.
Contagem de seguidores
Agora você pode recuperar metadados sobre seguidores. Mais informações.
Grupos de usuários e de locais
Agora é possível criar grupos de usuários e de locais usando a API. Mais informações
O campo hasPendingEdits foi adicionado ao LocationState
Indica se as propriedades de um local estão no estado de edição pendente. Mais informações

Alterações no comportamento

Data de abertura
Agora é possível definir uma data de abertura futura para uma ficha de empresa.
PointRadius
Agora
PointRadius é somente leitura. Para editar ou criar empresas de serviços locais, é preciso usar o Places.

v4.3

Novos recursos

APIs de perguntas e respostas
Veja perguntas, publique respostas e adicione perguntas frequentes às unidades da sua empresa. Mais informações.
Avaliações de leitura em massa
Recupere avaliações de diversos locais em uma única chamada. Mais informações.
Recomendação de GoogleLocations
Veja locais não reivindicados que o sistema do Google presume serem seus. Mais informações.
Informar problemas do GoogleLocation
Informe problemas com resultados de RecommendedGoogleLocations ou GoogleLocations. Mais informações.
Enumeração de serviços para as seções de PriceList
Identifique uma seção de PriceList como contendo itens de ALIMENTOS ou SERVIÇOS. Mais informações.
Descrição de mídia
Adicione legendas ao fazer o upload de novas mídias. Mais informações.
Insights de CHAINS_QUERIES
Veja quantas vezes uma unidade foi exibida como resultado de uma pesquisa pela rede a que ela pertence. Mais informações.

Alterações no comportamento

Notificações para contas da organização e grupos de unidades
Agora as contas configuradas para receber notificações do Pub/Sub também receberão avisos referentes às fichas incluídas em uma conta da organização ou nos grupos de unidades que administram.
ListLocations para contas da organização e grupos de unidades
Agora, quando accounts.locations.list é chamado com uma conta da organização ou grupo de usuários, são exibidos todos os locais que podem ser acessados por essa conta.

v4.2

Novos recursos

APIs de verificação
Exiba e acione os métodos de verificação disponíveis para os locais não verificados. Mais informações.
API GoogleLocations
Pesquise locais existentes no Google para reivindicar ou recuperar uma vinculação e solicitar acesso a locais reivindicados. Mais informações.
Filtros de local expandidos
Agora há mais opções para limitar os resultados retornados de uma chamada de Locations.List. Mais informações.
Associação de rede
Indique a associação de uma unidade como parte de uma rede (por exemplo, Walmart, Target etc.). Mais informações.
Informações da organização
Agora as informações de contas da organização serão exibidas como parte dos objetos da conta. Mais informações.
Foto de perfil do avaliador
Agora são incluídos URLs para as fotos de perfil do avaliador no objeto de avaliação. Mais informações.

v4.1

Novos recursos

Mídia fornecida pelo cliente
Agora é possível recuperar e ver insights de fotos e vídeos gerados pelos usuários para as unidades que você possui e administra. Mais informações.
APIs de gerenciamento de administrador
Agora você pode exibir, aceitar e recusar convites relacionados à sua conta e locais. Mais informações.
Profile (descrição fornecida pelo comerciante)
Descreva sua empresa e compartilhe com os usuários o diferencial do seu negócio e dos seus produtos/serviços. Mais informações.
Campo openingDate
Informe a data de inauguração da sua unidade. Mais informações.
Postagens de tipo de oferta
Agora há um novo tipo de postagem no Google que ajuda os usuários a encontrar ofertas disponíveis nas suas unidades. Mais informações.

v4

Novos recursos

Posts no Google
Agora você pode criar postagens no Google diretamente pela API.
Upload de fotos
Agora é possível fazer o upload de fotos diretamente pela API, além de pelo URL existente.
Filtragem/ativação de notificações
Agora você pode filtrar quais notificações são enviadas para tópicos do Pub/Sub. Assim, as notificações futuras usarão essa definição como base para serem encaminhadas apenas aos usuários que as ativaram, e não para todas as pessoas.
Notificações sobre UPDATED_REVIEW
Agora você pode se inscrever para receber notificações em tempo real sobre atualizações de avaliações dos clientes.
Suporte para grupos de usuários
Agora a API Google My Business é compatível com contas de grupo de usuários.

Alterações incompatíveis com versões anteriores

  • As fotos, que antes eram um campo de objetos de location, agora são um recurso no local (accounts/account_ID/locations/location_ID/photos).

  • O campo Country do endereço mudou para region_code, e sub_locality mudou para sublocality.

  • O campo Ownership descontinuado foi removido.

  • Anteriormente, os coproprietários de contas e locais não podiam ser distinguidos dos proprietários principais pela API, uma vez que todos apareciam como OWNER. Agora, os proprietários principais receberão o papel OWNER, e os outros proprietários, CO_OWNER.

  • AccountType.BUSINESS agora se chama AccountType.LOCATION_GROUP.

  • Ao usar uma máscara de campo para atualizar os locais, forneça update_mask no lugar do field_mask existente.

  • A mensagem de categoria usada para primary_category e additional_categories não tem mais um formulário legível por humanos. Os usuários precisam usar o serviço de categorias da API Google My Business para ver os nomes de categoria traduzidos.

v3.3

Novos recursos

Menus estruturados

Agora você pode fazer o seguinte:

  • Adicionar, atualizar ou excluir vários menus em um determinado local

  • Incluir várias seções em um menu

  • Exibir os itens de menu com nome, descrição, preço e fotos

v3.2

Novos recursos

Insights
Agora você pode acessar estatísticas da região e aprimorar as métricas pela API.
Notificações
Agora você pode se inscrever para receber notificações em tempo real sobre as novas atualizações do Google.

Alterações incompatíveis com versões anteriores

  • Os campos de UrlAttributeValue languageCodes e platforms que não eram mais usados foram removidos.

  • Agora SAME no tipo enumerado de propriedade descontinuada só se aplicará se o local duplicado tiver o mesmo proprietário principal. Antes, o comportamento tinha como base um cálculo de propriedade mais complexo.

v3.1

Novos recursos

Notificações
Agora você pode se inscrever para receber notificações em tempo real sobre novas avaliações.
URLs do Google Maps
Os URLs do Google Maps são incluídos nas respostas de local, permitindo que os usuários as vinculem facilmente ao Maps.
Estados de local
Agora há estados de local adicionais que indicam quando a ficha da empresa é publicada, desativada e tem verificação pendente.
Sinalização de reabertura
A sinalização canReopen diferencia os locais permanentemente fechados que podem ser reabertos daqueles que não serão mais reabertos.
Atributos
Agora há suporte para atributos de URL e Enum.
Endpoint da categoria
Veja uma lista de categorias compatíveis por país e idioma (substitui os arquivos CSV).

v3

Novos recursos

Avaliações
Agora você pode recuperar e responder a avaliações de empresas pela API.
Atributos
Adicione informações adicionais e específicas da categoria sobre os locais.
Encontrar local correspondente
Encontre e associe manualmente os locais existentes nos mapas à unidade da sua empresa.
Transferir local
Nova ação em Location :transfer. Permite transferir um local de uma conta (comercial ou pessoal) para outra.
Foto preferida
Indique qual foto você quer que apareça primeiro no Google Maps e na Pesquisa.
Novos filtros de pesquisa
Agora há novos filtros de pesquisa, como any_google_updates, is_suspended e is_duplicate.
Novos estados de local
Agora há novos estados de local, como is_verified e needs_reverification.
Melhorias no URL de foto
Agora a API aceita URLs de fotos sem um sufixo de formato de imagem.

Alterações incompatíveis com versões anteriores

  • Agora só é possível atualizar as fotos de unidades que têm uma página do Google+. Antes, elas eram aceitas e descartadas sem aviso prévio.

  • Agora os campos location_name e category_name são apenas para saída. Use os IDs de categoria apenas ao definir categorias.

  • As máscaras de campo não podem mais incluir o prefixo location. nos campos usados.

  • Agora as operações de criação/atualização consideram o local como payload do corpo. Os outros parâmetros são movidos para a string de consulta.

v2

Alterações incompatíveis com versões anteriores

  • Agora você precisa especificar um request_id nas chamadas para CreateLocation. Esse ID precisa ser exclusivo, porque ele ajuda a evitar a criação de locais duplicados na sua conta. Se você tentar criar um local em que o ID de solicitação corresponda a outro já existente, o sistema retornará esse local para evitar uma cópia.

    • business_hours em Local foi renomeado para regular_hours.