My Switch Collection — Guida utente

Benvenuto/a. Questa è la guida completa per passare da zero a una collezione completamente configurata: il tuo foglio Google, la configurazione iniziale, l'uso quotidiano e l'app web complementare opzionale. Sostituisce le vecchie note di accoglienza della beta e copre l'intero percorso, non solo la prima settimana.

I tuoi dati sono tuoi. Il tuo foglio vive nel tuo Google Drive, sotto il tuo account Google. Nessun altro, noi compresi, lo legge o vi scrive a meno che tu non lo condivida esplicitamente. Puoi smettere di condividerlo, scaricarlo o eliminarlo in qualsiasi momento — nulla in questo prodotto ti vincola.

1. Cosa ottieni

Due cose, e ti serve sempre solo la prima:

• Un foglio Google che è completamente tuo. Questo è il vero prodotto: un foglio di calcolo normalizzato (schede separate per il tuo catalogo, le tue copie fisiche, la tua lista dei desideri, e un paio di viste di riepilogo di sola lettura) con un piccolo script collegato. Non costa nulla, non richiede installazioni, e continua a funzionare come un normale foglio Google — filtri, tabelle pivot, esportazioni — che tu tocchi o meno il resto di questa guida.
• Un'app web opzionale. Un complemento pensato per il mobile che parla con lo stesso foglio — nulla viene duplicato. Aggiunge un flusso di aggiunta gioco più rapido da mobile, una dashboard, inventari tramite foto e monitoraggio dei prezzi. È facoltativa, e potrebbe non essere ancora attiva per la tua collezione — vedi il punto 8.

2. Crea il tuo foglio

https://docs.google.com/spreadsheets/d/10ygjHC4fzmApvqr9Ed4Nlx8Vsyexsy22i5JTYotBXDM/edit

Aprilo, poi File → Crea una copia, e salva la copia nel tuo Drive — chiamala come preferisci (per esempio "La Mia Scaffalatura"). Da questo momento, questa copia — i dati, la struttura del foglio e lo script ad essa collegato — è interamente tua. Niente di ciò che fai al suo interno è visibile a nessun altro, mai, a meno che tu non decida di condividerlo.

[Screenshot: il menu "File → Crea una copia" di Google Sheets]

3. Prima configurazione

Subito dopo aver copiato il modello, il menu 🎮 Collection mostra un solo elemento: Setup. È voluto — è l'unico pulsante di cui una copia appena fatta ha bisogno. Apri 🎮 Collection → Setup: succedono tre cose, in ordine:

1. Registra la tua copia presso l'API del prodotto, usando l'email del tuo account Google (letta automaticamente — niente da digitare, nessun modulo). La registrazione è idempotente: la stessa email corrisponde sempre alla stessa identità, quindi ricopiare il modello non concede mai un nuovo posto gratuito.
2. Programma la sincronizzazione quotidiana descritta al punto 4 (~05:00, il fuso orario della tua copia).
3. Avvia subito quella prima sincronizzazione, così il tuo foglio non resta vuoto mentre aspetti l'esecuzione di domani.

Devi cliccare Setup una sola volta, subito dopo la copia — ricarica il foglio dopo per vedere il menu completo (Add game…, Import data…, Sync now, Enable/Disable app access, e lo stesso Setup, tenuto lì per il caso in cui tu debba mai rieseguirlo).

La schermata dei permessi, senza giri di parole

La prima volta che esegui una voce del menu, Google ti chiederà di autorizzare lo script. Poiché la copia di ogni collezionista è tecnicamente una piccola applicazione a sé, e ci sono semplicemente troppe copie perché Google le esamini e le "verifichi" una per una, vedrai un avviso che dice "Google non ha verificato questa app". È previsto — non è un segnale che qualcosa non va o non è sicuro. Ecco esattamente cosa fare:

1. Vedrai una schermata intitolata "Google non ha verificato questa app", con un pulsante Avanzate. Cliccalo.
2. Appare una nuova riga: "Vai a [nome del progetto] (non sicuro)". Cliccala. ("Non sicuro" qui significa solo che Google non ha fatto passare questo specifico script per la sua revisione di verifica formale — non che faccia qualcosa di dannoso.)
3. A questo punto vedrai l'elenco reale dei permessi — quattro voci. Rivedile, poi clicca Allow / Continue.

[Screenshot: l'avviso "Google non ha verificato questa app" con Avanzate espanso]

Ecco esattamente cosa sono questi quattro permessi, e cosa fa davvero ciascuno — questo è l'elenco completo, non viene mai richiesto altro:

Nota cosa non è in quell'elenco: non c'è alcun permesso generale su Google Drive. Lo script non può vedere i tuoi altri file, non può creare file nel tuo Drive, e non può leggere nessun altro foglio di calcolo che possiedi. È deliberatamente l'insieme di permessi più ristretto che fa funzionare il foglio.

4. Cosa fa la sincronizzazione quotidiana

Una volta eseguito Setup, una chiamata all'API del prodotto riempie automaticamente quattro cose: la tua scheda VERSIONS (codici cartuccia, revisioni e regioni per migliaia di uscite Switch conosciute), e tre colonne su CATALOG/COPIES — punteggi di stampa e utenti (PRESS SCORE/USER SCORE), stime di durata (TIME TO BEAT/TIME TO 100%), e prezzi di mercato (MARKET PRICE/PRICE UPDATED, solo per le copie che hai segnato come SELL o INVEST). Una sincronizzazione completa richiede circa un minuto. La cella A1 di VERSIONS mostra sempre quando è stata eseguita l'ultima volta e quante righe ha portato.

Non devi fare nulla perché funzioni — gira nel cloud una volta al giorno (verso le 05:00, nel fuso orario configurato della tua copia) anche se il tuo portatile è spento. Se vuoi mai un aggiornamento immediato, usa 🎮 Collection → Sync now.

Come leggere il messaggio di sincronizzazione

Ogni sincronizzazione — quotidiana o su richiesta — termina con un avviso che ti dice esattamente cosa è successo:

• "Synced: versions, scores, times, prices" (o quanti dei quattro avevano dati da scrivere) — tutto ha funzionato.
• "Not included (needs a subscription): <name>" — quel dataset è riservato a un livello di abbonamento a pagamento che il tuo account non ha. Nulla si è rotto dalla tua parte, e il resto della sincronizzazione è andato normalmente. (Oggi nulla è riservato — ogni dataset è gratuito per ogni collezionista — ma il messaggio è pronto per quando un futuro livello a pagamento dovrà dirlo chiaramente invece di trattenere dati in silenzio.)
• "Temporarily unavailable on our side: <name>" — un intoppo dalla nostra parte (per esempio, un aggiornamento dati non ancora arrivato). Riprova più tardi; i tuoi dati esistenti per quel dataset restano intatti.
• "Your access token is no longer valid — run Setup again from the menu." — rieseguire Setup ti registra di nuovo e ottiene un token funzionante.
• "Could not reach the sync service — check your connection and try again." — la richiesta non ha ottenuto alcuna risposta (offline, DNS e simili) — diverso da quando è il prodotto stesso a segnalare un fallimento.
• "The sync service had a problem on our side — your sheet is fine, please try again later." — qualsiasi altra cosa sia andata storta nel backend del prodotto. Una sincronizzazione fallita non sovrascrive mai parzialmente i tuoi dati esistenti.

Se una sincronizzazione fallisce, non preoccuparti — riprova semplicemente il giorno dopo, allo stesso orario, e i tuoi dati esistenti restano esattamente come erano nel frattempo. Consulta le domande frequenti (punto 9) se resta obsoleta per più di un paio di giorni.

5. Aggiungere giochi

Ci sono due modi per aggiungere un gioco alla tua collezione: dal foglio stesso, o dall'app web se ne hai una configurata.

Dal foglio (desktop/browser)

🎮 Collection → Add game… apre una finestra di ricerca:

1. Digita il nome di un gioco o un codice cartuccia (per esempio "Hollow Knight" o LA-H-B). I risultati dalla scheda VERSIONS compaiono mentre digiti.
2. Scegli dall'elenco l'edizione/revisione/regione esatta che possiedi.
3. Compila i campi rapidi prima che venga scritto qualcosa: Sealed? (OPEN di default, o un tipo di sigillo se è ancora sigillato di fabbrica), Price paid (facoltativo), Completeness (di default SEALED nel menu a tendina — impostalo su CIB per una copia usata normale, o quello che corrisponde davvero), Status (KEEP di default; scegli subito SELL, INVEST o UNDECIDED se lo sai già), Buy date (di default oggi), e Location (facoltativo, per esempio "Scaffale A, scatola 2").
4. Clicca Add. Viene scritta una riga in COPIES con tutto quanto sopra più nome, console, regione, codice cartuccia e revisione già compilati — e una riga CATALOG viene creata automaticamente se il gioco è nuovo nella tua collezione.

[Screenshot: la finestra di ricerca Add game con i risultati e i campi rapidi]

Le copie sono impostate di default su STATUS = KEEP a meno che tu scelga altro nella finestra — un'aggiunta deliberata si presume voluta. Se risulta essere un doppione di qualcosa che possiedi già, comparirà in SURPLUS perché tu lo gestisca più tardi (punto 7). Tutto ciò che non è coperto sopra — note e punteggio di stato, note di stampa — resta da compilare in seguito tramite i menu a tendina in COPIES.

Dall'app web (mobile, in negozio)

Se hai configurato l'app web (punto 8), la sua pagina Add game è una versione più rapida e pensata per il mobile dello stesso flusso, costruita specificamente per "sono in questo momento in un negozio":

1. Cerca per nome o codice cartuccia.
2. Tocca l'edizione esatta che hai in mano.
3. Imposta Sealed?, una Location facoltativa (per esempio "Scaffale A, scatola 2"), Buying as (Keep, o Invest per un acquisto speculativo deliberato — vedi punto 7), e un Price paid facoltativo.
4. Tocca Add to collection.

[Screenshot: il modulo di aggiunta rapida Add game dell'app web]

Questo scrive esattamente nella stessa scheda COPIES della finestra nel foglio — non c'è un database mobile separato da tenere sincronizzato.

6. Importare e ripristinare tra copie

🎮 Collection → Import data… porta CATALOG/COPIES/PIPELINE (e le tue schede personali BATTERY/NOTES, se presenti) da un'altra copia di questo foglio, dato il suo ID del foglio di calcolo. Questo è lo strumento per:

• Ripristinare i tuoi dati in una copia nuova, se qualcosa va storto.
• Migrare tra due tue copie.
• Aggiornare a una versione più recente del modello senza perdere i tuoi dati — copia il nuovo modello, poi importa dall'URL della tua vecchia copia. L'importazione tollera layout più vecchi (colonne mancanti, ordine di colonne diverso) facendo corrispondere le colonne per nome, quindi funziona anche se la tua vecchia copia è precedente a colonne più recenti.

Per usarla, il foglio sorgente deve essere condiviso temporaneamente come "Chiunque abbia il link: Lettore". La finestra chiede il suo ID del foglio di calcolo, recupera e valida ogni scheda e — se la destinazione ha già dati — chiede conferma prima di sovrascrivere.

[Screenshot: il passaggio di conferma della finestra Import data]

Nota sulla privacy. Finché il foglio sorgente è condiviso tramite link, chiunque abbia quel link può leggerlo — inclusi i tuoi prezzi d'acquisto e le tue note. Una volta terminata l'importazione, torna al foglio sorgente e limita di nuovo la sua condivisione (Share → Restricted). Vale la pena dirlo due volte: non lasciare una copia della tua collezione leggibile pubblicamente tramite link più a lungo del tempo necessario per importare da essa.

7. Capire le tue schede

DASHBOARD e SURPLUS portano entrambe una nota nel foglio che spiega che sono generate. Se un numero su una delle due sembra sbagliato, la correzione va sempre fatta in COPIES o CATALOG — mai direttamente su quelle due schede, poiché le modifiche lì non si conservano (sono formule).

SURPLUS è la tua lista "cosa faccio con i doppioni": qualsiasi gioco di cui possiedi più di una copia non venduta. Filtra per STATUS = UNDECIDED e decidi, copia per copia, KEEP o SELL — direttamente in COPIES. L'elenco si aggiorna da solo non appena cambi uno status.

Tipi di sigillo (la colonna SEALED)

Completezza (la colonna COMPLETENESS)

SEALED, CIB (complete in box — cartuccia, custodia e manuale/inserti, tutto presente), CART-ONLY, CASE-ONLY, BOX-ONLY, MANUAL-ONLY, GRADED (valutata e sigillata professionalmente). La finestra Add game… del foglio ha il proprio menu a tendina Completeness (punto 5), quindi lo imposti direttamente all'aggiunta — di default è SEALED; cambialo in CIB per una copia usata normale, o quello che corrisponde davvero. Il flusso di aggiunta rapida mobile dell'app web non ha ancora quel campo, quindi deriva Completeness da Sealed?: OPEN → CIB, qualsiasi altra cosa → SEALED. In ogni caso, correggilo a mano in seguito in COPIES se mai risulta sbagliato.

Stato di gioco (la colonna PLAY STATUS della scheda CATALOG)

Una scala semplice: BACKLOG (non iniziato) → PLAYING → BEATEN → COMPLETED (completamente finito, non solo i titoli di coda) → DROPPED. Questo vive sul gioco, non sulla copia — riguarda se lo hai giocato, a prescindere da quante copie fisiche possiedi.

Il lato rivenditore (STATUS e INVEST)

La colonna STATUS su COPIES non è solo "tenere o vendere" — supporta anche un flusso deliberato di flip/rivendita: UNDECIDED, KEEP, SELL, SOLD, e INVEST (acquistato specificamente per rivendere, tracciato separatamente dalla tua collezione personale nelle cifre "INVEST capital" e "INVEST copies" della dashboard). Vendere una copia compila SELL PRICE, SELL DATE e SELL CHANNEL, che è ciò che alimenta il profitto realizzato del DASHBOARD — vedi il punto 8 per il modo più rapido di registrare una vendita.

8. L'app web

L'app web è opzionale e parla con esattamente lo stesso foglio di tutto quanto sopra — non lo sostituisce. Si sta attivando gradualmente per i collezionisti della beta; se aprendola non vedi ancora i tuoi dati, è previsto — non c'è nulla di sbagliato nella tua configurazione.

Attivarla: Enable app access

È tutto qui: un clic in più. Esegui 🎮 Collection → Enable app access e fa tutto ciò di cui l'app web ha bisogno, in ordine — ed è sicuro eseguirlo in qualsiasi momento per rivedere i tuoi dati di accesso (token perso, URL dell'app dimenticato, o semplicemente per riconnetterti):

1. Condivide solo questo foglio di calcolo con l'account di servizio dell'API del prodotto — lo stesso modello a privilegio minimo di tutto il resto qui, senza alcun accesso a Drive.
2. Collega il tuo foglio al tuo token di accesso (quello che Setup ha già creato per te al punto 3 — nessuna nuova richiesta, nessuna seconda registrazione) così l'app web sa quale foglio aprire per quel token.
3. Ti mostra una finestra con l'URL dell'app web (https://switch.mygamecollection.app/app) e il tuo token di accesso, pronti da copiare e incollare.

[Screenshot: la finestra "App access" con l'URL dell'app web e il token]

Apri quell'URL, e la prima volta che usi l'app web ti chiederà quel token: incolla quello dalla finestra. Te lo sei perso, o ti serve di nuovo più tardi? È anche sempre nella scheda nascosta CONFIG del tuo foglio, come API_TOKEN (Google Sheets mostra un piccolo indicatore di schede nascoste accanto alla barra delle schede — cliccalo per mostrare CONFIG). In ogni caso, da quel momento viene salvato solo nel tuo browser, e Sign out lo cancella. Tienilo privato — chiunque lo abbia può leggere (e, una volta che sei sull'app web, modificare) la tua collezione. Se mai pensi che sia stato esposto, chiedi a chi amministra il prodotto di emetterti uno nuovo — quello vecchio smette di funzionare immediatamente.

[Screenshot: la schermata "incolla il tuo token" dell'app web]

🎮 Collection → Disable app access annulla la condivisione all'istante, in qualsiasi momento, dallo stesso menu — l'app web non potrà più aprire il tuo foglio finché non riesegui Enable app access.

Cosa fa ogni vista

Registrare una vendita

1. In Collection, clicca sulla riga della copia venduta. Si apre il suo pannello dei dettagli.
2. Cambia Status in SOLD. Appare un piccolo modulo che chiede prezzo di vendita, data di vendita e canale di vendita (EBAY, WALLAPOP, VINTED, LOCAL, OTHER).
3. Compilalo e clicca Confirm sale.

[Screenshot: il mini-modulo di vendita all'interno del pannello dei dettagli di una copia]

Quell'unica azione scrive STATUS, SELL PRICE, SELL DATE e SELL CHANNEL di nuovo nel tuo foglio, e il profitto realizzato della tua dashboard si aggiorna al caricamento successivo.

Sessioni fotografiche, passo per passo

Invece di digitare ogni gioco uno per uno, puoi fotografare uno scaffale e lasciare che identifichi cosa c'è nell'immagine:

1. Apri Photos.
2. Trascina una o più foto di scaffale sulla pagina, o toccala per scegliere i file.
3. Attendi mentre ogni foto viene identificata — questo legge i dorsi/copertine nell'immagine e fa del suo meglio per farli corrispondere.
4. Rivedi quattro gruppi: New (non ancora nella tua collezione), Uncertain (bassa affidabilità — controllali con attenzione), Matched (già nella tua collezione, nulla da fare), e Unseen (copie che possiedi e che non sono state individuate in queste foto — nulla di sbagliato, solo un promemoria).
5. Per un elemento incerto, puoi selezionarlo per aggiungerlo come nuovo, oppure digitare nel suo campo "Link to an existing copy instead…" per farlo corrispondere a qualcosa che possiedi già — a seconda di cosa è corretto.
6. Seleziona le caselle per tutto ciò che vuoi aggiungere, poi clicca Add selected to collection.

[Screenshot: la schermata di revisione della sessione fotografica con i suoi quattro gruppi]

Nulla viene scritto nel tuo foglio prima del passo 6 — il passo di identificazione in sé non modifica mai nulla.

Aggiornamento prezzi

Il pulsante Refresh prices della Dashboard controlla un blocco delle tue copie rispetto agli annunci attuali (Wallapop e Vinted sempre; eBay solo se il tuo amministratore lo ha configurato) e aggiorna MARKET PRICE/PRICE UPDATED per tutto ciò per cui trova una corrispondenza affidabile. Riporta quante sono state aggiornate rispetto a quelle senza corrispondenza, e ricarica automaticamente la dashboard.

Condividi la tua collezione

La scheda Share my collection della Dashboard ti dà una pagina pubblica di sola lettura della tua collezione, a un link non indovinabile che puoi mandare a chiunque — senza che dall'altra parte serva accedere. Ciò che mostra è deliberatamente limitato: nomi dei giochi, edizioni, regioni, completezza, sigillo, punteggio di stato, stato di gioco e copertina. Non mostra mai dove conservi qualcosa, quanto hai pagato, le tue note, o qualsiasi cosa segnata come SOLD.

• Create link crea la tua pagina; Copy mette l'URL negli appunti.
• New link sostituisce la vecchia URL (quella vecchia smette di funzionare istantaneamente) — usalo se un link è finito più lontano di quanto volevi.
• Revoke ritira la pagina del tutto. Puoi crearne una nuova più tardi.

9. Domande frequenti e risoluzione problemi

La mia sincronizzazione quotidiana non è partita — cosa faccio?

Controlla la cella A1 di VERSIONS per la marca temporale dell'ultima esecuzione. Se è più vecchia di un giorno o due, esegui 🎮 Collection → Sync now per un aggiornamento immediato, e riesegui Setup una volta per assicurarti che il trigger giornaliero sia ancora programmato — può occasionalmente essere cancellato se ricopi il foglio o se Google revoca e richiede di nuovo l'autorizzazione.

Perché non vedo il menu 🎮 Collection sul telefono?

I menu personalizzati e le finestre di dialogo non funzionano nelle app mobili di Google Sheets (Android/iOS) — è una limitazione di Google Sheets, non qualcosa di specifico di questo foglio. Questo significa che Add game… e il resto del menu sono solo per desktop/browser web. Sul tuo telefono hai due opzioni: aprire direttamente la scheda COPIES e usare il menu a tendina della colonna NAME (la validazione dei dati funziona su mobile) per aggiungere una riga minima da completare più tardi, oppure — se ce l'hai — usare invece la pagina Add game dell'app web, costruita specificamente per questo caso.

La copertina di un gioco manca o è sbagliata

Le copertine provengono da un database di immagini comunitario condiviso, cercate principalmente per codice cartuccia e, in mancanza di un codice, tramite corrispondenza per nome. Non tutte le uscite e regioni hanno ancora una copertina — alcune regioni (in particolare le copertine PAL italiane) hanno semplicemente una copertura molto più scarsa alla fonte rispetto ad altre, quindi a volte vedrai una copertina della regione inglese come sostituta, o nessuna copertina del tutto. È una lacuna di completezza dei dati, non un segnale che qualcosa sia rotto nel tuo foglio, e si colma nel tempo man mano che il dataset condiviso cresce.

Il mio token dell'app web ha smesso di funzionare

I token possono essere riemessi in qualsiasi momento — chiedine uno nuovo a chi amministra il prodotto. La riemissione invalida immediatamente il vecchio token, quindi se sospetti che il tuo sia trapelato, riemetterlo è anche il modo per disattivare quello vecchio.

DASHBOARD o SURPLUS mostrano un numero che non riconosco

Non modificare quelle schede direttamente — sono generate da formule e le tue modifiche non si conservano. La fonte di verità è sempre COPIES (e CATALOG per i campi a livello di gioco); correggilo lì e le schede generate si aggiornano immediatamente.

Devo usare per forza l'app web?

No. Il foglio è il prodotto completo da solo — tutto ciò che è nei punti da 1 a 7 funziona senza nulla installato e senza token. L'app web è uno strato di comodità per un flusso di aggiunta gioco più rapido da mobile, una dashboard, e inventari tramite foto; saltala del tutto se preferisci.

I miei dati sono davvero privati?

Sì, con un'avvertenza che vale la pena ripetere: l'unico momento in cui il tuo foglio è leggibile tramite link da qualcun altro è se tu lo condividi temporaneamente — più comunemente durante Import data… (punto 6). Limita di nuovo la condivisione non appena l'importazione termina e nessuno all'infuori di te avrà mai avuto accesso permanente.

Supporto e feedback

Questo prodotto è in sviluppo attivo, e il tuo feedback plasma cosa viene costruito dopo. Ti preghiamo di segnalare qualsiasi cosa confusa, rotta o mancante — specialmente riguardo all'onboarding e alla schermata di consenso, che è l'ostacolo più grande per un collezionista non tecnico. Scrivi a [email protected] se non hai ancora un canale di supporto indicato.

Grazie per averlo provato.