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 계정의 ID입니다.
deviceId

string

변경할 수 없습니다. ChromeOS 기기의 ID입니다.

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "commandType": enum (CommandType),
  "payload": string
}
필드
commandType

enum (CommandType)

명령어 유형입니다.
payload

string

명령어의 페이로드입니다. 명령어에서 지원하는 경우에만 제공하세요. 다음 명령어는 페이로드 추가를 지원합니다.

  • SET_VOLUME: 페이로드는 { "volume": 50 } 형식의 문자열화된 JSON 객체입니다. 볼륨은 [0,100] 범위의 정수여야 합니다.
  • DEVICE_START_CRD_SESSION: 페이로드는 선택적으로 { "ackedUserPresence": true, "crdSessionType": string } 형식의 문자열화된 JSON 객체입니다. ackedUserPresence는 불리언입니다. 기본적으로 ackedUserPresence는 false로 설정됩니다. 활성 기기의 Chrome 원격 데스크톱 세션을 시작하려면 ackedUserPresence를 true로 설정하세요. crdSessionType는 private (원격 관리자에게 ChromeOS 기기의 배타적 제어 권한을 부여) 또는 shared (관리자와 로컬 사용자가 ChromeOS 기기의 제어 권한을 공유할 수 있음) 값 중에서만 선택할 수 있습니다. 설정하지 않으면 crdSessionType의 기본값은 shared입니다.
  • REBOOT: 페이로드는 { "user_session_delay_seconds": 300 } 형식의 문자열로 변환된 JSON 객체입니다. user_session_delay_seconds는 사용자가 로그인한 경우 기기를 재부팅하기 전에 기다릴 초 수를 나타냅니다. [0,300] 범위의 정수여야 합니다. 재부팅을 위한 페이로드가 없는 경우 기본 지연 시간은 0입니다. 참고: 게스트를 포함하여 실제 사용자가 로그인한 경우에만 적용됩니다. 기기가 로그인 화면 또는 키오스크 모드에 있는 경우 값이 적용되지 않고 기기가 즉시 재부팅됩니다.
  • FETCH_SUPPORT_PACKET: 페이로드는 선택적으로 다음과 같은 형식의 문자열로 된 JSON 객체입니다. {"supportPacketDetails":{ "issueCaseId": optional_support_case_id_string, "issueDescription": optional_issue_description_string, "requestedDataCollectors": [<comma-separated list of data_collector_enums integer values>]}}
    사용 가능한 data_collector_enums 목록은 다음과 같습니다. Chrome 시스템 정보 (1), 비정상 종료 ID (2), 메모리 세부정보 (3), UI 계층 구조 (4), 추가 ChromeOS 플랫폼 로그 (5), 기기 이벤트 (6), Intel Wi-Fi NIC 디버그 덤프 (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 블루투스 (19), ChromeOS 연결된 입력 장치 (20), ChromeOS 트래픽 카운터 (21), ChromeOS 가상 키보드 (22), ChromeOS 네트워크 상태 (23).
    자세한 내용은 도움말을 참고하세요.

응답 본문

명령어 실행에 대한 응답입니다.

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현 
{
  "commandId": string
}
필드
commandId

string (int64 format)

명령어 상태를 검색하는 데 사용되는, 실행된 명령어의 고유 ID입니다.

승인 범위

다음 OAuth 범위가 필요합니다.

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

자세한 내용은 승인 가이드를 참고하세요.