From 0c817482a79c27eadd04a883fb034f0b2683ef5c Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 19 Mar 2024 07:08:18 +0000 Subject: [PATCH] feat(chromemanagement): update the api #### chromemanagement:v1 The following keys were added: - resources.customers.resources.apps.methods.fetchDevicesRequestingExtension (Total Keys: 20) - resources.customers.resources.apps.methods.fetchUsersRequestingExtension (Total Keys: 20) - resources.customers.resources.reports.methods.countChromeCrashEvents (Total Keys: 17) - schemas.GoogleChromeManagementV1CountChromeCrashEventsResponse (Total Keys: 10) - schemas.GoogleChromeManagementV1DeviceRequestingExtensionDetails (Total Keys: 4) - schemas.GoogleChromeManagementV1FetchDevicesRequestingExtensionResponse (Total Keys: 7) - schemas.GoogleChromeManagementV1FetchUsersRequestingExtensionResponse (Total Keys: 7) - schemas.GoogleChromeManagementV1UserRequestingExtensionDetails (Total Keys: 4) --- .../chromemanagement_v1.customers.apps.html | 100 +++++++ ...chromemanagement_v1.customers.reports.html | 35 +++ .../documents/chromemanagement.v1.json | 244 +++++++++++++++++- 3 files changed, 378 insertions(+), 1 deletion(-) diff --git a/docs/dyn/chromemanagement_v1.customers.apps.html b/docs/dyn/chromemanagement_v1.customers.apps.html index 78d35a4a65d..c116650aa0f 100644 --- a/docs/dyn/chromemanagement_v1.customers.apps.html +++ b/docs/dyn/chromemanagement_v1.customers.apps.html @@ -98,6 +98,18 @@

Instance Methods

countChromeAppRequests_next()

Retrieves the next page of results.

+

+ fetchDevicesRequestingExtension(customer, extensionId=None, orgUnitId=None, pageSize=None, pageToken=None, x__xgafv=None)

+

Get a list of devices that have requested to install an extension.

+

+ fetchDevicesRequestingExtension_next()

+

Retrieves the next page of results.

+

+ fetchUsersRequestingExtension(customer, extensionId=None, orgUnitId=None, pageSize=None, pageToken=None, x__xgafv=None)

+

Get a list of users that have requested to install an extension.

+

+ fetchUsersRequestingExtension_next()

+

Retrieves the next page of results.

Method Details

close() @@ -153,4 +165,92 @@

Method Details

+
+ fetchDevicesRequestingExtension(customer, extensionId=None, orgUnitId=None, pageSize=None, pageToken=None, x__xgafv=None) + 
Get a list of devices that have requested to install an extension.
+
+Args:
+  customer: string, Required. The customer ID or "my_customer" prefixed with "customers/". (required)
+  extensionId: string, Required. The extension for which we want to find requesting devices.
+  orgUnitId: string, 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.
+  pageSize: integer, Optional. Maximum number of results to return. Maximum and default are 50. Any page size larger than 50 will be coerced to 50.
+  pageToken: string, Optional. Token to specify the page of the request to be returned. Token expires after 1 day.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Response containing a list of devices that have requested the queried extension.
+  "deviceDetails": [ # Details of devices that have requested the queried extension.
+    { # Details of a device requesting an extension, including the name of the device and the justification of the request.
+      "deviceName": "A String", # The name of a device that has requested the extension.
+      "justification": "A String", # Request justification as entered by the user.
+    },
+  ],
+  "nextPageToken": "A String", # Optional. Token to specify the next page in the list. Token expires after 1 day.
+  "totalSize": 42, # Optional. Total number of devices in response.
+}
+
+ +
+ fetchDevicesRequestingExtension_next() + 
Retrieves the next page of results.
+
+        Args:
+          previous_request: The request for the previous page. (required)
+          previous_response: The response from the request for the previous page. (required)
+
+        Returns:
+          A request object that you can call 'execute()' on to request the next
+          page. Returns None if there are no more items in the collection.
+
+
+ +
+ fetchUsersRequestingExtension(customer, extensionId=None, orgUnitId=None, pageSize=None, pageToken=None, x__xgafv=None) + 
Get a list of users that have requested to install an extension.
+
+Args:
+  customer: string, Required. The customer ID or "my_customer" prefixed with "customers/". (required)
+  extensionId: string, Required. The extension for which we want to find the requesting users.
+  orgUnitId: string, 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.
+  pageSize: integer, Optional. Maximum number of results to return. Maximum and default are 50. Any page size larger than 50 will be coerced to 50.
+  pageToken: string, Optional. Token to specify the page of the request to be returned. Token expires after 1 day.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Response containing a list of users that have requested the queried extension.
+  "nextPageToken": "A String", # Token to specify the next page in the list.
+  "totalSize": 42, # Total number of users in response.
+  "userDetails": [ # Details of users that have requested the queried extension.
+    { # Details of a user requesting an extension, including the email and the justification.
+      "email": "A String", # The e-mail address of a user that has requested the extension.
+      "justification": "A String", # Request justification as entered by the user.
+    },
+  ],
+}
+
+ +
+ fetchUsersRequestingExtension_next() + 
Retrieves the next page of results.
+
+        Args:
+          previous_request: The request for the previous page. (required)
+          previous_response: The response from the request for the previous page. (required)
+
+        Returns:
+          A request object that you can call 'execute()' on to request the next
+          page. Returns None if there are no more items in the collection.
+
+
+ \ No newline at end of file diff --git a/docs/dyn/chromemanagement_v1.customers.reports.html b/docs/dyn/chromemanagement_v1.customers.reports.html index 8ac9d3f116b..018ba0b2858 100644 --- a/docs/dyn/chromemanagement_v1.customers.reports.html +++ b/docs/dyn/chromemanagement_v1.customers.reports.html @@ -80,6 +80,9 @@

Instance Methods

countChromeBrowsersNeedingAttention(customer, orgUnitId=None, x__xgafv=None)

Count of Chrome Browsers that have been recently enrolled, have new policy to be synced, or have no recent activity.

+

+ countChromeCrashEvents(customer, filter=None, orderBy=None, orgUnitId=None, x__xgafv=None)

+

Get a count of Chrome crash events.

countChromeDevicesReachingAutoExpirationDate(customer, maxAueDate=None, minAueDate=None, orgUnitId=None, x__xgafv=None)

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).

@@ -153,6 +156,38 @@

Method Details

} +
+ countChromeCrashEvents(customer, filter=None, orderBy=None, orgUnitId=None, x__xgafv=None) + 
Get a count of Chrome crash events.
+
+Args:
+  customer: string, Customer ID. (required)
+  filter: string, 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: string, Field used to order results. Supported order by fields: * browser_version * count * date
+  orgUnitId: string, If specified, only count the number of crash events of the devices in this organizational unit.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Response contains a list of CrashEventCountByVersionPerDay which count the chrome crash at the certain date.
+  "crashEventCounts": [ # Crash event counts grouped by date and browser version.
+    { # The `count` of the Chrome crash events at the `date`.
+      "browserVersion": "A String", # Browser version this is counting.
+      "count": "A String", # Total count of crash events.
+      "date": { # 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 # Date of the crash event.
+        "day": 42, # Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.
+        "month": 42, # Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
+        "year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
+      },
+    },
+  ],
+}
+
+
countChromeDevicesReachingAutoExpirationDate(customer, maxAueDate=None, minAueDate=None, orgUnitId=None, x__xgafv=None) 
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).
diff --git a/googleapiclient/discovery_cache/documents/chromemanagement.v1.json b/googleapiclient/discovery_cache/documents/chromemanagement.v1.json
index c0934bea64b..69e1fe23760 100644
--- a/googleapiclient/discovery_cache/documents/chromemanagement.v1.json
+++ b/googleapiclient/discovery_cache/documents/chromemanagement.v1.json
@@ -160,6 +160,98 @@
 "scopes": [
 "https://www.googleapis.com/auth/chrome.management.appdetails.readonly"
 ]
+},
+"fetchDevicesRequestingExtension": {
+"description": "Get a list of devices that have requested to install an extension.",
+"flatPath": "v1/customers/{customersId}/apps:fetchDevicesRequestingExtension",
+"httpMethod": "GET",
+"id": "chromemanagement.customers.apps.fetchDevicesRequestingExtension",
+"parameterOrder": [
+"customer"
+],
+"parameters": {
+"customer": {
+"description": "Required. The customer ID or \"my_customer\" prefixed with \"customers/\".",
+"location": "path",
+"pattern": "^customers/[^/]+$",
+"required": true,
+"type": "string"
+},
+"extensionId": {
+"description": "Required. The extension for which we want to find requesting devices.",
+"location": "query",
+"type": "string"
+},
+"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"
+},
+"pageSize": {
+"description": "Optional. Maximum number of results to return. Maximum and default are 50. Any page size larger than 50 will be coerced to 50.",
+"format": "int32",
+"location": "query",
+"type": "integer"
+},
+"pageToken": {
+"description": "Optional. Token to specify the page of the request to be returned. Token expires after 1 day.",
+"location": "query",
+"type": "string"
+}
+},
+"path": "v1/{+customer}/apps:fetchDevicesRequestingExtension",
+"response": {
+"$ref": "GoogleChromeManagementV1FetchDevicesRequestingExtensionResponse"
+},
+"scopes": [
+"https://www.googleapis.com/auth/chrome.management.appdetails.readonly"
+]
+},
+"fetchUsersRequestingExtension": {
+"description": "Get a list of users that have requested to install an extension.",
+"flatPath": "v1/customers/{customersId}/apps:fetchUsersRequestingExtension",
+"httpMethod": "GET",
+"id": "chromemanagement.customers.apps.fetchUsersRequestingExtension",
+"parameterOrder": [
+"customer"
+],
+"parameters": {
+"customer": {
+"description": "Required. The customer ID or \"my_customer\" prefixed with \"customers/\".",
+"location": "path",
+"pattern": "^customers/[^/]+$",
+"required": true,
+"type": "string"
+},
+"extensionId": {
+"description": "Required. The extension for which we want to find the requesting users.",
+"location": "query",
+"type": "string"
+},
+"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"
+},
+"pageSize": {
+"description": "Optional. Maximum number of results to return. Maximum and default are 50. Any page size larger than 50 will be coerced to 50.",
+"format": "int32",
+"location": "query",
+"type": "integer"
+},
+"pageToken": {
+"description": "Optional. Token to specify the page of the request to be returned. Token expires after 1 day.",
+"location": "query",
+"type": "string"
+}
+},
+"path": "v1/{+customer}/apps:fetchUsersRequestingExtension",
+"response": {
+"$ref": "GoogleChromeManagementV1FetchUsersRequestingExtensionResponse"
+},
+"scopes": [
+"https://www.googleapis.com/auth/chrome.management.appdetails.readonly"
+]
 }
 },
 "resources": {
@@ -284,6 +376,46 @@
 "https://www.googleapis.com/auth/chrome.management.reports.readonly"
 ]
 },
+"countChromeCrashEvents": {
+"description": "Get a count of Chrome crash events.",
+"flatPath": "v1/customers/{customersId}/reports:countChromeCrashEvents",
+"httpMethod": "GET",
+"id": "chromemanagement.customers.reports.countChromeCrashEvents",
+"parameterOrder": [
+"customer"
+],
+"parameters": {
+"customer": {
+"description": "Customer ID.",
+"location": "path",
+"pattern": "^customers/[^/]+$",
+"required": true,
+"type": "string"
+},
+"filter": {
+"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'`.",
+"location": "query",
+"type": "string"
+},
+"orderBy": {
+"description": "Field used to order results. Supported order by fields: * browser_version * count * date",
+"location": "query",
+"type": "string"
+},
+"orgUnitId": {
+"description": "If specified, only count the number of crash events of the devices in this organizational unit.",
+"location": "query",
+"type": "string"
+}
+},
+"path": "v1/{+customer}/reports:countChromeCrashEvents",
+"response": {
+"$ref": "GoogleChromeManagementV1CountChromeCrashEventsResponse"
+},
+"scopes": [
+"https://www.googleapis.com/auth/chrome.management.reports.readonly"
+]
+},
 "countChromeDevicesReachingAutoExpirationDate": {
 "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).",
 "flatPath": "v1/customers/{customersId}/reports:countChromeDevicesReachingAutoExpirationDate",
@@ -1040,7 +1172,7 @@
 }
 }
 },
-"revision": "20240310",
+"revision": "20240317",
 "rootUrl": "https://chromemanagement.googleapis.com/",
 "schemas": {
 "GoogleChromeManagementV1AndroidAppInfo": {
@@ -1700,6 +1832,40 @@
 },
 "type": "object"
 },
+"GoogleChromeManagementV1CountChromeCrashEventsResponse": {
+"description": "Response contains a list of CrashEventCountByVersionPerDay which count the chrome crash at the certain date.",
+"id": "GoogleChromeManagementV1CountChromeCrashEventsResponse",
+"properties": {
+"crashEventCounts": {
+"description": "Crash event counts grouped by date and browser version.",
+"items": {
+"$ref": "GoogleChromeManagementV1CountChromeCrashEventsResponseCrashEventCount"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
+"GoogleChromeManagementV1CountChromeCrashEventsResponseCrashEventCount": {
+"description": "The `count` of the Chrome crash events at the `date`.",
+"id": "GoogleChromeManagementV1CountChromeCrashEventsResponseCrashEventCount",
+"properties": {
+"browserVersion": {
+"description": "Browser version this is counting.",
+"type": "string"
+},
+"count": {
+"description": "Total count of crash events.",
+"format": "int64",
+"type": "string"
+},
+"date": {
+"$ref": "GoogleTypeDate",
+"description": "Date of the crash event."
+}
+},
+"type": "object"
+},
 "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.",
 "id": "GoogleChromeManagementV1CountChromeDevicesReachingAutoExpirationDateResponse",
@@ -2087,6 +2253,21 @@
 },
 "type": "object"
 },
+"GoogleChromeManagementV1DeviceRequestingExtensionDetails": {
+"description": "Details of a device requesting an extension, including the name of the device and the justification of the request.",
+"id": "GoogleChromeManagementV1DeviceRequestingExtensionDetails",
+"properties": {
+"deviceName": {
+"description": "The name of a device that has requested the extension.",
+"type": "string"
+},
+"justification": {
+"description": "Request justification as entered by the user.",
+"type": "string"
+}
+},
+"type": "object"
+},
 "GoogleChromeManagementV1DiskInfo": {
 "description": "Status of the single storage device.",
 "id": "GoogleChromeManagementV1DiskInfo",
@@ -2279,6 +2460,52 @@
 },
 "type": "object"
 },
+"GoogleChromeManagementV1FetchDevicesRequestingExtensionResponse": {
+"description": "Response containing a list of devices that have requested the queried extension.",
+"id": "GoogleChromeManagementV1FetchDevicesRequestingExtensionResponse",
+"properties": {
+"deviceDetails": {
+"description": "Details of devices that have requested the queried extension.",
+"items": {
+"$ref": "GoogleChromeManagementV1DeviceRequestingExtensionDetails"
+},
+"type": "array"
+},
+"nextPageToken": {
+"description": "Optional. Token to specify the next page in the list. Token expires after 1 day.",
+"type": "string"
+},
+"totalSize": {
+"description": "Optional. Total number of devices in response.",
+"format": "int32",
+"type": "integer"
+}
+},
+"type": "object"
+},
+"GoogleChromeManagementV1FetchUsersRequestingExtensionResponse": {
+"description": "Response containing a list of users that have requested the queried extension.",
+"id": "GoogleChromeManagementV1FetchUsersRequestingExtensionResponse",
+"properties": {
+"nextPageToken": {
+"description": "Token to specify the next page in the list.",
+"type": "string"
+},
+"totalSize": {
+"description": "Total number of users in response.",
+"format": "int32",
+"type": "integer"
+},
+"userDetails": {
+"description": "Details of users that have requested the queried extension.",
+"items": {
+"$ref": "GoogleChromeManagementV1UserRequestingExtensionDetails"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
 "GoogleChromeManagementV1FindInstalledAppDevicesResponse": {
 "description": "Response containing a list of devices with queried app installed.",
 "id": "GoogleChromeManagementV1FindInstalledAppDevicesResponse",
@@ -3988,6 +4215,21 @@
 },
 "type": "object"
 },
+"GoogleChromeManagementV1UserRequestingExtensionDetails": {
+"description": "Details of a user requesting an extension, including the email and the justification.",
+"id": "GoogleChromeManagementV1UserRequestingExtensionDetails",
+"properties": {
+"email": {
+"description": "The e-mail address of a user that has requested the extension.",
+"type": "string"
+},
+"justification": {
+"description": "Request justification as entered by the user.",
+"type": "string"
+}
+},
+"type": "object"
+},
 "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); }",
 "id": "GoogleProtobufEmpty",