# Określanie płci w Google Sheets za pomocą dodatku GenderAPI

> Zainstaluj dodatek, zmapuj kolumny i przetwórz wybrany zakres wierszy. Sprawdź wyniki unknown, kredyty i różnice względem API V2.

Canonical HTML: https://www.genderapi.io/pl/blog/jak-okreslic-plec-w-google-sheets-za-pomoca-gender-api-add-on

Last reviewed: 2026-09-28

## Przetwarzaj wybrane wiersze z panelu bocznego

Dodatek GenderAPI for Google Sheets odczytuje kolumnę z imionami, adresami e-mail lub nazwami użytkowników i zapisuje wybrane pola wyniku w arkuszu. Panel boczny pozwala przetworzyć określony zakres i zapisać wartości bez pozostawiania formuły w każdej komórce.

To natywny przepływ dodatku. Jego kolumny wyników i przetwarzanie zbiorcze są niezależne od publicznego formatu odpowiedzi REST V2.

- [Zainstaluj z Google Workspace Marketplace](https://workspace.google.com/marketplace/app/gender_api_for_google_sheets_determines/712811575775)
- [Użyj zamiast tego formuły GENDER](https://www.genderapi.io/pl/blog/formula-plec-google-sheets-wykryj-plec-na-podstawie-imion)
- [Skonfiguruj przepływ pracy dla nowych wierszy](https://www.genderapi.io/pl/blog/jak-ustali%C4%87-p%C5%82e%C4%87-klient%C3%B3w-w-google-sheets-w-czasie-rzeczywistym)

## Zainstaluj, połącz i przetestuj małą próbkę

- Zainstaluj dodatek z jego karty w Google Workspace Marketplace i sprawdź, o jakie uprawnienia prosi. W Google Sheets otwórz Extensions → GenderAPI → Determine Gender.
- Wybierz klucz GenderAPI lub wpisz go w panelu bocznym. Sprawdź, czy wybrane konto ma dostępne kredyty.
- Wybierz arkusz i metodę name, email lub username. Wskaż odpowiednią kolumnę źródłową i mały zakres wierszy bez nagłówka.
- Wybierz osobną kolumnę na płeć oraz, w razie potrzeby, kolumny na prawdopodobieństwo, kraj i znalezione imię. Nie nadpisuj oryginalnych wartości.
- Jeśli masz wiarygodny kontekst kraju, użyj ustawienia kraju lub kolumny z kodami krajów. Nie wyprowadzaj tego kontekstu z prognozy, o którą zamierzasz zapytać.
- Sprawdź opcję pomijania istniejących wyników, uruchom przetwarzanie i zweryfikuj wybrane wiersze, zanim rozszerzysz zakres.

## Zmapuj dane wejściowe i miejsca docelowe

| Ustawienie | Typ | Wybór i opis |
| --- | --- | --- |
| Klucz API | Identyfikator konta | Użyj klucza wybranego w dodatku; sprawdź jego ważność i saldo. |
| Metoda | Wybór | name, email lub username, zależnie od kolumny źródłowej. |
| Arkusz i zakres wierszy | Arkusz i numery wierszy | Zaznacz tylko wiersze do przetworzenia i pomiń wiersz nagłówka. |
| Kolumna źródłowa | Odwołanie do kolumny | Jedyna kolumna wejściowa dla wybranej metody. |
| Kontekst kraju | Opcjonalne ustawienie lub kolumna | Używaj wiarygodnych dwuliterowych kodów krajów, jeśli je masz. |
| Kolumny wyników | Odwołania do kolumn | Płeć jest głównym miejscem docelowym; prawdopodobieństwo, kraj i znalezione imię są opcjonalne. |
| Pomijanie istniejących wyników | Pole wyboru | Sprawdź to ustawienie, aby ponowne uruchomienie nie zastąpiło przypadkiem już uzupełnionych wierszy. |

## Odczytaj kolumny wyników

Przechowuj oryginalną wartość obok wyniku. Powiązanie oparte na imieniu nie ustala płci zadeklarowanej przez daną osobę, a zwrócony kraj nie potwierdza jej miejsca zamieszkania ani obywatelstwa.

- Zanim przetworzysz cały zbiór danych, sprawdź zwykły wynik, niejednoznaczne dane wejściowe i nieudaną operację.
- Pusta komórka, tekst null i błąd formuły to różne wartości. Normalizuj wyniki unknown świadomie, nie ukrywając błędów.
- W przypadkach unknown lub niepewnych używaj neutralnych sformułowań, a informacje podane przez samą osobę przechowuj osobno od prognoz.

| Wynik | Typ | Jak z niego korzystać |
| --- | --- | --- |
| Gender | Tekst lub nierozstrzygnięta wartość | Zachowuj male lub female tylko dla udanego wyniku. Nierozstrzygniętą wartość zachowaj jako unknown, a komunikaty o błędach sprawdzaj osobno. |
| Probability | Liczba, jeśli jest dostępna | Historyczny wskaźnik pewności; nie odpowiada polu confidence z V2 ani zmierzonej dokładności na Twoich danych. |
| Country | Tekst, jeśli jest dostępny | Kontekst zwrócony przez wyszukiwanie. Przechowuj go osobno od zweryfikowanego kraju klienta. |
| Found / normalized name | Tekst, jeśli jest dostępny | Imię użyte lub wyodrębnione podczas przetwarzania. Sprawdź je, gdy adres e-mail lub nazwa użytkownika są niejednoznaczne. |

- [Wskaźniki pewności i ograniczenia](https://www.genderapi.io/pl/accuracy-methodology)

## Zaplanuj kredyty, limity i ponowne uruchomienia

Zarejestrowane bezpłatne konto GenderAPI obejmuje 200 kredytów dziennie. To saldo konta, a nie obietnica 200 zidentyfikowanych wyników w każdym przepływie pracy. Przed rozpoczęciem sprawdź saldo wybranego klucza i aktualne opcje przetwarzania narzędzia.

Natywne dodatki i przetwarzanie plików mają własne ścieżki przetwarzania. Limit partii REST V2, opcje AI i pola rozliczeniowe poszczególnych zapytań nie mają do nich automatycznie zastosowania. Ponowne uruchomienie lub przeliczenie może wysłać nowe zapytania i zużyć kredyty: nie zakładaj, że jest bezpłatne.

Zacznij od małej próbki, zachowaj uzyskane wyniki i przed ponownym uruchomieniem przejrzyj nieudane wiersze. Jeśli musisz tylko poprawić eksport lub aktualizację w miejscu docelowym, użyj ponownie wyników, które już masz.

- [Plany i kredyty konta](https://www.genderapi.io/pl/price)

## Wybierz dane, które udostępniasz

Integracje z arkuszami kalkulacyjnymi przesyłają wartości potrzebne do wyszukiwania i wymagają uprawnień do pracy z wybranym dokumentem. Przed przetwarzaniem danych osobowych sprawdź, kto ma dostęp do skoroszytu, jakie konto jest połączone i jakie są kolumny docelowe.

Przechowuj klucz API w ustawieniach dodatku, a nie w zwykłych komórkach, na zrzutach ekranu czy w udostępnianych przykładach. Opublikowana polityka prywatności opisuje przetwarzanie danych wejściowych, ich przechowywanie i logi; integracja z arkuszem kalkulacyjnym nie oznacza, że dane pozostają wyłącznie na Twoim urządzeniu.

- [Polityka prywatności GenderAPI](https://www.genderapi.io/pl/privacy-policy)

## Kiedy korzystać bezpośrednio z API V2

Skonfiguruj osobną integrację HTTP, gdy Twoja aplikacja potrzebuje jawnych opcji AI oraz, dla każdego elementu, informacji status, source, confidence_kind i usage z V2. Stosuj kontrakt zapytań i odpowiedzi V2: dodanie nazw pól V2 do natywnej formuły lub istniejącego dodatku nie zmienia ich działania.

- [Parametry zapytania V2](https://www.genderapi.io/pl/docs/v2/request-parameters)
- [Pola odpowiedzi V2](https://www.genderapi.io/pl/docs/v2/responses)
- [Integracja V2 z Pythonem](https://www.genderapi.io/pl/integrations/python)
- [Integracja V2 z Node.js](https://www.genderapi.io/pl/integrations/javascript)

## Czy muszę pisać kod, aby korzystać z panelu bocznego?

Nie. Zainstaluj dodatek, połącz klucz i zmapuj kolumnę źródłową oraz kolumny wyników. Bezpośrednia integracja z API V2 to osobna opcja dla aplikacji tworzonych na zamówienie.

## Czy mogę przetworzyć istniejące wiersze?

Tak. Użyj ustawień arkusza i zakresu wierszy w panelu bocznym. Przed uruchomieniem przetwarzania sprawdź nagłówek, typ danych wejściowych, kolumny docelowe i opcję dotyczącą istniejących wyników.

## Czy kolumny wyników odpowiadają odpowiedzi JSON V2?

Nie. Natywne przetwarzanie zapisuje w arkuszu obsługiwane pola. Obiekty data i meta oraz pola source i confidence_kind należą do kontraktu bezpośredniego API REST V2.

## Co zrobić z wynikiem unknown?

Zachowaj go jako unknown i odróżniaj od nieudanej operacji. Sprawdzaj niejednoznaczne dane wejściowe i używaj neutralnych sformułowań zamiast automatycznie przypisywać płeć.

## Dokumentacja źródłowa

- [Oficjalna karta dodatku Google Sheets](https://workspace.google.com/marketplace/app/gender_api_for_google_sheets_determines/712811575775)
- [Plany i kredyty GenderAPI](https://www.genderapi.io/pl/price)
- [Polityka prywatności GenderAPI](https://www.genderapi.io/pl/privacy-policy)
- [Kontrakt zapytań V2](https://www.genderapi.io/pl/docs/v2/request-parameters)