REST Resource: customers.telemetry.events

Ressource: TelemetryEvent

Données de télémétrie envoyées par un appareil géré.

Représentation 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)
  }
}
Champs
name

string

Uniquement en sortie. Nom de ressource de l'événement.
device

object (TelemetryDeviceInfo)

Uniquement en sortie. Informations sur l'appareil associé à l'événement.
user

object (TelemetryUserInfo)

Uniquement en sortie. Informations sur l'utilisateur associé à l'événement.
reportTime

string (Timestamp format)

Code temporel indiquant quand l'événement a été signalé.

Utilise la norme RFC 3339, où la sortie générée est toujours normalisée avec le suffixe Z et utilise 0, 3, 6 ou 9 chiffres décimaux. Les décalages autres que "Z" sont également acceptés. Exemples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
eventType

enum (EventType)

Type d'événement de l'événement en cours.
audioSevereUnderrunEvent

object (TelemetryAudioSevereUnderrunEvent)

Uniquement en sortie. Charge utile pour l'événement de sous-dépassement audio sévère. N'est présent que lorsque le champ eventType est AUDIO_SEVERE_UNDERRUN.
usbPeripheralsEvent

object (TelemetryUsbPeripheralsEvent)

Uniquement en sortie. Charge utile de l'événement de périphériques USB. Présent uniquement lorsque le champ eventType est USB_ADDED ou USB_REMOVED.
networkStateChangeEvent

object (TelemetryNetworkConnectionStateChangeEvent)

Uniquement en sortie. Charge utile de l'événement de modification de l'état de la connexion réseau. N'est présent que si eventType est NETWORK_STATE_CHANGE.
httpsLatencyChangeEvent

object (TelemetryHttpsLatencyChangeEvent)

Uniquement en sortie. Charge utile de l'événement de modification de la latence HTTPS. N'est présent que si eventType est NETWORK_HTTPS_LATENCY_CHANGE.
wifiSignalStrengthEvent

object (TelemetryNetworkSignalStrengthEvent)

Uniquement en sortie. Charge utile pour les événements d'intensité du signal Wi-Fi. Présent uniquement lorsque eventType est WIFI_SIGNAL_STRENGTH_LOW ou WIFI_SIGNAL_STRENGTH_RECOVERED.
vpnConnectionStateChangeEvent

object (TelemetryNetworkConnectionStateChangeEvent)

Uniquement en sortie. Charge utile pour l'événement de changement d'état de la connexion VPN. N'est présent que si eventType est VPN_CONNECTION_STATE_CHANGE.
appInstallEvent

object (TelemetryAppInstallEvent)

Uniquement en sortie. Charge utile de l'événement d'installation d'application. Présente uniquement lorsque eventType est APP_INSTALLED.
appUninstallEvent

object (TelemetryAppUninstallEvent)

Uniquement en sortie. Charge utile de l'événement de désinstallation d'application. Présente uniquement lorsque eventType est APP_UNINSTALLED.
appLaunchEvent

object (TelemetryAppLaunchEvent)

Uniquement en sortie. Charge utile de l'événement de lancement de l'application.Présente uniquement lorsque eventType est APP_LAUNCHED.
osCrashEvent

object (TelemetryOsCrashEvent)

Uniquement en sortie. Charge utile de l'événement de plantage de l'OS. Présente uniquement lorsque eventType est OS_CRASH.

TelemetryDeviceInfo

Informations sur un appareil associé à des données de télémétrie.

  • Autorisation précise requise: TELEMETRY_API_DEVICE
Représentation JSON 
{
  "deviceId": string,
  "orgUnitId": string
}
Champs
deviceId

string

Uniquement en sortie. ID d'API Directory unique de l'appareil. Cette valeur est identique à l'ID de l'API Directory de la console d'administration dans l'onglet "Appareils ChromeOS".
orgUnitId

string

Uniquement en sortie. ID de l'unité organisationnelle de l'appareil.

TelemetryUserInfo

Informations sur un utilisateur associées aux données télémétriques.

  • Autorisation précise requise: TELEMETRY_API_USER
Représentation JSON 
{
  "email": string,
  "orgUnitId": string
}
Champs
email

string

Uniquement en sortie. Adresse e-mail de l'utilisateur.
orgUnitId

string

Uniquement en sortie. ID de l'unité organisationnelle de l'utilisateur.

TelemetryAudioSevereUnderrunEvent

Ce type ne comporte aucun champ.

TelemetryAudioSevereUnderrunEvent est déclenché lorsqu'un appareil audio manque de données de tampon pendant plus de cinq secondes.

  • Autorisation précise requise: TELEMETRY_API_AUDIO_REPORT

TelemetryUsbPeripheralsEvent

TelemetryUsbPeripheralsEvent est déclenché Des appareils USB sont ajoutés ou supprimés.

  • Autorisation précise requise: TELEMETRY_API_PERIPHERALS_REPORT
Représentation JSON 
{
  "usbPeripheralReport": [
    {
      object (UsbPeripheralReport)
    }
  ]
}
Champs
usbPeripheralReport[]

object (UsbPeripheralReport)

Liste des appareils USB ajoutés ou supprimés.

TelemetryNetworkConnectionStateChangeEvent

TelemetryNetworkConnectionStateChangeEvent est déclenché en cas de changement d'état de la connexion réseau.

  • Autorisation précise requise: TELEMETRY_API_NETWORK_REPORT
Représentation JSON 
{
  "guid": string,
  "connectionState": enum (NetworkConnectionState)
}
Champs
guid

string

Identifiant unique du réseau.
connectionState

enum (NetworkConnectionState)

État actuel de la connexion du réseau.

TelemetryHttpsLatencyChangeEvent

La routine de latence HTTP est exécutée périodiquement et TelemetryHttpsLatencyChangeEvent est déclenchée si un problème de latence a été détecté ou si l'appareil s'est rétabli après un problème de latence.

  • Autorisation précise requise: TELEMETRY_API_NETWORK_REPORT
Représentation JSON 
{
  "httpsLatencyRoutineData": {
    object (HttpsLatencyRoutineData)
  },
  "httpsLatencyState": enum (HttpsLatencyState)
}
Champs
httpsLatencyRoutineData

object (HttpsLatencyRoutineData)

Données de routine de latence HTTPS ayant déclenché l'événement.
httpsLatencyState

enum (HttpsLatencyState)

État actuel de la latence HTTPS.

HttpsLatencyState

État de la latence HTTPS.

Enums
HTTPS_LATENCY_STATE_UNSPECIFIED L'état de la latence HTTPS n'est pas spécifié.
RECOVERY La latence HTTPS a été rétablie après un problème.
PROBLEM Problème de latence HTTPS.

TelemetryNetworkSignalStrengthEvent

TelemetryNetworkSignalStrengthEvent est déclenché sur les événements d'intensité du signal Wi-Fi.

  • Autorisation précise requise: TELEMETRY_API_NETWORK_REPORT
Représentation JSON 
{
  "guid": string,
  "signalStrengthDbm": integer
}
Champs
guid

string

Identifiant unique du réseau.
signalStrengthDbm

integer

Valeur RSSI de l'intensité du signal.

TelemetryAppInstallEvent

Données d'installation de l'application.

Représentation JSON 
{
  "appInstallSource": enum (ApplicationInstallSource),
  "appInstallReason": enum (ApplicationInstallReason),
  "appInstallTime": enum (ApplicationInstallTime),
  "appId": string,
  "appType": enum (TelemetryApplicationType)
}
Champs
appInstallSource

enum (ApplicationInstallSource)

Source d'installation de l'application.
appInstallReason

enum (ApplicationInstallReason)

Motif de l'installation de l'application.
appInstallTime

enum (ApplicationInstallTime)

Durée d'installation de l'application en fonction de son cycle de vie
appId

string

ID de l'application. Pour les PWA, il s'agit de l'URL de démarrage, et pour les extensions, de l'ID de l'extension.
appType

enum (TelemetryApplicationType)

Type d'application.

ApplicationInstallSource

Décrit la source d'installation de l'application.

Enums
APPLICATION_INSTALL_SOURCE_UNSPECIFIED La source d'installation de l'application est inconnue.
APPLICATION_INSTALL_SOURCE_SYSTEM Application installée avec ChromeOS
APPLICATION_INSTALL_SOURCE_SYNC La source d'installation de l'application est une synchronisation.
APPLICATION_INSTALL_SOURCE_PLAY_STORE La source d'installation de l'application est le Play Store.
APPLICATION_INSTALL_SOURCE_CHROME_WEB_STORE La source d'installation de l'application est le Chrome Web Store.
APPLICATION_INSTALL_SOURCE_BROWSER La source d'installation de l'application est un navigateur.

ApplicationInstallReason

Décrit le motif de l'installation de l'application.

Enums
APPLICATION_INSTALL_REASON_UNSPECIFIED Le motif de l'installation de l'application est inconnu.
APPLICATION_INSTALL_REASON_SYSTEM Application installée avec le système et considérée comme faisant partie de l'OS.
APPLICATION_INSTALL_REASON_POLICY Application installée par une règle.
APPLICATION_INSTALL_REASON_OEM Application installée par un fabricant d'équipement d'origine (OEM).
APPLICATION_INSTALL_REASON_DEFAULT Application installée par défaut, mais qui n'est pas considérée comme une application système.
APPLICATION_INSTALL_REASON_SYNC Application installée par synchronisation.
APPLICATION_INSTALL_REASON_USER Application installée par l'utilisateur.
APPLICATION_INSTALL_REASON_SUB_APP Application installée par l'appel de l'API SubApp.
APPLICATION_INSTALL_REASON_KIOSK Application installée par le kiosque sur ChromeOS.
APPLICATION_INSTALL_REASON_COMMAND_LINE Application installée à l'aide d'un argument de ligne de commande.

ApplicationInstallTime

Décrit le temps d'installation de l'application en fonction de son cycle de vie.

Enums
APPLICATION_INSTALL_TIME_UNSPECIFIED Heure d'installation de l'application inconnue.
APPLICATION_INSTALL_TIME_INIT L'installation de l'application est initialisée.
APPLICATION_INSTALL_TIME_RUNNING L'installation de l'application est en cours.

TelemetryAppUninstallEvent

Données de désinstallation d'applications

Représentation JSON 
{
  "appUninstallSource": enum (ApplicationUninstallSource),
  "appId": string,
  "appType": enum (TelemetryApplicationType)
}
Champs
appUninstallSource

enum (ApplicationUninstallSource)

Source de désinstallation de l'application.
appId

string

ID de l'application. Pour les PWA, il s'agit de l'URL de démarrage, et pour les extensions, de l'ID de l'extension.
appType

enum (TelemetryApplicationType)

Type d'application.

ApplicationUninstallSource

Décrit la source de désinstallation de l'application.

Enums
APPLICATION_UNINSTALL_SOURCE_UNSPECIFIED Source de désinstallation de l'application inconnue.
APPLICATION_UNINSTALL_SOURCE_APP_LIST Application désinstallée de la liste des applications (lanceur).
APPLICATION_UNINSTALL_SOURCE_APP_MANAGEMENT Application désinstallée depuis la page "Gestion des applications".
APPLICATION_UNINSTALL_SOURCE_SHELF Application désinstallée de l'étagère.
APPLICATION_UNINSTALL_SOURCE_MIGRATION Application désinstallée lors de la migration.

TelemetryAppLaunchEvent

Données de lancement de l'application.

Représentation JSON 
{
  "appLaunchSource": enum (ApplicationLaunchSource),
  "appId": string,
  "appType": enum (TelemetryApplicationType)
}
Champs
appLaunchSource

enum (ApplicationLaunchSource)

Source de lancement de l'application.
appId

string

ID de l'application. Pour les PWA, il s'agit de l'URL de démarrage, et pour les extensions, de l'ID de l'extension.
appType

enum (TelemetryApplicationType)

Type d'application.

ApplicationLaunchSource

Décrit la source de lancement de l'application.

Enums
APPLICATION_LAUNCH_SOURCE_UNSPECIFIED Source de lancement de l'application inconnue.
APPLICATION_LAUNCH_SOURCE_APP_LIST_GRID Application lancée depuis la grille d'applications, et non depuis le champ de recherche.
APPLICATION_LAUNCH_SOURCE_APP_LIST_GRID_CONTEXT_MENU Application lancée à partir de la grille d'applications, en dehors du menu contextuel.
APPLICATION_LAUNCH_SOURCE_APP_LIST_QUERY Application lancée à partir de résultats dépendants de la requête (icônes plus grandes).
APPLICATION_LAUNCH_SOURCE_APP_LIST_QUERY_CONTEXT_MENU Application lancée à partir des résultats dépendants des requêtes, en dehors du menu contextuel.
APPLICATION_LAUNCH_SOURCE_APP_LIST_RECOMMENDATION Application lancée à partir de recommandations sans requête (icônes plus petites).
APPLICATION_LAUNCH_SOURCE_PARENTAL_CONTROLS Application lancée depuis la section "Paramètres du contrôle parental" et notification de temps par application.
APPLICATION_LAUNCH_SOURCE_SHELF Application lancée depuis l'étagère.
APPLICATION_LAUNCH_SOURCE_FILE_MANAGER Application lancée depuis le gestionnaire de fichiers
APPLICATION_LAUNCH_SOURCE_OMNIBOX Application lancée après avoir saisi une URL dans l'omnibox du navigateur.
APPLICATION_LAUNCH_SOURCE_CHROME_INTERNAL Application lancée à partir d'un appel interne Chrome.
APPLICATION_LAUNCH_SOURCE_KEYBOARD Application lancée à partir d'un raccourci clavier pour ouvrir l'application.
APPLICATION_LAUNCH_SOURCE_OTHER_APP Application lancée en cliquant sur un lien dans une autre application ou une UI Web.
APPLICATION_LAUNCH_SOURCE_MENU Application lancée à partir du menu.
APPLICATION_LAUNCH_SOURCE_INSTALLED_NOTIFICATION Application lancée à partir de la notification installée.
APPLICATION_LAUNCH_SOURCE_TEST Application lancée à partir d'un test.
APPLICATION_LAUNCH_SOURCE_ARC Application lancée depuis Arc.
APPLICATION_LAUNCH_SOURCE_SHARESHEET Application lancée depuis Sharesheet.
APPLICATION_LAUNCH_SOURCE_RELEASE_NOTES_NOTIFICATION Application lancée à partir de la notification des notes de version.
APPLICATION_LAUNCH_SOURCE_FULL_RESTORE Application lancée à partir d'une restauration complète.
APPLICATION_LAUNCH_SOURCE_SMART_TEXT_CONTEXT_MENU Application lancée à partir d'un menu contextuel de sélection de texte intelligent.
APPLICATION_LAUNCH_SOURCE_DISCOVER_TAB_NOTIFICATION Application lancée à partir d'une notification de l'onglet "Découvrir".
APPLICATION_LAUNCH_SOURCE_MANAGEMENT_API Application lancée à partir de l'API Management.
APPLICATION_LAUNCH_SOURCE_KIOSK Application lancée depuis le kiosque.
APPLICATION_LAUNCH_SOURCE_COMMAND_LINE Application lancée à partir de la ligne de commande.
APPLICATION_LAUNCH_SOURCE_BACKGROUND_MODE Application lancée en mode arrière-plan.
APPLICATION_LAUNCH_SOURCE_NEW_TAB_PAGE Application lancée depuis la page "Nouvel onglet".
APPLICATION_LAUNCH_SOURCE_INTENT_URL Application lancée à partir d'une URL d'intent.
APPLICATION_LAUNCH_SOURCE_OS_LOGIN Application lancée à partir de la connexion au système d'exploitation.
APPLICATION_LAUNCH_SOURCE_PROTOCOL_HANDLER Application lancée à partir du gestionnaire de protocoles.
APPLICATION_LAUNCH_SOURCE_URL_HANDLER Application lancée à partir du gestionnaire d'URL.
APPLICATION_LAUNCH_SOURCE_LOCK_SCREEN Application lancée depuis le lanceur d'applications de l'écran de verrouillage.
APPLICATION_LAUNCH_SOURCE_APP_HOME_PAGE Application lancée à partir de la page d'accueil de l'application (chrome://apps).
APPLICATION_LAUNCH_SOURCE_REPARENTING Application lancée à partir du déplacement de contenu vers une application.
APPLICATION_LAUNCH_SOURCE_PROFILE_MENU Application lancée à partir du menu de profil de l'UI Web installable chrome://password-manager.
APPLICATION_LAUNCH_SOURCE_SYSTEM_TRAY_CALENDAR Application lancée à partir du calendrier de la barre d'état système.
APPLICATION_LAUNCH_SOURCE_INSTALLER Application lancée à partir de l'installateur source.
APPLICATION_LAUNCH_SOURCE_FIRST_RUN Comptez les lancements de l'application d'aide lors de la première utilisation séparément afin que nous puissions comprendre le nombre de lancements déclenchés par l'utilisateur.
APPLICATION_LAUNCH_SOURCE_WELCOME_TOUR Application lancée à partir de la visite guidée.
APPLICATION_LAUNCH_SOURCE_FOCUS_MODE Application lancée à partir du panneau de sélection.
APPLICATION_LAUNCH_SOURCE_SPARKY Application lancée à partir de la fonctionnalité expérimentale Sparky.
APPLICATION_LAUNCH_SOURCE_NAVIGATION_CAPTURING Application lancée à partir de la capture de navigation.
APPLICATION_LAUNCH_SOURCE_WEB_INSTALL_API Application lancée à partir de l'API d'installation Web.

TelemetryOsCrashEvent

Données sur les plantages de l'OS.

Représentation JSON 
{
  "crashType": enum (CrashType),
  "sessionType": enum (SessionType),
  "crashId": string
}
Champs
crashType

enum (CrashType)

Type de plantage.
sessionType

enum (SessionType)

Type de session.
crashId

string

ID de plantage.

CrashType

Décrit le type de plantage.

Enums
CRASH_TYPE_UNSPECIFIED Type de plantage inconnu.
CRASH_TYPE_KERNEL Plantage du kernel.
CRASH_TYPE_EMBEDDED_CONTROLLER Plantage du contrôleur intégré.

SessionType

Décrit le type de session.

Enums
SESSION_TYPE_UNSPECIFIED Type de session inconnu.
SESSION_TYPE_SIGNED_IN_USER Utilisateur connecté
SESSION_TYPE_KIOSK Kiosque :
SESSION_TYPE_MANAGED_GUEST Session Invité gérée.
SESSION_TYPE_ACTIVE_DIRECTORY Session Active Directory.

Méthodes

list

 Lister les événements de télémétrie