Použijte rozšíření k mapování polí v aplikaci Airtable
Rozšíření GenderAPI načte jméno nebo e-mailovou adresu z pole, které zvolíte, a zapíše odhadnutý signál pohlaví do samostatného cílového pole. Namapovat můžete také zemi, hodnotu probability a nalezené jméno a přeskočit záznamy, jejichž cílové pole pro pohlaví už obsahuje hodnotu.
Zdrojový kód rozšíření, zkontrolovaný 27. září 2026, používá starší endpointy V1 pro jména a e-mailové adresy a jejich pole odpovědi na nejvyšší úrovni. Tento průvodce popisuje nativní workflow rozšíření. Nainstalované rozšíření se může měnit nezávisle na tomto průvodci, proto si před použitím níže uvedeného mapování ověřte, jaká nastavení jsou k dispozici.
Připojte bázi a připravte pole
- Otevřete požadovanou bázi v aplikaci Airtable, přidejte GenderAPI.io z nabídky "Extensions" a rozšíření spusťte. Dokončete kroky připojení, které rozšíření zobrazí.
- Zvolte API klíč s kredity, který má operace použít. Zkontrolujte jeho zbývající zůstatek a ujistěte se, že klíč patří ke správnému účtu GenderAPI.
- Vyberte tabulku a zdrojové pole se jmény nebo e-mailovými adresami. Původní vstup v tomto poli ponechte a pro výsledky vytvořte samostatná pole.
- Vyberte povinné cílové pole pro pohlaví a případná volitelná doplňková pole. Pro formátované procentní hodnoty použijte pole typu Percent, pro zachování původní škály probability pole typu Number.
- Rozhodněte, zda se mají zachovat již vyplněná cílová pole pro pohlaví. Když zapnete přeskakování, zachovají se i nevyřešené textové hodnoty z dřívějších běhů, proto vymažte jen ty výsledky, které chcete záměrně zpracovat znovu.
Namapujte vstupy a výstupy rozšíření
Zdrojové pole může obsahovat jména i e-mailové adresy. V prozkoumané implementaci se hodnota obsahující @ zpracuje jako e-mail; toto pravidlo směrování neověřuje, že poštovní schránka existuje.
| Nastavení rozšíření | Povinné | Hodnota a chování |
|---|---|---|
| API klíč s kredity | Ano | Klíč zvoleného účtu GenderAPI poskytuje kredity pro zpracované požadavky. |
| Tabulka a zdrojové pole | Ano | Zdrojová buňka obsahuje jméno nebo e-mailovou adresu. Prázdné zdrojové buňky se přeskočí. |
| Cílové pole pro pohlaví | Ano | Přijímá nativní pole gender. Nevyřešenou hodnotu držte odděleně od hodnot male a female. |
| Cílové pole pro zemi | Ne | Přijímá vrácenou hodnotu country. Jde o výstupní sloupec, nikoli o filtr země pro požadavek. |
| Cílové pole pro probability | Ne | Přijímá hodnotu probability ze staršího API. Pole typu Percent dostane hodnotu vydělenou 100; pole typu Number zachová původní škálu. |
| Cílové pole pro Found Name | Ne | Přijímá jméno, které nativní API vrátí, pokud je k dispozici. Tohoto odvozeného kandidáta držte odděleně od zdrojové hodnoty. |
| Přeskočit vyplněná pole pohlaví | Ne | Zachová záznamy, jejichž cílové pole už obsahuje hodnotu, včetně nevyřešeného textu. Před každým během zkontrolujte, jak je volba nastavena. |
Před zpracováním celé tabulky vyzkoušejte malý běh
Začněte malou testovací tabulkou se jménem, e-mailovou adresou, prázdnou buňkou a nejednoznačným vstupem. Před zpracováním hlavní tabulky ověřte zvolená cílová pole a to, jak Airtable zobrazuje škálu probability.
Ve zkontrolovaném kódu rozšíření se výchozí hodnoty nevyřešených výsledků mohou zobrazit jako text null a probability 0. Tyto výchozí hodnoty mohou zůstat i po některých neúspěšných odpovědích nativního API, zatímco selhání připojení může záznam ponechat beze změny. Zkontrolujte stav běhu a dotčené řádky; samotný text null nedokazuje, že vyhledání proběhlo úspěšně.
Po běhu zkontrolujte stávající hodnoty. Nevyřešené výsledky ponechte ke kontrole, místo abyste pohlaví přiřadili sami. Odhad podle jména neověřuje genderovou identitu osoby a vrácená země není důkazem bydliště.
| Co vidíte | Co udělat |
|---|---|
| Očekávaný výsledek v zamýšlených sloupcích | Ponechte původní vstup a případná doplňková pole, aby šlo mapování později zpětně ověřit. |
| Text null nebo probability 0 | Výsledek ponechte nevyřešený a před rozhodnutím, zda je vhodné nové vyhledání, zkontrolujte stav operace. |
| Dříve vyplněné cílové pole zůstalo beze změny | Zkontrolujte nastavení přeskakování; může jít o záměrné zachování hodnoty. |
| Zpráva o klíči nebo kreditech, případně nezměněný výsledek po chybě | Vyřešte problém s účtem nebo připojením a před novým spuštěním určete dotčené záznamy. |
Mějte pod kontrolou čerpání kreditů a opakované běhy
Nativní rozšíření vyhledává hodnoty jednotlivě pomocí zvoleného klíče GenderAPI. Nový běh nad stejnými záznamy, které se nepřeskakují, může odeslat nové požadavky a znovu spotřebovat kredity. Vlastní tarif aplikace Airtable a dostupnost rozšíření jsou na zůstatku účtu nezávislé.
Nativní výstup nezpřístupňuje data/meta z odpovědi V2, výslovnou volbu režimu AI, objekt usage pro jednotlivé položky ani specifikaci dávkových požadavků V2. Pro toto workflow použijte starší referenční přehled V1 a pro tato nastavení samostatnou možnost API níže.
Rozšíření odesílá namapované hodnoty ke zpracování a výsledky zapisuje zpět do vaší báze. U záznamů, které chcete zpracovat, si projděte zveřejněné zásady nakládání s daty a oprávnění rozšíření a do zdrojového mapování nezahrnujte nesouvisející pole.
Použijte V2, když potřebujete strukturovanou odpověď
Pro vlastní integraci přijímá GenderAPI V2 jména, e-mailové adresy a uživatelská jména a vrací výslovná pole pro výsledek, spolehlivost, zdroj a čerpání kreditů. Toto připojení nastavte samostatně: přečtení průvodce V2 nezmění nainstalovanou aplikaci ani sloupce, do kterých zapisuje.
Příklady v Pythonu a Node.js pokrývají jednotlivé požadavky, dávkové požadavky, neznámé výsledky a provozní chyby. Začněte průvodcem autentizací a před odesláním požadavku, který se účtuje, zvolte režim AI.
Časté otázky
Používá rozšíření pro Airtable GenderAPI V2?
Zdrojový kód rozšíření, zkontrolovaný 27. září 2026, používá starší endpointy V1 pro jména a e-mailové adresy. Samostatně vytvořené vlastní připojení k V2 má jiná pole požadavku a odpovědi a nainstalované rozšíření neaktualizuje.
Může jedno zdrojové pole obsahovat jména i e-mailové adresy?
Ano. Prozkoumané rozšíření posílá neprázdné hodnoty obsahující @ do vyhledávání podle e-mailu a ostatní hodnoty do vyhledávání podle jména. Jde o směrování vstupu, nikoli o ověření poštovní schránky.
Proč hodnota probability vypadá v poli typu Percent jinak?
Rozšíření vydělí hodnotu probability ze staršího API číslem 100 pro pole typu Percent v aplikaci Airtable, aby ji Airtable mohl zobrazit jako procenta. Cílové pole typu Number zachová původní škálu; nejde o pole confidence z V2.
Zachová volba přeskakování nevyřešené výsledky?
Ano, pokud cílové pole už obsahuje hodnotu. To platí i pro text null z dřívějšího běhu. Tyto záznamy zkontrolujte a vymažte jen hodnoty, které chcete záměrně zpracovat znovu.
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.