API di Google Business Profile: cosa fa e come ottenere l'accesso
Di Toy Wen Da, Co-founder · Aggiornato · 6 min di lettura
Tradotto dall'originale in inglese. Leggilo in inglese
L'API di Google Business Profile ti permette di gestire via codice i dati della scheda, le recensioni, i post e le statistiche, senza passare dalla dashboard abituale. È pensata per le aziende e le agenzie che gestiscono molte sedi e per gli sviluppatori che creano strumenti basati su Google Business Profile. L'accesso non è automatico: invii una richiesta tramite un modulo di Google, che esamina ogni domanda prima di assegnarti una quota.
Cosa fa l'API di Google Business Profile
La dashboard è la via manuale e l'API è quella programmatica, ma entrambe lavorano sugli stessi dati: nome dell'attività, indirizzo, orari, categorie, foto, post, recensioni e metriche di rendimento. Con l'API, un software legge e scrive direttamente quei dati, invece di far inserire tutto a una persona a mano. La differenza si sente quando gestisci più di una manciata di sedi: aggiornare 40 schede una alla volta è un lavoro ben diverso dall'inviare un unico aggiornamento a tutte e 40.
A chi serve
- Brand con più sedi che vogliono orari, categorie e foto coerenti in ogni punto vendita.
- Agenzie che gestiscono Google Business Profile per più clienti da un unico sistema.
- Piattaforme SaaS che creano strumenti di gestione delle recensioni, di local SEO o di reputazione a partire da questi dati.
- Sviluppatori che realizzano dashboard interne per franchising o catene.
Un'attività con una sola sede raramente ha bisogno dell'accesso diretto all'API, perché la dashboard copre già pubblicazione di post, caricamento di foto e risposte alle recensioni. Un account sviluppatore comporterebbe tempo di configurazione senza un vantaggio proporzionato.
Come ottenere l'accesso all'API di Google Business Profile: i passaggi
L'accesso passa da Google Cloud, non dal normale login di Business Profile.
1. Crea un progetto Google Cloud
Crea un progetto nella Google Cloud Console e attiva la fatturazione. Più avanti, è anche qui che abiliti la "Business Profile API" dalla API Library.
2. Invia la richiesta di accesso all'API
Google tiene questa API dietro un modulo di richiesta, quindi non puoi semplicemente attivarla. Descrivi il tuo caso d'uso, la tua attività e come intendi usare i dati. I tempi di approvazione variano: alcuni sviluppatori, nelle discussioni delle community, parlano di circa due settimane di attesa, mentre altri raccontano di più rifiuti anche quando la richiesta riguardava la gestione del proprio profilo aziendale.
3. Configura l'OAuth consent screen
Le credenziali create in modalità "testing" spesso falliscono senza dare errori. Diversi sviluppatori che cercavano di risolvere problemi di accesso hanno scoperto che la soluzione era portare lo stato di pubblicazione dell'OAuth consent screen su "In Production": un passaggio facile da perdere e che raramente viene indicato come causa di una chiamata fallita.
4. Genera le credenziali e fai un test
Una volta approvato, crea le credenziali OAuth o dell'account di servizio e prova con un profilo reale. Se gestisci la scheda di un cliente, essere aggiunto come gestore del suo Business Profile non ti dà accesso all'API. La richiesta per il tuo progetto Cloud deve comunque essere approvata separatamente.
Accesso diretto all'API fai da te o piattaforma gestita
Richiedere l'accesso diretto all'API e usare una piattaforma costruita sopra di essa risolvono lo stesso problema in modi diversi.
| Approccio | Impegno di configurazione | Costo tipico | Ideale per |
|---|---|---|---|
| Accesso diretto all'API (il tuo progetto Cloud) | Alto: richiesta, attesa dell'approvazione, configurazione OAuth, manutenzione continua | L'API di Google è gratuita; il vero costo è il tuo tempo di sviluppo | Sviluppatori che creano uno strumento su misura o gestiscono decine di sedi interne |
| Piattaforma di terze parti per la gestione di GBP | Basso: ti registri e colleghi il tuo profilo | I piani basati sull'API ufficiale sono stati proposti a partire da circa $9.00 al mese per un paio di sedi | Agenzie e aziende che vogliono modifiche in blocco e sincronizzazione delle recensioni senza dover mantenere codice |
| Solo dashboard manuale | Nessuno | Gratis | Attività con una sola sede che gestiscono post, orari e recensioni solo ogni tanto |
Le piattaforme che pubblicizzano l'accesso all'API di Google Business Profile usano di solito gli endpoint ufficiali e autorizzati, e non fanno scraping della dashboard. Verificalo prima di dare accesso al tuo profilo, perché gli strumenti basati sullo scraping aumentano il rischio che la tua scheda venga segnalata.
I problemi più comuni
I ritardi nell'approvazione non sono l'unico ostacolo. Gli sviluppatori che lavorano con l'API segnalano errori 404 "method not found" quando le credenziali non corrispondono all'ambito (scope) giusto, e richieste di video dimostrativi da parte del team di revisione di Google prima di approvare certe app OAuth. Le richieste vengono inoltre rifiutate di frequente quando l'email dell'account non corrisponde al dominio dell'attività. Nessuno di questi problemi è un blocco definitivo, ma ciascuno aggiunge tempo prima che l'API restituisca dati utilizzabili.
Ti serve l'accesso all'API o una dashboard configurata meglio?
L'accesso all'API ti serve solo se gestisci molte sedi o stai costruendo un prodotto sui dati di Google Business Profile; altrimenti la soluzione è configurare meglio la dashboard. Se l'obiettivo è una maggiore visibilità, per esempio con le categorie giuste, domande e risposte complete o post che non finiscono sepolti, è un problema di dashboard e di contenuti, non di API. Scegliere bene le categorie di Google Business Profile, o sistemare il modo in cui si presenta la sezione domande e risposte di Google Business Profile, spesso fa più differenza di qualsiasi accesso programmatico. L'API è la scelta giusta quando sincronizzi decine di sedi o costruisci un prodotto attorno ai dati, e non ti aiuta se vuoi semplicemente posizionarti meglio nelle ricerche locali.
Le linee guida di Google Search Essentials affermano che informazioni aziendali accurate e aggiornate con costanza sono alla base del rendimento di una scheda nella ricerca locale. L'API può aiutarti a scalare questo lavoro, ma non lo crea al posto tuo. Per capire a che punto è la tua configurazione attuale, con o senza API, prova un report SEO di esempio sul tuo sito e sulla tua scheda.
Domande frequenti
L'API di Google Business Profile è gratuita?
L'API in sé non ha costi di licenza da parte di Google, ma l'accesso è subordinato a un processo di approvazione, e la maggior parte delle aziende finisce per pagare una piattaforma di terze parti o il tempo di uno sviluppatore per creare e mantenere l'integrazione.
Quanto tempo richiede l'approvazione dell'API di Google Business Profile?
Dipende. Secondo le community le approvazioni arrivano in circa due settimane, ma alcune richieste vengono respinte e vanno reinviate con più dettagli sul caso d'uso.
Posso usare l'API se sono solo gestore del profilo di qualcun altro?
Essere aggiunto come gestore non dà da solo l'accesso all'API. Ti serve comunque un tuo progetto Google Cloud con una richiesta di accesso all'API approvata.
Perché ricevo un errore 404 quando chiamo l'API?
Di solito indica una mancata corrispondenza tra credenziali e ambito (scope). Spesso si tratta di credenziali di un account di servizio usate dove ci si aspettavano credenziali OAuth, oppure di un'API non abilitata nel progetto Cloud.
Le piccole attività hanno bisogno dell'API di Google Business Profile?
Raramente. Un'attività con una sola sede può gestire post, foto, orari e risposte alle recensioni dalla dashboard standard. L'API ripaga quando gestisci diverse sedi o costruisci software attorno ai dati.
Prossimo passo: scopri cosa frena davvero la tua scheda
Prima di dedicare settimane a una richiesta per l'API di Google Business Profile, scopri se la soluzione di cui hai bisogno è davvero un problema di codice. Parla con il team e ottieni un report SEO di esempio che mostra cosa sta penalizzando la tua visibilità in questo momento e se un accesso a livello di API cambierebbe qualcosa.
Risorse / Riferimenti
Da leggere anche: Google Reviews API: The Free Options vs the 5-Review Limit.
Fonti
Sull'autore
SearchBlueprint ha ricercato, scritto e valutato questo articolo con la stessa pipeline di contenuti che i nostri clienti usano sui loro siti. Il punteggio indicato nella firma è quello che il nostro motore di contenuti ha assegnato a questa pagina prima della pubblicazione. Nulla qui è rivisto a mano, ed è proprio questo il punto: è il risultato del prodotto, pubblicato dove chiunque può verificarlo.