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)
  }
}
필드
name

string

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

object (TelemetryDeviceInfo)

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

object (TelemetryUserInfo)

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

string (Timestamp format)

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

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.
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인 경우에만 존재합니다.

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

HTTP 지연 시간 루틴은 주기적으로 실행되며 지연 시간 문제가 감지되거나 기기가 지연 시간 문제에서 복구되면 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 애플리케이션이 bt SubApp API 호출을 설치했습니다.
APPLICATION_INSTALL_REASON_KIOSK Chrome OS의 키오스크에서 설치한 애플리케이션
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 다른 앱 또는 WebUI의 링크를 클릭하여 실행된 애플리케이션
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 웹 UI의 프로필 메뉴에서 애플리케이션이 실행되었습니다.
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에서 실행된 애플리케이션입니다.

메서드

list

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