Käsittele valittu rivierä hallitusti sivupaneelissa
GenderAPI:n Google Sheets -lisäosa lukee nimiä, sähköpostiosoitteita tai käyttäjänimiä sisältävän sarakkeen ja kirjoittaa valitut tuloskentät taulukkoosi. Sivupaneelista on hyötyä, kun haluat valita rivialueen ja tallentaa tulokset arvoina ilman, että jokaisen solun kaavaa pitää ylläpitää.
Tämä on lisäosan oma työnkulku. Sen nykyiset tulossarakkeet ja tehtävien käsittely ovat erillään julkisen REST API V2:n vastausmuodosta.
Asenna, yhdistä ja kokeile pienellä otoksella
- Asenna lisäosa sen omalta sivulta Google Workspace Marketplacessa ja tarkista pyydetyt käyttöoikeudet. Avaa laskentataulukossa valikko Laajennukset (Extensions) → GenderAPI → Determine Gender.
- Valitse GenderAPI:n API-avaimesi tai syötä se sivupaneeliin. Varmista, että valitulla tilillä on käytettävissä krediittejä.
- Valitse taulukko (välilehti) ja syötetapa: name, email tai username. Valitse vastaava lähdesarake ja pieni rivialue, johon otsikkorivi ei kuulu.
- Valitse sukupuolelle erillinen tulossarake ja tarvittaessa valinnaiset sarakkeet Probability-arvolle, maalle ja löydetylle nimelle. Älä kirjoita lähdearvojen päälle.
- Jos sinulla on luotettava maakonteksti, käytä saatavilla olevaa maa-asetusta tai maakoodisaraketta. Älä päättele kontekstia ennusteesta, jota olet vasta pyytämässä.
- Käy läpi olemassa olevien tulosten ohitusasetus, käynnistä tehtävä ja tarkista valitut rivit ennen kuin laajennat rivialuetta.
Yhdistä syötteet ja kohdesarakkeet
| Asetus | Tyyppi | Mitä valita |
|---|---|---|
| API-avain | Tilin tunnistetieto | Käytä lisäosassa valittua avainta ja varmista sen saldo ja voimassaolo. |
| Syötetapa | Valinta | name, email tai username lähdesarakkeen mukaan. |
| Taulukko ja rivialue | Taulukko ja rivinumerot | Valitse vain käsiteltävät rivit ja jätä otsikkorivi pois. |
| Lähdesarake | Sarakeviittaus | Valitun syötetavan ainoa syötesarake. |
| Maakonteksti | Valinnainen asetus tai sarake | Käytä luotettavia kaksikirjaimisia maakoodeja, jos niitä on saatavilla. |
| Tulossarakkeet | Sarakeviittaukset | Sukupuoli on ensisijainen kohde. Sarakkeet Probability, maa ja löydetty nimi ovat valinnaisia. |
| Ohita olemassa olevat tulokset | Valintaruutu | Tarkista nykyinen asetus, jotta uusi ajo ei vahingossa korvaa jo valmiita rivejä. |
Näin luet tulossarakkeet
Säilytä alkuperäinen syöte tuloksen vieressä. Nimeen perustuva yhteys ei osoita henkilön itse ilmoittamaa sukupuolta, eikä palautettu maa ole vahvistettu asuinmaa tai kansalaisuus.
- 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. |
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.
Valitse, mitä tietoja jaat
Laskentataulukkointegraatiot välittävät haussa tarvittavat arvot ja tarvitsevat luvan käsitellä valittua dokumenttia. Tarkista työkirjan käyttöoikeudet, yhdistetty tili ja kohdesarakkeet ennen kuin käsittelet henkilötietoja.
Säilytä API-avaimet lisäosan asetuksissa, älä tavallisissa soluissa, kuvakaappauksissa tai jaetuissa esimerkeissä. Julkaistu tietosuojakäytäntö kuvaa syötteiden käsittelyn, säilytyksen ja lokit. Laskentataulukkointegraatio ei tarkoita, että tiedot pysyvät kokonaan omalla laitteellasi.
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.
Usein kysytyt kysymykset
Pitääkö minun kirjoittaa koodia, jotta voin käyttää sivupaneelia?
Ei. Asenna lisäosa, lisää avain ja määritä lähde- ja tulossarakkeet. Suora API V2 -integraatio on erillinen vaihtoehto omille sovelluksille.
Voinko käsitellä olemassa olevia rivejä?
Kyllä. Käytä sivupaneelin taulukko- ja rivialuevalintoja. Tarkista ennen aloittamista otsikkorivi, syötetyyppi, kohdesarakkeet ja olemassa olevien tulosten asetus.
Ovatko tulossarakkeet V2:n JSON-vastaus?
Eivät. Natiivi tehtävä kirjoittaa taulukkoon tukemansa kentät. V2:n oliot data ja meta sekä kentät source ja confidence_kind kuuluvat suoran REST API:n määrittelyyn.
Mitä teen tuntemattomalle tulokselle?
Säilytä se arvona unknown ja erota se epäonnistuneesta toiminnosta. Tarkista monitulkintaiset syötteet ja käytä neutraalia oletusvaihtoehtoa sen sijaan, että sukupuoli määritettäisiin automaattisesti.
Lähteet ja dokumentaatio
Opas tarkistettiin viimeksi . Tarkista asennus alustan dokumentaatiosta ja käytä erillisessä V2-integraatiossa alla olevaa API-dokumentaatiota.