docs: users can self enroll retail search feature on cloud console (#377)

* docs: users can self enroll retail search feature on cloud console docs: suggest search users not to send IP and use hashed user id docs: deprecate request_id in ImportProductsRequest docs: deprecate search dynamic_facet_spec and suggest to config on cloud console docs: keep the API doc up-to-date with recent changes feat: add new AddLocalInventories and RemoveLocalInventories APIs feat: users cannot switch to empty default branch unless force override feat: allow search users to skip validation for invalid boost specs feat: support search personalization feat: search returns applied control ids in the response PiperOrigin-RevId: 437355889 Source-Link: googleapis/googleapis@4d00815 Source-Link: https://github.com/googleapis/googleapis-gen/commit/b2b798247d46c932737cf689744a827fae7e5313 Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiYjJiNzk4MjQ3ZDQ2YzkzMjczN2NmNjg5NzQ0YTgyN2ZhZTdlNTMxMyJ9 * 🦉 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>

Author: gcf-owl-bot[bot]

README.md

@@ -27,13 +27,13 @@ If you are using Maven, add this to your pom.xml file:
 If you are using Gradle without BOM, add this to your dependencies
 
 ```Groovy
-implementation 'com.google.cloud:google-cloud-retail:2.0.15'
+implementation 'com.google.cloud:google-cloud-retail:2.0.16'
 ```
 
 If you are using SBT, add this to your dependencies
 
 ```Scala
-libraryDependencies += "com.google.cloud" % "google-cloud-retail" % "2.0.15"
+libraryDependencies += "com.google.cloud" % "google-cloud-retail" % "2.0.16"
 ```
 
 ## Authentication

google-cloud-retail/src/main/java/com/google/cloud/retail/v2/CatalogServiceClient.java

@@ -403,10 +403,6 @@ public final UnaryCallable<UpdateCatalogRequest, Catalog> updateCatalogCallable(
  * <li>UserEventService will only join events with products from branch {newBranch}.
  * </ul>
  *
- * <p>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.
- *
  * <p>Sample code:
  *
  * <pre>{@code
@@ -461,10 +457,6 @@ public final void setDefaultBranch(CatalogName catalog) {
  * <li>UserEventService will only join events with products from branch {newBranch}.
  * </ul>
  *
- * <p>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.
- *
  * <p>Sample code:
  *
  * <pre>{@code
@@ -517,10 +509,6 @@ public final void setDefaultBranch(String catalog) {
  * <li>UserEventService will only join events with products from branch {newBranch}.
  * </ul>
  *
- * <p>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.
- *
  * <p>Sample code:
  *
  * <pre>{@code
@@ -531,6 +519,7 @@ public final void setDefaultBranch(String catalog) {
  * .setBranchId(
  * BranchName.of("[PROJECT]", "[LOCATION]", "[CATALOG]", "[BRANCH]").toString())
  * .setNote("note3387378")
+ * .setForce(true)
  * .build();
  * catalogServiceClient.setDefaultBranch(request);
  * }
@@ -576,10 +565,6 @@ public final void setDefaultBranch(SetDefaultBranchRequest request) {
  * <li>UserEventService will only join events with products from branch {newBranch}.
  * </ul>
  *
- * <p>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.
- *
  * <p>Sample code:
  *
  * <pre>{@code
@@ -590,6 +575,7 @@ public final void setDefaultBranch(SetDefaultBranchRequest request) {
  * .setBranchId(
  * BranchName.of("[PROJECT]", "[LOCATION]", "[CATALOG]", "[BRANCH]").toString())
  * .setNote("note3387378")
+ * .setForce(true)
  * .build();
  * ApiFuture<Empty> future = catalogServiceClient.setDefaultBranchCallable().futureCall(request);
  * // Do something.
@@ -607,10 +593,6 @@ public final UnaryCallable<SetDefaultBranchRequest, Empty> setDefaultBranchCalla
  * [CatalogService.SetDefaultBranch][google.cloud.retail.v2.CatalogService.SetDefaultBranch]
  * method under a specified parent catalog.
  *
- * <p>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.
- *
  * <p>Sample code:
  *
  * <pre>{@code
@@ -638,10 +620,6 @@ public final GetDefaultBranchResponse getDefaultBranch(CatalogName catalog) {
  * [CatalogService.SetDefaultBranch][google.cloud.retail.v2.CatalogService.SetDefaultBranch]
  * method under a specified parent catalog.
  *
- * <p>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.
- *
  * <p>Sample code:
  *
  * <pre>{@code
@@ -667,10 +645,6 @@ public final GetDefaultBranchResponse getDefaultBranch(String catalog) {
  * [CatalogService.SetDefaultBranch][google.cloud.retail.v2.CatalogService.SetDefaultBranch]
  * method under a specified parent catalog.
  *
- * <p>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.
- *
  * <p>Sample code:
  *
  * <pre>{@code
@@ -696,10 +670,6 @@ public final GetDefaultBranchResponse getDefaultBranch(GetDefaultBranchRequest r
  * [CatalogService.SetDefaultBranch][google.cloud.retail.v2.CatalogService.SetDefaultBranch]
  * method under a specified parent catalog.
  *
- * <p>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.
- *
  * <p>Sample code:
  *
  * <pre>{@code

google-cloud-retail/src/main/java/com/google/cloud/retail/v2/CompletionServiceClient.java

@@ -33,9 +33,8 @@
 /**
  * Service Description: Auto-completion service for retail.
  *
- * <p>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.
+ * <p>This feature is only available for users who have Retail Search enabled. Please enable Retail
+ * Search on Cloud Console before using this feature.
  *
  * <p>This class provides the ability to make remote calls to the backing service through method
  * calls that map to API methods. Sample code to get started:
@@ -173,9 +172,8 @@ public final OperationsClient getOperationsClient() {
  /**
  * Completes the specified prefix with keyword suggestions.
  *
- * <p>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.
+ * <p>This feature is only available for users who have Retail Search enabled. Please enable
+ * Retail Search on Cloud Console before using this feature.
  *
  * <p>Sample code:
  *
@@ -206,9 +204,8 @@ public final CompleteQueryResponse completeQuery(CompleteQueryRequest request) {
  /**
  * Completes the specified prefix with keyword suggestions.
  *
- * <p>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.
+ * <p>This feature is only available for users who have Retail Search enabled. Please enable
+ * Retail Search on Cloud Console before using this feature.
  *
  * <p>Sample code:
  *
@@ -239,11 +236,13 @@ public final UnaryCallable<CompleteQueryRequest, CompleteQueryResponse> complete
  /**
  * Bulk import of processed completion dataset.
  *
- * <p>Request processing may be synchronous. Partial updating is not supported.
+ * <p>Request processing is asynchronous. Partial updating is not supported.
  *
- * <p>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.
+ * <p>The operation is successfully finished only after the imported suggestions are indexed
+ * successfully and ready for serving. The process takes hours.
+ *
+ * <p>This feature is only available for users who have Retail Search enabled. Please enable
+ * Retail Search on Cloud Console before using this feature.
  *
  * <p>Sample code:
  *
@@ -272,11 +271,13 @@ public final UnaryCallable<CompleteQueryRequest, CompleteQueryResponse> complete
  /**
  * Bulk import of processed completion dataset.
  *
- * <p>Request processing may be synchronous. Partial updating is not supported.
+ * <p>Request processing is asynchronous. Partial updating is not supported.
+ *
+ * <p>The operation is successfully finished only after the imported suggestions are indexed
+ * successfully and ready for serving. The process takes hours.
  *
- * <p>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.
+ * <p>This feature is only available for users who have Retail Search enabled. Please enable
+ * Retail Search on Cloud Console before using this feature.
  *
  * <p>Sample code:
  *
@@ -305,11 +306,13 @@ public final UnaryCallable<CompleteQueryRequest, CompleteQueryResponse> complete
  /**
  * Bulk import of processed completion dataset.
  *
- * <p>Request processing may be synchronous. Partial updating is not supported.
+ * <p>Request processing is asynchronous. Partial updating is not supported.
+ *
+ * <p>The operation is successfully finished only after the imported suggestions are indexed
+ * successfully and ready for serving. The process takes hours.
  *
- * <p>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.
+ * <p>This feature is only available for users who have Retail Search enabled. Please enable
+ * Retail Search on Cloud Console before using this feature.
  *
  * <p>Sample code:
  *