Method: customer.devices.chromeos.issueCommand

Émet une commande que l'appareil doit exécuter.

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 ChromeOS.

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 la prend en charge. Les commandes suivantes permettent d'ajouter la 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 est 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 dans la plage [0, 300].
  • FETCH_SUPPORT_PACKETdata_collector_enumsdata_collector_enums

    Pour en savoir plus, consultez cet article d'aide.

Corps de la réponse

Réponse à l'émission 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.