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.
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. |
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.
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.
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.
Perguntas frequentes
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
A última revisão deste guia foi em . Confira a instalação na documentação da plataforma e use a documentação da API indicada para uma integração separada com a V2.