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çimdeki dizelenmiş bir JSON nesnesi olmalıdır: { "volume": 50 }. Ses seviyesi [0,100] aralığında bir tam sayı olmalıdır.
  • DEVICE_START_CRD_SESSION: Yük, isteğe bağlı olarak şu biçimdeki dize haline getirilmiş bir JSON nesnesi olabilir: { "ackedUserPresence": true, "crdSessionType": dize }. 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 istiyorsanız ackedUserPresencetrue olarak ayarlayın. crdSessionType yalnızca private (uzaktan yöneticiye ChromeOS cihazın münhasır kontrolünü verir) veya shared (yöneticinin ve yerel kullanıcının ChromeOS cihazın kontrolünü paylaşmasına olanak tanır) değerleri arasından seçim yapabilir. Ayarlanmamışsa crdSessionType varsayılan olarak shared olur.
  • REBOOT: Yük, şu biçimdeki dizelenmiş bir JSON nesnesi olacaktır: { "user_session_delay_seconds": 300 }. user_session_delay_seconds, kullanıcı giriş yapmışsa cihazı yeniden başlatmadan önce beklemeniz gereken saniye sayısıdır. [0,300] aralığında bir tam sayı olmalıdır. Yeniden başlatma için yükü yoksa varsayılan gecikme 0'dır. Not: Bu durum yalnızca misafirler dahil olmak üzere gerçek bir kullanıcının oturum açtığı durumlarda geçerlidir. Cihaz giriş ekranında veya Kiosk modundaysa değere uyulmaz ve cihaz hemen yeniden başlatılır.
  • FETCH_SUPPORT_PACKET: Yük, isteğe bağlı olarak şu biçimdeki dizelenmiş bir JSON nesnesi olabilir: {"supportPacketDetails":{ "issueCaseId": isteğe bağlı_destek_kayıt_kimliği_dizisi, "issueDescription": isteğe bağlı_sorun_açıklaması_dizisi, "requestedDataCollectors": [<virgülle ayrılmış data_collector_enums tam sayı değerleri listesi>]}}
    Kullanılabilir data_collector_enums değerlerinin listesi şu şekildedir: 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'leri Hata Ayıklama Dosyası (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 bilgi için yardım makalesini inceleyin.

Yanıt gövdesi

Komut vermeyle ilgili 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)

Komut durumunu almak için kullanılan, verilen komutun benzersiz kimliği.

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ılavuzuna bakın.