Criar consultas de associação para grupos dinâmicos

Para criar consultas de associação para grupos dinâmicos no Google Admin Console, você pode usar atributos padrão, personalizados ou ambos.

Nesta página

Usar atributos padrão

Ao criar um grupo dinâmico no Admin Console, você seleciona atributos padrão na lista "Condições". É possível usar todos os atributos da tabela a seguir para criar consultas de associação para grupos dinâmicos.

Attribute

Exemplo de código

País

addresses.country

user.addresses.exists(address, address.country == 'Canadá')

Código do país

addresses.country_code

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

Tipo de endereço personalizado

addresses.custom_type

user.addresses.exists(address, address.custom_type=='Tipo de endereço personalizado')

Endereço completo

addresses.extended_address

user.addresses.exists(address, address.extended_address=='Califórnia, EUA')

Localidade do endereço

addresses.locality

user.addresses.exists(address, address.locality=='Sul da Califórnia')

CEP

addresses.postal_code

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

Caixa postal

addresses.po_box

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

Endereço principal

addresses.primary

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

Região

addresses.region

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

Endereço

addresses.street_address

user.addresses.exists(address, address.street_address=='Rua Exemplo, 123')

Tipo de endereço

addresses.type

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

Endereço de e-mail

emails.address

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

Tipo de e-mail personalizado

emails.custom_type

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

Is email primary

emails.primary

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

Tipo de e-mail

emails.type

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

Tipo de ID externo personalizado

external_ids.custom_type

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

Tipo de ID externo

external_ids.type

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

ID externo

external_ids.value

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

Pronomes de gênero

gender.address_me_as

user.gender.address_me_as=='eles/elas'

Tipo de gênero personalizado

gender.custom_gender

user.gender.custom_gender.startsWith('gênero personalizado')

Tipo de gênero

gender.type

user.gender.type==3

Protocolo de IMS personalizado

ims.custom_protocol

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

Tipo de IMS personalizado

ims.custom_type

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

Protocolo de IMS padrão

ims.standard_protocol

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

IMS principal

ims.primary

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

Tipo de IMS

ims.type

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

Mensageiro instantâneo

ims.value

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

Tipo de palavra-chave personalizada

keywords.custom_type

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

Tipo de palavra-chave

keywords.type

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

Keyword

keywords.value

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

Código do idioma

languages.language_code

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

Área de localização

locations.area

user.locations.exists(loc, loc.area=='Próximo a São Francisco')

ID do edifício

locations.building_id

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

Tipo de local personalizado

locations.custom_type

user.locations.exists(loc, loc.custom_type=='Região')

Código da mesa

locations.desk_code

user.locations.exists(loc, loc.desk_code=='Espaço de trabalho 37')

Nome do andar

locations.floor_name

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

Seção do piso

locations.floor_section

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

Tipo de local

locations.type

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

Sobrenome

name.family_name

user.name.family_name==''

Nome

name.given_name

user.name.given_name==''

Nome

name.value

user.name.value==''

Centro de custo

organizations.cost_center

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

Tipo de organização personalizado

organizations.custom_type

user.organizations.exists(org, org.custom_type=='sem fins lucrativos')

Departamento

organizations.department

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

Tipo de funcionário

organizations.description

user.organizations.exists(org, org.description=='provedor de pesquisas')

Domínio

organizations.domain

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

Local da organização

organizations.location

user.organizations.exists(org, org.location=='Califórnia')

Nome da organização

organizations.name

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

É a organização principal

organizations.primary

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

Símbolo da organização

organizations.symbol

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

Cargo

organizations.title

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

Tipo de organização

organizations.type

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

Tipo de telefone personalizado

phones.custom_type

user.phones.exists(phone, phone.custom_type.startsWith('novo tipo'))

Telefone principal

phones.primary

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

Tipo de telefone

phones.type

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

Número de telefone

phones.value

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

Tipo de relação personalizada

relations.custom_type

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

Valor de relação

relations.value

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

Tipo de relação

relations.type

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

Tipo de site personalizado

websites.custom_type

user.websites.exists(site, site.custom_type.startsWith('escrita criativa'))

É o site principal

websites.primary

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

Tipo de site

websites.type

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

Site

websites.value

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

Unidade organizacional ancestral

org_units.org_unit_id

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

E-mail do gerente

managers.user_id

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

Está arquivado

arquivado

user.archived==true

Alterar senha no login

change_password_at_next_login

user.change_password_at_next_login==true

Verificação em duas etapas aplicada

is_2sv_enforced

user.is_2sv_enforced==true

Inscrito na verificação em duas etapas

is_enrolled_in_2sv

user.is_enrolled_in_2sv==true

Caixa de e-mails configurada

is_mailbox_setup

user.is_mailbox_setup==true

E-mail principal

primary_email

user.primary_email==''

Está suspenso

suspensa

user.suspended==true

Motivo da suspensão

suspension_reason

user.suspension_reason==4

Unidade organizacional principal

org_unit_id

user.org_unit_id==orgUnitId('')

Gênero

Gender.Gender

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

Etnia

Ethnicity.Ethnicity

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

Usar atributos personalizados

Quando você cria uma consulta de associação no Admin Console, os atributos personalizados aparecem depois dos atributos padrão na lista "Condição".

Se você executar uma consulta que contém um atributo personalizado e a consulta não retornar membros, as propriedades do atributo podem estar definidas incorretamente na API Groups. Especificamente, a propriedade "indexed" precisa ser definida como verdadeira. Confira mais detalhes em Atributos personalizados do usuário.

Incluir o usuário automaticamente no grupo dinâmico

É possível editar as informações da conta de um usuário para que elas correspondam às condições da consulta e inclua automaticamente o usuário em um grupo dinâmico. Use a API Directory para editar os detalhes da conta de um usuário. Para mais detalhes, acesse Atualizar uma conta de usuário.

Você também pode editar alguns detalhes da conta de usuário no Admin Console, geralmente na página "Usuários", incluindo:

Verificação em duas etapas aplicada Inscrição na verificação em duas etapas
Tipo de endereço Unidade organizacional ancestral
ID do edifício Alterar senha no login
Centro de custo Departamento
Endereço de e-mail Tipo de e-mail
ID externo Nome
Nome do andar Seção do andar
Está arquivado E-mail principal
Caixa de e-mails configurada estiver suspenso;
Cargo Sobrenome
ID do usuário gerente Nome
Unidade organizacional mãe Número de telefone
Tipo de telefone

Excluir usuários do grupo dinâmico

Para adicionar apenas os usuários que não atendem a uma condição, crie uma condição para o grupo dinâmico e clique em Excluir . Por exemplo, para criar um grupo contendo apenas usuários que não moram nos EUA, crie a condição "Código do país é igual a EUA" e clique em Excluir . Na consulta, você recebe um ponto de exclamação (!) para a exclusão.

Para algumas consultas personalizadas com o parâmetro "existe", não é possível usar a opção de exclusão. Confira mais detalhes em Como formular e testar sua consulta.