Membuat kueri keanggotaan untuk grup dinamis

Guna membuat kueri keanggotaan untuk grup dinamis di konsol Google Admin, Anda dapat menggunakan atribut standar default, atribut khusus yang Anda buat, atau keduanya.

Pada halaman ini

Menggunakan atribut standar

Saat membuat grup dinamis di konsol Admin, Anda dapat memilih atribut standar dari daftar Kondisi. Anda dapat menggunakan semua atribut dalam tabel berikut guna membuat kueri keanggotaan untuk grup dinamis.

Atribut

Kode contoh

Negara

addresses.country

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

Kode negara

addresses.country_code

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

Jenis alamat khusus

addresses.custom_type

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

Alamat yang diperpanjang

addresses.extended_address

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

Lokalitas alamat

addresses.locality

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

Zip/Kode pos

addresses.postal_code

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

Kotak PO

addresses.po_box

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

Adalah alamat utama

addresses.primary

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

Wilayah

addresses.region

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

Alamat

addresses.street_address

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

Jenis alamat

addresses.type

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

Alamat email

emails.address

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

Jenis email khusus

emails.custom_type

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

Adalah email utama

emails.primary

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

Jenis email

emails.type

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

Jenis ID eksternal kustom

external_ids.custom_type

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

Jenis ID eksternal

external_ids.type

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

ID eksternal

external_ids.value

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

Kata ganti gender

gender.address_me_as

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

Jenis kelamin kustom

gender.custom_gender

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

Jenis kelamin

gender.type

user.gender.type==3

Protokol IMS kustom

ims.custom_protocol

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

Jenis IMS kustom

ims.custom_type

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

Protokol IMS standar

ims.standard_protocol

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

Apakah IMS bersifat utama

ims.primary

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

Jenis IMS

ims.type

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

Instant messenger

ims.value

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

Jenis kata kunci kustom

keywords.custom_type

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

Jenis kata kunci

keywords.type

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

Keyword

keywords.value

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

Kode bahasa

languages.language_code

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

Area lokasi

locations.area

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

ID bangunan

locations.building_id

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

Jenis lokasi kustom

locations.custom_type

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

Kode meja

locations.desk_code

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

Nama lantai

locations.floor_name

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

Bagian bawah

locations.floor_section

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

Location type

locations.type

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

Nama belakang

name.family_name

user.name.family_name==''

Nama depan

name.given_name

user.name.given_name==''

Nama

name.value

user.name.value==''

Pusat biaya

organizations.cost_center

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

Jenis organisasi kustom

organizations.custom_type

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

Departemen

organizations.department

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

Jenis Karyawan

organizations.description

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

Domain

organizations.domain

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

Lokasi organisasi

organizations.location

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

Nama organisasi

organizations.name

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

Adalah organisasi utama

organizations.primary

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

Simbol organisasi

organizations.symbol

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

Jabatan

organizations.title

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

Jenis organisasi

organizations.type

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

Jenis telepon kustom

phones.custom_type

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

Adalah telepon utama

phones.primary

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

Jenis ponsel

phones.type

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

Nomor telepon

phones.value

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

Jenis hubungan khusus

relations.custom_type

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

Nilai hubungan

relations.value

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

Jenis hubungan

relations.type

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

Jenis situs kustom

websites.custom_type

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

Adalah situs utama

websites.primary

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

Jenis situs

websites.type

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

Situs

websites.value

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

Unit organisasi ancestor

org_units.org_unit_id

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

Email manajer

managers.user_id

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

Diarisipkan

diarsipkan

user.archived==true

Mengubah sandi saat login

change_password_at_next_login

user.change_password_at_next_login==true

Verifikasi 2 langkah diterapkan

is_2sv_enforced

user.is_2sv_enforced==true

Verifikasi 2 langkah diaktifkan

is_enrolled_in_2sv

user.is_enrolled_in_2sv==true

Adalah penyiapan kotak surat

is_mailbox_setup

user.is_mailbox_setup==true

Email utama

primary_email

user.primary_email==''

Ditangguhkan

ditangguhkan

user.suspended==true

Alasan penangguhan

suspension_reason

user.suspension_reason==4

Unit organisasi induk

org_unit_id

user.org_unit_id==orgUnitId('')

Gender

Gender.Gender

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

Etnis

Ethnicity.Ethnicity

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

Menggunakan atribut khusus

Saat Anda membuat kueri keanggotaan di konsol Admin, atribut khusus akan muncul setelah atribut standar ada di daftar Kondisi.

Jika Anda menjalankan kueri yang berisi atribut khusus dan kueri menampilkan nol anggota, properti atribut mungkin tidak disetel dengan benar di Groups API. Secara khusus, properti "indexed" harus disetel ke true. Untuk mengetahui detailnya, buka Atribut pengguna khusus.

Menyertakan pengguna secara otomatis dalam grup dinamis

Anda dapat mengedit informasi akun pengguna agar cocok dengan kondisi kueri untuk menyertakan pengguna dalam grup dinamis secara otomatis. Anda dapat mengedit detail akun pengguna menggunakan Directory API. Untuk mengetahui detailnya, buka Memperbarui akun pengguna.

Anda juga dapat mengedit beberapa detail akun pengguna di konsol Admin, biasanya dari halaman Pengguna, termasuk:

Verifikasi 2 Langkah diterapkan Verifikasi 2 Langkah didaftarkan
Jenis alamat Unit organisasi ancestor
ID gedung Ubah sandi saat login
Pusat biaya Subkategori
Alamat email Jenis email
ID Eksternal Nama depan
Nama lantai Bagian lantai
Diarsipkan Adalah email utama
Adalah penyiapan kotak surat Ditangguhkan
Jabatan Nama belakang
ID penggunamanajer Nama
Unit organisasi induk Nomor telepon
Jenis telepon

Mengecualikan pengguna dari grup dinamis

Untuk menambahkan pengguna yang tidak memenuhi kondisi saja, buat kondisi untuk grup dinamis, lalu klik Kecualikan . Misalnya, untuk membuat grup yang hanya berisi pengguna yang tidak tinggal di AS, Anda dapat membuat kondisi "Kode negara sama dengan AS", lalu mengklik Kecualikan . Dalam kueri, pengguna yang dikecualikan memiliki tanda seru (!).

Untuk beberapa kueri kustom dengan parameter "exists", Anda tidak dapat menggunakan opsi kecualikan. Untuk mengetahui detailnya, buka Merumuskan dan menguji kueri Anda.