Verrijk rijen in Excel vanuit de zijbalk
Met de GenderAPI-add-on voor Excel kiest u een kolom met namen, e-mailadressen of gebruikersnamen en schrijft u de resultaten naar gekoppelde kolommen van het werkblad. Gebruik de zijbalk voor een gecontroleerd rijbereik of de functies GENDER.FROM_* voor berekeningen die aan cellen zijn gekoppeld.
De native Excel-client gebruikt de velden van de legacy-API. Deze geeft niet de objecten data en meta van de REST V2 terug; houd de bestaande koppelingen in de werkmap afgestemd op de daadwerkelijke output van de add-on.
Configureer eerst een klein rijbereik
- Installeer GenderAPI via de vermelding in de Microsoft-catalogus en open de zijbalk van de add-on in de werkmap. Controleer de toegangsrechten tot het document en eventuele beperkingen van uw organisatie.
- Sla uw GenderAPI-sleutel op in de add-on en controleer of het gekozen account over credits beschikt.
- Kies de methode name, email of username en de bijbehorende bronkolom. Stel een klein rijbereik in, zonder de headerrij.
- Koppel de doelkolom voor het geslacht en, indien nodig, de kolommen voor probability, land en gevonden naam. Houd elk resultaat gescheiden van de brongegevens.
- Stel alleen een landcontext in wanneer die betrouwbaar is voor de gegevens die u verwerkt. Controleer de gekozen instellingen en voer de steekproef uit.
- Bekijk de geïdentificeerde, niet opgeloste en mislukte rijen voordat u het bereik uitbreidt. Bewaar een kopie van de oorspronkelijke gegevens van de werkmap.
Kies invoer, context en resultaatkolommen
| Instelling | Type | Beschrijving |
|---|---|---|
| API-sleutel | Accountreferentie | Opgeslagen via het sleutelveld in de add-on; voer deze niet in gewone cellen van de werkmap in. |
| Methode en bron | Keuze en kolom | name, email of username samen met de bijbehorende bronkolom. |
| Rijbereik | Rijnummers | Begin met een klein bereik zonder de headerrij. |
| Landfilter | Optioneel land of optionele kolom | Geef een bekende landcontext op; het veld bevestigt niet de geverifieerde locatie van de persoon. |
| Resultaatkolommen | Kolomverwijzingen | Een doelkolom voor het geslacht en optionele doelen voor probability, land en gevonden naam. |
De resultaatkolommen lezen
Bewaar de oorspronkelijke waarde naast het resultaat. Een koppeling op basis van de naam legt niet het door de persoon opgegeven geslacht vast, en een teruggegeven land bewijst geen woonplaats of nationaliteit.
- Controleer een gewoon resultaat, een dubbelzinnige invoer en een mislukte uitvoering voordat u de volledige dataset verwerkt.
- Een lege cel, de tekst null en een formulefout zijn verschillende waarden. Normaliseer unknown-resultaten bewust, zonder fouten te verbergen.
- Gebruik neutrale formuleringen voor unknown of onzekere gevallen en houd informatie die de persoon zelf heeft verstrekt gescheiden van voorspellingen.
| Resultaat | Type | Gebruik |
|---|---|---|
| Gender | Tekst of onopgeloste waarde | Bewaar male of female alleen bij een geslaagd resultaat. Sla een onopgeloste waarde op als unknown en controleer foutmeldingen afzonderlijk. |
| Probability | Getal, indien beschikbaar | Een historische indicator van betrouwbaarheid. Deze komt niet overeen met het veld confidence van V2 en ook niet met een op uw gegevens gemeten nauwkeurigheid. |
| Country | Tekst, indien beschikbaar | Context die door de zoekopdracht is teruggegeven. Bewaar deze apart van het geverifieerde land van de klant. |
| Found / normalized name | Tekst, indien beschikbaar | De naam die tijdens de verwerking is gebruikt of geëxtraheerd. Controleer deze wanneer een e-mailadres of gebruikersnaam dubbelzinnig is. |
Credits, limieten en nieuwe uitvoeringen plannen
Een gratis geregistreerd GenderAPI-account bevat 200 credits per dag. Dat is een accountsaldo, geen belofte van 200 geïdentificeerde resultaten in elke workflow. Controleer voordat u begint het saldo van de geselecteerde sleutel en de huidige verwerkingsopties van de tool.
Add-ons en bestandsverwerking volgen hun eigen verwerkingspaden. De batchlimiet van de V2 REST-API, de AI-opties en de afschrijvingsvelden per verzoek gelden niet automatisch voor deze tools. Een nieuwe uitvoering of herberekening kan nieuwe verzoeken versturen en credits verbruiken: ga er niet van uit dat dit gratis is.
Begin met een kleine steekproef, sla de verkregen resultaten op en controleer mislukte rijen voordat u de uitvoering herhaalt. Als u alleen een export of een update in de bestemming hoeft te corrigeren, hergebruik dan de resultaten die u al hebt.
Kies welke gegevens u deelt
Spreadsheetintegraties versturen de waarden die voor de zoekopdracht nodig zijn en vragen machtigingen voor het geselecteerde document. Controleer voordat u persoonsgegevens verwerkt wie toegang heeft tot de spreadsheet, welk account is gekoppeld en welke bestemmingskolommen worden gebruikt.
Bewaar de API-sleutel in de instellingen van de add-on, niet in gewone cellen, screenshots of gedeelde voorbeelden. Het gepubliceerde privacybeleid beschrijft hoe invoergegevens worden verwerkt, bewaard en gelogd. Een spreadsheetintegratie betekent niet dat de gegevens uitsluitend op uw apparaat blijven.
Wanneer u de V2-API rechtstreeks gebruikt
Stel een aparte HTTP-integratie in als uw applicatie expliciete AI-opties en de V2-informatie status, source, confidence_kind en usage per item nodig heeft. Volg het verzoek- en antwoordcontract van V2: V2-veldnamen toevoegen aan een eigen formule of een bestaande add-on verandert het gedrag daarvan niet.
Veelgestelde vragen
Kan ik e-mailadressen en gebruikersnamen in Excel analyseren?
Ja. Kies de bijbehorende methode in de zijbalk en koppel de juiste invoerkolom. Controleer de teruggegeven naam en de niet opgeloste gevallen voordat u de resultaten gebruikt.
Moet ik de zijbalk of een formule gebruiken?
Gebruik de zijbalk om een gekozen bereik te verwerken en de waarden naar de gekoppelde kolommen te schrijven. Kies de formules GENDER.FROM_* wanneer u berekeningen nodig hebt die aan cellen zijn gekoppeld, en houd rekening met wat herberekening met zich meebrengt.
Betekent de bestandsnaam functions_v2.js dat de add-on de REST V2 gebruikt?
Nee. Het is de naam van een bestand van de Excel-client. Het openbare formulebestand dat voor deze handleiding is bekeken, roept endpoints van de legacy-API aan en leest de antwoordvelden daarvan.
Zijn voorspellingen geverifieerde kenmerken van de klant?
Nee. Houd ze gescheiden van de informatie die de klant zelf heeft verstrekt en gebruik een neutraal alternatief voor unknown-resultaten of onzekere gevallen.
Referentiedocumentatie
De handleiding is voor het laatst gecontroleerd op . Controleer de installatie in de documentatie van het platform en gebruik de gekoppelde API-documentatie voor een afzonderlijke V2-integratie.