Atenção: a v4.7 da API foi lançada. Consulte o registro de alterações. As postagens relacionadas à COVID-19 ainda estão permitidas temporariamente para redes.

Registro de alterações

v4.6

Novos recursos

Listas de serviços
Agora você pode recuperar e atualizar os serviços de uma empresa. Mais informações
O valor booleano canModifyServiceList foi adicionado 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 de categorias. 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 de 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 da 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 aos locais 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 que você é o proprietário. 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 um local foi exibido como resultado de uma pesquisa pela rede a que ele pertence. Mais informações.

Alterações no comportamento

Notificações para contas da organização e grupos de locais
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 locais que administram.
ListLocations para contas da organização e grupos de locais
Agora, quando accounts.locations.list é chamado com uma conta da organização ou de 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 de modo a solicitar acesso a locais reivindicados. Mais informações.
Filtros de local expandidos
Agora há opções adicionais para limitar os resultados retornados de uma chamada de Locations.List. Mais informações.
Associação de rede
Indique a associação de um local 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.
Postagens de produtos
Agora há um novo tipo de postagem de local para fornecer conteúdo relacionado ao produto (por exemplo, nome e preço). 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 os locais de que você é proprietário e administrador. Mais informações.
APIs de gerenciamento de administrador
Agora você pode exibir, aceitar e recusar convites relacionados à conta e a 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 das suas ofertas. Mais informações.
Campo openingDate
Informe a data em que seu local foi inaugurado. 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 nos seus locais. 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 obsoleto foi removido.

  • Anteriormente, os co-proprietá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. 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 recuperar insights de local 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 na enumeração de propriedade obsoleta 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 ao local 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 locais 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 código de solicitação corresponda a outro que já exista, o sistema retornará esse local existente para impedir que uma cópia seja gerada.

    • business_hours em Local foi renomeado para regular_hours.