Google Business BulkPublish

API di Google Business

Pubblica, programma e gestisci Google Business dal tuo codice. Una sola REST API e una sola chiave coprono Google Business e ogni altra rete che colleghi, così scrivi l’integrazione una volta sola.

Ottieni una chiave API gratuita Leggi la documentazione API

Integrazione di Google Business con BulkPublish

Cosa copre l’API di Google Business

Tutto ciò che segue fa parte dell’API pubblicata e oggi funziona con Google Business.

Funzione	Endpoint
Crea, programma, modifica e pubblica post	`POST /api/posts`
Carica immagini e video	`POST /api/media`
Trova il prossimo slot libero nella tua coda	`GET /api/posts/queue-slot`
Crea programmazioni ricorrenti	`POST /api/schedules`
Pubblica i nuovi elementi di un feed RSS	`POST /api/rss-feeds`
Leggi e rispondi alle recensioni	`GET /api/inbox/conversations, POST /api/inbox/conversations/{id}/messages`
Controlla che la connessione funzioni	`GET /api/channels/{id}/health`
Controlla l’utilizzo del tuo piano	`GET /api/quotas/usage`

Tipi di post che puoi pubblicare su Google Business

Scegli il tipo con postTypeOverrides. Un tipo che Google Business non offre viene rifiutato prima che qualcosa finisca in coda.

Tipo di post	Media
`standard` Update	Facoltativo, fino a 1 immagine
`event` Event	Facoltativo, fino a 1 immagine
`offer` Offer	Facoltativo, fino a 1 immagine

Programma un post su Google Business con curl

Tre richieste: trova il tuo canale, carica il file se il post ne ha uno, poi crea il post. Sostituisci la chiave con una creata in Impostazioni, poi Chiavi API, e 12 con l’id del tuo canale.

1. Elenca i tuoi canali e annota l’id del tuo account Google Business.

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

2. Carica il file. La risposta ti dà l’id del media da usare come mediaFiles qui sotto.

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

3. Crea il 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"
    }
  }
}'

La risposta è il post creato, con il suo id e lo stato. Recuperalo più tardi con GET /api/posts/{id} per vedere com’è andata.

Opzioni di Google Business

Inviale dentro platformSpecific, sotto la chiave di Google Business.

Opzione	Cosa fa	Accetta
`ctaType`	Pulsante di invito all’azione	`LEARN_MOREBOOKORDERSHOPSIGN_UPCALL`
`ctaUrl`	Link dell’invito all’azione	testo
`eventTitle`	Titolo dell’evento	testo
`startDate`	Data di inizio dell’evento	testo
`startTime`	Ora di inizio dell’evento	testo
`endDate`	Data di fine dell’evento	testo
`endTime`	Ora di fine dell’evento	testo
`couponCode`	Codice coupon dell’offerta	testo
`redeemOnlineUrl`	Link per riscattare l’offerta online	testo
`termsConditions`	Condizioni dell’offerta	testo

Analisi di Google Business tramite API

Per Google Business i numeri dei singoli post non sono disponibili, quindi non c’è nulla da rileggere.

Commenti e messaggi

Tramite l’API puoi leggere e rispondere alle recensioni.

Leggere i commenti funziona su ogni piano. Per rispondere ai commenti serve un piano a pagamento, e la casella condivisa fa parte di Pro e Business. Finché una funzione non è attiva sul tuo account, l’API risponde 403 con un codice che puoi controllare.

Accesso all’API su ogni piano

Ogni piano include le chiavi API, anche il piano Free. Ecco cosa consente ciascuno.

Piano	Chiavi API	Richieste al giorno
Free	1	30
Pro	5	5000
Business	10	50.000

Costruisci direttamente su Google Business oppure usa BulkPublish

Lavorare direttamente è una scelta sensata, soprattutto se ti serve qualcosa che BulkPublish non offre. Ecco cosa ti chiede Google Business Profile API, verificato sulla sua documentazione a ottobre 2026.

Prima di pubblicare devi registrare un’app per sviluppatori presso Google Business.
Per pubblicare su account diversi dal tuo, Google Business deve prima approvare la tua app.
I media vengono scaricati da un URL pubblico che devi ospitare tu.

BulkPublish mantiene la connessione per te: rinnova i token, controlla ogni post rispetto alle regole di Google Business prima che finisca in coda e segnala sul post una destinazione fallita, così il tuo codice fa una sola richiesta.

Leggi la documentazione ufficiale

Preferisci chiedere a un assistente?

Claude, ChatGPT e Cursor possono fare lo stesso tramite il server MCP per Google Business, con richieste in linguaggio naturale al posto del codice.

Vedi il server MCP per Google Business

Preferisci un calendario al codice?

Lo stesso account Google Business si può programmare dall’app, con un calendario dei contenuti e il caricamento in blocco.

Vedi il pianificatore per Google Business

Domande frequenti

Le domande più comuni sull’API di Google Business.

Esiste un’API di Google Business che posso usare senza costruire io l’integrazione?

Sì. BulkPublish espone Google Business tramite la sua REST API. Collega il tuo account Google Business una volta sola, poi pubblica, programma e gestisci tutto con una chiave. La stessa chiave vale per ogni altra rete che colleghi.

Cosa posso pubblicare su Google Business tramite l’API?

I tipi di post sono Update, Event e Offer. Ognuno viene controllato rispetto alle regole sui media di Google Business prima di finire in coda, quindi una richiesta che Google Business rifiuterebbe fallisce subito con un errore chiaro.

Posso programmare i post di Google Business tramite l’API?

Sì. Invia status "scheduled" con un orario scheduledAt e un timezone, oppure chiedi prima il prossimo slot libero nella tua coda. Sono disponibili anche programmazioni ricorrenti e feed RSS.

Posso leggere le analisi di Google Business tramite l’API?

Non i numeri dei singoli post: per Google Business non sono disponibili.

Posso leggere e rispondere ai commenti o ai messaggi di Google Business tramite l’API?

Sì. Puoi leggere e rispondere alle recensioni. Per rispondere ai commenti serve un piano a pagamento, e la casella condivisa fa parte di Pro e Business.

L’API di Google Business costa extra?

No. L’accesso all’API è su ogni piano. Free include 1 chiave e 30 richieste al giorno, Pro 5 chiavi e 5000 al giorno, Business 10 chiavi e 50.000 al giorno.

Mi serve un account sviluppatore Google Business o una revisione dell’app?

Non per usare BulkPublish. Colleghi il tuo account Google Business dalla pagina Canali e pubblichi con una chiave BulkPublish. Se invece costruisci sull’API di Google Business, la sezione qui sopra elenca cosa ti chiede.

Può farlo anche un assistente IA?

Sì. La pagina del server MCP per Google Business mostra come collegare Claude, ChatGPT o Cursor e cosa chiedere.

La stessa chiave e la stessa forma di richiesta funzionano per 15 reti.