docs: Keep the API doc up-to-date (#80)

- [ ] Regenerate this pull request now. PiperOrigin-RevId: 391605108 Source-Link: googleapis/googleapis@62d5035 Source-Link: googleapis/googleapis-gen@d3293d9
googleapis · Aug 19, 2021 · a77f0ea · a77f0ea
1 parent 9e8a666
commit a77f0ea
Show file tree

Hide file tree

Showing 21 changed files with 307 additions and 239 deletions.
diff --git a/google/cloud/retail_v2/services/catalog_service/async_client.py b/google/cloud/retail_v2/services/catalog_service/async_client.py
@@ -394,9 +394,9 @@ async def set_default_branch(
            branch {newBranch}.
 
         This feature is only available for users who have Retail Search
-        enabled. Contact Retail Support
-        (retail-search-support@google.com) if you are interested in
-        using Retail Search.
+        enabled. Please submit a form
+        `here <https://cloud.google.com/contact>`__ to contact cloud
+        sales if you are interested in using Retail Search.
 
         Args:
             request (:class:`google.cloud.retail_v2.types.SetDefaultBranchRequest`):
@@ -465,9 +465,9 @@ async def get_default_branch(
         method under a specified parent catalog.
 
         This feature is only available for users who have Retail Search
-        enabled. Contact Retail Support
-        (retail-search-support@google.com) if you are interested in
-        using Retail Search.
+        enabled. Please submit a form
+        `here <https://cloud.google.com/contact>`__ to contact cloud
+        sales if you are interested in using Retail Search.
 
         Args:
             request (:class:`google.cloud.retail_v2.types.GetDefaultBranchRequest`):

diff --git a/google/cloud/retail_v2/services/catalog_service/client.py b/google/cloud/retail_v2/services/catalog_service/client.py
@@ -597,9 +597,9 @@ def set_default_branch(
            branch {newBranch}.
 
         This feature is only available for users who have Retail Search
-        enabled. Contact Retail Support
-        (retail-search-support@google.com) if you are interested in
-        using Retail Search.
+        enabled. Please submit a form
+        `here <https://cloud.google.com/contact>`__ to contact cloud
+        sales if you are interested in using Retail Search.
 
         Args:
             request (google.cloud.retail_v2.types.SetDefaultBranchRequest):
@@ -668,9 +668,9 @@ def get_default_branch(
         method under a specified parent catalog.
 
         This feature is only available for users who have Retail Search
-        enabled. Contact Retail Support
-        (retail-search-support@google.com) if you are interested in
-        using Retail Search.
+        enabled. Please submit a form
+        `here <https://cloud.google.com/contact>`__ to contact cloud
+        sales if you are interested in using Retail Search.
 
         Args:
             request (google.cloud.retail_v2.types.GetDefaultBranchRequest):

diff --git a/google/cloud/retail_v2/services/catalog_service/transports/grpc.py b/google/cloud/retail_v2/services/catalog_service/transports/grpc.py
@@ -325,9 +325,9 @@ def set_default_branch(
            branch {newBranch}.
 
         This feature is only available for users who have Retail Search
-        enabled. Contact Retail Support
-        (retail-search-support@google.com) if you are interested in
-        using Retail Search.
+        enabled. Please submit a form
+        `here <https://cloud.google.com/contact>`__ to contact cloud
+        sales if you are interested in using Retail Search.
 
         Returns:
             Callable[[~.SetDefaultBranchRequest],
@@ -361,9 +361,9 @@ def get_default_branch(
         method under a specified parent catalog.
 
         This feature is only available for users who have Retail Search
-        enabled. Contact Retail Support
-        (retail-search-support@google.com) if you are interested in
-        using Retail Search.
+        enabled. Please submit a form
+        `here <https://cloud.google.com/contact>`__ to contact cloud
+        sales if you are interested in using Retail Search.
 
         Returns:
             Callable[[~.GetDefaultBranchRequest],

diff --git a/google/cloud/retail_v2/services/catalog_service/transports/grpc_asyncio.py b/google/cloud/retail_v2/services/catalog_service/transports/grpc_asyncio.py
@@ -333,9 +333,9 @@ def set_default_branch(
            branch {newBranch}.
 
         This feature is only available for users who have Retail Search
-        enabled. Contact Retail Support
-        (retail-search-support@google.com) if you are interested in
-        using Retail Search.
+        enabled. Please submit a form
+        `here <https://cloud.google.com/contact>`__ to contact cloud
+        sales if you are interested in using Retail Search.
 
         Returns:
             Callable[[~.SetDefaultBranchRequest],
@@ -369,9 +369,9 @@ def get_default_branch(
         method under a specified parent catalog.
 
         This feature is only available for users who have Retail Search
-        enabled. Contact Retail Support
-        (retail-search-support@google.com) if you are interested in
-        using Retail Search.
+        enabled. Please submit a form
+        `here <https://cloud.google.com/contact>`__ to contact cloud
+        sales if you are interested in using Retail Search.
 
         Returns:
             Callable[[~.GetDefaultBranchRequest],

diff --git a/google/cloud/retail_v2/services/completion_service/async_client.py b/google/cloud/retail_v2/services/completion_service/async_client.py
@@ -37,10 +37,11 @@
 
 class CompletionServiceAsyncClient:
     """Auto-completion service for retail.
+
     This feature is only available for users who have Retail Search
-    enabled. Contact Retail Support (retail-search-
-    support@google.com) if you are interested in using Retail
-    Search.
+    enabled. Please submit a form
+    `here <https://cloud.google.com/contact>`__ to contact cloud sales
+    if you are interested in using Retail Search.
     """
 
     _client: CompletionServiceClient
@@ -176,12 +177,12 @@ async def complete_query(
         timeout: float = None,
         metadata: Sequence[Tuple[str, str]] = (),
     ) -> completion_service.CompleteQueryResponse:
-        r"""Completes the specified prefix with keyword
-        suggestions.
-        This feature is only available for users who have Retail
-        Search enabled. Contact Retail Support (retail-search-
-        support@google.com) if you are interested in using
-        Retail Search.
+        r"""Completes the specified prefix with keyword suggestions.
+
+        This feature is only available for users who have Retail Search
+        enabled. Please submit a form
+        `here <https://cloud.google.com/contact>`__ to contact cloud
+        sales if you are interested in using Retail Search.
 
         Args:
             request (:class:`google.cloud.retail_v2.types.CompleteQueryRequest`):
@@ -228,12 +229,14 @@ async def import_completion_data(
         metadata: Sequence[Tuple[str, str]] = (),
     ) -> operation_async.AsyncOperation:
         r"""Bulk import of processed completion dataset.
-        Request processing may be synchronous. Partial updating
-        is not supported.
-        This feature is only available for users who have Retail
-        Search enabled. Contact Retail Support (retail-search-
-        support@google.com) if you are interested in using
-        Retail Search.
+
+        Request processing may be synchronous. Partial updating is not
+        supported.
+
+        This feature is only available for users who have Retail Search
+        enabled. Please submit a form
+        `here <https://cloud.google.com/contact>`__ to contact cloud
+        sales if you are interested in using Retail Search.
 
         Args:
             request (:class:`google.cloud.retail_v2.types.ImportCompletionDataRequest`):

diff --git a/google/cloud/retail_v2/services/completion_service/client.py b/google/cloud/retail_v2/services/completion_service/client.py
@@ -76,10 +76,11 @@ def get_transport_class(
 
 class CompletionServiceClient(metaclass=CompletionServiceClientMeta):
     """Auto-completion service for retail.
+
     This feature is only available for users who have Retail Search
-    enabled. Contact Retail Support (retail-search-
-    support@google.com) if you are interested in using Retail
-    Search.
+    enabled. Please submit a form
+    `here <https://cloud.google.com/contact>`__ to contact cloud sales
+    if you are interested in using Retail Search.
     """
 
     @staticmethod
@@ -367,12 +368,12 @@ def complete_query(
         timeout: float = None,
         metadata: Sequence[Tuple[str, str]] = (),
     ) -> completion_service.CompleteQueryResponse:
-        r"""Completes the specified prefix with keyword
-        suggestions.
-        This feature is only available for users who have Retail
-        Search enabled. Contact Retail Support (retail-search-
-        support@google.com) if you are interested in using
-        Retail Search.
+        r"""Completes the specified prefix with keyword suggestions.
+
+        This feature is only available for users who have Retail Search
+        enabled. Please submit a form
+        `here <https://cloud.google.com/contact>`__ to contact cloud
+        sales if you are interested in using Retail Search.
 
         Args:
             request (google.cloud.retail_v2.types.CompleteQueryRequest):
@@ -420,12 +421,14 @@ def import_completion_data(
         metadata: Sequence[Tuple[str, str]] = (),
     ) -> operation.Operation:
         r"""Bulk import of processed completion dataset.
-        Request processing may be synchronous. Partial updating
-        is not supported.
-        This feature is only available for users who have Retail
-        Search enabled. Contact Retail Support (retail-search-
-        support@google.com) if you are interested in using
-        Retail Search.
+
+        Request processing may be synchronous. Partial updating is not
+        supported.
+
+        This feature is only available for users who have Retail Search
+        enabled. Please submit a form
+        `here <https://cloud.google.com/contact>`__ to contact cloud
+        sales if you are interested in using Retail Search.
 
         Args:
             request (google.cloud.retail_v2.types.ImportCompletionDataRequest):

diff --git a/google/cloud/retail_v2/services/completion_service/transports/grpc.py b/google/cloud/retail_v2/services/completion_service/transports/grpc.py
@@ -35,10 +35,11 @@ class CompletionServiceGrpcTransport(CompletionServiceTransport):
     """gRPC backend transport for CompletionService.
 
     Auto-completion service for retail.
+
     This feature is only available for users who have Retail Search
-    enabled. Contact Retail Support (retail-search-
-    support@google.com) if you are interested in using Retail
-    Search.
+    enabled. Please submit a form
+    `here <https://cloud.google.com/contact>`__ to contact cloud sales
+    if you are interested in using Retail Search.
 
     This class defines the same methods as the primary client, so the
     primary client can load the underlying transport implementation
@@ -256,12 +257,12 @@ def complete_query(
     ]:
         r"""Return a callable for the complete query method over gRPC.
 
-        Completes the specified prefix with keyword
-        suggestions.
-        This feature is only available for users who have Retail
-        Search enabled. Contact Retail Support (retail-search-
-        support@google.com) if you are interested in using
-        Retail Search.
+        Completes the specified prefix with keyword suggestions.
+
+        This feature is only available for users who have Retail Search
+        enabled. Please submit a form
+        `here <https://cloud.google.com/contact>`__ to contact cloud
+        sales if you are interested in using Retail Search.
 
         Returns:
             Callable[[~.CompleteQueryRequest],
@@ -290,12 +291,14 @@ def import_completion_data(
         r"""Return a callable for the import completion data method over gRPC.
 
         Bulk import of processed completion dataset.
-        Request processing may be synchronous. Partial updating
-        is not supported.
-        This feature is only available for users who have Retail
-        Search enabled. Contact Retail Support (retail-search-
-        support@google.com) if you are interested in using
-        Retail Search.
+
+        Request processing may be synchronous. Partial updating is not
+        supported.
+
+        This feature is only available for users who have Retail Search
+        enabled. Please submit a form
+        `here <https://cloud.google.com/contact>`__ to contact cloud
+        sales if you are interested in using Retail Search.
 
         Returns:
             Callable[[~.ImportCompletionDataRequest],

diff --git a/google/cloud/retail_v2/services/completion_service/transports/grpc_asyncio.py b/google/cloud/retail_v2/services/completion_service/transports/grpc_asyncio.py
@@ -37,10 +37,11 @@ class CompletionServiceGrpcAsyncIOTransport(CompletionServiceTransport):
     """gRPC AsyncIO backend transport for CompletionService.
 
     Auto-completion service for retail.
+
     This feature is only available for users who have Retail Search
-    enabled. Contact Retail Support (retail-search-
-    support@google.com) if you are interested in using Retail
-    Search.
+    enabled. Please submit a form
+    `here <https://cloud.google.com/contact>`__ to contact cloud sales
+    if you are interested in using Retail Search.
 
     This class defines the same methods as the primary client, so the
     primary client can load the underlying transport implementation
@@ -261,12 +262,12 @@ def complete_query(
     ]:
         r"""Return a callable for the complete query method over gRPC.
 
-        Completes the specified prefix with keyword
-        suggestions.
-        This feature is only available for users who have Retail
-        Search enabled. Contact Retail Support (retail-search-
-        support@google.com) if you are interested in using
-        Retail Search.
+        Completes the specified prefix with keyword suggestions.
+
+        This feature is only available for users who have Retail Search
+        enabled. Please submit a form
+        `here <https://cloud.google.com/contact>`__ to contact cloud
+        sales if you are interested in using Retail Search.
 
         Returns:
             Callable[[~.CompleteQueryRequest],
@@ -295,12 +296,14 @@ def import_completion_data(
         r"""Return a callable for the import completion data method over gRPC.
 
         Bulk import of processed completion dataset.
-        Request processing may be synchronous. Partial updating
-        is not supported.
-        This feature is only available for users who have Retail
-        Search enabled. Contact Retail Support (retail-search-
-        support@google.com) if you are interested in using
-        Retail Search.
+
+        Request processing may be synchronous. Partial updating is not
+        supported.
+
+        This feature is only available for users who have Retail Search
+        enabled. Please submit a form
+        `here <https://cloud.google.com/contact>`__ to contact cloud
+        sales if you are interested in using Retail Search.
 
         Returns:
             Callable[[~.ImportCompletionDataRequest],

diff --git a/google/cloud/retail_v2/services/product_service/async_client.py b/google/cloud/retail_v2/services/product_service/async_client.py
@@ -764,9 +764,9 @@ async def set_inventory(
         [RemoveFulfillmentPlaces][google.cloud.retail.v2.ProductService.RemoveFulfillmentPlaces].
 
         This feature is only available for users who have Retail Search
-        enabled. Contact Retail Support
-        (retail-search-support@google.com) if you are interested in
-        using Retail Search.
+        enabled. Please submit a form
+        `here <https://cloud.google.com/contact>`__ to contact cloud
+        sales if you are interested in using Retail Search.
 
         Args:
             request (:class:`google.cloud.retail_v2.types.SetInventoryRequest`):
@@ -919,9 +919,9 @@ async def add_fulfillment_places(
         [ListProducts][google.cloud.retail.v2.ProductService.ListProducts].
 
         This feature is only available for users who have Retail Search
-        enabled. Contact Retail Support
-        (retail-search-support@google.com) if you are interested in
-        using Retail Search.
+        enabled. Please submit a form
+        `here <https://cloud.google.com/contact>`__ to contact cloud
+        sales if you are interested in using Retail Search.
 
         Args:
             request (:class:`google.cloud.retail_v2.types.AddFulfillmentPlacesRequest`):
@@ -1024,9 +1024,9 @@ async def remove_fulfillment_places(
         [ListProducts][google.cloud.retail.v2.ProductService.ListProducts].
 
         This feature is only available for users who have Retail Search
-        enabled. Contact Retail Support
-        (retail-search-support@google.com) if you are interested in
-        using Retail Search.
+        enabled. Please submit a form
+        `here <https://cloud.google.com/contact>`__ to contact cloud
+        sales if you are interested in using Retail Search.
 
         Args:
             request (:class:`google.cloud.retail_v2.types.RemoveFulfillmentPlacesRequest`):