Arricchisci le righe di Excel dalla barra laterale
Con il componente aggiuntivo GenderAPI per Excel scegli una colonna di nomi, indirizzi email o nomi utente e scrivi i risultati in colonne mappate del foglio di lavoro. Usa la barra laterale per un intervallo di righe controllato oppure le funzioni GENDER.FROM_* per calcoli legati alle celle.
Il client nativo di Excel usa i campi dell'API legacy. Non restituisce gli oggetti data e meta della REST V2; mantieni le mappature esistenti della cartella di lavoro allineate all'output effettivo del componente aggiuntivo.
Configura prima un piccolo intervallo di righe
- Installa GenderAPI dalla sua scheda nel catalogo Microsoft e apri la barra laterale del componente aggiuntivo nella cartella di lavoro. Verifica le autorizzazioni di accesso al documento ed eventuali restrizioni della tua organizzazione.
- Salva la tua chiave GenderAPI nel componente aggiuntivo e verifica che l'account scelto disponga di crediti.
- Scegli il metodo name, email o username e la colonna di origine corrispondente. Imposta un piccolo intervallo di righe, esclusa la riga di intestazione.
- Mappa la colonna di destinazione del genere e, se necessario, le colonne per probability, paese e nome trovato. Tieni ogni risultato separato dai dati di origine.
- Imposta un contesto di paese solo quando è affidabile per i dati che stai elaborando. Verifica le impostazioni scelte ed esegui il campione.
- Esamina le righe identificate, non risolte e non riuscite prima di estendere l'intervallo. Conserva una copia dei dati originali della cartella di lavoro.
Scegli input, contesto e colonne dei risultati
| Impostazione | Tipo | Descrizione |
|---|---|---|
| Chiave API | Credenziale dell'account | Salvata tramite il campo della chiave nel componente aggiuntivo; non inserirla nelle normali celle della cartella di lavoro. |
| Metodo e origine | Scelta e colonna | name, email o username insieme alla relativa colonna di origine. |
| Intervallo di righe | Numeri di riga | Inizia con un piccolo intervallo senza la riga di intestazione. |
| Filtro paese | Paese o colonna facoltativi | Indica un contesto di paese noto; il campo non attesta la posizione verificata della persona. |
| Colonne dei risultati | Riferimenti di colonna | Una colonna di destinazione per il genere e destinazioni facoltative per probability, paese e nome trovato. |
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. |
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à.
Scegli quali dati condividere
Le integrazioni per fogli di calcolo inviano i valori necessari alla ricerca e richiedono autorizzazioni sul documento selezionato. Prima di elaborare dati personali, verifica chi ha accesso al foglio di calcolo, quale account è collegato e quali colonne di destinazione vengono usate.
Conserva la chiave API nelle impostazioni del componente aggiuntivo, non in celle normali, screenshot o esempi condivisi. L'informativa sulla privacy pubblicata descrive come vengono trattati, conservati e registrati i dati di input. Un'integrazione per fogli di calcolo non significa che i dati restino esclusivamente sul tuo dispositivo.
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.
Domande frequenti
Posso analizzare indirizzi email e nomi utente in Excel?
Sì. Scegli il metodo corrispondente nella barra laterale e mappa la colonna di input corretta. Controlla il nome restituito e i casi non risolti prima di usare i risultati.
Devo usare la barra laterale o una formula?
Usa la barra laterale per elaborare un intervallo scelto e scrivere i valori nelle colonne mappate. Scegli le formule GENDER.FROM_* quando ti servono calcoli legati alle celle e tieni conto di cosa comporta il ricalcolo.
Il nome del file functions_v2.js significa che il componente aggiuntivo usa la REST V2?
No. È il nome di un file del client Excel. Il file pubblico delle formule esaminato per questa guida chiama endpoint dell'API legacy e ne legge i campi di risposta.
Le previsioni sono attributi verificati del cliente?
No. Tienile separate dalle informazioni fornite dal cliente e usa un'alternativa neutra per i risultati unknown o i casi incerti.
Documentazione di riferimento
La guida è stata verificata l'ultima volta il . Controlla l'installazione nella documentazione della piattaforma e usa la documentazione API collegata per un'integrazione V2 separata.