Method: chromeosdevices.list

Mengambil daftar perangkat Chrome OS yang telah diberi nomor halaman dalam sebuah 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.
orderBy

enum (OrderBy)

Properti perangkat yang akan digunakan untuk mengurutkan hasil.
orgUnitPath

string

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

string

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

enum (Projection)

Membatasi informasi yang ditampilkan ke kumpulan kolom yang dipilih.
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 org unit turunan, serta unit org yang ditentukan. Jika disetel ke benar (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

Ini adalah jenis sumber daya.
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 sebagaimana dianotasikan oleh administrator.
LAST_SYNC Tanggal dan waktu perangkat Chrome terakhir kali disinkronkan dengan setelan kebijakan di konsol Admin.
NOTES Catatan perangkat Chrome sebagaimana dianotasi oleh administrator.
SERIAL_NUMBER Nomor seri perangkat Chrome yang dimasukkan saat perangkat diaktifkan.
STATUS Status perangkat Chrome. Untuk informasi selengkapnya, lihat <a chromeosdevices.

Projection

Jenis proyeksi yang akan ditampilkan untuk perangkat.

Enum
BASIC Menyertakan hanya kolom metadata dasar (misalnya, deviceId, serialNumber, status, dan user)
FULL Mencakup semua kolom metadata

SortOrder

Urutan pengurutan yang harus diterapkan ke daftar perangkat.

Enum
ASCENDING Urutan menaik.
DESCENDING Urutan dari atas ke bawah.