Traitez les lignes sélectionnées depuis le panneau latéral
Le module complémentaire GenderAPI pour Google Sheets lit une colonne de prénoms, d’e-mails ou de noms d’utilisateur et écrit les champs de résultat choisis dans votre feuille. Le panneau latéral permet de traiter une plage précise et d’enregistrer les valeurs sans conserver une formule dans chaque cellule.
Il s’agit du flux natif du module. Ses colonnes de résultat et son traitement par lots sont indépendants du format de réponse public de REST V2.
Installez, connectez et testez un petit échantillon
- Installez le module depuis sa fiche Google Workspace Marketplace et examinez les autorisations demandées. Dans Google Sheets, ouvrez Extensions → GenderAPI → Determine Gender.
- Sélectionnez votre clé GenderAPI ou saisissez-la dans le panneau latéral. Vérifiez que le compte choisi dispose de crédits.
- Choisissez la feuille et la méthode name, email ou username. Sélectionnez la colonne source correspondante et une petite plage de lignes sans l’en-tête.
- Choisissez une colonne distincte pour le genre et, si nécessaire, des colonnes pour la probabilité, le pays et le prénom trouvé. N’écrasez pas les valeurs d’origine.
- Si vous disposez d’un contexte de pays fiable, utilisez le réglage de pays ou une colonne de codes pays. Ne déduisez pas ce contexte de la prédiction que vous allez demander.
- Vérifiez l’option qui ignore les résultats existants, lancez le traitement et contrôlez les lignes choisies avant d’élargir la plage.
Associez les entrées et les destinations
| Réglage | Type | Choix et description |
|---|---|---|
| Clé API | Identifiant du compte | Utilisez la clé sélectionnée dans le module ; vérifiez sa validité et son solde. |
| Méthode | Choix | name, email ou username, selon la colonne source. |
| Feuille et plage de lignes | Feuille et numéros de ligne | Ne sélectionnez que les lignes à traiter et excluez la ligne d’en-tête. |
| Colonne source | Référence de colonne | L’unique colonne d’entrée pour la méthode choisie. |
| Contexte de pays | Réglage ou colonne facultatifs | Utilisez des codes pays fiables à deux lettres lorsque vous en disposez. |
| Colonnes de résultat | Références de colonnes | Le genre est la destination principale ; la probabilité, le pays et le prénom trouvé sont facultatifs. |
| Ignorer les résultats existants | Case à cocher | Vérifiez ce réglage pour qu’une relance ne remplace pas involontairement des lignes déjà complétées. |
Interprétez les colonnes de résultat
Conservez la valeur d’origine à côté du résultat. Une estimation fondée sur un prénom n’établit pas le genre déclaré par la personne, et le pays renvoyé ne vérifie ni sa résidence ni sa nationalité.
- Avant de traiter l’ensemble des données, examinez un résultat courant, une entrée ambiguë et une opération en échec.
- Une cellule vide, le texte null et une erreur de formule sont des valeurs différentes. Normalisez les résultats inconnus sans masquer les erreurs.
- Employez une formulation neutre pour les cas inconnus ou incertains et conservez les informations fournies par la personne séparément des estimations.
| Sortie | Type | Utilisation |
|---|---|---|
| Gender | Texte ou valeur non résolue | Conservez male ou female uniquement pour un résultat abouti. Gardez une valeur non résolue comme inconnue et examinez les messages d’erreur séparément. |
| Probability | Nombre, si disponible | Indicateur de confiance historique ; il ne correspond ni au champ confidence de V2 ni à un taux d’exactitude mesuré sur vos données. |
| Country | Texte, si disponible | Contexte renvoyé par la recherche. Conservez-le séparément du pays vérifié du client. |
| Found / normalized name | Texte, si disponible | Prénom utilisé ou extrait pendant le traitement. Vérifiez-le lorsque l’e-mail ou le nom d’utilisateur est ambigu. |
Prévoyez les crédits, les limites et les nouvelles exécutions
Un compte GenderAPI gratuit enregistré dispose de 200 crédits par jour. Il s’agit d’un solde de compte, pas d’une promesse de 200 résultats identifiés dans chaque flux. Vérifiez le solde de la clé choisie et les options de traitement actuelles de l’outil avant de commencer.
Les extensions natives et les traitements de fichiers suivent leurs propres circuits. La limite de lot de REST V2, les options d’IA et les champs de facturation par requête ne s’y appliquent pas automatiquement. Une nouvelle exécution ou un recalcul peut soumettre de nouvelles requêtes et consommer des crédits : ne supposez pas qu’ils sont gratuits.
Commencez par un petit échantillon, conservez les résultats obtenus et examinez les lignes en échec avant de relancer. Si vous devez seulement corriger un export ou une mise à jour de la destination, réutilisez les résultats existants.
Choisissez les données que vous partagez
Les intégrations de tableur transmettent les valeurs nécessaires aux recherches et demandent l’autorisation d’accéder au document sélectionné. Vérifiez qui a accès au classeur, le compte connecté et les colonnes de destination avant de traiter des données personnelles.
Enregistrez la clé API dans les paramètres du module ou du complément, pas dans des cellules ordinaires, des captures d’écran ou des exemples partagés. La politique de confidentialité publiée décrit le traitement des entrées, leur conservation et les journaux ; une intégration de tableur ne signifie pas que les données restent entièrement sur votre appareil.
Quand utiliser directement l’API V2
Configurez une intégration HTTP distincte lorsque votre application a besoin d’options d’IA explicites et, pour chaque élément, des informations status, source, confidence_kind et usage de V2. Suivez le contrat de requête et de réponse V2 : ajouter des noms de champs V2 à une formule native ou à une extension existante ne modifie pas son fonctionnement.
Questions fréquentes
Dois-je écrire du code pour utiliser le panneau latéral ?
Non. Installez le module, connectez une clé et associez les colonnes source et de résultat. Une intégration directe à l’API V2 est une option distincte pour les applications sur mesure.
Puis-je traiter des lignes existantes ?
Oui. Utilisez les réglages de feuille et de plage de lignes du panneau latéral. Vérifiez l’en-tête, le type d’entrée, les colonnes de destination et l’option relative aux résultats existants avant de lancer le traitement.
Les colonnes de résultat correspondent-elles à la réponse JSON V2 ?
Non. Le traitement natif écrit les champs pris en charge dans la feuille. Les objets data et meta ainsi que source et confidence_kind relèvent du contrat de l’API REST V2 directe.
Que faire d’un résultat inconnu ?
Conservez-le comme inconnu et distinguez-le d’une opération en échec. Examinez les entrées ambiguës et utilisez une formulation neutre plutôt que d’attribuer automatiquement un genre.
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.