feat: [retail] release Model Services to v2beta version (#8284)

- [ ] Regenerate this pull request now. feat: release BatchRemoveCatalogAttributes API to v2beta version feat: release ExactSearchableOption for attribute config to v2beta version feat: release diversity_type for ServingConfig in v2beta version feat: add local inventories info to the Product resource feat: deprecate unused page_token field of PredictionRequest in v2beta version feat: deprecate unused facet_spec field of Control in v2beta version docs: improve documentation of SearchRequest for Search Personalization docs: improve documentation for Fullfillment and Inventory API in ProductService docs: minor documentation fixes and improvements PiperOrigin-RevId: 471846764 Source-Link: googleapis/googleapis@1513294 Source-Link: https://github.com/googleapis/googleapis-gen/commit/c371ea8df2e34940875d51200cd57e300a2bc0a8 Copy-Tag: eyJwIjoiamF2YS1yZXRhaWwvLk93bEJvdC55YW1sIiwiaCI6ImMzNzFlYThkZjJlMzQ5NDA4NzVkNTEyMDBjZDU3ZTMwMGEyYmMwYTgifQ==
googleapis · Sep 6, 2022 · 5f742f9 · 5f742f9
1 parent 2832653
commit 5f742f9
Show file tree

Hide file tree

Showing 189 changed files with 32,713 additions and 1,635 deletions.
diff --git a/...oogle-cloud-retail/src/main/java/com/google/cloud/retail/v2beta/CatalogServiceClient.java b/...oogle-cloud-retail/src/main/java/com/google/cloud/retail/v2beta/CatalogServiceClient.java
@@ -756,7 +756,7 @@ public final GetDefaultBranchResponse getDefaultBranch(GetDefaultBranchRequest r
    * }</pre>
    *
    * @param name Required. Full CompletionConfig resource name. Format:
-   *     projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/completionConfig
+   *     `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/completionConfig`
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   public final CompletionConfig getCompletionConfig(CompletionConfigName name) {
@@ -783,7 +783,7 @@ public final CompletionConfig getCompletionConfig(CompletionConfigName name) {
    * }</pre>
    *
    * @param name Required. Full CompletionConfig resource name. Format:
-   *     projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/completionConfig
+   *     `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/completionConfig`
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   public final CompletionConfig getCompletionConfig(String name) {
@@ -1280,6 +1280,66 @@ public final AttributesConfig removeCatalogAttribute(RemoveCatalogAttributeReque
     return stub.removeCatalogAttributeCallable();
   }
 
+  // AUTO-GENERATED DOCUMENTATION AND METHOD.
+  /**
+   * Removes all specified [CatalogAttribute][google.cloud.retail.v2beta.CatalogAttribute]s from the
+   * [AttributesConfig][google.cloud.retail.v2beta.AttributesConfig].
+   *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * // This snippet has been automatically generated for illustrative purposes only.
+   * // It may require modifications to work in your environment.
+   * try (CatalogServiceClient catalogServiceClient = CatalogServiceClient.create()) {
+   *   BatchRemoveCatalogAttributesRequest request =
+   *       BatchRemoveCatalogAttributesRequest.newBuilder()
+   *           .setAttributesConfig(
+   *               AttributesConfigName.of("[PROJECT]", "[LOCATION]", "[CATALOG]").toString())
+   *           .addAllAttributeKeys(new ArrayList<String>())
+   *           .build();
+   *   BatchRemoveCatalogAttributesResponse response =
+   *       catalogServiceClient.batchRemoveCatalogAttributes(request);
+   * }
+   * }</pre>
+   *
+   * @param request The request object containing all of the parameters for the API call.
+   * @throws com.google.api.gax.rpc.ApiException if the remote call fails
+   */
+  public final BatchRemoveCatalogAttributesResponse batchRemoveCatalogAttributes(
+      BatchRemoveCatalogAttributesRequest request) {
+    return batchRemoveCatalogAttributesCallable().call(request);
+  }
+
+  // AUTO-GENERATED DOCUMENTATION AND METHOD.
+  /**
+   * Removes all specified [CatalogAttribute][google.cloud.retail.v2beta.CatalogAttribute]s from the
+   * [AttributesConfig][google.cloud.retail.v2beta.AttributesConfig].
+   *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * // This snippet has been automatically generated for illustrative purposes only.
+   * // It may require modifications to work in your environment.
+   * try (CatalogServiceClient catalogServiceClient = CatalogServiceClient.create()) {
+   *   BatchRemoveCatalogAttributesRequest request =
+   *       BatchRemoveCatalogAttributesRequest.newBuilder()
+   *           .setAttributesConfig(
+   *               AttributesConfigName.of("[PROJECT]", "[LOCATION]", "[CATALOG]").toString())
+   *           .addAllAttributeKeys(new ArrayList<String>())
+   *           .build();
+   *   ApiFuture<BatchRemoveCatalogAttributesResponse> future =
+   *       catalogServiceClient.batchRemoveCatalogAttributesCallable().futureCall(request);
+   *   // Do something.
+   *   BatchRemoveCatalogAttributesResponse response = future.get();
+   * }
+   * }</pre>
+   */
+  public final UnaryCallable<
+          BatchRemoveCatalogAttributesRequest, BatchRemoveCatalogAttributesResponse>
+      batchRemoveCatalogAttributesCallable() {
+    return stub.batchRemoveCatalogAttributesCallable();
+  }
+
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
    * Replaces the specified [CatalogAttribute][google.cloud.retail.v2beta.CatalogAttribute] in the

diff --git a/...gle-cloud-retail/src/main/java/com/google/cloud/retail/v2beta/CatalogServiceSettings.java b/...gle-cloud-retail/src/main/java/com/google/cloud/retail/v2beta/CatalogServiceSettings.java
@@ -132,6 +132,13 @@ public UnaryCallSettings<SetDefaultBranchRequest, Empty> setDefaultBranchSetting
     return ((CatalogServiceStubSettings) getStubSettings()).removeCatalogAttributeSettings();
   }
 
+  /** Returns the object with the settings used for calls to batchRemoveCatalogAttributes. */
+  public UnaryCallSettings<
+          BatchRemoveCatalogAttributesRequest, BatchRemoveCatalogAttributesResponse>
+      batchRemoveCatalogAttributesSettings() {
+    return ((CatalogServiceStubSettings) getStubSettings()).batchRemoveCatalogAttributesSettings();
+  }
+
   /** Returns the object with the settings used for calls to replaceCatalogAttribute. */
   public UnaryCallSettings<ReplaceCatalogAttributeRequest, AttributesConfig>
       replaceCatalogAttributeSettings() {
@@ -312,6 +319,13 @@ public UnaryCallSettings.Builder<SetDefaultBranchRequest, Empty> setDefaultBranc
       return getStubSettingsBuilder().removeCatalogAttributeSettings();
     }
 
+    /** Returns the builder for the settings used for calls to batchRemoveCatalogAttributes. */
+    public UnaryCallSettings.Builder<
+            BatchRemoveCatalogAttributesRequest, BatchRemoveCatalogAttributesResponse>
+        batchRemoveCatalogAttributesSettings() {
+      return getStubSettingsBuilder().batchRemoveCatalogAttributesSettings();
+    }
+
     /** Returns the builder for the settings used for calls to replaceCatalogAttribute. */
     public UnaryCallSettings.Builder<ReplaceCatalogAttributeRequest, AttributesConfig>
         replaceCatalogAttributeSettings() {

diff --git a/...le-cloud-retail/src/main/java/com/google/cloud/retail/v2beta/CompletionServiceClient.java b/...le-cloud-retail/src/main/java/com/google/cloud/retail/v2beta/CompletionServiceClient.java
@@ -33,8 +33,8 @@
 /**
  * Service Description: Auto-completion service for retail.
  *
- * <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 feature is only available for users who have Retail Search enabled. 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:
@@ -205,8 +205,8 @@ public final OperationsClient getHttpJsonOperationsClient() {
   /**
    * Completes the specified prefix with keyword suggestions.
    *
-   * <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 feature is only available for users who have Retail Search enabled. Enable Retail
+   * Search on Cloud Console before using this feature.
    *
    * <p>Sample code:
    *
@@ -239,8 +239,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 enable
-   * Retail Search on Cloud Console before using this feature.
+   * <p>This feature is only available for users who have Retail Search enabled. Enable Retail
+   * Search on Cloud Console before using this feature.
    *
    * <p>Sample code:
    *
@@ -278,8 +278,8 @@ public final UnaryCallable<CompleteQueryRequest, CompleteQueryResponse> complete
    * <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>This feature is only available for users who have Retail Search enabled. Enable Retail
+   * Search on Cloud Console before using this feature.
    *
    * <p>Sample code:
    *
@@ -315,8 +315,8 @@ public final UnaryCallable<CompleteQueryRequest, CompleteQueryResponse> complete
    * <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>This feature is only available for users who have Retail Search enabled. Enable Retail
+   * Search on Cloud Console before using this feature.
    *
    * <p>Sample code:
    *
@@ -352,8 +352,8 @@ public final UnaryCallable<CompleteQueryRequest, CompleteQueryResponse> complete
    * <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>This feature is only available for users who have Retail Search enabled. Enable Retail
+   * Search on Cloud Console before using this feature.
    *
    * <p>Sample code:
    *

diff --git a/...oogle-cloud-retail/src/main/java/com/google/cloud/retail/v2beta/ControlServiceClient.java b/...oogle-cloud-retail/src/main/java/com/google/cloud/retail/v2beta/ControlServiceClient.java
@@ -421,7 +421,7 @@ public final UnaryCallable<DeleteControlRequest, Empty> deleteControlCallable()
    *
    * <p>[Control][google.cloud.retail.v2beta.Control] cannot be set to a different oneof field, if
    * so an INVALID_ARGUMENT is returned. If the [Control][google.cloud.retail.v2beta.Control] to
-   * delete does not exist, a NOT_FOUND error is returned.
+   * update does not exist, a NOT_FOUND error is returned.
    *
    * <p>Sample code:
    *
@@ -456,7 +456,7 @@ public final Control updateControl(Control control, FieldMask updateMask) {
    *
    * <p>[Control][google.cloud.retail.v2beta.Control] cannot be set to a different oneof field, if
    * so an INVALID_ARGUMENT is returned. If the [Control][google.cloud.retail.v2beta.Control] to
-   * delete does not exist, a NOT_FOUND error is returned.
+   * update does not exist, a NOT_FOUND error is returned.
    *
    * <p>Sample code:
    *
@@ -486,7 +486,7 @@ public final Control updateControl(UpdateControlRequest request) {
    *
    * <p>[Control][google.cloud.retail.v2beta.Control] cannot be set to a different oneof field, if
    * so an INVALID_ARGUMENT is returned. If the [Control][google.cloud.retail.v2beta.Control] to
-   * delete does not exist, a NOT_FOUND error is returned.
+   * update does not exist, a NOT_FOUND error is returned.
    *
    * <p>Sample code:
    *
@@ -524,7 +524,7 @@ public final UnaryCallable<UpdateControlRequest, Control> updateControlCallable(
    * }
    * }</pre>
    *
-   * @param name Required. The resource name of the Control to delete. Format:
+   * @param name Required. The resource name of the Control to get. Format:
    *     `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/controls/{control_id}`
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
@@ -549,7 +549,7 @@ public final Control getControl(ControlName name) {
    * }
    * }</pre>
    *
-   * @param name Required. The resource name of the Control to delete. Format:
+   * @param name Required. The resource name of the Control to get. Format:
    *     `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/controls/{control_id}`
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
@@ -611,7 +611,7 @@ public final UnaryCallable<GetControlRequest, Control> getControlCallable() {
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Lists all Controls linked to this catalog.
+   * Lists all Controls by their parent [Catalog][google.cloud.retail.v2beta.Catalog].
    *
    * <p>Sample code:
    *
@@ -640,7 +640,7 @@ public final ListControlsPagedResponse listControls(CatalogName parent) {
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Lists all Controls linked to this catalog.
+   * Lists all Controls by their parent [Catalog][google.cloud.retail.v2beta.Catalog].
    *
    * <p>Sample code:
    *
@@ -666,7 +666,7 @@ public final ListControlsPagedResponse listControls(String parent) {
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Lists all Controls linked to this catalog.
+   * Lists all Controls by their parent [Catalog][google.cloud.retail.v2beta.Catalog].
    *
    * <p>Sample code:
    *
@@ -696,7 +696,7 @@ public final ListControlsPagedResponse listControls(ListControlsRequest request)
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Lists all Controls linked to this catalog.
+   * Lists all Controls by their parent [Catalog][google.cloud.retail.v2beta.Catalog].
    *
    * <p>Sample code:
    *
@@ -727,7 +727,7 @@ public final ListControlsPagedResponse listControls(ListControlsRequest request)
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Lists all Controls linked to this catalog.
+   * Lists all Controls by their parent [Catalog][google.cloud.retail.v2beta.Catalog].
    *
    * <p>Sample code:
    *