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 .
  • REBOOT : Полезная нагрузка представляет собой строковый объект JSON в форме: { "user_session_delay_секунды": 300 }. user_session_delay_seconds — это количество секунд ожидания перед перезагрузкой устройства, если пользователь вошел в систему. Оно должно быть целым числом в диапазоне [0,300]. Если полезная нагрузка отсутствует для перезагрузки, задержка по умолчанию равна 0. Примечание. Это применимо только в том случае, если в систему вошел реальный пользователь, включая гостя. Если устройство находится на экране входа в систему или в режиме киоска, значение не учитывается и устройство немедленно перезагружается.
  • FETCH_SUPPORT_PACKET : полезная нагрузка необязательно представляет собой строковый объект JSON в форме: {"supportPacketDetails":{ "issueCaseId": option_support_case_id_string, "issueDescription": option_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), ChromeOS Bluetooth (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

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