feat(networkconnectivity): add DataTransferService (#15464)

Author: scotthart

generator/generator_config.textproto

@@ -3055,6 +3055,13 @@ service {
   retryable_status_codes: ["kUnavailable"]
 }
 
+service {
+  service_proto_path: "google/cloud/networkconnectivity/v1/data_transfer.proto"
+  product_path: "google/cloud/networkconnectivity/v1"
+  initial_copyright_year: "2025"
+  retryable_status_codes: ["kUnavailable"]
+}
+
 # Network Management
 service {
   service_proto_path: "google/cloud/networkmanagement/v1/reachability.proto"

generator/internal/descriptor_utils.cc

@@ -261,6 +261,9 @@ ParameterCommentSubstitution substitutions[] = {
     // Extra quotes in asset/v1.
     {R"""( "folders/12345")", or a )""", R"""( "folders/12345"), or a )"""},
 
+    // From google/cloud/networkconnectivity/v1/data_transfer.proto
+    {R"""(`FieldMask is used)""", R"""(`FieldMask` is used)"""},
+
     // Doxygen gets confused by single quotes in code spans:
     //    https://www.doxygen.nl/manual/markdown.html#mddox_code_spans
     // The workaround is to double quote these:

google/cloud/networkconnectivity/doc/environment-variables.dox

@@ -10,6 +10,10 @@ environment variables are convenient when troubleshooting problems.
 
 <!-- inject-endpoint-env-vars-start -->
 
+- `GOOGLE_CLOUD_CPP_DATA_TRANSFER_SERVICE_ENDPOINT=...` overrides the
+  `EndpointOption` (which defaults to "networkconnectivity.googleapis.com")
+  used by `MakeDataTransferServiceConnection()`.
+
 - `GOOGLE_CLOUD_CPP_HUB_SERVICE_ENDPOINT=...` overrides the
   `EndpointOption` (which defaults to "networkconnectivity.googleapis.com")
   used by `MakeHubServiceConnection()`.

google/cloud/networkconnectivity/doc/main.dox

@@ -33,6 +33,7 @@ The library also has other classes that provide helpers, configuration
 parameters, and infrastructure to mock the `*Client` classes when testing your
 application.
 
+- [\c networkconnectivity_v1::DataTransferServiceClient](@ref google::cloud::networkconnectivity_v1::DataTransferServiceClient)
 - [\c networkconnectivity_v1::HubServiceClient](@ref google::cloud::networkconnectivity_v1::HubServiceClient)
 - [\c networkconnectivity_v1::PolicyBasedRoutingServiceClient](@ref google::cloud::networkconnectivity_v1::PolicyBasedRoutingServiceClient)
 <!-- inject-client-list-end -->

google/cloud/networkconnectivity/doc/override-authentication.dox

@@ -9,10 +9,11 @@ this default. You can do so by providing the
 The following example shows how to explicitly load a service account key file:
 
 <!-- inject-service-account-snippet-start -->
-@snippet hub_client_samples.cc with-service-account
+@snippet data_transfer_client_samples.cc with-service-account
 
 Follow these links to find examples for other \c *Client classes:
 
+- [\c networkconnectivity_v1::DataTransferServiceClient](@ref networkconnectivity_v1::DataTransferServiceClient-service-account-snippet)
 - [\c networkconnectivity_v1::HubServiceClient](@ref networkconnectivity_v1::HubServiceClient-service-account-snippet)
 - [\c networkconnectivity_v1::PolicyBasedRoutingServiceClient](@ref networkconnectivity_v1::PolicyBasedRoutingServiceClient-service-account-snippet)
 
@@ -32,6 +33,12 @@ guide for more details.
 
 // <!-- inject-authentication-pages-start -->
 
+/*! @page networkconnectivity_v1::DataTransferServiceClient-service-account-snippet Override networkconnectivity_v1::DataTransferServiceClient Authentication Defaults
+
+@snippet google/cloud/networkconnectivity/v1/samples/data_transfer_client_samples.cc with-service-account
+
+*/
+
 /*! @page networkconnectivity_v1::HubServiceClient-service-account-snippet Override networkconnectivity_v1::HubServiceClient Authentication Defaults
 
 @snippet google/cloud/networkconnectivity/v1/samples/hub_client_samples.cc with-service-account

google/cloud/networkconnectivity/doc/override-endpoint.dox

@@ -7,12 +7,13 @@ library. Use the
 client library to change this default.
 
 <!-- inject-endpoint-snippet-start -->
-For example, this will override the default endpoint for `networkconnectivity_v1::HubServiceClient`:
+For example, this will override the default endpoint for `networkconnectivity_v1::DataTransferServiceClient`:
 
-@snippet hub_client_samples.cc set-client-endpoint
+@snippet data_transfer_client_samples.cc set-client-endpoint
 
 Follow these links to find examples for other \c *Client classes:
 
+- [\c networkconnectivity_v1::DataTransferServiceClient](@ref networkconnectivity_v1::DataTransferServiceClient-endpoint-snippet)
 - [\c networkconnectivity_v1::HubServiceClient](@ref networkconnectivity_v1::HubServiceClient-endpoint-snippet)
 - [\c networkconnectivity_v1::PolicyBasedRoutingServiceClient](@ref networkconnectivity_v1::PolicyBasedRoutingServiceClient-endpoint-snippet)
 
@@ -22,6 +23,12 @@ Follow these links to find examples for other \c *Client classes:
 
 // <!-- inject-endpoint-pages-start -->
 
+/*! @page networkconnectivity_v1::DataTransferServiceClient-endpoint-snippet Override networkconnectivity_v1::DataTransferServiceClient Endpoint Configuration
+
+@snippet google/cloud/networkconnectivity/v1/samples/data_transfer_client_samples.cc set-client-endpoint
+
+*/
+
 /*! @page networkconnectivity_v1::HubServiceClient-endpoint-snippet Override networkconnectivity_v1::HubServiceClient Endpoint Configuration
 
 @snippet google/cloud/networkconnectivity/v1/samples/hub_client_samples.cc set-client-endpoint

google/cloud/networkconnectivity/doc/override-retry-policies.dox

@@ -68,21 +68,22 @@ will use `FooBarIdempotencyPolicy`. This policy is very conservative.
 @section networkconnectivity-override-retry-example Example
 
 <!-- inject-retry-snippet-start -->
-For example, this will override the retry policies for `networkconnectivity_v1::HubServiceClient`:
+For example, this will override the retry policies for `networkconnectivity_v1::DataTransferServiceClient`:
 
-@snippet hub_client_samples.cc set-retry-policy
+@snippet data_transfer_client_samples.cc set-retry-policy
 
 This assumes you have created a custom idempotency policy. Such as:
 
-@snippet hub_client_samples.cc custom-idempotency-policy
+@snippet data_transfer_client_samples.cc custom-idempotency-policy
 
-This will override the polling policies for `networkconnectivity_v1::HubServiceClient`
+This will override the polling policies for `networkconnectivity_v1::DataTransferServiceClient`
 
-@snippet hub_client_samples.cc set-polling-policy
+@snippet data_transfer_client_samples.cc set-polling-policy
 
 
 Follow these links to find examples for other \c *Client classes:
 
+- [\c networkconnectivity_v1::DataTransferServiceClient](@ref networkconnectivity_v1::DataTransferServiceClient-retry-snippet)
 - [\c networkconnectivity_v1::HubServiceClient](@ref networkconnectivity_v1::HubServiceClient-retry-snippet)
 - [\c networkconnectivity_v1::PolicyBasedRoutingServiceClient](@ref networkconnectivity_v1::PolicyBasedRoutingServiceClient-retry-snippet)
 
@@ -100,6 +101,18 @@ Follow these links to find examples for other \c *Client classes:
 
 // <!-- inject-retry-pages-start -->
 
+/*! @page networkconnectivity_v1::DataTransferServiceClient-retry-snippet Override networkconnectivity_v1::DataTransferServiceClient Retry Policies
+
+This shows how to override the retry policies for networkconnectivity_v1::DataTransferServiceClient:
+
+@snippet google/cloud/networkconnectivity/v1/samples/data_transfer_client_samples.cc set-retry-policy
+
+Assuming you have created a custom idempotency policy. Such as:
+
+@snippet google/cloud/networkconnectivity/v1/samples/data_transfer_client_samples.cc custom-idempotency-policy
+
+*/
+
 /*! @page networkconnectivity_v1::HubServiceClient-retry-snippet Override networkconnectivity_v1::HubServiceClient Retry Policies
 
 This shows how to override the retry policies for networkconnectivity_v1::HubServiceClient: