Method: customer.devices.chromeos.issueCommand

Mengeluarkan perintah agar perangkat dijalankan.

Permintaan HTTP

POST https://admin.googleapis.com/admin/directory/v1/customer/{customerId}/devices/chromeos/{deviceId}:issueCommand

URL ini menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
customerId

string

Tidak dapat diubah. ID akun Google Workspace.
deviceId

string

Tidak dapat diubah. ID Perangkat ChromeOS.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "commandType": enum (CommandType),
  "payload": string
}
Kolom
commandType

enum (CommandType)

Jenis perintah.
payload

string

Payload untuk perintah, berikan hanya jika perintah mendukungnya. Perintah berikut mendukung penambahan payload:

  • SET_VOLUME: Payload adalah objek JSON yang di-stringifikasi dalam bentuk: { "volume": 50 }. Volume harus berupa bilangan bulat dalam rentang [0,100].
  • DEVICE_START_CRD_SESSION: Payload secara opsional adalah objek JSON yang diubah menjadi string dalam bentuk: { "ackedUserPresence": true, "crdSessionType": string }. ackedUserPresence adalah boolean. Secara default, ackedUserPresence disetel ke false. Untuk memulai sesi Chrome Desktop Jarak Jauh untuk perangkat yang aktif, setel ackedUserPresence ke true. crdSessionType hanya dapat memilih dari nilai private (yang memberikan kontrol eksklusif kepada admin jarak jauh atas perangkat ChromeOS) atau shared (yang memungkinkan admin dan pengguna lokal berbagi kontrol atas perangkat ChromeOS). Jika tidak disetel, crdSessionType ditetapkan secara default ke shared. Perintah FETCH_CRD_AVAILABILITY_INFO dapat digunakan untuk menentukan jenis sesi yang tersedia di perangkat.
  • REBOOT: Payload adalah objek JSON string dalam bentuk: { "user_session_delay_seconds": 300 }. user_session_delay_seconds adalah jumlah detik yang harus ditunggu sebelum memulai ulang perangkat jika pengguna login. Nilainya harus berupa bilangan bulat dalam rentang [0,300]. Jika payload tidak ada untuk memulai ulang, penundaan 0 adalah defaultnya. Catatan: Ini hanya berlaku jika pengguna sebenarnya login, termasuk Tamu. Jika perangkat berada di layar login atau dalam mode Kios, nilai tidak akan diterapkan dan perangkat akan segera dimulai ulang.
  • FETCH_SUPPORT_PACKET: Payload secara opsional adalah objek JSON yang diubah menjadi string dalam bentuk: {"supportPacketDetails":{ "issueCaseId": optional_support_case_id_string, "issueDescription": optional_issue_description_string, "requestedDataCollectors": [<comma-separated list of data_collector_enums integer values>]}}
    Daftar data_collector_enums yang tersedia adalah sebagai berikut: Informasi Sistem Chrome (1), ID Error (2), Detail Memori (3), Hierarki UI (4), Log Platform ChromeOS Tambahan (5), Peristiwa Perangkat (6), Dump Debug NIC WiFi Intel (7), Peristiwa Sentuh (8), Lacros (9), Informasi Sistem Lacros (10), Log ChromeOS Flex (11), Detail DBus (12), Rute Jaringan ChromeOS (13), Log Shill (Pengelola Koneksi) ChromeOS (14), Kebijakan (15), Status dan Log Sistem ChromeOS (16), Log Sistem ChromeOS (17), Log Pengguna Chrome ChromeOS (18), Bluetooth ChromeOS (19), Perangkat Input yang Terhubung ChromeOS (20), Penghitung Traffic ChromeOS (21), Keyboard Virtual ChromeOS (22), Kesehatan Jaringan ChromeOS (23).
    Lihat detail selengkapnya di artikel bantuan.

Isi respons

Respons untuk mengeluarkan perintah.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "commandId": string
}
Kolom
commandId

string (int64 format)

ID unik perintah yang dikeluarkan, digunakan untuk mengambil status perintah.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Panduan otorisasi.