Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Champs utilisateur valides pour les requêtes de groupe dynamique
Cette page décrit les champs et fonctionnalités compatibles du langage CEL pouvant être utilisés dans une requête d'adhésion.
Champs utilisateur
Les champs suivants de la ressource User du SDK Admin peuvent être utilisés dans les requêtes d'adhésion.
Champ
Sous-champ
addresses
country
country_code
custom_type
extended_address
locality
po_box
postal_code
primary
region
street_address
type
archived
boolean
change_password_at_next_login
boolean
is_2sv_enforced
boolean
is_enrolled_in_2sv
boolean
is_mailbox_setup
boolean
locations
area
building_id
custom_type
desk_code
floor_name
floor_section
type
organizations
cost_center
custom_type
department
description
domain
location
name
primary
symbol
title
type
relations
custom_type
type
value
emails
address
custom_type
primary
type
external_ids
custom_type
type
value
gender
address_me_as
custom_gender
type
ims
custom_protocol
custom_type
standard_protocol
primary
type
value
keywords
custom_type
type
value
languages
language_code
name
family_name
given_name
value
phones
custom_type
primary
type
value
suspended
boolean
suspension_reason
custom_type
type
value
websites
custom_type
primary
type
value
Attributs de type
Les attributs type du tableau précédent sont mis en correspondance à l'aide de valeurs d'énumération au lieu de leurs représentations sous forme de chaîne. La liste suivante répertorie la représentation sous forme de chaîne de chaque type et sa valeur d'énumération correspondante.
Attribut
Valeur d'énumération
Représentation de la chaîne
Adresses
0
inconnu
1
personnalisé
2
domicile
3
travail
4
autre
Zones
0
par défaut
1
personnalisé
2
bureau
Organisations
0
inconnu
1
travail
2
école
3
domain-only
Relations
12
responsable
Adresses e-mail
0
inconnu
1
personnalisé
2
domicile
3
travail
4
autre
ID externes
0
inconnu
1
personnalisé
2
compte
3
customer
4
réseau
5
organisation
6
login_id
Sexe
0
inconnu
1
mâle
2
femelle
3
autre
Protocole standard de messagerie instantanée
0
par défaut
1
protocole personnalisé
2
aim
3
msn
4
yahoo
5
skype
6
qq
7
gtalk
8
icq
9
jabber
10
net meeting
Type de messagerie instantanée
0
inconnu
1
personnalisé
2
domicile
3
travail
4
autre
Mots clés
0
inconnu
1
personnalisé
2
mission
3
occupation
4
outlook
Phones
0
inconnu
1
personnalisé
2
domicile
3
travail
4
autre
5
Fax (personnel)
6
Fax (professionnel)
7
mobile
8
pager
9
Fax (autre)
10
Société (principal)
11
assistant
12
voiture
13
radio
14
RNIS
15
rappel
16
Télex
17
TTY/TTD (malentendants)
18
Mobile (professionnel)
19
Pager (professionnel)
20
main
21
Grand Central
22
Enterprise Google Voice
Motif de la suspension
1
admin
2
moins de 13 ans
3
connexion Web requise
4
utilisation abusive
5
utilisation abusive — récupérable par l'administrateur
Sites Web
0
inconnu
1
Page d'installation de l'application
2
blog
3
personnalisé
4
ftp
5
domicile
6
une page d'accueil
7
autre
8
profil
9
reservations
10
resume
11
travail
Champs d'unité organisationnelle
Vous pouvez également interroger les adhésions à l'aide du champ orgUnitId pour inclure tous les utilisateurs faisant partie de cette unité organisationnelle, directement ou indirectement. Pour en savoir plus sur la récupération de la valeur orgUnitId, consultez la documentation de référence du SDK Admin.
Exemples de requêtes
Tous les utilisateurs directs d'une unité organisationnelle donnée :
user.org_unit_id==orgUnitId('03ph8a2z1enx4lx')
Tous les utilisateurs directs et indirects d'une unité organisationnelle donnée :
Remplacez MANAGER_ID par l'ID utilisateur unique du gestionnaire. Vous pouvez récupérer cet ID à l'aide de l'API Directory du SDK Admin en utilisant l'adresse e-mail du responsable comme userKey.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/09/04 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Difficile à comprendre","hardToUnderstand","thumb-down"],["Informations ou exemple de code incorrects","incorrectInformationOrSampleCode","thumb-down"],["Il n'y a pas l'information/les exemples dont j'ai besoin","missingTheInformationSamplesINeed","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/09/04 (UTC)."],[[["\u003cp\u003eThis document lists the supported user fields from the Admin SDK's \u003ccode\u003eUser\u003c/code\u003e resource that can be used in dynamic group membership queries, which are available to certain Google Workspace and Cloud Identity accounts.\u003c/p\u003e\n"],["\u003cp\u003eCustom user fields are supported in queries, provided that the schema already exists within \u003ccode\u003euser.custom_schemas\u003c/code\u003e, as detailed in the linked documentation.\u003c/p\u003e\n"],["\u003cp\u003eThe document specifies which fields can be used and the sub-fields each one has, with the inclusion of \u003ccode\u003eboolean\u003c/code\u003e types and when a field has a \u003ccode\u003eprimary\u003c/code\u003e value that can only be evaluated as true.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003etype\u003c/code\u003e attributes used in the user fields table are matched to enum values rather than string representations, and a table is provided mapping the string values to their corresponding enum values.\u003c/p\u003e\n"],["\u003cp\u003eMembership queries can also be performed using the \u003ccode\u003eorgUnitId\u003c/code\u003e field to include users directly or indirectly within a specified organizational unit, and the document also includes sample queries on how to retrieve users by their org unit, or managers.\u003c/p\u003e\n"]]],[],null,["# Valid user fields for dynamic group queries\n===========================================\n\nThis page outlines supported fields and features of CEL that can be\nused in a membership query.\n| **Note:** Dynamic groups are only available to Google Workspace Enterprise Standard, Enterprise Plus, Enterprise for Education, and Cloud Identity premium accounts.\n\nUser fields\n-----------\n\nThe following fields from the Admin SDK's\n[`User`](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users)\nresource can be used in membership queries.\n| **Note:** Custom user fields are also supported as long as the schema already exists in `user.custom_schemas`. See [Manage custom user fields](https://developers.google.com/admin-sdk/directory/v1/guides/manage-schemas) for more information about creating a custom schema.\n\n| **Note:** When a field has a `primary` value, that value can only be evaluated as a true expression. For example: \n| `user.addresses.exists(addr, addr.primary == true)\"`\n\n### Type attributes\n\nThe `type` attributes from the previous table are matched using enum values\ninstead of their string representations. The following list documents each\ntype's string representation to the corresponding enum value.\n\nOrganizational unit fields\n--------------------------\n\nYou can also query memberships using the `orgUnitId` field to include all\nusers who are part of that organizational unit, directly or indirectly. For more\ninformation about retrieving the `orgUnitId` value, see the\n[Admin SDK reference documentation](https://developers.google.com/admin-sdk/directory/reference/rest/v1/orgunits).\n\n### Sample queries\n\n- All direct users under a given organizational unit:\n\n user.org_unit_id==orgUnitId('03ph8a2z1enx4lx')\n\n- All direct and indirect users under a given organizational unit:\n\n user.org_units.exists(org_unit, org_unit.org_unit_id==orgUnitId('03ph8a2z1khexns'))\n\nOther query types\n-----------------\n\n- All users managed by a specific individual:\n\n user.managers.exists(manager, manager.user_id == userId('\u003cvar translate=\"no\"\u003eMANAGER_ID\u003c/var\u003e'))\n\n Replace \u003cvar translate=\"no\"\u003eMANAGER_ID\u003c/var\u003e with the manager's unique\n user ID. You can retrieve this ID with the\n [AdminSDK Directory API](https://developers.google.com/admin-sdk/directory/reference/rest/v1/users/get)\n using the manager's email address as `userKey`."]]
