# Determine o gênero no Excel com o suplemento da GenderAPI

> Instale o suplemento do Excel, conecte a chave da conta e mapeie colunas de nomes, endereços de e-mail ou nomes de usuário. Verifique resultados unknown e créditos.

Canonical HTML: https://www.genderapi.io/pt/blog/genderize-excel-names-using-genderapi-excel-add-in

Last reviewed: 2026-09-29

## Enriqueça linhas do Excel pelo painel lateral

Com o suplemento da GenderAPI para Excel, você escolhe uma coluna de nomes, endereços de e-mail ou nomes de usuário e grava os resultados em colunas mapeadas da planilha. Use o painel lateral para um intervalo de linhas controlado ou as funções GENDER.FROM_* para cálculos vinculados a células.

O cliente próprio do Excel usa os campos da API antiga. Ele não retorna os objetos data e meta da REST V2, então mantenha os mapeamentos existentes na pasta de trabalho alinhados com a saída real do suplemento.

- [Instalar pelo Microsoft AppSource](https://appsource.microsoft.com/en-us/product/office/WA200008555)
- [Guia das fórmulas do Excel](https://www.genderapi.io/pt/blog/formula-genero-para-microsoft-excel)

## Configure primeiro um pequeno intervalo de linhas

- Instale a GenderAPI pela página dela no catálogo da Microsoft e abra o painel lateral do suplemento na pasta de trabalho. Verifique as permissões de acesso ao documento e eventuais restrições da sua organização.
- Salve a sua chave da GenderAPI no suplemento e verifique se a conta escolhida tem créditos.
- Escolha o método name, email ou username e a coluna de origem correspondente. Informe um pequeno intervalo de linhas sem a linha de cabeçalho.
- Mapeie a coluna de destino do gênero e, se necessário, colunas para probability, país e nome encontrado. Mantenha cada resultado separado dos dados de origem.
- Informe um contexto de país somente quando ele for confiável para os dados que você processa. Verifique as opções escolhidas e execute a amostra.
- Revise as linhas identificadas, não resolvidas e com falha antes de ampliar o intervalo. Mantenha uma cópia dos dados originais da pasta de trabalho.

## Escolha entrada, contexto e colunas de resultado

| Configuração | Tipo | Descrição |
| --- | --- | --- |
| Chave de API | Credencial da conta | É salva pelo campo de chave do suplemento; não a escreva em células comuns da pasta de trabalho. |
| Método e origem | Seleção e coluna | name, email ou username junto com a coluna de origem correspondente. |
| Intervalo de linhas | Números de linha | Comece com um intervalo pequeno sem a linha de cabeçalho. |
| Filtro de país | País ou coluna opcional | Informa um contexto de país conhecido; o campo não confirma a localização verificada da pessoa. |
| Colunas de resultado | Referências de coluna | Uma coluna de destino para o gênero e destinos opcionais para probability, país e nome encontrado. |

## Leia as colunas de resultado

Mantenha o valor original ao lado do resultado. Uma associação baseada no nome não determina o gênero declarado pela pessoa, e um país retornado não comprova residência nem cidadania.

- Verifique um resultado comum, uma entrada ambígua e uma execução com falha antes de processar o conjunto de dados inteiro.
- Uma célula vazia, o texto null e um erro de fórmula são valores diferentes. Normalize os resultados unknown de forma intencional, sem ocultar erros.
- Use uma linguagem neutra em casos unknown ou incertos e mantenha as informações fornecidas pela própria pessoa separadas das previsões.

| Resultado | Tipo | Uso |
| --- | --- | --- |
| Gender | Texto ou valor não resolvido | Salve male ou female somente em um resultado bem-sucedido. Salve um valor não resolvido como unknown e revise as mensagens de erro separadamente. |
| Probability | Número, se disponível | Um indicador de confiança histórico. Ele não corresponde ao campo confidence da V2 nem a uma precisão medida nos seus dados. |
| Country | Texto, se disponível | Contexto retornado pela consulta. Mantenha-o separado do país verificado do cliente. |
| Found / normalized name | Texto, se disponível | O nome usado ou extraído durante o processamento. Verifique-o quando um endereço de e-mail ou um nome de usuário for ambíguo. |

- [Valores de confiança e limitações](https://www.genderapi.io/pt/accuracy-methodology)

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

## Escolha quais dados você compartilha

As integrações com planilhas enviam os valores necessários para a consulta e exigem permissões para o documento escolhido. Antes de processar dados pessoais, verifique quem tem acesso à planilha, qual conta está conectada e quais colunas de destino são usadas.

Guarde a chave de API nas configurações do complemento, e não em células comuns, capturas de tela ou exemplos compartilhados. A política de privacidade publicada descreve como os dados de entrada são tratados, armazenados e registrados. Uma integração com planilhas não significa que os dados permanecem exclusivamente no seu dispositivo.

- [Política de privacidade da GenderAPI](https://www.genderapi.io/pt/privacy-policy)

## 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 analisar endereços de e-mail e nomes de usuário no Excel?

Sim. Escolha o método correspondente no painel lateral e mapeie a coluna de entrada correta. Verifique o nome retornado e os casos não resolvidos antes de usar os resultados.

## Devo usar o painel lateral ou uma fórmula?

Use o painel lateral para processar um intervalo selecionado e gravar valores nas colunas mapeadas. Escolha as fórmulas GENDER.FROM_* quando precisar de cálculos vinculados a células e leve em conta o que o recálculo implica.

## O nome de arquivo functions_v2.js significa que o suplemento usa a REST V2?

Não. É o nome de um arquivo do cliente do Excel. O arquivo público de fórmulas revisado para este guia chama endpoints da API antiga e lê os campos de resposta dela.

## As previsões são atributos verificados dos clientes?

Não. Mantenha-as separadas das informações fornecidas pelo próprio cliente e use uma alternativa neutra em resultados unknown ou casos incertos.

## 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)
- [Cliente publicado das fórmulas do Excel](https://excel.genderapi.io/functions_v2.js)
- [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)