Spuštění souborové úlohy z ovládacího panelu účtu
Souborový nástroj GenderAPI načte tabulku, umožní vám namapovat sloupec se jmény, e-maily nebo uživatelskými jmény a připraví obohacený výstup ve formátu CSV. Použijte ho pro úlohu nad souborem, když nepotřebujete budovat integraci s API.
Workflow pro soubory na nástěnce je oddělené od dávkových požadavků REST V2. Samotný soubor není požadavek JSON pro V2 a limity na položku ani cesty v odpovědi z V2 se na tuto nativní úlohu nevztahují.
Použijte formát, který nahrávací prvek přijímá
Současný nahrávací prvek vybírá 1 soubor najednou. U sešitu s více listy zvolte zamýšlený list a zkontrolujte načtené hodnoty. Pokud nahrávací prvek váš formát nepřijímá, vyexportujte soubor před zahájením do některého z uvedených formátů.
Zpracování ovlivňuje složitost souboru, počet řádků, zvolená metoda, kredity účtu a zatížení služby. Vyzkoušejte reprezentativní soubor; tento návod neslibuje pevnou maximální velikost ani pevnou dobu zpracování.
| Formát | Přijímaná přípona |
|---|---|
| CSV | .csv |
| Excel | .xls, .xlsx |
| Apple Numbers | .numbers |
| OpenDocument | .ods |
| Hodnoty oddělené tabulátorem | .tsv |
| Text | .txt |
Před spuštěním úlohy zkontrolujte návrhy
- Připravte si kopii s daty, která úloha potřebuje. Vstupní údaje mějte v jasně označeném sloupci a případné spolehlivé dvoupísmenné kódy zemí v samostatném sloupci.
- Přihlaste se, otevřete nástroj Excel/CSV, vyberte zamýšlený klíč a poté soubor a list.
- Během nastavení listu může nástroj odeslat vzorové buňky pro návrhy sloupců s pomocí AI. Navržený typ vstupu a sloupce sami zkontrolujte, než budete pokračovat.
- Zvolte analýzu jmen, e-mailů nebo uživatelských jmen, potvrďte zdrojový sloupec a volitelné mapování země a zkontrolujte aktuální možnosti AI a exportu, které nástroj zobrazuje.
- Spusťte zpracování a sledujte průběh. Neodesílejte stejný soubor opakovaně jen proto, že úloha ještě není dokončená.
- Až bude export připravený, stáhněte soubor CSV, zkontrolujte, zda řádky odpovídají originálu, a projděte záznamy s výsledkem identified, neznámé i neúspěšné záznamy. Zdrojový soubor si ponechte pro porovnání.
Zkontrolujte nastavení souborové úlohy
| Nastavení | Typ | Popis |
|---|---|---|
| API klíč | Přihlašovací údaj účtu | Účet, z jehož zůstatku bude zvolená úloha čerpat. |
| Soubor a list | Výběr souboru | Zvolte jeden přijímaný soubor a zamýšlený list. |
| Metoda | Volba | name, email nebo username. Zkontrolujte automaticky navržené hodnoty. |
| Zdrojový sloupec | Mapování sloupce | Vstup, který se má v každém řádku analyzovat; zkontrolujte záhlaví a vzorové hodnoty. |
| Kontext země | Volitelný sloupec nebo nastavení | Pokud je to relevantní, použijte známé dvoupísmenné kódy zemí. |
| Možnosti AI a exportu | Aktuální ovládací prvky nástroje | Před zpracováním zkontrolujte zobrazená nastavení; nejde o parametry ai_mode z V2. |
Jak číst výsledkové sloupce
Exportovaný soubor CSV přidává nativní pole výsledků gender, country, probability a found_name. Před importem do jiného systému ověřte, že řádky odpovídají originálu, a zkontrolujte záhlaví sloupců. Výstupním formátem je CSV i tehdy, když byl vstupem sešit Excelu.
Odhady jsou odvozená přiřazení. Držte je odděleně od pohlaví, které osoba sama uvedla, a od ověřených údajů o zemi.
- Než zpracujete celou datovou sadu, prohlédněte si běžný výsledek, nejednoznačný vstup a neúspěšnou operaci.
- Prázdná buňka, text null a chyba vzorce jsou v tabulce různé hodnoty. Výsledky unknown normalizujte záměrně a chyby přitom neskrývejte.
- Pro neznámé nebo nejisté záznamy použijte neutrální záložní řešení. Údaje z profilu, které osoba sama uvedla, držte odděleně od odvozených sloupců.
| Výstup | Typický typ | Jak s ním pracovat |
|---|---|---|
| Gender | Text nebo nevyřešená hodnota | Hodnotu male nebo female ponechte jen u úspěšného výsledku. Nevyřešenou hodnotu zachovejte jako unknown a chybové texty kontrolujte zvlášť. |
| Probability | Číslo, pokud je k dispozici | Starší signál spolehlivosti. Nejde o pole confidence z V2 ani o naměřenou přesnost pro vaši datovou sadu. |
| Country | Text, pokud je k dispozici | Kontext vrácený vyhledáním. Uchovávejte ho odděleně od ověřené země zákazníka. |
| Found / normalized name | Text, pokud je k dispozici | Jméno použité nebo extrahované při zpracování. U nejednoznačných e-mailových adres a uživatelských jmen ho zkontrolujte. |
Naplánujte kredity, limity a opakovaná spuštění
Registrovaný bezplatný účet GenderAPI zahrnuje 200 kreditů za den. Kredity představují zůstatek účtu, nikoli příslib 200 úspěšných výsledků v každém workflow. Před spuštěním zkontrolujte zůstatek vybraného klíče a aktuální možnosti zpracování daného nástroje.
Nativní doplňky a souborové úlohy mají vlastní způsob zpracování. Limit dávkových požadavků v REST API V2, možnosti AI a pole účtování jednotlivých požadavků se na ně automaticky nevztahují. Opakované spuštění nebo přepočet může odeslat data ke zpracování znovu, proto nepředpokládejte, že je zdarma.
Začněte malým vzorkem, dokončené výsledky si ponechte a před opětovným spuštěním projděte neúspěšné řádky. Pokud potřebujete jen opravit pozdější export nebo aktualizaci v cílové aplikaci, použijte znovu výsledky, které už máte.
Počítejte s analýzou při nastavení a s uchováváním souborů
Při výběru listu se mohou vzorové buňky odeslat k mapování sloupců s pomocí AI ještě před posledním krokem zpracování. Nepředpokládejte, že všechna data zůstanou lokálně, dokud nestisknete Start. Odstraňte nepotřebné sloupce a před výběrem souboru s osobními údaji si přečtěte Zásady ochrany osobních údajů.
Po exportu použijte dostupnou akci smazání, jakmile kopii v pracovním prostoru už nepotřebujete. Zveřejněné zásady popisují plánované odstranění z aktivních systémů a uchovávání v zálohách; plán mazání není důkazem, že všechny kopie již byly odstraněny.
Kdy použít přímo API V2
Samostatnou integraci přes HTTP použijte, když vaše aplikace potřebuje explicitní možnosti AI a z V2 informace status, source, confidence_kind a usage pro každou položku. Řiďte se specifikací požadavku a odpovědi V2. Přidání názvů polí V2 do nativního vzorce nebo stávajícího doplňku chování tohoto klienta nezmění.
Časté otázky
Přijímá nahrávání soubory XLSM?
Současný nahrávací prvek uvádí CSV, XLS, XLSX, Numbers, ODS, TSV a TXT. Sešit XLSM vyexportujte do některého z těchto formátů a před nahráním zkontrolujte výsledné hodnoty.
Jsou návrhy sloupců vždy správné?
Ne. Zkontrolujte navržený typ vstupu, zacházení s řádkem záhlaví, zdrojový sloupec a mapování země. Během nastavení se mohou vzorová data odeslat pro návrhy s pomocí AI.
Dostanu zpět původní sešit Excelu?
Dokumentovaná souborová úloha exportuje výsledky do CSV. Před importem do původního sešitu nebo jiného nástroje zkontrolujte exportované sloupce a to, zda řádky odpovídají originálu.
Je to totéž jako dávkový požadavek V2?
Ne. Jde o souborovou úlohu na nástěnce s vlastními možnostmi a vlastním zpracováním. Když sestavujete požadavky JSON ve vlastní integraci, použijte dokumentaci V2 k dávkovým požadavkům.
Zdroje a dokumentace
Průvodce byl naposledy zkontrolován . Instalaci ověřte v dokumentaci platformy a pro samostatnou integraci V2 použijte níže uvedenou dokumentaci API.