# Fórmula GENDER no Google Sheets: argumentos e resultados

> Use =GENDER para nomes, endereços de e-mail e nomes de usuário. Veja a ordem dos argumentos, o filtro de país, os resultados estendidos e o que significam os recálculos.

Canonical HTML: https://www.genderapi.io/pt/blog/formula-genero-google-sheets-identificar-genero-por-nomes

Last reviewed: 2026-09-29

## Obtenha um resultado a partir de uma única célula

Depois de instalar o complemento GenderAPI for Google Sheets e salvar a chave nas configurações de Formula dele, digite =GENDER(A2) para analisar o nome da célula A2. Com os argumentos opcionais, você escolhe um endereço de e-mail ou um nome de usuário como entrada, um contexto geográfico e colunas de resultado extras.

GENDER é a fórmula própria do complemento. Ela não aceita um objeto de requisição JSON da V2 e não retorna a estrutura de resposta da V2.

- [Instalar o complemento necessário](https://workspace.google.com/marketplace/app/gender_api_for_google_sheets_determines/712811575775)
- [Processar um intervalo maior pelo painel lateral](https://www.genderapi.io/pt/blog/como-determinar-o-genero-no-google-sheets-usando-gender-api-add-on)

## Salve a chave antes de escrever fórmulas

- Abra Extensões (Extensions) → GenderAPI → Determine Gender e depois vá para a página Formula no menu do painel lateral.
- Escolha uma chave de API salva ou digite a sua e salve-a. Guarde as credenciais no painel lateral, e não em células compartilhadas.
- Digite um valor representativo em A2 e coloque a fórmula em outra célula. Deixe espaço à direita se você solicitar informações extras.
- Verifique o resultado e as instruções atuais no painel lateral antes de copiar a fórmula para outras linhas.

## Os argumentos seguem esta ordem

| Argumento | Tipo | Valor padrão | Descrição |
| --- | --- | --- | --- |
| `input` | Texto ou referência de célula | Obrigatório | Um nome, um endereço de e-mail ou um nome de usuário, por exemplo A2. |
| `method` | Texto | name | name, email ou username, conforme a entrada. |
| `country_filter` | Texto | Nenhum filtro de país | Código de país opcional de duas letras. Use uma string vazia para omitir este argumento antes de additional_info. |
| `additional_info` | Booleano | FALSE | TRUE retorna campos extras nas colunas adjacentes. FALSE retorna somente o gênero. |

**Exemplos de fórmulas para Google Sheets**

Cada linha é uma fórmula independente. Escolha o método que corresponde ao valor em A2. Os exemplos mostram a sintaxe e não garantem um resultado específico. Dependendo da localidade da planilha, o separador de argumentos pode ser ponto e vírgula em vez de vírgula.

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

## Deixe espaço para os resultados estendidos

Quando additional_info está ativado, as instruções atuais do painel lateral no Google Sheets indicam quatro valores nesta ordem: gênero, país, probability e nome normalizado. A ordem é diferente da das fórmulas do Excel. Verifique as instruções do complemento instalado ao criar os cabeçalhos das colunas.

Deixe todas as células de destino vazias para que a matriz possa se expandir. Uma matriz bloqueada, uma chave ausente ou um erro da plataforma devem ser resolvidos separadamente: não são previsões com o resultado unknown.

| Posição | Instruções atuais do Sheets | Tratamento |
| --- | --- | --- |
| 1 | Gender | Salve os resultados não resolvidos como unknown e mantenha-os separados das mensagens de erro. |
| 2 | Country | Contexto retornado pela consulta, e não uma localização verificada. |
| 3 | Probability | Salve este valor histórico junto com o resultado. Não o renomeie como o confidence da V2. |
| 4 | Normalized name | Verifique o nome derivado da sua entrada antes de usá-lo em outros lugares. |

## Entenda os recálculos e as notas de cache

A fórmula é dinâmica. Uma alteração na entrada dela ou um recálculo da planilha pode exigir um novo processamento. O complemento pode adicionar uma nota com a fórmula e o resultado armazenado em cache, mas a nota não garante que cada recálculo posterior ocorra sem uma nova requisição ou sem consumir créditos.

O Google aplica limites de execução para funções personalizadas e para URL Fetch, independentemente dos créditos da GenderAPI. Segundo a documentação atual do Google, cada execução de uma função personalizada é limitada a 30 segundos. Fórmulas simultâneas demais ou requisições lentas podem gerar erros, mesmo que a sua conta ainda tenha créditos.

Se você quiser um retrato estável, copie os resultados preenchidos e cole-os como valores em outro intervalo. Essa cópia não depende mais da fórmula. Salve também a entrada original e a data da verificação.

- [Como funcionam as funções personalizadas do Google](https://developers.google.com/apps-script/guides/sheets/functions)
- [Limites atuais do Google Apps Script](https://developers.google.com/apps-script/guides/services/quotas)

## Planeje créditos, limites e novas execuções

Uma conta gratuita registrada da GenderAPI inclui 200 créditos por dia. Isso é um saldo da conta, e não uma promessa de 200 resultados identificados em cada fluxo de trabalho. Verifique o saldo da chave escolhida e as opções de processamento atuais da ferramenta antes de começar.

Complementos e o processamento de arquivos seguem fluxos de processamento próprios. O limite de lote da API REST V2, as opções de IA e os campos de cobrança de cada requisição não se aplicam automaticamente a essas ferramentas. Uma nova execução ou um recálculo pode enviar novas requisições e consumir créditos, então não presuma que seja gratuito.

Comece com uma pequena amostra, salve os resultados obtidos e revise as linhas com falha antes de executar novamente. Se você só precisa corrigir uma exportação ou uma atualização no destino, reutilize os resultados que já tem.

- [Planos e créditos da conta](https://www.genderapi.io/pt/price)

## Quando usar a API V2 diretamente

Configure uma integração HTTP separada se a sua aplicação exigir opções de IA explícitas e as informações status, source, confidence_kind e usage da V2 para cada item. Siga o contrato de requisição e resposta da V2: adicionar nomes de campos da V2 a uma fórmula própria ou a um complemento existente não altera o comportamento deles.

- [Parâmetros da requisição](https://www.genderapi.io/pt/docs/v2/request-parameters)
- [Campos da resposta na V2](https://www.genderapi.io/pt/docs/v2/responses)
- [Integração com a V2 em Python](https://www.genderapi.io/pt/integrations/python)
- [Integração com a V2 em Node.js](https://www.genderapi.io/pt/integrations/javascript)

## A fórmula se chama GENDER_API?

Não. O complemento para Google Sheets documenta =GENDER(input, method, country_filter, additional_info). O Microsoft Excel usa outros nomes: GENDER.FROM_NAME, GENDER.FROM_EMAIL e GENDER.FROM_USERNAME.

## Posso solicitar campos extras sem filtro de país?

Sim. Deixe o terceiro argumento vazio, por exemplo =GENDER(A2, "email", "", TRUE). Os campos extras se expandem então para as células adjacentes.

## A nota de cache torna os recálculos gratuitos?

Um resultado salvo pode ser reutilizado, mas a nota não garante que cada execução futura ocorra sem uma nova requisição. Acompanhe os créditos e salve valores fixos quando você não precisar de recálculo dinâmico.

## Todos que editam a planilha têm acesso automático à fórmula?

Não presuma isso. Verifique se o complemento está disponível e autorizado para os usuários envolvidos e para o documento. Compartilhe uma cópia somente com valores se os destinatários precisarem apenas dos resultados preenchidos.

## Fontes e documentação

- [Página oficial do complemento para Google Sheets](https://workspace.google.com/marketplace/app/gender_api_for_google_sheets_determines/712811575775)
- [Funções personalizadas no Google Sheets](https://developers.google.com/apps-script/guides/sheets/functions)
- [Cotas do Google Apps Script](https://developers.google.com/apps-script/guides/services/quotas)
- [Planos e créditos da GenderAPI](https://www.genderapi.io/pt/price)
- [Política de privacidade da GenderAPI](https://www.genderapi.io/pt/privacy-policy)
- [Contrato de requisição da V2](https://www.genderapi.io/pt/docs/v2/request-parameters)