# Konfiguracja przepływu GenderAPI dla nowych wierszy w Google Sheets

> Skonfiguruj natywny przepływ pracy, zmapuj kolumny i przetestuj rzeczywiste źródło nowych wierszy. Obsłuż wyniki unknown i brakujące aktualizacje.

Canonical HTML: https://www.genderapi.io/pl/blog/jak-ustali%C4%87-p%C5%82e%C4%87-klient%C3%B3w-w-google-sheets-w-czasie-rzeczywistym

Last reviewed: 2026-09-28

## Mapuj nowe rekordy na kolumny wyników

Dodatek GenderAPI oferuje ekran Workflows, który mapuje nowe rekordy arkusza na kolumnę płci i inne opcjonalne kolumny wyników. Skonfiguruj go dla właściwego arkusza, a następnie sprawdź rzeczywiście przychodzący rekord, zanim zaczniesz polegać na automatyzacji.

Natywny przepływ pracy jest oddzielony od bezpośredniej akcji HTTP V2. Jego wyzwalanie, opóźnienie i pola wyjściowe zależą od zainstalowanego dodatku i konta Google; natychmiastowa aktualizacja nie jest gwarantowana dla każdego źródła nowych wierszy.

## Utwórz i przetestuj przepływ pracy

- Zainstaluj i otwórz dodatek GenderAPI, a następnie otwórz Workflows z menu panelu bocznego.
- Wybierz arkusz i swój klucz API. Wybierz analizę name, email lub username zgodnie z kolumną źródłową.
- Zmapuj kolumnę źródłową na osobną kolumnę płci. Miejsca docelowe dla prawdopodobieństwa, kraju i znalezionego imienia dodawaj tylko wtedy, gdy ich potrzebujesz.
- Przed utworzeniem przepływu pracy sprawdź wszystkie mapowania. Interfejs zapobiega konfliktom kolumn i może zgłosić istniejący przepływ pracy lub osiągnięty limit.
- Dodaj reprezentatywny rekord tym samym mechanizmem, którego używają Twoje dane produkcyjne. Sprawdź, czy wartości pojawiają się we właściwym wierszu i czy żadne istniejące pole nie zostało nadpisane.
- Przetestuj nierozstrzygniętą wartość i błąd operacyjny, a następnie zdecyduj, jak będziesz wykrywać i sprawdzać brakujące lub nieudane wiersze.

- [Zainstaluj dodatek Google Sheets](https://workspace.google.com/marketplace/app/gender_api_for_google_sheets_determines/712811575775)

## Skonfiguruj pola natywnego przepływu pracy

| Ustawienie | Typ | Zastosowanie |
| --- | --- | --- |
| Klucz API | Dane uwierzytelniające | Wybierz właściwe konto i sprawdź dostępne kredyty. |
| Arkusz | Wybór arkusza | Arkusz, którego rekordy ma przetwarzać ten przepływ pracy. |
| Metoda | Wybór | name, email lub username; wybrana metoda określa sposób interpretacji danych wejściowych. |
| Kolumna źródłowa | Odwołanie do kolumny | Wartość do przeanalizowania w każdym rekordzie. |
| Kolumna płci | Odwołanie do kolumny | Miejsce docelowe odrębne od danych wejściowych i pozostałych wyników. |
| Prawdopodobieństwo, kraj, znalezione imię | Opcjonalne miejsca docelowe | Osobne kolumny na dodatkowe natywne wyniki. |

## Sprawdź, jak wiersze faktycznie trafiają do arkusza

Wpisanie wartości, przesłanie formularza i import rekordów z CRM to różne zdarzenia. Zgodnie z dokumentacją Google wykonania skryptów i zapytania API zazwyczaj nie uruchamiają wyzwalaczy instalowanych. Publiczna karta dodatku nie pozwala ustalić jego dokładnej implementacji: przetestuj źródło danych, którego zamierzasz używać.

Nie zakładaj, że nowy przepływ pracy przetworzy wstecznie istniejące wiersze. Dla takich rekordów zaznacz zakres w panelu przetwarzania zbiorczego i prowadź rejestr już przetworzonych wierszy.

Jeśli oczekiwana aktualizacja się nie pojawi, sprawdź przepływ pracy, uprawnienia, saldo klucza, mapowania kolumn i błędy platformy, zanim ponownie wyślesz te same rekordy.

- [Ograniczenia wyzwalaczy instalowanych Google](https://developers.google.com/apps-script/guides/triggers/installable)
- [Przetwarzaj istniejące wiersze zbiorczo](https://www.genderapi.io/pl/blog/jak-okreslic-plec-w-google-sheets-za-pomoca-gender-api-add-on)

## 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)

## 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.

- [Przepływ HTTP V2 w Make](https://www.genderapi.io/pl/blog/make-gender-api-integration)
- [Przepływ HTTP V2 w Zapier](https://www.genderapi.io/pl/blog/zapier-gender-api-integration)
- [Parametry zapytania V2](https://www.genderapi.io/pl/docs/v2/request-parameters)

## Czy każdy import z CRM uruchamia natywny przepływ pracy?

Nie zakładaj tego. Przetestuj rekord pochodzący z rzeczywiście używanego CRM lub automatyzacji. Google rozróżnia ręczne edycje, przesłania formularzy i aktualizacje przez API; sprawdź zachowanie zainstalowanego dodatku.

## Czy mogę przetworzyć wiersze, które już są w arkuszu?

Zaznacz zakres w panelu przetwarzania zbiorczego. Utworzenie przepływu pracy dla nowych wierszy nie oznacza przetworzenia istniejących rekordów.

## Ile przepływów pracy mogę utworzyć?

Interfejs może zgłosić limit, ale ten przewodnik nie podaje niezweryfikowanej liczby. Sprawdź zainstalowaną wersję i w razie potrzeby usuń niepotrzebne już przepływy pracy.

## Jak uzyskać pola source i usage z V2?

Utwórz osobną integrację HTTP V2, na przykład według udokumentowanej instrukcji dla Make lub Zapier. Nie zakładaj, że kolumny dodatku zawierają strukturę odpowiedzi V2.

## Dokumentacja źródłowa

- [Oficjalna karta dodatku Google Sheets](https://workspace.google.com/marketplace/app/gender_api_for_google_sheets_determines/712811575775)
- [Instalowalne wyzwalacze Google](https://developers.google.com/apps-script/guides/triggers/installable)
- [Limity Google Apps Script](https://developers.google.com/apps-script/guides/services/quotas)
- [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)