Domande frequenti

Che cosa sono le API GBP?

Le API di Profilo dell'attività sono interfacce di programmazione che consentono agli sviluppatori di scrivere applicazioni per gestire i dati relativi all'account e alla sede di Profilo dell'attività. Le API consentono ai commercianti o ai loro rappresentanti di gestire il modo in cui i loro dati vengono presentati su Google e di controllare chi li gestisce congiuntamente. Anche i dati creati dagli utenti, come foto, post e recensioni, possono essere gestiti tramite le API.

Le API Business Profile offrono quasi le stesse funzionalità dell'interfaccia utente di Profilo dell'attività, con alcune funzionalità aggiuntive specifiche per le API. Gli utenti delle API possono aspettarsi che gli aggiornamenti di Google vengano eseguiti come per gli utenti dell'interfaccia utente.

Chi può accedere alle API GBP?

Le API GBP non sono aperte al pubblico. Gli utenti devono richiedere l'accesso alle API GBP per poterle utilizzare. Qualsiasi persona fisica o giuridica che può dimostrare un motivo commerciale legale per accedere alle API GBP è approvata per l'accesso. Ecco alcuni consigli per dimostrare la legalità come azienda:

  • Utilizza un indirizzo email aziendale valido associato al dominio della tua attività.
  • Assicurati che il sito web dell'attività sia aggiornato e pubblicato.

L'accesso alle API GBP consente a un utente di eseguire query su qualsiasi dato di Profilo dell'attività su Google?

No. Anche se hai accesso alle API Profilo dell'attività su Google, non puoi eseguire query sui dati di un Profilo dell'attività su Google, a meno che tu non abbia accesso a quel particolare Profilo dell'attività su Google.

Quali sono le norme pertinenti per gli utenti dell'API GBP?

I partner devono rispettare le norme di Google Business Profile, nonché tutte le norme e i Termini e condizioni delle API.

In che modo gli utenti ottengono l'accesso all'API GBP?

Per creare correttamente la tua prima applicazione client, devi completare i seguenti prerequisiti:

  1. Creare un Account Google.
  2. Prova Profilo dell'attività.
  3. Crea un progetto nella console API di Google.
  4. Richiedi l'accesso all'API: le richieste vengono esaminate entro 14 giorni.

In che modo gli utenti ottengono l'accesso a una determinata API all'interno dell'API GBP?

Esistono otto API associate a Profilo dell'attività che devono essere abilitate nella console API di Google:

  • API Google My Business 4.9, che include le seguenti chiamate API di funzionalità importanti:
    • 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 Rendimento profilo dell'attività

Se l'applicazione di un utente per richiedere l'accesso viene approvata, gli verrà concessa una quota predefinita standard per tutte e otto le API.

Come funziona l'accesso all'API GBP?

L'accesso all'API di Profilo dell'attività su Google viene concesso a livello di progetto Google Cloud. Se un utente A ha richiesto l'accesso all'API Google Business Profile per il progetto 12345678, l'accesso viene concesso al progetto 12345678. Di conseguenza, qualsiasi utente, incluso l'utente A con accesso al progetto Google Cloud, può effettuare chiamate alle API di Profilo dell'attività su Google. I partner devono controllare l'accesso al progetto Google Cloud in base alle necessità per evitare abusi.

Hai un riepilogo delle API e delle funzionalità di esempio?

Consulta la seguente tabella per informazioni sulle diverse API e sulle relative funzionalità.

API Documentazione di riferimento Funzionalità di esempio
API Account Management Documentazione
  • Gestisci l'accesso a una stazione di ricarica.
  • Crea un account con il nome e il tipo specificati sotto l'account principale specificato.
  • Elenca tutti gli account dell'utente autenticato.
  • Elenca gli inviti in attesa per l'account specificato.
  • Sposta una sede da un account di proprietà dell'utente a un altro account.
  • Aggiorna l'amministratore per la sede specificata.
API Business Information Documentazione
  • L'API Business Information consente di gestire il ciclo di vita del profilo e di aggiungere o gestire le informazioni sull'attività su Profilo dell'attività.
  • Consente ai commercianti di recuperare, creare, aggiornare o eliminare i profili delle attività su Google.
  • Consente ai commercianti di recuperare o aggiornare gli attributi del profilo.
  • Consente ai commercianti di ottenere o cercare catene e categorie di profilo.
API Lodging Documentazione
  • Consente di gestire i dati sugli alloggi, ad esempio i servizi della struttura, e le norme per le attività su Google. L'API è specifica per le attività che forniscono servizi di alloggio, come gli hotel. L'API Lodging consente agli sviluppatori di aggiornare gli attributi delle strutture ricettive di un profilo dell'attività su Google.
API Place Actions Documentazione
  • Consente di gestire i link di azioni dirette nelle attività.
  • Reindirizza gli utenti a eseguire azioni come prenotare un appuntamento, prenotare un tavolo e ordinare cibo a domicilio.
API Notifications Documentazione
  • Consente la gestione delle impostazioni di notifica per account specifici.
API Verifications Documentazione
  • Avvia la procedura di verifica per una sede.
  • Mostra tutte le opzioni di verifica idonee per una località in una lingua specifica.
API Domande e risposte Documentazione
  • Consente la gestione delle domande e delle risposte di una stazione di ricarica.
API Business Profile Performance Documentazione
  • Consente ai commercianti di recuperare informazioni sul rendimento della scheda della loro attività su Google.
  • Gli approfondimenti includono impressioni dell'attività, richieste di indicazioni stradali, clic sulle chiamate, clic sul sito web, prenotazioni, ordini di cibo, interazioni con il menu e altro ancora.
API Media Documentazione
  • Consente agli sviluppatori di API di caricare foto e video per un profilo dell'attività.
API Reviews Documentazione
  • Consente ai commercianti di ricevere recensioni e rispondere alle recensioni in un profilo dell'attività.
API Local Posts Documentazione
  • Consente ai commercianti di ottenere, creare o aggiornare post locali.
API FoodMenus Documentazione
  • Consente ai commercianti di ottenere, creare o aggiornare menu di cibo per un profilo dell'attività.

Se hai ancora domande sui dati a tua disposizione e/o su come accedervi, utilizza i seguenti moduli per presentare una richiesta:

In che modo i partner possono configurare la struttura del proprio account per utilizzare le API GBP?

Se sei un partner terzo che gestisce le schede per le attività:

In che modo le attività commerciali possono autorizzare un partner API GBP a gestire la loro scheda dell'attività?

Le attività concedono l'accesso a un partner di terze parti in due modi:

  • Configurazione di OAuth: consulta questa guida per capire in che modo le piattaforme dei partner di terze parti utilizzano le credenziali del commerciante per modificare e accedere ai dati di Profilo dell'attività su Google per conto del commerciante o dell'attività.

  • Accesso come proprietario o gestore: se un partner di terze parti viene aggiunto come gestore di Profilo dell'attività su Google dal commerciante, che deve essere il proprietario principale del profilo, il partner di terze parti non deve utilizzare le credenziali del commerciante per utilizzare le API di GBP per modificare e accedere ai dati di GBP.

    Nota: consigliamo vivamente ai partner di terze parti di non aggiungersi come proprietari di Profilo dell'attività, ma solo di aggiungersi come gestori.

Se un'attività ha più di 10 sedi, esiste un modo per eseguire la verifica collettiva?

Sì. Puoi richiedere la verifica collettiva per più di 10 profili. Dopo la verifica, le località delle catene pubblicate possono essere gestite con le API Profilo dell'attività come per le altre località, con alcune eccezioni. Ad esempio, gli amministratori del sito vengono trattati in modo diverso e possono aggiungersi alle sedi in franchising.

Quali sono i limiti di quota delle varie API?

I limiti di quota standard sono elencati nella sezione Limiti di utilizzo. Se hai bisogno di limiti più elevati, puoi inviare una richiesta di quota standard.

Quanta quota posso richiedere?

La quota è una risorsa limitata. Il team di assistenza dell'API GBP determina l'idoneità della richiesta di aumento della quota confermando l'utilizzo della quota passato. Se il tuo utilizzo medio della quota è inferiore al 70% dei limiti di quota attuali, potresti non ottenere un ulteriore aumento dei limiti di quota.

I partner dell'API GBP possono creare un account di test per la produzione?

No. Purtroppo, non esiste un modo diretto per creare una scheda GBP falsa in produzione tramite l'interfaccia utente o l'API GBP e sottoporla a test.

La maggior parte delle schede false create viene segnalata dalla nostra moderazione e sospesa. Ti consigliamo di utilizzare la scheda di un cliente e di utilizzarla dopo l'orario di apertura (a condizione che tu non modifichi le informazioni principali della scheda, come nome, indirizzo, categoria) oppure di creare una scheda per la sede centrale della tua azienda. Se vuoi testare una risposta dell'API per verificare una scheda o qualsiasi altra azione che richiede una scheda di produzione, puoi utilizzare le risposte API simulate.