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:
    *