Method: customer.devices.chromeos.issueCommand

Gibt einen Befehl für das Gerät aus.

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. Die ID des ChromeOS-Geräts.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

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

enum (CommandType)

Der Befehlstyp.
payload

string

Die Nutzlast für den Befehl. Geben Sie sie nur an, wenn der Befehl dies unterstützt. Mit den folgenden Befehlen können Sie Nutzlast hinzufügen:

  • SET_VOLUME: Die Nutzlast ist ein JSON-Objekt im Stringformat in der Form { "volume": 50 }. Die Lautstärke muss eine Ganzzahl im Bereich [0,100] sein.
  • DEVICE_START_CRD_SESSION: Die Nutzlast ist optional ein JSON-Objekt im Stringformat in der Form: { "ackedUserPresence": true, "crdSessionType": string }. ackedUserPresence ist ein boolescher Wert. Standardmäßig ist ackedUserPresence auf false festgelegt. Wenn Sie eine Chrome Remote Desktop-Sitzung für ein aktives Gerät starten möchten, setzen Sie ackedUserPresence auf true. crdSessionType kann nur die Werte private (die dem Remote-Administrator die alleinige Kontrolle über das ChromeOS-Gerät gewährt) oder shared (die es dem Administrator und dem lokalen Nutzer ermöglicht, die Kontrolle über das ChromeOS-Gerät gemeinsam auszuüben) auswählen. Wenn crdSessionType nicht festgelegt ist, wird standardmäßig shared verwendet.
  • REBOOT: Die Nutzlast ist ein stringisiertes JSON-Objekt in folgendem Format: { "user_session_delay_seconds": 300 }. user_session_delay_seconds ist die Anzahl der Sekunden, die gewartet werden muss, bevor das Gerät neu gestartet wird, wenn ein Nutzer angemeldet ist. Es muss eine Ganzzahl im Bereich [0,300] sein. Wenn für den Neustart keine Nutzlast vorhanden ist, ist standardmäßig eine Verzögerung von 0 angegeben. Hinweis: Dies gilt nur, wenn ein tatsächlicher Nutzer angemeldet ist, einschließlich eines Gasts. Wenn sich das Gerät auf dem Anmeldebildschirm oder im Kioskmodus befindet, wird der Wert nicht berücksichtigt und das Gerät wird sofort neu gestartet.
  • FETCH_SUPPORT_PACKET: Die Nutzlast kann optional ein String-JSON-Objekt im folgenden Format sein: {"supportPacketDetails":{ "issueCaseId": optional_support_case_id_string, "issueDescription": optional_issue_description_string, "requestedDataCollectors": [<comma-separated list of data_collector_enums integer values>]}}
    Die Liste der verfügbaren data_collector_enums lautet: Chrome-Systeminformationen (1), Crash-IDs (2), Speicherdetails (3), UI-Hierarchie (4), zusätzliche ChromeOS-Plattformprotokolle (5), Geräteereignis (6), Intel-WiFi-NICs-Debug-Dump (7), Touch-Ereignisse (8), Lacros (9), Lacros-Systeminformationen (10), ChromeOS Flex-Protokolle (11), DBus-Details (12), ChromeOS-Netzwerkpfade (13), ChromeOS-Shill-Protokolle (Verbindungsmanager) (14), Richtlinien (15), ChromeOS-Systemstatus und ‑Protokolle (16), ChromeOS-Systemprotokolle (17), ChromeOS-Chrome-Nutzerprotokolle (18), ChromeOS-Bluetooth (19), ChromeOS-verbundene Eingabegeräte (20), ChromeOS-Traffic-Zähler (21), ChromeOS-virtuelle Tastatur (22), ChromeOS-Netzwerkstatus (23).
    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 erteilten Befehls, die zum Abrufen des Befehlsstatus verwendet wird.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie im Leitfaden zur Autorisierung.