Mappa i campi con l'estensione per Airtable
L'estensione GenderAPI legge un nome o un indirizzo email da un campo scelto e scrive la previsione del genere in un campo di destinazione separato. Puoi anche mappare paese, probability e nome trovato, e saltare i record il cui campo di destinazione del genere contiene già un valore.
Il codice dell'estensione, esaminato il 27 settembre 2026, usa gli endpoint V1 per nomi e indirizzi email e i relativi campi di risposta di primo livello. Questa guida descrive quel flusso di lavoro nativo. L'estensione installata può cambiare indipendentemente dalla guida: verifica le impostazioni disponibili prima di applicare le mappature seguenti.
Collega la base e prepara i campi
- Apri la base corretta, aggiungi GenderAPI.io da Extensions e avvia l'estensione. Completa i passaggi di connessione mostrati dall'estensione.
- Scegli la chiave i cui crediti verranno usati. Verifica il saldo residuo e che appartenga all'account GenderAPI corretto.
- Scegli la tabella e il campo di origine con i nomi o gli indirizzi email. Mantieni l'input originale in quel campo e crea campi separati per i risultati.
- Seleziona il campo di destinazione obbligatorio per il genere ed eventuali destinazioni aggiuntive. Usa un campo percent per un valore percentuale formattato o un campo numerico per mantenere la scala originale di probability.
- Decidi se conservare i campi di destinazione del genere già compilati. L'opzione per saltarli conserva anche i valori di testo non risolti di un'esecuzione precedente. Cancella quindi solo i risultati che vuoi deliberatamente elaborare di nuovo.
Mappa input e output dell'estensione
Il campo di origine può contenere sia nomi sia indirizzi email. Nell'implementazione esaminata, un valore che contiene @ segue il percorso email; questa regola di instradamento non verifica che la casella di posta esista.
| Impostazione dell'estensione | Obbligatoria | Valore e comportamento |
|---|---|---|
| Chiave dei crediti | Sì | La chiave dell'account GenderAPI selezionato fornisce i crediti per le richieste elaborate. |
| Tabella e campo di origine | Sì | La cella di origine contiene un nome o un indirizzo email. Le celle di origine vuote vengono saltate. |
| Campo di destinazione del genere | Sì | Riceve il campo nativo gender. Tieni un valore non risolto separato da male e female. |
| Campo di destinazione del paese | No | Riceve il valore country restituito. È una colonna di output, non un filtro paese per la richiesta. |
| Campo di destinazione di probability | No | Riceve il valore probability dell'API legacy. Un campo percent riceve il valore diviso per 100; un campo numerico mantiene la scala originale. |
| Campo di destinazione Found Name | No | Riceve il nome restituito dall'API nativa, quando disponibile. Tieni questo candidato dedotto separato dal valore di origine. |
| Salta i campi del genere compilati | No | Conserva i record il cui campo di destinazione contiene già un valore, compreso il testo non risolto. Controlla lo stato dell'opzione prima di ogni esecuzione. |
Prova un piccolo batch prima di elaborare la tabella
Inizia con una piccola tabella di prova che contenga un nome, un indirizzo email, una cella vuota e un input ambiguo. Verifica i campi di destinazione scelti e come Airtable mostra la scala di probability prima di elaborare la tabella principale.
Nel codice esaminato, i valori predefiniti non risolti possono comparire come testo null e probability 0. Anche alcune risposte native non riuscite possono lasciare questi valori predefiniti, mentre un errore di connessione può lasciare un record invariato. Controlla lo stato dell'esecuzione e le righe interessate: il solo testo null non dimostra che la ricerca sia riuscita.
Controlla i valori esistenti dopo l'esecuzione. Conserva i risultati non risolti per la verifica invece di assegnare tu stesso un genere. Una previsione basata sul nome non conferma l'identità di genere di una persona, e un paese restituito non dimostra dove qualcuno risiede.
| Cosa vedi | Cosa fare |
|---|---|
| Risultato atteso nelle colonne previste | Conserva l'input originale e i campi aggiuntivi, così la mappatura resta verificabile. |
| Testo null o probability 0 | Lascia il caso non risolto e controlla lo stato dell'elaborazione prima di decidere una nuova ricerca. |
| Un campo di destinazione già compilato è rimasto invariato | Controlla l'opzione per saltare; la conservazione del valore può essere intenzionale. |
| Messaggio su chiave o crediti, oppure risultato invariato dopo un errore | Risolvi il problema dell'account o della connessione e individua i record interessati prima di riavviare. |
Tieni sotto controllo i crediti consumati e le nuove esecuzioni
L'estensione nativa cerca i valori uno alla volta con la chiave GenderAPI selezionata. Una nuova esecuzione sugli stessi record non saltati può inviare nuove richieste e consumare di nuovo crediti. Il piano di Airtable e la disponibilità dell'estensione sono separati da questo saldo dell'account.
L'output nativo non espone né data/meta della risposta V2, né una scelta esplicita della modalità IA, né un oggetto usage per elemento, né il contratto batch della V2. Usa la documentazione V1 per questo flusso di lavoro e l'alternativa API separata descritta sotto quando ti servono queste impostazioni.
L'estensione invia i valori mappati per l'elaborazione e riscrive i risultati nella tua base. Verifica l'informativa pubblicata sul trattamento dei dati e le autorizzazioni dell'estensione per i record interessati; non includere campi non pertinenti nella mappatura di origine.
Usa la V2 quando ti serve una risposta strutturata
Per un'integrazione personalizzata, GenderAPI V2 accetta nomi, indirizzi email e nomi utente e restituisce campi espliciti per risultato, confidenza, origine e consumo. Configura quella connessione separatamente: leggere la guida V2 non modifica l'app installata né le sue colonne di output.
Gli esempi in Python e Node.js coprono richieste singole, batch, risultati unknown ed errori operativi. Inizia dalla guida all'autenticazione e scegli la modalità IA prima di inviare una richiesta soggetta ad addebito.
Domande frequenti
L'estensione per Airtable usa GenderAPI V2?
Il codice dell'estensione, esaminato il 27 settembre 2026, usa gli endpoint V1 per nomi e indirizzi email. Una connessione V2 personalizzata ha campi di richiesta e di risposta diversi; non aggiorna l'estensione installata.
Un campo di origine può contenere sia nomi sia indirizzi email?
Sì. L'estensione esaminata invia i valori non vuoti che contengono @ alla ricerca per email e gli altri valori alla ricerca per nome. È un instradamento dell'input, non una verifica della casella di posta.
Perché probability appare diverso in un campo percentuale?
L'estensione divide per 100 il valore probability dell'API legacy per un campo percent di Airtable, così Airtable può mostrarlo come percentuale. Un campo numerico mantiene la scala originale; non è il campo confidence della V2.
L'opzione per saltare conserva i risultati non risolti?
Sì, quando il campo di destinazione contiene già un valore, compreso il testo null di un'esecuzione precedente. Verifica quei record e cancella solo i valori che vuoi deliberatamente elaborare di nuovo.
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.