Como Integrar o GMBapi.com no BigQuery
A integração de dados locais do GMBapi.com com o BigQuery oferece novas capacidades poderosas, permitindo análise de dados avançada, relatórios personalizados e integração perfeita com as suas ferramentas existentes. Este guia acompanha-o passo a passo na configuração da integração do BigQuery e na maximização do seu potencial para o seu negócio.
O Que Obtém com a Nossa Integração BigQuery
Com esta integração, pode:
Aceder a tabelas BigQuery organizadas e estruturadas
(sem despejos de dados brutos).
As tabelas são atualizadas diariamente com os dados mais recentes dos seus Perfis de Empresa.
Gere os seus relatórios e estatísticas personalizados do Google
Business Profile.
Integre as nossas informações acionáveis diretamente na sua própria plataforma, software ou website.
Utilize o código fornecido para replicar as visualizações do nosso website nos seus relatórios ou no seu website!
Requisitos de Integração com o BigQuery e o GMBapi.com
Antes de configurar a sua integração com o BigQuery, certifique-se do seguinte:
Tem uma conta GMBapi.com ativa com todas as suas localizações sincronizadas!
Tem uma conta de faturação ativa associada ao seu Projeto Google Cloud.
Criou uma conta de serviço com os seguintes papéis:BigQuery Data Editor é necessário para criar/editar uma tabela no seu GCPBigQuery Job User - Necessário para agendar e executar consultas
Partilhe o e-mail da conta de serviço e o(s) nome(s) das contas em app.gmbapi.com que devem receber acesso.
Assim que o acesso às tabelas for partilhado, pode agendar consultas usando a conta de serviço criada no seu próprio projeto BigQuery.
Guia Passo a Passo para Configurar a Integração com o BigQuery
*Se já criou uma conta Google Cloud Platform com a faturação configurada, pode saltar para Passo 3
Passo 1: Criar um Projeto Google Cloud
Navegue até à Google Cloud Platform.
Crie um novo projeto ou selecione um existente.
Passo 2: Configurar os Detalhes de Faturação
Aceda à Google Cloud Console .
No menu do lado esquerdo, selecione “Faturação ” → depois clique em “Gerir Contas de Faturação ”.
Escolha a organização apropriada (se aplicável) e clique em “Criar Conta ”.
Introduza um nome para a sua conta de faturação, selecione o seu país e ligue-a à organização correta.
Adicione um método de pagamento válido e envie para ativar a faturação.
Passo 2.1. Associe a Sua Conta de Faturação ao Projeto
Na Cloud Console, selecione o projeto que pretende ligar.
Navegue até à secção “Faturação ”.
Se solicitado, selecione a conta de faturação a associar a este projeto.
Para mudar de contas de faturação mais tarde, clique em “Gerir Contas de Faturação ” e escolha a opção apropriada.
⚠️ Nota: Sem a faturação ativada, as consultas programadas e outras operações do BigQuery não serão executadas.
Passo 3: Criar e Configurar uma Conta de Serviço
No seu projeto Google Cloud, vá a IAM e Administração > Contas de Serviço .
Clique em Criar Conta de Serviço .
Dê um nome à sua conta de serviço (por exemplo,
“Integração com o BigQuery ”). Atribua as seguintes funções para garantir que a conta de serviço tem acesso para agendar consultas e criar tabelas no GCP: Editor de Dados do BigQuery Utilizador de Tarefas do BigQuery
Conclua a criação da conta de serviço e copie o endereço de e-mail gerado.
Passo 4: Partilhe o E-mail da Conta de Serviço
Partilhe o e-mail da conta de serviço com a nossa equipa de suporte ou através do seu portal de gestão de integrações.
Além disso, confirme a conta GMBapi.com (grupo de localizações GBP) à qual pretende que a conta de serviço aceda.
Os dados são armazenados por conta GBP e é necessário acesso explícito para cada uma.
Nota: Se precisar de acesso a contas GBP adicionais no futuro, basta repetir o Passo 3 em diante para cada nova conta.
Passo 5: Configurar o BigQuery
Navegue até ao BigQuery na sua Google Cloud Console.
Crie um novo conjunto de dados ou selecione um existente.
Importante : Defina a região do conjunto de dados para europe-west4 (Países Baixos).
Isto é necessário para transferir dados usando uma consulta agendada; as regiões de origem e destino devem corresponder. Uma vez que o GMBapi.com armazena dados nos Países Baixos, o seu conjunto de dados também deve estar nessa região para permitir a transferência.
Nota: Se necessário, pode posteriormente replicar ou migrar os seus dados para outra região. Saiba mais 👉 Replicação de Dados BigQuery
Passo 6: Aceda e Utilize os Seus Dados
Uma vez concedido o acesso, tem duas formas principais de trabalhar com os seus dados:
Consultas Agendadas (Recomendado)
Utilize consultas agendadas no seu projeto BigQuery para copiar os dados organizados de GMBapi.com para o seu próprio conjunto de dados. Isto garante acesso e propriedade dos dados a longo prazo.
Utilize as credenciais da conta de serviço ao configurar consultas agendadas.
Acesso Direto através da API BigQuery
Em alternativa, pode utilizar as credenciais da conta de serviço para aceder diretamente aos dados através da API BigQuery no seu código.
✅ Recomendação: Para um melhor controlo, portabilidade e preparação para o futuro, recomendamos a criação de uma cópia das tabelas no seu próprio projeto GCP, seja através de consultas agendadas ou programaticamente utilizando a API BigQuery.
A nossa equipa fornecerá modelos SQL prontos a usar e snippets de código visual para o ajudar a começar rapidamente.
Exemplos de Casos de Uso para Integração BigQuery
Relatórios Personalizados
Gere relatórios adaptados às necessidades específicas do seu negócio, aprofundando as métricas de desempenho de SEO local.
Integração de Plataforma
Integre as nossas informações de forma contínua no seu CRM, painel do site ou qualquer plataforma de análise que a sua empresa utilize.
Análise Avançada
Aproveite as poderosas capacidades analíticas do BigQuery para identificar tendências, oportunidades e insights acionáveis mais rapidamente do que nunca.
Obter Ajuda
Se ficar preso em qualquer ponto do processo, a nossa equipa está aqui para o ajudar. Não hesite em contactar-nos se tiver dúvidas sobre a configuração de permissões, a criação de contas de serviço ou a agendamento de consultas. Estamos empenhados em tornar o seu processo de integração suave e bem-sucedido.
Solicite acesso a um grupo de localização e inicie um período de avaliação gratuito. Depois:
Contacte a nossa equipa de suporte.
Configure o seu projeto BigQuery.
Certifique-se de que a sua conta de faturação está ativa.
Crie uma conta de serviço com as funções corretas.
Partilhe o e-mail da conta de serviço e os nomes de conta relevantes em app.gmbapi.com.
Comece a agendar consultas para obter tabelas de dados estruturados.
Para assistência detalhada, aceda à nossa documentação abrangente ou contacte diretamente a nossa equipa de suporte para otimizar a sua experiência de integração com o BigQuery.
Aproveite todo o potencial dos seus dados de SEO local com a nossa robusta integração BigQuery, tornando as decisões mais inteligentes e baseadas em dados mais fáceis do que nunca.
Perguntas Frequentes Sobre a GMBapi.com e a Integração BigQuery
Perguntas Frequentes
Para configurar a integração, precisa de uma conta GMBapi.com ativa com as suas localizações sincronizadas, um Projeto Google Cloud com faturação ativada e uma conta de serviço com as funções BigQuery corretas. Uma vez configurados, a nossa equipa pode conceder acesso a tabelas BigQuery estruturadas que são atualizadas diariamente com os dados do seu Perfil de Empresa do Google.
A conta de serviço deve ter as funções BigQuery Data Editor e BigQuery Job User. A função Data Editor permite que a conta crie e edite tabelas dentro do seu projeto, enquanto a função Job User possibilita agendar e executar consultas. Sem estas funções, a sua integração e transferências de dados não funcionarão corretamente.
O seu conjunto de dados deve estar localizado em europe-west4 porque a GMBapi.com armazena os seus dados nos Países Baixos. O Google exige que as regiões de origem e destino correspondam para que as transferências de dados funcionem. Se as regiões não estiverem alinhadas, as suas consultas agendadas e pipelines de dados falharão. Se necessário, pode posteriormente replicar ou migrar os dados para uma região diferente, mas o conjunto de dados inicial deve estar em europe-west4.
As tabelas BigQuery são atualizadas diariamente com os dados mais recentes dos seus Perfis de Empresa do Google. Isso garante que as suas análises, dashboards e relatórios reflitam sempre as métricas de desempenho de SEO local mais recentes, sem a necessidade de atualizações manuais.
Pode aceder aos seus dados de duas formas principais. O método recomendado é usar consultas agendadas, que copiam as tabelas estruturadas da GMBapi.com para o seu próprio projeto BigQuery para que mantenha controlo e propriedade a longo prazo. Alternativamente, pode usar a API BigQuery para consultar os dados diretamente com as credenciais da sua conta de serviço. A maioria das empresas escolhe consultas agendadas, pois estas proporcionam mais flexibilidade e portabilidade.
Sim, a integração foi concebida para funcionar perfeitamente com as suas ferramentas existentes. Assim que os seus dados estiverem disponíveis no BigQuery, pode conectá-los diretamente aos seus dashboards, sistemas de CRM, websites ou plataformas de análise. Muitas empresas usam esta capacidade para construir dashboards personalizados ou integrar insights nos seus fluxos de trabalho existentes.
Se encontrar algum problema, seja na configuração da conta de serviço, na ativação da faturação ou no agendamento de consultas, pode contactar a equipa de suporte da GMBapi.com. A nossa equipa está disponível para o guiar durante o processo e garantir que a sua integração decorra sem problemas do início ao fim.
