My Switch Collection — Guía de usuario

Bienvenido/a. Esta es la guía completa para pasar de cero a tener tu colección completamente configurada: tu propia hoja de Google, la configuración inicial, el uso del día a día y la app web complementaria opcional. Sustituye a las antiguas notas de incorporación a la beta y cubre todo el recorrido, no solo la primera semana.

Tus datos son tuyos. Tu hoja vive en tu propio Google Drive, bajo tu propia cuenta de Google. Nadie más, ni siquiera nosotros, la lee ni la escribe a menos que tú la compartas expresamente. Puedes dejar de compartirla, descargarla o borrarla cuando quieras — nada en este producto te ata a él.

1. Qué obtienes

Dos cosas, y solo necesitas la primera:

• Una hoja de Google que es completamente tuya. Este es el producto de verdad: una hoja de cálculo normalizada (pestañas separadas para tu catálogo, tus copias físicas, tu lista de deseos, y un par de vistas de resumen de solo lectura) con un pequeño script vinculado. No cuesta nada, no necesita instalación, y sigue funcionando como una hoja de Google normal — filtros, tablas dinámicas, exportaciones — la toques o no como se describe en el resto de esta guía.
• Una app web opcional. Un complemento pensado para el móvil que habla con la misma hoja — nada se duplica. Añade un alta de juegos más rápida desde el móvil, un panel, inventarios por foto y seguimiento de precios. Es opcional, y puede que todavía no esté activada para tu colección — mira el apartado 8.

2. Crea tu hoja

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

Ábrela, luego Archivo → Crear una copia, y guarda la copia en tu propio Drive — llámala como quieras (por ejemplo, "Mi Estantería de Juegos"). A partir de este momento, esta copia — los datos, la estructura de la hoja y el script vinculado a ella — es completamente tuya. Nada de lo que hagas en ella es visible para nadie más, nunca, a menos que decidas compartirla.

[Captura de pantalla: el menú "Archivo → Crear una copia" de Google Sheets]

3. Configuración inicial

Justo después de copiar la plantilla, el menú 🎮 Collection muestra solo un elemento: Setup. Es intencionado — es el único botón que necesita una copia recién hecha. Abre 🎮 Collection → Setup y hace tres cosas, en este orden:

1. Registra tu copia en la API del producto, usando el correo de tu propia cuenta de Google (se lee automáticamente — nada que escribir, sin formularios). El registro es idempotente: el mismo correo siempre corresponde a la misma identidad, así que volver a copiar la plantilla nunca concede una nueva plaza gratuita.
2. Programa la sincronización diaria descrita en el apartado 4 (~05:00, la zona horaria de tu copia).
3. Ejecuta esa primera sincronización de inmediato, para que tu hoja no quede vacía mientras esperas a la ejecución de mañana.

Solo necesitas pulsar Setup una vez, justo después de copiar — recarga la hoja después para ver el menú completo (Add game…, Import data…, Sync now, Enable/Disable app access, y el propio Setup, que se mantiene por si alguna vez necesitas volver a ejecutarlo).

La pantalla de permisos, sin rodeos

La primera vez que ejecutes cualquier elemento del menú, Google te pedirá autorizar el script. Como la copia de cada coleccionista es técnicamente su propia pequeña aplicación, y hay sencillamente demasiadas copias como para que Google las revise y "verifique" una por una, verás un aviso que dice "Google no ha verificado esta app." Es lo esperado — no es una señal de que algo vaya mal o sea inseguro. Esto es exactamente lo que hay que hacer:

1. Verás una pantalla titulada "Google no ha verificado esta app", con un botón llamado Avanzado. Pulsa ahí.
2. Aparece una línea nueva: "Ir a [nombre del proyecto] (no seguro)". Púlsala. ("No seguro" aquí solo significa que Google no ha hecho pasar este script concreto por su revisión de verificación formal — no que haga algo dañino.)
3. Ahora verás la lista de permisos real — cuatro elementos. Revísalos y luego pulsa Allow / Continue.

[Captura de pantalla: el aviso "Google no ha verificado esta app" con Avanzado desplegado]

Esto es exactamente lo que son esos cuatro permisos, y qué hace realmente cada uno — esta es la lista completa, nunca se pide nada más:

Fíjate en lo que no está en esa lista: no hay ningún permiso general de Google Drive. El script no puede ver tus otros archivos, no puede crear archivos en tu Drive, y no puede leer ninguna otra hoja de cálculo que poseas. Es deliberadamente el conjunto de permisos más estrecho posible que hace que la hoja funcione.

4. Qué hace la sincronización diaria

Una vez que Setup se ejecuta, una llamada a la API del producto rellena cuatro cosas automáticamente: tu pestaña VERSIONS (códigos de cartucho, revisiones y regiones de miles de lanzamientos de Switch conocidos), y tres columnas en CATALOG/COPIES — puntuaciones de prensa y usuarios (PRESS SCORE/USER SCORE), estimaciones de duración (TIME TO BEAT/TIME TO 100%), y precios de mercado (MARKET PRICE/PRICE UPDATED, solo para copias que hayas marcado como SELL o INVEST). Una sincronización completa tarda alrededor de un minuto. La celda A1 de VERSIONS siempre muestra cuándo se ejecutó por última vez y cuántas filas trajo.

No necesitas hacer nada para que esto funcione — se ejecuta en la nube una vez al día (sobre las 05:00, en la zona horaria configurada de tu copia) aunque tu portátil esté apagado. Si alguna vez quieres una actualización inmediata, usa 🎮 Collection → Sync now.

Cómo leer el mensaje de sincronización

Cada sincronización — diaria o bajo demanda — termina con un aviso que te dice exactamente qué ha pasado:

• "Synced: versions, scores, times, prices" (o los que de los cuatro tuvieran datos que escribir) — todo ha funcionado.
• "Not included (needs a subscription): <name>" — ese conjunto de datos está reservado a un nivel de suscripción de pago que tu cuenta no tiene. Nada se ha roto por tu parte, y el resto de la sincronización ha seguido su curso con normalidad. (Hoy no hay nada reservado — todos los conjuntos de datos son gratuitos para todo coleccionista — pero el mensaje está listo para cuando un futuro nivel de pago necesite decir esto con claridad en lugar de retener datos en silencio.)
• "Temporarily unavailable on our side: <name>" — un contratiempo por nuestra parte (por ejemplo, una actualización de datos que aún no ha llegado). Inténtalo más tarde; tus datos existentes para ese conjunto no se tocan.
• "Your access token is no longer valid — run Setup again from the menu." — volver a ejecutar Setup te vuelve a registrar y obtiene un token que funciona.
• "Could not reach the sync service — check your connection and try again." — la solicitud nunca obtuvo respuesta alguna (sin conexión, DNS, y similares) — distinto de que el propio producto informe de un fallo.
• "The sync service had a problem on our side — your sheet is fine, please try again later." — cualquier otra cosa que haya fallado en el backend del producto. Una sincronización fallida nunca sobrescribe parcialmente tus datos existentes.

Si una sincronización falla alguna vez, no te preocupes — simplemente lo vuelve a intentar en el mismo horario al día siguiente, y tus datos existentes se quedan exactamente como estaban mientras tanto. Consulta las preguntas frecuentes (apartado 9) si se queda desactualizada durante más de un par de días.

5. Añadir juegos

Hay dos formas de añadir un juego a tu colección: desde la propia hoja, o desde la app web si tienes una configurada.

Desde la hoja (escritorio/navegador)

🎮 Collection → Add game… abre un diálogo de búsqueda:

1. Escribe el nombre de un juego o un código de cartucho (por ejemplo, "Hollow Knight" o LA-H-B). Los resultados de la pestaña VERSIONS aparecen mientras escribes.
2. Elige de la lista la edición/revisión/región exacta que tienes.
3. Rellena los campos rápidos antes de que se escriba nada: Sealed? (OPEN por defecto, o un tipo de precinto si sigue precintado de fábrica), Price paid (opcional), Completeness (por defecto SEALED en el desplegable — cámbialo a CIB para una copia usada normal, o lo que realmente corresponda), Status (KEEP por defecto; elige SELL, INVEST o UNDECIDED de inmediato si ya lo sabes), Buy date (por defecto hoy), y Location (opcional, por ejemplo "Estantería A, caja 2").
4. Pulsa Add. Se escribe una fila en COPIES con todo lo anterior más el nombre, la consola, la región, el código de cartucho y la revisión ya rellenados — y se crea automáticamente una fila en CATALOG si el juego es nuevo en tu colección.

[Captura de pantalla: el diálogo de búsqueda Add game con resultados y los campos rápidos]

Las copias se marcan por defecto como STATUS = KEEP a menos que elijas otra cosa en el diálogo — se presume que un alta deliberada es algo que quieres quedarte. Si resulta ser un duplicado de algo que ya tienes, aparecerá en SURPLUS para que lo gestiones más tarde (apartado 7). Cualquier cosa no cubierta arriba — notas y puntuación de estado, notas de impresión — se deja para que la rellenes después desde los desplegables en COPIES.

Desde la app web (móvil, en tienda)

Si tienes la app web configurada (apartado 8), su página Add game es una versión más rápida y pensada para el móvil del mismo flujo, construida específicamente para "estoy ahora mismo en una tienda":

1. Busca por nombre o código de cartucho.
2. Toca la edición exacta que tienes en la mano.
3. Ajusta Sealed?, una Location opcional (por ejemplo "Estantería A, caja 2"), Buying as (Keep, o Invest para una compra especulativa deliberada — ver apartado 7), y un Price paid opcional.
4. Toca Add to collection.

[Captura de pantalla: el formulario de alta rápida Add game de la app web]

Esto escribe en exactamente la misma pestaña COPIES que el diálogo de la hoja — no hay una base de datos móvil separada que mantener sincronizada.

6. Importar y restaurar entre copias

🎮 Collection → Import data… trae CATALOG/COPIES/PIPELINE (y tus pestañas personales BATTERY/NOTES, si existen) desde otra copia de esta hoja, dado su ID de hoja de cálculo. Esta es la herramienta para:

• Restaurar tus propios datos en una copia nueva, si algo sale mal.
• Migrar entre dos copias tuyas.
• Actualizar a una versión más nueva de la plantilla sin perder tus datos — copia la plantilla nueva y luego importa desde la URL de tu copia antigua. La importación tolera diseños antiguos (columnas que faltan, orden de columnas distinto) al hacer coincidir las columnas por nombre, así que esto funciona incluso si tu copia antigua es anterior a columnas más nuevas.

Para usarla, la hoja origen necesita estar compartida temporalmente como "Cualquier persona con el enlace: Lector". El diálogo pide su ID de hoja de cálculo, obtiene y valida cada pestaña y — si el destino ya tiene datos — te pide confirmación antes de sobrescribir.

[Captura de pantalla: el paso de confirmación del diálogo Import data]

Nota de privacidad. Mientras la hoja origen está compartida por enlace, cualquiera con ese enlace puede leerla — incluyendo tus precios de compra y tus notas. En cuanto termine la importación, vuelve a la hoja origen y restringe de nuevo su compartición (Share → Restricted). Vale la pena decirlo dos veces: no dejes una copia de tu colección públicamente legible por enlace más tiempo del que tarde en importarse.

7. Entendiendo tus pestañas

DASHBOARD y SURPLUS llevan ambas una nota en la propia hoja explicando que son generadas. Si un número en cualquiera de las dos parece incorrecto, el arreglo siempre está en COPIES o CATALOG — nunca directamente en esas dos pestañas, ya que las ediciones ahí no se conservan (son fórmulas).

SURPLUS es tu lista de "qué hago con los duplicados": cualquier juego del que poseas más de una copia no vendida. Filtra por STATUS = UNDECIDED y decide, copia a copia, KEEP o SELL — directamente en COPIES. La lista se actualiza sola en cuanto cambias un status.

Tipos de precinto (la columna SEALED)

Completitud (la columna COMPLETENESS)

SEALED, CIB (completo en caja — cartucho, caja y manual/insertos, todo presente), CART-ONLY, CASE-ONLY, BOX-ONLY, MANUAL-ONLY, GRADED (graduada y sellada profesionalmente). El diálogo Add game… de la hoja tiene su propio desplegable de Completeness (apartado 5) así que lo ajustas directamente al añadir — por defecto es SEALED; cámbialo a CIB para una copia usada normal, o lo que realmente corresponda. El alta rápida móvil de la app web todavía no tiene ese campo, así que deriva Completeness a partir de Sealed?: OPEN → CIB, cualquier otra cosa → SEALED. En cualquier caso, corrígelo a mano después en COPIES si alguna vez está mal.

Estado de juego (la columna PLAY STATUS de la pestaña CATALOG)

Una escala sencilla: BACKLOG (sin empezar) → PLAYING → BEATEN → COMPLETED (totalmente terminado, no solo los créditos) → DROPPED. Esto vive en el juego, no en la copia — trata de si lo has jugado, con independencia de cuántas copias físicas poseas.

El lado del revendedor (STATUS e INVEST)

La columna STATUS en COPIES no es solo "quedármelo o venderlo" — también soporta un flujo deliberado de flip/reventa: UNDECIDED, KEEP, SELL, SOLD, e INVEST (comprado específicamente para revender, seguido por separado de tu colección personal en las cifras "INVEST capital" e "INVEST copies" del panel). Vender una copia rellena SELL PRICE, SELL DATE y SELL CHANNEL, que es lo que alimenta el beneficio realizado del DASHBOARD — ver apartado 8 para la forma más rápida de registrar una venta.

8. La app web

La app web es opcional y habla con exactamente la misma hoja que todo lo anterior — no la sustituye. Se está activando poco a poco para los coleccionistas de la beta; si al abrirla todavía no ves tus datos, es lo esperado — no hay nada mal en tu propia configuración.

Activarla: Enable app access

Es todo esto: un clic más. Ejecuta 🎮 Collection → Enable app access y hace todo lo que la app web necesita, en orden — y es seguro ejecutarlo en cualquier momento para volver a ver tus datos de acceso (perdiste tu token, olvidaste la URL de la app, o simplemente te estás reconectando):

1. Comparte solo esta hoja de cálculo con la cuenta de servicio de la API del producto — el mismo modelo de mínimo privilegio que todo lo demás aquí, sin implicar acceso a Drive.
2. Vincula tu hoja a tu token de acceso (el que Setup ya creó para ti en el apartado 3 — sin nueva solicitud, sin segundo registro) para que la app web sepa qué hoja abrir con ese token.
3. Te muestra un diálogo con la URL de la app web (https://switch.mygamecollection.app/app) y tu token de acceso, listos para copiar y pegar.

[Captura de pantalla: el diálogo "App access" con la URL de la app web y el token]

Abre esa URL, y la primera vez que uses la app web te pedirá ese token: pega el del diálogo. ¿Se te pasó, o lo necesitas de nuevo más tarde? También está siempre en la pestaña oculta CONFIG de tu hoja, como API_TOKEN (Google Sheets muestra un pequeño indicador de pestañas ocultas junto a la barra de pestañas — pulsa ahí para mostrar CONFIG). En cualquier caso, a partir de ahí se guarda solo en tu propio navegador, y Sign out lo borra. Mantenlo en privado — quien lo tenga puede leer (y, una vez estés en la app web, editar) tu colección. Si alguna vez crees que se ha expuesto, pide a quien administre el producto que te emita uno nuevo — el antiguo deja de funcionar de inmediato.

[Captura de pantalla: la pantalla "pega tu token" de la app web]

🎮 Collection → Disable app access deshace la compartición al instante, en cualquier momento, desde el mismo menú — la app web ya no podrá abrir tu hoja hasta que vuelvas a ejecutar Enable app access.

Qué hace cada vista

Registrar una venta

1. En Collection, haz clic en la fila de la copia que vendiste. Se abre su panel de detalles.
2. Cambia Status a SOLD. Aparece un pequeño formulario que pide precio de venta, fecha de venta y canal de venta (EBAY, WALLAPOP, VINTED, LOCAL, OTHER).
3. Rellénalo y pulsa Confirm sale.

[Captura de pantalla: el mini-formulario de venta dentro del panel de detalles de una copia]

Esa única acción escribe STATUS, SELL PRICE, SELL DATE y SELL CHANNEL de vuelta en tu hoja, y el beneficio realizado de tu dashboard se actualiza en la siguiente carga.

Sesiones de fotos, paso a paso

En lugar de escribir cada juego uno a uno, puedes fotografiar una estantería y dejar que identifique lo que hay en la imagen:

1. Abre Photos.
2. Suelta una o varias fotos de estantería en la página, o tócala para elegir archivos.
3. Espera mientras se identifica cada foto — esto lee los lomos/portadas de la imagen y hace lo posible por hacerlos coincidir.
4. Revisa cuatro grupos: New (todavía no está en tu colección), Uncertain (confianza baja — revísalos con cuidado), Matched (ya está en tu colección, nada que hacer), y Unseen (copias que posees que no aparecieron en estas fotos — no pasa nada, es solo un recordatorio).
5. Para un elemento incierto, puedes marcarlo para añadirlo como nuevo, o escribir en su campo "Link to an existing copy instead…" para hacerlo coincidir con algo que ya tienes — lo que sea correcto.
6. Marca las casillas de todo lo que quieras añadir, y luego pulsa Add selected to collection.

[Captura de pantalla: la pantalla de revisión de la sesión de fotos con sus cuatro grupos]

Nada se escribe en tu hoja hasta el paso 6 — el paso de identificación en sí nunca modifica nada.

Actualización de precios

El botón Refresh prices del Dashboard comprueba un lote de tus copias contra los anuncios actuales (Wallapop y Vinted siempre; eBay solo si tu administrador lo ha configurado) y actualiza MARKET PRICE/PRICE UPDATED para todo aquello donde encuentra una coincidencia fiable. Informa de cuántas se actualizaron frente a cuántas no tuvieron coincidencia, y recarga el dashboard automáticamente.

Comparte tu colección

La tarjeta Share my collection del Dashboard te da una página pública de solo lectura de tu colección en un enlace no adivinable que puedes enviar a quien quieras — sin que necesiten iniciar sesión por su parte. Lo que muestra es deliberadamente limitado: nombres de juego, ediciones, regiones, completitud, precinto, puntuación de estado, estado de juego y portada. Nunca muestra dónde guardas nada, lo que pagaste, tus notas, ni nada marcado como SOLD.

• Create link crea tu página; Copy pone la URL en tu portapapeles.
• New link sustituye la URL antigua (la antigua deja de funcionar al instante) — úsalo si un enlace se ha escapado más de lo que querías.
• Revoke retira la página por completo. Puedes crear una nueva más tarde.

9. Preguntas frecuentes y solución de problemas

Mi sincronización diaria no se ejecutó — ¿qué hago?

Revisa la celda A1 de VERSIONS para ver la marca de tiempo de la última ejecución. Si tiene más de un día o dos de antigüedad, ejecuta 🎮 Collection → Sync now para una actualización inmediata, y vuelve a ejecutar Setup una vez para asegurarte de que el disparador diario sigue programado — a veces puede borrarse si vuelves a copiar la hoja o si Google revoca y vuelve a pedir autorización.

¿Por qué no veo el menú 🎮 Collection en el móvil?

Los menús personalizados y los diálogos emergentes no funcionan en las apps móviles de Google Sheets (Android/iOS) — es una limitación de Google Sheets, no algo específico de esta hoja. Eso significa que Add game… y el resto del menú son solo de escritorio/navegador web. En tu móvil, tienes dos opciones: abrir la pestaña COPIES directamente y usar el desplegable de la columna NAME (la validación de datos sí funciona en móvil) para añadir una fila básica que termines más tarde, o — si la tienes — usar en su lugar la página Add game de la app web, construida específicamente para este caso.

La portada de un juego falta o está mal

La portada viene de una base de datos comunitaria de arte compartida, buscada principalmente por código de cartucho y recurriendo a la coincidencia por nombre cuando no hay código disponible. Todavía no todos los lanzamientos y regiones tienen portada — algunas regiones (especialmente el arte de caja PAL español) simplemente tienen una cobertura mucho más escasa en origen que otras, así que a veces verás una portada de la región inglesa haciendo de sustituta, o ninguna portada en absoluto. Es un vacío de completitud de datos, no una señal de que algo esté roto en tu propia hoja, y se va rellenando con el tiempo a medida que crece el conjunto de datos compartido.

Mi token de la app web ha dejado de funcionar

Los tokens se pueden reemitir en cualquier momento — pide uno nuevo a quien administre el producto. Reemitir invalida el token antiguo de inmediato, así que si sospechas que el tuyo se ha filtrado, reemitirlo es también la forma de desactivar el antiguo.

DASHBOARD o SURPLUS muestran un número que no reconozco

No edites esas pestañas directamente — se generan a partir de fórmulas y tus ediciones no se conservan. La fuente de verdad siempre es COPIES (y CATALOG para los campos a nivel de juego); arréglalo ahí y las pestañas generadas se ponen al día de inmediato.

¿Tengo que usar la app web?

No. La hoja es el producto completo por sí sola — todo lo de los apartados 1 al 7 funciona sin nada instalado y sin token. La app web es una capa de comodidad para un alta de juegos más rápida desde el móvil, un panel, e inventarios por foto; sáltatela por completo si lo prefieres.

¿Mis datos son realmente privados?

Sí, con una salvedad que merece repetirse: el único momento en que tu hoja es legible por enlace para otra persona es si tú la compartes temporalmente — lo más habitual, durante Import data… (apartado 6). Restringe la compartición de nuevo en cuanto termine la importación y nadie fuera de ti habrá tenido nunca acceso permanente.

Soporte y comentarios

Este producto está en desarrollo activo, y tus comentarios dan forma a lo que se construye a continuación. Por favor, informa de cualquier cosa confusa, rota o que falte — especialmente en torno a la incorporación y la pantalla de consentimiento, que es el mayor obstáculo para un coleccionista no técnico. Escribe a [email protected] si todavía no tienes un canal de soporte indicado.

Gracias por probarlo.