Behandl valgte rækker fra sidepanelet
Tilføjelsen GenderAPI for Google Sheets læser en kolonne med navne, e-mailadresser eller brugernavne og skriver de valgte resultatfelter i arket. Fra sidepanelet kan du behandle et bestemt område og gemme værdierne uden at efterlade en formel i hver celle.
Dette er tilføjelsens eget workflow. Dens resultatkolonner og behandling af batches er uafhængige af det offentlige svarformat i REST API V2.
Installér, forbind og test med en lille prøve
- Installér tilføjelsen fra dens side i Google Workspace Marketplace, og kontrollér de tilladelser, den beder om. Åbn Udvidelser (Extensions) → GenderAPI → Determine Gender i Google Sheets.
- Vælg en GenderAPI-nøgle, eller indtast den i sidepanelet. Kontrollér, at den valgte konto har kreditter til rådighed.
- Vælg arket og metoden name, email eller username. Angiv den tilsvarende kildekolonne og et lille rækkeområde uden overskriftsrækken.
- Vælg en separat kolonne til køn og om nødvendigt kolonner til probability, land og fundet navn. Overskriv ikke de oprindelige værdier.
- Hvis du har pålidelig geografisk kontekst, så brug landeindstillingen eller en kolonne med landekoder. Udled ikke denne kontekst af den forudsigelse, du er ved at bede om.
- Kontrollér indstillingen for at springe eksisterende resultater over, start behandlingen, og gennemgå de valgte rækker, før du udvider området.
Tilknyt input og destinationer
| Indstilling | Type | Valg og beskrivelse |
|---|---|---|
| API-nøgle | Konto-id | Brug nøglen, der er valgt i tilføjelsen, og kontrollér, at den er gyldig og har saldo. |
| Metode | Valg | name, email eller username, afhængigt af kildekolonnen. |
| Ark og rækkeområde | Ark og rækkenumre | Vælg kun de rækker, der skal behandles, og udelad overskriftsrækken. |
| Kildekolonne | Kolonnereference | Den eneste inputkolonne for den valgte metode. |
| Geografisk kontekst | Valgfri indstilling eller kolonne | Brug pålidelige landekoder på to bogstaver, hvis de findes. |
| Resultatkolonner | Kolonnereferencer | Køn er den primære destination. Probability, land og fundet navn er valgfrie. |
| Spring eksisterende resultater over | Afkrydsningsfelt | Kontrollér denne indstilling, så en ny kørsel ikke ved en fejl erstatter rækker, der allerede er udfyldt. |
Læs resultatkolonnerne
Behold den oprindelige værdi ved siden af resultatet. En navnebaseret sammenhæng fastslår ikke personens selvoplyste køn, og et returneret land beviser hverken bopæl eller statsborgerskab.
- Kontrollér et almindeligt resultat, et tvetydigt input og en mislykket kørsel, før du behandler hele datasættet.
- En tom celle, teksten null og en formelfejl er forskellige værdier. Normalisér unknown-resultater bevidst uden at skjule fejl.
- Brug neutrale formuleringer ved unknown eller usikre tilfælde, og hold oplysninger, som personen selv har givet, adskilt fra forudsigelser.
| Resultat | Type | Brug |
|---|---|---|
| Gender | Tekst eller uafklaret værdi | Gem kun male eller female ved et vellykket resultat. Gem en uafklaret værdi som unknown, og gennemgå fejlmeddelelser separat. |
| Probability | Tal, hvis tilgængeligt | En historisk konfidensindikator. Den svarer hverken til feltet confidence i V2 eller til en målt nøjagtighed på dine data. |
| Country | Tekst, hvis tilgængelig | Kontekst, som opslaget returnerer. Hold den adskilt fra kundens verificerede land. |
| Found / normalized name | Tekst, hvis tilgængelig | Navnet, der blev brugt eller udtrukket under behandlingen. Kontrollér det, når en e-mailadresse eller et brugernavn er tvetydigt. |
Planlæg kreditter, grænser og nye kørsler
En gratis, registreret GenderAPI-konto indeholder 200 kreditter om dagen. Det er en kontosaldo, ikke et løfte om 200 identificerede resultater i hvert workflow. Kontrollér saldoen for den valgte nøgle og værktøjets aktuelle behandlingsmuligheder, før du går i gang.
Tilføjelser og filbehandling følger deres egne behandlingsforløb. Batchgrænsen i REST API V2, AI-indstillingerne og opkrævningsfelterne for de enkelte forespørgsler gælder ikke automatisk for disse værktøjer. En ny kørsel eller genberegning kan sende nye forespørgsler og bruge kreditter, så gå ikke ud fra, at den er gratis.
Start med en lille prøve, gem de resultater, du får, og gennemgå de mislykkede rækker, før du kører igen. Hvis du kun skal rette en eksport eller en opdatering i destinationen, så genbrug de resultater, du allerede har.
Vælg, hvilke data du deler
Regnearksintegrationer sender de værdier, der er nødvendige for opslaget, og kræver tilladelser til det valgte dokument. Før du behandler personoplysninger, så kontrollér, hvem der har adgang til regnearket, hvilken konto der er forbundet, og hvilke destinationskolonner der bruges.
Opbevar API-nøglen i tilføjelsens indstillinger, ikke i almindelige celler, skærmbilleder eller delte eksempler. Den offentliggjorte privatlivspolitik beskriver, hvordan inputdata behandles, opbevares og logges. En regnearksintegration betyder ikke, at dataene udelukkende forbliver på din enhed.
Hvornår du skal bruge API V2 direkte
Opsæt en separat HTTP-integration, hvis din applikation kræver eksplicitte AI-indstillinger og V2-oplysningerne status, source, confidence_kind og usage for hvert element. Følg V2-kontrakten for forespørgsel og svar: Hvis du tilføjer V2-feltnavne til en egen formel eller en eksisterende tilføjelse, ændrer det ikke dens adfærd.
Ofte stillede spørgsmål
Skal jeg skrive kode for at bruge sidepanelet?
Nej. Installér tilføjelsen, forbind nøglen, og tilknyt kildekolonnen og resultatkolonnerne. En direkte integration med API V2 er en separat mulighed for skræddersyede applikationer.
Kan jeg behandle eksisterende rækker?
Ja. Brug indstillingerne for ark og rækkeområde i sidepanelet. Kontrollér overskriftsrækken, inputtypen, destinationskolonnerne og indstillingen for eksisterende resultater, før du starter behandlingen.
Svarer resultatkolonnerne til JSON-svaret i V2?
Nej. Tilføjelsens egen behandling skriver de understøttede felter i arket. Objekterne data og meta samt felterne source og confidence_kind hører til kontrakten for den direkte REST API V2.
Hvordan håndterer jeg et unknown-resultat?
Gem det som unknown, og hold det adskilt fra en mislykket kørsel. Gennemgå tvetydige input, og brug neutrale formuleringer i stedet for automatisk at tildele et køn.
Kilder og dokumentation
Guiden blev senest gennemgået den . Kontrollér installationen i platformens dokumentation, og brug den tilknyttede API-dokumentation til en separat V2-integration.