feat: Add UnenrollDataSources API which gives users a programmatic way to unenroll data sources

Google APIs · copybara-github · commit fa4f91acabaf · 2024-02-12T07:43:16.000-08:00
PiperOrigin-RevId: 606248188
diff --git a/google/cloud/bigquery/datatransfer/v1/datatransfer.proto b/google/cloud/bigquery/datatransfer/v1/datatransfer.proto
@@ -236,6 +236,18 @@ service DataTransferService {
       }
     };
   }
+
+  // Unenroll data sources in a user project. This allows users to remove
+  // transfer configurations for these data sources. They will no longer appear
+  // in the ListDataSources RPC and will also no longer appear in the [BigQuery
+  // UI](https://console.cloud.google.com/bigquery).
+  rpc UnenrollDataSources(UnenrollDataSourcesRequest)
+      returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      post: "/v1/{name=projects/*/locations/*}:unenrollDataSources"
+      body: "*"
+    };
+  }
 }
 
 // A parameter used to define custom fields in a data source definition.
@@ -894,3 +906,14 @@ message EnrollDataSourcesRequest {
   // data source id.
   repeated string data_source_ids = 2;
 }
+
+// A request to unenroll a set of data sources so they are no longer visible in
+// the BigQuery UI's `Transfer` tab.
+message UnenrollDataSourcesRequest {
+  // The name of the project resource in the form: `projects/{project_id}`
+  string name = 1;
+
+  // Data sources that are unenrolled. It is required to provide at least one
+  // data source id.
+  repeated string data_source_ids = 2;
+}
