Berika Excel-rader via sidopanelen
Med GenderAPI-tillägget för Excel väljer du en kolumn med namn, e-postadresser eller användarnamn och skriver resultaten till mappade kolumner i kalkylbladet. Använd sidopanelen för ett kontrollerat radintervall eller funktionerna GENDER.FROM_* för cellbundna beräkningar.
Den inbyggda Excel-klienten använder fälten från det äldre API:et. Den returnerar inte objekten data och meta från REST V2; håll befintliga mappningar i arbetsboken i linje med tilläggets faktiska utdata.
Konfigurera först ett litet radintervall
- Installera GenderAPI från sidan i Microsofts katalog och öppna tilläggets sidopanel i arbetsboken. Granska behörigheterna för dokumentåtkomst och eventuella begränsningar i din organisation.
- Spara din GenderAPI-nyckel i tillägget och kontrollera att det valda kontot har tillgängliga krediter.
- Välj metoden name, email eller username och motsvarande källkolumn. Ange ett litet radintervall utan rubrikrad.
- Mappa målkolumnen för kön och vid behov kolumner för sannolikhet, land och hittat namn. Håll varje resultat åtskilt från källdata.
- Ange landskontext endast när den är tillförlitlig för de data du bearbetar. Granska de valda inställningarna och kör ett stickprov.
- Granska identifierade, ej fastställda och misslyckade rader innan du utökar intervallet. Behåll en kopia av arbetsbokens ursprungliga data.
Välj indata, kontext och resultatkolumner
| Inställning | Typ | Beskrivning |
|---|---|---|
| API-nyckel | Kontouppgift | Sparas via nyckelfältet i tillägget; skriv den inte i vanliga celler i arbetsboken. |
| Metod och källa | Val och kolumn | name, email eller username tillsammans med källkolumnen. |
| Radintervall | Radnummer | Börja med ett litet intervall utan rubrikrad. |
| Landsfilter | Valfritt land eller kolumn | Ange en känd landskontext; fältet styrker inte personens verifierade plats. |
| Resultatkolumner | Kolumnreferenser | Målkolumn för kön samt valfria målkolumner för sannolikhet, land och hittat namn. |
Läs resultatkolumnerna
Behåll det ursprungliga värdet bredvid resultatet. En namnbaserad matchning avgör inte vilket kön en person själv uppger, och ett returnerat land bevisar varken var personen bor eller vilket medborgarskap hon eller han har.
- Granska ett vanligt resultat, en tvetydig indata och en misslyckad körning innan du bearbetar hela datamängden.
- En tom cell, texten null och ett formelfel är olika värden. Normalisera unknown-resultat medvetet utan att dölja fel.
- Använd neutrala formuleringar vid unknown eller osäkra fall och håll uppgifter som personen själv lämnat åtskilda från prediktioner.
| Resultat | Typ | Användning |
|---|---|---|
| Gender | Text eller olöst värde | Behåll male eller female bara vid ett lyckat resultat. Spara ett olöst värde som unknown och granska felmeddelanden separat. |
| Probability | Tal, om tillgängligt | Ett historiskt konfidensvärde. Det motsvarar varken fältet confidence i V2 eller en uppmätt noggrannhet för dina data. |
| Country | Text, om tillgänglig | Sammanhang som returneras av sökningen. Spara det separat från kundens verifierade land. |
| Found / normalized name | Text, om tillgänglig | Namnet som användes eller extraherades vid bearbetningen. Granska det när en e-postadress eller ett användarnamn är tvetydigt. |
Planera krediter, gränser och nya körningar
Ett registrerat kostnadsfritt GenderAPI-konto omfattar 200 krediter per dag. Det är ett kontosaldo och inget löfte om 200 identifierade resultat i varje arbetsflöde. Kontrollera saldot för den valda nyckeln och verktygets aktuella bearbetningsalternativ innan du börjar.
Egna tillägg och filbearbetning har sina egna bearbetningsvägar. Batchgränsen i REST-API:et V2, AI-alternativen och debiteringsfälten för enskilda förfrågningar gäller inte automatiskt för dem. En ny körning eller omräkning kan skicka nya förfrågningar och förbruka krediter: utgå inte från att den är kostnadsfri.
Börja med ett litet urval, spara de resultat du fått och granska misslyckade rader innan du kör igen. Om du bara behöver rätta en export eller en uppdatering i målet ska du återanvända de resultat du redan har.
Bestäm vilka data du delar
Kalkylbladsintegrationer skickar de värden som behövs för sökningen och kräver behörigheter för det valda dokumentet. Kontrollera innan du bearbetar personuppgifter vem som har åtkomst till kalkylarket, vilket konto som är anslutet och vilka målkolumner som används.
Förvara API-nyckeln i tilläggets inställningar, inte i vanliga celler, på skärmbilder eller i delade exempel. Den publicerade integritetspolicyn beskriver hur indata behandlas, lagras och loggas. En kalkylbladsintegration innebär inte att data enbart stannar på din enhet.
När du ska använda V2-API:et direkt
Konfigurera en separat HTTP-integration om ditt program behöver uttryckliga AI-alternativ samt uppgifterna status, source, confidence_kind och usage från V2 för varje post. Följ kontraktet för förfrågan och svar i V2: om du lägger till fältnamn från V2 i en egen formel eller ett befintligt tillägg ändras inte dess beteende.
Vanliga frågor
Kan jag analysera e-postadresser och användarnamn i Excel?
Ja. Välj motsvarande metod i sidopanelen och mappa rätt indatakolumn. Granska det returnerade namnet och ej fastställda fall innan du använder resultaten.
Ska jag använda sidopanelen eller en formel?
Använd sidopanelen för att bearbeta ett valt intervall och skriva värden till mappade kolumner. Välj formlerna GENDER.FROM_* när du behöver cellbundna beräkningar och tar hänsyn till vad en omräkning innebär.
Betyder filnamnet functions_v2.js att tillägget använder REST V2?
Nej. Det är ett filnamn i Excel-klienten. Den publicerade formelfilen som granskades för den här guiden anropar endpoints i det äldre API:et och läser dess svarsfält.
Är prediktioner verifierade kundattribut?
Nej. Håll dem åtskilda från uppgifter som kunden själv har lämnat och använd neutrala formuleringar för unknown-resultat eller osäkra fall.
Referensdokumentation
Guiden granskades senast . Kontrollera installationen i plattformens dokumentation och använd den länkade API-dokumentationen för en separat V2-integration.