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. N'incluez que les ressources correspondant 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 compatibles:

  • deviceId
  • userId
  • deviceOrgUnitId
  • userOrgUnitId
  • timestamp
  • eventType
Le filtre "code temporel" accepte le format en millisecondes de l'époque Unix ou le format UTC "Zulu" RFC3339, 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 qu'il soit actuellement obligatoire, ce champ deviendra facultatif, tandis que le paramètre de filtre avec un type d'événement le deviendra obligatoire.

Les chemins d'accès readMask compatibles sont les suivants:

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

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 sur une page. La valeur par défaut est 100. La valeur maximale est 1 000.

pageToken

string

Facultatif. Jeton permettant de spécifier la page suivante dans 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 niveau d'accès OAuth suivant :

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