# Formule GENDER dans Google Sheets : arguments et résultats

> Utilisez =GENDER pour les prénoms, e-mails et noms d’utilisateur. Consultez l’ordre des arguments, le filtre pays, les sorties étendues et l’effet des recalculs.

Canonical HTML: https://www.genderapi.io/fr/blog/formule-genre-google-sheets-detection-genre-noms

Last reviewed: 2026-09-28

## Obtenez un résultat depuis une cellule

Après avoir installé le module GenderAPI pour Google Sheets et enregistré votre clé dans ses paramètres Formula, saisissez =GENDER(A2) pour analyser le prénom de la cellule A2. Des arguments facultatifs permettent de choisir une entrée e-mail ou nom d’utilisateur, un contexte de pays et des colonnes de résultat supplémentaires.

GENDER est la formule native du module. Elle n’accepte pas l’objet JSON d’une requête V2 et ne renvoie pas l’enveloppe de réponse V2.

- [Installer le module requis](https://workspace.google.com/marketplace/app/gender_api_for_google_sheets_determines/712811575775)
- [Traiter une plage plus large depuis le panneau latéral](https://www.genderapi.io/fr/blog/comment-determiner-le-genre-dans-google-sheets-en-utilisant-gender-api-add-on)

## Enregistrez votre clé avant de saisir des formules

- Ouvrez Extensions → GenderAPI → Determine Gender, puis accédez à la page Formula depuis le menu du panneau latéral.
- Choisissez une clé API enregistrée ou saisissez la vôtre et enregistrez-la. Conservez vos identifiants dans le panneau latéral plutôt que dans des cellules partagées.
- Saisissez une entrée représentative en A2 et placez la formule dans une autre cellule. Laissez de la place à droite si vous demandez des informations supplémentaires.
- Contrôlez le résultat et l’aide actuelle du panneau avant de recopier la formule sur d’autres lignes.

## Les arguments suivent cet ordre

| Argument | Type | Valeur par défaut | Description |
| --- | --- | --- | --- |
| `input` | Texte ou référence de cellule | Obligatoire | Prénom, adresse e-mail ou nom d’utilisateur, par exemple A2. |
| `method` | Texte | name | name, email ou username, selon l’entrée. |
| `country_filter` | Texte | Aucun filtre pays | Code pays facultatif à deux lettres. Utilisez une chaîne vide pour l’ignorer avant additional_info. |
| `additional_info` | Booléen | FALSE | TRUE renvoie des champs supplémentaires dans les colonnes adjacentes ; FALSE ne renvoie que le genre. |

**Exemples de formules Google Sheets**

Chaque ligne est une formule distincte. Choisissez la méthode correspondant à la valeur de A2. Ces exemples illustrent la syntaxe et ne garantissent aucun résultat. Selon les paramètres régionaux de la feuille, le séparateur d’arguments peut être un point-virgule au lieu d’une virgule.

```text
=GENDER(A2)
=GENDER(A2, "email")
=GENDER(A2, "username")
=GENDER(A2, "name", "IT", TRUE)
=GENDER(A2, "email", "", TRUE)
```

## Laissez de la place pour les sorties étendues

Lorsque additional_info est activé, l’aide actuelle du panneau Google Sheets indique quatre valeurs dans cet ordre : genre, pays, probabilité et prénom normalisé. Cet ordre diffère de celui des formules Excel. Vérifiez l’aide du module installé lorsque vous créez les en-têtes de colonnes.

Laissez vides toutes les cellules de destination pour que le tableau puisse s’étendre. Un tableau bloqué, une clé absente ou une erreur de plateforme doivent être résolus séparément : ce ne sont pas des prédictions de genre inconnu.

| Position | Aide actuelle de Sheets | Traitement |
| --- | --- | --- |
| 1 | Gender | Gardez les résultats non résolus comme inconnus et distinguez-les des messages d’erreur. |
| 2 | Country | Contexte renvoyé par la recherche, pas une localisation vérifiée. |
| 3 | Probability | Conservez cet indicateur historique avec le résultat ; ne le renommez pas en confidence de V2. |
| 4 | Normalized name | Vérifiez le prénom dérivé de votre entrée avant de l’utiliser ailleurs. |

## Comprenez les recalculs et les notes en cache

Une formule est dynamique. Modifier ses entrées ou recalculer la feuille peut nécessiter un nouveau traitement. Le module peut écrire une note contenant la formule et son résultat en cache, mais cette note ne garantit pas que chaque calcul ultérieur évitera une nouvelle requête ou une consommation de crédits.

Google applique ses quotas d’exécution des fonctions personnalisées et d’URL Fetch indépendamment des crédits GenderAPI. Sa documentation actuelle limite chaque exécution d’une fonction personnalisée à 30 secondes. Trop de formules simultanées ou des requêtes lentes peuvent provoquer des erreurs même si votre compte dispose encore de crédits.

Pour obtenir un instantané stable, copiez les résultats complétés et collez-les en tant que valeurs dans une autre zone. Cette copie ne dépend plus de la formule ; conservez aussi l’entrée d’origine et la date de vérification.

- [Fonctionnement des fonctions personnalisées Google](https://developers.google.com/apps-script/guides/sheets/functions)
- [Quotas actuels de Google Apps Script](https://developers.google.com/apps-script/guides/services/quotas)

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

- [Offres et crédits du compte](https://www.genderapi.io/fr/price)

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

- [Paramètres de requête V2](https://www.genderapi.io/fr/docs/v2/request-parameters)
- [Champs de réponse V2](https://www.genderapi.io/fr/docs/v2/responses)
- [Intégration V2 avec Python](https://www.genderapi.io/fr/integrations/python)
- [Intégration V2 avec Node.js](https://www.genderapi.io/fr/integrations/javascript)

## La formule s’appelle-t-elle GENDER_API ?

Non. Le module Google Sheets documente =GENDER(input, method, country_filter, additional_info). Microsoft Excel utilise d’autres noms : GENDER.FROM_NAME, GENDER.FROM_EMAIL et GENDER.FROM_USERNAME.

## Puis-je demander des champs supplémentaires sans filtre pays ?

Oui. Laissez le troisième argument vide, par exemple =GENDER(A2, "email", "", TRUE). Les champs supplémentaires s’étendent alors dans les cellules adjacentes.

## La note en cache rend-elle les recalculs gratuits ?

Un résultat enregistré peut être réutilisé, mais la note ne garantit pas que chaque exécution future évitera une nouvelle requête. Surveillez vos crédits et conservez des valeurs fixes lorsque le recalcul dynamique n’est pas nécessaire.

## Tous les éditeurs de la feuille y ont-ils automatiquement accès ?

Ne le supposez pas. Vérifiez que le module est disponible et autorisé pour les utilisateurs et le document concernés. Partagez une copie en valeurs lorsque les destinataires n’ont besoin que des résultats complétés.

## Documentation de référence

- [Fiche officielle du module Google Sheets](https://workspace.google.com/marketplace/app/gender_api_for_google_sheets_determines/712811575775)
- [Fonctions personnalisées de Google](https://developers.google.com/apps-script/guides/sheets/functions)
- [Quotas de Google Apps Script](https://developers.google.com/apps-script/guides/services/quotas)
- [Offres et crédits GenderAPI](https://www.genderapi.io/fr/price)
- [Politique de confidentialité de GenderAPI](https://www.genderapi.io/fr/privacy-policy)
- [Contrat de requête V2](https://www.genderapi.io/fr/docs/v2/request-parameters)