@googleapis/chromemanagement 27.0.0 → 30.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/v1.ts CHANGED
@@ -1180,6 +1180,57 @@ export namespace chromemanagement_v1 {
1180
1180
  */
1181
1181
  totalSize?: number | null;
1182
1182
  }
1183
+ /**
1184
+ * Response to `FindSaasUsageBrowsers` method.
1185
+ */
1186
+ export interface Schema$GoogleChromeManagementV1FindSaasUsageBrowsersResponse {
1187
+ /**
1188
+ * A token, which can be sent as `page_token` to retrieve the next page.
1189
+ */
1190
+ nextPageToken?: string | null;
1191
+ /**
1192
+ * The list of SaaS usage browser reports.
1193
+ */
1194
+ saasUsageBrowsers?: Schema$GoogleChromeManagementV1SaasUsageBrowser[];
1195
+ /**
1196
+ * Total number of SaaS usage browser reports that match the request.
1197
+ */
1198
+ totalSize?: string | null;
1199
+ }
1200
+ /**
1201
+ * Response to `FindSaasUsageProfiles` method.
1202
+ */
1203
+ export interface Schema$GoogleChromeManagementV1FindSaasUsageProfilesResponse {
1204
+ /**
1205
+ * A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.
1206
+ */
1207
+ nextPageToken?: string | null;
1208
+ /**
1209
+ * The list of SaaS usage profile reports.
1210
+ */
1211
+ profileReports?: Schema$GoogleChromeManagementV1SaasUsageProfileReport[];
1212
+ /**
1213
+ * Total number of SaaS usage profile reports that match the request.
1214
+ */
1215
+ totalSize?: string | null;
1216
+ }
1217
+ /**
1218
+ * Response to `FindSaasUsage` method.
1219
+ */
1220
+ export interface Schema$GoogleChromeManagementV1FindSaasUsageReportsResponse {
1221
+ /**
1222
+ * A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.
1223
+ */
1224
+ nextPageToken?: string | null;
1225
+ /**
1226
+ * The list of SaaS usage reports.
1227
+ */
1228
+ saasReports?: Schema$GoogleChromeManagementV1SaasUsageReport[];
1229
+ /**
1230
+ * Total number of SaaS usage reports that match the request.
1231
+ */
1232
+ totalSize?: string | null;
1233
+ }
1183
1234
  /**
1184
1235
  * Information of a graphics adapter (GPU).
1185
1236
  */
@@ -1780,6 +1831,146 @@ export namespace chromemanagement_v1 {
1780
1831
  */
1781
1832
  uptimeRuntimeDuration?: string | null;
1782
1833
  }
1834
+ /**
1835
+ * Details of a SaaS usage browser.
1836
+ */
1837
+ export interface Schema$GoogleChromeManagementV1SaasUsageBrowser {
1838
+ /**
1839
+ * Output only. The device permanent ID.
1840
+ */
1841
+ devicePermanentId?: string | null;
1842
+ /**
1843
+ * Output only. The timestamp when the application was first navigated to by this browser.
1844
+ */
1845
+ firstNavigationTime?: string | null;
1846
+ /**
1847
+ * Output only. The timestamp when the application was last navigated to by this browser.
1848
+ */
1849
+ lastNavigationTime?: string | null;
1850
+ /**
1851
+ * Output only. The machine name.
1852
+ */
1853
+ machine?: string | null;
1854
+ /**
1855
+ * Output only. The ID of the organizational unit.
1856
+ */
1857
+ orgUnitId?: string | null;
1858
+ /**
1859
+ * Output only. The OS platform.
1860
+ */
1861
+ osPlatform?: string | null;
1862
+ /**
1863
+ * Output only. The OS version.
1864
+ */
1865
+ osVersion?: string | null;
1866
+ }
1867
+ /**
1868
+ * Represents a single SaaS report entry grouped by profile.
1869
+ */
1870
+ export interface Schema$GoogleChromeManagementV1SaasUsageProfileReport {
1871
+ /**
1872
+ * Output only. The email of the user.
1873
+ */
1874
+ email?: string | null;
1875
+ /**
1876
+ * Output only. The timestamp when the application was first navigated to by this profile.
1877
+ */
1878
+ firstNavigationTime?: string | null;
1879
+ /**
1880
+ * Output only. The timestamp when the application was last navigated to by this profile.
1881
+ */
1882
+ lastNavigationTime?: string | null;
1883
+ /**
1884
+ * Output only. The ID of the organizational unit.
1885
+ */
1886
+ orgUnitId?: string | null;
1887
+ /**
1888
+ * Output only. The OS platform.
1889
+ */
1890
+ osPlatform?: string | null;
1891
+ /**
1892
+ * Output only. The OS version.
1893
+ */
1894
+ osVersion?: string | null;
1895
+ /**
1896
+ * Output only. The permanent ID of the profile.
1897
+ */
1898
+ profilePermanentId?: string | null;
1899
+ }
1900
+ /**
1901
+ * Represents a single SaaS report entry.
1902
+ */
1903
+ export interface Schema$GoogleChromeManagementV1SaasUsageReport {
1904
+ /**
1905
+ * Output only. The name of the application.
1906
+ */
1907
+ app?: string | null;
1908
+ /**
1909
+ * Output only. The category of the application.
1910
+ */
1911
+ category?: string | null;
1912
+ /**
1913
+ * Output only. Provides information about content transfer events, if available.
1914
+ */
1915
+ contentTransferDetails?: Schema$GoogleChromeManagementV1SaasUsageReportContentTransferDetails;
1916
+ /**
1917
+ * Output only. Number of distinct browsers that visited the application.
1918
+ */
1919
+ distinctBrowsersCount?: string | null;
1920
+ /**
1921
+ * Output only. Number of distinct users who visited the application.
1922
+ */
1923
+ distinctUsersCount?: string | null;
1924
+ /**
1925
+ * Output only. A list of domains and subdomains associated with the application.
1926
+ */
1927
+ domains?: string[] | null;
1928
+ /**
1929
+ * Output only. A list of encryption protocols used to access the application.
1930
+ */
1931
+ encryptionProtocols?: string[] | null;
1932
+ /**
1933
+ * Output only. The timestamp when the application was first navigated to.
1934
+ */
1935
+ firstNavigationTime?: string | null;
1936
+ /**
1937
+ * Output only. The year the organization was founded.
1938
+ */
1939
+ foundedYear?: number | null;
1940
+ /**
1941
+ * Output only. The headquarters location of the organization.
1942
+ */
1943
+ headquarters?: string | null;
1944
+ /**
1945
+ * Output only. The timestamp when the application was last navigated to.
1946
+ */
1947
+ lastNavigationTime?: string | null;
1948
+ /**
1949
+ * Output only. The organization that develops the application.
1950
+ */
1951
+ organization?: string | null;
1952
+ /**
1953
+ * Output only. The ID of the organizational unit.
1954
+ */
1955
+ orgUnitId?: string | null;
1956
+ /**
1957
+ * Output only. The primary domain of the application.
1958
+ */
1959
+ primaryDomain?: string | null;
1960
+ /**
1961
+ * Output only. Total number of visits to the application.
1962
+ */
1963
+ visitsCount?: string | null;
1964
+ }
1965
+ /**
1966
+ * Provides information about content transfer events, if available.
1967
+ */
1968
+ export interface Schema$GoogleChromeManagementV1SaasUsageReportContentTransferDetails {
1969
+ /**
1970
+ * Output only. Total number of content transfers associated with the application.
1971
+ */
1972
+ contentTransferCount?: string | null;
1973
+ }
1783
1974
  /**
1784
1975
  * Status data for storage. * This field is telemetry information and this will change over time as the device is utilized. * Data for this field is controlled via policy: [ReportDeviceStorageStatus](https://chromeenterprise.google/policies/#ReportDeviceStorageStatus) * Data Collection Frequency: Only at Upload * Default Data Reporting Frequency: 3 hours - Policy Controlled: Yes * Cache: If the device is offline, the collected data is stored locally, and will be reported when the device is next online: No * Reported for affiliated users only: N/A * Granular permission needed: TELEMETRY_API_STORAGE_INFO
1785
1976
  */
@@ -11449,25 +11640,507 @@ export namespace chromemanagement_v1 {
11449
11640
  );
11450
11641
  }
11451
11642
  }
11452
- }
11453
11643
 
11454
- export interface Params$Resource$Customers$Reports$Countactivedevices extends StandardParameters {
11455
- /**
11456
- * Required. Obfuscated customer ID prefixed with "customers/C" or "customers/my_customer".
11457
- */
11458
- customer?: string;
11459
- /**
11460
- * 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.
11461
- */
11462
- 'date.day'?: number;
11463
11644
  /**
11464
- * Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
11645
+ * Find SaaS usage reports of a customer based on the given search and sorting criteria.
11646
+ * @example
11647
+ * ```js
11648
+ * // Before running the sample:
11649
+ * // - Enable the API at:
11650
+ * // https://console.developers.google.com/apis/api/chromemanagement.googleapis.com
11651
+ * // - Login into gcloud by running:
11652
+ * // ```sh
11653
+ * // $ gcloud auth application-default login
11654
+ * // ```
11655
+ * // - Install the npm module by running:
11656
+ * // ```sh
11657
+ * // $ npm install googleapis
11658
+ * // ```
11659
+ *
11660
+ * const {google} = require('googleapis');
11661
+ * const chromemanagement = google.chromemanagement('v1');
11662
+ *
11663
+ * async function main() {
11664
+ * const auth = new google.auth.GoogleAuth({
11665
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
11666
+ * scopes: [
11667
+ * 'https://www.googleapis.com/auth/chrome.management.reports.readonly',
11668
+ * ],
11669
+ * });
11670
+ *
11671
+ * // Acquire an auth client, and bind it to all future calls
11672
+ * const authClient = await auth.getClient();
11673
+ * google.options({auth: authClient});
11674
+ *
11675
+ * // Do the magic
11676
+ * const res = await chromemanagement.customers.reports.findSaasUsage({
11677
+ * // Required. Obfuscated customer ID prefixed with "customers/C" or "customers/my_customer".
11678
+ * customer: 'customers/my-customer',
11679
+ * // Optional. The filter expression to narrow down the SaaS reports to return. Supported operators are: =, !=, <, <=, \>, \>=, :. Logical operators AND, OR, and NOT are supported. Supported fields: * app * org_unit_id * first_navigation_time * last_navigation_time * category * organization * founded_year * headquarters * primary_domain * domains * encryption_protocols * visits_count * distinct_users_count * distinct_browsers_count * content_transfer_count Example: `(first_navigation_time < "2026-01-31T00:00:00Z" AND last_navigation_time \> "2026-01-01T00:00:00Z") AND visits_count \> 100`
11680
+ * filter: 'placeholder-value',
11681
+ * // Optional. The order by expression to sort the SaaS reports. Supported fields: * app * category * organization * founded_year * headquarters * primary_domain * visits_count * distinct_users_count * distinct_browsers_count * content_transfer_count Default order is ascending. To specify descending order for a field, append " desc". Example: `visits_count desc`
11682
+ * orderBy: 'placeholder-value',
11683
+ * // Optional. The maximum number of reports to return. The service may return fewer than this value. If unspecified, at most 100 reports will be returned. The maximum value is 200; values above 200 will be coerced to 200.
11684
+ * pageSize: 'placeholder-value',
11685
+ * // Optional. A page token, received from a previous `FindSaasUsageReports` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `FindSaasUsageReports` must match the call that provided the page token.
11686
+ * pageToken: 'placeholder-value',
11687
+ * });
11688
+ * console.log(res.data);
11689
+ *
11690
+ * // Example response
11691
+ * // {
11692
+ * // "nextPageToken": "my_nextPageToken",
11693
+ * // "saasReports": [],
11694
+ * // "totalSize": "my_totalSize"
11695
+ * // }
11696
+ * }
11697
+ *
11698
+ * main().catch(e => {
11699
+ * console.error(e);
11700
+ * throw e;
11701
+ * });
11702
+ *
11703
+ * ```
11704
+ *
11705
+ * @param params - Parameters for request
11706
+ * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
11707
+ * @param callback - Optional callback that handles the response.
11708
+ * @returns A promise if used with async/await, or void if used with a callback.
11465
11709
  */
11466
- 'date.month'?: number;
11710
+ findSaasUsage(
11711
+ params: Params$Resource$Customers$Reports$Findsaasusage,
11712
+ options: StreamMethodOptions
11713
+ ): Promise<GaxiosResponseWithHTTP2<Readable>>;
11714
+ findSaasUsage(
11715
+ params?: Params$Resource$Customers$Reports$Findsaasusage,
11716
+ options?: MethodOptions
11717
+ ): Promise<
11718
+ GaxiosResponseWithHTTP2<Schema$GoogleChromeManagementV1FindSaasUsageReportsResponse>
11719
+ >;
11720
+ findSaasUsage(
11721
+ params: Params$Resource$Customers$Reports$Findsaasusage,
11722
+ options: StreamMethodOptions | BodyResponseCallback<Readable>,
11723
+ callback: BodyResponseCallback<Readable>
11724
+ ): void;
11725
+ findSaasUsage(
11726
+ params: Params$Resource$Customers$Reports$Findsaasusage,
11727
+ options:
11728
+ | MethodOptions
11729
+ | BodyResponseCallback<Schema$GoogleChromeManagementV1FindSaasUsageReportsResponse>,
11730
+ callback: BodyResponseCallback<Schema$GoogleChromeManagementV1FindSaasUsageReportsResponse>
11731
+ ): void;
11732
+ findSaasUsage(
11733
+ params: Params$Resource$Customers$Reports$Findsaasusage,
11734
+ callback: BodyResponseCallback<Schema$GoogleChromeManagementV1FindSaasUsageReportsResponse>
11735
+ ): void;
11736
+ findSaasUsage(
11737
+ callback: BodyResponseCallback<Schema$GoogleChromeManagementV1FindSaasUsageReportsResponse>
11738
+ ): void;
11739
+ findSaasUsage(
11740
+ paramsOrCallback?:
11741
+ | Params$Resource$Customers$Reports$Findsaasusage
11742
+ | BodyResponseCallback<Schema$GoogleChromeManagementV1FindSaasUsageReportsResponse>
11743
+ | BodyResponseCallback<Readable>,
11744
+ optionsOrCallback?:
11745
+ | MethodOptions
11746
+ | StreamMethodOptions
11747
+ | BodyResponseCallback<Schema$GoogleChromeManagementV1FindSaasUsageReportsResponse>
11748
+ | BodyResponseCallback<Readable>,
11749
+ callback?:
11750
+ | BodyResponseCallback<Schema$GoogleChromeManagementV1FindSaasUsageReportsResponse>
11751
+ | BodyResponseCallback<Readable>
11752
+ ):
11753
+ | void
11754
+ | Promise<
11755
+ GaxiosResponseWithHTTP2<Schema$GoogleChromeManagementV1FindSaasUsageReportsResponse>
11756
+ >
11757
+ | Promise<GaxiosResponseWithHTTP2<Readable>> {
11758
+ let params = (paramsOrCallback ||
11759
+ {}) as Params$Resource$Customers$Reports$Findsaasusage;
11760
+ let options = (optionsOrCallback || {}) as MethodOptions;
11761
+
11762
+ if (typeof paramsOrCallback === 'function') {
11763
+ callback = paramsOrCallback;
11764
+ params = {} as Params$Resource$Customers$Reports$Findsaasusage;
11765
+ options = {};
11766
+ }
11767
+
11768
+ if (typeof optionsOrCallback === 'function') {
11769
+ callback = optionsOrCallback;
11770
+ options = {};
11771
+ }
11772
+
11773
+ const rootUrl =
11774
+ options.rootUrl || 'https://chromemanagement.googleapis.com/';
11775
+ const parameters = {
11776
+ options: Object.assign(
11777
+ {
11778
+ url: (rootUrl + '/v1/{+customer}/reports:findSaasUsage').replace(
11779
+ /([^:]\/)\/+/g,
11780
+ '$1'
11781
+ ),
11782
+ method: 'GET',
11783
+ apiVersion: '',
11784
+ },
11785
+ options
11786
+ ),
11787
+ params,
11788
+ requiredParams: ['customer'],
11789
+ pathParams: ['customer'],
11790
+ context: this.context,
11791
+ };
11792
+ if (callback) {
11793
+ createAPIRequest<Schema$GoogleChromeManagementV1FindSaasUsageReportsResponse>(
11794
+ parameters,
11795
+ callback as BodyResponseCallback<unknown>
11796
+ );
11797
+ } else {
11798
+ return createAPIRequest<Schema$GoogleChromeManagementV1FindSaasUsageReportsResponse>(
11799
+ parameters
11800
+ );
11801
+ }
11802
+ }
11803
+
11467
11804
  /**
11468
- * Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
11469
- */
11470
- 'date.year'?: number;
11805
+ * Find SaaS usage reports of a customer grouped by browsers based on the given search and sorting criteria.
11806
+ * @example
11807
+ * ```js
11808
+ * // Before running the sample:
11809
+ * // - Enable the API at:
11810
+ * // https://console.developers.google.com/apis/api/chromemanagement.googleapis.com
11811
+ * // - Login into gcloud by running:
11812
+ * // ```sh
11813
+ * // $ gcloud auth application-default login
11814
+ * // ```
11815
+ * // - Install the npm module by running:
11816
+ * // ```sh
11817
+ * // $ npm install googleapis
11818
+ * // ```
11819
+ *
11820
+ * const {google} = require('googleapis');
11821
+ * const chromemanagement = google.chromemanagement('v1');
11822
+ *
11823
+ * async function main() {
11824
+ * const auth = new google.auth.GoogleAuth({
11825
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
11826
+ * scopes: [
11827
+ * 'https://www.googleapis.com/auth/chrome.management.reports.readonly',
11828
+ * ],
11829
+ * });
11830
+ *
11831
+ * // Acquire an auth client, and bind it to all future calls
11832
+ * const authClient = await auth.getClient();
11833
+ * google.options({auth: authClient});
11834
+ *
11835
+ * // Do the magic
11836
+ * const res = await chromemanagement.customers.reports.findSaasUsageBrowsers({
11837
+ * // Required. The name of the SaaS application (e.g., `ChatGPT`, `Gemini`).
11838
+ * app: 'placeholder-value',
11839
+ * // Required. Obfuscated customer ID prefixed with "customers/C" or "customers/my_customer".
11840
+ * customer: 'customers/my-customer',
11841
+ * // Optional. The filter expression to narrow down the SaaS browser reports to return. Supported operators are: =, !=, <, <=, \>, \>=, :. Logical operators AND, OR, and NOT are supported. Supported fields: * machine * os_platform * first_navigation_time * last_navigation_time * org_unit_id
11842
+ * filter: 'placeholder-value',
11843
+ * // Optional. The order by expression to sort the SaaS browser reports. Supported fields: * machine * os_platform * first_navigation_time * last_navigation_time Default order is ascending. To specify descending order for a field, append " desc".
11844
+ * orderBy: 'placeholder-value',
11845
+ * // Optional. The maximum number of browsers to return. The service may return fewer than this value. If unspecified, at most 100 browsers will be returned. The maximum value is 200; values above 200 will be coerced to 200.
11846
+ * pageSize: 'placeholder-value',
11847
+ * // Optional. A page token, received from a previous `FindSaasUsageBrowsers` call. Provide this to retrieve the subsequent page.
11848
+ * pageToken: 'placeholder-value',
11849
+ * });
11850
+ * console.log(res.data);
11851
+ *
11852
+ * // Example response
11853
+ * // {
11854
+ * // "nextPageToken": "my_nextPageToken",
11855
+ * // "saasUsageBrowsers": [],
11856
+ * // "totalSize": "my_totalSize"
11857
+ * // }
11858
+ * }
11859
+ *
11860
+ * main().catch(e => {
11861
+ * console.error(e);
11862
+ * throw e;
11863
+ * });
11864
+ *
11865
+ * ```
11866
+ *
11867
+ * @param params - Parameters for request
11868
+ * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
11869
+ * @param callback - Optional callback that handles the response.
11870
+ * @returns A promise if used with async/await, or void if used with a callback.
11871
+ */
11872
+ findSaasUsageBrowsers(
11873
+ params: Params$Resource$Customers$Reports$Findsaasusagebrowsers,
11874
+ options: StreamMethodOptions
11875
+ ): Promise<GaxiosResponseWithHTTP2<Readable>>;
11876
+ findSaasUsageBrowsers(
11877
+ params?: Params$Resource$Customers$Reports$Findsaasusagebrowsers,
11878
+ options?: MethodOptions
11879
+ ): Promise<
11880
+ GaxiosResponseWithHTTP2<Schema$GoogleChromeManagementV1FindSaasUsageBrowsersResponse>
11881
+ >;
11882
+ findSaasUsageBrowsers(
11883
+ params: Params$Resource$Customers$Reports$Findsaasusagebrowsers,
11884
+ options: StreamMethodOptions | BodyResponseCallback<Readable>,
11885
+ callback: BodyResponseCallback<Readable>
11886
+ ): void;
11887
+ findSaasUsageBrowsers(
11888
+ params: Params$Resource$Customers$Reports$Findsaasusagebrowsers,
11889
+ options:
11890
+ | MethodOptions
11891
+ | BodyResponseCallback<Schema$GoogleChromeManagementV1FindSaasUsageBrowsersResponse>,
11892
+ callback: BodyResponseCallback<Schema$GoogleChromeManagementV1FindSaasUsageBrowsersResponse>
11893
+ ): void;
11894
+ findSaasUsageBrowsers(
11895
+ params: Params$Resource$Customers$Reports$Findsaasusagebrowsers,
11896
+ callback: BodyResponseCallback<Schema$GoogleChromeManagementV1FindSaasUsageBrowsersResponse>
11897
+ ): void;
11898
+ findSaasUsageBrowsers(
11899
+ callback: BodyResponseCallback<Schema$GoogleChromeManagementV1FindSaasUsageBrowsersResponse>
11900
+ ): void;
11901
+ findSaasUsageBrowsers(
11902
+ paramsOrCallback?:
11903
+ | Params$Resource$Customers$Reports$Findsaasusagebrowsers
11904
+ | BodyResponseCallback<Schema$GoogleChromeManagementV1FindSaasUsageBrowsersResponse>
11905
+ | BodyResponseCallback<Readable>,
11906
+ optionsOrCallback?:
11907
+ | MethodOptions
11908
+ | StreamMethodOptions
11909
+ | BodyResponseCallback<Schema$GoogleChromeManagementV1FindSaasUsageBrowsersResponse>
11910
+ | BodyResponseCallback<Readable>,
11911
+ callback?:
11912
+ | BodyResponseCallback<Schema$GoogleChromeManagementV1FindSaasUsageBrowsersResponse>
11913
+ | BodyResponseCallback<Readable>
11914
+ ):
11915
+ | void
11916
+ | Promise<
11917
+ GaxiosResponseWithHTTP2<Schema$GoogleChromeManagementV1FindSaasUsageBrowsersResponse>
11918
+ >
11919
+ | Promise<GaxiosResponseWithHTTP2<Readable>> {
11920
+ let params = (paramsOrCallback ||
11921
+ {}) as Params$Resource$Customers$Reports$Findsaasusagebrowsers;
11922
+ let options = (optionsOrCallback || {}) as MethodOptions;
11923
+
11924
+ if (typeof paramsOrCallback === 'function') {
11925
+ callback = paramsOrCallback;
11926
+ params = {} as Params$Resource$Customers$Reports$Findsaasusagebrowsers;
11927
+ options = {};
11928
+ }
11929
+
11930
+ if (typeof optionsOrCallback === 'function') {
11931
+ callback = optionsOrCallback;
11932
+ options = {};
11933
+ }
11934
+
11935
+ const rootUrl =
11936
+ options.rootUrl || 'https://chromemanagement.googleapis.com/';
11937
+ const parameters = {
11938
+ options: Object.assign(
11939
+ {
11940
+ url: (
11941
+ rootUrl + '/v1/{+customer}/reports:findSaasUsageBrowsers'
11942
+ ).replace(/([^:]\/)\/+/g, '$1'),
11943
+ method: 'GET',
11944
+ apiVersion: '',
11945
+ },
11946
+ options
11947
+ ),
11948
+ params,
11949
+ requiredParams: ['customer'],
11950
+ pathParams: ['customer'],
11951
+ context: this.context,
11952
+ };
11953
+ if (callback) {
11954
+ createAPIRequest<Schema$GoogleChromeManagementV1FindSaasUsageBrowsersResponse>(
11955
+ parameters,
11956
+ callback as BodyResponseCallback<unknown>
11957
+ );
11958
+ } else {
11959
+ return createAPIRequest<Schema$GoogleChromeManagementV1FindSaasUsageBrowsersResponse>(
11960
+ parameters
11961
+ );
11962
+ }
11963
+ }
11964
+
11965
+ /**
11966
+ * Find SaaS usage reports of a customer grouped by profiles based on the given search and sorting criteria.
11967
+ * @example
11968
+ * ```js
11969
+ * // Before running the sample:
11970
+ * // - Enable the API at:
11971
+ * // https://console.developers.google.com/apis/api/chromemanagement.googleapis.com
11972
+ * // - Login into gcloud by running:
11973
+ * // ```sh
11974
+ * // $ gcloud auth application-default login
11975
+ * // ```
11976
+ * // - Install the npm module by running:
11977
+ * // ```sh
11978
+ * // $ npm install googleapis
11979
+ * // ```
11980
+ *
11981
+ * const {google} = require('googleapis');
11982
+ * const chromemanagement = google.chromemanagement('v1');
11983
+ *
11984
+ * async function main() {
11985
+ * const auth = new google.auth.GoogleAuth({
11986
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
11987
+ * scopes: [
11988
+ * 'https://www.googleapis.com/auth/chrome.management.reports.readonly',
11989
+ * ],
11990
+ * });
11991
+ *
11992
+ * // Acquire an auth client, and bind it to all future calls
11993
+ * const authClient = await auth.getClient();
11994
+ * google.options({auth: authClient});
11995
+ *
11996
+ * // Do the magic
11997
+ * const res = await chromemanagement.customers.reports.findSaasUsageProfiles({
11998
+ * // Required. The name of the SaaS application (e.g., `ChatGPT`, `Gemini`).
11999
+ * app: 'placeholder-value',
12000
+ * // Required. Obfuscated customer ID prefixed with "customers/C" or "customers/my_customer".
12001
+ * customer: 'customers/my-customer',
12002
+ * // Optional. The filter expression to narrow down the SaaS profile reports to return. Supported operators are: =, !=, <, <=, \>, \>=, :. Logical operators AND, OR, and NOT are supported. Supported fields: * email * org_unit_id * os_platform * first_navigation_time * last_navigation_time
12003
+ * filter: 'placeholder-value',
12004
+ * // Optional. The order by expression to sort the SaaS profile reports. Supported fields: * email * os_platform * first_navigation_time * last_navigation_time Default order is ascending. To specify descending order for a field, append " desc".
12005
+ * orderBy: 'placeholder-value',
12006
+ * // Optional. The maximum number of reports to return. The service may return fewer than this value. If unspecified, at most 100 reports will be returned. The maximum value is 200; values above 200 will be coerced to 200.
12007
+ * pageSize: 'placeholder-value',
12008
+ * // Optional. A page token, received from a previous `FindSaasUsageProfiles` call. Provide this to retrieve the subsequent page.
12009
+ * pageToken: 'placeholder-value',
12010
+ * });
12011
+ * console.log(res.data);
12012
+ *
12013
+ * // Example response
12014
+ * // {
12015
+ * // "nextPageToken": "my_nextPageToken",
12016
+ * // "profileReports": [],
12017
+ * // "totalSize": "my_totalSize"
12018
+ * // }
12019
+ * }
12020
+ *
12021
+ * main().catch(e => {
12022
+ * console.error(e);
12023
+ * throw e;
12024
+ * });
12025
+ *
12026
+ * ```
12027
+ *
12028
+ * @param params - Parameters for request
12029
+ * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
12030
+ * @param callback - Optional callback that handles the response.
12031
+ * @returns A promise if used with async/await, or void if used with a callback.
12032
+ */
12033
+ findSaasUsageProfiles(
12034
+ params: Params$Resource$Customers$Reports$Findsaasusageprofiles,
12035
+ options: StreamMethodOptions
12036
+ ): Promise<GaxiosResponseWithHTTP2<Readable>>;
12037
+ findSaasUsageProfiles(
12038
+ params?: Params$Resource$Customers$Reports$Findsaasusageprofiles,
12039
+ options?: MethodOptions
12040
+ ): Promise<
12041
+ GaxiosResponseWithHTTP2<Schema$GoogleChromeManagementV1FindSaasUsageProfilesResponse>
12042
+ >;
12043
+ findSaasUsageProfiles(
12044
+ params: Params$Resource$Customers$Reports$Findsaasusageprofiles,
12045
+ options: StreamMethodOptions | BodyResponseCallback<Readable>,
12046
+ callback: BodyResponseCallback<Readable>
12047
+ ): void;
12048
+ findSaasUsageProfiles(
12049
+ params: Params$Resource$Customers$Reports$Findsaasusageprofiles,
12050
+ options:
12051
+ | MethodOptions
12052
+ | BodyResponseCallback<Schema$GoogleChromeManagementV1FindSaasUsageProfilesResponse>,
12053
+ callback: BodyResponseCallback<Schema$GoogleChromeManagementV1FindSaasUsageProfilesResponse>
12054
+ ): void;
12055
+ findSaasUsageProfiles(
12056
+ params: Params$Resource$Customers$Reports$Findsaasusageprofiles,
12057
+ callback: BodyResponseCallback<Schema$GoogleChromeManagementV1FindSaasUsageProfilesResponse>
12058
+ ): void;
12059
+ findSaasUsageProfiles(
12060
+ callback: BodyResponseCallback<Schema$GoogleChromeManagementV1FindSaasUsageProfilesResponse>
12061
+ ): void;
12062
+ findSaasUsageProfiles(
12063
+ paramsOrCallback?:
12064
+ | Params$Resource$Customers$Reports$Findsaasusageprofiles
12065
+ | BodyResponseCallback<Schema$GoogleChromeManagementV1FindSaasUsageProfilesResponse>
12066
+ | BodyResponseCallback<Readable>,
12067
+ optionsOrCallback?:
12068
+ | MethodOptions
12069
+ | StreamMethodOptions
12070
+ | BodyResponseCallback<Schema$GoogleChromeManagementV1FindSaasUsageProfilesResponse>
12071
+ | BodyResponseCallback<Readable>,
12072
+ callback?:
12073
+ | BodyResponseCallback<Schema$GoogleChromeManagementV1FindSaasUsageProfilesResponse>
12074
+ | BodyResponseCallback<Readable>
12075
+ ):
12076
+ | void
12077
+ | Promise<
12078
+ GaxiosResponseWithHTTP2<Schema$GoogleChromeManagementV1FindSaasUsageProfilesResponse>
12079
+ >
12080
+ | Promise<GaxiosResponseWithHTTP2<Readable>> {
12081
+ let params = (paramsOrCallback ||
12082
+ {}) as Params$Resource$Customers$Reports$Findsaasusageprofiles;
12083
+ let options = (optionsOrCallback || {}) as MethodOptions;
12084
+
12085
+ if (typeof paramsOrCallback === 'function') {
12086
+ callback = paramsOrCallback;
12087
+ params = {} as Params$Resource$Customers$Reports$Findsaasusageprofiles;
12088
+ options = {};
12089
+ }
12090
+
12091
+ if (typeof optionsOrCallback === 'function') {
12092
+ callback = optionsOrCallback;
12093
+ options = {};
12094
+ }
12095
+
12096
+ const rootUrl =
12097
+ options.rootUrl || 'https://chromemanagement.googleapis.com/';
12098
+ const parameters = {
12099
+ options: Object.assign(
12100
+ {
12101
+ url: (
12102
+ rootUrl + '/v1/{+customer}/reports:findSaasUsageProfiles'
12103
+ ).replace(/([^:]\/)\/+/g, '$1'),
12104
+ method: 'GET',
12105
+ apiVersion: '',
12106
+ },
12107
+ options
12108
+ ),
12109
+ params,
12110
+ requiredParams: ['customer'],
12111
+ pathParams: ['customer'],
12112
+ context: this.context,
12113
+ };
12114
+ if (callback) {
12115
+ createAPIRequest<Schema$GoogleChromeManagementV1FindSaasUsageProfilesResponse>(
12116
+ parameters,
12117
+ callback as BodyResponseCallback<unknown>
12118
+ );
12119
+ } else {
12120
+ return createAPIRequest<Schema$GoogleChromeManagementV1FindSaasUsageProfilesResponse>(
12121
+ parameters
12122
+ );
12123
+ }
12124
+ }
12125
+ }
12126
+
12127
+ export interface Params$Resource$Customers$Reports$Countactivedevices extends StandardParameters {
12128
+ /**
12129
+ * Required. Obfuscated customer ID prefixed with "customers/C" or "customers/my_customer".
12130
+ */
12131
+ customer?: string;
12132
+ /**
12133
+ * 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.
12134
+ */
12135
+ 'date.day'?: number;
12136
+ /**
12137
+ * Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
12138
+ */
12139
+ 'date.month'?: number;
12140
+ /**
12141
+ * Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
12142
+ */
12143
+ 'date.year'?: number;
11471
12144
  }
11472
12145
  export interface Params$Resource$Customers$Reports$Countchromebrowsersneedingattention extends StandardParameters {
11473
12146
  /**
@@ -11795,6 +12468,80 @@ export namespace chromemanagement_v1 {
11795
12468
  */
11796
12469
  pageToken?: string;
11797
12470
  }
12471
+ export interface Params$Resource$Customers$Reports$Findsaasusage extends StandardParameters {
12472
+ /**
12473
+ * Required. Obfuscated customer ID prefixed with "customers/C" or "customers/my_customer".
12474
+ */
12475
+ customer?: string;
12476
+ /**
12477
+ * Optional. The filter expression to narrow down the SaaS reports to return. Supported operators are: =, !=, <, <=, \>, \>=, :. Logical operators AND, OR, and NOT are supported. Supported fields: * app * org_unit_id * first_navigation_time * last_navigation_time * category * organization * founded_year * headquarters * primary_domain * domains * encryption_protocols * visits_count * distinct_users_count * distinct_browsers_count * content_transfer_count Example: `(first_navigation_time < "2026-01-31T00:00:00Z" AND last_navigation_time \> "2026-01-01T00:00:00Z") AND visits_count \> 100`
12478
+ */
12479
+ filter?: string;
12480
+ /**
12481
+ * Optional. The order by expression to sort the SaaS reports. Supported fields: * app * category * organization * founded_year * headquarters * primary_domain * visits_count * distinct_users_count * distinct_browsers_count * content_transfer_count Default order is ascending. To specify descending order for a field, append " desc". Example: `visits_count desc`
12482
+ */
12483
+ orderBy?: string;
12484
+ /**
12485
+ * Optional. The maximum number of reports to return. The service may return fewer than this value. If unspecified, at most 100 reports will be returned. The maximum value is 200; values above 200 will be coerced to 200.
12486
+ */
12487
+ pageSize?: number;
12488
+ /**
12489
+ * Optional. A page token, received from a previous `FindSaasUsageReports` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `FindSaasUsageReports` must match the call that provided the page token.
12490
+ */
12491
+ pageToken?: string;
12492
+ }
12493
+ export interface Params$Resource$Customers$Reports$Findsaasusagebrowsers extends StandardParameters {
12494
+ /**
12495
+ * Required. The name of the SaaS application (e.g., `ChatGPT`, `Gemini`).
12496
+ */
12497
+ app?: string;
12498
+ /**
12499
+ * Required. Obfuscated customer ID prefixed with "customers/C" or "customers/my_customer".
12500
+ */
12501
+ customer?: string;
12502
+ /**
12503
+ * Optional. The filter expression to narrow down the SaaS browser reports to return. Supported operators are: =, !=, <, <=, \>, \>=, :. Logical operators AND, OR, and NOT are supported. Supported fields: * machine * os_platform * first_navigation_time * last_navigation_time * org_unit_id
12504
+ */
12505
+ filter?: string;
12506
+ /**
12507
+ * Optional. The order by expression to sort the SaaS browser reports. Supported fields: * machine * os_platform * first_navigation_time * last_navigation_time Default order is ascending. To specify descending order for a field, append " desc".
12508
+ */
12509
+ orderBy?: string;
12510
+ /**
12511
+ * Optional. The maximum number of browsers to return. The service may return fewer than this value. If unspecified, at most 100 browsers will be returned. The maximum value is 200; values above 200 will be coerced to 200.
12512
+ */
12513
+ pageSize?: number;
12514
+ /**
12515
+ * Optional. A page token, received from a previous `FindSaasUsageBrowsers` call. Provide this to retrieve the subsequent page.
12516
+ */
12517
+ pageToken?: string;
12518
+ }
12519
+ export interface Params$Resource$Customers$Reports$Findsaasusageprofiles extends StandardParameters {
12520
+ /**
12521
+ * Required. The name of the SaaS application (e.g., `ChatGPT`, `Gemini`).
12522
+ */
12523
+ app?: string;
12524
+ /**
12525
+ * Required. Obfuscated customer ID prefixed with "customers/C" or "customers/my_customer".
12526
+ */
12527
+ customer?: string;
12528
+ /**
12529
+ * Optional. The filter expression to narrow down the SaaS profile reports to return. Supported operators are: =, !=, <, <=, \>, \>=, :. Logical operators AND, OR, and NOT are supported. Supported fields: * email * org_unit_id * os_platform * first_navigation_time * last_navigation_time
12530
+ */
12531
+ filter?: string;
12532
+ /**
12533
+ * Optional. The order by expression to sort the SaaS profile reports. Supported fields: * email * os_platform * first_navigation_time * last_navigation_time Default order is ascending. To specify descending order for a field, append " desc".
12534
+ */
12535
+ orderBy?: string;
12536
+ /**
12537
+ * Optional. The maximum number of reports to return. The service may return fewer than this value. If unspecified, at most 100 reports will be returned. The maximum value is 200; values above 200 will be coerced to 200.
12538
+ */
12539
+ pageSize?: number;
12540
+ /**
12541
+ * Optional. A page token, received from a previous `FindSaasUsageProfiles` call. Provide this to retrieve the subsequent page.
12542
+ */
12543
+ pageToken?: string;
12544
+ }
11798
12545
 
11799
12546
  export class Resource$Customers$Telemetry {
11800
12547
  context: APIRequestContext;