openapi-directory/api/googleapis.com/chromemanagement.json

Building & bundling https://github.com/APIs-guru/openapi-directory for easy use from JS

{"openapi":"3.0.0","servers":[{"url":"https://chromemanagement.googleapis.com/"}],"info":{"contact":{"name":"Google","url":"https://google.com","x-twitter":"youtube"},"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.","license":{"name":"Creative Commons Attribution 3.0","url":"http://creativecommons.org/licenses/by/3.0/"},"termsOfService":"https://developers.google.com/terms/","title":"Chrome Management API","version":"v1","x-apisguru-categories":["analytics","media"],"x-logo":{"url":"https://upload.wikimedia.org/wikipedia/commons/e/e1/YouTube_play_buttom_icon_%282013-2017%29.svg"},"x-origin":[{"format":"openapi","url":"https://chromemanagement.googleapis.com/$discovery/rest?version=v1","version":"3.0"}],"x-providerName":"googleapis.com","x-serviceName":"chromemanagement"},"externalDocs":{"url":"http://developers.google.com/chrome/management/"},"tags":[{"name":"customers"}],"paths":{"/v1/{customer}/apps:countChromeAppRequests":{"get":{"description":"Generate summary of app installation requests.","operationId":"chromemanagement.customers.apps.countChromeAppRequests","parameters":[{"description":"Required. Customer id or \"my_customer\" to use the customer associated to the account making the request.","in":"path","name":"customer","required":true,"schema":{"type":"string"}},{"description":"Field used to order results. Supported fields: * request_count * latest_request_time","in":"query","name":"orderBy","schema":{"type":"string"}},{"description":"The ID of the organizational unit.","in":"query","name":"orgUnitId","schema":{"type":"string"}},{"description":"Maximum number of results to return. Maximum and default are 50, anything above will be coerced to 50.","in":"query","name":"pageSize","schema":{"type":"integer"}},{"description":"Token to specify the page of the request to be returned.","in":"query","name":"pageToken","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleChromeManagementV1CountChromeAppRequestsResponse"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/chrome.management.appdetails.readonly"],"Oauth2c":["https://www.googleapis.com/auth/chrome.management.appdetails.readonly"]}],"tags":["customers"]},"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}]},"/v1/{customer}/reports:countChromeBrowsersNeedingAttention":{"get":{"description":"Count of Chrome Browsers that have been recently enrolled, have new policy to be synced, or have no recent activity.","operationId":"chromemanagement.customers.reports.countChromeBrowsersNeedingAttention","parameters":[{"description":"Required. The customer ID or \"my_customer\" prefixed with \"customers/\".","in":"path","name":"customer","required":true,"schema":{"type":"string"}},{"description":"Optional. The ID of the organizational unit. If omitted, all data will be returned.","in":"query","name":"orgUnitId","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleChromeManagementV1CountChromeBrowsersNeedingAttentionResponse"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/chrome.management.reports.readonly"],"Oauth2c":["https://www.googleapis.com/auth/chrome.management.reports.readonly"]}],"tags":["customers"]},"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}]},"/v1/{customer}/reports:countChromeDevicesReachingAutoExpirationDate":{"get":{"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).","operationId":"chromemanagement.customers.reports.countChromeDevicesReachingAutoExpirationDate","parameters":[{"description":"Required. The customer ID or \"my_customer\" prefixed with \"customers/\".","in":"path","name":"customer","required":true,"schema":{"type":"string"}},{"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.","in":"query","name":"maxAueDate","schema":{"type":"string"}},{"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.","in":"query","name":"minAueDate","schema":{"type":"string"}},{"description":"Optional. The organizational unit ID, if omitted, will return data for all organizational units.","in":"query","name":"orgUnitId","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleChromeManagementV1CountChromeDevicesReachingAutoExpirationDateResponse"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/chrome.management.reports.readonly"],"Oauth2c":["https://www.googleapis.com/auth/chrome.management.reports.readonly"]}],"tags":["customers"]},"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}]},"/v1/{customer}/reports:countChromeDevicesThatNeedAttention":{"get":{"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","operationId":"chromemanagement.customers.reports.countChromeDevicesThatNeedAttention","parameters":[{"description":"Required. The customer ID or \"my_customer\" prefixed with \"customers/\".","in":"path","name":"customer","required":true,"schema":{"type":"string"}},{"description":"Optional. The ID of the organizational unit. If omitted, all data will be returned.","in":"query","name":"orgUnitId","schema":{"type":"string"}},{"description":"Required. Mask of the fields that should be populated in the returned report.","in":"query","name":"readMask","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleChromeManagementV1CountChromeDevicesThatNeedAttentionResponse"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/chrome.management.reports.readonly"],"Oauth2c":["https://www.googleapis.com/auth/chrome.management.reports.readonly"]}],"tags":["customers"]},"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}]},"/v1/{customer}/reports:countChromeHardwareFleetDevices":{"get":{"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","operationId":"chromemanagement.customers.reports.countChromeHardwareFleetDevices","parameters":[{"description":"Required. The customer ID or \"my_customer\".","in":"path","name":"customer","required":true,"schema":{"type":"string"}},{"description":"Optional. The ID of the organizational unit. If omitted, all data will be returned.","in":"query","name":"orgUnitId","schema":{"type":"string"}},{"description":"Required. Mask of the fields that should be populated in the returned report.","in":"query","name":"readMask","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleChromeManagementV1CountChromeHardwareFleetDevicesResponse"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/chrome.management.reports.readonly"],"Oauth2c":["https://www.googleapis.com/auth/chrome.management.reports.readonly"]}],"tags":["customers"]},"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}]},"/v1/{customer}/reports:countChromeVersions":{"get":{"description":"Generate report of installed Chrome versions.","operationId":"chromemanagement.customers.reports.countChromeVersions","parameters":[{"description":"Required. Customer id or \"my_customer\" to use the customer associated to the account making the request.","in":"path","name":"customer","required":true,"schema":{"type":"string"}},{"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","in":"query","name":"filter","schema":{"type":"string"}},{"description":"The ID of the organizational unit.","in":"query","name":"orgUnitId","schema":{"type":"string"}},{"description":"Maximum number of results to return. Maximum and default are 100.","in":"query","name":"pageSize","schema":{"type":"integer"}},{"description":"Token to specify the page of the request to be returned.","in":"query","name":"pageToken","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleChromeManagementV1CountChromeVersionsResponse"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/chrome.management.reports.readonly"],"Oauth2c":["https://www.googleapis.com/auth/chrome.management.reports.readonly"]}],"tags":["customers"]},"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}]},"/v1/{customer}/reports:countInstalledApps":{"get":{"description":"Generate report of app installations.","operationId":"chromemanagement.customers.reports.countInstalledApps","parameters":[{"description":"Required. Customer id or \"my_customer\" to use the customer associated to the account making the request.","in":"path","name":"customer","required":true,"schema":{"type":"string"}},{"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","in":"query","name":"filter","schema":{"type":"string"}},{"description":"Field used to order results. Supported order by fields: * app_name * app_type * install_type * number_of_permissions * total_install_count * app_id","in":"query","name":"orderBy","schema":{"type":"string"}},{"description":"The ID of the organizational unit.","in":"query","name":"orgUnitId","schema":{"type":"string"}},{"description":"Maximum number of results to return. Maximum and default are 100.","in":"query","name":"pageSize","schema":{"type":"integer"}},{"description":"Token to specify the page of the request to be returned.","in":"query","name":"pageToken","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleChromeManagementV1CountInstalledAppsResponse"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/chrome.management.reports.readonly"],"Oauth2c":["https://www.googleapis.com/auth/chrome.management.reports.readonly"]}],"tags":["customers"]},"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}]},"/v1/{customer}/reports:countPrintJobsByPrinter":{"get":{"description":"Get a summary of printing done by each printer.","operationId":"chromemanagement.customers.reports.countPrintJobsByPrinter","parameters":[{"description":"Required. Customer ID prefixed with \"customers/\" or \"customers/my_customer\" to use the customer associated to the account making the request.","in":"path","name":"customer","required":true,"schema":{"type":"string"}},{"description":"Query string to filter results, AND-separated fields in EBNF syntax. Note: OR operations are not supported in this filter. Note: Only >= and <= comparators are supported in this filter. Supported filter fields: * complete_time","in":"query","name":"filter","schema":{"type":"string"}},{"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","in":"query","name":"orderBy","schema":{"type":"string"}},{"description":"Maximum number of results to return. Maximum and default are 100.","in":"query","name":"pageSize","schema":{"type":"integer"}},{"description":"Token to specify the page of the response to be returned.","in":"query","name":"pageToken","schema":{"type":"string"}},{"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.","in":"query","name":"printerOrgUnitId","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleChromeManagementV1CountPrintJobsByPrinterResponse"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/chrome.management.reports.readonly"],"Oauth2c":["https://www.googleapis.com/auth/chrome.management.reports.readonly"]}],"tags":["customers"]},"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}]},"/v1/{customer}/reports:countPrintJobsByUser":{"get":{"description":"Get a summary of printing done by each user.","operationId":"chromemanagement.customers.reports.countPrintJobsByUser","parameters":[{"description":"Required. Customer ID prefixed with \"customers/\" or \"customers/my_customer\" to use the customer associated to the account making the request.","in":"path","name":"customer","required":true,"schema":{"type":"string"}},{"description":"Query string to filter results, AND-separated fields in EBNF syntax. Note: OR operations are not supported in this filter. Note: Only >= and <= comparators are supported in this filter. Supported filter fields: * complete_time","in":"query","name":"filter","schema":{"type":"string"}},{"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","in":"query","name":"orderBy","schema":{"type":"string"}},{"description":"Maximum number of results to return. Maximum and default are 100.","in":"query","name":"pageSize","schema":{"type":"integer"}},{"description":"Token to specify the page of the response to be returned.","in":"query","name":"pageToken","schema":{"type":"string"}},{"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.","in":"query","name":"printerOrgUnitId","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleChromeManagementV1CountPrintJobsByUserResponse"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/chrome.management.reports.readonly"],"Oauth2c":["https://www.googleapis.com/auth/chrome.management.reports.readonly"]}],"tags":["customers"]},"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}]},"/v1/{customer}/reports:enumeratePrintJobs":{"get":{"description":"Get a list of print jobs.","operationId":"chromemanagement.customers.reports.enumeratePrintJobs","parameters":[{"description":"Required. Customer ID prefixed with \"customers/\" or \"customers/my_customer\" to use the customer associated to the account making the request.","in":"path","name":"customer","required":true,"schema":{"type":"string"}},{"description":"Query string to filter results, AND-separated fields in EBNF syntax. Note: OR operations are not supported in this filter. Note: Only >= and <= 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","in":"query","name":"filter","schema":{"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","in":"query","name":"orderBy","schema":{"type":"string"}},{"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.","in":"query","name":"pageSize","schema":{"type":"integer"}},{"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.","in":"query","name":"pageToken","schema":{"type":"string"}},{"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.","in":"query","name":"printerOrgUnitId","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleChromeManagementV1EnumeratePrintJobsResponse"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/chrome.management.reports.readonly"],"Oauth2c":["https://www.googleapis.com/auth/chrome.management.reports.readonly"]}],"tags":["customers"]},"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}]},"/v1/{customer}/reports:findInstalledAppDevices":{"get":{"description":"Generate report of managed Chrome browser devices that have a specified app installed.","operationId":"chromemanagement.customers.reports.findInstalledAppDevices","parameters":[{"description":"Required. Customer id or \"my_customer\" to use the customer associated to the account making the request.","in":"path","name":"customer","required":true,"schema":{"type":"string"}},{"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).","in":"query","name":"appId","schema":{"type":"string"}},{"description":"Type of the app.","in":"query","name":"appType","schema":{"enum":["APP_TYPE_UNSPECIFIED","EXTENSION","APP","THEME","HOSTED_APP","ANDROID_APP"],"type":"string"}},{"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","in":"query","name":"filter","schema":{"type":"string"}},{"description":"Field used to order results. Supported order by fields: * machine * device_id","in":"query","name":"orderBy","schema":{"type":"string"}},{"description":"The ID of the organizational unit.","in":"query","name":"orgUnitId","schema":{"type":"string"}},{"description":"Maximum number of results to return. Maximum and default are 100.","in":"query","name":"pageSize","schema":{"type":"integer"}},{"description":"Token to specify the page of the request to be returned.","in":"query","name":"pageToken","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleChromeManagementV1FindInstalledAppDevicesResponse"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/chrome.management.reports.readonly"],"Oauth2c":["https://www.googleapis.com/auth/chrome.management.reports.readonly"]}],"tags":["customers"]},"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}]},"/v1/{name}":{"delete":{"description":"Delete a telemetry notification config.","operationId":"chromemanagement.customers.telemetry.notificationConfigs.delete","parameters":[{"description":"Required. The name of the notification config to delete. Format: `customers/{customer}/telemetry/notificationConfigs/{notification_config}`","in":"path","name":"name","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleProtobufEmpty"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/chrome.management.telemetry.readonly"],"Oauth2c":["https://www.googleapis.com/auth/chrome.management.telemetry.readonly"]}],"tags":["customers"]},"get":{"description":"Get telemetry user.","operationId":"chromemanagement.customers.telemetry.users.get","parameters":[{"description":"Required. Name of the `TelemetryUser` to return.","in":"path","name":"name","required":true,"schema":{"type":"string"}},{"description":"Read mask to specify which fields to return.","in":"query","name":"readMask","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleChromeManagementV1TelemetryUser"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/chrome.management.telemetry.readonly"],"Oauth2c":["https://www.googleapis.com/auth/chrome.management.telemetry.readonly"]}],"tags":["customers"]},"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}]},"/v1/{parent}/telemetry/devices":{"get":{"description":"List all telemetry devices.","operationId":"chromemanagement.customers.telemetry.devices.list","parameters":[{"description":"Required. Customer id or \"my_customer\" to use the customer associated to the account making the request.","in":"path","name":"parent","required":true,"schema":{"type":"string"}},{"description":"Optional. Only include resources that match the filter. Supported filter fields: - org_unit_id - serial_number - device_id - reports_timestamp The \"reports_timestamp\" filter accepts either the Unix Epoch milliseconds format or the RFC3339 UTC \"Zulu\" format with nanosecond resolution and up to nine fractional digits. Both formats should be surrounded by simple double quotes. Examples: \"2014-10-02T15:01:23Z\", \"2014-10-02T15:01:23.045123456Z\", \"1679283943823\".","in":"query","name":"filter","schema":{"type":"string"}},{"description":"Maximum number of results to return. Default value is 100. Maximum value is 1000.","in":"query","name":"pageSize","schema":{"type":"integer"}},{"description":"Token to specify next page in the list.","in":"query","name":"pageToken","schema":{"type":"string"}},{"description":"Required. Read mask to specify which fields to return.","in":"query","name":"readMask","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleChromeManagementV1ListTelemetryDevicesResponse"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/chrome.management.telemetry.readonly"],"Oauth2c":["https://www.googleapis.com/auth/chrome.management.telemetry.readonly"]}],"tags":["customers"]},"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}]},"/v1/{parent}/telemetry/events":{"get":{"description":"List telemetry events.","operationId":"chromemanagement.customers.telemetry.events.list","parameters":[{"description":"Required. Customer id or \"my_customer\" to use the customer associated to the account making the request.","in":"path","name":"parent","required":true,"schema":{"type":"string"}},{"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\".","in":"query","name":"filter","schema":{"type":"string"}},{"description":"Optional. Maximum number of results to return. Default value is 100. Maximum value is 1000.","in":"query","name":"pageSize","schema":{"type":"integer"}},{"description":"Optional. Token to specify next page in the list.","in":"query","name":"pageToken","schema":{"type":"string"}},{"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.","in":"query","name":"readMask","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleChromeManagementV1ListTelemetryEventsResponse"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/chrome.management.telemetry.readonly"],"Oauth2c":["https://www.googleapis.com/auth/chrome.management.telemetry.readonly"]}],"tags":["customers"]},"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}]},"/v1/{parent}/telemetry/notificationConfigs":{"get":{"description":"List all telemetry notification configs.","operationId":"chromemanagement.customers.telemetry.notificationConfigs.list","parameters":[{"description":"Required. The parent which owns the notification configs.","in":"path","name":"parent","required":true,"schema":{"type":"string"}},{"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.","in":"query","name":"pageSize","schema":{"type":"integer"}},{"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.","in":"query","name":"pageToken","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleChromeManagementV1ListTelemetryNotificationConfigsResponse"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/chrome.management.telemetry.readonly"],"Oauth2c":["https://www.googleapis.com/auth/chrome.management.telemetry.readonly"]}],"tags":["customers"]},"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}],"post":{"description":"Create a telemetry notification config.","operationId":"chromemanagement.customers.telemetry.notificationConfigs.create","parameters":[{"description":"Required. The parent resource where this notification config will be created. Format: `customers/{customer}`","in":"path","name":"parent","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleChromeManagementV1TelemetryNotificationConfig"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleChromeManagementV1TelemetryNotificationConfig"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/chrome.management.telemetry.readonly"],"Oauth2c":["https://www.googleapis.com/auth/chrome.management.telemetry.readonly"]}],"tags":["customers"]}},"/v1/{parent}/telemetry/users":{"get":{"description":"List all telemetry users.","operationId":"chromemanagement.customers.telemetry.users.list","parameters":[{"description":"Required. Customer id or \"my_customer\" to use the customer associated to the account making the request.","in":"path","name":"parent","required":true,"schema":{"type":"string"}},{"description":"Only include resources that match the filter. Supported filter fields: - user_id - user_org_unit_id ","in":"query","name":"filter","schema":{"type":"string"}},{"description":"Maximum number of results to return. Default value is 100. Maximum value is 1000.","in":"query","name":"pageSize","schema":{"type":"integer"}},{"description":"Token to specify next page in the list.","in":"query","name":"pageToken","schema":{"type":"string"}},{"description":"Read mask to specify which fields to return.","in":"query","name":"readMask","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleChromeManagementV1ListTelemetryUsersResponse"}}},"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/chrome.management.telemetry.readonly"],"Oauth2c":["https://www.googleapis.com/auth/chrome.management.telemetry.readonly"]}],"tags":["customers"]},"parameters":[{"$ref":"#/components/parameters/_.xgafv"},{"$ref":"#/components/parameters/access_token"},{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/callback"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/upload_protocol"},{"$ref":"#/components/parameters/uploadType"}]}},"components":{"parameters":{"_.xgafv":{"description":"V1 error format.","in":"query","name":"$.xgafv","schema":{"enum":["1","2"],"type":"string"}},"access_token":{"description":"OAuth access token.","in":"query","name":"access_token","schema":{"type":"string"}},"alt":{"description":"Data format for response.","in":"query","name":"alt","schema":{"enum":["json","media","proto"],"type":"string"}},"callback":{"description":"JSONP","in":"query","name":"callback","schema":{"type":"string"}},"fields":{"description":"Selector specifying which fields to include in a partial response.","in":"query","name":"fields","schema":{"type":"string"}},"key":{"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.","in":"query","name":"key","schema":{"type":"string"}},"oauth_token":{"description":"OAuth 2.0 token for the current user.","in":"query","name":"oauth_token","schema":{"type":"string"}},"prettyPrint":{"description":"Returns response with indentations and line breaks.","in":"query","name":"prettyPrint","schema":{"type":"boolean"}},"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.","in":"query","name":"quotaUser","schema":{"type":"string"}},"uploadType":{"description":"Legacy upload protocol for media (e.g. \"media\", \"multipart\").","in":"query","name":"uploadType","schema":{"type":"string"}},"upload_protocol":{"description":"Upload protocol for media (e.g. \"raw\", \"multipart\").","in":"query","name":"upload_protocol","schema":{"type":"string"}}},"schemas":{"GoogleChromeManagementV1AndroidAppInfo":{"description":"Android app information.","properties":{"permissions":{"description":"Output only. Permissions requested by an Android app.","items":{"$ref":"#/components/schemas/GoogleChromeManagementV1AndroidAppPermission"},"readOnly":true,"type":"array"}},"type":"object"},"GoogleChromeManagementV1AndroidAppPermission":{"description":"Permission requested by an Android app.","properties":{"type":{"description":"Output only. The type of the permission.","readOnly":true,"type":"string"}},"type":"object"},"GoogleChromeManagementV1AppDetails":{"description":"Resource representing app details.","properties":{"androidAppInfo":{"$ref":"#/components/schemas/GoogleChromeManagementV1AndroidAppInfo","description":"Output only. Android app information.","readOnly":true},"appId":{"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,"type":"string"},"chromeAppInfo":{"$ref":"#/components/schemas/GoogleChromeManagementV1ChromeAppInfo","description":"Output only. Chrome Web Store app information.","readOnly":true},"description":{"description":"Output only. App's description.","readOnly":true,"type":"string"},"detailUri":{"description":"Output only. The uri for the detail page of the item.","readOnly":true,"type":"string"},"displayName":{"description":"Output only. App's display name.","readOnly":true,"type":"string"},"firstPublishTime":{"description":"Output only. First published time.","format":"google-datetime","readOnly":true,"type":"string"},"homepageUri":{"description":"Output only. Home page or Website uri.","readOnly":true,"type":"string"},"iconUri":{"description":"Output only. A link to an image that can be used as an icon for the product.","readOnly":true,"type":"string"},"isPaidApp":{"description":"Output only. Indicates if the app has to be paid for OR has paid content.","readOnly":true,"type":"boolean"},"latestPublishTime":{"description":"Output only. Latest published time.","format":"google-datetime","readOnly":true,"type":"string"},"name":{"description":"Output only. Format: name=customers/{customer_id}/apps/{chrome|android|web}/{app_id}@{version}","readOnly":true,"type":"string"},"privacyPolicyUri":{"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.","readOnly":true,"type":"string"},"publisher":{"description":"Output only. The publisher of the item.","readOnly":true,"type":"string"},"reviewNumber":{"description":"Output only. Number of reviews received. Chrome Web Store review information will always be for the latest version of an app.","format":"int64","readOnly":true,"type":"string"},"reviewRating":{"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","readOnly":true,"type":"number"},"revisionId":{"description":"Output only. App version. A new revision is committed whenever a new version of the app is published.","readOnly":true,"type":"string"},"serviceError":{"$ref":"#/components/schemas/GoogleRpcStatus","description":"Output only. Information about a partial service error if applicable.","readOnly":true},"type":{"description":"Output only. App type.","enum":["APP_ITEM_TYPE_UNSPECIFIED","CHROME","ANDROID","WEB"],"readOnly":true,"type":"string"}},"type":"object"},"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","properties":{"inputDevice":{"description":"Output only. Active input device's name.","readOnly":true,"type":"string"},"inputGain":{"description":"Output only. Active input device's gain in [0, 100].","format":"int32","readOnly":true,"type":"integer"},"inputMute":{"description":"Output only. Is active input device mute or not.","readOnly":true,"type":"boolean"},"outputDevice":{"description":"Output only. Active output device's name.","readOnly":true,"type":"string"},"outputMute":{"description":"Output only. Is active output device mute or not.","readOnly":true,"type":"boolean"},"outputVolume":{"description":"Output only. Active output device's volume in [0, 100].","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"}},"type":"object"},"GoogleChromeManagementV1BatteryInfo":{"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","properties":{"designCapacity":{"description":"Output only. Design capacity (mAmpere-hours).","format":"int64","readOnly":true,"type":"string"},"designMinVoltage":{"description":"Output only. Designed minimum output voltage (mV)","format":"int32","readOnly":true,"type":"integer"},"manufactureDate":{"$ref":"#/components/schemas/GoogleTypeDate","description":"Output only. The date the battery was manufactured.","readOnly":true},"manufacturer":{"description":"Output only. Battery manufacturer.","readOnly":true,"type":"string"},"serialNumber":{"description":"Output only. Battery serial number.","readOnly":true,"type":"string"},"technology":{"description":"Output only. Technology of the battery. Example: Li-ion","readOnly":true,"type":"string"}},"type":"object"},"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":{"chargeRate":{"description":"Output only. Battery charge percentage.","format":"int32","readOnly":true,"type":"integer"},"current":{"description":"Output only. Battery current (mA).","format":"int64","readOnly":true,"type":"string"},"dischargeRate":{"description":"Output only. The battery discharge rate measured in mW. Positive if the battery is being discharged, negative if it's being charged.","format":"int32","readOnly":true,"type":"integer"},"remainingCapacity":{"description":"Output only. Battery remaining capacity (mAmpere-hours).","format":"int64","readOnly":true,"type":"string"},"reportTime":{"description":"Output only. Timestamp of when the sample was collected on device","format":"google-datetime","readOnly":true,"type":"string"},"status":{"description":"Output only. Battery status read from sysfs. Example: Discharging","readOnly":true,"type":"string"},"temperature":{"description":"Output only. Temperature in Celsius degrees.","format":"int32","readOnly":true,"type":"integer"},"voltage":{"description":"Output only. Battery voltage (millivolt).","format":"int64","readOnly":true,"type":"string"}},"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":{"description":"Output only. Battery health.","enum":["BATTERY_HEALTH_UNSPECIFIED","BATTERY_HEALTH_NORMAL","BATTERY_REPLACE_SOON","BATTERY_REPLACE_NOW"],"readOnly":true,"type":"string"},"cycleCount":{"description":"Output only. Cycle count.","format":"int32","readOnly":true,"type":"integer"},"fullChargeCapacity":{"description":"Output only. Full charge capacity (mAmpere-hours).","format":"int64","readOnly":true,"type":"string"},"reportTime":{"description":"Output only. Timestamp of when the sample was collected on device","format":"google-datetime","readOnly":true,"type":"string"},"sample":{"description":"Output only. Sampling data for the battery sorted in a decreasing order of report_time.","items":{"$ref":"#/components/schemas/GoogleChromeManagementV1BatterySampleReport"},"readOnly":true,"type":"array"},"serialNumber":{"description":"Output only. Battery serial number.","readOnly":true,"type":"string"}},"type":"object"},"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":{"description":"Total time to boot up.","format":"google-duration","type":"string"},"bootUpTime":{"description":"The timestamp when power came on.","format":"google-datetime","type":"string"},"reportTime":{"description":"Timestamp when the report was collected.","format":"google-datetime","type":"string"},"shutdownDuration":{"description":"Total time since shutdown start to power off.","format":"google-duration","type":"string"},"shutdownReason":{"description":"The shutdown reason.","enum":["SHUTDOWN_REASON_UNSPECIFIED","USER_REQUEST","SYSTEM_UPDATE","LOW_BATTERY","OTHER"],"type":"string"},"shutdownTime":{"description":"The timestamp when shutdown.","format":"google-datetime","type":"string"}},"type":"object"},"GoogleChromeManagementV1BrowserVersion":{"description":"Describes a browser version and its install count.","properties":{"channel":{"description":"Output only. The release channel of the installed browser.","enum":["RELEASE_CHANNEL_UNSPECIFIED","CANARY","DEV","BETA","STABLE"],"readOnly":true,"type":"string"},"count":{"description":"Output only. Count grouped by device_system and major version","format":"int64","readOnly":true,"type":"string"},"deviceOsVersion":{"description":"Output only. Version of the system-specified operating system.","readOnly":true,"type":"string"},"system":{"description":"Output only. The device operating system.","enum":["DEVICE_SYSTEM_UNSPECIFIED","SYSTEM_OTHER","SYSTEM_ANDROID","SYSTEM_IOS","SY