Method: customer.devices.chromeos.issueCommand

Wydaje polecenie do wykonania przez urządzenie.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
customerId

string

Niezmienna. Identyfikator konta Google Workspace.
deviceId

string

Niezmienna. Identyfikator urządzenia z ChromeOS.

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "commandType": enum (CommandType),
  "payload": string
}
Pola
commandType

enum (CommandType)

Typ polecenia.
payload

string

Payload polecenia. Podaj go tylko wtedy, gdy polecenie go obsługuje. Te polecenia obsługują dodawanie ładunku:

  • SET_VOLUME: ładunek to obiekt JSON w postaci ciągu znaków w formie: { "volume": 50 }. Wartość musi być liczbą całkowitą z zakresu [0,100].
  • DEVICE_START_CRD_SESSION: ładunek to opcjonalnie obiekt JSON w postaci ciągu tekstowego w formie: { "ackedUserPresence": true, "crdSessionType": string }. ackedUserPresence to wartość logiczna. Domyślnie ackedUserPresence ma wartość false. Aby rozpocząć sesję Pulpitu zdalnego Chrome na aktywnym urządzeniu, ustaw wartość ackedUserPresence na true. crdSessionType może wybierać tylko wartości private (która przyznaje administratorowi zdalnego wyłączną kontrolę nad urządzeniem z ChromeOS) lub shared (która umożliwia administratorowi i użytkownikowi lokalnemu współdzielenie kontroli nad urządzeniem z ChromeOS). Jeśli nie jest ustawiony, crdSessionType przyjmuje domyślnie wartość shared.
  • REBOOT: Payload to zakodowany w postaci ciągu znaków obiekt JSON w formie: { "user_session_delay_seconds": 300 }. Wartość user_session_delay_seconds to liczba sekund, przez którą należy czekać przed ponownym uruchomieniem urządzenia, jeśli użytkownik jest zalogowany. Musi być liczbą całkowitą z zakresu [0,300]. Gdy dane nie są dostępne do ponownego uruchomienia, domyślnie opóźnienie wynosi 0. Uwaga: ta opcja działa tylko wtedy, gdy zalogowany jest rzeczywisty użytkownik, w tym Gość. Jeśli urządzenie jest na ekranie logowania lub w trybie kiosku, wartość nie jest uwzględniana, a urządzenie natychmiast się ponownie uruchamia.
  • FETCH_SUPPORT_PACKET: Payload to opcjonalnie ciąg znaków obiektu JSON w formie: {"supportPacketDetails":{ "issueCaseId": optional_support_case_id_string, "issueDescription": optional_issue_description_string, "requestedDataCollectors": [<comma-separated list of data_collector_enums integer values>]}}
    Lista dostępnych data_collector_enums: informacje o systemie Chrome (1), identyfikatory awarii (2), szczegóły pamięci (3), hierarchia interfejsu użytkownika (4), dodatkowe logi platformy ChromeOS (5), zdarzenie urządzenia (6), debugowanie Intel WiFi NICs (7), zdarzenia dotykowe (8), Lacros (9), informacje o systemie Lacros (10), logi ChromeOS Flex (11), szczegóły DBus (12), trasy sieciowe ChromeOS (13), logi ChromeOS Shill (14), zasady (15), stan systemu i logi ChromeOS (16), logi systemu ChromeOS (17), logi użytkownika ChromeOS Chrome (18), Bluetooth ChromeOS (19), urządzenia wejściowe ChromeOS (20), liczniki ruchu ChromeOS (21), klawiatura wirtualna ChromeOS (22), stan sieci ChromeOS (23).
    Więcej informacji znajdziesz w tym artykule pomocy.

Treść odpowiedzi

Odpowiedź na polecenie.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "commandId": string
}
Pola
commandId

string (int64 format)

Unikalny identyfikator polecenia, który służy do pobierania stanu polecenia.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w przewodniku dotyczącym autoryzacji.