Starta en filbearbetning i kontots dashboard
GenderAPI:s filverktyg läser in ett kalkylark, låter dig mappa en kolumn med namn, e-postadresser eller användarnamn och skapar en berikad CSV-export. Använd det för filbaserad bearbetning när du inte behöver bygga en API-integration.
Det här arbetsflödet i kontots dashboard är skilt från batchförfrågningar via REST V2. En fil är inte en V2-JSON-förfrågan: gränser per post och svarsvägar i V2 gäller inte för den här inbyggda bearbetningen.
Använd ett format som filväljaren accepterar
Den aktuella filväljaren accepterar en fil i taget. Välj rätt kalkylblad i en arbetsbok med flera kalkylblad och granska de inlästa värdena. Om filen har ett annat format exporterar du den till något av de listade formaten innan du startar.
Bearbetningen beror på filens komplexitet, antalet rader, vald metod, kontots krediter och tjänstens belastning. Testa med en representativ fil; den här guiden utlovar varken en fast maximal storlek eller en fast bearbetningstid.
| Format | Accepterad filändelse |
|---|---|
| CSV | .csv |
| Excel | .xls, .xlsx |
| Apple Numbers | .numbers |
| OpenDocument | .ods |
| Tabbavgränsade värden | .tsv |
| Text | .txt |
Granska förslagen innan bearbetningen startar
- Skapa en kopia som endast innehåller de data som behövs. Placera indata i en tydligt namngiven kolumn och eventuella tillförlitliga landskoder med två bokstäver i en egen kolumn.
- Logga in, öppna Excel- och CSV-verktyget, välj rätt nyckel och därefter fil och kalkylblad.
- När kalkylbladet konfigureras kan verktyget skicka exempelceller för att föreslå kolumner med hjälp av AI. Kontrollera själv den föreslagna indatatypen och kolumnerna innan du fortsätter.
- Välj analys av namn, e-postadresser eller användarnamn, bekräfta källkolumnen och den valfria landsmappningen och granska sedan de AI- och exportalternativ som verktyget visar.
- Starta bearbetningen och följ förloppet. Ladda inte upp samma fil flera gånger bara för att bearbetningen ännu inte är klar.
- När exporten är klar laddar du ned CSV-filen, kontrollerar att raderna stämmer överens och granskar identifierade, unknown och misslyckade poster. Spara källfilen för jämförelse.
Kontrollera inställningarna för filbearbetningen
| Inställning | Typ | Beskrivning |
|---|---|---|
| API-nyckel | Kontouppgift | Det konto vars saldo används för den här bearbetningen. |
| Fil och kalkylblad | Filval | En accepterad fil och rätt kalkylblad. |
| Metod | Val | name, email eller username. Granska det automatiskt föreslagna värdet. |
| Källkolumn | Kolumnmappning | Indata som ska analyseras på varje rad; kontrollera rubrikraden och exempelvärdena. |
| Landskontext | Valfri kolumn eller inställning | Kända landskoder med två bokstäver, när det är relevant. |
| AI- och exportalternativ | Verktygets aktuella kontroller | Granska de visade inställningarna före bearbetningen; det är inte ai_mode-parametrar från V2. |
Läs resultatkolumnerna
Den exporterade CSV-filen lägger till de inbyggda resultatfälten gender, country, probability och found_name. Kontrollera att raderna stämmer med originalet och granska kolumnrubrikerna innan du importerar filen till ett annat system. Resultatet levereras i CSV-format även om indata var en Excel-arbetsbok.
Prediktioner är uppskattade samband. Håll dem åtskilda från personens självangivna kön och från verifierade landsuppgifter.
- 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.
Ta hänsyn till föranalys och lagring av filen
Valet av kalkylblad kan skicka exempelceller för AI-stödd kolumnmappning innan det sista bearbetningssteget börjar. Utgå inte från att alla data stannar på din enhet tills bearbetningen startar. Ta bort kolumner som inte behövs och läs integritetspolicyn innan du väljer en fil med personuppgifter.
Använd den tillgängliga raderingsåtgärden efter exporten när kopian i arbetsytan inte längre behövs. Den publicerade policyn beskriver planerad radering från aktiva system och lagring i säkerhetskopior; ett raderingsschema visar inte att alla kopior redan har raderats.
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
Accepterar verktyget XLSM-filer?
Den aktuella filväljaren listar CSV, XLS, XLSX, Numbers, ODS, TSV och TXT. Exportera en XLSM-arbetsbok till något av dessa format och granska de resulterande värdena innan du laddar upp den.
Är kolumnförslagen alltid korrekta?
Nej. Granska indatatypen, hanteringen av rubrikraden, källkolumnen och landsmappningen. Under konfigurationen kan exempeldata skickas för att ta fram AI-stödda förslag.
Får jag tillbaka den ursprungliga Excel-arbetsboken?
Den dokumenterade bearbetningen exporterar resultaten i CSV-format. Kontrollera de exporterade kolumnerna och att raderna stämmer överens innan du för över dem till den ursprungliga arbetsboken eller ett annat verktyg.
Motsvarar detta en batchförfrågan i V2?
Nej. Det är en filbearbetning i kontots dashboard med egna alternativ och ett eget flöde. Använd V2-dokumentationen för batchar när du skapar JSON-förfrågningar i din egen integration.
Referensdokumentation
Guiden granskades senast . Kontrollera installationen i plattformens dokumentation och använd den länkade API-dokumentationen för en separat V2-integration.