Procesa las filas seleccionadas desde el panel lateral
El complemento GenderAPI para Google Sheets lee una columna de nombres, correos o usuarios y escribe los campos de resultado seleccionados. El panel lateral permite procesar un rango concreto y guardar valores sin mantener una fórmula en cada celda.
Este flujo utiliza el proceso propio del complemento. Sus columnas y su comportamiento por lotes son independientes del formato de respuesta público de REST V2.
Instala, conecta y empieza con una muestra pequeña
- Instala el complemento desde Marketplace y revisa los permisos. En Google Sheets, abre Extensiones (Extensions) → GenderAPI → Determine Gender.
- Selecciona o introduce la clave de GenderAPI en el panel lateral y comprueba los créditos disponibles.
- Elige la hoja y el método name, email o username adecuado. Selecciona la columna de origen y un rango pequeño que excluya los encabezados.
- Elige una columna separada para el género. Añade probability, country y el nombre encontrado solo si los necesitas; conserva los valores originales.
- Si dispones de contexto de país fiable, usa el ajuste de país o una columna de códigos. No deduzcas ese contexto de la misma predicción que vas a solicitar.
- Revisa la opción para omitir resultados existentes. Ejecuta la muestra e inspecciona los resultados antes de ampliar el rango.
Asigna las entradas y las columnas de destino
| Ajuste | Tipo | Selección y descripción |
|---|---|---|
| Clave API | Credencial de cuenta | Comprueba que la clave elegida sea válida y tenga saldo. |
| Método | Opción | name, email o username según la columna de origen. |
| Hoja y rango de filas | Hoja y números de fila | Selecciona solo las filas que procesarás; excluye los encabezados. |
| Columna de origen | Referencia de columna | Una columna de entrada para el método seleccionado. |
| Contexto de país | Ajuste o columna opcional | Utiliza códigos fiables de dos letras cuando dispongas de ellos. |
| Columnas de resultados | Referencias de columna | El género es el destino principal; probabilidad, país y nombre encontrado son opcionales. |
| Omitir resultados existentes | Casilla | Revisa el ajuste para evitar sobrescribir filas completadas al repetir la operación. |
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
¿Necesito escribir código?
No. Selecciona el método, el rango y las columnas en el panel lateral. Si necesitas campos específicos de V2, utiliza una integración HTTP independiente.
¿Puedo procesar filas existentes?
Sí. Elige un rango concreto en el panel lateral. No supongas que un flujo para filas nuevas procesará automáticamente los registros anteriores.
¿El complemento devuelve una respuesta JSON V2?
El complemento escribe los campos elegidos en columnas. No se debe asumir que esas salidas coincidan con la estructura de respuesta V2.
¿Qué hago si no se encuentra un resultado?
Conserva el caso como desconocido y utiliza expresiones neutrales. Distingue primero un resultado sin resolver de un error operativo; revisa la entrada antes de repetirlo.
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.