Associez les champs avec l’extension Airtable
L’extension GenderAPI lit un prénom ou un e-mail dans le champ choisi et écrit l’estimation du genre dans une destination distincte. Vous pouvez aussi associer le pays, la probabilité et un prénom trouvé, puis ignorer les enregistrements dont la destination de genre contient déjà une valeur.
Le code de l’extension examiné le 27 septembre 2026 utilise les endpoints V1 pour les prénoms et les e-mails ainsi que leurs champs de réponse de premier niveau. Ce guide décrit ce flux natif. Une extension installée peut évoluer indépendamment : vérifiez les contrôles disponibles avant d’appliquer les associations ci-dessous.
Connectez la base et préparez les champs
- Ouvrez la base concernée, ajoutez GenderAPI.io depuis Extensions et lancez-la. Suivez les étapes de connexion affichées par l’extension.
- Choisissez la clé dont les crédits seront utilisés. Vérifiez son solde restant et le compte GenderAPI associé.
- Sélectionnez la table et un champ source contenant des prénoms ou des e-mails. Conservez l’entrée d’origine dans ce champ et créez des champs de résultat distincts.
- Sélectionnez la destination obligatoire du genre et les destinations complémentaires utiles. Utilisez un champ percent pour un pourcentage formaté ou un champ numérique pour conserver l’échelle d’origine de la probabilité.
- Décidez si les destinations de genre déjà remplies doivent être préservées. L’option d’omission préserve aussi les textes non résolus d’une exécution précédente : n’effacez que les résultats que vous souhaitez délibérément retraiter.
Associez les entrées et les sorties de l’extension
Le champ source peut mélanger prénoms et e-mails. Dans l’implémentation examinée, une valeur contenant @ suit le circuit des e-mails ; cette règle d’aiguillage ne vérifie pas que la boîte aux lettres existe.
| Réglage de l’extension | Obligatoire | Valeur et comportement |
|---|---|---|
| Clé de crédits | Oui | La clé du compte GenderAPI sélectionné fournit les crédits des requêtes traitées. |
| Table et champ source | Oui | La cellule source fournit un prénom ou un e-mail. Les cellules source vides sont ignorées. |
| Destination du genre | Oui | Reçoit le champ gender natif. Gardez une valeur non résolue séparée de male et female. |
| Destination du pays | Non | Reçoit la valeur country renvoyée. C’est une colonne de sortie, pas un filtre pays pour la requête. |
| Destination de la probabilité | Non | Reçoit la valeur probability de l’ancienne API. Un champ percent reçoit la valeur divisée par 100 ; un champ numérique conserve l’échelle d’origine. |
| Destination Found Name | Non | Reçoit le prénom renvoyé par l’API native lorsqu’il existe. Gardez ce candidat estimé séparé de la valeur source. |
| Ignorer les champs de genre remplis | Non | Préserve les enregistrements dont la destination contient déjà une valeur, y compris un texte non résolu. Vérifiez l’état de cette option avant chaque exécution. |
Testez un petit lot avant de traiter la table
Commencez par une petite table de test contenant un prénom, un e-mail, une cellule vide et une entrée ambiguë. Vérifiez les champs de destination choisis et la façon dont Airtable affiche l’échelle de probabilité avant de traiter votre table principale.
Dans le code examiné, les valeurs par défaut non résolues peuvent apparaître sous la forme du texte null et d’une probabilité de 0. Certaines réponses natives en échec peuvent aussi laisser ces valeurs par défaut, tandis qu’une erreur de connexion peut laisser l’enregistrement inchangé. Examinez l’état de l’exécution et les lignes concernées : le texte null seul ne prouve pas qu’une recherche a abouti.
Contrôlez les valeurs existantes après l’exécution. Conservez les résultats non résolus pour examen plutôt que d’attribuer vous-même un genre. Une prédiction fondée sur un prénom ne vérifie pas l’identité de genre d’une personne, et le pays renvoyé ne prouve pas sa résidence.
| Ce que vous voyez | Que faire |
|---|---|
| Un résultat attendu dans les colonnes prévues | Conservez l’entrée d’origine et les champs complémentaires pour que l’association reste vérifiable. |
| Texte null ou probabilité de 0 | Laissez le cas non résolu et vérifiez l’état du traitement avant de décider d’une nouvelle recherche. |
| Une destination déjà remplie est restée inchangée | Vérifiez l’option d’omission ; cette préservation peut être voulue. |
| Message de clé ou de crédits, ou résultat inchangé après une erreur | Résolvez le problème de compte ou de connexion et identifiez les enregistrements concernés avant de relancer. |
Maîtrisez les crédits utilisés et les relances
L’extension native interroge les valeurs une par une avec la clé GenderAPI sélectionnée. Relancer les mêmes enregistrements non ignorés peut soumettre de nouvelles requêtes et consommer à nouveau des crédits. L’offre Airtable et la disponibilité des extensions sont indépendantes de ce solde.
La sortie native n’expose ni la réponse data/meta de V2, ni le choix explicite du mode d’IA, ni l’objet usage par élément, ni le contrat batch de V2. Utilisez la référence V1 pour ce flux et l’option API distincte ci-dessous lorsque ces contrôles sont nécessaires.
L’extension envoie les valeurs associées pour traitement et réécrit les résultats dans votre base. Consultez la politique de traitement des données publiée et les autorisations de l’extension pour les enregistrements concernés ; n’incluez pas de champs sans rapport dans l’association source.
Utilisez V2 lorsque vous avez besoin d’une réponse structurée
Pour une intégration sur mesure, GenderAPI V2 accepte des prénoms, des e-mails et des noms d’utilisateur et renvoie des champs explicites de résultat, de confiance, de source et de consommation. Configurez cette connexion séparément : consulter le guide V2 ne modifie ni une application installée ni ses colonnes de sortie.
Les exemples Python et Node.js couvrent les requêtes unitaires, les lots, les résultats inconnus et les erreurs opérationnelles. Commencez par le guide d’authentification et choisissez votre mode d’IA avant d’envoyer une requête facturable.
Questions fréquentes
L’extension Airtable utilise-t-elle GenderAPI V2 ?
Le code de l’extension examiné le 27 septembre 2026 utilise les endpoints V1 pour les prénoms et les e-mails. Une connexion V2 sur mesure possède d’autres champs de requête et de réponse ; elle ne met pas à niveau l’extension installée.
Un même champ source peut-il contenir des prénoms et des adresses e-mail ?
Oui. L’extension examinée envoie les valeurs non vides contenant @ vers la recherche par e-mail et les autres vers la recherche par prénom. Il s’agit d’un aiguillage des entrées, pas d’une vérification de la boîte aux lettres.
Pourquoi la probabilité paraît-elle différente dans un champ de pourcentage ?
L’extension divise la valeur probability de l’ancienne API par 100 pour un champ percent d’Airtable, afin qu’Airtable l’affiche en pourcentage. Une destination numérique conserve l’échelle d’origine ; ce n’est pas le champ confidence de V2.
L’option d’omission préserve-t-elle les résultats non résolus ?
Oui, lorsque la destination contient déjà une valeur, y compris le texte null d’une exécution précédente. Examinez ces enregistrements et n’effacez que les valeurs que vous souhaitez délibérément traiter à nouveau.
Documentation de référence
Dernière révision de ce guide : . Consultez la documentation de la plateforme pour l’installation, et la référence API liée pour une intégration V2 distincte.