# Determine o gênero no Google Sheets com o complemento da GenderAPI

> Instale o complemento, mapeie as colunas e processe um intervalo de linhas selecionado. Verifique resultados unknown, créditos e as diferenças em relação à API V2.

Canonical HTML: https://www.genderapi.io/pt/blog/como-determinar-o-genero-no-google-sheets-usando-gender-api-add-on

Last reviewed: 2026-09-29

## Processe linhas selecionadas pelo painel lateral

O complemento GenderAPI for Google Sheets lê uma coluna de nomes, endereços de e-mail ou nomes de usuário e grava na planilha os campos de resultado escolhidos. Pelo painel lateral, você pode processar um intervalo específico e salvar os valores sem deixar uma fórmula em cada célula.

Este é o fluxo de trabalho próprio do complemento. As colunas de resultado e o processamento em lote dele são independentes do formato de resposta público da API REST V2.

- [Instalar pelo Google Workspace Marketplace](https://workspace.google.com/marketplace/app/gender_api_for_google_sheets_determines/712811575775)
- [Usar a fórmula GENDER em vez disso](https://www.genderapi.io/pt/blog/formula-genero-google-sheets-identificar-genero-por-nomes)
- [Configurar um fluxo de trabalho para novas linhas](https://www.genderapi.io/pt/blog/como-identificar-o-g%C3%AAnero-dos-clientes-no-google-sheets-em-tempo-real)

## Instale, conecte e teste com uma pequena amostra

- Instale o complemento pela página dele no Google Workspace Marketplace e verifique as permissões solicitadas. No Google Sheets, abra Extensões (Extensions) → GenderAPI → Determine Gender.
- Escolha uma chave da GenderAPI ou digite-a no painel lateral. Verifique se a conta escolhida tem créditos disponíveis.
- Escolha a planilha e o método name, email ou username. Informe a coluna de origem correspondente e um pequeno intervalo de linhas sem a linha de cabeçalho.
- Escolha uma coluna separada para o gênero e, se necessário, colunas para probability, país e nome encontrado. Não sobrescreva os valores originais.
- Se você tiver um contexto geográfico confiável, use a opção de país ou uma coluna com códigos de país. Não deduza esse contexto da previsão que você está solicitando.
- Verifique a opção de ignorar resultados existentes, inicie o processamento e revise as linhas selecionadas antes de ampliar o intervalo.

## Mapeie entradas e destinos

| Configuração | Tipo | Opções e descrição |
| --- | --- | --- |
| Chave de API | Identificação da conta | Use a chave escolhida no complemento e verifique se ela é válida e tem saldo. |
| Método | Seleção | name, email ou username, conforme a coluna de origem. |
| Planilha e intervalo de linhas | Planilha e números de linha | Selecione somente as linhas que devem ser processadas e deixe de fora a linha de cabeçalho. |
| Coluna de origem | Referência de coluna | A única coluna de entrada para o método escolhido. |
| Contexto geográfico | Opção ou coluna opcional | Use códigos de país confiáveis de duas letras, se houver. |
| Colunas de resultado | Referências de coluna | O gênero é o destino principal. Probability, país e nome encontrado são opcionais. |
| Ignorar resultados existentes | Caixa de seleção | Verifique esta opção para que uma nova execução não substitua por engano linhas já preenchidas. |

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

## Preciso escrever código para usar o painel lateral?

Não. Instale o complemento, conecte a chave e mapeie a coluna de origem e as colunas de resultado. Uma integração direta com a API V2 é uma opção separada para aplicações personalizadas.

## Posso processar linhas existentes?

Sim. Use as opções de planilha e de intervalo de linhas no painel lateral. Verifique a linha de cabeçalho, o tipo de entrada, as colunas de destino e a opção de resultados existentes antes de iniciar o processamento.

## As colunas de resultado correspondem à resposta JSON da V2?

Não. O processamento próprio do complemento grava na planilha os campos compatíveis. Os objetos data e meta e os campos source e confidence_kind pertencem ao contrato da API REST V2 direta.

## Como devo tratar um resultado unknown?

Salve-o como unknown e mantenha-o separado de uma execução com falha. Revise as entradas ambíguas e use uma linguagem neutra em vez de atribuir um gênero automaticamente.

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