1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
|
<html><body>
<style>
body, h1, h2, h3, div, span, p, pre, a {
margin: 0;
padding: 0;
border: 0;
font-weight: inherit;
font-style: inherit;
font-size: 100%;
font-family: inherit;
vertical-align: baseline;
}
body {
font-size: 13px;
padding: 1em;
}
h1 {
font-size: 26px;
margin-bottom: 1em;
}
h2 {
font-size: 24px;
margin-bottom: 1em;
}
h3 {
font-size: 20px;
margin-bottom: 1em;
margin-top: 1em;
}
pre, code {
line-height: 1.5;
font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
}
pre {
margin-top: 0.5em;
}
h1, h2, h3, p {
font-family: Arial, sans serif;
}
h1, h2, h3 {
border-bottom: solid #CCC 1px;
}
.toc_element {
margin-top: 0.5em;
}
.firstline {
margin-left: 2 em;
}
.method {
margin-top: 1em;
border: solid 1px #CCC;
padding: 1em;
background: #EEE;
}
.details {
font-weight: bold;
font-size: 14px;
}
</style>
<h1><a href="chromemanagement_v1.html">Chrome Management API</a> . <a href="chromemanagement_v1.customers.html">customers</a> . <a href="chromemanagement_v1.customers.telemetry.html">telemetry</a> . <a href="chromemanagement_v1.customers.telemetry.devices.html">devices</a></h1>
<h2>Instance Methods</h2>
<p class="toc_element">
<code><a href="#close">close()</a></code></p>
<p class="firstline">Close httplib2 connections.</p>
<p class="toc_element">
<code><a href="#get">get(name, readMask=None, x__xgafv=None)</a></code></p>
<p class="firstline">Get telemetry device.</p>
<p class="toc_element">
<code><a href="#list">list(parent, filter=None, pageSize=None, pageToken=None, readMask=None, x__xgafv=None)</a></code></p>
<p class="firstline">List all telemetry devices.</p>
<p class="toc_element">
<code><a href="#list_next">list_next()</a></code></p>
<p class="firstline">Retrieves the next page of results.</p>
<h3>Method Details</h3>
<div class="method">
<code class="details" id="close">close()</code>
<pre>Close httplib2 connections.</pre>
</div>
<div class="method">
<code class="details" id="get">get(name, readMask=None, x__xgafv=None)</code>
<pre>Get telemetry device.
Args:
name: string, Required. Name of the `TelemetryDevice` to return. (required)
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
2 - v2 error format
Returns:
An object of the form:
{ # Telemetry data collected from a managed device. * Granular permission needed: TELEMETRY_API_DEVICE
"appReport": [ # Output only. App reports collected periodically sorted in a decreasing order of report_time.
{ # App report.
"reportTime": "A String", # Timestamp when the report was collected.
"usageData": [ # App usage data.
{ # App usage data.
"appId": "A String", # App id.
"appInstanceId": "A String", # Application instance id. This will be unique per window/instance.
"appType": "A String", # Type of app.
"runningDuration": "A String", # App foreground running time.
},
],
},
],
"audioStatusReport": [ # Output only. Audio reports collected periodically sorted in a decreasing order of report_time.
{ # 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: [ReportDeviceAudioStatus](https://chromeenterprise.google/policies/#ReportDeviceAudioStatus) * Data Collection Frequency: 10 minutes * 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_AUDIO_REPORT
"inputDevice": "A String", # Output only. Active input device's name.
"inputGain": 42, # Output only. Active input device's gain in [0, 100].
"inputMute": True or False, # Output only. Is active input device mute or not.
"outputDevice": "A String", # Output only. Active output device's name.
"outputMute": True or False, # Output only. Is active output device mute or not.
"outputVolume": 42, # Output only. Active output device's volume in [0, 100].
"reportTime": "A String", # Output only. Timestamp of when the sample was collected on device.
},
],
"batteryInfo": [ # Output only. Information on battery specs for the device.
{ # Information about the battery. * This field provides device information, which is static and will not change over time. * Data for this field is controlled via policy: [ReportDevicePowerStatus](https://chromeenterprise.google/policies/#ReportDevicePowerStatus) * 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_BATTERY_INFO
"designCapacity": "A String", # Output only. Design capacity (mAmpere-hours).
"designMinVoltage": 42, # Output only. Designed minimum output voltage (mV)
"manufactureDate": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Output only. The date the battery was manufactured.
"day": 42, # Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.
"month": 42, # Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
"year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
},
"manufacturer": "A String", # Output only. Battery manufacturer.
"serialNumber": "A String", # Output only. Battery serial number.
"technology": "A String", # Output only. Technology of the battery. Example: Li-ion
},
],
"batteryStatusReport": [ # Output only. Battery reports collected periodically.
{ # Status data for battery. * This field is telemetry information and this will change over time as the device is utilized. * Data for this field is controlled via policy: [ReportDevicePowerStatus](https://chromeenterprise.google/policies/#ReportDevicePowerStatus) * 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_BATTERY_REPORT
"batteryHealth": "A String", # Output only. Battery health.
"cycleCount": 42, # Output only. Cycle count.
"fullChargeCapacity": "A String", # Output only. Full charge capacity (mAmpere-hours).
"reportTime": "A String", # Output only. Timestamp of when the sample was collected on device
"sample": [ # Output only. Sampling data for the battery sorted in a decreasing order of report_time.
{ # Sampling data for battery. * This field is telemetry information and this will change over time as the device is utilized. * Data for this field is controlled via policy: [ReportDevicePowerStatus](https://chromeenterprise.google/policies/#ReportDevicePowerStatus) * 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
"chargeRate": 42, # Output only. Battery charge percentage.
"current": "A String", # Output only. Battery current (mA).
"dischargeRate": 42, # Output only. The battery discharge rate measured in mW. Positive if the battery is being discharged, negative if it's being charged.
"remainingCapacity": "A String", # Output only. Battery remaining capacity (mAmpere-hours).
"reportTime": "A String", # Output only. Timestamp of when the sample was collected on device
"status": "A String", # Output only. Battery status read from sysfs. Example: Discharging
"temperature": 42, # Output only. Temperature in Celsius degrees.
"voltage": "A String", # Output only. Battery voltage (millivolt).
},
],
"serialNumber": "A String", # Output only. Battery serial number.
},
],
"bootPerformanceReport": [ # Output only. Boot performance reports of the device.
{ # Boot performance report of a device. * This field is telemetry information and this will change over time as the device is utilized. * Data for this field is controlled via policy: [ReportDeviceBootMode](https://chromeenterprise.google/policies/#ReportDeviceBootMode) * Data Collection Frequency: On every boot up event * 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: Yes * Reported for affiliated users only: N/A * Granular permission needed: TELEMETRY_API_OS_REPORT
"bootUpDuration": "A String", # Total time to boot up.
"bootUpTime": "A String", # The timestamp when power came on.
"reportTime": "A String", # Timestamp when the report was collected.
"shutdownDuration": "A String", # Total time since shutdown start to power off.
"shutdownReason": "A String", # The shutdown reason.
"shutdownTime": "A String", # The timestamp when shutdown.
},
],
"cpuInfo": [ # Output only. Information regarding CPU specs for the device.
{ # CPU specifications for the device * This field provides device information, which is static and will not change over time. * Data for this field is controlled via policy: [ReportDeviceCpuInfo](https://chromeenterprise.google/policies/#ReportDeviceCpuInfo) * 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_CPU_INFO
"architecture": "A String", # Output only. Architecture type for the CPU. * This field provides device information, which is static and will not change over time. * Data for this field is controlled via policy: [ReportDeviceCpuInfo](https://chromeenterprise.google/policies/#ReportDeviceCpuInfo) * 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
"keylockerConfigured": True or False, # Output only. Whether keylocker is configured.`TRUE` = Enabled; `FALSE` = disabled. Only reported if keylockerSupported = `TRUE`.
"keylockerSupported": True or False, # Output only. Whether keylocker is supported.
"maxClockSpeed": 42, # Output only. The max CPU clock speed in kHz.
"model": "A String", # Output only. The CPU model name. Example: Intel(R) Core(TM) i5-8250U CPU @ 1.60GHz
},
],
"cpuStatusReport": [ # Output only. CPU status reports collected periodically sorted in a decreasing order of report_time.
{ # Provides information about the status of the CPU. * This field is telemetry information and this will change over time as the device is utilized. * Data for this field is controlled via policy: [ReportDeviceCpuInfo](https://chromeenterprise.google/policies/#ReportDeviceCpuInfo) * Data Collection Frequency: Every 10 minutes * 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_CPU_REPORT
"cpuTemperatureInfo": [ # Output only. CPU temperature sample info per CPU core in Celsius
{ # CPU temperature of a device. Sampled per CPU core in Celsius. * This field is telemetry information and this will change over time as the device is utilized. * Data for this field is controlled via policy: [ReportDeviceCpuInfo](https://chromeenterprise.google/policies/#ReportDeviceCpuInfo) * Data Collection Frequency: Every 10 minutes * 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
"label": "A String", # Output only. CPU label. Example: Core 0
"temperatureCelsius": 42, # Output only. CPU temperature in Celsius.
},
],
"cpuUtilizationPct": 42, # Output only. Sample of CPU utilization (0-100 percent).
"reportTime": "A String", # Output only. The timestamp in milliseconds representing time at which this report was sampled.
"sampleFrequency": "A String", # Output only. Frequency the report is sampled.
},
],
"customer": "A String", # Output only. Google Workspace Customer whose enterprise enrolled the device.
"deviceId": "A String", # Output only. The unique Directory API ID of the device. This value is the same as the Admin Console's Directory API ID in the ChromeOS Devices tab
"graphicsInfo": { # Information of the graphics subsystem. * This field provides device information, which is static and will not change over time. * Data for this field is controlled via policy: [ReportDeviceGraphicsStatus](https://chromeenterprise.google/policies/#ReportDeviceGraphicsStatus) * 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_GRAPHICS_INFO # Output only. Contains information regarding Graphic peripherals for the device.
"adapterInfo": { # Information of a graphics adapter (GPU). # Output only. Information about the graphics adapter (GPU).
"adapter": "A String", # Output only. Adapter name. Example: Mesa DRI Intel(R) UHD Graphics 620 (Kabylake GT2).
"deviceId": "A String", # Output only. Represents the graphics card device id.
"driverVersion": "A String", # Output only. Version of the GPU driver.
},
"displayDevices": [ # Output only. Information about the display(s) of the device.
{ # Information of a display device.
"displayHeightMm": 42, # Output only. Display height in millimeters.
"displayName": "A String", # Output only. Display device name.
"displayWidthMm": 42, # Output only. Display width in millimeters.
"edidVersion": "A String", # Output only. EDID version.
"internal": True or False, # Output only. Is display internal or not.
"manufactureYear": 42, # Output only. Year of manufacture.
"manufacturerId": "A String", # Output only. Three letter manufacturer ID.
"modelId": 42, # Output only. Manufacturer product code.
"serialNumber": 42, # Output only. Serial number.
},
],
"eprivacySupported": True or False, # Output only. Is ePrivacy screen supported or not.
"touchScreenInfo": { # Information on the device touch screen. # Output only. Information about the internal touch screen(s) of the device.
"devices": [ # Output only. List of the internal touch screen devices.
{ # Information of an internal touch screen device.
"displayName": "A String", # Output only. Touch screen device display name.
"stylusCapable": True or False, # Output only. Touch screen device is stylus capable or not.
"touchPointCount": 42, # Output only. Number of touch points supported on the device.
},
],
"touchpadLibrary": "A String", # Output only. Touchpad library name used by the input stack.
},
},
"graphicsStatusReport": [ # Output only. Graphics reports collected periodically.
{ # Information of the graphics subsystem. * This field is telemetry information and this will change over time as the device is utilized. * Data for this field is controlled via policy: [ReportDeviceGraphicsInfo](https://chromeenterprise.google/policies/#ReportDeviceGraphicsInfo) * Data Collection Frequency: 3 hours. * 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_GRAPHICS_REPORT
"displays": [ # Output only. Information about the displays for the device.
{ # Information for a display.
"deviceId": "A String", # Output only. Represents the graphics card device id.
"displayName": "A String", # Output only. Display device name.
"edidVersion": "A String", # Output only. EDID version.
"isInternal": True or False, # Output only. Indicates if display is internal or not.
"refreshRate": 42, # Output only. Refresh rate in Hz.
"resolutionHeight": 42, # Output only. Resolution height in pixels.
"resolutionWidth": 42, # Output only. Resolution width in pixels.
"serialNumber": 42, # Output only. Serial number.
},
],
"reportTime": "A String", # Output only. Time at which the graphics data was reported.
},
],
"heartbeatStatusReport": [ # Output only. Heartbeat status report containing timestamps periodically sorted in decreasing order of report_time
{ # Heartbeat status report of a device. * Available for Kiosks * This field provides online/offline/unknown status of a device and will only be included if the status has changed (e.g. Online -> Offline) * Data for this field is controlled via policy: [HeartbeatEnabled](https://chromeenterprise.google/policies/#HeartbeatEnabled) [More Info](https://support.google.com/chrome/a/answer/6179663#:~:text=On%20the%20Chrome,device%20status%20alerts) * Heartbeat Frequency: 2 mins * Note: If a device goes offline, it can take up to 12 minutes for the online status of the device to be updated * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: N/A * Reported for affiliated users only: N/A * Granular permission needed: TELEMETRY_API_DEVICE_ACTIVITY_REPORT
"reportTime": "A String", # Timestamp of when status changed was detected
"state": "A String", # State the device changed to
},
],
"kioskAppStatusReport": [ # Output only. Kiosk app status report for the kiosk device
{ # Kiosk app status report of a device. * Available for Kiosks * This field provides the app id and version number running on a kiosk device and the timestamp of when the report was last updated * Data for this field is controlled via policy: [ReportDeviceSessionStatus](https://chromeenterprise.google/policies/#ReportDeviceSessionStatus) * 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_APPS_REPORT
"appId": "A String", # App id of kiosk app for example "mdmkkicfmmkgmpkmkdikhlbggogpicma"
"appVersion": "A String", # App version number of kiosk app for example "1.10.118"
"reportTime": "A String", # Timestamp of when report was collected
},
],
"memoryInfo": { # Memory information of a device. * This field has both telemetry and device information: - `totalRamBytes` - Device information - `availableRamBytes` - Telemetry information - `totalMemoryEncryption` - Device information * Data for this field is controlled via policy: [ReportDeviceMemoryInfo](https://chromeenterprise.google/policies/#ReportDeviceMemoryInfo) * Data Collection Frequency: - `totalRamBytes` - Only at upload - `availableRamBytes` - Every 10 minutes - `totalMemoryEncryption` - at device startup * Default Data Reporting Frequency: - `totalRamBytes` - 3 hours - `availableRamBytes` - 3 hours - `totalMemoryEncryption` - at device startup - 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: only for `totalMemoryEncryption` * Reported for affiliated users only: N/A * Granular permission needed: TELEMETRY_API_MEMORY_INFO # Output only. Information regarding memory specs for the device.
"availableRamBytes": "A String", # Output only. Amount of available RAM in bytes.
"totalMemoryEncryption": { # Memory encryption information of a device. * This field provides device information, which is static and will not change over time. * Data for this field is controlled via policy: [ReportDeviceMemoryInfo](https://chromeenterprise.google/policies/#ReportDeviceMemoryInfo) * Data Collection Frequency: At device startup * Default Data Reporting Frequency: At device startup - 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: Yes * Reported for affiliated users only: N/A # Output only. Total memory encryption info for the device.
"encryptionAlgorithm": "A String", # Memory encryption algorithm.
"encryptionState": "A String", # The state of memory encryption on the device.
"keyLength": "A String", # The length of the encryption keys.
"maxKeys": "A String", # The maximum number of keys that can be used for encryption.
},
"totalRamBytes": "A String", # Output only. Total RAM in bytes.
},
"memoryStatusReport": [ # Output only. Memory status reports collected periodically sorted decreasing by report_time.
{ # Contains samples of memory status reports. * This field is telemetry information and this will change over time as the device is utilized. * Data for this field is controlled via policy: [ReportDeviceMemoryInfo](https://chromeenterprise.google/policies/#ReportDeviceMemoryInfo) * Data Collection Frequency: Only at upload, SystemRamFreeByes is collected every 10 minutes * Default Data Reporting Frequency: Every 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_MEMORY_REPORT
"pageFaults": 42, # Output only. Number of page faults during this collection
"reportTime": "A String", # Output only. The timestamp in milliseconds representing time at which this report was sampled.
"sampleFrequency": "A String", # Output only. Frequency the report is sampled.
"systemRamFreeBytes": "A String", # Output only. Amount of free RAM in bytes (unreliable due to Garbage Collection).
},
],
"name": "A String", # Output only. Resource name of the device.
"networkBandwidthReport": [ # Output only. Network bandwidth reports collected periodically sorted in a decreasing order of report_time.
{ # Network bandwidth report. * Granular permission needed: TELEMETRY_API_NETWORK_REPORT
"downloadSpeedKbps": "A String", # Output only. Download speed in kilobits per second.
"reportTime": "A String", # Output only. Timestamp of when the report was collected.
},
],
"networkDiagnosticsReport": [ # Output only. Network diagnostics collected periodically.
{ # Network testing results to determine the health of the device's network connection, for example whether the HTTPS latency is high or normal. * Granular permission needed: TELEMETRY_API_NETWORK_REPORT
"httpsLatencyData": { # Data that describes the result of the HTTPS latency diagnostics routine, with the HTTPS requests issued to Google websites. # Output only. HTTPS latency test data.
"latency": "A String", # Output only. HTTPS latency if routine succeeded or failed because of HIGH_LATENCY or VERY_HIGH_LATENCY.
"problem": "A String", # Output only. HTTPS latency routine problem if a problem occurred.
},
"reportTime": "A String", # Output only. Timestamp of when the diagnostics were collected.
},
],
"networkInfo": { # Network device information. * This field provides device information, which is static and will not change over time. * Data for this field is controlled via policy: [ReportNetworkDeviceConfiguration](https://chromeenterprise.google/policies/#ReportNetworkDeviceConfiguration) * Data Collection Frequency: At device startup * Default Data Reporting Frequency: At device startup - 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: Yes * Reported for affiliated users only: N/A * Granular permission needed: TELEMETRY_API_NETWORK_INFO # Output only. Network devices information.
"networkDevices": [ # Output only. List of network devices.
{ # Details about the network device. * This field provides device information, which is static and will not change over time. * Data for this field is controlled via policy: [ReportNetworkDeviceConfiguration](https://chromeenterprise.google/policies/#ReportNetworkDeviceConfiguration) * Data Collection Frequency: At device startup * Default Data Reporting Frequency: At device startup - 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: Yes * Reported for affiliated users only: N/A
"iccid": "A String", # Output only. The integrated circuit card ID associated with the device's sim card.
"imei": "A String", # Output only. IMEI (if applicable) of the corresponding network device.
"macAddress": "A String", # Output only. MAC address (if applicable) of the corresponding network device.
"mdn": "A String", # Output only. The mobile directory number associated with the device's sim card.
"meid": "A String", # Output only. MEID (if applicable) of the corresponding network device.
"type": "A String", # Output only. Network device type.
},
],
},
"networkStatusReport": [ # Output only. Network specs collected periodically.
{ # State of visible/configured networks. * This field is telemetry information and this will change over time as the device is utilized. * Data for this field is controlled via policy: [ReportNetworkStatus](https://chromeenterprise.google/policies/#ReportNetworkStatus) * Data Collection Frequency: 60 minutes * 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: Yes * Reported for affiliated users only: Yes * Granular permission needed: TELEMETRY_API_NETWORK_REPORT
"connectionState": "A String", # Output only. Current connection state of the network.
"connectionType": "A String", # Output only. Network connection type.
"encryptionOn": True or False, # Output only. Whether the wifi encryption key is turned off.
"gatewayIpAddress": "A String", # Output only. Gateway IP address.
"guid": "A String", # Output only. Network connection guid.
"lanIpAddress": "A String", # Output only. LAN IP address.
"receivingBitRateMbps": "A String", # Output only. Receiving bit rate measured in Megabits per second.
"reportTime": "A String", # Output only. Time at which the network state was reported.
"sampleFrequency": "A String", # Output only. Frequency the report is sampled.
"signalStrengthDbm": 42, # Output only. Signal strength for wireless networks measured in decibels.
"transmissionBitRateMbps": "A String", # Output only. Transmission bit rate measured in Megabits per second.
"transmissionPowerDbm": 42, # Output only. Transmission power measured in decibels.
"wifiLinkQuality": "A String", # Output only. Wifi link quality. Value ranges from [0, 70]. 0 indicates no signal and 70 indicates a strong signal.
"wifiPowerManagementEnabled": True or False, # Output only. Wifi power management enabled
},
],
"orgUnitId": "A String", # Output only. Organization unit ID of the device.
"osUpdateStatus": [ # Output only. Contains relevant information regarding ChromeOS update status.
{ # Contains information regarding the current OS update status. * This field is telemetry information and this will change over time as the device is utilized. * Data for this field is controlled via policy: [ReportDeviceOsUpdateStatus](https://chromeenterprise.google/policies/#ReportDeviceOsUpdateStatus) * 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_OS_REPORT
"lastRebootTime": "A String", # Output only. Timestamp of the last reboot.
"lastUpdateCheckTime": "A String", # Output only. Timestamp of the last update check.
"lastUpdateTime": "A String", # Output only. Timestamp of the last successful update.
"newPlatformVersion": "A String", # Output only. New platform version of the os image being downloaded and applied. It is only set when update status is OS_IMAGE_DOWNLOAD_IN_PROGRESS or OS_UPDATE_NEED_REBOOT. Note this could be a dummy "0.0.0.0" for OS_UPDATE_NEED_REBOOT status for some edge cases, e.g. update engine is restarted without a reboot.
"newRequestedPlatformVersion": "A String", # Output only. New requested platform version from the pending updated kiosk app.
"updateState": "A String", # Output only. Current state of the os update.
},
],
"peripheralsReport": [ # Output only. Peripherals reports collected periodically sorted in a decreasing order of report_time.
{ # Peripherals report. * Granular permission needed: TELEMETRY_API_PERIPHERALS_REPORT
"reportTime": "A String", # Output only. Timestamp of when the report was collected.
"usbPeripheralReport": [ # Reports of all usb connected devices.
{ # USB connected peripheral report.
"categories": [ # Output only. Categories the device belongs to https://www.usb.org/defined-class-codes
"A String",
],
"classId": 42, # Output only. Class ID https://www.usb.org/defined-class-codes
"firmwareVersion": "A String", # Output only. Firmware version
"name": "A String", # Output only. Device name, model name, or product name
"pid": 42, # Output only. Product ID
"subclassId": 42, # Output only. Subclass ID https://www.usb.org/defined-class-codes
"vendor": "A String", # Output only. Vendor name
"vid": 42, # Output only. Vendor ID
},
],
},
],
"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.
"totalDiskBytes": "A String", # The total space for user data storage in the device in bytes.
"volume": [ # Information for disk volumes
{ # Information for disk volumes
"storageFreeBytes": "A String", # Free storage space in bytes.
"storageTotalBytes": "A String", # Total storage space in bytes.
"volumeId": "A String", # Disk volume id.
},
],
},
"storageStatusReport": [ # Output only. Storage reports collected periodically.
{ # 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_REPORT
"disk": [ # Output only. Reports on disk.
{ # Status of the single storage device.
"bytesReadThisSession": "A String", # Output only. Number of bytes read since last boot.
"bytesWrittenThisSession": "A String", # Output only. Number of bytes written since last boot.
"discardTimeThisSession": "A String", # Output only. Time spent discarding since last boot. Discarding is writing to clear blocks which are no longer in use. Supported on kernels 4.18+.
"health": "A String", # Output only. Disk health.
"ioTimeThisSession": "A String", # Output only. Counts the time the disk and queue were busy, so unlike the fields above, parallel requests are not counted multiple times.
"manufacturer": "A String", # Output only. Disk manufacturer.
"model": "A String", # Output only. Disk model.
"readTimeThisSession": "A String", # Output only. Time spent reading from disk since last boot.
"serialNumber": "A String", # Output only. Disk serial number.
"sizeBytes": "A String", # Output only. Disk size.
"type": "A String", # Output only. Disk type: eMMC / NVMe / ATA / SCSI.
"volumeIds": [ # Output only. Disk volumes.
"A String",
],
"writeTimeThisSession": "A String", # Output only. Time spent writing to disk since last boot.
},
],
"reportTime": "A String", # Output only. Timestamp of when the sample was collected on device
},
],
"thunderboltInfo": [ # Output only. Information on Thunderbolt bus.
{ # Thunderbolt bus info. * This field provides device information, which is static and will not change over time. * Data for this field is controlled via policy: [ReportDeviceSecurityStatus](https://chromeenterprise.google/policies/#ReportDeviceSecurityStatus) * Data Collection Frequency: At device startup * Default Data Reporting Frequency: At device startup - Policy Controlled: No * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: Yes * Reported for affiliated users only: N/A * Granular permission needed: TELEMETRY_API_BUS_DEVICE_INFO
"securityLevel": "A String", # Security level of the Thunderbolt bus.
},
],
}</pre>
</div>
<div class="method">
<code class="details" id="list">list(parent, filter=None, pageSize=None, pageToken=None, readMask=None, x__xgafv=None)</code>
<pre>List all telemetry devices.
Args:
parent: string, Required. Customer id or "my_customer" to use the customer associated to the account making the request. (required)
filter: string, Optional. Only include resources that match the filter. Requests that don't specify a "reports_timestamp" value will default to returning only recent reports. Specify "reports_timestamp>=0" to get all report data. 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. 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
2 - v2 error format
Returns:
An object of the form:
{
"devices": [ # Telemetry devices returned in the response.
{ # Telemetry data collected from a managed device. * Granular permission needed: TELEMETRY_API_DEVICE
"appReport": [ # Output only. App reports collected periodically sorted in a decreasing order of report_time.
{ # App report.
"reportTime": "A String", # Timestamp when the report was collected.
"usageData": [ # App usage data.
{ # App usage data.
"appId": "A String", # App id.
"appInstanceId": "A String", # Application instance id. This will be unique per window/instance.
"appType": "A String", # Type of app.
"runningDuration": "A String", # App foreground running time.
},
],
},
],
"audioStatusReport": [ # Output only. Audio reports collected periodically sorted in a decreasing order of report_time.
{ # 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: [ReportDeviceAudioStatus](https://chromeenterprise.google/policies/#ReportDeviceAudioStatus) * Data Collection Frequency: 10 minutes * 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_AUDIO_REPORT
"inputDevice": "A String", # Output only. Active input device's name.
"inputGain": 42, # Output only. Active input device's gain in [0, 100].
"inputMute": True or False, # Output only. Is active input device mute or not.
"outputDevice": "A String", # Output only. Active output device's name.
"outputMute": True or False, # Output only. Is active output device mute or not.
"outputVolume": 42, # Output only. Active output device's volume in [0, 100].
"reportTime": "A String", # Output only. Timestamp of when the sample was collected on device.
},
],
"batteryInfo": [ # Output only. Information on battery specs for the device.
{ # Information about the battery. * This field provides device information, which is static and will not change over time. * Data for this field is controlled via policy: [ReportDevicePowerStatus](https://chromeenterprise.google/policies/#ReportDevicePowerStatus) * 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_BATTERY_INFO
"designCapacity": "A String", # Output only. Design capacity (mAmpere-hours).
"designMinVoltage": 42, # Output only. Designed minimum output voltage (mV)
"manufactureDate": { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Output only. The date the battery was manufactured.
"day": 42, # Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.
"month": 42, # Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
"year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
},
"manufacturer": "A String", # Output only. Battery manufacturer.
"serialNumber": "A String", # Output only. Battery serial number.
"technology": "A String", # Output only. Technology of the battery. Example: Li-ion
},
],
"batteryStatusReport": [ # Output only. Battery reports collected periodically.
{ # Status data for battery. * This field is telemetry information and this will change over time as the device is utilized. * Data for this field is controlled via policy: [ReportDevicePowerStatus](https://chromeenterprise.google/policies/#ReportDevicePowerStatus) * 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_BATTERY_REPORT
"batteryHealth": "A String", # Output only. Battery health.
"cycleCount": 42, # Output only. Cycle count.
"fullChargeCapacity": "A String", # Output only. Full charge capacity (mAmpere-hours).
"reportTime": "A String", # Output only. Timestamp of when the sample was collected on device
"sample": [ # Output only. Sampling data for the battery sorted in a decreasing order of report_time.
{ # Sampling data for battery. * This field is telemetry information and this will change over time as the device is utilized. * Data for this field is controlled via policy: [ReportDevicePowerStatus](https://chromeenterprise.google/policies/#ReportDevicePowerStatus) * 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
"chargeRate": 42, # Output only. Battery charge percentage.
"current": "A String", # Output only. Battery current (mA).
"dischargeRate": 42, # Output only. The battery discharge rate measured in mW. Positive if the battery is being discharged, negative if it's being charged.
"remainingCapacity": "A String", # Output only. Battery remaining capacity (mAmpere-hours).
"reportTime": "A String", # Output only. Timestamp of when the sample was collected on device
"status": "A String", # Output only. Battery status read from sysfs. Example: Discharging
"temperature": 42, # Output only. Temperature in Celsius degrees.
"voltage": "A String", # Output only. Battery voltage (millivolt).
},
],
"serialNumber": "A String", # Output only. Battery serial number.
},
],
"bootPerformanceReport": [ # Output only. Boot performance reports of the device.
{ # Boot performance report of a device. * This field is telemetry information and this will change over time as the device is utilized. * Data for this field is controlled via policy: [ReportDeviceBootMode](https://chromeenterprise.google/policies/#ReportDeviceBootMode) * Data Collection Frequency: On every boot up event * 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: Yes * Reported for affiliated users only: N/A * Granular permission needed: TELEMETRY_API_OS_REPORT
"bootUpDuration": "A String", # Total time to boot up.
"bootUpTime": "A String", # The timestamp when power came on.
"reportTime": "A String", # Timestamp when the report was collected.
"shutdownDuration": "A String", # Total time since shutdown start to power off.
"shutdownReason": "A String", # The shutdown reason.
"shutdownTime": "A String", # The timestamp when shutdown.
},
],
"cpuInfo": [ # Output only. Information regarding CPU specs for the device.
{ # CPU specifications for the device * This field provides device information, which is static and will not change over time. * Data for this field is controlled via policy: [ReportDeviceCpuInfo](https://chromeenterprise.google/policies/#ReportDeviceCpuInfo) * 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_CPU_INFO
"architecture": "A String", # Output only. Architecture type for the CPU. * This field provides device information, which is static and will not change over time. * Data for this field is controlled via policy: [ReportDeviceCpuInfo](https://chromeenterprise.google/policies/#ReportDeviceCpuInfo) * 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
"keylockerConfigured": True or False, # Output only. Whether keylocker is configured.`TRUE` = Enabled; `FALSE` = disabled. Only reported if keylockerSupported = `TRUE`.
"keylockerSupported": True or False, # Output only. Whether keylocker is supported.
"maxClockSpeed": 42, # Output only. The max CPU clock speed in kHz.
"model": "A String", # Output only. The CPU model name. Example: Intel(R) Core(TM) i5-8250U CPU @ 1.60GHz
},
],
"cpuStatusReport": [ # Output only. CPU status reports collected periodically sorted in a decreasing order of report_time.
{ # Provides information about the status of the CPU. * This field is telemetry information and this will change over time as the device is utilized. * Data for this field is controlled via policy: [ReportDeviceCpuInfo](https://chromeenterprise.google/policies/#ReportDeviceCpuInfo) * Data Collection Frequency: Every 10 minutes * 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_CPU_REPORT
"cpuTemperatureInfo": [ # Output only. CPU temperature sample info per CPU core in Celsius
{ # CPU temperature of a device. Sampled per CPU core in Celsius. * This field is telemetry information and this will change over time as the device is utilized. * Data for this field is controlled via policy: [ReportDeviceCpuInfo](https://chromeenterprise.google/policies/#ReportDeviceCpuInfo) * Data Collection Frequency: Every 10 minutes * 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
"label": "A String", # Output only. CPU label. Example: Core 0
"temperatureCelsius": 42, # Output only. CPU temperature in Celsius.
},
],
"cpuUtilizationPct": 42, # Output only. Sample of CPU utilization (0-100 percent).
"reportTime": "A String", # Output only. The timestamp in milliseconds representing time at which this report was sampled.
"sampleFrequency": "A String", # Output only. Frequency the report is sampled.
},
],
"customer": "A String", # Output only. Google Workspace Customer whose enterprise enrolled the device.
"deviceId": "A String", # Output only. The unique Directory API ID of the device. This value is the same as the Admin Console's Directory API ID in the ChromeOS Devices tab
"graphicsInfo": { # Information of the graphics subsystem. * This field provides device information, which is static and will not change over time. * Data for this field is controlled via policy: [ReportDeviceGraphicsStatus](https://chromeenterprise.google/policies/#ReportDeviceGraphicsStatus) * 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_GRAPHICS_INFO # Output only. Contains information regarding Graphic peripherals for the device.
"adapterInfo": { # Information of a graphics adapter (GPU). # Output only. Information about the graphics adapter (GPU).
"adapter": "A String", # Output only. Adapter name. Example: Mesa DRI Intel(R) UHD Graphics 620 (Kabylake GT2).
"deviceId": "A String", # Output only. Represents the graphics card device id.
"driverVersion": "A String", # Output only. Version of the GPU driver.
},
"displayDevices": [ # Output only. Information about the display(s) of the device.
{ # Information of a display device.
"displayHeightMm": 42, # Output only. Display height in millimeters.
"displayName": "A String", # Output only. Display device name.
"displayWidthMm": 42, # Output only. Display width in millimeters.
"edidVersion": "A String", # Output only. EDID version.
"internal": True or False, # Output only. Is display internal or not.
"manufactureYear": 42, # Output only. Year of manufacture.
"manufacturerId": "A String", # Output only. Three letter manufacturer ID.
"modelId": 42, # Output only. Manufacturer product code.
"serialNumber": 42, # Output only. Serial number.
},
],
"eprivacySupported": True or False, # Output only. Is ePrivacy screen supported or not.
"touchScreenInfo": { # Information on the device touch screen. # Output only. Information about the internal touch screen(s) of the device.
"devices": [ # Output only. List of the internal touch screen devices.
{ # Information of an internal touch screen device.
"displayName": "A String", # Output only. Touch screen device display name.
"stylusCapable": True or False, # Output only. Touch screen device is stylus capable or not.
"touchPointCount": 42, # Output only. Number of touch points supported on the device.
},
],
"touchpadLibrary": "A String", # Output only. Touchpad library name used by the input stack.
},
},
"graphicsStatusReport": [ # Output only. Graphics reports collected periodically.
{ # Information of the graphics subsystem. * This field is telemetry information and this will change over time as the device is utilized. * Data for this field is controlled via policy: [ReportDeviceGraphicsInfo](https://chromeenterprise.google/policies/#ReportDeviceGraphicsInfo) * Data Collection Frequency: 3 hours. * 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_GRAPHICS_REPORT
"displays": [ # Output only. Information about the displays for the device.
{ # Information for a display.
"deviceId": "A String", # Output only. Represents the graphics card device id.
"displayName": "A String", # Output only. Display device name.
"edidVersion": "A String", # Output only. EDID version.
"isInternal": True or False, # Output only. Indicates if display is internal or not.
"refreshRate": 42, # Output only. Refresh rate in Hz.
"resolutionHeight": 42, # Output only. Resolution height in pixels.
"resolutionWidth": 42, # Output only. Resolution width in pixels.
"serialNumber": 42, # Output only. Serial number.
},
],
"reportTime": "A String", # Output only. Time at which the graphics data was reported.
},
],
"heartbeatStatusReport": [ # Output only. Heartbeat status report containing timestamps periodically sorted in decreasing order of report_time
{ # Heartbeat status report of a device. * Available for Kiosks * This field provides online/offline/unknown status of a device and will only be included if the status has changed (e.g. Online -> Offline) * Data for this field is controlled via policy: [HeartbeatEnabled](https://chromeenterprise.google/policies/#HeartbeatEnabled) [More Info](https://support.google.com/chrome/a/answer/6179663#:~:text=On%20the%20Chrome,device%20status%20alerts) * Heartbeat Frequency: 2 mins * Note: If a device goes offline, it can take up to 12 minutes for the online status of the device to be updated * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: N/A * Reported for affiliated users only: N/A * Granular permission needed: TELEMETRY_API_DEVICE_ACTIVITY_REPORT
"reportTime": "A String", # Timestamp of when status changed was detected
"state": "A String", # State the device changed to
},
],
"kioskAppStatusReport": [ # Output only. Kiosk app status report for the kiosk device
{ # Kiosk app status report of a device. * Available for Kiosks * This field provides the app id and version number running on a kiosk device and the timestamp of when the report was last updated * Data for this field is controlled via policy: [ReportDeviceSessionStatus](https://chromeenterprise.google/policies/#ReportDeviceSessionStatus) * 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_APPS_REPORT
"appId": "A String", # App id of kiosk app for example "mdmkkicfmmkgmpkmkdikhlbggogpicma"
"appVersion": "A String", # App version number of kiosk app for example "1.10.118"
"reportTime": "A String", # Timestamp of when report was collected
},
],
"memoryInfo": { # Memory information of a device. * This field has both telemetry and device information: - `totalRamBytes` - Device information - `availableRamBytes` - Telemetry information - `totalMemoryEncryption` - Device information * Data for this field is controlled via policy: [ReportDeviceMemoryInfo](https://chromeenterprise.google/policies/#ReportDeviceMemoryInfo) * Data Collection Frequency: - `totalRamBytes` - Only at upload - `availableRamBytes` - Every 10 minutes - `totalMemoryEncryption` - at device startup * Default Data Reporting Frequency: - `totalRamBytes` - 3 hours - `availableRamBytes` - 3 hours - `totalMemoryEncryption` - at device startup - 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: only for `totalMemoryEncryption` * Reported for affiliated users only: N/A * Granular permission needed: TELEMETRY_API_MEMORY_INFO # Output only. Information regarding memory specs for the device.
"availableRamBytes": "A String", # Output only. Amount of available RAM in bytes.
"totalMemoryEncryption": { # Memory encryption information of a device. * This field provides device information, which is static and will not change over time. * Data for this field is controlled via policy: [ReportDeviceMemoryInfo](https://chromeenterprise.google/policies/#ReportDeviceMemoryInfo) * Data Collection Frequency: At device startup * Default Data Reporting Frequency: At device startup - 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: Yes * Reported for affiliated users only: N/A # Output only. Total memory encryption info for the device.
"encryptionAlgorithm": "A String", # Memory encryption algorithm.
"encryptionState": "A String", # The state of memory encryption on the device.
"keyLength": "A String", # The length of the encryption keys.
"maxKeys": "A String", # The maximum number of keys that can be used for encryption.
},
"totalRamBytes": "A String", # Output only. Total RAM in bytes.
},
"memoryStatusReport": [ # Output only. Memory status reports collected periodically sorted decreasing by report_time.
{ # Contains samples of memory status reports. * This field is telemetry information and this will change over time as the device is utilized. * Data for this field is controlled via policy: [ReportDeviceMemoryInfo](https://chromeenterprise.google/policies/#ReportDeviceMemoryInfo) * Data Collection Frequency: Only at upload, SystemRamFreeByes is collected every 10 minutes * Default Data Reporting Frequency: Every 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_MEMORY_REPORT
"pageFaults": 42, # Output only. Number of page faults during this collection
"reportTime": "A String", # Output only. The timestamp in milliseconds representing time at which this report was sampled.
"sampleFrequency": "A String", # Output only. Frequency the report is sampled.
"systemRamFreeBytes": "A String", # Output only. Amount of free RAM in bytes (unreliable due to Garbage Collection).
},
],
"name": "A String", # Output only. Resource name of the device.
"networkBandwidthReport": [ # Output only. Network bandwidth reports collected periodically sorted in a decreasing order of report_time.
{ # Network bandwidth report. * Granular permission needed: TELEMETRY_API_NETWORK_REPORT
"downloadSpeedKbps": "A String", # Output only. Download speed in kilobits per second.
"reportTime": "A String", # Output only. Timestamp of when the report was collected.
},
],
"networkDiagnosticsReport": [ # Output only. Network diagnostics collected periodically.
{ # Network testing results to determine the health of the device's network connection, for example whether the HTTPS latency is high or normal. * Granular permission needed: TELEMETRY_API_NETWORK_REPORT
"httpsLatencyData": { # Data that describes the result of the HTTPS latency diagnostics routine, with the HTTPS requests issued to Google websites. # Output only. HTTPS latency test data.
"latency": "A String", # Output only. HTTPS latency if routine succeeded or failed because of HIGH_LATENCY or VERY_HIGH_LATENCY.
"problem": "A String", # Output only. HTTPS latency routine problem if a problem occurred.
},
"reportTime": "A String", # Output only. Timestamp of when the diagnostics were collected.
},
],
"networkInfo": { # Network device information. * This field provides device information, which is static and will not change over time. * Data for this field is controlled via policy: [ReportNetworkDeviceConfiguration](https://chromeenterprise.google/policies/#ReportNetworkDeviceConfiguration) * Data Collection Frequency: At device startup * Default Data Reporting Frequency: At device startup - 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: Yes * Reported for affiliated users only: N/A * Granular permission needed: TELEMETRY_API_NETWORK_INFO # Output only. Network devices information.
"networkDevices": [ # Output only. List of network devices.
{ # Details about the network device. * This field provides device information, which is static and will not change over time. * Data for this field is controlled via policy: [ReportNetworkDeviceConfiguration](https://chromeenterprise.google/policies/#ReportNetworkDeviceConfiguration) * Data Collection Frequency: At device startup * Default Data Reporting Frequency: At device startup - 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: Yes * Reported for affiliated users only: N/A
"iccid": "A String", # Output only. The integrated circuit card ID associated with the device's sim card.
"imei": "A String", # Output only. IMEI (if applicable) of the corresponding network device.
"macAddress": "A String", # Output only. MAC address (if applicable) of the corresponding network device.
"mdn": "A String", # Output only. The mobile directory number associated with the device's sim card.
"meid": "A String", # Output only. MEID (if applicable) of the corresponding network device.
"type": "A String", # Output only. Network device type.
},
],
},
"networkStatusReport": [ # Output only. Network specs collected periodically.
{ # State of visible/configured networks. * This field is telemetry information and this will change over time as the device is utilized. * Data for this field is controlled via policy: [ReportNetworkStatus](https://chromeenterprise.google/policies/#ReportNetworkStatus) * Data Collection Frequency: 60 minutes * 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: Yes * Reported for affiliated users only: Yes * Granular permission needed: TELEMETRY_API_NETWORK_REPORT
"connectionState": "A String", # Output only. Current connection state of the network.
"connectionType": "A String", # Output only. Network connection type.
"encryptionOn": True or False, # Output only. Whether the wifi encryption key is turned off.
"gatewayIpAddress": "A String", # Output only. Gateway IP address.
"guid": "A String", # Output only. Network connection guid.
"lanIpAddress": "A String", # Output only. LAN IP address.
"receivingBitRateMbps": "A String", # Output only. Receiving bit rate measured in Megabits per second.
"reportTime": "A String", # Output only. Time at which the network state was reported.
"sampleFrequency": "A String", # Output only. Frequency the report is sampled.
"signalStrengthDbm": 42, # Output only. Signal strength for wireless networks measured in decibels.
"transmissionBitRateMbps": "A String", # Output only. Transmission bit rate measured in Megabits per second.
"transmissionPowerDbm": 42, # Output only. Transmission power measured in decibels.
"wifiLinkQuality": "A String", # Output only. Wifi link quality. Value ranges from [0, 70]. 0 indicates no signal and 70 indicates a strong signal.
"wifiPowerManagementEnabled": True or False, # Output only. Wifi power management enabled
},
],
"orgUnitId": "A String", # Output only. Organization unit ID of the device.
"osUpdateStatus": [ # Output only. Contains relevant information regarding ChromeOS update status.
{ # Contains information regarding the current OS update status. * This field is telemetry information and this will change over time as the device is utilized. * Data for this field is controlled via policy: [ReportDeviceOsUpdateStatus](https://chromeenterprise.google/policies/#ReportDeviceOsUpdateStatus) * 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_OS_REPORT
"lastRebootTime": "A String", # Output only. Timestamp of the last reboot.
"lastUpdateCheckTime": "A String", # Output only. Timestamp of the last update check.
"lastUpdateTime": "A String", # Output only. Timestamp of the last successful update.
"newPlatformVersion": "A String", # Output only. New platform version of the os image being downloaded and applied. It is only set when update status is OS_IMAGE_DOWNLOAD_IN_PROGRESS or OS_UPDATE_NEED_REBOOT. Note this could be a dummy "0.0.0.0" for OS_UPDATE_NEED_REBOOT status for some edge cases, e.g. update engine is restarted without a reboot.
"newRequestedPlatformVersion": "A String", # Output only. New requested platform version from the pending updated kiosk app.
"updateState": "A String", # Output only. Current state of the os update.
},
],
"peripheralsReport": [ # Output only. Peripherals reports collected periodically sorted in a decreasing order of report_time.
{ # Peripherals report. * Granular permission needed: TELEMETRY_API_PERIPHERALS_REPORT
"reportTime": "A String", # Output only. Timestamp of when the report was collected.
"usbPeripheralReport": [ # Reports of all usb connected devices.
{ # USB connected peripheral report.
"categories": [ # Output only. Categories the device belongs to https://www.usb.org/defined-class-codes
"A String",
],
"classId": 42, # Output only. Class ID https://www.usb.org/defined-class-codes
"firmwareVersion": "A String", # Output only. Firmware version
"name": "A String", # Output only. Device name, model name, or product name
"pid": 42, # Output only. Product ID
"subclassId": 42, # Output only. Subclass ID https://www.usb.org/defined-class-codes
"vendor": "A String", # Output only. Vendor name
"vid": 42, # Output only. Vendor ID
},
],
},
],
"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.
"totalDiskBytes": "A String", # The total space for user data storage in the device in bytes.
"volume": [ # Information for disk volumes
{ # Information for disk volumes
"storageFreeBytes": "A String", # Free storage space in bytes.
"storageTotalBytes": "A String", # Total storage space in bytes.
"volumeId": "A String", # Disk volume id.
},
],
},
"storageStatusReport": [ # Output only. Storage reports collected periodically.
{ # 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_REPORT
"disk": [ # Output only. Reports on disk.
{ # Status of the single storage device.
"bytesReadThisSession": "A String", # Output only. Number of bytes read since last boot.
"bytesWrittenThisSession": "A String", # Output only. Number of bytes written since last boot.
"discardTimeThisSession": "A String", # Output only. Time spent discarding since last boot. Discarding is writing to clear blocks which are no longer in use. Supported on kernels 4.18+.
"health": "A String", # Output only. Disk health.
"ioTimeThisSession": "A String", # Output only. Counts the time the disk and queue were busy, so unlike the fields above, parallel requests are not counted multiple times.
"manufacturer": "A String", # Output only. Disk manufacturer.
"model": "A String", # Output only. Disk model.
"readTimeThisSession": "A String", # Output only. Time spent reading from disk since last boot.
"serialNumber": "A String", # Output only. Disk serial number.
"sizeBytes": "A String", # Output only. Disk size.
"type": "A String", # Output only. Disk type: eMMC / NVMe / ATA / SCSI.
"volumeIds": [ # Output only. Disk volumes.
"A String",
],
"writeTimeThisSession": "A String", # Output only. Time spent writing to disk since last boot.
},
],
"reportTime": "A String", # Output only. Timestamp of when the sample was collected on device
},
],
"thunderboltInfo": [ # Output only. Information on Thunderbolt bus.
{ # Thunderbolt bus info. * This field provides device information, which is static and will not change over time. * Data for this field is controlled via policy: [ReportDeviceSecurityStatus](https://chromeenterprise.google/policies/#ReportDeviceSecurityStatus) * Data Collection Frequency: At device startup * Default Data Reporting Frequency: At device startup - Policy Controlled: No * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: Yes * Reported for affiliated users only: N/A * Granular permission needed: TELEMETRY_API_BUS_DEVICE_INFO
"securityLevel": "A String", # Security level of the Thunderbolt bus.
},
],
},
],
"nextPageToken": "A String", # Token to specify next page in the list.
}</pre>
</div>
<div class="method">
<code class="details" id="list_next">list_next()</code>
<pre>Retrieves the next page of results.
Args:
previous_request: The request for the previous page. (required)
previous_response: The response from the request for the previous page. (required)
Returns:
A request object that you can call 'execute()' on to request the next
page. Returns None if there are no more items in the collection.
</pre>
</div>
</body></html>
|
