REST Resource: customers.telemetry.events

Ressource : TelemetryEvent

Données de télémétrie signalé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)
  },
  "externalDisplaysEvent": {
    object (TelemetryExternalDisplayEvent)
  }
}
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 le moment où l'événement a été signalé.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) 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 actuel.
audioSevereUnderrunEvent

object (TelemetryAudioSevereUnderrunEvent)

Uniquement en sortie. Charge utile pour l'événement de sous-exécution audio sévère. Présent uniquement lorsque le champ eventType est défini sur AUDIO_SEVERE_UNDERRUN.
usbPeripheralsEvent

object (TelemetryUsbPeripheralsEvent)

Uniquement en sortie. Charge utile de l'événement des 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. Présent uniquement lorsque eventType est défini sur NETWORK_STATE_CHANGE.
httpsLatencyChangeEvent

object (TelemetryHttpsLatencyChangeEvent)

Uniquement en sortie. Charge utile de l'événement de modification de la latence HTTPS. Présent uniquement lorsque eventType est défini sur 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. Présent uniquement lorsque eventType est défini sur VPN_CONNECTION_STATE_CHANGE.
appInstallEvent

object (TelemetryAppInstallEvent)

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

object (TelemetryAppUninstallEvent)

Uniquement en sortie. Charge utile de l'événement de désinstallation de l'application. Présent uniquement lorsque eventType est défini sur 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 défini sur APP_LAUNCHED.
osCrashEvent

object (TelemetryOsCrashEvent)

Uniquement en sortie. Charge utile pour l'événement de plantage de l'OS. Présent uniquement lorsque eventType est défini sur OS_CRASH.
externalDisplaysEvent

object (TelemetryExternalDisplayEvent)

Uniquement en sortie. Charge utile pour l'événement de connexion/déconnexion d'un écran externe. Présent uniquement lorsque eventType est EXTERNAL_DISPLAY_CONNECTED ou EXTERNAL_DISPLAY_DISCONNECTED.

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 se déclenche lorsque les appareils audio manquent de données de mémoire tampon pendant plus de cinq secondes.

  • Autorisation précise requise : TELEMETRY_API_AUDIO_REPORT

TelemetryUsbPeripheralsEvent

TelemetryUsbPeripheralsEvent est déclenché lorsque 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é lorsque l'état de la connexion réseau change.

  • 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 réseau.

TelemetryHttpsLatencyChangeEvent

La routine de latence Https 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 remis d'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 latence HTTPS n'est pas spécifié.
RECOVERY La latence HTTPS est revenue à la normale après un problème.
PROBLEM Problème de latence HTTPS.

TelemetryNetworkSignalStrengthEvent

TelemetryNetworkSignalStrengthEvent est déclenché lors d'événements liés à l'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 des applications.

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)

Temps 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 dans 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 d'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 d'API SubApp.
APPLICATION_INSTALL_REASON_KIOSK Application installée par le kiosque sur ChromeOS.
APPLICATION_INSTALL_REASON_COMMAND_LINE Application installée par 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 Durée 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 des 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 L'application a été désinstallée de la liste des applications (lanceur d'applications).
APPLICATION_UNINSTALL_SOURCE_APP_MANAGEMENT L'application a été désinstallée depuis la page "Gestion des applications".
APPLICATION_UNINSTALL_SOURCE_SHELF L'application a été désinstallée de l'étagère.
APPLICATION_UNINSTALL_SOURCE_MIGRATION Application désinstallée lors de la migration d'applications.

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 du lancement de l'application.

Enums
APPLICATION_LAUNCH_SOURCE_UNSPECIFIED Source de lancement de l'application inconnue.
APPLICATION_LAUNCH_SOURCE_APP_LIST_GRID L'application a été 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épendant de la requête (icônes plus grandes).
APPLICATION_LAUNCH_SOURCE_APP_LIST_QUERY_CONTEXT_MENU Application lancée à partir de résultats dépendant d'une requête, 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 en saisissant 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 interface utilisateur Web.
APPLICATION_LAUNCH_SOURCE_MENU Application lancée depuis le menu.
APPLICATION_LAUNCH_SOURCE_INSTALLED_NOTIFICATION L'application a été lancée à partir de la notification d'installation.
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 la feuille de partage.
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 L'application a été lancée à partir d'une notification de l'onglet "Découvrir".
APPLICATION_LAUNCH_SOURCE_MANAGEMENT_API Application lancée depuis 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 L'application a été lancée depuis le 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 depuis 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 depuis la page d'accueil des applications (chrome://apps).
APPLICATION_LAUNCH_SOURCE_REPARENTING Application lancée à partir du déplacement de contenu dans une application.
APPLICATION_LAUNCH_SOURCE_PROFILE_MENU Application lancée depuis le menu de profil de l'UI Web chrome://password-manager installable.
APPLICATION_LAUNCH_SOURCE_SYSTEM_TRAY_CALENDAR L'application a été lancée depuis le calendrier de la barre d'état système.
APPLICATION_LAUNCH_SOURCE_INSTALLER Application lancée à partir du programme d'installation de la source.
APPLICATION_LAUNCH_SOURCE_FIRST_RUN Nous comptons séparément les lancements de l'application d'aide lors de la première exécution afin de comprendre le nombre de lancements déclenchés par les utilisateurs.
APPLICATION_LAUNCH_SOURCE_WELCOME_TOUR Application lancée depuis la visite guidée de bienvenue.
APPLICATION_LAUNCH_SOURCE_FOCUS_MODE L'application a été lancée depuis le panneau de contrôle.
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 la 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 du plantage.

CrashType

Décrit le type d'erreur.

Enums
CRASH_TYPE_UNSPECIFIED Type d'erreur inconnu.
CRASH_TYPE_KERNEL Plantage du noyau.
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.

TelemetryExternalDisplayEvent

Charge utile de l'événement de connexion/déconnexion d'un écran externe.

Représentation JSON 
{
  "externalDisplayData": [
    {
      object (TelemetryExternalDisplayData)
    }
  ]
}
Champs
externalDisplayData[]

object (TelemetryExternalDisplayData)

Liste des écrans externes qui ont été connectés/déconnectés.

TelemetryExternalDisplayData

Données d'affichage externe.

Représentation JSON 
{
  "displayName": string,
  "resolutionHorizontal": integer,
  "resolutionVertical": integer,
  "refreshRate": string,
  "serialNumber": integer,
  "edidVersion": string
}
Champs
displayName

string

Nom à afficher.
resolutionHorizontal

integer

Résolution horizontale.
resolutionVertical

integer

Résolution verticale.
refreshRate

string (int64 format)

Fréquence d'actualisation.
serialNumber

integer

Numéro de série
edidVersion

string

Version EDID.

Méthodes

list

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