Componenti aggiuntivi di Google Sheets

L'Add-In di Google Sheets di Stock Events porta direttamente i dati del tuo portafoglio dentro i tuoi fogli di calcolo. Puoi accedere a prezzi azionari in tempo reale, metriche sui dividendi, partecipazioni del portafoglio e dettagli delle singole posizioni — tutto si aggiorna automaticamente nel tuo foglio.

Installare l'Add-In

1. Apri l'app nel Marketplace
2. Clicca su Aggiungi per installarlo.
3. Una volta installato, apparirà un pulsante Stock Events nella scheda Estensioni della barra in Google Sheets.

Accedere

L'add-in utilizza un flusso di accesso basato sul dispositivo. Ti autentichi nel browser e l'add-in rileva automaticamente la sessione.

1. Clicca sul pulsante Stock Events nella scheda Home per aprire il pannello laterale.
2. Clicca su Login. Si aprirà una finestra del browser.
3. Accedi con il tuo account Stock Events nel browser. Se sei già connesso, la connessione si completerà automaticamente.
4. Torna su Sheets. Il pannello laterale si aggiornerà mostrando il tuo nome utente e l'elenco dei tuoi portafogli.

Devi accedere solo una volta. La sessione rimane attiva finché non esegui il logout o finché la tua sottoscrizione Pro non scade.

Disconnettersi

Clicca su Sign Out in fondo al pannello laterale. Tutte le funzioni smetteranno di restituire dati e mostreranno #LOGIN! finché non effettuerai di nuovo l'accesso.

Usare le Funzioni

Tutte le funzioni usano il namespace STOCKEVENTS. Scrivi =STOCKEVENTS. in una cella e Sheets ti mostrerà l'elenco completo delle funzioni disponibili.

Dati di Mercato

Queste funzioni accettano come input il simbolo del titolo.

=STOCKEVENTS_STOCK_PRICE("AAPL")
Restituisce il prezzo di mercato attuale di un'azione.

=STOCKEVENTS_STOCK_CHANGE("AAPL")
Restituisce la variazione di prezzo nelle ultime 24 ore in percentuale.

=STOCKEVENTS_STOCK_DIVIDEND_YIELD("AAPL")
Restituisce il rendimento annuale da dividendo.

=STOCKEVENTS_STOCK_NAME("AAPL")
Restituisce il nome completo della società (es. "Apple Inc.").

Dividendi

Queste funzioni accettano come input il nome di un portafoglio e restituiscono le metriche sui dividendi per quel portafoglio.

=STOCKEVENTS_DIVIDENDS_INCOME("Watchlist")
Restituisce il reddito annuale da dividendi previsto.

=STOCKEVENTS_DIVIDENDS_YIELD("Watchlist")
Restituisce il rendimento medio ponderato dei dividendi di tutte le partecipazioni.

=STOCKEVENTS_DIVIDENDS_YIELD_ON_COST("Watchlist")
Restituisce il rendimento da dividendo basato sul prezzo medio di acquisto ponderato.

Partecipazioni

Queste funzioni accettano come input il nome di un portafoglio e restituiscono dati aggregati del portafoglio.

=STOCKEVENTS_HOLDINGS_VALUE("Watchlist")
Restituisce il valore di mercato totale attuale di tutte le posizioni.

=STOCKEVENTS_HOLDINGS_GAIN("Watchlisto")
Restituisce il profitto o la perdita non realizzata totale su tutte le posizioni.

=STOCKEVENTS_HOLDINGS_LIST("Watchlist")
Restituisce un elenco verticale di tutti i simboli dei titoli nel portafoglio. È un array dinamico — si espande automaticamente nelle celle sottostanti.

Posizioni

Queste funzioni accettano sia un simbolo di titolo che un nome di portafoglio e restituiscono i dati per quella specifica posizione.

=STOCKEVENTS_POSITION_VALUE("AAPL"; "Watchlist")
Restituisce il valore di mercato attuale della posizione.

=STOCKEVENTS_POSITION_SHARES("AAPL"; "Watchlist")
Restituisce il numero totale di azioni detenute.

=STOCKEVENTS_POSITION_GAIN("AAPL"; "Watchlist")
Restituisce il guadagno o la perdita non realizzata per la posizione.

=STOCKEVENTS_POSITION_AVG_COST("AAPL"; "Watchlist")
Restituisce il prezzo medio di acquisto (costo base) per azione.

Nomi dei Portafogli

Usa esattamente il nome del portafoglio come appare nell'app Stock Events. Dopo aver effettuato l'accesso, il pannello laterale mostra tutti i tuoi portafogli — usa quei nomi nelle formule.

Per fare riferimento a tutti i tuoi portafogli combinati, usa "Combined" come nome del portafoglio:

=STOCKEVENTS_HOLDINGS_VALUE("Combined")

Errori

Se una funzione non riesce a restituire dati, mostrerà uno dei seguenti valori di errore:

LOGIN!
Non sei connesso. Apri il pannello laterale e clicca su Login.

INVALID_TICKER
Il simbolo del titolo non è stato riconosciuto. Controlla l'ortografia e assicurati di usare il simbolo corretto della borsa.

PORTFOLIO_NOT_FOUND
Nessun portafoglio corrisponde al nome fornito. Apri il pannello laterale per vedere i nomi esatti dei tuoi portafogli.

ERROR!
Si è verificato un problema temporaneo. La funzione riproverà automaticamente al prossimo aggiornamento.

Consigli

• Puoi fare riferimento ai valori delle celle invece di digitare direttamente le stringhe. Ad esempio, se la cella A1 contiene "AAPL", usa =STOCKEVENTS_STOCK_PRICE(A1).
• Usa HOLDINGS_LIST per elencare tutti i tuoi titoli in una colonna, poi usa STOCK_PRICE o POSITION_VALUE accanto a ciascuno per creare una dashboard aggiornata in tempo reale.

Hai bisogno di aiuto?

Se riscontri problemi, contattaci a support@stockevents.app.