Method: customers.telemetry.events.list

Répertorier 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. Identifiant client ou "my_customer" pour utiliser le client associé au compte à l'origine de la demande.

Paramètres de requête

Paramètres
filter

string

Facultatif. Incluez uniquement les ressources correspondant au filtre. Bien qu'il soit actuellement facultatif, il est obligatoire. Veuillez spécifier au moins un type d'événement.

Champs de filtre compatibles:

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

string (FieldMask format)

Obligatoire. Lire le masque pour 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 le sera prochainement.

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

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

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 de 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 concernant la liste des événements de télémétrie pour 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 dans la liste.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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