Google Business BulkPublish

API do Google Business

Publique, agende e gerencie o Google Business a partir do seu próprio código. Uma API REST e uma chave cobrem o Google Business e todas as outras redes que você conectar, então você escreve a integração uma vez só.

Obter uma chave de API grátis Ler a referência da API

Integração do Google Business com o BulkPublish

O que a API do Google Business cobre

Tudo abaixo faz parte da API publicada e já funciona com o Google Business.

Recurso	Endpoint
Criar, agendar, editar e publicar posts	`POST /api/posts`
Enviar imagens e vídeos	`POST /api/media`
Encontrar o próximo horário livre da sua fila	`GET /api/posts/queue-slot`
Criar agendamentos recorrentes	`POST /api/schedules`
Publicar novos itens de um feed RSS	`POST /api/rss-feeds`
Ler e responder avaliações	`GET /api/inbox/conversations, POST /api/inbox/conversations/{id}/messages`
Verificar se a conexão está saudável	`GET /api/channels/{id}/health`
Consultar o uso do seu plano	`GET /api/quotas/usage`

Tipos de post que você pode publicar no Google Business

Escolha o tipo com postTypeOverrides. Um tipo que o Google Business não oferece é recusado antes de qualquer coisa entrar na fila.

Tipo de publicação	Mídia
`standard` Update	Opcional, até 1 imagem
`event` Event	Opcional, até 1 imagem
`offer` Offer	Opcional, até 1 imagem

Agende um post do Google Business com curl

Três requisições: encontre seu canal, envie o arquivo se o post tiver um e crie o post. Troque a chave por uma de Configurações, depois Chaves de API, e o 12 pelo id do seu próprio canal.

1. Liste seus canais e anote o id da sua conta do Google Business.

curl https://app.bulkpublish.com/api/channels \
  -H "Authorization: Bearer bp_your_key_here"

2. Envie o arquivo. A resposta traz o id da mídia, usado como mediaFiles abaixo.

curl -X POST https://app.bulkpublish.com/api/media \
  -H "Authorization: Bearer bp_your_key_here" \
  -F "file=@photo.jpg"

3. Crie o post.

curl -X POST https://app.bulkpublish.com/api/posts \
  -H "Authorization: Bearer bp_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
  "content": "Fresh bread every morning from 7am",
  "channels": [{ "channelId": 12 }],
  "status": "scheduled",
  "scheduledAt": "2026-12-01T09:00:00Z",
  "mediaFiles": [101],
  "platformSpecific": {
    "gmb": {
      "ctaType": "LEARN_MORE",
      "ctaUrl": "https://example.com/offer"
    }
  }
}'

A resposta é o post criado, com seu id e status. Busque-o depois com GET /api/posts/{id} para ver como foi.

Opções do Google Business

Envie estas opções dentro de platformSpecific, na chave do Google Business.

Opção	O que faz	Aceita
`ctaType`	Botão de chamada para ação	`LEARN_MOREBOOKORDERSHOPSIGN_UPCALL`
`ctaUrl`	Link da chamada para ação	texto
`eventTitle`	Título do evento	texto
`startDate`	Data de início do evento	texto
`startTime`	Hora de início do evento	texto
`endDate`	Data de término do evento	texto
`endTime`	Hora de término do evento	texto
`couponCode`	Código de cupom da oferta	texto
`redeemOnlineUrl`	Link para resgatar a oferta online	texto
`termsConditions`	Termos da oferta	texto

Análises do Google Business pela API

Os números por post não estão disponíveis para o Google Business, então não há nada para ler.

Comentários e mensagens

Pela API você pode ler e responder avaliações.

Ler comentários funciona em todos os planos. Responder comentários exige um plano pago, e a caixa de entrada faz parte do Pro e do Business. Enquanto um recurso não estiver ativado na sua conta, a API responde 403 com um código que você pode verificar.

Acesso à API em todos os planos

Todos os planos incluem chaves de API, inclusive o Free. Veja o que cada um permite.

Plano	Chaves de API	Requisições por dia
Free	1	30
Pro	5	5.000
Business	10	50.000

Construir direto no Google Business ou usar o BulkPublish

Ir direto é uma escolha válida, principalmente se você precisa de algo que o BulkPublish não oferece. Isto é o que Google Business Profile API exige de você, conferido com a documentação em outubro de 2026.

Você precisa registrar um app de desenvolvedor no Google Business antes de poder publicar.
Publicar em contas que não são a sua exige que o Google Business aprove seu app antes.
A mídia é buscada em uma URL pública que você precisa hospedar.

O BulkPublish cuida da conexão por você: renova os tokens, confere cada post com as regras do Google Business antes de entrar na fila e informa no post qual destino falhou, então seu código faz uma única requisição.

Ler a documentação oficial

Prefere pedir a um assistente?

Claude, ChatGPT e Cursor fazem o mesmo pelo servidor MCP do Google Business, com comandos em vez de código.

Ver o servidor MCP do Google Business

Prefere um calendário a código?

A mesma conta do Google Business pode ser agendada pelo app, com calendário de conteúdo e envio em massa.

Ver o agendador do Google Business

Perguntas frequentes

Dúvidas comuns sobre a API do Google Business.

Existe uma API do Google Business que eu possa usar sem construir a integração sozinho?

Sim. O BulkPublish oferece o Google Business por meio da sua API REST. Conecte sua conta do Google Business uma vez e depois publique, agende e gerencie com uma chave. A mesma chave funciona em todas as outras redes que você conectar.

O que posso publicar no Google Business pela API?

Os tipos de post são Update, Event e Offer. Cada um é conferido com as regras de mídia do Google Business antes de entrar na fila, então uma requisição que o Google Business recusaria falha na hora, com um erro claro.

Posso agendar posts do Google Business pela API?

Sim. Envie o status "scheduled" com um horário em scheduledAt e um timezone, ou peça antes o próximo horário livre da sua fila. Agendamentos recorrentes e feeds RSS também estão disponíveis.

Posso ler as análises do Google Business pela API?

Números por post não. Eles não estão disponíveis para o Google Business.

Posso ler e responder comentários ou mensagens do Google Business pela API?

Sim. Você pode ler e responder avaliações. Responder comentários exige um plano pago, e a caixa de entrada faz parte do Pro e do Business.

A API do Google Business custa algo a mais?

Não. O acesso à API está em todos os planos. O Free inclui 1 chave e 30 requisições por dia, o Pro 5 chaves e 5.000 por dia, o Business 10 chaves e 50.000 por dia.

Preciso de uma conta de desenvolvedor do Google Business ou de uma revisão de app?

Não para usar o BulkPublish. Você conecta sua conta do Google Business na página Canais e publica com uma chave do BulkPublish. Se preferir construir direto na API do Google Business, a seção acima lista o que ela exige de você.

Um assistente de IA também consegue fazer isso?

Sim. A página do servidor MCP do Google Business mostra como conectar Claude, ChatGPT ou Cursor e o que pedir.

A mesma chave e o mesmo formato de requisição funcionam em 15 redes.