# Formule GenderAPI per Microsoft Excel

> Usa GENDER.FROM_NAME, GENDER.FROM_EMAIL e GENDER.FROM_USERNAME in Excel. Verifica argomenti, valori predefiniti, output esteso ed errori comuni.

Canonical HTML: https://www.genderapi.io/it/blog/formula-genere-per-microsoft-excel

Last reviewed: 2026-09-28

## Scegli la funzione adatta ai tuoi dati di input

Installa il componente aggiuntivo GenderAPI per Excel, salva la tua chiave API nella sua barra laterale e usa GENDER.FROM_NAME per i nomi, GENDER.FROM_EMAIL per gli indirizzi email o GENDER.FROM_USERNAME per i nomi utente. Ogni funzione accetta prima l'input, poi un flag facoltativo per le informazioni aggiuntive e infine un contesto di paese facoltativo.

Queste formule native di Excel si basano sull'API legacy. La formula GENDER di Google Sheets ha una firma diversa, e l'API REST V2 diretta ha un proprio contratto JSON.

- [Installa il componente aggiuntivo per Excel](https://appsource.microsoft.com/en-us/product/office/WA200008555)
- [Configura la barra laterale in Excel](https://www.genderapi.io/it/blog/genderize-excel-names-using-genderapi-excel-add-in)

## Tre argomenti in ordine fisso

| Argomento | Tipo | Valore predefinito | Descrizione |
| --- | --- | --- | --- |
| `name / email / username` | Testo o riferimento di cella | Obbligatorio | L'input per la funzione scelta, ad esempio A2. |
| `enable_additional_info` | Booleano | FALSE | TRUE o 1 restituisce quattro colonne. Ometti l'argomento o usa FALSE/0 per ottenere solo il genere. |
| `country` | Testo | Nessun filtro paese | Codice paese facoltativo di due lettere, ad esempio IT, US, DE o TR. Se indichi questo terzo argomento, specifica anche il secondo. |

**Esempi di formule per Excel**

Ogni riga è un esempio distinto. Inserisci in A2 il nome, l'indirizzo email o il nome utente corrispondente. A seconda delle impostazioni internazionali di Excel, il separatore degli argomenti può essere il punto e virgola invece della virgola.

```text
=GENDER.FROM_NAME(A2)
=GENDER.FROM_NAME(A2, TRUE, "IT")
=GENDER.FROM_EMAIL(A2, TRUE)
=GENDER.FROM_USERNAME(A2, FALSE)
```

## L'output esteso di Excel usa quattro colonne

Senza informazioni aggiuntive, la formula restituisce solo il genere. Quando sono attivate, l'output documentato di Excel occupa una riga con genere, probability, paese e nome trovato, in questo ordine. Lascia vuote le tre celle a destra.

La formula di Google Sheets mette il paese prima di probability: non riutilizzare le sue intestazioni di colonna senza verificare l'ordine valido in Excel.

| Posizione | Output di Excel | Significato |
| --- | --- | --- |
| 1 | Gender | Genere identificato o valore non risolto. Gestisci separatamente gli errori operativi. |
| 2 | Probability | Segnale di confidenza dell'API legacy; non è confidence_kind della V2 né un'accuratezza misurata del modello. |
| 3 | Country | Contesto di paese restituito dalla ricerca, non un attributo verificato della persona. |
| 4 | Matched name | Controlla il nome usato o estratto, in particolare per indirizzi email e nomi utente. |

## Correggi gli errori di configurazione prima di copiare la formula verso il basso

Un ricalcolo può avviare una nuova ricerca. Se ti serve un'istantanea stabile, incolla i risultati completati come valori e conserva accanto i dati originali e la data della verifica.

| Sintomo | Cosa verificare |
| --- | --- |
| La funzione non è disponibile | Verifica che il componente aggiuntivo sia installato e disponibile in questa cartella di lavoro e in questo ambiente Excel. |
| La chiave API non è impostata | Apri la barra laterale di GenderAPI e salva la chiave. Una chiave scritta in una cella non sostituisce la credenziale salvata nel componente aggiuntivo. |
| Input vuoto | Controlla la cella a cui fa riferimento la formula e scegli la funzione corrispondente al tipo effettivo di input. |
| L'output esteso non viene visualizzato | Libera le celle di destinazione adiacenti necessarie senza sovrascrivere dati utili. |
| Messaggio di errore o unknown error | Verifica la connessione, lo stato dell'account e il messaggio restituito. Un errore operativo non è una previsione non risolta. |

## 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.

- [Parametri della richiesta](https://www.genderapi.io/it/docs/v2/request-parameters)
- [Campi della risposta V2](https://www.genderapi.io/it/docs/v2/responses)
- [Integrazione V2 con Python](https://www.genderapi.io/it/integrations/python)
- [Integrazione V2 con Node.js](https://www.genderapi.io/it/integrations/javascript)

## Posso usare =GENDER(A2) in Microsoft Excel?

Le funzioni documentate del componente aggiuntivo per Excel sono GENDER.FROM_NAME, GENDER.FROM_EMAIL e GENDER.FROM_USERNAME. La semplice formula GENDER appartiene al componente aggiuntivo per Google Sheets.

## Come indico un paese senza output aggiuntivo?

Lascia disattivato il secondo argomento, ad esempio =GENDER.FROM_NAME(A2, FALSE, "IT"). Il paese è il terzo argomento, non il secondo.

## Qual è il valore predefinito dell'impostazione per le informazioni aggiuntive?

Se l'argomento viene omesso, è disattivata. TRUE o 1 attiva l'output su quattro colonne: genere, probability, paese e nome trovato.

## Le funzioni restituiscono informazioni di addebito della V2?

No. Le formule native espongono i campi di risultato dell'API legacy. Usa un'integrazione V2 separata quando ti servono i metadati della richiesta, source, confidence_kind o il consumo per richiesta.

## Documentazione di riferimento

- [Scheda ufficiale del componente aggiuntivo in Microsoft AppSource](https://appsource.microsoft.com/en-us/product/office/WA200008555)
- [Documentazione della formula Excel: gender_from_name](https://excel.genderapi.io/help/gender_from_name.html)
- [Documentazione della formula Excel: gender_from_email](https://excel.genderapi.io/help/gender_from_email.html)
- [Documentazione della formula Excel: gender_from_username](https://excel.genderapi.io/help/gender_from_username.html)
- [Definizioni pubblicate delle funzioni Excel](https://excel.genderapi.io/functions_v2.json)
- [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)