Felder mit der Airtable-Erweiterung zuordnen
Die GenderAPI-Erweiterung liest einen Namen oder eine E-Mail-Adresse aus einem ausgewählten Feld und schreibt die Geschlechtsvorhersage in ein separates Zielfeld. Sie können außerdem Land, Wahrscheinlichkeit und gefundenen Namen zuordnen und Einträge überspringen, deren Geschlechts-Zielfeld bereits einen Wert enthält.
Der am 27. September 2026 geprüfte Code der Erweiterung verwendet die V1-Endpunkte für Namen und E-Mail-Adressen sowie deren Antwortfelder auf oberster Ebene. Dieser Leitfaden beschreibt diesen nativen Workflow. Die installierte Erweiterung kann sich unabhängig davon ändern: Prüfen Sie die verfügbaren Einstellungen, bevor Sie die folgenden Zuordnungen übernehmen.
Base verbinden und Felder vorbereiten
- Öffnen Sie die richtige Base, fügen Sie GenderAPI.io über Extensions hinzu und starten Sie die Erweiterung. Folgen Sie den Verbindungsschritten, die die Erweiterung anzeigt.
- Wählen Sie den Schlüssel, von dem die Credits abgebucht werden sollen. Prüfen Sie sein verbleibendes Guthaben und das zugehörige GenderAPI-Konto.
- Wählen Sie die Tabelle und das Quellfeld mit den Namen oder E-Mail-Adressen. Behalten Sie die ursprünglichen Eingaben in diesem Feld bei und legen Sie separate Felder für die Ergebnisse an.
- Wählen Sie das erforderliche Geschlechts-Zielfeld und nützliche zusätzliche Zielfelder. Verwenden Sie ein percent-Feld für einen formatierten Prozentwert oder ein Zahlenfeld, um die ursprüngliche Skala der Wahrscheinlichkeit beizubehalten.
- Entscheiden Sie, ob bereits ausgefüllte Geschlechts-Zielfelder erhalten bleiben sollen. Die Option zum Überspringen bewahrt auch ungeklärte Textwerte aus einem früheren Lauf. Löschen Sie daher nur die Ergebnisse, die Sie bewusst erneut verarbeiten möchten.
Ein- und Ausgaben der Erweiterung zuordnen
Das Quellfeld kann sowohl Namen als auch E-Mail-Adressen enthalten. In der geprüften Implementierung wird ein Wert mit @ an den E-Mail-Pfad geleitet; diese Weiterleitungsregel prüft nicht, ob das Postfach existiert.
| Einstellung der Erweiterung | Erforderlich | Wert und Verhalten |
|---|---|---|
| Credit-Schlüssel | Ja | Der Schlüssel des ausgewählten GenderAPI-Kontos stellt die Credits für verarbeitete Anfragen bereit. |
| Tabelle und Quellfeld | Ja | Die Quellzelle enthält einen Namen oder eine E-Mail-Adresse. Leere Quellzellen werden übersprungen. |
| Geschlechts-Zielfeld | Ja | Erhält das native Feld gender. Bewahren Sie einen ungeklärten Wert getrennt von male und female auf. |
| Länder-Zielfeld | Nein | Erhält den zurückgegebenen Wert country. Dies ist eine Ausgabespalte und kein Länderfilter für die Anfrage. |
| Wahrscheinlichkeits-Zielfeld | Nein | Erhält den Wert probability der älteren API. Ein percent-Feld erhält den durch 100 geteilten Wert; ein Zahlenfeld behält die ursprüngliche Skala bei. |
| Zielfeld Found Name | Nein | Erhält den von der nativen API zurückgegebenen Namen, sofern verfügbar. Bewahren Sie diesen abgeleiteten Kandidaten getrennt vom Quellwert auf. |
| Ausgefüllte Geschlechtsfelder überspringen | Nein | Bewahrt Einträge, deren Zielfeld bereits einen Wert enthält, einschließlich ungeklärtem Text. Prüfen Sie den Status dieser Option vor jedem Lauf. |
Einen kleinen Batch testen, bevor Sie die Tabelle verarbeiten
Beginnen Sie mit einer kleinen Testtabelle mit einem Namen, einer E-Mail-Adresse, einer leeren Zelle und einer mehrdeutigen Eingabe. Prüfen Sie die ausgewählten Zielfelder und wie Airtable die Skala der Wahrscheinlichkeit anzeigt, bevor Sie die Haupttabelle verarbeiten.
Im geprüften Code können ungeklärte Standardwerte als Text null und Wahrscheinlichkeit 0 erscheinen. Auch manche fehlgeschlagenen nativen Antworten können diese Standardwerte hinterlassen, und ein Verbindungsfehler kann einen Eintrag unverändert lassen. Prüfen Sie den Status des Laufs und die betroffenen Zeilen: Der Text null allein belegt nicht, dass die Abfrage erfolgreich war.
Kontrollieren Sie nach dem Lauf die vorhandenen Werte. Bewahren Sie ungeklärte Ergebnisse zur Prüfung auf, statt selbst ein Geschlecht zuzuweisen. Eine namensbasierte Vorhersage bestätigt nicht die Geschlechtsidentität einer Person, und ein zurückgegebenes Land belegt keinen Wohnort.
| Was Sie sehen | Was zu tun ist |
|---|---|
| Erwartetes Ergebnis in den geplanten Spalten | Behalten Sie die ursprüngliche Eingabe und die zusätzlichen Felder bei, damit die Zuordnung überprüfbar bleibt. |
| Text null oder Wahrscheinlichkeit 0 | Belassen Sie den Fall als ungeklärt und prüfen Sie den Verarbeitungsstatus, bevor Sie über eine erneute Abfrage entscheiden. |
| Ein zuvor ausgefülltes Zielfeld blieb unverändert | Prüfen Sie die Option zum Überspringen; dieses Beibehalten des Werts kann beabsichtigt sein. |
| Meldung zu Schlüssel oder Credits oder unverändertes Ergebnis nach einem Fehler | Beheben Sie das Konto- oder Verbindungsproblem und ermitteln Sie die betroffenen Einträge, bevor Sie erneut starten. |
Verbrauchte Credits und erneute Läufe kontrollieren
Die native Erweiterung fragt Werte einzeln mit dem ausgewählten GenderAPI-Schlüssel ab. Ein erneuter Lauf für dieselben nicht übersprungenen Einträge kann neue Anfragen senden und erneut Credits verbrauchen. Der Airtable-Tarif und die Verfügbarkeit von Erweiterungen sind unabhängig von diesem Kontoguthaben.
Die native Ausgabe stellt weder die data/meta-Antwort von V2 noch eine ausdrückliche Wahl des KI-Modus, ein usage-Objekt pro Eintrag oder den Batch-Vertrag von V2 bereit. Verwenden Sie für diesen Workflow die V1-Dokumentation und, wenn Sie diese Einstellungen benötigen, die unten beschriebene separate API-Option.
Die Erweiterung sendet die zugeordneten Werte zur Verarbeitung und schreibt die Ergebnisse zurück in Ihre Base. Prüfen Sie die veröffentlichte Datenverarbeitungsrichtlinie und die Berechtigungen der Erweiterung für die betreffenden Einträge; nehmen Sie keine unzusammenhängenden Felder in die Quellzuordnung auf.
V2 verwenden, wenn Sie eine strukturierte Antwort benötigen
Für eine eigene Integration akzeptiert GenderAPI V2 Namen, E-Mail-Adressen und Benutzernamen und gibt ausdrückliche Felder für Ergebnis, Konfidenz, Quelle und Verbrauch zurück. Richten Sie diese Verbindung separat ein: Das Lesen des V2-Leitfadens ändert weder die installierte App noch ihre Ausgabespalten.
Die Beispiele in Python und Node.js behandeln Einzelanfragen, Batches, unknown-Ergebnisse und Betriebsfehler. Beginnen Sie mit dem Leitfaden zur Authentifizierung und wählen Sie den KI-Modus, bevor Sie eine kostenpflichtige Anfrage senden.
Häufige Fragen
Verwendet die Airtable-Erweiterung GenderAPI V2?
Der am 27. September 2026 geprüfte Code der Erweiterung verwendet die V1-Endpunkte für Namen und E-Mail-Adressen. Eine eigene V2-Verbindung hat andere Anfrage- und Antwortfelder; sie aktualisiert die installierte Erweiterung nicht.
Kann ein Quellfeld sowohl Namen als auch E-Mail-Adressen enthalten?
Ja. Die geprüfte Erweiterung leitet nicht leere Werte mit @ an die Abfrage nach E-Mail-Adresse und alle übrigen an die Abfrage nach Namen weiter. Dies ist eine Weiterleitung der Eingabe, keine Überprüfung des Postfachs.
Warum sieht die Wahrscheinlichkeit in einem Prozentfeld anders aus?
Die Erweiterung teilt den Wert probability der älteren API für ein percent-Feld in Airtable durch 100, damit Airtable ihn als Prozentwert anzeigen kann. Ein Zahlenfeld behält die ursprüngliche Skala bei; es handelt sich nicht um das Feld confidence von V2.
Bewahrt die Option zum Überspringen ungeklärte Ergebnisse?
Ja, wenn das Zielfeld bereits einen Wert enthält, einschließlich des Texts null aus einem früheren Lauf. Prüfen Sie diese Einträge und löschen Sie nur die Werte, die Sie bewusst erneut verarbeiten möchten.
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.