Method: users.list

Mengambil daftar pengguna yang dihapus atau semua pengguna di domain yang telah diberi nomor halaman.

Permintaan HTTP

GET https://admin.googleapis.com/admin/directory/v1/users

URL menggunakan sintaksis gRPC Transcoding.

Parameter kueri

Parameter
customFieldMask

string

Daftar nama skema yang dipisahkan koma. Semua kolom dari skema ini diambil. Kolom ini hanya boleh disetel saat projection=custom.
customer

string

ID unik untuk akun Google Workspace pelanggan. Pada akun multi-domain, gunakan kolom ini untuk mengambil semua pengguna untuk pelanggan, bukan domain. Anda juga dapat menggunakan alias my_customer untuk mewakili customerId akun Anda. customerId juga ditampilkan sebagai bagian dari resource Users. Anda harus memberikan parameter customer atau domain.
domain

string

Nama domain. Gunakan kolom ini untuk mendapatkan pengguna hanya dari satu domain. Untuk menampilkan semua domain untuk akun pelanggan, gunakan parameter kueri customer. Parameter customer atau domain harus diberikan.
event

enum (Event)

Peristiwa tujuan langganan (jika berlangganan)
maxResults

integer

Jumlah hasil maksimum yang akan ditampilkan.
orderBy

enum (OrderBy)

Properti yang akan digunakan untuk mengurutkan hasil.
pageToken

string

Token untuk menentukan halaman berikutnya dalam daftar
projection

enum (Projection)

Subset kolom apa yang harus diambil untuk pengguna ini.
query

string

String kueri untuk menelusuri kolom pengguna. Untuk informasi selengkapnya tentang membuat kueri pengguna, lihat Penelusuran untuk Pengguna.
showDeleted

string

Jika ditetapkan ke true, daftar pengguna yang dihapus akan diambil. (Default: false)
sortOrder

enum (SortOrder)

Apakah akan menampilkan hasil dalam urutan menaik atau menurun, mengabaikan huruf besar/kecil.
viewType

enum (ViewType)

Apakah mengambil tampilan publik pengguna saja atau seluruh domain. Untuk informasi selengkapnya, lihat Mengambil pengguna sebagai non-administrator.

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "kind": string,
  "trigger_event": string,
  "etag": string,
  "users": [
    {
      object (User)
    }
  ],
  "nextPageToken": string
}
Kolom
kind

string

Jenis sumber daya ini.
trigger_event

string

Peristiwa yang memicu respons ini (hanya digunakan jika Respons Push)
etag

string

ETag resource.
users[]

object (User)

Daftar objek pengguna.
nextPageToken

string

Token yang digunakan untuk mengakses halaman berikutnya dari hasil ini.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/admin.directory.user
  • https://www.googleapis.com/auth/admin.directory.user.readonly
  • https://www.googleapis.com/auth/cloud-platform

Untuk informasi selengkapnya, lihat Panduan otorisasi.

Acara

Jenis peristiwa Langganan

Enum
ADD Peristiwa Buatan Pengguna
DELETE Peristiwa Dihapus oleh Pengguna
MAKE_ADMIN Peristiwa Perubahan Status Admin Pengguna
UNDELETE Peristiwa Pembatalan Penghapusan Pengguna
UPDATE Peristiwa yang Diperbarui oleh Pengguna

OrderBy

Enum
EMAIL Email utama pengguna.
FAMILY_NAME Nama belakang pengguna.
GIVEN_NAME Nama depan pengguna.

Proyeksi

Enum
BASIC Jangan sertakan kolom kustom apa pun untuk pengguna.
CUSTOM Sertakan kolom kustom dari skema yang diminta di customFieldMask.
FULL Sertakan semua kolom yang terkait dengan pengguna ini.

SortOrder

Enum
ASCENDING Urutan menaik.
DESCENDING Urutan menurun.

ViewType

Enum
admin_view Hasilnya mencakup kolom khusus administrator dan publik domain untuk pengguna tersebut.
domain_public Hasilnya hanya menyertakan kolom untuk pengguna yang dapat dilihat secara publik oleh pengguna lain di domain tersebut.