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 de local e da conta 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:
- Use um endereço de e-mail comercial válido que esteja vinculado ao domínio da sua empresa.
- Garanta 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 à API GBP?
Você precisa atender aos seguintes requisitos para criar seu primeiro aplicativo cliente:
- Crie uma Conta do Google.
- Testar o Perfil da Empresa.
- Crie um projeto no Console de APIs do Google.
- Solicitar acesso à API: as solicitações são analisadas 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 à API GBP?
O acesso à API 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 precisam 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 |
|
API Business Information | Documentação |
|
API Lodging | Documentação |
|
API Place Actions | Documentação |
|
API Notifications | Documentação |
|
API Verifications | Documentação |
|
API Q&A | Documentação |
|
API Business Profile Performance | Documentação |
|
API Media | Documentação |
|
API Reviews | Documentação |
|
API Local Posts | Documentação |
|
API FoodMenus | Documentação |
|
Se você tiver dúvidas sobre os dados disponíveis ou como acessá-los, preencha este formulário.
Como os parceiros podem configurar a estrutura das contas para usar as APIs do GBP?
Se você é um parceiro terceirizado que gerencia fichas para empresas:
- Solicite uma conta de organização do GBP como agência.
- Aprenda sobre os conceitos de grupos de usuários e grupos de unidades da empresa.
- Consulte este guia para saber como gerenciar unidades em nome das empresas.
Como as empresas autorizam um parceiro das APIs GBP a gerenciar as 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 parceiro terceirizado for adicionado como gerente do Perfil da Empresa no Google pelo comerciante, que é o proprietário principal do GBP, o parceiro terceirizado não precisará usar as credenciais do comerciante para usar as APIs GBP para editar e acessar 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 mais de 10 perfis. Após a verificação, as unidades de rede publicadas podem ser gerenciadas com as APIs do Perfil da Empresa 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?
Nã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.