Crea códigos QR dinámicos desde una hoja de Google con Apps Script

Para crear códigos QR dinámicos desde una hoja de Google, pon un enlace por fila con tu propio identificador de referencia, pega un breve Apps Script en la hoja, guarda tu token de API en las propiedades del script y ejecútalo desde un menú. El script envía las filas a la API REST de QR Maker en lotes de 100 y escribe el enlace corto de cada fila en la hoja. Si vuelves a ejecutarlo, solo rellena las filas que siguen vacías, así que nunca crea duplicados.

Cuándo es la herramienta adecuada

Una hoja de cálculo es donde ya viven la mayoría de las listas de productos, planos de mesas y seguimientos de campañas. Si alguien de tu equipo mantiene esa lista a mano, crear los códigos desde la misma hoja mantiene sincronizados la lista y los códigos sin necesidad de un desarrollador. Los casos típicos son un código por SKU de producto para el envase, un código por mesa o habitación, o un código por comercial o local para la misma campaña.

Si necesitas los códigos dentro de tu propia aplicación, llama a la API desde tu servidor. La guía de la API REST lo explica.

Qué necesitas

• Un plan Business de QR Maker y un token de API. Crea el token en Ajustes, Tokens de API. Empieza por qrs_ y se muestra una sola vez.
• Una hoja de Google con encabezados en la fila 1 y estas columnas: A external_id, B target_url, C name (opcional), D short_link (déjala vacía), E status (déjala vacía).

El external_id es tu propia referencia para la fila: un SKU, un número de mesa, un código de comercial. Debe ser único en tu cuenta y puede contener letras, dígitos, puntos, guiones bajos, dos puntos y guiones.

Paso 1: añade el script

Abre la hoja, elige Extensiones (Extensions) y luego Apps Script, borra el código de ejemplo y pega el contenido de google-sheets.gs. Guarda el proyecto.

Paso 2: guarda el token de forma segura

En el editor de Apps Script abre Configuración del proyecto (Project Settings), baja hasta Propiedades de la secuencia de comandos (Script properties) y añade una propiedad llamada QR_TOKEN con tu token como valor.

No pegues el token en una celda. Cualquiera que pueda abrir la hoja puede leer sus celdas, y quien tenga el token puede crear, modificar y eliminar códigos en tu cuenta. Las propiedades del script solo las ven quienes pueden editar el script.

Paso 3: ejecútalo

Recarga la hoja. Aparece un nuevo menú QR Maker. Elige «Create codes for new rows» (crear códigos para las filas nuevas). La primera vez, Google te pedirá que autorices al script a editar la hoja y a llamar a un servicio externo.

Para cada fila que tenga un identificador y un enlace pero aún no tenga enlace corto, el script crea un código dinámico y rellena la columna D. La columna E muestra created, o already existed si ya se había creado un código con ese identificador, o un código de error si la fila fue rechazada: INVALID_TARGET_URL para un enlace que no es una dirección http o https válida, o un código que empieza por URL_BLOCKED_ cuando los controles de seguridad rechazan el destino, por ejemplo un enlace a otro acortador de URL.

Paso 4: obtén las imágenes

El enlace corto de la columna D es lo que debe codificar el código impreso. Para la imagen en sí tienes dos opciones:

• Descargar cada código como SVG desde tu panel de QR Maker, donde además puedes aplicar tus colores y tu logotipo.
• Obtenerlo de la API con GET /v1/qrcodes/by-external-id/{external_id}?include=svg, que devuelve el código con el texto SVG en data.svg. El ejemplo en Python guarda un SVG por fila y es la vía más rápida para cientos de códigos.

Cambiar un destino más adelante

Editar la columna B y volver a ejecutar el script no mueve un código existente. Es deliberado: un POST con un identificador conocido y un enlace distinto devuelve un conflicto en lugar de redirigir en silencio un código que quizá ya esté impreso. Cambia el destino en el panel, o llama a PATCH /v1/qrcodes/by-external-id/{external_id} con el nuevo target_url.

Límites que conviene tener en cuenta

Cada ejecución envía hasta 100 filas por petición, y cada fila correcta cuenta como una llamada de las 50.000 mensuales incluidas en el plan Business. Las filas que fallan no cuentan. Apps Script se detiene tras unos seis minutos por ejecución, suficiente para varios miles de filas; si son más, ejecútalo de nuevo y seguirá donde se quedó.

Preguntas frecuentes

¿Necesito un servidor para esto?

No. Apps Script se ejecuta en los servidores de Google, así que el token nunca llega a un navegador. Por eso también funciona aunque la API no acepte llamadas desde páginas web.

¿Pueden ver mi token los compañeros con acceso de solo lectura?

No. Las propiedades del script solo son visibles para quienes pueden editar el proyecto de script. Los lectores y comentaristas no pueden abrirlas.

¿Y si borro una fila?

No le pasa nada al código. Borrar una fila solo la quita de la hoja. Desactiva o elimina el código en el panel, o con la API, si debe dejar de funcionar.