Regenerate all APIs with service comments in client documentation

The comments are included as they are, as a "remarks" section both the abstract base class and the concrete implementation.

Author: jskeet

apis/Google.Cloud.Asset.V1/Google.Cloud.Asset.V1/AssetServiceClient.g.cs

@@ -269,6 +269,9 @@ private AssetServiceClient BuildImpl()
     }
 
     /// <summary>AssetService client wrapper, for convenient use.</summary>
+    /// <remarks>
+    /// Asset service definition.
+    /// </remarks>
     public abstract partial class AssetServiceClient
     {
         /// <summary>
@@ -1279,6 +1282,9 @@ public virtual void DeleteFeed(FeedName name, gaxgrpc::CallSettings callSettings
     }
 
     /// <summary>AssetService client wrapper implementation, for convenient use.</summary>
+    /// <remarks>
+    /// Asset service definition.
+    /// </remarks>
     public sealed partial class AssetServiceClientImpl : AssetServiceClient
     {
         private readonly gaxgrpc::ApiCall<ExportAssetsRequest, lro::Operation> _callExportAssets;

apis/Google.Cloud.Asset.V1/synth.metadata

@@ -4,7 +4,7 @@
       "git": {
         "name": "googleapis",
         "remote": "https://github.com/googleapis/googleapis.git",
-        "sha": "49883ad9b196aa7b44869d24749104b504cafad0"        
+        "sha": "07460951fc07dd2b3f172d01b04e2a5fefd13ccc"        
       }
     }
   ]

apis/Google.Cloud.AutoML.V1/Google.Cloud.AutoML.V1/AutoMlClient.g.cs

@@ -547,6 +547,22 @@ private AutoMlClient BuildImpl()
     }
 
     /// <summary>AutoMl client wrapper, for convenient use.</summary>
+    /// <remarks>
+    /// AutoML Server API.
+    /// 
+    /// The resource names are assigned by the server.
+    /// The server never reuses names that it has created after the resources with
+    /// those names are deleted.
+    /// 
+    /// An ID of a resource is the last element of the item's resource name. For
+    /// `projects/{project_id}/locations/{location_id}/datasets/{dataset_id}`, then
+    /// the id for the item is `{dataset_id}`.
+    /// 
+    /// Currently the only supported `location_id` is "us-central1".
+    /// 
+    /// On any input that is documented to expect a string parameter in
+    /// snake_case or kebab-case, either of those cases is accepted.
+    /// </remarks>
     public abstract partial class AutoMlClient
     {
         /// <summary>
@@ -3310,6 +3326,22 @@ public virtual ModelEvaluation GetModelEvaluation(ModelEvaluationName name, gaxg
     }
 
     /// <summary>AutoMl client wrapper implementation, for convenient use.</summary>
+    /// <remarks>
+    /// AutoML Server API.
+    /// 
+    /// The resource names are assigned by the server.
+    /// The server never reuses names that it has created after the resources with
+    /// those names are deleted.
+    /// 
+    /// An ID of a resource is the last element of the item's resource name. For
+    /// `projects/{project_id}/locations/{location_id}/datasets/{dataset_id}`, then
+    /// the id for the item is `{dataset_id}`.
+    /// 
+    /// Currently the only supported `location_id` is "us-central1".
+    /// 
+    /// On any input that is documented to expect a string parameter in
+    /// snake_case or kebab-case, either of those cases is accepted.
+    /// </remarks>
     public sealed partial class AutoMlClientImpl : AutoMlClient
     {
         private readonly gaxgrpc::ApiCall<CreateDatasetRequest, lro::Operation> _callCreateDataset;

apis/Google.Cloud.AutoML.V1/Google.Cloud.AutoML.V1/PredictionServiceClient.g.cs

@@ -158,6 +158,12 @@ private PredictionServiceClient BuildImpl()
     }
 
     /// <summary>PredictionService client wrapper, for convenient use.</summary>
+    /// <remarks>
+    /// AutoML Prediction API.
+    /// 
+    /// On any input that is documented to expect a string parameter in
+    /// snake_case or kebab-case, either of those cases is accepted.
+    /// </remarks>
     public abstract partial class PredictionServiceClient
     {
         /// <summary>
@@ -1731,6 +1737,12 @@ public virtual PredictResponse Predict(ModelName name, ExamplePayload payload, s
     }
 
     /// <summary>PredictionService client wrapper implementation, for convenient use.</summary>
+    /// <remarks>
+    /// AutoML Prediction API.
+    /// 
+    /// On any input that is documented to expect a string parameter in
+    /// snake_case or kebab-case, either of those cases is accepted.
+    /// </remarks>
     public sealed partial class PredictionServiceClientImpl : PredictionServiceClient
     {
         private readonly gaxgrpc::ApiCall<PredictRequest, PredictResponse> _callPredict;

apis/Google.Cloud.AutoML.V1/synth.metadata

@@ -4,7 +4,7 @@
       "git": {
         "name": "googleapis",
         "remote": "https://github.com/googleapis/googleapis.git",
-        "sha": "7272af32a96a42fe5bb9452360e32ae95718abc2"        
+        "sha": "07460951fc07dd2b3f172d01b04e2a5fefd13ccc"        
       }
     }
   ]

apis/Google.Cloud.BigQuery.Connection.V1/Google.Cloud.BigQuery.Connection.V1/ConnectionServiceClient.g.cs

@@ -230,6 +230,9 @@ private ConnectionServiceClient BuildImpl()
     }
 
     /// <summary>ConnectionService client wrapper, for convenient use.</summary>
+    /// <remarks>
+    /// Manages external data source connections and credentials.
+    /// </remarks>
     public abstract partial class ConnectionServiceClient
     {
         /// <summary>
@@ -1521,6 +1524,9 @@ public virtual void DeleteConnection(ConnectionName name, gaxgrpc::CallSettings
     }
 
     /// <summary>ConnectionService client wrapper implementation, for convenient use.</summary>
+    /// <remarks>
+    /// Manages external data source connections and credentials.
+    /// </remarks>
     public sealed partial class ConnectionServiceClientImpl : ConnectionServiceClient
     {
         private readonly gaxgrpc::ApiCall<CreateConnectionRequest, Connection> _callCreateConnection;

apis/Google.Cloud.BigQuery.Connection.V1/synth.metadata

@@ -4,7 +4,7 @@
       "git": {
         "name": "googleapis",
         "remote": "https://github.com/googleapis/googleapis.git",
-        "sha": "163aa04ede887024d245ab2c6af2528d9460bb9c"        
+        "sha": "07460951fc07dd2b3f172d01b04e2a5fefd13ccc"        
       }
     }
   ]

apis/Google.Cloud.BigQuery.DataTransfer.V1/Google.Cloud.BigQuery.DataTransfer.V1/DataTransferServiceClient.g.cs

@@ -337,6 +337,12 @@ private DataTransferServiceClient BuildImpl()
     }
 
     /// <summary>DataTransferService client wrapper, for convenient use.</summary>
+    /// <remarks>
+    /// The Google BigQuery Data Transfer Service API enables BigQuery users to
+    /// configure the transfer of their data from other Google Products into
+    /// BigQuery. This service contains methods that are end user exposed. It backs
+    /// up the frontend.
+    /// </remarks>
     public abstract partial class DataTransferServiceClient
     {
         /// <summary>
@@ -2319,6 +2325,12 @@ public virtual CheckValidCredsResponse CheckValidCreds(DataSourceName name, gaxg
     }
 
     /// <summary>DataTransferService client wrapper implementation, for convenient use.</summary>
+    /// <remarks>
+    /// The Google BigQuery Data Transfer Service API enables BigQuery users to
+    /// configure the transfer of their data from other Google Products into
+    /// BigQuery. This service contains methods that are end user exposed. It backs
+    /// up the frontend.
+    /// </remarks>
     public sealed partial class DataTransferServiceClientImpl : DataTransferServiceClient
     {
         private readonly gaxgrpc::ApiCall<GetDataSourceRequest, DataSource> _callGetDataSource;

apis/Google.Cloud.BigQuery.DataTransfer.V1/synth.metadata

@@ -4,7 +4,7 @@
       "git": {
         "name": "googleapis",
         "remote": "https://github.com/googleapis/googleapis.git",
-        "sha": "7272af32a96a42fe5bb9452360e32ae95718abc2"        
+        "sha": "07460951fc07dd2b3f172d01b04e2a5fefd13ccc"        
       }
     }
   ]

apis/Google.Cloud.BigQuery.Reservation.V1/Google.Cloud.BigQuery.Reservation.V1/ReservationServiceClient.g.cs

@@ -405,6 +405,23 @@ private ReservationServiceClient BuildImpl()
     }
 
     /// <summary>ReservationService client wrapper, for convenient use.</summary>
+    /// <remarks>
+    /// This API allows users to manage their flat-rate BigQuery reservations.
+    /// 
+    /// A reservation provides computational resource guarantees, in the form of
+    /// [slots](https://cloud.google.com/bigquery/docs/slots), to users. A slot is a
+    /// unit of computational power in BigQuery, and serves as the basic unit of
+    /// parallelism. In a scan of a multi-partitioned table, a single slot operates
+    /// on a single partition of the table. A reservation resource exists as a child
+    /// resource of the admin project and location, e.g.:
+    /// `projects/myproject/locations/US/reservations/reservationName`.
+    /// 
+    /// A capacity commitment is a way to purchase compute capacity for BigQuery jobs
+    /// (in the form of slots) with some committed period of usage. A capacity
+    /// commitment resource exists as a child resource of the admin project and
+    /// location, e.g.:
+    /// `projects/myproject/locations/US/capacityCommitments/id`.
+    /// </remarks>
     public abstract partial class ReservationServiceClient
     {
         /// <summary>
@@ -3701,6 +3718,23 @@ public virtual BiReservation UpdateBiReservation(BiReservation biReservation, wk
     }
 
     /// <summary>ReservationService client wrapper implementation, for convenient use.</summary>
+    /// <remarks>
+    /// This API allows users to manage their flat-rate BigQuery reservations.
+    /// 
+    /// A reservation provides computational resource guarantees, in the form of
+    /// [slots](https://cloud.google.com/bigquery/docs/slots), to users. A slot is a
+    /// unit of computational power in BigQuery, and serves as the basic unit of
+    /// parallelism. In a scan of a multi-partitioned table, a single slot operates
+    /// on a single partition of the table. A reservation resource exists as a child
+    /// resource of the admin project and location, e.g.:
+    /// `projects/myproject/locations/US/reservations/reservationName`.
+    /// 
+    /// A capacity commitment is a way to purchase compute capacity for BigQuery jobs
+    /// (in the form of slots) with some committed period of usage. A capacity
+    /// commitment resource exists as a child resource of the admin project and
+    /// location, e.g.:
+    /// `projects/myproject/locations/US/capacityCommitments/id`.
+    /// </remarks>
     public sealed partial class ReservationServiceClientImpl : ReservationServiceClient
     {
         private readonly gaxgrpc::ApiCall<CreateReservationRequest, Reservation> _callCreateReservation;