Asigna los campos con la extensión de Airtable
La extensión de GenderAPI lee un nombre o correo del campo seleccionado y escribe la estimación en un destino independiente. Puedes añadir país, probabilidad y nombre encontrado, y omitir registros cuyo destino de género ya tenga un valor.
El código revisado el 28 de septiembre de 2026 utiliza endpoints V1 de nombres y correos y campos de respuesta de primer nivel. Esta guía describe ese flujo. La versión instalada puede cambiar por separado; comprueba sus controles antes de asignar campos.
Conecta la base y prepara los campos
- Abre la base correspondiente, añade GenderAPI.io desde Extensions y completa los pasos de conexión de la extensión.
- Elige la clave cuyos créditos utilizarás. Comprueba el saldo y la cuenta de GenderAPI asociada.
- Selecciona la tabla y el campo de nombres o correos. Conserva la entrada original y crea campos de destino independientes.
- Asigna el destino obligatorio de género y los campos adicionales que necesites. Utiliza un campo percent para porcentajes o uno numérico para la escala original.
- Decide si omitirás destinos de género ya rellenados. Esto también conserva textos de resultados desconocidos: borra únicamente los valores que hayas decidido volver a procesar.
Relaciona las entradas con sus destinos
Un mismo campo puede contener nombres y correos. El código revisado dirige los valores que contienen @ al endpoint de correo; esta regla no verifica que exista el buzón.
| Ajuste | Obligatorio | Valor y comportamiento |
|---|---|---|
| Clave de créditos | Sí | Las consultas utilizan el saldo de la cuenta de GenderAPI seleccionada. |
| Tabla y campo de origen | Sí | Proporcionan el nombre o correo; se omiten las celdas de origen vacías. |
| Destino de género | Sí | Recibe gender. Conserva los casos sin resolver separados de male y female. |
| Destino de país | No | Recibe country; es una salida, no un filtro de país para la solicitud. |
| Destino de probabilidad | No | Recibe probability de V1. En un campo percent se divide entre 100; en uno numérico conserva la escala original. |
| Destino Found Name | No | Recibe el nombre devuelto, si existe. Conserva el candidato extraído separado del valor de origen. |
| Omitir destinos de género rellenos | No | Conserva cualquier destino con valor, incluido un texto anterior sin resolver. Revisa el ajuste antes de ejecutar. |
Revisa una muestra antes de procesar la tabla
Empieza con una tabla pequeña que incluya un nombre, un correo, una celda vacía y una entrada ambigua. Comprueba los destinos y la escala de probabilidad en Airtable.
El código revisado puede dejar el texto null y una probabilidad cero como valores predeterminados. Algunas respuestas fallidas también pueden dejar esos valores; un fallo de conexión puede mantener el registro sin cambios. El texto null por sí solo no demuestra que la consulta haya terminado correctamente.
Conserva los casos sin resolver como desconocidos. Una estimación no verifica la identidad de género de la persona, y el país de salida no confirma su residencia.
| Situación | Comprobación |
|---|---|
| Resultado en los campos previstos | Conserva la entrada y los campos auxiliares para poder revisar la asignación. |
| Texto null o probabilidad cero | Mantén el estado desconocido y revisa el procesamiento antes de consultar de nuevo. |
| Un destino relleno no cambia | Comprueba si está activada la omisión; puede ser una protección intencionada. |
| Aviso de clave/créditos o registro sin cambios tras un error | Resuelve el problema de cuenta o conexión e identifica los registros afectados antes de repetir. |
Controla los créditos y las repeticiones
La extensión consulta los valores individualmente con la clave seleccionada. Repetir registros no omitidos puede generar nuevas consultas y consumir créditos. El plan de Airtable y el acceso a extensiones son independientes de ese saldo.
La extensión no presenta data/meta de V2, selección explícita del modo de IA, usage por elemento ni el contrato batch de V2. Utiliza la referencia V1 para este flujo o configura una conexión V2 independiente si necesitas esos controles.
Los valores asignados se envían para su procesamiento y los resultados se escriben en la base. Revisa los permisos y la política de datos; no incluyas campos innecesarios.
Utiliza V2 si necesitas una respuesta estructurada
GenderAPI V2 acepta nombres, correos y usuarios y devuelve campos explícitos de resultado, confianza, origen y uso. Configura esta conexión por separado: consultar V2 no actualiza una aplicación instalada ni cambia sus columnas.
Los ejemplos de Python y Node.js cubren solicitudes individuales, lotes, resultados desconocidos y errores operativos. Configura la autenticación y elige el modo de IA antes de enviar una solicitud facturable.
Preguntas frecuentes
¿La extensión de Airtable utiliza V2?
El código revisado el 28 de septiembre de 2026 utiliza endpoints V1 de nombres y correos. Una conexión V2 independiente tiene otros campos y no actualiza la extensión instalada.
¿Puedo mezclar nombres y correos en el campo de origen?
Sí. La extensión revisada dirige las entradas no vacías con @ a la consulta de correo y las demás a nombres. No verifica la existencia del buzón.
¿Por qué cambia la probabilidad en un campo de porcentaje?
La extensión divide probability entre 100 para campos percent y Airtable lo representa como porcentaje. Un campo numérico conserva la escala original. No es el campo confidence de V2.
¿La omisión conserva también los resultados desconocidos?
Sí, si el destino contiene un valor, incluido el texto null anterior. Revisa los registros y borra solo los resultados que quieras volver a consultar.
Documentación de referencia
Última revisión de esta guía: . Consulta la documentación de la plataforma para la instalación y la referencia API enlazada para una integración V2 independiente.