Method: chromeosdevices.list

Mengambil daftar perangkat Chrome OS yang diberi nomor halaman dalam akun.

Permintaan HTTP

GET https://admin.googleapis.com/admin/directory/v1/customer/{customerId}/devices/chromeos

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
customerId

string

ID unik untuk akun Google Workspace pelanggan. Sebagai administrator akun, Anda juga dapat menggunakan alias my_customer untuk mewakili customerId akun Anda. customerId juga ditampilkan sebagai bagian dari Resource pengguna.

Parameter kueri

Parameter
maxResults

integer

Jumlah hasil maksimum yang akan ditampilkan. Nilai tidak boleh lebih dari 300.

orderBy

enum (OrderBy)

Properti perangkat yang akan digunakan untuk mengurutkan hasil.

orgUnitPath

string

Jalur lengkap unit organisasi (tanpa / di awal) atau ID uniknya.

pageToken

string

Parameter kueri pageToken digunakan untuk meminta halaman hasil kueri berikutnya. Parameter kueri pageToken untuk permintaan lanjutan adalah nextPageToken dari respons Anda sebelumnya.

projection

enum (Projection)

Menentukan apakah respons berisi daftar lengkap properti atau hanya sebagian.

query

string

String penelusuran dalam format yang diberikan di https://developers.google.com/admin-sdk/directory/v1/list-query-operators

sortOrder

enum (SortOrder)

Apakah akan menampilkan hasil dalam urutan menaik atau menurun. Harus digunakan dengan parameter orderBy.

includeChildOrgunits

boolean

Menampilkan perangkat dari semua organisasi turunan, serta unit organisasi yang ditentukan. Jika ditetapkan ke true, 'orgUnitPath' harus diberikan.

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON
{
  "kind": string,
  "etag": string,
  "chromeosdevices": [
    {
      object (ChromeOsDevice)
    }
  ],
  "nextPageToken": string
}
Kolom
kind

string

Jenis sumber daya ini.

etag

string

ETag resource.

chromeosdevices[]

object (ChromeOsDevice)

Daftar objek Perangkat Chrome OS.

nextPageToken

string

Token yang digunakan untuk mengakses halaman berikutnya dari hasil ini. Untuk mengakses halaman berikutnya, gunakan nilai token ini dalam string kueri pageToken permintaan ini.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/admin.directory.device.chromeos
  • https://www.googleapis.com/auth/admin.directory.device.chromeos.readonly

Untuk informasi selengkapnya, lihat Panduan otorisasi.

OrderBy

Enum
ANNOTATED_LOCATION Lokasi perangkat Chrome seperti yang dianotasi oleh administrator.
ANNOTATED_USER Pengguna Chromebook seperti yang dianotasi oleh administrator.
LAST_SYNC Tanggal dan waktu perangkat Chrome terakhir disinkronkan dengan setelan kebijakan di konsol Admin.
NOTES Catatan perangkat Chrome seperti yang dianotasi oleh administrator.
SERIAL_NUMBER Nomor seri perangkat Chrome yang dimasukkan saat perangkat diaktifkan.
STATUS Status perangkat Chrome. Untuk informasi selengkapnya, lihat <a chromeosdevices.

Proyeksi

Jenis proyeksi yang akan ditampilkan untuk perangkat.

Enum
BASIC Hanya menyertakan kolom metadata dasar (misalnya, deviceId, serialNumber, status, dan pengguna)
FULL Menyertakan semua kolom metadata

SortOrder

Tata urutan yang harus diterapkan ke daftar perangkat.

Enum
ASCENDING Urutan menaik.
DESCENDING Urutan menurun.