My Switch Collection — Guide utilisateur

Bienvenue. Voici le guide complet pour passer de rien à une collection entièrement configurée : votre propre feuille Google, la configuration initiale, l'usage au quotidien, et l'application web complémentaire optionnelle. Il remplace les anciennes notes d'accueil de la bêta et couvre tout le parcours, pas seulement la première semaine.

Vos données vous appartiennent. Votre feuille vit dans votre propre Google Drive, sous votre propre compte Google. Personne d'autre, pas même nous, ne la lit ni n'y écrit sans que vous l'ayez explicitement partagée. Vous pouvez arrêter de la partager, la télécharger, ou la supprimer à tout moment — rien dans ce produit ne vous enferme.

1. Ce que vous obtenez

Deux choses, et vous n'avez jamais besoin que de la première :

• Une feuille Google qui vous appartient entièrement. C'est le vrai produit : un tableur normalisé (des onglets séparés pour votre catalogue, vos exemplaires physiques, votre liste de souhaits, et quelques vues de synthèse en lecture seule) avec un petit script attaché. Ça ne coûte rien, ne nécessite aucune installation, et continue de fonctionner comme une feuille Google classique — filtres, tableaux croisés dynamiques, exports — que vous touchiez ou non le reste de ce guide.
• Une application web optionnelle. Un complément pensé pour le mobile qui parle à la même feuille — rien n'est dupliqué. Elle ajoute un ajout de jeu mobile plus rapide, un tableau de bord, des inventaires par photo, et un suivi des prix. Elle est facultative, et il se peut qu'elle ne soit pas encore activée pour votre collection — voir la partie 8.

2. Créez votre feuille

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

Ouvrez-la, puis Fichier → Créer une copie, et enregistrez la copie dans votre propre Drive — nommez-la comme vous voulez (par exemple « Mon étagère de jeux »). À partir de ce moment, cette copie — les données, la structure de la feuille, et le script qui y est lié — vous appartient entièrement. Rien de ce que vous y faites n'est visible par qui que ce soit, jamais, à moins que vous ne choisissiez de la partager.

[Capture d'écran : le menu « Fichier → Créer une copie » de Google Sheets]

3. Première configuration

Juste après avoir copié le modèle, le menu 🎮 Collection n'affiche qu'un seul élément : Setup. C'est voulu — c'est le seul bouton dont une copie neuve a besoin. Ouvrez 🎮 Collection → Setup : trois choses se produisent, dans cet ordre :

1. Enregistre votre copie auprès de l'API du produit, en utilisant l'adresse e-mail de votre propre compte Google (lue automatiquement — rien à saisir, aucun formulaire). L'enregistrement est idempotent : la même adresse correspond toujours à la même identité, donc recopier le modèle n'accorde jamais une nouvelle place gratuite.
2. Programme la synchronisation quotidienne décrite dans la partie 4 (~05:00, le fuseau horaire de votre copie).
3. Lance cette première synchronisation immédiatement, pour que votre feuille ne reste pas vide en attendant l'exécution du lendemain.

Vous n'avez besoin de cliquer sur Setup qu'une seule fois, juste après la copie — rechargez la feuille ensuite pour voir le menu complet (Add game…, Import data…, Sync now, Enable/Disable app access, et Setup lui-même, conservé au cas où vous auriez besoin de le relancer).

L'écran de permissions, en toute franchise

La première fois que vous exécutez un élément du menu, Google vous demande d'autoriser le script. Comme la copie de chaque collectionneur est techniquement sa propre petite application, et qu'il y a tout simplement trop de copies pour que Google les examine et les « vérifie » individuellement, vous verrez un avertissement disant que « Google n'a pas vérifié cette application ». C'est normal — ce n'est pas le signe que quelque chose ne va pas ou n'est pas sûr. Voici exactement quoi faire :

1. Vous verrez un écran intitulé « Google n'a pas vérifié cette application », avec un bouton Avancé. Cliquez dessus.
2. Une nouvelle ligne apparaît : « Accéder à [nom du projet] (non sécurisé) ». Cliquez dessus. (« Non sécurisé » signifie ici seulement que Google n'a pas fait passer ce script précis par sa revue de vérification formelle — pas qu'il fait quoi que ce soit de nuisible.)
3. Vous verrez alors la vraie liste des permissions — quatre éléments. Passez-les en revue, puis cliquez sur Allow / Continue.

[Capture d'écran : l'avertissement « Google n'a pas vérifié cette application » avec Avancé déplié]

Voici exactement ce que sont ces quatre permissions, et ce que chacune fait réellement — c'est la liste complète, rien d'autre n'est jamais demandé :

Remarquez ce qui n'est pas dans cette liste : il n'y a aucune permission Google Drive générale. Le script ne peut pas voir vos autres fichiers, ne peut pas créer de fichiers dans votre Drive, et ne peut lire aucune autre feuille de calcul que vous possédez. C'est délibérément l'ensemble de permissions le plus restreint qui permette à la feuille de fonctionner.

4. Ce que fait la synchronisation quotidienne

Une fois Setup exécuté, un appel à l'API du produit remplit quatre choses automatiquement : votre onglet VERSIONS (codes cartouche, révisions et régions pour des milliers de sorties Switch connues), et trois colonnes sur CATALOG/COPIES — notes presse et joueurs (PRESS SCORE/USER SCORE), estimations de durée (TIME TO BEAT/TIME TO 100%), et prix de marché (MARKET PRICE/PRICE UPDATED, uniquement pour les exemplaires marqués SELL ou INVEST). Une synchronisation complète prend environ une minute. La cellule A1 de VERSIONS indique toujours quand elle s'est exécutée pour la dernière fois et combien de lignes elle a ramenées.

Vous n'avez rien à faire pour que ça fonctionne — ça tourne dans le cloud une fois par jour (vers 05:00, le fuseau horaire configuré de votre copie) même si votre ordinateur est éteint. Si vous voulez une mise à jour immédiate, utilisez 🎮 Collection → Sync now.

Lire le message de synchronisation

Chaque synchronisation — quotidienne ou à la demande — se termine par une notification qui vous dit exactement ce qui s'est passé :

• « Synced: versions, scores, times, prices » (ou le nombre de ces quatre éléments qui avaient des données à écrire) — tout a fonctionné.
• « Not included (needs a subscription): <name> » — ce jeu de données est réservé à un palier d'abonnement payant que votre compte n'a pas. Rien n'est cassé de votre côté, et le reste de la synchronisation s'est déroulé normalement. (Rien n'est réservé aujourd'hui — chaque jeu de données est gratuit pour tous les collectionneurs — mais le message est prêt pour le jour où un futur palier payant devra le dire clairement plutôt que de retenir des données en silence.)
• « Temporarily unavailable on our side: <name> » — un incident de notre côté (par exemple, une actualisation de données pas encore arrivée). Réessayez plus tard ; vos données existantes pour ce jeu de données ne sont pas touchées.
• « Your access token is no longer valid — run Setup again from the menu. » — relancer Setup vous ré-enregistre et récupère un jeton valide.
• « Could not reach the sync service — check your connection and try again. » — la requête n'a obtenu aucune réponse du tout (hors ligne, DNS, etc.) — distinct du produit lui-même signalant un échec.
• « The sync service had a problem on our side — your sheet is fine, please try again later. » — tout autre problème survenu côté backend du produit. Une synchronisation ratée n'écrase jamais partiellement vos données existantes.

Si une synchronisation échoue un jour, ne vous inquiétez pas — elle réessaie simplement le lendemain, au même horaire, et vos données existantes restent exactement comme elles étaient entre-temps. Consultez la FAQ (partie 9) si ça reste périmé plus de deux jours.

5. Ajouter des jeux

Il y a deux façons d'ajouter un jeu à votre collection : depuis la feuille elle-même, ou depuis l'application web si vous en avez configuré une.

Depuis la feuille (ordinateur/navigateur)

🎮 Collection → Add game… ouvre une boîte de dialogue de recherche :

1. Tapez un nom de jeu ou un code cartouche (par exemple « Hollow Knight » ou LA-H-B). Les résultats de l'onglet VERSIONS apparaissent au fur et à mesure que vous tapez.
2. Choisissez dans la liste l'édition/révision/région exacte que vous possédez.
3. Remplissez les champs rapides avant que quoi que ce soit ne soit écrit : Sealed? (OPEN par défaut, ou un type de scellé s'il est encore scellé d'usine), Price paid (facultatif), Completeness (par défaut SEALED dans le menu déroulant — passez-le à CIB pour un exemplaire d'occasion normal, ou ce qui convient vraiment), Status (KEEP par défaut ; choisissez tout de suite SELL, INVEST ou UNDECIDED si vous le savez déjà), Buy date (aujourd'hui par défaut), et Location (facultatif, par exemple « Étagère A, boîte 2 »).
4. Cliquez sur Add. Une ligne est écrite dans COPIES avec tout ce qui précède plus le nom, la console, la région, le code cartouche et la révision déjà remplis — et une ligne CATALOG est créée automatiquement si le jeu est nouveau dans votre collection.

[Capture d'écran : la boîte de dialogue de recherche Add game avec ses résultats et les champs rapides]

Les exemplaires sont marqués par défaut STATUS = KEEP sauf si vous choisissez autre chose dans la boîte de dialogue — un ajout délibéré est présumé voulu. Si ça s'avère être un doublon de quelque chose que vous possédez déjà, ça apparaîtra dans SURPLUS pour que vous le tranchiez plus tard (partie 7). Tout ce qui n'est pas couvert ci-dessus — notes et score d'état, notes d'impression — reste à remplir plus tard via les menus déroulants dans COPIES.

Depuis l'application web (mobile, en magasin)

Si vous avez configuré l'application web (partie 8), sa page Add game est une version plus rapide et pensée mobile du même flux, conçue spécifiquement pour « je suis actuellement dans un magasin » :

1. Cherchez par nom ou par code cartouche.
2. Touchez l'édition exacte que vous avez en main.
3. Réglez Sealed?, une Location facultative (par exemple « Étagère A, boîte 2 »), Buying as (Keep, ou Invest pour un achat spéculatif délibéré — voir partie 7), et un Price paid facultatif.
4. Touchez Add to collection.

[Capture d'écran : le formulaire d'ajout rapide Add game de l'application web]

Ça écrit dans exactement le même onglet COPIES que la boîte de dialogue de la feuille — il n'y a pas de base de données mobile séparée à synchroniser.

6. Importer et restaurer entre copies

🎮 Collection → Import data… ramène CATALOG/COPIES/PIPELINE (et vos onglets personnels BATTERY/NOTES, s'ils existent) depuis une autre copie de cette feuille, à partir de son identifiant de feuille de calcul. C'est l'outil pour :

• Restaurer vos propres données dans une copie neuve, si quelque chose se passe mal.
• Migrer entre deux de vos propres copies.
• Mettre à niveau vers une version plus récente du modèle sans perdre vos données — copiez le nouveau modèle, puis importez depuis l'URL de votre ancienne copie. L'import tolère les anciennes structures (colonnes manquantes, ordre différent) en faisant correspondre les colonnes par leur nom, donc ça fonctionne même si votre ancienne copie est antérieure à des colonnes plus récentes.

Pour l'utiliser, la feuille source doit être temporairement partagée en « Tous les utilisateurs disposant du lien : Lecteur ». La boîte de dialogue demande son identifiant de feuille de calcul, récupère et valide chaque onglet, et — si la destination a déjà des données — vous demande confirmation avant d'écraser.

[Capture d'écran : l'étape de confirmation de la boîte de dialogue Import data]

Remarque sur la confidentialité. Tant que la feuille source est partagée par lien, quiconque a ce lien peut la lire — y compris vos prix d'achat et vos notes. Une fois l'import terminé, retournez sur la feuille source et restreignez à nouveau son partage (Share → Restricted). Ça vaut la peine de le répéter : ne laissez pas une copie de votre collection lisible publiquement par lien plus longtemps que le temps nécessaire pour importer depuis elle.

7. Comprendre vos onglets

DASHBOARD et SURPLUS portent toutes deux une note dans la feuille expliquant qu'elles sont générées. Si un chiffre sur l'une des deux semble faux, la correction se fait toujours dans COPIES ou CATALOG — jamais directement sur ces deux onglets, puisque les modifications qui y sont faites ne tiennent pas (ce sont des formules).

SURPLUS est votre liste « que faire avec les doublons » : tout jeu dont vous possédez plus d'un exemplaire non vendu. Filtrez sur STATUS = UNDECIDED et décidez, exemplaire par exemplaire, KEEP ou SELL — directement dans COPIES. La liste se met à jour d'elle-même dès que vous changez un statut.

Types de scellé (la colonne SEALED)

Complétude (la colonne COMPLETENESS)

SEALED, CIB (complet en boîte — cartouche, boîtier et manuel/inserts, tout présent), CART-ONLY, CASE-ONLY, BOX-ONLY, MANUAL-ONLY, GRADED (gradé et scellé professionnellement). La boîte de dialogue Add game… de la feuille a son propre menu déroulant Completeness (partie 5), vous le réglez donc directement à l'ajout — par défaut SEALED ; passez-le à CIB pour un exemplaire d'occasion normal, ou ce qui convient vraiment. L'ajout rapide mobile de l'application web n'a pas encore ce champ, il déduit donc Completeness à partir de Sealed? : OPEN → CIB, autre chose → SEALED. Dans les deux cas, corrigez-le à la main ensuite dans COPIES si jamais c'est faux.

Statut de jeu (la colonne PLAY STATUS de l'onglet CATALOG)

Une échelle simple : BACKLOG (pas commencé) → PLAYING → BEATEN → COMPLETED (entièrement fini, pas seulement le générique) → DROPPED. Ça vit sur le jeu, pas sur l'exemplaire — c'est une question de si vous l'avez joué, indépendamment du nombre d'exemplaires physiques que vous possédez.

Le côté revendeur (STATUS et INVEST)

La colonne STATUS sur COPIES n'est pas seulement « garder ou vendre » — elle supporte aussi un flux délibéré de flip/revente : UNDECIDED, KEEP, SELL, SOLD, et INVEST (acheté spécifiquement pour revendre, suivi séparément de votre collection personnelle dans les chiffres « INVEST capital » et « INVEST copies » du tableau de bord). Vendre un exemplaire remplit SELL PRICE, SELL DATE, et SELL CHANNEL, ce qui alimente le bénéfice réalisé du DASHBOARD — voir partie 8 pour la façon la plus rapide d'enregistrer une vente.

8. L'application web

L'application web est optionnelle et parle à exactement la même feuille que tout ce qui précède — elle ne la remplace pas. Elle s'ouvre progressivement aux collectionneurs de la bêta ; si l'ouvrir n'affiche pas encore vos données, c'est normal — rien ne va de travers dans votre propre configuration.

L'activer : Enable app access

C'est tout : un clic de plus. Exécutez 🎮 Collection → Enable app access et ça fait tout ce dont l'application web a besoin, dans l'ordre — et c'est sûr à exécuter n'importe quand pour revoir vos informations d'accès (jeton perdu, URL de l'app oubliée, ou simplement pour vous reconnecter) :

1. Partage uniquement cette feuille de calcul avec le compte de service de l'API du produit — le même modèle de moindre privilège que partout ailleurs ici, sans impliquer d'accès à Drive.
2. Relie votre feuille à votre jeton d'accès (celui que Setup a déjà créé pour vous dans la partie 3 — pas de nouvelle demande, pas de second enregistrement) pour que l'application web sache quelle feuille ouvrir pour ce jeton.
3. Vous affiche une boîte de dialogue avec l'URL de l'application web (https://switch.mygamecollection.app/app) et votre jeton d'accès, prêts à copier-coller.

[Capture d'écran : la boîte de dialogue « App access » avec l'URL de l'application web et le jeton]

Ouvrez cette URL, et la première fois que vous utilisez l'application web, elle vous demande ce jeton : collez celui de la boîte de dialogue. Vous l'avez raté, ou en avez besoin de nouveau plus tard ? Il est aussi toujours dans l'onglet caché CONFIG de votre feuille, sous API_TOKEN (Google Sheets affiche un petit indicateur d'onglets cachés à côté de la barre d'onglets — cliquez dessus pour afficher CONFIG). Dans tous les cas, il n'est ensuite stocké que dans votre propre navigateur, et Sign out l'efface. Gardez-le privé — quiconque le possède peut lire (et, une fois sur l'application web, modifier) votre collection. Si vous pensez qu'il a été exposé, demandez à qui administre le produit de vous en émettre un nouveau — l'ancien cesse de fonctionner immédiatement.

[Capture d'écran : l'écran « collez votre jeton » de l'application web]

🎮 Collection → Disable app access annule le partage instantanément, à tout moment, depuis le même menu — l'application web ne pourra plus ouvrir votre feuille tant que vous ne relancez pas Enable app access.

Ce que fait chaque vue

Enregistrer une vente

1. Dans Collection, cliquez sur la ligne de l'exemplaire vendu. Son panneau de détails s'ouvre.
2. Passez Status à SOLD. Un petit formulaire apparaît demandant le prix de vente, la date de vente, et le canal de vente (EBAY, WALLAPOP, VINTED, LOCAL, OTHER).
3. Remplissez-le et cliquez sur Confirm sale.

[Capture d'écran : le mini-formulaire de vente dans le panneau de détails d'un exemplaire]

Cette seule action écrit STATUS, SELL PRICE, SELL DATE, et SELL CHANNEL dans votre feuille, et le bénéfice réalisé de votre tableau de bord se met à jour au chargement suivant.

Sessions photo, étape par étape

Plutôt que de saisir chaque jeu un par un, vous pouvez photographier une étagère et laisser l'outil identifier ce qui s'y trouve :

1. Ouvrez Photos.
2. Déposez une ou plusieurs photos d'étagère sur la page, ou touchez-la pour choisir des fichiers.
3. Attendez que chaque photo soit identifiée — ça lit les tranches/ jaquettes dans l'image et fait de son mieux pour les faire correspondre.
4. Passez en revue quatre groupes : New (pas encore dans votre collection), Uncertain (confiance faible — vérifiez-les soigneusement), Matched (déjà dans votre collection, rien à faire), et Unseen (exemplaires que vous possédez et qui n'ont pas été repérés sur ces photos — rien d'anormal, juste un rappel).
5. Pour un élément incertain, vous pouvez soit le cocher pour l'ajouter comme nouveau, soit taper dans son champ « Link to an existing copy instead… » pour le faire correspondre à quelque chose que vous possédez déjà — selon ce qui est correct.
6. Cochez les cases de tout ce que vous voulez ajouter, puis cliquez sur Add selected to collection.

[Capture d'écran : l'écran de revue de session photo avec ses quatre groupes]

Rien n'est écrit dans votre feuille avant l'étape 6 — l'étape d'identification elle-même ne modifie jamais rien.

Actualisation des prix

Le bouton Refresh prices du Dashboard vérifie un lot de vos exemplaires par rapport aux annonces actuelles (toujours Wallapop et Vinted ; eBay seulement si votre administrateur l'a configuré) et met à jour MARKET PRICE/PRICE UPDATED pour tout ce pour quoi il trouve une correspondance fiable. Il indique combien ont été mis à jour par rapport à ceux sans correspondance, et recharge automatiquement le tableau de bord.

Partagez votre collection

La carte Share my collection du Dashboard vous donne une page publique en lecture seule de votre collection, à un lien impossible à deviner que vous pouvez envoyer à qui vous voulez — sans connexion nécessaire de leur côté. Ce qu'elle affiche est délibérément limité : noms de jeux, éditions, régions, complétude, scellé, score d'état, statut de jeu et jaquette. Elle ne montre jamais où vous rangez quoi que ce soit, ce que vous avez payé, vos notes, ni rien marqué SOLD.

• Create link crée votre page ; Copy met l'URL dans votre presse-papiers.
• New link remplace l'ancienne URL (l'ancienne cesse de fonctionner instantanément) — à utiliser si un lien s'est échappé plus loin que prévu.
• Revoke retire la page entièrement. Vous pouvez en créer une nouvelle plus tard.

9. FAQ et dépannage

Ma synchronisation quotidienne ne s'est pas lancée — que faire ?

Vérifiez la cellule A1 de VERSIONS pour l'horodatage de la dernière exécution. Si elle date de plus d'un jour ou deux, exécutez 🎮 Collection → Sync now pour une actualisation immédiate, et relancez Setup une fois pour vous assurer que le déclencheur quotidien est toujours programmé — il peut parfois être effacé si vous recopiez la feuille ou si Google révoque et redemande l'autorisation.

Pourquoi je ne vois pas le menu 🎮 Collection sur mon téléphone ?

Les menus personnalisés et les boîtes de dialogue ne fonctionnent pas dans les applications mobiles Google Sheets (Android/iOS) — c'est une limitation de Google Sheets, pas quelque chose de spécifique à cette feuille. Ça veut dire que Add game… et le reste du menu sont réservés à l'ordinateur/au navigateur web. Sur votre téléphone, vous avez deux options : ouvrir directement l'onglet COPIES et utiliser le menu déroulant de la colonne NAME (la validation de données fonctionne sur mobile) pour ajouter une ligne minimale que vous finirez plus tard, ou — si vous l'avez — utiliser à la place la page Add game de l'application web, conçue spécifiquement pour ce cas.

La jaquette d'un jeu est manquante ou incorrecte

La jaquette vient d'une base de données d'images communautaire partagée, recherchée d'abord par code cartouche puis, à défaut, par correspondance de nom. Toutes les sorties et régions n'ont pas encore de jaquette — certaines régions (en particulier le visuel de boîte PAL espagnol) ont tout simplement une couverture bien plus mince à la source que d'autres, donc vous verrez parfois une jaquette de la région anglaise en remplacement, ou aucune jaquette du tout. C'est un manque de complétude des données, pas le signe que quelque chose est cassé dans votre propre feuille, et ça se comble avec le temps à mesure que le jeu de données partagé grandit.

Mon jeton d'application web a cessé de fonctionner

Les jetons peuvent être réémis à tout moment — demandez-en un nouveau à qui administre le produit. La réémission invalide immédiatement l'ancien jeton, donc si vous soupçonnez que le vôtre a fuité, réémettre est aussi la façon de couper l'ancien.

DASHBOARD ou SURPLUS affichent un chiffre que je ne reconnais pas

Ne modifiez pas ces onglets directement — ils sont générés à partir de formules et vos modifications ne tiennent pas. La source de vérité est toujours COPIES (et CATALOG pour les champs au niveau du jeu) ; corrigez-le là et les onglets générés se mettent à jour immédiatement.

Dois-je utiliser l'application web ?

Non. La feuille est le produit complet à elle seule — tout ce qui est décrit dans les parties 1 à 7 fonctionne sans rien installer et sans jeton. L'application web est une couche de confort pour un ajout de jeu mobile plus rapide, un tableau de bord, et des inventaires par photo ; sautez-la entièrement si vous préférez.

Mes données sont-elles vraiment privées ?

Oui, avec une réserve qui mérite d'être répétée : le seul moment où votre feuille est lisible par lien par quelqu'un d'autre, c'est si vous la partagez temporairement — le plus souvent pendant Import data… (partie 6). Restreignez à nouveau le partage dès que l'import est terminé et personne d'autre que vous n'aura jamais eu d'accès permanent.

Support et retours

Ce produit est en développement actif, et vos retours façonnent ce qui est construit ensuite. Merci de signaler tout ce qui est confus, cassé, ou manquant — en particulier autour de l'accueil et de l'écran de consentement, qui est le plus gros obstacle pour un collectionneur non technique. Écrivez à [email protected] si aucun canal de support ne vous est encore indiqué.

Merci d'avoir essayé.