Berik utvalgte Excel-rader fra sidepanelet
Med GenderAPI-tillegget for Excel velger du en kolonne med navn, e-postadresser eller brukernavn og skriver resultatene til tilordnede kolonner i regnearket. Bruk sidepanelet til et kontrollert radområde, eller de separate GENDER.FROM_*-funksjonene til cellebaserte beregninger.
Den innebygde Excel-klienten bruker feltene fra det eldre API-et. Den returnerer ikke objektene data og meta fra det direkte REST V2-API-et; hold eksisterende tilordninger i arbeidsboken i samsvar med tilleggets faktiske utdata.
Konfigurer et lite radområde først
- Installer GenderAPI fra den offisielle oppføringen i Microsofts katalog, og åpne sidepanelet til tillegget i arbeidsboken. Kontroller tilgangstillatelsene for dokumentet og eventuelle begrensninger i organisasjonen din.
- Lagre GenderAPI-nøkkelen din i tillegget, og kontroller at den tiltenkte kontoen har kreditter.
- Velg metoden name, email eller username og den tilhørende kildekolonnen. Angi et lite område med start- og sluttrad, uten overskriftsraden.
- Tilordne målkolonnen for kjønn og eventuelt kolonner for probability, land og funnet navn. Hold hvert resultat atskilt fra kildedataene.
- Angi landekontekst bare når den er pålitelig for dataene du behandler. Kontroller de valgte innstillingene, og kjør testutvalget.
- Gå gjennom rader som er identified, uavklarte eller mislykkede, før du utvider området. Behold en kopi av de opprinnelige dataene i arbeidsboken.
Velg inndata, kontekst og resultatkolonner
| Innstilling | Type | Beskrivelse |
|---|---|---|
| API-nøkkel | Påloggingsopplysning for kontoen | Lagres via nøkkelfeltet i tillegget; ikke skriv den inn i vanlige celler i arbeidsboken. |
| Metode og kilde | Valg og kolonne | name, email eller username sammen med den tilhørende kildekolonnen. |
| Radområde | Radnumre | Start med et lite område uten overskriftsraden. |
| Landefilter | Valgfritt land eller kolonne | Gir kjent landekontekst; det er ikke en forespørsel om personens verifiserte plassering. |
| Resultatkolonner | Kolonnereferanser | En målkolonne for kjønn og valgfrie målkolonner for probability, land og funnet navn. |
Les resultatkolonnene
Behold den opprinnelige verdien ved siden av resultatet. En navnebasert tilknytning fastslår ikke kjønnet personen selv har oppgitt, og et returnert land er ikke bekreftet bosted eller nasjonalitet.
- Kontroller et vanlig resultat, et tvetydig input og en mislykket operasjon før du behandler et helt datasett.
- En tom celle, teksten null og en formelfeil er ulike verdier i regnearket. Normaliser unknown-resultater bevisst uten å skjule feil.
- Bruk en nøytral reserveløsning for ukjente eller usikre poster. Hold profilopplysninger som personen selv har oppgitt, atskilt fra utledede kolonner.
| Resultat | Typisk type | Slik bruker du det |
|---|---|---|
| Gender | Tekst eller uavklart verdi | Behold male eller female bare ved et vellykket resultat. Behold en uavklart verdi som unknown, og gjennomgå feiltekster separat. |
| Probability | Tall, når tilgjengelig | Et eldre konfidenssignal. Det er verken feltet confidence i V2 eller en målt treffsikkerhet for datasettet ditt. |
| Country | Tekst, når tilgjengelig | Kontekst som oppslaget returnerer. Hold den atskilt fra kundens bekreftede land. |
| Found / normalized name | Tekst, når tilgjengelig | Navnet som ble brukt eller hentet ut under behandlingen. Kontroller det ved tvetydige e-postadresser og brukernavn. |
Planlegg kreditter, grenser og gjentatte kjøringer
En registrert gratis GenderAPI-konto inkluderer 200 kreditter per dag. Kreditter er en kontosaldo, ikke et løfte om 200 vellykkede resultater i hver arbeidsflyt. Kontroller saldoen for den valgte nøkkelen og verktøyets gjeldende behandlingsalternativer før du starter.
Innebygde tillegg og filjobber har egne behandlingsløp. Grensen for samleforespørsler i REST API V2, KI-alternativene og belastningsfeltene per forespørsel gjelder ikke automatisk for dem. En gjentatt kjøring eller omberegning kan sende inn nytt arbeid, så ikke anta at den er gratis.
Start med et lite utvalg, behold fullførte resultater, og gjennomgå de mislykkede radene før du kjører på nytt. Hvis du bare trenger å rette en senere eksport eller en oppdatering i målet, bør du gjenbruke resultatene du allerede har.
Velg hvilke data du deler
Regnearkintegrasjonene overfører verdiene som trengs for oppslagene, og krever tillatelse til å arbeide med det valgte dokumentet. Kontroller tilgangen til arbeidsboken, den tilkoblede kontoen og destinasjonskolonnene før du behandler personopplysninger.
Oppbevar API-nøkler i tilleggets innstillinger, ikke i vanlige celler, skjermbilder eller delte eksempler. Den publiserte personvernerklæringen beskriver behandling av input, oppbevaring og logger. En regnearkintegrasjon betyr ikke at dataene forblir utelukkende på enheten din.
Når du bør bruke API V2 direkte
Bruk en separat HTTP-integrasjon når applikasjonen din trenger eksplisitte KI-alternativer og V2-informasjonen status, source, confidence_kind og usage for hvert element. Følg V2-kontrakten for forespørsel og svar. Å legge til V2-feltnavn i en innebygd formel eller et eksisterende tillegg endrer ikke hvordan den klienten oppfører seg.
Ofte stilte spørsmål
Kan jeg analysere e-postadresser og brukernavn i Excel?
Ja. Velg den tilsvarende metoden i sidepanelet, og tilordne riktig inndatakolonne. Kontroller det returnerte navnet og uavklarte resultater før du bruker resultatet.
Bør jeg bruke sidepanelet eller en formel?
Bruk sidepanelet til å behandle et valgt område og skrive verdier til de tilordnede kolonnene. Velg GENDER.FROM_*-formlene når du vil ha beregninger knyttet til celler og forstår hvordan omberegning fungerer.
Betyr filnavnet functions_v2.js at tillegget bruker REST V2?
Nei. Det er navnet på en fil i Excel-klienten. Den offentlige formelfilen som er gjennomgått for denne veiledningen, kaller endepunkter i det eldre API-et og leser svarfeltene derfra.
Er prediksjonene verifiserte kundeattributter?
Nei. Hold utledede resultater atskilt fra opplysninger kunden selv har oppgitt, og bruk et nøytralt alternativ for ukjente eller usikre poster.
Kilder og dokumentasjon
Veiledningen ble sist gjennomgått . Kontroller installasjonen i dokumentasjonen til plattformen, og bruk API-dokumentasjonen nedenfor for en separat V2-integrasjon.