Method: customer.devices.chromeos.issueCommand

Выдает команду устройству на выполнение.

HTTP-запрос

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

URL использует синтаксис перекодировки gRPC .

Параметры пути

Параметры
customerId

string

Неизменяемый. Идентификатор учетной записи Google Workspace.

deviceId

string

Неизменяемый. Идентификатор устройства Chrome OS.

Текст запроса

Тело запроса содержит данные со следующей структурой:

JSON-представление 
{
  "commandType": enum (CommandType),
  "payload": string
}
Поля
commandType

enum ( CommandType )

Тип команды.

payload

string

Полезная нагрузка для команды. Указывайте её только в том случае, если команда её поддерживает. Следующие команды поддерживают добавление полезной нагрузки:

  • SET_VOLUME : Полезная нагрузка — это строковый JSON-объект в формате: { "volume": 50 }. Объём должен быть целым числом в диапазоне [0,100].
  • DEVICE_START_CRD_SESSION : Полезная нагрузка может представлять собой строковый объект JSON в следующем формате: { "ackedUserPresence": true, "crdSessionType": string }. ackedUserPresence — логическое значение. По умолчанию ackedUserPresence имеет значение false . Чтобы запустить сеанс удаленного рабочего стола Chrome для активного устройства, установите ackedUserPresence в true . crdSessionType может выбирать только из значений private (что предоставляет удаленному администратору исключительный контроль над устройством ChromeOS) или shared (что позволяет администратору и локальному пользователю совместно управлять устройством ChromeOS). Если значение не задано, crdSessionType по умолчанию имеет значение shared . Команда FETCH_CRD_AVAILABILITY_INFO может использоваться для определения доступных типов сеансов на устройстве.
  • REBOOT : полезная нагрузка — это строковый JSON-объект в формате: { "user_session_delay_seconds": 300 }. user_session_delay_seconds — это количество секунд ожидания перед перезагрузкой устройства, если пользователь вошёл в систему. Это число должно быть целым числом в диапазоне [0,300]. Если полезная нагрузка отсутствует для перезагрузки, по умолчанию используется задержка 0. Примечание: это применимо только в том случае, если в системе находится реальный пользователь, включая гостя. Если устройство находится на экране входа или в режиме киоска, это значение не учитывается, и устройство немедленно перезагружается.
  • FETCH_SUPPORT_PACKET : полезная нагрузка может быть строковым объектом JSON в следующем формате: {"supportPacketDetails":{ "issueCaseId": optional_support_case_id_string, "issueDescription":optional_issue_description_string, "requestedDataCollectors": [<разделенный запятыми список целочисленных значений data_collector_enums >]}}
    Список доступных data_collector_enums выглядит следующим образом: информация о системе Chrome (1), идентификаторы сбоев (2), сведения о памяти (3), иерархия пользовательского интерфейса (4), дополнительные журналы платформы ChromeOS (5), событие устройства (6), дамп отладки сетевых карт Intel WiFi (7), события касания (8), Lacros (9), информация о системе Lacros (10), журналы ChromeOS Flex (11), сведения о DBus (12), сетевые маршруты ChromeOS (13), журналы ChromeOS Shill (диспетчера подключений) (14), политики (15), состояние и журналы системы ChromeOS (16), системные журналы ChromeOS (17), журналы пользователей ChromeOS Chrome (18), Bluetooth ChromeOS (19), подключенные устройства ввода ChromeOS (20), счетчики трафика ChromeOS (21), виртуальная клавиатура ChromeOS (22), состояние сети ChromeOS (23).
    Более подробную информацию смотрите в справочной статье .

Тело ответа

Ответ на выдачу команды.

В случае успеха тело ответа содержит данные со следующей структурой:

JSON-представление 
{
  "commandId": string
}
Поля
commandId

string ( int64 format)

Уникальный идентификатор выданной команды, используемый для получения статуса команды.

Области авторизации

Требуется следующая область OAuth:

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

Более подробную информацию смотрите в Руководстве по авторизации .