{ "parameters": { "quotaUser": { "description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.", "location": "query", "type": "string" }, "access_token": { "description": "OAuth access token.", "type": "string", "location": "query" }, "prettyPrint": { "type": "boolean", "default": "true", "location": "query", "description": "Returns response with indentations and line breaks." }, "fields": { "description": "Selector specifying which fields to include in a partial response.", "type": "string", "location": "query" }, "key": { "location": "query", "type": "string", "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token." }, "upload_protocol": { "location": "query", "type": "string", "description": "Upload protocol for media (e.g. \"raw\", \"multipart\")." }, "$.xgafv": { "type": "string", "enumDescriptions": [ "v1 error format", "v2 error format" ], "enum": [ "1", "2" ], "location": "query", "description": "V1 error format." }, "alt": { "enum": [ "json", "media", "proto" ], "location": "query", "description": "Data format for response.", "default": "json", "type": "string", "enumDescriptions": [ "Responses with Content-Type of application/json", "Media download with context-dependent Content-Type", "Responses with Content-Type of application/x-protobuf" ] }, "uploadType": { "type": "string", "location": "query", "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\")." }, "callback": { "description": "JSONP", "location": "query", "type": "string" }, "oauth_token": { "type": "string", "description": "OAuth 2.0 token for the current user.", "location": "query" } }, "schemas": { "GoogleChromeManagementV1NetworkBandwidthReport": { "properties": { "reportTime": { "type": "string", "readOnly": true, "description": "Output only. Timestamp of when the report was collected.", "format": "google-datetime" }, "downloadSpeedKbps": { "format": "int64", "type": "string", "description": "Output only. Download speed in kilobits per second.", "readOnly": true } }, "description": "Network bandwidth report. * Granular permission needed: TELEMETRY_API_NETWORK_REPORT", "type": "object", "id": "GoogleChromeManagementV1NetworkBandwidthReport" }, "GoogleTypeDate": { "description": "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", "id": "GoogleTypeDate", "type": "object", "properties": { "month": { "format": "int32", "description": "Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.", "type": "integer" }, "day": { "type": "integer", "format": "int32", "description": "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." }, "year": { "format": "int32", "description": "Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.", "type": "integer" } } }, "GoogleChromeManagementV1TelemetryNotificationFilter": { "type": "object", "description": "Configures how the telemetry data should be filtered.", "properties": { "deviceId": { "type": "string", "description": "If set, only sends notifications for telemetry data coming from this device." }, "deviceOrgUnitId": { "description": "If set, only sends notifications for telemetry data coming from devices in this org unit.", "type": "string" }, "userOrgUnitId": { "description": "If set, only sends notifications for telemetry data coming from devices owned by users in this org unit.", "type": "string" }, "userEmail": { "type": "string", "description": "If set, only sends notifications for telemetry data coming from devices owned by this user." }, "telemetryEventNotificationFilter": { "$ref": "GoogleChromeManagementV1TelemetryEventNotificationFilter", "description": "Only sends notifications for the telemetry events matching this filter." } }, "id": "GoogleChromeManagementV1TelemetryNotificationFilter" }, "GoogleChromeManagementV1CountChromeAppRequestsResponse": { "description": "Response containing summary of requested app installations.", "id": "GoogleChromeManagementV1CountChromeAppRequestsResponse", "type": "object", "properties": { "nextPageToken": { "description": "Token to specify the next page in the list.", "type": "string" }, "requestedApps": { "items": { "$ref": "GoogleChromeManagementV1ChromeAppRequest" }, "type": "array", "description": "Count of requested apps matching request." }, "totalSize": { "format": "int32", "type": "integer", "description": "Total number of matching app requests." } } }, "GoogleChromeManagementV1HttpsLatencyRoutineData": { "description": "Data that describes the result of the HTTPS latency diagnostics routine, with the HTTPS requests issued to Google websites.", "properties": { "problem": { "enum": [ "HTTPS_LATENCY_PROBLEM_UNSPECIFIED", "FAILED_DNS_RESOLUTIONS", "FAILED_HTTPS_REQUESTS", "HIGH_LATENCY", "VERY_HIGH_LATENCY" ], "readOnly": true, "enumDescriptions": [ "HTTPS latency problem not specified.", "One or more DNS resolutions resulted in a failure.", "One or more HTTPS requests resulted in a failure.", "Average HTTPS request latency time between 500ms and 1000ms is high.", "Average HTTPS request latency time greater than 1000ms is very high." ], "description": "Output only. HTTPS latency routine problem if a problem occurred.", "type": "string" }, "latency": { "description": "Output only. HTTPS latency if routine succeeded or failed because of HIGH_LATENCY or VERY_HIGH_LATENCY.", "format": "google-duration", "readOnly": true, "type": "string" } }, "id": "GoogleChromeManagementV1HttpsLatencyRoutineData", "type": "object" }, "GoogleChromeManagementV1TelemetryEventNotificationFilter": { "properties": { "eventTypes": { "description": "Only sends the notifications for events of these types. Must not be empty.", "items": { "enum": [ "EVENT_TYPE_UNSPECIFIED", "AUDIO_SEVERE_UNDERRUN", "NETWORK_STATE_CHANGE", "USB_ADDED", "USB_REMOVED", "NETWORK_HTTPS_LATENCY_CHANGE", "WIFI_SIGNAL_STRENGTH_LOW", "WIFI_SIGNAL_STRENGTH_RECOVERED", "VPN_CONNECTION_STATE_CHANGE" ], "enumDescriptions": [ "Event type unknown.", "Triggered when a audio devices run out of buffer data for more than 5 seconds.", "Triggered immediately on any changes to a network connection.", "Triggered when USB devices are added.", "Triggered when USB devices are removed.", "Triggered when a new HTTPS latency problem was detected or the device has recovered form an existing HTTPS latency problem.", "Triggered when connected WiFi network signal strength drops below -70dBm.", "Triggered when connected WiFi network signal strength is recovered from a signal drop.", "Triggered on changes to VPN connections." ], "type": "string" }, "type": "array" } }, "description": "Configures how the telemetry events should be filtered.", "id": "GoogleChromeManagementV1TelemetryEventNotificationFilter", "type": "object" }, "GoogleChromeManagementV1BatteryStatusReport": { "description": "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", "properties": { "batteryHealth": { "readOnly": true, "enumDescriptions": [ "Health unknown.", "Battery is healthy, full charge capacity / design capacity \u003e 80%", "Battery is moderately unhealthy and suggested to be replaced soon, full charge capacity / design capacity 75% - 80%", "Battery is unhealthy and suggested to be replaced, full charge capacity / design capacity \u003c 75%" ], "enum": [ "BATTERY_HEALTH_UNSPECIFIED", "BATTERY_HEALTH_NORMAL", "BATTERY_REPLACE_SOON", "BATTERY_REPLACE_NOW" ], "description": "Output only. Battery health.", "type": "string" }, "fullChargeCapacity": { "readOnly": true, "format": "int64", "description": "Output only. Full charge capacity (mAmpere-hours).", "type": "string" }, "cycleCount": { "type": "integer", "format": "int32", "description": "Output only. Cycle count.", "readOnly": true }, "sample": { "readOnly": true, "description": "Output only. Sampling data for the battery sorted in a decreasing order of report_time.", "items": { "$ref": "GoogleChromeManagementV1BatterySampleReport" }, "type": "array" }, "serialNumber": { "readOnly": true, "description": "Output only. Battery serial number.", "type": "string" }, "reportTime": { "description": "Output only. Timestamp of when the sample was collected on device", "readOnly": true, "type": "string", "format": "google-datetime" } }, "type": "object", "id": "GoogleChromeManagementV1BatteryStatusReport" }, "GoogleProtobufEmpty": { "id": "GoogleProtobufEmpty", "description": "A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); }", "type": "object", "properties": {} }, "GoogleChromeManagementV1FetchDevicesRequestingExtensionResponse": { "id": "GoogleChromeManagementV1FetchDevicesRequestingExtensionResponse", "type": "object", "description": "Response containing a list of devices that have requested the queried extension.", "properties": { "deviceDetails": { "description": "Details of devices that have requested the queried extension.", "type": "array", "items": { "$ref": "GoogleChromeManagementV1DeviceRequestingExtensionDetails" } }, "nextPageToken": { "type": "string", "description": "Optional. Token to specify the next page in the list. Token expires after 1 day." }, "totalSize": { "description": "Optional. Total number of devices in response.", "format": "int32", "type": "integer" } } }, "GoogleChromeManagementV1InstalledApp": { "type": "object", "properties": { "osUserCount": { "type": "string", "format": "int64", "readOnly": true, "description": "Output only. Count of ChromeOS users with this app installed." }, "appId": { "readOnly": true, "type": "string", "description": "Output only. Unique identifier of the app. For Chrome apps and extensions, the 32-character id (e.g. ehoadneljpdggcbbknedodolkkjodefl). For Android apps, the package name (e.g. com.evernote)." }, "appInstallType": { "enumDescriptions": [ "Application install type not specified.", "Multiple app install types.", "Normal app install type.", "Administrator app install type.", "Development app install type.", "Sideloaded app install type.", "Other app install type." ], "enum": [ "APP_INSTALL_TYPE_UNSPECIFIED", "MULTIPLE", "NORMAL", "ADMIN", "DEVELOPMENT", "SIDELOAD", "OTHER" ], "description": "Output only. How the app was installed.", "readOnly": true, "type": "string" }, "displayName": { "type": "string", "description": "Output only. Name of the installed app.", "readOnly": true }, "homepageUri": { "readOnly": true, "type": "string", "description": "Output only. Homepage uri of the installed app." }, "permissions": { "readOnly": true, "items": { "type": "string" }, "type": "array", "description": "Output only. Permissions of the installed app." }, "appSource": { "enumDescriptions": [ "Application source not specified.", "Generally for extensions and Chrome apps.", "Play Store app." ], "readOnly": true, "type": "string", "description": "Output only. Source of the installed app.", "enum": [ "APP_SOURCE_UNSPECIFIED", "CHROME_WEBSTORE", "PLAY_STORE" ] }, "appType": { "enumDescriptions": [ "App type not specified.", "Chrome extension.", "Chrome app.", "Chrome theme.", "Chrome hosted app.", "ARC++ app." ], "readOnly": true, "type": "string", "description": "Output only. Type of the app.", "enum": [ "APP_TYPE_UNSPECIFIED", "EXTENSION", "APP", "THEME", "HOSTED_APP", "ANDROID_APP" ] }, "description": { "description": "Output only. Description of the installed app.", "readOnly": true, "type": "string" }, "browserDeviceCount": { "readOnly": true, "description": "Output only. Count of browser devices with this app installed.", "format": "int64", "type": "string" }, "disabled": { "readOnly": true, "description": "Output only. Whether the app is disabled.", "type": "boolean" } }, "id": "GoogleChromeManagementV1InstalledApp", "description": "Describes an installed app." }, "GoogleChromeManagementV1DeviceAueCountReport": { "id": "GoogleChromeManagementV1DeviceAueCountReport", "description": "Report for CountChromeDevicesPerAueDateResponse, contains the count of devices of a specific model and auto update expiration range.", "properties": { "count": { "format": "int64", "description": "Count of devices of this model.", "type": "string" }, "model": { "type": "string", "description": "Public model name of the devices." }, "expired": { "description": "Boolean value for whether or not the device has already expired.", "type": "boolean" }, "aueMonth": { "enum": [ "MONTH_UNSPECIFIED", "JANUARY", "FEBRUARY", "MARCH", "APRIL", "MAY", "JUNE", "JULY", "AUGUST", "SEPTEMBER", "OCTOBER", "NOVEMBER", "DECEMBER" ], "enumDescriptions": [ "The unspecified month.", "The month of January.", "The month of February.", "The month of March.", "The month of April.", "The month of May.", "The month of June.", "The month of July.", "The month of August.", "The month of September.", "The month of October.", "The month of November.", "The month of December." ], "type": "string", "description": "Enum value of month corresponding to the auto update expiration date in UTC time zone. If the device is already expired, this field is empty." }, "aueYear": { "description": "Int value of year corresponding to the Auto Update Expiration date in UTC time zone. If the device is already expired, this field is empty.", "type": "string", "format": "int64" } }, "type": "object" }, "GoogleChromeManagementV1ChromeAppPermission": { "id": "GoogleChromeManagementV1ChromeAppPermission", "description": "Permission requested by a Chrome app or extension.", "type": "object", "properties": { "accessUserData": { "description": "Output only. If available, whether this permissions grants the app/extension access to user data.", "type": "boolean", "readOnly": true }, "type": { "type": "string", "description": "Output only. The type of the permission.", "readOnly": true }, "documentationUri": { "description": "Output only. If available, a URI to a page that has documentation for the current permission.", "readOnly": true, "type": "string" } } }, "GoogleChromeManagementV1ListTelemetryNotificationConfigsResponse": { "description": "Response message for listing notification configs for a customer.", "type": "object", "properties": { "telemetryNotificationConfigs": { "type": "array", "description": "The telemetry notification configs from the specified customer.", "items": { "$ref": "GoogleChromeManagementV1TelemetryNotificationConfig" } }, "nextPageToken": { "type": "string", "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages." } }, "id": "GoogleChromeManagementV1ListTelemetryNotificationConfigsResponse" }, "GoogleChromeManagementV1ListTelemetryUsersResponse": { "id": "GoogleChromeManagementV1ListTelemetryUsersResponse", "properties": { "telemetryUsers": { "items": { "$ref": "GoogleChromeManagementV1TelemetryUser" }, "description": "Telemetry users returned in the response.", "type": "array" }, "nextPageToken": { "description": "Token to specify next page in the list.", "type": "string" } }, "description": "Response message for listing telemetry users for a customer.", "type": "object" }, "GoogleChromeManagementV1ThunderboltInfo": { "type": "object", "properties": { "securityLevel": { "enumDescriptions": [ "Thunderbolt security level is not set.", "All devices are automatically connected by the firmware. No user approval is needed.", "User is asked whether the device is allowed to be connected.", "User is asked whether the device is allowed to be connected. In addition the device is sent a challenge that should match the expected one based on a random key written to the key sysfs attribute", "The firmware automatically creates tunnels for Thunderbolt.", "The firmware automatically creates tunnels for the USB controller and Display Port in a dock. All PCIe links downstream of the dock are removed.", "PCIE tunneling is disabled." ], "type": "string", "description": "Security level of the Thunderbolt bus.", "enum": [ "THUNDERBOLT_SECURITY_LEVEL_UNSPECIFIED", "THUNDERBOLT_SECURITY_NONE_LEVEL", "THUNDERBOLT_SECURITY_USER_LEVEL", "THUNDERBOLT_SECURITY_SECURE_LEVEL", "THUNDERBOLT_SECURITY_DP_ONLY_LEVEL", "THUNDERBOLT_SECURITY_USB_ONLY_LEVEL", "THUNDERBOLT_SECURITY_NO_PCIE_LEVEL" ] } }, "description": "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", "id": "GoogleChromeManagementV1ThunderboltInfo" }, "GoogleChromeManagementV1CountChromeDevicesReachingAutoExpirationDateResponse": { "id": "GoogleChromeManagementV1CountChromeDevicesReachingAutoExpirationDateResponse", "description": "Response containing a list of devices expiring in each month of a selected time frame. Counts are grouped by model and Auto Update Expiration date.", "type": "object", "properties": { "deviceAueCountReports": { "type": "array", "items": { "$ref": "GoogleChromeManagementV1DeviceAueCountReport" }, "description": "The list of reports sorted by auto update expiration date in ascending order." } } }, "GoogleChromeManagementV1TelemetryUserDevice": { "id": "GoogleChromeManagementV1TelemetryUserDevice", "description": "Telemetry data collected for a managed user and device. * Granular permission needed: TELEMETRY_API_DEVICE", "type": "object", "properties": { "deviceActivityReport": { "items": { "$ref": "GoogleChromeManagementV1DeviceActivityReport" }, "description": "Output only. Device activity reports collected periodically sorted in a decreasing order of report_time.", "readOnly": true, "type": "array" }, "networkBandwidthReport": { "readOnly": true, "type": "array", "items": { "$ref": "GoogleChromeManagementV1NetworkBandwidthReport" }, "description": "Output only. Network bandwidth reports collected periodically sorted in a decreasing order of report_time." }, "deviceId": { "type": "string", "description": "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." }, "peripheralsReport": { "items": { "$ref": "GoogleChromeManagementV1PeripheralsReport" }, "type": "array", "description": "Output only. Peripherals reports collected periodically sorted in a decreasing order of report_time.", "readOnly": true }, "audioStatusReport": { "items": { "$ref": "GoogleChromeManagementV1AudioStatusReport" }, "readOnly": true, "type": "array", "description": "Output only. Audio reports collected periodically sorted in a decreasing order of report_time." } } }, "GoogleChromeManagementV1CpuInfo": { "properties": { "keylockerConfigured": { "description": "Output only. Whether keylocker is configured.`TRUE` = Enabled; `FALSE` = disabled. Only reported if keylockerSupported = `TRUE`.", "readOnly": true, "type": "boolean" }, "keylockerSupported": { "readOnly": true, "type": "boolean", "description": "Output only. Whether keylocker is supported." }, "model": { "readOnly": true, "type": "string", "description": "Output only. The CPU model name. Example: Intel(R) Core(TM) i5-8250U CPU @ 1.60GHz" }, "architecture": { "type": "string", "description": "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", "enumDescriptions": [ "Architecture unknown.", "x64 architecture" ], "readOnly": true, "enum": [ "ARCHITECTURE_UNSPECIFIED", "X64" ] }, "maxClockSpeed": { "format": "int32", "readOnly": true, "description": "Output only. The max CPU clock speed in kHz.", "type": "integer" } }, "type": "object", "id": "GoogleChromeManagementV1CpuInfo", "description": "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" }, "GoogleChromeManagementV1NetworkDevice": { "id": "GoogleChromeManagementV1NetworkDevice", "description": "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", "type": "object", "properties": { "type": { "description": "Output only. Network device type.", "enumDescriptions": [ "Network device type not specified.", "Cellular device.", "Ethernet device.", "Wifi device." ], "enum": [ "NETWORK_DEVICE_TYPE_UNSPECIFIED", "CELLULAR_DEVICE", "ETHERNET_DEVICE", "WIFI_DEVICE" ], "type": "string", "readOnly": true }, "meid": { "readOnly": true, "type": "string", "description": "Output only. MEID (if applicable) of the corresponding network device." }, "imei": { "type": "string", "description": "Output only. IMEI (if applicable) of the corresponding network device.", "readOnly": true }, "macAddress": { "type": "string", "description": "Output only. MAC address (if applicable) of the corresponding network device.", "readOnly": true }, "iccid": { "type": "string", "description": "Output only. The integrated circuit card ID associated with the device's sim card.", "readOnly": true }, "mdn": { "readOnly": true, "description": "Output only. The mobile directory number associated with the device's sim card.", "type": "string" } } }, "GoogleChromeManagementV1ChromeAppRequest": { "properties": { "detailUri": { "type": "string", "description": "Output only. The uri for the detail page of the item.", "readOnly": true }, "latestRequestTime": { "readOnly": true, "type": "string", "format": "google-datetime", "description": "Output only. The timestamp of the most recently made request for this app." }, "appId": { "description": "Output only. Unique store identifier for the app. Example: \"gmbmikajjgmnabiglmofipeabaddhgne\" for the Save to Google Drive Chrome extension.", "type": "string", "readOnly": true }, "requestCount": { "description": "Output only. Total count of requests for this app.", "type": "string", "format": "int64", "readOnly": true }, "iconUri": { "readOnly": true, "type": "string", "description": "Output only. A link to an image that can be used as an icon for the product." }, "appDetails": { "description": "Output only. Format: app_details=customers/{customer_id}/apps/chrome/{app_id}", "readOnly": true, "type": "string" }, "displayName": { "type": "string", "readOnly": true, "description": "Output only. App's display name." } }, "type": "object", "id": "GoogleChromeManagementV1ChromeAppRequest", "description": "Details of an app installation request." }, "GoogleChromeManagementV1AppDetails": { "description": "Resource representing app details.", "properties": { "name": { "readOnly": true, "type": "string", "description": "Output only. Format: name=customers/{customer_id}/apps/{chrome|android|web}/{app_id}@{version}" }, "revisionId": { "type": "string", "readOnly": true, "description": "Output only. App version. A new revision is committed whenever a new version of the app is published." }, "homepageUri": { "readOnly": true, "description": "Output only. Home page or Website uri.", "type": "string" }, "androidAppInfo": { "$ref": "GoogleChromeManagementV1AndroidAppInfo", "readOnly": true, "description": "Output only. Android app information." }, "iconUri": { "type": "string", "readOnly": true, "description": "Output only. A link to an image that can be used as an icon for the product." }, "latestPublishTime": { "readOnly": true, "format": "google-datetime", "description": "Output only. Latest published time.", "type": "string" }, "firstPublishTime": { "format": "google-datetime", "type": "string", "description": "Output only. First published time.", "readOnly": true }, "description": { "readOnly": true, "type": "string", "description": "Output only. App's description." }, "displayName": { "description": "Output only. App's display name.", "type": "string", "readOnly": true }, "reviewNumber": { "readOnly": true, "description": "Output only. Number of reviews received. Chrome Web Store review information will always be for the latest version of an app.", "type": "string", "format": "int64" }, "reviewRating": { "readOnly": true, "description": "Output only. The rating of the app (on 5 stars). Chrome Web Store review information will always be for the latest version of an app.", "format": "float", "type": "number" }, "chromeAppInfo": { "$ref": "GoogleChromeManagementV1ChromeAppInfo", "description": "Output only. Chrome Web Store app information.", "readOnly": true }, "isPaidApp": { "type": "boolean", "readOnly": true, "description": "Output only. Indicates if the app has to be paid for OR has paid content." }, "appId": { "type": "string", "description": "Output only. Unique store identifier for the item. Examples: \"gmbmikajjgmnabiglmofipeabaddhgne\" for the Save to Google Drive Chrome extension, \"com.google.android.apps.docs\" for the Google Drive Android app.", "readOnly": true }, "publisher": { "readOnly": true, "description": "Output only. The publisher of the item.", "type": "string" }, "detailUri": { "description": "Output only. The uri for the detail page of the item.", "type": "string", "readOnly": true }, "type": { "enum": [ "APP_ITEM_TYPE_UNSPECIFIED", "CHROME", "ANDROID", "WEB" ], "type": "string", "readOnly": true, "enumDescriptions": [ "App type unspecified.", "Chrome app.", "ARC++ app.", "Web app." ], "description": "Output only. App type." }, "serviceError": { "$ref": "GoogleRpcStatus", "readOnly": true, "description": "Output only. Information about a partial service error if applicable." }, "privacyPolicyUri": { "readOnly": true, "description": "Output only. The URI pointing to the privacy policy of the app, if it was provided by the developer. Version-specific field that will only be set when the requested app version is found.", "type": "string" } }, "type": "object", "id": "GoogleChromeManagementV1AppDetails" }, "GoogleChromeManagementV1MemoryInfo": { "properties": { "availableRamBytes": { "type": "string", "readOnly": true, "format": "int64", "description": "Output only. Amount of available RAM in bytes." }, "totalMemoryEncryption": { "description": "Output only. Total memory encryption info for the device.", "readOnly": true, "$ref": "GoogleChromeManagementV1TotalMemoryEncryptionInfo" }, "totalRamBytes": { "readOnly": true, "description": "Output only. Total RAM in bytes.", "format": "int64", "type": "string" } }, "description": "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", "id": "GoogleChromeManagementV1MemoryInfo", "type": "object" }, "GoogleChromeManagementV1TelemetryNetworkConnectionStateChangeEvent": { "id": "GoogleChromeManagementV1TelemetryNetworkConnectionStateChangeEvent", "type": "object", "description": "`TelemetryNetworkConnectionStateChangeEvent` is triggered on network connection state changes. * Granular permission needed: TELEMETRY_API_NETWORK_REPORT", "properties": { "guid": { "type": "string", "description": "Unique identifier of the network." }, "connectionState": { "description": "Current connection state of the network.", "type": "string", "enum": [ "NETWORK_CONNECTION_STATE_UNSPECIFIED", "ONLINE", "CONNECTED", "PORTAL", "CONNECTING", "NOT_CONNECTED" ], "enumDescriptions": [ "Network connection state unspecified.", "The network is connected and internet connectivity is available.", "The network is connected and not in a detected portal state, but internet connectivity may not be available.", "The network is connected but a portal state was detected. Internet connectivity may be limited.", "The network is in the process of connecting.", "The network is not connected." ] } } }, "GoogleChromeManagementV1GraphicsInfo": { "description": "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", "properties": { "touchScreenInfo": { "$ref": "GoogleChromeManagementV1TouchScreenInfo", "description": "Output only. Information about the internal touch screen(s) of the device.", "readOnly": true }, "eprivacySupported": { "readOnly": true, "description": "Output only. Is ePrivacy screen supported or not.", "type": "boolean" }, "displayDevices": { "type": "array", "readOnly": true, "items": { "$ref": "GoogleChromeManagementV1DisplayDevice" }, "description": "Output only. Information about the display(s) of the device." }, "adapterInfo": { "$ref": "GoogleChromeManagementV1GraphicsAdapterInfo", "description": "Output only. Information about the graphics adapter (GPU).", "readOnly": true } }, "type": "object", "id": "GoogleChromeManagementV1GraphicsInfo" }, "GoogleChromeManagementV1TotalMemoryEncryptionInfo": { "properties": { "encryptionAlgorithm": { "type": "string", "description": "Memory encryption algorithm.", "enumDescriptions": [ "Memory encryption algorithm is not set.", "The memory encryption algorithm being used is unknown.", "The memory encryption algorithm is using the AES_XTS encryption algorithm with a 128 bit block cypher.", "The memory encryption algorithm is using the AES_XTS encryption algorithm with a 256 bit block cypher." ], "enum": [ "MEMORY_ENCRYPTION_ALGORITHM_UNSPECIFIED", "MEMORY_ENCRYPTION_ALGORITHM_UNKNOWN", "MEMORY_ENCRYPTION_ALGORITHM_AES_XTS_128", "MEMORY_ENCRYPTION_ALGORITHM_AES_XTS_256" ] }, "encryptionState": { "enum": [ "MEMORY_ENCRYPTION_STATE_UNSPECIFIED", "MEMORY_ENCRYPTION_STATE_UNKNOWN", "MEMORY_ENCRYPTION_STATE_DISABLED", "MEMORY_ENCRYPTION_STATE_TME", "MEMORY_ENCRYPTION_STATE_MKTME" ], "enumDescriptions": [ "Memory encryption state is not set.", "The memory encryption state is unknown.", "Memory encrpytion on the device is disabled.", "Memory encryption on the device uses total memory encryption.", "Memory encryption on the device uses multi-key total memory encryption." ], "type": "string", "description": "The state of memory encryption on the device." }, "keyLength": { "description": "The length of the encryption keys.", "format": "int64", "type": "string" }, "maxKeys": { "format": "int64", "description": "The maximum number of keys that can be used for encryption.", "type": "string" } }, "type": "object", "description": "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", "id": "GoogleChromeManagementV1TotalMemoryEncryptionInfo" }, "GoogleChromeManagementV1CountPrintJobsByPrinterResponse": { "type": "object", "id": "GoogleChromeManagementV1CountPrintJobsByPrinterResponse", "properties": { "nextPageToken": { "type": "string", "description": "Pagination token for requesting the next page." }, "totalSize": { "type": "string", "format": "int64", "description": "Total number of printers matching request." }, "printerReports": { "type": "array", "items": { "$ref": "GoogleChromeManagementV1PrinterReport" }, "description": "List of PrinterReports matching request." } }, "description": "Response containing a summary printing report for each printer from the specified organizational unit for the requested time interval." }, "GoogleChromeManagementV1StorageStatusReport": { "id": "GoogleChromeManagementV1StorageStatusReport", "properties": { "disk": { "description": "Output only. Reports on disk.", "type": "array", "items": { "$ref": "GoogleChromeManagementV1DiskInfo" }, "readOnly": true }, "reportTime": { "type": "string", "description": "Output only. Timestamp of when the sample was collected on device", "format": "google-datetime", "readOnly": true } }, "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_REPORT", "type": "object" }, "GoogleChromeManagementV1Device": { "description": "Describes a device reporting Chrome browser information.", "type": "object", "properties": { "machine": { "description": "Output only. The name of the machine within its local network.", "type": "string", "readOnly": true }, "deviceId": { "type": "string", "description": "Output only. The ID of the device that reported this Chrome browser information.", "readOnly": true } }, "id": "GoogleChromeManagementV1Device" }, "GoogleChromeManagementV1StorageInfo": { "type": "object", "id": "GoogleChromeManagementV1StorageInfo", "properties": { "volume": { "description": "Information for disk volumes", "type": "array", "items": { "$ref": "GoogleChromeManagementV1StorageInfoDiskVolume" } }, "totalDiskBytes": { "type": "string", "description": "The total space for user data storage in the device in bytes.", "format": "int64" }, "availableDiskBytes": { "format": "int64", "description": "The available space for user data storage in the device in bytes.", "type": "string" } }, "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" }, "GoogleChromeManagementV1CpuTemperatureInfo": { "type": "object", "id": "GoogleChromeManagementV1CpuTemperatureInfo", "properties": { "label": { "readOnly": true, "type": "string", "description": "Output only. CPU label. Example: Core 0" }, "temperatureCelsius": { "format": "int32", "description": "Output only. CPU temperature in Celsius.", "readOnly": true, "type": "integer" } }, "description": "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" }, "GoogleChromeManagementV1TelemetryNetworkSignalStrengthEvent": { "properties": { "guid": { "type": "string", "description": "Unique identifier of the network." }, "signalStrengthDbm": { "type": "integer", "format": "int32", "description": "Signal strength RSSI value." } }, "type": "object", "id": "GoogleChromeManagementV1TelemetryNetworkSignalStrengthEvent", "description": "`TelemetryNetworkSignalStrengthEvent` is triggered on WiFi signal strength events. * Granular permission needed: TELEMETRY_API_NETWORK_REPORT" }, "GoogleChromeManagementV1CountChromeVersionsResponse": { "id": "GoogleChromeManagementV1CountChromeVersionsResponse", "description": "Response containing requested browser versions details and counts.", "type": "object", "properties": { "browserVersions": { "description": "List of all browser versions and their install counts.", "type": "array", "items": { "$ref": "GoogleChromeManagementV1BrowserVersion" } }, "totalSize": { "type": "integer", "format": "int32", "description": "Total number browser versions matching request." }, "nextPageToken": { "description": "Token to specify the next page of the request.", "type": "string" } } }, "GoogleChromeManagementV1CountChromeCrashEventsResponse": { "id": "GoogleChromeManagementV1CountChromeCrashEventsResponse", "description": "Response contains a list of CrashEventCountByVersionPerDay which count the chrome crash at the certain date.", "properties": { "crashEventCounts": { "items": { "$ref": "GoogleChromeManagementV1CountChromeCrashEventsResponseCrashEventCount" }, "description": "Crash event counts grouped by date and browser version.", "type": "array" } }, "type": "object" }, "GoogleChromeManagementV1CountChromeCrashEventsResponseCrashEventCount": { "id": "GoogleChromeManagementV1CountChromeCrashEventsResponseCrashEventCount", "description": "The `count` of the Chrome crash events at the `date`.", "properties": { "count": { "description": "Total count of crash events.", "type": "string", "format": "int64" }, "date": { "$ref": "GoogleTypeDate", "description": "Date of the crash event." }, "browserVersion": { "type": "string", "description": "Browser version this is counting." } }, "type": "object" }, "GoogleChromeManagementV1GraphicsAdapterInfo": { "properties": { "driverVersion": { "description": "Output only. Version of the GPU driver.", "type": "string", "readOnly": true }, "adapter": { "type": "string", "description": "Output only. Adapter name. Example: Mesa DRI Intel(R) UHD Graphics 620 (Kabylake GT2).", "readOnly": true }, "deviceId": { "readOnly": true, "format": "int64", "description": "Output only. Represents the graphics card device id.", "type": "string" } }, "description": "Information of a graphics adapter (GPU).", "type": "object", "id": "GoogleChromeManagementV1GraphicsAdapterInfo" }, "GoogleChromeManagementV1AndroidAppPermission": { "id": "GoogleChromeManagementV1AndroidAppPermission", "type": "object", "properties": { "type": { "description": "Output only. The type of the permission.", "type": "string", "readOnly": true } }, "description": "Permission requested by an Android app." }, "GoogleChromeManagementV1UserPrintReport": { "description": "Report for CountPrintJobsByUser, contains printing statistics for a user. Contains the number of printers, the number of devices used to initiate print jobs, and the number of print jobs initiated.", "id": "GoogleChromeManagementV1UserPrintReport", "type": "object", "properties": { "userId": { "description": "The unique Directory API ID of the user.", "type": "string" }, "jobCount": { "description": "Number of print jobs initiated by the user.", "format": "int64", "type": "string" }, "userEmail": { "type": "string", "description": "The primary e-mail address of the user." }, "printerCount": { "format": "int64", "description": "Number of printers used by the user.", "type": "string" }, "deviceCount": { "description": "Number of chrome devices that have been used to initiate print jobs by the user.", "type": "string", "format": "int64" } } }, "GoogleChromeManagementV1PrinterReport": { "type": "object", "description": "Report for CountPrintJobsByPrinter, contains statistics on printer usage. Contains the total number of print jobs initiated with this printer, the number of users and the number of devices that have initiated at least one print job with this printer.", "id": "GoogleChromeManagementV1PrinterReport", "properties": { "userCount": { "description": "Number of users that have sent print jobs to the printer.", "format": "int64", "type": "string" }, "printerId": { "type": "string", "description": "Printer API ID." }, "deviceCount": { "description": "Number of chrome devices that have been used to send print jobs to the specified printer.", "format": "int64", "type": "string" }, "printer": { "description": "Printer name.", "type": "string" }, "printerModel": { "type": "string", "description": "Printer model." }, "jobCount": { "description": "Number of print jobs sent to the printer.", "type": "string", "format": "int64" } } }, "GoogleChromeManagementV1NetworkDiagnosticsReport": { "id": "GoogleChromeManagementV1NetworkDiagnosticsReport", "description": "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", "properties": { "reportTime": { "type": "string", "format": "google-datetime", "description": "Output only. Timestamp of when the diagnostics were collected.", "readOnly": true }, "httpsLatencyData": { "description": "Output only. HTTPS latency test data.", "readOnly": true, "$ref": "GoogleChromeManagementV1HttpsLatencyRoutineData" } }, "type": "object" }, "GoogleChromeManagementV1FindInstalledAppDevicesResponse": { "type": "object", "id": "GoogleChromeManagementV1FindInstalledAppDevicesResponse", "properties": { "totalSize": { "type": "integer", "description": "Total number of devices matching request.", "format": "int32" }, "nextPageToken": { "description": "Token to specify the next page of the request.", "type": "string" }, "devices": { "description": "A list of devices which have the app installed. Sorted in ascending alphabetical order on the Device.machine field.", "items": { "$ref": "GoogleChromeManagementV1Device" }, "type": "array" } }, "description": "Response containing a list of devices with queried app installed." }, "GoogleChromeManagementV1NetworkInfo": { "description": "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", "id": "GoogleChromeManagementV1NetworkInfo", "type": "object", "properties": { "networkDevices": { "items": { "$ref": "GoogleChromeManagementV1NetworkDevice" }, "description": "Output only. List of network devices.", "type": "array", "readOnly": true } } }, "GoogleChromeManagementV1TelemetryNotificationConfig": { "type": "object", "description": "Configuration to receive notifications of telemetry data.", "id": "GoogleChromeManagementV1TelemetryNotificationConfig", "properties": { "googleCloudPubsubTopic": { "description": "The pubsub topic to which notifications are published to.", "type": "string" }, "name": { "readOnly": true, "description": "Output only. Resource name of the notification configuration.", "type": "string" }, "customer": { "description": "Output only. Google Workspace customer that owns the resource.", "type": "string", "readOnly": true }, "filter": { "$ref": "GoogleChromeManagementV1TelemetryNotificationFilter", "description": "Only send notifications for telemetry data matching this filter." } } }, "GoogleChromeManagementV1TelemetryEvent": { "description": "Telemetry data reported by a managed device.", "type": "object", "id": "GoogleChromeManagementV1TelemetryEvent", "properties": { "wifiSignalStrengthEvent": { "readOnly": true, "description": "Output only. Payload for WiFi signal strength events. Present only when `event_type` is `WIFI_SIGNAL_STRENGTH_LOW` or `WIFI_SIGNAL_STRENGTH_RECOVERED`.", "$ref": "GoogleChromeManagementV1TelemetryNetworkSignalStrengthEvent" }, "device": { "readOnly": true, "$ref": "GoogleChromeManagementV1TelemetryDeviceInfo", "description": "Output only. Information about the device associated with the event." }, "usbPeripheralsEvent": { "$ref": "GoogleChromeManagementV1TelemetryUsbPeripheralsEvent", "readOnly": true, "description": "Output only. Payload for usb peripherals event. Present only when the `event_type` field is either `USB_ADDED` or `USB_REMOVED`." }, "eventType": { "type": "string", "enum": [ "EVENT_TYPE_UNSPECIFIED", "AUDIO_SEVERE_UNDERRUN", "NETWORK_STATE_CHANGE", "USB_ADDED", "USB_REMOVED", "NETWORK_HTTPS_LATENCY_CHANGE", "WIFI_SIGNAL_STRENGTH_LOW", "WIFI_SIGNAL_STRENGTH_RECOVERED", "VPN_CONNECTION_STATE_CHANGE" ], "enumDescriptions": [ "Event type unknown.", "Triggered when a audio devices run out of buffer data for more than 5 seconds.", "Triggered immediately on any changes to a network connection.", "Triggered when USB devices are added.", "Triggered when USB devices are removed.", "Triggered when a new HTTPS latency problem was detected or the device has recovered form an existing HTTPS latency problem.", "Triggered when connected WiFi network signal strength drops below -70dBm.", "Triggered when connected WiFi network signal strength is recovered from a signal drop.", "Triggered on changes to VPN connections." ], "description": "The event type of the current event." }, "httpsLatencyChangeEvent": { "readOnly": true, "description": "Output only. Payload for HTTPS latency change event. Present only when `event_type` is `NETWORK_HTTPS_LATENCY_CHANGE`.", "$ref": "GoogleChromeManagementV1TelemetryHttpsLatencyChangeEvent" }, "reportTime": { "format": "google-datetime", "description": "Timestamp that represents when the event was reported.", "type": "string" }, "networkStateChangeEvent": { "$ref": "GoogleChromeManagementV1TelemetryNetworkConnectionStateChangeEvent", "readOnly": true, "description": "Output only. Payload for network connection state change event. Present only when `event_type` is `NETWORK_STATE_CHANGE`." }, "vpnConnectionStateChangeEvent": { "readOnly": true, "description": "Output only. Payload for VPN connection state change event. Present only when `event_type` is `VPN_CONNECTION_STATE_CHANGE`.", "$ref": "GoogleChromeManagementV1TelemetryNetworkConnectionStateChangeEvent" }, "user": { "readOnly": true, "description": "Output only. Information about the user associated with the event.", "$ref": "GoogleChromeManagementV1TelemetryUserInfo" }, "audioSevereUnderrunEvent": { "readOnly": true, "$ref": "GoogleChromeManagementV1TelemetryAudioSevereUnderrunEvent", "description": "Output only. Payload for audio severe underrun event. Present only when the `event_type` field is `AUDIO_SEVERE_UNDERRUN`." }, "name": { "description": "Output only. Resource name of the event.", "type": "string", "readOnly": true } } }, "GoogleChromeManagementV1CountInstalledAppsResponse": { "description": "Response containing details of queried installed apps.", "id": "GoogleChromeManagementV1CountInstalledAppsResponse", "properties": { "totalSize": { "type": "integer", "format": "int32", "description": "Total number of installed apps matching request." }, "installedApps": { "type": "array", "items": { "$ref": "GoogleChromeManagementV1InstalledApp" }, "description": "List of installed apps matching request." }, "nextPageToken": { "type": "string", "description": "Token to specify the next page of the request." } }, "type": "object" }, "GoogleChromeManagementV1GraphicsStatusReport": { "type": "object", "description": "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", "properties": { "displays": { "items": { "$ref": "GoogleChromeManagementV1DisplayInfo" }, "readOnly": true, "type": "array", "description": "Output only. Information about the displays for the device." }, "reportTime": { "format": "google-datetime", "readOnly": true, "description": "Output only. Time at which the graphics data was reported.", "type": "string" } }, "id": "GoogleChromeManagementV1GraphicsStatusReport" }, "GoogleChromeManagementV1BatterySampleReport": { "description": "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", "properties": { "voltage": { "format": "int64", "type": "string", "description": "Output only. Battery voltage (millivolt).", "readOnly": true }, "current": { "format": "int64", "readOnly": true, "type": "string", "description": "Output only. Battery current (mA)." }, "temperature": { "description": "Output only. Temperature in Celsius degrees.", "format": "int32", "readOnly": true, "type": "integer" }, "reportTime": { "description": "Output only. Timestamp of when the sample was collected on device", "format": "google-datetime", "readOnly": true, "type": "string" }, "status": { "type": "string", "description": "Output only. Battery status read from sysfs. Example: Discharging", "readOnly": true }, "remainingCapacity": { "type": "string", "format": "int64", "description": "Output only. Battery remaining capacity (mAmpere-hours).", "readOnly": true }, "dischargeRate": { "description": "Output only. The battery discharge rate measured in mW. Positive if the battery is being discharged, negative if it's being charged.", "type": "integer", "readOnly": true, "format": "int32" }, "chargeRate": { "description": "Output only. Battery charge percentage.", "readOnly": true, "format": "int32", "type": "integer" } }, "type": "object", "id": "GoogleChromeManagementV1BatterySampleReport" }, "GoogleChromeManagementV1BrowserVersion": { "id": "GoogleChromeManagementV1BrowserVersion", "properties": { "channel": { "readOnly": true, "enumDescriptions": [ "No release channel specified.", "Canary release channel.", "Dev release channel.", "Beta release channel.", "Stable release channel." ], "type": "string", "description": "Output only. The release channel of the installed browser.", "enum": [ "RELEASE_CHANNEL_UNSPECIFIED", "CANARY", "DEV", "BETA", "STABLE" ] }, "count": { "readOnly": true, "description": "Output only. Count grouped by device_system and major version", "type": "string", "format": "int64" }, "version": { "description": "Output only. The full version of the installed browser.", "type": "string", "readOnly": true }, "system": { "readOnly": true, "enumDescriptions": [ "No operating system specified.", "Other operating system.", "Android operating system.", "Apple iOS operating system.", "ChromeOS operating system.", "Microsoft Windows operating system.", "Apple macOS operating system.", "Linux operating system." ], "description": "Output only. The device operating system.", "type": "string", "enum": [ "DEVICE_SYSTEM_UNSPECIFIED", "SYSTEM_OTHER", "SYSTEM_ANDROID", "SYSTEM_IOS", "SYSTEM_CROS", "SYSTEM_WINDOWS", "SYSTEM_MAC", "SYSTEM_LINUX" ] }, "deviceOsVersion": { "description": "Output only. Version of the system-specified operating system.", "readOnly": true, "type": "string" } }, "description": "Describes a browser version and its install count.", "type": "object" }, "GoogleChromeManagementV1CountChromeDevicesThatNeedAttentionResponse": { "id": "GoogleChromeManagementV1CountChromeDevicesThatNeedAttentionResponse", "type": "object", "description": "Response containing counts for devices that need attention.", "properties": { "noRecentPolicySyncCount": { "description": "Number of ChromeOS devices have not synced policies in the past 28 days.", "format": "int64", "type": "string" }, "noRecentUserActivityCount": { "description": "Number of ChromeOS devices that have not seen any user activity in the past 28 days.", "format": "int64", "type": "string" }, "osVersionNotCompliantCount": { "description": "Number of devices whose OS version is not compliant.", "format": "int64", "type": "string" }, "unsupportedPolicyCount": { "type": "string", "format": "int64", "description": "Number of devices that are unable to apply a policy due to an OS version mismatch." }, "pendingUpdate": { "description": "Number of devices that are pending an OS update.", "format": "int64", "type": "string" } } }, "GoogleChromeManagementV1DisplayInfo": { "properties": { "resolutionWidth": { "readOnly": true, "format": "int32", "description": "Output only. Resolution width in pixels.", "type": "integer" }, "isInternal": { "readOnly": true, "type": "boolean", "description": "Output only. Indicates if display is internal or not." }, "refreshRate": { "format": "int32", "readOnly": true, "description": "Output only. Refresh rate in Hz.", "type": "integer" }, "resolutionHeight": { "readOnly": true, "type": "integer", "description": "Output only. Resolution height in pixels.", "format": "int32" }, "deviceId": { "description": "Output only. Represents the graphics card device id.", "readOnly": true, "format": "int64", "type": "string" }, "displayName": { "description": "Output only. Display device name.", "type": "string", "readOnly": true } }, "type": "object", "id": "GoogleChromeManagementV1DisplayInfo", "description": "Information for a display." }, "GoogleChromeManagementV1CountPrintJobsByUserResponse": { "description": "Response containing a summary printing report for each user that has initiated a print job with a printer from the specified organizational unit during the requested time interval.", "properties": { "totalSize": { "format": "int64", "description": "Total number of users matching request.", "type": "string" }, "nextPageToken": { "type": "string", "description": "Pagination token for requesting the next page." }, "userPrintReports": { "description": "List of UserPrintReports matching request.", "items": { "$ref": "GoogleChromeManagementV1UserPrintReport" }, "type": "array" } }, "id": "GoogleChromeManagementV1CountPrintJobsByUserResponse", "type": "object" }, "GoogleChromeManagementV1TouchScreenDevice": { "id": "GoogleChromeManagementV1TouchScreenDevice", "description": "Information of an internal touch screen device.", "type": "object", "properties": { "displayName": { "readOnly": true, "type": "string", "description": "Output only. Touch screen device display name." }, "stylusCapable": { "readOnly": true, "type": "boolean", "description": "Output only. Touch screen device is stylus capable or not." }, "touchPointCount": { "readOnly": true, "type": "integer", "description": "Output only. Number of touch points supported on the device.", "format": "int32" } } }, "GoogleChromeManagementV1CpuStatusReport": { "description": "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", "id": "GoogleChromeManagementV1CpuStatusReport", "type": "object", "properties": { "cpuTemperatureInfo": { "type": "array", "readOnly": true, "description": "Output only. CPU temperature sample info per CPU core in Celsius", "items": { "$ref": "GoogleChromeManagementV1CpuTemperatureInfo" } }, "reportTime": { "readOnly": true, "format": "google-datetime", "type": "string", "description": "Output only. The timestamp in milliseconds representing time at which this report was sampled." }, "cpuUtilizationPct": { "format": "int32", "description": "Output only. Sample of CPU utilization (0-100 percent).", "readOnly": true, "type": "integer" }, "sampleFrequency": { "format": "google-duration", "description": "Output only. Frequency the report is sampled.", "readOnly": true, "type": "string" } } }, "GoogleChromeManagementV1TelemetryUser": { "id": "GoogleChromeManagementV1TelemetryUser", "description": "Telemetry data collected from a managed user. * Granular permission needed: TELEMETRY_API_USER", "type": "object", "properties": { "customer": { "type": "string", "description": "G Suite Customer whose enterprise enrolled the device." }, "userId": { "description": "Directory ID of the user.", "type": "string" }, "name": { "description": "Resource name of the user.", "type": "string" }, "userEmail": { "description": "Email address of the user.", "type": "string" }, "orgUnitId": { "type": "string", "description": "Organization unit of the user." }, "userDevice": { "items": { "$ref": "GoogleChromeManagementV1TelemetryUserDevice" }, "type": "array", "description": "Telemetry data collected from a managed user and device." } } }, "GoogleChromeManagementV1PeripheralsReport": { "properties": { "usbPeripheralReport": { "items": { "$ref": "GoogleChromeManagementV1UsbPeripheralReport" }, "description": "Reports of all usb connected devices.", "type": "array" }, "reportTime": { "description": "Output only. Timestamp of when the report was collected.", "format": "google-datetime", "type": "string", "readOnly": true } }, "id": "GoogleChromeManagementV1PeripheralsReport", "description": "Peripherals report. * Granular permission needed: TELEMETRY_API_PERIPHERALS_REPORT", "type": "object" }, "GoogleChromeManagementV1ListTelemetryEventsResponse": { "description": "Response message for listing telemetry events for a customer.", "type": "object", "properties": { "telemetryEvents": { "items": { "$ref": "GoogleChromeManagementV1TelemetryEvent" }, "description": "Telemetry events returned in the response.", "type": "array" }, "nextPageToken": { "type": "string", "description": "Token to specify next page in the list." } }, "id": "GoogleChromeManagementV1ListTelemetryEventsResponse" }, "GoogleChromeManagementV1StorageInfoDiskVolume": { "description": "Information for disk volumes", "id": "GoogleChromeManagementV1StorageInfoDiskVolume", "type": "object", "properties": { "storageFreeBytes": { "description": "Free storage space in bytes.", "format": "int64", "type": "string" }, "volumeId": { "type": "string", "description": "Disk volume id." }, "storageTotalBytes": { "description": "Total storage space in bytes.", "format": "int64", "type": "string" } } }, "GoogleChromeManagementV1OsUpdateStatus": { "type": "object", "id": "GoogleChromeManagementV1OsUpdateStatus", "description": "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", "properties": { "lastUpdateCheckTime": { "format": "google-datetime", "type": "string", "description": "Output only. Timestamp of the last update check.", "readOnly": true }, "updateState": { "readOnly": true, "enumDescriptions": [ "State unspecified.", "OS has not started downloading.", "OS has started download on device.", "Device needs reboot to finish upload." ], "type": "string", "description": "Output only. Current state of the os update.", "enum": [ "UPDATE_STATE_UNSPECIFIED", "OS_IMAGE_DOWNLOAD_NOT_STARTED", "OS_IMAGE_DOWNLOAD_IN_PROGRESS", "OS_UPDATE_NEED_REBOOT" ] }, "newRequestedPlatformVersion": { "readOnly": true, "description": "Output only. New requested platform version from the pending updated kiosk app.", "type": "string" }, "newPlatformVersion": { "type": "string", "description": "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.", "readOnly": true }, "lastRebootTime": { "type": "string", "readOnly": true, "description": "Output only. Timestamp of the last reboot.", "format": "google-datetime" }, "lastUpdateTime": { "readOnly": true, "format": "google-datetime", "description": "Output only. Timestamp of the last successful update.", "type": "string" } } }, "GoogleChromeManagementV1DiskInfo": { "description": "Status of the single storage device.", "properties": { "writeTimeThisSession": { "readOnly": true, "format": "google-duration", "type": "string", "description": "Output only. Time spent writing to disk since last boot." }, "health": { "description": "Output only. Disk health.", "type": "string", "readOnly": true }, "readTimeThisSession": { "format": "google-duration", "description": "Output only. Time spent reading from disk since last boot.", "readOnly": true, "type": "string" }, "bytesWrittenThisSession": { "readOnly": true, "description": "Output only. Number of bytes written since last boot.", "type": "string", "format": "int64" }, "bytesReadThisSession": { "type": "string", "description": "Output only. Number of bytes read since last boot.", "readOnly": true, "format": "int64" }, "model": { "description": "Output only. Disk model.", "type": "string", "readOnly": true }, "type": { "type": "string", "description": "Output only. Disk type: eMMC / NVMe / ATA / SCSI.", "readOnly": true }, "serialNumber": { "type": "string", "description": "Output only. Disk serial number.", "readOnly": true }, "sizeBytes": { "format": "int64", "description": "Output only. Disk size.", "readOnly": true, "type": "string" }, "volumeIds": { "readOnly": true, "description": "Output only. Disk volumes.", "type": "array", "items": { "type": "string" } }, "manufacturer": { "type": "string", "description": "Output only. Disk manufacturer.", "readOnly": true }, "discardTimeThisSession": { "readOnly": true, "type": "string", "description": "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+.", "format": "google-duration" }, "ioTimeThisSession": { "type": "string", "format": "google-duration", "description": "Output only. Counts the time the disk and queue were busy, so unlike the fields above, parallel requests are not counted multiple times.", "readOnly": true } }, "id": "GoogleChromeManagementV1DiskInfo", "type": "object" }, "GoogleChromeManagementV1TelemetryUserInfo": { "description": "Information about a user associated with telemetry data. * Granular permission needed: TELEMETRY_API_USER", "type": "object", "id": "GoogleChromeManagementV1TelemetryUserInfo", "properties": { "email": { "readOnly": true, "type": "string", "description": "Output only. User's email." }, "orgUnitId": { "type": "string", "readOnly": true, "description": "Output only. Organization unit ID of the user." } } }, "GoogleChromeManagementV1TelemetryHttpsLatencyChangeEvent": { "id": "GoogleChromeManagementV1TelemetryHttpsLatencyChangeEvent", "description": "Https latency routine is run periodically and `TelemetryHttpsLatencyChangeEvent` is triggered if a latency problem was detected or if the device has recovered from a latency problem. * Granular permission needed: TELEMETRY_API_NETWORK_REPORT", "properties": { "httpsLatencyRoutineData": { "description": "HTTPS latency routine data that triggered the event.", "$ref": "GoogleChromeManagementV1HttpsLatencyRoutineData" }, "httpsLatencyState": { "type": "string", "description": "Current HTTPS latency state.", "enum": [ "HTTPS_LATENCY_STATE_UNSPECIFIED", "RECOVERY", "PROBLEM" ], "enumDescriptions": [ "HTTPS latency state is unspecified.", "HTTPS latency recovered from a problem.", "HTTPS latency problem." ] } }, "type": "object" }, "GoogleChromeManagementV1ListTelemetryDevicesResponse": { "type": "object", "properties": { "nextPageToken": { "description": "Token to specify next page in the list.", "type": "string" }, "devices": { "description": "Telemetry devices returned in the response.", "items": { "$ref": "GoogleChromeManagementV1TelemetryDevice" }, "type": "array" } }, "id": "GoogleChromeManagementV1ListTelemetryDevicesResponse" }, "GoogleChromeManagementV1BatteryInfo": { "properties": { "technology": { "readOnly": true, "description": "Output only. Technology of the battery. Example: Li-ion", "type": "string" }, "manufacturer": { "type": "string", "readOnly": true, "description": "Output only. Battery manufacturer." }, "serialNumber": { "type": "string", "description": "Output only. Battery serial number.", "readOnly": true }, "designCapacity": { "description": "Output only. Design capacity (mAmpere-hours).", "type": "string", "readOnly": true, "format": "int64" }, "manufactureDate": { "$ref": "GoogleTypeDate", "readOnly": true, "description": "Output only. The date the battery was manufactured." }, "designMinVoltage": { "type": "integer", "readOnly": true, "format": "int32", "description": "Output only. Designed minimum output voltage (mV)" } }, "type": "object", "description": "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", "id": "GoogleChromeManagementV1BatteryInfo" }, "GoogleChromeManagementV1TelemetryAudioSevereUnderrunEvent": { "type": "object", "id": "GoogleChromeManagementV1TelemetryAudioSevereUnderrunEvent", "properties": {}, "description": "`TelemetryAudioSevereUnderrunEvent` is triggered when a audio devices run out of buffer data for more than 5 seconds. * Granular permission needed: TELEMETRY_API_AUDIO_REPORT" }, "GoogleChromeManagementV1DisplayDevice": { "description": "Information of a display device.", "properties": { "manufactureYear": { "description": "Output only. Year of manufacture.", "type": "integer", "format": "int32", "readOnly": true }, "displayName": { "description": "Output only. Display device name.", "type": "string", "readOnly": true }, "displayHeightMm": { "format": "int32", "readOnly": true, "description": "Output only. Display height in millimeters.", "type": "integer" }, "manufacturerId": { "type": "string", "readOnly": true, "description": "Output only. Three letter manufacturer ID." }, "internal": { "readOnly": true, "description": "Output only. Is display internal or not.", "type": "boolean" }, "modelId": { "description": "Output only. Manufacturer product code.", "type": "integer", "readOnly": true, "format": "int32" }, "displayWidthMm": { "type": "integer", "readOnly": true, "format": "int32", "description": "Output only. Display width in millimeters." } }, "id": "GoogleChromeManagementV1DisplayDevice", "type": "object" }, "GoogleChromeManagementV1UserRequestingExtensionDetails": { "id": "GoogleChromeManagementV1UserRequestingExtensionDetails", "type": "object", "description": "Details of a user requesting an extension, including the email and the justification.", "properties": { "email": { "description": "The e-mail address of a user that has requested the extension.", "type": "string" }, "justification": { "type": "string", "description": "Request justification as entered by the user." } } }, "GoogleChromeManagementV1DeviceHardwareCountReport": { "properties": { "bucket": { "type": "string", "description": "Public name of the hardware specification." }, "count": { "format": "int64", "type": "string", "description": "Count of devices with a unique hardware specification." } }, "type": "object", "id": "GoogleChromeManagementV1DeviceHardwareCountReport", "description": "Report for CountChromeDevicesPerHardwareSpecResponse, contains the count of devices with a unique hardware specification." }, "GoogleChromeManagementV1EnumeratePrintJobsResponse": { "type": "object", "description": "Response containing a list of print jobs.", "id": "GoogleChromeManagementV1EnumeratePrintJobsResponse", "properties": { "nextPageToken": { "type": "string", "description": "A token, which can be used in a subsequent request to retrieve the next page. If this field is omitted, there are no subsequent pages." }, "printJobs": { "type": "array", "description": "List of requested print jobs.", "items": { "$ref": "GoogleChromeManagementV1PrintJob" } }, "totalSize": { "description": "Total number of print jobs matching request.", "format": "int64", "type": "string" } } }, "GoogleChromeManagementV1DeviceRequestingExtensionDetails": { "id": "GoogleChromeManagementV1DeviceRequestingExtensionDetails", "description": "Details of a device requesting an extension, including the name of the device and the justification of the request.", "properties": { "justification": { "type": "string", "description": "Request justification as entered by the user." }, "deviceName": { "type": "string", "description": "The name of a device that has requested the extension." } }, "type": "object" }, "GoogleChromeManagementV1ChromeAppInfo": { "id": "GoogleChromeManagementV1ChromeAppInfo", "properties": { "isTheme": { "readOnly": true, "type": "boolean", "description": "Output only. Whether the app or extension is a theme." }, "minUserCount": { "type": "integer", "format": "int32", "readOnly": true, "description": "Output only. The minimum number of users using this app." }, "supportEnabled": { "readOnly": true, "description": "Output only. The app developer has enabled support for their app. Version-specific field that will only be set when the requested app version is found.", "type": "boolean" }, "googleOwned": { "type": "boolean", "readOnly": true, "description": "Output only. Whether the app or extension is built and maintained by Google. Version-specific field that will only be set when the requested app version is found." }, "isExtensionPolicySupported": { "readOnly": true, "description": "Output only. Whether an app supports policy for extensions.", "type": "boolean" }, "type": { "enum": [ "ITEM_TYPE_UNSPECIFIED", "EXTENSION", "OTHERS" ], "enumDescriptions": [ "Unspecified ItemType.", "Chrome Extensions.", "Any other type than extension." ], "type": "string", "description": "Output only. Types of an item in the Chrome Web Store", "readOnly": true }, "isCwsHosted": { "description": "Output only. Whether the app or extension is in a published state in the Chrome Web Store.", "readOnly": true, "type": "boolean" }, "kioskEnabled": { "type": "boolean", "description": "Output only. Whether this app is enabled for Kiosk mode on ChromeOS devices", "readOnly": true }, "isKioskOnly": { "type": "boolean", "description": "Output only. Whether the app is only for Kiosk mode on ChromeOS devices", "readOnly": true }, "permissions": { "items": { "$ref": "GoogleChromeManagementV1ChromeAppPermission" }, "readOnly": true, "type": "array", "description": "Output only. Every custom permission requested by the app. Version-specific field that will only be set when the requested app version is found." }, "siteAccess": { "items": { "$ref": "GoogleChromeManagementV1ChromeAppSiteAccess" }, "type": "array", "description": "Output only. Every permission giving access to domains or broad host patterns. ( e.g. www.google.com). This includes the matches from content scripts as well as hosts in the permissions node of the manifest. Version-specific field that will only be set when the requested app version is found.", "readOnly": true } }, "type": "object", "description": "Chrome Web Store app information." }, "GoogleChromeManagementV1HeartbeatStatusReport": { "properties": { "state": { "enum": [ "STATE_UNSPECIFIED", "UNKNOWN", "ONLINE", "OFFLINE" ], "description": "State the device changed to", "enumDescriptions": [ "State not specified", "Device is not eligible for heartbeat monitoring", "Device is online", "Device is offline" ], "type": "string" }, "reportTime": { "format": "google-datetime", "type": "string", "description": "Timestamp of when status changed was detected" } }, "type": "object", "description": "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 -\u003e 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", "id": "GoogleChromeManagementV1HeartbeatStatusReport" }, "GoogleChromeManagementV1MemoryStatusReport": { "description": "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", "properties": { "systemRamFreeBytes": { "type": "string", "format": "int64", "description": "Output only. Amount of free RAM in bytes (unreliable due to Garbage Collection).", "readOnly": true }, "reportTime": { "description": "Output only. The timestamp in milliseconds representing time at which this report was sampled.", "format": "google-datetime", "readOnly": true, "type": "string" }, "sampleFrequency": { "readOnly": true, "format": "google-duration", "description": "Output only. Frequency the report is sampled.", "type": "string" }, "pageFaults": { "format": "int32", "description": "Output only. Number of page faults during this collection", "type": "integer", "readOnly": true } }, "id": "GoogleChromeManagementV1MemoryStatusReport", "type": "object" }, "GoogleChromeManagementV1DeviceActivityReport": { "properties": { "deviceActivityState": { "enum": [ "DEVICE_ACTIVITY_STATE_UNSPECIFIED", "ACTIVE", "IDLE", "LOCKED" ], "enumDescriptions": [ "Device activity state is unspecified.", "Device is currently being used.", "Device is currently idle.", "Device is currently locked." ], "type": "string", "readOnly": true, "description": "Output only. Device activity state." }, "reportTime": { "type": "string", "format": "google-datetime", "readOnly": true, "description": "Output only. Timestamp of when the report was collected." } }, "description": "Device activity report. * Granular permission needed: TELEMETRY_API_DEVICE_ACTIVITY_REPORT", "id": "GoogleChromeManagementV1DeviceActivityReport", "type": "object" }, "GoogleChromeManagementV1ChromeAppSiteAccess": { "description": "Represent one host permission.", "type": "object", "id": "GoogleChromeManagementV1ChromeAppSiteAccess", "properties": { "hostMatch": { "type": "string", "description": "Output only. This can contain very specific hosts, or patterns like \"*.com\" for instance.", "readOnly": true } } }, "GoogleChromeManagementV1KioskAppStatusReport": { "description": "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", "id": "GoogleChromeManagementV1KioskAppStatusReport", "type": "object", "properties": { "appVersion": { "type": "string", "description": "App version number of kiosk app for example \"1.10.118\"" }, "appId": { "description": "App id of kiosk app for example \"mdmkkicfmmkgmpkmkdikhlbggogpicma\"", "type": "string" }, "reportTime": { "type": "string", "format": "google-datetime", "description": "Timestamp of when report was collected" } } }, "GoogleChromeManagementV1AndroidAppInfo": { "properties": { "permissions": { "type": "array", "readOnly": true, "items": { "$ref": "GoogleChromeManagementV1AndroidAppPermission" }, "description": "Output only. Permissions requested by an Android app." } }, "type": "object", "description": "Android app information.", "id": "GoogleChromeManagementV1AndroidAppInfo" }, "GoogleChromeManagementV1CountChromeBrowsersNeedingAttentionResponse": { "type": "object", "id": "GoogleChromeManagementV1CountChromeBrowsersNeedingAttentionResponse", "properties": { "pendingBrowserUpdateCount": { "description": "Number of browsers that are pending an OS update", "type": "string", "format": "int64" }, "recentlyEnrolledCount": { "format": "int64", "type": "string", "description": "Number of browsers that have been recently enrolled" }, "noRecentActivityCount": { "description": "Number of browsers that haven’t had any recent activity", "format": "int64", "type": "string" } }, "description": "Response containing counts for browsers that need attention." }, "GoogleChromeManagementV1AudioStatusReport": { "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: [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", "id": "GoogleChromeManagementV1AudioStatusReport", "type": "object", "properties": { "outputVolume": { "readOnly": true, "type": "integer", "format": "int32", "description": "Output only. Active output device's volume in [0, 100]." }, "inputGain": { "type": "integer", "description": "Output only. Active input device's gain in [0, 100].", "format": "int32", "readOnly": true }, "outputDevice": { "readOnly": true, "description": "Output only. Active output device's name.", "type": "string" }, "inputDevice": { "description": "Output only. Active input device's name.", "readOnly": true, "type": "string" }, "inputMute": { "description": "Output only. Is active input device mute or not.", "type": "boolean", "readOnly": true }, "outputMute": { "description": "Output only. Is active output device mute or not.", "readOnly": true, "type": "boolean" }, "reportTime": { "format": "google-datetime", "description": "Output only. Timestamp of when the sample was collected on device.", "type": "string", "readOnly": true } } }, "GoogleRpcStatus": { "properties": { "details": { "type": "array", "items": { "additionalProperties": { "type": "any", "description": "Properties of the object. Contains field @type with type URL." }, "type": "object" }, "description": "A list of messages that carry the error details. There is a common set of message types for APIs to use." }, "message": { "description": "A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.", "type": "string" }, "code": { "description": "The status code, which should be an enum value of google.rpc.Code.", "format": "int32", "type": "integer" } }, "type": "object", "description": "The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors).", "id": "GoogleRpcStatus" }, "GoogleChromeManagementV1NetworkStatusReport": { "properties": { "reportTime": { "format": "google-datetime", "description": "Output only. Time at which the network state was reported.", "type": "string", "readOnly": true }, "connectionType": { "enumDescriptions": [ "Network connection type unspecified", "Cellular network connection.", "Ethernet network connection.", "Tether network connection.", "VPN network connection.", "Wifi network connection." ], "enum": [ "NETWORK_TYPE_UNSPECIFIED", "CELLULAR", "ETHERNET", "TETHER", "VPN", "WIFI" ], "type": "string", "readOnly": true, "description": "Output only. Network connection type." }, "lanIpAddress": { "readOnly": true, "description": "Output only. LAN IP address.", "type": "string" }, "guid": { "readOnly": true, "description": "Output only. Network connection guid.", "type": "string" }, "wifiPowerManagementEnabled": { "readOnly": true, "type": "boolean", "description": "Output only. Wifi power management enabled" }, "signalStrengthDbm": { "description": "Output only. Signal strength for wireless networks measured in decibels.", "format": "int32", "type": "integer", "readOnly": true }, "connectionState": { "readOnly": true, "type": "string", "description": "Output only. Current connection state of the network.", "enumDescriptions": [ "Network connection state unspecified.", "The network is connected and internet connectivity is available.", "The network is connected and not in a detected portal state, but internet connectivity may not be available.", "The network is connected but a portal state was detected. Internet connectivity may be limited.", "The network is in the process of connecting.", "The network is not connected." ], "enum": [ "NETWORK_CONNECTION_STATE_UNSPECIFIED", "ONLINE", "CONNECTED", "PORTAL", "CONNECTING", "NOT_CONNECTED" ] }, "wifiLinkQuality": { "type": "string", "description": "Output only. Wifi link quality. Value ranges from [0, 70]. 0 indicates no signal and 70 indicates a strong signal.", "format": "int64", "readOnly": true }, "transmissionBitRateMbps": { "type": "string", "readOnly": true, "description": "Output only. Transmission bit rate measured in Megabits per second.", "format": "int64" }, "gatewayIpAddress": { "readOnly": true, "type": "string", "description": "Output only. Gateway IP address." }, "encryptionOn": { "description": "Output only. Whether the wifi encryption key is turned off.", "readOnly": true, "type": "boolean" }, "receivingBitRateMbps": { "description": "Output only. Receiving bit rate measured in Megabits per second.", "format": "int64", "readOnly": true, "type": "string" }, "sampleFrequency": { "type": "string", "description": "Output only. Frequency the report is sampled.", "format": "google-duration", "readOnly": true }, "transmissionPowerDbm": { "type": "integer", "description": "Output only. Transmission power measured in decibels.", "format": "int32", "readOnly": true } }, "description": "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", "type": "object", "id": "GoogleChromeManagementV1NetworkStatusReport" }, "GoogleChromeManagementV1BootPerformanceReport": { "type": "object", "id": "GoogleChromeManagementV1BootPerformanceReport", "description": "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", "properties": { "bootUpDuration": { "format": "google-duration", "description": "Total time to boot up.", "type": "string" }, "shutdownTime": { "type": "string", "description": "The timestamp when shutdown.", "format": "google-datetime" }, "reportTime": { "format": "google-datetime", "description": "Timestamp when the report was collected.", "type": "string" }, "shutdownReason": { "type": "string", "enum": [ "SHUTDOWN_REASON_UNSPECIFIED", "USER_REQUEST", "SYSTEM_UPDATE", "LOW_BATTERY", "OTHER" ], "enumDescriptions": [ "Shutdown reason is not specified.", "User initiated.", "System update initiated.", "Shutdown due to low battery.", "Shutdown due to other reasons." ], "description": "The shutdown reason." }, "shutdownDuration": { "format": "google-duration", "type": "string", "description": "Total time since shutdown start to power off." }, "bootUpTime": { "format": "google-datetime", "type": "string", "description": "The timestamp when power came on." } } }, "GoogleChromeManagementV1TelemetryDeviceInfo": { "properties": { "deviceId": { "readOnly": true, "description": "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.", "type": "string" }, "orgUnitId": { "description": "Output only. Organization unit ID of the device.", "readOnly": true, "type": "string" } }, "type": "object", "id": "GoogleChromeManagementV1TelemetryDeviceInfo", "description": "Information about a device associated with telemetry data. * Granular Permission needed: TELEMETRY_API_DEVICE" }, "GoogleChromeManagementV1CountChromeHardwareFleetDevicesResponse": { "id": "GoogleChromeManagementV1CountChromeHardwareFleetDevicesResponse", "type": "object", "description": "Response containing a list of devices with a specific type of hardware specification from the requested hardware type.", "properties": { "memoryReports": { "description": "The DeviceHardwareCountReport for device memory amount in gigabytes (for example 16).", "items": { "$ref": "GoogleChromeManagementV1DeviceHardwareCountReport" }, "type": "array" }, "modelReports": { "items": { "$ref": "GoogleChromeManagementV1DeviceHardwareCountReport" }, "type": "array", "description": "The DeviceHardwareCountReport for device model type (for example Acer C7 Chromebook)." }, "storageReports": { "description": "The DeviceHardwareCountReport for device storage amount in gigabytes (for example 128).", "items": { "$ref": "GoogleChromeManagementV1DeviceHardwareCountReport" }, "type": "array" }, "cpuReports": { "type": "array", "description": "The DeviceHardwareCountReport for device cpu type (for example Intel(R) Core(TM) i7-10610U CPU @ 1.80GHz).", "items": { "$ref": "GoogleChromeManagementV1DeviceHardwareCountReport" } } } }, "GoogleChromeManagementV1FetchUsersRequestingExtensionResponse": { "description": "Response containing a list of users that have requested the queried extension.", "type": "object", "id": "GoogleChromeManagementV1FetchUsersRequestingExtensionResponse", "properties": { "nextPageToken": { "description": "Token to specify the next page in the list.", "type": "string" }, "totalSize": { "type": "integer", "description": "Total number of users in response.", "format": "int32" }, "userDetails": { "description": "Details of users that have requested the queried extension.", "items": { "$ref": "GoogleChromeManagementV1UserRequestingExtensionDetails" }, "type": "array" } } }, "GoogleChromeManagementV1TouchScreenInfo": { "properties": { "devices": { "items": { "$ref": "GoogleChromeManagementV1TouchScreenDevice" }, "readOnly": true, "description": "Output only. List of the internal touch screen devices.", "type": "array" }, "touchpadLibrary": { "readOnly": true, "type": "string", "description": "Output only. Touchpad library name used by the input stack." } }, "description": "Information on the device touch screen.", "type": "object", "id": "GoogleChromeManagementV1TouchScreenInfo" }, "GoogleChromeManagementV1RuntimeCountersReport": { "id": "GoogleChromeManagementV1RuntimeCountersReport", "properties": { "enterPoweroffCount": { "type": "string", "format": "int64", "description": "Number of times that the device has entered into the power-off state. Currently obtained via the PSR, count from S0-\u003eS5." }, "uptimeRuntimeDuration": { "type": "string", "description": "Total lifetime runtime. Currently always S0 runtime from Intel vPro PSR.", "format": "google-duration" }, "enterHibernationCount": { "type": "string", "description": "Number of times that the device has entered into the hibernation state. Currently obtained via the PSR, count from S0-\u003eS4.", "format": "int64" }, "enterSleepCount": { "type": "string", "description": "Number of times that the device has entered into the sleep state. Currently obtained via the PSR, count from S0-\u003eS3.", "format": "int64" }, "reportTime": { "description": "Timestamp when the report was collected.", "format": "google-datetime", "type": "string" } }, "description": "Runtime counters retrieved from CPU. Currently the runtime counters telemetry is only supported by Intel vPro PSR on Gen 14+.", "type": "object" }, "GoogleChromeManagementV1UsbPeripheralReport": { "id": "GoogleChromeManagementV1UsbPeripheralReport", "type": "object", "properties": { "name": { "description": "Output only. Device name, model name, or product name", "type": "string", "readOnly": true }, "subclassId": { "readOnly": true, "type": "integer", "format": "int32", "description": "Output only. Subclass ID https://www.usb.org/defined-class-codes" }, "firmwareVersion": { "description": "Output only. Firmware version", "readOnly": true, "type": "string" }, "pid": { "type": "integer", "description": "Output only. Product ID", "format": "int32", "readOnly": true }, "vendor": { "readOnly": true, "description": "Output only. Vendor name", "type": "string" }, "categories": { "readOnly": true, "items": { "type": "string" }, "type": "array", "description": "Output only. Categories the device belongs to https://www.usb.org/defined-class-codes" }, "vid": { "description": "Output only. Vendor ID", "format": "int32", "type": "integer", "readOnly": true }, "classId": { "readOnly": true, "format": "int32", "type": "integer", "description": "Output only. Class ID https://www.usb.org/defined-class-codes" } }, "description": "USB connected peripheral report." }, "GoogleChromeManagementV1PrintJob": { "type": "object", "id": "GoogleChromeManagementV1PrintJob", "properties": { "duplexMode": { "type": "string", "enum": [ "DUPLEX_MODE_UNSPECIFIED", "ONE_SIDED", "TWO_SIDED_LONG_EDGE", "TWO_SIDED_SHORT_EDGE" ], "description": "Duplex mode.", "enumDescriptions": [ "Unspecified.", "One-sided.", "Two-sided flipping over long edge.", "Two-sided flipping over short edge." ] }, "createTime": { "format": "google-datetime", "description": "Print job creation timestamp.", "type": "string" }, "state": { "type": "string", "description": "The final state of the job.", "enum": [ "STATE_UNSPECIFIED", "PRINTED", "CANCELLED", "FAILED" ], "enumDescriptions": [ "Print job is in an unspecified state.", "The document was successfully printed.", "Print job was cancelled.", "Print job failed." ] }, "title": { "type": "string", "description": "The title of the document." }, "printerId": { "type": "string", "description": "API ID of the printer used for printing." }, "documentPageCount": { "description": "Number of pages in the document.", "format": "int32", "type": "integer" }, "copyCount": { "type": "integer", "description": "Number of copies.", "format": "int32" }, "id": { "type": "string", "description": "Unique ID of the print job." }, "completeTime": { "description": "Print job completion timestamp.", "format": "google-datetime", "type": "string" }, "colorMode": { "enum": [ "COLOR_MODE_UNSPECIFIED", "BLACK_AND_WHITE", "COLOR" ], "description": "Color mode.", "enumDescriptions": [ "Unspecified.", "Black and white.", "Color." ], "type": "string" }, "printer": { "description": "Name of the printer used for printing.", "type": "string" }, "userEmail": { "type": "string", "description": "The primary e-mail address of the user who submitted the print job." }, "userId": { "description": "The unique Directory API ID of the user who submitted the print job.", "type": "string" } }, "description": "Represents a request to print a document that has been submitted to a printer." }, "GoogleChromeManagementV1TelemetryDevice": { "id": "GoogleChromeManagementV1TelemetryDevice", "type": "object", "description": "Telemetry data collected from a managed device. * Granular permission needed: TELEMETRY_API_DEVICE", "properties": { "graphicsStatusReport": { "readOnly": true, "type": "array", "description": "Output only. Graphics reports collected periodically.", "items": { "$ref": "GoogleChromeManagementV1GraphicsStatusReport" } }, "name": { "type": "string", "readOnly": true, "description": "Output only. Resource name of the device." }, "heartbeatStatusReport": { "items": { "$ref": "GoogleChromeManagementV1HeartbeatStatusReport" }, "type": "array", "description": "Output only. Heartbeat status report containing timestamps periodically sorted in decreasing order of report_time", "readOnly": true }, "serialNumber": { "description": "Output only. Device serial number. This value is the same as the Admin Console's Serial Number in the ChromeOS Devices tab.", "type": "string", "readOnly": true }, "batteryStatusReport": { "readOnly": true, "type": "array", "description": "Output only. Battery reports collected periodically.", "items": { "$ref": "GoogleChromeManagementV1BatteryStatusReport" } }, "networkBandwidthReport": { "items": { "$ref": "GoogleChromeManagementV1NetworkBandwidthReport" }, "type": "array", "readOnly": true, "description": "Output only. Network bandwidth reports collected periodically sorted in a decreasing order of report_time." }, "networkDiagnosticsReport": { "items": { "$ref": "GoogleChromeManagementV1NetworkDiagnosticsReport" }, "type": "array", "description": "Output only. Network diagnostics collected periodically.", "readOnly": true }, "customer": { "description": "Output only. Google Workspace Customer whose enterprise enrolled the device.", "type": "string", "readOnly": true }, "graphicsInfo": { "$ref": "GoogleChromeManagementV1GraphicsInfo", "description": "Output only. Contains information regarding Graphic peripherals for the device.", "readOnly": true }, "cpuInfo": { "readOnly": true, "items": { "$ref": "GoogleChromeManagementV1CpuInfo" }, "type": "array", "description": "Output only. Information regarding CPU specs for the device." }, "deviceId": { "type": "string", "description": "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", "readOnly": true }, "orgUnitId": { "type": "string", "description": "Output only. Organization unit ID of the device.", "readOnly": true }, "batteryInfo": { "readOnly": true, "items": { "$ref": "GoogleChromeManagementV1BatteryInfo" }, "description": "Output only. Information on battery specs for the device.", "type": "array" }, "storageInfo": { "description": "Output only. Information of storage specs for the device.", "readOnly": true, "$ref": "GoogleChromeManagementV1StorageInfo" }, "memoryInfo": { "description": "Output only. Information regarding memory specs for the device.", "readOnly": true, "$ref": "GoogleChromeManagementV1MemoryInfo" }, "networkStatusReport": { "items": { "$ref": "GoogleChromeManagementV1NetworkStatusReport" }, "type": "array", "description": "Output only. Network specs collected periodically.", "readOnly": true }, "storageStatusReport": { "items": { "$ref": "GoogleChromeManagementV1StorageStatusReport" }, "type": "array", "description": "Output only. Storage reports collected periodically.", "readOnly": true }, "runtimeCountersReport": { "readOnly": true, "type": "array", "items": { "$ref": "GoogleChromeManagementV1RuntimeCountersReport" }, "description": "Output only. Runtime counters reports collected device lifetime runtime, as well as the counts of S0-\u003eS3, S0-\u003eS4, and S0-\u003eS5 transitions, meaning entering into sleep, hibernation, and power-off states" }, "memoryStatusReport": { "description": "Output only. Memory status reports collected periodically sorted decreasing by report_time.", "type": "array", "readOnly": true, "items": { "$ref": "GoogleChromeManagementV1MemoryStatusReport" } }, "bootPerformanceReport": { "description": "Output only. Boot performance reports of the device.", "items": { "$ref": "GoogleChromeManagementV1BootPerformanceReport" }, "readOnly": true, "type": "array" }, "peripheralsReport": { "type": "array", "readOnly": true, "items": { "$ref": "GoogleChromeManagementV1PeripheralsReport" }, "description": "Output only. Peripherals reports collected periodically sorted in a decreasing order of report_time." }, "kioskAppStatusReport": { "type": "array", "readOnly": true, "items": { "$ref": "GoogleChromeManagementV1KioskAppStatusReport" }, "description": "Output only. Kiosk app status report for the kiosk device" }, "audioStatusReport": { "type": "array", "description": "Output only. Audio reports collected periodically sorted in a decreasing order of report_time.", "readOnly": true, "items": { "$ref": "GoogleChromeManagementV1AudioStatusReport" } }, "osUpdateStatus": { "readOnly": true, "type": "array", "items": { "$ref": "GoogleChromeManagementV1OsUpdateStatus" }, "description": "Output only. Contains relevant information regarding ChromeOS update status." }, "networkInfo": { "description": "Output only. Network devices information.", "$ref": "GoogleChromeManagementV1NetworkInfo", "readOnly": true }, "thunderboltInfo": { "readOnly": true, "description": "Output only. Information on Thunderbolt bus.", "items": { "$ref": "GoogleChromeManagementV1ThunderboltInfo" }, "type": "array" }, "cpuStatusReport": { "items": { "$ref": "GoogleChromeManagementV1CpuStatusReport" }, "description": "Output only. CPU status reports collected periodically sorted in a decreasing order of report_time.", "type": "array", "readOnly": true } } }, "GoogleChromeManagementV1TelemetryUsbPeripheralsEvent": { "type": "object", "description": "`TelemetryUsbPeripheralsEvent` is triggered USB devices are either added or removed. * Granular permission needed: TELEMETRY_API_PERIPHERALS_REPORT", "id": "GoogleChromeManagementV1TelemetryUsbPeripheralsEvent", "properties": { "usbPeripheralReport": { "type": "array", "items": { "$ref": "GoogleChromeManagementV1UsbPeripheralReport" }, "description": "List of usb devices that were either added or removed." } } } }, "documentationLink": "http://developers.google.com/chrome/management/", "auth": { "oauth2": { "scopes": { "https://www.googleapis.com/auth/chrome.management.appdetails.readonly": { "description": "See detailed information about apps installed on Chrome browsers and devices managed by your organization" }, "https://www.googleapis.com/auth/chrome.management.telemetry.readonly": { "description": "See basic device and telemetry information collected from Chrome OS devices or users managed within your organization" }, "https://www.googleapis.com/auth/chrome.management.reports.readonly": { "description": "See reports about devices and Chrome browsers managed within your organization" } } } }, "rootUrl": "https://chromemanagement.googleapis.com/", "basePath": "", "batchPath": "batch", "discoveryVersion": "v1", "ownerName": "Google", "version_module": true, "name": "chromemanagement", "version": "v1", "description": "The Chrome Management API is a suite of services that allows Chrome administrators to view, manage and gain insights on their Chrome OS and Chrome Browser devices.", "kind": "discovery#restDescription", "fullyEncodeReservedExpansion": true, "title": "Chrome Management API", "mtlsRootUrl": "https://chromemanagement.mtls.googleapis.com/", "icons": { "x16": "http://www.google.com/images/icons/product/search-16.gif", "x32": "http://www.google.com/images/icons/product/search-32.gif" }, "servicePath": "", "id": "chromemanagement:v1", "revision": "20240321", "resources": { "customers": { "resources": { "telemetry": { "resources": { "devices": { "methods": { "list": { "id": "chromemanagement.customers.telemetry.devices.list", "parameters": { "pageSize": { "type": "integer", "description": "Maximum number of results to return. Default value is 100. Maximum value is 1000.", "location": "query", "format": "int32" }, "filter": { "type": "string", "description": "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\u003e=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\".", "location": "query" }, "readMask": { "location": "query", "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", "type": "string" }, "pageToken": { "location": "query", "type": "string", "description": "Token to specify next page in the list." }, "parent": { "type": "string", "required": true, "location": "path", "pattern": "^customers/[^/]+$", "description": "Required. Customer id or \"my_customer\" to use the customer associated to the account making the request." } }, "description": "List all telemetry devices.", "path": "v1/{+parent}/telemetry/devices", "response": { "$ref": "GoogleChromeManagementV1ListTelemetryDevicesResponse" }, "scopes": [ "https://www.googleapis.com/auth/chrome.management.telemetry.readonly" ], "httpMethod": "GET", "flatPath": "v1/customers/{customersId}/telemetry/devices", "parameterOrder": [ "parent" ] }, "get": { "flatPath": "v1/customers/{customersId}/telemetry/devices/{devicesId}", "httpMethod": "GET", "description": "Get telemetry device.", "id": "chromemanagement.customers.telemetry.devices.get", "path": "v1/{+name}", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleChromeManagementV1TelemetryDevice" }, "parameters": { "readMask": { "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", "type": "string", "location": "query" }, "name": { "required": true, "pattern": "^customers/[^/]+/telemetry/devices/[^/]+$", "description": "Required. Name of the `TelemetryDevice` to return.", "type": "string", "location": "path" } }, "scopes": [ "https://www.googleapis.com/auth/chrome.management.telemetry.readonly" ] } } }, "events": { "methods": { "list": { "response": { "$ref": "GoogleChromeManagementV1ListTelemetryEventsResponse" }, "parameters": { "parent": { "location": "path", "required": true, "type": "string", "description": "Required. Customer id or \"my_customer\" to use the customer associated to the account making the request.", "pattern": "^customers/[^/]+$" }, "filter": { "location": "query", "description": "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\".", "type": "string" }, "pageSize": { "type": "integer", "format": "int32", "location": "query", "description": "Optional. Maximum number of results to return. Default value is 100. Maximum value is 1000." }, "readMask": { "location": "query", "type": "string", "format": "google-fieldmask", "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 " }, "pageToken": { "location": "query", "description": "Optional. Token to specify next page in the list.", "type": "string" } }, "flatPath": "v1/customers/{customersId}/telemetry/events", "id": "chromemanagement.customers.telemetry.events.list", "httpMethod": "GET", "description": "List telemetry events.", "scopes": [ "https://www.googleapis.com/auth/chrome.management.telemetry.readonly" ], "parameterOrder": [ "parent" ], "path": "v1/{+parent}/telemetry/events" } } }, "users": { "methods": { "get": { "scopes": [ "https://www.googleapis.com/auth/chrome.management.telemetry.readonly" ], "httpMethod": "GET", "description": "Get telemetry user.", "id": "chromemanagement.customers.telemetry.users.get", "flatPath": "v1/customers/{customersId}/telemetry/users/{usersId}", "path": "v1/{+name}", "parameters": { "readMask": { "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" }, "name": { "location": "path", "pattern": "^customers/[^/]+/telemetry/users/[^/]+$", "description": "Required. Name of the `TelemetryUser` to return.", "required": true, "type": "string" } }, "parameterOrder": [ "name" ], "response": { "$ref": "GoogleChromeManagementV1TelemetryUser" } }, "list": { "description": "List all telemetry users.", "response": { "$ref": "GoogleChromeManagementV1ListTelemetryUsersResponse" }, "flatPath": "v1/customers/{customersId}/telemetry/users", "httpMethod": "GET", "path": "v1/{+parent}/telemetry/users", "parameters": { "parent": { "required": true, "description": "Required. Customer id or \"my_customer\" to use the customer associated to the account making the request.", "location": "path", "type": "string", "pattern": "^customers/[^/]+$" }, "pageSize": { "type": "integer", "format": "int32", "location": "query", "description": "Maximum number of results to return. Default value is 100. Maximum value is 1000." }, "readMask": { "type": "string", "location": "query", "format": "google-fieldmask", "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 " }, "filter": { "location": "query", "type": "string", "description": "Only include resources that match the filter. Supported filter fields: - user_id - user_org_unit_id " }, "pageToken": { "type": "string", "location": "query", "description": "Token to specify next page in the list." } }, "id": "chromemanagement.customers.telemetry.users.list", "scopes": [ "https://www.googleapis.com/auth/chrome.management.telemetry.readonly" ], "parameterOrder": [ "parent" ] } } }, "notificationConfigs": { "methods": { "delete": { "parameters": { "name": { "required": true, "description": "Required. The name of the notification config to delete. Format: `customers/{customer}/telemetry/notificationConfigs/{notification_config}`", "pattern": "^customers/[^/]+/telemetry/notificationConfigs/[^/]+$", "location": "path", "type": "string" } }, "httpMethod": "DELETE", "id": "chromemanagement.customers.telemetry.notificationConfigs.delete", "flatPath": "v1/customers/{customersId}/telemetry/notificationConfigs/{notificationConfigsId}", "scopes": [ "https://www.googleapis.com/auth/chrome.management.telemetry.readonly" ], "path": "v1/{+name}", "parameterOrder": [ "name" ], "description": "Delete a telemetry notification config.", "response": { "$ref": "GoogleProtobufEmpty" } }, "list": { "id": "chromemanagement.customers.telemetry.notificationConfigs.list", "path": "v1/{+parent}/telemetry/notificationConfigs", "description": "List all telemetry notification configs.", "response": { "$ref": "GoogleChromeManagementV1ListTelemetryNotificationConfigsResponse" }, "scopes": [ "https://www.googleapis.com/auth/chrome.management.telemetry.readonly" ], "parameterOrder": [ "parent" ], "parameters": { "pageToken": { "type": "string", "location": "query", "description": "A page token, received from a previous `ListTelemetryNotificationConfigs` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListTelemetryNotificationConfigs` must match the call that provided the page token." }, "pageSize": { "type": "integer", "location": "query", "description": "The maximum number of notification configs to return. The service may return fewer than this value. If unspecified, at most 100 notification configs will be returned. The maximum value is 100; values above 100 will be coerced to 100.", "format": "int32" }, "parent": { "required": true, "type": "string", "description": "Required. The parent which owns the notification configs.", "pattern": "^customers/[^/]+$", "location": "path" } }, "flatPath": "v1/customers/{customersId}/telemetry/notificationConfigs", "httpMethod": "GET" }, "create": { "response": { "$ref": "GoogleChromeManagementV1TelemetryNotificationConfig" }, "request": { "$ref": "GoogleChromeManagementV1TelemetryNotificationConfig" }, "description": "Create a telemetry notification config.", "parameterOrder": [ "parent" ], "id": "chromemanagement.customers.telemetry.notificationConfigs.create", "flatPath": "v1/customers/{customersId}/telemetry/notificationConfigs", "parameters": { "parent": { "pattern": "^customers/[^/]+$", "type": "string", "location": "path", "required": true, "description": "Required. The parent resource where this notification config will be created. Format: `customers/{customer}`" } }, "scopes": [ "https://www.googleapis.com/auth/chrome.management.telemetry.readonly" ], "path": "v1/{+parent}/telemetry/notificationConfigs", "httpMethod": "POST" } } } } }, "reports": { "methods": { "countPrintJobsByPrinter": { "httpMethod": "GET", "id": "chromemanagement.customers.reports.countPrintJobsByPrinter", "parameters": { "customer": { "description": "Required. Customer ID prefixed with \"customers/\" or \"customers/my_customer\" to use the customer associated to the account making the request.", "location": "path", "type": "string", "required": true, "pattern": "^customers/[^/]+$" }, "printerOrgUnitId": { "description": "The ID of the organizational unit for printers. If specified, only data for printers from the specified organizational unit will be returned. If omitted, data for printers from all organizational units will be returned.", "location": "query", "type": "string" }, "pageToken": { "location": "query", "type": "string", "description": "Token to specify the page of the response to be returned." }, "orderBy": { "location": "query", "description": "Field used to order results. If omitted, results will be ordered in ascending order of the 'printer' field. Supported order_by fields: * printer * job_count * device_count * user_count", "type": "string" }, "pageSize": { "format": "int32", "location": "query", "type": "integer", "description": "Maximum number of results to return. Maximum and default are 100." }, "filter": { "description": "Query string to filter results, AND-separated fields in EBNF syntax. Note: OR operations are not supported in this filter. Note: Only \u003e= and \u003c= comparators are supported in this filter. Supported filter fields: * complete_time", "type": "string", "location": "query" } }, "flatPath": "v1/customers/{customersId}/reports:countPrintJobsByPrinter", "response": { "$ref": "GoogleChromeManagementV1CountPrintJobsByPrinterResponse" }, "path": "v1/{+customer}/reports:countPrintJobsByPrinter", "scopes": [ "https://www.googleapis.com/auth/chrome.management.reports.readonly" ], "parameterOrder": [ "customer" ], "description": "Get a summary of printing done by each printer." }, "countChromeDevicesReachingAutoExpirationDate": { "flatPath": "v1/customers/{customersId}/reports:countChromeDevicesReachingAutoExpirationDate", "scopes": [ "https://www.googleapis.com/auth/chrome.management.reports.readonly" ], "path": "v1/{+customer}/reports:countChromeDevicesReachingAutoExpirationDate", "httpMethod": "GET", "response": { "$ref": "GoogleChromeManagementV1CountChromeDevicesReachingAutoExpirationDateResponse" }, "id": "chromemanagement.customers.reports.countChromeDevicesReachingAutoExpirationDate", "parameters": { "customer": { "description": "Required. The customer ID or \"my_customer\" prefixed with \"customers/\".", "required": true, "type": "string", "pattern": "^customers/[^/]+$", "location": "path" }, "maxAueDate": { "type": "string", "location": "query", "description": "Optional. Maximum expiration date in format yyyy-mm-dd in UTC timezone. If included returns all devices that have already expired and devices with auto expiration date equal to or earlier than the maximum date." }, "minAueDate": { "description": "Optional. Maximum expiration date in format yyyy-mm-dd in UTC timezone. If included returns all devices that have already expired and devices with auto expiration date equal to or later than the minimum date.", "type": "string", "location": "query" }, "orgUnitId": { "description": "Optional. The organizational unit ID, if omitted, will return data for all organizational units.", "type": "string", "location": "query" } }, "description": "Generate report of the number of devices expiring in each month of the selected time frame. Devices are grouped by auto update expiration date and model. Further information can be found [here](https://support.google.com/chrome/a/answer/10564947).", "parameterOrder": [ "customer" ] }, "countChromeVersions": { "scopes": [ "https://www.googleapis.com/auth/chrome.management.reports.readonly" ], "description": "Generate report of installed Chrome versions.", "response": { "$ref": "GoogleChromeManagementV1CountChromeVersionsResponse" }, "parameterOrder": [ "customer" ], "path": "v1/{+customer}/reports:countChromeVersions", "httpMethod": "GET", "parameters": { "pageToken": { "location": "query", "type": "string", "description": "Token to specify the page of the request to be returned." }, "pageSize": { "location": "query", "format": "int32", "type": "integer", "description": "Maximum number of results to return. Maximum and default are 100." }, "customer": { "location": "path", "required": true, "description": "Required. Customer id or \"my_customer\" to use the customer associated to the account making the request.", "pattern": "^customers/[^/]+$", "type": "string" }, "orgUnitId": { "type": "string", "location": "query", "description": "The ID of the organizational unit." }, "filter": { "location": "query", "description": "Query string to filter results, AND-separated fields in EBNF syntax. Note: OR operations are not supported in this filter. Supported filter fields: * last_active_date", "type": "string" } }, "flatPath": "v1/customers/{customersId}/reports:countChromeVersions", "id": "chromemanagement.customers.reports.countChromeVersions" }, "countPrintJobsByUser": { "response": { "$ref": "GoogleChromeManagementV1CountPrintJobsByUserResponse" }, "id": "chromemanagement.customers.reports.countPrintJobsByUser", "flatPath": "v1/customers/{customersId}/reports:countPrintJobsByUser", "httpMethod": "GET", "path": "v1/{+customer}/reports:countPrintJobsByUser", "parameterOrder": [ "customer" ], "parameters": { "customer": { "description": "Required. Customer ID prefixed with \"customers/\" or \"customers/my_customer\" to use the customer associated to the account making the request.", "pattern": "^customers/[^/]+$", "type": "string", "required": true, "location": "path" }, "filter": { "description": "Query string to filter results, AND-separated fields in EBNF syntax. Note: OR operations are not supported in this filter. Note: Only \u003e= and \u003c= comparators are supported in this filter. Supported filter fields: * complete_time", "location": "query", "type": "string" }, "pageToken": { "location": "query", "description": "Token to specify the page of the response to be returned.", "type": "string" }, "printerOrgUnitId": { "description": "The ID of the organizational unit for printers. If specified, only print jobs initiated with printers from the specified organizational unit will be counted. If omitted, all print jobs will be counted.", "location": "query", "type": "string" }, "orderBy": { "location": "query", "description": "Field used to order results. If omitted, results will be ordered in ascending order of the 'user_email' field. Supported order_by fields: * user_email * job_count * printer_count * device_count", "type": "string" }, "pageSize": { "type": "integer", "location": "query", "description": "Maximum number of results to return. Maximum and default are 100.", "format": "int32" } }, "description": "Get a summary of printing done by each user.", "scopes": [ "https://www.googleapis.com/auth/chrome.management.reports.readonly" ] }, "countInstalledApps": { "parameterOrder": [ "customer" ], "scopes": [ "https://www.googleapis.com/auth/chrome.management.reports.readonly" ], "flatPath": "v1/customers/{customersId}/reports:countInstalledApps", "id": "chromemanagement.customers.reports.countInstalledApps", "parameters": { "orgUnitId": { "type": "string", "description": "The ID of the organizational unit.", "location": "query" }, "customer": { "pattern": "^customers/[^/]+$", "location": "path", "type": "string", "description": "Required. Customer id or \"my_customer\" to use the customer associated to the account making the request.", "required": true }, "pageToken": { "description": "Token to specify the page of the request to be returned.", "location": "query", "type": "string" }, "orderBy": { "description": "Field used to order results. Supported order by fields: * app_name * app_type * install_type * number_of_permissions * total_install_count * app_id", "type": "string", "location": "query" }, "filter": { "description": "Query string to filter results, AND-separated fields in EBNF syntax. Note: OR operations are not supported in this filter. Supported filter fields: * app_name * app_type * install_type * number_of_permissions * total_install_count * latest_profile_active_date * permission_name * app_id", "location": "query", "type": "string" }, "pageSize": { "location": "query", "format": "int32", "type": "integer", "description": "Maximum number of results to return. Maximum and default are 100." } }, "description": "Generate report of app installations.", "httpMethod": "GET", "response": { "$ref": "GoogleChromeManagementV1CountInstalledAppsResponse" }, "path": "v1/{+customer}/reports:countInstalledApps" }, "countChromeHardwareFleetDevices": { "id": "chromemanagement.customers.reports.countChromeHardwareFleetDevices", "path": "v1/{+customer}/reports:countChromeHardwareFleetDevices", "scopes": [ "https://www.googleapis.com/auth/chrome.management.reports.readonly" ], "parameters": { "customer": { "type": "string", "required": true, "location": "path", "pattern": "^customers/[^/]+$", "description": "Required. The customer ID or \"my_customer\"." }, "readMask": { "description": "Required. Mask of the fields that should be populated in the returned report.", "location": "query", "type": "string", "format": "google-fieldmask" }, "orgUnitId": { "description": "Optional. The ID of the organizational unit. If omitted, all data will be returned.", "location": "query", "type": "string" } }, "httpMethod": "GET", "response": { "$ref": "GoogleChromeManagementV1CountChromeHardwareFleetDevicesResponse" }, "parameterOrder": [ "customer" ], "flatPath": "v1/customers/{customersId}/reports:countChromeHardwareFleetDevices", "description": "Counts of devices with a specific hardware specification from the requested hardware type (for example model name, processor type). Further information can be found here https://support.google.com/chrome/a/answer/10564947" }, "countChromeBrowsersNeedingAttention": { "httpMethod": "GET", "description": "Count of Chrome Browsers that have been recently enrolled, have new policy to be synced, or have no recent activity.", "scopes": [ "https://www.googleapis.com/auth/chrome.management.reports.readonly" ], "id": "chromemanagement.customers.reports.countChromeBrowsersNeedingAttention", "parameters": { "customer": { "required": true, "location": "path", "type": "string", "pattern": "^customers/[^/]+$", "description": "Required. The customer ID or \"my_customer\" prefixed with \"customers/\"." }, "orgUnitId": { "type": "string", "location": "query", "description": "Optional. The ID of the organizational unit. If omitted, all data will be returned." } }, "path": "v1/{+customer}/reports:countChromeBrowsersNeedingAttention", "parameterOrder": [ "customer" ], "response": { "$ref": "GoogleChromeManagementV1CountChromeBrowsersNeedingAttentionResponse" }, "flatPath": "v1/customers/{customersId}/reports:countChromeBrowsersNeedingAttention" }, "enumeratePrintJobs": { "parameters": { "printerOrgUnitId": { "description": "The ID of the organizational unit for printers. If specified, only print jobs submitted to printers from the specified organizational unit will be returned.", "location": "query", "type": "string" }, "orderBy": { "location": "query", "type": "string", "description": "Field used to order results. If not specified, results will be ordered in descending order of the `complete_time` field. Supported order by fields: * title * state * create_time * complete_time * document_page_count * color_mode * duplex_mode * printer * user_email" }, "customer": { "required": true, "location": "path", "pattern": "^customers/[^/]+$", "type": "string", "description": "Required. Customer ID prefixed with \"customers/\" or \"customers/my_customer\" to use the customer associated to the account making the request." }, "pageSize": { "type": "integer", "description": "The number of print jobs in the page from 0 to 100 inclusive, if page_size is not specified or zero, the size will be 50.", "location": "query", "format": "int32" }, "filter": { "description": "Query string to filter results, AND-separated fields in EBNF syntax. Note: OR operations are not supported in this filter. Note: Only \u003e= and \u003c= comparators are supported for `complete_time`. Note: Only = comparator supported for `user_id` and `printer_id`. Supported filter fields: * complete_time * printer_id * user_id", "type": "string", "location": "query" }, "pageToken": { "location": "query", "type": "string", "description": "A page token received from a previous `EnumeratePrintJobs` call. Provide this to retrieve the subsequent page. If omitted, the first page of results will be returned. When paginating, all other parameters provided to `EnumeratePrintJobs` must match the call that provided the page token." } }, "response": { "$ref": "GoogleChromeManagementV1EnumeratePrintJobsResponse" }, "httpMethod": "GET", "id": "chromemanagement.customers.reports.enumeratePrintJobs", "scopes": [ "https://www.googleapis.com/auth/chrome.management.reports.readonly" ], "flatPath": "v1/customers/{customersId}/reports:enumeratePrintJobs", "parameterOrder": [ "customer" ], "path": "v1/{+customer}/reports:enumeratePrintJobs", "description": "Get a list of print jobs." }, "countChromeDevicesThatNeedAttention": { "scopes": [ "https://www.googleapis.com/auth/chrome.management.reports.readonly" ], "description": "Counts of ChromeOS devices that have not synced policies or have lacked user activity in the past 28 days, are out of date, or are not complaint. Further information can be found here https://support.google.com/chrome/a/answer/10564947", "parameters": { "orgUnitId": { "description": "Optional. The ID of the organizational unit. If omitted, all data will be returned.", "location": "query", "type": "string" }, "customer": { "location": "path", "pattern": "^customers/[^/]+$", "type": "string", "required": true, "description": "Required. The customer ID or \"my_customer\" prefixed with \"customers/\"." }, "readMask": { "location": "query", "type": "string", "format": "google-fieldmask", "description": "Required. Mask of the fields that should be populated in the returned report." } }, "parameterOrder": [ "customer" ], "httpMethod": "GET", "response": { "$ref": "GoogleChromeManagementV1CountChromeDevicesThatNeedAttentionResponse" }, "path": "v1/{+customer}/reports:countChromeDevicesThatNeedAttention", "flatPath": "v1/customers/{customersId}/reports:countChromeDevicesThatNeedAttention", "id": "chromemanagement.customers.reports.countChromeDevicesThatNeedAttention" }, "findInstalledAppDevices": { "httpMethod": "GET", "flatPath": "v1/customers/{customersId}/reports:findInstalledAppDevices", "id": "chromemanagement.customers.reports.findInstalledAppDevices", "description": "Generate report of managed Chrome browser devices that have a specified app installed.", "path": "v1/{+customer}/reports:findInstalledAppDevices", "response": { "$ref": "GoogleChromeManagementV1FindInstalledAppDevicesResponse" }, "parameterOrder": [ "customer" ], "parameters": { "pageToken": { "type": "string", "description": "Token to specify the page of the request to be returned.", "location": "query" }, "orderBy": { "description": "Field used to order results. Supported order by fields: * machine * device_id", "location": "query", "type": "string" }, "pageSize": { "location": "query", "type": "integer", "format": "int32", "description": "Maximum number of results to return. Maximum and default are 100." }, "filter": { "description": "Query string to filter results, AND-separated fields in EBNF syntax. Note: OR operations are not supported in this filter. Supported filter fields: * last_active_date", "location": "query", "type": "string" }, "customer": { "description": "Required. Customer id or \"my_customer\" to use the customer associated to the account making the request.", "required": true, "pattern": "^customers/[^/]+$", "type": "string", "location": "path" }, "appType": { "description": "Type of the app.", "enumDescriptions": [ "App type not specified.", "Chrome extension.", "Chrome app.", "Chrome theme.", "Chrome hosted app.", "ARC++ app." ], "type": "string", "location": "query", "enum": [ "APP_TYPE_UNSPECIFIED", "EXTENSION", "APP", "THEME", "HOSTED_APP", "ANDROID_APP" ] }, "orgUnitId": { "description": "The ID of the organizational unit.", "location": "query", "type": "string" }, "appId": { "description": "Unique identifier of the app. For Chrome apps and extensions, the 32-character id (e.g. ehoadneljpdggcbbknedodolkkjodefl). For Android apps, the package name (e.g. com.evernote).", "location": "query", "type": "string" } }, "scopes": [ "https://www.googleapis.com/auth/chrome.management.reports.readonly" ] }, "countChromeCrashEvents": { "flatPath": "v1/customers/{customersId}/reports:countChromeCrashEvents", "httpMethod": "GET", "id": "chromemanagement.customers.reports.countChromeCrashEvents", "parameterOrder": [ "customer" ], "path": "v1/{+customer}/reports:countChromeCrashEvents", "scopes": [ "https://www.googleapis.com/auth/chrome.management.reports.readonly" ], "response": { "$ref": "GoogleChromeManagementV1CountChromeCrashEventsResponse" }, "description": "Get a count of Chrome crash events.", "parameters": { "orgUnitId": { "location": "query", "type": "string", "description": "If specified, only count the number of crash events of the devices in this organizational unit." }, "customer": { "pattern": "^customers/[^/]+$", "type": "string", "required": true, "description": "Customer ID.", "location": "path" }, "filter": { "location": "query", "type": "string", "description": "Query string to filter results, AND-separated fields in EBNF syntax. Supported filter fields: * major_browser_version * minor_browser_version * browser_channel * device_platform * past_number_days Example: `major_browser_version = 'M115' AND past_number_days = '28'`." }, "orderBy": { "location": "query", "type": "string", "description": "Field used to order results. Supported order by fields: * browser_version * count * date" } } } } }, "apps": { "resources": { "android": { "methods": { "get": { "parameters": { "name": { "required": true, "type": "string", "location": "path", "description": "Required. The app for which details are being queried. Examples: \"customers/my_customer/apps/chrome/gmbmikajjgmnabiglmofipeabaddhgne@2.1.2\" for the Save to Google Drive Chrome extension version 2.1.2, \"customers/my_customer/apps/android/com.google.android.apps.docs\" for the Google Drive Android app's latest version.", "pattern": "^customers/[^/]+/apps/android/[^/]+$" } }, "parameterOrder": [ "name" ], "description": "Get a specific app for a customer by its resource name.", "flatPath": "v1/customers/{customersId}/apps/android/{androidId}", "response": { "$ref": "GoogleChromeManagementV1AppDetails" }, "httpMethod": "GET", "id": "chromemanagement.customers.apps.android.get", "path": "v1/{+name}", "scopes": [ "https://www.googleapis.com/auth/chrome.management.appdetails.readonly" ] } } }, "chrome": { "methods": { "get": { "scopes": [ "https://www.googleapis.com/auth/chrome.management.appdetails.readonly" ], "httpMethod": "GET", "parameters": { "name": { "required": true, "description": "Required. The app for which details are being queried. Examples: \"customers/my_customer/apps/chrome/gmbmikajjgmnabiglmofipeabaddhgne@2.1.2\" for the Save to Google Drive Chrome extension version 2.1.2, \"customers/my_customer/apps/android/com.google.android.apps.docs\" for the Google Drive Android app's latest version.", "pattern": "^customers/[^/]+/apps/chrome/[^/]+$", "type": "string", "location": "path" } }, "description": "Get a specific app for a customer by its resource name.", "id": "chromemanagement.customers.apps.chrome.get", "flatPath": "v1/customers/{customersId}/apps/chrome/{chromeId}", "path": "v1/{+name}", "parameterOrder": [ "name" ], "response": { "$ref": "GoogleChromeManagementV1AppDetails" } } } }, "web": { "methods": { "get": { "httpMethod": "GET", "id": "chromemanagement.customers.apps.web.get", "scopes": [ "https://www.googleapis.com/auth/chrome.management.appdetails.readonly" ], "description": "Get a specific app for a customer by its resource name.", "path": "v1/{+name}", "parameterOrder": [ "name" ], "flatPath": "v1/customers/{customersId}/apps/web/{webId}", "parameters": { "name": { "pattern": "^customers/[^/]+/apps/web/[^/]+$", "description": "Required. The app for which details are being queried. Examples: \"customers/my_customer/apps/chrome/gmbmikajjgmnabiglmofipeabaddhgne@2.1.2\" for the Save to Google Drive Chrome extension version 2.1.2, \"customers/my_customer/apps/android/com.google.android.apps.docs\" for the Google Drive Android app's latest version.", "required": true, "type": "string", "location": "path" } }, "response": { "$ref": "GoogleChromeManagementV1AppDetails" } } } } }, "methods": { "countChromeAppRequests": { "response": { "$ref": "GoogleChromeManagementV1CountChromeAppRequestsResponse" }, "flatPath": "v1/customers/{customersId}/apps:countChromeAppRequests", "path": "v1/{+customer}/apps:countChromeAppRequests", "scopes": [ "https://www.googleapis.com/auth/chrome.management.appdetails.readonly" ], "id": "chromemanagement.customers.apps.countChromeAppRequests", "httpMethod": "GET", "description": "Generate summary of app installation requests.", "parameterOrder": [ "customer" ], "parameters": { "orderBy": { "location": "query", "description": "Field used to order results. Supported fields: * request_count * latest_request_time", "type": "string" }, "orgUnitId": { "location": "query", "description": "The ID of the organizational unit.", "type": "string" }, "pageSize": { "description": "Maximum number of results to return. Maximum and default are 50, anything above will be coerced to 50.", "type": "integer", "location": "query", "format": "int32" }, "pageToken": { "description": "Token to specify the page of the request to be returned.", "type": "string", "location": "query" }, "customer": { "required": true, "type": "string", "pattern": "^customers/[^/]+$", "location": "path", "description": "Required. Customer id or \"my_customer\" to use the customer associated to the account making the request." } } }, "fetchUsersRequestingExtension": { "parameters": { "customer": { "required": true, "pattern": "^customers/[^/]+$", "description": "Required. The customer ID or \"my_customer\" prefixed with \"customers/\".", "location": "path", "type": "string" }, "extensionId": { "type": "string", "location": "query", "description": "Required. The extension for which we want to find the requesting users." }, "pageToken": { "description": "Optional. Token to specify the page of the request to be returned. Token expires after 1 day.", "location": "query", "type": "string" }, "pageSize": { "format": "int32", "type": "integer", "description": "Optional. Maximum number of results to return. Maximum and default are 50. Any page size larger than 50 will be coerced to 50.", "location": "query" }, "orgUnitId": { "description": "The ID of the organizational unit. Only consider devices that directly belong to this org unit, i.e. sub-orgunits are not counted. If omitted, all data will be returned.", "location": "query", "type": "string" } }, "id": "chromemanagement.customers.apps.fetchUsersRequestingExtension", "parameterOrder": [ "customer" ], "response": { "$ref": "GoogleChromeManagementV1FetchUsersRequestingExtensionResponse" }, "scopes": [ "https://www.googleapis.com/auth/chrome.management.appdetails.readonly" ], "description": "Get a list of users that have requested to install an extension.", "flatPath": "v1/customers/{customersId}/apps:fetchUsersRequestingExtension", "httpMethod": "GET", "path": "v1/{+customer}/apps:fetchUsersRequestingExtension" }, "fetchDevicesRequestingExtension": { "path": "v1/{+customer}/apps:fetchDevicesRequestingExtension", "description": "Get a list of devices that have requested to install an extension.", "id": "chromemanagement.customers.apps.fetchDevicesRequestingExtension", "parameters": { "pageSize": { "type": "integer", "format": "int32", "location": "query", "description": "Optional. Maximum number of results to return. Maximum and default are 50. Any page size larger than 50 will be coerced to 50." }, "extensionId": { "type": "string", "location": "query", "description": "Required. The extension for which we want to find requesting devices." }, "pageToken": { "description": "Optional. Token to specify the page of the request to be returned. Token expires after 1 day.", "type": "string", "location": "query" }, "customer": { "type": "string", "required": true, "description": "Required. The customer ID or \"my_customer\" prefixed with \"customers/\".", "location": "path", "pattern": "^customers/[^/]+$" }, "orgUnitId": { "description": "The ID of the organizational unit. Only consider devices that directly belong to this org unit, i.e. sub-orgunits are not counted. If omitted, all data will be returned.", "type": "string", "location": "query" } }, "response": { "$ref": "GoogleChromeManagementV1FetchDevicesRequestingExtensionResponse" }, "flatPath": "v1/customers/{customersId}/apps:fetchDevicesRequestingExtension", "scopes": [ "https://www.googleapis.com/auth/chrome.management.appdetails.readonly" ], "httpMethod": "GET", "parameterOrder": [ "customer" ] } } } } } }, "canonicalName": "Chrome Management", "baseUrl": "https://chromemanagement.googleapis.com/", "protocol": "rest", "ownerDomain": "google.com" }