fix!: remove field max_wait_duration from message Scheduling

fix!: remove method `CountTokens` from service LlmUtilityService
feat: add psc_automated_endpoints to IndexPrivateEndpoints
feat: add update_mask to UpsertDatapointsRequest
feat: add more RecordErrorType enum values
feat: add request_response_logging_schema_version to ModelDeploymentMonitoringBigQueryTable
feat: add resource_title, resource_use_case, resource_description to RegionalResourceReferences
docs: deprecate use_case and description in ResourceReference
feat: add deploy_gke, open_tine_tuning_pipelines, open_notebooks to CallToAction
docs: minor changes to comments

PiperOrigin-RevId: 605668103

google/cloud/aiplatform/v1beta1/aiplatform_v1beta1.yaml

@@ -72,8 +72,6 @@ types:
 - name: google.cloud.aiplatform.v1beta1.DeployModelResponse
 - name: google.cloud.aiplatform.v1beta1.ExportDataOperationMetadata
 - name: google.cloud.aiplatform.v1beta1.ExportDataResponse
-- name: google.cloud.aiplatform.v1beta1.ExportEndpointOperationMetadata
-- name: google.cloud.aiplatform.v1beta1.ExportEndpointResponse
 - name: google.cloud.aiplatform.v1beta1.ExportFeatureValuesOperationMetadata
 - name: google.cloud.aiplatform.v1beta1.ExportFeatureValuesResponse
 - name: google.cloud.aiplatform.v1beta1.ExportModelOperationMetadata
@@ -357,6 +355,7 @@ http:
     - delete: '/v1beta1/{name=projects/*/locations/*/featurestores/*/entityTypes/*/features/*/operations/*}'
     - delete: '/v1beta1/{name=projects/*/locations/*/customJobs/*/operations/*}'
     - delete: '/v1beta1/{name=projects/*/locations/*/dataLabelingJobs/*/operations/*}'
+    - delete: '/v1beta1/{name=projects/*/locations/*/evaluationTasks/*/operations/*}'
     - delete: '/v1beta1/{name=projects/*/locations/*/exampleStores/*/operations/*}'
     - delete: '/v1beta1/{name=projects/*/locations/*/extensionControllers/*/operations/*}'
     - delete: '/v1beta1/{name=projects/*/locations/*/extensions/*/operations/*}'
@@ -444,6 +443,7 @@ http:
     - get: '/v1beta1/{name=projects/*/locations/*/deploymentResourcePools/*/operations/*}'
     - get: '/v1beta1/{name=projects/*/locations/*/edgeDevices/*/operations/*}'
     - get: '/v1beta1/{name=projects/*/locations/*/endpoints/*/operations/*}'
+    - get: '/v1beta1/{name=projects/*/locations/*/evaluationTasks/*/operations/*}'
     - get: '/v1beta1/{name=projects/*/locations/*/exampleStores/*/operations/*}'
     - get: '/v1beta1/{name=projects/*/locations/*/extensionControllers/*/operations/*}'
     - get: '/v1beta1/{name=projects/*/locations/*/extensions/*/operations/*}'
@@ -535,6 +535,7 @@ http:
     - get: '/v1beta1/{name=projects/*/locations/*/deploymentResourcePools/*}/operations'
     - get: '/v1beta1/{name=projects/*/locations/*/edgeDevices/*}/operations'
     - get: '/v1beta1/{name=projects/*/locations/*/endpoints/*}/operations'
+    - get: '/v1beta1/{name=projects/*/locations/*/evaluationTasks/*}/operations'
     - get: '/v1beta1/{name=projects/*/locations/*/exampleStores/*}/operations'
     - get: '/v1beta1/{name=projects/*/locations/*/extensionControllers/*}/operations'
     - get: '/v1beta1/{name=projects/*/locations/*/extensions/*}/operations'
@@ -626,6 +627,7 @@ http:
     - post: '/v1beta1/{name=projects/*/locations/*/deploymentResourcePools/*/operations/*}:wait'
     - post: '/v1beta1/{name=projects/*/locations/*/edgeDevices/*/operations/*}:wait'
     - post: '/v1beta1/{name=projects/*/locations/*/endpoints/*/operations/*}:wait'
+    - post: '/v1beta1/{name=projects/*/locations/*/evaluationTasks/*/operations/*}:wait'
     - post: '/v1beta1/{name=projects/*/locations/*/exampleStores/*/operations/*}:wait'
     - post: '/v1beta1/{name=projects/*/locations/*/extensionControllers/*/operations/*}:wait'
     - post: '/v1beta1/{name=projects/*/locations/*/extensions/*/operations/*}:wait'
@@ -723,10 +725,6 @@ authentication:
     oauth:
       canonical_scopes: |-
         https://www.googleapis.com/auth/cloud-platform
-  - selector: google.cloud.aiplatform.v1beta1.LlmUtilityService.CountTokens
-    oauth:
-      canonical_scopes: |-
-        https://www.googleapis.com/auth/cloud-platform
   - selector: google.cloud.aiplatform.v1beta1.MatchService.FindNeighbors
     oauth:
       canonical_scopes: |-

google/cloud/aiplatform/v1beta1/custom_job.proto

@@ -363,9 +363,4 @@ message Scheduling {
   // job starts running. If true, overrides
   // `Scheduling.restart_job_on_worker_restart` to false.
   bool disable_retries = 5 [(google.api.field_behavior) = OPTIONAL];
-
-  // Optional. This is the maximum time a user will wait in the QRM queue for
-  // resources. Default is 1 day
-  google.protobuf.Duration max_wait_duration = 6
-      [(google.api.field_behavior) = OPTIONAL];
 }

google/cloud/aiplatform/v1beta1/endpoint_service.proto

@@ -220,6 +220,7 @@ message ListEndpointsRequest {
   //     * A key including a space must be quoted. `labels."a key"`.
   //
   // Some examples:
+  //
   //   * `endpoint=1`
   //   * `displayName="myDisplayName"`
   //   * `labels.myKey="myValue"`

google/cloud/aiplatform/v1beta1/explanation.proto

@@ -44,6 +44,14 @@ message Explanation {
   // [Attribution.output_index][google.cloud.aiplatform.v1beta1.Attribution.output_index]
   // can be used to identify which output this attribution is explaining.
   //
+  // By default, we provide Shapley values for the predicted class. However,
+  // you can configure the explanation request to generate Shapley values for
+  // any other classes too. For example, if a model predicts a probability of
+  // `0.4` for approving a loan application, the model's decision is to reject
+  // the application since `p(reject) = 0.6 > p(approve) = 0.4`, and the default
+  // Shapley values would be computed for rejection decision and not approval,
+  // even though the latter might be the positive class.
+  //
   // If users set
   // [ExplanationParameters.top_k][google.cloud.aiplatform.v1beta1.ExplanationParameters.top_k],
   // the attributions are sorted by

google/cloud/aiplatform/v1beta1/feature_online_store_admin_service.proto

@@ -319,6 +319,7 @@ message UpdateFeatureOnlineStoreRequest {
   // Updatable fields:
   //
   //   * `big_query_source`
+  //   * `bigtable`
   //   * `labels`
   //   * `sync_config`
   google.protobuf.FieldMask update_mask = 2;
@@ -480,6 +481,7 @@ message UpdateFeatureViewRequest {
   // Updatable fields:
   //
   //   * `labels`
+  //   * `serviceAgentType`
   google.protobuf.FieldMask update_mask = 2;
 }
 

google/cloud/aiplatform/v1beta1/feature_online_store_service.proto

@@ -169,12 +169,13 @@ message NearestNeighborQuery {
   }
 
   // String filter is used to search a subset of the entities by using boolean
-  // rules. For example: if a query specifies string filter with 'name
-  // = color, allow_tokens = {red, blue}, deny_tokens = {purple}','  then that
-  // query will match entities that are red or blue, but if those points are
-  // also purple, then they will be excluded even if they are red/blue. Only
-  // string filter is supported for now, numeric filter will be supported in the
-  // near future.
+  // rules on string columns.
+  // For example: if a query specifies string filter
+  // with 'name = color, allow_tokens = {red, blue}, deny_tokens = {purple}','
+  // then that query will match entities that are red or blue, but if those
+  // points are also purple, then they will be excluded even if they are
+  // red/blue. Only string filter is supported for now, numeric filter will be
+  // supported in the near future.
   message StringFilter {
     // Required. Column names in BigQuery that used as filters.
     string name = 1 [(google.api.field_behavior) = REQUIRED];

google/cloud/aiplatform/v1beta1/index_endpoint.proto

@@ -292,4 +292,9 @@ message IndexPrivateEndpoints {
   // Output only. The name of the service attachment resource. Populated if
   // private service connect is enabled.
   string service_attachment = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. PscAutomatedEndpoints is populated if private service connect
+  // is enabled if PscAutomatedConfig is set.
+  repeated PscAutomatedEndpoints psc_automated_endpoints = 3
+      [(google.api.field_behavior) = OUTPUT_ONLY];
 }

google/cloud/aiplatform/v1beta1/index_service.proto

@@ -252,6 +252,16 @@ message UpsertDatapointsRequest {
 
   // A list of datapoints to be created/updated.
   repeated IndexDatapoint datapoints = 2;
+
+  // Optional. Update mask is used to specify the fields to be overwritten in
+  // the datapoints by the update. The fields specified in the update_mask are
+  // relative to each IndexDatapoint inside datapoints, not the full request.
+  //
+  // Updatable fields:
+  //
+  //   * Use `all_restricts` to update both restricts and numeric_restricts.
+  google.protobuf.FieldMask update_mask = 3
+      [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Response message for
@@ -307,6 +317,25 @@ message NearestNeighborSearchOperationMetadata {
 
       // The `namespace` field is missing.
       NAMESPACE_MISSING = 7;
+
+      // Generic catch-all error. Only used for validation failure where the
+      // root cause cannot be easily retrieved programmatically.
+      PARSING_ERROR = 8;
+
+      // There are multiple restricts with the same `namespace` value.
+      DUPLICATE_NAMESPACE = 9;
+
+      // Numeric restrict has operator specified in datapoint.
+      OP_IN_DATAPOINT = 10;
+
+      // Numeric restrict has multiple values specified.
+      MULTIPLE_VALUES = 11;
+
+      // Numeric restrict has invalid numeric value specified.
+      INVALID_NUMERIC_VALUE = 12;
+
+      // File is not in UTF_8 format.
+      INVALID_ENCODING = 13;
     }
 
     // The error type of this record.

google/cloud/aiplatform/v1beta1/llm_utility_service.proto

@@ -20,7 +20,6 @@ import "google/api/annotations.proto";
 import "google/api/client.proto";
 import "google/api/field_behavior.proto";
 import "google/api/resource.proto";
-import "google/cloud/aiplatform/v1beta1/prediction_service.proto";
 import "google/protobuf/struct.proto";
 
 option csharp_namespace = "Google.Cloud.AIPlatform.V1Beta1";
@@ -37,19 +36,6 @@ service LlmUtilityService {
   option (google.api.oauth_scopes) =
       "https://www.googleapis.com/auth/cloud-platform";
 
-  // Perform a token counting.
-  rpc CountTokens(CountTokensRequest) returns (CountTokensResponse) {
-    option (google.api.http) = {
-      post: "/v1beta1/{endpoint=projects/*/locations/*/endpoints/*}:countTokens"
-      body: "*"
-      additional_bindings {
-        post: "/v1beta1/{endpoint=projects/*/locations/*/publishers/*/models/*}:countTokens"
-        body: "*"
-      }
-    };
-    option (google.api.method_signature) = "endpoint,instances";
-  }
-
   // Return a list of tokens based on the input text.
   rpc ComputeTokens(ComputeTokensRequest) returns (ComputeTokensResponse) {
     option (google.api.http) = {

google/cloud/aiplatform/v1beta1/model.proto

@@ -211,12 +211,12 @@ message Model {
   // deploying this Model. The specification is ingested upon
   // [ModelService.UploadModel][google.cloud.aiplatform.v1beta1.ModelService.UploadModel],
   // and all binaries it contains are copied and stored internally by Vertex AI.
-  // Not present for AutoML Models or Large Models.
+  // Not required for AutoML Models.
   ModelContainerSpec container_spec = 9
       [(google.api.field_behavior) = INPUT_ONLY];
 
   // Immutable. The path to the directory containing the Model artifact and any
-  // of its supporting files. Not present for AutoML Models or Large Models.
+  // of its supporting files. Not required for AutoML Models.
   string artifact_uri = 26 [(google.api.field_behavior) = IMMUTABLE];
 
   // Output only. When this Model is deployed, its prediction resources are
@@ -396,7 +396,8 @@ message Model {
   EncryptionSpec encryption_spec = 24;
 
   // Output only. Source of a model. It can either be automl training pipeline,
-  // custom training pipeline, BigQuery ML, or existing Vertex AI Model.
+  // custom training pipeline, BigQuery ML, or saved and tuned from Genie or
+  // Model Garden.
   ModelSourceInfo model_source_info = 38
       [(google.api.field_behavior) = OUTPUT_ONLY];
 
@@ -732,6 +733,10 @@ message Port {
 // Detail description of the source information of the model.
 message ModelSourceInfo {
   // Source of the model.
+  // Different from `objective` field, this `ModelSourceType` enum
+  // indicates the source from which the model was accessed or obtained,
+  // whereas the `objective` indicates the overall aim or function of this
+  // model.
   enum ModelSourceType {
     // Should not be used.
     MODEL_SOURCE_TYPE_UNSPECIFIED = 0;
@@ -753,6 +758,9 @@ message ModelSourceInfo {
 
     // The Model is uploaded by text embedding finetuning pipeline.
     CUSTOM_TEXT_EMBEDDING = 6;
+
+    // The Model is saved or tuned from Marketplace.
+    MARKETPLACE = 7;
   }
 
   // Type of the model source.

google/cloud/aiplatform/v1beta1/model_deployment_monitoring_job.proto

@@ -263,6 +263,11 @@ message ModelDeploymentMonitoringBigQueryTable {
   // & analysis. Format:
   // `bq://<project_id>.model_deployment_monitoring_<endpoint_id>.<tolower(log_source)>_<tolower(log_type)>`
   string bigquery_table_path = 3;
+
+  // Output only. The schema version of the request/response logging BigQuery
+  // table. Default to v1 if unset.
+  string request_response_logging_schema_version = 4
+      [(google.api.field_behavior) = OUTPUT_ONLY];
 }
 
 // ModelDeploymentMonitoringObjectiveConfig contains the pair of

google/cloud/aiplatform/v1beta1/pipeline_service.proto

@@ -185,6 +185,33 @@ service PipelineService {
     };
     option (google.api.method_signature) = "name";
   }
+
+  // Batch cancel PipelineJobs.
+  // Firstly the server will check if all the jobs are in non-terminal states,
+  // and skip the jobs that are already terminated.
+  // If the operation failed, none of the pipeline jobs are cancelled.
+  // The server will poll the states of all the pipeline jobs periodically
+  // to check the cancellation status.
+  // This operation will return an LRO.
+  rpc BatchCancelPipelineJobs(BatchCancelPipelineJobsRequest)
+      returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1beta1/{parent=projects/*/locations/*}/pipelineJobs:batchCancel"
+      body: "*"
+    };
+    option (google.api.method_signature) = "parent,names";
+    option (google.longrunning.operation_info) = {
+      response_type: "BatchCancelPipelineJobsResponse"
+      metadata_type: "BatchCancelPipelineJobsOperationMetadata"
+    };
+  }
+}
+
+// Runtime operation information for
+// [PipelineService.BatchCancelPipelineJobs][google.cloud.aiplatform.v1beta1.PipelineService.BatchCancelPipelineJobs].
+message BatchCancelPipelineJobsOperationMetadata {
+  // The common part of the operation metadata.
+  GenericOperationMetadata generic_metadata = 1;
 }
 
 // Request message for
@@ -330,6 +357,10 @@ message CreatePipelineJobRequest {
   // This value should be less than 128 characters, and valid characters
   // are `/[a-z][0-9]-/`.
   string pipeline_job_id = 3;
+
+  // Optional. Whether to do component level validations before job creation.
+  // Currently we only support Google First Party Component/Pipelines.
+  bool preflight_validations = 4 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Request message for
@@ -495,3 +526,34 @@ message CancelPipelineJobRequest {
     }
   ];
 }
+
+// Request message for
+// [PipelineService.BatchCancelPipelineJobs][google.cloud.aiplatform.v1beta1.PipelineService.BatchCancelPipelineJobs].
+message BatchCancelPipelineJobsRequest {
+  // Required. The name of the PipelineJobs' parent resource.
+  // Format: `projects/{project}/locations/{location}`
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "aiplatform.googleapis.com/PipelineJob"
+    }
+  ];
+
+  // Required. The names of the PipelineJobs to cancel.
+  // A maximum of 32 PipelineJobs can be cancelled in a batch.
+  // Format:
+  // `projects/{project}/locations/{location}/pipelineJobs/{pipelineJob}`
+  repeated string names = 2 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "aiplatform.googleapis.com/PipelineJob"
+    }
+  ];
+}
+
+// Response message for
+// [PipelineService.BatchCancelPipelineJobs][google.cloud.aiplatform.v1beta1.PipelineService.BatchCancelPipelineJobs].
+message BatchCancelPipelineJobsResponse {
+  // PipelineJobs cancelled.
+  repeated PipelineJob pipeline_jobs = 1;
+}

google/cloud/aiplatform/v1beta1/prediction_service.proto

@@ -666,8 +666,7 @@ message GenerateContentRequest {
   //
   // A `Tool` is a piece of code that enables the system to interact with
   // external systems to perform an action, or set of actions, outside of
-  // knowledge and scope of the model. The only supported tool is currently
-  // `Function`
+  // knowledge and scope of the model.
   repeated Tool tools = 6 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. Per request settings for blocking unsafe content.