feat: [google-cloud-bigquery-analyticshub] Add support for Analytics Hub & Marketplace Integration (googleapis#13897)

BEGIN_COMMIT_OVERRIDE
feat: Add support for Analytics Hub & Marketplace Integration
feat: Adding CommercialInfo message to the Listing and Subscription
resources
feat: Adding allow_only_metadata_sharing to Listing resource
feat: Adding routine field to the SharedResource message
feat: Adding DestinationDataset to the Subscription resource
feat: Adding delete_commercial and revoke_commercial to
DeleteListingRequest and RevokeSubscriptionRequest
END_COMMIT_OVERRIDE

- [ ] Regenerate this pull request now.

feat: Adding CommercialInfo message to the Listing and Subscription
resources
feat: Adding allow_only_metadata_sharing to Listing resource
feat: Adding routine field to the SharedResource message
feat: Adding DestinationDataset to the Subscription resource
feat: Adding delete_commercial and revoke_commercial to
DeleteListingRequest and RevokeSubscriptionRequest

PiperOrigin-RevId: 758114056

Source-Link:
googleapis/googleapis@1270a1b

Source-Link:
https://github.com/googleapis/googleapis-gen/commit/9db5fb8414108f6fd57e026a4a991e75db670098
Copy-Tag:
eyJwIjoicGFja2FnZXMvZ29vZ2xlLWNsb3VkLWJpZ3F1ZXJ5LWFuYWx5dGljc2h1Yi8uT3dsQm90LnlhbWwiLCJoIjoiOWRiNWZiODQxNDEwOGY2ZmQ1N2UwMjZhNGE5OTFlNzVkYjY3MDA5OCJ9

---------

Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>

Author: gcf-owl-bot[bot]

packages/google-cloud-bigquery-analyticshub/google/cloud/bigquery_analyticshub_v1/services/analytics_hub_service/async_client.py

@@ -97,6 +97,14 @@ class AnalyticsHubServiceAsyncClient:
     parse_dataset_path = staticmethod(AnalyticsHubServiceClient.parse_dataset_path)
     listing_path = staticmethod(AnalyticsHubServiceClient.listing_path)
     parse_listing_path = staticmethod(AnalyticsHubServiceClient.parse_listing_path)
+    managed_service_path = staticmethod(AnalyticsHubServiceClient.managed_service_path)
+    parse_managed_service_path = staticmethod(
+        AnalyticsHubServiceClient.parse_managed_service_path
+    )
+    order_path = staticmethod(AnalyticsHubServiceClient.order_path)
+    parse_order_path = staticmethod(AnalyticsHubServiceClient.parse_order_path)
+    routine_path = staticmethod(AnalyticsHubServiceClient.routine_path)
+    parse_routine_path = staticmethod(AnalyticsHubServiceClient.parse_routine_path)
     subscription_path = staticmethod(AnalyticsHubServiceClient.subscription_path)
     parse_subscription_path = staticmethod(
         AnalyticsHubServiceClient.parse_subscription_path
@@ -366,7 +374,7 @@ async def sample_list_data_exchanges():
                 data exchanges.
             parent (:class:`str`):
                 Required. The parent resource path of the data
-                exchanges. e.g. ``projects/myproject/locations/US``.
+                exchanges. e.g. ``projects/myproject/locations/us``.
 
                 This corresponds to the ``parent`` field
                 on the ``request`` instance; if ``request`` is provided, this
@@ -495,7 +503,7 @@ async def sample_list_org_data_exchanges():
             organization (:class:`str`):
                 Required. The organization resource path of the projects
                 containing DataExchanges. e.g.
-                ``organizations/myorg/locations/US``.
+                ``organizations/myorg/locations/us``.
 
                 This corresponds to the ``organization`` field
                 on the ``request`` instance; if ``request`` is provided, this
@@ -623,7 +631,7 @@ async def sample_get_data_exchange():
                 The request object. Message for getting a data exchange.
             name (:class:`str`):
                 Required. The resource name of the data exchange. e.g.
-                ``projects/myproject/locations/US/dataExchanges/123``.
+                ``projects/myproject/locations/us/dataExchanges/123``.
 
                 This corresponds to the ``name`` field
                 on the ``request`` instance; if ``request`` is provided, this
@@ -742,7 +750,7 @@ async def sample_create_data_exchange():
                 The request object. Message for creating a data exchange.
             parent (:class:`str`):
                 Required. The parent resource path of the data exchange.
-                e.g. ``projects/myproject/locations/US``.
+                e.g. ``projects/myproject/locations/us``.
 
                 This corresponds to the ``parent`` field
                 on the ``request`` instance; if ``request`` is provided, this
@@ -992,7 +1000,7 @@ async def sample_delete_data_exchange():
             name (:class:`str`):
                 Required. The full name of the data exchange resource
                 that you want to delete. For example,
-                ``projects/myproject/locations/US/dataExchanges/123``.
+                ``projects/myproject/locations/us/dataExchanges/123``.
 
                 This corresponds to the ``name`` field
                 on the ``request`` instance; if ``request`` is provided, this
@@ -1095,7 +1103,7 @@ async def sample_list_listings():
                 listings.
             parent (:class:`str`):
                 Required. The parent resource path of the listing. e.g.
-                ``projects/myproject/locations/US/dataExchanges/123``.
+                ``projects/myproject/locations/us/dataExchanges/123``.
 
                 This corresponds to the ``parent`` field
                 on the ``request`` instance; if ``request`` is provided, this
@@ -1219,7 +1227,7 @@ async def sample_get_listing():
                 The request object. Message for getting a listing.
             name (:class:`str`):
                 Required. The resource name of the listing. e.g.
-                ``projects/myproject/locations/US/dataExchanges/123/listings/456``.
+                ``projects/myproject/locations/us/dataExchanges/123/listings/456``.
 
                 This corresponds to the ``name`` field
                 on the ``request`` instance; if ``request`` is provided, this
@@ -1339,7 +1347,7 @@ async def sample_create_listing():
                 The request object. Message for creating a listing.
             parent (:class:`str`):
                 Required. The parent resource path of the listing. e.g.
-                ``projects/myproject/locations/US/dataExchanges/123``.
+                ``projects/myproject/locations/us/dataExchanges/123``.
 
                 This corresponds to the ``parent`` field
                 on the ``request`` instance; if ``request`` is provided, this
@@ -1586,7 +1594,7 @@ async def sample_delete_listing():
                 The request object. Message for deleting a listing.
             name (:class:`str`):
                 Required. Resource name of the listing to delete. e.g.
-                ``projects/myproject/locations/US/dataExchanges/123/listings/456``.
+                ``projects/myproject/locations/us/dataExchanges/123/listings/456``.
 
                 This corresponds to the ``name`` field
                 on the ``request`` instance; if ``request`` is provided, this
@@ -1700,7 +1708,7 @@ async def sample_subscribe_listing():
             name (:class:`str`):
                 Required. Resource name of the listing that you want to
                 subscribe to. e.g.
-                ``projects/myproject/locations/US/dataExchanges/123/listings/456``.
+                ``projects/myproject/locations/us/dataExchanges/123/listings/456``.
 
                 This corresponds to the ``name`` field
                 on the ``request`` instance; if ``request`` is provided, this
@@ -1781,7 +1789,8 @@ async def subscribe_data_exchange(
     ) -> operation_async.AsyncOperation:
         r"""Creates a Subscription to a Data Clean Room. This is
         a long-running operation as it will create one or more
-        linked datasets.
+        linked datasets. Throws a Bad Request error if the Data
+        Exchange does not contain any listings.
 
         .. code-block:: python
 
@@ -1821,7 +1830,7 @@ async def sample_subscribe_data_exchange():
                 Exchange.
             name (:class:`str`):
                 Required. Resource name of the Data Exchange. e.g.
-                ``projects/publisherproject/locations/US/dataExchanges/123``
+                ``projects/publisherproject/locations/us/dataExchanges/123``
 
                 This corresponds to the ``name`` field
                 on the ``request`` instance; if ``request`` is provided, this
@@ -1952,7 +1961,7 @@ async def sample_refresh_subscription():
             name (:class:`str`):
                 Required. Resource name of the Subscription to refresh.
                 e.g.
-                ``projects/subscriberproject/locations/US/subscriptions/123``
+                ``projects/subscriberproject/locations/us/subscriptions/123``
 
                 This corresponds to the ``name`` field
                 on the ``request`` instance; if ``request`` is provided, this
@@ -2074,7 +2083,7 @@ async def sample_get_subscription():
             name (:class:`str`):
                 Required. Resource name of the
                 subscription. e.g.
-                projects/123/locations/US/subscriptions/456
+                projects/123/locations/us/subscriptions/456
 
                 This corresponds to the ``name`` field
                 on the ``request`` instance; if ``request`` is provided, this
@@ -2190,7 +2199,7 @@ async def sample_list_subscriptions():
             parent (:class:`str`):
                 Required. The parent resource path of
                 the subscription. e.g.
-                projects/myproject/locations/US
+                projects/myproject/locations/us
 
                 This corresponds to the ``parent`` field
                 on the ``request`` instance; if ``request`` is provided, this
@@ -2321,9 +2330,9 @@ async def sample_list_shared_resource_subscriptions():
                 Required. Resource name of the
                 requested target. This resource may be
                 either a Listing or a DataExchange. e.g.
-                projects/123/locations/US/dataExchanges/456
+                projects/123/locations/us/dataExchanges/456
                 OR e.g.
-                projects/123/locations/US/dataExchanges/456/listings/789
+                projects/123/locations/us/dataExchanges/456/listings/789
 
                 This corresponds to the ``resource`` field
                 on the ``request`` instance; if ``request`` is provided, this
@@ -2448,7 +2457,7 @@ async def sample_revoke_subscription():
             name (:class:`str`):
                 Required. Resource name of the
                 subscription to revoke. e.g.
-                projects/123/locations/US/subscriptions/456
+                projects/123/locations/us/subscriptions/456
 
                 This corresponds to the ``name`` field
                 on the ``request`` instance; if ``request`` is provided, this
@@ -2563,7 +2572,7 @@ async def sample_delete_subscription():
             name (:class:`str`):
                 Required. Resource name of the
                 subscription to delete. e.g.
-                projects/123/locations/US/subscriptions/456
+                projects/123/locations/us/subscriptions/456
 
                 This corresponds to the ``name`` field
                 on the ``request`` instance; if ``request`` is provided, this