Method: customer.devices.chromeos.issueCommand

Mengeluarkan perintah untuk dieksekusi perangkat.

Permintaan HTTP

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

URL 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-string dalam bentuk: { "volume": 50 }. Volume harus berupa bilangan bulat dalam rentang [0,100].
  • DEVICE_START_CRD_SESSION: Payload secara opsional adalah objek JSON yang di-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 aktif, tetapkan ackedUserPresence ke true. crdSessionType hanya dapat memilih dari nilai private (yang memberi admin jarak jauh kontrol eksklusif atas perangkat ChromeOS) atau shared (yang memungkinkan admin dan pengguna lokal berbagi kontrol atas perangkat ChromeOS). Jika tidak ditetapkan, crdSessionType ditetapkan secara default ke shared.
  • REBOOT: Payload adalah objek JSON yang di-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 default. Catatan: Hal ini hanya berlaku jika pengguna sebenarnya login, termasuk Tamu. Jika perangkat berada di layar login atau dalam mode Kiosk, nilai tersebut tidak akan dipatuhi dan perangkat akan langsung dimulai ulang.
  • FETCH_SUPPORT_PACKET: Payload secara opsional adalah objek JSON yang di-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), Intel WiFi NICs Debug Dump (7), Peristiwa Sentuh (8), Lacros (9), Informasi Sistem Lacros (10), Log Flex ChromeOS (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), ChromeOS Bluetooth (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, yang 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.