diff --git a/docs/dyn/chromemanagement_v1.customers.telemetry.devices.html b/docs/dyn/chromemanagement_v1.customers.telemetry.devices.html index f364cad4502..75e41329940 100644 --- a/docs/dyn/chromemanagement_v1.customers.telemetry.devices.html +++ b/docs/dyn/chromemanagement_v1.customers.telemetry.devices.html @@ -98,7 +98,7 @@

Method Details

Args: name: string, Required. Name of the `TelemetryDevice` to return. (required) - readMask: string, Required. Read mask to specify which fields to return. + readMask: string, Required. Read mask to specify which fields to return. Supported read_mask paths are: - name - org_unit_id - device_id - serial_number - cpu_info - cpu_status_report - memory_info - memory_status_report - network_info - network_diagnostics_report - network_status_report - os_update_status - graphics_info - graphics_status_report - battery_info - battery_status_report - storage_info - storage_status_report - thunderbolt_info - audio_status_report - boot_performance_report - heartbeat_status_report - network_bandwidth_report - peripherals_report - kiosk_app_status_report - app_report - runtime_counters_report x__xgafv: string, V1 error format. Allowed values 1 - v1 error format @@ -339,6 +339,15 @@

Method Details

], }, ], + "runtimeCountersReport": [ # Output only. Runtime counters reports collected device lifetime runtime, as well as the counts of S0->S3, S0->S4, and S0->S5 transitions, meaning entering into sleep, hibernation, and power-off states + { # Runtime counters retrieved from CPU. Currently the runtime counters telemetry is only supported by Intel vPro PSR on Gen 14+. + "enterHibernationCount": "A String", # Number of times that the device has entered into the hibernation state. Currently obtained via the PSR, count from S0->S4. + "enterPoweroffCount": "A String", # Number of times that the device has entered into the power-off state. Currently obtained via the PSR, count from S0->S5. + "enterSleepCount": "A String", # Number of times that the device has entered into the sleep state. Currently obtained via the PSR, count from S0->S3. + "reportTime": "A String", # Timestamp when the report was collected. + "uptimeRuntimeDuration": "A String", # Total lifetime runtime. Currently always S0 runtime from Intel vPro PSR. + }, + ], "serialNumber": "A String", # Output only. Device serial number. This value is the same as the Admin Console's Serial Number in the ChromeOS Devices tab. "storageInfo": { # Status data for storage. * This field is telemetry information and this will change over time as the device is utilized. * Data for this field is controlled via policy: [ReportDeviceStorageStatus](https://chromeenterprise.google/policies/#ReportDeviceStorageStatus) * Data Collection Frequency: Only at Upload * Default Data Reporting Frequency: 3 hours - Policy Controlled: Yes * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: No * Reported for affiliated users only: N/A * Granular permission needed: TELEMETRY_API_STORAGE_INFO # Output only. Information of storage specs for the device. "availableDiskBytes": "A String", # The available space for user data storage in the device in bytes. @@ -392,7 +401,7 @@

Method Details

filter: string, Optional. Only include resources that match the filter. Supported filter fields: - org_unit_id - serial_number - device_id - reports_timestamp The "reports_timestamp" filter accepts either the Unix Epoch milliseconds format or the RFC3339 UTC "Zulu" format with nanosecond resolution and up to nine fractional digits. Both formats should be surrounded by simple double quotes. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", "1679283943823". pageSize: integer, Maximum number of results to return. Default value is 100. Maximum value is 1000. pageToken: string, Token to specify next page in the list. - readMask: string, Required. Read mask to specify which fields to return. + readMask: string, Required. Read mask to specify which fields to return. Supported read_mask paths are: - name - org_unit_id - device_id - serial_number - cpu_info - cpu_status_report - memory_info - memory_status_report - network_info - network_diagnostics_report - network_status_report - os_update_status - graphics_info - graphics_status_report - battery_info - battery_status_report - storage_info - storage_status_report - thunderbolt_info - audio_status_report - boot_performance_report - heartbeat_status_report - network_bandwidth_report - peripherals_report - kiosk_app_status_report - app_report - runtime_counters_report x__xgafv: string, V1 error format. Allowed values 1 - v1 error format @@ -635,6 +644,15 @@

Method Details

], }, ], + "runtimeCountersReport": [ # Output only. Runtime counters reports collected device lifetime runtime, as well as the counts of S0->S3, S0->S4, and S0->S5 transitions, meaning entering into sleep, hibernation, and power-off states + { # Runtime counters retrieved from CPU. Currently the runtime counters telemetry is only supported by Intel vPro PSR on Gen 14+. + "enterHibernationCount": "A String", # Number of times that the device has entered into the hibernation state. Currently obtained via the PSR, count from S0->S4. + "enterPoweroffCount": "A String", # Number of times that the device has entered into the power-off state. Currently obtained via the PSR, count from S0->S5. + "enterSleepCount": "A String", # Number of times that the device has entered into the sleep state. Currently obtained via the PSR, count from S0->S3. + "reportTime": "A String", # Timestamp when the report was collected. + "uptimeRuntimeDuration": "A String", # Total lifetime runtime. Currently always S0 runtime from Intel vPro PSR. + }, + ], "serialNumber": "A String", # Output only. Device serial number. This value is the same as the Admin Console's Serial Number in the ChromeOS Devices tab. "storageInfo": { # Status data for storage. * This field is telemetry information and this will change over time as the device is utilized. * Data for this field is controlled via policy: [ReportDeviceStorageStatus](https://chromeenterprise.google/policies/#ReportDeviceStorageStatus) * Data Collection Frequency: Only at Upload * Default Data Reporting Frequency: 3 hours - Policy Controlled: Yes * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: No * Reported for affiliated users only: N/A * Granular permission needed: TELEMETRY_API_STORAGE_INFO # Output only. Information of storage specs for the device. "availableDiskBytes": "A String", # The available space for user data storage in the device in bytes. diff --git a/docs/dyn/chromemanagement_v1.customers.telemetry.events.html b/docs/dyn/chromemanagement_v1.customers.telemetry.events.html index d6f0f0374ca..b4ee3cab968 100644 --- a/docs/dyn/chromemanagement_v1.customers.telemetry.events.html +++ b/docs/dyn/chromemanagement_v1.customers.telemetry.events.html @@ -98,7 +98,7 @@

Method Details

filter: string, Optional. Only include resources that match the filter. Although this parameter is currently optional, this parameter will be required- please specify at least 1 event type. Supported filter fields: - device_id - user_id - device_org_unit_id - user_org_unit_id - timestamp - event_type The "timestamp" filter accepts either the Unix Epoch milliseconds format or the RFC3339 UTC "Zulu" format with nanosecond resolution and up to nine fractional digits. Both formats should be surrounded by simple double quotes. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", "1679283943823". pageSize: integer, Optional. Maximum number of results to return. Default value is 100. Maximum value is 1000. pageToken: string, Optional. Token to specify next page in the list. - readMask: string, Required. Read mask to specify which fields to return. Although currently required, this field will become optional, while the filter parameter with an event type will be come required. + readMask: string, Required. Read mask to specify which fields to return. Although currently required, this field will become optional, while the filter parameter with an event type will be come required. Supported read_mask paths are: - device - user - audio_severe_underrun_event - usb_peripherals_event - https_latency_change_event - network_state_change_event - wifi_signal_strength_event - vpn_connection_state_change_event - app_install_event - app_uninstall_event - app_launch_event x__xgafv: string, V1 error format. Allowed values 1 - v1 error format diff --git a/docs/dyn/chromemanagement_v1.customers.telemetry.users.html b/docs/dyn/chromemanagement_v1.customers.telemetry.users.html index 91374f062d3..20d1cf0acf6 100644 --- a/docs/dyn/chromemanagement_v1.customers.telemetry.users.html +++ b/docs/dyn/chromemanagement_v1.customers.telemetry.users.html @@ -98,7 +98,7 @@

Method Details

Args: name: string, Required. Name of the `TelemetryUser` to return. (required) - readMask: string, Read mask to specify which fields to return. + readMask: string, Read mask to specify which fields to return. Supported read_mask paths are: - name - org_unit_id - user_id - user_email - user_device.device_id - user_device.audio_status_report - user_device.device_activity_report - user_device.network_bandwidth_report - user_device.peripherals_report x__xgafv: string, V1 error format. Allowed values 1 - v1 error format @@ -172,7 +172,7 @@

Method Details

filter: string, Only include resources that match the filter. Supported filter fields: - user_id - user_org_unit_id pageSize: integer, Maximum number of results to return. Default value is 100. Maximum value is 1000. pageToken: string, Token to specify next page in the list. - readMask: string, Read mask to specify which fields to return. + readMask: string, Read mask to specify which fields to return. Supported read_mask paths are: - name - org_unit_id - user_id - user_email - user_device.device_id - user_device.audio_status_report - user_device.device_activity_report - user_device.network_bandwidth_report - user_device.peripherals_report x__xgafv: string, V1 error format. Allowed values 1 - v1 error format diff --git a/googleapiclient/discovery_cache/documents/chromemanagement.v1.json b/googleapiclient/discovery_cache/documents/chromemanagement.v1.json index e359682a7f0..1ab7b8a8f95 100644 --- a/googleapiclient/discovery_cache/documents/chromemanagement.v1.json +++ b/googleapiclient/discovery_cache/documents/chromemanagement.v1.json @@ -746,7 +746,7 @@ "type": "string" }, "readMask": { -"description": "Required. Read mask to specify which fields to return.", +"description": "Required. Read mask to specify which fields to return. Supported read_mask paths are: - name - org_unit_id - device_id - serial_number - cpu_info - cpu_status_report - memory_info - memory_status_report - network_info - network_diagnostics_report - network_status_report - os_update_status - graphics_info - graphics_status_report - battery_info - battery_status_report - storage_info - storage_status_report - thunderbolt_info - audio_status_report - boot_performance_report - heartbeat_status_report - network_bandwidth_report - peripherals_report - kiosk_app_status_report - app_report - runtime_counters_report ", "format": "google-fieldmask", "location": "query", "type": "string" @@ -793,7 +793,7 @@ "type": "string" }, "readMask": { -"description": "Required. Read mask to specify which fields to return.", +"description": "Required. Read mask to specify which fields to return. Supported read_mask paths are: - name - org_unit_id - device_id - serial_number - cpu_info - cpu_status_report - memory_info - memory_status_report - network_info - network_diagnostics_report - network_status_report - os_update_status - graphics_info - graphics_status_report - battery_info - battery_status_report - storage_info - storage_status_report - thunderbolt_info - audio_status_report - boot_performance_report - heartbeat_status_report - network_bandwidth_report - peripherals_report - kiosk_app_status_report - app_report - runtime_counters_report ", "format": "google-fieldmask", "location": "query", "type": "string" @@ -844,7 +844,7 @@ "type": "string" }, "readMask": { -"description": "Required. Read mask to specify which fields to return. Although currently required, this field will become optional, while the filter parameter with an event type will be come required.", +"description": "Required. Read mask to specify which fields to return. Although currently required, this field will become optional, while the filter parameter with an event type will be come required. Supported read_mask paths are: - device - user - audio_severe_underrun_event - usb_peripherals_event - https_latency_change_event - network_state_change_event - wifi_signal_strength_event - vpn_connection_state_change_event - app_install_event - app_uninstall_event - app_launch_event ", "format": "google-fieldmask", "location": "query", "type": "string" @@ -972,7 +972,7 @@ "type": "string" }, "readMask": { -"description": "Read mask to specify which fields to return.", +"description": "Read mask to specify which fields to return. Supported read_mask paths are: - name - org_unit_id - user_id - user_email - user_device.device_id - user_device.audio_status_report - user_device.device_activity_report - user_device.network_bandwidth_report - user_device.peripherals_report ", "format": "google-fieldmask", "location": "query", "type": "string" @@ -1019,7 +1019,7 @@ "type": "string" }, "readMask": { -"description": "Read mask to specify which fields to return.", +"description": "Read mask to specify which fields to return. Supported read_mask paths are: - name - org_unit_id - user_id - user_email - user_device.device_id - user_device.audio_status_report - user_device.device_activity_report - user_device.network_bandwidth_report - user_device.peripherals_report ", "format": "google-fieldmask", "location": "query", "type": "string" @@ -1040,7 +1040,7 @@ } } }, -"revision": "20240225", +"revision": "20240303", "rootUrl": "https://chromemanagement.googleapis.com/", "schemas": { "GoogleChromeManagementV1AndroidAppInfo": { @@ -3113,6 +3113,38 @@ }, "type": "object" }, +"GoogleChromeManagementV1RuntimeCountersReport": { +"description": "Runtime counters retrieved from CPU. Currently the runtime counters telemetry is only supported by Intel vPro PSR on Gen 14+.", +"id": "GoogleChromeManagementV1RuntimeCountersReport", +"properties": { +"enterHibernationCount": { +"description": "Number of times that the device has entered into the hibernation state. Currently obtained via the PSR, count from S0->S4.", +"format": "int64", +"type": "string" +}, +"enterPoweroffCount": { +"description": "Number of times that the device has entered into the power-off state. Currently obtained via the PSR, count from S0->S5.", +"format": "int64", +"type": "string" +}, +"enterSleepCount": { +"description": "Number of times that the device has entered into the sleep state. Currently obtained via the PSR, count from S0->S3.", +"format": "int64", +"type": "string" +}, +"reportTime": { +"description": "Timestamp when the report was collected.", +"format": "google-datetime", +"type": "string" +}, +"uptimeRuntimeDuration": { +"description": "Total lifetime runtime. Currently always S0 runtime from Intel vPro PSR.", +"format": "google-duration", +"type": "string" +} +}, +"type": "object" +}, "GoogleChromeManagementV1StorageInfo": { "description": "Status data for storage. * This field is telemetry information and this will change over time as the device is utilized. * Data for this field is controlled via policy: [ReportDeviceStorageStatus](https://chromeenterprise.google/policies/#ReportDeviceStorageStatus) * Data Collection Frequency: Only at Upload * Default Data Reporting Frequency: 3 hours - Policy Controlled: Yes * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: No * Reported for affiliated users only: N/A * Granular permission needed: TELEMETRY_API_STORAGE_INFO", "id": "GoogleChromeManagementV1StorageInfo", @@ -3344,6 +3376,14 @@ "readOnly": true, "type": "array" }, +"runtimeCountersReport": { +"description": "Output only. Runtime counters reports collected device lifetime runtime, as well as the counts of S0->S3, S0->S4, and S0->S5 transitions, meaning entering into sleep, hibernation, and power-off states", +"items": { +"$ref": "GoogleChromeManagementV1RuntimeCountersReport" +}, +"readOnly": true, +"type": "array" +}, "serialNumber": { "description": "Output only. Device serial number. This value is the same as the Admin Console's Serial Number in the ChromeOS Devices tab.", "readOnly": true,