Dynamische QR-Codes aus Google Sheets mit Apps Script erstellen

Um dynamische QR-Codes aus einer Google-Tabelle zu erstellen, setzt du pro Zeile einen Link mit deiner eigenen Referenz-ID, fügst ein kurzes Apps Script in die Tabelle ein, speicherst dein API-Token in den Skripteigenschaften und startest es über ein Menü. Das Skript schickt die Zeilen in Stapeln zu je 100 an die REST-API von QR Maker und schreibt den Kurzlink jeder Zeile zurück in die Tabelle. Ein erneuter Lauf füllt nur Zeilen aus, die noch leer sind, es entstehen also nie Duplikate.

Wann das das richtige Werkzeug ist

In einer Tabelle stehen die meisten Produktlisten, Tischpläne und Kampagnen-Tracker ohnehin schon. Pflegt jemand im Team diese Liste von Hand, hält das Erstellen der Codes aus derselben Tabelle Liste und Codes synchron, ganz ohne Entwickler. Typische Fälle sind ein Code pro Produkt-SKU für die Verpackung, ein Code pro Tisch oder Raum oder ein Code pro Vertriebsmitarbeiter oder Standort für dieselbe Kampagne.

Brauchst du die Codes in deiner eigenen Anwendung, ruf die API stattdessen von deinem Server auf. Das beschreibt die REST-API-Anleitung.

Was du brauchst

• Einen Business-Tarif bei QR Maker und ein API-Token. Erstelle das Token unter Einstellungen, API-Tokens. Es beginnt mit qrs_ und wird einmal angezeigt.
• Eine Google-Tabelle mit Kopfzeile in Zeile 1 und diesen Spalten: A external_id, B target_url, C name (optional), D short_link (leer lassen), E status (leer lassen).

Die external_id ist deine eigene Referenz für die Zeile: eine SKU, eine Tischnummer, ein Vertreterkürzel. Sie muss in deinem Konto eindeutig sein und darf Buchstaben, Ziffern, Punkte, Unterstriche, Doppelpunkte und Bindestriche enthalten.

Schritt 1: das Skript hinzufügen

Öffne die Tabelle, wähle Erweiterungen (Extensions) und dann Apps Script, lösche den Platzhaltercode und füge den Inhalt von google-sheets.gs ein. Speichere das Projekt.

Schritt 2: das Token sicher speichern

Öffne im Apps-Script-Editor die Projekteinstellungen (Project Settings), scrolle zu den Skripteigenschaften (Script properties) und füge eine Eigenschaft namens QR_TOKEN mit deinem Token als Wert hinzu.

Füge das Token nicht in eine Zelle ein. Jeder, der die Tabelle öffnen kann, kann ihre Zellen lesen, und wer das Token hat, kann in deinem Konto Codes erstellen, ändern und löschen. Skripteigenschaften sehen nur Personen, die das Skript bearbeiten können.

Schritt 3: ausführen

Lade die Tabelle neu. Ein neues Menü QR Maker erscheint. Wähle „Create codes for new rows“ (Codes für neue Zeilen erstellen). Beim ersten Mal bittet Google dich, dem Skript zu erlauben, die Tabelle zu bearbeiten und einen externen Dienst aufzurufen.

Für jede Zeile mit ID und Link, aber noch ohne Kurzlink, erstellt das Skript einen dynamischen Code und füllt Spalte D. Spalte E zeigt created, oder already existed, wenn ein Code mit dieser ID schon früher erstellt wurde, oder einen Fehlercode, wenn die Zeile abgelehnt wurde: INVALID_TARGET_URL für einen Link, der keine gültige http- oder https-Adresse ist, oder einen Code, der mit URL_BLOCKED_ beginnt, wenn die Sicherheitsprüfungen das Ziel ablehnen, etwa einen Link zu einem anderen URL-Kürzer.

Schritt 4: die Bilder holen

Der Kurzlink in Spalte D ist das, was der gedruckte Code kodieren muss. Für das Bild selbst hast du zwei Möglichkeiten:

• Lade jeden Code als SVG aus deinem QR-Maker-Dashboard herunter, wo du auch deine Farben und dein Logo anwenden kannst.
• Hol ihn über die API mit GET /v1/qrcodes/by-external-id/{external_id}?include=svg, was den Code mit dem SVG-Text in data.svg zurückgibt. Das Python-Beispiel speichert ein SVG pro Zeile und ist bei Hunderten von Codes der schnellere Weg.

Ein Ziel später ändern

Spalte B zu bearbeiten und das Skript erneut auszuführen, verschiebt keinen bestehenden Code. Das ist Absicht: Ein POST mit bekannter ID und anderem Link liefert einen Konflikt, statt einen möglicherweise schon gedruckten Code stillschweigend umzuleiten. Ändere das Ziel im Dashboard oder rufe PATCH /v1/qrcodes/by-external-id/{external_id} mit der neuen target_url auf.

Grenzen, die du kennen solltest

Jeder Lauf schickt bis zu 100 Zeilen pro Anfrage, und jede erfolgreiche Zeile zählt als ein Aufruf von den 50.000 pro Monat, die im Business-Tarif enthalten sind. Fehlgeschlagene Zeilen zählen nicht. Apps Script selbst stoppt nach etwa sechs Minuten pro Lauf, was für mehrere Tausend Zeilen reicht; bei mehr startest du es erneut, und es macht dort weiter, wo es aufgehört hat.

FAQ

Brauche ich dafür einen Server?

Nein. Apps Script läuft auf den Servern von Google, das Token erreicht also nie einen Browser. Deshalb funktioniert das auch, obwohl die API keine Aufrufe von Webseiten annimmt.

Können Kollegen mit Lesezugriff mein Token sehen?

Nein. Skripteigenschaften sind nur für Personen sichtbar, die das Skriptprojekt bearbeiten können. Betrachter und Kommentierende können sie nicht öffnen.

Was passiert, wenn ich eine Zeile lösche?

Mit dem Code passiert nichts. Eine Zeile zu löschen entfernt sie nur aus der Tabelle. Deaktiviere oder lösche den Code im Dashboard oder über die API, wenn er nicht mehr funktionieren soll.