Perguntas frequentes

O que são as APIs do GBP?

As APIs do Perfil da Empresa são interfaces de programação que permitem aos desenvolvedores criar aplicativos para gerenciar a conta do Perfil da Empresa e os dados de local. Com as APIs, os comerciantes ou representantes deles podem gerenciar como os dados são apresentados no Google e controlar quem cogerencia essas informações. Os dados criados pelo usuário, como fotos, postagens e avaliações, também podem ser gerenciados nas APIs.

As APIs do Perfil da Empresa oferecem quase os mesmos recursos que a interface do usuário do Perfil da Empresa, com alguns outros recursos específicos. Os usuários das APIs podem esperar que as atualizações do Google ocorram da mesma forma que fazem para os usuários da interface do usuário.

Quem pode ter acesso às APIs do GBP?

As APIs do GBP não estão abertas ao público. Os usuários precisam solicitar acesso às APIs do GBP para usá-las. O acesso às APIs do GBP é aprovado para qualquer indivíduo ou empresa que possa demonstrar um motivo comercial legal para acessar as APIs. Estas são algumas recomendações para demonstrar legalidade como uma empresa:

  • Use um endereço de e-mail comercial válido vinculado ao seu domínio comercial.
  • Verifique se o site da empresa está atualizado e ativo.

Ter acesso às APIs do GBP permite que um usuário consulte dados do Perfil da Empresa no Google?

Não. Mesmo que você tenha acesso às APIs do GBP, não será possível consultar os dados de um Perfil da Empresa no Google, a menos que você tenha acesso a esse Perfil da Empresa específico.

Quais são as políticas relevantes para os usuários da API GBP?

Os parceiros precisam estar em conformidade com as políticas do Perfil da Empresa no Google e de todas as políticas e os Termos e Condições da API.

Como os usuários têm acesso à API GBP?

Você precisa atender aos seguintes pré-requisitos para criar seu primeiro aplicativo cliente:

  1. Crie uma Conta do Google.
  2. Conheça o Perfil da Empresa.
  3. Crie um projeto no Console de APIs do Google.
  4. Solicitar acesso à API: as solicitações são analisadas em até 14 dias.

Como os usuários podem acessar uma determinada API na API GBP?

Existem oito APIs associadas ao Perfil da Empresa que precisam ser ativadas no Console de APIs do Google:

  • API Google My Business 4.9, que inclui as seguintes chamadas de API de recursos importantes:
    • FoodMenus
    • Media
    • Reviews
    • LocalPosts
  • API My Business Account Management
  • API My Business Lodging
  • API My Business Place Actions
  • API My Business Notifications
  • API My Business Verifications
  • API My Business Business Information
  • API My Business Q&A
  • API Business Profile Performance

Se o aplicativo de um usuário que solicita acesso for aprovado, ele receberá uma cota padrão padrão para todas as oito APIs.

Como funciona o acesso à API GBP?

O acesso à API GBP é concedido no nível do projeto do Google Cloud. Se um usuário A tiver solicitado acesso à API Google Business Profile para o projeto 12345678, o acesso será concedido ao projeto 12345678. Assim, qualquer usuário, incluindo o A com acesso ao projeto do Google Cloud, pode fazer chamadas para as APIs do Perfil da Empresa no Google. Os parceiros precisam controlar o acesso ao projeto do Google Cloud com base na necessidade de acesso para evitar abusos.

Você tem um resumo das APIs e exemplos de recursos?

Consulte a tabela a seguir para conhecer as diferentes APIs e os recursos de cada uma.

API Documentação de referência Exemplos de recursos
API Account Management Documentação
  • Gerenciar o acesso a um local.
  • Cria uma conta com o nome e o tipo especificados no pai indicado.
  • Lista todas as contas do usuário autenticado.
  • Lista os convites pendentes da conta especificada.
  • Move um local de uma conta do usuário para outra.
  • Atualiza o administrador para o local especificado.
API Business Information Documentação
  • A API Business Information permite gerenciar o ciclo de vida do perfil e adicionar ou gerenciar informações comerciais no GBP.
  • Permite que os comerciantes acessem, criem, atualizem ou excluam Perfis da Empresa no Google.
  • Permite que os comerciantes recebam ou atualizem atributos do perfil.
  • Permite que os comerciantes acessem ou pesquisem redes e categorias de perfil.
API Lodging Documentação
  • Permite o gerenciamento de dados de hospedagem, por exemplo, comodidades e políticas da propriedade para empresas no Google. Ela é específica para empresas que oferecem serviços de hospedagem, como hotéis. Com a API Lodging, os desenvolvedores podem atualizar os atributos de hospedagem de um Perfil da Empresa no Google.
API Place Actions Documentação
  • Permite o gerenciamento de links de ação de lugar nas empresas.
  • Redirecione os usuários para realizar ações como agendar um horário, reservar uma mesa ou pedir comida para entrega.
API Notifications Documentação
  • Ativa o gerenciamento das configurações de notificação para contas especificadas.
API Verifications Documentação
  • Inicia o processo de verificação de um local.
  • Informa todas as opções de verificação qualificadas para um local em um idioma específico.
API Q&A Documentação
  • Permite o gerenciamento de perguntas e respostas de um local.
API Business Profile Performance Documentação
  • Permite que os comerciantes busquem insights de desempenho sobre a ficha da empresa deles no Google.
  • Os insights incluem impressões comerciais, solicitações de rotas, cliques de chamada, cliques para acessar o site, agendamentos, pedidos de comida, interações com o cardápio e muito mais.
API Media Documentação
  • Permite que os desenvolvedores de API façam upload de fotos e vídeos para um Perfil da Empresa.
API Reviews Documentação
  • Permite que os comerciantes recebam avaliações e respondam a avaliações no Perfil da Empresa.
API Local Posts Documentação
  • Permite que os comerciantes acessem, criem ou atualizem postagens locais.
API FoodMenus Documentação
  • Permite que os comerciantes acessem, criem ou atualizem cardápios em um Perfil da Empresa.

Como os parceiros podem configurar a estrutura das contas para usar as APIs do GBP?

Se você é um parceiro terceirizado que faz o gerenciamento de fichas para empresas:

Como as empresas autorizam um parceiro da API GBP para gerenciar a ficha da empresa?

As empresas concedem acesso a um parceiro de terceiros de duas maneiras:

  • Configuração do OAuth:consulte este guia para entender como as plataformas de parceiros terceirizados usam as credenciais do comerciante para editar e acessar os dados do Perfil da Empresa no Google em nome do comerciante ou da empresa.

  • Acesso de proprietário ou gerente:se um parceiro de terceiros for adicionado como gerente do Perfil da Empresa no Google pelo comerciante, que precisa ser o proprietário principal do GBP, esse parceiro não precisará usar as credenciais do comerciante para editar e acessar dados do GBP.

    Observação:é altamente recomendável que os parceiros de terceiros não se adicionem como proprietários do GBP e adicionem a si mesmos apenas como administradores.

Se uma empresa tem mais de 10 locais, existe uma forma de verificação em massa?

Sim. Você pode solicitar a verificação em massa para mais de 10 perfis. Após a verificação, os locais de rede publicados podem ser gerenciados com as APIs do Perfil da Empresa da mesma forma que os outros locais, com algumas exceções. Por exemplo, os gerentes de local são tratados de modo diferente e podem adicionar a si mesmos a locais de franquias.

Quais são os limites de cota para as diversas APIs?

Os limites de cota padrão estão listados na seção Limites de uso. Se você precisar aumentar os limites, envie uma solicitação de cota padrão.

Quantas cotas posso solicitar?

A cota é um recurso limitado. A equipe de suporte da API GBP determina a qualificação da solicitação de aumento de cota confirmando seu uso anterior da cota. Se o uso médio da cota for inferior a 70% dos limites atuais, um aumento nos limites poderá ser negado.

Os parceiros da API GBP podem criar uma conta de teste para produção?

Não. Não há uma maneira direta de criar uma listagem falsa do GBP na produção usando a interface ou a API do GBP e fazer um teste com ela.

A maioria das listagens falsas criadas é sinalizada pela nossa moderação e suspensa. O conselho é usar uma ficha de cliente e trabalhar com ela após o horário comercial, desde que você não altere as informações principais dela, como nome, endereço ou categoria, ou crie uma ficha para a sede da empresa. Se você quiser testar uma resposta de API para verificar uma lista ou qualquer outra ação que exija uma lista de produção, use respostas simuladas da API.