Method: customer.devices.chromeos.issueCommand

Wydaje polecenie, które urządzenie ma wykonać.

Żą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

Niezmienne. Identyfikator konta Google Workspace.
deviceId

string

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

Ładunek polecenia. Podaj go tylko wtedy, gdy polecenie go obsługuje. Dodawanie ładunku jest obsługiwane przez te polecenia:

  • SET_VOLUME: ładunek to ciąg znaków obiektu JSON w formacie: { "volume": 50 }. Głośność musi być liczbą całkowitą z zakresu [0,100].
  • DEVICE_START_CRD_SESSION: ładunek może być opcjonalnie ciągiem znaków obiektu JSON w formacie: { "ackedUserPresence": true, "crdSessionType": string }. ackedUserPresence to wartość logiczna. Domyślnie parametr ackedUserPresence ma wartość false. Aby rozpocząć sesję Pulpitu zdalnego Chrome na aktywnym urządzeniu, ustaw wartość ackedUserPresence na true. crdSessionType może wybrać tylko wartości private (która przyznaje zdalnemu administratorowi wyłączną kontrolę nad urządzeniem z ChromeOS) lub shared (która umożliwia administratorowi i lokalnemu użytkownikowi współdzielenie kontroli nad urządzeniem z ChromeOS). Jeśli nie jest ustawiony, crdSessionType domyślnie przyjmuje wartość shared. Za pomocą polecenia FETCH_CRD_AVAILABILITY_INFO możesz określić typy sesji dostępne na urządzeniu.
  • REBOOT: ładunek to ciąg znaków będący obiektem JSON w formacie: { "user_session_delay_seconds": 300 }. Wartość user_session_delay_seconds to liczba sekund, które należy odczekać przed ponownym uruchomieniem urządzenia, jeśli użytkownik jest zalogowany. Musi to być liczba całkowita z zakresu [0,300]. Jeśli w przypadku ponownego uruchomienia nie ma danych, domyślnie ustawiane jest opóźnienie 0. Uwaga: dotyczy to tylko sytuacji, gdy zalogowany jest prawdziwy użytkownik, w tym gość. Jeśli urządzenie jest na ekranie logowania lub w trybie kiosku, wartość nie jest uwzględniana i urządzenie natychmiast uruchamia się ponownie.
  • FETCH_SUPPORT_PACKET: ładunek jest opcjonalnie ciągiem znaków obiektu JSON w formacie: {"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 jest następująca: informacje o systemie Chrome (1), identyfikatory awarii (2), szczegóły pamięci (3), hierarchia interfejsu (4), dodatkowe logi platformy ChromeOS (5), zdarzenie na urządzeniu (6), zrzut debugowania kart sieciowych Intel WiFi (7), zdarzenia dotyku (8), Lacros (9), informacje o systemie Lacros (10), logi ChromeOS Flex (11), szczegóły DBus (12), trasy sieciowe ChromeOS (13), logi ChromeOS Shill (menedżera połączeń) (14), zasady (15), stan systemu ChromeOS i logi (16), logi systemowe ChromeOS (17), logi użytkownika ChromeOS (18), Bluetooth ChromeOS (19), podłączone urządzenia wejściowe ChromeOS (20), liczniki ruchu ChromeOS (21), klawiatura wirtualna ChromeOS (22), stan sieci ChromeOS (23).
     Więcej informacji znajdziesz w artykule pomocy.

Treść odpowiedzi

Odpowiedź na wydane polecenie.

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

Zapis JSON 
{
  "commandId": string
}
Pola
commandId

string (int64 format)

Unikalny identyfikator wydanego 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 po autoryzacji.