feat: add merchant center link service (#404)

* feat: support per-entity search and autocomplete
feat: add model get API
feat: support new filter syntax for recommendation
feat: expose A/B experiment info in search response
docs: keep the API doc up-to-date with recent changes

PiperOrigin-RevId: 522675546

Source-Link: googleapis/googleapis@81b0808

Source-Link: https://github.com/googleapis/googleapis-gen/commit/e950439cd0d486ab8d2b32672b54c0a6b6451420
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiZTk1MDQzOWNkMGQ0ODZhYjhkMmIzMjY3MmI1NGMwYTZiNjQ1MTQyMCJ9

* 🦉 Updates from OwlBot post-processor

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

* feat: add model service
feat: support per-entity search and autocomplete
feat: support new filter syntax for recommendation
feat: expose A/B experiment info in search response
docs: keep the API doc up-to-date with recent changes

PiperOrigin-RevId: 522675951

Source-Link: googleapis/googleapis@f149e91

Source-Link: https://github.com/googleapis/googleapis-gen/commit/c4538a888d2ec13ce719c1a1aa9dc7de5b17375a
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiYzQ1MzhhODg4ZDJlYzEzY2U3MTljMWExYWE5ZGM3ZGU1YjE3Mzc1YSJ9

* 🦉 Updates from OwlBot post-processor

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

* feat: add merchant center link service
feat: support per-entity search and autocomplete
feat: expose facets and product counts in autocomplete
feat: add model get API
feat: allow cascaded deletion on primary product
feat: support new filter syntax for recommendation
feat: expose A/B experiment info in search response
docs: keep the API doc up-to-date with recent changes

PiperOrigin-RevId: 523140513

Source-Link: googleapis/googleapis@4a9f933

Source-Link: https://github.com/googleapis/googleapis-gen/commit/ffb754a7d2cd79380fb5ccfd33a1c0908dbb62a5
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiZmZiNzU0YTdkMmNkNzkzODBmYjVjY2ZkMzNhMWMwOTA4ZGJiNjJhNSJ9

* 🦉 Updates from OwlBot post-processor

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

---------

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

docs/retail_v2/model_service.rst

@@ -0,0 +1,10 @@
+ModelService
+------------------------------
+
+.. automodule:: google.cloud.retail_v2.services.model_service
+    :members:
+    :inherited-members:
+
+.. automodule:: google.cloud.retail_v2.services.model_service.pagers
+    :members:
+    :inherited-members:

docs/retail_v2/services.rst

@@ -6,6 +6,7 @@ Services for Google Cloud Retail v2 API
     catalog_service
     completion_service
     control_service
+    model_service
     prediction_service
     product_service
     search_service

docs/retail_v2alpha/merchant_center_account_link_service.rst

@@ -0,0 +1,6 @@
+MerchantCenterAccountLinkService
+--------------------------------------------------
+
+.. automodule:: google.cloud.retail_v2alpha.services.merchant_center_account_link_service
+    :members:
+    :inherited-members:

docs/retail_v2alpha/services.rst

@@ -6,6 +6,7 @@ Services for Google Cloud Retail v2alpha API
     catalog_service
     completion_service
     control_service
+    merchant_center_account_link_service
     model_service
     prediction_service
     product_service

google/cloud/retail/__init__.py

@@ -32,6 +32,10 @@
     ControlServiceAsyncClient,
 )
 from google.cloud.retail_v2.services.control_service.client import ControlServiceClient
+from google.cloud.retail_v2.services.model_service.async_client import (
+    ModelServiceAsyncClient,
+)
+from google.cloud.retail_v2.services.model_service.client import ModelServiceClient
 from google.cloud.retail_v2.services.prediction_service.async_client import (
     PredictionServiceAsyncClient,
 )
@@ -92,6 +96,7 @@
     LocalInventory,
     PriceInfo,
     Rating,
+    RecommendationsFilteringOption,
     Rule,
     SearchSolutionUseCase,
     SolutionType,
@@ -128,6 +133,21 @@
     UserEventInlineSource,
     UserEventInputConfig,
 )
+from google.cloud.retail_v2.types.model import Model
+from google.cloud.retail_v2.types.model_service import (
+    CreateModelMetadata,
+    CreateModelRequest,
+    DeleteModelRequest,
+    GetModelRequest,
+    ListModelsRequest,
+    ListModelsResponse,
+    PauseModelRequest,
+    ResumeModelRequest,
+    TuneModelMetadata,
+    TuneModelRequest,
+    TuneModelResponse,
+    UpdateModelRequest,
+)
 from google.cloud.retail_v2.types.prediction_service import (
     PredictRequest,
     PredictResponse,
@@ -162,7 +182,11 @@
     PurgeUserEventsRequest,
     PurgeUserEventsResponse,
 )
-from google.cloud.retail_v2.types.search_service import SearchRequest, SearchResponse
+from google.cloud.retail_v2.types.search_service import (
+    ExperimentInfo,
+    SearchRequest,
+    SearchResponse,
+)
 from google.cloud.retail_v2.types.serving_config import ServingConfig
 from google.cloud.retail_v2.types.serving_config_service import (
     AddControlRequest,
@@ -195,6 +219,8 @@
     "CompletionServiceAsyncClient",
     "ControlServiceClient",
     "ControlServiceAsyncClient",
+    "ModelServiceClient",
+    "ModelServiceAsyncClient",
     "PredictionServiceClient",
     "PredictionServiceAsyncClient",
     "ProductServiceClient",
@@ -236,6 +262,7 @@
     "Rule",
     "UserInfo",
     "AttributeConfigLevel",
+    "RecommendationsFilteringOption",
     "SearchSolutionUseCase",
     "SolutionType",
     "CompleteQueryRequest",
@@ -263,6 +290,19 @@
     "UserEventImportSummary",
     "UserEventInlineSource",
     "UserEventInputConfig",
+    "Model",
+    "CreateModelMetadata",
+    "CreateModelRequest",
+    "DeleteModelRequest",
+    "GetModelRequest",
+    "ListModelsRequest",
+    "ListModelsResponse",
+    "PauseModelRequest",
+    "ResumeModelRequest",
+    "TuneModelMetadata",
+    "TuneModelRequest",
+    "TuneModelResponse",
+    "UpdateModelRequest",
     "PredictRequest",
     "PredictResponse",
     "Product",
@@ -291,6 +331,7 @@
     "PurgeMetadata",
     "PurgeUserEventsRequest",
     "PurgeUserEventsResponse",
+    "ExperimentInfo",
     "SearchRequest",
     "SearchResponse",
     "ServingConfig",

google/cloud/retail_v2/__init__.py

@@ -24,6 +24,7 @@
     CompletionServiceClient,
 )
 from .services.control_service import ControlServiceAsyncClient, ControlServiceClient
+from .services.model_service import ModelServiceAsyncClient, ModelServiceClient
 from .services.prediction_service import (
     PredictionServiceAsyncClient,
     PredictionServiceClient,
@@ -72,6 +73,7 @@
     LocalInventory,
     PriceInfo,
     Rating,
+    RecommendationsFilteringOption,
     Rule,
     SearchSolutionUseCase,
     SolutionType,
@@ -105,6 +107,21 @@
     UserEventInlineSource,
     UserEventInputConfig,
 )
+from .types.model import Model
+from .types.model_service import (
+    CreateModelMetadata,
+    CreateModelRequest,
+    DeleteModelRequest,
+    GetModelRequest,
+    ListModelsRequest,
+    ListModelsResponse,
+    PauseModelRequest,
+    ResumeModelRequest,
+    TuneModelMetadata,
+    TuneModelRequest,
+    TuneModelResponse,
+    UpdateModelRequest,
+)
 from .types.prediction_service import PredictRequest, PredictResponse
 from .types.product import Product
 from .types.product_service import (
@@ -136,7 +153,7 @@
     PurgeUserEventsRequest,
     PurgeUserEventsResponse,
 )
-from .types.search_service import SearchRequest, SearchResponse
+from .types.search_service import ExperimentInfo, SearchRequest, SearchResponse
 from .types.serving_config import ServingConfig
 from .types.serving_config_service import (
     AddControlRequest,
@@ -166,6 +183,7 @@
     "CatalogServiceAsyncClient",
     "CompletionServiceAsyncClient",
     "ControlServiceAsyncClient",
+    "ModelServiceAsyncClient",
     "PredictionServiceAsyncClient",
     "ProductServiceAsyncClient",
     "SearchServiceAsyncClient",
@@ -198,19 +216,24 @@
     "Control",
     "ControlServiceClient",
     "CreateControlRequest",
+    "CreateModelMetadata",
+    "CreateModelRequest",
     "CreateProductRequest",
     "CreateServingConfigRequest",
     "CustomAttribute",
     "DeleteControlRequest",
+    "DeleteModelRequest",
     "DeleteProductRequest",
     "DeleteServingConfigRequest",
+    "ExperimentInfo",
     "FulfillmentInfo",
     "GcsSource",
     "GetAttributesConfigRequest",
     "GetCompletionConfigRequest",
     "GetControlRequest",
     "GetDefaultBranchRequest",
     "GetDefaultBranchResponse",
+    "GetModelRequest",
     "GetProductRequest",
     "GetServingConfigRequest",
     "Image",
@@ -227,11 +250,16 @@
     "ListCatalogsResponse",
     "ListControlsRequest",
     "ListControlsResponse",
+    "ListModelsRequest",
+    "ListModelsResponse",
     "ListProductsRequest",
     "ListProductsResponse",
     "ListServingConfigsRequest",
     "ListServingConfigsResponse",
     "LocalInventory",
+    "Model",
+    "ModelServiceClient",
+    "PauseModelRequest",
     "PredictRequest",
     "PredictResponse",
     "PredictionServiceClient",
@@ -248,6 +276,7 @@
     "PurgeUserEventsRequest",
     "PurgeUserEventsResponse",
     "Rating",
+    "RecommendationsFilteringOption",
     "RejoinUserEventsMetadata",
     "RejoinUserEventsRequest",
     "RejoinUserEventsResponse",
@@ -260,6 +289,7 @@
     "RemoveLocalInventoriesRequest",
     "RemoveLocalInventoriesResponse",
     "ReplaceCatalogAttributeRequest",
+    "ResumeModelRequest",
     "Rule",
     "SearchRequest",
     "SearchResponse",
@@ -272,10 +302,14 @@
     "SetInventoryRequest",
     "SetInventoryResponse",
     "SolutionType",
+    "TuneModelMetadata",
+    "TuneModelRequest",
+    "TuneModelResponse",
     "UpdateAttributesConfigRequest",
     "UpdateCatalogRequest",
     "UpdateCompletionConfigRequest",
     "UpdateControlRequest",
+    "UpdateModelRequest",
     "UpdateProductRequest",
     "UpdateServingConfigRequest",
     "UserEvent",