Campos de usuário válidos para consultas de grupo dinâmico

Esta página descreve os campos e recursos suportados do CEL que podem ser usados em uma consulta de associação.

Campos do usuário

Os seguintes campos do recurso User do SDK Admin podem ser usados em consultas de associação.

Campo Subcampo
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

Atributos de tipo

Os campos type da tabela anterior são correspondidos usando valores de enum em vez de suas representações de string. A lista a seguir documenta a representação de cada tipo de string no valor do enum correspondente.

Atributo Valor Enum Representação de string
Endereços 0 desconhecido
1 Personalizada
2 residencial
3 trabalho
4 outro
Locais 0 padrão
1 Personalizada
2 desk
organizações 0 desconhecido
1 trabalho
2 school
3 Somente domínio
Relations 12 administrador
Emails 0 desconhecido
1 Personalizada
2 residencial
3 trabalho
4 outro
IDs externos 0 desconhecido
1 Personalizada
2 conta
3 cliente
4 network
5 organização
6 login_id
Gênero 0 desconhecido
1 masculino
2 feminino
3 outro
Protocolo padrão de IMS 0 padrão
1 Protocolo personalizado
2 AIM
3 MSN
4 yahoo
5 Skype
6 QQ
7 gtalk
8 ICQ
9 Jabber
10 NetMeeting
Tipo de IMS 0 desconhecido
1 Personalizada
2 residencial
3 trabalho
4 outro
Keywords 0 desconhecido
1 Personalizada
2 Missão.
3 occupation
4 Outlook
Phones 0 desconhecido
1 Personalizada
2 residencial
3 trabalho
4 outro
5 Fax residencial
6 Fax comercial
7 mobile
8 pager
9 Outro fax
10 Empresa (principal)
11 Assistente
12 carro
13 rádio
14 ISDN
15 callback
16 Telex
17 TTY/TDD
18 Celular comercial
19 Pager comercial
20 main
21 Grand Central
22 Enterprise Voice
Motivo da suspensão 1 admin
2 under 13
3 login na Web obrigatório
4 abuse
5 abuso: recuperável pelo administrador
Websites 0 desconhecido
1 Página de instalação do aplicativo
2 blog
3 Personalizada
4 ftp
5 residencial
6 Página inicial
7 outro
8 perfil
9 reservas
10 resume
11 trabalho

Campos da unidade organizacional

Também é possível consultar associações usando o campo orgUnitId, que inclui todos os usuários que fazem parte dessa unidade organizacional, direta ou indiretamente. Saiba mais sobre como recuperar o valor orgUnitId na documentação de referência do SDK Admin.

Amostras de consultas

  • Todos os usuários diretos em uma determinada unidade organizacional:

    user.org_unit_id==orgUnitId('03ph8a2z1enx4lx')
    
  • Todos os usuários diretos e indiretos em uma unidade organizacional:

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

Outros tipos de consulta

  • Todos os usuários gerenciados por uma pessoa específica:

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

    Substitua MANAGER_ID pelo ID exclusivo do usuário do administrador. É possível extrair esse ID com a API AdminSDK Directory usando o endereço de e-mail do administrador como userKey.