Täydennä valittuja Excel-rivejä sivupaneelista
GenderAPI:n Excel-lisäosalla voit valita nimi-, sähköposti- tai käyttäjänimisarakkeen ja kirjoittaa tulokset yhdistettyihin taulukon sarakkeisiin. Käytä sivupaneelia rajatulle rivialueelle tai erillisiä funktioita GENDER.FROM_* soluihin perustuviin laskelmiin.
Lisäosan oma Excel-asiakasohjelma käyttää vanhemman API:n kenttiä. Se ei palauta suoran REST V2 API:n objekteja data ja meta, joten pidä työkirjan nykyiset kenttien yhdistämiset linjassa lisäosan todellisen tulosteen kanssa.
Määritä ensin pieni rivialue
- Asenna GenderAPI sen Microsoft AppSourcen sivulta ja avaa lisäosan sivupaneeli työkirjassasi. Tarkista asiakirjan käyttöoikeudet ja organisaatiosi mahdolliset rajoitukset.
- Tallenna GenderAPI-avaimesi lisäosan kautta ja varmista, että tarkoitetulla tilillä on krediittejä.
- Valitse menetelmä name, email tai username ja sitä vastaava lähdesarake. Määritä alku- ja loppurivi niin, että alue on pieni eikä sisällä otsikkoriviä.
- Yhdistä sukupuolen kohdesarake sekä valinnaiset sarakkeet Probability-arvolle, maalle ja löydetylle nimelle. Pidä jokainen tuloste erillään lähdetiedoista.
- Määritä maakonteksti vain, kun se on luotettava käsittelemillesi tiedoille. Tarkista valitut asetukset ja käsittele otos.
- Tarkista rivit, joilla on tulos identified, sekä tuntemattomat ja epäonnistuneet rivit ennen kuin laajennat aluetta. Säilytä kopio työkirjan alkuperäisistä tiedoista.
Valitse syöte, konteksti ja tulossarakkeet
| Asetus | Tyyppi | Kuvaus |
|---|---|---|
| API-avain | Tilin tunnistetieto | Tallennetaan lisäosan avainkentän kautta; älä sijoita sitä työkirjan tavallisiin soluihin. |
| Menetelmä ja lähde | Valinta ja sarake | name, email tai username sekä sitä vastaava lähdesarake. |
| Rivialue | Rivinumerot | Aloita pienellä alueella ilman otsikkoriviä. |
| Maasuodatin | Valinnainen maa tai sarake | Antaa tunnetun maakontekstin; se ei ole pyyntö henkilön vahvistetusta sijainnista. |
| Tulossarakkeet | Sarakeviittaukset | Sukupuolen kohdesarake sekä valinnaiset kohdesarakkeet Probability-arvolle, maalle ja löydetylle nimelle. |
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
Voinko analysoida sähköpostiosoitteita ja käyttäjänimiä Excelissä?
Kyllä. Valitse sivupaneelissa vastaava menetelmä ja yhdistä sitä vastaava syötesarake. Tarkista palautettu nimi ja tuntemattomat tulokset ennen kuin käytät tulosta.
Kannattaako käyttää sivupaneelia vai kaavaa?
Käytä sivupaneelia, kun haluat käsitellä valitun alueen ja kirjoittaa arvot yhdistettyihin sarakkeisiin. Käytä kaavoja GENDER.FROM_*, kun haluat solujen syötteisiin sidottuja laskelmia ja ymmärrät, miten uudelleenlaskenta toimii.
Tarkoittaako tiedosto functions_v2.js, että lisäosa käyttää REST V2:ta?
Ei. Se on Excel-asiakasohjelman tiedoston nimi. Tätä opasta varten tarkistettu julkinen kaavatiedosto kutsuu vanhemman API:n endpointeja ja lukee niiden vanhoja vastauskenttiä.
Ovatko ennusteet vahvistettuja asiakkaan ominaisuuksia?
Eivät. Pidä päätellyt tulokset erillään asiakkaan itse antamista tiedoista ja käytä neutraalia vara-arvoa tuntemattomille tai epävarmoille tietueille.
Lähteet ja dokumentaatio
Opas tarkistettiin viimeksi . Tarkista asennus alustan dokumentaatiosta ja käytä erillisessä V2-integraatiossa alla olevaa API-dokumentaatiota.