Method: customers.telemetry.events.list

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

Requête HTTP

GET https://chromemanagement.googleapis.com/v1/{parent=customers/*}/telemetry/events

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
parent

string

Obligatoire. Numéro client ou "my_customer" pour utiliser le client associé au compte à l'origine de la requête.

Paramètres de requête

Paramètres
filter

string

Facultatif. Incluez uniquement les ressources qui correspondent au filtre. Bien que ce paramètre soit actuellement facultatif, il deviendra obligatoire. Veuillez spécifier au moins un type d'événement.

Champs de filtre acceptés :

  • deviceId
  • userId
  • deviceOrgUnitId
  • userOrgUnitId
  • timestamp
  • eventType
 Le filtre "timestamp" accepte le format Unix Epoch en millisecondes ou le format RFC3339 UTC "Zulu" avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Les deux formats doivent être entourés de guillemets doubles simples. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", "1679283943823".

readMask

string (FieldMask format)

Obligatoire. Masque de lecture permettant de spécifier les champs à renvoyer. Bien que ce champ soit actuellement obligatoire, il deviendra facultatif, tandis que le paramètre de filtre avec un type d'événement deviendra obligatoire.

Voici les chemins readMask acceptés :

  • appareil
  • utilisateur
  • audioSevereUnderrunEvent
  • usbPeripheralsEvent
  • httpsLatencyChangeEvent
  • networkStateChangeEvent
  • wifiSignalStrengthEvent
  • vpnConnectionStateChangeEvent
  • appInstallEvent
  • appUninstallEvent
  • appLaunchEvent
  • osCrashEvent
  • externalDisplaysEvent

Il s'agit d'une liste de noms de champs complets séparés par une virgule. Exemple : "user.displayName,photo".

pageSize

integer

Facultatif. Nombre maximal de résultats à renvoyer. La valeur par défaut est 100. La valeur maximale est de 1 000.

pageToken

string

Facultatif. Jeton permettant de spécifier la page suivante de la liste.

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Message de réponse pour la liste des événements de télémétrie d'un client.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON
{
  "telemetryEvents": [
    {
      object (TelemetryEvent)
    }
  ],
  "nextPageToken": string
}
Champs
telemetryEvents[]

object (TelemetryEvent)

Événements de télémétrie renvoyés dans la réponse.

nextPageToken

string

Jeton permettant de spécifier la page suivante de la liste.

Champs d'application des autorisations

Requiert le champ d'application OAuth suivant :

  • https://www.googleapis.com/auth/chrome.management.telemetry.readonly