Method: customer.devices.chromeos.issueCommand

Émet une commande à exécuter par l'appareil.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
customerId

string

Immuable. ID du compte Google Workspace.
deviceId

string

Immuable. ID de l'appareil Chrome OS.

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON 
{
  "commandType": enum (CommandType),
  "payload": string
}
Champs
commandType

enum (CommandType)

Type de commande.
payload

string

Charge utile de la commande, ne la fournissez que si la commande le prend en charge. Les commandes suivantes prennent en charge l'ajout de charge utile:

  • SET_VOLUME : la charge utile est un objet JSON concaténé au format { "volume": 50}. Le volume doit être un entier compris dans la plage [0,100].
  • DEVICE_START_CRD_SESSION : la charge utile correspond éventuellement à un objet JSON concaténé au format { "ackedUserPresence": true}. ackedUserPresence est une valeur booléenne. Par défaut, ackedUserPresence est défini sur false. Pour démarrer une session de Bureau à distance Chrome pour un appareil actif, définissez ackedUserPresence sur true.
  • REBOOT : la charge utile est un objet JSON concaténé au format { "user_session_delay_seconds": 300}. Le délai doit être compris entre 0 et 300.
  • FETCH_SUPPORT_PACKET : La charge utile est un objet JSON stringifié de manière facultative au format suivant : {"supportPacketDetails":{ "issueCaseId": optional_support_case_id_string, "issueDescription": optional_issue_description_string, "requestedDataCollectors": [<liste de valeurs d'entiers data_collector_enums(-) séparées par des virgules>]}}
    La liste des événements disponibles : data_collector_enums de journaux d'état (3), de rapports d'erreur (3), de type "informations sur l'interface utilisateur" : Wi-Fi : informations système Chrome (3), informations de connexion au réseau Wi-Fi (3), réseaux d'informations système Chrome (3), informations de connexion au réseau Wi-Fi (3), réseau d'informations système Chrome 1 (ChromeOS1), journaux système (via
    Pour en savoir plus, consultez cet article d'aide.

Corps de la réponse

Réponse à l'exécution d'une commande.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "commandId": string
}
Champs
commandId

string (int64 format)

ID unique de la commande émise, utilisé pour récupérer l'état de la commande.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez le guide relatif aux autorisations.