docs: update documentation of .google.cloud.aiplatform.v1.DatasetService, .google.cloud.aiplatform.v1.Dataset, and .google.cloud.aiplatform.v1.DatasetVersion

Google APIs · copybara-github · commit d077e5979c3e · 2026-02-04T02:39:32.000-08:00
feat: add resource_reference to the field `name` in message `.google.cloud.aiplatform.v1.Dataset`
feat: add resource_reference to the field `name` in message `.google.cloud.aiplatform.v1.DatasetVersion`

PiperOrigin-RevId: 865307574
diff --git a/google/cloud/aiplatform/v1/dataset.proto b/google/cloud/aiplatform/v1/dataset.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.
@@ -40,9 +40,14 @@ message Dataset {
   };
 
   // Output only. Identifier. The resource name of the Dataset.
+  // Format:
+  // `projects/{project}/locations/{location}/datasets/{dataset}`
   string name = 1 [
     (google.api.field_behavior) = OUTPUT_ONLY,
-    (google.api.field_behavior) = IDENTIFIER
+    (google.api.field_behavior) = IDENTIFIER,
+    (google.api.resource_reference) = {
+      type: "aiplatform.googleapis.com/Dataset"
+    }
   ];
 
   // Required. The user-defined name of the Dataset.
diff --git a/google/cloud/aiplatform/v1/dataset_service.proto b/google/cloud/aiplatform/v1/dataset_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.
@@ -259,9 +259,7 @@ service DatasetService {
     option (google.api.method_signature) = "name";
   }
 
-  // Lists Annotations belongs to a dataitem
-  // This RPC is only available in InternalDatasetService. It is only used for
-  // exporting conversation data to CCAI Insights.
+  // Lists Annotations belongs to a dataitem.
   rpc ListAnnotations(ListAnnotationsRequest)
       returns (ListAnnotationsResponse) {
     option (google.api.http) = {
@@ -296,7 +294,6 @@ message CreateDatasetOperationMetadata {
 
 // Request message for
 // [DatasetService.GetDataset][google.cloud.aiplatform.v1.DatasetService.GetDataset].
-// Next ID: 4
 message GetDatasetRequest {
   // Required. The name of the Dataset resource.
   string name = 1 [
@@ -528,7 +525,6 @@ message DeleteDatasetVersionRequest {
 
 // Request message for
 // [DatasetService.GetDatasetVersion][google.cloud.aiplatform.v1.DatasetService.GetDatasetVersion].
-// Next ID: 4
 message GetDatasetVersionRequest {
   // Required. The resource name of the Dataset version to delete.
   // Format:
diff --git a/google/cloud/aiplatform/v1/dataset_version.proto b/google/cloud/aiplatform/v1/dataset_version.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,9 +37,14 @@ message DatasetVersion {
   };
 
   // Output only. Identifier. The resource name of the DatasetVersion.
+  // Format:
+  // `projects/{project}/locations/{location}/datasets/{dataset}/datasetVersions/{dataset_version}`
   string name = 1 [
     (google.api.field_behavior) = OUTPUT_ONLY,
-    (google.api.field_behavior) = IDENTIFIER
+    (google.api.field_behavior) = IDENTIFIER,
+    (google.api.resource_reference) = {
+      type: "aiplatform.googleapis.com/DatasetVersion"
+    }
   ];
 
   // Output only. Timestamp when this DatasetVersion was created.
