# Configurare un flusso di lavoro per le nuove righe di Google Sheets con GenderAPI

> Configura un flusso di lavoro del componente aggiuntivo, mappa le colonne e prova l'origine reale delle nuove righe. Gestisci i risultati unknown e gli aggiornamenti mancati.

Canonical HTML: https://www.genderapi.io/it/blog/come-identificare-il-genere-dei-clienti-in-google-sheets-in-tempo-reale

Last reviewed: 2026-09-28

## Mappa i nuovi record sulle colonne di risultato

Il componente aggiuntivo GenderAPI offre una schermata Workflows che mappa i nuovi record del foglio su una colonna del genere e su altre colonne di risultato facoltative. Configuralo per il foglio corretto e poi verifica un record realmente in arrivo prima di affidarti all'automazione.

Il flusso di lavoro proprio del componente aggiuntivo è separato da un'azione HTTP diretta con la V2. Attivazione, tempi e campi di output dipendono dal componente aggiuntivo installato e dall'account Google. Un aggiornamento immediato non è garantito per ogni origine di nuove righe.

## Crea e prova il flusso di lavoro

- Installa e apri il componente aggiuntivo GenderAPI, quindi apri Workflows dal menu della barra laterale.
- Scegli il foglio e la tua chiave API. Seleziona l'analisi name, email o username adatta alla colonna di origine.
- Mappa la colonna di origine su una colonna separata per il genere. Aggiungi destinazioni per probabilità, paese e nome trovato solo se ti servono.
- Controlla tutte le mappature prima di creare il flusso di lavoro. L'interfaccia impedisce conflitti tra colonne e può segnalare che un flusso di lavoro esiste già o che è stato raggiunto un limite.
- Aggiungi un record rappresentativo tramite lo stesso meccanismo usato dai tuoi dati di produzione. Verifica che i valori compaiano nella riga corretta e che nessun campo esistente sia stato sovrascritto.
- Prova un valore non risolto e un errore operativo, quindi decidi come individuare e verificare le righe mancanti o non riuscite.

- [Installa il componente aggiuntivo per Google Sheets](https://workspace.google.com/marketplace/app/gender_api_for_google_sheets_determines/712811575775)

## Configura i campi del flusso di lavoro del componente aggiuntivo

| Impostazione | Tipo | Uso |
| --- | --- | --- |
| Chiave API | Credenziale | Scegli l'account corretto e verifica i crediti disponibili. |
| Foglio | Selezione del foglio | Il foglio i cui record questo flusso di lavoro deve elaborare. |
| Metodo | Scelta | name, email o username. Il metodo scelto determina come viene interpretato l'input. |
| Colonna di origine | Riferimento di colonna | Il valore da analizzare in ogni record. |
| Colonna del genere | Riferimento di colonna | Una destinazione distinta dall'input e dagli altri risultati. |
| Probabilità, paese, nome trovato | Destinazioni facoltative | Colonne separate per i risultati aggiuntivi del componente aggiuntivo. |

## Verifica come arrivano realmente le righe nel foglio

Digitare un valore, inviare un modulo e importare record da un CRM sono eventi diversi. Secondo la documentazione di Google, le esecuzioni di script e le richieste API in genere non attivano i trigger installabili. La scheda pubblica del componente aggiuntivo non indica esattamente come è implementato: prova l'origine dati che intendi usare.

Non dare per scontato che un nuovo flusso di lavoro elabori a posteriori le righe esistenti. Per questi record scegli un intervallo nella barra laterale per l'elaborazione in batch e tieni traccia delle righe già elaborate.

Se un aggiornamento previsto non arriva, controlla il flusso di lavoro, le autorizzazioni, il saldo della chiave, le mappature delle colonne e gli errori della piattaforma prima di inviare di nuovo gli stessi record.

- [Limitazioni dei trigger installabili di Google](https://developers.google.com/apps-script/guides/triggers/installable)
- [Elabora in blocco le righe esistenti](https://www.genderapi.io/it/blog/come-determinare-il-genere-in-google-sheets-utilizzando-gender-api-add-on)

## Leggi le colonne di risultato

Conserva il valore originale accanto al risultato. Un'associazione basata sul nome non stabilisce il genere dichiarato dalla persona, e un paese restituito non dimostra né la residenza né la cittadinanza.

- Controlla un risultato ordinario, un input ambiguo e un'esecuzione non riuscita prima di elaborare l'intero set di dati.
- Una cella vuota, il testo null e un errore di formula sono valori diversi. Normalizza i risultati unknown in modo consapevole senza nascondere gli errori.
- Usa formulazioni neutre per i casi unknown o incerti e tieni le informazioni fornite dalla persona separate dalle previsioni.

| Risultato | Tipo | Uso |
| --- | --- | --- |
| Gender | Testo o valore non risolto | Conserva male o female solo in caso di risultato riuscito. Salva un valore non risolto come unknown e verifica separatamente i messaggi di errore. |
| Probability | Numero, se disponibile | Un indicatore di confidenza storico. Non corrisponde né al campo confidence della V2 né a un'accuratezza misurata sui tuoi dati. |
| Country | Testo, se disponibile | Contesto restituito dalla ricerca. Conservalo separato dal paese verificato del cliente. |
| Found / normalized name | Testo, se disponibile | Il nome usato o estratto durante l'elaborazione. Verificalo quando un indirizzo email o un nome utente è ambiguo. |

- [Valori di confidenza e limiti](https://www.genderapi.io/it/accuracy-methodology)

## Pianifica crediti, limiti e nuove esecuzioni

Un account GenderAPI gratuito registrato include 200 crediti al giorno. Si tratta di un saldo dell'account, non della promessa di 200 risultati identificati in ogni flusso di lavoro. Prima di iniziare, verifica il saldo della chiave selezionata e le opzioni di elaborazione attuali dello strumento.

I componenti aggiuntivi e l'elaborazione dei file seguono percorsi di elaborazione propri. Il limite dei batch dell'API REST V2, le opzioni IA e i campi di addebito delle singole richieste non si applicano automaticamente a questi strumenti. Una nuova esecuzione o un ricalcolo può inviare nuove richieste e consumare crediti: non dare per scontato che sia gratuito.

Inizia con un piccolo campione, salva i risultati ottenuti e verifica le righe non riuscite prima di ripetere l'esecuzione. Se devi solo correggere un'esportazione o un aggiornamento nella destinazione, riutilizza i risultati che hai già.

- [Piani e crediti dell'account](https://www.genderapi.io/it/price)

## Quando usare direttamente l'API V2

Configura un'integrazione HTTP separata se la tua applicazione richiede opzioni IA esplicite e le informazioni status, source, confidence_kind e usage della V2 per ogni elemento. Segui il contratto di richiesta e risposta della V2: aggiungere nomi di campi V2 a una formula propria o a un componente aggiuntivo esistente non ne modifica il comportamento.

- [Flusso HTTP con la V2 in Make](https://www.genderapi.io/it/blog/make-gender-api-integration)
- [Flusso HTTP con la V2 in Zapier](https://www.genderapi.io/it/blog/zapier-gender-api-integration)
- [Parametri della richiesta](https://www.genderapi.io/it/docs/v2/request-parameters)

## Ogni importazione da CRM attiva il flusso di lavoro del componente aggiuntivo?

Non darlo per scontato. Prova un record proveniente dal CRM o dall'automazione che usi realmente. Google distingue tra modifiche manuali, invii di moduli e aggiornamenti tramite API. Verifica il comportamento del componente aggiuntivo installato.

## Posso elaborare le righe già presenti nel foglio?

Scegli un intervallo nella barra laterale per l'elaborazione in batch. Creare un flusso di lavoro per le nuove righe non comporta l'elaborazione dei record esistenti.

## Quanti flussi di lavoro posso creare?

L'interfaccia può segnalare un limite, ma questa guida non indica un numero non verificato. Controlla la versione installata e, se necessario, elimina i flussi di lavoro che non ti servono più.

## Come ottengo i campi source e usage della V2?

Crea un'integrazione HTTP separata con la V2, ad esempio seguendo la guida documentata per Make o Zapier. Non dare per scontato che le colonne del componente aggiuntivo contengano la struttura di risposta della V2.

## Documentazione di riferimento

- [Scheda ufficiale del componente aggiuntivo per Google Sheets](https://workspace.google.com/marketplace/app/gender_api_for_google_sheets_determines/712811575775)
- [Trigger installabili in Google Apps Script](https://developers.google.com/apps-script/guides/triggers/installable)
- [Quote di Google Apps Script](https://developers.google.com/apps-script/guides/services/quotas)
- [Piani e crediti di GenderAPI](https://www.genderapi.io/it/price)
- [Informativa sulla privacy di GenderAPI](https://www.genderapi.io/it/privacy-policy)
- [Contratto delle richieste V2](https://www.genderapi.io/it/docs/v2/request-parameters)