Obohacení vybraných řádků Excelu z postranního panelu
Doplněk GenderAPI pro Excel vám umožní vybrat sloupec se jmény, e-maily nebo uživatelskými jmény a zapsat výsledky do namapovaných sloupců listu. Postranní panel použijte pro kontrolovaný rozsah řádků, samostatné funkce GENDER.FROM_* pro výpočty v jednotlivých buňkách.
Nativní klient pro Excel používá pole staršího API. Nevrací objekty data a meta z přímého REST V2 API; stávající mapování v sešitu proto udržujte v souladu se skutečným výstupem doplňku.
Nejprve nastavte malý rozsah řádků
- Nainstalujte GenderAPI z jeho záznamu v Microsoft AppSource a v sešitu otevřete postranní panel doplňku. Zkontrolujte oprávnění k přístupu k dokumentu a případná omezení vaší organizace.
- Uložte svůj klíč GenderAPI v doplňku a ověřte, že zamýšlený účet má kredity.
- Zvolte metodu name, email nebo username a odpovídající zdrojový sloupec. Nastavte malý rozsah od počátečního po koncový řádek bez řádku záhlaví.
- Namapujte cílový sloupec pro pohlaví a volitelné sloupce pro probability, zemi a nalezené jméno. Každý výstup držte odděleně od zdrojových dat.
- Kontext země nastavte jen tehdy, když je pro zpracovávaná data spolehlivý. Zkontrolujte zvolená nastavení a spusťte zkušební vzorek.
- Než rozsah rozšíříte, projděte řádky s výsledkem identified, neurčené i neúspěšné řádky. Uchovejte si kopii původních dat sešitu.
Výběr vstupu, kontextu a sloupců s výsledky
| Nastavení | Typ | Popis |
|---|---|---|
| API klíč | Přihlašovací údaj účtu | Ukládá se přes pole pro klíč v doplňku; nevkládejte ho do běžných buněk sešitu. |
| Metoda a zdroj | Volba a sloupec | name, email nebo username spolu s příslušným zdrojovým sloupcem. |
| Rozsah řádků | Čísla řádků | Začněte malým rozsahem bez řádku záhlaví. |
| Filtr země | Volitelná země nebo sloupec | Dodává známý kontext země; nejde o požadavek na ověřenou polohu osoby. |
| Sloupce s výsledky | Odkazy na sloupce | Cílový sloupec pro pohlaví a volitelné cílové sloupce pro probability, zemi a nalezené jméno. |
Jak číst výsledkové sloupce
Původní hodnotu ponechte vedle výsledku. Přiřazení na základě jména neurčuje pohlaví, které osoba sama uvedla, a vrácená země není ověřené bydliště ani státní příslušnost.
- 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.
Zvolte, jaká data sdílíte
Integrace s tabulkami přenášejí hodnoty potřebné k vyhledání a vyžadují oprávnění pracovat s vybraným dokumentem. Před zpracováním osobních údajů zkontrolujte přístup k sešitu, připojený účet a cílové sloupce.
API klíče ukládejte v nastavení doplňku, ne v běžných buňkách, na snímcích obrazovky ani ve sdílených ukázkách. Zveřejněné Zásady ochrany osobních údajů popisují zacházení se vstupy, uchovávání dat a protokoly. Integrace s tabulkou neznamená, že data zůstávají výhradně ve vašem zařízení.
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
Mohu v Excelu analyzovat e-maily a uživatelská jména?
Ano. V postranním panelu zvolte odpovídající metodu a namapujte příslušný vstupní sloupec. Než výsledek použijete, zkontrolujte vrácené jméno a neurčené výsledky.
Mám použít postranní panel, nebo vzorec?
Postranní panel použijte ke zpracování zvoleného rozsahu a zápisu hodnot do namapovaných sloupců. Vzorce GENDER.FROM_* zvolte, když chcete výpočty navázané na vstupní buňky a rozumíte tomu, jak funguje přepočet.
Znamená soubor functions_v2.js, že doplněk používá REST V2?
Ne. Jde o název souboru klienta pro Excel. Veřejný soubor se vzorci, který byl pro tento návod zkontrolován, volá endpointy staršího API a čte pole jeho odpovědí.
Jsou odhady ověřenými atributy zákazníka?
Ne. Odvozené výsledky držte odděleně od údajů, které zákazník sám uvedl, a pro neznámé nebo nejisté záznamy použijte neutrální náhradní hodnotu.
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.