REST Resource: customers.telemetry.users

Ressource: TelemetryUser

Telemetriedaten, die von einem verwalteten Nutzer erhoben wurden.

  • Detaillierte Berechtigung erforderlich: TELEMETRY_API_USER
JSON-Darstellung
{
  "name": string,
  "customer": string,
  "orgUnitId": string,
  "userId": string,
  "userEmail": string,
  "userDevice": [
    {
      object (TelemetryUserDevice)
    }
  ]
}
Felder
name

string

Ressourcenname des Nutzers.

customer

string

G Suite-Kunde, dessen Unternehmen das Gerät registriert hat.

orgUnitId

string

Organisationseinheit des Nutzers.

userId

string

Verzeichnis-ID des Nutzers.

userEmail

string

E-Mail-Adresse des Nutzers

userDevice[]

object (TelemetryUserDevice)

Telemetriedaten, die von einem verwalteten Nutzer und Gerät erhoben wurden.

TelemetryUserDevice

Telemetriedaten, die für einen verwalteten Nutzer und ein verwaltetes Gerät erhoben wurden.

  • Detaillierte Berechtigung erforderlich: TELEMETRY_API_DEVICE
JSON-Darstellung
{
  "deviceId": string,
  "audioStatusReport": [
    {
      object (AudioStatusReport)
    }
  ],
  "deviceActivityReport": [
    {
      object (DeviceActivityReport)
    }
  ],
  "networkBandwidthReport": [
    {
      object (NetworkBandwidthReport)
    }
  ],
  "peripheralsReport": [
    {
      object (PeripheralsReport)
    }
  ],
  "appReport": [
    {
      object (AppReport)
    }
  ]
}
Felder
deviceId

string

Die eindeutige Directory API-ID des Geräts. Dieser Wert entspricht der Directory API-ID der Admin-Konsole auf dem Tab „ChromeOS-Geräte“.

audioStatusReport[]

object (AudioStatusReport)

Nur Ausgabe. Regelmäßig erhobene Audioberichte, sortiert in absteigender Reihenfolge nach reportTime.

deviceActivityReport[]

object (DeviceActivityReport)

Nur Ausgabe. Regelmäßig erfasste Berichte zur Geräteaktivität, sortiert in absteigender Reihenfolge nach reportTime.

networkBandwidthReport[]

object (NetworkBandwidthReport)

Nur Ausgabe. Berichte zur Netzwerkbandbreite, die regelmäßig erhoben und in absteigender Reihenfolge nach reportTime sortiert werden.

peripheralsReport[]

object (PeripheralsReport)

Nur Ausgabe. Berichte zu Peripheriegeräten, die regelmäßig erhoben werden, in absteigender Reihenfolge nach reportTime sortiert.

appReport[]

object (AppReport)

Nur Ausgabe. Regelmäßig erhobene App-Berichte, sortiert in absteigender Reihenfolge nach reportTime.

DeviceActivityReport

Bericht zur Geräteaktivität

  • Erforderliche detaillierte Berechtigung: TELEMETRY_API_DEVICE_ACTIVITY_REPORT
JSON-Darstellung
{
  "reportTime": string,
  "deviceActivityState": enum (DeviceActivityState)
}
Felder
reportTime

string (Timestamp format)

Nur Ausgabe. Zeitstempel, der angibt, wann die Daten erfasst wurden.

Es wird RFC 3339 verwendet, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Glieder mit Dezimalstellen enthält. Andere Achsenbezeichnungen als „Z“ sind ebenfalls zulässig. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

deviceActivityState

enum (DeviceActivityState)

Nur Ausgabe. Status der Geräteaktivität.

DeviceActivityState

Aktivitätsstatus des Geräts.

Enums
DEVICE_ACTIVITY_STATE_UNSPECIFIED Der Status der Geräteaktivität ist nicht angegeben.
ACTIVE Das Gerät wird derzeit verwendet.
IDLE Das Gerät ist derzeit inaktiv.
LOCKED Das Gerät ist derzeit gesperrt.

Methoden

get

Telemetrienutzer abrufen

list

Listet alle Nutzer der Telemetrie auf.