Verwerk gekozen rijen vanuit de zijbalk
De add-on GenderAPI for Google Sheets leest een kolom met namen, e-mailadressen of gebruikersnamen en schrijft de geselecteerde resultaatvelden in het blad. Vanuit de zijbalk kunt u een specifiek bereik verwerken en de waarden opslaan zonder in elke cel een formule achter te laten.
Dit is de eigen workflow van de add-on. De resultaatkolommen en de batchverwerking staan los van het openbare antwoordformaat van de V2 REST-API.
Installeren, koppelen en testen met een kleine steekproef
- Installeer de add-on via de vermelding in de Google Workspace Marketplace en controleer de gevraagde machtigingen. Open in Google Sheets Extensies (Extensions) → GenderAPI → Determine Gender.
- Kies een GenderAPI-sleutel of voer deze in de zijbalk in. Controleer of het geselecteerde account beschikbare credits heeft.
- Kies het blad en de methode name, email of username. Geef de bijbehorende bronkolom op en een klein bereik van rijen zonder de headerrij.
- Kies een aparte kolom voor het geslacht en, indien nodig, kolommen voor waarschijnlijkheid, land en gevonden naam. Overschrijf de oorspronkelijke waarden niet.
- Gebruik de landinstelling of een kolom met landcodes als u over betrouwbare geografische context beschikt. Leid die context niet af uit de voorspelling die u gaat opvragen.
- Controleer de optie om bestaande resultaten over te slaan, start de verwerking en controleer de geselecteerde rijen voordat u het bereik uitbreidt.
Invoer en bestemmingen koppelen
| Instelling | Type | Keuze en beschrijving |
|---|---|---|
| API-sleutel | Accountidentificatie | Gebruik de sleutel die in de add-on is geselecteerd en controleer of deze geldig is en saldo heeft. |
| Methode | Keuze | name, email of username, afhankelijk van de bronkolom. |
| Blad en rijbereik | Blad en rijnummers | Selecteer alleen de rijen die verwerkt moeten worden en sluit de headerrij uit. |
| Bronkolom | Kolomverwijzing | De enige invoerkolom voor de gekozen methode. |
| Geografische context | Optionele instelling of kolom | Gebruik betrouwbare landcodes van twee letters, indien beschikbaar. |
| Resultaatkolommen | Kolomverwijzingen | Het geslacht is de belangrijkste bestemming. Waarschijnlijkheid, land en gevonden naam zijn optioneel. |
| Bestaande resultaten overslaan | Selectievakje | Controleer deze instelling, zodat een nieuwe uitvoering niet per ongeluk al ingevulde rijen vervangt. |
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
Moet ik code schrijven om de zijbalk te gebruiken?
Nee. Installeer de add-on, koppel de sleutel en wijs de bronkolom en de resultaatkolommen toe. Een rechtstreekse integratie met de V2-API is een aparte optie voor maatwerkapplicaties.
Kan ik bestaande rijen verwerken?
Ja. Gebruik de instellingen voor blad en rijbereik in de zijbalk. Controleer voordat u de verwerking start de headerrij, het invoertype, de bestemmingskolommen en de optie voor bestaande resultaten.
Komen de resultaatkolommen overeen met het JSON-antwoord van V2?
Nee. De eigen verwerking van de add-on schrijft de ondersteunde velden in het blad. De objecten data en meta en de velden source en confidence_kind horen bij het contract van de rechtstreekse V2 REST-API.
Hoe ga ik om met een unknown-resultaat?
Sla het op als unknown en onderscheid het van een mislukte uitvoering. Controleer dubbelzinnige invoer en gebruik neutrale formuleringen in plaats van automatisch een geslacht toe te wijzen.
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.