REST Resource: customers.telemetry.events

리소스: TelemetryEvent

관리 기기에서 보고된 원격 분석 데이터입니다.

JSON 표현 
{
  "name": string,
  "device": {
    object (TelemetryDeviceInfo)
  },
  "user": {
    object (TelemetryUserInfo)
  },
  "reportTime": string,
  "eventType": enum (EventType),
  "audioSevereUnderrunEvent": {
    object (TelemetryAudioSevereUnderrunEvent)
  },
  "usbPeripheralsEvent": {
    object (TelemetryUsbPeripheralsEvent)
  },
  "networkStateChangeEvent": {
    object (TelemetryNetworkConnectionStateChangeEvent)
  },
  "httpsLatencyChangeEvent": {
    object (TelemetryHttpsLatencyChangeEvent)
  },
  "wifiSignalStrengthEvent": {
    object (TelemetryNetworkSignalStrengthEvent)
  },
  "vpnConnectionStateChangeEvent": {
    object (TelemetryNetworkConnectionStateChangeEvent)
  },
  "appInstallEvent": {
    object (TelemetryAppInstallEvent)
  },
  "appUninstallEvent": {
    object (TelemetryAppUninstallEvent)
  },
  "appLaunchEvent": {
    object (TelemetryAppLaunchEvent)
  },
  "osCrashEvent": {
    object (TelemetryOsCrashEvent)
  }
}
필드
name

string

출력 전용입니다. 이벤트의 리소스 이름입니다.
device

object (TelemetryDeviceInfo)

출력 전용입니다. 이벤트와 연결된 기기에 관한 정보입니다.
user

object (TelemetryUserInfo)

출력 전용입니다. 이벤트와 연결된 사용자에 대한 정보입니다.
reportTime

string (Timestamp format)

이벤트가 보고된 시점을 나타내는 타임스탬프입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
eventType

enum (EventType)

현재 이벤트의 이벤트 유형입니다.
audioSevereUnderrunEvent

object (TelemetryAudioSevereUnderrunEvent)

출력 전용입니다. 오디오 심각한 언더런 이벤트의 페이로드입니다. eventType 필드가 AUDIO_SEVERE_UNDERRUN인 경우에만 표시됩니다.
usbPeripheralsEvent

object (TelemetryUsbPeripheralsEvent)

출력 전용입니다. USB 주변기기 이벤트의 페이로드입니다. eventType 필드가 USB_ADDED 또는 USB_REMOVED인 경우에만 표시됩니다.
networkStateChangeEvent

object (TelemetryNetworkConnectionStateChangeEvent)

출력 전용입니다. 네트워크 연결 상태 변경 이벤트의 페이로드입니다. eventType이 NETWORK_STATE_CHANGE인 경우에만 표시됩니다.
httpsLatencyChangeEvent

object (TelemetryHttpsLatencyChangeEvent)

출력 전용입니다. HTTPS 지연 시간 변경 이벤트의 페이로드입니다. eventType이 NETWORK_HTTPS_LATENCY_CHANGE인 경우에만 표시됩니다.
wifiSignalStrengthEvent

object (TelemetryNetworkSignalStrengthEvent)

출력 전용입니다. Wi-Fi 신호 강도 이벤트의 페이로드입니다. eventType가 WIFI_SIGNAL_STRENGTH_LOW 또는 WIFI_SIGNAL_STRENGTH_RECOVERED인 경우에만 표시됩니다.
vpnConnectionStateChangeEvent

object (TelemetryNetworkConnectionStateChangeEvent)

출력 전용입니다. VPN 연결 상태 변경 이벤트의 페이로드입니다. eventType이 VPN_CONNECTION_STATE_CHANGE인 경우에만 표시됩니다.
appInstallEvent

object (TelemetryAppInstallEvent)

출력 전용입니다. 앱 설치 이벤트의 페이로드입니다. eventType이 APP_INSTALLED인 경우에만 표시됩니다.
appUninstallEvent

object (TelemetryAppUninstallEvent)

출력 전용입니다. 앱 제거 이벤트의 페이로드입니다. eventType이 APP_UNINSTALLED인 경우에만 표시됩니다.
appLaunchEvent

object (TelemetryAppLaunchEvent)

출력 전용입니다. 앱 실행 이벤트의 페이로드입니다.eventType이 APP_LAUNCHED인 경우에만 표시됩니다.
osCrashEvent

object (TelemetryOsCrashEvent)

출력 전용입니다. OS 비정상 종료 이벤트의 페이로드입니다. eventType이 OS_CRASH인 경우에만 표시됩니다.

TelemetryDeviceInfo

원격 분석 데이터와 연결된 기기에 대한 정보입니다.

  • 세분화된 권한 필요: TELEMETRY_API_DEVICE
JSON 표현 
{
  "deviceId": string,
  "orgUnitId": string
}
필드
deviceId

string

출력 전용입니다. 기기의 고유 Directory API ID입니다. 이 값은 ChromeOS 기기 탭의 관리 콘솔 Directory API ID와 동일합니다.
orgUnitId

string

출력 전용입니다. 기기의 조직 단위 ID입니다.

TelemetryUserInfo

원격 분석 데이터와 연결된 사용자에 대한 정보입니다.

  • 세분화된 권한 필요: TELEMETRY_API_USER
JSON 표현 
{
  "email": string,
  "orgUnitId": string
}
필드
email

string

출력 전용입니다. 사용자의 이메일
orgUnitId

string

출력 전용입니다. 사용자의 조직 단위 ID입니다.

TelemetryAudioSevereUnderrunEvent

이 유형에는 필드가 없습니다.

TelemetryAudioSevereUnderrunEvent은 오디오 기기의 버퍼 데이터가 5초 넘게 부족할 때 트리거됩니다.

  • 세분화된 권한 필요: TELEMETRY_API_AUDIO_REPORT

TelemetryUsbPeripheralsEvent

TelemetryUsbPeripheralsEvent가 트리거되면 USB 기기가 추가 또는 삭제됩니다.

  • 세분화된 권한 필요: TELEMETRY_API_PERIPHERALS_REPORT
JSON 표현 
{
  "usbPeripheralReport": [
    {
      object (UsbPeripheralReport)
    }
  ]
}
필드
usbPeripheralReport[]

object (UsbPeripheralReport)

추가 또는 삭제된 USB 기기 목록입니다.

TelemetryNetworkConnectionStateChangeEvent

TelemetryNetworkConnectionStateChangeEvent는 네트워크 연결 상태 변경 시 트리거됩니다.

  • 세분화된 권한 필요: TELEMETRY_API_NETWORK_REPORT
JSON 표현 
{
  "guid": string,
  "connectionState": enum (NetworkConnectionState)
}
필드
guid

string

네트워크의 고유 식별자입니다.
connectionState

enum (NetworkConnectionState)

네트워크의 현재 연결 상태입니다.

TelemetryHttpsLatencyChangeEvent

Https 지연 시간 루틴은 주기적으로 실행되며 지연 시간 문제가 감지되거나 기기가 지연 시간 문제에서 복구되면 TelemetryHttpsLatencyChangeEvent이 트리거됩니다.

  • 세분화된 권한 필요: TELEMETRY_API_NETWORK_REPORT
JSON 표현 
{
  "httpsLatencyRoutineData": {
    object (HttpsLatencyRoutineData)
  },
  "httpsLatencyState": enum (HttpsLatencyState)
}
필드
httpsLatencyRoutineData

object (HttpsLatencyRoutineData)

이벤트를 트리거한 HTTPS 지연 시간 루틴 데이터입니다.
httpsLatencyState

enum (HttpsLatencyState)

현재 HTTPS 지연 시간 상태입니다.

HttpsLatencyState

HTTPS 지연 시간 상태입니다.

열거형
HTTPS_LATENCY_STATE_UNSPECIFIED HTTPS 지연 시간 상태가 지정되지 않았습니다.
RECOVERY HTTPS 지연 시간이 문제에서 복구되었습니다.
PROBLEM HTTPS 지연 시간 문제

TelemetryNetworkSignalStrengthEvent

TelemetryNetworkSignalStrengthEvent는 Wi-Fi 신호 강도 이벤트에서 트리거됩니다.

  • 세분화된 권한 필요: TELEMETRY_API_NETWORK_REPORT
JSON 표현 
{
  "guid": string,
  "signalStrengthDbm": integer
}
필드
guid

string

네트워크의 고유 식별자입니다.
signalStrengthDbm

integer

신호 강도 RSSI 값입니다.

TelemetryAppInstallEvent

앱 설치 데이터

JSON 표현 
{
  "appInstallSource": enum (ApplicationInstallSource),
  "appInstallReason": enum (ApplicationInstallReason),
  "appInstallTime": enum (ApplicationInstallTime),
  "appId": string,
  "appType": enum (TelemetryApplicationType)
}
필드
appInstallSource

enum (ApplicationInstallSource)

앱 설치 소스입니다.
appInstallReason

enum (ApplicationInstallReason)

앱 설치 이유
appInstallTime

enum (ApplicationInstallTime)

앱 수명 주기에 따른 앱 설치 시간
appId

string

앱 ID입니다. PWA의 경우 시작 URL이고 확장 프로그램의 경우 확장 프로그램 ID입니다.
appType

enum (TelemetryApplicationType)

앱 유형입니다.

ApplicationInstallSource

앱 설치 소스를 설명합니다.

열거형
APPLICATION_INSTALL_SOURCE_UNSPECIFIED 애플리케이션 설치 소스를 알 수 없습니다.
APPLICATION_INSTALL_SOURCE_SYSTEM Chrome OS의 일부로 설치된 애플리케이션입니다.
APPLICATION_INSTALL_SOURCE_SYNC 애플리케이션 설치 소스는 동기화입니다.
APPLICATION_INSTALL_SOURCE_PLAY_STORE 애플리케이션 설치 소스는 Play 스토어입니다.
APPLICATION_INSTALL_SOURCE_CHROME_WEB_STORE 애플리케이션 설치 소스가 Chrome 웹 스토어입니다.
APPLICATION_INSTALL_SOURCE_BROWSER 애플리케이션 설치 소스는 브라우저입니다.

ApplicationInstallReason

앱 설치 이유를 설명합니다.

열거형
APPLICATION_INSTALL_REASON_UNSPECIFIED 애플리케이션 설치 이유를 알 수 없습니다.
APPLICATION_INSTALL_REASON_SYSTEM 시스템과 함께 설치되며 OS의 일부로 간주되는 애플리케이션입니다.
APPLICATION_INSTALL_REASON_POLICY 정책에 의해 설치된 애플리케이션
APPLICATION_INSTALL_REASON_OEM OEM에서 설치한 애플리케이션입니다.
APPLICATION_INSTALL_REASON_DEFAULT 기본적으로 설치되지만 시스템 앱으로 간주되지 않는 애플리케이션입니다.
APPLICATION_INSTALL_REASON_SYNC 동기화를 통해 설치된 애플리케이션
APPLICATION_INSTALL_REASON_USER 사용자가 설치한 애플리케이션입니다.
APPLICATION_INSTALL_REASON_SUB_APP SubApp API 호출을 통해 설치된 애플리케이션
APPLICATION_INSTALL_REASON_KIOSK ChromeOS에서 키오스크가 설치한 애플리케이션입니다.
APPLICATION_INSTALL_REASON_COMMAND_LINE 명령줄 인수로 설치된 애플리케이션

ApplicationInstallTime

앱 수명 주기에 따른 앱 설치 시간을 설명합니다.

열거형
APPLICATION_INSTALL_TIME_UNSPECIFIED 애플리케이션 설치 시간이 알 수 없습니다.
APPLICATION_INSTALL_TIME_INIT 애플리케이션 설치가 초기화됩니다.
APPLICATION_INSTALL_TIME_RUNNING 현재 애플리케이션 설치가 실행 중입니다.

TelemetryAppUninstallEvent

앱 제거 데이터

JSON 표현 
{
  "appUninstallSource": enum (ApplicationUninstallSource),
  "appId": string,
  "appType": enum (TelemetryApplicationType)
}
필드
appUninstallSource

enum (ApplicationUninstallSource)

앱 제거 소스입니다.
appId

string

앱 ID입니다. PWA의 경우 시작 URL이고 확장 프로그램의 경우 확장 프로그램 ID입니다.
appType

enum (TelemetryApplicationType)

앱 유형입니다.

ApplicationUninstallSource

앱 제거 소스를 설명합니다.

열거형
APPLICATION_UNINSTALL_SOURCE_UNSPECIFIED 애플리케이션 제거 소스가 알 수 없음
APPLICATION_UNINSTALL_SOURCE_APP_LIST 앱 목록 (런처)에서 애플리케이션이 제거되었습니다.
APPLICATION_UNINSTALL_SOURCE_APP_MANAGEMENT 앱 관리 페이지에서 애플리케이션이 제거되었습니다.
APPLICATION_UNINSTALL_SOURCE_SHELF 애플리케이션이 섹션에서 제거되었습니다.
APPLICATION_UNINSTALL_SOURCE_MIGRATION 앱 이전으로 인해 애플리케이션이 제거되었습니다.

TelemetryAppLaunchEvent

앱 실행 데이터

JSON 표현 
{
  "appLaunchSource": enum (ApplicationLaunchSource),
  "appId": string,
  "appType": enum (TelemetryApplicationType)
}
필드
appLaunchSource

enum (ApplicationLaunchSource)

앱 실행 소스입니다.
appId

string

앱 ID입니다. PWA의 경우 시작 URL이고 확장 프로그램의 경우 확장 프로그램 ID입니다.
appType

enum (TelemetryApplicationType)

앱 유형입니다.

ApplicationLaunchSource

앱 실행 소스를 설명합니다.

열거형
APPLICATION_LAUNCH_SOURCE_UNSPECIFIED 애플리케이션 실행 소스를 알 수 없습니다.
APPLICATION_LAUNCH_SOURCE_APP_LIST_GRID 검색창이 아닌 앱 그리드에서 실행된 애플리케이션
APPLICATION_LAUNCH_SOURCE_APP_LIST_GRID_CONTEXT_MENU 컨텍스트 메뉴가 아닌 앱 그리드에서 실행된 애플리케이션
APPLICATION_LAUNCH_SOURCE_APP_LIST_QUERY 쿼리 종속 결과에서 실행된 애플리케이션 (더 큰 아이콘)
APPLICATION_LAUNCH_SOURCE_APP_LIST_QUERY_CONTEXT_MENU 컨텍스트 메뉴가 아닌 쿼리 종속 결과에서 실행된 애플리케이션
APPLICATION_LAUNCH_SOURCE_APP_LIST_RECOMMENDATION 쿼리 없는 추천에서 실행된 애플리케이션 (작은 아이콘)
APPLICATION_LAUNCH_SOURCE_PARENTAL_CONTROLS 자녀 보호 기능 설정 섹션에서 실행된 애플리케이션 및 앱별 시간 알림
APPLICATION_LAUNCH_SOURCE_SHELF 섹션에서 애플리케이션이 실행되었습니다.
APPLICATION_LAUNCH_SOURCE_FILE_MANAGER 파일 관리자에서 실행된 애플리케이션
APPLICATION_LAUNCH_SOURCE_OMNIBOX 브라우저의 검색주소창에 URL을 입력하여 실행된 애플리케이션
APPLICATION_LAUNCH_SOURCE_CHROME_INTERNAL Chrome 내부 호출에서 실행된 애플리케이션
APPLICATION_LAUNCH_SOURCE_KEYBOARD 앱을 여는 단축키에서 실행된 애플리케이션입니다.
APPLICATION_LAUNCH_SOURCE_OTHER_APP 다른 앱 또는 웹UI에서 링크를 클릭하여 실행된 애플리케이션입니다.
APPLICATION_LAUNCH_SOURCE_MENU 메뉴에서 애플리케이션이 실행됩니다.
APPLICATION_LAUNCH_SOURCE_INSTALLED_NOTIFICATION 설치된 알림에서 실행된 애플리케이션
APPLICATION_LAUNCH_SOURCE_TEST 테스트에서 실행된 애플리케이션
APPLICATION_LAUNCH_SOURCE_ARC Arc에서 실행된 애플리케이션
APPLICATION_LAUNCH_SOURCE_SHARESHEET Sharesheet에서 실행된 애플리케이션
APPLICATION_LAUNCH_SOURCE_RELEASE_NOTES_NOTIFICATION 출시 노트 알림에서 실행된 애플리케이션
APPLICATION_LAUNCH_SOURCE_FULL_RESTORE 전체 복원에서 실행된 애플리케이션
APPLICATION_LAUNCH_SOURCE_SMART_TEXT_CONTEXT_MENU 스마트 텍스트 선택 컨텍스트 메뉴에서 실행된 애플리케이션
APPLICATION_LAUNCH_SOURCE_DISCOVER_TAB_NOTIFICATION 탐색 탭 알림에서 실행된 애플리케이션
APPLICATION_LAUNCH_SOURCE_MANAGEMENT_API Management API에서 실행된 애플리케이션
APPLICATION_LAUNCH_SOURCE_KIOSK 키오스크에서 애플리케이션이 실행되었습니다.
APPLICATION_LAUNCH_SOURCE_COMMAND_LINE 명령줄에서 실행된 애플리케이션
APPLICATION_LAUNCH_SOURCE_BACKGROUND_MODE 백그라운드 모드에서 실행된 애플리케이션
APPLICATION_LAUNCH_SOURCE_NEW_TAB_PAGE 새 탭 페이지에서 실행된 애플리케이션
APPLICATION_LAUNCH_SOURCE_INTENT_URL 인텐트 URL에서 실행된 애플리케이션
APPLICATION_LAUNCH_SOURCE_OS_LOGIN OS 로그인에서 실행된 애플리케이션
APPLICATION_LAUNCH_SOURCE_PROTOCOL_HANDLER 프로토콜 핸들러에서 실행된 애플리케이션입니다.
APPLICATION_LAUNCH_SOURCE_URL_HANDLER URL 핸들러에서 실행된 애플리케이션
APPLICATION_LAUNCH_SOURCE_LOCK_SCREEN 잠금 화면 앱 런처에서 실행된 애플리케이션
APPLICATION_LAUNCH_SOURCE_APP_HOME_PAGE 앱 홈 (chrome://apps) 페이지에서 실행된 애플리케이션
APPLICATION_LAUNCH_SOURCE_REPARENTING 콘텐츠를 앱으로 이동하면서 실행된 애플리케이션입니다.
APPLICATION_LAUNCH_SOURCE_PROFILE_MENU 설치 가능한 chrome://password-manager WebUI의 프로필 메뉴에서 실행된 애플리케이션입니다.
APPLICATION_LAUNCH_SOURCE_SYSTEM_TRAY_CALENDAR 작업 표시줄 캘린더에서 실행된 애플리케이션
APPLICATION_LAUNCH_SOURCE_INSTALLER 소스 설치 프로그램에서 실행된 애플리케이션입니다.
APPLICATION_LAUNCH_SOURCE_FIRST_RUN 사용자 트리거 실행 수를 파악할 수 있도록 최초 실행 도움말 앱 실행 수를 별도로 집계합니다.
APPLICATION_LAUNCH_SOURCE_WELCOME_TOUR 시작 둘러보기에서 애플리케이션이 실행되었습니다.
APPLICATION_LAUNCH_SOURCE_FOCUS_MODE 포커스 패널에서 실행된 애플리케이션
APPLICATION_LAUNCH_SOURCE_SPARKY 실험용 기능 Sparky에서 실행된 애플리케이션
APPLICATION_LAUNCH_SOURCE_NAVIGATION_CAPTURING 탐색 캡처에서 실행된 애플리케이션
APPLICATION_LAUNCH_SOURCE_WEB_INSTALL_API 웹 설치 API에서 실행된 애플리케이션

TelemetryOsCrashEvent

OS 비정상 종료 데이터

JSON 표현 
{
  "crashType": enum (CrashType),
  "sessionType": enum (SessionType),
  "crashId": string
}
필드
crashType

enum (CrashType)

비정상 종료 유형입니다.
sessionType

enum (SessionType)

세션 유형입니다.
crashId

string

비정상 종료 ID

CrashType

비정상 종료 유형을 설명합니다.

열거형
CRASH_TYPE_UNSPECIFIED 비정상 종료 유형을 알 수 없습니다.
CRASH_TYPE_KERNEL 커널 비정상 종료
CRASH_TYPE_EMBEDDED_CONTROLLER 삽입된 컨트롤러 비정상 종료

SessionType

세션 유형을 설명합니다.

열거형
SESSION_TYPE_UNSPECIFIED 세션 유형을 알 수 없습니다.
SESSION_TYPE_SIGNED_IN_USER 로그인한 사용자
SESSION_TYPE_KIOSK 키오스크:
SESSION_TYPE_MANAGED_GUEST 관리 게스트 세션
SESSION_TYPE_ACTIVE_DIRECTORY Active Directory 세션

메서드

list

 원격 분석 이벤트를 나열합니다.