Conecta los registros nuevos con sus columnas de resultados
La pantalla de flujos del complemento GenderAPI permite asignar nuevos registros a columnas de género y otros resultados opcionales. Configura la hoja correspondiente y comprueba un registro procedente de tu fuente real antes de depender de la automatización.
Este flujo es independiente de un paso HTTP V2 directo. Los eventos, los tiempos y las salidas dependen del complemento instalado y de la cuenta de Google; no se garantiza una actualización inmediata para cualquier origen de filas nuevas.
Crea y prueba el flujo
- Instala y abre GenderAPI y entra en Workflows desde el panel lateral.
- Selecciona la hoja y la clave API. Elige name, email o username según los datos de origen.
- Asigna la columna de origen a una columna separada para el género. Añade destinos de probabilidad, país y nombre encontrado solo si los necesitas.
- Revisa las asignaciones antes de crear el flujo. La interfaz evita conflictos de columnas y puede advertir de un flujo existente o de un límite alcanzado.
- Añade un registro de prueba mediante el mismo método que usarás en producción. Comprueba que los resultados se escriban en la fila correcta y se conserven los demás campos.
- Prueba por separado un valor sin resolver y un error operativo. Define cómo detectarás las filas incompletas o fallidas.
Configura los campos del flujo
| Ajuste | Tipo | Descripción |
|---|---|---|
| Clave API | Credencial | Selecciona la cuenta y comprueba el saldo. |
| Hoja | Selección de hoja | Hoja cuyos registros se procesarán. |
| Método | Opción | name, email o username define cómo se interpreta la entrada. |
| Columna de origen | Referencia de columna | Valor que se analizará en cada registro. |
| Columna de género | Referencia de columna | Destino separado de la entrada y de las demás salidas. |
| Probabilidad, país y nombre encontrado | Destinos opcionales | Columnas separadas para los resultados adicionales del complemento. |
Prueba cómo llegan realmente las filas
Escribir manualmente, enviar un formulario y transferir registros desde un CRM mediante API son eventos distintos. Según Google, las ejecuciones de scripts y las solicitudes API generalmente no activan los disparadores instalables. La ficha pública del complemento no permite verificar su implementación exacta de eventos: prueba el origen que utilizarás.
No supongas que crear un flujo nuevo procesará las filas antiguas. Para registros existentes, selecciona un rango en el panel de procesamiento por lotes y lleva un control de las filas completadas.
Si no aparece la actualización esperada, revisa el flujo, los permisos, el saldo, las asignaciones de columnas y los errores de plataforma antes de volver a enviar los mismos registros.
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.
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
¿Toda importación desde un CRM activa el flujo?
No lo supongas. Prueba un registro desde el CRM o la automatización que usarás. Google distingue las ediciones, los formularios y las actualizaciones por API; verifica el comportamiento del complemento instalado.
¿Puedo procesar las filas antiguas de la hoja?
Selecciona un rango en el panel de procesamiento por lotes. Crear un flujo para filas nuevas no implica procesar los registros anteriores.
¿Cuántos flujos puedo crear?
La interfaz puede indicar que has alcanzado un límite. No damos un número sin verificar: comprueba la versión instalada y elimina los flujos que ya no necesites cuando corresponda.
¿Cómo obtengo source y usage de V2?
Configura una integración HTTP V2 independiente, como la descrita en las guías de Make o Zapier. No supongas que las columnas del complemento contengan la respuesta V2.
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.