# Yhdistä nimet ja sähköpostiosoitteet kenttiin GenderAPI:n Airtable-laajennuksella

> Määritä Airtable-laajennus, yhdistä sukupuoli ja sitä täydentävät kentät, säilytä olemassa olevat arvot ja tarkista ratkaisemattomat tietueet. Tutustu laajennuksen omaan V1-yhteyteen ja erillisiin V2-vaihtoehtoihin.

Canonical HTML: https://www.genderapi.io/fi/blog/how-to-determine-gender-from-airtable-data

Last reviewed: 2026-09-30

## Käytä laajennusta Airtable-kenttien yhdistämiseen

GenderAPI-laajennus lukee nimen tai sähköpostiosoitteen valitsemastasi kentästä ja kirjoittaa ennustetun sukupuolisignaalin erilliseen kohdekenttään. Voit yhdistää myös maan, probability-arvon ja löydetyn nimen sekä ohittaa tietueet, joiden sukupuolen kohdekentässä on jo arvo.

Laajennuksen lähdekoodi, joka tarkistettiin 27. syyskuuta 2026, käyttää V1:n vanhoja endpointeja nimille ja sähköpostiosoitteille sekä niiden ylätason vastauskenttiä. Tämä opas kuvaa laajennuksen omaa työnkulkua. Asennettu laajennus voi muuttua tästä oppaasta riippumatta, joten tarkista sen käytettävissä olevat asetukset ennen kuin yhdistät kentät alla kuvatulla tavalla.

- [GenderAPI.io Airtable Marketplacessa](https://airtable.com/marketplace/blkqCasjQIqmmBrmb/gender-api-io-determine-gender)
- [V1:n vastauskenttien viiteopas](https://www.genderapi.io/fi/api-documentation/v1)

## Yhdistä tietokanta ja valmistele sarakkeet

- Avaa haluamasi Airtable-tietokanta (base), lisää GenderAPI.io kohdasta Extensions ja käynnistä laajennus. Suorita laajennuksen näyttämät yhdistämisvaiheet.
- Valitse API-avain, jonka krediittejä toiminto käyttää. Tarkista avaimen jäljellä oleva saldo ja varmista, että avain kuuluu oikeaan GenderAPI-tiliin.
- Valitse taulukko ja lähdekenttä, jossa on nimiä tai sähköpostiosoitteita. Jätä alkuperäinen syöte tähän kenttään ja luo tuloksille erilliset kentät.
- Valitse pakollinen sukupuolen kohdekenttä ja haluamasi valinnaiset lisäkentät. Käytä prosenttikenttää muotoiltuja prosenttiarvoja varten tai numerokenttää, jos haluat säilyttää probability-arvon alkuperäisen asteikon.
- Päätä, haluatko säilyttää jo täytetyt sukupuolen kohdekentät. Kun otat ohituksen käyttöön, myös aiempien ajojen ratkaisemattomat tekstiarvot säilyvät, joten tyhjennä vain ne tulokset, jotka haluat tarkoituksella käsitellä uudelleen.

## Yhdistä laajennuksen syötteet ja tulosteet

| Laajennuksen asetus | Pakollinen | Arvo ja toiminta |
| --- | --- | --- |
| Krediittien API-avain | Kyllä | Käsitellyt pyynnöt käyttävät valitun GenderAPI-tilin avaimen krediittejä. |
| Taulukko ja lähdekenttä | Kyllä | Lähdesolussa on nimi tai sähköpostiosoite. Tyhjät lähdesolut ohitetaan. |
| Sukupuolen kohdekenttä | Kyllä | Saa arvon laajennuksen käyttämän API:n kentästä gender. Pidä ratkaisematon arvo erillään arvoista male ja female. |
| Maan kohdekenttä | Ei | Saa palautetun maa-arvon. Kyseessä on tulossarake, ei pyynnön maasuodatin. |
| Kohdekenttä probability-arvolle | Ei | Saa vanhan API:n arvon probability. Prosenttikenttä saa arvon jaettuna 100:lla; numerokenttä säilyttää alkuperäisen asteikon. |
| Kohdekenttä Found Name | Ei | Saa laajennuksen käyttämän API:n palauttaman nimen, jos se on saatavilla. Pidä tämä päätelty ehdokas erillään lähdearvosta. |
| Ohita täytetyt sukupuolikentät | Ei | Säilyttää tietueet, joiden kohdekentässä on jo arvo, myös ratkaisemattoman tekstin. Tarkista valinnan tila ennen jokaista ajoa. |

Lähdekentässä voi olla sekaisin nimiä ja sähköpostiosoitteita. Tarkastellussa toteutuksessa @-merkin sisältävä arvo käsitellään sähköpostiosoitteena; tämä ohjaussääntö ei varmista, että postilaatikko on olemassa.

## Kokeile pientä ajoa ennen koko taulukon käsittelyä

Aloita pienellä testitaulukolla, jossa on nimi, sähköpostiosoite, tyhjä solu ja monitulkintainen syöte. Varmista valitut kohdekentät ja se, miten Airtable näyttää probability-asteikon, ennen kuin käsittelet päätaulukon.

Tarkistetussa laajennuksen koodissa ratkaisemattomien tulosten oletusarvot voivat näkyä tekstinä null ja probability-arvona 0. Nämä oletusarvot voivat jäädä voimaan myös joidenkin laajennuksen käyttämän API:n epäonnistuneiden vastausten jälkeen, kun taas yhteysvirhe voi jättää tietueen ennalleen. Tarkista ajon tila ja rivit, joita se koski; pelkkä teksti null ei todista, että haku onnistui.

Tarkista olemassa olevat arvot ajon jälkeen. Jätä ratkaisemattomat tulokset tarkistettaviksi äläkä määritä sukupuolta itse. Nimeen perustuvat ennusteet eivät vahvista henkilön sukupuoli-identiteettiä, eikä palautettu maa todista asuinpaikkaa.

| Mitä näet | Mitä teet |
| --- | --- |
| Odotettu tulos oikeissa sarakkeissa | Säilytä alkuperäinen syöte ja mahdolliset lisäkentät, jotta kenttien yhdistäminen voidaan tarkistaa myöhemminkin. |
| Teksti null tai probability-arvo 0 | Jätä tulos ratkaisemattomaksi ja tarkista toiminnon tila ennen kuin päätät, onko uusi haku aiheellinen. |
| Aiemmin täytetty kohdekenttä ei muuttunut | Tarkista ohitusasetus; arvo on voitu säilyttää tarkoituksella. |
| Avainta tai krediittejä koskeva ilmoitus tai muuttumaton tulos virheen jälkeen | Korjaa tiliin tai yhteyteen liittyvä ongelma ja selvitä, mitä tietueita se koski, ennen kuin käynnistät ajon uudelleen. |

## Pidä krediitit ja uudet ajot hallinnassa

Laajennus hakee arvot yksi kerrallaan valitulla GenderAPI-avaimella. Jos samat ohittamattomat tietueet ajetaan uudelleen, laajennus voi lähettää uusia pyyntöjä ja käyttää krediittejä uudelleen. Airtablen oma paketti ja laajennuksen saatavuus ovat erillään tilin saldosta.

Laajennuksen tuloste ei tuo näkyviin V2-vastauksen osia data/meta, erikseen valittavaa tekoälytilaa, kohdekohtaista usage-objektia eikä V2:n eräpyyntöä koskevaa määrittelyä. Käytä tässä työnkulussa V1:n viiteopasta ja alla olevaa erillistä API-vaihtoehtoa, kun tarvitset näitä ominaisuuksia.

Laajennus lähettää yhdistetyt arvot käsiteltäviksi ja kirjoittaa tulokset takaisin tietokantaasi. Tutustu julkaistuun tietosuojakäytäntöön ja laajennuksen käyttöoikeuksiin niiden tietueiden osalta, joita aiot käsitellä, äläkä ota lähdekenttien yhdistämiseen mukaan asiaan kuulumattomia kenttiä.

- [Hinnat](https://www.genderapi.io/fi/price)
- [Tietosuojakäytäntö](https://www.genderapi.io/fi/privacy-policy)

## Valitse API, kun tarvitset ohjelmallisen vastauksen

Omassa integraatiossa GenderAPI V2 hyväksyy nimiä, sähköpostiosoitteita ja käyttäjänimiä ja palauttaa erilliset kentät tulokselle, luottamusarvolle, lähteelle ja krediittien käytölle. Määritä tämä yhteys erikseen: V2-oppaan lukeminen ei muuta asennettua sovellusta tai sen tulossarakkeita.

Python- ja Node.js-esimerkit kattavat yksittäiset pyynnöt, eräpyynnöt, tuntemattomat tulokset ja toimintavirheet. Aloita todennusoppaasta ja valitse tekoälytila ennen kuin lähetät veloitettavan pyynnön.

- [V2:n todennus](https://www.genderapi.io/fi/docs/v2/authentication)
- [V2:n vastauskentät](https://www.genderapi.io/fi/docs/v2/responses)
- [Python-integraation esimerkki](https://www.genderapi.io/fi/integrations/python)
- [Node.js-integraation esimerkki](https://www.genderapi.io/fi/integrations/javascript)

## Käyttääkö Airtable-laajennus GenderAPI V2:ta?

Laajennuksen lähdekoodi, joka tarkistettiin 27. syyskuuta 2026, käyttää V1:n vanhoja endpointeja nimille ja sähköpostiosoitteille. Erikseen rakennetussa omassa V2-yhteydessä on eri pyyntö- ja vastauskentät, eikä se päivitä asennettua laajennusta.

## Voiko yhdessä lähdekentässä olla sekä nimiä että sähköpostiosoitteita?

Kyllä. Tarkasteltu laajennus ohjaa @-merkin sisältävät ei-tyhjät arvot sähköpostihakuun ja muut arvot nimihakuun. Kyse on syötteen ohjaamisesta, ei postilaatikon tarkistamisesta.

## Miksi probability-arvo näyttää prosenttikentässä erilaiselta?

Laajennus jakaa vanhan API:n probability-arvon 100:lla Airtablen prosenttikenttää varten, jotta Airtable voi näyttää sen prosentteina. Numeerinen kohdekenttä säilyttää alkuperäisen asteikon; kyse ei ole V2:n kentästä confidence.

## Säilyttääkö ohitusasetus ratkaisemattomat tulokset?

Kyllä, jos kohdekentässä on jo arvo. Tämä koskee myös aiemman ajon tekstiä null. Tarkista nämä tietueet ja tyhjennä vain ne arvot, jotka haluat tarkoituksella käsitellä uudelleen.

## Lähteet ja dokumentaatio

- [Virallinen sivu: Airtable](https://airtable.com/marketplace/blkqCasjQIqmmBrmb/gender-api-io-determine-gender)
- [GenderAPI V1 -dokumentaatio](https://www.genderapi.io/fi/api-documentation/v1)
- [Erillinen API V2 -dokumentaatio](https://www.genderapi.io/fi/api-documentation)