feat: [retail] add merchant center link service

packages/google-cloud-retail/README.md

@@ -104,6 +104,14 @@ Samples are in the [`samples/`](https://github.com/googleapis/google-cloud-node/
 | Control_service.get_control | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-retail/samples/generated/v2/control_service.get_control.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-retail/samples/generated/v2/control_service.get_control.js,samples/README.md) |
 | Control_service.list_controls | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-retail/samples/generated/v2/control_service.list_controls.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-retail/samples/generated/v2/control_service.list_controls.js,samples/README.md) |
 | Control_service.update_control | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-retail/samples/generated/v2/control_service.update_control.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-retail/samples/generated/v2/control_service.update_control.js,samples/README.md) |
+| Model_service.create_model | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-retail/samples/generated/v2/model_service.create_model.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-retail/samples/generated/v2/model_service.create_model.js,samples/README.md) |
+| Model_service.delete_model | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-retail/samples/generated/v2/model_service.delete_model.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-retail/samples/generated/v2/model_service.delete_model.js,samples/README.md) |
+| Model_service.get_model | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-retail/samples/generated/v2/model_service.get_model.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-retail/samples/generated/v2/model_service.get_model.js,samples/README.md) |
+| Model_service.list_models | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-retail/samples/generated/v2/model_service.list_models.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-retail/samples/generated/v2/model_service.list_models.js,samples/README.md) |
+| Model_service.pause_model | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-retail/samples/generated/v2/model_service.pause_model.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-retail/samples/generated/v2/model_service.pause_model.js,samples/README.md) |
+| Model_service.resume_model | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-retail/samples/generated/v2/model_service.resume_model.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-retail/samples/generated/v2/model_service.resume_model.js,samples/README.md) |
+| Model_service.tune_model | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-retail/samples/generated/v2/model_service.tune_model.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-retail/samples/generated/v2/model_service.tune_model.js,samples/README.md) |
+| Model_service.update_model | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-retail/samples/generated/v2/model_service.update_model.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-retail/samples/generated/v2/model_service.update_model.js,samples/README.md) |
 | Prediction_service.predict | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-retail/samples/generated/v2/prediction_service.predict.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-retail/samples/generated/v2/prediction_service.predict.js,samples/README.md) |
 | Product_service.add_fulfillment_places | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-retail/samples/generated/v2/product_service.add_fulfillment_places.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-retail/samples/generated/v2/product_service.add_fulfillment_places.js,samples/README.md) |
 | Product_service.add_local_inventories | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-retail/samples/generated/v2/product_service.add_local_inventories.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-retail/samples/generated/v2/product_service.add_local_inventories.js,samples/README.md) |
@@ -202,6 +210,7 @@ Samples are in the [`samples/`](https://github.com/googleapis/google-cloud-node/
 | Control_service.update_control | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-retail/samples/generated/v2beta/control_service.update_control.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-retail/samples/generated/v2beta/control_service.update_control.js,samples/README.md) |
 | Model_service.create_model | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-retail/samples/generated/v2beta/model_service.create_model.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-retail/samples/generated/v2beta/model_service.create_model.js,samples/README.md) |
 | Model_service.delete_model | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-retail/samples/generated/v2beta/model_service.delete_model.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-retail/samples/generated/v2beta/model_service.delete_model.js,samples/README.md) |
+| Model_service.get_model | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-retail/samples/generated/v2beta/model_service.get_model.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-retail/samples/generated/v2beta/model_service.get_model.js,samples/README.md) |
 | Model_service.list_models | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-retail/samples/generated/v2beta/model_service.list_models.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-retail/samples/generated/v2beta/model_service.list_models.js,samples/README.md) |
 | Model_service.pause_model | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-retail/samples/generated/v2beta/model_service.pause_model.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-retail/samples/generated/v2beta/model_service.pause_model.js,samples/README.md) |
 | Model_service.resume_model | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-retail/samples/generated/v2beta/model_service.resume_model.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-retail/samples/generated/v2beta/model_service.resume_model.js,samples/README.md) |

packages/google-cloud-retail/protos/google/cloud/retail/v2/catalog.proto

@@ -140,8 +140,7 @@ message CatalogAttribute {
 
   // The status of the exact-searchable option of a catalog attribute.
   enum ExactSearchableOption {
-    // Value used when unset. Defaults to
-    // [EXACT_SEARCHABLE_DISABLED][google.cloud.retail.v2.CatalogAttribute.ExactSearchableOption.EXACT_SEARCHABLE_DISABLED].
+    // Value used when unset.
     EXACT_SEARCHABLE_OPTION_UNSPECIFIED = 0;
 
     // Exact searchable option enabled for an attribute.
@@ -153,8 +152,7 @@ message CatalogAttribute {
 
   // The status of the retrievable option of a catalog attribute.
   enum RetrievableOption {
-    // Value used when unset. Defaults to
-    // [RETRIEVABLE_DISABLED][google.cloud.retail.v2.CatalogAttribute.RetrievableOption.RETRIEVABLE_DISABLED].
+    // Value used when unset.
     RETRIEVABLE_OPTION_UNSPECIFIED = 0;
 
     // Retrievable option enabled for an attribute.
@@ -171,6 +169,10 @@ message CatalogAttribute {
   // characters and underscores. For example, an attribute named
   // `attributes.abc_xyz` can be indexed, but an attribute named
   // `attributes.abc-xyz` cannot be indexed.
+  //
+  // If the attribute key starts with `attributes.`, then the attribute is a
+  // custom attribute. Attributes such as `brands`, `patterns`, and `title` are
+  // built-in and called system attributes.
   string key = 1 [(google.api.field_behavior) = REQUIRED];
 
   // Output only. Indicates whether this attribute has been used by any
@@ -235,11 +237,14 @@ message CatalogAttribute {
 
   // If EXACT_SEARCHABLE_ENABLED, attribute values will be exact searchable.
   // This property only applies to textual custom attributes and requires
-  // indexable set to enabled to enable exact-searchable.
+  // indexable set to enabled to enable exact-searchable. If unset, the server
+  // behavior defaults to
+  // [EXACT_SEARCHABLE_DISABLED][google.cloud.retail.v2.CatalogAttribute.ExactSearchableOption.EXACT_SEARCHABLE_DISABLED].
   ExactSearchableOption exact_searchable_option = 11;
 
   // If RETRIEVABLE_ENABLED, attribute values are retrievable in the search
-  // results.
+  // results. If unset, the server behavior defaults to
+  // [RETRIEVABLE_DISABLED][google.cloud.retail.v2.CatalogAttribute.RetrievableOption.RETRIEVABLE_DISABLED].
   RetrievableOption retrievable_option = 12;
 }
 

packages/google-cloud-retail/protos/google/cloud/retail/v2/common.proto

@@ -55,6 +55,20 @@ enum SolutionType {
   SOLUTION_TYPE_SEARCH = 2;
 }
 
+// If filtering for recommendations is enabled.
+enum RecommendationsFilteringOption {
+  // Value used when unset.
+  // In this case, server behavior defaults to
+  // [RECOMMENDATIONS_FILTERING_DISABLED][google.cloud.retail.v2.RecommendationsFilteringOption.RECOMMENDATIONS_FILTERING_DISABLED].
+  RECOMMENDATIONS_FILTERING_OPTION_UNSPECIFIED = 0;
+
+  // Recommendation filtering is disabled.
+  RECOMMENDATIONS_FILTERING_DISABLED = 1;
+
+  // Recommendation filtering is enabled.
+  RECOMMENDATIONS_FILTERING_ENABLED = 3;
+}
+
 // The use case of Cloud Retail Search.
 enum SearchSolutionUseCase {
   // The value when it's unspecified. In this case, server behavior defaults to
@@ -362,7 +376,7 @@ message ColorInfo {
   // it is expected to have only 1 color. May consider using single "Mixed"
   // instead of multiple values.
   //
-  // A maximum of 25 colors are allowed. Each value must be a UTF-8 encoded
+  // A maximum of 75 colors are allowed. Each value must be a UTF-8 encoded
   // string with a length limit of 128 characters. Otherwise, an
   // INVALID_ARGUMENT error is returned.
   //

packages/google-cloud-retail/protos/google/cloud/retail/v2/completion_service.proto

@@ -33,7 +33,7 @@ option objc_class_prefix = "RETAIL";
 option php_namespace = "Google\\Cloud\\Retail\\V2";
 option ruby_package = "Google::Cloud::Retail::V2";
 
-// Auto-completion service for retail.
+// Autocomplete service for retail.
 //
 // This feature is only available for users who have Retail Search enabled.
 // Enable Retail Search on Cloud Console before using this feature.
@@ -74,7 +74,7 @@ service CompletionService {
   }
 }
 
-// Auto-complete parameters.
+// Autocomplete parameters.
 message CompleteQueryRequest {
   // Required. Catalog for which the completion is performed.
   //
@@ -150,9 +150,17 @@ message CompleteQueryRequest {
   // The maximum allowed max suggestions is 20. If it is set higher, it will be
   // capped by 20.
   int32 max_suggestions = 5;
+
+  // The entity for customers that may run multiple different entities, domains,
+  // sites or regions, for example, `Google US`, `Google Ads`, `Waymo`,
+  // `google.com`, `youtube.com`, etc.
+  // If this is set, it should be exactly matched with
+  // [UserEvent.entity][google.cloud.retail.v2.UserEvent.entity] to get
+  // per-entity autocomplete results.
+  string entity = 10;
 }
 
-// Response of the auto-complete query.
+// Response of the autocomplete query.
 message CompleteQueryResponse {
   // Resource that represents completion results.
   message CompletionResult {

packages/google-cloud-retail/protos/google/cloud/retail/v2/import_config.proto

@@ -126,7 +126,7 @@ message BigQuerySource {
   //   The schema is available here:
   //   https://support.google.com/analytics/answer/7029846.
   //
-  // Supported values for auto-completion imports:
+  // Supported values for autocomplete imports:
   //
   // * `suggestions` (default): One JSON completion suggestion per line.
   // * `denylist`:  One JSON deny suggestion per line.