Procesa filas de Excel desde el panel lateral
El complemento GenderAPI permite seleccionar una columna de nombres, correos o usuarios y escribir los resultados en columnas de destino. Usa el panel lateral para un rango de filas y las fórmulas GENDER.FROM_* para cálculos vinculados a celdas.
El complemento de Excel utiliza campos de la API anterior. No devuelve los objetos data y meta de REST V2; configura las asignaciones según su salida real.
Empieza con un rango pequeño de filas
- Instala GenderAPI desde la tienda de Microsoft y abre el panel de tareas en el libro. Revisa los permisos y las restricciones de tu organización.
- Guarda la clave API en el complemento y comprueba los créditos de la cuenta correcta.
- Elige name, email o username según la columna de origen. Define un rango pequeño de filas que no incluya el encabezado.
- Selecciona una columna de género y, si los necesitas, destinos de probabilidad, país y nombre encontrado. Mantén cada salida separada de los datos originales.
- Aplica el filtro de país solo si dispones de contexto fiable. Revisa la configuración antes de iniciar la muestra.
- Inspecciona los resultados identificados, desconocidos y fallidos antes de ampliar el rango. Conserva una copia del libro original.
Configura las entradas, el país y las columnas de salida
| Ajuste | Tipo | Descripción |
|---|---|---|
| Clave API | Credencial de cuenta | Guárdala en el ajuste de clave del complemento, no en celdas normales. |
| Método y origen | Opción y columna | Asocia name, email o username con la columna correspondiente. |
| Rango de filas | Números de fila | Empieza con un rango pequeño sin encabezados. |
| Filtro de país | País o columna opcional | Proporciona contexto conocido; este campo no determina una ubicación verificada. |
| Columnas de resultados | Referencias de columna | Destino para género y destinos opcionales para probabilidad, país y nombre encontrado. |
Interpreta las columnas de resultados
Conserva la entrada original junto al resultado. Una estimación a partir de un nombre no representa la declaración de género de la persona. El país devuelto tampoco verifica su residencia o nacionalidad.
- Antes de procesar todos los datos, revisa un resultado habitual, una entrada ambigua y una operación fallida.
- Una celda vacía, el texto null y un error de fórmula son valores diferentes. No ocultes los errores al normalizar resultados desconocidos.
- Usa expresiones neutrales para los casos inciertos y conserva la información aportada por la persona separada de las estimaciones.
| Salida | Tipo | Descripción |
|---|---|---|
| Gender | Texto o valor sin resolver | Conserva male o female cuando el resultado sea correcto. Mantén los casos sin resolver como desconocidos y revisa los mensajes de error por separado. |
| Probability | Número, si está disponible | Es un indicador del complemento; no equivale al campo confidence de V2 ni a una tasa de exactitud medida sobre tus datos. |
| Country | Texto, si está disponible | Contexto devuelto por la consulta. Consérvalo por separado del país verificado del cliente. |
| Found / normalized name | Texto, si está disponible | Nombre utilizado o extraído durante el procesamiento. Revísalo cuando el correo o el usuario sean ambiguos. |
Planifica los créditos y las nuevas ejecuciones
Una cuenta gratuita registrada de GenderAPI dispone de 200 créditos diarios. Esto no garantiza 200 resultados identificados en cualquier flujo. Comprueba el saldo de la clave y las opciones actuales de la herramienta antes de empezar.
El complemento y las herramientas de archivos tienen sus propios procesos. Los límites de lotes, las opciones de IA y los campos de coste de REST V2 no se aplican automáticamente a estas herramientas. Volver a ejecutar o recalcular puede generar nuevas solicitudes y consumir créditos.
Empieza con una muestra pequeña, conserva los resultados completados y revisa las filas fallidas antes de repetirlas. Si solo necesitas reparar la exportación o la escritura en el destino, reutiliza los resultados existentes.
Revisa los datos compartidos y los permisos
La integración transmite los valores necesarios para la consulta y solicita acceso al documento seleccionado. Revisa quién puede acceder al documento, la cuenta conectada y las columnas de resultados.
Guarda la clave en la configuración del complemento, no en celdas compartidas ni capturas. Consulta la política de privacidad para conocer el tratamiento y la conservación de datos; usar el complemento no significa que los datos permanezcan íntegramente en tu dispositivo.
Cuándo utilizar la API V2 directamente
Si necesitas controlar las opciones de IA o recibir estado, source, confidence_kind y usage para cada registro, configura una integración HTTP independiente. Sigue el contrato de solicitudes y respuestas V2: añadir nombres de campos V2 a una fórmula o al complemento no cambia su funcionamiento.
Preguntas frecuentes
¿Puedo consultar correos y usuarios en Excel?
Sí. Selecciona el método adecuado en el panel y asigna la columna de entrada. Revisa el nombre encontrado y los casos sin resolver antes de utilizar los resultados.
¿Conviene usar el panel lateral o una fórmula?
Usa el panel para procesar un rango y escribir resultados en columnas. Elige GENDER.FROM_* si necesitas cálculos vinculados a celdas y has considerado el efecto de los recálculos.
¿El nombre functions_v2.js significa que se usa REST V2?
No. Es el nombre del archivo del cliente de Excel. El cliente de fórmulas revisado utiliza endpoints y campos de respuesta de la API anterior.
¿Las estimaciones son datos verificados del cliente?
No. Consérvalas separadas de la información proporcionada por el cliente y utiliza expresiones neutrales en los casos desconocidos o inciertos.
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.