Ausgewählte Zeilen über die Seitenleiste verarbeiten
Das Add-on GenderAPI for Google Sheets liest eine Spalte mit Namen, E-Mail-Adressen oder Benutzernamen und schreibt ausgewählte Ergebnisfelder in das Tabellenblatt. Über die Seitenleiste können Sie einen bestimmten Bereich verarbeiten und Werte speichern, ohne in jeder Zelle eine Formel zu hinterlassen.
Dies ist der native Ablauf des Add-ons. Seine Ergebnisspalten und die Batch-Verarbeitung sind unabhängig vom öffentlichen Antwortformat der REST-API V2.
Installieren, verbinden und mit einer kleinen Stichprobe testen
- Installieren Sie das Add-on über seinen Eintrag im Google Workspace Marketplace und prüfen Sie, welche Berechtigungen es anfordert. Öffnen Sie in Google Sheets Extensions → GenderAPI → Determine Gender.
- Wählen Sie einen GenderAPI-Schlüssel aus oder geben Sie ihn in der Seitenleiste ein. Prüfen Sie, ob das ausgewählte Konto über verfügbare Credits verfügt.
- Wählen Sie das Tabellenblatt und die Methode name, email oder username. Geben Sie die passende Quellspalte und einen kleinen Zeilenbereich ohne Kopfzeile an.
- Wählen Sie eine eigene Spalte für das Geschlecht und bei Bedarf Spalten für Wahrscheinlichkeit, Land und gefundenen Namen. Überschreiben Sie die ursprünglichen Werte nicht.
- Wenn Sie einen verlässlichen Länderkontext haben, verwenden Sie die Ländereinstellung oder eine Spalte mit Ländercodes. Leiten Sie diesen Kontext nicht aus der Vorhersage ab, die Sie abfragen möchten.
- Prüfen Sie die Option zum Überspringen vorhandener Ergebnisse, starten Sie die Verarbeitung und kontrollieren Sie die ausgewählten Zeilen, bevor Sie den Bereich erweitern.
Eingaben und Ziele zuordnen
| Einstellung | Typ | Auswahl und Beschreibung |
|---|---|---|
| API-Schlüssel | Kontokennung | Verwenden Sie den im Add-on ausgewählten Schlüssel; prüfen Sie seine Gültigkeit und sein Guthaben. |
| Methode | Auswahl | name, email oder username, je nach Quellspalte. |
| Tabellenblatt und Zeilenbereich | Tabellenblatt und Zeilennummern | Wählen Sie nur die zu verarbeitenden Zeilen aus und lassen Sie die Kopfzeile aus. |
| Quellspalte | Spaltenverweis | Die einzige Eingabespalte für die gewählte Methode. |
| Länderkontext | Optionale Einstellung oder Spalte | Verwenden Sie verlässliche zweistellige Ländercodes, sofern Sie welche haben. |
| Ergebnisspalten | Spaltenverweise | Das Geschlecht ist das Hauptziel; Wahrscheinlichkeit, Land und gefundener Name sind optional. |
| Vorhandene Ergebnisse überspringen | Kontrollkästchen | Prüfen Sie diese Einstellung, damit ein erneuter Lauf bereits ausgefüllte Zeilen nicht versehentlich ersetzt. |
Ergebnisspalten lesen
Bewahren Sie den ursprünglichen Wert neben dem Ergebnis auf. Eine namensbasierte Zuordnung bestimmt nicht das Geschlecht, das eine Person selbst angibt, und ein zurückgegebenes Land belegt weder ihren Wohnort noch ihre Staatsangehörigkeit.
- Prüfen Sie ein gewöhnliches Ergebnis, eine mehrdeutige Eingabe und einen fehlgeschlagenen Vorgang, bevor Sie den gesamten Datensatz verarbeiten.
- Eine leere Zelle, der Text null und ein Formelfehler sind unterschiedliche Werte. Normalisieren Sie unknown-Ergebnisse bewusst, ohne Fehler zu verbergen.
- Verwenden Sie bei unknown oder unsicheren Fällen neutrale Formulierungen und bewahren Sie Angaben der Person selbst getrennt von Vorhersagen auf.
| Ergebnis | Typ | Verwendung |
|---|---|---|
| Gender | Text oder nicht aufgelöster Wert | Behalten Sie male oder female nur bei einem erfolgreichen Ergebnis bei. Einen nicht aufgelösten Wert bewahren Sie als unknown auf; Fehlermeldungen prüfen Sie getrennt. |
| Probability | Zahl, falls verfügbar | Ein historischer Sicherheitswert; er entspricht weder dem Feld confidence aus V2 noch einer gemessenen Genauigkeit für Ihre Daten. |
| Country | Text, falls verfügbar | Von der Abfrage zurückgegebener Kontext. Bewahren Sie ihn getrennt vom verifizierten Land des Kunden auf. |
| Found / normalized name | Text, falls verfügbar | Der bei der Verarbeitung verwendete oder extrahierte Name. Prüfen Sie ihn, wenn eine E-Mail-Adresse oder ein Benutzername mehrdeutig ist. |
Credits, Limits und erneute Läufe planen
Ein registriertes kostenloses GenderAPI-Konto umfasst 200 Credits pro Tag. Das ist ein Kontoguthaben und kein Versprechen von 200 identifizierten Ergebnissen in jedem Workflow. Prüfen Sie vor dem Start das Guthaben des ausgewählten Schlüssels und die aktuellen Verarbeitungsoptionen des Tools.
Native Add-ons und die Dateiverarbeitung haben eigene Verarbeitungswege. Das Batch-Limit der REST-API V2, die KI-Optionen und die Abrechnungsfelder einzelner Anfragen gelten für sie nicht automatisch. Ein erneuter Lauf oder eine Neuberechnung kann neue Anfragen senden und Credits verbrauchen: Gehen Sie nicht davon aus, dass er kostenlos ist.
Beginnen Sie mit einer kleinen Stichprobe, bewahren Sie die erhaltenen Ergebnisse auf und prüfen Sie fehlgeschlagene Zeilen vor einem erneuten Lauf. Wenn Sie nur einen Export oder eine Aktualisierung im Ziel korrigieren müssen, verwenden Sie die bereits vorhandenen Ergebnisse erneut.
Entscheiden, welche Daten Sie weitergeben
Tabellenintegrationen übermitteln die für die Abfrage benötigten Werte und benötigen Berechtigungen für das ausgewählte Dokument. Prüfen Sie vor der Verarbeitung personenbezogener Daten, wer Zugriff auf die Arbeitsmappe hat, welches Konto verbunden ist und welche Zielspalten verwendet werden.
Bewahren Sie den API-Schlüssel in den Einstellungen des Add-ons auf, nicht in gewöhnlichen Zellen, auf Screenshots oder in geteilten Beispielen. Die veröffentlichte Datenschutzerklärung beschreibt die Verarbeitung der Eingaben, ihre Speicherung und die Protokolle; eine Tabellenintegration bedeutet nicht, dass die Daten ausschließlich auf Ihrem Gerät bleiben.
Wann Sie die V2-API direkt verwenden sollten
Richten Sie eine separate HTTP-Integration ein, wenn Ihre Anwendung ausdrückliche KI-Optionen sowie für jeden Eintrag die Angaben status, source, confidence_kind und usage aus V2 benötigt. Halten Sie sich an den Anfrage- und Antwortvertrag von V2: Wenn Sie einer nativen Formel oder einem bestehenden Add-on V2-Feldnamen hinzufügen, ändert das ihr Verhalten nicht.
Häufige Fragen
Muss ich Code schreiben, um die Seitenleiste zu nutzen?
Nein. Installieren Sie das Add-on, verbinden Sie den Schlüssel und ordnen Sie die Quellspalte sowie die Ergebnisspalten zu. Eine direkte Integration mit der V2-API ist eine separate Option für individuell entwickelte Anwendungen.
Kann ich vorhandene Zeilen verarbeiten?
Ja. Verwenden Sie die Einstellungen für Tabellenblatt und Zeilenbereich in der Seitenleiste. Prüfen Sie vor dem Start der Verarbeitung die Kopfzeile, den Eingabetyp, die Zielspalten und die Option für vorhandene Ergebnisse.
Entsprechen die Ergebnisspalten der JSON-Antwort von V2?
Nein. Die native Verarbeitung schreibt die unterstützten Felder in das Tabellenblatt. Die Objekte data und meta sowie die Felder source und confidence_kind gehören zum Vertrag der direkten REST-API V2.
Wie gehe ich mit einem unknown-Ergebnis um?
Bewahren Sie es als unknown auf und unterscheiden Sie es von einem fehlgeschlagenen Vorgang. Prüfen Sie mehrdeutige Eingaben und verwenden Sie neutrale Formulierungen, statt automatisch ein Geschlecht zuzuweisen.
Quellendokumentation
Letzte Prüfung dieser Anleitung: . Prüfen Sie die Installation in der Dokumentation der Plattform und nutzen Sie für eine separate V2-Integration die verlinkte API-Dokumentation.