# Fórmulas da GenderAPI para Microsoft Excel

> Use GENDER.FROM_NAME, GENDER.FROM_EMAIL e GENDER.FROM_USERNAME no Excel. Verifique argumentos, valores padrão, saída estendida e erros comuns.

Canonical HTML: https://www.genderapi.io/pt/blog/formula-genero-para-microsoft-excel

Last reviewed: 2026-09-29

## Escolha a função adequada à sua entrada

Instale o suplemento da GenderAPI para Excel, salve a sua chave de API no painel lateral dele e use GENDER.FROM_NAME para nomes, GENDER.FROM_EMAIL para endereços de e-mail ou GENDER.FROM_USERNAME para nomes de usuário. Cada função recebe primeiro a entrada, depois um sinalizador opcional para informações extras e, por fim, um contexto de país opcional.

Essas fórmulas do Excel se baseiam na API antiga. A fórmula GENDER do Google Sheets tem outra assinatura, e a API REST V2 direta tem o próprio contrato JSON.

- [Instalar o suplemento do Excel](https://appsource.microsoft.com/en-us/product/office/WA200008555)
- [Configurar o painel lateral no Excel](https://www.genderapi.io/pt/blog/genderize-excel-names-using-genderapi-excel-add-in)

## Três argumentos em ordem fixa

| Argumento | Tipo | Valor padrão | Descrição |
| --- | --- | --- | --- |
| `name / email / username` | Texto ou referência de célula | Obrigatório | A entrada da função escolhida, por exemplo A2. |
| `enable_additional_info` | Booleano | FALSE | TRUE ou 1 retorna quatro colunas. Omita o argumento ou use FALSE/0 para obter somente o gênero. |
| `country` | Texto | Nenhum filtro de país | Código de país opcional de duas letras, por exemplo IT, US, DE ou TR. Se você informar este terceiro argumento, informe também o segundo. |

**Exemplos de fórmulas para Excel**

Cada linha é um exemplo independente. Digite em A2 o nome, o endereço de e-mail ou o nome de usuário correspondente. Dependendo da localidade do Excel, o separador de argumentos pode ser ponto e vírgula em vez de vírgula.

```text
=GENDER.FROM_NAME(A2)
=GENDER.FROM_NAME(A2, TRUE, "IT")
=GENDER.FROM_EMAIL(A2, TRUE)
=GENDER.FROM_USERNAME(A2, FALSE)
```

## A saída estendida no Excel usa quatro colunas

Sem informações extras, a fórmula retorna somente o gênero. Quando elas estão ativadas, a saída documentada do Excel preenche uma linha com gênero, probability, país e nome encontrado, nessa ordem. Mantenha vazias as três células à direita.

A fórmula do Google Sheets coloca o país antes de probability, então não reutilize os cabeçalhos de coluna dela sem verificar a ordem que vale no Excel.

| Posição | Saída no Excel | Significado |
| --- | --- | --- |
| 1 | Gender | Gênero identificado ou valor não resolvido. Trate erros operacionais separadamente. |
| 2 | Probability | Sinal de confiança da API antiga; não é o confidence_kind da V2 nem uma precisão medida do modelo. |
| 3 | Country | Contexto de país retornado pela consulta, e não um atributo verificado da pessoa. |
| 4 | Matched name | Verifique o nome usado ou extraído, principalmente para endereços de e-mail e nomes de usuário. |

## Corrija erros de configuração antes de copiar a fórmula para baixo

Um recálculo pode iniciar uma nova consulta. Se você precisar de um retrato estável, cole os resultados prontos como valores e salve ao lado os dados originais e a data da verificação.

| Sintoma | O que verificar |
| --- | --- |
| A função não está disponível | Verifique se o suplemento está instalado e disponível nesta pasta de trabalho e neste ambiente do Excel. |
| A chave de API não foi informada | Abra o painel lateral da GenderAPI e salve a chave. Uma chave escrita em uma célula não substitui a credencial salva no suplemento. |
| Entrada vazia | Verifique a célula referenciada pela fórmula e escolha a função que corresponde ao tipo de entrada real. |
| A saída estendida não aparece | Libere as células de destino adjacentes necessárias sem sobrescrever dados úteis. |
| Mensagem de erro ou unknown error | Verifique a conexão, o status da conta e a mensagem retornada. Um erro operacional não é uma previsão não resolvida. |

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

## Posso usar =GENDER(A2) no Microsoft Excel?

As funções documentadas do suplemento do Excel são GENDER.FROM_NAME, GENDER.FROM_EMAIL e GENDER.FROM_USERNAME. A fórmula GENDER simples pertence ao complemento para Google Sheets.

## Como informo um país sem saída extra?

Deixe o segundo argumento desativado, por exemplo =GENDER.FROM_NAME(A2, FALSE, "IT"). O país é o terceiro argumento, e não o segundo.

## Qual é o valor padrão da opção de informações extras?

Se o argumento for omitido, ela fica desativada. TRUE ou 1 ativa a saída em quatro colunas: gênero, probability, país e nome encontrado.

## As funções retornam informações de cobrança da V2?

Não. As fórmulas integradas mostram os campos de resultado da API antiga. Use uma integração separada com a V2 quando precisar dos metadados da requisição, de source, de confidence_kind ou do uso por requisição.

## Fontes e documentação

- [Página oficial do suplemento no Microsoft AppSource](https://appsource.microsoft.com/en-us/product/office/WA200008555)
- [Documentação da fórmula do Excel: gender_from_name](https://excel.genderapi.io/help/gender_from_name.html)
- [Documentação da fórmula do Excel: gender_from_email](https://excel.genderapi.io/help/gender_from_email.html)
- [Documentação da fórmula do Excel: gender_from_username](https://excel.genderapi.io/help/gender_from_username.html)
- [Definições publicadas das funções do Excel](https://excel.genderapi.io/functions_v2.json)
- [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)