Procesa un archivo desde el panel de tu cuenta
La herramienta de archivos de GenderAPI lee la hoja, permite asignar la columna de nombres, correos o usuarios y prepara resultados CSV. Puedes utilizarla sin desarrollar una integración API.
Este flujo del panel es independiente de las solicitudes por lotes de REST V2. Un archivo no es una solicitud JSON V2 y sus límites de elementos y rutas de respuesta no se aplican directamente a este proceso.
Formatos aceptados por el selector de archivos
El selector acepta un archivo cada vez. Si contiene varias hojas, elige la que procesarás y comprueba los valores leídos. Convierte los formatos no admitidos a uno de los listados antes de subirlos.
La complejidad del archivo, las filas, el método, los créditos y la carga del servicio influyen en el tiempo. Prueba un archivo representativo; no se garantiza un tamaño fijo ni un plazo de finalización.
| Formato | Extensión admitida |
|---|---|
| CSV | .csv |
| Excel | .xls, .xlsx |
| Apple Numbers | .numbers |
| OpenDocument | .ods |
| Valores separados por tabulaciones | .tsv |
| Texto | .txt |
Revisa las sugerencias de columnas antes de procesar
- Prepara una copia que contenga solo los datos necesarios. Usa una columna de entrada con encabezado claro y, si procede, otra con códigos de país fiables de dos letras.
- Inicia sesión y abre la herramienta Excel y CSV. Selecciona la clave, el archivo y la hoja que utilizarás.
- Durante la configuración de la hoja, la herramienta puede enviar celdas de muestra para sugerir columnas mediante IA. Revisa personalmente el método y las columnas sugeridas antes de continuar.
- Elige nombres, correos o usuarios y verifica la entrada y el país opcional. Revisa los controles de IA y exportación disponibles en la pantalla.
- Inicia el proceso y sigue el progreso. No envíes repetidamente el mismo archivo solo porque todavía no haya terminado.
- Descarga el CSV cuando esté listo. Comprueba la correspondencia de filas y los registros identificados, desconocidos y fallidos. Conserva el original para comparar.
Ajustes del procesamiento de archivos
| Ajuste | Tipo | Descripción |
|---|---|---|
| Clave API | Credencial de cuenta | Cuenta cuyo saldo se utilizará para el proceso. |
| Archivo y hoja | Selección de archivo | Un archivo admitido y su hoja correspondiente. |
| Método | Opción | name, email o username. Revisa la sugerencia automática. |
| Columna de origen | Asignación de columna | Entrada que se analizará por fila; comprueba el encabezado y los ejemplos. |
| Contexto de país | Columna o ajuste opcional | Códigos conocidos de dos letras, cuando sean pertinentes. |
| IA y exportación | Controles actuales de la herramienta | Revisa los ajustes visibles antes de empezar; no son los parámetros ai_mode de V2. |
Interpreta las columnas de resultados
El CSV exportado incorpora gender, country, probability y found_name. Comprueba los encabezados y la correspondencia de filas antes de importarlo en otro sistema. La salida es CSV aunque la entrada sea Excel.
Los resultados son estimaciones. Consérvalos separados de la declaración de género de la persona y de su país verificado.
- 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.
Ten en cuenta el análisis inicial y la conservación del archivo
Seleccionar una hoja puede enviar celdas de muestra para asignar columnas mediante IA antes del procesamiento final. No supongas que todos los datos permanecen en tu dispositivo hasta pulsar Iniciar. Elimina columnas innecesarias y revisa la política de privacidad antes de elegir un archivo con datos personales.
Si no necesitas la copia del espacio de trabajo después de descargarla, utiliza la opción de eliminación. La política vigente explica la retirada programada del sistema activo y la conservación en copias de seguridad; una fecha programada no demuestra que todas las copias ya se hayan borrado.
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 subir un archivo XLSM?
El selector actual enumera CSV, XLS, XLSX, Numbers, ODS, TSV y TXT. Convierte XLSM a uno de esos formatos y comprueba los valores obtenidos.
¿Las sugerencias de columnas siempre son correctas?
No. Comprueba el tipo de entrada, los encabezados, la columna de origen y el país. Durante la configuración pueden enviarse muestras para sugerencias mediante IA.
¿Recibiré de vuelta el archivo Excel original?
El proceso documentado genera CSV. Revisa las columnas y las filas antes de trasladarlo al libro original o a otra herramienta.
¿Equivale a una solicitud batch de V2?
No. Es un trabajo de archivos con opciones y procesamiento propios del panel. Consulta la documentación batch de V2 si estás construyendo una integración JSON independiente.
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.