Mapeie campos com a extensão do Airtable
A extensão da GenderAPI lê um nome ou um endereço de e-mail de um campo que você escolhe e grava a previsão de gênero em um campo de destino separado. Você também pode mapear país, probability e nome encontrado e ignorar registros em que o campo de destino do gênero já tem um valor.
O código da extensão, revisado em 27 de setembro de 2026, usa endpoints da V1 para nomes e endereços de e-mail e os respectivos campos de resposta de nível superior. Este guia descreve o fluxo de trabalho nativo. A extensão instalada pode mudar independentemente do guia, então verifique as opções disponíveis antes de aplicar os mapeamentos abaixo.
Conecte a base e prepare os campos
- Abra a base certa, adicione a GenderAPI.io em Extensions e inicie a extensão. Conclua as etapas de conexão exibidas pela extensão.
- Escolha a chave cujos créditos serão usados. Verifique o saldo restante e se a chave pertence à conta certa da GenderAPI.
- Escolha a tabela e o campo de origem com nomes ou endereços de e-mail. Mantenha a entrada original no campo e crie campos separados para os resultados.
- Escolha o campo de destino obrigatório do gênero e eventuais destinos extras. Use um campo percent para um valor percentual formatado ou um campo numérico para manter a escala original de probability.
- Decida se os campos de destino do gênero já preenchidos devem ser preservados. A opção que os ignora também preserva valores de texto não resolvidos de uma execução anterior. Por isso, limpe somente os resultados que você quer processar novamente de forma intencional.
Mapeie a entrada e a saída da extensão
O campo de origem pode conter tanto nomes quanto endereços de e-mail. Na implementação revisada, um valor com @ segue a rota de e-mail. Essa regra de roteamento não verifica se a caixa de correio existe.
| Configuração da extensão | Obrigatória | Valor e comportamento |
|---|---|---|
| Chave de créditos | Sim | A chave da conta da GenderAPI escolhida fornece os créditos para as requisições processadas. |
| Tabela e campo de origem | Sim | A célula de origem contém um nome ou um endereço de e-mail. Células de origem vazias são ignoradas. |
| Campo de destino do gênero | Sim | Recebe o campo nativo gender. Mantenha um valor não resolvido separado de male e female. |
| Campo de destino do país | Não | Recebe o valor country retornado. É uma coluna de saída, e não um filtro de país da requisição. |
| Campo de destino de probability | Não | Recebe o valor probability da API antiga. Um campo percent recebe o valor dividido por 100, enquanto um campo numérico mantém a escala original. |
| Campo de destino de Found Name | Não | Recebe o nome retornado pela API nativa, quando disponível. Mantenha esse candidato inferido separado do valor de origem. |
| Ignorar campos de gênero preenchidos | Não | Preserva os registros em que o campo de destino já tem um valor, incluindo texto não resolvido. Verifique a opção antes de cada execução. |
Teste um lote pequeno antes de processar a tabela
Comece com uma pequena tabela de teste com um nome, um endereço de e-mail, uma célula vazia e uma entrada ambígua. Verifique os campos de destino escolhidos e como o Airtable exibe a escala de probability antes de processar a tabela principal.
No código revisado, valores padrão não resolvidos podem aparecer como o texto null e probability 0. Algumas respostas nativas com falha também podem deixar esses valores padrão, enquanto um erro de conexão pode deixar um registro inalterado. Verifique o status da execução e as linhas afetadas: o texto null sozinho não comprova que a consulta foi bem-sucedida.
Verifique os valores existentes após a execução. Preserve os resultados não resolvidos para revisão em vez de atribuir um gênero por conta própria. Uma previsão baseada no nome não confirma a identidade de gênero de uma pessoa, e um país retornado não comprova onde alguém mora.
| O que você vê | O que fazer |
|---|---|
| Resultado esperado nas colunas previstas | Mantenha a entrada original e eventuais campos extras para que o mapeamento possa ser conferido. |
| O texto null ou probability 0 | Deixe o caso como não resolvido e verifique o status do processamento antes de decidir por uma nova consulta. |
| Um campo de destino já preenchido continua inalterado | Verifique a opção de ignorar. A preservação pode ser intencional. |
| Mensagem sobre chave ou créditos, ou resultado inalterado após um erro | Resolva o problema da conta ou da conexão e localize os registros afetados antes de começar de novo. |
Controle o consumo de créditos e as novas execuções
A extensão nativa consulta os valores um por vez com a chave da GenderAPI escolhida. Uma nova execução nos mesmos registros que não forem ignorados pode enviar novas requisições e consumir créditos novamente. O plano do Airtable e a disponibilidade da extensão são independentes desse saldo da conta.
A saída nativa não mostra data/meta da resposta da V2, uma escolha explícita do modo de IA, um objeto usage por item nem o contrato de lote da V2. Use a documentação da V1 para este fluxo de trabalho e a alternativa de API separada abaixo quando precisar dessas opções.
A extensão envia os valores mapeados para processamento e grava os resultados de volta na sua base. Revise a política de tratamento de dados publicada e as permissões da extensão para os registros envolvidos e não inclua campos irrelevantes no mapeamento de origem.
Use a V2 quando precisar de uma resposta estruturada
Para uma integração personalizada, a GenderAPI V2 aceita nomes, endereços de e-mail e nomes de usuário e retorna campos explícitos de resultado, confiança, origem e uso. Configure essa conexão separadamente: ler o guia da V2 não altera o aplicativo instalado nem as colunas de saída dele.
Os exemplos em Python e Node.js cobrem requisições individuais, lotes, resultados unknown e erros operacionais. Comece pelo guia de autenticação e escolha o modo de IA antes de enviar uma requisição cobrada.
Perguntas frequentes
A extensão do Airtable usa a GenderAPI V2?
O código da extensão, revisado em 27 de setembro de 2026, usa endpoints da V1 para nomes e endereços de e-mail. Uma conexão personalizada com a V2 tem outros campos de requisição e de resposta e não atualiza a extensão instalada.
Um campo de origem pode conter nomes e endereços de e-mail?
Sim. A extensão revisada envia valores não vazios com @ para a consulta de e-mail e os demais valores para a consulta de nome. Isso é um roteamento da entrada, e não uma verificação da caixa de correio.
Por que probability aparece diferente em um campo de porcentagem?
A extensão divide o valor probability da API antiga por 100 para um campo percent do Airtable, para que o Airtable possa exibi-lo como porcentagem. Um campo numérico mantém a escala original. Não é o campo confidence da V2.
A opção de ignorar preserva resultados não resolvidos?
Sim, quando o campo de destino já tem um valor, incluindo o texto null de uma execução anterior. Revise esses registros e limpe somente os valores que você quer processar novamente de forma intencional.
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.