@googleapis/threatintelligence 1.0.0 → 3.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/build/v1beta.d.ts CHANGED
@@ -70,31 +70,14 @@ export declare namespace threatintelligence_v1beta {
70
70
  projects: Resource$Projects;
71
71
  constructor(options: GlobalOptions, google?: GoogleConfigurable);
72
72
  }
73
- /**
74
- * The software that is affected by the vulnerability.
75
- */
76
- export interface Schema$AffectedSoftware {
77
- /**
78
- * Optional. The product of the software.
79
- */
80
- product?: string | null;
81
- /**
82
- * Optional. The vendor of the software.
83
- */
84
- vendor?: string | null;
85
- }
86
73
  /**
87
74
  * Stateful object representing a group of Findings. Key feature to an Alert is that it expresses the user's intent towards the findings of that group, even those that haven't occurred yet.
88
75
  */
89
76
  export interface Schema$Alert {
90
77
  /**
91
- * Optional. AI summary of the finding.
78
+ * Optional. AI summary of the alert.
92
79
  */
93
80
  aiSummary?: string | null;
94
- /**
95
- * Output only. Assets that are impacted by this alert.
96
- */
97
- assets?: string[] | null;
98
81
  /**
99
82
  * Output only. Audit information for the alert.
100
83
  */
@@ -127,6 +110,10 @@ export declare namespace threatintelligence_v1beta {
127
110
  * Output only. External ID for the alert. This is used internally to provide protection against out of order updates.
128
111
  */
129
112
  externalId?: string | null;
113
+ /**
114
+ * Output only. The number of findings associated with this alert.
115
+ */
116
+ findingCount?: string | null;
130
117
  /**
131
118
  * Output only. Findings that are covered by this alert.
132
119
  */
@@ -172,21 +159,13 @@ export declare namespace threatintelligence_v1beta {
172
159
  * Insider Threat alert detail type.
173
160
  */
174
161
  insiderThreat?: Schema$InsiderThreatAlertDetail;
175
- /**
176
- * Domain Monitoring alert detail type.
177
- */
178
- suspiciousDomain?: Schema$SuspiciousDomainAlertDetail;
179
- /**
180
- * Technology Watchlist alert detail type.
181
- */
182
- targetTechnology?: Schema$TargetTechnologyAlertDetail;
183
162
  }
184
163
  /**
185
164
  * A document that is associated with an alert.
186
165
  */
187
166
  export interface Schema$AlertDocument {
188
167
  /**
189
- * Output only. AI summary of the finding.
168
+ * Output only. AI summary of the document.
190
169
  */
191
170
  aiSummary?: string | null;
192
171
  /**
@@ -202,7 +181,7 @@ export declare namespace threatintelligence_v1beta {
202
181
  */
203
182
  content?: string | null;
204
183
  /**
205
- * Output only. The time the document was created.
184
+ * Output only. The timestamp of the original external publication of the document.
206
185
  */
207
186
  createTime?: string | null;
208
187
  /**
@@ -251,61 +230,6 @@ export declare namespace threatintelligence_v1beta {
251
230
  */
252
231
  translatedTitle?: string | null;
253
232
  }
254
- /**
255
- * Customer defined Configuration for asset discovery.
256
- */
257
- export interface Schema$AssetDiscoveryConfig {
258
- /**
259
- * Output only. Timestamp of the last scan completed. This field is set by the system and cannot be modified by the user.
260
- */
261
- lastScanCompleteTime?: string | null;
262
- /**
263
- * Output only. Timestamp of the last scan started - used for scheduling the next scan. This field is set by the system and cannot be modified by the user.
264
- */
265
- lastScanStartTime?: string | null;
266
- /**
267
- * Required. Frequency at which the scheduled discovery scan should be run. If not specified, the default frequency is DAILY.
268
- */
269
- scanFrequency?: string | null;
270
- /**
271
- * Optional. Seed assets that are out of scope for the scheduled discovery scan.
272
- */
273
- scopeExclusionAssets?: Schema$AssetDiscoverySeed[];
274
- /**
275
- * Required. Seed assets for the scheduled discovery scan. At least one seed asset is required.
276
- */
277
- seedAssets?: Schema$AssetDiscoverySeed[];
278
- /**
279
- * Required. Workflow to be used for the scheduled discovery scan. If not specified, the default workflow is EXTERNAL_DISCOVERY.
280
- */
281
- workflow?: string | null;
282
- }
283
- /**
284
- * Seed assets for asset discovery.
285
- */
286
- export interface Schema$AssetDiscoverySeed {
287
- /**
288
- * Required. Type of the seed asset.
289
- */
290
- seedType?: string | null;
291
- /**
292
- * Required. Value for the seed asset. Could be an IP address, network service, email addresses, etc.
293
- */
294
- seedValue?: string | null;
295
- }
296
- /**
297
- * Represents an association with a vulnerability.
298
- */
299
- export interface Schema$Association {
300
- /**
301
- * Required. The ID of the association.
302
- */
303
- id?: string | null;
304
- /**
305
- * Required. The type of the association.
306
- */
307
- type?: string | null;
308
- }
309
233
  /**
310
234
  * Tracks basic CRUD facts.
311
235
  */
@@ -327,63 +251,6 @@ export declare namespace threatintelligence_v1beta {
327
251
  */
328
252
  updateTime?: string | null;
329
253
  }
330
- /**
331
- * Sample compromised credential detail.
332
- */
333
- export interface Schema$CompromisedCredentialsFindingDetail {
334
- /**
335
- * Optional. Reference to the author this detail was extracted from. This is deprecated and will be removed.
336
- */
337
- author?: string | null;
338
- /**
339
- * Optional. Claimed site the credential is intended for.
340
- */
341
- credentialService?: string | null;
342
- /**
343
- * Optional. Reference to the dark web document. This is deprecated and will be removed.
344
- */
345
- darkWebDoc?: string | null;
346
- /**
347
- * Optional. This will contain a link to the external reference for this credential. If set, this is a link back to the DTM product to allow customers to get additional context about this finding.
348
- */
349
- externalReferenceUri?: string | null;
350
- /**
351
- * Optional. If the source of the credential was from a file dump this will contain the name of the file the credential was found in. This can be used by customers for context on where the credential was found and to try to find other references to the file in the wild.
352
- */
353
- fileDump?: string | null;
354
- /**
355
- * Optional. A list of hashes of the file dump. These will be prefixed with the algorithm. Example: "sha256:"
356
- */
357
- fileDumpHashes?: string[] | null;
358
- /**
359
- * Optional. If file_dump is set this will contain the size of the dump file in bytes. File dumps can be very large.
360
- */
361
- fileDumpSizeBytes?: string | null;
362
- /**
363
- * Optional. Reference to the forum this detail was extracted from. This is deprecated and will be removed.
364
- */
365
- forum?: string | null;
366
- /**
367
- * Optional. This will indicate the malware family that leaked this credential, if known.
368
- */
369
- malwareFamily?: string | null;
370
- /**
371
- * Optional. This indicates our best guess as to when the credential was leaked to the particular venue that triggered this finding. This is not necessarily the time the credential was actually leaked and it may not always be be accurate.
372
- */
373
- postedTime?: string | null;
374
- /**
375
- * Optional. If the source of a credential is publicly addressable this will contain a uri to the where the credential was found.
376
- */
377
- sourceUri?: string | null;
378
- /**
379
- * Required. This field will always be set and will be used to identify the user named in the credential leak. In cases where customers are authorized to see the actual user key this will be set to the actual user key. In cases where the customer is not authorized to see the actual user key this will be set to a hash of the user key. The hashed value is an intentionally opaque value that is not intended to be used for any other purpose than to uniquely identify the user in the context of this specific customer, service domain, and user name. Example: "user@example.com" or "redacted:".
380
- */
381
- userKey?: string | null;
382
- /**
383
- * Optional. Claimed evidence of the password/secret. This will always be hashed. In the event where the plaintext password is known it will be set to "redacted:" where the same hash will be presented when the same password is found for the same organization for the same service. Redaction is done by hashing the password with a salt that is unique to the customer organization and service. In the event where the plaintext password is not known it will be set to ":" where the algorithm is the hash algorithm used and the hash is the hash of the password using that algorithm. In the event we don't know the exact algorithm used we will set it to "hashed:".
384
- */
385
- userSecretEvidence?: string | null;
386
- }
387
254
  /**
388
255
  * A configuration represents a behavior an engine should follow when producing new findings.
389
256
  */
@@ -405,7 +272,7 @@ export declare namespace threatintelligence_v1beta {
405
272
  */
406
273
  displayName?: string | null;
407
274
  /**
408
- * Identifier. Server generated name for the configuration. format is vaults/{vault\}/configurations/{configuration\}
275
+ * Identifier. Server generated name for the configuration. format is projects/{project\}/configurations/{configuration\}
409
276
  */
410
277
  name?: string | null;
411
278
  /**
@@ -425,10 +292,6 @@ export declare namespace threatintelligence_v1beta {
425
292
  * Wrapper class that contains the union struct for all the various configuration detail specific classes.
426
293
  */
427
294
  export interface Schema$ConfigurationDetail {
428
- /**
429
- * Asset Discovery detail config.
430
- */
431
- assetDiscovery?: Schema$AssetDiscoveryConfig;
432
295
  /**
433
296
  * Customer Profile detail config.
434
297
  */
@@ -437,18 +300,6 @@ export declare namespace threatintelligence_v1beta {
437
300
  * Output only. Name of the detail type. Will be set by the server during creation to the name of the field that is set in the detail union.
438
301
  */
439
302
  detailType?: string | null;
440
- /**
441
- * Domain Monitoring detail config.
442
- */
443
- domainMonitoring?: Schema$DomainMonitoringConfig;
444
- /**
445
- * Initial Access Broker (IAB) detail config.
446
- */
447
- initialAccessBroker?: Schema$InitialAccessBrokerConfig;
448
- /**
449
- * Technology Watchlist detail config.
450
- */
451
- technologyWatchlist?: Schema$TechnologyWatchListConfig;
452
303
  }
453
304
  /**
454
305
  * A ConfigurationRevision is a snapshot of a Configuration at a point in time. It is immutable.
@@ -459,7 +310,7 @@ export declare namespace threatintelligence_v1beta {
459
310
  */
460
311
  createTime?: string | null;
461
312
  /**
462
- * Identifier. The name of the ConfigurationRevision Format: vaults//configurations//revisions/ OR projects//configurations//revisions/
313
+ * Identifier. The name of the ConfigurationRevision Format: projects//configurations//revisions/
463
314
  */
464
315
  name?: string | null;
465
316
  /**
@@ -760,7 +611,7 @@ export declare namespace threatintelligence_v1beta {
760
611
  */
761
612
  discoveryDocumentIds?: string[] | null;
762
613
  /**
763
- * Required. Data Leak specific severity This will be the string representation of the DataLeakFindingDetail.Severityenum. (e.g., "LOW", "MEDIUM", "HIGH", "CRITICAL")
614
+ * Required. The severity of the Data Leak alert. Allowed values are: * `LOW` * `MEDIUM` * `HIGH` * `CRITICAL`
764
615
  */
765
616
  severity?: string | null;
766
617
  }
@@ -781,61 +632,6 @@ export declare namespace threatintelligence_v1beta {
781
632
  */
782
633
  severity?: string | null;
783
634
  }
784
- /**
785
- * Any account-level configuration options will go here.
786
- */
787
- export interface Schema$DomainMonitoringConfig {
788
- /**
789
- * The domains to use as "seeds" for Suspicious Domain Monitoring.
790
- */
791
- domains?: Schema$DomainMonitoringDomain[];
792
- }
793
- /**
794
- * A Domain Monitoring "domain"
795
- */
796
- export interface Schema$DomainMonitoringDomain {
797
- /**
798
- * The domain name to match against.
799
- */
800
- domain?: string | null;
801
- }
802
- /**
803
- * EntityProfile represents the structured profile of a customer entity, containing key identifiers and descriptive attributes optimized for contextual matching against threat intelligence, particularly Initial Access Broker (IAB) offerings.
804
- */
805
- export interface Schema$EntityProfile {
806
- /**
807
- * Optional. List of specific countries of operation. Purpose: Essential for matching geographically targeted threats (e.g., actor specifies victims in 'DE'). Use ISO 3166-1 alpha-2 codes (e.g., "US", "GB", "JP", "DE").
808
- */
809
- countries?: string[] | null;
810
- /**
811
- * Required. List of primary internet domain names associated with the entity. Purpose: Crucial for explicit matching against domains mentioned in threat intel and can inform semantic matching. Must contain at least one domain. Example: ["acme.com", "acme.co.uk"]
812
- */
813
- domains?: string[] | null;
814
- /**
815
- * Optional. List of primary industry sectors the entity operates within. Purpose: Crucial for matching industry-specific threats and understanding attacker motivation. Use standardized GTI Industry Classification values. Example: ["Technology", "Financial Services", "Healthcare"]
816
- */
817
- industries?: string[] | null;
818
- /**
819
- * Required. Canonical name of the entity (e.g., the legal company name). Purpose: Primary identifier for the customer.
820
- */
821
- name?: string | null;
822
- /**
823
- * Optional. Specific geographic areas of *significant* operational concentration or strategic importance below the country level, if clearly identifiable and relevant. Purpose: Useful for highly localized threats, less commonly populated than `countries`. Example: ["Silicon Valley", "Frankfurt am Main Metropolitan Region"]
824
- */
825
- operationalAreas?: string[] | null;
826
- /**
827
- * Required. A concise, machine-generated (e.g., LLM) or human-curated summary of the entity. Purpose: Captures the semantic essence for embedding generation and similarity matching. Should synthesize key aspects like core business, scale, and market. Example: "Acme Corporation is a large, US-based multinational conglomerate operating..."
828
- */
829
- profileSummary?: string | null;
830
- /**
831
- * Optional. List of primary geopolitical regions where the entity has significant operations. Purpose: Filters geographically relevant threats. Use standardized names or codes where possible (e.g., "North America", "EMEA", "APAC", UN M49 codes).
832
- */
833
- regions?: string[] | null;
834
- /**
835
- * Optional. List of more granular sub-industries, if applicable and known. Purpose: Provides finer-grained context for more specific threat matching. Should align with GTI classifications if possible. Example: ["Semiconductors", "Cloud Computing Services", "Investment Banking"]
836
- */
837
- subIndustries?: string[] | null;
838
- }
839
635
  /**
840
636
  * Response message for EnumerateAlertFacets.
841
637
  */
@@ -912,10 +708,6 @@ export declare namespace threatintelligence_v1beta {
912
708
  * Optional. Name of the alert that this finding is bound to.
913
709
  */
914
710
  alert?: string | null;
915
- /**
916
- * Optional. Optional - asset name if known. Format: vaults/{vault\}/assets/{asset\}
917
- */
918
- asset?: string | null;
919
711
  /**
920
712
  * Output only. Audit data about the finding.
921
713
  */
@@ -933,11 +725,7 @@ export declare namespace threatintelligence_v1beta {
933
725
  */
934
726
  displayName?: string | null;
935
727
  /**
936
- * Optional. Optional - name of the issue that this finding is bound to. Format: vaults/{vault\}/issues/{issue\}
937
- */
938
- issue?: string | null;
939
- /**
940
- * Identifier. Server generated name for the finding (leave clear during creation). Format: vaults/{vault\}/findings/{finding\}
728
+ * Identifier. Server generated name for the finding (leave clear during creation). Format: projects/{project\}/findings/{finding\}
941
729
  */
942
730
  name?: string | null;
943
731
  /**
@@ -965,10 +753,6 @@ export declare namespace threatintelligence_v1beta {
965
753
  * Wrapper class that contains the union struct for all the various findings detail specific classes.
966
754
  */
967
755
  export interface Schema$FindingDetail {
968
- /**
969
- * Compromised Credentials detail type.
970
- */
971
- compromisedCredentials?: Schema$CompromisedCredentialsFindingDetail;
972
756
  /**
973
757
  * Data Leak finding detail type.
974
758
  */
@@ -977,10 +761,6 @@ export declare namespace threatintelligence_v1beta {
977
761
  * Output only. Name of the detail type. Will be set by the server during creation to the name of the field that is set in the detail union.
978
762
  */
979
763
  detailType?: string | null;
980
- /**
981
- * Inband vulnerability detail type.
982
- */
983
- inbandVulnerability?: Schema$InbandVulnerabilityFindingDetail;
984
764
  /**
985
765
  * Initial Access Broker finding detail type.
986
766
  */
@@ -989,96 +769,19 @@ export declare namespace threatintelligence_v1beta {
989
769
  * Insider Threat finding detail type.
990
770
  */
991
771
  insiderThreat?: Schema$InsiderThreatFindingDetail;
992
- /**
993
- * Misconfiguration finding detail type.
994
- */
995
- misconfiguration?: Schema$MisconfigurationFindingDetail;
996
- /**
997
- * Domain Monitoring finding detail type.
998
- */
999
- suspiciousDomain?: Schema$SuspiciousDomainFindingDetail;
1000
- /**
1001
- * Technology Watchlist finding detail type.
1002
- */
1003
- targetTechnology?: Schema$TargetTechnologyFindingDetail;
1004
772
  }
1005
773
  /**
1006
- * Fleshed out vulnerability object that includes enough details to fill out a vulnerability specific view for an issue.
774
+ * Request message for GenerateOrgProfileConfiguration.
1007
775
  */
1008
- export interface Schema$InbandVulnerability {
1009
- /**
1010
- * Optional. The software that is affected by the vulnerability.
1011
- */
1012
- affectedSoftware?: Schema$AffectedSoftware[];
1013
- /**
1014
- * Optional. The authors of the vulnerability detection.
1015
- */
1016
- authors?: string[] | null;
776
+ export interface Schema$GenerateOrgProfileConfigurationRequest {
1017
777
  /**
1018
- * Required. The CVE ID of the vulnerability.
778
+ * Required. The display name of the organization to generate the profile for.
1019
779
  */
1020
- cveId?: string | null;
1021
- /**
1022
- * Required. The CVSS V3.1 score (Base score)for the vulnerability. ( )
1023
- */
1024
- cvssV31Score?: number | null;
1025
- /**
1026
- * Optional. Temporal CVSS V3.1 score for the vulnerability.
1027
- */
1028
- cvssV31ScoreTemporal?: number | null;
1029
- /**
1030
- * Optional. The human readable description. This can be basic HTML formatted text.
1031
- */
1032
- description?: string | null;
1033
- /**
1034
- * Optional. The date the vulnerability was first disclosed.
1035
- */
1036
- disclosureTime?: string | null;
1037
- /**
1038
- * Optional. Exploitation state of the vulnerability, for example "Available".
1039
- */
1040
- exploitationState?: string | null;
1041
- /**
1042
- * Required. The external ID of the vulnerability.
1043
- */
1044
- externalVulnerabilityId?: string | null;
1045
- /**
1046
- * Optional. Whether this is exploited in the wild.
1047
- */
1048
- isExploitedWild?: boolean | null;
1049
- /**
1050
- * Optional. Reference URLs to the vulnerability.
1051
- */
1052
- referenceUrls?: string[] | null;
1053
- /**
1054
- * Optional. The human readable remediation recommendation. This can be basic HTML formatted text.
1055
- */
1056
- remediation?: string | null;
1057
- /**
1058
- * Optional. Risk rating for the vulnerability, for example "High".
1059
- */
1060
- riskRating?: string | null;
1061
- /**
1062
- * Optional. Human readable name for the vulnerability.
1063
- */
1064
- title?: string | null;
1065
- }
1066
- /**
1067
- * This is a temporary detail type that will be used to support vulnerabilities until the engines start using the full vulnerability objects. The "Inband" refers to the fact that all vulnerability details are included with every finding.
1068
- */
1069
- export interface Schema$InbandVulnerabilityFindingDetail {
1070
- /**
1071
- * Optional. A short description of the proof of the vulnerability.
1072
- */
1073
- formattedProofDetails?: string | null;
1074
- /**
1075
- * Optional. The URI that lead to this detection, if appropriate.
1076
- */
1077
- requestUri?: string | null;
780
+ displayName?: string | null;
1078
781
  /**
1079
- * Required. Vulnerability metadata.
782
+ * Required. The domain of the organization to generate the profile for.
1080
783
  */
1081
- vulnerability?: Schema$InbandVulnerability;
784
+ domain?: string | null;
1082
785
  }
1083
786
  /**
1084
787
  * Captures the specific details of InitialAccessBroker (IAB) alert.
@@ -1089,19 +792,10 @@ export declare namespace threatintelligence_v1beta {
1089
792
  */
1090
793
  discoveryDocumentIds?: string[] | null;
1091
794
  /**
1092
- * Required. IAB specific severity
795
+ * Required. The severity of the Initial Access Broker (IAB) alert. Allowed values are: * `LOW` * `MEDIUM` * `HIGH` * `CRITICAL`
1093
796
  */
1094
797
  severity?: string | null;
1095
798
  }
1096
- /**
1097
- * InitialAccessBrokerConfig is specific to Initial Access Broker (IAB) matching scenarios.
1098
- */
1099
- export interface Schema$InitialAccessBrokerConfig {
1100
- /**
1101
- * Represents the comprehensive profile of the customer entity used for matching.
1102
- */
1103
- entityProfile?: Schema$EntityProfile;
1104
- }
1105
799
  /**
1106
800
  * A detail object for an Initial Access Broker (IAB) finding.
1107
801
  */
@@ -1128,7 +822,7 @@ export declare namespace threatintelligence_v1beta {
1128
822
  */
1129
823
  discoveryDocumentIds?: string[] | null;
1130
824
  /**
1131
- * Required. InsiderThreat specific severity This will be the string representation of the InsiderThreatFindingDetail.Severityenum. (e.g., "LOW", "MEDIUM", "HIGH", "CRITICAL")
825
+ * Required. The severity of the Insider Threat alert. Allowed values are: * `LOW` * `MEDIUM` * `HIGH` * `CRITICAL`
1132
826
  */
1133
827
  severity?: string | null;
1134
828
  }
@@ -1251,55 +945,33 @@ export declare namespace threatintelligence_v1beta {
1251
945
  export interface Schema$MarkAlertAsTriagedRequest {
1252
946
  }
1253
947
  /**
1254
- * Misconfiguration finding detail.
1255
- */
1256
- export interface Schema$MisconfigurationFindingDetail {
1257
- /**
1258
- * Required. The misconfiguration metadata.
1259
- */
1260
- misconfigurationMetadata?: Schema$MisconfigurationMetadata;
1261
- }
1262
- /**
1263
- * Misconfiguration metadata.
948
+ * This resource represents a long-running operation that is the result of a network API call.
1264
949
  */
1265
- export interface Schema$MisconfigurationMetadata {
1266
- /**
1267
- * Optional. Description of the misconfiguration.
1268
- */
1269
- description?: string | null;
1270
- /**
1271
- * Optional. A user-friendly name for the misconfiguration.
1272
- */
1273
- displayName?: string | null;
950
+ export interface Schema$Operation {
1274
951
  /**
1275
- * Required. The identifier for the misconfiguration. This is an internal name generated by the finding provider.
952
+ * If the value is `false`, it means the operation is still in progress. If `true`, the operation is completed, and either `error` or `response` is available.
1276
953
  */
1277
- misconfigurationId?: string | null;
954
+ done?: boolean | null;
1278
955
  /**
1279
- * Optional. References to external resources that provide more information about the misconfiguration.
956
+ * The error result of the operation in case of failure or cancellation.
1280
957
  */
1281
- references?: Schema$MisconfigurationReference[];
958
+ error?: Schema$Status;
1282
959
  /**
1283
- * Optional. Recommended remediation steps for the misconfiguration.
960
+ * Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.
1284
961
  */
1285
- remediation?: string | null;
1286
- /**
1287
- * Optional. The endpoint which was found to have the vulnerability.
1288
- */
1289
- vulnerableUri?: string | null;
1290
- }
1291
- /**
1292
- * A reference to an external resource that provides more information about a misconfiguration.
1293
- */
1294
- export interface Schema$MisconfigurationReference {
962
+ metadata?: {
963
+ [key: string]: any;
964
+ } | null;
1295
965
  /**
1296
- * Required. The type of the reference (e.g., "description", "remediation").
966
+ * The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should be a resource name ending with `operations/{unique_id\}`.
1297
967
  */
1298
- type?: string | null;
968
+ name?: string | null;
1299
969
  /**
1300
- * Required. The URI of the reference.
970
+ * The normal, successful response of the operation. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.
1301
971
  */
1302
- uri?: string | null;
972
+ response?: {
973
+ [key: string]: any;
974
+ } | null;
1303
975
  }
1304
976
  /**
1305
977
  * Structured priority analysis for a threat.
@@ -1318,262 +990,79 @@ export declare namespace threatintelligence_v1beta {
1318
990
  */
1319
991
  reasoning?: string | null;
1320
992
  }
1321
- /**
1322
- * Request message for FetchAlertUriStatus.
1323
- */
1324
- export interface Schema$RefreshAlertUriStatusRequest {
1325
- }
1326
- /**
1327
- * Response message for FetchAlertUriStatus.
1328
- */
1329
- export interface Schema$RefreshAlertUriStatusResponse {
1330
- /**
1331
- * Output only. Status of the alert in WebRisk.
1332
- */
1333
- state?: string | null;
1334
- }
1335
993
  /**
1336
994
  * Structured relevance analysis for a threat.
1337
995
  */
1338
996
  export interface Schema$RelevanceAnalysis {
1339
997
  /**
1340
- * The level of confidence in the given verdict.
1341
- */
1342
- confidence?: string | null;
1343
- /**
1344
- * Evidence supporting the verdict, including matched and unmatched items.
1345
- */
1346
- evidence?: Schema$Evidence;
1347
- /**
1348
- * Human-readable explanation from the matcher, detailing why a particular result is considered relevant or not relevant.
1349
- */
1350
- reasoning?: string | null;
1351
- /**
1352
- * The level of relevance.
1353
- */
1354
- relevanceLevel?: string | null;
1355
- /**
1356
- * Indicates whether the threat is considered relevant.
1357
- */
1358
- relevant?: boolean | null;
1359
- }
1360
- /**
1361
- * Request message for ReportAlertUri.
1362
- */
1363
- export interface Schema$ReportAlertUriRequest {
1364
- }
1365
- /**
1366
- * Response message for ReportAlertUri.
1367
- */
1368
- export interface Schema$ReportAlertUriResponse {
1369
- /**
1370
- * Output only. Status of the alert in WebRisk.
1371
- */
1372
- state?: string | null;
1373
- }
1374
- /**
1375
- * Response message for SearchFindings.
1376
- */
1377
- export interface Schema$SearchFindingsResponse {
1378
- /**
1379
- * List of findings.
1380
- */
1381
- findings?: Schema$Finding[];
1382
- /**
1383
- * Page token.
1384
- */
1385
- nextPageToken?: string | null;
1386
- }
1387
- /**
1388
- * Structured severity analysis for a threat.
1389
- */
1390
- export interface Schema$SeverityAnalysis {
1391
- /**
1392
- * The level of confidence in the given verdict.
1393
- */
1394
- confidence?: string | null;
1395
- /**
1396
- * Human-readable explanation from the model, detailing why a particular result is considered to have a certain severity.
1397
- */
1398
- reasoning?: string | null;
1399
- /**
1400
- * The level of severity.
1401
- */
1402
- severityLevel?: string | null;
1403
- }
1404
- /**
1405
- * The alert detail for a suspicious domain finding.
1406
- */
1407
- export interface Schema$SuspiciousDomainAlertDetail {
1408
- /**
1409
- * The DNS details of the suspicious domain.
1410
- */
1411
- dns?: Schema$SuspiciousDomainDnsDetails;
1412
- /**
1413
- * Required. The suspicious domain name.
1414
- */
1415
- domain?: string | null;
1416
- /**
1417
- * The GTI details of the suspicious domain.
1418
- */
1419
- gtiDetails?: Schema$SuspiciousDomainGtiDetails;
1420
- /**
1421
- * Output only. Name of Web Risk submission operation.
1422
- */
1423
- webRiskOperation?: string | null;
1424
- /**
1425
- * Output only. Status of the Web Risk submission.
1426
- */
1427
- webRiskState?: string | null;
1428
- /**
1429
- * The whois details of the suspicious domain.
1430
- */
1431
- whois?: Schema$SuspiciousDomainWhoIsDetails;
1432
- }
1433
- /**
1434
- * The DNS details of the suspicious domain.
1435
- */
1436
- export interface Schema$SuspiciousDomainDnsDetails {
1437
- /**
1438
- * The DNS records of the suspicious domain.
1439
- */
1440
- dnsRecords?: Schema$SuspiciousDomainDnsRecord[];
1441
- /**
1442
- * The time the DNS details were retrieved.
1443
- */
1444
- retrievalTime?: string | null;
1445
- }
1446
- /**
1447
- * The DNS record of the suspicious domain.
1448
- */
1449
- export interface Schema$SuspiciousDomainDnsRecord {
1450
- /**
1451
- * The name of the DNS record.
1452
- */
1453
- record?: string | null;
1454
- /**
1455
- * The TTL of the DNS record.
1456
- */
1457
- ttl?: number | null;
1458
- /**
1459
- * The type of the DNS record.
1460
- */
1461
- type?: string | null;
1462
- /**
1463
- * The value of the DNS record.
1464
- */
1465
- value?: string | null;
1466
- }
1467
- /**
1468
- * A detailed object for a suspicious Domain finding.
1469
- */
1470
- export interface Schema$SuspiciousDomainFindingDetail {
1471
- /**
1472
- * The DNS details of the suspicious domain.
1473
- */
1474
- dns?: Schema$SuspiciousDomainDnsDetails;
1475
- /**
1476
- * Required. The suspicious domain name.
1477
- */
1478
- domain?: string | null;
1479
- /**
1480
- * The GTI details of the suspicious domain.
1481
- */
1482
- gtiDetails?: Schema$SuspiciousDomainGtiDetails;
1483
- /**
1484
- * Required. Reference to the match score of the finding. This is a float value between 0 and 1 calculated by the matching engine.
1485
- */
1486
- matchScore?: number | null;
1487
- /**
1488
- * Required. The severity of the finding. This indicates the potential impact of the threat.
1489
- */
1490
- severity?: string | null;
1491
- /**
1492
- * The whois details of the suspicious domain.
1493
- */
1494
- whois?: Schema$SuspiciousDomainWhoIsDetails;
1495
- }
1496
- /**
1497
- * The GTI details of the suspicious domain.
1498
- */
1499
- export interface Schema$SuspiciousDomainGtiDetails {
1500
- /**
1501
- * The threat score of the suspicious domain. The threat score is a number between 0 and 100.
998
+ * The level of confidence in the given verdict.
1502
999
  */
1503
- threatScore?: number | null;
1000
+ confidence?: string | null;
1504
1001
  /**
1505
- * Output only. The verdict of the suspicious domain.
1002
+ * Evidence supporting the verdict, including matched and unmatched items.
1506
1003
  */
1507
- verdict?: string | null;
1004
+ evidence?: Schema$Evidence;
1508
1005
  /**
1509
- * VirusTotal link for the domain
1006
+ * Human-readable explanation from the matcher, detailing why a particular result is considered relevant or not relevant.
1510
1007
  */
1511
- virustotalUri?: string | null;
1512
- }
1513
- /**
1514
- * The whois details of the suspicious domain.
1515
- */
1516
- export interface Schema$SuspiciousDomainWhoIsDetails {
1008
+ reasoning?: string | null;
1517
1009
  /**
1518
- * The time the whois details were retrieved.
1010
+ * The level of relevance.
1519
1011
  */
1520
- retrievalTime?: string | null;
1012
+ relevanceLevel?: string | null;
1521
1013
  /**
1522
- * The whois details of the suspicious domain.
1014
+ * Indicates whether the threat is considered relevant.
1523
1015
  */
1524
- whois?: string | null;
1016
+ relevant?: boolean | null;
1525
1017
  }
1526
1018
  /**
1527
- * Contains details for a technology watchlist alert.
1019
+ * Response message for SearchFindings.
1528
1020
  */
1529
- export interface Schema$TargetTechnologyAlertDetail {
1021
+ export interface Schema$SearchFindingsResponse {
1530
1022
  /**
1531
- * Optional. The vulnerability match details.
1023
+ * List of findings.
1532
1024
  */
1533
- vulnerabilityMatch?: Schema$VulnerabilityMatch;
1534
- }
1535
- /**
1536
- * Contains details for a technology watchlist finding.
1537
- */
1538
- export interface Schema$TargetTechnologyFindingDetail {
1025
+ findings?: Schema$Finding[];
1539
1026
  /**
1540
- * Optional. The vulnerability match details.
1027
+ * Page token.
1541
1028
  */
1542
- vulnerabilityMatch?: Schema$VulnerabilityMatch;
1029
+ nextPageToken?: string | null;
1543
1030
  }
1544
1031
  /**
1545
- * TechnologyWatchListAlertThreshold contains the thresholds for alerting.
1032
+ * Structured severity analysis for a threat.
1546
1033
  */
1547
- export interface Schema$TechnologyWatchListAlertThreshold {
1548
- /**
1549
- * Optional. The minimum cvss V3 score for the alert. Ex: 7.0. Valid range is [0.0, 10.0].
1550
- */
1551
- cvssScoreMinimum?: number | null;
1034
+ export interface Schema$SeverityAnalysis {
1552
1035
  /**
1553
- * Optional. The minimum epss score for the alert. Ex: 0.8. Valid range is [0.0, 1.0].
1036
+ * The level of confidence in the given verdict.
1554
1037
  */
1555
- epssScoreMinimum?: number | null;
1038
+ confidence?: string | null;
1556
1039
  /**
1557
- * Optional. The exploitation states of the alert.
1040
+ * Human-readable explanation from the model, detailing why a particular result is considered to have a certain severity.
1558
1041
  */
1559
- exploitationStates?: string[] | null;
1042
+ reasoning?: string | null;
1560
1043
  /**
1561
- * Optional. The minimum priority for the alert.
1044
+ * The level of severity.
1562
1045
  */
1563
- priorityMinimum?: string | null;
1046
+ severityLevel?: string | null;
1564
1047
  }
1565
1048
  /**
1566
- * TechnologyWatchListConfig is the configuration for the technology watchlist.
1049
+ * The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors).
1567
1050
  */
1568
- export interface Schema$TechnologyWatchListConfig {
1051
+ export interface Schema$Status {
1052
+ /**
1053
+ * The status code, which should be an enum value of google.rpc.Code.
1054
+ */
1055
+ code?: number | null;
1569
1056
  /**
1570
- * Optional. Alert thresholds to effectively reduce noise.
1057
+ * A list of messages that carry the error details. There is a common set of message types for APIs to use.
1571
1058
  */
1572
- alertThreshold?: Schema$TechnologyWatchListAlertThreshold;
1059
+ details?: Array<{
1060
+ [key: string]: any;
1061
+ }> | null;
1573
1062
  /**
1574
- * Optional. List of vendor, technology or cpe fingerprint. example: Microsoft office 360 Apache Server 3.5 cpe:2.3:a:microsoft:outlook:*:*:*:*:*:*:*:*
1063
+ * A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
1575
1064
  */
1576
- technologies?: string[] | null;
1065
+ message?: string | null;
1577
1066
  }
1578
1067
  /**
1579
1068
  * Response message for UpsertConfiguration.
@@ -1584,49 +1073,95 @@ export declare namespace threatintelligence_v1beta {
1584
1073
  */
1585
1074
  configuration?: string | null;
1586
1075
  }
1587
- /**
1588
- * Contains details about a vulnerability match.
1589
- */
1590
- export interface Schema$VulnerabilityMatch {
1591
- /**
1592
- * Optional. Associated threat actors, malware, etc. This is embedded as a snapshot because the details of the association at the time of the vulnerability match are important for context and reporting.
1593
- */
1594
- associations?: Schema$Association[];
1595
- /**
1596
- * Required. The collection ID of the vulnerability. Ex: "vulnerability--cve-2025-9876".
1597
- */
1598
- collectionId?: string | null;
1599
- /**
1600
- * Required. The CVE ID of the vulnerability. Ex: "CVE-2025-9876". See https://www.cve.org/ for more information.
1601
- */
1602
- cveId?: string | null;
1603
- /**
1604
- * Required. The CVSS v3 score of the vulnerability. Example: 6.4.
1605
- */
1606
- cvss3Score?: number | null;
1607
- /**
1608
- * Required. A description of the vulnerability.
1609
- */
1610
- description?: string | null;
1611
- /**
1612
- * Required. The exploitation state of the vulnerability.
1613
- */
1614
- exploitationState?: string | null;
1615
- /**
1616
- * Required. The risk rating of the vulnerability.
1617
- */
1618
- riskRating?: string | null;
1619
- /**
1620
- * Required. The affected technologies. Ex: "Apache Struts".
1621
- */
1622
- technologies?: string[] | null;
1623
- }
1624
1076
  export class Resource$Projects {
1625
1077
  context: APIRequestContext;
1626
1078
  alerts: Resource$Projects$Alerts;
1627
1079
  configurations: Resource$Projects$Configurations;
1628
1080
  findings: Resource$Projects$Findings;
1629
1081
  constructor(context: APIRequestContext);
1082
+ /**
1083
+ * Triggers the generation of a Customer Profile for a project.
1084
+ * @example
1085
+ * ```js
1086
+ * // Before running the sample:
1087
+ * // - Enable the API at:
1088
+ * // https://console.developers.google.com/apis/api/threatintelligence.googleapis.com
1089
+ * // - Login into gcloud by running:
1090
+ * // ```sh
1091
+ * // $ gcloud auth application-default login
1092
+ * // ```
1093
+ * // - Install the npm module by running:
1094
+ * // ```sh
1095
+ * // $ npm install googleapis
1096
+ * // ```
1097
+ *
1098
+ * const {google} = require('googleapis');
1099
+ * const threatintelligence = google.threatintelligence('v1beta');
1100
+ *
1101
+ * async function main() {
1102
+ * const auth = new google.auth.GoogleAuth({
1103
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
1104
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
1105
+ * });
1106
+ *
1107
+ * // Acquire an auth client, and bind it to all future calls
1108
+ * const authClient = await auth.getClient();
1109
+ * google.options({auth: authClient});
1110
+ *
1111
+ * // Do the magic
1112
+ * const res = await threatintelligence.projects.generateOrgProfile({
1113
+ * // Required. The name of the project to generate the profile for. Format: projects/{project\}
1114
+ * name: 'projects/my-project',
1115
+ *
1116
+ * // Request body metadata
1117
+ * requestBody: {
1118
+ * // request body parameters
1119
+ * // {
1120
+ * // "displayName": "my_displayName",
1121
+ * // "domain": "my_domain"
1122
+ * // }
1123
+ * },
1124
+ * });
1125
+ * console.log(res.data);
1126
+ *
1127
+ * // Example response
1128
+ * // {
1129
+ * // "done": false,
1130
+ * // "error": {},
1131
+ * // "metadata": {},
1132
+ * // "name": "my_name",
1133
+ * // "response": {}
1134
+ * // }
1135
+ * }
1136
+ *
1137
+ * main().catch(e => {
1138
+ * console.error(e);
1139
+ * throw e;
1140
+ * });
1141
+ *
1142
+ * ```
1143
+ *
1144
+ * @param params - Parameters for request
1145
+ * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
1146
+ * @param callback - Optional callback that handles the response.
1147
+ * @returns A promise if used with async/await, or void if used with a callback.
1148
+ */
1149
+ generateOrgProfile(params: Params$Resource$Projects$Generateorgprofile, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
1150
+ generateOrgProfile(params?: Params$Resource$Projects$Generateorgprofile, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$Operation>>;
1151
+ generateOrgProfile(params: Params$Resource$Projects$Generateorgprofile, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
1152
+ generateOrgProfile(params: Params$Resource$Projects$Generateorgprofile, options: MethodOptions | BodyResponseCallback<Schema$Operation>, callback: BodyResponseCallback<Schema$Operation>): void;
1153
+ generateOrgProfile(params: Params$Resource$Projects$Generateorgprofile, callback: BodyResponseCallback<Schema$Operation>): void;
1154
+ generateOrgProfile(callback: BodyResponseCallback<Schema$Operation>): void;
1155
+ }
1156
+ export interface Params$Resource$Projects$Generateorgprofile extends StandardParameters {
1157
+ /**
1158
+ * Required. The name of the project to generate the profile for. Format: projects/{project\}
1159
+ */
1160
+ name?: string;
1161
+ /**
1162
+ * Request body metadata
1163
+ */
1164
+ requestBody?: Schema$GenerateOrgProfileConfigurationRequest;
1630
1165
  }
1631
1166
  export class Resource$Projects$Alerts {
1632
1167
  context: APIRequestContext;
@@ -1677,7 +1212,6 @@ export declare namespace threatintelligence_v1beta {
1677
1212
  * // Example response
1678
1213
  * // {
1679
1214
  * // "aiSummary": "my_aiSummary",
1680
- * // "assets": [],
1681
1215
  * // "audit": {},
1682
1216
  * // "configurations": [],
1683
1217
  * // "detail": {},
@@ -1686,6 +1220,7 @@ export declare namespace threatintelligence_v1beta {
1686
1220
  * // "duplicatedBy": [],
1687
1221
  * // "etag": "my_etag",
1688
1222
  * // "externalId": "my_externalId",
1223
+ * // "findingCount": "my_findingCount",
1689
1224
  * // "findings": [],
1690
1225
  * // "name": "my_name",
1691
1226
  * // "priorityAnalysis": {},
@@ -1760,7 +1295,6 @@ export declare namespace threatintelligence_v1beta {
1760
1295
  * // Example response
1761
1296
  * // {
1762
1297
  * // "aiSummary": "my_aiSummary",
1763
- * // "assets": [],
1764
1298
  * // "audit": {},
1765
1299
  * // "configurations": [],
1766
1300
  * // "detail": {},
@@ -1769,6 +1303,7 @@ export declare namespace threatintelligence_v1beta {
1769
1303
  * // "duplicatedBy": [],
1770
1304
  * // "etag": "my_etag",
1771
1305
  * // "externalId": "my_externalId",
1306
+ * // "findingCount": "my_findingCount",
1772
1307
  * // "findings": [],
1773
1308
  * // "name": "my_name",
1774
1309
  * // "priorityAnalysis": {},
@@ -1903,7 +1438,6 @@ export declare namespace threatintelligence_v1beta {
1903
1438
  * // Example response
1904
1439
  * // {
1905
1440
  * // "aiSummary": "my_aiSummary",
1906
- * // "assets": [],
1907
1441
  * // "audit": {},
1908
1442
  * // "configurations": [],
1909
1443
  * // "detail": {},
@@ -1912,6 +1446,7 @@ export declare namespace threatintelligence_v1beta {
1912
1446
  * // "duplicatedBy": [],
1913
1447
  * // "etag": "my_etag",
1914
1448
  * // "externalId": "my_externalId",
1449
+ * // "findingCount": "my_findingCount",
1915
1450
  * // "findings": [],
1916
1451
  * // "name": "my_name",
1917
1452
  * // "priorityAnalysis": {},
@@ -1984,7 +1519,6 @@ export declare namespace threatintelligence_v1beta {
1984
1519
  * // Example response
1985
1520
  * // {
1986
1521
  * // "aiSummary": "my_aiSummary",
1987
- * // "assets": [],
1988
1522
  * // "audit": {},
1989
1523
  * // "configurations": [],
1990
1524
  * // "detail": {},
@@ -1993,6 +1527,7 @@ export declare namespace threatintelligence_v1beta {
1993
1527
  * // "duplicatedBy": [],
1994
1528
  * // "etag": "my_etag",
1995
1529
  * // "externalId": "my_externalId",
1530
+ * // "findingCount": "my_findingCount",
1996
1531
  * // "findings": [],
1997
1532
  * // "name": "my_name",
1998
1533
  * // "priorityAnalysis": {},
@@ -2059,7 +1594,6 @@ export declare namespace threatintelligence_v1beta {
2059
1594
  * // Example response
2060
1595
  * // {
2061
1596
  * // "aiSummary": "my_aiSummary",
2062
- * // "assets": [],
2063
1597
  * // "audit": {},
2064
1598
  * // "configurations": [],
2065
1599
  * // "detail": {},
@@ -2068,6 +1602,7 @@ export declare namespace threatintelligence_v1beta {
2068
1602
  * // "duplicatedBy": [],
2069
1603
  * // "etag": "my_etag",
2070
1604
  * // "externalId": "my_externalId",
1605
+ * // "findingCount": "my_findingCount",
2071
1606
  * // "findings": [],
2072
1607
  * // "name": "my_name",
2073
1608
  * // "priorityAnalysis": {},
@@ -2126,13 +1661,13 @@ export declare namespace threatintelligence_v1beta {
2126
1661
  *
2127
1662
  * // Do the magic
2128
1663
  * const res = await threatintelligence.projects.alerts.list({
2129
- * // Optional. Filter criteria.
1664
+ * // Optional. Filter criteria. Supported fields for filtering include: * `audit.create_time` * `audit.creator` * `audit.update_time` * `audit.updater` * `detail.data_leak.discovery_document_ids` * `detail.data_leak.severity` * `detail.detail_type` * `detail.initial_access_broker.discovery_document_ids` * `detail.initial_access_broker.severity` * `detail.insider_threat.discovery_document_ids` * `detail.insider_threat.severity` * `finding_count` * `priority_analysis.priority_level` * `relevance_analysis.confidence` * `relevance_analysis.relevance_level` * `relevance_analysis.relevant` * `severity_analysis.severity_level` * `state` Examples: * `detail.detail_type = "initial_access_broker"` * `detail.detail_type != "data_leak"` * `detail.insider_threat.severity = "HIGH"` * `audit.create_time \>= "2026-04-03T00:00:00Z" AND audit.create_time < "2026-04-06T00:00:00Z"` * `state = "NEW" OR state = "TRIAGED"` * `severity_analysis.severity_level = "SEVERITY_LEVEL_CRITICAL"`
2130
1665
  * filter: 'placeholder-value',
2131
- * // Optional. Order by criteria in the csv format: "field1,field2 desc" or "field1,field2" or "field1 asc, field2".
1666
+ * // Optional. Order by criteria in the csv format: "field1, field2 desc" or "field1, field2" or "field1 asc, field2". If a field is specified without `asc` or `desc`, ascending order is used by default. Supported fields for ordering are identical to those supported for filtering. Examples: * `audit.create_time desc` * `audit.update_time asc` * `audit.create_time desc, severity_analysis.severity_level desc`
2132
1667
  * orderBy: 'placeholder-value',
2133
- * // Optional. Page size.
1668
+ * // Optional. Page size. Default to 100 alerts per page. Maximum is 1000 alerts per page.
2134
1669
  * pageSize: 'placeholder-value',
2135
- * // Optional. Page token.
1670
+ * // Optional. Page token to retrieve the next page of results.
2136
1671
  * pageToken: 'placeholder-value',
2137
1672
  * // Required. Parent of the alerts. Format: projects/{project\}
2138
1673
  * parent: 'projects/my-project',
@@ -2209,7 +1744,6 @@ export declare namespace threatintelligence_v1beta {
2209
1744
  * // Example response
2210
1745
  * // {
2211
1746
  * // "aiSummary": "my_aiSummary",
2212
- * // "assets": [],
2213
1747
  * // "audit": {},
2214
1748
  * // "configurations": [],
2215
1749
  * // "detail": {},
@@ -2218,6 +1752,7 @@ export declare namespace threatintelligence_v1beta {
2218
1752
  * // "duplicatedBy": [],
2219
1753
  * // "etag": "my_etag",
2220
1754
  * // "externalId": "my_externalId",
1755
+ * // "findingCount": "my_findingCount",
2221
1756
  * // "findings": [],
2222
1757
  * // "name": "my_name",
2223
1758
  * // "priorityAnalysis": {},
@@ -2290,7 +1825,6 @@ export declare namespace threatintelligence_v1beta {
2290
1825
  * // Example response
2291
1826
  * // {
2292
1827
  * // "aiSummary": "my_aiSummary",
2293
- * // "assets": [],
2294
1828
  * // "audit": {},
2295
1829
  * // "configurations": [],
2296
1830
  * // "detail": {},
@@ -2299,6 +1833,7 @@ export declare namespace threatintelligence_v1beta {
2299
1833
  * // "duplicatedBy": [],
2300
1834
  * // "etag": "my_etag",
2301
1835
  * // "externalId": "my_externalId",
1836
+ * // "findingCount": "my_findingCount",
2302
1837
  * // "findings": [],
2303
1838
  * // "name": "my_name",
2304
1839
  * // "priorityAnalysis": {},
@@ -2326,138 +1861,6 @@ export declare namespace threatintelligence_v1beta {
2326
1861
  read(params: Params$Resource$Projects$Alerts$Read, options: MethodOptions | BodyResponseCallback<Schema$Alert>, callback: BodyResponseCallback<Schema$Alert>): void;
2327
1862
  read(params: Params$Resource$Projects$Alerts$Read, callback: BodyResponseCallback<Schema$Alert>): void;
2328
1863
  read(callback: BodyResponseCallback<Schema$Alert>): void;
2329
- /**
2330
- * Return the status of a URI submitted to Google WebRisk.
2331
- * @example
2332
- * ```js
2333
- * // Before running the sample:
2334
- * // - Enable the API at:
2335
- * // https://console.developers.google.com/apis/api/threatintelligence.googleapis.com
2336
- * // - Login into gcloud by running:
2337
- * // ```sh
2338
- * // $ gcloud auth application-default login
2339
- * // ```
2340
- * // - Install the npm module by running:
2341
- * // ```sh
2342
- * // $ npm install googleapis
2343
- * // ```
2344
- *
2345
- * const {google} = require('googleapis');
2346
- * const threatintelligence = google.threatintelligence('v1beta');
2347
- *
2348
- * async function main() {
2349
- * const auth = new google.auth.GoogleAuth({
2350
- * // Scopes can be specified either as an array or as a single, space-delimited string.
2351
- * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
2352
- * });
2353
- *
2354
- * // Acquire an auth client, and bind it to all future calls
2355
- * const authClient = await auth.getClient();
2356
- * google.options({auth: authClient});
2357
- *
2358
- * // Do the magic
2359
- * const res = await threatintelligence.projects.alerts.refreshUriStatus({
2360
- * // Required. Name of alert to refresh status from WebRisk
2361
- * name: 'projects/my-project/alerts/my-alert',
2362
- *
2363
- * // Request body metadata
2364
- * requestBody: {
2365
- * // request body parameters
2366
- * // {}
2367
- * },
2368
- * });
2369
- * console.log(res.data);
2370
- *
2371
- * // Example response
2372
- * // {
2373
- * // "state": "my_state"
2374
- * // }
2375
- * }
2376
- *
2377
- * main().catch(e => {
2378
- * console.error(e);
2379
- * throw e;
2380
- * });
2381
- *
2382
- * ```
2383
- *
2384
- * @param params - Parameters for request
2385
- * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
2386
- * @param callback - Optional callback that handles the response.
2387
- * @returns A promise if used with async/await, or void if used with a callback.
2388
- */
2389
- refreshUriStatus(params: Params$Resource$Projects$Alerts$Refreshuristatus, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
2390
- refreshUriStatus(params?: Params$Resource$Projects$Alerts$Refreshuristatus, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$RefreshAlertUriStatusResponse>>;
2391
- refreshUriStatus(params: Params$Resource$Projects$Alerts$Refreshuristatus, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
2392
- refreshUriStatus(params: Params$Resource$Projects$Alerts$Refreshuristatus, options: MethodOptions | BodyResponseCallback<Schema$RefreshAlertUriStatusResponse>, callback: BodyResponseCallback<Schema$RefreshAlertUriStatusResponse>): void;
2393
- refreshUriStatus(params: Params$Resource$Projects$Alerts$Refreshuristatus, callback: BodyResponseCallback<Schema$RefreshAlertUriStatusResponse>): void;
2394
- refreshUriStatus(callback: BodyResponseCallback<Schema$RefreshAlertUriStatusResponse>): void;
2395
- /**
2396
- * Report the URI associated with an alert to Google WebRisk.
2397
- * @example
2398
- * ```js
2399
- * // Before running the sample:
2400
- * // - Enable the API at:
2401
- * // https://console.developers.google.com/apis/api/threatintelligence.googleapis.com
2402
- * // - Login into gcloud by running:
2403
- * // ```sh
2404
- * // $ gcloud auth application-default login
2405
- * // ```
2406
- * // - Install the npm module by running:
2407
- * // ```sh
2408
- * // $ npm install googleapis
2409
- * // ```
2410
- *
2411
- * const {google} = require('googleapis');
2412
- * const threatintelligence = google.threatintelligence('v1beta');
2413
- *
2414
- * async function main() {
2415
- * const auth = new google.auth.GoogleAuth({
2416
- * // Scopes can be specified either as an array or as a single, space-delimited string.
2417
- * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
2418
- * });
2419
- *
2420
- * // Acquire an auth client, and bind it to all future calls
2421
- * const authClient = await auth.getClient();
2422
- * google.options({auth: authClient});
2423
- *
2424
- * // Do the magic
2425
- * const res = await threatintelligence.projects.alerts.reportAlertUri({
2426
- * // Required. Name of alert to submit to WebRisk.
2427
- * name: 'projects/my-project/alerts/my-alert',
2428
- *
2429
- * // Request body metadata
2430
- * requestBody: {
2431
- * // request body parameters
2432
- * // {}
2433
- * },
2434
- * });
2435
- * console.log(res.data);
2436
- *
2437
- * // Example response
2438
- * // {
2439
- * // "state": "my_state"
2440
- * // }
2441
- * }
2442
- *
2443
- * main().catch(e => {
2444
- * console.error(e);
2445
- * throw e;
2446
- * });
2447
- *
2448
- * ```
2449
- *
2450
- * @param params - Parameters for request
2451
- * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
2452
- * @param callback - Optional callback that handles the response.
2453
- * @returns A promise if used with async/await, or void if used with a callback.
2454
- */
2455
- reportAlertUri(params: Params$Resource$Projects$Alerts$Reportalerturi, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
2456
- reportAlertUri(params?: Params$Resource$Projects$Alerts$Reportalerturi, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$ReportAlertUriResponse>>;
2457
- reportAlertUri(params: Params$Resource$Projects$Alerts$Reportalerturi, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
2458
- reportAlertUri(params: Params$Resource$Projects$Alerts$Reportalerturi, options: MethodOptions | BodyResponseCallback<Schema$ReportAlertUriResponse>, callback: BodyResponseCallback<Schema$ReportAlertUriResponse>): void;
2459
- reportAlertUri(params: Params$Resource$Projects$Alerts$Reportalerturi, callback: BodyResponseCallback<Schema$ReportAlertUriResponse>): void;
2460
- reportAlertUri(callback: BodyResponseCallback<Schema$ReportAlertUriResponse>): void;
2461
1864
  /**
2462
1865
  * Marks an alert to closed state - RESOLVED.
2463
1866
  * @example
@@ -2503,7 +1906,6 @@ export declare namespace threatintelligence_v1beta {
2503
1906
  * // Example response
2504
1907
  * // {
2505
1908
  * // "aiSummary": "my_aiSummary",
2506
- * // "assets": [],
2507
1909
  * // "audit": {},
2508
1910
  * // "configurations": [],
2509
1911
  * // "detail": {},
@@ -2512,6 +1914,7 @@ export declare namespace threatintelligence_v1beta {
2512
1914
  * // "duplicatedBy": [],
2513
1915
  * // "etag": "my_etag",
2514
1916
  * // "externalId": "my_externalId",
1917
+ * // "findingCount": "my_findingCount",
2515
1918
  * // "findings": [],
2516
1919
  * // "name": "my_name",
2517
1920
  * // "priorityAnalysis": {},
@@ -2584,7 +1987,6 @@ export declare namespace threatintelligence_v1beta {
2584
1987
  * // Example response
2585
1988
  * // {
2586
1989
  * // "aiSummary": "my_aiSummary",
2587
- * // "assets": [],
2588
1990
  * // "audit": {},
2589
1991
  * // "configurations": [],
2590
1992
  * // "detail": {},
@@ -2593,6 +1995,7 @@ export declare namespace threatintelligence_v1beta {
2593
1995
  * // "duplicatedBy": [],
2594
1996
  * // "etag": "my_etag",
2595
1997
  * // "externalId": "my_externalId",
1998
+ * // "findingCount": "my_findingCount",
2596
1999
  * // "findings": [],
2597
2000
  * // "name": "my_name",
2598
2001
  * // "priorityAnalysis": {},
@@ -2665,7 +2068,6 @@ export declare namespace threatintelligence_v1beta {
2665
2068
  * // Example response
2666
2069
  * // {
2667
2070
  * // "aiSummary": "my_aiSummary",
2668
- * // "assets": [],
2669
2071
  * // "audit": {},
2670
2072
  * // "configurations": [],
2671
2073
  * // "detail": {},
@@ -2674,6 +2076,7 @@ export declare namespace threatintelligence_v1beta {
2674
2076
  * // "duplicatedBy": [],
2675
2077
  * // "etag": "my_etag",
2676
2078
  * // "externalId": "my_externalId",
2079
+ * // "findingCount": "my_findingCount",
2677
2080
  * // "findings": [],
2678
2081
  * // "name": "my_name",
2679
2082
  * // "priorityAnalysis": {},
@@ -2760,19 +2163,19 @@ export declare namespace threatintelligence_v1beta {
2760
2163
  }
2761
2164
  export interface Params$Resource$Projects$Alerts$List extends StandardParameters {
2762
2165
  /**
2763
- * Optional. Filter criteria.
2166
+ * Optional. Filter criteria. Supported fields for filtering include: * `audit.create_time` * `audit.creator` * `audit.update_time` * `audit.updater` * `detail.data_leak.discovery_document_ids` * `detail.data_leak.severity` * `detail.detail_type` * `detail.initial_access_broker.discovery_document_ids` * `detail.initial_access_broker.severity` * `detail.insider_threat.discovery_document_ids` * `detail.insider_threat.severity` * `finding_count` * `priority_analysis.priority_level` * `relevance_analysis.confidence` * `relevance_analysis.relevance_level` * `relevance_analysis.relevant` * `severity_analysis.severity_level` * `state` Examples: * `detail.detail_type = "initial_access_broker"` * `detail.detail_type != "data_leak"` * `detail.insider_threat.severity = "HIGH"` * `audit.create_time \>= "2026-04-03T00:00:00Z" AND audit.create_time < "2026-04-06T00:00:00Z"` * `state = "NEW" OR state = "TRIAGED"` * `severity_analysis.severity_level = "SEVERITY_LEVEL_CRITICAL"`
2764
2167
  */
2765
2168
  filter?: string;
2766
2169
  /**
2767
- * Optional. Order by criteria in the csv format: "field1,field2 desc" or "field1,field2" or "field1 asc, field2".
2170
+ * Optional. Order by criteria in the csv format: "field1, field2 desc" or "field1, field2" or "field1 asc, field2". If a field is specified without `asc` or `desc`, ascending order is used by default. Supported fields for ordering are identical to those supported for filtering. Examples: * `audit.create_time desc` * `audit.update_time asc` * `audit.create_time desc, severity_analysis.severity_level desc`
2768
2171
  */
2769
2172
  orderBy?: string;
2770
2173
  /**
2771
- * Optional. Page size.
2174
+ * Optional. Page size. Default to 100 alerts per page. Maximum is 1000 alerts per page.
2772
2175
  */
2773
2176
  pageSize?: number;
2774
2177
  /**
2775
- * Optional. Page token.
2178
+ * Optional. Page token to retrieve the next page of results.
2776
2179
  */
2777
2180
  pageToken?: string;
2778
2181
  /**
@@ -2800,26 +2203,6 @@ export declare namespace threatintelligence_v1beta {
2800
2203
  */
2801
2204
  requestBody?: Schema$MarkAlertAsReadRequest;
2802
2205
  }
2803
- export interface Params$Resource$Projects$Alerts$Refreshuristatus extends StandardParameters {
2804
- /**
2805
- * Required. Name of alert to refresh status from WebRisk
2806
- */
2807
- name?: string;
2808
- /**
2809
- * Request body metadata
2810
- */
2811
- requestBody?: Schema$RefreshAlertUriStatusRequest;
2812
- }
2813
- export interface Params$Resource$Projects$Alerts$Reportalerturi extends StandardParameters {
2814
- /**
2815
- * Required. Name of alert to submit to WebRisk.
2816
- */
2817
- name?: string;
2818
- /**
2819
- * Request body metadata
2820
- */
2821
- requestBody?: Schema$ReportAlertUriRequest;
2822
- }
2823
2206
  export interface Params$Resource$Projects$Alerts$Resolve extends StandardParameters {
2824
2207
  /**
2825
2208
  * Required. Name of the alert to mark as resolved. Format: projects/{project\}/alerts/{alert\}
@@ -3291,7 +2674,7 @@ export declare namespace threatintelligence_v1beta {
3291
2674
  context: APIRequestContext;
3292
2675
  constructor(context: APIRequestContext);
3293
2676
  /**
3294
- * Get a finding by name.
2677
+ * Get a finding by name. The `name` field should have the format: `projects/{project\}/findings/{finding\}`
3295
2678
  * @example
3296
2679
  * ```js
3297
2680
  * // Before running the sample:
@@ -3330,12 +2713,10 @@ export declare namespace threatintelligence_v1beta {
3330
2713
  * // {
3331
2714
  * // "aiSummary": "my_aiSummary",
3332
2715
  * // "alert": "my_alert",
3333
- * // "asset": "my_asset",
3334
2716
  * // "audit": {},
3335
2717
  * // "configurations": [],
3336
2718
  * // "detail": {},
3337
2719
  * // "displayName": "my_displayName",
3338
- * // "issue": "my_issue",
3339
2720
  * // "name": "my_name",
3340
2721
  * // "provider": "my_provider",
3341
2722
  * // "relevanceAnalysis": {},
@@ -3364,7 +2745,7 @@ export declare namespace threatintelligence_v1beta {
3364
2745
  get(params: Params$Resource$Projects$Findings$Get, callback: BodyResponseCallback<Schema$Finding>): void;
3365
2746
  get(callback: BodyResponseCallback<Schema$Finding>): void;
3366
2747
  /**
3367
- * Get a list of findings that meet the filter criteria.
2748
+ * Get a list of findings that meet the filter criteria. The `parent` field in ListFindingsRequest should have the format: projects/{project\}
3368
2749
  * @example
3369
2750
  * ```js
3370
2751
  * // Before running the sample:
@@ -3433,7 +2814,7 @@ export declare namespace threatintelligence_v1beta {
3433
2814
  list(params: Params$Resource$Projects$Findings$List, callback: BodyResponseCallback<Schema$ListFindingsResponse>): void;
3434
2815
  list(callback: BodyResponseCallback<Schema$ListFindingsResponse>): void;
3435
2816
  /**
3436
- * SearchFindings is a more powerful version of ListFindings that supports complex queries like "findings for issues" using functions such as `has_issue` and `has_asset` in the query string. Example to search for findings for a specific issue: `has_issue("name=\"vaults/vault-12345/issues/issue-12345\"")`)
2817
+ * SearchFindings is a more powerful version of ListFindings that supports complex queries like "findings for alerts" using functions such as `has_alert` in the query string. The `parent` field in SearchFindingsRequest should have the format: projects/{project\} Example to search for findings for a specific issue: `has_alert("name=\"projects/gti-12345/alerts/alert-12345\"")`
3437
2818
  * @example
3438
2819
  * ```js
3439
2820
  * // Before running the sample:
@@ -3471,7 +2852,7 @@ export declare namespace threatintelligence_v1beta {
3471
2852
  * pageToken: 'placeholder-value',
3472
2853
  * // Required. Parent of the findings. Format: vaults/{vault\}
3473
2854
  * parent: 'projects/my-project',
3474
- * // Optional. Query on what findings will be returned. This supports the same filter criteria as FindingService.ListFindings as well as the following relationship queries `has_issue` and `has_asset`. Examples: - has_issue("name=\"vaults/vault-12345/issues/issue-12345\"") - has_asset("name=\"vaults/vault-12345/assets/asset-12345\"")
2855
+ * // Optional. Query on what findings will be returned. This supports the same filter criteria as FindingService.ListFindings as well as the following relationship query `has_alert`. Example: - `has_alert("name=\"projects/gti-12345/alerts/alert-12345\"")`
3475
2856
  * query: 'placeholder-value',
3476
2857
  * });
3477
2858
  * console.log(res.data);
@@ -3548,7 +2929,7 @@ export declare namespace threatintelligence_v1beta {
3548
2929
  */
3549
2930
  parent?: string;
3550
2931
  /**
3551
- * Optional. Query on what findings will be returned. This supports the same filter criteria as FindingService.ListFindings as well as the following relationship queries `has_issue` and `has_asset`. Examples: - has_issue("name=\"vaults/vault-12345/issues/issue-12345\"") - has_asset("name=\"vaults/vault-12345/assets/asset-12345\"")
2932
+ * Optional. Query on what findings will be returned. This supports the same filter criteria as FindingService.ListFindings as well as the following relationship query `has_alert`. Example: - `has_alert("name=\"projects/gti-12345/alerts/alert-12345\"")`
3552
2933
  */
3553
2934
  query?: string;
3554
2935
  }