Bruk Airtable-utvidelsen til å tilordne felt
GenderAPI-utvidelsen leser et navn eller en e-postadresse fra feltet du velger, og skriver et predikert kjønnssignal til et eget målfelt. Du kan også tilordne land, probability og funnet navn, og hoppe over poster der målfeltet for kjønn allerede har en verdi.
Kildekoden til utvidelsen, gjennomgått 27. september 2026, bruker de eldre V1-endepunktene for navn og e-postadresser og svarfeltene deres på øverste nivå. Denne veiledningen beskriver den innebygde arbeidsflyten. Den installerte utvidelsen kan endre seg uavhengig av veiledningen, så sjekk hvilke innstillinger som er tilgjengelige, før du tar i bruk tilordningene nedenfor.
Koble til basen og klargjør feltene
- Åpne Airtable-basen du skal bruke, legg til GenderAPI.io fra "Extensions" og start utvidelsen. Fullfør tilkoblingstrinnene som utvidelsen viser.
- Velg API-nøkkelen med kredittene som operasjonen skal bruke. Sjekk den gjenværende saldoen, og sørg for at nøkkelen hører til riktig GenderAPI-konto.
- Velg tabellen og et kildefelt som inneholder navn eller e-postadresser. Behold den opprinnelige inndataen i feltet, og opprett egne felt for resultatene.
- Velg det obligatoriske målfeltet for kjønn og eventuelle valgfrie tilleggsfelt. Bruk et percent-felt for formaterte prosentverdier, eller et number-felt for å beholde den opprinnelige probability-skalaen.
- Bestem om målfelt for kjønn som allerede er utfylt, skal beholdes. Når du slår på alternativet for å hoppe over, beholdes også uavklarte tekstverdier fra tidligere kjøringer, så fjern bare de resultatene du bevisst vil behandle på nytt.
Tilordne inndata og utdata i utvidelsen
Kildefeltet kan inneholde både navn og e-postadresser. I den undersøkte implementeringen går en verdi som inneholder @, til e-postbehandlingen. Denne rutingregelen bekrefter ikke at postkassen finnes.
| Innstilling i utvidelsen | Obligatorisk | Verdi og virkemåte |
|---|---|---|
| API-nøkkel med kreditter | Ja | Nøkkelen til den valgte GenderAPI-kontoen står for kredittene til de behandlede forespørslene. |
| Tabell og kildefelt | Ja | Kildecellen inneholder et navn eller en e-postadresse. Tomme kildeceller hoppes over. |
| Målfelt for kjønn | Ja | Mottar det innebygde feltet gender. Hold en uavklart verdi atskilt fra male og female. |
| Målfelt for land | Nei | Mottar den returnerte verdien country. Dette er en utdatakolonne, ikke et landfilter for forespørselen. |
| Målfelt for probability | Nei | Mottar probability-verdien fra det eldre API-et. Et percent-felt får verdien delt på 100; et number-felt beholder den opprinnelige skalaen. |
| Målfelt for Found Name | Nei | Mottar navnet som det innebygde API-et returnerer, når det finnes. Hold denne utledede kandidaten atskilt fra kildeverdien. |
| Hopp over utfylte kjønnsfelt | Nei | Beholder poster der målfeltet allerede har en verdi, også uavklart tekst. Sjekk hvordan alternativet er stilt inn, før hver kjøring. |
Test en liten kjøring før du behandler hele tabellen
Start med en liten testtabell som inneholder et navn, en e-postadresse, en tom celle og en tvetydig inndata. Bekreft de valgte målfeltene og hvordan Airtable viser probability-skalaen, før du behandler hovedtabellen.
I den gjennomgåtte koden til utvidelsen kan standardverdier for uavklarte resultater vises som teksten null og probability 0. Enkelte mislykkede svar fra det innebygde API-et kan også etterlate disse standardverdiene, mens en tilkoblingsfeil kan la en post stå uendret. Gå gjennom statusen for kjøringen og de berørte radene; teksten null alene beviser ikke at oppslaget ble fullført.
Sjekk de eksisterende verdiene etter kjøringen. Behold uavklarte resultater for gjennomgang i stedet for å tildele et kjønn selv. En navnebasert prediksjon bekrefter ikke en persons kjønnsidentitet, og et returnert land er ikke bevis for bosted.
| Det du ser | Det du gjør |
|---|---|
| Forventet resultat i de tiltenkte kolonnene | Behold den opprinnelige inndataen og eventuelle tilleggsfelt, slik at tilordningen kan etterprøves senere. |
| Teksten null eller probability 0 | La resultatet stå uavklart, og sjekk statusen for operasjonen før du bestemmer om et nytt oppslag er hensiktsmessig. |
| Et målfelt som allerede var utfylt, er uendret | Sjekk innstillingen for å hoppe over; dette kan være en tilsiktet bevaring. |
| Melding om nøkkel eller kreditter, eller uendret resultat etter en feil | Løs problemet med kontoen eller tilkoblingen, og finn de berørte postene før du starter på nytt. |
Hold kontroll på kredittforbruk og nye kjøringer
Den innebygde utvidelsen slår opp verdiene én og én med den valgte GenderAPI-nøkkelen. En ny kjøring på de samme postene som ikke hoppes over, kan sende nye forespørsler og bruke kreditter på nytt. Airtables eget abonnement og tilgjengeligheten til utvidelsen er atskilt fra saldoen på kontoen.
De innebygde utdataene viser verken V2-svarets data/meta, et eksplisitt valg av KI-modus, et usage-objekt per element eller V2-kontrakten for samleforespørsler. Bruk den eldre V1-referansen for denne arbeidsflyten, og det separate API-alternativet nedenfor når du trenger disse innstillingene.
Utvidelsen sender de tilordnede verdiene til behandling og skriver resultatene tilbake til basen din. Gå gjennom den publiserte retningslinjen for databehandling og utvidelsens tillatelser for postene du skal behandle, og ta ikke med irrelevante felt i kildetilordningen.
Bruk V2 når du trenger et strukturert svar
For en egen integrasjon tar GenderAPI V2 imot navn, e-postadresser og brukernavn og returnerer eksplisitte felt for resultat, konfidens, kilde og forbruk. Konfigurer den tilkoblingen separat: Å lese V2-veiledningen endrer ikke en installert app eller kolonnene den skriver til.
Eksemplene i Python og Node.js dekker enkeltforespørsler, samleforespørsler, ukjente resultater og driftsfeil. Start med veiledningen for autentisering, og velg KI-modus før du sender en forespørsel som belastes.
Ofte stilte spørsmål
Bruker Airtable-utvidelsen GenderAPI V2?
Kildekoden til utvidelsen, gjennomgått 27. september 2026, bruker de eldre V1-endepunktene for navn og e-postadresser. En egen V2-tilkobling som bygges separat, har andre forespørsels- og svarfelt og oppgraderer ikke den installerte utvidelsen.
Kan ett kildefelt inneholde både navn og e-postadresser?
Ja. Den undersøkte utvidelsen sender verdier som ikke er tomme og inneholder @, til e-postoppslaget, og andre verdier til navneoppslaget. Dette er ruting av inndata, ikke verifisering av postkassen.
Hvorfor ser probability annerledes ut i et percent-felt?
Utvidelsen deler probability-verdien fra det eldre API-et på 100 for et percent-felt i Airtable, slik at Airtable kan vise verdien som prosent. Et målfelt av typen number beholder den opprinnelige skalaen; dette er ikke confidence-feltet i V2.
Beholder alternativet for å hoppe over uavklarte resultater?
Ja, når målfeltet allerede har en verdi. Det gjelder også teksten null fra en tidligere kjøring. Gå gjennom disse postene, og fjern bare verdiene du bevisst vil behandle på nytt.
Kilder og dokumentasjon
Veiledningen ble sist gjennomgått . Kontroller installasjonen i dokumentasjonen til plattformen, og bruk API-dokumentasjonen nedenfor for en separat V2-integrasjon.