# Przetwarzanie imion i adresów e-mail w Airtable z GenderAPI

> Skonfiguruj rozszerzenie Airtable i zmapuj płeć, kraj oraz prawdopodobieństwo. Zachowaj istniejące wartości, przejrzyj nierozstrzygnięte rekordy i odróżniaj V1 od V2.

Canonical HTML: https://www.genderapi.io/pl/blog/jak-okreslic-plec-na-podstawie-danych-z-airtable

Last reviewed: 2026-09-28

## Mapuj pola za pomocą rozszerzenia Airtable

Rozszerzenie GenderAPI odczytuje imię lub adres e-mail z wybranego pola i zapisuje prognozę płci w osobnym polu docelowym. Możesz też zmapować kraj, prawdopodobieństwo i znalezione imię, a następnie pomijać rekordy, w których pole docelowe płci zawiera już wartość.

Kod rozszerzenia przejrzany 27 września 2026 r. korzysta z endpointów V1 dla imion i adresów e-mail oraz z ich pól odpowiedzi najwyższego poziomu. Ten przewodnik opisuje ten natywny przepływ pracy. Zainstalowane rozszerzenie może zmieniać się niezależnie: sprawdź dostępne ustawienia, zanim zastosujesz poniższe mapowania.

- [GenderAPI.io w Airtable Marketplace](https://airtable.com/marketplace/blkqCasjQIqmmBrmb/gender-api-io-determine-gender)
- [Dokumentacja odpowiedzi V1](https://www.genderapi.io/pl/api-documentation/v1)

## Połącz bazę i przygotuj pola

- Otwórz właściwą bazę, dodaj GenderAPI.io z sekcji Extensions i uruchom je. Wykonaj kroki połączenia wyświetlane przez rozszerzenie.
- Wybierz klucz, z którego będą pobierane kredyty. Sprawdź jego pozostałe saldo i powiązane konto GenderAPI.
- Wybierz tabelę i pole źródłowe zawierające imiona lub adresy e-mail. Zachowaj oryginalne dane wejściowe w tym polu i utwórz osobne pola na wyniki.
- Wybierz wymagane pole docelowe płci oraz przydatne dodatkowe pola docelowe. Użyj pola percent dla sformatowanej wartości procentowej albo pola liczbowego, aby zachować oryginalną skalę prawdopodobieństwa.
- Zdecyduj, czy wypełnione już pola docelowe płci mają zostać zachowane. Opcja pomijania zachowuje również nierozstrzygnięte wartości tekstowe z wcześniejszego uruchomienia, dlatego usuwaj tylko te wyniki, które celowo chcesz przetworzyć ponownie.

## Mapuj dane wejściowe i wyjściowe rozszerzenia

| Ustawienie rozszerzenia | Wymagane | Wartość i działanie |
| --- | --- | --- |
| Klucz kredytów | Tak | Klucz wybranego konta GenderAPI dostarcza kredyty na przetworzone zapytania. |
| Tabela i pole źródłowe | Tak | Komórka źródłowa zawiera imię lub adres e-mail. Puste komórki źródłowe są pomijane. |
| Pole docelowe płci | Tak | Otrzymuje natywne pole gender. Przechowuj wartość nierozstrzygniętą oddzielnie od male i female. |
| Pole docelowe kraju | Nie | Otrzymuje zwróconą wartość country. To kolumna wyjściowa, a nie filtr kraju dla zapytania. |
| Pole docelowe prawdopodobieństwa | Nie | Otrzymuje wartość probability ze starszego API. Pole percent otrzymuje wartość podzieloną przez 100; pole liczbowe zachowuje oryginalną skalę. |
| Pole docelowe Found Name | Nie | Otrzymuje imię zwrócone przez natywne API, jeśli jest dostępne. Przechowuj tego wywnioskowanego kandydata oddzielnie od wartości źródłowej. |
| Pomijanie wypełnionych pól płci | Nie | Zachowuje rekordy, w których pole docelowe zawiera już wartość, w tym nierozstrzygnięty tekst. Sprawdź stan tej opcji przed każdym uruchomieniem. |

Pole źródłowe może zawierać zarówno imiona, jak i adresy e-mail. W przejrzanej implementacji wartość zawierająca @ trafia do ścieżki e-mail; ta reguła kierowania nie sprawdza, czy skrzynka pocztowa istnieje.

## Przetestuj małą partię przed przetworzeniem tabeli

Zacznij od małej tabeli testowej zawierającej imię, adres e-mail, pustą komórkę i niejednoznaczne dane wejściowe. Sprawdź wybrane pola docelowe i sposób, w jaki Airtable wyświetla skalę prawdopodobieństwa, zanim przetworzysz główną tabelę.

W przejrzanym kodzie domyślne wartości nierozstrzygnięte mogą pojawiać się jako tekst null i prawdopodobieństwo 0. Niektóre nieudane odpowiedzi natywne również mogą pozostawić te wartości domyślne, a błąd połączenia może pozostawić rekord bez zmian. Sprawdź stan uruchomienia i dotknięte wiersze: sam tekst null nie dowodzi, że wyszukiwanie zakończyło się powodzeniem.

Po uruchomieniu skontroluj istniejące wartości. Zachowaj nierozstrzygnięte wyniki do przeglądu, zamiast samodzielnie przypisywać płeć. Prognoza oparta na imieniu nie weryfikuje tożsamości płciowej osoby, a zwrócony kraj nie dowodzi miejsca zamieszkania.

| Co widzisz | Co zrobić |
| --- | --- |
| Oczekiwany wynik w zaplanowanych kolumnach | Zachowaj oryginalne dane wejściowe i pola dodatkowe, aby mapowanie pozostało możliwe do sprawdzenia. |
| Tekst null lub prawdopodobieństwo 0 | Pozostaw przypadek jako nierozstrzygnięty i sprawdź stan przetwarzania, zanim zdecydujesz o ponownym wyszukiwaniu. |
| Wcześniej wypełnione pole docelowe pozostało bez zmian | Sprawdź opcję pomijania; takie zachowanie wartości może być zamierzone. |
| Komunikat o kluczu lub kredytach albo wynik bez zmian po błędzie | Rozwiąż problem z kontem lub połączeniem i zidentyfikuj dotknięte rekordy przed ponownym uruchomieniem. |

## Kontroluj zużyte kredyty i ponowne uruchomienia

Natywne rozszerzenie wysyła zapytania o wartości pojedynczo, używając wybranego klucza GenderAPI. Ponowne uruchomienie dla tych samych niepominiętych rekordów może wysłać nowe zapytania i ponownie zużyć kredyty. Plan Airtable i dostępność rozszerzeń są niezależne od tego salda konta.

Natywne dane wyjściowe nie udostępniają odpowiedzi data/meta z V2, jawnego wyboru trybu AI, obiektu usage dla każdego elementu ani kontraktu partii V2. Dla tego przepływu pracy korzystaj z dokumentacji V1, a gdy potrzebujesz tych ustawień, z osobnej opcji API opisanej poniżej.

Rozszerzenie wysyła zmapowane wartości do przetworzenia i zapisuje wyniki z powrotem w Twojej bazie. Zapoznaj się z opublikowaną polityką przetwarzania danych i uprawnieniami rozszerzenia dla odpowiednich rekordów; nie uwzględniaj w mapowaniu źródłowym niepowiązanych pól.

- [Plany i kredyty](https://www.genderapi.io/pl/price)
- [Polityka przetwarzania danych](https://www.genderapi.io/pl/privacy-policy)

## Użyj V2, gdy potrzebujesz ustrukturyzowanej odpowiedzi

W przypadku niestandardowej integracji GenderAPI V2 przyjmuje imiona, adresy e-mail i nazwy użytkowników oraz zwraca jawne pola wyniku, pewności, źródła i zużycia. Skonfiguruj to połączenie osobno: zapoznanie się z przewodnikiem V2 nie zmienia zainstalowanej aplikacji ani jej kolumn wyjściowych.

Przykłady w Pythonie i Node.js obejmują pojedyncze zapytania, partie, wyniki unknown i błędy operacyjne. Zacznij od przewodnika po uwierzytelnianiu i wybierz tryb AI przed wysłaniem płatnego zapytania.

- [Uwierzytelnianie V2](https://www.genderapi.io/pl/docs/v2/authentication)
- [Pola odpowiedzi V2](https://www.genderapi.io/pl/docs/v2/responses)
- [Przykład integracji w Pythonie](https://www.genderapi.io/pl/integrations/python)
- [Przykład integracji w Node.js](https://www.genderapi.io/pl/integrations/javascript)

## Czy rozszerzenie Airtable korzysta z GenderAPI V2?

Kod rozszerzenia przejrzany 27 września 2026 r. korzysta z endpointów V1 dla imion i adresów e-mail. Niestandardowe połączenie V2 ma inne pola zapytania i odpowiedzi; nie aktualizuje ono zainstalowanego rozszerzenia.

## Czy jedno pole źródłowe może zawierać zarówno imiona, jak i adresy e-mail?

Tak. Przejrzane rozszerzenie kieruje niepuste wartości zawierające @ do wyszukiwania według adresu e-mail, a pozostałe do wyszukiwania według imienia. Jest to kierowanie danych wejściowych, a nie weryfikacja skrzynki pocztowej.

## Dlaczego prawdopodobieństwo wygląda inaczej w polu procentowym?

Rozszerzenie dzieli wartość probability ze starszego API przez 100 dla pola percent w Airtable, aby Airtable mogło wyświetlić ją jako wartość procentową. Pole liczbowe zachowuje oryginalną skalę; nie jest to pole confidence z V2.

## Czy opcja pomijania zachowuje nierozstrzygnięte wyniki?

Tak, jeśli pole docelowe zawiera już wartość, w tym tekst null z wcześniejszego uruchomienia. Przejrzyj te rekordy i usuwaj tylko te wartości, które celowo chcesz przetworzyć ponownie.

## Dokumentacja źródłowa

- [Oficjalna karta w katalogu: Airtable](https://airtable.com/marketplace/blkqCasjQIqmmBrmb/gender-api-io-determine-gender)
- [Dokumentacja GenderAPI V1](https://www.genderapi.io/pl/api-documentation/v1)
- [Dokumentacja osobnego API V2](https://www.genderapi.io/pl/api-documentation)