Method: customer.devices.chromeos.issueCommand

Cihazın yürütmesi için bir komut yayınlar.

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
customerId

string

Değişmez. Google Workspace hesabının kimliği.

deviceId

string

Değişmez. Chrome OS cihazın kimliği.

İstek içeriği

İstek metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi
{
  "commandType": enum (CommandType),
  "payload": string
}
Alanlar
commandType

enum (CommandType)

Komutun türü.

payload

string

Komutun yükü. Yalnızca komut destekliyorsa sağlayın. Aşağıdaki komutlar, yük eklemeyi destekler:

  • SET_VOLUME: Yük, şu biçimde dizeleştirilmiş bir JSON nesnesidir: { "volume": 50 }. Ses düzeyi, [0,100] aralığında bir tam sayı olmalıdır.
  • DEVICE_START_CRD_SESSION: Yük, isteğe bağlı olarak şu biçimde dizeleştirilmiş bir JSON nesnesidir: { "ackedUserPresence": true, "crdSessionType": string }. ackedUserPresence bir boole değeridir. Varsayılan olarak ackedUserPresence, false olarak ayarlanır. Etkin bir cihaz için Chrome Uzaktan Masaüstü oturumu başlatmak üzere ackedUserPresence değerini true olarak ayarlayın. crdSessionType yalnızca private (uzak yöneticinin ChromeOS cihaz üzerinde özel kontrol sahibi olmasını sağlar) veya shared (yöneticinin ve yerel kullanıcının ChromeOS cihazın kontrolünü paylaşmasına olanak tanır) değerlerinden birini seçebilir. Ayarlanmamışsa crdSessionType varsayılan olarak shared olur. Cihazdaki kullanılabilir oturum türlerini belirlemek için FETCH_CRD_AVAILABILITY_INFO komutu kullanılabilir.
  • REBOOT: Yük, { "user_session_delay_seconds": 300 } biçiminde dizeleştirilmiş bir JSON nesnesidir. user_session_delay_seconds, bir kullanıcı giriş yapmışsa cihazın yeniden başlatılmadan önce beklenecek süreyi (saniye cinsinden) ifade eder. [0,300] aralığında bir tam sayı olmalıdır. Yeniden başlatma için yük mevcut olmadığında varsayılan olarak 0 gecikme kullanılır. Not: Bu yalnızca Misafir de dahil olmak üzere gerçek bir kullanıcı oturum açmışsa geçerlidir. Cihaz giriş ekranındaysa veya kiosk modundaysa değer dikkate alınmaz ve cihaz hemen yeniden başlatılır.
  • FETCH_SUPPORT_PACKET: Yük, isteğe bağlı olarak şu biçimde dizeleştirilmiş bir JSON nesnesidir: {"supportPacketDetails":{ "issueCaseId": optional_support_case_id_string, "issueDescription": optional_issue_description_string, "requestedDataCollectors": [<comma-separated list of data_collector_enums integer values>]}}
    Kullanılabilir data_collector_enums listesi şöyledir: Chrome Sistem Bilgileri (1), Kilitlenme Kimlikleri (2), Bellek Ayrıntıları (3), Kullanıcı Arayüzü Hiyerarşisi (4), Ek ChromeOS Platform Günlükleri (5), Cihaz Etkinliği (6), Intel WiFi NIC'ler Hata Ayıklama Dökümü (7), Dokunma Etkinlikleri (8), Lacros (9), Lacros Sistem Bilgileri (10), ChromeOS Flex Günlükleri (11), DBus Ayrıntıları (12), ChromeOS Ağ Rotaları (13), ChromeOS Shill (Bağlantı Yöneticisi) Günlükleri (14), Politikalar (15), ChromeOS Sistem Durumu ve Günlükleri (16), ChromeOS Sistem Günlükleri (17), ChromeOS Chrome Kullanıcı Günlükleri (18), ChromeOS Bluetooth (19), ChromeOS Bağlı Giriş Cihazları (20), ChromeOS Trafik Sayaçları (21), ChromeOS Sanal Klavye (22), ChromeOS Ağ Sağlığı (23).
    Daha fazla bilgiyi yardım makalesinde bulabilirsiniz.

Yanıt gövdesi

Komut verme yanıtı.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi
{
  "commandId": string
}
Alanlar
commandId

string (int64 format)

Verilen komutun benzersiz kimliği. Komut durumunu almak için kullanılır.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için Yetkilendirme kılavuzu'na bakın.