Perguntas frequentes

O que são as APIs GBP?

As APIs Business Profile são interfaces de programação que permitem aos desenvolvedores criar aplicativos para gerenciar os dados da conta e das unidades do Perfil da Empresa. Com elas, os comerciantes ou representantes deles podem gerenciar como os dados aparecem no Google e controlar quem administra essas informações. Os dados criados pelos usuários, como fotos, postagens e avaliações, também podem ser gerenciados nas APIs.

As APIs Business Profile oferecem quase os mesmos recursos que a interface do usuário do Perfil da Empresa, mas têm outras funcionalidades específicas. As atualizações do Google nas APIs ocorrem da mesma maneira que na interface do usuário.

Quem pode ter acesso às APIs GBP?

As APIs GBP não estão abertas ao público. Os usuários precisam pedir acesso para usá-las. Qualquer pessoa ou empresa que possa demonstrar um motivo comercial legítimo para acessar as APIs GBP têm o acesso aprovado. Algumas recomendações para demonstrar a legitimidade de uma empresa são:

  • Usar um endereço de e-mail comercial válido que esteja vinculado ao domínio da sua empresa.
  • Garantir que o site da empresa esteja atualizado e ativo.

O acesso às APIs GBP permite que um usuário consulte qualquer dado do Perfil da Empresa no Google?

Não. Mesmo que você use as APIs GBP, só poderá consultar os dados de um Perfil da Empresa no Google específico se tiver acesso a ele.

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

Os parceiros precisam obedecer às políticas do Perfil da Empresa no Google, além de todas as políticas e Termos e Condições da API.

Como os usuários recebem acesso às APIs GBP?

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

  1. Criar uma Conta do Google
  2. Usar o Perfil da Empresa
  3. Criar um projeto no Console de APIs do Google
  4. Solicitar acesso à API: os pedidos são analisados em até 14 dias

Como os usuários recebem acesso a uma determinada API dentro das APIs 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 a solicitação de acesso de um usuário for aprovada, ele receberá uma cota padrão para as oito APIs.

Como funciona o acesso às APIs GBP?

O acesso às APIs GBP é concedido no nível do projeto do Google Cloud. Se o usuário A solicitar acesso às APIs Google Business Profile para o projeto n.º 12345678, o acesso será concedido especificamente a esse projeto. Assim, qualquer pessoa, inclusive o usuário A, com acesso ao projeto n.º 12345678 do Google Cloud pode fazer chamadas para as APIs Google Business Profile. Os parceiros devem controlar o acesso ao projeto do Google Cloud de acordo com a necessidade para evitar abusos.

Vocês têm um resumo das APIs e exemplos de recursos delas?

Consulte a tabela a seguir para conhecer as diferentes APIs e os recursos disponíveis.

API Documentação de referência Exemplos de recursos
API Account Management Documentação
  • Gerencia o acesso a uma unidade.
  • Cria uma conta com o nome e o tipo especificados sob a conta principal.
  • Lista todas as contas do usuário autenticado.
  • Lista os convites pendentes para a conta especificada.
  • Move uma unidade de uma conta que o usuário possui para outra.
  • Atualiza o administrador da unidade especificada.
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 obtenham, criem, atualizem ou excluam Perfis de Empresas no Google.
  • Possibilita aos comerciantes obter ou atualizar atributos de perfil.
  • Permite que os comerciantes obtenham ou pesquisem redes e categorias de perfis.
API Lodging Documentação
  • Possibilita gerenciar dados de hospedagem (por exemplo, comodidades e políticas de uma propriedade) de empresas no Google. Essa API é específica para negócios que oferecem serviços de hospedagem, como hotéis. A API Lodging permite que os desenvolvedores atualizem os atributos de hospedagem de um Perfil da Empresa no Google.
API Place Actions Documentação
  • Possibilita gerenciar os links de posicionamento de ação nas empresas.
  • Redireciona os usuários para realizar ações como agendar um horário, reservar uma mesa e pedir comida.
API Notifications Documentação
  • Permite o gerenciamento das configurações de notificação em contas especificadas.
API Verifications Documentação
  • Inicia o processo de verificação de uma unidade.
  • Informa todas as opções de verificação qualificadas para uma unidade em um idioma específico.
API Q&A Documentação
  • Permite gerenciar as perguntas e respostas de uma unidade.
API Business Profile Performance Documentação
  • Permite que os comerciantes recebam insights de desempenho sobre as fichas das empresas deles no Google.
  • Os insights incluem impressões do Perfil da Empresa, solicitações de rotas, cliques de chamada, cliques para acessar o site, reservas, pedidos de comida, interações com o menu 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 em um Perfil da Empresa.
API Local Posts Documentação
  • Permite que os comerciantes obtenham, criem ou atualizem postagens locais.
API FoodMenus Documentação
  • Permite que os comerciantes obtenham, criem ou atualizem cardápios para um Perfil da Empresa.

Caso ainda tenha dúvidas sobre os dados disponíveis e/ou o acesso a eles, preencha este formulário.

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

Se você é um parceiro terceirizado que gerencia fichas para empresas:

Como as empresas autorizam um parceiro das APIs GBP a gerenciar suas fichas?

As empresas têm duas formas de conceder acesso a um parceiro terceirizado:

  • Configuração 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.

  • Acesso de proprietário ou gerente: se um comerciante (proprietário principal do GBP) adicionar um parceiro terceirizado como gerente do Perfil da Empresa no Google, o parceiro não precisará inserir as credenciais do comerciante para usar as APIs GBP quando quiser acessar e editar os dados do GBP.

    Observação: recomendamos que os parceiros terceirizados não se adicionem como proprietários do GBP, mas apenas como gerentes.

Se uma empresa tiver 10 ou mais unidades, existe uma maneira de fazer a verificação em massa?

Sim. Você pode solicitar a verificação em massa para 10 ou mais perfis. Após a verificação, as unidades de rede publicadas podem ser gerenciadas com as APIs Business Profile da mesma forma que as outras unidades, com algumas exceções. Por exemplo, os gerentes de local são tratados de modo diferente e podem adicionar a si mesmos a unidades de franquias.

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

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

Qual é a cota que posso solicitar?

A cota é um recurso limitado. A equipe de suporte das APIs GBP determina a qualificação da sua solicitação de aumento de cota com base no seu uso anterior da cota. Se o seu uso médio da cota for inferior a 70% dos limites atuais, seus limites de cota não terão aumento.

Os parceiros das APIs GBP podem criar uma conta de teste para produção?

Infelizmente, não existe uma maneira direta de criar uma ficha do GBP falsa para produção usando a interface do usuário ou a API GBP e depois fazer testes.

A maioria das fichas falsas é identificada pela nossa moderação e suspensa. A recomendação é usar uma ficha de cliente e trabalhar com ela após o expediente (desde que você não altere nenhuma informação principal, como nome, endereço, categoria) ou criar uma ficha para a sede da sua empresa. Se você quiser testar uma resposta da API para verificar uma ficha ou qualquer outra ação que exija uma ficha de produção, poderá usar respostas simuladas da API.