feat: [recommender] Support utilization insights and cloud hub

packages/google-cloud-recommender/protos/google/cloud/recommender/v1/insight.proto

@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -16,6 +16,7 @@ syntax = "proto3";
 
 package google.cloud.recommender.v1;
 
+import "google/api/field_behavior.proto";
 import "google/api/resource.proto";
 import "google/protobuf/duration.proto";
 import "google/protobuf/struct.proto";
@@ -95,8 +96,8 @@ message Insight {
     string recommendation = 1;
   }
 
-  // Name of the insight.
-  string name = 1;
+  // Identifier. Name of the insight.
+  string name = 1 [(google.api.field_behavior) = IDENTIFIER];
 
   // Free-form human readable summary in English. The maximum length is 500
   // characters.

packages/google-cloud-recommender/protos/google/cloud/recommender/v1/insight_type_config.proto

@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -37,10 +37,10 @@ message InsightTypeConfig {
     pattern: "billingAccounts/{billing_account}/locations/{location}/insightTypes/{insight_type}/config"
   };
 
-  // Name of insight type config.
+  // Identifier. Name of insight type config.
   // Eg,
   // projects/[PROJECT_NUMBER]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]/config
-  string name = 1;
+  string name = 1 [(google.api.field_behavior) = IDENTIFIER];
 
   // InsightTypeGenerationConfig which configures the generation of
   // insights for this insight type.

packages/google-cloud-recommender/protos/google/cloud/recommender/v1/recommendation.proto

@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -16,6 +16,7 @@ syntax = "proto3";
 
 package google.cloud.recommender.v1;
 
+import "google/api/field_behavior.proto";
 import "google/api/resource.proto";
 import "google/protobuf/duration.proto";
 import "google/protobuf/struct.proto";
@@ -71,8 +72,8 @@ message Recommendation {
     string insight = 1;
   }
 
-  // Name of recommendation.
-  string name = 1;
+  // Identifier. Name of recommendation.
+  string name = 1 [(google.api.field_behavior) = IDENTIFIER];
 
   // Free-form human readable summary in English. The maximum length is 500
   // characters.
@@ -123,6 +124,9 @@ message Recommendation {
   // exclusive group. This means that only one recommendation within the group
   // is suggested to be applied.
   string xor_group_id = 18;
+
+  // Fully qualified resource names that this recommendation is targeting.
+  repeated string target_resources = 19;
 }
 
 // Contains what resources are changing and how they are changing.
@@ -236,6 +240,7 @@ message Operation {
 
 // Contains various matching options for values for a GCP resource field.
 message ValueMatcher {
+  // To be used for full regex matching.
   oneof match_variant {
     // To be used for full regex matching. The regular expression is using the
     // Google RE2 syntax (https://github.com/google/re2/wiki/Syntax), so to be
@@ -346,6 +351,9 @@ message Impact {
     // Use with CategoryType.RELIABILITY
     ReliabilityProjection reliability_projection = 103;
   }
+
+  // The service that this impact is associated with.
+  string service = 3;
 }
 
 // Information for state. Contains state and metadata.

packages/google-cloud-recommender/protos/google/cloud/recommender/v1/recommender_config.proto

@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -37,10 +37,10 @@ message RecommenderConfig {
     pattern: "billingAccounts/{billing_account}/locations/{location}/recommenders/{recommender}/config"
   };
 
-  // Name of recommender config.
+  // Identifier. Name of recommender config.
   // Eg,
   // projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]/config
-  string name = 1;
+  string name = 1 [(google.api.field_behavior) = IDENTIFIER];
 
   // RecommenderGenerationConfig which configures the Generation of
   // recommendations for this recommender.

packages/google-cloud-recommender/protos/google/cloud/recommender/v1/recommender_service.proto

@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.

packages/google-cloud-recommender/protos/protos.d.ts

@@ -691,6 +691,9 @@ export namespace google {
 
                     /** Recommendation xorGroupId */
                     xorGroupId?: (string|null);
+
+                    /** Recommendation targetResources */
+                    targetResources?: (string[]|null);
                 }
 
                 /** Represents a Recommendation. */
@@ -738,6 +741,9 @@ export namespace google {
                     /** Recommendation xorGroupId. */
                     public xorGroupId: string;
 
+                    /** Recommendation targetResources. */
+                    public targetResources: string[];
+
                     /**
                      * Creates a new Recommendation instance using the specified properties.
                      * @param [properties] Properties to set
@@ -1819,6 +1825,9 @@ export namespace google {
 
                     /** Impact reliabilityProjection */
                     reliabilityProjection?: (google.cloud.recommender.v1.IReliabilityProjection|null);
+
+                    /** Impact service */
+                    service?: (string|null);
                 }
 
                 /** Represents an Impact. */
@@ -1845,6 +1854,9 @@ export namespace google {
                     /** Impact reliabilityProjection. */
                     public reliabilityProjection?: (google.cloud.recommender.v1.IReliabilityProjection|null);
 
+                    /** Impact service. */
+                    public service: string;
+
                     /** Impact projection. */
                     public projection?: ("costProjection"|"securityProjection"|"sustainabilityProjection"|"reliabilityProjection");
 
@@ -8707,6 +8719,19 @@ export namespace google {
     /** Namespace api. */
     namespace api {
 
+        /** FieldBehavior enum. */
+        enum FieldBehavior {
+            FIELD_BEHAVIOR_UNSPECIFIED = 0,
+            OPTIONAL = 1,
+            REQUIRED = 2,
+            OUTPUT_ONLY = 3,
+            INPUT_ONLY = 4,
+            IMMUTABLE = 5,
+            UNORDERED_LIST = 6,
+            NON_EMPTY_DEFAULT = 7,
+            IDENTIFIER = 8
+        }
+
         /** Properties of a ResourceDescriptor. */
         interface IResourceDescriptor {
 
@@ -8959,19 +8984,6 @@ export namespace google {
             public static getTypeUrl(typeUrlPrefix?: string): string;
         }
 
-        /** FieldBehavior enum. */
-        enum FieldBehavior {
-            FIELD_BEHAVIOR_UNSPECIFIED = 0,
-            OPTIONAL = 1,
-            REQUIRED = 2,
-            OUTPUT_ONLY = 3,
-            INPUT_ONLY = 4,
-            IMMUTABLE = 5,
-            UNORDERED_LIST = 6,
-            NON_EMPTY_DEFAULT = 7,
-            IDENTIFIER = 8
-        }
-
         /** Properties of a Http. */
         interface IHttp {
 
@@ -13248,11 +13260,11 @@ export namespace google {
             /** FieldOptions uninterpretedOption */
             uninterpretedOption?: (google.protobuf.IUninterpretedOption[]|null);
 
-            /** FieldOptions .google.api.resourceReference */
-            ".google.api.resourceReference"?: (google.api.IResourceReference|null);
-
             /** FieldOptions .google.api.fieldBehavior */
             ".google.api.fieldBehavior"?: (google.api.FieldBehavior[]|null);
+
+            /** FieldOptions .google.api.resourceReference */
+            ".google.api.resourceReference"?: (google.api.IResourceReference|null);
         }
 
         /** Represents a FieldOptions. */