Uzyskaj wynik z jednej komórki
Po zainstalowaniu dodatku GenderAPI for Google Sheets i zapisaniu klucza w jego ustawieniach Formula wpisz =GENDER(A2), aby przeanalizować imię z komórki A2. Opcjonalne argumenty pozwalają wybrać dane wejściowe w postaci adresu e-mail lub nazwy użytkownika, kontekst kraju oraz dodatkowe kolumny wyników.
GENDER to natywna formuła dodatku. Nie przyjmuje obiektu JSON zapytania V2 i nie zwraca struktury odpowiedzi V2.
Zapisz klucz przed wpisaniem formuł
- Otwórz Extensions → GenderAPI → Determine Gender, a następnie przejdź do strony Formula z menu panelu bocznego.
- Wybierz zapisany klucz API lub wpisz własny i go zapisz. Przechowuj dane uwierzytelniające w panelu bocznym, a nie w udostępnianych komórkach.
- Wpisz reprezentatywną wartość w A2, a formułę umieść w innej komórce. Zostaw wolne miejsce po prawej stronie, jeśli prosisz o dodatkowe informacje.
- Sprawdź wynik i aktualną pomoc w panelu, zanim skopiujesz formułę do kolejnych wierszy.
Argumenty występują w tej kolejności
| Argument | Typ | Wartość domyślna | Opis |
|---|---|---|---|
input | Tekst lub odwołanie do komórki | Wymagany | Imię, adres e-mail lub nazwa użytkownika, na przykład A2. |
method | Tekst | name | name, email lub username, zależnie od danych wejściowych. |
country_filter | Tekst | Brak filtra kraju | Opcjonalny dwuliterowy kod kraju. Użyj pustego ciągu znaków, aby pominąć ten argument przed additional_info. |
additional_info | Wartość logiczna | FALSE | TRUE zwraca dodatkowe pola w sąsiednich kolumnach; FALSE zwraca tylko płeć. |
Każdy wiersz to osobna formuła. Wybierz metodę odpowiadającą wartości w A2. Przykłady ilustrują składnię i nie gwarantują żadnego wyniku. W zależności od ustawień regionalnych arkusza separatorem argumentów może być średnik zamiast przecinka.
=GENDER(A2)
=GENDER(A2, "email")
=GENDER(A2, "username")
=GENDER(A2, "name", "IT", TRUE)
=GENDER(A2, "email", "", TRUE)Zostaw miejsce na rozszerzone wyniki
Gdy additional_info jest włączone, aktualna pomoc w panelu Google Sheets wymienia cztery wartości w tej kolejności: płeć, kraj, prawdopodobieństwo i znormalizowane imię. Ta kolejność różni się od kolejności w formułach Excel. Tworząc nagłówki kolumn, sprawdź pomoc zainstalowanego dodatku.
Pozostaw wszystkie komórki docelowe puste, aby tablica mogła się rozwinąć. Zablokowaną tablicę, brak klucza lub błąd platformy trzeba rozwiązać osobno: nie są to prognozy z wynikiem unknown.
| Pozycja | Aktualna pomoc Sheets | Postępowanie |
|---|---|---|
| 1 | Gender | Nierozstrzygnięte wyniki zachowuj jako unknown i odróżniaj je od komunikatów o błędach. |
| 2 | Country | Kontekst zwrócony przez wyszukiwanie, a nie zweryfikowana lokalizacja. |
| 3 | Probability | Przechowuj ten historyczny wskaźnik razem z wynikiem; nie zmieniaj jego nazwy na confidence z V2. |
| 4 | Normalized name | Sprawdź imię wyprowadzone z Twoich danych wejściowych, zanim użyjesz go gdzie indziej. |
Zrozum przeliczenia i notatki z pamięci podręcznej
Formuła jest dynamiczna. Zmiana jej danych wejściowych lub przeliczenie arkusza może wymagać ponownego przetworzenia. Dodatek może zapisać notatkę z formułą i wynikiem z pamięci podręcznej, ale ta notatka nie gwarantuje, że każde późniejsze przeliczenie obędzie się bez nowego zapytania lub zużycia kredytów.
Google stosuje limity wykonywania funkcji niestandardowych i URL Fetch niezależnie od kredytów GenderAPI. Jego aktualna dokumentacja ogranicza każde wykonanie funkcji niestandardowej do 30 sekund. Zbyt wiele jednoczesnych formuł lub wolne zapytania mogą powodować błędy, nawet jeśli Twoje konto nadal ma kredyty.
Aby uzyskać stabilną migawkę, skopiuj uzupełnione wyniki i wklej je jako wartości w innym obszarze. Taka kopia nie zależy już od formuły; zachowaj też oryginalne dane wejściowe i datę weryfikacji.
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.
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.
Najczęstsze pytania
Czy formuła nazywa się GENDER_API?
Nie. Dodatek Google Sheets dokumentuje =GENDER(input, method, country_filter, additional_info). Microsoft Excel używa innych nazw: GENDER.FROM_NAME, GENDER.FROM_EMAIL i GENDER.FROM_USERNAME.
Czy mogę poprosić o dodatkowe pola bez filtra kraju?
Tak. Pozostaw trzeci argument pusty, na przykład =GENDER(A2, "email", "", TRUE). Dodatkowe pola rozwiną się wtedy do sąsiednich komórek.
Czy notatka z pamięci podręcznej sprawia, że przeliczenia są bezpłatne?
Zapisany wynik może zostać użyty ponownie, ale notatka nie gwarantuje, że każde przyszłe wykonanie obędzie się bez nowego zapytania. Monitoruj kredyty i przechowuj stałe wartości, gdy dynamiczne przeliczanie nie jest potrzebne.
Czy wszyscy edytorzy arkusza mają do niej automatycznie dostęp?
Nie zakładaj tego. Sprawdź, czy dodatek jest dostępny i autoryzowany dla odpowiednich użytkowników i dokumentu. Udostępnij kopię z wartościami, gdy odbiorcy potrzebują tylko uzupełnionych wyników.
Dokumentacja źródłowa
Ostatnia weryfikacja tego poradnika: . Instalację sprawdź w dokumentacji platformy, a przy osobnej integracji V2 skorzystaj z podlinkowanej dokumentacji API.