Method: customer.devices.chromeos.issueCommand

Gibt einen Befehl aus, der auf dem 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

Parameters
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 sie unterstützt. Die folgenden Befehle unterstützen das Hinzufügen von Nutzlasten:

  • SET_VOLUME: Nutzlast ist ein als String definiertes JSON-Objekt im Format { "volume": 50 }. Das Volume muss eine Ganzzahl im Bereich [0,100] sein.
  • DEVICE_START_CRD_SESSION: Die Nutzlast ist optional ein JSON-Objekt mit String im Format { "ackedUserPresence": true }. ackedUserPresence ist ein boolescher Wert. Standardmäßig ist ackedUserPresence auf false festgelegt. Wenn du eine Chrome Remote Desktop-Sitzung für ein aktives Gerät starten möchtest, setze ackedUserPresence auf true.
  • REBOOT: Die Nutzlast ist ein als String definiertes JSON-Objekt im Format { "user_session_delay_seconds": 300 }. Die Verzögerung muss im Bereich [0, 300] liegen.
  • FETCH_SUPPORT_PACKET: Nutzlast ist optional ein Stringified JSON-Objekt in folgendem Format: {"supportPacketDetails":{ "issueCaseId": optional_support_case_id_string, "issueDescription": optional_issue_description_string, "requestedDataCollectors": [<comma-separated list of data_collector_enums Ganzzahl values>]}}
    Die Liste der verfügbaren data_collector_enums-Protokolle (1), Chrome-Systemdetails (1), UI
    Weitere Informationen finden Sie 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.