Creare query di appartenenza per i gruppi dinamici

Per creare query di appartenenza per i gruppi dinamici nella Console di amministrazione Google, puoi utilizzare gli attributi standard predefiniti, quelli personalizzati creati da te o entrambi.

In questa pagina

Utilizza gli attributi standard

Quando crei un gruppo dinamico nella Console di amministrazione, selezioni gli attributi standard dall'elenco Condizioni. Puoi utilizzare tutti gli attributi della tabella seguente per creare query di appartenenza per i gruppi dinamici.

Attributo

Codice di esempio

Paese

addresses.country

user.addresses.exists(address, address.country == 'Canada')

Codice paese

addresses.country_code

user.addresses.exists(address, address.country_code == '555')

Tipo di indirizzo personalizzato

addresses.custom_type

user.addresses.exists(address, address.custom_type=='Custom address type')

Indirizzo esteso

addresses.extended_address

user.addresses.exists(address, address.extended_address=='California, USA')

Località indirizzo

addresses.locality

user.addresses.exists(address, address.locality=='Southern California')

Codice postale

addresses.postal_code

user.addresses.exists(address, address.postal_code=='94040')

Casella postale

addresses.po_box

user.addresses.exists(address, address.po_box=='87132')

Indirizzo principale

addresses.primary

user.addresses.exists(address, address.primary==true)

Regione

addresses.region

user.addresses.exists(address, address.region=='Southwest')

Indirizzo civico

addresses.street_address

user.addresses.exists(address, address.street_address=='123 Fake St')

Tipo di indirizzo

addresses.type

user.addresses.exists(address, address.type==1)

Indirizzo email

emails.address

user.emails.exists(email, email.address.startsWith(''))

Tipo di email personalizzato

emails.custom_type

email.address.startsWith('custom@google.com')

Is email primary

emails.primary

user.emails.exists(email, email.primary==true)

Tipo di email

emails.type

user.emails.exists(email, email.type==1)

Tipo di ID esterno personalizzato

external_ids.custom_type

user.external_ids.exists(id, id.custom_type.startsWith('runner'))

Tipo di ID esterno

external_ids.type

user.external_ids.exists(id, id.type==3)

ID esterno

external_ids.value

user.external_ids.exists(id, id.value=='')

Pronomi di genere

gender.address_me_as

user.gender.address_me_as=='they/them'

Tipo di genere personalizzato

gender.custom_gender

user.gender.custom_gender.startsWith('custom gender')

Tipo di genere

gender.type

user.gender.type==3

Protocollo di messaggistica immediata personalizzato

ims.custom_protocol

user.ims.exists(im, im.custom_protocol.startsWith('custom'))

Tipo di messaggistica immediata personalizzato

ims.custom_type

user.ims.exists(im, im.custom_type.startsWith('custom'))

Protocollo di messaggistica immediata standard

ims.standard_protocol

user.ims.exists(im, im.standard_protocol==7)

Is IMS primary

ims.primary

user.ims.exists(im, im.primary==true)

Tipo di messaggistica immediata

ims.type

user.ims.exists(im, im.type==3)

Messaggistica istantanea

ims.value

user.ims.exists(im, im.value=='chat')

Tipo di parola chiave personalizzato

keywords.custom_type

user.keywords.exists(keyword, keyword.custom_type.startsWith('contractor'))

Tipo di parola chiave

keywords.type

user.keywords.exists(keyword, keyword.type==3)

Keyword

keywords.value

user.keywords.exists(keyword, keyword.value=='engineer')

Codice lingua

languages.language_code

user.languages.exists(language, language.language_code=='English')

Area geografica

locations.area

user.locations.exists(loc, loc.area=='Near San Francisco')

ID edificio

locations.building_id

user.locations.exists(loc, loc.building_id=='')

Tipo di posizione personalizzato

locations.custom_type

user.locations.exists(loc, loc.custom_type=='Region')

Codice scrivania

locations.desk_code

user.locations.exists(loc, loc.desk_code=='Desk 37')

Nome piano

locations.floor_name

user.locations.exists(loc, loc.floor_name=='')

Sezione del piano

locations.floor_section

user.locations.exists(loc, loc.floor_section=='')

Tipo di località

locations.type

user.locations.exists(loc, loc.type==1)

Cognome

name.family_name

user.name.family_name==''

Nome

name.given_name

user.name.given_name==''

Nome

name.value

user.name.value==''

Centro di costo

organizations.cost_center

user.organizations.exists(org, org.cost_center=='')

Tipo di organizzazione personalizzato

organizations.custom_type

user.organizations.exists(org, org.custom_type=='nonprofit')

Reparto

organizations.department

user.organizations.exists(org, org.department=='')

Tipo di dipendente

organizations.description

user.organizations.exists(org, org.description=='search provider')

Dominio

organizations.domain

user.organizations.exists(org, org.domain=='example.net')

Sede dell'organizzazione

organizations.location

user.organizations.exists(org, org.location=='California')

Nome dell'organizzazione

organizations.name

user.organizations.exists(org, org.name=='Google')

Organizzazione principale

organizations.primary

user.organizations.exists(org, org.primary==true)

Simbolo dell'organizzazione

organizations.symbol

user.organizations.exists(org, org.symbol=='GOOG')

Qualifica

organizations.title

user.organizations.exists(org, org.title=='')

Tipo di organizzazione

organizations.type

user.organizations.exists(org, org.type==2)

Tipo di telefono personalizzato

phones.custom_type

user.phones.exists(phone, phone.custom_type.startsWith('new type'))

Is phone primary

phones.primary

user.phones.exists(phone, phone.primary==true)

Tipo di telefono

phones.type

user.phones.exists(phone, phone.type==11)

Numero di telefono

phones.value

user.phones.exists(phone, phone.value=='')

Tipo di relazione personalizzato

relations.custom_type

user.relations.exists(rel, rel.custom_type=='example')

Valore relazione

relations.value

user.relations.exists(rel, rel.value=='Sundar')

Tipo di relazione

relations.type

user.relations.exists(rel, rel.type==12)

Tipo di sito web personalizzato

websites.custom_type

user.websites.exists(site, site.custom_type.startsWith('creative writing'))

Is website primary

websites.primary

user.websites.exists(site, site.primary==true)

Tipo di sito web

websites.type

user.websites.exists(site, site.type==2)

Sito web

websites.value

user.websites.exists(site, site.value=='google.com')

Unità organizzativa predecessore

org_units.org_unit_id

user.org_units.exists(org_unit, org_unit.org_unit_id==orgUnitId(''))

Email del manager

managers.user_id

user.managers.exists(manager, manager.user_id==userId(''))

È archiviato

archiviato

user.archived==true

Modifica password all'accesso

change_password_at_next_login

user.change_password_at_next_login==true

Applicata verifica in due passaggi

is_2sv_enforced

user.is_2sv_enforced==true

Verifica in due passaggi registrata

is_enrolled_in_2sv

user.is_enrolled_in_2sv==true

Casella di posta configurata

is_mailbox_setup

user.is_mailbox_setup==true

Email principale

primary_email

user.primary_email==''

È stato sospeso

sospesa

user.suspended==true

Motivo della sospensione

suspension_reason

user.suspension_reason==4

Unità organizzativa principale

org_unit_id

user.org_unit_id==orgUnitId('')

Genere

Gender.Gender

user.custom_schemas.Gender.Gender.exists(G, G=='')

Etnia

Ethnicity.Ethnicity

user.custom_schemas.Ethnicity.Ethnicity.exists(E, E=='')

Utilizzare gli attributi personalizzati

Quando crei una query di appartenenza nella Console di amministrazione, gli attributi personalizzati vengono visualizzati dopo gli attributi standard nell'elenco Condizioni.

Se esegui una query che contiene un attributo personalizzato e la query restituisce zero membri, le proprietà degli attributi potrebbero essere impostate in modo errato nell'API Groups. Nello specifico, la proprietà "indexed" (indicizzato) deve essere impostata su true. Per maggiori dettagli, vedi Attributi utente personalizzati.

Includere automaticamente l'utente nel gruppo dinamico

Puoi modificare le informazioni dell'account di un utente in modo che corrispondano alle condizioni della query per includerlo automaticamente in un gruppo dinamico. Modifica i dettagli dell'account di un utente utilizzando l'API Directory. Per maggiori dettagli, vedi Aggiornare un account utente.

Puoi anche modificare alcuni dettagli dell'account utente nella Console di amministrazione, in genere dalla pagina Utenti, tra cui:

Applicata verifica in due passaggi Registrato per la verifica in due passaggi
Tipo di indirizzo Unità organizzativa predecessore
ID edificio Modifica password all'accesso
Centro di costo Dipartimento
Indirizzo email Tipo di email
ID esterno Nome
Nome piano Sezione del piano
È archiviato Email principale
Casella di posta configurata È stato sospeso
Qualifica Cognome
ID utente gestore Nome
Unità organizzativa principale Numero di telefono
Tipo di telefono

Escludere utenti dal gruppo dinamico

Per aggiungere solo gli utenti che non soddisfano una condizione, crea una condizione per il gruppo dinamico e poi fai clic su Escludi . Ad esempio, per creare un gruppo contenente solo gli utenti che non vivono negli Stati Uniti, devi creare la condizione "Codice paese è uguale a US" e poi fare clic su Escludi . Nella query, l'esclusione è rappresentata da un punto esclamativo (!).

Per alcune query personalizzate con il parametro "exists", non puoi utilizzare l'opzione di esclusione. Per maggiori dettagli, vedi Formulare e testare la query.