Mappa fält med Airtable-tillägget
GenderAPI-tillägget läser ett namn eller en e-postadress från ett valt fält och skriver prediktionen av kön till ett separat målfält. Du kan också mappa land, sannolikhet och hittat namn samt hoppa över poster vars målfält för kön redan innehåller ett värde.
Tilläggets kod, granskad den 27 september 2026, använder V1-slutpunkterna för namn och e-postadresser och deras svarsfält på toppnivå. Den här guiden beskriver det inbyggda arbetsflödet. Det installerade tillägget kan ändras oberoende av guiden: kontrollera de tillgängliga inställningarna innan du tillämpar mappningarna nedan.
Anslut basen och förbered fälten
- Öppna rätt bas, lägg till GenderAPI.io via Extensions och starta tillägget. Följ de anslutningssteg som tillägget visar.
- Välj den nyckel vars krediter ska användas. Kontrollera dess återstående saldo och att den hör till rätt GenderAPI-konto.
- Välj tabellen och källfältet med namnen eller e-postadresserna. Behåll de ursprungliga indata i det fältet och skapa separata fält för resultaten.
- Välj det obligatoriska målfältet för kön och eventuella kompletterande målfält. Använd ett percent-fält för ett formaterat procentvärde eller ett nummerfält för att behålla sannolikhetens ursprungliga skala.
- Bestäm om redan ifyllda målfält för kön ska bevaras. Alternativet att hoppa över bevarar också olösta textvärden från en tidigare körning. Rensa därför bara de resultat som du medvetet vill bearbeta igen.
Mappa tilläggets indata och utdata
Källfältet kan innehålla både namn och e-postadresser. I den granskade implementeringen skickas ett värde som innehåller @ till e-postvägen; den här dirigeringsregeln kontrollerar inte att brevlådan finns.
| Tilläggets inställning | Obligatorisk | Värde och beteende |
|---|---|---|
| Kreditnyckel | Ja | Nyckeln för det valda GenderAPI-kontot tillhandahåller krediterna för bearbetade förfrågningar. |
| Tabell och källfält | Ja | Källcellen innehåller ett namn eller en e-postadress. Tomma källceller hoppas över. |
| Målfält för kön | Ja | Tar emot det inbyggda fältet gender. Håll ett olöst värde åtskilt från male och female. |
| Målfält för land | Nej | Tar emot det returnerade värdet country. Det är en utdatakolumn och inget landsfilter för förfrågan. |
| Målfält för sannolikhet | Nej | Tar emot värdet probability från det äldre API:et. Ett percent-fält får värdet delat med 100; ett nummerfält behåller den ursprungliga skalan. |
| Målfält Found Name | Nej | Tar emot namnet som det inbyggda API:et returnerar, när det finns. Håll den här härledda kandidaten åtskild från källvärdet. |
| Hoppa över ifyllda könsfält | Nej | Bevarar poster vars målfält redan innehåller ett värde, inklusive olöst text. Kontrollera alternativets läge före varje körning. |
Testa en liten batch innan du bearbetar tabellen
Börja med en liten testtabell med ett namn, en e-postadress, en tom cell och en tvetydig indata. Kontrollera de valda målfälten och hur Airtable visar sannolikhetens skala innan du bearbetar huvudtabellen.
I den granskade koden kan olösta standardvärden visas som texten null och sannolikheten 0. Vissa misslyckade inbyggda svar kan också lämna kvar dessa standardvärden, och ett anslutningsfel kan lämna en post oförändrad. Kontrollera körningens status och de berörda raderna: texten null ensam bevisar inte att uppslaget lyckades.
Kontrollera de befintliga värdena efter körningen. Bevara olösta resultat för granskning i stället för att själv tilldela ett kön. En namnbaserad prediktion bekräftar inte en persons könsidentitet, och ett returnerat land bevisar inte var någon bor.
| Vad du ser | Vad du ska göra |
|---|---|
| Förväntat resultat i de avsedda kolumnerna | Behåll den ursprungliga indata och de kompletterande fälten så att mappningen förblir granskningsbar. |
| Texten null eller sannolikheten 0 | Låt fallet vara olöst och kontrollera bearbetningsstatus innan du beslutar om ett nytt uppslag. |
| Ett tidigare ifyllt målfält förblev oförändrat | Kontrollera alternativet att hoppa över; att värdet behölls kan vara avsiktligt. |
| Meddelande om nyckel eller krediter, eller oförändrat resultat efter ett fel | Åtgärda konto- eller anslutningsproblemet och identifiera de berörda posterna innan du startar igen. |
Håll koll på förbrukade krediter och nya körningar
Det inbyggda tillägget slår upp värden ett i taget med den valda GenderAPI-nyckeln. En ny körning för samma poster som inte hoppas över kan skicka nya förfrågningar och förbruka krediter igen. Airtables egen plan och tilläggets tillgänglighet är skilda från detta kontosaldo.
De inbyggda utdata exponerar varken V2-svarets data/meta, ett uttryckligt val av AI-läge, ett usage-objekt per post eller V2:s batchkontrakt. Använd V1-dokumentationen för det här arbetsflödet och det separata API-alternativet nedan när du behöver de inställningarna.
Tillägget skickar de mappade värdena för bearbetning och skriver tillbaka resultaten till din bas. Granska den publicerade policyn för databehandling och tilläggets behörigheter för de aktuella posterna; ta inte med orelaterade fält i källmappningen.
Använd V2 när du behöver ett strukturerat svar
För en egen integration tar GenderAPI V2 emot namn, e-postadresser och användarnamn och returnerar uttryckliga fält för resultat, konfidens, källa och förbrukning. Konfigurera den anslutningen separat: att läsa V2-guiden ändrar varken den installerade appen eller dess utdatakolumner.
Exemplen i Python och Node.js täcker enskilda förfrågningar, batchar, unknown-resultat och driftfel. Börja med guiden om autentisering och välj AI-läge innan du skickar en debiterbar förfrågan.
Vanliga frågor
Använder Airtable-tillägget GenderAPI V2?
Tilläggets kod, granskad den 27 september 2026, använder V1-slutpunkterna för namn och e-postadresser. En egen V2-anslutning har andra fält i förfrågan och svar; den uppgraderar inte det installerade tillägget.
Kan ett källfält innehålla både namn och e-postadresser?
Ja. Det granskade tillägget skickar icke-tomma värden som innehåller @ till uppslaget för e-post och övriga värden till uppslaget för namn. Det är en dirigering av indata, inte en verifiering av brevlådan.
Varför ser sannolikheten annorlunda ut i ett procentfält?
Tillägget delar det äldre API:ets värde probability med 100 för ett percent-fält i Airtable så att Airtable kan visa det som procent. Ett nummerfält behåller den ursprungliga skalan; det är inte V2:s fält confidence.
Bevarar alternativet att hoppa över olösta resultat?
Ja, när målfältet redan innehåller ett värde, inklusive texten null från en tidigare körning. Granska de posterna och rensa bara de värden som du medvetet vill bearbeta igen.
Referensdokumentation
Guiden granskades senast . Kontrollera installationen i plattformens dokumentation och använd den länkade API-dokumentationen för en separat V2-integration.