Method: customers.telemetry.events.list

Список событий телеметрии.

HTTP-запрос

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

В URL-адресе используется синтаксис транскодирования gRPC .

Параметры пути

Параметры
parent

string

Обязательно. Идентификатор клиента или "my_customer", чтобы использовать клиента, связанного с учетной записью, отправляющей запрос.

Параметры запроса

Параметры
filter

string

Необязательный параметр. Включайте только ресурсы, соответствующие фильтру. Хотя в настоящее время этот параметр необязателен, в будущем он станет обязательным — пожалуйста, укажите как минимум один тип события.

Поддерживаемые поля фильтра:

  • идентификатор устройства
  • ID пользователя
  • deviceOrgUnitId
  • userOrgUnitId
  • метка времени
  • eventType
Фильтр "timestamp" принимает либо формат миллисекунд Unix Epoch, либо формат RFC3339 UTC "Zulu" с разрешением в наносекунды и до девяти дробных знаков. Оба формата должны быть заключены в простые двойные кавычки. Примеры: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", "1679283943823".

readMask

string ( FieldMask format)

Обязательно. Используйте маску чтения, чтобы указать, какие поля следует вернуть. Хотя в настоящее время это поле является обязательным, оно станет необязательным, а параметр фильтра с типом события станет обязательным.

Поддерживаемые пути для чтения маски:

  • устройство
  • пользователь
  • audioSevereUnderrunEvent
  • usbPeripheralsEvent
  • httpsLatencyChangeEvent
  • networkStateChangeEvent
  • wifiSignalStrengthEvent
  • vpnConnectionStateChangeEvent
  • appInstalLevent
  • appUninstallEvent
  • appLaunchEvent
  • osCrashEvent
  • externalDisplaysEvent

Это список полных имен полей, разделенных запятыми. Пример: "user.displayName,photo" .

pageSize

integer

Необязательный параметр. Максимальное количество возвращаемых результатов. Значение по умолчанию — 100. Максимальное значение — 1000.

pageToken

string

Необязательный параметр. Токен для указания следующей страницы в списке.

Текст запроса

Тело запроса должно быть пустым.

Ответный текст

Ответное сообщение для отображения телеметрических событий для клиента.

В случае успеха тело ответа будет содержать данные следующей структуры:

JSON-представление
{
  "telemetryEvents": [
    {
      object (TelemetryEvent)
    }
  ],
  "nextPageToken": string
}
Поля
telemetryEvents[]

object ( TelemetryEvent )

В ответе были получены телеметрические данные.

nextPageToken

string

Токен для указания следующей страницы в списке.

Области полномочий

Требуется следующая область действия OAuth:

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

Список событий телеметрии.

HTTP-запрос

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

В URL-адресе используется синтаксис транскодирования gRPC .

Параметры пути

Параметры
parent

string

Обязательно. Идентификатор клиента или "my_customer", чтобы использовать клиента, связанного с учетной записью, отправляющей запрос.

Параметры запроса

Параметры
filter

string

Необязательный параметр. Включайте только ресурсы, соответствующие фильтру. Хотя в настоящее время этот параметр необязателен, в будущем он станет обязательным — пожалуйста, укажите как минимум один тип события.

Поддерживаемые поля фильтра:

  • идентификатор устройства
  • ID пользователя
  • deviceOrgUnitId
  • userOrgUnitId
  • метка времени
  • eventType
Фильтр "timestamp" принимает либо формат миллисекунд Unix Epoch, либо формат RFC3339 UTC "Zulu" с разрешением в наносекунды и до девяти дробных знаков. Оба формата должны быть заключены в простые двойные кавычки. Примеры: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", "1679283943823".

readMask

string ( FieldMask format)

Обязательно. Используйте маску чтения, чтобы указать, какие поля следует вернуть. Хотя в настоящее время это поле является обязательным, оно станет необязательным, а параметр фильтра с типом события станет обязательным.

Поддерживаемые пути для чтения маски:

  • устройство
  • пользователь
  • audioSevereUnderrunEvent
  • usbPeripheralsEvent
  • httpsLatencyChangeEvent
  • networkStateChangeEvent
  • wifiSignalStrengthEvent
  • vpnConnectionStateChangeEvent
  • appInstalLevent
  • appUninstallEvent
  • appLaunchEvent
  • osCrashEvent
  • externalDisplaysEvent

Это список полных имен полей, разделенных запятыми. Пример: "user.displayName,photo" .

pageSize

integer

Необязательный параметр. Максимальное количество возвращаемых результатов. Значение по умолчанию — 100. Максимальное значение — 1000.

pageToken

string

Необязательный параметр. Токен для указания следующей страницы в списке.

Текст запроса

Тело запроса должно быть пустым.

Ответный текст

Ответное сообщение для отображения телеметрических событий для клиента.

В случае успеха тело ответа будет содержать данные следующей структуры:

JSON-представление
{
  "telemetryEvents": [
    {
      object (TelemetryEvent)
    }
  ],
  "nextPageToken": string
}
Поля
telemetryEvents[]

object ( TelemetryEvent )

В ответе были получены телеметрические данные.

nextPageToken

string

Токен для указания следующей страницы в списке.

Области полномочий

Требуется следующая область действия OAuth:

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