diff --git a/discovery/chromemanagement-v1.json b/discovery/chromemanagement-v1.json index 32f3e51d685..bdf519ae2b7 100644 --- a/discovery/chromemanagement-v1.json +++ b/discovery/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": { @@ -746,7 +838,7 @@ "type": "string" }, "readMask": { - "description": "Required. Read mask to specify which fields to return.", + "description": "Required. Read mask to specify which fields to return. Supported read_mask paths are: - name - org_unit_id - device_id - serial_number - cpu_info - cpu_status_report - memory_info - memory_status_report - network_info - network_diagnostics_report - network_status_report - os_update_status - graphics_info - graphics_status_report - battery_info - battery_status_report - storage_info - storage_status_report - thunderbolt_info - audio_status_report - boot_performance_report - heartbeat_status_report - network_bandwidth_report - peripherals_report - kiosk_app_status_report - app_report - runtime_counters_report ", "format": "google-fieldmask", "location": "query", "type": "string" @@ -793,7 +885,7 @@ "type": "string" }, "readMask": { - "description": "Required. Read mask to specify which fields to return.", + "description": "Required. Read mask to specify which fields to return. Supported read_mask paths are: - name - org_unit_id - device_id - serial_number - cpu_info - cpu_status_report - memory_info - memory_status_report - network_info - network_diagnostics_report - network_status_report - os_update_status - graphics_info - graphics_status_report - battery_info - battery_status_report - storage_info - storage_status_report - thunderbolt_info - audio_status_report - boot_performance_report - heartbeat_status_report - network_bandwidth_report - peripherals_report - kiosk_app_status_report - app_report - runtime_counters_report ", "format": "google-fieldmask", "location": "query", "type": "string" @@ -844,7 +936,7 @@ "type": "string" }, "readMask": { - "description": "Required. Read mask to specify which fields to return. Although currently required, this field will become optional, while the filter parameter with an event type will be come required.", + "description": "Required. Read mask to specify which fields to return. Although currently required, this field will become optional, while the filter parameter with an event type will be come required. Supported read_mask paths are: - device - user - audio_severe_underrun_event - usb_peripherals_event - https_latency_change_event - network_state_change_event - wifi_signal_strength_event - vpn_connection_state_change_event - app_install_event - app_uninstall_event - app_launch_event ", "format": "google-fieldmask", "location": "query", "type": "string" @@ -972,7 +1064,7 @@ "type": "string" }, "readMask": { - "description": "Read mask to specify which fields to return.", + "description": "Read mask to specify which fields to return. Supported read_mask paths are: - name - org_unit_id - user_id - user_email - user_device.device_id - user_device.audio_status_report - user_device.device_activity_report - user_device.network_bandwidth_report - user_device.peripherals_report ", "format": "google-fieldmask", "location": "query", "type": "string" @@ -1019,7 +1111,7 @@ "type": "string" }, "readMask": { - "description": "Read mask to specify which fields to return.", + "description": "Read mask to specify which fields to return. Supported read_mask paths are: - name - org_unit_id - user_id - user_email - user_device.device_id - user_device.audio_status_report - user_device.device_activity_report - user_device.network_bandwidth_report - user_device.peripherals_report ", "format": "google-fieldmask", "location": "query", "type": "string" @@ -1040,7 +1132,7 @@ } } }, - "revision": "20240227", + "revision": "20240312", "rootUrl": "https://chromemanagement.googleapis.com/", "schemas": { "GoogleChromeManagementV1AndroidAppInfo": { @@ -2087,6 +2179,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 +2386,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 +4141,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", diff --git a/src/apis/chromemanagement/v1.ts b/src/apis/chromemanagement/v1.ts index 16ceae4d81c..b989b35e4ff 100644 --- a/src/apis/chromemanagement/v1.ts +++ b/src/apis/chromemanagement/v1.ts @@ -793,6 +793,19 @@ export namespace chromemanagement_v1 { */ count?: string | null; } + /** + * Details of a device requesting an extension, including the name of the device and the justification of the request. + */ + export interface Schema$GoogleChromeManagementV1DeviceRequestingExtensionDetails { + /** + * The name of a device that has requested the extension. + */ + deviceName?: string | null; + /** + * Request justification as entered by the user. + */ + justification?: string | null; + } /** * Status of the single storage device. */ @@ -929,6 +942,40 @@ export namespace chromemanagement_v1 { */ totalSize?: string | null; } + /** + * Response containing a list of devices that have requested the queried extension. + */ + export interface Schema$GoogleChromeManagementV1FetchDevicesRequestingExtensionResponse { + /** + * Details of devices that have requested the queried extension. + */ + deviceDetails?: Schema$GoogleChromeManagementV1DeviceRequestingExtensionDetails[]; + /** + * Optional. Token to specify the next page in the list. Token expires after 1 day. + */ + nextPageToken?: string | null; + /** + * Optional. Total number of devices in response. + */ + totalSize?: number | null; + } + /** + * Response containing a list of users that have requested the queried extension. + */ + export interface Schema$GoogleChromeManagementV1FetchUsersRequestingExtensionResponse { + /** + * Token to specify the next page in the list. + */ + nextPageToken?: string | null; + /** + * Total number of users in response. + */ + totalSize?: number | null; + /** + * Details of users that have requested the queried extension. + */ + userDetails?: Schema$GoogleChromeManagementV1UserRequestingExtensionDetails[]; + } /** * Response containing a list of devices with queried app installed. */ @@ -1972,6 +2019,19 @@ export namespace chromemanagement_v1 { */ userId?: string | null; } + /** + * Details of a user requesting an extension, including the email and the justification. + */ + export interface Schema$GoogleChromeManagementV1UserRequestingExtensionDetails { + /** + * The e-mail address of a user that has requested the extension. + */ + email?: string | null; + /** + * Request justification as entered by the user. + */ + justification?: string | null; + } /** * 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); \} */ @@ -2131,6 +2191,200 @@ export namespace chromemanagement_v1 { ); } } + + /** + * Get a list of devices that have requested to install an extension. + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + fetchDevicesRequestingExtension( + params: Params$Resource$Customers$Apps$Fetchdevicesrequestingextension, + options: StreamMethodOptions + ): GaxiosPromise; + fetchDevicesRequestingExtension( + params?: Params$Resource$Customers$Apps$Fetchdevicesrequestingextension, + options?: MethodOptions + ): GaxiosPromise; + fetchDevicesRequestingExtension( + params: Params$Resource$Customers$Apps$Fetchdevicesrequestingextension, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + fetchDevicesRequestingExtension( + params: Params$Resource$Customers$Apps$Fetchdevicesrequestingextension, + options: + | MethodOptions + | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + fetchDevicesRequestingExtension( + params: Params$Resource$Customers$Apps$Fetchdevicesrequestingextension, + callback: BodyResponseCallback + ): void; + fetchDevicesRequestingExtension( + callback: BodyResponseCallback + ): void; + fetchDevicesRequestingExtension( + paramsOrCallback?: + | Params$Resource$Customers$Apps$Fetchdevicesrequestingextension + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): + | void + | GaxiosPromise + | GaxiosPromise { + let params = (paramsOrCallback || + {}) as Params$Resource$Customers$Apps$Fetchdevicesrequestingextension; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = + {} as Params$Resource$Customers$Apps$Fetchdevicesrequestingextension; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = + options.rootUrl || 'https://chromemanagement.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: ( + rootUrl + '/v1/{+customer}/apps:fetchDevicesRequestingExtension' + ).replace(/([^:]\/)\/+/g, '$1'), + method: 'GET', + }, + options + ), + params, + requiredParams: ['customer'], + pathParams: ['customer'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest( + parameters + ); + } + } + + /** + * Get a list of users that have requested to install an extension. + * + * @param params - Parameters for request + * @param options - Optionally override request options, such as `url`, `method`, and `encoding`. + * @param callback - Optional callback that handles the response. + * @returns A promise if used with async/await, or void if used with a callback. + */ + fetchUsersRequestingExtension( + params: Params$Resource$Customers$Apps$Fetchusersrequestingextension, + options: StreamMethodOptions + ): GaxiosPromise; + fetchUsersRequestingExtension( + params?: Params$Resource$Customers$Apps$Fetchusersrequestingextension, + options?: MethodOptions + ): GaxiosPromise; + fetchUsersRequestingExtension( + params: Params$Resource$Customers$Apps$Fetchusersrequestingextension, + options: StreamMethodOptions | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + fetchUsersRequestingExtension( + params: Params$Resource$Customers$Apps$Fetchusersrequestingextension, + options: + | MethodOptions + | BodyResponseCallback, + callback: BodyResponseCallback + ): void; + fetchUsersRequestingExtension( + params: Params$Resource$Customers$Apps$Fetchusersrequestingextension, + callback: BodyResponseCallback + ): void; + fetchUsersRequestingExtension( + callback: BodyResponseCallback + ): void; + fetchUsersRequestingExtension( + paramsOrCallback?: + | Params$Resource$Customers$Apps$Fetchusersrequestingextension + | BodyResponseCallback + | BodyResponseCallback, + optionsOrCallback?: + | MethodOptions + | StreamMethodOptions + | BodyResponseCallback + | BodyResponseCallback, + callback?: + | BodyResponseCallback + | BodyResponseCallback + ): + | void + | GaxiosPromise + | GaxiosPromise { + let params = (paramsOrCallback || + {}) as Params$Resource$Customers$Apps$Fetchusersrequestingextension; + let options = (optionsOrCallback || {}) as MethodOptions; + + if (typeof paramsOrCallback === 'function') { + callback = paramsOrCallback; + params = + {} as Params$Resource$Customers$Apps$Fetchusersrequestingextension; + options = {}; + } + + if (typeof optionsOrCallback === 'function') { + callback = optionsOrCallback; + options = {}; + } + + const rootUrl = + options.rootUrl || 'https://chromemanagement.googleapis.com/'; + const parameters = { + options: Object.assign( + { + url: ( + rootUrl + '/v1/{+customer}/apps:fetchUsersRequestingExtension' + ).replace(/([^:]\/)\/+/g, '$1'), + method: 'GET', + }, + options + ), + params, + requiredParams: ['customer'], + pathParams: ['customer'], + context: this.context, + }; + if (callback) { + createAPIRequest( + parameters, + callback as BodyResponseCallback + ); + } else { + return createAPIRequest( + parameters + ); + } + } } export interface Params$Resource$Customers$Apps$Countchromeapprequests @@ -2156,6 +2410,52 @@ export namespace chromemanagement_v1 { */ pageToken?: string; } + export interface Params$Resource$Customers$Apps$Fetchdevicesrequestingextension + extends StandardParameters { + /** + * Required. The customer ID or "my_customer" prefixed with "customers/". + */ + customer?: string; + /** + * Required. The extension for which we want to find requesting devices. + */ + extensionId?: 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. + */ + orgUnitId?: string; + /** + * Optional. Maximum number of results to return. Maximum and default are 50. Any page size larger than 50 will be coerced to 50. + */ + pageSize?: number; + /** + * Optional. Token to specify the page of the request to be returned. Token expires after 1 day. + */ + pageToken?: string; + } + export interface Params$Resource$Customers$Apps$Fetchusersrequestingextension + extends StandardParameters { + /** + * Required. The customer ID or "my_customer" prefixed with "customers/". + */ + customer?: string; + /** + * Required. The extension for which we want to find the requesting users. + */ + extensionId?: 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. + */ + orgUnitId?: string; + /** + * Optional. Maximum number of results to return. Maximum and default are 50. Any page size larger than 50 will be coerced to 50. + */ + pageSize?: number; + /** + * Optional. Token to specify the page of the request to be returned. Token expires after 1 day. + */ + pageToken?: string; + } export class Resource$Customers$Apps$Android { context: APIRequestContext; @@ -3909,7 +4209,7 @@ export namespace chromemanagement_v1 { */ name?: string; /** - * Required. Read mask to specify which fields to return. + * 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 */ readMask?: string; } @@ -3932,7 +4232,7 @@ export namespace chromemanagement_v1 { */ parent?: string; /** - * Required. Read mask to specify which fields to return. + * 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 */ readMask?: string; } @@ -4060,7 +4360,7 @@ export namespace chromemanagement_v1 { */ parent?: string; /** - * Required. Read mask to specify which fields to return. Although currently required, this field will become optional, while the filter parameter with an event type will be come required. + * 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 */ readMask?: string; } @@ -4595,7 +4895,7 @@ export namespace chromemanagement_v1 { */ name?: string; /** - * Read mask to specify which fields to return. + * 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 */ readMask?: string; } @@ -4618,7 +4918,7 @@ export namespace chromemanagement_v1 { */ parent?: string; /** - * Read mask to specify which fields to return. + * 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 */ readMask?: string; }