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)
  }
}
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)

Horodatage 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 en cours.

audioSevereUnderrunEvent

object (TelemetryAudioSevereUnderrunEvent)

Uniquement en sortie. Charge utile pour é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 lié aux 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 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 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 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é aux 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 d'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é aux 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 est à court de données de la mémoire tampon pendant plus de cinq secondes.

  • Autorisation précise requise: TELEMETRY_API_AUDIO_REPORT

TelemetryUsbPeripheralsEvent

TelemetryUsbPeripheralsEvent est déclenché. 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 qui ont été ajoutés ou supprimés.

TelemetryNetworkConnectionStateChangeEvent

TelemetryNetworkConnectionStateChangeEvent se déclenche 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 régulièrement et TelemetryHttpsLatencyChangeEvent se déclenche si un problème de latence a été détecté ou si l'appareil a récupéré 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 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écupérée à la suite d'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 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 d'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)

Le 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. Pour les extensions, il s'agit de l'ID d'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 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 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 via la 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 SubApp.
APPLICATION_INSTALL_REASON_KIOSK Application installée par kiosque sur ChromeOS.
APPLICATION_INSTALL_REASON_COMMAND_LINE Application installée via un argument de ligne de commande.

ApplicationInstallTime

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

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 la désinstallation de l'application.

appId

string

ID de l'application. Pour les PWA, il s'agit de l'URL de démarrage. Pour les extensions, il s'agit de l'ID d'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 la 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 de la page "Gestion d'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 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. Pour les extensions, il s'agit de l'ID d'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épendant d'une 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 la notification de l'heure par application.
APPLICATION_LAUNCH_SOURCE_SHELF Application lancée depuis l'étagère.
APPLICATION_LAUNCH_SOURCE_FILE_MANAGER Application lancée à partir du 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 du raccourci clavier pour ouvrir l'application.
APPLICATION_LAUNCH_SOURCE_OTHER_APP Application lancée suite à un clic sur un lien dans une autre application ou interface Web.
APPLICATION_LAUNCH_SOURCE_MENU Application lancée à partir du 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 à partir de 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 à 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 un 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 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).
APPLICATION_LAUNCH_SOURCE_REPARENTING Application lancée après avoir déplacé du contenu dans une application.
APPLICATION_LAUNCH_SOURCE_PROFILE_MENU Application lancée à partir du 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 à partir du programme d'installation source.
APPLICATION_LAUNCH_SOURCE_FIRST_RUN Comptez les lancements de l'application d'aide à 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 lors de la visite de bienvenue.
APPLICATION_LAUNCH_SOURCE_FOCUS_MODE Application lancée depuis le panneau de sélection.
APPLICATION_LAUNCH_SOURCE_SPARKY Application lancée à partir de la fonctionnalité expérimentale Sparky.

Méthodes

list

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