Method: customer.devices.chromeos.issueCommand

Invia un comando da eseguire sul 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 del payload:

  • SET_VOLUME: il payload è un oggetto JSON con stringa nel formato: { "volume": 50 }. Il volume deve essere un numero intero compreso nell'intervallo [0,100].
  • DEVICE_START_CRD_SESSION: il payload può essere un oggetto JSON con stringa nel formato: { "ackedUserPresence": true, "crdSessionType": stringa }. 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.
  • REBOOT: il payload è un oggetto JSON con stringa nel formato: { "user_session_delay_seconds": 300 }. user_session_delay_seconds è il numero 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 valore predefinito è 0. Nota: questo vale solo se ha eseguito l'accesso un utente effettivo, incluso un ospite. Se il dispositivo è nella schermata di accesso o in modalità kiosk, il valore non viene rispettato e il dispositivo si riavvia immediatamente.
  • FETCH_SUPPORT_PACKET: il payload può essere un oggetto JSON con stringa nel seguente 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 sulla memoria (3), Gerarchia dell'interfaccia utente (4), Log aggiuntivi della piattaforma ChromeOS (5), Evento del dispositivo (6), Dump di debug delle NIC Intel WiFi (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 (Gestore delle connessioni) (14), Norme (15), Stato e log di sistema di ChromeOS (16), Log di sistema di ChromeOS (17), Log utente di ChromeOS Chrome (18), Bluetooth di ChromeOS (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 all'invio 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.