Method: customer.devices.chromeos.issueCommand

Invia un comando da eseguire al dispositivo.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
customerId

string

Immutabile. ID dell'account Google Workspace.

deviceId

string

Immutabile. ID del dispositivo ChromeOS.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON
{
  "commandType": enum (CommandType),
  "payload": string
}
Campi
commandType

enum (CommandType)

Il tipo di comando.

payload

string

Il payload per il comando, forniscilo solo se il comando lo supporta. I seguenti comandi supportano l'aggiunta di payload:

  • SET_VOLUME: il payload è un oggetto JSON convertito in stringa nel formato: { "volume": 50 }. Il volume deve essere un numero intero compreso nell'intervallo [0,100].
  • DEVICE_START_CRD_SESSION: il payload è facoltativamente un oggetto JSON convertito in stringa nel formato: { "ackedUserPresence": true, "crdSessionType": string }. ackedUserPresence è un valore booleano. Per impostazione predefinita, ackedUserPresence è impostato su false. Per avviare una sessione di Chrome Remote Desktop per un dispositivo attivo, imposta ackedUserPresence su true. crdSessionType può selezionare solo i valori private (che concede all'amministratore remoto il controllo esclusivo del dispositivo ChromeOS) o shared (che consente all'amministratore e all'utente locale di condividere il controllo del dispositivo ChromeOS). Se non viene impostato, il valore predefinito di crdSessionType è shared. Il comando FETCH_CRD_AVAILABILITY_INFO può essere utilizzato per determinare i tipi di sessione disponibili sul dispositivo.
  • REBOOT: il payload è un oggetto JSON convertito in stringa nel formato: { "user_session_delay_seconds": 300 }. user_session_delay_seconds è la quantità di secondi da attendere prima di riavviare il dispositivo se un utente ha eseguito l'accesso. Deve essere un numero intero compreso nell'intervallo [0,300]. Quando il payload non è presente per il riavvio, il ritardo predefinito è 0. Nota: questa opzione si applica solo se è stato eseguito l'accesso di un utente reale, incluso un ospite. Se il dispositivo si trova nella schermata di accesso o in modalità Kiosk, il valore non viene rispettato e il dispositivo si riavvia immediatamente.
  • FETCH_SUPPORT_PACKET: Il payload è facoltativamente una stringa JSON nel formato: {"supportPacketDetails":{ "issueCaseId": optional_support_case_id_string, "issueDescription": optional_issue_description_string, "requestedDataCollectors": [<comma-separated list of data_collector_enums integer values>]}}
    L'elenco dei data_collector_enums disponibili è il seguente: Informazioni di sistema di Chrome (1), ID arresto anomalo (2), Dettagli memoria (3), Gerarchia UI (4), Log della piattaforma ChromeOS aggiuntivi (5), Evento dispositivo (6), Dump di debug delle NIC Wi-Fi Intel (7), Eventi tocco (8), Lacros (9), Informazioni di sistema di Lacros (10), Log di ChromeOS Flex (11), Dettagli DBus (12), Route di rete di ChromeOS (13), Log di ChromeOS Shill (Connection Manager) (14), Norme (15), Stato e log di sistema di ChromeOS (16), Log di sistema di ChromeOS (17), Log utente di ChromeOS Chrome (18), ChromeOS Bluetooth (19), Dispositivi di input connessi di ChromeOS (20), Contatori di traffico di ChromeOS (21), Tastiera virtuale di ChromeOS (22), Integrità della rete di ChromeOS (23).
    Per ulteriori dettagli, consulta l'articolo del Centro assistenza.

Corpo della risposta

Una risposta per l'emissione di un comando.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON
{
  "commandId": string
}
Campi
commandId

string (int64 format)

L'ID univoco del comando emesso, utilizzato per recuperare lo stato del comando.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la Guida all'autorizzazione.