Bearbeta valda rader via sidopanelen
Tillägget GenderAPI for Google Sheets läser en kolumn med namn, e-postadresser eller användarnamn och skriver valda resultatfält till kalkylbladet. Via sidopanelen kan du bearbeta ett visst intervall och spara värden utan att lämna en formel i varje cell.
Detta är tilläggets eget flöde. Dess resultatkolumner och batchbearbetning är oberoende av det publika svarsformatet i REST-API:et V2.
Installera, anslut och testa med ett litet urval
- Installera tillägget via dess sida i Google Workspace Marketplace och kontrollera vilka behörigheter det begär. Öppna Tillägg (Extensions) → GenderAPI → Determine Gender i Google Sheets.
- Välj en GenderAPI-nyckel eller ange den i sidopanelen. Kontrollera att det valda kontot har tillgängliga krediter.
- Välj kalkylblad och metoden name, email eller username. Ange motsvarande källkolumn och ett litet radintervall utan rubrikrad.
- Välj en egen kolumn för kön och vid behov kolumner för sannolikhet, land och hittat namn. Skriv inte över de ursprungliga värdena.
- Om du har ett tillförlitligt landssammanhang kan du använda landsinställningen eller en kolumn med landskoder. Härled inte detta sammanhang från den prediktion du vill hämta.
- Kontrollera alternativet för att hoppa över befintliga resultat, starta bearbetningen och granska de valda raderna innan du utökar intervallet.
Mappa indata och mål
| Inställning | Typ | Val och beskrivning |
|---|---|---|
| API-nyckel | Kontoidentifierare | Använd nyckeln som valts i tillägget och kontrollera att den är giltig och har saldo. |
| Metod | Val | name, email eller username, beroende på källkolumnen. |
| Kalkylblad och radintervall | Kalkylblad och radnummer | Välj bara de rader som ska bearbetas och utelämna rubrikraden. |
| Källkolumn | Kolumnreferens | Den enda indatakolumnen för den valda metoden. |
| Landssammanhang | Valfri inställning eller kolumn | Använd tillförlitliga landskoder med två bokstäver om du har sådana. |
| Resultatkolumner | Kolumnreferenser | Kön är huvudmålet. Sannolikhet, land och hittat namn är valfria. |
| Hoppa över befintliga resultat | Kryssruta | Kontrollera denna inställning så att en ny körning inte av misstag ersätter rader som redan är ifyllda. |
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
Måste jag skriva kod för att använda sidopanelen?
Nej. Installera tillägget, anslut nyckeln och mappa källkolumnen och resultatkolumnerna. En direkt integration med V2-API:et är ett separat alternativ för egenutvecklade program.
Kan jag bearbeta befintliga rader?
Ja. Använd inställningarna för kalkylblad och radintervall i sidopanelen. Kontrollera rubrikraden, indatatypen, målkolumnerna och alternativet för befintliga resultat innan du startar bearbetningen.
Motsvarar resultatkolumnerna JSON-svaret i V2?
Nej. Den egna bearbetningen skriver de fält som stöds till kalkylbladet. Objekten data och meta samt fälten source och confidence_kind hör till kontraktet för det direkta REST-API:et V2.
Hur hanterar jag ett unknown-resultat?
Spara det som unknown och skilj det från en misslyckad körning. Granska tvetydiga indata och använd neutrala formuleringar i stället för att automatiskt tilldela ett kön.
Referensdokumentation
Guiden granskades senast . Kontrollera installationen i plattformens dokumentation och använd den länkade API-dokumentationen för en separat V2-integration.