# Jak používat vzorec GENDER v Google Sheets

> Použijte =GENDER pro jména, e-mailové adresy a uživatelská jména v Google Sheets. Přehled pořadí argumentů, kontextu země, rozšířených výsledků, přepočtu a kvót.

Canonical HTML: https://www.genderapi.io/cs/blog/gender-formula-google-sheets-detect-gender-from-names

Last reviewed: 2026-09-30

## Vypočtěte výsledek z buňky

Po instalaci doplňku GenderAPI pro Google Sheets a uložení klíče v nastavení Formula zadejte =GENDER(A2), abyste analyzovali jméno v buňce A2. Volitelné argumenty určují vstup typu e-mail nebo uživatelské jméno, kontext země a další výsledkové sloupce.

GENDER je nativní vzorec doplňku. Nepřijímá objekt požadavku JSON z V2 a nevrací strukturu odpovědi V2.

- [Nainstalovat potřebný doplněk](https://workspace.google.com/marketplace/app/gender_api_for_google_sheets_determines/712811575775)
- [Použít postranní panel pro větší rozsah řádků](https://www.genderapi.io/cs/blog/how-to-determine-gender-in-google-sheets-using-gender-api-add-on)

## Před zadáním vzorců uložte klíč

- Otevřete Rozšíření (Extensions) → GenderAPI → Determine Gender a potom v nabídce postranního panelu otevřete stránku Formula.
- Vyberte uložený API klíč, nebo zadejte svůj klíč a uložte ho. Přihlašovací údaje uchovávejte v postranním panelu, ne ve sdílených buňkách listu.
- Do buňky A2 zadejte reprezentativní vstup a vzorec vložte do samostatné buňky. Pokud požadujete doplňující informace, nechte vpravo volné místo.
- Než vzorec zkopírujete do dalších řádků, zkontrolujte výsledek a aktuální nápovědu ke vzorci v postranním panelu.

## Argumenty se zadávají v tomto pořadí

| Název argumentu | Typ | Výchozí hodnota | Popis |
| --- | --- | --- | --- |
| `input` | Text nebo odkaz na buňku | Povinný | Jméno, e-mailová adresa nebo uživatelské jméno, například A2. |
| `method` | Textová hodnota | name | Použijte name, email nebo username podle vstupu. |
| `country_filter` | Textová hodnota | Bez filtru země | Volitelný kód země o 2 písmenech. Pokud tento argument před additional_info vynecháváte, použijte prázdný řetězec. |
| `additional_info` | Logická hodnota | FALSE | TRUE požaduje další pole v sousedních sloupcích. FALSE vrací pouze hodnotu pohlaví. |

**Ukázky vzorců pro Google Sheets**

Každý řádek je samostatný vzorec. Zvolte metodu, která odpovídá hodnotě v A2. Ukázky předvádějí syntaxi a nezaručují konkrétní výsledek. Podle místního nastavení tabulky může být oddělovačem argumentů místo čárky středník.

```text
=GENDER(A2)
=GENDER(A2, "email")
=GENDER(A2, "username")
=GENDER(A2, "name", "IT", TRUE)
=GENDER(A2, "email", "", TRUE)
```

## Nechte místo pro rozšířené výsledky

Když je argument additional_info zapnutý, aktuální nápověda v postranním panelu Google Sheets uvádí 4 hodnoty v tomto pořadí: pohlaví, země, Probability a normalizované jméno. Liší se to od pořadí ve vzorci pro Excel. Při vytváření záhlaví sloupců si ověřte nápovědu v nainstalovaném doplňku.

Všechny cílové buňky ponechte prázdné, aby se maticový výsledek mohl rozbalit. Zablokovaný maticový výsledek, chybějící klíč nebo chyba platformy vyžadují řešení problému. Nejde o odhad neznámého pohlaví.

| Pozice | Aktuální nápověda v Sheets | Zpracování |
| --- | --- | --- |
| 1 | Gender | Nevyřešené výsledky ponechte jako unknown a odlište je od chybových textů. |
| 2 | Country | Používejte jako kontext vrácený vyhledáním, ne jako ověřenou polohu. |
| 3 | Probability | Tento starší signál uchovávejte spolu s výsledkem. Nepřejmenovávejte ho na confidence z V2. |
| 4 | Normalized name | Jméno odvozené z vašeho vstupu zkontrolujte dřív, než ho použijete v dalších krocích. |

## Pochopte přepočet a poznámky s mezipamětí

Vzorec je dynamický. Úprava vstupů nebo přepočet listu může vyžadovat nové zpracování. Doplněk může zapsat poznámku se vzorcem a jeho výsledkem uloženým v mezipaměti, poznámka však nezaručuje, že se každý pozdější výpočet obejde bez požadavku nebo účtování.

Google uplatňuje kvóty pro spouštění vlastních funkcí a pro URL Fetch nezávisle na kreditech GenderAPI. Podle aktuální dokumentace Googlu je jedno spuštění vlastní funkce omezeno na 30 sekund. Příliš mnoho souběžných vzorců nebo pomalé požadavky mohou způsobit chyby, i když má váš účet ještě kredity.

Pokud chcete stabilní snímek, zkopírujte dokončené výsledky a vložte je jako hodnoty do samostatné oblasti. Tento snímek pak už na vzorci nezávisí. Pro vlastní evidenci si ponechte původní vstup a datum kontroly.

- [Jak fungují vlastní funkce Googlu](https://developers.google.com/apps-script/guides/sheets/functions)
- [Aktuální kvóty Google Apps Script](https://developers.google.com/apps-script/guides/services/quotas)

## Naplánujte kredity, limity a opakovaná spuštění

Registrovaný bezplatný účet GenderAPI zahrnuje 200 kreditů za den. Kredity představují zůstatek účtu, nikoli příslib 200 úspěšných výsledků v každém workflow. Před spuštěním zkontrolujte zůstatek vybraného klíče a aktuální možnosti zpracování daného nástroje.

Nativní doplňky a souborové úlohy mají vlastní způsob zpracování. Limit dávkových požadavků v REST API V2, možnosti AI a pole účtování jednotlivých požadavků se na ně automaticky nevztahují. Opakované spuštění nebo přepočet může odeslat data ke zpracování znovu, proto nepředpokládejte, že je zdarma.

Začněte malým vzorkem, dokončené výsledky si ponechte a před opětovným spuštěním projděte neúspěšné řádky. Pokud potřebujete jen opravit pozdější export nebo aktualizaci v cílové aplikaci, použijte znovu výsledky, které už máte.

- [Tarify účtu a kredity](https://www.genderapi.io/cs/price)

## Kdy použít přímo API V2

Samostatnou integraci přes HTTP použijte, když vaše aplikace potřebuje explicitní možnosti AI a z V2 informace status, source, confidence_kind a usage pro každou položku. Řiďte se specifikací požadavku a odpovědi V2. Přidání názvů polí V2 do nativního vzorce nebo stávajícího doplňku chování tohoto klienta nezmění.

- [Parametry požadavku V2](https://www.genderapi.io/cs/docs/v2/request-parameters)
- [Pole odpovědi V2](https://www.genderapi.io/cs/docs/v2/responses)
- [Integrace V2 v Pythonu](https://www.genderapi.io/cs/integrations/python)
- [Integrace V2 v Node.js](https://www.genderapi.io/cs/integrations/javascript)

## Jmenuje se vzorec GENDER_API?

Ne. Doplněk pro Google Sheets dokumentuje =GENDER(input, method, country_filter, additional_info). Microsoft Excel používá jiné názvy: GENDER.FROM_NAME, GENDER.FROM_EMAIL a GENDER.FROM_USERNAME.

## Mohu požádat o další pole bez filtru země?

Ano. Třetí argument ponechte jako prázdný řetězec, například =GENDER(A2, "email", "", TRUE). Další pole se pak rozbalí do sousedních buněk.

## Je přepočet díky poznámce s mezipamětí zdarma?

Uložený výsledek lze použít znovu, poznámka však nezaručuje, že se každé budoucí spuštění obejde bez nového požadavku. Sledujte kredity a stabilní výsledky uchovávejte jako hodnoty, pokud průběžný přepočet není nutný.

## Mají všichni, kdo tabulku upravují, automaticky přístup?

Nepředpokládejte to. Ověřte, že je doplněk dostupný a autorizovaný pro zamýšlené uživatele a dokument. Pokud příjemci potřebují jen dokončené výsledky, uchovávejte kopii obsahující pouze hodnoty.

## Zdroje a dokumentace

- [Oficiální stránka doplňku pro Google Sheets](https://workspace.google.com/marketplace/app/gender_api_for_google_sheets_determines/712811575775)
- [Vlastní funkce v Google Sheets](https://developers.google.com/apps-script/guides/sheets/functions)
- [Kvóty a limity Google Apps Script](https://developers.google.com/apps-script/guides/services/quotas)
- [Tarify a kredity GenderAPI](https://www.genderapi.io/cs/price)
- [Zásady ochrany osobních údajů GenderAPI](https://www.genderapi.io/cs/privacy-policy)
- [Specifikace požadavku V2](https://www.genderapi.io/cs/docs/v2/request-parameters)