Domande frequenti (FAQ)

Che cosa sono le API di Profilo dell'attività su Google?

Le API di Profilo dell'attività sono interfacce di programmazione che consentono agli sviluppatori di scrivere applicazioni per gestire i dati sull'account e sulla posizione 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 co-gestisce i loro dati. Anche i dati creati dagli utenti, come foto, post e recensioni, possono essere gestiti tramite le API.

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

Chi può accedere alle API di Profilo dell'attività su Google?

Le API Profilo dell'attività non sono aperte al pubblico. Gli utenti devono richiedere l'accesso alle API GBP per utilizzarle. Tutti i privati o le aziende in grado di dimostrare di avere motivi commerciali legali per accedere alle API GBP sono approvati per l'accesso. Ecco alcuni consigli per dimostrare la legalità come attività commerciale:

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

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

No. Anche se hai accesso alle API di 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 Profilo dell'attività?

I partner devono essere conformi alle norme di Profilo dell'attività su Google, nonché a tutte le norme e tutti i termini e condizioni relativi alle API.

In che modo gli utenti possono accedere all'API GBP?

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

  1. Ottieni 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 possono accedere 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 Business Profile Performance

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 GBP viene concesso a livello di progetto Google Cloud. Se un utente A ha richiesto l'accesso all'API Google Business Profile per il progetto n. - 12345678, l'accesso viene concesso al progetto n. - 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 alla necessità di accedere per evitare comportamenti illeciti.

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

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

API Documentazione di riferimento Esempi di funzionalità
API Account Management Documentazione
  • Gestire l'accesso a una posizione.
  • Crea un account con il nome e il tipo specificati sotto l'elemento padre 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 il luogo specificato.
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à relative a Profilo dell'attività.
  • Consente ai commercianti di ottenere, creare, aggiornare o eliminare i profili dell'attività su Google.
  • Consente ai commercianti di ottenere o aggiornare gli attributi del profilo.
  • Consente ai commercianti di ottenere o cercare catene e categorie di profili.
API Lodging Documentazione
  • Consente di gestire i dati sugli alloggi, ad esempio i comfort della struttura, e le norme per le attività commerciali su Google. L'API è specifica per attività che forniscono servizi di alloggio, ad esempio gli hotel. L'API Lodging consente agli sviluppatori di aggiornare gli attributi di alloggio di un Profilo dell'attività su Google.
API Place Actions Documentazione
  • Consente di gestire i link per le azioni dei luoghi sulle 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.
  • Segnala tutte le opzioni di verifica idonee per una località in una lingua specifica.
API Q&A Documentazione
  • Consente di gestire domande e risposte relative a un luogo.
API Business Profile Performance Documentazione
  • Consente ai commercianti di recuperare informazioni sulle prestazioni della loro scheda di attività su Google.
  • Gli approfondimenti includono impressioni dell'attività, richieste di indicazioni stradali, clic per chiamata, clic che indirizzano al sito web, prenotazioni, ordinazioni 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 nel profilo dell'attività.
API Local Posts Documentazione
  • Consente ai commercianti di ottenere, creare o aggiornare i post locali.
API FoodMenus Documentazione
  • Consente ai commercianti di ottenere, creare o aggiornare i menu alimentari per un profilo dell'attività.

In che modo i partner possono configurare la struttura del proprio account per utilizzare le API di Profilo dell'attività su Google?

Se sei un partner terzo che si occupa della gestione delle schede per le attività commerciali:

In che modo le attività possono autorizzare un partner API di GBP a gestire la propria scheda di 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 dei commercianti 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 dal commerciante come gestore del profilo dell'attività su Google, che dovrebbe essere il proprietario principale della piattaforma Profilo dell'attività, il partner di terze parti non deve utilizzare le credenziali del commerciante per utilizzare le API di Profilo dell'attività su Google per modificare e accedere ai dati di Profilo dell'attività su Google.

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

Se un'attività ha più di 10 sedi, è possibile eseguire la verifica collettiva?

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

Quali sono i limiti di quota per le 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.

Quante quota posso richiedere?

La quota è una risorsa limitata. Il team di assistenza dell'API GBP determina l'idoneità della richiesta di aumento della quota verificando l'utilizzo passato della quota. Se l'utilizzo medio della quota è inferiore al 70% dei limiti di quota attuali, ti potrebbe essere negato un ulteriore aumento dei limiti di quota.

I partner API GBP possono creare un account di prova per la produzione?

No. Sfortunatamente, non esiste un modo diretto per creare una scheda Profilo dell'attività falsa in produzione tramite l'interfaccia utente o l'API di Profilo dell'attività su Google e testare l'attività.

La maggior parte delle schede false create viene segnalata dalla nostra moderazione e sospesa. Ti consigliamo di utilizzare una scheda dei clienti e di lavorarci dopo l'orario di lavoro (a condizione di non modificare le informazioni principali della scheda, come nome, indirizzo e categoria) o 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 prodotto, puoi utilizzare le risposte dell'API fittizie.