REST Resource: customers.telemetry.events

Ressource: TelemetryEvent

Données de télémétrie enregistré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)
  }
}
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 représentant le moment où l'événement a été signalé

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".
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 audio grave de sous-utilisation. Présent uniquement lorsque le champ eventType est défini sur AUDIO_SEVERE_UNDERRUN.
usbPeripheralsEvent

object (TelemetryUsbPeripheralsEvent)

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

object (TelemetryNetworkConnectionStateChangeEvent)

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

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 unique de l'API Directory 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 d'unité organisationnelle de l'appareil.

TelemetryUserInfo

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

  • 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 d'unité organisationnelle de l'utilisateur.

TelemetryAudioSevereUnderrunEvent

Ce type ne comporte aucun champ.

TelemetryAudioSevereUnderrunEvent se déclenche lorsqu'un appareil audio n'a plus de données de mémoire tampon pendant plus de cinq secondes.

  • Autorisation détaillée requise: TELEMETRY_API_AUDIO_REPORT

TelemetryUsbPeripheralsEvent

TelemetryUsbPeripheralsEvent : les 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 détaillée 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 de connexion actuel du réseau.

TelemetryHttpsLatencyChangeEvent

La routine de latence HTTPS est exécutée régulièrement et TelemetryHttpsLatencyChangeEvent se déclenche si un problème de latence a été détecté ou si l'appareil a résolu un problème de latence.

  • Autorisation détaillée 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 de latence HTTPS actuel.

HttpsLatencyState

État de latence HTTPS.

Enums
HTTPS_LATENCY_STATE_UNSPECIFIED L'état de latence HTTPS n'est pas spécifié.
RECOVERY Latence HTTPS résolue suite à un problème.
PROBLEM Problème de latence HTTPS.

TelemetryNetworkSignalStrengthEvent

TelemetryNetworkSignalStrengthEvent se déclenche en cas d'événements d'intensité du signal Wi-Fi.

  • Autorisation détaillée 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 d'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ébut. Pour les extensions, il s'agit 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 le cadre de Chrome OS.
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 d'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 une action de l'utilisateur.
APPLICATION_INSTALL_REASON_SUB_APP L'application a installé l'appel d'API bt SubApp.
APPLICATION_INSTALL_REASON_KIOSK Application installée par le mode Kiosque sur Chrome OS.
APPLICATION_INSTALL_REASON_COMMAND_LINE Application installée par l'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 de l'application

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ébut. Pour les extensions, il s'agit 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 d'applications).
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 sa migration

TelemetryAppLaunchEvent

Données sur le 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ébut. Pour les extensions, il s'agit 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 du 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épendants des requêtes (icônes plus grandes).
APPLICATION_LAUNCH_SOURCE_APP_LIST_QUERY_CONTEXT_MENU Application lancée à partir de résultats dépendants de la 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 des paramètres de contrôle parental et la notification d'heure par application.
APPLICATION_LAUNCH_SOURCE_SHELF Application lancée à partir de l'étagère.
APPLICATION_LAUNCH_SOURCE_FILE_MANAGER Application lancée à partir du gestionnaire de fichiers
APPLICATION_LAUNCH_SOURCE_OMNIBOX L'application a été 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 du raccourci clavier pour l'ouvrir.
APPLICATION_LAUNCH_SOURCE_OTHER_APP Application lancée en cliquant sur un lien dans une autre application ou interface Web.
APPLICATION_LAUNCH_SOURCE_MENU Application lancée depuis le menu.
APPLICATION_LAUNCH_SOURCE_INSTALLED_NOTIFICATION Application 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 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 intelligente.
APPLICATION_LAUNCH_SOURCE_DISCOVER_TAB_NOTIFICATION Application lancée depuis 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 à partir d'un kiosque.
APPLICATION_LAUNCH_SOURCE_COMMAND_LINE Application lancée à partir de la ligne de commande.
APPLICATION_LAUNCH_SOURCE_BACKGROUND_MODE Application 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 OS Login.
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 (chrome://apps) de l'application.
APPLICATION_LAUNCH_SOURCE_REPARENTING Lancement d'une application lors du déplacement du contenu vers une application.
APPLICATION_LAUNCH_SOURCE_PROFILE_MENU Application lancée depuis le menu de profil de l'interface utilisateur Web chrome://password-manager installable.
APPLICATION_LAUNCH_SOURCE_SYSTEM_TRAY_CALENDAR Application lancée depuis l'agenda de la barre d'état système.
APPLICATION_LAUNCH_SOURCE_INSTALLER Application lancée depuis le programme d'installation source.
APPLICATION_LAUNCH_SOURCE_FIRST_RUN Comptabilisez séparément les lancements de l'application d'aide à la première exécution afin de comprendre le nombre de lancements déclenchés par l'utilisateur.
APPLICATION_LAUNCH_SOURCE_WELCOME_TOUR Application lancée lors de la visite de bienvenue.
APPLICATION_LAUNCH_SOURCE_FOCUS_MODE Application lancée depuis le panneau de sélection.

Méthodes

list

 Répertorier les événements de télémétrie