Workflows in Google Sheets · Integratiehandleiding

Een workflow instellen voor nieuwe rijen in Google Sheets met GenderAPI

Stel een workflow van de add-on in, koppel de kolommen en test de werkelijke bron van nieuwe rijen. Handel unknown-resultaten en gemiste updates af.

Integratiehandleiding: Workflows in Google Sheets

Nieuwe records aan de resultaatkolommen koppelen

De GenderAPI-add-on biedt een scherm Workflows dat nieuwe records in het blad koppelt aan een geslachtskolom en aan andere optionele resultaatkolommen. Stel dit in voor het juiste blad en controleer daarna een werkelijk binnenkomend record voordat u op de automatisering vertrouwt.

De eigen workflow van de add-on staat los van een rechtstreekse HTTP-actie met V2. Activering, timing en uitvoervelden hangen af van de geïnstalleerde add-on en het Google-account. Een onmiddellijke update is niet voor elke bron van nieuwe rijen gegarandeerd.

De workflow maken en testen

  • Installeer en open de GenderAPI-add-on en open vervolgens Workflows via het menu van de zijbalk.
  • Kies het blad en uw API-sleutel. Selecteer de analyse name, email of username die bij de bronkolom past.
  • Koppel de bronkolom aan een aparte geslachtskolom. Voeg alleen bestemmingen voor waarschijnlijkheid, land en gevonden naam toe als u die nodig hebt.
  • Controleer alle koppelingen voordat u de workflow aanmaakt. De interface voorkomt conflicten tussen kolommen en kan melden dat er al een workflow bestaat of dat een limiet is bereikt.
  • Voeg een representatief record toe via hetzelfde mechanisme dat uw productiegegevens gebruiken. Controleer of de waarden in de juiste rij verschijnen en of er geen bestaand veld is overschreven.
  • Test een onopgeloste waarde en een operationele fout, en bepaal daarna hoe u ontbrekende of mislukte rijen opspoort en controleert.

De velden van de add-on-workflow instellen

InstellingTypeGebruik
API-sleutelInloggegevenKies het juiste account en controleer de beschikbare credits.
BladBladselectieHet blad waarvan deze workflow de records moet verwerken.
MethodeKeuzename, email of username. De gekozen methode bepaalt hoe de invoer wordt geïnterpreteerd.
BronkolomKolomverwijzingDe waarde die in elk record moet worden geanalyseerd.
GeslachtskolomKolomverwijzingEen bestemming die gescheiden is van de invoer en van de andere resultaten.
Waarschijnlijkheid, land, gevonden naamOptionele bestemmingenAparte kolommen voor de extra resultaten van de add-on.

Controleer hoe rijen werkelijk in het blad terechtkomen

Een waarde typen, een formulier indienen en records uit een CRM importeren zijn verschillende gebeurtenissen. Volgens de documentatie van Google activeren scriptuitvoeringen en API-verzoeken doorgaans geen installeerbare triggers. De openbare vermelding van de add-on geeft niet precies aan hoe deze is geïmplementeerd: test de gegevensbron die u wilt gebruiken.

Ga er niet van uit dat een nieuwe workflow bestaande rijen achteraf verwerkt. Kies voor deze records een bereik in de zijbalk voor batchverwerking en houd bij welke rijen al zijn verwerkt.

Als een verwachte update uitblijft, controleer dan de workflow, de machtigingen, het saldo van de sleutel, de kolomkoppelingen en platformfouten voordat u dezelfde records opnieuw verstuurt.

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.
ResultaatTypeGebruik
GenderTekst of onopgeloste waardeBewaar male of female alleen bij een geslaagd resultaat. Sla een onopgeloste waarde op als unknown en controleer foutmeldingen afzonderlijk.
ProbabilityGetal, indien beschikbaarEen historische indicator van betrouwbaarheid. Deze komt niet overeen met het veld confidence van V2 en ook niet met een op uw gegevens gemeten nauwkeurigheid.
CountryTekst, indien beschikbaarContext die door de zoekopdracht is teruggegeven. Bewaar deze apart van het geverifieerde land van de klant.
Found / normalized nameTekst, indien beschikbaarDe 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.

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

Activeert elke import uit een CRM de workflow van de add-on?

Ga daar niet van uit. Test een record uit het CRM of de automatisering die u werkelijk gebruikt. Google maakt onderscheid tussen handmatige wijzigingen, formulierinzendingen en updates via de API. Controleer het gedrag van de geïnstalleerde add-on.

Kan ik de rijen verwerken die al in het blad staan?

Kies een bereik in de zijbalk voor batchverwerking. Het aanmaken van een workflow voor nieuwe rijen betekent niet dat bestaande records worden verwerkt.

Hoeveel workflows kan ik aanmaken?

De interface kan een limiet melden, maar deze handleiding noemt geen ongeverifieerd aantal. Controleer de geïnstalleerde versie en verwijder zo nodig workflows die u niet meer nodig hebt.

Hoe krijg ik de V2-velden source en usage?

Maak een aparte HTTP-integratie met V2, bijvoorbeeld volgens de gedocumenteerde handleiding voor Make of Zapier. Ga er niet van uit dat de kolommen van de add-on de antwoordstructuur van V2 bevatten.

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.

Gepubliceerd: 2 april 2025Laatst gecontroleerd:

Kies de workflow

Gebruik de native add-on of bouw een V2-integratie

Bekijk de beschikbare integraties of bouw een eigen workflow op basis van de V2-documentatie.