Method: customer.devices.chromeos.issueCommand

Gibt einen Befehl aus, der vom Gerät ausgeführt werden soll.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
customerId

string

Nicht veränderbar. ID des Google Workspace-Kontos.

deviceId

string

Nicht veränderbar. ID des Chrome OS-Geräts.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung
{
  "commandType": enum (CommandType),
  "payload": string
}
Felder
commandType

enum (CommandType)

Der Typ des Befehls.

payload

string

Die Nutzlast für den Befehl. Geben Sie sie nur an, wenn der Befehl dies unterstützt. Die folgenden Befehle unterstützen das Hinzufügen von Nutzlast:

  • SET_VOLUME: Die Nutzlast ist ein String-JSON-Objekt im Format { "volume": 50 }. Das Volumen muss eine Ganzzahl im Bereich [0,100] sein.
  • DEVICE_START_CRD_SESSION: Die Nutzlast ist optional ein String-JSON-Objekt im Format { "ackedUserPresence": true }. ackedUserPresence ist ein boolescher Wert. Standardmäßig ist ackedUserPresence auf false eingestellt. Wenn Sie eine Chrome Remote Desktop-Sitzung für ein aktives Gerät starten möchten, setzen Sie ackedUserPresence auf true.
  • REBOOT: Die Nutzlast ist ein String-JSON-Objekt im Format { "user_session_delay_seconds": 300 }. Die Verzögerung muss im Bereich [0, 300] liegen.
  • FETCH_SUPPORT_PACKETdata_collector_enumsdata_collector_enums

    Weitere Informationen findest du in diesem Hilfeartikel.

Antworttext

Eine Antwort auf die Ausgabe eines Befehls.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung
{
  "commandId": string
}
Felder
commandId

string (int64 format)

Die eindeutige ID des ausgegebenen Befehls, mit der der Befehlsstatus abgerufen wird.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie im Leitfaden zur Autorisierung.