# Sukupuolen selvittäminen Excel- ja CSV-tiedostoista GenderAPI:lla

> Lataa laskentataulukko palveluun, tarkista ehdotetut sarakkeet, valitse nimien, sähköpostiosoitteiden tai käyttäjänimien analyysi ja vie tulokset CSV-muodossa. Tarkista tuetut muodot, tietojen käsittely ja ajon rajoitukset.

Canonical HTML: https://www.genderapi.io/fi/blog/determining-gender-of-names-in-excel-csv-with-gender-api

Last reviewed: 2026-09-30

## Suorita tiedostoajo hallintapaneelista

GenderAPI:n tiedostotyökalu lukee laskentataulukon, antaa sinun yhdistää nimi-, sähköposti- tai käyttäjänimisarakkeen ja valmistelee täydennetyn CSV-tulosteen. Käytä sitä tiedostopohjaiseen ajoon, kun sinun ei tarvitse rakentaa API-integraatiota.

Hallintapaneelin tiedostotyönkulku on erillinen REST V2:n eräpyynnöistä. Tiedosto itsessään ei ole V2:n JSON-pyyntö, eikä V2:n kohdekohtaisia rajoituksia tai vastauspolkuja pidä soveltaa tähän työkalun omaan ajoon.

- [Avaa Excel/CSV-työkalu](https://app.genderapi.io/csv)

## Käytä muotoa, jonka latauskenttä hyväksyy

Nykyinen latauskenttä valitsee yhden tiedoston kerrallaan. Jos työkirjassa on useita taulukoita, valitse tarkoitettu taulukko ja tarkista jäsennetyt arvot. Jos latauskenttä ei hyväksy tiedostosi muotoa, vie tiedosto ennen aloittamista johonkin luetelluista muodoista.

Käsittelyyn vaikuttavat tiedoston monimutkaisuus, rivimäärä, valittu menetelmä, tilin krediitit ja palvelun kuormitus. Testaa edustavalla tiedostolla; tämä opas ei lupaa kiinteää enimmäiskokoa eikä kiinteää valmistumisaikaa.

| Muoto | Hyväksytty tiedostopääte |
| --- | --- |
| CSV | `.csv` |
| Excel | `.xls, .xlsx` |
| Apple Numbers | `.numbers` |
| OpenDocument | `.ods` |
| Sarkaimin erotetut arvot | `.tsv` |
| Teksti | `.txt` |

## Tarkista ehdotukset ennen ajon aloittamista

- Valmistele kopio, jossa on ajon tarvitsemat tiedot. Pidä syötteet selvästi nimetyssä sarakkeessa ja mahdolliset luotettavat kaksikirjaimiset maakoodit omassa sarakkeessaan.
- Kirjaudu sisään, avaa Excel/CSV-työkalu, valitse tarkoitettu avain ja valitse sitten tiedosto ja taulukko.
- Taulukon määrityksen aikana työkalu voi lähettää esimerkkisolujen tietoja tekoälyavusteisia sarake-ehdotuksia varten. Tarkista ehdotettu syötetyyppi ja sarakkeet itse ennen kuin jatkat.
- Valitse nimien, sähköpostiosoitteiden tai käyttäjänimien analyysi, vahvista lähdesarake ja valinnainen maan yhdistäminen ja tarkista työkalun näyttämät nykyiset tekoäly- ja vientiasetukset.
- Käynnistä käsittely ja seuraa edistymistä. Älä lähetä samaa tiedostoa uudelleen vain siksi, että ajo ei ole vielä valmis.
- Kun vienti on valmis, lataa CSV-tiedosto, tarkista, että rivit vastaavat alkuperäistä, ja käy läpi tietueet, joilla on tulos identified, sekä tuntemattomat ja epäonnistuneet tietueet. Säilytä lähdetiedosto vertailua varten.

## Tarkista tiedostoajon asetukset

| Asetus | Tyyppi | Kuvaus |
| --- | --- | --- |
| API-avain | Tilin tunnistetieto | Tili, jonka saldoa valittu ajo käyttää. |
| Tiedosto ja taulukko | Tiedoston valinta | Valitse yksi hyväksytty tiedosto ja tarkoitettu taulukko. |
| Menetelmä | Valinta | name, email tai username. Tarkista automaattisesti ehdotetut arvot. |
| Lähdesarake | Sarakkeen yhdistäminen | Syöte, joka analysoidaan jokaisella rivillä; tarkista otsikko ja esimerkkiarvot. |
| Maakonteksti | Valinnainen sarake tai asetus | Käytä tunnettuja kaksikirjaimisia maakoodeja, kun se on tarpeen. |
| Tekoäly- ja vientiasetukset | Työkalun nykyiset ohjaimet | Tarkista näytetyt asetukset ennen käsittelyä; ne eivät vastaa V2:n parametria ai_mode. |

## Näin luet tulossarakkeet

Viety CSV-tiedosto lisää työkalun omat tuloskentät gender, country, probability ja found_name. Varmista ennen tuontia toiseen järjestelmään, että rivit vastaavat alkuperäistä, ja tarkista sarakeotsikot. Tulosteen muoto on CSV myös silloin, kun syötteenä oli Excel-työkirja.

Ennusteet ovat päättelyyn perustuvia yhteyksiä. Pidä ne erillään henkilön itse ilmoittamasta sukupuolesta ja vahvistetuista maatiedoista.

- Tarkastele tavallista tulosta, monitulkintaista syötettä ja epäonnistunutta toimintoa ennen kuin käsittelet koko tietoaineiston.
- Tyhjä solu, teksti null ja kaavavirhe ovat laskentataulukossa eri arvoja. Yhtenäistä tuntemattomat tulokset (unknown) harkitusti äläkä piilota virheitä.
- Käytä neutraalia oletusvaihtoehtoa tuntemattomille tai epävarmoille tietueille. Pidä henkilön itse antamat profiilitiedot erillään päätellyistä sarakkeista.

| Tulos | Tyypillinen tyyppi | Näin käytät sitä |
| --- | --- | --- |
| Gender | Teksti tai ratkaisematon arvo | Pidä arvo male tai female vain onnistuneissa tuloksissa. Säilytä ratkaisematon arvo arvona unknown ja tarkista virhetekstit erikseen. |
| Probability | Luku, jos saatavilla | Vanha luottamussignaali. Se ei ole V2:n kenttä confidence eikä tietoaineistollesi mitattu tarkkuus. |
| Country | Teksti, jos saatavilla | Haun palauttama konteksti. Pidä se erillään asiakkaan vahvistetusta maasta. |
| Found / normalized name | Teksti, jos saatavilla | Käsittelyssä käytetty tai poimittu nimi. Tarkista se, kun sähköpostiosoite tai käyttäjänimi on monitulkintainen. |

- [Näin tulkitset luottamusarvon ja rajoitukset](https://www.genderapi.io/fi/accuracy-methodology)

## Suunnittele krediitit, rajoitukset ja uudet ajot

Rekisteröity maksuton GenderAPI-tili saa 200 krediittiä joka päivä. Krediitit ovat tilin saldoa, eivätkä ne lupaa 200 onnistunutta tulosta jokaisessa työnkulussa. Tarkista valitun avaimen saldo ja työkalun nykyiset käsittelyvaihtoehdot ennen aloittamista.

Natiiveilla lisäosilla ja tiedostotehtävillä on omat käsittelytapansa. REST API V2:n eräpyynnön enimmäiskoko, tekoälyasetukset ja pyyntökohtaiset laskutuskentät eivät automaattisesti koske niitä. Uusi ajo tai uudelleenlaskenta voi lähettää tiedot käsiteltäviksi uudelleen, joten älä oleta sen olevan maksuton.

Aloita pienellä otoksella, säilytä valmiit tulokset ja käy epäonnistuneet rivit läpi ennen uutta ajoa. Jos sinun tarvitsee vain korjata myöhempi vienti tai kohdesovelluksen päivitys, käytä uudelleen jo saamiasi tuloksia.

- [Tilipaketit ja krediitit](https://www.genderapi.io/fi/price)

## Huomioi määrityksen aikainen analyysi ja tiedostojen säilytys

Taulukon valitseminen voi lähettää esimerkkisoluja tekoälyavusteista sarakkeiden yhdistämistä varten jo ennen viimeistä käsittelyvaihetta. Älä oleta, että kaikki tiedot pysyvät paikallisina, ennen kuin painat Start. Poista tarpeettomat sarakkeet ja lue tietosuojakäytäntö ennen kuin valitset henkilötietoja sisältävän tiedoston.

Käytä viennin jälkeen saatavilla olevaa poistotoimintoa, kun työtilan kopiota ei enää tarvita. Julkaistu käytäntö kuvaa ajoitetun poiston aktiivisista järjestelmistä ja säilytyksen varmuuskopioissa; poistoaikataulu ei ole todiste siitä, että kaikki kopiot on jo poistettu.

- [Tiedostojen ja hakujen säilytyskäytäntö](https://www.genderapi.io/fi/privacy-policy)

## Milloin käyttää API V2:ta suoraan

Käytä erillistä HTTP-integraatiota, kun sovelluksesi tarvitsee V2:n tekoälyasetuksia erikseen määritettyinä sekä kohdekohtaiset tiedot status, source, confidence_kind ja usage. Noudata V2:n pyyntö- ja vastausmäärittelyä. V2:n kenttänimien lisääminen natiiviin kaavaan tai nykyiseen lisäosaan ei muuta kyseisen asiakasohjelman toimintaa.

- [API V2:n pyyntöparametrit](https://www.genderapi.io/fi/docs/v2/request-parameters)
- [API V2:n JSON-vastaukset ja luottamusarvot](https://www.genderapi.io/fi/docs/v2/responses)
- [V2-integraatio Pythonilla](https://www.genderapi.io/fi/integrations/python)
- [V2-integraatio Node.js:llä](https://www.genderapi.io/fi/integrations/javascript)

## Hyväksyykö lataus XLSM-tiedostoja?

Nykyinen latauskenttä luettelee muodot CSV, XLS, XLSX, Numbers, ODS, TSV ja TXT. Vie XLSM-työkirja johonkin näistä muodoista ja tarkista tuloksena saadut arvot ennen lataamista.

## Ovatko sarake-ehdotukset aina oikein?

Eivät. Tarkista ehdotettu syötetyyppi, otsikkorivin käsittely, lähdesarake ja maan yhdistäminen. Määrityksen aikana esimerkkitietoja voidaan lähettää tekoälyavusteisia ehdotuksia varten.

## Saanko alkuperäisen Excel-työkirjan takaisin?

Dokumentoitu tiedostoajo vie tulokset CSV-muodossa. Tarkista viedyt sarakkeet ja rivien vastaavuus alkuperäiseen ennen kuin tuot ne alkuperäiseen työkirjaan tai muuhun työkaluun.

## Onko tämä sama kuin V2:n eräpyyntö?

Ei. Kyse on hallintapaneelin tiedostoajosta, jolla on omat asetuksensa ja oma käsittelynsä. Käytä V2:n eräpyyntöjä koskevaa dokumentaatiota, kun rakennat JSON-pyyntöjä omassa integraatiossasi.

## Lähteet ja dokumentaatio

- [Lisäosan virallinen sivu Microsoft AppSourcessa](https://app.genderapi.io/csv)
- [V2:n eräpyyntöjen dokumentaatio](https://www.genderapi.io/fi/docs/v2/batch)
- [GenderAPI-tilin hinnat ja krediitit](https://www.genderapi.io/fi/price)
- [GenderAPI:n tietosuojakäytäntö](https://www.genderapi.io/fi/privacy-policy)
- [V2-pyynnön määrittely](https://www.genderapi.io/fi/docs/v2/request-parameters)