Tilknyt felter med Airtable-udvidelsen
GenderAPI-udvidelsen læser et navn eller en e-mailadresse fra et felt, du vælger, og skriver kønsforudsigelsen i et separat destinationsfelt. Du kan også tilknytte land, probability og fundet navn og springe poster over, hvor destinationsfeltet for køn allerede har en værdi.
Udvidelsens kode, gennemgået den 27. september 2026, bruger V1-endpoints til navne og e-mailadresser og deres tilhørende svarfelter på øverste niveau. Denne guide beskriver det native workflow. Den installerede udvidelse kan ændre sig uafhængigt af guiden, så kontrollér de tilgængelige indstillinger, før du anvender tilknytningerne nedenfor.
Forbind basen, og forbered felterne
- Åbn den rigtige base, tilføj GenderAPI.io under Extensions, og start udvidelsen. Gennemfør de forbindelsestrin, som udvidelsen viser.
- Vælg den nøgle, hvis kreditter skal bruges. Kontrollér den resterende saldo, og at nøglen hører til den rigtige GenderAPI-konto.
- Vælg tabellen og kildefeltet med navne eller e-mailadresser. Behold det oprindelige input i feltet, og opret separate felter til resultaterne.
- Vælg det obligatoriske destinationsfelt for køn og eventuelle ekstra destinationer. Brug et percent-felt til en formateret procentværdi eller et talfelt for at bevare den oprindelige probability-skala.
- Beslut, om allerede udfyldte destinationsfelter for køn skal bevares. Indstillingen, der springer dem over, bevarer også uafklarede tekstværdier fra en tidligere kørsel. Ryd derfor kun de resultater, du bevidst vil behandle igen.
Tilknyt udvidelsens input og output
Kildefeltet kan indeholde både navne og e-mailadresser. I den gennemgåede implementering følger en værdi med @ e-mailruten. Denne routingregel kontrollerer ikke, om postkassen findes.
| Indstilling i udvidelsen | Obligatorisk | Værdi og adfærd |
|---|---|---|
| Kreditnøgle | Ja | Nøglen til den valgte GenderAPI-konto leverer kreditterne til de behandlede forespørgsler. |
| Tabel og kildefelt | Ja | Kildecellen indeholder et navn eller en e-mailadresse. Tomme kildeceller springes over. |
| Destinationsfelt for køn | Ja | Modtager det native felt gender. Hold en uafklaret værdi adskilt fra male og female. |
| Destinationsfelt for land | Nej | Modtager den returnerede country-værdi. Det er en outputkolonne, ikke et landefilter for forespørgslen. |
| Destinationsfelt for probability | Nej | Modtager probability-værdien fra det ældre API. Et percent-felt får værdien divideret med 100, mens et talfelt bevarer den oprindelige skala. |
| Destinationsfelt for Found Name | Nej | Modtager det navn, som det native API returnerer, når det er tilgængeligt. Hold denne udledte kandidat adskilt fra kildeværdien. |
| Spring udfyldte kønsfelter over | Nej | Bevarer poster, hvor destinationsfeltet allerede har en værdi, herunder uafklaret tekst. Kontrollér indstillingen før hver kørsel. |
Test en lille batch, før du behandler tabellen
Start med en lille testtabel med et navn, en e-mailadresse, en tom celle og et tvetydigt input. Kontrollér de valgte destinationsfelter, og hvordan Airtable viser probability-skalaen, før du behandler hovedtabellen.
I den gennemgåede kode kan uafklarede standardværdier vises som teksten null og probability 0. Nogle mislykkede native svar kan også efterlade disse standardværdier, mens en forbindelsesfejl kan efterlade en post uændret. Kontrollér kørslens status og de berørte rækker: teksten null alene beviser ikke, at opslaget lykkedes.
Kontrollér de eksisterende værdier efter kørslen. Bevar uafklarede resultater til gennemgang i stedet for selv at tildele et køn. En navnebaseret forudsigelse bekræfter ikke en persons kønsidentitet, og et returneret land beviser ikke, hvor nogen bor.
| Det ser du | Det gør du |
|---|---|
| Forventet resultat i de tilsigtede kolonner | Behold det oprindelige input og eventuelle ekstra felter, så tilknytningen kan efterprøves. |
| Teksten null eller probability 0 | Lad sagen stå uafklaret, og kontrollér behandlingens status, før du beslutter et nyt opslag. |
| Et allerede udfyldt destinationsfelt er uændret | Kontrollér indstillingen for at springe over. Bevarelsen kan være tilsigtet. |
| Meddelelse om nøgle eller kreditter, eller uændret resultat efter en fejl | Løs problemet med kontoen eller forbindelsen, og find de berørte poster, før du starter igen. |
Hold styr på kreditforbrug og nye kørsler
Den native udvidelse slår værdierne op én ad gangen med den valgte GenderAPI-nøgle. En ny kørsel på de samme poster, der ikke springes over, kan sende nye forespørgsler og bruge kreditter igen. Airtables abonnement og udvidelsens tilgængelighed er adskilt fra denne kontosaldo.
Det native output viser hverken V2-svarets data/meta, et eksplicit valg af AI-tilstand, et usage-objekt pr. element eller V2's batchkontrakt. Brug V1-dokumentationen til dette workflow og det separate API-alternativ nedenfor, når du har brug for disse indstillinger.
Udvidelsen sender de tilknyttede værdier til behandling og skriver resultaterne tilbage i din base. Gennemgå den offentliggjorte politik for databehandling og udvidelsens tilladelser for de berørte poster, og tag ikke irrelevante felter med i kildetilknytningen.
Brug V2, når du har brug for et struktureret svar
Til en tilpasset integration accepterer GenderAPI V2 navne, e-mailadresser og brugernavne og returnerer eksplicitte felter for resultat, konfidens, kilde og forbrug. Konfigurér den forbindelse separat: at læse V2-guiden ændrer hverken den installerede app eller dens outputkolonner.
Eksemplerne i Python og Node.js dækker enkeltforespørgsler, batches, unknown-resultater og driftsfejl. Start med guiden til godkendelse, og vælg AI-tilstand, før du sender en forespørgsel, der opkræves.
Ofte stillede spørgsmål
Bruger Airtable-udvidelsen GenderAPI V2?
Udvidelsens kode, gennemgået den 27. september 2026, bruger V1-endpoints til navne og e-mailadresser. En tilpasset V2-forbindelse har andre forespørgsels- og svarfelter og opgraderer ikke den installerede udvidelse.
Kan et kildefelt indeholde både navne og e-mailadresser?
Ja. Den gennemgåede udvidelse sender ikke-tomme værdier med @ til e-mailopslaget og andre værdier til navneopslaget. Det er routing af input, ikke en kontrol af postkassen.
Hvorfor ser probability anderledes ud i et procentfelt?
Udvidelsen dividerer probability-værdien fra det ældre API med 100 for et percent-felt i Airtable, så Airtable kan vise den som procent. Et talfelt bevarer den oprindelige skala. Det er ikke V2's confidence-felt.
Bevarer indstillingen til at springe over uafklarede resultater?
Ja, når destinationsfeltet allerede har en værdi, herunder teksten null fra en tidligere kørsel. Gennemgå de poster, og ryd kun de værdier, du bevidst vil behandle igen.
Kilder og dokumentation
Guiden blev senest gennemgået den . Kontrollér installationen i platformens dokumentation, og brug den tilknyttede API-dokumentation til en separat V2-integration.