diff --git a/java-retail/README.md b/java-retail/README.md index 9a559a01cdd8..9e6c0d938528 100644 --- a/java-retail/README.md +++ b/java-retail/README.md @@ -19,20 +19,20 @@ If you are using Maven, add this to your pom.xml file: com.google.cloud google-cloud-retail - 2.8.0 + 2.9.0 ``` If you are using Gradle without BOM, add this to your dependencies: ```Groovy -implementation 'com.google.cloud:google-cloud-retail:2.8.0' +implementation 'com.google.cloud:google-cloud-retail:2.9.0' ``` If you are using SBT, add this to your dependencies: ```Scala -libraryDependencies += "com.google.cloud" % "google-cloud-retail" % "2.8.0" +libraryDependencies += "com.google.cloud" % "google-cloud-retail" % "2.9.0" ``` ## Authentication diff --git a/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2/CatalogServiceClient.java b/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2/CatalogServiceClient.java index 8c263086b0c3..f0c1fc66dede 100644 --- a/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2/CatalogServiceClient.java +++ b/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2/CatalogServiceClient.java @@ -814,7 +814,7 @@ public final GetDefaultBranchResponse getDefaultBranch(GetDefaultBranchRequest r * } * * @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) { @@ -844,7 +844,7 @@ public final CompletionConfig getCompletionConfig(CompletionConfigName name) { * } * * @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) { diff --git a/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2/CompletionServiceClient.java b/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2/CompletionServiceClient.java index c208e0ecbdd5..a5871d5b5dd6 100644 --- a/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2/CompletionServiceClient.java +++ b/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2/CompletionServiceClient.java @@ -33,8 +33,8 @@ /** * Service Description: Auto-completion service for retail. * - *

This feature is only available for users who have Retail Search enabled. Please enable Retail - * Search on Cloud Console before using this feature. + *

This feature is only available for users who have Retail Search enabled. Enable Retail Search + * on Cloud Console before using this feature. * *

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: @@ -213,8 +213,8 @@ public final OperationsClient getHttpJsonOperationsClient() { /** * Completes the specified prefix with keyword suggestions. * - *

This feature is only available for users who have Retail Search enabled. Please enable - * Retail Search on Cloud Console before using this feature. + *

This feature is only available for users who have Retail Search enabled. Enable Retail + * Search on Cloud Console before using this feature. * *

Sample code: * @@ -250,8 +250,8 @@ public final CompleteQueryResponse completeQuery(CompleteQueryRequest request) { /** * Completes the specified prefix with keyword suggestions. * - *

This feature is only available for users who have Retail Search enabled. Please enable - * Retail Search on Cloud Console before using this feature. + *

This feature is only available for users who have Retail Search enabled. Enable Retail + * Search on Cloud Console before using this feature. * *

Sample code: * @@ -292,8 +292,8 @@ public final UnaryCallable complete *

The operation is successfully finished only after the imported suggestions are indexed * successfully and ready for serving. The process takes hours. * - *

This feature is only available for users who have Retail Search enabled. Please enable - * Retail Search on Cloud Console before using this feature. + *

This feature is only available for users who have Retail Search enabled. Enable Retail + * Search on Cloud Console before using this feature. * *

Sample code: * @@ -332,8 +332,8 @@ public final UnaryCallable complete *

The operation is successfully finished only after the imported suggestions are indexed * successfully and ready for serving. The process takes hours. * - *

This feature is only available for users who have Retail Search enabled. Please enable - * Retail Search on Cloud Console before using this feature. + *

This feature is only available for users who have Retail Search enabled. Enable Retail + * Search on Cloud Console before using this feature. * *

Sample code: * @@ -372,8 +372,8 @@ public final UnaryCallable complete *

The operation is successfully finished only after the imported suggestions are indexed * successfully and ready for serving. The process takes hours. * - *

This feature is only available for users who have Retail Search enabled. Please enable - * Retail Search on Cloud Console before using this feature. + *

This feature is only available for users who have Retail Search enabled. Enable Retail + * Search on Cloud Console before using this feature. * *

Sample code: * diff --git a/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2/ProductServiceClient.java b/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2/ProductServiceClient.java index e0ede2623e28..9dddc3640088 100644 --- a/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2/ProductServiceClient.java +++ b/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2/ProductServiceClient.java @@ -1039,8 +1039,8 @@ public final UnaryCallable importProductsCalla * *

This process is asynchronous and does not require the * [Product][google.cloud.retail.v2.Product] to exist before updating fulfillment information. If - * the request is valid, the update will be enqueued and processed downstream. As a consequence, - * when a response is returned, updates are not immediately manifested in the + * the request is valid, the update is enqueued and processed downstream. As a consequence, when a + * response is returned, updates are not immediately manifested in the * [Product][google.cloud.retail.v2.Product] queried by * [ProductService.GetProduct][google.cloud.retail.v2.ProductService.GetProduct] or * [ProductService.ListProducts][google.cloud.retail.v2.ProductService.ListProducts]. @@ -1048,19 +1048,19 @@ public final UnaryCallable importProductsCalla *

When inventory is updated with * [ProductService.CreateProduct][google.cloud.retail.v2.ProductService.CreateProduct] and * [ProductService.UpdateProduct][google.cloud.retail.v2.ProductService.UpdateProduct], the - * specified inventory field value(s) will overwrite any existing value(s) while ignoring the last - * update time for this field. Furthermore, the last update time for the specified inventory - * fields will be overwritten to the time of the + * specified inventory field value(s) overwrite any existing value(s) while ignoring the last + * update time for this field. Furthermore, the last update times for the specified inventory + * fields are overwritten by the times of the * [ProductService.CreateProduct][google.cloud.retail.v2.ProductService.CreateProduct] or * [ProductService.UpdateProduct][google.cloud.retail.v2.ProductService.UpdateProduct] request. * *

If no inventory fields are set in * [CreateProductRequest.product][google.cloud.retail.v2.CreateProductRequest.product], then any - * pre-existing inventory information for this product will be used. + * pre-existing inventory information for this product is used. * *

If no inventory fields are set in * [SetInventoryRequest.set_mask][google.cloud.retail.v2.SetInventoryRequest.set_mask], then any - * existing inventory information will be preserved. + * existing inventory information is preserved. * *

Pre-existing inventory information can only be updated with * [ProductService.SetInventory][google.cloud.retail.v2.ProductService.SetInventory], @@ -1068,14 +1068,15 @@ public final UnaryCallable importProductsCalla * and * [ProductService.RemoveFulfillmentPlaces][google.cloud.retail.v2.ProductService.RemoveFulfillmentPlaces]. * - *

The returned [Operation][]s will be obsolete after 1 day, and [GetOperation][] API will - * return NOT_FOUND afterwards. + *

The returned [Operation][google.longrunning.Operation]s is obsolete after one day, and the + * [GetOperation][google.longrunning.Operations.GetOperation] API returns `NOT_FOUND` afterwards. * - *

If conflicting updates are issued, the [Operation][]s associated with the stale updates will - * not be marked as [done][Operation.done] until being obsolete. + *

If conflicting updates are issued, the [Operation][google.longrunning.Operation]s associated + * with the stale updates are not marked as [done][google.longrunning.Operation.done] until they + * are obsolete. * - *

This feature is only available for users who have Retail Search enabled. Please enable - * Retail Search on Cloud Console before using this feature. + *

This feature is only available for users who have Retail Search enabled. Enable Retail + * Search on Cloud Console before using this feature. * *

Sample code: * @@ -1164,8 +1165,8 @@ public final OperationFuture setInve * *

This process is asynchronous and does not require the * [Product][google.cloud.retail.v2.Product] to exist before updating fulfillment information. If - * the request is valid, the update will be enqueued and processed downstream. As a consequence, - * when a response is returned, updates are not immediately manifested in the + * the request is valid, the update is enqueued and processed downstream. As a consequence, when a + * response is returned, updates are not immediately manifested in the * [Product][google.cloud.retail.v2.Product] queried by * [ProductService.GetProduct][google.cloud.retail.v2.ProductService.GetProduct] or * [ProductService.ListProducts][google.cloud.retail.v2.ProductService.ListProducts]. @@ -1173,19 +1174,19 @@ public final OperationFuture setInve *

When inventory is updated with * [ProductService.CreateProduct][google.cloud.retail.v2.ProductService.CreateProduct] and * [ProductService.UpdateProduct][google.cloud.retail.v2.ProductService.UpdateProduct], the - * specified inventory field value(s) will overwrite any existing value(s) while ignoring the last - * update time for this field. Furthermore, the last update time for the specified inventory - * fields will be overwritten to the time of the + * specified inventory field value(s) overwrite any existing value(s) while ignoring the last + * update time for this field. Furthermore, the last update times for the specified inventory + * fields are overwritten by the times of the * [ProductService.CreateProduct][google.cloud.retail.v2.ProductService.CreateProduct] or * [ProductService.UpdateProduct][google.cloud.retail.v2.ProductService.UpdateProduct] request. * *

If no inventory fields are set in * [CreateProductRequest.product][google.cloud.retail.v2.CreateProductRequest.product], then any - * pre-existing inventory information for this product will be used. + * pre-existing inventory information for this product is used. * *

If no inventory fields are set in * [SetInventoryRequest.set_mask][google.cloud.retail.v2.SetInventoryRequest.set_mask], then any - * existing inventory information will be preserved. + * existing inventory information is preserved. * *

Pre-existing inventory information can only be updated with * [ProductService.SetInventory][google.cloud.retail.v2.ProductService.SetInventory], @@ -1193,14 +1194,15 @@ public final OperationFuture setInve * and * [ProductService.RemoveFulfillmentPlaces][google.cloud.retail.v2.ProductService.RemoveFulfillmentPlaces]. * - *

The returned [Operation][]s will be obsolete after 1 day, and [GetOperation][] API will - * return NOT_FOUND afterwards. + *

The returned [Operation][google.longrunning.Operation]s is obsolete after one day, and the + * [GetOperation][google.longrunning.Operations.GetOperation] API returns `NOT_FOUND` afterwards. * - *

If conflicting updates are issued, the [Operation][]s associated with the stale updates will - * not be marked as [done][Operation.done] until being obsolete. + *

If conflicting updates are issued, the [Operation][google.longrunning.Operation]s associated + * with the stale updates are not marked as [done][google.longrunning.Operation.done] until they + * are obsolete. * - *

This feature is only available for users who have Retail Search enabled. Please enable - * Retail Search on Cloud Console before using this feature. + *

This feature is only available for users who have Retail Search enabled. Enable Retail + * Search on Cloud Console before using this feature. * *

Sample code: * @@ -1237,8 +1239,8 @@ public final OperationFuture setInve * *

This process is asynchronous and does not require the * [Product][google.cloud.retail.v2.Product] to exist before updating fulfillment information. If - * the request is valid, the update will be enqueued and processed downstream. As a consequence, - * when a response is returned, updates are not immediately manifested in the + * the request is valid, the update is enqueued and processed downstream. As a consequence, when a + * response is returned, updates are not immediately manifested in the * [Product][google.cloud.retail.v2.Product] queried by * [ProductService.GetProduct][google.cloud.retail.v2.ProductService.GetProduct] or * [ProductService.ListProducts][google.cloud.retail.v2.ProductService.ListProducts]. @@ -1246,19 +1248,19 @@ public final OperationFuture setInve *

When inventory is updated with * [ProductService.CreateProduct][google.cloud.retail.v2.ProductService.CreateProduct] and * [ProductService.UpdateProduct][google.cloud.retail.v2.ProductService.UpdateProduct], the - * specified inventory field value(s) will overwrite any existing value(s) while ignoring the last - * update time for this field. Furthermore, the last update time for the specified inventory - * fields will be overwritten to the time of the + * specified inventory field value(s) overwrite any existing value(s) while ignoring the last + * update time for this field. Furthermore, the last update times for the specified inventory + * fields are overwritten by the times of the * [ProductService.CreateProduct][google.cloud.retail.v2.ProductService.CreateProduct] or * [ProductService.UpdateProduct][google.cloud.retail.v2.ProductService.UpdateProduct] request. * *

If no inventory fields are set in * [CreateProductRequest.product][google.cloud.retail.v2.CreateProductRequest.product], then any - * pre-existing inventory information for this product will be used. + * pre-existing inventory information for this product is used. * *

If no inventory fields are set in * [SetInventoryRequest.set_mask][google.cloud.retail.v2.SetInventoryRequest.set_mask], then any - * existing inventory information will be preserved. + * existing inventory information is preserved. * *

Pre-existing inventory information can only be updated with * [ProductService.SetInventory][google.cloud.retail.v2.ProductService.SetInventory], @@ -1266,14 +1268,15 @@ public final OperationFuture setInve * and * [ProductService.RemoveFulfillmentPlaces][google.cloud.retail.v2.ProductService.RemoveFulfillmentPlaces]. * - *

The returned [Operation][]s will be obsolete after 1 day, and [GetOperation][] API will - * return NOT_FOUND afterwards. + *

The returned [Operation][google.longrunning.Operation]s is obsolete after one day, and the + * [GetOperation][google.longrunning.Operations.GetOperation] API returns `NOT_FOUND` afterwards. * - *

If conflicting updates are issued, the [Operation][]s associated with the stale updates will - * not be marked as [done][Operation.done] until being obsolete. + *

If conflicting updates are issued, the [Operation][google.longrunning.Operation]s associated + * with the stale updates are not marked as [done][google.longrunning.Operation.done] until they + * are obsolete. * - *

This feature is only available for users who have Retail Search enabled. Please enable - * Retail Search on Cloud Console before using this feature. + *

This feature is only available for users who have Retail Search enabled. Enable Retail + * Search on Cloud Console before using this feature. * *

Sample code: * @@ -1310,8 +1313,8 @@ public final OperationFuture setInve * *

This process is asynchronous and does not require the * [Product][google.cloud.retail.v2.Product] to exist before updating fulfillment information. If - * the request is valid, the update will be enqueued and processed downstream. As a consequence, - * when a response is returned, updates are not immediately manifested in the + * the request is valid, the update is enqueued and processed downstream. As a consequence, when a + * response is returned, updates are not immediately manifested in the * [Product][google.cloud.retail.v2.Product] queried by * [ProductService.GetProduct][google.cloud.retail.v2.ProductService.GetProduct] or * [ProductService.ListProducts][google.cloud.retail.v2.ProductService.ListProducts]. @@ -1319,19 +1322,19 @@ public final OperationFuture setInve *

When inventory is updated with * [ProductService.CreateProduct][google.cloud.retail.v2.ProductService.CreateProduct] and * [ProductService.UpdateProduct][google.cloud.retail.v2.ProductService.UpdateProduct], the - * specified inventory field value(s) will overwrite any existing value(s) while ignoring the last - * update time for this field. Furthermore, the last update time for the specified inventory - * fields will be overwritten to the time of the + * specified inventory field value(s) overwrite any existing value(s) while ignoring the last + * update time for this field. Furthermore, the last update times for the specified inventory + * fields are overwritten by the times of the * [ProductService.CreateProduct][google.cloud.retail.v2.ProductService.CreateProduct] or * [ProductService.UpdateProduct][google.cloud.retail.v2.ProductService.UpdateProduct] request. * *

If no inventory fields are set in * [CreateProductRequest.product][google.cloud.retail.v2.CreateProductRequest.product], then any - * pre-existing inventory information for this product will be used. + * pre-existing inventory information for this product is used. * *

If no inventory fields are set in * [SetInventoryRequest.set_mask][google.cloud.retail.v2.SetInventoryRequest.set_mask], then any - * existing inventory information will be preserved. + * existing inventory information is preserved. * *

Pre-existing inventory information can only be updated with * [ProductService.SetInventory][google.cloud.retail.v2.ProductService.SetInventory], @@ -1339,14 +1342,15 @@ public final OperationFuture setInve * and * [ProductService.RemoveFulfillmentPlaces][google.cloud.retail.v2.ProductService.RemoveFulfillmentPlaces]. * - *

The returned [Operation][]s will be obsolete after 1 day, and [GetOperation][] API will - * return NOT_FOUND afterwards. + *

The returned [Operation][google.longrunning.Operation]s is obsolete after one day, and the + * [GetOperation][google.longrunning.Operations.GetOperation] API returns `NOT_FOUND` afterwards. * - *

If conflicting updates are issued, the [Operation][]s associated with the stale updates will - * not be marked as [done][Operation.done] until being obsolete. + *

If conflicting updates are issued, the [Operation][google.longrunning.Operation]s associated + * with the stale updates are not marked as [done][google.longrunning.Operation.done] until they + * are obsolete. * - *

This feature is only available for users who have Retail Search enabled. Please enable - * Retail Search on Cloud Console before using this feature. + *

This feature is only available for users who have Retail Search enabled. Enable Retail + * Search on Cloud Console before using this feature. * *

Sample code: * @@ -1387,14 +1391,16 @@ public final UnaryCallable setInventoryCallable( * [ProductService.GetProduct][google.cloud.retail.v2.ProductService.GetProduct] or * [ProductService.ListProducts][google.cloud.retail.v2.ProductService.ListProducts]. * - *

The returned [Operation][]s will be obsolete after 1 day, and [GetOperation][] API will - * return NOT_FOUND afterwards. + *

The returned [Operation][google.longrunning.Operation]s will be obsolete after 1 day, and + * [GetOperation][google.longrunning.Operations.GetOperation] API will return NOT_FOUND + * afterwards. * - *

If conflicting updates are issued, the [Operation][]s associated with the stale updates will - * not be marked as [done][Operation.done] until being obsolete. + *

If conflicting updates are issued, the [Operation][google.longrunning.Operation]s associated + * with the stale updates will not be marked as [done][google.longrunning.Operation.done] until + * being obsolete. * - *

This feature is only available for users who have Retail Search enabled. Please enable - * Retail Search on Cloud Console before using this feature. + *

This feature is only available for users who have Retail Search enabled. Enable Retail + * Search on Cloud Console before using this feature. * *

Sample code: * @@ -1442,14 +1448,16 @@ public final UnaryCallable setInventoryCallable( * [ProductService.GetProduct][google.cloud.retail.v2.ProductService.GetProduct] or * [ProductService.ListProducts][google.cloud.retail.v2.ProductService.ListProducts]. * - *

The returned [Operation][]s will be obsolete after 1 day, and [GetOperation][] API will - * return NOT_FOUND afterwards. + *

The returned [Operation][google.longrunning.Operation]s will be obsolete after 1 day, and + * [GetOperation][google.longrunning.Operations.GetOperation] API will return NOT_FOUND + * afterwards. * - *

If conflicting updates are issued, the [Operation][]s associated with the stale updates will - * not be marked as [done][Operation.done] until being obsolete. + *

If conflicting updates are issued, the [Operation][google.longrunning.Operation]s associated + * with the stale updates will not be marked as [done][google.longrunning.Operation.done] until + * being obsolete. * - *

This feature is only available for users who have Retail Search enabled. Please enable - * Retail Search on Cloud Console before using this feature. + *

This feature is only available for users who have Retail Search enabled. Enable Retail + * Search on Cloud Console before using this feature. * *

Sample code: * @@ -1496,14 +1504,16 @@ public final UnaryCallable setInventoryCallable( * [ProductService.GetProduct][google.cloud.retail.v2.ProductService.GetProduct] or * [ProductService.ListProducts][google.cloud.retail.v2.ProductService.ListProducts]. * - *

The returned [Operation][]s will be obsolete after 1 day, and [GetOperation][] API will - * return NOT_FOUND afterwards. + *

The returned [Operation][google.longrunning.Operation]s will be obsolete after 1 day, and + * [GetOperation][google.longrunning.Operations.GetOperation] API will return NOT_FOUND + * afterwards. * - *

If conflicting updates are issued, the [Operation][]s associated with the stale updates will - * not be marked as [done][Operation.done] until being obsolete. + *

If conflicting updates are issued, the [Operation][google.longrunning.Operation]s associated + * with the stale updates will not be marked as [done][google.longrunning.Operation.done] until + * being obsolete. * - *

This feature is only available for users who have Retail Search enabled. Please enable - * Retail Search on Cloud Console before using this feature. + *

This feature is only available for users who have Retail Search enabled. Enable Retail + * Search on Cloud Console before using this feature. * *

Sample code: * @@ -1550,14 +1560,16 @@ public final UnaryCallable setInventoryCallable( * [ProductService.GetProduct][google.cloud.retail.v2.ProductService.GetProduct] or * [ProductService.ListProducts][google.cloud.retail.v2.ProductService.ListProducts]. * - *

The returned [Operation][]s will be obsolete after 1 day, and [GetOperation][] API will - * return NOT_FOUND afterwards. + *

The returned [Operation][google.longrunning.Operation]s will be obsolete after 1 day, and + * [GetOperation][google.longrunning.Operations.GetOperation] API will return NOT_FOUND + * afterwards. * - *

If conflicting updates are issued, the [Operation][]s associated with the stale updates will - * not be marked as [done][Operation.done] until being obsolete. + *

If conflicting updates are issued, the [Operation][google.longrunning.Operation]s associated + * with the stale updates will not be marked as [done][google.longrunning.Operation.done] until + * being obsolete. * - *

This feature is only available for users who have Retail Search enabled. Please enable - * Retail Search on Cloud Console before using this feature. + *

This feature is only available for users who have Retail Search enabled. Enable Retail + * Search on Cloud Console before using this feature. * *

Sample code: * @@ -1604,14 +1616,16 @@ public final UnaryCallable setInventoryCallable( * [ProductService.GetProduct][google.cloud.retail.v2.ProductService.GetProduct] or * [ProductService.ListProducts][google.cloud.retail.v2.ProductService.ListProducts]. * - *

The returned [Operation][]s will be obsolete after 1 day, and [GetOperation][] API will - * return NOT_FOUND afterwards. + *

The returned [Operation][google.longrunning.Operation]s will be obsolete after 1 day, and + * [GetOperation][google.longrunning.Operations.GetOperation] API will return NOT_FOUND + * afterwards. * - *

If conflicting updates are issued, the [Operation][]s associated with the stale updates will - * not be marked as [done][Operation.done] until being obsolete. + *

If conflicting updates are issued, the [Operation][google.longrunning.Operation]s associated + * with the stale updates will not be marked as [done][google.longrunning.Operation.done] until + * being obsolete. * - *

This feature is only available for users who have Retail Search enabled. Please enable - * Retail Search on Cloud Console before using this feature. + *

This feature is only available for users who have Retail Search enabled. Enable Retail + * Search on Cloud Console before using this feature. * *

Sample code: * @@ -1657,14 +1671,16 @@ public final UnaryCallable setInventoryCallable( * [ProductService.GetProduct][google.cloud.retail.v2.ProductService.GetProduct] or * [ProductService.ListProducts][google.cloud.retail.v2.ProductService.ListProducts]. * - *

The returned [Operation][]s will be obsolete after 1 day, and [GetOperation][] API will - * return NOT_FOUND afterwards. + *

The returned [Operation][google.longrunning.Operation]s will be obsolete after 1 day, and + * [GetOperation][google.longrunning.Operations.GetOperation] API will return NOT_FOUND + * afterwards. * - *

If conflicting updates are issued, the [Operation][]s associated with the stale updates will - * not be marked as [done][Operation.done] until being obsolete. + *

If conflicting updates are issued, the [Operation][google.longrunning.Operation]s associated + * with the stale updates will not be marked as [done][google.longrunning.Operation.done] until + * being obsolete. * - *

This feature is only available for users who have Retail Search enabled. Please enable - * Retail Search on Cloud Console before using this feature. + *

This feature is only available for users who have Retail Search enabled. Enable Retail + * Search on Cloud Console before using this feature. * *

Sample code: * @@ -1712,14 +1728,16 @@ public final UnaryCallable setInventoryCallable( * [ProductService.GetProduct][google.cloud.retail.v2.ProductService.GetProduct] or * [ProductService.ListProducts][google.cloud.retail.v2.ProductService.ListProducts]. * - *

The returned [Operation][]s will be obsolete after 1 day, and [GetOperation][] API will - * return NOT_FOUND afterwards. + *

The returned [Operation][google.longrunning.Operation]s will be obsolete after 1 day, and + * [GetOperation][google.longrunning.Operations.GetOperation] API will return NOT_FOUND + * afterwards. * - *

If conflicting updates are issued, the [Operation][]s associated with the stale updates will - * not be marked as [done][Operation.done] until being obsolete. + *

If conflicting updates are issued, the [Operation][google.longrunning.Operation]s associated + * with the stale updates will not be marked as [done][google.longrunning.Operation.done] until + * being obsolete. * - *

This feature is only available for users who have Retail Search enabled. Please enable - * Retail Search on Cloud Console before using this feature. + *

This feature is only available for users who have Retail Search enabled. Enable Retail + * Search on Cloud Console before using this feature. * *

Sample code: * @@ -1766,14 +1784,16 @@ public final UnaryCallable setInventoryCallable( * [ProductService.GetProduct][google.cloud.retail.v2.ProductService.GetProduct] or * [ProductService.ListProducts][google.cloud.retail.v2.ProductService.ListProducts]. * - *

The returned [Operation][]s will be obsolete after 1 day, and [GetOperation][] API will - * return NOT_FOUND afterwards. + *

The returned [Operation][google.longrunning.Operation]s will be obsolete after 1 day, and + * [GetOperation][google.longrunning.Operations.GetOperation] API will return NOT_FOUND + * afterwards. * - *

If conflicting updates are issued, the [Operation][]s associated with the stale updates will - * not be marked as [done][Operation.done] until being obsolete. + *

If conflicting updates are issued, the [Operation][google.longrunning.Operation]s associated + * with the stale updates will not be marked as [done][google.longrunning.Operation.done] until + * being obsolete. * - *

This feature is only available for users who have Retail Search enabled. Please enable - * Retail Search on Cloud Console before using this feature. + *

This feature is only available for users who have Retail Search enabled. Enable Retail + * Search on Cloud Console before using this feature. * *

Sample code: * @@ -1820,14 +1840,16 @@ public final UnaryCallable setInventoryCallable( * [ProductService.GetProduct][google.cloud.retail.v2.ProductService.GetProduct] or * [ProductService.ListProducts][google.cloud.retail.v2.ProductService.ListProducts]. * - *

The returned [Operation][]s will be obsolete after 1 day, and [GetOperation][] API will - * return NOT_FOUND afterwards. + *

The returned [Operation][google.longrunning.Operation]s will be obsolete after 1 day, and + * [GetOperation][google.longrunning.Operations.GetOperation] API will return NOT_FOUND + * afterwards. * - *

If conflicting updates are issued, the [Operation][]s associated with the stale updates will - * not be marked as [done][Operation.done] until being obsolete. + *

If conflicting updates are issued, the [Operation][google.longrunning.Operation]s associated + * with the stale updates will not be marked as [done][google.longrunning.Operation.done] until + * being obsolete. * - *

This feature is only available for users who have Retail Search enabled. Please enable - * Retail Search on Cloud Console before using this feature. + *

This feature is only available for users who have Retail Search enabled. Enable Retail + * Search on Cloud Console before using this feature. * *

Sample code: * @@ -1876,14 +1898,16 @@ public final UnaryCallable setInventoryCallable( * [ProductService.GetProduct][google.cloud.retail.v2.ProductService.GetProduct] or * [ProductService.ListProducts][google.cloud.retail.v2.ProductService.ListProducts]. * - *

The returned [Operation][]s will be obsolete after 1 day, and [GetOperation][] API will - * return NOT_FOUND afterwards. + *

The returned [Operation][google.longrunning.Operation]s will be obsolete after 1 day, and + * [GetOperation][google.longrunning.Operations.GetOperation] API will return NOT_FOUND + * afterwards. * - *

If conflicting updates are issued, the [Operation][]s associated with the stale updates will - * not be marked as [done][Operation.done] until being obsolete. + *

If conflicting updates are issued, the [Operation][google.longrunning.Operation]s associated + * with the stale updates will not be marked as [done][google.longrunning.Operation.done] until + * being obsolete. * - *

This feature is only available for users who have Retail Search enabled. Please enable - * Retail Search on Cloud Console before using this feature. + *

This feature is only available for users who have Retail Search enabled. Enable Retail + * Search on Cloud Console before using this feature. * *

Sample code: * @@ -1934,14 +1958,16 @@ public final UnaryCallable setInventoryCallable( * [ProductService.UpdateProduct][google.cloud.retail.v2.ProductService.UpdateProduct] has no * effect on local inventories. * - *

The returned [Operation][]s will be obsolete after 1 day, and [GetOperation][] API will - * return NOT_FOUND afterwards. + *

The returned [Operation][google.longrunning.Operation]s will be obsolete after 1 day, and + * [GetOperation][google.longrunning.Operations.GetOperation] API will return NOT_FOUND + * afterwards. * - *

If conflicting updates are issued, the [Operation][]s associated with the stale updates will - * not be marked as [done][Operation.done] until being obsolete. + *

If conflicting updates are issued, the [Operation][google.longrunning.Operation]s associated + * with the stale updates will not be marked as [done][google.longrunning.Operation.done] until + * being obsolete. * - *

This feature is only available for users who have Retail Search enabled. Please enable - * Retail Search on Cloud Console before using this feature. + *

This feature is only available for users who have Retail Search enabled. Enable Retail + * Search on Cloud Console before using this feature. * *

Sample code: * @@ -1994,14 +2020,16 @@ public final UnaryCallable setInventoryCallable( * [ProductService.UpdateProduct][google.cloud.retail.v2.ProductService.UpdateProduct] has no * effect on local inventories. * - *

The returned [Operation][]s will be obsolete after 1 day, and [GetOperation][] API will - * return NOT_FOUND afterwards. + *

The returned [Operation][google.longrunning.Operation]s will be obsolete after 1 day, and + * [GetOperation][google.longrunning.Operations.GetOperation] API will return NOT_FOUND + * afterwards. * - *

If conflicting updates are issued, the [Operation][]s associated with the stale updates will - * not be marked as [done][Operation.done] until being obsolete. + *

If conflicting updates are issued, the [Operation][google.longrunning.Operation]s associated + * with the stale updates will not be marked as [done][google.longrunning.Operation.done] until + * being obsolete. * - *

This feature is only available for users who have Retail Search enabled. Please enable - * Retail Search on Cloud Console before using this feature. + *

This feature is only available for users who have Retail Search enabled. Enable Retail + * Search on Cloud Console before using this feature. * *

Sample code: * @@ -2053,14 +2081,16 @@ public final UnaryCallable setInventoryCallable( * [ProductService.UpdateProduct][google.cloud.retail.v2.ProductService.UpdateProduct] has no * effect on local inventories. * - *

The returned [Operation][]s will be obsolete after 1 day, and [GetOperation][] API will - * return NOT_FOUND afterwards. + *

The returned [Operation][google.longrunning.Operation]s will be obsolete after 1 day, and + * [GetOperation][google.longrunning.Operations.GetOperation] API will return NOT_FOUND + * afterwards. * - *

If conflicting updates are issued, the [Operation][]s associated with the stale updates will - * not be marked as [done][Operation.done] until being obsolete. + *

If conflicting updates are issued, the [Operation][google.longrunning.Operation]s associated + * with the stale updates will not be marked as [done][google.longrunning.Operation.done] until + * being obsolete. * - *

This feature is only available for users who have Retail Search enabled. Please enable - * Retail Search on Cloud Console before using this feature. + *

This feature is only available for users who have Retail Search enabled. Enable Retail + * Search on Cloud Console before using this feature. * *

Sample code: * @@ -2112,14 +2142,16 @@ public final UnaryCallable setInventoryCallable( * [ProductService.UpdateProduct][google.cloud.retail.v2.ProductService.UpdateProduct] has no * effect on local inventories. * - *

The returned [Operation][]s will be obsolete after 1 day, and [GetOperation][] API will - * return NOT_FOUND afterwards. + *

The returned [Operation][google.longrunning.Operation]s will be obsolete after 1 day, and + * [GetOperation][google.longrunning.Operations.GetOperation] API will return NOT_FOUND + * afterwards. * - *

If conflicting updates are issued, the [Operation][]s associated with the stale updates will - * not be marked as [done][Operation.done] until being obsolete. + *

If conflicting updates are issued, the [Operation][google.longrunning.Operation]s associated + * with the stale updates will not be marked as [done][google.longrunning.Operation.done] until + * being obsolete. * - *

This feature is only available for users who have Retail Search enabled. Please enable - * Retail Search on Cloud Console before using this feature. + *

This feature is only available for users who have Retail Search enabled. Enable Retail + * Search on Cloud Console before using this feature. * *

Sample code: * @@ -2171,14 +2203,16 @@ public final UnaryCallable setInventoryCallable( * [ProductService.UpdateProduct][google.cloud.retail.v2.ProductService.UpdateProduct] has no * effect on local inventories. * - *

The returned [Operation][]s will be obsolete after 1 day, and [GetOperation][] API will - * return NOT_FOUND afterwards. + *

The returned [Operation][google.longrunning.Operation]s will be obsolete after 1 day, and + * [GetOperation][google.longrunning.Operations.GetOperation] API will return NOT_FOUND + * afterwards. * - *

If conflicting updates are issued, the [Operation][]s associated with the stale updates will - * not be marked as [done][Operation.done] until being obsolete. + *

If conflicting updates are issued, the [Operation][google.longrunning.Operation]s associated + * with the stale updates will not be marked as [done][google.longrunning.Operation.done] until + * being obsolete. * - *

This feature is only available for users who have Retail Search enabled. Please enable - * Retail Search on Cloud Console before using this feature. + *

This feature is only available for users who have Retail Search enabled. Enable Retail + * Search on Cloud Console before using this feature. * *

Sample code: * @@ -2226,14 +2260,16 @@ public final UnaryCallable addLocalInvent * [ProductService.UpdateProduct][google.cloud.retail.v2.ProductService.UpdateProduct] has no * effect on local inventories. * - *

The returned [Operation][]s will be obsolete after 1 day, and [GetOperation][] API will - * return NOT_FOUND afterwards. + *

The returned [Operation][google.longrunning.Operation]s will be obsolete after 1 day, and + * [GetOperation][google.longrunning.Operations.GetOperation] API will return NOT_FOUND + * afterwards. * - *

If conflicting updates are issued, the [Operation][]s associated with the stale updates will - * not be marked as [done][Operation.done] until being obsolete. + *

If conflicting updates are issued, the [Operation][google.longrunning.Operation]s associated + * with the stale updates will not be marked as [done][google.longrunning.Operation.done] until + * being obsolete. * - *

This feature is only available for users who have Retail Search enabled. Please enable - * Retail Search on Cloud Console before using this feature. + *

This feature is only available for users who have Retail Search enabled. Enable Retail + * Search on Cloud Console before using this feature. * *

Sample code: * @@ -2284,14 +2320,16 @@ public final UnaryCallable addLocalInvent * [ProductService.UpdateProduct][google.cloud.retail.v2.ProductService.UpdateProduct] has no * effect on local inventories. * - *

The returned [Operation][]s will be obsolete after 1 day, and [GetOperation][] API will - * return NOT_FOUND afterwards. + *

The returned [Operation][google.longrunning.Operation]s will be obsolete after 1 day, and + * [GetOperation][google.longrunning.Operations.GetOperation] API will return NOT_FOUND + * afterwards. * - *

If conflicting updates are issued, the [Operation][]s associated with the stale updates will - * not be marked as [done][Operation.done] until being obsolete. + *

If conflicting updates are issued, the [Operation][google.longrunning.Operation]s associated + * with the stale updates will not be marked as [done][google.longrunning.Operation.done] until + * being obsolete. * - *

This feature is only available for users who have Retail Search enabled. Please enable - * Retail Search on Cloud Console before using this feature. + *

This feature is only available for users who have Retail Search enabled. Enable Retail + * Search on Cloud Console before using this feature. * *

Sample code: * @@ -2341,14 +2379,16 @@ public final UnaryCallable addLocalInvent * [ProductService.UpdateProduct][google.cloud.retail.v2.ProductService.UpdateProduct] has no * effect on local inventories. * - *

The returned [Operation][]s will be obsolete after 1 day, and [GetOperation][] API will - * return NOT_FOUND afterwards. + *

The returned [Operation][google.longrunning.Operation]s will be obsolete after 1 day, and + * [GetOperation][google.longrunning.Operations.GetOperation] API will return NOT_FOUND + * afterwards. * - *

If conflicting updates are issued, the [Operation][]s associated with the stale updates will - * not be marked as [done][Operation.done] until being obsolete. + *

If conflicting updates are issued, the [Operation][google.longrunning.Operation]s associated + * with the stale updates will not be marked as [done][google.longrunning.Operation.done] until + * being obsolete. * - *

This feature is only available for users who have Retail Search enabled. Please enable - * Retail Search on Cloud Console before using this feature. + *

This feature is only available for users who have Retail Search enabled. Enable Retail + * Search on Cloud Console before using this feature. * *

Sample code: * @@ -2397,14 +2437,16 @@ public final UnaryCallable addLocalInvent * [ProductService.UpdateProduct][google.cloud.retail.v2.ProductService.UpdateProduct] has no * effect on local inventories. * - *

The returned [Operation][]s will be obsolete after 1 day, and [GetOperation][] API will - * return NOT_FOUND afterwards. + *

The returned [Operation][google.longrunning.Operation]s will be obsolete after 1 day, and + * [GetOperation][google.longrunning.Operations.GetOperation] API will return NOT_FOUND + * afterwards. * - *

If conflicting updates are issued, the [Operation][]s associated with the stale updates will - * not be marked as [done][Operation.done] until being obsolete. + *

If conflicting updates are issued, the [Operation][google.longrunning.Operation]s associated + * with the stale updates will not be marked as [done][google.longrunning.Operation.done] until + * being obsolete. * - *

This feature is only available for users who have Retail Search enabled. Please enable - * Retail Search on Cloud Console before using this feature. + *

This feature is only available for users who have Retail Search enabled. Enable Retail + * Search on Cloud Console before using this feature. * *

Sample code: * @@ -2455,14 +2497,16 @@ public final UnaryCallable addLocalInvent * [ProductService.UpdateProduct][google.cloud.retail.v2.ProductService.UpdateProduct] has no * effect on local inventories. * - *

The returned [Operation][]s will be obsolete after 1 day, and [GetOperation][] API will - * return NOT_FOUND afterwards. + *

The returned [Operation][google.longrunning.Operation]s will be obsolete after 1 day, and + * [GetOperation][google.longrunning.Operations.GetOperation] API will return NOT_FOUND + * afterwards. * - *

If conflicting updates are issued, the [Operation][]s associated with the stale updates will - * not be marked as [done][Operation.done] until being obsolete. + *

If conflicting updates are issued, the [Operation][google.longrunning.Operation]s associated + * with the stale updates will not be marked as [done][google.longrunning.Operation.done] until + * being obsolete. * - *

This feature is only available for users who have Retail Search enabled. Please enable - * Retail Search on Cloud Console before using this feature. + *

This feature is only available for users who have Retail Search enabled. Enable Retail + * Search on Cloud Console before using this feature. * *

Sample code: * diff --git a/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2/SearchServiceClient.java b/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2/SearchServiceClient.java index edb33d89089d..02cbd05590bf 100644 --- a/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2/SearchServiceClient.java +++ b/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2/SearchServiceClient.java @@ -36,8 +36,8 @@ /** * Service Description: Service for search. * - *

This feature is only available for users who have Retail Search enabled. Please enable Retail - * Search on Cloud Console before using this feature. + *

This feature is only available for users who have Retail Search enabled. Enable Retail Search + * on Cloud Console before using this feature. * *

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: @@ -203,8 +203,8 @@ public SearchServiceStub getStub() { /** * Performs a search. * - *

This feature is only available for users who have Retail Search enabled. Please enable - * Retail Search on Cloud Console before using this feature. + *

This feature is only available for users who have Retail Search enabled. Enable Retail + * Search on Cloud Console before using this feature. * *

Sample code: * @@ -256,8 +256,8 @@ public final SearchPagedResponse search(SearchRequest request) { /** * Performs a search. * - *

This feature is only available for users who have Retail Search enabled. Please enable - * Retail Search on Cloud Console before using this feature. + *

This feature is only available for users who have Retail Search enabled. Enable Retail + * Search on Cloud Console before using this feature. * *

Sample code: * @@ -309,8 +309,8 @@ public final UnaryCallable searchPagedCallab /** * Performs a search. * - *

This feature is only available for users who have Retail Search enabled. Please enable - * Retail Search on Cloud Console before using this feature. + *

This feature is only available for users who have Retail Search enabled. Enable Retail + * Search on Cloud Console before using this feature. * *

Sample code: * diff --git a/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2/ServingConfigServiceClient.java b/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2/ServingConfigServiceClient.java index c29c8b824e0f..3663644571f8 100644 --- a/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2/ServingConfigServiceClient.java +++ b/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2/ServingConfigServiceClient.java @@ -361,7 +361,7 @@ public final ServingConfig createServingConfig(CreateServingConfigRequest reques * } * * @param name Required. The resource name of the ServingConfig to delete. Format: - * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id} + * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}` * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ public final void deleteServingConfig(ServingConfigName name) { @@ -396,7 +396,7 @@ public final void deleteServingConfig(ServingConfigName name) { * } * * @param name Required. The resource name of the ServingConfig to delete. Format: - * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id} + * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}` * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ public final void deleteServingConfig(String name) { @@ -596,7 +596,7 @@ public final ServingConfig updateServingConfig(UpdateServingConfigRequest reques * } * * @param name Required. The resource name of the ServingConfig to get. Format: - * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id} + * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}` * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ public final ServingConfig getServingConfig(ServingConfigName name) { @@ -629,7 +629,7 @@ public final ServingConfig getServingConfig(ServingConfigName name) { * } * * @param name Required. The resource name of the ServingConfig to get. Format: - * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id} + * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}` * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ public final ServingConfig getServingConfig(String name) { @@ -726,7 +726,7 @@ public final UnaryCallable getServingCon * } * * @param parent Required. The catalog resource name. Format: - * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id} + * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}` * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ public final ListServingConfigsPagedResponse listServingConfigs(CatalogName parent) { @@ -760,7 +760,7 @@ public final ListServingConfigsPagedResponse listServingConfigs(CatalogName pare * } * * @param parent Required. The catalog resource name. Format: - * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id} + * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}` * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ public final ListServingConfigsPagedResponse listServingConfigs(String parent) { @@ -904,7 +904,7 @@ public final ListServingConfigsPagedResponse listServingConfigs( * } * * @param servingConfig Required. The source ServingConfig resource name . Format: - * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id} + * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}` * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ public final ServingConfig addControl(ServingConfigName servingConfig) { @@ -941,7 +941,7 @@ public final ServingConfig addControl(ServingConfigName servingConfig) { * } * * @param servingConfig Required. The source ServingConfig resource name . Format: - * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id} + * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}` * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ public final ServingConfig addControl(String servingConfig) { @@ -1044,7 +1044,7 @@ public final UnaryCallable addControlCallable( * } * * @param servingConfig Required. The source ServingConfig resource name . Format: - * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id} + * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}` * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ public final ServingConfig removeControl(ServingConfigName servingConfig) { @@ -1078,7 +1078,7 @@ public final ServingConfig removeControl(ServingConfigName servingConfig) { * } * * @param servingConfig Required. The source ServingConfig resource name . Format: - * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id} + * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}` * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ public final ServingConfig removeControl(String servingConfig) { diff --git a/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2/UserEventServiceClient.java b/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2/UserEventServiceClient.java index 9dc0b05e23db..f600f4030288 100644 --- a/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2/UserEventServiceClient.java +++ b/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2/UserEventServiceClient.java @@ -48,6 +48,7 @@ * WriteUserEventRequest.newBuilder() * .setParent("parent-995424086") * .setUserEvent(UserEvent.newBuilder().build()) + * .setWriteAsync(true) * .build(); * UserEvent response = userEventServiceClient.writeUserEvent(request); * } @@ -219,6 +220,7 @@ public final OperationsClient getHttpJsonOperationsClient() { * WriteUserEventRequest.newBuilder() * .setParent("parent-995424086") * .setUserEvent(UserEvent.newBuilder().build()) + * .setWriteAsync(true) * .build(); * UserEvent response = userEventServiceClient.writeUserEvent(request); * } @@ -248,6 +250,7 @@ public final UserEvent writeUserEvent(WriteUserEventRequest request) { * WriteUserEventRequest.newBuilder() * .setParent("parent-995424086") * .setUserEvent(UserEvent.newBuilder().build()) + * .setWriteAsync(true) * .build(); * ApiFuture future = * userEventServiceClient.writeUserEventCallable().futureCall(request); @@ -283,6 +286,7 @@ public final UnaryCallable writeUserEventCalla * .setUserEvent("userEvent315571599") * .setUri("uri116076") * .setEts(100772) + * .setRawJson("rawJson985449776") * .build(); * HttpBody response = userEventServiceClient.collectUserEvent(request); * } @@ -318,6 +322,7 @@ public final HttpBody collectUserEvent(CollectUserEventRequest request) { * .setUserEvent("userEvent315571599") * .setUri("uri116076") * .setEts(100772) + * .setRawJson("rawJson985449776") * .build(); * ApiFuture future = * userEventServiceClient.collectUserEventCallable().futureCall(request); @@ -535,11 +540,11 @@ public final UnaryCallable importUserEventsC // AUTO-GENERATED DOCUMENTATION AND METHOD. /** - * Starts a user event rejoin operation with latest product catalog. Events will not be annotated - * with detailed product information if product is missing from the catalog at the time the user - * event is ingested, and these events are stored as unjoined events with a limited usage on - * training and serving. This method can be used to start a join operation on specified events - * with latest version of product catalog. It can also be used to correct events joined with the + * Starts a user-event rejoin operation with latest product catalog. Events are not annotated with + * detailed product information for products that are missing from the catalog when the user event + * is ingested. These events are stored as unjoined events with limited usage on training and + * serving. You can use this method to start a join operation on specified events with the latest + * version of product catalog. You can also use this method to correct events joined with the * wrong product catalog. A rejoin operation can take hours or days to complete. * *

Sample code: @@ -568,11 +573,11 @@ public final UnaryCallable importUserEventsC // AUTO-GENERATED DOCUMENTATION AND METHOD. /** - * Starts a user event rejoin operation with latest product catalog. Events will not be annotated - * with detailed product information if product is missing from the catalog at the time the user - * event is ingested, and these events are stored as unjoined events with a limited usage on - * training and serving. This method can be used to start a join operation on specified events - * with latest version of product catalog. It can also be used to correct events joined with the + * Starts a user-event rejoin operation with latest product catalog. Events are not annotated with + * detailed product information for products that are missing from the catalog when the user event + * is ingested. These events are stored as unjoined events with limited usage on training and + * serving. You can use this method to start a join operation on specified events with the latest + * version of product catalog. You can also use this method to correct events joined with the * wrong product catalog. A rejoin operation can take hours or days to complete. * *

Sample code: @@ -601,11 +606,11 @@ public final UnaryCallable importUserEventsC // AUTO-GENERATED DOCUMENTATION AND METHOD. /** - * Starts a user event rejoin operation with latest product catalog. Events will not be annotated - * with detailed product information if product is missing from the catalog at the time the user - * event is ingested, and these events are stored as unjoined events with a limited usage on - * training and serving. This method can be used to start a join operation on specified events - * with latest version of product catalog. It can also be used to correct events joined with the + * Starts a user-event rejoin operation with latest product catalog. Events are not annotated with + * detailed product information for products that are missing from the catalog when the user event + * is ingested. These events are stored as unjoined events with limited usage on training and + * serving. You can use this method to start a join operation on specified events with the latest + * version of product catalog. You can also use this method to correct events joined with the * wrong product catalog. A rejoin operation can take hours or days to complete. * *

Sample code: diff --git a/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2/package-info.java b/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2/package-info.java index d1e3cc2d57cb..570b8ecae47c 100644 --- a/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2/package-info.java +++ b/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2/package-info.java @@ -42,8 +42,8 @@ * *

Service Description: Auto-completion service for retail. * - *

This feature is only available for users who have Retail Search enabled. Please enable Retail - * Search on Cloud Console before using this feature. + *

This feature is only available for users who have Retail Search enabled. Enable Retail Search + * on Cloud Console before using this feature. * *

Sample for CompletionServiceClient: * @@ -141,8 +141,8 @@ * *

Service Description: Service for search. * - *

This feature is only available for users who have Retail Search enabled. Please enable Retail - * Search on Cloud Console before using this feature. + *

This feature is only available for users who have Retail Search enabled. Enable Retail Search + * on Cloud Console before using this feature. * *

Sample for SearchServiceClient: * @@ -222,6 +222,7 @@ * WriteUserEventRequest.newBuilder() * .setParent("parent-995424086") * .setUserEvent(UserEvent.newBuilder().build()) + * .setWriteAsync(true) * .build(); * UserEvent response = userEventServiceClient.writeUserEvent(request); * } diff --git a/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2/stub/HttpJsonUserEventServiceStub.java b/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2/stub/HttpJsonUserEventServiceStub.java index 7ccba8633e92..7e354143dd09 100644 --- a/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2/stub/HttpJsonUserEventServiceStub.java +++ b/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2/stub/HttpJsonUserEventServiceStub.java @@ -95,6 +95,7 @@ public class HttpJsonUserEventServiceStub extends UserEventServiceStub { Map> fields = new HashMap<>(); ProtoRestSerializer serializer = ProtoRestSerializer.create(); + serializer.putQueryParam(fields, "writeAsync", request.getWriteAsync()); serializer.putQueryParam(fields, "$alt", "json;enum-encoding=int"); return fields; }) @@ -133,6 +134,9 @@ public class HttpJsonUserEventServiceStub extends UserEventServiceStub { ProtoRestSerializer serializer = ProtoRestSerializer.create(); serializer.putQueryParam(fields, "ets", request.getEts()); + serializer.putQueryParam( + fields, "prebuiltRule", request.getPrebuiltRule()); + serializer.putQueryParam(fields, "rawJson", request.getRawJson()); serializer.putQueryParam(fields, "uri", request.getUri()); serializer.putQueryParam(fields, "userEvent", request.getUserEvent()); serializer.putQueryParam(fields, "$alt", "json;enum-encoding=int"); diff --git a/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2alpha/CatalogServiceClient.java b/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2alpha/CatalogServiceClient.java index bfc583be6387..eb287029e4c1 100644 --- a/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2alpha/CatalogServiceClient.java +++ b/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2alpha/CatalogServiceClient.java @@ -816,7 +816,7 @@ public final GetDefaultBranchResponse getDefaultBranch(GetDefaultBranchRequest r * } * * @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) { @@ -846,7 +846,7 @@ public final CompletionConfig getCompletionConfig(CompletionConfigName name) { * } * * @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) { @@ -1391,6 +1391,72 @@ public final AttributesConfig removeCatalogAttribute(RemoveCatalogAttributeReque return stub.removeCatalogAttributeCallable(); } + // AUTO-GENERATED DOCUMENTATION AND METHOD. + /** + * Removes all specified [CatalogAttribute][google.cloud.retail.v2alpha.CatalogAttribute]s from + * the [AttributesConfig][google.cloud.retail.v2alpha.AttributesConfig]. + * + *

Sample code: + * + * 

{@code
+   * // This snippet has been automatically generated and should be regarded as a code template only.
+   * // It will require modifications to work:
+   * // - It may require correct/in-range values for request initialization.
+   * // - It may require specifying regional endpoints when creating the service client as shown in
+   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+   * try (CatalogServiceClient catalogServiceClient = CatalogServiceClient.create()) {
+   *   BatchRemoveCatalogAttributesRequest request =
+   *       BatchRemoveCatalogAttributesRequest.newBuilder()
+   *           .setAttributesConfig(
+   *               AttributesConfigName.of("[PROJECT]", "[LOCATION]", "[CATALOG]").toString())
+   *           .addAllAttributeKeys(new ArrayList())
+   *           .build();
+   *   BatchRemoveCatalogAttributesResponse response =
+   *       catalogServiceClient.batchRemoveCatalogAttributes(request);
+   * }
+   * }
+ * + * @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.v2alpha.CatalogAttribute]s from + * the [AttributesConfig][google.cloud.retail.v2alpha.AttributesConfig]. + * + *

Sample code: + * + * 

{@code
+   * // This snippet has been automatically generated and should be regarded as a code template only.
+   * // It will require modifications to work:
+   * // - It may require correct/in-range values for request initialization.
+   * // - It may require specifying regional endpoints when creating the service client as shown in
+   * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+   * try (CatalogServiceClient catalogServiceClient = CatalogServiceClient.create()) {
+   *   BatchRemoveCatalogAttributesRequest request =
+   *       BatchRemoveCatalogAttributesRequest.newBuilder()
+   *           .setAttributesConfig(
+   *               AttributesConfigName.of("[PROJECT]", "[LOCATION]", "[CATALOG]").toString())
+   *           .addAllAttributeKeys(new ArrayList())
+   *           .build();
+   *   ApiFuture future =
+   *       catalogServiceClient.batchRemoveCatalogAttributesCallable().futureCall(request);
+   *   // Do something.
+   *   BatchRemoveCatalogAttributesResponse response = future.get();
+   * }
+   * }
+ */ + public final UnaryCallable< + BatchRemoveCatalogAttributesRequest, BatchRemoveCatalogAttributesResponse> + batchRemoveCatalogAttributesCallable() { + return stub.batchRemoveCatalogAttributesCallable(); + } + // AUTO-GENERATED DOCUMENTATION AND METHOD. /** * Replaces the specified [CatalogAttribute][google.cloud.retail.v2alpha.CatalogAttribute] in the diff --git a/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2alpha/CatalogServiceSettings.java b/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2alpha/CatalogServiceSettings.java index 94369d62b22e..274ddda1ac97 100644 --- a/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2alpha/CatalogServiceSettings.java +++ b/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2alpha/CatalogServiceSettings.java @@ -132,6 +132,13 @@ public UnaryCallSettings 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 replaceCatalogAttributeSettings() { @@ -312,6 +319,13 @@ public UnaryCallSettings.Builder 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 replaceCatalogAttributeSettings() { diff --git a/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2alpha/CompletionServiceClient.java b/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2alpha/CompletionServiceClient.java index 2aefd35581c1..764154b342e4 100644 --- a/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2alpha/CompletionServiceClient.java +++ b/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2alpha/CompletionServiceClient.java @@ -33,8 +33,8 @@ /** * Service Description: Auto-completion service for retail. * - *

This feature is only available for users who have Retail Search enabled. Please enable Retail - * Search on Cloud Console before using this feature. + *

This feature is only available for users who have Retail Search enabled. Enable Retail Search + * on Cloud Console before using this feature. * *

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: @@ -55,6 +55,7 @@ * .setDeviceType("deviceType781190832") * .setDataset("dataset1443214456") * .setMaxSuggestions(618824852) + * .setEnableAttributeSuggestions(true) * .build(); * CompleteQueryResponse response = completionServiceClient.completeQuery(request); * } @@ -214,8 +215,8 @@ public final OperationsClient getHttpJsonOperationsClient() { /** * Completes the specified prefix with keyword suggestions. * - *

This feature is only available for users who have Retail Search enabled. Please enable - * Retail Search on Cloud Console before using this feature. + *

This feature is only available for users who have Retail Search enabled. Enable Retail + * Search on Cloud Console before using this feature. * *

Sample code: * @@ -235,6 +236,7 @@ public final OperationsClient getHttpJsonOperationsClient() { * .setDeviceType("deviceType781190832") * .setDataset("dataset1443214456") * .setMaxSuggestions(618824852) + * .setEnableAttributeSuggestions(true) * .build(); * CompleteQueryResponse response = completionServiceClient.completeQuery(request); * } @@ -251,8 +253,8 @@ public final CompleteQueryResponse completeQuery(CompleteQueryRequest request) { /** * Completes the specified prefix with keyword suggestions. * - *

This feature is only available for users who have Retail Search enabled. Please enable - * Retail Search on Cloud Console before using this feature. + *

This feature is only available for users who have Retail Search enabled. Enable Retail + * Search on Cloud Console before using this feature. * *

Sample code: * @@ -272,6 +274,7 @@ public final CompleteQueryResponse completeQuery(CompleteQueryRequest request) { * .setDeviceType("deviceType781190832") * .setDataset("dataset1443214456") * .setMaxSuggestions(618824852) + * .setEnableAttributeSuggestions(true) * .build(); * ApiFuture future = * completionServiceClient.completeQueryCallable().futureCall(request); @@ -293,8 +296,8 @@ public final UnaryCallable complete *

The operation is successfully finished only after the imported suggestions are indexed * successfully and ready for serving. The process takes hours. * - *

This feature is only available for users who have Retail Search enabled. Please enable - * Retail Search on Cloud Console before using this feature. + *

This feature is only available for users who have Retail Search enabled. Enable Retail + * Search on Cloud Console before using this feature. * *

Sample code: * @@ -333,8 +336,8 @@ public final UnaryCallable complete *

The operation is successfully finished only after the imported suggestions are indexed * successfully and ready for serving. The process takes hours. * - *

This feature is only available for users who have Retail Search enabled. Please enable - * Retail Search on Cloud Console before using this feature. + *

This feature is only available for users who have Retail Search enabled. Enable Retail + * Search on Cloud Console before using this feature. * *

Sample code: * @@ -373,8 +376,8 @@ public final UnaryCallable complete *

The operation is successfully finished only after the imported suggestions are indexed * successfully and ready for serving. The process takes hours. * - *

This feature is only available for users who have Retail Search enabled. Please enable - * Retail Search on Cloud Console before using this feature. + *

This feature is only available for users who have Retail Search enabled. Enable Retail + * Search on Cloud Console before using this feature. * *

Sample code: * diff --git a/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2alpha/ControlServiceClient.java b/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2alpha/ControlServiceClient.java index 01f21c759024..7d161c70ac59 100644 --- a/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2alpha/ControlServiceClient.java +++ b/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2alpha/ControlServiceClient.java @@ -454,7 +454,7 @@ public final UnaryCallable deleteControlCallable() * *

[Control][google.cloud.retail.v2alpha.Control] cannot be set to a different oneof field, if * so an INVALID_ARGUMENT is returned. If the [Control][google.cloud.retail.v2alpha.Control] to - * delete does not exist, a NOT_FOUND error is returned. + * update does not exist, a NOT_FOUND error is returned. * *

Sample code: * @@ -492,7 +492,7 @@ public final Control updateControl(Control control, FieldMask updateMask) { * *

[Control][google.cloud.retail.v2alpha.Control] cannot be set to a different oneof field, if * so an INVALID_ARGUMENT is returned. If the [Control][google.cloud.retail.v2alpha.Control] to - * delete does not exist, a NOT_FOUND error is returned. + * update does not exist, a NOT_FOUND error is returned. * *

Sample code: * @@ -525,7 +525,7 @@ public final Control updateControl(UpdateControlRequest request) { * *

[Control][google.cloud.retail.v2alpha.Control] cannot be set to a different oneof field, if * so an INVALID_ARGUMENT is returned. If the [Control][google.cloud.retail.v2alpha.Control] to - * delete does not exist, a NOT_FOUND error is returned. + * update does not exist, a NOT_FOUND error is returned. * *

Sample code: * @@ -569,7 +569,7 @@ public final UnaryCallable updateControlCallable( * } * } * - * @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 */ @@ -597,7 +597,7 @@ public final Control getControl(ControlName name) { * } * } * - * @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 */ @@ -665,7 +665,7 @@ public final UnaryCallable getControlCallable() { // AUTO-GENERATED DOCUMENTATION AND METHOD. /** - * Lists all Controls linked to this catalog. + * Lists all Controls by their parent [Catalog][google.cloud.retail.v2alpha.Catalog]. * *

Sample code: * @@ -697,7 +697,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.v2alpha.Catalog]. * *

Sample code: * @@ -726,7 +726,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.v2alpha.Catalog]. * *

Sample code: * @@ -759,7 +759,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.v2alpha.Catalog]. * *

Sample code: * @@ -793,7 +793,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.v2alpha.Catalog]. * *

Sample code: * diff --git a/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2alpha/ModelServiceClient.java b/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2alpha/ModelServiceClient.java index 84d8640ddcb8..b02b22caa8f2 100644 --- a/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2alpha/ModelServiceClient.java +++ b/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2alpha/ModelServiceClient.java @@ -42,11 +42,11 @@ // AUTO-GENERATED DOCUMENTATION AND CLASS. /** * Service Description: Service for performing CRUD operations on models. Recommendation models - * contain all the metadata necessary to generate a set of models for the Predict() api. A model is - * queried indirectly via a ServingConfig, which associates a model with a given Placement (e.g. + * contain all the metadata necessary to generate a set of models for the `Predict()` API. A model + * is queried indirectly via a ServingConfig, which associates a model with a given Placement (e.g. * Frequently Bought Together on Home Page). * - *

This service allows customers to e.g.: + *

This service allows you to do the following: * *

    *
  • Initiate training of a model. @@ -234,8 +234,8 @@ public final OperationsClient getHttpJsonOperationsClient() { * } * * @param parent Required. The parent resource under which to create the model. Format: - * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id} - * @param model Required. The payload of the [Model] to create. + * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}` + * @param model Required. The payload of the [Model][google.cloud.retail.v2alpha.Model] to create. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ public final OperationFuture createModelAsync( @@ -268,8 +268,8 @@ public final OperationFuture createModelAsync( * } * * @param parent Required. The parent resource under which to create the model. Format: - * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id} - * @param model Required. The payload of the [Model] to create. + * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}` + * @param model Required. The payload of the [Model][google.cloud.retail.v2alpha.Model] to create. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ public final OperationFuture createModelAsync( @@ -389,7 +389,7 @@ public final UnaryCallable createModelCallable() * } * * @param name Required. The name of the model to pause. Format: - * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id} + * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}` * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ public final Model pauseModel(ModelName name) { @@ -417,7 +417,7 @@ public final Model pauseModel(ModelName name) { * } * * @param name Required. The name of the model to pause. Format: - * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id} + * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}` * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ public final Model pauseModel(String name) { @@ -499,7 +499,7 @@ public final UnaryCallable pauseModelCallable() { * } * * @param name Required. The name of the model to resume. Format: - * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id} + * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}` * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ public final Model resumeModel(String name) { @@ -574,8 +574,9 @@ public final UnaryCallable resumeModelCallable() { * } * } * - * @param name Required. The resource name of the [Model] to delete. Format: - * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id} + * @param name Required. The resource name of the [Model][google.cloud.retail.v2alpha.Model] to + * delete. Format: + * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}` * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ public final void deleteModel(ModelName name) { @@ -602,8 +603,9 @@ public final void deleteModel(ModelName name) { * } * } * - * @param name Required. The resource name of the [Model] to delete. Format: - * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id} + * @param name Required. The resource name of the [Model][google.cloud.retail.v2alpha.Model] to + * delete. Format: + * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}` * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ public final void deleteModel(String name) { @@ -687,7 +689,7 @@ public final UnaryCallable deleteModelCallable() { * } * * @param parent Required. The parent for which to list models. Format: - * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id} + * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}` * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ public final ListModelsPagedResponse listModels(CatalogName parent) { @@ -717,7 +719,7 @@ public final ListModelsPagedResponse listModels(CatalogName parent) { * } * * @param parent Required. The parent for which to list models. Format: - * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id} + * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}` * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ public final ListModelsPagedResponse listModels(String parent) { @@ -828,8 +830,8 @@ public final UnaryCallable listModelsCall // AUTO-GENERATED DOCUMENTATION AND METHOD. /** - * Update of model metadata. Only fields that currently can be updated are: filtering_option, - * periodic_tuning_state. If other values are provided, this API method will ignore them. + * Update of model metadata. Only fields that currently can be updated are: `filtering_option` and + * `periodic_tuning_state`. If other values are provided, this API method ignores them. * *

    Sample code: * @@ -846,9 +848,9 @@ public final UnaryCallable listModelsCall * } * } * - * @param model Required. The body of the updated [Model]. + * @param model Required. The body of the updated [Model][google.cloud.retail.v2alpha.Model]. * @param updateMask Optional. Indicates which fields in the provided 'model' to update. If not - * set, will by default update all fields. + * set, by default updates all fields. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ public final Model updateModel(Model model, FieldMask updateMask) { @@ -859,8 +861,8 @@ public final Model updateModel(Model model, FieldMask updateMask) { // AUTO-GENERATED DOCUMENTATION AND METHOD. /** - * Update of model metadata. Only fields that currently can be updated are: filtering_option, - * periodic_tuning_state. If other values are provided, this API method will ignore them. + * Update of model metadata. Only fields that currently can be updated are: `filtering_option` and + * `periodic_tuning_state`. If other values are provided, this API method ignores them. * *

    Sample code: * @@ -889,8 +891,8 @@ public final Model updateModel(UpdateModelRequest request) { // AUTO-GENERATED DOCUMENTATION AND METHOD. /** - * Update of model metadata. Only fields that currently can be updated are: filtering_option, - * periodic_tuning_state. If other values are provided, this API method will ignore them. + * Update of model metadata. Only fields that currently can be updated are: `filtering_option` and + * `periodic_tuning_state`. If other values are provided, this API method ignores them. * *

    Sample code: * @@ -935,7 +937,7 @@ public final UnaryCallable updateModelCallable() { * } * * @param name Required. The resource name of the model to tune. Format: - * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id} + * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}` * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ public final OperationFuture tuneModelAsync( @@ -964,7 +966,7 @@ public final OperationFuture tuneModelAsyn * } * * @param name Required. The resource name of the model to tune. Format: - * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id} + * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}` * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ public final OperationFuture tuneModelAsync(String name) { diff --git a/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2alpha/ProductServiceClient.java b/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2alpha/ProductServiceClient.java index 16761096637b..abd17293ac6e 100644 --- a/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2alpha/ProductServiceClient.java +++ b/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2alpha/ProductServiceClient.java @@ -1184,8 +1184,8 @@ public final UnaryCallable importProductsCalla * *

    This process is asynchronous and does not require the * [Product][google.cloud.retail.v2alpha.Product] to exist before updating fulfillment - * information. If the request is valid, the update will be enqueued and processed downstream. As - * a consequence, when a response is returned, updates are not immediately manifested in the + * information. If the request is valid, the update is enqueued and processed downstream. As a + * consequence, when a response is returned, updates are not immediately manifested in the * [Product][google.cloud.retail.v2alpha.Product] queried by * [ProductService.GetProduct][google.cloud.retail.v2alpha.ProductService.GetProduct] or * [ProductService.ListProducts][google.cloud.retail.v2alpha.ProductService.ListProducts]. @@ -1193,20 +1193,20 @@ public final UnaryCallable importProductsCalla *

    When inventory is updated with * [ProductService.CreateProduct][google.cloud.retail.v2alpha.ProductService.CreateProduct] and * [ProductService.UpdateProduct][google.cloud.retail.v2alpha.ProductService.UpdateProduct], the - * specified inventory field value(s) will overwrite any existing value(s) while ignoring the last - * update time for this field. Furthermore, the last update time for the specified inventory - * fields will be overwritten to the time of the + * specified inventory field value(s) overwrite any existing value(s) while ignoring the last + * update time for this field. Furthermore, the last update times for the specified inventory + * fields are overwritten by the times of the * [ProductService.CreateProduct][google.cloud.retail.v2alpha.ProductService.CreateProduct] or * [ProductService.UpdateProduct][google.cloud.retail.v2alpha.ProductService.UpdateProduct] * request. * *

    If no inventory fields are set in * [CreateProductRequest.product][google.cloud.retail.v2alpha.CreateProductRequest.product], then - * any pre-existing inventory information for this product will be used. + * any pre-existing inventory information for this product is used. * *

    If no inventory fields are set in * [SetInventoryRequest.set_mask][google.cloud.retail.v2alpha.SetInventoryRequest.set_mask], then - * any existing inventory information will be preserved. + * any existing inventory information is preserved. * *

    Pre-existing inventory information can only be updated with * [ProductService.SetInventory][google.cloud.retail.v2alpha.ProductService.SetInventory], @@ -1214,8 +1214,15 @@ public final UnaryCallable importProductsCalla * and * [ProductService.RemoveFulfillmentPlaces][google.cloud.retail.v2alpha.ProductService.RemoveFulfillmentPlaces]. * - *

    This feature is only available for users who have Retail Search enabled. Please enable - * Retail Search on Cloud Console before using this feature. + *

    The returned [Operation][google.longrunning.Operation]s is obsolete after one day, and the + * [GetOperation][google.longrunning.Operations.GetOperation] API returns `NOT_FOUND` afterwards. + * + *

    If conflicting updates are issued, the [Operation][google.longrunning.Operation]s associated + * with the stale updates are not marked as [done][google.longrunning.Operation.done] until they + * are obsolete. + * + *

    This feature is only available for users who have Retail Search enabled. Enable Retail + * Search on Cloud Console before using this feature. * *

    Sample code: * @@ -1304,8 +1311,8 @@ public final OperationFuture setInve * *

    This process is asynchronous and does not require the * [Product][google.cloud.retail.v2alpha.Product] to exist before updating fulfillment - * information. If the request is valid, the update will be enqueued and processed downstream. As - * a consequence, when a response is returned, updates are not immediately manifested in the + * information. If the request is valid, the update is enqueued and processed downstream. As a + * consequence, when a response is returned, updates are not immediately manifested in the * [Product][google.cloud.retail.v2alpha.Product] queried by * [ProductService.GetProduct][google.cloud.retail.v2alpha.ProductService.GetProduct] or * [ProductService.ListProducts][google.cloud.retail.v2alpha.ProductService.ListProducts]. @@ -1313,20 +1320,20 @@ public final OperationFuture setInve *

    When inventory is updated with * [ProductService.CreateProduct][google.cloud.retail.v2alpha.ProductService.CreateProduct] and * [ProductService.UpdateProduct][google.cloud.retail.v2alpha.ProductService.UpdateProduct], the - * specified inventory field value(s) will overwrite any existing value(s) while ignoring the last - * update time for this field. Furthermore, the last update time for the specified inventory - * fields will be overwritten to the time of the + * specified inventory field value(s) overwrite any existing value(s) while ignoring the last + * update time for this field. Furthermore, the last update times for the specified inventory + * fields are overwritten by the times of the * [ProductService.CreateProduct][google.cloud.retail.v2alpha.ProductService.CreateProduct] or * [ProductService.UpdateProduct][google.cloud.retail.v2alpha.ProductService.UpdateProduct] * request. * *

    If no inventory fields are set in * [CreateProductRequest.product][google.cloud.retail.v2alpha.CreateProductRequest.product], then - * any pre-existing inventory information for this product will be used. + * any pre-existing inventory information for this product is used. * *

    If no inventory fields are set in * [SetInventoryRequest.set_mask][google.cloud.retail.v2alpha.SetInventoryRequest.set_mask], then - * any existing inventory information will be preserved. + * any existing inventory information is preserved. * *

    Pre-existing inventory information can only be updated with * [ProductService.SetInventory][google.cloud.retail.v2alpha.ProductService.SetInventory], @@ -1334,8 +1341,15 @@ public final OperationFuture setInve * and * [ProductService.RemoveFulfillmentPlaces][google.cloud.retail.v2alpha.ProductService.RemoveFulfillmentPlaces]. * - *

    This feature is only available for users who have Retail Search enabled. Please enable - * Retail Search on Cloud Console before using this feature. + *

    The returned [Operation][google.longrunning.Operation]s is obsolete after one day, and the + * [GetOperation][google.longrunning.Operations.GetOperation] API returns `NOT_FOUND` afterwards. + * + *

    If conflicting updates are issued, the [Operation][google.longrunning.Operation]s associated + * with the stale updates are not marked as [done][google.longrunning.Operation.done] until they + * are obsolete. + * + *

    This feature is only available for users who have Retail Search enabled. Enable Retail + * Search on Cloud Console before using this feature. * *

    Sample code: * @@ -1372,8 +1386,8 @@ public final OperationFuture setInve * *

    This process is asynchronous and does not require the * [Product][google.cloud.retail.v2alpha.Product] to exist before updating fulfillment - * information. If the request is valid, the update will be enqueued and processed downstream. As - * a consequence, when a response is returned, updates are not immediately manifested in the + * information. If the request is valid, the update is enqueued and processed downstream. As a + * consequence, when a response is returned, updates are not immediately manifested in the * [Product][google.cloud.retail.v2alpha.Product] queried by * [ProductService.GetProduct][google.cloud.retail.v2alpha.ProductService.GetProduct] or * [ProductService.ListProducts][google.cloud.retail.v2alpha.ProductService.ListProducts]. @@ -1381,20 +1395,20 @@ public final OperationFuture setInve *

    When inventory is updated with * [ProductService.CreateProduct][google.cloud.retail.v2alpha.ProductService.CreateProduct] and * [ProductService.UpdateProduct][google.cloud.retail.v2alpha.ProductService.UpdateProduct], the - * specified inventory field value(s) will overwrite any existing value(s) while ignoring the last - * update time for this field. Furthermore, the last update time for the specified inventory - * fields will be overwritten to the time of the + * specified inventory field value(s) overwrite any existing value(s) while ignoring the last + * update time for this field. Furthermore, the last update times for the specified inventory + * fields are overwritten by the times of the * [ProductService.CreateProduct][google.cloud.retail.v2alpha.ProductService.CreateProduct] or * [ProductService.UpdateProduct][google.cloud.retail.v2alpha.ProductService.UpdateProduct] * request. * *

    If no inventory fields are set in * [CreateProductRequest.product][google.cloud.retail.v2alpha.CreateProductRequest.product], then - * any pre-existing inventory information for this product will be used. + * any pre-existing inventory information for this product is used. * *

    If no inventory fields are set in * [SetInventoryRequest.set_mask][google.cloud.retail.v2alpha.SetInventoryRequest.set_mask], then - * any existing inventory information will be preserved. + * any existing inventory information is preserved. * *

    Pre-existing inventory information can only be updated with * [ProductService.SetInventory][google.cloud.retail.v2alpha.ProductService.SetInventory], @@ -1402,8 +1416,15 @@ public final OperationFuture setInve * and * [ProductService.RemoveFulfillmentPlaces][google.cloud.retail.v2alpha.ProductService.RemoveFulfillmentPlaces]. * - *

    This feature is only available for users who have Retail Search enabled. Please enable - * Retail Search on Cloud Console before using this feature. + *

    The returned [Operation][google.longrunning.Operation]s is obsolete after one day, and the + * [GetOperation][google.longrunning.Operations.GetOperation] API returns `NOT_FOUND` afterwards. + * + *

    If conflicting updates are issued, the [Operation][google.longrunning.Operation]s associated + * with the stale updates are not marked as [done][google.longrunning.Operation.done] until they + * are obsolete. + * + *

    This feature is only available for users who have Retail Search enabled. Enable Retail + * Search on Cloud Console before using this feature. * *

    Sample code: * @@ -1440,8 +1461,8 @@ public final OperationFuture setInve * *

    This process is asynchronous and does not require the * [Product][google.cloud.retail.v2alpha.Product] to exist before updating fulfillment - * information. If the request is valid, the update will be enqueued and processed downstream. As - * a consequence, when a response is returned, updates are not immediately manifested in the + * information. If the request is valid, the update is enqueued and processed downstream. As a + * consequence, when a response is returned, updates are not immediately manifested in the * [Product][google.cloud.retail.v2alpha.Product] queried by * [ProductService.GetProduct][google.cloud.retail.v2alpha.ProductService.GetProduct] or * [ProductService.ListProducts][google.cloud.retail.v2alpha.ProductService.ListProducts]. @@ -1449,20 +1470,20 @@ public final OperationFuture setInve *

    When inventory is updated with * [ProductService.CreateProduct][google.cloud.retail.v2alpha.ProductService.CreateProduct] and * [ProductService.UpdateProduct][google.cloud.retail.v2alpha.ProductService.UpdateProduct], the - * specified inventory field value(s) will overwrite any existing value(s) while ignoring the last - * update time for this field. Furthermore, the last update time for the specified inventory - * fields will be overwritten to the time of the + * specified inventory field value(s) overwrite any existing value(s) while ignoring the last + * update time for this field. Furthermore, the last update times for the specified inventory + * fields are overwritten by the times of the * [ProductService.CreateProduct][google.cloud.retail.v2alpha.ProductService.CreateProduct] or * [ProductService.UpdateProduct][google.cloud.retail.v2alpha.ProductService.UpdateProduct] * request. * *

    If no inventory fields are set in * [CreateProductRequest.product][google.cloud.retail.v2alpha.CreateProductRequest.product], then - * any pre-existing inventory information for this product will be used. + * any pre-existing inventory information for this product is used. * *

    If no inventory fields are set in * [SetInventoryRequest.set_mask][google.cloud.retail.v2alpha.SetInventoryRequest.set_mask], then - * any existing inventory information will be preserved. + * any existing inventory information is preserved. * *

    Pre-existing inventory information can only be updated with * [ProductService.SetInventory][google.cloud.retail.v2alpha.ProductService.SetInventory], @@ -1470,8 +1491,15 @@ public final OperationFuture setInve * and * [ProductService.RemoveFulfillmentPlaces][google.cloud.retail.v2alpha.ProductService.RemoveFulfillmentPlaces]. * - *

    This feature is only available for users who have Retail Search enabled. Please enable - * Retail Search on Cloud Console before using this feature. + *

    The returned [Operation][google.longrunning.Operation]s is obsolete after one day, and the + * [GetOperation][google.longrunning.Operations.GetOperation] API returns `NOT_FOUND` afterwards. + * + *

    If conflicting updates are issued, the [Operation][google.longrunning.Operation]s associated + * with the stale updates are not marked as [done][google.longrunning.Operation.done] until they + * are obsolete. + * + *

    This feature is only available for users who have Retail Search enabled. Enable Retail + * Search on Cloud Console before using this feature. * *

    Sample code: * @@ -1512,8 +1540,16 @@ public final UnaryCallable setInventoryCallable( * [ProductService.GetProduct][google.cloud.retail.v2alpha.ProductService.GetProduct] or * [ProductService.ListProducts][google.cloud.retail.v2alpha.ProductService.ListProducts]. * - *

    This feature is only available for users who have Retail Search enabled. Please enable - * Retail Search on Cloud Console before using this feature. + *

    The returned [Operation][google.longrunning.Operation]s will be obsolete after 1 day, and + * [GetOperation][google.longrunning.Operations.GetOperation] API will return NOT_FOUND + * afterwards. + * + *

    If conflicting updates are issued, the [Operation][google.longrunning.Operation]s associated + * with the stale updates will not be marked as [done][google.longrunning.Operation.done] until + * being obsolete. + * + *

    This feature is only available for users who have Retail Search enabled. Enable Retail + * Search on Cloud Console before using this feature. * *

    Sample code: * @@ -1561,8 +1597,16 @@ public final UnaryCallable setInventoryCallable( * [ProductService.GetProduct][google.cloud.retail.v2alpha.ProductService.GetProduct] or * [ProductService.ListProducts][google.cloud.retail.v2alpha.ProductService.ListProducts]. * - *

    This feature is only available for users who have Retail Search enabled. Please enable - * Retail Search on Cloud Console before using this feature. + *

    The returned [Operation][google.longrunning.Operation]s will be obsolete after 1 day, and + * [GetOperation][google.longrunning.Operations.GetOperation] API will return NOT_FOUND + * afterwards. + * + *

    If conflicting updates are issued, the [Operation][google.longrunning.Operation]s associated + * with the stale updates will not be marked as [done][google.longrunning.Operation.done] until + * being obsolete. + * + *

    This feature is only available for users who have Retail Search enabled. Enable Retail + * Search on Cloud Console before using this feature. * *

    Sample code: * @@ -1609,8 +1653,16 @@ public final UnaryCallable setInventoryCallable( * [ProductService.GetProduct][google.cloud.retail.v2alpha.ProductService.GetProduct] or * [ProductService.ListProducts][google.cloud.retail.v2alpha.ProductService.ListProducts]. * - *

    This feature is only available for users who have Retail Search enabled. Please enable - * Retail Search on Cloud Console before using this feature. + *

    The returned [Operation][google.longrunning.Operation]s will be obsolete after 1 day, and + * [GetOperation][google.longrunning.Operations.GetOperation] API will return NOT_FOUND + * afterwards. + * + *

    If conflicting updates are issued, the [Operation][google.longrunning.Operation]s associated + * with the stale updates will not be marked as [done][google.longrunning.Operation.done] until + * being obsolete. + * + *

    This feature is only available for users who have Retail Search enabled. Enable Retail + * Search on Cloud Console before using this feature. * *

    Sample code: * @@ -1657,8 +1709,16 @@ public final UnaryCallable setInventoryCallable( * [ProductService.GetProduct][google.cloud.retail.v2alpha.ProductService.GetProduct] or * [ProductService.ListProducts][google.cloud.retail.v2alpha.ProductService.ListProducts]. * - *

    This feature is only available for users who have Retail Search enabled. Please enable - * Retail Search on Cloud Console before using this feature. + *

    The returned [Operation][google.longrunning.Operation]s will be obsolete after 1 day, and + * [GetOperation][google.longrunning.Operations.GetOperation] API will return NOT_FOUND + * afterwards. + * + *

    If conflicting updates are issued, the [Operation][google.longrunning.Operation]s associated + * with the stale updates will not be marked as [done][google.longrunning.Operation.done] until + * being obsolete. + * + *

    This feature is only available for users who have Retail Search enabled. Enable Retail + * Search on Cloud Console before using this feature. * *

    Sample code: * @@ -1705,8 +1765,16 @@ public final UnaryCallable setInventoryCallable( * [ProductService.GetProduct][google.cloud.retail.v2alpha.ProductService.GetProduct] or * [ProductService.ListProducts][google.cloud.retail.v2alpha.ProductService.ListProducts]. * - *

    This feature is only available for users who have Retail Search enabled. Please enable - * Retail Search on Cloud Console before using this feature. + *

    The returned [Operation][google.longrunning.Operation]s will be obsolete after 1 day, and + * [GetOperation][google.longrunning.Operations.GetOperation] API will return NOT_FOUND + * afterwards. + * + *

    If conflicting updates are issued, the [Operation][google.longrunning.Operation]s associated + * with the stale updates will not be marked as [done][google.longrunning.Operation.done] until + * being obsolete. + * + *

    This feature is only available for users who have Retail Search enabled. Enable Retail + * Search on Cloud Console before using this feature. * *

    Sample code: * @@ -1752,8 +1820,16 @@ public final UnaryCallable setInventoryCallable( * [ProductService.GetProduct][google.cloud.retail.v2alpha.ProductService.GetProduct] or * [ProductService.ListProducts][google.cloud.retail.v2alpha.ProductService.ListProducts]. * - *

    This feature is only available for users who have Retail Search enabled. Please enable - * Retail Search on Cloud Console before using this feature. + *

    The returned [Operation][google.longrunning.Operation]s will be obsolete after 1 day, and + * [GetOperation][google.longrunning.Operations.GetOperation] API will return NOT_FOUND + * afterwards. + * + *

    If conflicting updates are issued, the [Operation][google.longrunning.Operation]s associated + * with the stale updates will not be marked as [done][google.longrunning.Operation.done] until + * being obsolete. + * + *

    This feature is only available for users who have Retail Search enabled. Enable Retail + * Search on Cloud Console before using this feature. * *

    Sample code: * @@ -1801,8 +1877,16 @@ public final UnaryCallable setInventoryCallable( * [ProductService.GetProduct][google.cloud.retail.v2alpha.ProductService.GetProduct] or * [ProductService.ListProducts][google.cloud.retail.v2alpha.ProductService.ListProducts]. * - *

    This feature is only available for users who have Retail Search enabled. Please enable - * Retail Search on Cloud Console before using this feature. + *

    The returned [Operation][google.longrunning.Operation]s will be obsolete after 1 day, and + * [GetOperation][google.longrunning.Operations.GetOperation] API will return NOT_FOUND + * afterwards. + * + *

    If conflicting updates are issued, the [Operation][google.longrunning.Operation]s associated + * with the stale updates will not be marked as [done][google.longrunning.Operation.done] until + * being obsolete. + * + *

    This feature is only available for users who have Retail Search enabled. Enable Retail + * Search on Cloud Console before using this feature. * *

    Sample code: * @@ -1849,8 +1933,16 @@ public final UnaryCallable setInventoryCallable( * [ProductService.GetProduct][google.cloud.retail.v2alpha.ProductService.GetProduct] or * [ProductService.ListProducts][google.cloud.retail.v2alpha.ProductService.ListProducts]. * - *

    This feature is only available for users who have Retail Search enabled. Please enable - * Retail Search on Cloud Console before using this feature. + *

    The returned [Operation][google.longrunning.Operation]s will be obsolete after 1 day, and + * [GetOperation][google.longrunning.Operations.GetOperation] API will return NOT_FOUND + * afterwards. + * + *

    If conflicting updates are issued, the [Operation][google.longrunning.Operation]s associated + * with the stale updates will not be marked as [done][google.longrunning.Operation.done] until + * being obsolete. + * + *

    This feature is only available for users who have Retail Search enabled. Enable Retail + * Search on Cloud Console before using this feature. * *

    Sample code: * @@ -1897,8 +1989,16 @@ public final UnaryCallable setInventoryCallable( * [ProductService.GetProduct][google.cloud.retail.v2alpha.ProductService.GetProduct] or * [ProductService.ListProducts][google.cloud.retail.v2alpha.ProductService.ListProducts]. * - *

    This feature is only available for users who have Retail Search enabled. Please enable - * Retail Search on Cloud Console before using this feature. + *

    The returned [Operation][google.longrunning.Operation]s will be obsolete after 1 day, and + * [GetOperation][google.longrunning.Operations.GetOperation] API will return NOT_FOUND + * afterwards. + * + *

    If conflicting updates are issued, the [Operation][google.longrunning.Operation]s associated + * with the stale updates will not be marked as [done][google.longrunning.Operation.done] until + * being obsolete. + * + *

    This feature is only available for users who have Retail Search enabled. Enable Retail + * Search on Cloud Console before using this feature. * *

    Sample code: * @@ -1947,8 +2047,16 @@ public final UnaryCallable setInventoryCallable( * [ProductService.GetProduct][google.cloud.retail.v2alpha.ProductService.GetProduct] or * [ProductService.ListProducts][google.cloud.retail.v2alpha.ProductService.ListProducts]. * - *

    This feature is only available for users who have Retail Search enabled. Please enable - * Retail Search on Cloud Console before using this feature. + *

    The returned [Operation][google.longrunning.Operation]s will be obsolete after 1 day, and + * [GetOperation][google.longrunning.Operations.GetOperation] API will return NOT_FOUND + * afterwards. + * + *

    If conflicting updates are issued, the [Operation][google.longrunning.Operation]s associated + * with the stale updates will not be marked as [done][google.longrunning.Operation.done] until + * being obsolete. + * + *

    This feature is only available for users who have Retail Search enabled. Enable Retail + * Search on Cloud Console before using this feature. * *

    Sample code: * @@ -1999,8 +2107,16 @@ public final UnaryCallable setInventoryCallable( * [ProductService.UpdateProduct][google.cloud.retail.v2alpha.ProductService.UpdateProduct] has no * effect on local inventories. * - *

    This feature is only available for users who have Retail Search enabled. Please enable - * Retail Search on Cloud Console before using this feature. + *

    The returned [Operation][google.longrunning.Operation]s will be obsolete after 1 day, and + * [GetOperation][google.longrunning.Operations.GetOperation] API will return NOT_FOUND + * afterwards. + * + *

    If conflicting updates are issued, the [Operation][google.longrunning.Operation]s associated + * with the stale updates will not be marked as [done][google.longrunning.Operation.done] until + * being obsolete. + * + *

    This feature is only available for users who have Retail Search enabled. Enable Retail + * Search on Cloud Console before using this feature. * *

    Sample code: * @@ -2053,8 +2169,16 @@ public final UnaryCallable setInventoryCallable( * [ProductService.UpdateProduct][google.cloud.retail.v2alpha.ProductService.UpdateProduct] has no * effect on local inventories. * - *

    This feature is only available for users who have Retail Search enabled. Please enable - * Retail Search on Cloud Console before using this feature. + *

    The returned [Operation][google.longrunning.Operation]s will be obsolete after 1 day, and + * [GetOperation][google.longrunning.Operations.GetOperation] API will return NOT_FOUND + * afterwards. + * + *

    If conflicting updates are issued, the [Operation][google.longrunning.Operation]s associated + * with the stale updates will not be marked as [done][google.longrunning.Operation.done] until + * being obsolete. + * + *

    This feature is only available for users who have Retail Search enabled. Enable Retail + * Search on Cloud Console before using this feature. * *

    Sample code: * @@ -2106,8 +2230,16 @@ public final UnaryCallable setInventoryCallable( * [ProductService.UpdateProduct][google.cloud.retail.v2alpha.ProductService.UpdateProduct] has no * effect on local inventories. * - *

    This feature is only available for users who have Retail Search enabled. Please enable - * Retail Search on Cloud Console before using this feature. + *

    The returned [Operation][google.longrunning.Operation]s will be obsolete after 1 day, and + * [GetOperation][google.longrunning.Operations.GetOperation] API will return NOT_FOUND + * afterwards. + * + *

    If conflicting updates are issued, the [Operation][google.longrunning.Operation]s associated + * with the stale updates will not be marked as [done][google.longrunning.Operation.done] until + * being obsolete. + * + *

    This feature is only available for users who have Retail Search enabled. Enable Retail + * Search on Cloud Console before using this feature. * *

    Sample code: * @@ -2159,8 +2291,16 @@ public final UnaryCallable setInventoryCallable( * [ProductService.UpdateProduct][google.cloud.retail.v2alpha.ProductService.UpdateProduct] has no * effect on local inventories. * - *

    This feature is only available for users who have Retail Search enabled. Please enable - * Retail Search on Cloud Console before using this feature. + *

    The returned [Operation][google.longrunning.Operation]s will be obsolete after 1 day, and + * [GetOperation][google.longrunning.Operations.GetOperation] API will return NOT_FOUND + * afterwards. + * + *

    If conflicting updates are issued, the [Operation][google.longrunning.Operation]s associated + * with the stale updates will not be marked as [done][google.longrunning.Operation.done] until + * being obsolete. + * + *

    This feature is only available for users who have Retail Search enabled. Enable Retail + * Search on Cloud Console before using this feature. * *

    Sample code: * @@ -2212,8 +2352,16 @@ public final UnaryCallable setInventoryCallable( * [ProductService.UpdateProduct][google.cloud.retail.v2alpha.ProductService.UpdateProduct] has no * effect on local inventories. * - *

    This feature is only available for users who have Retail Search enabled. Please enable - * Retail Search on Cloud Console before using this feature. + *

    The returned [Operation][google.longrunning.Operation]s will be obsolete after 1 day, and + * [GetOperation][google.longrunning.Operations.GetOperation] API will return NOT_FOUND + * afterwards. + * + *

    If conflicting updates are issued, the [Operation][google.longrunning.Operation]s associated + * with the stale updates will not be marked as [done][google.longrunning.Operation.done] until + * being obsolete. + * + *

    This feature is only available for users who have Retail Search enabled. Enable Retail + * Search on Cloud Console before using this feature. * *

    Sample code: * @@ -2261,8 +2409,16 @@ public final UnaryCallable addLocalInvent * [ProductService.UpdateProduct][google.cloud.retail.v2alpha.ProductService.UpdateProduct] has no * effect on local inventories. * - *

    This feature is only available for users who have Retail Search enabled. Please enable - * Retail Search on Cloud Console before using this feature. + *

    The returned [Operation][google.longrunning.Operation]s will be obsolete after 1 day, and + * [GetOperation][google.longrunning.Operations.GetOperation] API will return NOT_FOUND + * afterwards. + * + *

    If conflicting updates are issued, the [Operation][google.longrunning.Operation]s associated + * with the stale updates will not be marked as [done][google.longrunning.Operation.done] until + * being obsolete. + * + *

    This feature is only available for users who have Retail Search enabled. Enable Retail + * Search on Cloud Console before using this feature. * *

    Sample code: * @@ -2313,8 +2469,16 @@ public final UnaryCallable addLocalInvent * [ProductService.UpdateProduct][google.cloud.retail.v2alpha.ProductService.UpdateProduct] has no * effect on local inventories. * - *

    This feature is only available for users who have Retail Search enabled. Please enable - * Retail Search on Cloud Console before using this feature. + *

    The returned [Operation][google.longrunning.Operation]s will be obsolete after 1 day, and + * [GetOperation][google.longrunning.Operations.GetOperation] API will return NOT_FOUND + * afterwards. + * + *

    If conflicting updates are issued, the [Operation][google.longrunning.Operation]s associated + * with the stale updates will not be marked as [done][google.longrunning.Operation.done] until + * being obsolete. + * + *

    This feature is only available for users who have Retail Search enabled. Enable Retail + * Search on Cloud Console before using this feature. * *

    Sample code: * @@ -2364,8 +2528,16 @@ public final UnaryCallable addLocalInvent * [ProductService.UpdateProduct][google.cloud.retail.v2alpha.ProductService.UpdateProduct] has no * effect on local inventories. * - *

    This feature is only available for users who have Retail Search enabled. Please enable - * Retail Search on Cloud Console before using this feature. + *

    The returned [Operation][google.longrunning.Operation]s will be obsolete after 1 day, and + * [GetOperation][google.longrunning.Operations.GetOperation] API will return NOT_FOUND + * afterwards. + * + *

    If conflicting updates are issued, the [Operation][google.longrunning.Operation]s associated + * with the stale updates will not be marked as [done][google.longrunning.Operation.done] until + * being obsolete. + * + *

    This feature is only available for users who have Retail Search enabled. Enable Retail + * Search on Cloud Console before using this feature. * *

    Sample code: * @@ -2414,8 +2586,16 @@ public final UnaryCallable addLocalInvent * [ProductService.UpdateProduct][google.cloud.retail.v2alpha.ProductService.UpdateProduct] has no * effect on local inventories. * - *

    This feature is only available for users who have Retail Search enabled. Please enable - * Retail Search on Cloud Console before using this feature. + *

    The returned [Operation][google.longrunning.Operation]s will be obsolete after 1 day, and + * [GetOperation][google.longrunning.Operations.GetOperation] API will return NOT_FOUND + * afterwards. + * + *

    If conflicting updates are issued, the [Operation][google.longrunning.Operation]s associated + * with the stale updates will not be marked as [done][google.longrunning.Operation.done] until + * being obsolete. + * + *

    This feature is only available for users who have Retail Search enabled. Enable Retail + * Search on Cloud Console before using this feature. * *

    Sample code: * @@ -2466,8 +2646,16 @@ public final UnaryCallable addLocalInvent * [ProductService.UpdateProduct][google.cloud.retail.v2alpha.ProductService.UpdateProduct] has no * effect on local inventories. * - *

    This feature is only available for users who have Retail Search enabled. Please enable - * Retail Search on Cloud Console before using this feature. + *

    The returned [Operation][google.longrunning.Operation]s will be obsolete after 1 day, and + * [GetOperation][google.longrunning.Operations.GetOperation] API will return NOT_FOUND + * afterwards. + * + *

    If conflicting updates are issued, the [Operation][google.longrunning.Operation]s associated + * with the stale updates will not be marked as [done][google.longrunning.Operation.done] until + * being obsolete. + * + *

    This feature is only available for users who have Retail Search enabled. Enable Retail + * Search on Cloud Console before using this feature. * *

    Sample code: * diff --git a/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2alpha/SearchServiceClient.java b/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2alpha/SearchServiceClient.java index 1d277e53ff23..72e5957f79a8 100644 --- a/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2alpha/SearchServiceClient.java +++ b/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2alpha/SearchServiceClient.java @@ -37,8 +37,8 @@ /** * Service Description: Service for search. * - *

    This feature is only available for users who have Retail Search enabled. Please enable Retail - * Search on Cloud Console before using this feature. + *

    This feature is only available for users who have Retail Search enabled. Enable Retail Search + * on Cloud Console before using this feature. * *

    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 SearchServiceStub getStub() { /** * Performs a search. * - *

    This feature is only available for users who have Retail Search enabled. Please enable - * Retail Search on Cloud Console before using this feature. + *

    This feature is only available for users who have Retail Search enabled. Enable Retail + * Search on Cloud Console before using this feature. * *

    Sample code: * @@ -258,8 +258,8 @@ public final SearchPagedResponse search(SearchRequest request) { /** * Performs a search. * - *

    This feature is only available for users who have Retail Search enabled. Please enable - * Retail Search on Cloud Console before using this feature. + *

    This feature is only available for users who have Retail Search enabled. Enable Retail + * Search on Cloud Console before using this feature. * *

    Sample code: * @@ -311,8 +311,8 @@ public final UnaryCallable searchPagedCallab /** * Performs a search. * - *

    This feature is only available for users who have Retail Search enabled. Please enable - * Retail Search on Cloud Console before using this feature. + *

    This feature is only available for users who have Retail Search enabled. Enable Retail + * Search on Cloud Console before using this feature. * *

    Sample code: * diff --git a/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2alpha/ServingConfigServiceClient.java b/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2alpha/ServingConfigServiceClient.java index 6f072e3124bf..9083d8018653 100644 --- a/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2alpha/ServingConfigServiceClient.java +++ b/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2alpha/ServingConfigServiceClient.java @@ -367,7 +367,7 @@ public final ServingConfig createServingConfig(CreateServingConfigRequest reques * } * * @param name Required. The resource name of the ServingConfig to delete. Format: - * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id} + * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}` * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ public final void deleteServingConfig(ServingConfigName name) { @@ -402,7 +402,7 @@ public final void deleteServingConfig(ServingConfigName name) { * } * * @param name Required. The resource name of the ServingConfig to delete. Format: - * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id} + * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}` * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ public final void deleteServingConfig(String name) { @@ -602,7 +602,7 @@ public final ServingConfig updateServingConfig(UpdateServingConfigRequest reques * } * * @param name Required. The resource name of the ServingConfig to get. Format: - * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id} + * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}` * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ public final ServingConfig getServingConfig(ServingConfigName name) { @@ -635,7 +635,7 @@ public final ServingConfig getServingConfig(ServingConfigName name) { * } * * @param name Required. The resource name of the ServingConfig to get. Format: - * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id} + * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}` * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ public final ServingConfig getServingConfig(String name) { @@ -732,7 +732,7 @@ public final UnaryCallable getServingCon * } * * @param parent Required. The catalog resource name. Format: - * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id} + * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}` * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ public final ListServingConfigsPagedResponse listServingConfigs(CatalogName parent) { @@ -766,7 +766,7 @@ public final ListServingConfigsPagedResponse listServingConfigs(CatalogName pare * } * * @param parent Required. The catalog resource name. Format: - * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id} + * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}` * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ public final ListServingConfigsPagedResponse listServingConfigs(String parent) { @@ -910,7 +910,7 @@ public final ListServingConfigsPagedResponse listServingConfigs( * } * * @param servingConfig Required. The source ServingConfig resource name . Format: - * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id} + * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}` * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ public final ServingConfig addControl(ServingConfigName servingConfig) { @@ -947,7 +947,7 @@ public final ServingConfig addControl(ServingConfigName servingConfig) { * } * * @param servingConfig Required. The source ServingConfig resource name . Format: - * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id} + * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}` * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ public final ServingConfig addControl(String servingConfig) { @@ -1050,7 +1050,7 @@ public final UnaryCallable addControlCallable( * } * * @param servingConfig Required. The source ServingConfig resource name . Format: - * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id} + * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}` * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ public final ServingConfig removeControl(ServingConfigName servingConfig) { @@ -1084,7 +1084,7 @@ public final ServingConfig removeControl(ServingConfigName servingConfig) { * } * * @param servingConfig Required. The source ServingConfig resource name . Format: - * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id} + * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}` * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ public final ServingConfig removeControl(String servingConfig) { diff --git a/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2alpha/UserEventServiceClient.java b/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2alpha/UserEventServiceClient.java index fa0f884b1e1c..1a7c9092edf3 100644 --- a/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2alpha/UserEventServiceClient.java +++ b/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2alpha/UserEventServiceClient.java @@ -48,6 +48,7 @@ * WriteUserEventRequest.newBuilder() * .setParent("parent-995424086") * .setUserEvent(UserEvent.newBuilder().build()) + * .setWriteAsync(true) * .build(); * UserEvent response = userEventServiceClient.writeUserEvent(request); * } @@ -220,6 +221,7 @@ public final OperationsClient getHttpJsonOperationsClient() { * WriteUserEventRequest.newBuilder() * .setParent("parent-995424086") * .setUserEvent(UserEvent.newBuilder().build()) + * .setWriteAsync(true) * .build(); * UserEvent response = userEventServiceClient.writeUserEvent(request); * } @@ -249,6 +251,7 @@ public final UserEvent writeUserEvent(WriteUserEventRequest request) { * WriteUserEventRequest.newBuilder() * .setParent("parent-995424086") * .setUserEvent(UserEvent.newBuilder().build()) + * .setWriteAsync(true) * .build(); * ApiFuture future = * userEventServiceClient.writeUserEventCallable().futureCall(request); @@ -284,6 +287,7 @@ public final UnaryCallable writeUserEventCalla * .setUserEvent("userEvent315571599") * .setUri("uri116076") * .setEts(100772) + * .setRawJson("rawJson985449776") * .build(); * HttpBody response = userEventServiceClient.collectUserEvent(request); * } @@ -319,6 +323,7 @@ public final HttpBody collectUserEvent(CollectUserEventRequest request) { * .setUserEvent("userEvent315571599") * .setUri("uri116076") * .setEts(100772) + * .setRawJson("rawJson985449776") * .build(); * ApiFuture future = * userEventServiceClient.collectUserEventCallable().futureCall(request); @@ -434,8 +439,8 @@ public final UnaryCallable purgeUserEventsCal * Bulk import of User events. Request processing might be synchronous. Events that already exist * are skipped. Use this method for backfilling historical user events. * - *

    Operation.response is of type ImportResponse. Note that it is possible for a subset of the - * items to be successfully inserted. Operation.metadata is of type ImportMetadata. + *

    `Operation.response` is of type `ImportResponse`. Note that it is possible for a subset of + * the items to be successfully inserted. `Operation.metadata` is of type `ImportMetadata`. * *

    Sample code: * @@ -470,8 +475,8 @@ public final OperationFuture importUse * Bulk import of User events. Request processing might be synchronous. Events that already exist * are skipped. Use this method for backfilling historical user events. * - *

    Operation.response is of type ImportResponse. Note that it is possible for a subset of the - * items to be successfully inserted. Operation.metadata is of type ImportMetadata. + *

    `Operation.response` is of type `ImportResponse`. Note that it is possible for a subset of + * the items to be successfully inserted. `Operation.metadata` is of type `ImportMetadata`. * *

    Sample code: * @@ -505,8 +510,8 @@ public final OperationFuture importUse * Bulk import of User events. Request processing might be synchronous. Events that already exist * are skipped. Use this method for backfilling historical user events. * - *

    Operation.response is of type ImportResponse. Note that it is possible for a subset of the - * items to be successfully inserted. Operation.metadata is of type ImportMetadata. + *

    `Operation.response` is of type `ImportResponse`. Note that it is possible for a subset of + * the items to be successfully inserted. `Operation.metadata` is of type `ImportMetadata`. * *

    Sample code: * @@ -536,11 +541,11 @@ public final UnaryCallable importUserEventsC // AUTO-GENERATED DOCUMENTATION AND METHOD. /** - * Starts a user event rejoin operation with latest product catalog. Events will not be annotated - * with detailed product information if product is missing from the catalog at the time the user - * event is ingested, and these events are stored as unjoined events with a limited usage on - * training and serving. This method can be used to start a join operation on specified events - * with latest version of product catalog. It can also be used to correct events joined with the + * Starts a user-event rejoin operation with latest product catalog. Events are not annotated with + * detailed product information for products that are missing from the catalog when the user event + * is ingested. These events are stored as unjoined events with limited usage on training and + * serving. You can use this method to start a join operation on specified events with the latest + * version of product catalog. You can also use this method to correct events joined with the * wrong product catalog. A rejoin operation can take hours or days to complete. * *

    Sample code: @@ -569,11 +574,11 @@ public final UnaryCallable importUserEventsC // AUTO-GENERATED DOCUMENTATION AND METHOD. /** - * Starts a user event rejoin operation with latest product catalog. Events will not be annotated - * with detailed product information if product is missing from the catalog at the time the user - * event is ingested, and these events are stored as unjoined events with a limited usage on - * training and serving. This method can be used to start a join operation on specified events - * with latest version of product catalog. It can also be used to correct events joined with the + * Starts a user-event rejoin operation with latest product catalog. Events are not annotated with + * detailed product information for products that are missing from the catalog when the user event + * is ingested. These events are stored as unjoined events with limited usage on training and + * serving. You can use this method to start a join operation on specified events with the latest + * version of product catalog. You can also use this method to correct events joined with the * wrong product catalog. A rejoin operation can take hours or days to complete. * *

    Sample code: @@ -602,11 +607,11 @@ public final UnaryCallable importUserEventsC // AUTO-GENERATED DOCUMENTATION AND METHOD. /** - * Starts a user event rejoin operation with latest product catalog. Events will not be annotated - * with detailed product information if product is missing from the catalog at the time the user - * event is ingested, and these events are stored as unjoined events with a limited usage on - * training and serving. This method can be used to start a join operation on specified events - * with latest version of product catalog. It can also be used to correct events joined with the + * Starts a user-event rejoin operation with latest product catalog. Events are not annotated with + * detailed product information for products that are missing from the catalog when the user event + * is ingested. These events are stored as unjoined events with limited usage on training and + * serving. You can use this method to start a join operation on specified events with the latest + * version of product catalog. You can also use this method to correct events joined with the * wrong product catalog. A rejoin operation can take hours or days to complete. * *

    Sample code: diff --git a/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2alpha/gapic_metadata.json b/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2alpha/gapic_metadata.json index 2cfd38ec602a..15b87963a7e9 100644 --- a/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2alpha/gapic_metadata.json +++ b/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2alpha/gapic_metadata.json @@ -13,6 +13,9 @@ "AddCatalogAttribute": { "methods": ["addCatalogAttribute", "addCatalogAttributeCallable"] }, + "BatchRemoveCatalogAttributes": { + "methods": ["batchRemoveCatalogAttributes", "batchRemoveCatalogAttributesCallable"] + }, "GetAttributesConfig": { "methods": ["getAttributesConfig", "getAttributesConfig", "getAttributesConfig", "getAttributesConfigCallable"] }, diff --git a/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2alpha/package-info.java b/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2alpha/package-info.java index 6313a3385af9..317a979004ee 100644 --- a/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2alpha/package-info.java +++ b/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2alpha/package-info.java @@ -42,8 +42,8 @@ * *

    Service Description: Auto-completion service for retail. * - *

    This feature is only available for users who have Retail Search enabled. Please enable Retail - * Search on Cloud Console before using this feature. + *

    This feature is only available for users who have Retail Search enabled. Enable Retail Search + * on Cloud Console before using this feature. * *

    Sample for CompletionServiceClient: * @@ -63,6 +63,7 @@ * .setDeviceType("deviceType781190832") * .setDataset("dataset1443214456") * .setMaxSuggestions(618824852) + * .setEnableAttributeSuggestions(true) * .build(); * CompleteQueryResponse response = completionServiceClient.completeQuery(request); * } @@ -91,11 +92,11 @@ *

    ======================= ModelServiceClient ======================= * *

    Service Description: Service for performing CRUD operations on models. Recommendation models - * contain all the metadata necessary to generate a set of models for the Predict() api. A model is - * queried indirectly via a ServingConfig, which associates a model with a given Placement (e.g. + * contain all the metadata necessary to generate a set of models for the `Predict()` API. A model + * is queried indirectly via a ServingConfig, which associates a model with a given Placement (e.g. * Frequently Bought Together on Home Page). * - *

    This service allows customers to e.g.: + *

    This service allows you to do the following: * *

      *
    • Initiate training of a model. @@ -171,8 +172,8 @@ * *

      Service Description: Service for search. * - *

      This feature is only available for users who have Retail Search enabled. Please enable Retail - * Search on Cloud Console before using this feature. + *

      This feature is only available for users who have Retail Search enabled. Enable Retail Search + * on Cloud Console before using this feature. * *

      Sample for SearchServiceClient: * @@ -252,6 +253,7 @@ * WriteUserEventRequest.newBuilder() * .setParent("parent-995424086") * .setUserEvent(UserEvent.newBuilder().build()) + * .setWriteAsync(true) * .build(); * UserEvent response = userEventServiceClient.writeUserEvent(request); * } diff --git a/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2alpha/stub/CatalogServiceStub.java b/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2alpha/stub/CatalogServiceStub.java index 88ac6f552fd1..35c2204ff022 100644 --- a/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2alpha/stub/CatalogServiceStub.java +++ b/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2alpha/stub/CatalogServiceStub.java @@ -23,6 +23,8 @@ import com.google.api.gax.rpc.UnaryCallable; import com.google.cloud.retail.v2alpha.AddCatalogAttributeRequest; import com.google.cloud.retail.v2alpha.AttributesConfig; +import com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesRequest; +import com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesResponse; import com.google.cloud.retail.v2alpha.Catalog; import com.google.cloud.retail.v2alpha.CompletionConfig; import com.google.cloud.retail.v2alpha.GetAttributesConfigRequest; @@ -98,6 +100,12 @@ public UnaryCallable addCatalogAtt throw new UnsupportedOperationException("Not implemented: removeCatalogAttributeCallable()"); } + public UnaryCallable + batchRemoveCatalogAttributesCallable() { + throw new UnsupportedOperationException( + "Not implemented: batchRemoveCatalogAttributesCallable()"); + } + public UnaryCallable replaceCatalogAttributeCallable() { throw new UnsupportedOperationException("Not implemented: replaceCatalogAttributeCallable()"); diff --git a/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2alpha/stub/CatalogServiceStubSettings.java b/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2alpha/stub/CatalogServiceStubSettings.java index 20e248d38299..6747197aa775 100644 --- a/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2alpha/stub/CatalogServiceStubSettings.java +++ b/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2alpha/stub/CatalogServiceStubSettings.java @@ -45,6 +45,8 @@ import com.google.api.gax.rpc.UnaryCallable; import com.google.cloud.retail.v2alpha.AddCatalogAttributeRequest; import com.google.cloud.retail.v2alpha.AttributesConfig; +import com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesRequest; +import com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesResponse; import com.google.cloud.retail.v2alpha.Catalog; import com.google.cloud.retail.v2alpha.CompletionConfig; import com.google.cloud.retail.v2alpha.GetAttributesConfigRequest; @@ -129,6 +131,9 @@ public class CatalogServiceStubSettings extends StubSettings removeCatalogAttributeSettings; + private final UnaryCallSettings< + BatchRemoveCatalogAttributesRequest, BatchRemoveCatalogAttributesResponse> + batchRemoveCatalogAttributesSettings; private final UnaryCallSettings replaceCatalogAttributeSettings; @@ -243,6 +248,13 @@ public UnaryCallSettings setDefaultBranchSetting return removeCatalogAttributeSettings; } + /** Returns the object with the settings used for calls to batchRemoveCatalogAttributes. */ + public UnaryCallSettings< + BatchRemoveCatalogAttributesRequest, BatchRemoveCatalogAttributesResponse> + batchRemoveCatalogAttributesSettings() { + return batchRemoveCatalogAttributesSettings; + } + /** Returns the object with the settings used for calls to replaceCatalogAttribute. */ public UnaryCallSettings replaceCatalogAttributeSettings() { @@ -365,6 +377,8 @@ protected CatalogServiceStubSettings(Builder settingsBuilder) throws IOException updateAttributesConfigSettings = settingsBuilder.updateAttributesConfigSettings().build(); addCatalogAttributeSettings = settingsBuilder.addCatalogAttributeSettings().build(); removeCatalogAttributeSettings = settingsBuilder.removeCatalogAttributeSettings().build(); + batchRemoveCatalogAttributesSettings = + settingsBuilder.batchRemoveCatalogAttributesSettings().build(); replaceCatalogAttributeSettings = settingsBuilder.replaceCatalogAttributeSettings().build(); } @@ -391,6 +405,9 @@ public static class Builder extends StubSettings.Builder removeCatalogAttributeSettings; + private final UnaryCallSettings.Builder< + BatchRemoveCatalogAttributesRequest, BatchRemoveCatalogAttributesResponse> + batchRemoveCatalogAttributesSettings; private final UnaryCallSettings.Builder replaceCatalogAttributeSettings; private static final ImmutableMap> @@ -443,6 +460,7 @@ protected Builder(ClientContext clientContext) { updateAttributesConfigSettings = UnaryCallSettings.newUnaryCallSettingsBuilder(); addCatalogAttributeSettings = UnaryCallSettings.newUnaryCallSettingsBuilder(); removeCatalogAttributeSettings = UnaryCallSettings.newUnaryCallSettingsBuilder(); + batchRemoveCatalogAttributesSettings = UnaryCallSettings.newUnaryCallSettingsBuilder(); replaceCatalogAttributeSettings = UnaryCallSettings.newUnaryCallSettingsBuilder(); unaryMethodSettingsBuilders = @@ -457,6 +475,7 @@ protected Builder(ClientContext clientContext) { updateAttributesConfigSettings, addCatalogAttributeSettings, removeCatalogAttributeSettings, + batchRemoveCatalogAttributesSettings, replaceCatalogAttributeSettings); initDefaults(this); } @@ -474,6 +493,8 @@ protected Builder(CatalogServiceStubSettings settings) { updateAttributesConfigSettings = settings.updateAttributesConfigSettings.toBuilder(); addCatalogAttributeSettings = settings.addCatalogAttributeSettings.toBuilder(); removeCatalogAttributeSettings = settings.removeCatalogAttributeSettings.toBuilder(); + batchRemoveCatalogAttributesSettings = + settings.batchRemoveCatalogAttributesSettings.toBuilder(); replaceCatalogAttributeSettings = settings.replaceCatalogAttributeSettings.toBuilder(); unaryMethodSettingsBuilders = @@ -488,6 +509,7 @@ protected Builder(CatalogServiceStubSettings settings) { updateAttributesConfigSettings, addCatalogAttributeSettings, removeCatalogAttributeSettings, + batchRemoveCatalogAttributesSettings, replaceCatalogAttributeSettings); } @@ -568,6 +590,11 @@ private static Builder initDefaults(Builder builder) { .setRetryableCodes(RETRYABLE_CODE_DEFINITIONS.get("retry_policy_0_codes")) .setRetrySettings(RETRY_PARAM_DEFINITIONS.get("retry_policy_0_params")); + builder + .batchRemoveCatalogAttributesSettings() + .setRetryableCodes(RETRYABLE_CODE_DEFINITIONS.get("retry_policy_0_codes")) + .setRetrySettings(RETRY_PARAM_DEFINITIONS.get("retry_policy_0_params")); + builder .replaceCatalogAttributeSettings() .setRetryableCodes(RETRYABLE_CODE_DEFINITIONS.get("retry_policy_0_codes")) @@ -650,6 +677,13 @@ public UnaryCallSettings.Builder setDefaultBranc return removeCatalogAttributeSettings; } + /** Returns the builder for the settings used for calls to batchRemoveCatalogAttributes. */ + public UnaryCallSettings.Builder< + BatchRemoveCatalogAttributesRequest, BatchRemoveCatalogAttributesResponse> + batchRemoveCatalogAttributesSettings() { + return batchRemoveCatalogAttributesSettings; + } + /** Returns the builder for the settings used for calls to replaceCatalogAttribute. */ public UnaryCallSettings.Builder replaceCatalogAttributeSettings() { diff --git a/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2alpha/stub/GrpcCatalogServiceStub.java b/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2alpha/stub/GrpcCatalogServiceStub.java index cc9faeb16f68..69a1ec2bd20d 100644 --- a/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2alpha/stub/GrpcCatalogServiceStub.java +++ b/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2alpha/stub/GrpcCatalogServiceStub.java @@ -27,6 +27,8 @@ import com.google.api.gax.rpc.UnaryCallable; import com.google.cloud.retail.v2alpha.AddCatalogAttributeRequest; import com.google.cloud.retail.v2alpha.AttributesConfig; +import com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesRequest; +import com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesResponse; import com.google.cloud.retail.v2alpha.Catalog; import com.google.cloud.retail.v2alpha.CompletionConfig; import com.google.cloud.retail.v2alpha.GetAttributesConfigRequest; @@ -163,6 +165,21 @@ public class GrpcCatalogServiceStub extends CatalogServiceStub { .setResponseMarshaller(ProtoUtils.marshaller(AttributesConfig.getDefaultInstance())) .build(); + private static final MethodDescriptor< + BatchRemoveCatalogAttributesRequest, BatchRemoveCatalogAttributesResponse> + batchRemoveCatalogAttributesMethodDescriptor = + MethodDescriptor + . + newBuilder() + .setType(MethodDescriptor.MethodType.UNARY) + .setFullMethodName( + "google.cloud.retail.v2alpha.CatalogService/BatchRemoveCatalogAttributes") + .setRequestMarshaller( + ProtoUtils.marshaller(BatchRemoveCatalogAttributesRequest.getDefaultInstance())) + .setResponseMarshaller( + ProtoUtils.marshaller(BatchRemoveCatalogAttributesResponse.getDefaultInstance())) + .build(); + private static final MethodDescriptor replaceCatalogAttributeMethodDescriptor = MethodDescriptor.newBuilder() @@ -193,6 +210,9 @@ public class GrpcCatalogServiceStub extends CatalogServiceStub { addCatalogAttributeCallable; private final UnaryCallable removeCatalogAttributeCallable; + private final UnaryCallable< + BatchRemoveCatalogAttributesRequest, BatchRemoveCatalogAttributesResponse> + batchRemoveCatalogAttributesCallable; private final UnaryCallable replaceCatalogAttributeCallable; @@ -353,6 +373,20 @@ protected GrpcCatalogServiceStub( return params.build(); }) .build(); + GrpcCallSettings + batchRemoveCatalogAttributesTransportSettings = + GrpcCallSettings + . + newBuilder() + .setMethodDescriptor(batchRemoveCatalogAttributesMethodDescriptor) + .setParamsExtractor( + request -> { + ImmutableMap.Builder params = ImmutableMap.builder(); + params.put( + "attributes_config", String.valueOf(request.getAttributesConfig())); + return params.build(); + }) + .build(); GrpcCallSettings replaceCatalogAttributeTransportSettings = GrpcCallSettings.newBuilder() @@ -411,6 +445,11 @@ protected GrpcCatalogServiceStub( removeCatalogAttributeTransportSettings, settings.removeCatalogAttributeSettings(), clientContext); + this.batchRemoveCatalogAttributesCallable = + callableFactory.createUnaryCallable( + batchRemoveCatalogAttributesTransportSettings, + settings.batchRemoveCatalogAttributesSettings(), + clientContext); this.replaceCatalogAttributeCallable = callableFactory.createUnaryCallable( replaceCatalogAttributeTransportSettings, @@ -484,6 +523,12 @@ public UnaryCallable addCatalogAtt return removeCatalogAttributeCallable; } + @Override + public UnaryCallable + batchRemoveCatalogAttributesCallable() { + return batchRemoveCatalogAttributesCallable; + } + @Override public UnaryCallable replaceCatalogAttributeCallable() { diff --git a/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2alpha/stub/HttpJsonCatalogServiceStub.java b/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2alpha/stub/HttpJsonCatalogServiceStub.java index a56e44ea3ae9..d0f0f37a2404 100644 --- a/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2alpha/stub/HttpJsonCatalogServiceStub.java +++ b/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2alpha/stub/HttpJsonCatalogServiceStub.java @@ -32,6 +32,8 @@ import com.google.api.gax.rpc.UnaryCallable; import com.google.cloud.retail.v2alpha.AddCatalogAttributeRequest; import com.google.cloud.retail.v2alpha.AttributesConfig; +import com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesRequest; +import com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesResponse; import com.google.cloud.retail.v2alpha.Catalog; import com.google.cloud.retail.v2alpha.CompletionConfig; import com.google.cloud.retail.v2alpha.GetAttributesConfigRequest; @@ -448,6 +450,51 @@ public class HttpJsonCatalogServiceStub extends CatalogServiceStub { .build()) .build(); + private static final ApiMethodDescriptor< + BatchRemoveCatalogAttributesRequest, BatchRemoveCatalogAttributesResponse> + batchRemoveCatalogAttributesMethodDescriptor = + ApiMethodDescriptor + . + newBuilder() + .setFullMethodName( + "google.cloud.retail.v2alpha.CatalogService/BatchRemoveCatalogAttributes") + .setHttpMethod("POST") + .setType(ApiMethodDescriptor.MethodType.UNARY) + .setRequestFormatter( + ProtoMessageRequestFormatter.newBuilder() + .setPath( + "/v2alpha/{attributesConfig=projects/*/locations/*/catalogs/*/attributesConfig}:batchRemoveCatalogAttributes", + request -> { + Map fields = new HashMap<>(); + ProtoRestSerializer serializer = + ProtoRestSerializer.create(); + serializer.putPathParam( + fields, "attributesConfig", request.getAttributesConfig()); + return fields; + }) + .setQueryParamsExtractor( + request -> { + Map> fields = new HashMap<>(); + ProtoRestSerializer serializer = + ProtoRestSerializer.create(); + serializer.putQueryParam(fields, "$alt", "json;enum-encoding=int"); + return fields; + }) + .setRequestBodyExtractor( + request -> + ProtoRestSerializer.create() + .toBody( + "*", + request.toBuilder().clearAttributesConfig().build(), + true)) + .build()) + .setResponseParser( + ProtoMessageResponseParser.newBuilder() + .setDefaultInstance(BatchRemoveCatalogAttributesResponse.getDefaultInstance()) + .setDefaultTypeRegistry(typeRegistry) + .build()) + .build(); + private static final ApiMethodDescriptor replaceCatalogAttributeMethodDescriptor = ApiMethodDescriptor.newBuilder() @@ -509,6 +556,9 @@ public class HttpJsonCatalogServiceStub extends CatalogServiceStub { addCatalogAttributeCallable; private final UnaryCallable removeCatalogAttributeCallable; + private final UnaryCallable< + BatchRemoveCatalogAttributesRequest, BatchRemoveCatalogAttributesResponse> + batchRemoveCatalogAttributesCallable; private final UnaryCallable replaceCatalogAttributeCallable; @@ -611,6 +661,14 @@ protected HttpJsonCatalogServiceStub( .setMethodDescriptor(removeCatalogAttributeMethodDescriptor) .setTypeRegistry(typeRegistry) .build(); + HttpJsonCallSettings + batchRemoveCatalogAttributesTransportSettings = + HttpJsonCallSettings + . + newBuilder() + .setMethodDescriptor(batchRemoveCatalogAttributesMethodDescriptor) + .setTypeRegistry(typeRegistry) + .build(); HttpJsonCallSettings replaceCatalogAttributeTransportSettings = HttpJsonCallSettings.newBuilder() @@ -663,6 +721,11 @@ protected HttpJsonCatalogServiceStub( removeCatalogAttributeTransportSettings, settings.removeCatalogAttributeSettings(), clientContext); + this.batchRemoveCatalogAttributesCallable = + callableFactory.createUnaryCallable( + batchRemoveCatalogAttributesTransportSettings, + settings.batchRemoveCatalogAttributesSettings(), + clientContext); this.replaceCatalogAttributeCallable = callableFactory.createUnaryCallable( replaceCatalogAttributeTransportSettings, @@ -686,6 +749,7 @@ public static List getMethodDescriptors() { methodDescriptors.add(updateAttributesConfigMethodDescriptor); methodDescriptors.add(addCatalogAttributeMethodDescriptor); methodDescriptors.add(removeCatalogAttributeMethodDescriptor); + methodDescriptors.add(batchRemoveCatalogAttributesMethodDescriptor); methodDescriptors.add(replaceCatalogAttributeMethodDescriptor); return methodDescriptors; } @@ -749,6 +813,12 @@ public UnaryCallable addCatalogAtt return removeCatalogAttributeCallable; } + @Override + public UnaryCallable + batchRemoveCatalogAttributesCallable() { + return batchRemoveCatalogAttributesCallable; + } + @Override public UnaryCallable replaceCatalogAttributeCallable() { diff --git a/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2alpha/stub/HttpJsonCompletionServiceStub.java b/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2alpha/stub/HttpJsonCompletionServiceStub.java index cd6fd20db9e7..8870ef6b8a47 100644 --- a/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2alpha/stub/HttpJsonCompletionServiceStub.java +++ b/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2alpha/stub/HttpJsonCompletionServiceStub.java @@ -85,6 +85,10 @@ public class HttpJsonCompletionServiceStub extends CompletionServiceStub { ProtoRestSerializer.create(); serializer.putQueryParam(fields, "dataset", request.getDataset()); serializer.putQueryParam(fields, "deviceType", request.getDeviceType()); + serializer.putQueryParam( + fields, + "enableAttributeSuggestions", + request.getEnableAttributeSuggestions()); serializer.putQueryParam( fields, "languageCodes", request.getLanguageCodesList()); serializer.putQueryParam( diff --git a/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2alpha/stub/HttpJsonUserEventServiceStub.java b/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2alpha/stub/HttpJsonUserEventServiceStub.java index fda116831dc1..9aca37369b1f 100644 --- a/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2alpha/stub/HttpJsonUserEventServiceStub.java +++ b/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2alpha/stub/HttpJsonUserEventServiceStub.java @@ -95,6 +95,7 @@ public class HttpJsonUserEventServiceStub extends UserEventServiceStub { Map> fields = new HashMap<>(); ProtoRestSerializer serializer = ProtoRestSerializer.create(); + serializer.putQueryParam(fields, "writeAsync", request.getWriteAsync()); serializer.putQueryParam(fields, "$alt", "json;enum-encoding=int"); return fields; }) @@ -133,6 +134,9 @@ public class HttpJsonUserEventServiceStub extends UserEventServiceStub { ProtoRestSerializer serializer = ProtoRestSerializer.create(); serializer.putQueryParam(fields, "ets", request.getEts()); + serializer.putQueryParam( + fields, "prebuiltRule", request.getPrebuiltRule()); + serializer.putQueryParam(fields, "rawJson", request.getRawJson()); serializer.putQueryParam(fields, "uri", request.getUri()); serializer.putQueryParam(fields, "userEvent", request.getUserEvent()); serializer.putQueryParam(fields, "$alt", "json;enum-encoding=int"); diff --git a/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2beta/UserEventServiceClient.java b/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2beta/UserEventServiceClient.java index 93a856aa86af..11604f1264f3 100644 --- a/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2beta/UserEventServiceClient.java +++ b/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2beta/UserEventServiceClient.java @@ -48,6 +48,7 @@ * WriteUserEventRequest.newBuilder() * .setParent("parent-995424086") * .setUserEvent(UserEvent.newBuilder().build()) + * .setWriteAsync(true) * .build(); * UserEvent response = userEventServiceClient.writeUserEvent(request); * } @@ -220,6 +221,7 @@ public final OperationsClient getHttpJsonOperationsClient() { * WriteUserEventRequest.newBuilder() * .setParent("parent-995424086") * .setUserEvent(UserEvent.newBuilder().build()) + * .setWriteAsync(true) * .build(); * UserEvent response = userEventServiceClient.writeUserEvent(request); * } @@ -249,6 +251,7 @@ public final UserEvent writeUserEvent(WriteUserEventRequest request) { * WriteUserEventRequest.newBuilder() * .setParent("parent-995424086") * .setUserEvent(UserEvent.newBuilder().build()) + * .setWriteAsync(true) * .build(); * ApiFuture future = * userEventServiceClient.writeUserEventCallable().futureCall(request); @@ -284,6 +287,7 @@ public final UnaryCallable writeUserEventCalla * .setUserEvent("userEvent315571599") * .setUri("uri116076") * .setEts(100772) + * .setRawJson("rawJson985449776") * .build(); * HttpBody response = userEventServiceClient.collectUserEvent(request); * } @@ -319,6 +323,7 @@ public final HttpBody collectUserEvent(CollectUserEventRequest request) { * .setUserEvent("userEvent315571599") * .setUri("uri116076") * .setEts(100772) + * .setRawJson("rawJson985449776") * .build(); * ApiFuture future = * userEventServiceClient.collectUserEventCallable().futureCall(request); diff --git a/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2beta/package-info.java b/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2beta/package-info.java index de9069f7dac2..74e593e8f643 100644 --- a/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2beta/package-info.java +++ b/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2beta/package-info.java @@ -252,6 +252,7 @@ * WriteUserEventRequest.newBuilder() * .setParent("parent-995424086") * .setUserEvent(UserEvent.newBuilder().build()) + * .setWriteAsync(true) * .build(); * UserEvent response = userEventServiceClient.writeUserEvent(request); * } diff --git a/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2beta/stub/HttpJsonUserEventServiceStub.java b/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2beta/stub/HttpJsonUserEventServiceStub.java index 206d3c13b09f..ea040550a3c0 100644 --- a/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2beta/stub/HttpJsonUserEventServiceStub.java +++ b/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2beta/stub/HttpJsonUserEventServiceStub.java @@ -95,6 +95,7 @@ public class HttpJsonUserEventServiceStub extends UserEventServiceStub { Map> fields = new HashMap<>(); ProtoRestSerializer serializer = ProtoRestSerializer.create(); + serializer.putQueryParam(fields, "writeAsync", request.getWriteAsync()); serializer.putQueryParam(fields, "$alt", "json;enum-encoding=int"); return fields; }) @@ -133,6 +134,9 @@ public class HttpJsonUserEventServiceStub extends UserEventServiceStub { ProtoRestSerializer serializer = ProtoRestSerializer.create(); serializer.putQueryParam(fields, "ets", request.getEts()); + serializer.putQueryParam( + fields, "prebuiltRule", request.getPrebuiltRule()); + serializer.putQueryParam(fields, "rawJson", request.getRawJson()); serializer.putQueryParam(fields, "uri", request.getUri()); serializer.putQueryParam(fields, "userEvent", request.getUserEvent()); serializer.putQueryParam(fields, "$alt", "json;enum-encoding=int"); diff --git a/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2beta/stub/ProductServiceStubSettings.java b/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2beta/stub/ProductServiceStubSettings.java index 14d4d0b7b335..e8ce1e37a3b8 100644 --- a/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2beta/stub/ProductServiceStubSettings.java +++ b/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2beta/stub/ProductServiceStubSettings.java @@ -502,7 +502,7 @@ public static class Builder extends StubSettings.BuildernewArrayList( StatusCode.Code.UNAVAILABLE, StatusCode.Code.DEADLINE_EXCEEDED))); definitions.put( - "retry_policy_2_codes", + "retry_policy_3_codes", ImmutableSet.copyOf( Lists.newArrayList( StatusCode.Code.UNAVAILABLE, StatusCode.Code.DEADLINE_EXCEEDED))); @@ -535,7 +535,7 @@ public static class Builder extends StubSettings.BuildernewUnaryCallSettingsBuilder() - .setRetryableCodes(RETRYABLE_CODE_DEFINITIONS.get("retry_policy_2_codes")) - .setRetrySettings(RETRY_PARAM_DEFINITIONS.get("retry_policy_2_params")) + .setRetryableCodes(RETRYABLE_CODE_DEFINITIONS.get("retry_policy_3_codes")) + .setRetrySettings(RETRY_PARAM_DEFINITIONS.get("retry_policy_3_params")) .build()) .setResponseTransformer( ProtoOperationTransformers.ResponseTransformer.create(ImportProductsResponse.class)) diff --git a/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2beta/stub/UserEventServiceStubSettings.java b/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2beta/stub/UserEventServiceStubSettings.java index 721eaa3db73a..d57e7a8c87b1 100644 --- a/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2beta/stub/UserEventServiceStubSettings.java +++ b/java-retail/google-cloud-retail/src/main/java/com/google/cloud/retail/v2beta/stub/UserEventServiceStubSettings.java @@ -316,7 +316,7 @@ public static class Builder extends StubSettings.BuildernewArrayList( StatusCode.Code.UNAVAILABLE, StatusCode.Code.DEADLINE_EXCEEDED))); definitions.put( - "retry_policy_3_codes", + "retry_policy_4_codes", ImmutableSet.copyOf( Lists.newArrayList( StatusCode.Code.UNAVAILABLE, StatusCode.Code.DEADLINE_EXCEEDED))); @@ -360,7 +360,7 @@ public static class Builder extends StubSettings.BuildernewUnaryCallSettingsBuilder() - .setRetryableCodes(RETRYABLE_CODE_DEFINITIONS.get("retry_policy_3_codes")) - .setRetrySettings(RETRY_PARAM_DEFINITIONS.get("retry_policy_3_params")) + .setRetryableCodes(RETRYABLE_CODE_DEFINITIONS.get("retry_policy_4_codes")) + .setRetrySettings(RETRY_PARAM_DEFINITIONS.get("retry_policy_4_params")) .build()) .setResponseTransformer( ProtoOperationTransformers.ResponseTransformer.create(ImportUserEventsResponse.class)) diff --git a/java-retail/google-cloud-retail/src/test/java/com/google/cloud/retail/v2/UserEventServiceClientHttpJsonTest.java b/java-retail/google-cloud-retail/src/test/java/com/google/cloud/retail/v2/UserEventServiceClientHttpJsonTest.java index 73544d3f6f10..138770923852 100644 --- a/java-retail/google-cloud-retail/src/test/java/com/google/cloud/retail/v2/UserEventServiceClientHttpJsonTest.java +++ b/java-retail/google-cloud-retail/src/test/java/com/google/cloud/retail/v2/UserEventServiceClientHttpJsonTest.java @@ -111,6 +111,7 @@ public void writeUserEventTest() throws Exception { WriteUserEventRequest.newBuilder() .setParent("projects/project-6267/locations/location-6267/catalogs/catalog-6267") .setUserEvent(UserEvent.newBuilder().build()) + .setWriteAsync(true) .build(); UserEvent actualResponse = client.writeUserEvent(request); @@ -143,6 +144,7 @@ public void writeUserEventExceptionTest() throws Exception { WriteUserEventRequest.newBuilder() .setParent("projects/project-6267/locations/location-6267/catalogs/catalog-6267") .setUserEvent(UserEvent.newBuilder().build()) + .setWriteAsync(true) .build(); client.writeUserEvent(request); Assert.fail("No exception raised"); @@ -167,6 +169,7 @@ public void collectUserEventTest() throws Exception { .setUserEvent("userEvent315571599") .setUri("uri116076") .setEts(100772) + .setRawJson("rawJson985449776") .build(); HttpBody actualResponse = client.collectUserEvent(request); @@ -201,6 +204,7 @@ public void collectUserEventExceptionTest() throws Exception { .setUserEvent("userEvent315571599") .setUri("uri116076") .setEts(100772) + .setRawJson("rawJson985449776") .build(); client.collectUserEvent(request); Assert.fail("No exception raised"); diff --git a/java-retail/google-cloud-retail/src/test/java/com/google/cloud/retail/v2/UserEventServiceClientTest.java b/java-retail/google-cloud-retail/src/test/java/com/google/cloud/retail/v2/UserEventServiceClientTest.java index 27ddb0bc7c63..e220ca1402e6 100644 --- a/java-retail/google-cloud-retail/src/test/java/com/google/cloud/retail/v2/UserEventServiceClientTest.java +++ b/java-retail/google-cloud-retail/src/test/java/com/google/cloud/retail/v2/UserEventServiceClientTest.java @@ -116,6 +116,7 @@ public void writeUserEventTest() throws Exception { WriteUserEventRequest.newBuilder() .setParent("parent-995424086") .setUserEvent(UserEvent.newBuilder().build()) + .setWriteAsync(true) .build(); UserEvent actualResponse = client.writeUserEvent(request); @@ -127,6 +128,7 @@ public void writeUserEventTest() throws Exception { Assert.assertEquals(request.getParent(), actualRequest.getParent()); Assert.assertEquals(request.getUserEvent(), actualRequest.getUserEvent()); + Assert.assertEquals(request.getWriteAsync(), actualRequest.getWriteAsync()); Assert.assertTrue( channelProvider.isHeaderSent( ApiClientHeaderProvider.getDefaultApiClientHeaderKey(), @@ -143,6 +145,7 @@ public void writeUserEventExceptionTest() throws Exception { WriteUserEventRequest.newBuilder() .setParent("parent-995424086") .setUserEvent(UserEvent.newBuilder().build()) + .setWriteAsync(true) .build(); client.writeUserEvent(request); Assert.fail("No exception raised"); @@ -167,6 +170,7 @@ public void collectUserEventTest() throws Exception { .setUserEvent("userEvent315571599") .setUri("uri116076") .setEts(100772) + .setRawJson("rawJson985449776") .build(); HttpBody actualResponse = client.collectUserEvent(request); @@ -176,10 +180,12 @@ public void collectUserEventTest() throws Exception { Assert.assertEquals(1, actualRequests.size()); CollectUserEventRequest actualRequest = ((CollectUserEventRequest) actualRequests.get(0)); + Assert.assertEquals(request.getPrebuiltRule(), actualRequest.getPrebuiltRule()); Assert.assertEquals(request.getParent(), actualRequest.getParent()); Assert.assertEquals(request.getUserEvent(), actualRequest.getUserEvent()); Assert.assertEquals(request.getUri(), actualRequest.getUri()); Assert.assertEquals(request.getEts(), actualRequest.getEts()); + Assert.assertEquals(request.getRawJson(), actualRequest.getRawJson()); Assert.assertTrue( channelProvider.isHeaderSent( ApiClientHeaderProvider.getDefaultApiClientHeaderKey(), @@ -198,6 +204,7 @@ public void collectUserEventExceptionTest() throws Exception { .setUserEvent("userEvent315571599") .setUri("uri116076") .setEts(100772) + .setRawJson("rawJson985449776") .build(); client.collectUserEvent(request); Assert.fail("No exception raised"); diff --git a/java-retail/google-cloud-retail/src/test/java/com/google/cloud/retail/v2alpha/CatalogServiceClientHttpJsonTest.java b/java-retail/google-cloud-retail/src/test/java/com/google/cloud/retail/v2alpha/CatalogServiceClientHttpJsonTest.java index 0356ab45ce23..0b86c7dabaa4 100644 --- a/java-retail/google-cloud-retail/src/test/java/com/google/cloud/retail/v2alpha/CatalogServiceClientHttpJsonTest.java +++ b/java-retail/google-cloud-retail/src/test/java/com/google/cloud/retail/v2alpha/CatalogServiceClientHttpJsonTest.java @@ -33,6 +33,7 @@ import com.google.protobuf.FieldMask; import com.google.protobuf.Timestamp; import java.io.IOException; +import java.util.ArrayList; import java.util.Arrays; import java.util.HashMap; import java.util.List; @@ -868,6 +869,62 @@ public void removeCatalogAttributeExceptionTest() throws Exception { } } + @Test + public void batchRemoveCatalogAttributesTest() throws Exception { + BatchRemoveCatalogAttributesResponse expectedResponse = + BatchRemoveCatalogAttributesResponse.newBuilder() + .addAllDeletedCatalogAttributes(new ArrayList()) + .addAllResetCatalogAttributes(new ArrayList()) + .build(); + mockService.addResponse(expectedResponse); + + BatchRemoveCatalogAttributesRequest request = + BatchRemoveCatalogAttributesRequest.newBuilder() + .setAttributesConfig( + AttributesConfigName.of("[PROJECT]", "[LOCATION]", "[CATALOG]").toString()) + .addAllAttributeKeys(new ArrayList()) + .build(); + + BatchRemoveCatalogAttributesResponse actualResponse = + client.batchRemoveCatalogAttributes(request); + Assert.assertEquals(expectedResponse, actualResponse); + + List actualRequests = mockService.getRequestPaths(); + Assert.assertEquals(1, actualRequests.size()); + + String apiClientHeaderKey = + mockService + .getRequestHeaders() + .get(ApiClientHeaderProvider.getDefaultApiClientHeaderKey()) + .iterator() + .next(); + Assert.assertTrue( + GaxHttpJsonProperties.getDefaultApiClientHeaderPattern() + .matcher(apiClientHeaderKey) + .matches()); + } + + @Test + public void batchRemoveCatalogAttributesExceptionTest() throws Exception { + ApiException exception = + ApiExceptionFactory.createException( + new Exception(), FakeStatusCode.of(StatusCode.Code.INVALID_ARGUMENT), false); + mockService.addException(exception); + + try { + BatchRemoveCatalogAttributesRequest request = + BatchRemoveCatalogAttributesRequest.newBuilder() + .setAttributesConfig( + AttributesConfigName.of("[PROJECT]", "[LOCATION]", "[CATALOG]").toString()) + .addAllAttributeKeys(new ArrayList()) + .build(); + client.batchRemoveCatalogAttributes(request); + Assert.fail("No exception raised"); + } catch (InvalidArgumentException e) { + // Expected exception. + } + } + @Test public void replaceCatalogAttributeTest() throws Exception { AttributesConfig expectedResponse = diff --git a/java-retail/google-cloud-retail/src/test/java/com/google/cloud/retail/v2alpha/CatalogServiceClientTest.java b/java-retail/google-cloud-retail/src/test/java/com/google/cloud/retail/v2alpha/CatalogServiceClientTest.java index fec59de0f150..98213b924a94 100644 --- a/java-retail/google-cloud-retail/src/test/java/com/google/cloud/retail/v2alpha/CatalogServiceClientTest.java +++ b/java-retail/google-cloud-retail/src/test/java/com/google/cloud/retail/v2alpha/CatalogServiceClientTest.java @@ -32,6 +32,7 @@ import com.google.protobuf.Timestamp; import io.grpc.StatusRuntimeException; import java.io.IOException; +import java.util.ArrayList; import java.util.Arrays; import java.util.HashMap; import java.util.List; @@ -737,6 +738,58 @@ public void removeCatalogAttributeExceptionTest() throws Exception { } } + @Test + public void batchRemoveCatalogAttributesTest() throws Exception { + BatchRemoveCatalogAttributesResponse expectedResponse = + BatchRemoveCatalogAttributesResponse.newBuilder() + .addAllDeletedCatalogAttributes(new ArrayList()) + .addAllResetCatalogAttributes(new ArrayList()) + .build(); + mockCatalogService.addResponse(expectedResponse); + + BatchRemoveCatalogAttributesRequest request = + BatchRemoveCatalogAttributesRequest.newBuilder() + .setAttributesConfig( + AttributesConfigName.of("[PROJECT]", "[LOCATION]", "[CATALOG]").toString()) + .addAllAttributeKeys(new ArrayList()) + .build(); + + BatchRemoveCatalogAttributesResponse actualResponse = + client.batchRemoveCatalogAttributes(request); + Assert.assertEquals(expectedResponse, actualResponse); + + List actualRequests = mockCatalogService.getRequests(); + Assert.assertEquals(1, actualRequests.size()); + BatchRemoveCatalogAttributesRequest actualRequest = + ((BatchRemoveCatalogAttributesRequest) actualRequests.get(0)); + + Assert.assertEquals(request.getAttributesConfig(), actualRequest.getAttributesConfig()); + Assert.assertEquals(request.getAttributeKeysList(), actualRequest.getAttributeKeysList()); + Assert.assertTrue( + channelProvider.isHeaderSent( + ApiClientHeaderProvider.getDefaultApiClientHeaderKey(), + GaxGrpcProperties.getDefaultApiClientHeaderPattern())); + } + + @Test + public void batchRemoveCatalogAttributesExceptionTest() throws Exception { + StatusRuntimeException exception = new StatusRuntimeException(io.grpc.Status.INVALID_ARGUMENT); + mockCatalogService.addException(exception); + + try { + BatchRemoveCatalogAttributesRequest request = + BatchRemoveCatalogAttributesRequest.newBuilder() + .setAttributesConfig( + AttributesConfigName.of("[PROJECT]", "[LOCATION]", "[CATALOG]").toString()) + .addAllAttributeKeys(new ArrayList()) + .build(); + client.batchRemoveCatalogAttributes(request); + Assert.fail("No exception raised"); + } catch (InvalidArgumentException e) { + // Expected exception. + } + } + @Test public void replaceCatalogAttributeTest() throws Exception { AttributesConfig expectedResponse = diff --git a/java-retail/google-cloud-retail/src/test/java/com/google/cloud/retail/v2alpha/CompletionServiceClientHttpJsonTest.java b/java-retail/google-cloud-retail/src/test/java/com/google/cloud/retail/v2alpha/CompletionServiceClientHttpJsonTest.java index e35582ea67d6..b02cab6b1199 100644 --- a/java-retail/google-cloud-retail/src/test/java/com/google/cloud/retail/v2alpha/CompletionServiceClientHttpJsonTest.java +++ b/java-retail/google-cloud-retail/src/test/java/com/google/cloud/retail/v2alpha/CompletionServiceClientHttpJsonTest.java @@ -31,6 +31,7 @@ import com.google.rpc.Status; import java.io.IOException; import java.util.ArrayList; +import java.util.HashMap; import java.util.List; import java.util.concurrent.ExecutionException; import javax.annotation.Generated; @@ -83,6 +84,7 @@ public void completeQueryTest() throws Exception { .addAllCompletionResults(new ArrayList()) .setAttributionToken("attributionToken104706234") .addAllRecentSearchResults(new ArrayList()) + .putAllAttributeResults(new HashMap()) .build(); mockService.addResponse(expectedResponse); @@ -95,6 +97,7 @@ public void completeQueryTest() throws Exception { .setDeviceType("deviceType781190832") .setDataset("dataset1443214456") .setMaxSuggestions(618824852) + .setEnableAttributeSuggestions(true) .build(); CompleteQueryResponse actualResponse = client.completeQuery(request); @@ -132,6 +135,7 @@ public void completeQueryExceptionTest() throws Exception { .setDeviceType("deviceType781190832") .setDataset("dataset1443214456") .setMaxSuggestions(618824852) + .setEnableAttributeSuggestions(true) .build(); client.completeQuery(request); Assert.fail("No exception raised"); diff --git a/java-retail/google-cloud-retail/src/test/java/com/google/cloud/retail/v2alpha/CompletionServiceClientTest.java b/java-retail/google-cloud-retail/src/test/java/com/google/cloud/retail/v2alpha/CompletionServiceClientTest.java index 968cff012eeb..92ad7352c855 100644 --- a/java-retail/google-cloud-retail/src/test/java/com/google/cloud/retail/v2alpha/CompletionServiceClientTest.java +++ b/java-retail/google-cloud-retail/src/test/java/com/google/cloud/retail/v2alpha/CompletionServiceClientTest.java @@ -32,6 +32,7 @@ import java.io.IOException; import java.util.ArrayList; import java.util.Arrays; +import java.util.HashMap; import java.util.List; import java.util.UUID; import java.util.concurrent.ExecutionException; @@ -88,6 +89,7 @@ public void completeQueryTest() throws Exception { .addAllCompletionResults(new ArrayList()) .setAttributionToken("attributionToken104706234") .addAllRecentSearchResults(new ArrayList()) + .putAllAttributeResults(new HashMap()) .build(); mockCompletionService.addResponse(expectedResponse); @@ -100,6 +102,7 @@ public void completeQueryTest() throws Exception { .setDeviceType("deviceType781190832") .setDataset("dataset1443214456") .setMaxSuggestions(618824852) + .setEnableAttributeSuggestions(true) .build(); CompleteQueryResponse actualResponse = client.completeQuery(request); @@ -116,6 +119,8 @@ public void completeQueryTest() throws Exception { Assert.assertEquals(request.getDeviceType(), actualRequest.getDeviceType()); Assert.assertEquals(request.getDataset(), actualRequest.getDataset()); Assert.assertEquals(request.getMaxSuggestions(), actualRequest.getMaxSuggestions()); + Assert.assertEquals( + request.getEnableAttributeSuggestions(), actualRequest.getEnableAttributeSuggestions()); Assert.assertTrue( channelProvider.isHeaderSent( ApiClientHeaderProvider.getDefaultApiClientHeaderKey(), @@ -137,6 +142,7 @@ public void completeQueryExceptionTest() throws Exception { .setDeviceType("deviceType781190832") .setDataset("dataset1443214456") .setMaxSuggestions(618824852) + .setEnableAttributeSuggestions(true) .build(); client.completeQuery(request); Assert.fail("No exception raised"); diff --git a/java-retail/google-cloud-retail/src/test/java/com/google/cloud/retail/v2alpha/MockCatalogServiceImpl.java b/java-retail/google-cloud-retail/src/test/java/com/google/cloud/retail/v2alpha/MockCatalogServiceImpl.java index 6d1eeec53203..9f34957b8334 100644 --- a/java-retail/google-cloud-retail/src/test/java/com/google/cloud/retail/v2alpha/MockCatalogServiceImpl.java +++ b/java-retail/google-cloud-retail/src/test/java/com/google/cloud/retail/v2alpha/MockCatalogServiceImpl.java @@ -269,6 +269,28 @@ public void removeCatalogAttribute( } } + @Override + public void batchRemoveCatalogAttributes( + BatchRemoveCatalogAttributesRequest request, + StreamObserver responseObserver) { + Object response = responses.poll(); + if (response instanceof BatchRemoveCatalogAttributesResponse) { + requests.add(request); + responseObserver.onNext(((BatchRemoveCatalogAttributesResponse) response)); + responseObserver.onCompleted(); + } else if (response instanceof Exception) { + responseObserver.onError(((Exception) response)); + } else { + responseObserver.onError( + new IllegalArgumentException( + String.format( + "Unrecognized response type %s for method BatchRemoveCatalogAttributes, expected %s or %s", + response == null ? "null" : response.getClass().getName(), + BatchRemoveCatalogAttributesResponse.class.getName(), + Exception.class.getName()))); + } + } + @Override public void replaceCatalogAttribute( ReplaceCatalogAttributeRequest request, StreamObserver responseObserver) { diff --git a/java-retail/google-cloud-retail/src/test/java/com/google/cloud/retail/v2alpha/ProductServiceClientHttpJsonTest.java b/java-retail/google-cloud-retail/src/test/java/com/google/cloud/retail/v2alpha/ProductServiceClientHttpJsonTest.java index 82361b8bce9e..ac89ce76a91b 100644 --- a/java-retail/google-cloud-retail/src/test/java/com/google/cloud/retail/v2alpha/ProductServiceClientHttpJsonTest.java +++ b/java-retail/google-cloud-retail/src/test/java/com/google/cloud/retail/v2alpha/ProductServiceClientHttpJsonTest.java @@ -120,6 +120,7 @@ public void createProductTest() throws Exception { .setPublishTime(Timestamp.newBuilder().build()) .setRetrievableFields(FieldMask.newBuilder().build()) .addAllVariants(new ArrayList()) + .addAllLocalInventories(new ArrayList()) .build(); mockService.addResponse(expectedResponse); @@ -198,6 +199,7 @@ public void createProductTest2() throws Exception { .setPublishTime(Timestamp.newBuilder().build()) .setRetrievableFields(FieldMask.newBuilder().build()) .addAllVariants(new ArrayList()) + .addAllLocalInventories(new ArrayList()) .build(); mockService.addResponse(expectedResponse); @@ -278,6 +280,7 @@ public void getProductTest() throws Exception { .setPublishTime(Timestamp.newBuilder().build()) .setRetrievableFields(FieldMask.newBuilder().build()) .addAllVariants(new ArrayList()) + .addAllLocalInventories(new ArrayList()) .build(); mockService.addResponse(expectedResponse); @@ -354,6 +357,7 @@ public void getProductTest2() throws Exception { .setPublishTime(Timestamp.newBuilder().build()) .setRetrievableFields(FieldMask.newBuilder().build()) .addAllVariants(new ArrayList()) + .addAllLocalInventories(new ArrayList()) .build(); mockService.addResponse(expectedResponse); @@ -532,6 +536,7 @@ public void updateProductTest() throws Exception { .setPublishTime(Timestamp.newBuilder().build()) .setRetrievableFields(FieldMask.newBuilder().build()) .addAllVariants(new ArrayList()) + .addAllLocalInventories(new ArrayList()) .build(); mockService.addResponse(expectedResponse); @@ -568,6 +573,7 @@ public void updateProductTest() throws Exception { .setPublishTime(Timestamp.newBuilder().build()) .setRetrievableFields(FieldMask.newBuilder().build()) .addAllVariants(new ArrayList()) + .addAllLocalInventories(new ArrayList()) .build(); FieldMask updateMask = FieldMask.newBuilder().build(); @@ -630,6 +636,7 @@ public void updateProductExceptionTest() throws Exception { .setPublishTime(Timestamp.newBuilder().build()) .setRetrievableFields(FieldMask.newBuilder().build()) .addAllVariants(new ArrayList()) + .addAllLocalInventories(new ArrayList()) .build(); FieldMask updateMask = FieldMask.newBuilder().build(); client.updateProduct(product, updateMask); @@ -897,6 +904,7 @@ public void setInventoryTest() throws Exception { .setPublishTime(Timestamp.newBuilder().build()) .setRetrievableFields(FieldMask.newBuilder().build()) .addAllVariants(new ArrayList()) + .addAllLocalInventories(new ArrayList()) .build(); FieldMask setMask = FieldMask.newBuilder().build(); @@ -959,6 +967,7 @@ public void setInventoryExceptionTest() throws Exception { .setPublishTime(Timestamp.newBuilder().build()) .setRetrievableFields(FieldMask.newBuilder().build()) .addAllVariants(new ArrayList()) + .addAllLocalInventories(new ArrayList()) .build(); FieldMask setMask = FieldMask.newBuilder().build(); client.setInventoryAsync(inventory, setMask).get(); diff --git a/java-retail/google-cloud-retail/src/test/java/com/google/cloud/retail/v2alpha/ProductServiceClientTest.java b/java-retail/google-cloud-retail/src/test/java/com/google/cloud/retail/v2alpha/ProductServiceClientTest.java index 993e6318d82d..28956ece81d7 100644 --- a/java-retail/google-cloud-retail/src/test/java/com/google/cloud/retail/v2alpha/ProductServiceClientTest.java +++ b/java-retail/google-cloud-retail/src/test/java/com/google/cloud/retail/v2alpha/ProductServiceClientTest.java @@ -124,6 +124,7 @@ public void createProductTest() throws Exception { .setPublishTime(Timestamp.newBuilder().build()) .setRetrievableFields(FieldMask.newBuilder().build()) .addAllVariants(new ArrayList()) + .addAllLocalInventories(new ArrayList()) .build(); mockProductService.addResponse(expectedResponse); @@ -198,6 +199,7 @@ public void createProductTest2() throws Exception { .setPublishTime(Timestamp.newBuilder().build()) .setRetrievableFields(FieldMask.newBuilder().build()) .addAllVariants(new ArrayList()) + .addAllLocalInventories(new ArrayList()) .build(); mockProductService.addResponse(expectedResponse); @@ -272,6 +274,7 @@ public void getProductTest() throws Exception { .setPublishTime(Timestamp.newBuilder().build()) .setRetrievableFields(FieldMask.newBuilder().build()) .addAllVariants(new ArrayList()) + .addAllLocalInventories(new ArrayList()) .build(); mockProductService.addResponse(expectedResponse); @@ -342,6 +345,7 @@ public void getProductTest2() throws Exception { .setPublishTime(Timestamp.newBuilder().build()) .setRetrievableFields(FieldMask.newBuilder().build()) .addAllVariants(new ArrayList()) + .addAllLocalInventories(new ArrayList()) .build(); mockProductService.addResponse(expectedResponse); @@ -498,6 +502,7 @@ public void updateProductTest() throws Exception { .setPublishTime(Timestamp.newBuilder().build()) .setRetrievableFields(FieldMask.newBuilder().build()) .addAllVariants(new ArrayList()) + .addAllLocalInventories(new ArrayList()) .build(); mockProductService.addResponse(expectedResponse); diff --git a/java-retail/google-cloud-retail/src/test/java/com/google/cloud/retail/v2alpha/ServingConfigServiceClientHttpJsonTest.java b/java-retail/google-cloud-retail/src/test/java/com/google/cloud/retail/v2alpha/ServingConfigServiceClientHttpJsonTest.java index 25d4041d00fd..01a25c585ebd 100644 --- a/java-retail/google-cloud-retail/src/test/java/com/google/cloud/retail/v2alpha/ServingConfigServiceClientHttpJsonTest.java +++ b/java-retail/google-cloud-retail/src/test/java/com/google/cloud/retail/v2alpha/ServingConfigServiceClientHttpJsonTest.java @@ -100,6 +100,7 @@ public void createServingConfigTest() throws Exception { .addAllIgnoreControlIds(new ArrayList()) .setDiversityLevel("diversityLevel578206123") .setEnableCategoryFilterLevel("enableCategoryFilterLevel-1232535413") + .setPersonalizationSpec(SearchRequest.PersonalizationSpec.newBuilder().build()) .addAllSolutionTypes(new ArrayList()) .build(); mockService.addResponse(expectedResponse); @@ -167,6 +168,7 @@ public void createServingConfigTest2() throws Exception { .addAllIgnoreControlIds(new ArrayList()) .setDiversityLevel("diversityLevel578206123") .setEnableCategoryFilterLevel("enableCategoryFilterLevel-1232535413") + .setPersonalizationSpec(SearchRequest.PersonalizationSpec.newBuilder().build()) .addAllSolutionTypes(new ArrayList()) .build(); mockService.addResponse(expectedResponse); @@ -318,6 +320,7 @@ public void updateServingConfigTest() throws Exception { .addAllIgnoreControlIds(new ArrayList()) .setDiversityLevel("diversityLevel578206123") .setEnableCategoryFilterLevel("enableCategoryFilterLevel-1232535413") + .setPersonalizationSpec(SearchRequest.PersonalizationSpec.newBuilder().build()) .addAllSolutionTypes(new ArrayList()) .build(); mockService.addResponse(expectedResponse); @@ -342,6 +345,7 @@ public void updateServingConfigTest() throws Exception { .addAllIgnoreControlIds(new ArrayList()) .setDiversityLevel("diversityLevel578206123") .setEnableCategoryFilterLevel("enableCategoryFilterLevel-1232535413") + .setPersonalizationSpec(SearchRequest.PersonalizationSpec.newBuilder().build()) .addAllSolutionTypes(new ArrayList()) .build(); FieldMask updateMask = FieldMask.newBuilder().build(); @@ -392,6 +396,7 @@ public void updateServingConfigExceptionTest() throws Exception { .addAllIgnoreControlIds(new ArrayList()) .setDiversityLevel("diversityLevel578206123") .setEnableCategoryFilterLevel("enableCategoryFilterLevel-1232535413") + .setPersonalizationSpec(SearchRequest.PersonalizationSpec.newBuilder().build()) .addAllSolutionTypes(new ArrayList()) .build(); FieldMask updateMask = FieldMask.newBuilder().build(); @@ -424,6 +429,7 @@ public void getServingConfigTest() throws Exception { .addAllIgnoreControlIds(new ArrayList()) .setDiversityLevel("diversityLevel578206123") .setEnableCategoryFilterLevel("enableCategoryFilterLevel-1232535413") + .setPersonalizationSpec(SearchRequest.PersonalizationSpec.newBuilder().build()) .addAllSolutionTypes(new ArrayList()) .build(); mockService.addResponse(expectedResponse); @@ -488,6 +494,7 @@ public void getServingConfigTest2() throws Exception { .addAllIgnoreControlIds(new ArrayList()) .setDiversityLevel("diversityLevel578206123") .setEnableCategoryFilterLevel("enableCategoryFilterLevel-1232535413") + .setPersonalizationSpec(SearchRequest.PersonalizationSpec.newBuilder().build()) .addAllSolutionTypes(new ArrayList()) .build(); mockService.addResponse(expectedResponse); @@ -652,6 +659,7 @@ public void addControlTest() throws Exception { .addAllIgnoreControlIds(new ArrayList()) .setDiversityLevel("diversityLevel578206123") .setEnableCategoryFilterLevel("enableCategoryFilterLevel-1232535413") + .setPersonalizationSpec(SearchRequest.PersonalizationSpec.newBuilder().build()) .addAllSolutionTypes(new ArrayList()) .build(); mockService.addResponse(expectedResponse); @@ -716,6 +724,7 @@ public void addControlTest2() throws Exception { .addAllIgnoreControlIds(new ArrayList()) .setDiversityLevel("diversityLevel578206123") .setEnableCategoryFilterLevel("enableCategoryFilterLevel-1232535413") + .setPersonalizationSpec(SearchRequest.PersonalizationSpec.newBuilder().build()) .addAllSolutionTypes(new ArrayList()) .build(); mockService.addResponse(expectedResponse); @@ -780,6 +789,7 @@ public void removeControlTest() throws Exception { .addAllIgnoreControlIds(new ArrayList()) .setDiversityLevel("diversityLevel578206123") .setEnableCategoryFilterLevel("enableCategoryFilterLevel-1232535413") + .setPersonalizationSpec(SearchRequest.PersonalizationSpec.newBuilder().build()) .addAllSolutionTypes(new ArrayList()) .build(); mockService.addResponse(expectedResponse); @@ -844,6 +854,7 @@ public void removeControlTest2() throws Exception { .addAllIgnoreControlIds(new ArrayList()) .setDiversityLevel("diversityLevel578206123") .setEnableCategoryFilterLevel("enableCategoryFilterLevel-1232535413") + .setPersonalizationSpec(SearchRequest.PersonalizationSpec.newBuilder().build()) .addAllSolutionTypes(new ArrayList()) .build(); mockService.addResponse(expectedResponse); diff --git a/java-retail/google-cloud-retail/src/test/java/com/google/cloud/retail/v2alpha/ServingConfigServiceClientTest.java b/java-retail/google-cloud-retail/src/test/java/com/google/cloud/retail/v2alpha/ServingConfigServiceClientTest.java index 0513c2c7b6a3..3ea1c019f707 100644 --- a/java-retail/google-cloud-retail/src/test/java/com/google/cloud/retail/v2alpha/ServingConfigServiceClientTest.java +++ b/java-retail/google-cloud-retail/src/test/java/com/google/cloud/retail/v2alpha/ServingConfigServiceClientTest.java @@ -103,6 +103,7 @@ public void createServingConfigTest() throws Exception { .addAllIgnoreControlIds(new ArrayList()) .setDiversityLevel("diversityLevel578206123") .setEnableCategoryFilterLevel("enableCategoryFilterLevel-1232535413") + .setPersonalizationSpec(SearchRequest.PersonalizationSpec.newBuilder().build()) .addAllSolutionTypes(new ArrayList()) .build(); mockServingConfigService.addResponse(expectedResponse); @@ -166,6 +167,7 @@ public void createServingConfigTest2() throws Exception { .addAllIgnoreControlIds(new ArrayList()) .setDiversityLevel("diversityLevel578206123") .setEnableCategoryFilterLevel("enableCategoryFilterLevel-1232535413") + .setPersonalizationSpec(SearchRequest.PersonalizationSpec.newBuilder().build()) .addAllSolutionTypes(new ArrayList()) .build(); mockServingConfigService.addResponse(expectedResponse); @@ -299,6 +301,7 @@ public void updateServingConfigTest() throws Exception { .addAllIgnoreControlIds(new ArrayList()) .setDiversityLevel("diversityLevel578206123") .setEnableCategoryFilterLevel("enableCategoryFilterLevel-1232535413") + .setPersonalizationSpec(SearchRequest.PersonalizationSpec.newBuilder().build()) .addAllSolutionTypes(new ArrayList()) .build(); mockServingConfigService.addResponse(expectedResponse); @@ -358,6 +361,7 @@ public void getServingConfigTest() throws Exception { .addAllIgnoreControlIds(new ArrayList()) .setDiversityLevel("diversityLevel578206123") .setEnableCategoryFilterLevel("enableCategoryFilterLevel-1232535413") + .setPersonalizationSpec(SearchRequest.PersonalizationSpec.newBuilder().build()) .addAllSolutionTypes(new ArrayList()) .build(); mockServingConfigService.addResponse(expectedResponse); @@ -416,6 +420,7 @@ public void getServingConfigTest2() throws Exception { .addAllIgnoreControlIds(new ArrayList()) .setDiversityLevel("diversityLevel578206123") .setEnableCategoryFilterLevel("enableCategoryFilterLevel-1232535413") + .setPersonalizationSpec(SearchRequest.PersonalizationSpec.newBuilder().build()) .addAllSolutionTypes(new ArrayList()) .build(); mockServingConfigService.addResponse(expectedResponse); @@ -560,6 +565,7 @@ public void addControlTest() throws Exception { .addAllIgnoreControlIds(new ArrayList()) .setDiversityLevel("diversityLevel578206123") .setEnableCategoryFilterLevel("enableCategoryFilterLevel-1232535413") + .setPersonalizationSpec(SearchRequest.PersonalizationSpec.newBuilder().build()) .addAllSolutionTypes(new ArrayList()) .build(); mockServingConfigService.addResponse(expectedResponse); @@ -618,6 +624,7 @@ public void addControlTest2() throws Exception { .addAllIgnoreControlIds(new ArrayList()) .setDiversityLevel("diversityLevel578206123") .setEnableCategoryFilterLevel("enableCategoryFilterLevel-1232535413") + .setPersonalizationSpec(SearchRequest.PersonalizationSpec.newBuilder().build()) .addAllSolutionTypes(new ArrayList()) .build(); mockServingConfigService.addResponse(expectedResponse); @@ -674,6 +681,7 @@ public void removeControlTest() throws Exception { .addAllIgnoreControlIds(new ArrayList()) .setDiversityLevel("diversityLevel578206123") .setEnableCategoryFilterLevel("enableCategoryFilterLevel-1232535413") + .setPersonalizationSpec(SearchRequest.PersonalizationSpec.newBuilder().build()) .addAllSolutionTypes(new ArrayList()) .build(); mockServingConfigService.addResponse(expectedResponse); @@ -732,6 +740,7 @@ public void removeControlTest2() throws Exception { .addAllIgnoreControlIds(new ArrayList()) .setDiversityLevel("diversityLevel578206123") .setEnableCategoryFilterLevel("enableCategoryFilterLevel-1232535413") + .setPersonalizationSpec(SearchRequest.PersonalizationSpec.newBuilder().build()) .addAllSolutionTypes(new ArrayList()) .build(); mockServingConfigService.addResponse(expectedResponse); diff --git a/java-retail/google-cloud-retail/src/test/java/com/google/cloud/retail/v2alpha/UserEventServiceClientHttpJsonTest.java b/java-retail/google-cloud-retail/src/test/java/com/google/cloud/retail/v2alpha/UserEventServiceClientHttpJsonTest.java index 247db4c99868..cfc346869776 100644 --- a/java-retail/google-cloud-retail/src/test/java/com/google/cloud/retail/v2alpha/UserEventServiceClientHttpJsonTest.java +++ b/java-retail/google-cloud-retail/src/test/java/com/google/cloud/retail/v2alpha/UserEventServiceClientHttpJsonTest.java @@ -111,6 +111,7 @@ public void writeUserEventTest() throws Exception { WriteUserEventRequest.newBuilder() .setParent("projects/project-6267/locations/location-6267/catalogs/catalog-6267") .setUserEvent(UserEvent.newBuilder().build()) + .setWriteAsync(true) .build(); UserEvent actualResponse = client.writeUserEvent(request); @@ -143,6 +144,7 @@ public void writeUserEventExceptionTest() throws Exception { WriteUserEventRequest.newBuilder() .setParent("projects/project-6267/locations/location-6267/catalogs/catalog-6267") .setUserEvent(UserEvent.newBuilder().build()) + .setWriteAsync(true) .build(); client.writeUserEvent(request); Assert.fail("No exception raised"); @@ -167,6 +169,7 @@ public void collectUserEventTest() throws Exception { .setUserEvent("userEvent315571599") .setUri("uri116076") .setEts(100772) + .setRawJson("rawJson985449776") .build(); HttpBody actualResponse = client.collectUserEvent(request); @@ -201,6 +204,7 @@ public void collectUserEventExceptionTest() throws Exception { .setUserEvent("userEvent315571599") .setUri("uri116076") .setEts(100772) + .setRawJson("rawJson985449776") .build(); client.collectUserEvent(request); Assert.fail("No exception raised"); diff --git a/java-retail/google-cloud-retail/src/test/java/com/google/cloud/retail/v2alpha/UserEventServiceClientTest.java b/java-retail/google-cloud-retail/src/test/java/com/google/cloud/retail/v2alpha/UserEventServiceClientTest.java index 25ab78ff793b..b261987b47f7 100644 --- a/java-retail/google-cloud-retail/src/test/java/com/google/cloud/retail/v2alpha/UserEventServiceClientTest.java +++ b/java-retail/google-cloud-retail/src/test/java/com/google/cloud/retail/v2alpha/UserEventServiceClientTest.java @@ -116,6 +116,7 @@ public void writeUserEventTest() throws Exception { WriteUserEventRequest.newBuilder() .setParent("parent-995424086") .setUserEvent(UserEvent.newBuilder().build()) + .setWriteAsync(true) .build(); UserEvent actualResponse = client.writeUserEvent(request); @@ -127,6 +128,7 @@ public void writeUserEventTest() throws Exception { Assert.assertEquals(request.getParent(), actualRequest.getParent()); Assert.assertEquals(request.getUserEvent(), actualRequest.getUserEvent()); + Assert.assertEquals(request.getWriteAsync(), actualRequest.getWriteAsync()); Assert.assertTrue( channelProvider.isHeaderSent( ApiClientHeaderProvider.getDefaultApiClientHeaderKey(), @@ -143,6 +145,7 @@ public void writeUserEventExceptionTest() throws Exception { WriteUserEventRequest.newBuilder() .setParent("parent-995424086") .setUserEvent(UserEvent.newBuilder().build()) + .setWriteAsync(true) .build(); client.writeUserEvent(request); Assert.fail("No exception raised"); @@ -167,6 +170,7 @@ public void collectUserEventTest() throws Exception { .setUserEvent("userEvent315571599") .setUri("uri116076") .setEts(100772) + .setRawJson("rawJson985449776") .build(); HttpBody actualResponse = client.collectUserEvent(request); @@ -176,10 +180,12 @@ public void collectUserEventTest() throws Exception { Assert.assertEquals(1, actualRequests.size()); CollectUserEventRequest actualRequest = ((CollectUserEventRequest) actualRequests.get(0)); + Assert.assertEquals(request.getPrebuiltRule(), actualRequest.getPrebuiltRule()); Assert.assertEquals(request.getParent(), actualRequest.getParent()); Assert.assertEquals(request.getUserEvent(), actualRequest.getUserEvent()); Assert.assertEquals(request.getUri(), actualRequest.getUri()); Assert.assertEquals(request.getEts(), actualRequest.getEts()); + Assert.assertEquals(request.getRawJson(), actualRequest.getRawJson()); Assert.assertTrue( channelProvider.isHeaderSent( ApiClientHeaderProvider.getDefaultApiClientHeaderKey(), @@ -198,6 +204,7 @@ public void collectUserEventExceptionTest() throws Exception { .setUserEvent("userEvent315571599") .setUri("uri116076") .setEts(100772) + .setRawJson("rawJson985449776") .build(); client.collectUserEvent(request); Assert.fail("No exception raised"); diff --git a/java-retail/google-cloud-retail/src/test/java/com/google/cloud/retail/v2beta/UserEventServiceClientHttpJsonTest.java b/java-retail/google-cloud-retail/src/test/java/com/google/cloud/retail/v2beta/UserEventServiceClientHttpJsonTest.java index a40fb222e6e0..afbb0c5b17e8 100644 --- a/java-retail/google-cloud-retail/src/test/java/com/google/cloud/retail/v2beta/UserEventServiceClientHttpJsonTest.java +++ b/java-retail/google-cloud-retail/src/test/java/com/google/cloud/retail/v2beta/UserEventServiceClientHttpJsonTest.java @@ -111,6 +111,7 @@ public void writeUserEventTest() throws Exception { WriteUserEventRequest.newBuilder() .setParent("projects/project-6267/locations/location-6267/catalogs/catalog-6267") .setUserEvent(UserEvent.newBuilder().build()) + .setWriteAsync(true) .build(); UserEvent actualResponse = client.writeUserEvent(request); @@ -143,6 +144,7 @@ public void writeUserEventExceptionTest() throws Exception { WriteUserEventRequest.newBuilder() .setParent("projects/project-6267/locations/location-6267/catalogs/catalog-6267") .setUserEvent(UserEvent.newBuilder().build()) + .setWriteAsync(true) .build(); client.writeUserEvent(request); Assert.fail("No exception raised"); @@ -167,6 +169,7 @@ public void collectUserEventTest() throws Exception { .setUserEvent("userEvent315571599") .setUri("uri116076") .setEts(100772) + .setRawJson("rawJson985449776") .build(); HttpBody actualResponse = client.collectUserEvent(request); @@ -201,6 +204,7 @@ public void collectUserEventExceptionTest() throws Exception { .setUserEvent("userEvent315571599") .setUri("uri116076") .setEts(100772) + .setRawJson("rawJson985449776") .build(); client.collectUserEvent(request); Assert.fail("No exception raised"); diff --git a/java-retail/google-cloud-retail/src/test/java/com/google/cloud/retail/v2beta/UserEventServiceClientTest.java b/java-retail/google-cloud-retail/src/test/java/com/google/cloud/retail/v2beta/UserEventServiceClientTest.java index 892e313463e9..bd3189ef5529 100644 --- a/java-retail/google-cloud-retail/src/test/java/com/google/cloud/retail/v2beta/UserEventServiceClientTest.java +++ b/java-retail/google-cloud-retail/src/test/java/com/google/cloud/retail/v2beta/UserEventServiceClientTest.java @@ -116,6 +116,7 @@ public void writeUserEventTest() throws Exception { WriteUserEventRequest.newBuilder() .setParent("parent-995424086") .setUserEvent(UserEvent.newBuilder().build()) + .setWriteAsync(true) .build(); UserEvent actualResponse = client.writeUserEvent(request); @@ -127,6 +128,7 @@ public void writeUserEventTest() throws Exception { Assert.assertEquals(request.getParent(), actualRequest.getParent()); Assert.assertEquals(request.getUserEvent(), actualRequest.getUserEvent()); + Assert.assertEquals(request.getWriteAsync(), actualRequest.getWriteAsync()); Assert.assertTrue( channelProvider.isHeaderSent( ApiClientHeaderProvider.getDefaultApiClientHeaderKey(), @@ -143,6 +145,7 @@ public void writeUserEventExceptionTest() throws Exception { WriteUserEventRequest.newBuilder() .setParent("parent-995424086") .setUserEvent(UserEvent.newBuilder().build()) + .setWriteAsync(true) .build(); client.writeUserEvent(request); Assert.fail("No exception raised"); @@ -167,6 +170,7 @@ public void collectUserEventTest() throws Exception { .setUserEvent("userEvent315571599") .setUri("uri116076") .setEts(100772) + .setRawJson("rawJson985449776") .build(); HttpBody actualResponse = client.collectUserEvent(request); @@ -176,10 +180,12 @@ public void collectUserEventTest() throws Exception { Assert.assertEquals(1, actualRequests.size()); CollectUserEventRequest actualRequest = ((CollectUserEventRequest) actualRequests.get(0)); + Assert.assertEquals(request.getPrebuiltRule(), actualRequest.getPrebuiltRule()); Assert.assertEquals(request.getParent(), actualRequest.getParent()); Assert.assertEquals(request.getUserEvent(), actualRequest.getUserEvent()); Assert.assertEquals(request.getUri(), actualRequest.getUri()); Assert.assertEquals(request.getEts(), actualRequest.getEts()); + Assert.assertEquals(request.getRawJson(), actualRequest.getRawJson()); Assert.assertTrue( channelProvider.isHeaderSent( ApiClientHeaderProvider.getDefaultApiClientHeaderKey(), @@ -198,6 +204,7 @@ public void collectUserEventExceptionTest() throws Exception { .setUserEvent("userEvent315571599") .setUri("uri116076") .setEts(100772) + .setRawJson("rawJson985449776") .build(); client.collectUserEvent(request); Assert.fail("No exception raised"); diff --git a/java-retail/grpc-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/CompletionServiceGrpc.java b/java-retail/grpc-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/CompletionServiceGrpc.java index 3698d6082f8e..78c6c24338d8 100644 --- a/java-retail/grpc-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/CompletionServiceGrpc.java +++ b/java-retail/grpc-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/CompletionServiceGrpc.java @@ -23,7 +23,7 @@ * 

        * Auto-completion service for retail.
  * This feature is only available for users who have Retail Search enabled.
- * Please enable Retail Search on Cloud Console before using this feature.
+ * Enable Retail Search on Cloud Console before using this feature.
  *
      */ @javax.annotation.Generated( @@ -177,7 +177,7 @@ public CompletionServiceFutureStub newStub( * 
          * Auto-completion service for retail.
    * This feature is only available for users who have Retail Search enabled.
-   * Please enable Retail Search on Cloud Console before using this feature.
+   * Enable Retail Search on Cloud Console before using this feature.
    *
      */ public abstract static class CompletionServiceImplBase implements io.grpc.BindableService { @@ -188,7 +188,7 @@ public abstract static class CompletionServiceImplBase implements io.grpc.Bindab * 
            * Completes the specified prefix with keyword suggestions.
      * This feature is only available for users who have Retail Search enabled.
-     * Please enable Retail Search on Cloud Console before using this feature.
+     * Enable Retail Search on Cloud Console before using this feature.
      *
      */ public void completeQuery( @@ -208,7 +208,7 @@ public void completeQuery( * The operation is successfully finished only after the imported suggestions * are indexed successfully and ready for serving. The process takes hours. * This feature is only available for users who have Retail Search enabled. - * Please enable Retail Search on Cloud Console before using this feature. + * Enable Retail Search on Cloud Console before using this feature. * */ public void importCompletionData( @@ -244,7 +244,7 @@ public final io.grpc.ServerServiceDefinition bindService() { * 
          * Auto-completion service for retail.
    * This feature is only available for users who have Retail Search enabled.
-   * Please enable Retail Search on Cloud Console before using this feature.
+   * Enable Retail Search on Cloud Console before using this feature.
    *
      */ public static final class CompletionServiceStub @@ -265,7 +265,7 @@ protected CompletionServiceStub build( * 
            * Completes the specified prefix with keyword suggestions.
      * This feature is only available for users who have Retail Search enabled.
-     * Please enable Retail Search on Cloud Console before using this feature.
+     * Enable Retail Search on Cloud Console before using this feature.
      *
      */ public void completeQuery( @@ -287,7 +287,7 @@ public void completeQuery( * The operation is successfully finished only after the imported suggestions * are indexed successfully and ready for serving. The process takes hours. * This feature is only available for users who have Retail Search enabled. - * Please enable Retail Search on Cloud Console before using this feature. + * Enable Retail Search on Cloud Console before using this feature. * */ public void importCompletionData( @@ -306,7 +306,7 @@ public void importCompletionData( * 
          * Auto-completion service for retail.
    * This feature is only available for users who have Retail Search enabled.
-   * Please enable Retail Search on Cloud Console before using this feature.
+   * Enable Retail Search on Cloud Console before using this feature.
    *
      */ public static final class CompletionServiceBlockingStub @@ -328,7 +328,7 @@ protected CompletionServiceBlockingStub build( * 
            * Completes the specified prefix with keyword suggestions.
      * This feature is only available for users who have Retail Search enabled.
-     * Please enable Retail Search on Cloud Console before using this feature.
+     * Enable Retail Search on Cloud Console before using this feature.
      *
      */ public com.google.cloud.retail.v2.CompleteQueryResponse completeQuery( @@ -346,7 +346,7 @@ public com.google.cloud.retail.v2.CompleteQueryResponse completeQuery( * The operation is successfully finished only after the imported suggestions * are indexed successfully and ready for serving. The process takes hours. * This feature is only available for users who have Retail Search enabled. - * Please enable Retail Search on Cloud Console before using this feature. + * Enable Retail Search on Cloud Console before using this feature. * */ public com.google.longrunning.Operation importCompletionData( @@ -362,7 +362,7 @@ public com.google.longrunning.Operation importCompletionData( * 
          * Auto-completion service for retail.
    * This feature is only available for users who have Retail Search enabled.
-   * Please enable Retail Search on Cloud Console before using this feature.
+   * Enable Retail Search on Cloud Console before using this feature.
    *
      */ public static final class CompletionServiceFutureStub @@ -383,7 +383,7 @@ protected CompletionServiceFutureStub build( * 
            * Completes the specified prefix with keyword suggestions.
      * This feature is only available for users who have Retail Search enabled.
-     * Please enable Retail Search on Cloud Console before using this feature.
+     * Enable Retail Search on Cloud Console before using this feature.
      *
      */ public com.google.common.util.concurrent.ListenableFuture< @@ -402,7 +402,7 @@ protected CompletionServiceFutureStub build( * The operation is successfully finished only after the imported suggestions * are indexed successfully and ready for serving. The process takes hours. * This feature is only available for users who have Retail Search enabled. - * Please enable Retail Search on Cloud Console before using this feature. + * Enable Retail Search on Cloud Console before using this feature. * */ public com.google.common.util.concurrent.ListenableFuture diff --git a/java-retail/grpc-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/ProductServiceGrpc.java b/java-retail/grpc-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/ProductServiceGrpc.java index e24fe482f535..25f8bbab9840 100644 --- a/java-retail/grpc-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/ProductServiceGrpc.java +++ b/java-retail/grpc-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/ProductServiceGrpc.java @@ -670,9 +670,9 @@ public void importProducts( * timestamps of each inventory field. * This process is asynchronous and does not require the * [Product][google.cloud.retail.v2.Product] to exist before updating - * fulfillment information. If the request is valid, the update will be - * enqueued and processed downstream. As a consequence, when a response is - * returned, updates are not immediately manifested in the + * fulfillment information. If the request is valid, the update is enqueued + * and processed downstream. As a consequence, when a response is returned, + * updates are not immediately manifested in the * [Product][google.cloud.retail.v2.Product] queried by * [ProductService.GetProduct][google.cloud.retail.v2.ProductService.GetProduct] * or @@ -681,32 +681,34 @@ public void importProducts( * [ProductService.CreateProduct][google.cloud.retail.v2.ProductService.CreateProduct] * and * [ProductService.UpdateProduct][google.cloud.retail.v2.ProductService.UpdateProduct], - * the specified inventory field value(s) will overwrite any existing value(s) + * the specified inventory field value(s) overwrite any existing value(s) * while ignoring the last update time for this field. Furthermore, the last - * update time for the specified inventory fields will be overwritten to the - * time of the + * update times for the specified inventory fields are overwritten by the + * times of the * [ProductService.CreateProduct][google.cloud.retail.v2.ProductService.CreateProduct] * or * [ProductService.UpdateProduct][google.cloud.retail.v2.ProductService.UpdateProduct] * request. * If no inventory fields are set in * [CreateProductRequest.product][google.cloud.retail.v2.CreateProductRequest.product], - * then any pre-existing inventory information for this product will be used. + * then any pre-existing inventory information for this product is used. * If no inventory fields are set in * [SetInventoryRequest.set_mask][google.cloud.retail.v2.SetInventoryRequest.set_mask], - * then any existing inventory information will be preserved. + * then any existing inventory information is preserved. * Pre-existing inventory information can only be updated with * [ProductService.SetInventory][google.cloud.retail.v2.ProductService.SetInventory], * [ProductService.AddFulfillmentPlaces][google.cloud.retail.v2.ProductService.AddFulfillmentPlaces], * and * [ProductService.RemoveFulfillmentPlaces][google.cloud.retail.v2.ProductService.RemoveFulfillmentPlaces]. - * The returned [Operation][]s will be obsolete after 1 day, and - * [GetOperation][] API will return NOT_FOUND afterwards. - * If conflicting updates are issued, the [Operation][]s associated with the - * stale updates will not be marked as [done][Operation.done] until being - * obsolete. + * The returned [Operation][google.longrunning.Operation]s is obsolete after + * one day, and the [GetOperation][google.longrunning.Operations.GetOperation] + * API returns `NOT_FOUND` afterwards. + * If conflicting updates are issued, the + * [Operation][google.longrunning.Operation]s associated with the stale + * updates are not marked as [done][google.longrunning.Operation.done] until + * they are obsolete. * This feature is only available for users who have Retail Search enabled. - * Please enable Retail Search on Cloud Console before using this feature. + * Enable Retail Search on Cloud Console before using this feature. * */ public void setInventory( @@ -731,13 +733,15 @@ public void setInventory( * [ProductService.GetProduct][google.cloud.retail.v2.ProductService.GetProduct] * or * [ProductService.ListProducts][google.cloud.retail.v2.ProductService.ListProducts]. - * The returned [Operation][]s will be obsolete after 1 day, and - * [GetOperation][] API will return NOT_FOUND afterwards. - * If conflicting updates are issued, the [Operation][]s associated with the - * stale updates will not be marked as [done][Operation.done] until being - * obsolete. + * The returned [Operation][google.longrunning.Operation]s will be obsolete + * after 1 day, and [GetOperation][google.longrunning.Operations.GetOperation] + * API will return NOT_FOUND afterwards. + * If conflicting updates are issued, the + * [Operation][google.longrunning.Operation]s associated with the stale + * updates will not be marked as [done][google.longrunning.Operation.done] + * until being obsolete. * This feature is only available for users who have Retail Search enabled. - * Please enable Retail Search on Cloud Console before using this feature. + * Enable Retail Search on Cloud Console before using this feature. * */ public void addFulfillmentPlaces( @@ -762,13 +766,15 @@ public void addFulfillmentPlaces( * [ProductService.GetProduct][google.cloud.retail.v2.ProductService.GetProduct] * or * [ProductService.ListProducts][google.cloud.retail.v2.ProductService.ListProducts]. - * The returned [Operation][]s will be obsolete after 1 day, and - * [GetOperation][] API will return NOT_FOUND afterwards. - * If conflicting updates are issued, the [Operation][]s associated with the - * stale updates will not be marked as [done][Operation.done] until being - * obsolete. + * The returned [Operation][google.longrunning.Operation]s will be obsolete + * after 1 day, and [GetOperation][google.longrunning.Operations.GetOperation] + * API will return NOT_FOUND afterwards. + * If conflicting updates are issued, the + * [Operation][google.longrunning.Operation]s associated with the stale + * updates will not be marked as [done][google.longrunning.Operation.done] + * until being obsolete. * This feature is only available for users who have Retail Search enabled. - * Please enable Retail Search on Cloud Console before using this feature. + * Enable Retail Search on Cloud Console before using this feature. * */ public void removeFulfillmentPlaces( @@ -799,13 +805,15 @@ public void removeFulfillmentPlaces( * and * [ProductService.UpdateProduct][google.cloud.retail.v2.ProductService.UpdateProduct] * has no effect on local inventories. - * The returned [Operation][]s will be obsolete after 1 day, and - * [GetOperation][] API will return NOT_FOUND afterwards. - * If conflicting updates are issued, the [Operation][]s associated with the - * stale updates will not be marked as [done][Operation.done] until being - * obsolete. + * The returned [Operation][google.longrunning.Operation]s will be obsolete + * after 1 day, and [GetOperation][google.longrunning.Operations.GetOperation] + * API will return NOT_FOUND afterwards. + * If conflicting updates are issued, the + * [Operation][google.longrunning.Operation]s associated with the stale + * updates will not be marked as [done][google.longrunning.Operation.done] + * until being obsolete. * This feature is only available for users who have Retail Search enabled. - * Please enable Retail Search on Cloud Console before using this feature. + * Enable Retail Search on Cloud Console before using this feature. * */ public void addLocalInventories( @@ -834,13 +842,15 @@ public void addLocalInventories( * and * [ProductService.UpdateProduct][google.cloud.retail.v2.ProductService.UpdateProduct] * has no effect on local inventories. - * The returned [Operation][]s will be obsolete after 1 day, and - * [GetOperation][] API will return NOT_FOUND afterwards. - * If conflicting updates are issued, the [Operation][]s associated with the - * stale updates will not be marked as [done][Operation.done] until being - * obsolete. + * The returned [Operation][google.longrunning.Operation]s will be obsolete + * after 1 day, and [GetOperation][google.longrunning.Operations.GetOperation] + * API will return NOT_FOUND afterwards. + * If conflicting updates are issued, the + * [Operation][google.longrunning.Operation]s associated with the stale + * updates will not be marked as [done][google.longrunning.Operation.done] + * until being obsolete. * This feature is only available for users who have Retail Search enabled. - * Please enable Retail Search on Cloud Console before using this feature. + * Enable Retail Search on Cloud Console before using this feature. * */ public void removeLocalInventories( @@ -1051,9 +1061,9 @@ public void importProducts( * timestamps of each inventory field. * This process is asynchronous and does not require the * [Product][google.cloud.retail.v2.Product] to exist before updating - * fulfillment information. If the request is valid, the update will be - * enqueued and processed downstream. As a consequence, when a response is - * returned, updates are not immediately manifested in the + * fulfillment information. If the request is valid, the update is enqueued + * and processed downstream. As a consequence, when a response is returned, + * updates are not immediately manifested in the * [Product][google.cloud.retail.v2.Product] queried by * [ProductService.GetProduct][google.cloud.retail.v2.ProductService.GetProduct] * or @@ -1062,32 +1072,34 @@ public void importProducts( * [ProductService.CreateProduct][google.cloud.retail.v2.ProductService.CreateProduct] * and * [ProductService.UpdateProduct][google.cloud.retail.v2.ProductService.UpdateProduct], - * the specified inventory field value(s) will overwrite any existing value(s) + * the specified inventory field value(s) overwrite any existing value(s) * while ignoring the last update time for this field. Furthermore, the last - * update time for the specified inventory fields will be overwritten to the - * time of the + * update times for the specified inventory fields are overwritten by the + * times of the * [ProductService.CreateProduct][google.cloud.retail.v2.ProductService.CreateProduct] * or * [ProductService.UpdateProduct][google.cloud.retail.v2.ProductService.UpdateProduct] * request. * If no inventory fields are set in * [CreateProductRequest.product][google.cloud.retail.v2.CreateProductRequest.product], - * then any pre-existing inventory information for this product will be used. + * then any pre-existing inventory information for this product is used. * If no inventory fields are set in * [SetInventoryRequest.set_mask][google.cloud.retail.v2.SetInventoryRequest.set_mask], - * then any existing inventory information will be preserved. + * then any existing inventory information is preserved. * Pre-existing inventory information can only be updated with * [ProductService.SetInventory][google.cloud.retail.v2.ProductService.SetInventory], * [ProductService.AddFulfillmentPlaces][google.cloud.retail.v2.ProductService.AddFulfillmentPlaces], * and * [ProductService.RemoveFulfillmentPlaces][google.cloud.retail.v2.ProductService.RemoveFulfillmentPlaces]. - * The returned [Operation][]s will be obsolete after 1 day, and - * [GetOperation][] API will return NOT_FOUND afterwards. - * If conflicting updates are issued, the [Operation][]s associated with the - * stale updates will not be marked as [done][Operation.done] until being - * obsolete. + * The returned [Operation][google.longrunning.Operation]s is obsolete after + * one day, and the [GetOperation][google.longrunning.Operations.GetOperation] + * API returns `NOT_FOUND` afterwards. + * If conflicting updates are issued, the + * [Operation][google.longrunning.Operation]s associated with the stale + * updates are not marked as [done][google.longrunning.Operation.done] until + * they are obsolete. * This feature is only available for users who have Retail Search enabled. - * Please enable Retail Search on Cloud Console before using this feature. + * Enable Retail Search on Cloud Console before using this feature. * */ public void setInventory( @@ -1114,13 +1126,15 @@ public void setInventory( * [ProductService.GetProduct][google.cloud.retail.v2.ProductService.GetProduct] * or * [ProductService.ListProducts][google.cloud.retail.v2.ProductService.ListProducts]. - * The returned [Operation][]s will be obsolete after 1 day, and - * [GetOperation][] API will return NOT_FOUND afterwards. - * If conflicting updates are issued, the [Operation][]s associated with the - * stale updates will not be marked as [done][Operation.done] until being - * obsolete. + * The returned [Operation][google.longrunning.Operation]s will be obsolete + * after 1 day, and [GetOperation][google.longrunning.Operations.GetOperation] + * API will return NOT_FOUND afterwards. + * If conflicting updates are issued, the + * [Operation][google.longrunning.Operation]s associated with the stale + * updates will not be marked as [done][google.longrunning.Operation.done] + * until being obsolete. * This feature is only available for users who have Retail Search enabled. - * Please enable Retail Search on Cloud Console before using this feature. + * Enable Retail Search on Cloud Console before using this feature. * */ public void addFulfillmentPlaces( @@ -1147,13 +1161,15 @@ public void addFulfillmentPlaces( * [ProductService.GetProduct][google.cloud.retail.v2.ProductService.GetProduct] * or * [ProductService.ListProducts][google.cloud.retail.v2.ProductService.ListProducts]. - * The returned [Operation][]s will be obsolete after 1 day, and - * [GetOperation][] API will return NOT_FOUND afterwards. - * If conflicting updates are issued, the [Operation][]s associated with the - * stale updates will not be marked as [done][Operation.done] until being - * obsolete. + * The returned [Operation][google.longrunning.Operation]s will be obsolete + * after 1 day, and [GetOperation][google.longrunning.Operations.GetOperation] + * API will return NOT_FOUND afterwards. + * If conflicting updates are issued, the + * [Operation][google.longrunning.Operation]s associated with the stale + * updates will not be marked as [done][google.longrunning.Operation.done] + * until being obsolete. * This feature is only available for users who have Retail Search enabled. - * Please enable Retail Search on Cloud Console before using this feature. + * Enable Retail Search on Cloud Console before using this feature. * */ public void removeFulfillmentPlaces( @@ -1186,13 +1202,15 @@ public void removeFulfillmentPlaces( * and * [ProductService.UpdateProduct][google.cloud.retail.v2.ProductService.UpdateProduct] * has no effect on local inventories. - * The returned [Operation][]s will be obsolete after 1 day, and - * [GetOperation][] API will return NOT_FOUND afterwards. - * If conflicting updates are issued, the [Operation][]s associated with the - * stale updates will not be marked as [done][Operation.done] until being - * obsolete. + * The returned [Operation][google.longrunning.Operation]s will be obsolete + * after 1 day, and [GetOperation][google.longrunning.Operations.GetOperation] + * API will return NOT_FOUND afterwards. + * If conflicting updates are issued, the + * [Operation][google.longrunning.Operation]s associated with the stale + * updates will not be marked as [done][google.longrunning.Operation.done] + * until being obsolete. * This feature is only available for users who have Retail Search enabled. - * Please enable Retail Search on Cloud Console before using this feature. + * Enable Retail Search on Cloud Console before using this feature. * */ public void addLocalInventories( @@ -1223,13 +1241,15 @@ public void addLocalInventories( * and * [ProductService.UpdateProduct][google.cloud.retail.v2.ProductService.UpdateProduct] * has no effect on local inventories. - * The returned [Operation][]s will be obsolete after 1 day, and - * [GetOperation][] API will return NOT_FOUND afterwards. - * If conflicting updates are issued, the [Operation][]s associated with the - * stale updates will not be marked as [done][Operation.done] until being - * obsolete. + * The returned [Operation][google.longrunning.Operation]s will be obsolete + * after 1 day, and [GetOperation][google.longrunning.Operations.GetOperation] + * API will return NOT_FOUND afterwards. + * If conflicting updates are issued, the + * [Operation][google.longrunning.Operation]s associated with the stale + * updates will not be marked as [done][google.longrunning.Operation.done] + * until being obsolete. * This feature is only available for users who have Retail Search enabled. - * Please enable Retail Search on Cloud Console before using this feature. + * Enable Retail Search on Cloud Console before using this feature. * */ public void removeLocalInventories( @@ -1353,9 +1373,9 @@ public com.google.longrunning.Operation importProducts( * timestamps of each inventory field. * This process is asynchronous and does not require the * [Product][google.cloud.retail.v2.Product] to exist before updating - * fulfillment information. If the request is valid, the update will be - * enqueued and processed downstream. As a consequence, when a response is - * returned, updates are not immediately manifested in the + * fulfillment information. If the request is valid, the update is enqueued + * and processed downstream. As a consequence, when a response is returned, + * updates are not immediately manifested in the * [Product][google.cloud.retail.v2.Product] queried by * [ProductService.GetProduct][google.cloud.retail.v2.ProductService.GetProduct] * or @@ -1364,32 +1384,34 @@ public com.google.longrunning.Operation importProducts( * [ProductService.CreateProduct][google.cloud.retail.v2.ProductService.CreateProduct] * and * [ProductService.UpdateProduct][google.cloud.retail.v2.ProductService.UpdateProduct], - * the specified inventory field value(s) will overwrite any existing value(s) + * the specified inventory field value(s) overwrite any existing value(s) * while ignoring the last update time for this field. Furthermore, the last - * update time for the specified inventory fields will be overwritten to the - * time of the + * update times for the specified inventory fields are overwritten by the + * times of the * [ProductService.CreateProduct][google.cloud.retail.v2.ProductService.CreateProduct] * or * [ProductService.UpdateProduct][google.cloud.retail.v2.ProductService.UpdateProduct] * request. * If no inventory fields are set in * [CreateProductRequest.product][google.cloud.retail.v2.CreateProductRequest.product], - * then any pre-existing inventory information for this product will be used. + * then any pre-existing inventory information for this product is used. * If no inventory fields are set in * [SetInventoryRequest.set_mask][google.cloud.retail.v2.SetInventoryRequest.set_mask], - * then any existing inventory information will be preserved. + * then any existing inventory information is preserved. * Pre-existing inventory information can only be updated with * [ProductService.SetInventory][google.cloud.retail.v2.ProductService.SetInventory], * [ProductService.AddFulfillmentPlaces][google.cloud.retail.v2.ProductService.AddFulfillmentPlaces], * and * [ProductService.RemoveFulfillmentPlaces][google.cloud.retail.v2.ProductService.RemoveFulfillmentPlaces]. - * The returned [Operation][]s will be obsolete after 1 day, and - * [GetOperation][] API will return NOT_FOUND afterwards. - * If conflicting updates are issued, the [Operation][]s associated with the - * stale updates will not be marked as [done][Operation.done] until being - * obsolete. + * The returned [Operation][google.longrunning.Operation]s is obsolete after + * one day, and the [GetOperation][google.longrunning.Operations.GetOperation] + * API returns `NOT_FOUND` afterwards. + * If conflicting updates are issued, the + * [Operation][google.longrunning.Operation]s associated with the stale + * updates are not marked as [done][google.longrunning.Operation.done] until + * they are obsolete. * This feature is only available for users who have Retail Search enabled. - * Please enable Retail Search on Cloud Console before using this feature. + * Enable Retail Search on Cloud Console before using this feature. * */ public com.google.longrunning.Operation setInventory( @@ -1413,13 +1435,15 @@ public com.google.longrunning.Operation setInventory( * [ProductService.GetProduct][google.cloud.retail.v2.ProductService.GetProduct] * or * [ProductService.ListProducts][google.cloud.retail.v2.ProductService.ListProducts]. - * The returned [Operation][]s will be obsolete after 1 day, and - * [GetOperation][] API will return NOT_FOUND afterwards. - * If conflicting updates are issued, the [Operation][]s associated with the - * stale updates will not be marked as [done][Operation.done] until being - * obsolete. + * The returned [Operation][google.longrunning.Operation]s will be obsolete + * after 1 day, and [GetOperation][google.longrunning.Operations.GetOperation] + * API will return NOT_FOUND afterwards. + * If conflicting updates are issued, the + * [Operation][google.longrunning.Operation]s associated with the stale + * updates will not be marked as [done][google.longrunning.Operation.done] + * until being obsolete. * This feature is only available for users who have Retail Search enabled. - * Please enable Retail Search on Cloud Console before using this feature. + * Enable Retail Search on Cloud Console before using this feature. * */ public com.google.longrunning.Operation addFulfillmentPlaces( @@ -1443,13 +1467,15 @@ public com.google.longrunning.Operation addFulfillmentPlaces( * [ProductService.GetProduct][google.cloud.retail.v2.ProductService.GetProduct] * or * [ProductService.ListProducts][google.cloud.retail.v2.ProductService.ListProducts]. - * The returned [Operation][]s will be obsolete after 1 day, and - * [GetOperation][] API will return NOT_FOUND afterwards. - * If conflicting updates are issued, the [Operation][]s associated with the - * stale updates will not be marked as [done][Operation.done] until being - * obsolete. + * The returned [Operation][google.longrunning.Operation]s will be obsolete + * after 1 day, and [GetOperation][google.longrunning.Operations.GetOperation] + * API will return NOT_FOUND afterwards. + * If conflicting updates are issued, the + * [Operation][google.longrunning.Operation]s associated with the stale + * updates will not be marked as [done][google.longrunning.Operation.done] + * until being obsolete. * This feature is only available for users who have Retail Search enabled. - * Please enable Retail Search on Cloud Console before using this feature. + * Enable Retail Search on Cloud Console before using this feature. * */ public com.google.longrunning.Operation removeFulfillmentPlaces( @@ -1479,13 +1505,15 @@ public com.google.longrunning.Operation removeFulfillmentPlaces( * and * [ProductService.UpdateProduct][google.cloud.retail.v2.ProductService.UpdateProduct] * has no effect on local inventories. - * The returned [Operation][]s will be obsolete after 1 day, and - * [GetOperation][] API will return NOT_FOUND afterwards. - * If conflicting updates are issued, the [Operation][]s associated with the - * stale updates will not be marked as [done][Operation.done] until being - * obsolete. + * The returned [Operation][google.longrunning.Operation]s will be obsolete + * after 1 day, and [GetOperation][google.longrunning.Operations.GetOperation] + * API will return NOT_FOUND afterwards. + * If conflicting updates are issued, the + * [Operation][google.longrunning.Operation]s associated with the stale + * updates will not be marked as [done][google.longrunning.Operation.done] + * until being obsolete. * This feature is only available for users who have Retail Search enabled. - * Please enable Retail Search on Cloud Console before using this feature. + * Enable Retail Search on Cloud Console before using this feature. * */ public com.google.longrunning.Operation addLocalInventories( @@ -1513,13 +1541,15 @@ public com.google.longrunning.Operation addLocalInventories( * and * [ProductService.UpdateProduct][google.cloud.retail.v2.ProductService.UpdateProduct] * has no effect on local inventories. - * The returned [Operation][]s will be obsolete after 1 day, and - * [GetOperation][] API will return NOT_FOUND afterwards. - * If conflicting updates are issued, the [Operation][]s associated with the - * stale updates will not be marked as [done][Operation.done] until being - * obsolete. + * The returned [Operation][google.longrunning.Operation]s will be obsolete + * after 1 day, and [GetOperation][google.longrunning.Operations.GetOperation] + * API will return NOT_FOUND afterwards. + * If conflicting updates are issued, the + * [Operation][google.longrunning.Operation]s associated with the stale + * updates will not be marked as [done][google.longrunning.Operation.done] + * until being obsolete. * This feature is only available for users who have Retail Search enabled. - * Please enable Retail Search on Cloud Console before using this feature. + * Enable Retail Search on Cloud Console before using this feature. * */ public com.google.longrunning.Operation removeLocalInventories( @@ -1641,9 +1671,9 @@ protected ProductServiceFutureStub build( * timestamps of each inventory field. * This process is asynchronous and does not require the * [Product][google.cloud.retail.v2.Product] to exist before updating - * fulfillment information. If the request is valid, the update will be - * enqueued and processed downstream. As a consequence, when a response is - * returned, updates are not immediately manifested in the + * fulfillment information. If the request is valid, the update is enqueued + * and processed downstream. As a consequence, when a response is returned, + * updates are not immediately manifested in the * [Product][google.cloud.retail.v2.Product] queried by * [ProductService.GetProduct][google.cloud.retail.v2.ProductService.GetProduct] * or @@ -1652,32 +1682,34 @@ protected ProductServiceFutureStub build( * [ProductService.CreateProduct][google.cloud.retail.v2.ProductService.CreateProduct] * and * [ProductService.UpdateProduct][google.cloud.retail.v2.ProductService.UpdateProduct], - * the specified inventory field value(s) will overwrite any existing value(s) + * the specified inventory field value(s) overwrite any existing value(s) * while ignoring the last update time for this field. Furthermore, the last - * update time for the specified inventory fields will be overwritten to the - * time of the + * update times for the specified inventory fields are overwritten by the + * times of the * [ProductService.CreateProduct][google.cloud.retail.v2.ProductService.CreateProduct] * or * [ProductService.UpdateProduct][google.cloud.retail.v2.ProductService.UpdateProduct] * request. * If no inventory fields are set in * [CreateProductRequest.product][google.cloud.retail.v2.CreateProductRequest.product], - * then any pre-existing inventory information for this product will be used. + * then any pre-existing inventory information for this product is used. * If no inventory fields are set in * [SetInventoryRequest.set_mask][google.cloud.retail.v2.SetInventoryRequest.set_mask], - * then any existing inventory information will be preserved. + * then any existing inventory information is preserved. * Pre-existing inventory information can only be updated with * [ProductService.SetInventory][google.cloud.retail.v2.ProductService.SetInventory], * [ProductService.AddFulfillmentPlaces][google.cloud.retail.v2.ProductService.AddFulfillmentPlaces], * and * [ProductService.RemoveFulfillmentPlaces][google.cloud.retail.v2.ProductService.RemoveFulfillmentPlaces]. - * The returned [Operation][]s will be obsolete after 1 day, and - * [GetOperation][] API will return NOT_FOUND afterwards. - * If conflicting updates are issued, the [Operation][]s associated with the - * stale updates will not be marked as [done][Operation.done] until being - * obsolete. + * The returned [Operation][google.longrunning.Operation]s is obsolete after + * one day, and the [GetOperation][google.longrunning.Operations.GetOperation] + * API returns `NOT_FOUND` afterwards. + * If conflicting updates are issued, the + * [Operation][google.longrunning.Operation]s associated with the stale + * updates are not marked as [done][google.longrunning.Operation.done] until + * they are obsolete. * This feature is only available for users who have Retail Search enabled. - * Please enable Retail Search on Cloud Console before using this feature. + * Enable Retail Search on Cloud Console before using this feature. * */ public com.google.common.util.concurrent.ListenableFuture @@ -1701,13 +1733,15 @@ protected ProductServiceFutureStub build( * [ProductService.GetProduct][google.cloud.retail.v2.ProductService.GetProduct] * or * [ProductService.ListProducts][google.cloud.retail.v2.ProductService.ListProducts]. - * The returned [Operation][]s will be obsolete after 1 day, and - * [GetOperation][] API will return NOT_FOUND afterwards. - * If conflicting updates are issued, the [Operation][]s associated with the - * stale updates will not be marked as [done][Operation.done] until being - * obsolete. + * The returned [Operation][google.longrunning.Operation]s will be obsolete + * after 1 day, and [GetOperation][google.longrunning.Operations.GetOperation] + * API will return NOT_FOUND afterwards. + * If conflicting updates are issued, the + * [Operation][google.longrunning.Operation]s associated with the stale + * updates will not be marked as [done][google.longrunning.Operation.done] + * until being obsolete. * This feature is only available for users who have Retail Search enabled. - * Please enable Retail Search on Cloud Console before using this feature. + * Enable Retail Search on Cloud Console before using this feature. * */ public com.google.common.util.concurrent.ListenableFuture @@ -1731,13 +1765,15 @@ protected ProductServiceFutureStub build( * [ProductService.GetProduct][google.cloud.retail.v2.ProductService.GetProduct] * or * [ProductService.ListProducts][google.cloud.retail.v2.ProductService.ListProducts]. - * The returned [Operation][]s will be obsolete after 1 day, and - * [GetOperation][] API will return NOT_FOUND afterwards. - * If conflicting updates are issued, the [Operation][]s associated with the - * stale updates will not be marked as [done][Operation.done] until being - * obsolete. + * The returned [Operation][google.longrunning.Operation]s will be obsolete + * after 1 day, and [GetOperation][google.longrunning.Operations.GetOperation] + * API will return NOT_FOUND afterwards. + * If conflicting updates are issued, the + * [Operation][google.longrunning.Operation]s associated with the stale + * updates will not be marked as [done][google.longrunning.Operation.done] + * until being obsolete. * This feature is only available for users who have Retail Search enabled. - * Please enable Retail Search on Cloud Console before using this feature. + * Enable Retail Search on Cloud Console before using this feature. * */ public com.google.common.util.concurrent.ListenableFuture @@ -1767,13 +1803,15 @@ protected ProductServiceFutureStub build( * and * [ProductService.UpdateProduct][google.cloud.retail.v2.ProductService.UpdateProduct] * has no effect on local inventories. - * The returned [Operation][]s will be obsolete after 1 day, and - * [GetOperation][] API will return NOT_FOUND afterwards. - * If conflicting updates are issued, the [Operation][]s associated with the - * stale updates will not be marked as [done][Operation.done] until being - * obsolete. + * The returned [Operation][google.longrunning.Operation]s will be obsolete + * after 1 day, and [GetOperation][google.longrunning.Operations.GetOperation] + * API will return NOT_FOUND afterwards. + * If conflicting updates are issued, the + * [Operation][google.longrunning.Operation]s associated with the stale + * updates will not be marked as [done][google.longrunning.Operation.done] + * until being obsolete. * This feature is only available for users who have Retail Search enabled. - * Please enable Retail Search on Cloud Console before using this feature. + * Enable Retail Search on Cloud Console before using this feature. * */ public com.google.common.util.concurrent.ListenableFuture @@ -1801,13 +1839,15 @@ protected ProductServiceFutureStub build( * and * [ProductService.UpdateProduct][google.cloud.retail.v2.ProductService.UpdateProduct] * has no effect on local inventories. - * The returned [Operation][]s will be obsolete after 1 day, and - * [GetOperation][] API will return NOT_FOUND afterwards. - * If conflicting updates are issued, the [Operation][]s associated with the - * stale updates will not be marked as [done][Operation.done] until being - * obsolete. + * The returned [Operation][google.longrunning.Operation]s will be obsolete + * after 1 day, and [GetOperation][google.longrunning.Operations.GetOperation] + * API will return NOT_FOUND afterwards. + * If conflicting updates are issued, the + * [Operation][google.longrunning.Operation]s associated with the stale + * updates will not be marked as [done][google.longrunning.Operation.done] + * until being obsolete. * This feature is only available for users who have Retail Search enabled. - * Please enable Retail Search on Cloud Console before using this feature. + * Enable Retail Search on Cloud Console before using this feature. * */ public com.google.common.util.concurrent.ListenableFuture diff --git a/java-retail/grpc-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/SearchServiceGrpc.java b/java-retail/grpc-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/SearchServiceGrpc.java index c37a610c1bd5..d73ac15a3b06 100644 --- a/java-retail/grpc-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/SearchServiceGrpc.java +++ b/java-retail/grpc-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/SearchServiceGrpc.java @@ -23,7 +23,7 @@ * 
        * Service for search.
  * This feature is only available for users who have Retail Search enabled.
- * Please enable Retail Search on Cloud Console before using this feature.
+ * Enable Retail Search on Cloud Console before using this feature.
  *
      */ @javax.annotation.Generated( @@ -125,7 +125,7 @@ public SearchServiceFutureStub newStub( * 
          * Service for search.
    * This feature is only available for users who have Retail Search enabled.
-   * Please enable Retail Search on Cloud Console before using this feature.
+   * Enable Retail Search on Cloud Console before using this feature.
    *
      */ public abstract static class SearchServiceImplBase implements io.grpc.BindableService { @@ -136,7 +136,7 @@ public abstract static class SearchServiceImplBase implements io.grpc.BindableSe * 
            * Performs a search.
      * This feature is only available for users who have Retail Search enabled.
-     * Please enable Retail Search on Cloud Console before using this feature.
+     * Enable Retail Search on Cloud Console before using this feature.
      *
      */ public void search( @@ -164,7 +164,7 @@ public final io.grpc.ServerServiceDefinition bindService() { * 
          * Service for search.
    * This feature is only available for users who have Retail Search enabled.
-   * Please enable Retail Search on Cloud Console before using this feature.
+   * Enable Retail Search on Cloud Console before using this feature.
    *
      */ public static final class SearchServiceStub @@ -184,7 +184,7 @@ protected SearchServiceStub build(io.grpc.Channel channel, io.grpc.CallOptions c * 
            * Performs a search.
      * This feature is only available for users who have Retail Search enabled.
-     * Please enable Retail Search on Cloud Console before using this feature.
+     * Enable Retail Search on Cloud Console before using this feature.
      *
      */ public void search( @@ -201,7 +201,7 @@ public void search( * 
          * Service for search.
    * This feature is only available for users who have Retail Search enabled.
-   * Please enable Retail Search on Cloud Console before using this feature.
+   * Enable Retail Search on Cloud Console before using this feature.
    *
      */ public static final class SearchServiceBlockingStub @@ -222,7 +222,7 @@ protected SearchServiceBlockingStub build( * 
            * Performs a search.
      * This feature is only available for users who have Retail Search enabled.
-     * Please enable Retail Search on Cloud Console before using this feature.
+     * Enable Retail Search on Cloud Console before using this feature.
      *
      */ public com.google.cloud.retail.v2.SearchResponse search( @@ -238,7 +238,7 @@ public com.google.cloud.retail.v2.SearchResponse search( * 
          * Service for search.
    * This feature is only available for users who have Retail Search enabled.
-   * Please enable Retail Search on Cloud Console before using this feature.
+   * Enable Retail Search on Cloud Console before using this feature.
    *
      */ public static final class SearchServiceFutureStub @@ -259,7 +259,7 @@ protected SearchServiceFutureStub build( * 
            * Performs a search.
      * This feature is only available for users who have Retail Search enabled.
-     * Please enable Retail Search on Cloud Console before using this feature.
+     * Enable Retail Search on Cloud Console before using this feature.
      *
      */ public com.google.common.util.concurrent.ListenableFuture< diff --git a/java-retail/grpc-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/UserEventServiceGrpc.java b/java-retail/grpc-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/UserEventServiceGrpc.java index ffff48c5b1ba..cc85c8ef898f 100644 --- a/java-retail/grpc-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/UserEventServiceGrpc.java +++ b/java-retail/grpc-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/UserEventServiceGrpc.java @@ -370,14 +370,14 @@ public void importUserEvents( * * * 
      -     * Starts a user event rejoin operation with latest product catalog. Events
-     * will not be annotated with detailed product information if product is
-     * missing from the catalog at the time the user event is ingested, and these
-     * events are stored as unjoined events with a limited usage on training and
-     * serving. This method can be used to start a join operation on specified
-     * events with latest version of product catalog. It can also be used to
-     * correct events joined with the wrong product catalog. A rejoin operation
-     * can take hours or days to complete.
+     * Starts a user-event rejoin operation with latest product catalog. Events
+     * are not annotated with detailed product information for products that are
+     * missing from the catalog when the user event is ingested. These
+     * events are stored as unjoined events with limited usage on training and
+     * serving. You can use this method to start a join operation on specified
+     * events with the latest version of product catalog. You can also use this
+     * method to correct events joined with the wrong product catalog. A rejoin
+     * operation can take hours or days to complete.
      *
      */ public void rejoinUserEvents( @@ -521,14 +521,14 @@ public void importUserEvents( * * * 
      -     * Starts a user event rejoin operation with latest product catalog. Events
-     * will not be annotated with detailed product information if product is
-     * missing from the catalog at the time the user event is ingested, and these
-     * events are stored as unjoined events with a limited usage on training and
-     * serving. This method can be used to start a join operation on specified
-     * events with latest version of product catalog. It can also be used to
-     * correct events joined with the wrong product catalog. A rejoin operation
-     * can take hours or days to complete.
+     * Starts a user-event rejoin operation with latest product catalog. Events
+     * are not annotated with detailed product information for products that are
+     * missing from the catalog when the user event is ingested. These
+     * events are stored as unjoined events with limited usage on training and
+     * serving. You can use this method to start a join operation on specified
+     * events with the latest version of product catalog. You can also use this
+     * method to correct events joined with the wrong product catalog. A rejoin
+     * operation can take hours or days to complete.
      *
      */ public void rejoinUserEvents( @@ -627,14 +627,14 @@ public com.google.longrunning.Operation importUserEvents( * * * 
      -     * Starts a user event rejoin operation with latest product catalog. Events
-     * will not be annotated with detailed product information if product is
-     * missing from the catalog at the time the user event is ingested, and these
-     * events are stored as unjoined events with a limited usage on training and
-     * serving. This method can be used to start a join operation on specified
-     * events with latest version of product catalog. It can also be used to
-     * correct events joined with the wrong product catalog. A rejoin operation
-     * can take hours or days to complete.
+     * Starts a user-event rejoin operation with latest product catalog. Events
+     * are not annotated with detailed product information for products that are
+     * missing from the catalog when the user event is ingested. These
+     * events are stored as unjoined events with limited usage on training and
+     * serving. You can use this method to start a join operation on specified
+     * events with the latest version of product catalog. You can also use this
+     * method to correct events joined with the wrong product catalog. A rejoin
+     * operation can take hours or days to complete.
      *
      */ public com.google.longrunning.Operation rejoinUserEvents( @@ -730,14 +730,14 @@ protected UserEventServiceFutureStub build( * * * 
      -     * Starts a user event rejoin operation with latest product catalog. Events
-     * will not be annotated with detailed product information if product is
-     * missing from the catalog at the time the user event is ingested, and these
-     * events are stored as unjoined events with a limited usage on training and
-     * serving. This method can be used to start a join operation on specified
-     * events with latest version of product catalog. It can also be used to
-     * correct events joined with the wrong product catalog. A rejoin operation
-     * can take hours or days to complete.
+     * Starts a user-event rejoin operation with latest product catalog. Events
+     * are not annotated with detailed product information for products that are
+     * missing from the catalog when the user event is ingested. These
+     * events are stored as unjoined events with limited usage on training and
+     * serving. You can use this method to start a join operation on specified
+     * events with the latest version of product catalog. You can also use this
+     * method to correct events joined with the wrong product catalog. A rejoin
+     * operation can take hours or days to complete.
      *
      */ public com.google.common.util.concurrent.ListenableFuture diff --git a/java-retail/grpc-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/CatalogServiceGrpc.java b/java-retail/grpc-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/CatalogServiceGrpc.java index 3184aec34034..30968754f568 100644 --- a/java-retail/grpc-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/CatalogServiceGrpc.java +++ b/java-retail/grpc-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/CatalogServiceGrpc.java @@ -515,6 +515,59 @@ private CatalogServiceGrpc() {} return getRemoveCatalogAttributeMethod; } + private static volatile io.grpc.MethodDescriptor< + com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesRequest, + com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesResponse> + getBatchRemoveCatalogAttributesMethod; + + @io.grpc.stub.annotations.RpcMethod( + fullMethodName = SERVICE_NAME + '/' + "BatchRemoveCatalogAttributes", + requestType = com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesRequest.class, + responseType = com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesResponse.class, + methodType = io.grpc.MethodDescriptor.MethodType.UNARY) + public static io.grpc.MethodDescriptor< + com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesRequest, + com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesResponse> + getBatchRemoveCatalogAttributesMethod() { + io.grpc.MethodDescriptor< + com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesRequest, + com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesResponse> + getBatchRemoveCatalogAttributesMethod; + if ((getBatchRemoveCatalogAttributesMethod = + CatalogServiceGrpc.getBatchRemoveCatalogAttributesMethod) + == null) { + synchronized (CatalogServiceGrpc.class) { + if ((getBatchRemoveCatalogAttributesMethod = + CatalogServiceGrpc.getBatchRemoveCatalogAttributesMethod) + == null) { + CatalogServiceGrpc.getBatchRemoveCatalogAttributesMethod = + getBatchRemoveCatalogAttributesMethod = + io.grpc.MethodDescriptor + . + newBuilder() + .setType(io.grpc.MethodDescriptor.MethodType.UNARY) + .setFullMethodName( + generateFullMethodName(SERVICE_NAME, "BatchRemoveCatalogAttributes")) + .setSampledToLocalTracing(true) + .setRequestMarshaller( + io.grpc.protobuf.ProtoUtils.marshaller( + com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesRequest + .getDefaultInstance())) + .setResponseMarshaller( + io.grpc.protobuf.ProtoUtils.marshaller( + com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesResponse + .getDefaultInstance())) + .setSchemaDescriptor( + new CatalogServiceMethodDescriptorSupplier( + "BatchRemoveCatalogAttributes")) + .build(); + } + } + } + return getBatchRemoveCatalogAttributesMethod; + } + private static volatile io.grpc.MethodDescriptor< com.google.cloud.retail.v2alpha.ReplaceCatalogAttributeRequest, com.google.cloud.retail.v2alpha.AttributesConfig> @@ -809,6 +862,24 @@ public void removeCatalogAttribute( getRemoveCatalogAttributeMethod(), responseObserver); } + /** + * + * + * 
      +     * Removes all specified
+     * [CatalogAttribute][google.cloud.retail.v2alpha.CatalogAttribute]s from the
+     * [AttributesConfig][google.cloud.retail.v2alpha.AttributesConfig].
+     *
      + */ + public void batchRemoveCatalogAttributes( + com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesRequest request, + io.grpc.stub.StreamObserver< + com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesResponse> + responseObserver) { + io.grpc.stub.ServerCalls.asyncUnimplementedUnaryCall( + getBatchRemoveCatalogAttributesMethod(), responseObserver); + } + /** * * @@ -901,6 +972,13 @@ public final io.grpc.ServerServiceDefinition bindService() { com.google.cloud.retail.v2alpha.RemoveCatalogAttributeRequest, com.google.cloud.retail.v2alpha.AttributesConfig>( this, METHODID_REMOVE_CATALOG_ATTRIBUTE))) + .addMethod( + getBatchRemoveCatalogAttributesMethod(), + io.grpc.stub.ServerCalls.asyncUnaryCall( + new MethodHandlers< + com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesRequest, + com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesResponse>( + this, METHODID_BATCH_REMOVE_CATALOG_ATTRIBUTES))) .addMethod( getReplaceCatalogAttributeMethod(), io.grpc.stub.ServerCalls.asyncUnaryCall( @@ -1144,6 +1222,26 @@ public void removeCatalogAttribute( responseObserver); } + /** + * + * + * 
      +     * Removes all specified
+     * [CatalogAttribute][google.cloud.retail.v2alpha.CatalogAttribute]s from the
+     * [AttributesConfig][google.cloud.retail.v2alpha.AttributesConfig].
+     *
      + */ + public void batchRemoveCatalogAttributes( + com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesRequest request, + io.grpc.stub.StreamObserver< + com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesResponse> + responseObserver) { + io.grpc.stub.ClientCalls.asyncUnaryCall( + getChannel().newCall(getBatchRemoveCatalogAttributesMethod(), getCallOptions()), + request, + responseObserver); + } + /** * * @@ -1363,6 +1461,22 @@ public com.google.cloud.retail.v2alpha.AttributesConfig removeCatalogAttribute( getChannel(), getRemoveCatalogAttributeMethod(), getCallOptions(), request); } + /** + * + * + * 
      +     * Removes all specified
+     * [CatalogAttribute][google.cloud.retail.v2alpha.CatalogAttribute]s from the
+     * [AttributesConfig][google.cloud.retail.v2alpha.AttributesConfig].
+     *
      + */ + public com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesResponse + batchRemoveCatalogAttributes( + com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesRequest request) { + return io.grpc.stub.ClientCalls.blockingUnaryCall( + getChannel(), getBatchRemoveCatalogAttributesMethod(), getCallOptions(), request); + } + /** * * @@ -1590,6 +1704,23 @@ protected CatalogServiceFutureStub build( getChannel().newCall(getRemoveCatalogAttributeMethod(), getCallOptions()), request); } + /** + * + * + * 
      +     * Removes all specified
+     * [CatalogAttribute][google.cloud.retail.v2alpha.CatalogAttribute]s from the
+     * [AttributesConfig][google.cloud.retail.v2alpha.AttributesConfig].
+     *
      + */ + public com.google.common.util.concurrent.ListenableFuture< + com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesResponse> + batchRemoveCatalogAttributes( + com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesRequest request) { + return io.grpc.stub.ClientCalls.futureUnaryCall( + getChannel().newCall(getBatchRemoveCatalogAttributesMethod(), getCallOptions()), request); + } + /** * * @@ -1622,7 +1753,8 @@ protected CatalogServiceFutureStub build( private static final int METHODID_UPDATE_ATTRIBUTES_CONFIG = 7; private static final int METHODID_ADD_CATALOG_ATTRIBUTE = 8; private static final int METHODID_REMOVE_CATALOG_ATTRIBUTE = 9; - private static final int METHODID_REPLACE_CATALOG_ATTRIBUTE = 10; + private static final int METHODID_BATCH_REMOVE_CATALOG_ATTRIBUTES = 10; + private static final int METHODID_REPLACE_CATALOG_ATTRIBUTE = 11; private static final class MethodHandlers implements io.grpc.stub.ServerCalls.UnaryMethod, @@ -1701,6 +1833,13 @@ public void invoke(Req request, io.grpc.stub.StreamObserver responseObserv (io.grpc.stub.StreamObserver) responseObserver); break; + case METHODID_BATCH_REMOVE_CATALOG_ATTRIBUTES: + serviceImpl.batchRemoveCatalogAttributes( + (com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesRequest) request, + (io.grpc.stub.StreamObserver< + com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesResponse>) + responseObserver); + break; case METHODID_REPLACE_CATALOG_ATTRIBUTE: serviceImpl.replaceCatalogAttribute( (com.google.cloud.retail.v2alpha.ReplaceCatalogAttributeRequest) request, @@ -1781,6 +1920,7 @@ public static io.grpc.ServiceDescriptor getServiceDescriptor() { .addMethod(getUpdateAttributesConfigMethod()) .addMethod(getAddCatalogAttributeMethod()) .addMethod(getRemoveCatalogAttributeMethod()) + .addMethod(getBatchRemoveCatalogAttributesMethod()) .addMethod(getReplaceCatalogAttributeMethod()) .build(); } diff --git a/java-retail/grpc-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/CompletionServiceGrpc.java b/java-retail/grpc-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/CompletionServiceGrpc.java index 43c0c438e625..77b8f28b1d19 100644 --- a/java-retail/grpc-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/CompletionServiceGrpc.java +++ b/java-retail/grpc-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/CompletionServiceGrpc.java @@ -23,7 +23,7 @@ * 
        * Auto-completion service for retail.
  * This feature is only available for users who have Retail Search enabled.
- * Please enable Retail Search on Cloud Console before using this feature.
+ * Enable Retail Search on Cloud Console before using this feature.
  *
      */ @javax.annotation.Generated( @@ -180,7 +180,7 @@ public CompletionServiceFutureStub newStub( * 
          * Auto-completion service for retail.
    * This feature is only available for users who have Retail Search enabled.
-   * Please enable Retail Search on Cloud Console before using this feature.
+   * Enable Retail Search on Cloud Console before using this feature.
    *
      */ public abstract static class CompletionServiceImplBase implements io.grpc.BindableService { @@ -191,7 +191,7 @@ public abstract static class CompletionServiceImplBase implements io.grpc.Bindab * 
            * Completes the specified prefix with keyword suggestions.
      * This feature is only available for users who have Retail Search enabled.
-     * Please enable Retail Search on Cloud Console before using this feature.
+     * Enable Retail Search on Cloud Console before using this feature.
      *
      */ public void completeQuery( @@ -211,7 +211,7 @@ public void completeQuery( * The operation is successfully finished only after the imported suggestions * are indexed successfully and ready for serving. The process takes hours. * This feature is only available for users who have Retail Search enabled. - * Please enable Retail Search on Cloud Console before using this feature. + * Enable Retail Search on Cloud Console before using this feature. * */ public void importCompletionData( @@ -247,7 +247,7 @@ public final io.grpc.ServerServiceDefinition bindService() { * 
          * Auto-completion service for retail.
    * This feature is only available for users who have Retail Search enabled.
-   * Please enable Retail Search on Cloud Console before using this feature.
+   * Enable Retail Search on Cloud Console before using this feature.
    *
      */ public static final class CompletionServiceStub @@ -268,7 +268,7 @@ protected CompletionServiceStub build( * 
            * Completes the specified prefix with keyword suggestions.
      * This feature is only available for users who have Retail Search enabled.
-     * Please enable Retail Search on Cloud Console before using this feature.
+     * Enable Retail Search on Cloud Console before using this feature.
      *
      */ public void completeQuery( @@ -290,7 +290,7 @@ public void completeQuery( * The operation is successfully finished only after the imported suggestions * are indexed successfully and ready for serving. The process takes hours. * This feature is only available for users who have Retail Search enabled. - * Please enable Retail Search on Cloud Console before using this feature. + * Enable Retail Search on Cloud Console before using this feature. * */ public void importCompletionData( @@ -309,7 +309,7 @@ public void importCompletionData( * 
          * Auto-completion service for retail.
    * This feature is only available for users who have Retail Search enabled.
-   * Please enable Retail Search on Cloud Console before using this feature.
+   * Enable Retail Search on Cloud Console before using this feature.
    *
      */ public static final class CompletionServiceBlockingStub @@ -331,7 +331,7 @@ protected CompletionServiceBlockingStub build( * 
            * Completes the specified prefix with keyword suggestions.
      * This feature is only available for users who have Retail Search enabled.
-     * Please enable Retail Search on Cloud Console before using this feature.
+     * Enable Retail Search on Cloud Console before using this feature.
      *
      */ public com.google.cloud.retail.v2alpha.CompleteQueryResponse completeQuery( @@ -349,7 +349,7 @@ public com.google.cloud.retail.v2alpha.CompleteQueryResponse completeQuery( * The operation is successfully finished only after the imported suggestions * are indexed successfully and ready for serving. The process takes hours. * This feature is only available for users who have Retail Search enabled. - * Please enable Retail Search on Cloud Console before using this feature. + * Enable Retail Search on Cloud Console before using this feature. * */ public com.google.longrunning.Operation importCompletionData( @@ -365,7 +365,7 @@ public com.google.longrunning.Operation importCompletionData( * 
          * Auto-completion service for retail.
    * This feature is only available for users who have Retail Search enabled.
-   * Please enable Retail Search on Cloud Console before using this feature.
+   * Enable Retail Search on Cloud Console before using this feature.
    *
      */ public static final class CompletionServiceFutureStub @@ -386,7 +386,7 @@ protected CompletionServiceFutureStub build( * 
            * Completes the specified prefix with keyword suggestions.
      * This feature is only available for users who have Retail Search enabled.
-     * Please enable Retail Search on Cloud Console before using this feature.
+     * Enable Retail Search on Cloud Console before using this feature.
      *
      */ public com.google.common.util.concurrent.ListenableFuture< @@ -405,7 +405,7 @@ protected CompletionServiceFutureStub build( * The operation is successfully finished only after the imported suggestions * are indexed successfully and ready for serving. The process takes hours. * This feature is only available for users who have Retail Search enabled. - * Please enable Retail Search on Cloud Console before using this feature. + * Enable Retail Search on Cloud Console before using this feature. * */ public com.google.common.util.concurrent.ListenableFuture diff --git a/java-retail/grpc-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ControlServiceGrpc.java b/java-retail/grpc-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ControlServiceGrpc.java index 7c782f8aca3a..25953b435357 100644 --- a/java-retail/grpc-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ControlServiceGrpc.java +++ b/java-retail/grpc-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ControlServiceGrpc.java @@ -351,7 +351,7 @@ public void deleteControl( * Updates a Control. * [Control][google.cloud.retail.v2alpha.Control] cannot be set to a different * oneof field, if so an INVALID_ARGUMENT is returned. If the - * [Control][google.cloud.retail.v2alpha.Control] to delete does not exist, a + * [Control][google.cloud.retail.v2alpha.Control] to update does not exist, a * NOT_FOUND error is returned. * */ @@ -379,7 +379,8 @@ public void getControl( * * * 
      -     * Lists all Controls linked to this catalog.
+     * Lists all Controls by their parent
+     * [Catalog][google.cloud.retail.v2alpha.Catalog].
      *
      */ public void listControls( @@ -489,7 +490,7 @@ public void deleteControl( * Updates a Control. * [Control][google.cloud.retail.v2alpha.Control] cannot be set to a different * oneof field, if so an INVALID_ARGUMENT is returned. If the - * [Control][google.cloud.retail.v2alpha.Control] to delete does not exist, a + * [Control][google.cloud.retail.v2alpha.Control] to update does not exist, a * NOT_FOUND error is returned. * */ @@ -520,7 +521,8 @@ public void getControl( * * * 
      -     * Lists all Controls linked to this catalog.
+     * Lists all Controls by their parent
+     * [Catalog][google.cloud.retail.v2alpha.Catalog].
      *
      */ public void listControls( @@ -590,7 +592,7 @@ public com.google.protobuf.Empty deleteControl( * Updates a Control. * [Control][google.cloud.retail.v2alpha.Control] cannot be set to a different * oneof field, if so an INVALID_ARGUMENT is returned. If the - * [Control][google.cloud.retail.v2alpha.Control] to delete does not exist, a + * [Control][google.cloud.retail.v2alpha.Control] to update does not exist, a * NOT_FOUND error is returned. * */ @@ -617,7 +619,8 @@ public com.google.cloud.retail.v2alpha.Control getControl( * * * 
      -     * Lists all Controls linked to this catalog.
+     * Lists all Controls by their parent
+     * [Catalog][google.cloud.retail.v2alpha.Catalog].
      *
      */ public com.google.cloud.retail.v2alpha.ListControlsResponse listControls( @@ -684,7 +687,7 @@ protected ControlServiceFutureStub build( * Updates a Control. * [Control][google.cloud.retail.v2alpha.Control] cannot be set to a different * oneof field, if so an INVALID_ARGUMENT is returned. If the - * [Control][google.cloud.retail.v2alpha.Control] to delete does not exist, a + * [Control][google.cloud.retail.v2alpha.Control] to update does not exist, a * NOT_FOUND error is returned. * */ @@ -713,7 +716,8 @@ protected ControlServiceFutureStub build( * * * 
      -     * Lists all Controls linked to this catalog.
+     * Lists all Controls by their parent
+     * [Catalog][google.cloud.retail.v2alpha.Catalog].
      *
      */ public com.google.common.util.concurrent.ListenableFuture< diff --git a/java-retail/grpc-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ModelServiceGrpc.java b/java-retail/grpc-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ModelServiceGrpc.java index 48fdf2cb397b..6233d7b0c48b 100644 --- a/java-retail/grpc-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ModelServiceGrpc.java +++ b/java-retail/grpc-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ModelServiceGrpc.java @@ -23,10 +23,10 @@ * 
        * Service for performing CRUD operations on models.
  * Recommendation models contain all the metadata necessary to generate a set of
- * models for the Predict() api. A model is queried
+ * models for the `Predict()` API. A model is queried
  * indirectly via a ServingConfig, which associates a model with a
  * given Placement (e.g. Frequently Bought Together on Home Page).
- * This service allows customers to e.g.:
+ * This service allows you to do the following:
  * * Initiate training of a model.
  * * Pause training of an existing model.
  * * List all the available models along with their metadata.
@@ -392,10 +392,10 @@ public ModelServiceFutureStub newStub(
    * 
          * Service for performing CRUD operations on models.
    * Recommendation models contain all the metadata necessary to generate a set of
-   * models for the Predict() api. A model is queried
+   * models for the `Predict()` API. A model is queried
    * indirectly via a ServingConfig, which associates a model with a
    * given Placement (e.g. Frequently Bought Together on Home Page).
-   * This service allows customers to e.g.:
+   * This service allows you to do the following:
    * * Initiate training of a model.
    * * Pause training of an existing model.
    * * List all the available models along with their metadata.
@@ -478,8 +478,9 @@ public void listModels(
      *
      * 
            * Update of model metadata. Only fields that
-     * currently can be updated are: filtering_option, periodic_tuning_state.
-     * If other values are provided, this API method will ignore them.
+     * currently can be updated are: `filtering_option` and
+     * `periodic_tuning_state`.
+     * If other values are provided, this API method ignores them.
      * 
      
      */
     public void updateModel(
@@ -558,10 +559,10 @@ public final io.grpc.ServerServiceDefinition bindService() {
    * 
          * Service for performing CRUD operations on models.
    * Recommendation models contain all the metadata necessary to generate a set of
-   * models for the Predict() api. A model is queried
+   * models for the `Predict()` API. A model is queried
    * indirectly via a ServingConfig, which associates a model with a
    * given Placement (e.g. Frequently Bought Together on Home Page).
-   * This service allows customers to e.g.:
+   * This service allows you to do the following:
    * * Initiate training of a model.
    * * Pause training of an existing model.
    * * List all the available models along with their metadata.
@@ -661,8 +662,9 @@ public void listModels(
      *
      * 
            * Update of model metadata. Only fields that
-     * currently can be updated are: filtering_option, periodic_tuning_state.
-     * If other values are provided, this API method will ignore them.
+     * currently can be updated are: `filtering_option` and
+     * `periodic_tuning_state`.
+     * If other values are provided, this API method ignores them.
      * 
      
      */
     public void updateModel(
@@ -695,10 +697,10 @@ public void tuneModel(
    * 
          * Service for performing CRUD operations on models.
    * Recommendation models contain all the metadata necessary to generate a set of
-   * models for the Predict() api. A model is queried
+   * models for the `Predict()` API. A model is queried
    * indirectly via a ServingConfig, which associates a model with a
    * given Placement (e.g. Frequently Bought Together on Home Page).
-   * This service allows customers to e.g.:
+   * This service allows you to do the following:
    * * Initiate training of a model.
    * * Pause training of an existing model.
    * * List all the available models along with their metadata.
@@ -787,8 +789,9 @@ public com.google.cloud.retail.v2alpha.ListModelsResponse listModels(
      *
      * 
            * Update of model metadata. Only fields that
-     * currently can be updated are: filtering_option, periodic_tuning_state.
-     * If other values are provided, this API method will ignore them.
+     * currently can be updated are: `filtering_option` and
+     * `periodic_tuning_state`.
+     * If other values are provided, this API method ignores them.
      * 
      
      */
     public com.google.cloud.retail.v2alpha.Model updateModel(
@@ -817,10 +820,10 @@ public com.google.longrunning.Operation tuneModel(
    * 
          * Service for performing CRUD operations on models.
    * Recommendation models contain all the metadata necessary to generate a set of
-   * models for the Predict() api. A model is queried
+   * models for the `Predict()` API. A model is queried
    * indirectly via a ServingConfig, which associates a model with a
    * given Placement (e.g. Frequently Bought Together on Home Page).
-   * This service allows customers to e.g.:
+   * This service allows you to do the following:
    * * Initiate training of a model.
    * * Pause training of an existing model.
    * * List all the available models along with their metadata.
@@ -910,8 +913,9 @@ protected ModelServiceFutureStub build(
      *
      * 
            * Update of model metadata. Only fields that
-     * currently can be updated are: filtering_option, periodic_tuning_state.
-     * If other values are provided, this API method will ignore them.
+     * currently can be updated are: `filtering_option` and
+     * `periodic_tuning_state`.
+     * If other values are provided, this API method ignores them.
      * 
      
      */
     public com.google.common.util.concurrent.ListenableFuture
diff --git a/java-retail/grpc-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ProductServiceGrpc.java b/java-retail/grpc-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ProductServiceGrpc.java
index d0a568a03715..bb65d0a2627f 100644
--- a/java-retail/grpc-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ProductServiceGrpc.java
+++ b/java-retail/grpc-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ProductServiceGrpc.java
@@ -763,9 +763,9 @@ public void importProducts(
      * update timestamps of each inventory field.
      * This process is asynchronous and does not require the
      * [Product][google.cloud.retail.v2alpha.Product] to exist before updating
-     * fulfillment information. If the request is valid, the update will be
-     * enqueued and processed downstream. As a consequence, when a response is
-     * returned, updates are not immediately manifested in the
+     * fulfillment information. If the request is valid, the update is enqueued
+     * and processed downstream. As a consequence, when a response is returned,
+     * updates are not immediately manifested in the
      * [Product][google.cloud.retail.v2alpha.Product] queried by
      * [ProductService.GetProduct][google.cloud.retail.v2alpha.ProductService.GetProduct]
      * or
@@ -774,27 +774,34 @@ public void importProducts(
      * [ProductService.CreateProduct][google.cloud.retail.v2alpha.ProductService.CreateProduct]
      * and
      * [ProductService.UpdateProduct][google.cloud.retail.v2alpha.ProductService.UpdateProduct],
-     * the specified inventory field value(s) will overwrite any existing value(s)
+     * the specified inventory field value(s) overwrite any existing value(s)
      * while ignoring the last update time for this field. Furthermore, the last
-     * update time for the specified inventory fields will be overwritten to the
-     * time of the
+     * update times for the specified inventory fields are overwritten by the
+     * times of the
      * [ProductService.CreateProduct][google.cloud.retail.v2alpha.ProductService.CreateProduct]
      * or
      * [ProductService.UpdateProduct][google.cloud.retail.v2alpha.ProductService.UpdateProduct]
      * request.
      * If no inventory fields are set in
      * [CreateProductRequest.product][google.cloud.retail.v2alpha.CreateProductRequest.product],
-     * then any pre-existing inventory information for this product will be used.
+     * then any pre-existing inventory information for this product is used.
      * If no inventory fields are set in
      * [SetInventoryRequest.set_mask][google.cloud.retail.v2alpha.SetInventoryRequest.set_mask],
-     * then any existing inventory information will be preserved.
+     * then any existing inventory information is preserved.
      * Pre-existing inventory information can only be updated with
      * [ProductService.SetInventory][google.cloud.retail.v2alpha.ProductService.SetInventory],
      * [ProductService.AddFulfillmentPlaces][google.cloud.retail.v2alpha.ProductService.AddFulfillmentPlaces],
      * and
      * [ProductService.RemoveFulfillmentPlaces][google.cloud.retail.v2alpha.ProductService.RemoveFulfillmentPlaces].
+     * The returned [Operation][google.longrunning.Operation]s is obsolete after
+     * one day, and the [GetOperation][google.longrunning.Operations.GetOperation]
+     * API returns `NOT_FOUND` afterwards.
+     * If conflicting updates are issued, the
+     * [Operation][google.longrunning.Operation]s associated with the stale
+     * updates are not marked as [done][google.longrunning.Operation.done] until
+     * they are obsolete.
      * This feature is only available for users who have Retail Search enabled.
-     * Please enable Retail Search on Cloud Console before using this feature.
+     * Enable Retail Search on Cloud Console before using this feature.
      * 
      
      */
     public void setInventory(
@@ -819,8 +826,15 @@ public void setInventory(
      * [ProductService.GetProduct][google.cloud.retail.v2alpha.ProductService.GetProduct]
      * or
      * [ProductService.ListProducts][google.cloud.retail.v2alpha.ProductService.ListProducts].
+     * The returned [Operation][google.longrunning.Operation]s will be obsolete
+     * after 1 day, and [GetOperation][google.longrunning.Operations.GetOperation]
+     * API will return NOT_FOUND afterwards.
+     * If conflicting updates are issued, the
+     * [Operation][google.longrunning.Operation]s associated with the stale
+     * updates will not be marked as [done][google.longrunning.Operation.done]
+     * until being obsolete.
      * This feature is only available for users who have Retail Search enabled.
-     * Please enable Retail Search on Cloud Console before using this feature.
+     * Enable Retail Search on Cloud Console before using this feature.
      * 
      
      */
     public void addFulfillmentPlaces(
@@ -845,8 +859,15 @@ public void addFulfillmentPlaces(
      * [ProductService.GetProduct][google.cloud.retail.v2alpha.ProductService.GetProduct]
      * or
      * [ProductService.ListProducts][google.cloud.retail.v2alpha.ProductService.ListProducts].
+     * The returned [Operation][google.longrunning.Operation]s will be obsolete
+     * after 1 day, and [GetOperation][google.longrunning.Operations.GetOperation]
+     * API will return NOT_FOUND afterwards.
+     * If conflicting updates are issued, the
+     * [Operation][google.longrunning.Operation]s associated with the stale
+     * updates will not be marked as [done][google.longrunning.Operation.done]
+     * until being obsolete.
      * This feature is only available for users who have Retail Search enabled.
-     * Please enable Retail Search on Cloud Console before using this feature.
+     * Enable Retail Search on Cloud Console before using this feature.
      * 
      
      */
     public void removeFulfillmentPlaces(
@@ -877,8 +898,15 @@ public void removeFulfillmentPlaces(
      * and
      * [ProductService.UpdateProduct][google.cloud.retail.v2alpha.ProductService.UpdateProduct]
      * has no effect on local inventories.
+     * The returned [Operation][google.longrunning.Operation]s will be obsolete
+     * after 1 day, and [GetOperation][google.longrunning.Operations.GetOperation]
+     * API will return NOT_FOUND afterwards.
+     * If conflicting updates are issued, the
+     * [Operation][google.longrunning.Operation]s associated with the stale
+     * updates will not be marked as [done][google.longrunning.Operation.done]
+     * until being obsolete.
      * This feature is only available for users who have Retail Search enabled.
-     * Please enable Retail Search on Cloud Console before using this feature.
+     * Enable Retail Search on Cloud Console before using this feature.
      * 
      
      */
     public void addLocalInventories(
@@ -907,8 +935,15 @@ public void addLocalInventories(
      * and
      * [ProductService.UpdateProduct][google.cloud.retail.v2alpha.ProductService.UpdateProduct]
      * has no effect on local inventories.
+     * The returned [Operation][google.longrunning.Operation]s will be obsolete
+     * after 1 day, and [GetOperation][google.longrunning.Operations.GetOperation]
+     * API will return NOT_FOUND afterwards.
+     * If conflicting updates are issued, the
+     * [Operation][google.longrunning.Operation]s associated with the stale
+     * updates will not be marked as [done][google.longrunning.Operation.done]
+     * until being obsolete.
      * This feature is only available for users who have Retail Search enabled.
-     * Please enable Retail Search on Cloud Console before using this feature.
+     * Enable Retail Search on Cloud Console before using this feature.
      *
      */ public void removeLocalInventories( @@ -1155,9 +1190,9 @@ public void importProducts( * update timestamps of each inventory field. * This process is asynchronous and does not require the * [Product][google.cloud.retail.v2alpha.Product] to exist before updating - * fulfillment information. If the request is valid, the update will be - * enqueued and processed downstream. As a consequence, when a response is - * returned, updates are not immediately manifested in the + * fulfillment information. If the request is valid, the update is enqueued + * and processed downstream. As a consequence, when a response is returned, + * updates are not immediately manifested in the * [Product][google.cloud.retail.v2alpha.Product] queried by * [ProductService.GetProduct][google.cloud.retail.v2alpha.ProductService.GetProduct] * or @@ -1166,27 +1201,34 @@ public void importProducts( * [ProductService.CreateProduct][google.cloud.retail.v2alpha.ProductService.CreateProduct] * and * [ProductService.UpdateProduct][google.cloud.retail.v2alpha.ProductService.UpdateProduct], - * the specified inventory field value(s) will overwrite any existing value(s) + * the specified inventory field value(s) overwrite any existing value(s) * while ignoring the last update time for this field. Furthermore, the last - * update time for the specified inventory fields will be overwritten to the - * time of the + * update times for the specified inventory fields are overwritten by the + * times of the * [ProductService.CreateProduct][google.cloud.retail.v2alpha.ProductService.CreateProduct] * or * [ProductService.UpdateProduct][google.cloud.retail.v2alpha.ProductService.UpdateProduct] * request. * If no inventory fields are set in * [CreateProductRequest.product][google.cloud.retail.v2alpha.CreateProductRequest.product], - * then any pre-existing inventory information for this product will be used. + * then any pre-existing inventory information for this product is used. * If no inventory fields are set in * [SetInventoryRequest.set_mask][google.cloud.retail.v2alpha.SetInventoryRequest.set_mask], - * then any existing inventory information will be preserved. + * then any existing inventory information is preserved. * Pre-existing inventory information can only be updated with * [ProductService.SetInventory][google.cloud.retail.v2alpha.ProductService.SetInventory], * [ProductService.AddFulfillmentPlaces][google.cloud.retail.v2alpha.ProductService.AddFulfillmentPlaces], * and * [ProductService.RemoveFulfillmentPlaces][google.cloud.retail.v2alpha.ProductService.RemoveFulfillmentPlaces]. + * The returned [Operation][google.longrunning.Operation]s is obsolete after + * one day, and the [GetOperation][google.longrunning.Operations.GetOperation] + * API returns `NOT_FOUND` afterwards. + * If conflicting updates are issued, the + * [Operation][google.longrunning.Operation]s associated with the stale + * updates are not marked as [done][google.longrunning.Operation.done] until + * they are obsolete. * This feature is only available for users who have Retail Search enabled. - * Please enable Retail Search on Cloud Console before using this feature. + * Enable Retail Search on Cloud Console before using this feature. * */ public void setInventory( @@ -1213,8 +1255,15 @@ public void setInventory( * [ProductService.GetProduct][google.cloud.retail.v2alpha.ProductService.GetProduct] * or * [ProductService.ListProducts][google.cloud.retail.v2alpha.ProductService.ListProducts]. + * The returned [Operation][google.longrunning.Operation]s will be obsolete + * after 1 day, and [GetOperation][google.longrunning.Operations.GetOperation] + * API will return NOT_FOUND afterwards. + * If conflicting updates are issued, the + * [Operation][google.longrunning.Operation]s associated with the stale + * updates will not be marked as [done][google.longrunning.Operation.done] + * until being obsolete. * This feature is only available for users who have Retail Search enabled. - * Please enable Retail Search on Cloud Console before using this feature. + * Enable Retail Search on Cloud Console before using this feature. * */ public void addFulfillmentPlaces( @@ -1241,8 +1290,15 @@ public void addFulfillmentPlaces( * [ProductService.GetProduct][google.cloud.retail.v2alpha.ProductService.GetProduct] * or * [ProductService.ListProducts][google.cloud.retail.v2alpha.ProductService.ListProducts]. + * The returned [Operation][google.longrunning.Operation]s will be obsolete + * after 1 day, and [GetOperation][google.longrunning.Operations.GetOperation] + * API will return NOT_FOUND afterwards. + * If conflicting updates are issued, the + * [Operation][google.longrunning.Operation]s associated with the stale + * updates will not be marked as [done][google.longrunning.Operation.done] + * until being obsolete. * This feature is only available for users who have Retail Search enabled. - * Please enable Retail Search on Cloud Console before using this feature. + * Enable Retail Search on Cloud Console before using this feature. * */ public void removeFulfillmentPlaces( @@ -1275,8 +1331,15 @@ public void removeFulfillmentPlaces( * and * [ProductService.UpdateProduct][google.cloud.retail.v2alpha.ProductService.UpdateProduct] * has no effect on local inventories. + * The returned [Operation][google.longrunning.Operation]s will be obsolete + * after 1 day, and [GetOperation][google.longrunning.Operations.GetOperation] + * API will return NOT_FOUND afterwards. + * If conflicting updates are issued, the + * [Operation][google.longrunning.Operation]s associated with the stale + * updates will not be marked as [done][google.longrunning.Operation.done] + * until being obsolete. * This feature is only available for users who have Retail Search enabled. - * Please enable Retail Search on Cloud Console before using this feature. + * Enable Retail Search on Cloud Console before using this feature. * */ public void addLocalInventories( @@ -1307,8 +1370,15 @@ public void addLocalInventories( * and * [ProductService.UpdateProduct][google.cloud.retail.v2alpha.ProductService.UpdateProduct] * has no effect on local inventories. + * The returned [Operation][google.longrunning.Operation]s will be obsolete + * after 1 day, and [GetOperation][google.longrunning.Operations.GetOperation] + * API will return NOT_FOUND afterwards. + * If conflicting updates are issued, the + * [Operation][google.longrunning.Operation]s associated with the stale + * updates will not be marked as [done][google.longrunning.Operation.done] + * until being obsolete. * This feature is only available for users who have Retail Search enabled. - * Please enable Retail Search on Cloud Console before using this feature. + * Enable Retail Search on Cloud Console before using this feature. * */ public void removeLocalInventories( @@ -1459,9 +1529,9 @@ public com.google.longrunning.Operation importProducts( * update timestamps of each inventory field. * This process is asynchronous and does not require the * [Product][google.cloud.retail.v2alpha.Product] to exist before updating - * fulfillment information. If the request is valid, the update will be - * enqueued and processed downstream. As a consequence, when a response is - * returned, updates are not immediately manifested in the + * fulfillment information. If the request is valid, the update is enqueued + * and processed downstream. As a consequence, when a response is returned, + * updates are not immediately manifested in the * [Product][google.cloud.retail.v2alpha.Product] queried by * [ProductService.GetProduct][google.cloud.retail.v2alpha.ProductService.GetProduct] * or @@ -1470,27 +1540,34 @@ public com.google.longrunning.Operation importProducts( * [ProductService.CreateProduct][google.cloud.retail.v2alpha.ProductService.CreateProduct] * and * [ProductService.UpdateProduct][google.cloud.retail.v2alpha.ProductService.UpdateProduct], - * the specified inventory field value(s) will overwrite any existing value(s) + * the specified inventory field value(s) overwrite any existing value(s) * while ignoring the last update time for this field. Furthermore, the last - * update time for the specified inventory fields will be overwritten to the - * time of the + * update times for the specified inventory fields are overwritten by the + * times of the * [ProductService.CreateProduct][google.cloud.retail.v2alpha.ProductService.CreateProduct] * or * [ProductService.UpdateProduct][google.cloud.retail.v2alpha.ProductService.UpdateProduct] * request. * If no inventory fields are set in * [CreateProductRequest.product][google.cloud.retail.v2alpha.CreateProductRequest.product], - * then any pre-existing inventory information for this product will be used. + * then any pre-existing inventory information for this product is used. * If no inventory fields are set in * [SetInventoryRequest.set_mask][google.cloud.retail.v2alpha.SetInventoryRequest.set_mask], - * then any existing inventory information will be preserved. + * then any existing inventory information is preserved. * Pre-existing inventory information can only be updated with * [ProductService.SetInventory][google.cloud.retail.v2alpha.ProductService.SetInventory], * [ProductService.AddFulfillmentPlaces][google.cloud.retail.v2alpha.ProductService.AddFulfillmentPlaces], * and * [ProductService.RemoveFulfillmentPlaces][google.cloud.retail.v2alpha.ProductService.RemoveFulfillmentPlaces]. + * The returned [Operation][google.longrunning.Operation]s is obsolete after + * one day, and the [GetOperation][google.longrunning.Operations.GetOperation] + * API returns `NOT_FOUND` afterwards. + * If conflicting updates are issued, the + * [Operation][google.longrunning.Operation]s associated with the stale + * updates are not marked as [done][google.longrunning.Operation.done] until + * they are obsolete. * This feature is only available for users who have Retail Search enabled. - * Please enable Retail Search on Cloud Console before using this feature. + * Enable Retail Search on Cloud Console before using this feature. * */ public com.google.longrunning.Operation setInventory( @@ -1514,8 +1591,15 @@ public com.google.longrunning.Operation setInventory( * [ProductService.GetProduct][google.cloud.retail.v2alpha.ProductService.GetProduct] * or * [ProductService.ListProducts][google.cloud.retail.v2alpha.ProductService.ListProducts]. + * The returned [Operation][google.longrunning.Operation]s will be obsolete + * after 1 day, and [GetOperation][google.longrunning.Operations.GetOperation] + * API will return NOT_FOUND afterwards. + * If conflicting updates are issued, the + * [Operation][google.longrunning.Operation]s associated with the stale + * updates will not be marked as [done][google.longrunning.Operation.done] + * until being obsolete. * This feature is only available for users who have Retail Search enabled. - * Please enable Retail Search on Cloud Console before using this feature. + * Enable Retail Search on Cloud Console before using this feature. * */ public com.google.longrunning.Operation addFulfillmentPlaces( @@ -1539,8 +1623,15 @@ public com.google.longrunning.Operation addFulfillmentPlaces( * [ProductService.GetProduct][google.cloud.retail.v2alpha.ProductService.GetProduct] * or * [ProductService.ListProducts][google.cloud.retail.v2alpha.ProductService.ListProducts]. + * The returned [Operation][google.longrunning.Operation]s will be obsolete + * after 1 day, and [GetOperation][google.longrunning.Operations.GetOperation] + * API will return NOT_FOUND afterwards. + * If conflicting updates are issued, the + * [Operation][google.longrunning.Operation]s associated with the stale + * updates will not be marked as [done][google.longrunning.Operation.done] + * until being obsolete. * This feature is only available for users who have Retail Search enabled. - * Please enable Retail Search on Cloud Console before using this feature. + * Enable Retail Search on Cloud Console before using this feature. * */ public com.google.longrunning.Operation removeFulfillmentPlaces( @@ -1570,8 +1661,15 @@ public com.google.longrunning.Operation removeFulfillmentPlaces( * and * [ProductService.UpdateProduct][google.cloud.retail.v2alpha.ProductService.UpdateProduct] * has no effect on local inventories. + * The returned [Operation][google.longrunning.Operation]s will be obsolete + * after 1 day, and [GetOperation][google.longrunning.Operations.GetOperation] + * API will return NOT_FOUND afterwards. + * If conflicting updates are issued, the + * [Operation][google.longrunning.Operation]s associated with the stale + * updates will not be marked as [done][google.longrunning.Operation.done] + * until being obsolete. * This feature is only available for users who have Retail Search enabled. - * Please enable Retail Search on Cloud Console before using this feature. + * Enable Retail Search on Cloud Console before using this feature. * */ public com.google.longrunning.Operation addLocalInventories( @@ -1599,8 +1697,15 @@ public com.google.longrunning.Operation addLocalInventories( * and * [ProductService.UpdateProduct][google.cloud.retail.v2alpha.ProductService.UpdateProduct] * has no effect on local inventories. + * The returned [Operation][google.longrunning.Operation]s will be obsolete + * after 1 day, and [GetOperation][google.longrunning.Operations.GetOperation] + * API will return NOT_FOUND afterwards. + * If conflicting updates are issued, the + * [Operation][google.longrunning.Operation]s associated with the stale + * updates will not be marked as [done][google.longrunning.Operation.done] + * until being obsolete. * This feature is only available for users who have Retail Search enabled. - * Please enable Retail Search on Cloud Console before using this feature. + * Enable Retail Search on Cloud Console before using this feature. * */ public com.google.longrunning.Operation removeLocalInventories( @@ -1752,9 +1857,9 @@ protected ProductServiceFutureStub build( * update timestamps of each inventory field. * This process is asynchronous and does not require the * [Product][google.cloud.retail.v2alpha.Product] to exist before updating - * fulfillment information. If the request is valid, the update will be - * enqueued and processed downstream. As a consequence, when a response is - * returned, updates are not immediately manifested in the + * fulfillment information. If the request is valid, the update is enqueued + * and processed downstream. As a consequence, when a response is returned, + * updates are not immediately manifested in the * [Product][google.cloud.retail.v2alpha.Product] queried by * [ProductService.GetProduct][google.cloud.retail.v2alpha.ProductService.GetProduct] * or @@ -1763,27 +1868,34 @@ protected ProductServiceFutureStub build( * [ProductService.CreateProduct][google.cloud.retail.v2alpha.ProductService.CreateProduct] * and * [ProductService.UpdateProduct][google.cloud.retail.v2alpha.ProductService.UpdateProduct], - * the specified inventory field value(s) will overwrite any existing value(s) + * the specified inventory field value(s) overwrite any existing value(s) * while ignoring the last update time for this field. Furthermore, the last - * update time for the specified inventory fields will be overwritten to the - * time of the + * update times for the specified inventory fields are overwritten by the + * times of the * [ProductService.CreateProduct][google.cloud.retail.v2alpha.ProductService.CreateProduct] * or * [ProductService.UpdateProduct][google.cloud.retail.v2alpha.ProductService.UpdateProduct] * request. * If no inventory fields are set in * [CreateProductRequest.product][google.cloud.retail.v2alpha.CreateProductRequest.product], - * then any pre-existing inventory information for this product will be used. + * then any pre-existing inventory information for this product is used. * If no inventory fields are set in * [SetInventoryRequest.set_mask][google.cloud.retail.v2alpha.SetInventoryRequest.set_mask], - * then any existing inventory information will be preserved. + * then any existing inventory information is preserved. * Pre-existing inventory information can only be updated with * [ProductService.SetInventory][google.cloud.retail.v2alpha.ProductService.SetInventory], * [ProductService.AddFulfillmentPlaces][google.cloud.retail.v2alpha.ProductService.AddFulfillmentPlaces], * and * [ProductService.RemoveFulfillmentPlaces][google.cloud.retail.v2alpha.ProductService.RemoveFulfillmentPlaces]. + * The returned [Operation][google.longrunning.Operation]s is obsolete after + * one day, and the [GetOperation][google.longrunning.Operations.GetOperation] + * API returns `NOT_FOUND` afterwards. + * If conflicting updates are issued, the + * [Operation][google.longrunning.Operation]s associated with the stale + * updates are not marked as [done][google.longrunning.Operation.done] until + * they are obsolete. * This feature is only available for users who have Retail Search enabled. - * Please enable Retail Search on Cloud Console before using this feature. + * Enable Retail Search on Cloud Console before using this feature. * */ public com.google.common.util.concurrent.ListenableFuture @@ -1807,8 +1919,15 @@ protected ProductServiceFutureStub build( * [ProductService.GetProduct][google.cloud.retail.v2alpha.ProductService.GetProduct] * or * [ProductService.ListProducts][google.cloud.retail.v2alpha.ProductService.ListProducts]. + * The returned [Operation][google.longrunning.Operation]s will be obsolete + * after 1 day, and [GetOperation][google.longrunning.Operations.GetOperation] + * API will return NOT_FOUND afterwards. + * If conflicting updates are issued, the + * [Operation][google.longrunning.Operation]s associated with the stale + * updates will not be marked as [done][google.longrunning.Operation.done] + * until being obsolete. * This feature is only available for users who have Retail Search enabled. - * Please enable Retail Search on Cloud Console before using this feature. + * Enable Retail Search on Cloud Console before using this feature. * */ public com.google.common.util.concurrent.ListenableFuture @@ -1832,8 +1951,15 @@ protected ProductServiceFutureStub build( * [ProductService.GetProduct][google.cloud.retail.v2alpha.ProductService.GetProduct] * or * [ProductService.ListProducts][google.cloud.retail.v2alpha.ProductService.ListProducts]. + * The returned [Operation][google.longrunning.Operation]s will be obsolete + * after 1 day, and [GetOperation][google.longrunning.Operations.GetOperation] + * API will return NOT_FOUND afterwards. + * If conflicting updates are issued, the + * [Operation][google.longrunning.Operation]s associated with the stale + * updates will not be marked as [done][google.longrunning.Operation.done] + * until being obsolete. * This feature is only available for users who have Retail Search enabled. - * Please enable Retail Search on Cloud Console before using this feature. + * Enable Retail Search on Cloud Console before using this feature. * */ public com.google.common.util.concurrent.ListenableFuture @@ -1864,8 +1990,15 @@ protected ProductServiceFutureStub build( * and * [ProductService.UpdateProduct][google.cloud.retail.v2alpha.ProductService.UpdateProduct] * has no effect on local inventories. + * The returned [Operation][google.longrunning.Operation]s will be obsolete + * after 1 day, and [GetOperation][google.longrunning.Operations.GetOperation] + * API will return NOT_FOUND afterwards. + * If conflicting updates are issued, the + * [Operation][google.longrunning.Operation]s associated with the stale + * updates will not be marked as [done][google.longrunning.Operation.done] + * until being obsolete. * This feature is only available for users who have Retail Search enabled. - * Please enable Retail Search on Cloud Console before using this feature. + * Enable Retail Search on Cloud Console before using this feature. * */ public com.google.common.util.concurrent.ListenableFuture @@ -1893,8 +2026,15 @@ protected ProductServiceFutureStub build( * and * [ProductService.UpdateProduct][google.cloud.retail.v2alpha.ProductService.UpdateProduct] * has no effect on local inventories. + * The returned [Operation][google.longrunning.Operation]s will be obsolete + * after 1 day, and [GetOperation][google.longrunning.Operations.GetOperation] + * API will return NOT_FOUND afterwards. + * If conflicting updates are issued, the + * [Operation][google.longrunning.Operation]s associated with the stale + * updates will not be marked as [done][google.longrunning.Operation.done] + * until being obsolete. * This feature is only available for users who have Retail Search enabled. - * Please enable Retail Search on Cloud Console before using this feature. + * Enable Retail Search on Cloud Console before using this feature. * */ public com.google.common.util.concurrent.ListenableFuture diff --git a/java-retail/grpc-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/SearchServiceGrpc.java b/java-retail/grpc-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/SearchServiceGrpc.java index a0cad11bce39..1c50414e780d 100644 --- a/java-retail/grpc-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/SearchServiceGrpc.java +++ b/java-retail/grpc-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/SearchServiceGrpc.java @@ -23,7 +23,7 @@ * 
        * Service for search.
  * This feature is only available for users who have Retail Search enabled.
- * Please enable Retail Search on Cloud Console before using this feature.
+ * Enable Retail Search on Cloud Console before using this feature.
  *
      */ @javax.annotation.Generated( @@ -128,7 +128,7 @@ public SearchServiceFutureStub newStub( * 
          * Service for search.
    * This feature is only available for users who have Retail Search enabled.
-   * Please enable Retail Search on Cloud Console before using this feature.
+   * Enable Retail Search on Cloud Console before using this feature.
    *
      */ public abstract static class SearchServiceImplBase implements io.grpc.BindableService { @@ -139,7 +139,7 @@ public abstract static class SearchServiceImplBase implements io.grpc.BindableSe * 
            * Performs a search.
      * This feature is only available for users who have Retail Search enabled.
-     * Please enable Retail Search on Cloud Console before using this feature.
+     * Enable Retail Search on Cloud Console before using this feature.
      *
      */ public void search( @@ -168,7 +168,7 @@ public final io.grpc.ServerServiceDefinition bindService() { * 
          * Service for search.
    * This feature is only available for users who have Retail Search enabled.
-   * Please enable Retail Search on Cloud Console before using this feature.
+   * Enable Retail Search on Cloud Console before using this feature.
    *
      */ public static final class SearchServiceStub @@ -188,7 +188,7 @@ protected SearchServiceStub build(io.grpc.Channel channel, io.grpc.CallOptions c * 
            * Performs a search.
      * This feature is only available for users who have Retail Search enabled.
-     * Please enable Retail Search on Cloud Console before using this feature.
+     * Enable Retail Search on Cloud Console before using this feature.
      *
      */ public void search( @@ -206,7 +206,7 @@ public void search( * 
          * Service for search.
    * This feature is only available for users who have Retail Search enabled.
-   * Please enable Retail Search on Cloud Console before using this feature.
+   * Enable Retail Search on Cloud Console before using this feature.
    *
      */ public static final class SearchServiceBlockingStub @@ -227,7 +227,7 @@ protected SearchServiceBlockingStub build( * 
            * Performs a search.
      * This feature is only available for users who have Retail Search enabled.
-     * Please enable Retail Search on Cloud Console before using this feature.
+     * Enable Retail Search on Cloud Console before using this feature.
      *
      */ public com.google.cloud.retail.v2alpha.SearchResponse search( @@ -243,7 +243,7 @@ public com.google.cloud.retail.v2alpha.SearchResponse search( * 
          * Service for search.
    * This feature is only available for users who have Retail Search enabled.
-   * Please enable Retail Search on Cloud Console before using this feature.
+   * Enable Retail Search on Cloud Console before using this feature.
    *
      */ public static final class SearchServiceFutureStub @@ -264,7 +264,7 @@ protected SearchServiceFutureStub build( * 
            * Performs a search.
      * This feature is only available for users who have Retail Search enabled.
-     * Please enable Retail Search on Cloud Console before using this feature.
+     * Enable Retail Search on Cloud Console before using this feature.
      *
      */ public com.google.common.util.concurrent.ListenableFuture< diff --git a/java-retail/grpc-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/UserEventServiceGrpc.java b/java-retail/grpc-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/UserEventServiceGrpc.java index cfb3c135b030..ec4caad43f16 100644 --- a/java-retail/grpc-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/UserEventServiceGrpc.java +++ b/java-retail/grpc-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/UserEventServiceGrpc.java @@ -361,9 +361,9 @@ public void purgeUserEvents( * Bulk import of User events. Request processing might be * synchronous. Events that already exist are skipped. * Use this method for backfilling historical user events. - * Operation.response is of type ImportResponse. Note that it is + * `Operation.response` is of type `ImportResponse`. Note that it is * possible for a subset of the items to be successfully inserted. - * Operation.metadata is of type ImportMetadata. + * `Operation.metadata` is of type `ImportMetadata`. * */ public void importUserEvents( @@ -377,14 +377,14 @@ public void importUserEvents( * * * 
      -     * Starts a user event rejoin operation with latest product catalog. Events
-     * will not be annotated with detailed product information if product is
-     * missing from the catalog at the time the user event is ingested, and these
-     * events are stored as unjoined events with a limited usage on training and
-     * serving. This method can be used to start a join operation on specified
-     * events with latest version of product catalog. It can also be used to
-     * correct events joined with the wrong product catalog. A rejoin operation
-     * can take hours or days to complete.
+     * Starts a user-event rejoin operation with latest product catalog. Events
+     * are not annotated with detailed product information for products that are
+     * missing from the catalog when the user event is ingested. These
+     * events are stored as unjoined events with limited usage on training and
+     * serving. You can use this method to start a join operation on specified
+     * events with the latest version of product catalog. You can also use this
+     * method to correct events joined with the wrong product catalog. A rejoin
+     * operation can take hours or days to complete.
      *
      */ public void rejoinUserEvents( @@ -510,9 +510,9 @@ public void purgeUserEvents( * Bulk import of User events. Request processing might be * synchronous. Events that already exist are skipped. * Use this method for backfilling historical user events. - * Operation.response is of type ImportResponse. Note that it is + * `Operation.response` is of type `ImportResponse`. Note that it is * possible for a subset of the items to be successfully inserted. - * Operation.metadata is of type ImportMetadata. + * `Operation.metadata` is of type `ImportMetadata`. * */ public void importUserEvents( @@ -528,14 +528,14 @@ public void importUserEvents( * * * 
      -     * Starts a user event rejoin operation with latest product catalog. Events
-     * will not be annotated with detailed product information if product is
-     * missing from the catalog at the time the user event is ingested, and these
-     * events are stored as unjoined events with a limited usage on training and
-     * serving. This method can be used to start a join operation on specified
-     * events with latest version of product catalog. It can also be used to
-     * correct events joined with the wrong product catalog. A rejoin operation
-     * can take hours or days to complete.
+     * Starts a user-event rejoin operation with latest product catalog. Events
+     * are not annotated with detailed product information for products that are
+     * missing from the catalog when the user event is ingested. These
+     * events are stored as unjoined events with limited usage on training and
+     * serving. You can use this method to start a join operation on specified
+     * events with the latest version of product catalog. You can also use this
+     * method to correct events joined with the wrong product catalog. A rejoin
+     * operation can take hours or days to complete.
      *
      */ public void rejoinUserEvents( @@ -619,9 +619,9 @@ public com.google.longrunning.Operation purgeUserEvents( * Bulk import of User events. Request processing might be * synchronous. Events that already exist are skipped. * Use this method for backfilling historical user events. - * Operation.response is of type ImportResponse. Note that it is + * `Operation.response` is of type `ImportResponse`. Note that it is * possible for a subset of the items to be successfully inserted. - * Operation.metadata is of type ImportMetadata. + * `Operation.metadata` is of type `ImportMetadata`. * */ public com.google.longrunning.Operation importUserEvents( @@ -634,14 +634,14 @@ public com.google.longrunning.Operation importUserEvents( * * * 
      -     * Starts a user event rejoin operation with latest product catalog. Events
-     * will not be annotated with detailed product information if product is
-     * missing from the catalog at the time the user event is ingested, and these
-     * events are stored as unjoined events with a limited usage on training and
-     * serving. This method can be used to start a join operation on specified
-     * events with latest version of product catalog. It can also be used to
-     * correct events joined with the wrong product catalog. A rejoin operation
-     * can take hours or days to complete.
+     * Starts a user-event rejoin operation with latest product catalog. Events
+     * are not annotated with detailed product information for products that are
+     * missing from the catalog when the user event is ingested. These
+     * events are stored as unjoined events with limited usage on training and
+     * serving. You can use this method to start a join operation on specified
+     * events with the latest version of product catalog. You can also use this
+     * method to correct events joined with the wrong product catalog. A rejoin
+     * operation can take hours or days to complete.
      *
      */ public com.google.longrunning.Operation rejoinUserEvents( @@ -723,9 +723,9 @@ protected UserEventServiceFutureStub build( * Bulk import of User events. Request processing might be * synchronous. Events that already exist are skipped. * Use this method for backfilling historical user events. - * Operation.response is of type ImportResponse. Note that it is + * `Operation.response` is of type `ImportResponse`. Note that it is * possible for a subset of the items to be successfully inserted. - * Operation.metadata is of type ImportMetadata. + * `Operation.metadata` is of type `ImportMetadata`. * */ public com.google.common.util.concurrent.ListenableFuture @@ -738,14 +738,14 @@ protected UserEventServiceFutureStub build( * * * 
      -     * Starts a user event rejoin operation with latest product catalog. Events
-     * will not be annotated with detailed product information if product is
-     * missing from the catalog at the time the user event is ingested, and these
-     * events are stored as unjoined events with a limited usage on training and
-     * serving. This method can be used to start a join operation on specified
-     * events with latest version of product catalog. It can also be used to
-     * correct events joined with the wrong product catalog. A rejoin operation
-     * can take hours or days to complete.
+     * Starts a user-event rejoin operation with latest product catalog. Events
+     * are not annotated with detailed product information for products that are
+     * missing from the catalog when the user event is ingested. These
+     * events are stored as unjoined events with limited usage on training and
+     * serving. You can use this method to start a join operation on specified
+     * events with the latest version of product catalog. You can also use this
+     * method to correct events joined with the wrong product catalog. A rejoin
+     * operation can take hours or days to complete.
      *
      */ public com.google.common.util.concurrent.ListenableFuture diff --git a/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/AddControlRequest.java b/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/AddControlRequest.java index 33325706d49b..91336632ed78 100644 --- a/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/AddControlRequest.java +++ b/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/AddControlRequest.java @@ -75,7 +75,7 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() { * * 
          * Required. The source ServingConfig resource name . Format:
-   * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+   * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
    *
      * * @@ -101,7 +101,7 @@ public java.lang.String getServingConfig() { * * 
          * Required. The source ServingConfig resource name . Format:
-   * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+   * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
    *
      * * @@ -531,7 +531,7 @@ public Builder mergeFrom( * * 
            * Required. The source ServingConfig resource name . Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
      *
      * * @@ -556,7 +556,7 @@ public java.lang.String getServingConfig() { * * 
            * Required. The source ServingConfig resource name . Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
      *
      * * @@ -581,7 +581,7 @@ public com.google.protobuf.ByteString getServingConfigBytes() { * * 
            * Required. The source ServingConfig resource name . Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
      *
      * * @@ -605,7 +605,7 @@ public Builder setServingConfig(java.lang.String value) { * * 
            * Required. The source ServingConfig resource name . Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
      *
      * * @@ -625,7 +625,7 @@ public Builder clearServingConfig() { * * 
            * Required. The source ServingConfig resource name . Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
      *
      * * diff --git a/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/AddControlRequestOrBuilder.java b/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/AddControlRequestOrBuilder.java index 29049e29a0d1..8d90ead6d48b 100644 --- a/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/AddControlRequestOrBuilder.java +++ b/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/AddControlRequestOrBuilder.java @@ -28,7 +28,7 @@ public interface AddControlRequestOrBuilder * * 
          * Required. The source ServingConfig resource name . Format:
-   * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+   * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
    *
      * * @@ -43,7 +43,7 @@ public interface AddControlRequestOrBuilder * * 
          * Required. The source ServingConfig resource name . Format:
-   * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+   * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
    *
      * * diff --git a/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/CatalogAttribute.java b/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/CatalogAttribute.java index 0beb18f6e5bf..21be69403ac8 100644 --- a/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/CatalogAttribute.java +++ b/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/CatalogAttribute.java @@ -44,6 +44,8 @@ private CatalogAttribute() { indexableOption_ = 0; dynamicFacetableOption_ = 0; searchableOption_ = 0; + exactSearchableOption_ = 0; + retrievableOption_ = 0; } @java.lang.Override @@ -247,8 +249,7 @@ public enum IndexableOption implements com.google.protobuf.ProtocolMessageEnum { * * * 
      -     * Value used when unset. Defaults to
-     * [INDEXABLE_ENABLED][google.cloud.retail.v2.CatalogAttribute.IndexableOption.INDEXABLE_ENABLED].
+     * Value used when unset.
      *
      * * INDEXABLE_OPTION_UNSPECIFIED = 0; @@ -281,8 +282,7 @@ public enum IndexableOption implements com.google.protobuf.ProtocolMessageEnum { * * * 
      -     * Value used when unset. Defaults to
-     * [INDEXABLE_ENABLED][google.cloud.retail.v2.CatalogAttribute.IndexableOption.INDEXABLE_ENABLED].
+     * Value used when unset.
      *
      * * INDEXABLE_OPTION_UNSPECIFIED = 0; @@ -408,8 +408,7 @@ public enum DynamicFacetableOption implements com.google.protobuf.ProtocolMessag * * * 
      -     * Value used when unset. Defaults to
-     * [DYNAMIC_FACETABLE_ENABLED][google.cloud.retail.v2.CatalogAttribute.DynamicFacetableOption.DYNAMIC_FACETABLE_ENABLED].
+     * Value used when unset.
      *
      * * DYNAMIC_FACETABLE_OPTION_UNSPECIFIED = 0; @@ -442,8 +441,7 @@ public enum DynamicFacetableOption implements com.google.protobuf.ProtocolMessag * * * 
      -     * Value used when unset. Defaults to
-     * [DYNAMIC_FACETABLE_ENABLED][google.cloud.retail.v2.CatalogAttribute.DynamicFacetableOption.DYNAMIC_FACETABLE_ENABLED].
+     * Value used when unset.
      *
      * * DYNAMIC_FACETABLE_OPTION_UNSPECIFIED = 0; @@ -570,8 +568,7 @@ public enum SearchableOption implements com.google.protobuf.ProtocolMessageEnum * * * 
      -     * Value used when unset. Defaults to
-     * [SEARCHABLE_DISABLED][google.cloud.retail.v2.CatalogAttribute.SearchableOption.SEARCHABLE_DISABLED].
+     * Value used when unset.
      *
      * * SEARCHABLE_OPTION_UNSPECIFIED = 0; @@ -604,8 +601,7 @@ public enum SearchableOption implements com.google.protobuf.ProtocolMessageEnum * * * 
      -     * Value used when unset. Defaults to
-     * [SEARCHABLE_DISABLED][google.cloud.retail.v2.CatalogAttribute.SearchableOption.SEARCHABLE_DISABLED].
+     * Value used when unset.
      *
      * * SEARCHABLE_OPTION_UNSPECIFIED = 0; @@ -717,6 +713,330 @@ private SearchableOption(int value) { // @@protoc_insertion_point(enum_scope:google.cloud.retail.v2.CatalogAttribute.SearchableOption) } + /** + * + * + * 
      +   * The status of the exact-searchable option of a catalog attribute.
+   *
      + * + * Protobuf enum {@code google.cloud.retail.v2.CatalogAttribute.ExactSearchableOption} + */ + public enum ExactSearchableOption implements com.google.protobuf.ProtocolMessageEnum { + /** + * + * + * 
      +     * Value used when unset. Defaults to
+     * [EXACT_SEARCHABLE_DISABLED][google.cloud.retail.v2.CatalogAttribute.ExactSearchableOption.EXACT_SEARCHABLE_DISABLED].
+     *
      + * + * EXACT_SEARCHABLE_OPTION_UNSPECIFIED = 0; + */ + EXACT_SEARCHABLE_OPTION_UNSPECIFIED(0), + /** + * + * + * 
      +     * Exact searchable option enabled for an attribute.
+     *
      + * + * EXACT_SEARCHABLE_ENABLED = 1; + */ + EXACT_SEARCHABLE_ENABLED(1), + /** + * + * + * 
      +     * Exact searchable option disabled for an attribute.
+     *
      + * + * EXACT_SEARCHABLE_DISABLED = 2; + */ + EXACT_SEARCHABLE_DISABLED(2), + UNRECOGNIZED(-1), + ; + + /** + * + * + * 
      +     * Value used when unset. Defaults to
+     * [EXACT_SEARCHABLE_DISABLED][google.cloud.retail.v2.CatalogAttribute.ExactSearchableOption.EXACT_SEARCHABLE_DISABLED].
+     *
      + * + * EXACT_SEARCHABLE_OPTION_UNSPECIFIED = 0; + */ + public static final int EXACT_SEARCHABLE_OPTION_UNSPECIFIED_VALUE = 0; + /** + * + * + * 
      +     * Exact searchable option enabled for an attribute.
+     *
      + * + * EXACT_SEARCHABLE_ENABLED = 1; + */ + public static final int EXACT_SEARCHABLE_ENABLED_VALUE = 1; + /** + * + * + * 
      +     * Exact searchable option disabled for an attribute.
+     *
      + * + * EXACT_SEARCHABLE_DISABLED = 2; + */ + public static final int EXACT_SEARCHABLE_DISABLED_VALUE = 2; + + public final int getNumber() { + if (this == UNRECOGNIZED) { + throw new java.lang.IllegalArgumentException( + "Can't get the number of an unknown enum value."); + } + return value; + } + + /** + * @param value The numeric wire value of the corresponding enum entry. + * @return The enum associated with the given numeric wire value. + * @deprecated Use {@link #forNumber(int)} instead. + */ + @java.lang.Deprecated + public static ExactSearchableOption valueOf(int value) { + return forNumber(value); + } + + /** + * @param value The numeric wire value of the corresponding enum entry. + * @return The enum associated with the given numeric wire value. + */ + public static ExactSearchableOption forNumber(int value) { + switch (value) { + case 0: + return EXACT_SEARCHABLE_OPTION_UNSPECIFIED; + case 1: + return EXACT_SEARCHABLE_ENABLED; + case 2: + return EXACT_SEARCHABLE_DISABLED; + default: + return null; + } + } + + public static com.google.protobuf.Internal.EnumLiteMap + internalGetValueMap() { + return internalValueMap; + } + + private static final com.google.protobuf.Internal.EnumLiteMap + internalValueMap = + new com.google.protobuf.Internal.EnumLiteMap() { + public ExactSearchableOption findValueByNumber(int number) { + return ExactSearchableOption.forNumber(number); + } + }; + + public final com.google.protobuf.Descriptors.EnumValueDescriptor getValueDescriptor() { + if (this == UNRECOGNIZED) { + throw new java.lang.IllegalStateException( + "Can't get the descriptor of an unrecognized enum value."); + } + return getDescriptor().getValues().get(ordinal()); + } + + public final com.google.protobuf.Descriptors.EnumDescriptor getDescriptorForType() { + return getDescriptor(); + } + + public static final com.google.protobuf.Descriptors.EnumDescriptor getDescriptor() { + return com.google.cloud.retail.v2.CatalogAttribute.getDescriptor().getEnumTypes().get(4); + } + + private static final ExactSearchableOption[] VALUES = values(); + + public static ExactSearchableOption valueOf( + com.google.protobuf.Descriptors.EnumValueDescriptor desc) { + if (desc.getType() != getDescriptor()) { + throw new java.lang.IllegalArgumentException("EnumValueDescriptor is not for this type."); + } + if (desc.getIndex() == -1) { + return UNRECOGNIZED; + } + return VALUES[desc.getIndex()]; + } + + private final int value; + + private ExactSearchableOption(int value) { + this.value = value; + } + + // @@protoc_insertion_point(enum_scope:google.cloud.retail.v2.CatalogAttribute.ExactSearchableOption) + } + + /** + * + * + * 
      +   * The status of the retrievable option of a catalog attribute.
+   *
      + * + * Protobuf enum {@code google.cloud.retail.v2.CatalogAttribute.RetrievableOption} + */ + public enum RetrievableOption implements com.google.protobuf.ProtocolMessageEnum { + /** + * + * + * 
      +     * Value used when unset. Defaults to
+     * [RETRIEVABLE_DISABLED][google.cloud.retail.v2.CatalogAttribute.RetrievableOption.RETRIEVABLE_DISABLED].
+     *
      + * + * RETRIEVABLE_OPTION_UNSPECIFIED = 0; + */ + RETRIEVABLE_OPTION_UNSPECIFIED(0), + /** + * + * + * 
      +     * Retrievable option enabled for an attribute.
+     *
      + * + * RETRIEVABLE_ENABLED = 1; + */ + RETRIEVABLE_ENABLED(1), + /** + * + * + * 
      +     * Retrievable option disabled for an attribute.
+     *
      + * + * RETRIEVABLE_DISABLED = 2; + */ + RETRIEVABLE_DISABLED(2), + UNRECOGNIZED(-1), + ; + + /** + * + * + * 
      +     * Value used when unset. Defaults to
+     * [RETRIEVABLE_DISABLED][google.cloud.retail.v2.CatalogAttribute.RetrievableOption.RETRIEVABLE_DISABLED].
+     *
      + * + * RETRIEVABLE_OPTION_UNSPECIFIED = 0; + */ + public static final int RETRIEVABLE_OPTION_UNSPECIFIED_VALUE = 0; + /** + * + * + * 
      +     * Retrievable option enabled for an attribute.
+     *
      + * + * RETRIEVABLE_ENABLED = 1; + */ + public static final int RETRIEVABLE_ENABLED_VALUE = 1; + /** + * + * + * 
      +     * Retrievable option disabled for an attribute.
+     *
      + * + * RETRIEVABLE_DISABLED = 2; + */ + public static final int RETRIEVABLE_DISABLED_VALUE = 2; + + public final int getNumber() { + if (this == UNRECOGNIZED) { + throw new java.lang.IllegalArgumentException( + "Can't get the number of an unknown enum value."); + } + return value; + } + + /** + * @param value The numeric wire value of the corresponding enum entry. + * @return The enum associated with the given numeric wire value. + * @deprecated Use {@link #forNumber(int)} instead. + */ + @java.lang.Deprecated + public static RetrievableOption valueOf(int value) { + return forNumber(value); + } + + /** + * @param value The numeric wire value of the corresponding enum entry. + * @return The enum associated with the given numeric wire value. + */ + public static RetrievableOption forNumber(int value) { + switch (value) { + case 0: + return RETRIEVABLE_OPTION_UNSPECIFIED; + case 1: + return RETRIEVABLE_ENABLED; + case 2: + return RETRIEVABLE_DISABLED; + default: + return null; + } + } + + public static com.google.protobuf.Internal.EnumLiteMap + internalGetValueMap() { + return internalValueMap; + } + + private static final com.google.protobuf.Internal.EnumLiteMap + internalValueMap = + new com.google.protobuf.Internal.EnumLiteMap() { + public RetrievableOption findValueByNumber(int number) { + return RetrievableOption.forNumber(number); + } + }; + + public final com.google.protobuf.Descriptors.EnumValueDescriptor getValueDescriptor() { + if (this == UNRECOGNIZED) { + throw new java.lang.IllegalStateException( + "Can't get the descriptor of an unrecognized enum value."); + } + return getDescriptor().getValues().get(ordinal()); + } + + public final com.google.protobuf.Descriptors.EnumDescriptor getDescriptorForType() { + return getDescriptor(); + } + + public static final com.google.protobuf.Descriptors.EnumDescriptor getDescriptor() { + return com.google.cloud.retail.v2.CatalogAttribute.getDescriptor().getEnumTypes().get(5); + } + + private static final RetrievableOption[] VALUES = values(); + + public static RetrievableOption valueOf( + com.google.protobuf.Descriptors.EnumValueDescriptor desc) { + if (desc.getType() != getDescriptor()) { + throw new java.lang.IllegalArgumentException("EnumValueDescriptor is not for this type."); + } + if (desc.getIndex() == -1) { + return UNRECOGNIZED; + } + return VALUES[desc.getIndex()]; + } + + private final int value; + + private RetrievableOption(int value) { + this.value = value; + } + + // @@protoc_insertion_point(enum_scope:google.cloud.retail.v2.CatalogAttribute.RetrievableOption) + } + public static final int KEY_FIELD_NUMBER = 1; private volatile java.lang.Object key_; /** @@ -796,13 +1116,13 @@ public com.google.protobuf.ByteString getKeyBytes() { * [CatalogService.UpdateAttributesConfig][google.cloud.retail.v2.CatalogService.UpdateAttributesConfig] * APIs. This field is `False` for pre-loaded * [CatalogAttribute][google.cloud.retail.v2.CatalogAttribute]s. - * Only pre-loaded - * [CatalogAttribute][google.cloud.retail.v2.CatalogAttribute]s that are - * neither in use by products nor predefined can be deleted. - * [CatalogAttribute][google.cloud.retail.v2.CatalogAttribute]s that are - * either in use by products or are predefined cannot be deleted; however, - * their configuration properties will reset to default values upon removal - * request. + * Only pre-loaded [catalog + * attributes][google.cloud.retail.v2.CatalogAttribute] that are neither in + * use by products nor predefined can be deleted. [Catalog + * attributes][google.cloud.retail.v2.CatalogAttribute] that are + * either in use by products or are predefined attributes cannot be deleted; + * however, their configuration properties will reset to default values upon + * removal request. * After catalog changes, it takes about 10 minutes for this field to update. * * @@ -870,6 +1190,7 @@ public com.google.cloud.retail.v2.CatalogAttribute.AttributeType getType() { * is CATALOG_LEVEL_ATTRIBUTE_CONFIG, if INDEXABLE_ENABLED attribute values * are indexed so that it can be filtered, faceted, or boosted in * [SearchService.Search][google.cloud.retail.v2.SearchService.Search]. + * Must be specified, otherwise throws INVALID_FORMAT error. * * * .google.cloud.retail.v2.CatalogAttribute.IndexableOption indexable_option = 5; @@ -889,6 +1210,7 @@ public int getIndexableOptionValue() { * is CATALOG_LEVEL_ATTRIBUTE_CONFIG, if INDEXABLE_ENABLED attribute values * are indexed so that it can be filtered, faceted, or boosted in * [SearchService.Search][google.cloud.retail.v2.SearchService.Search]. + * Must be specified, otherwise throws INVALID_FORMAT error. * * * .google.cloud.retail.v2.CatalogAttribute.IndexableOption indexable_option = 5; @@ -915,6 +1237,7 @@ public com.google.cloud.retail.v2.CatalogAttribute.IndexableOption getIndexableO * facet. Could only be DYNAMIC_FACETABLE_DISABLED if * [CatalogAttribute.indexable_option][google.cloud.retail.v2.CatalogAttribute.indexable_option] * is INDEXABLE_DISABLED. Otherwise, an INVALID_ARGUMENT error is returned. + * Must be specified, otherwise throws INVALID_FORMAT error. * * * @@ -935,6 +1258,7 @@ public int getDynamicFacetableOptionValue() { * facet. Could only be DYNAMIC_FACETABLE_DISABLED if * [CatalogAttribute.indexable_option][google.cloud.retail.v2.CatalogAttribute.indexable_option] * is INDEXABLE_DISABLED. Otherwise, an INVALID_ARGUMENT error is returned. + * Must be specified, otherwise throws INVALID_FORMAT error. * * * @@ -970,6 +1294,7 @@ public int getDynamicFacetableOptionValue() { * will not be searchable by text queries in * [SearchService.Search][google.cloud.retail.v2.SearchService.Search], as * there are no text values associated to numerical attributes. + * Must be specified, otherwise throws INVALID_FORMAT error. * * * .google.cloud.retail.v2.CatalogAttribute.SearchableOption searchable_option = 7; @@ -993,6 +1318,7 @@ public int getSearchableOptionValue() { * will not be searchable by text queries in * [SearchService.Search][google.cloud.retail.v2.SearchService.Search], as * there are no text values associated to numerical attributes. + * Must be specified, otherwise throws INVALID_FORMAT error. * * * .google.cloud.retail.v2.CatalogAttribute.SearchableOption searchable_option = 7; @@ -1009,6 +1335,96 @@ public com.google.cloud.retail.v2.CatalogAttribute.SearchableOption getSearchabl : result; } + public static final int EXACT_SEARCHABLE_OPTION_FIELD_NUMBER = 11; + private int exactSearchableOption_; + /** + * + * + * 
      +   * 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.
+   *
      + * + * + * .google.cloud.retail.v2.CatalogAttribute.ExactSearchableOption exact_searchable_option = 11; + * + * + * @return The enum numeric value on the wire for exactSearchableOption. + */ + @java.lang.Override + public int getExactSearchableOptionValue() { + return exactSearchableOption_; + } + /** + * + * + * 
      +   * 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.
+   *
      + * + * + * .google.cloud.retail.v2.CatalogAttribute.ExactSearchableOption exact_searchable_option = 11; + * + * + * @return The exactSearchableOption. + */ + @java.lang.Override + public com.google.cloud.retail.v2.CatalogAttribute.ExactSearchableOption + getExactSearchableOption() { + @SuppressWarnings("deprecation") + com.google.cloud.retail.v2.CatalogAttribute.ExactSearchableOption result = + com.google.cloud.retail.v2.CatalogAttribute.ExactSearchableOption.valueOf( + exactSearchableOption_); + return result == null + ? com.google.cloud.retail.v2.CatalogAttribute.ExactSearchableOption.UNRECOGNIZED + : result; + } + + public static final int RETRIEVABLE_OPTION_FIELD_NUMBER = 12; + private int retrievableOption_; + /** + * + * + * 
      +   * If RETRIEVABLE_ENABLED, attribute values are retrievable in the search
+   * results.
+   *
      + * + * .google.cloud.retail.v2.CatalogAttribute.RetrievableOption retrievable_option = 12; + * + * + * @return The enum numeric value on the wire for retrievableOption. + */ + @java.lang.Override + public int getRetrievableOptionValue() { + return retrievableOption_; + } + /** + * + * + * 
      +   * If RETRIEVABLE_ENABLED, attribute values are retrievable in the search
+   * results.
+   *
      + * + * .google.cloud.retail.v2.CatalogAttribute.RetrievableOption retrievable_option = 12; + * + * + * @return The retrievableOption. + */ + @java.lang.Override + public com.google.cloud.retail.v2.CatalogAttribute.RetrievableOption getRetrievableOption() { + @SuppressWarnings("deprecation") + com.google.cloud.retail.v2.CatalogAttribute.RetrievableOption result = + com.google.cloud.retail.v2.CatalogAttribute.RetrievableOption.valueOf(retrievableOption_); + return result == null + ? com.google.cloud.retail.v2.CatalogAttribute.RetrievableOption.UNRECOGNIZED + : result; + } + private byte memoizedIsInitialized = -1; @java.lang.Override @@ -1049,6 +1465,18 @@ public void writeTo(com.google.protobuf.CodedOutputStream output) throws java.io if (type_ != com.google.cloud.retail.v2.CatalogAttribute.AttributeType.UNKNOWN.getNumber()) { output.writeEnum(10, type_); } + if (exactSearchableOption_ + != com.google.cloud.retail.v2.CatalogAttribute.ExactSearchableOption + .EXACT_SEARCHABLE_OPTION_UNSPECIFIED + .getNumber()) { + output.writeEnum(11, exactSearchableOption_); + } + if (retrievableOption_ + != com.google.cloud.retail.v2.CatalogAttribute.RetrievableOption + .RETRIEVABLE_OPTION_UNSPECIFIED + .getNumber()) { + output.writeEnum(12, retrievableOption_); + } getUnknownFields().writeTo(output); } @@ -1084,6 +1512,18 @@ public int getSerializedSize() { if (type_ != com.google.cloud.retail.v2.CatalogAttribute.AttributeType.UNKNOWN.getNumber()) { size += com.google.protobuf.CodedOutputStream.computeEnumSize(10, type_); } + if (exactSearchableOption_ + != com.google.cloud.retail.v2.CatalogAttribute.ExactSearchableOption + .EXACT_SEARCHABLE_OPTION_UNSPECIFIED + .getNumber()) { + size += com.google.protobuf.CodedOutputStream.computeEnumSize(11, exactSearchableOption_); + } + if (retrievableOption_ + != com.google.cloud.retail.v2.CatalogAttribute.RetrievableOption + .RETRIEVABLE_OPTION_UNSPECIFIED + .getNumber()) { + size += com.google.protobuf.CodedOutputStream.computeEnumSize(12, retrievableOption_); + } size += getUnknownFields().getSerializedSize(); memoizedSize = size; return size; @@ -1106,6 +1546,8 @@ public boolean equals(final java.lang.Object obj) { if (indexableOption_ != other.indexableOption_) return false; if (dynamicFacetableOption_ != other.dynamicFacetableOption_) return false; if (searchableOption_ != other.searchableOption_) return false; + if (exactSearchableOption_ != other.exactSearchableOption_) return false; + if (retrievableOption_ != other.retrievableOption_) return false; if (!getUnknownFields().equals(other.getUnknownFields())) return false; return true; } @@ -1129,6 +1571,10 @@ public int hashCode() { hash = (53 * hash) + dynamicFacetableOption_; hash = (37 * hash) + SEARCHABLE_OPTION_FIELD_NUMBER; hash = (53 * hash) + searchableOption_; + hash = (37 * hash) + EXACT_SEARCHABLE_OPTION_FIELD_NUMBER; + hash = (53 * hash) + exactSearchableOption_; + hash = (37 * hash) + RETRIEVABLE_OPTION_FIELD_NUMBER; + hash = (53 * hash) + retrievableOption_; hash = (29 * hash) + getUnknownFields().hashCode(); memoizedHashCode = hash; return hash; @@ -1280,6 +1726,10 @@ public Builder clear() { searchableOption_ = 0; + exactSearchableOption_ = 0; + + retrievableOption_ = 0; + return this; } @@ -1313,6 +1763,8 @@ public com.google.cloud.retail.v2.CatalogAttribute buildPartial() { result.indexableOption_ = indexableOption_; result.dynamicFacetableOption_ = dynamicFacetableOption_; result.searchableOption_ = searchableOption_; + result.exactSearchableOption_ = exactSearchableOption_; + result.retrievableOption_ = retrievableOption_; onBuilt(); return result; } @@ -1381,6 +1833,12 @@ public Builder mergeFrom(com.google.cloud.retail.v2.CatalogAttribute other) { if (other.searchableOption_ != 0) { setSearchableOptionValue(other.getSearchableOptionValue()); } + if (other.exactSearchableOption_ != 0) { + setExactSearchableOptionValue(other.getExactSearchableOptionValue()); + } + if (other.retrievableOption_ != 0) { + setRetrievableOptionValue(other.getRetrievableOptionValue()); + } this.mergeUnknownFields(other.getUnknownFields()); onChanged(); return this; @@ -1443,6 +1901,18 @@ public Builder mergeFrom( break; } // case 80 + case 88: + { + exactSearchableOption_ = input.readEnum(); + + break; + } // case 88 + case 96: + { + retrievableOption_ = input.readEnum(); + + break; + } // case 96 default: { if (!super.parseUnknownField(input, extensionRegistry, tag)) { @@ -1613,13 +2083,13 @@ public Builder setKeyBytes(com.google.protobuf.ByteString value) { * [CatalogService.UpdateAttributesConfig][google.cloud.retail.v2.CatalogService.UpdateAttributesConfig] * APIs. This field is `False` for pre-loaded * [CatalogAttribute][google.cloud.retail.v2.CatalogAttribute]s. - * Only pre-loaded - * [CatalogAttribute][google.cloud.retail.v2.CatalogAttribute]s that are - * neither in use by products nor predefined can be deleted. - * [CatalogAttribute][google.cloud.retail.v2.CatalogAttribute]s that are - * either in use by products or are predefined cannot be deleted; however, - * their configuration properties will reset to default values upon removal - * request. + * Only pre-loaded [catalog + * attributes][google.cloud.retail.v2.CatalogAttribute] that are neither in + * use by products nor predefined can be deleted. [Catalog + * attributes][google.cloud.retail.v2.CatalogAttribute] that are + * either in use by products or are predefined attributes cannot be deleted; + * however, their configuration properties will reset to default values upon + * removal request. * After catalog changes, it takes about 10 minutes for this field to update. * * @@ -1647,13 +2117,13 @@ public boolean getInUse() { * [CatalogService.UpdateAttributesConfig][google.cloud.retail.v2.CatalogService.UpdateAttributesConfig] * APIs. This field is `False` for pre-loaded * [CatalogAttribute][google.cloud.retail.v2.CatalogAttribute]s. - * Only pre-loaded - * [CatalogAttribute][google.cloud.retail.v2.CatalogAttribute]s that are - * neither in use by products nor predefined can be deleted. - * [CatalogAttribute][google.cloud.retail.v2.CatalogAttribute]s that are - * either in use by products or are predefined cannot be deleted; however, - * their configuration properties will reset to default values upon removal - * request. + * Only pre-loaded [catalog + * attributes][google.cloud.retail.v2.CatalogAttribute] that are neither in + * use by products nor predefined can be deleted. [Catalog + * attributes][google.cloud.retail.v2.CatalogAttribute] that are + * either in use by products or are predefined attributes cannot be deleted; + * however, their configuration properties will reset to default values upon + * removal request. * After catalog changes, it takes about 10 minutes for this field to update. * * @@ -1684,13 +2154,13 @@ public Builder setInUse(boolean value) { * [CatalogService.UpdateAttributesConfig][google.cloud.retail.v2.CatalogService.UpdateAttributesConfig] * APIs. This field is `False` for pre-loaded * [CatalogAttribute][google.cloud.retail.v2.CatalogAttribute]s. - * Only pre-loaded - * [CatalogAttribute][google.cloud.retail.v2.CatalogAttribute]s that are - * neither in use by products nor predefined can be deleted. - * [CatalogAttribute][google.cloud.retail.v2.CatalogAttribute]s that are - * either in use by products or are predefined cannot be deleted; however, - * their configuration properties will reset to default values upon removal - * request. + * Only pre-loaded [catalog + * attributes][google.cloud.retail.v2.CatalogAttribute] that are neither in + * use by products nor predefined can be deleted. [Catalog + * attributes][google.cloud.retail.v2.CatalogAttribute] that are + * either in use by products or are predefined attributes cannot be deleted; + * however, their configuration properties will reset to default values upon + * removal request. * After catalog changes, it takes about 10 minutes for this field to update. * * @@ -1823,6 +2293,7 @@ public Builder clearType() { * is CATALOG_LEVEL_ATTRIBUTE_CONFIG, if INDEXABLE_ENABLED attribute values * are indexed so that it can be filtered, faceted, or boosted in * [SearchService.Search][google.cloud.retail.v2.SearchService.Search]. + * Must be specified, otherwise throws INVALID_FORMAT error. * * * .google.cloud.retail.v2.CatalogAttribute.IndexableOption indexable_option = 5; @@ -1842,6 +2313,7 @@ public int getIndexableOptionValue() { * is CATALOG_LEVEL_ATTRIBUTE_CONFIG, if INDEXABLE_ENABLED attribute values * are indexed so that it can be filtered, faceted, or boosted in * [SearchService.Search][google.cloud.retail.v2.SearchService.Search]. + * Must be specified, otherwise throws INVALID_FORMAT error. * * * .google.cloud.retail.v2.CatalogAttribute.IndexableOption indexable_option = 5; @@ -1864,6 +2336,7 @@ public Builder setIndexableOptionValue(int value) { * is CATALOG_LEVEL_ATTRIBUTE_CONFIG, if INDEXABLE_ENABLED attribute values * are indexed so that it can be filtered, faceted, or boosted in * [SearchService.Search][google.cloud.retail.v2.SearchService.Search]. + * Must be specified, otherwise throws INVALID_FORMAT error. * * * .google.cloud.retail.v2.CatalogAttribute.IndexableOption indexable_option = 5; @@ -1888,6 +2361,7 @@ public com.google.cloud.retail.v2.CatalogAttribute.IndexableOption getIndexableO * is CATALOG_LEVEL_ATTRIBUTE_CONFIG, if INDEXABLE_ENABLED attribute values * are indexed so that it can be filtered, faceted, or boosted in * [SearchService.Search][google.cloud.retail.v2.SearchService.Search]. + * Must be specified, otherwise throws INVALID_FORMAT error. * * * .google.cloud.retail.v2.CatalogAttribute.IndexableOption indexable_option = 5; @@ -1914,6 +2388,7 @@ public Builder setIndexableOption( * is CATALOG_LEVEL_ATTRIBUTE_CONFIG, if INDEXABLE_ENABLED attribute values * are indexed so that it can be filtered, faceted, or boosted in * [SearchService.Search][google.cloud.retail.v2.SearchService.Search]. + * Must be specified, otherwise throws INVALID_FORMAT error. * * * .google.cloud.retail.v2.CatalogAttribute.IndexableOption indexable_option = 5; @@ -1936,6 +2411,7 @@ public Builder clearIndexableOption() { * facet. Could only be DYNAMIC_FACETABLE_DISABLED if * [CatalogAttribute.indexable_option][google.cloud.retail.v2.CatalogAttribute.indexable_option] * is INDEXABLE_DISABLED. Otherwise, an INVALID_ARGUMENT error is returned. + * Must be specified, otherwise throws INVALID_FORMAT error. * * * @@ -1956,6 +2432,7 @@ public int getDynamicFacetableOptionValue() { * facet. Could only be DYNAMIC_FACETABLE_DISABLED if * [CatalogAttribute.indexable_option][google.cloud.retail.v2.CatalogAttribute.indexable_option] * is INDEXABLE_DISABLED. Otherwise, an INVALID_ARGUMENT error is returned. + * Must be specified, otherwise throws INVALID_FORMAT error. * * * @@ -1979,6 +2456,7 @@ public Builder setDynamicFacetableOptionValue(int value) { * facet. Could only be DYNAMIC_FACETABLE_DISABLED if * [CatalogAttribute.indexable_option][google.cloud.retail.v2.CatalogAttribute.indexable_option] * is INDEXABLE_DISABLED. Otherwise, an INVALID_ARGUMENT error is returned. + * Must be specified, otherwise throws INVALID_FORMAT error. * * * @@ -2006,6 +2484,7 @@ public Builder setDynamicFacetableOptionValue(int value) { * facet. Could only be DYNAMIC_FACETABLE_DISABLED if * [CatalogAttribute.indexable_option][google.cloud.retail.v2.CatalogAttribute.indexable_option] * is INDEXABLE_DISABLED. Otherwise, an INVALID_ARGUMENT error is returned. + * Must be specified, otherwise throws INVALID_FORMAT error. * * * @@ -2033,6 +2512,7 @@ public Builder setDynamicFacetableOption( * facet. Could only be DYNAMIC_FACETABLE_DISABLED if * [CatalogAttribute.indexable_option][google.cloud.retail.v2.CatalogAttribute.indexable_option] * is INDEXABLE_DISABLED. Otherwise, an INVALID_ARGUMENT error is returned. + * Must be specified, otherwise throws INVALID_FORMAT error. * * * @@ -2062,6 +2542,7 @@ public Builder clearDynamicFacetableOption() { * will not be searchable by text queries in * [SearchService.Search][google.cloud.retail.v2.SearchService.Search], as * there are no text values associated to numerical attributes. + * Must be specified, otherwise throws INVALID_FORMAT error. * * * .google.cloud.retail.v2.CatalogAttribute.SearchableOption searchable_option = 7; @@ -2085,6 +2566,7 @@ public int getSearchableOptionValue() { * will not be searchable by text queries in * [SearchService.Search][google.cloud.retail.v2.SearchService.Search], as * there are no text values associated to numerical attributes. + * Must be specified, otherwise throws INVALID_FORMAT error. * * * .google.cloud.retail.v2.CatalogAttribute.SearchableOption searchable_option = 7; @@ -2111,6 +2593,7 @@ public Builder setSearchableOptionValue(int value) { * will not be searchable by text queries in * [SearchService.Search][google.cloud.retail.v2.SearchService.Search], as * there are no text values associated to numerical attributes. + * Must be specified, otherwise throws INVALID_FORMAT error. * * * .google.cloud.retail.v2.CatalogAttribute.SearchableOption searchable_option = 7; @@ -2139,6 +2622,7 @@ public com.google.cloud.retail.v2.CatalogAttribute.SearchableOption getSearchabl * will not be searchable by text queries in * [SearchService.Search][google.cloud.retail.v2.SearchService.Search], as * there are no text values associated to numerical attributes. + * Must be specified, otherwise throws INVALID_FORMAT error. * * * .google.cloud.retail.v2.CatalogAttribute.SearchableOption searchable_option = 7; @@ -2169,6 +2653,7 @@ public Builder setSearchableOption( * will not be searchable by text queries in * [SearchService.Search][google.cloud.retail.v2.SearchService.Search], as * there are no text values associated to numerical attributes. + * Must be specified, otherwise throws INVALID_FORMAT error. * * * .google.cloud.retail.v2.CatalogAttribute.SearchableOption searchable_option = 7; @@ -2182,6 +2667,226 @@ public Builder clearSearchableOption() { return this; } + private int exactSearchableOption_ = 0; + /** + * + * + * 
      +     * 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.
+     *
      + * + * + * .google.cloud.retail.v2.CatalogAttribute.ExactSearchableOption exact_searchable_option = 11; + * + * + * @return The enum numeric value on the wire for exactSearchableOption. + */ + @java.lang.Override + public int getExactSearchableOptionValue() { + return exactSearchableOption_; + } + /** + * + * + * 
      +     * 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.
+     *
      + * + * + * .google.cloud.retail.v2.CatalogAttribute.ExactSearchableOption exact_searchable_option = 11; + * + * + * @param value The enum numeric value on the wire for exactSearchableOption to set. + * @return This builder for chaining. + */ + public Builder setExactSearchableOptionValue(int value) { + + exactSearchableOption_ = value; + onChanged(); + return this; + } + /** + * + * + * 
      +     * 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.
+     *
      + * + * + * .google.cloud.retail.v2.CatalogAttribute.ExactSearchableOption exact_searchable_option = 11; + * + * + * @return The exactSearchableOption. + */ + @java.lang.Override + public com.google.cloud.retail.v2.CatalogAttribute.ExactSearchableOption + getExactSearchableOption() { + @SuppressWarnings("deprecation") + com.google.cloud.retail.v2.CatalogAttribute.ExactSearchableOption result = + com.google.cloud.retail.v2.CatalogAttribute.ExactSearchableOption.valueOf( + exactSearchableOption_); + return result == null + ? com.google.cloud.retail.v2.CatalogAttribute.ExactSearchableOption.UNRECOGNIZED + : result; + } + /** + * + * + * 
      +     * 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.
+     *
      + * + * + * .google.cloud.retail.v2.CatalogAttribute.ExactSearchableOption exact_searchable_option = 11; + * + * + * @param value The exactSearchableOption to set. + * @return This builder for chaining. + */ + public Builder setExactSearchableOption( + com.google.cloud.retail.v2.CatalogAttribute.ExactSearchableOption value) { + if (value == null) { + throw new NullPointerException(); + } + + exactSearchableOption_ = value.getNumber(); + onChanged(); + return this; + } + /** + * + * + * 
      +     * 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.
+     *
      + * + * + * .google.cloud.retail.v2.CatalogAttribute.ExactSearchableOption exact_searchable_option = 11; + * + * + * @return This builder for chaining. + */ + public Builder clearExactSearchableOption() { + + exactSearchableOption_ = 0; + onChanged(); + return this; + } + + private int retrievableOption_ = 0; + /** + * + * + * 
      +     * If RETRIEVABLE_ENABLED, attribute values are retrievable in the search
+     * results.
+     *
      + * + * .google.cloud.retail.v2.CatalogAttribute.RetrievableOption retrievable_option = 12; + * + * + * @return The enum numeric value on the wire for retrievableOption. + */ + @java.lang.Override + public int getRetrievableOptionValue() { + return retrievableOption_; + } + /** + * + * + * 
      +     * If RETRIEVABLE_ENABLED, attribute values are retrievable in the search
+     * results.
+     *
      + * + * .google.cloud.retail.v2.CatalogAttribute.RetrievableOption retrievable_option = 12; + * + * + * @param value The enum numeric value on the wire for retrievableOption to set. + * @return This builder for chaining. + */ + public Builder setRetrievableOptionValue(int value) { + + retrievableOption_ = value; + onChanged(); + return this; + } + /** + * + * + * 
      +     * If RETRIEVABLE_ENABLED, attribute values are retrievable in the search
+     * results.
+     *
      + * + * .google.cloud.retail.v2.CatalogAttribute.RetrievableOption retrievable_option = 12; + * + * + * @return The retrievableOption. + */ + @java.lang.Override + public com.google.cloud.retail.v2.CatalogAttribute.RetrievableOption getRetrievableOption() { + @SuppressWarnings("deprecation") + com.google.cloud.retail.v2.CatalogAttribute.RetrievableOption result = + com.google.cloud.retail.v2.CatalogAttribute.RetrievableOption.valueOf(retrievableOption_); + return result == null + ? com.google.cloud.retail.v2.CatalogAttribute.RetrievableOption.UNRECOGNIZED + : result; + } + /** + * + * + * 
      +     * If RETRIEVABLE_ENABLED, attribute values are retrievable in the search
+     * results.
+     *
      + * + * .google.cloud.retail.v2.CatalogAttribute.RetrievableOption retrievable_option = 12; + * + * + * @param value The retrievableOption to set. + * @return This builder for chaining. + */ + public Builder setRetrievableOption( + com.google.cloud.retail.v2.CatalogAttribute.RetrievableOption value) { + if (value == null) { + throw new NullPointerException(); + } + + retrievableOption_ = value.getNumber(); + onChanged(); + return this; + } + /** + * + * + * 
      +     * If RETRIEVABLE_ENABLED, attribute values are retrievable in the search
+     * results.
+     *
      + * + * .google.cloud.retail.v2.CatalogAttribute.RetrievableOption retrievable_option = 12; + * + * + * @return This builder for chaining. + */ + public Builder clearRetrievableOption() { + + retrievableOption_ = 0; + onChanged(); + return this; + } + @java.lang.Override public final Builder setUnknownFields(final com.google.protobuf.UnknownFieldSet unknownFields) { return super.setUnknownFields(unknownFields); diff --git a/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/CatalogAttributeOrBuilder.java b/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/CatalogAttributeOrBuilder.java index 6e24c8e3f23d..3f76e246db96 100644 --- a/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/CatalogAttributeOrBuilder.java +++ b/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/CatalogAttributeOrBuilder.java @@ -76,13 +76,13 @@ public interface CatalogAttributeOrBuilder * [CatalogService.UpdateAttributesConfig][google.cloud.retail.v2.CatalogService.UpdateAttributesConfig] * APIs. This field is `False` for pre-loaded * [CatalogAttribute][google.cloud.retail.v2.CatalogAttribute]s. - * Only pre-loaded - * [CatalogAttribute][google.cloud.retail.v2.CatalogAttribute]s that are - * neither in use by products nor predefined can be deleted. - * [CatalogAttribute][google.cloud.retail.v2.CatalogAttribute]s that are - * either in use by products or are predefined cannot be deleted; however, - * their configuration properties will reset to default values upon removal - * request. + * Only pre-loaded [catalog + * attributes][google.cloud.retail.v2.CatalogAttribute] that are neither in + * use by products nor predefined can be deleted. [Catalog + * attributes][google.cloud.retail.v2.CatalogAttribute] that are + * either in use by products or are predefined attributes cannot be deleted; + * however, their configuration properties will reset to default values upon + * removal request. * After catalog changes, it takes about 10 minutes for this field to update. * * @@ -132,6 +132,7 @@ public interface CatalogAttributeOrBuilder * is CATALOG_LEVEL_ATTRIBUTE_CONFIG, if INDEXABLE_ENABLED attribute values * are indexed so that it can be filtered, faceted, or boosted in * [SearchService.Search][google.cloud.retail.v2.SearchService.Search]. + * Must be specified, otherwise throws INVALID_FORMAT error. * * * .google.cloud.retail.v2.CatalogAttribute.IndexableOption indexable_option = 5; @@ -148,6 +149,7 @@ public interface CatalogAttributeOrBuilder * is CATALOG_LEVEL_ATTRIBUTE_CONFIG, if INDEXABLE_ENABLED attribute values * are indexed so that it can be filtered, faceted, or boosted in * [SearchService.Search][google.cloud.retail.v2.SearchService.Search]. + * Must be specified, otherwise throws INVALID_FORMAT error. * * * .google.cloud.retail.v2.CatalogAttribute.IndexableOption indexable_option = 5; @@ -164,6 +166,7 @@ public interface CatalogAttributeOrBuilder * facet. Could only be DYNAMIC_FACETABLE_DISABLED if * [CatalogAttribute.indexable_option][google.cloud.retail.v2.CatalogAttribute.indexable_option] * is INDEXABLE_DISABLED. Otherwise, an INVALID_ARGUMENT error is returned. + * Must be specified, otherwise throws INVALID_FORMAT error. * * * @@ -181,6 +184,7 @@ public interface CatalogAttributeOrBuilder * facet. Could only be DYNAMIC_FACETABLE_DISABLED if * [CatalogAttribute.indexable_option][google.cloud.retail.v2.CatalogAttribute.indexable_option] * is INDEXABLE_DISABLED. Otherwise, an INVALID_ARGUMENT error is returned. + * Must be specified, otherwise throws INVALID_FORMAT error. * * * @@ -204,6 +208,7 @@ public interface CatalogAttributeOrBuilder * will not be searchable by text queries in * [SearchService.Search][google.cloud.retail.v2.SearchService.Search], as * there are no text values associated to numerical attributes. + * Must be specified, otherwise throws INVALID_FORMAT error. * * * .google.cloud.retail.v2.CatalogAttribute.SearchableOption searchable_option = 7; @@ -224,6 +229,7 @@ public interface CatalogAttributeOrBuilder * will not be searchable by text queries in * [SearchService.Search][google.cloud.retail.v2.SearchService.Search], as * there are no text values associated to numerical attributes. + * Must be specified, otherwise throws INVALID_FORMAT error. * * * .google.cloud.retail.v2.CatalogAttribute.SearchableOption searchable_option = 7; @@ -231,4 +237,66 @@ public interface CatalogAttributeOrBuilder * @return The searchableOption. */ com.google.cloud.retail.v2.CatalogAttribute.SearchableOption getSearchableOption(); + + /** + * + * + * 
      +   * 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.
+   *
      + * + * + * .google.cloud.retail.v2.CatalogAttribute.ExactSearchableOption exact_searchable_option = 11; + * + * + * @return The enum numeric value on the wire for exactSearchableOption. + */ + int getExactSearchableOptionValue(); + /** + * + * + * 
      +   * 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.
+   *
      + * + * + * .google.cloud.retail.v2.CatalogAttribute.ExactSearchableOption exact_searchable_option = 11; + * + * + * @return The exactSearchableOption. + */ + com.google.cloud.retail.v2.CatalogAttribute.ExactSearchableOption getExactSearchableOption(); + + /** + * + * + * 
      +   * If RETRIEVABLE_ENABLED, attribute values are retrievable in the search
+   * results.
+   *
      + * + * .google.cloud.retail.v2.CatalogAttribute.RetrievableOption retrievable_option = 12; + * + * + * @return The enum numeric value on the wire for retrievableOption. + */ + int getRetrievableOptionValue(); + /** + * + * + * 
      +   * If RETRIEVABLE_ENABLED, attribute values are retrievable in the search
+   * results.
+   *
      + * + * .google.cloud.retail.v2.CatalogAttribute.RetrievableOption retrievable_option = 12; + * + * + * @return The retrievableOption. + */ + com.google.cloud.retail.v2.CatalogAttribute.RetrievableOption getRetrievableOption(); } diff --git a/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/CatalogProto.java b/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/CatalogProto.java index cde0dc192a9c..dbcf71c1bc66 100644 --- a/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/CatalogProto.java +++ b/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/CatalogProto.java @@ -67,7 +67,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() { + "*google/cloud/retail/v2/import_config.pr" + "oto\"^\n\022ProductLevelConfig\022\036\n\026ingestion_p" + "roduct_type\030\001 \001(\t\022(\n merchant_center_pro" - + "duct_id_field\030\002 \001(\t\"\233\006\n\020CatalogAttribute" + + "duct_id_field\030\002 \001(\t\"\277\t\n\020CatalogAttribute" + "\022\020\n\003key\030\001 \001(\tB\003\340A\002\022\023\n\006in_use\030\t \001(\010B\003\340A\003\022" + "I\n\004type\030\n \001(\01626.google.cloud.retail.v2.C" + "atalogAttribute.AttributeTypeB\003\340A\003\022R\n\020in" @@ -77,56 +77,66 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() { + "e.cloud.retail.v2.CatalogAttribute.Dynam" + "icFacetableOption\022T\n\021searchable_option\030\007" + " \001(\01629.google.cloud.retail.v2.CatalogAtt" - + "ribute.SearchableOption\"8\n\rAttributeType" - + "\022\013\n\007UNKNOWN\020\000\022\013\n\007TEXTUAL\020\001\022\r\n\tNUMERICAL\020" - + "\002\"b\n\017IndexableOption\022 \n\034INDEXABLE_OPTION" - + "_UNSPECIFIED\020\000\022\025\n\021INDEXABLE_ENABLED\020\001\022\026\n" - + "\022INDEXABLE_DISABLED\020\002\"\201\001\n\026DynamicFacetab" - + "leOption\022(\n$DYNAMIC_FACETABLE_OPTION_UNS" - + "PECIFIED\020\000\022\035\n\031DYNAMIC_FACETABLE_ENABLED\020" - + "\001\022\036\n\032DYNAMIC_FACETABLE_DISABLED\020\002\"f\n\020Sea" - + "rchableOption\022!\n\035SEARCHABLE_OPTION_UNSPE" - + "CIFIED\020\000\022\026\n\022SEARCHABLE_ENABLED\020\001\022\027\n\023SEAR" - + "CHABLE_DISABLED\020\002\"\266\003\n\020AttributesConfig\022\024" - + "\n\004name\030\001 \001(\tB\006\340A\002\340A\005\022[\n\022catalog_attribut" - + "es\030\002 \003(\0132?.google.cloud.retail.v2.Attrib" - + "utesConfig.CatalogAttributesEntry\022Q\n\026att" - + "ribute_config_level\030\003 \001(\0162,.google.cloud" - + ".retail.v2.AttributeConfigLevelB\003\340A\003\032b\n\026" - + "CatalogAttributesEntry\022\013\n\003key\030\001 \001(\t\0227\n\005v" - + "alue\030\002 \001(\0132(.google.cloud.retail.v2.Cata" - + "logAttribute:\0028\001:x\352Au\n&retail.googleapis" - + ".com/AttributesConfig\022Kprojects/{project" - + "}/locations/{location}/catalogs/{catalog" - + "}/attributesConfig\"\231\005\n\020CompletionConfig\022" - + "\024\n\004name\030\001 \001(\tB\006\340A\002\340A\005\022\026\n\016matching_order\030" - + "\002 \001(\t\022\027\n\017max_suggestions\030\003 \001(\005\022\031\n\021min_pr" - + "efix_length\030\004 \001(\005\022\025\n\rauto_learning\030\013 \001(\010" - + "\022X\n\030suggestions_input_config\030\005 \001(\01321.goo" - + "gle.cloud.retail.v2.CompletionDataInputC" - + "onfigB\003\340A\003\022.\n!last_suggestions_import_op" - + "eration\030\006 \001(\tB\003\340A\003\022U\n\025denylist_input_con" - + "fig\030\007 \001(\01321.google.cloud.retail.v2.Compl" - + "etionDataInputConfigB\003\340A\003\022+\n\036last_denyli" - + "st_import_operation\030\010 \001(\tB\003\340A\003\022V\n\026allowl" - + "ist_input_config\030\t \001(\01321.google.cloud.re" - + "tail.v2.CompletionDataInputConfigB\003\340A\003\022," - + "\n\037last_allowlist_import_operation\030\n \001(\tB" - + "\003\340A\003:x\352Au\n&retail.googleapis.com/Complet" - + "ionConfig\022Kprojects/{project}/locations/" - + "{location}/catalogs/{catalog}/completion" - + "Config\"\354\001\n\007Catalog\022\024\n\004name\030\001 \001(\tB\006\340A\002\340A\005" - + "\022\034\n\014display_name\030\002 \001(\tB\006\340A\002\340A\005\022M\n\024produc" - + "t_level_config\030\004 \001(\0132*.google.cloud.reta" - + "il.v2.ProductLevelConfigB\003\340A\002:^\352A[\n\035reta" - + "il.googleapis.com/Catalog\022:projects/{pro" - + "ject}/locations/{location}/catalogs/{cat" - + "alog}B\301\001\n\032com.google.cloud.retail.v2B\014Ca" - + "talogProtoP\001Z.google.cloud.retail.v" + + "2.CatalogAttribute.ExactSearchableOption" + + "\022V\n\022retrievable_option\030\014 \001(\0162:.google.cl" + + "oud.retail.v2.CatalogAttribute.Retrievab" + + "leOption\"8\n\rAttributeType\022\013\n\007UNKNOWN\020\000\022\013" + + "\n\007TEXTUAL\020\001\022\r\n\tNUMERICAL\020\002\"b\n\017IndexableO" + + "ption\022 \n\034INDEXABLE_OPTION_UNSPECIFIED\020\000\022" + + "\025\n\021INDEXABLE_ENABLED\020\001\022\026\n\022INDEXABLE_DISA" + + "BLED\020\002\"\201\001\n\026DynamicFacetableOption\022(\n$DYN" + + "AMIC_FACETABLE_OPTION_UNSPECIFIED\020\000\022\035\n\031D" + + "YNAMIC_FACETABLE_ENABLED\020\001\022\036\n\032DYNAMIC_FA" + + "CETABLE_DISABLED\020\002\"f\n\020SearchableOption\022!" + + "\n\035SEARCHABLE_OPTION_UNSPECIFIED\020\000\022\026\n\022SEA" + + "RCHABLE_ENABLED\020\001\022\027\n\023SEARCHABLE_DISABLED" + + "\020\002\"}\n\025ExactSearchableOption\022\'\n#EXACT_SEA" + + "RCHABLE_OPTION_UNSPECIFIED\020\000\022\034\n\030EXACT_SE" + + "ARCHABLE_ENABLED\020\001\022\035\n\031EXACT_SEARCHABLE_D" + + "ISABLED\020\002\"j\n\021RetrievableOption\022\"\n\036RETRIE" + + "VABLE_OPTION_UNSPECIFIED\020\000\022\027\n\023RETRIEVABL" + + "E_ENABLED\020\001\022\030\n\024RETRIEVABLE_DISABLED\020\002\"\266\003" + + "\n\020AttributesConfig\022\024\n\004name\030\001 \001(\tB\006\340A\002\340A\005" + + "\022[\n\022catalog_attributes\030\002 \003(\0132?.google.cl" + + "oud.retail.v2.AttributesConfig.CatalogAt" + + "tributesEntry\022Q\n\026attribute_config_level\030" + + "\003 \001(\0162,.google.cloud.retail.v2.Attribute" + + "ConfigLevelB\003\340A\003\032b\n\026CatalogAttributesEnt" + + "ry\022\013\n\003key\030\001 \001(\t\0227\n\005value\030\002 \001(\0132(.google." + + "cloud.retail.v2.CatalogAttribute:\0028\001:x\352A" + + "u\n&retail.googleapis.com/AttributesConfi" + + "g\022Kprojects/{project}/locations/{locatio" + + "n}/catalogs/{catalog}/attributesConfig\"\231" + + "\005\n\020CompletionConfig\022\024\n\004name\030\001 \001(\tB\006\340A\002\340A" + + "\005\022\026\n\016matching_order\030\002 \001(\t\022\027\n\017max_suggest" + + "ions\030\003 \001(\005\022\031\n\021min_prefix_length\030\004 \001(\005\022\025\n" + + "\rauto_learning\030\013 \001(\010\022X\n\030suggestions_inpu" + + "t_config\030\005 \001(\01321.google.cloud.retail.v2." + + "CompletionDataInputConfigB\003\340A\003\022.\n!last_s" + + "uggestions_import_operation\030\006 \001(\tB\003\340A\003\022U" + + "\n\025denylist_input_config\030\007 \001(\01321.google.c" + + "loud.retail.v2.CompletionDataInputConfig" + + "B\003\340A\003\022+\n\036last_denylist_import_operation\030" + + "\010 \001(\tB\003\340A\003\022V\n\026allowlist_input_config\030\t \001" + + "(\01321.google.cloud.retail.v2.CompletionDa" + + "taInputConfigB\003\340A\003\022,\n\037last_allowlist_imp" + + "ort_operation\030\n \001(\tB\003\340A\003:x\352Au\n&retail.go" + + "ogleapis.com/CompletionConfig\022Kprojects/" + + "{project}/locations/{location}/catalogs/" + + "{catalog}/completionConfig\"\354\001\n\007Catalog\022\024" + + "\n\004name\030\001 \001(\tB\006\340A\002\340A\005\022\034\n\014display_name\030\002 \001" + + "(\tB\006\340A\002\340A\005\022M\n\024product_level_config\030\004 \001(\013" + + "2*.google.cloud.retail.v2.ProductLevelCo" + + "nfigB\003\340A\002:^\352A[\n\035retail.googleapis.com/Ca" + + "talog\022:projects/{project}/locations/{loc" + + "ation}/catalogs/{catalog}B\301\001\n\032com.google" + + ".cloud.retail.v2B\014CatalogProtoP\001Z + * The prebuilt rule name that can convert a specific type of raw_json. + * For example: "default_schema/v1.0" + * + * + * string prebuilt_rule = 6; + * + * @return Whether the prebuiltRule field is set. + */ + public boolean hasPrebuiltRule() { + return conversionRuleCase_ == 6; + } + /** + * + * + * 
      +   * The prebuilt rule name that can convert a specific type of raw_json.
+   * For example: "default_schema/v1.0"
+   *
      + * + * string prebuilt_rule = 6; + * + * @return The prebuiltRule. + */ + public java.lang.String getPrebuiltRule() { + java.lang.Object ref = ""; + if (conversionRuleCase_ == 6) { + ref = conversionRule_; + } + if (ref instanceof java.lang.String) { + return (java.lang.String) ref; + } else { + com.google.protobuf.ByteString bs = (com.google.protobuf.ByteString) ref; + java.lang.String s = bs.toStringUtf8(); + if (conversionRuleCase_ == 6) { + conversionRule_ = s; + } + return s; + } + } + /** + * + * + * 
      +   * The prebuilt rule name that can convert a specific type of raw_json.
+   * For example: "default_schema/v1.0"
+   *
      + * + * string prebuilt_rule = 6; + * + * @return The bytes for prebuiltRule. + */ + public com.google.protobuf.ByteString getPrebuiltRuleBytes() { + java.lang.Object ref = ""; + if (conversionRuleCase_ == 6) { + ref = conversionRule_; + } + if (ref instanceof java.lang.String) { + com.google.protobuf.ByteString b = + com.google.protobuf.ByteString.copyFromUtf8((java.lang.String) ref); + if (conversionRuleCase_ == 6) { + conversionRule_ = b; + } + return b; + } else { + return (com.google.protobuf.ByteString) ref; + } + } + public static final int PARENT_FIELD_NUMBER = 1; private volatile java.lang.Object parent_; /** @@ -246,6 +364,61 @@ public long getEts() { return ets_; } + public static final int RAW_JSON_FIELD_NUMBER = 5; + private volatile java.lang.Object rawJson_; + /** + * + * + * 
      +   * An arbitrary serialized JSON string that contains necessary information
+   * that can comprise a user event. When this field is specified, the
+   * user_event field will be ignored. Note: line-delimited JSON is not
+   * supported, a single JSON only.
+   *
      + * + * string raw_json = 5; + * + * @return The rawJson. + */ + @java.lang.Override + public java.lang.String getRawJson() { + java.lang.Object ref = rawJson_; + if (ref instanceof java.lang.String) { + return (java.lang.String) ref; + } else { + com.google.protobuf.ByteString bs = (com.google.protobuf.ByteString) ref; + java.lang.String s = bs.toStringUtf8(); + rawJson_ = s; + return s; + } + } + /** + * + * + * 
      +   * An arbitrary serialized JSON string that contains necessary information
+   * that can comprise a user event. When this field is specified, the
+   * user_event field will be ignored. Note: line-delimited JSON is not
+   * supported, a single JSON only.
+   *
      + * + * string raw_json = 5; + * + * @return The bytes for rawJson. + */ + @java.lang.Override + public com.google.protobuf.ByteString getRawJsonBytes() { + java.lang.Object ref = rawJson_; + if (ref instanceof java.lang.String) { + com.google.protobuf.ByteString b = + com.google.protobuf.ByteString.copyFromUtf8((java.lang.String) ref); + rawJson_ = b; + return b; + } else { + return (com.google.protobuf.ByteString) ref; + } + } + private byte memoizedIsInitialized = -1; @java.lang.Override @@ -272,6 +445,12 @@ public void writeTo(com.google.protobuf.CodedOutputStream output) throws java.io if (ets_ != 0L) { output.writeInt64(4, ets_); } + if (!com.google.protobuf.GeneratedMessageV3.isStringEmpty(rawJson_)) { + com.google.protobuf.GeneratedMessageV3.writeString(output, 5, rawJson_); + } + if (conversionRuleCase_ == 6) { + com.google.protobuf.GeneratedMessageV3.writeString(output, 6, conversionRule_); + } getUnknownFields().writeTo(output); } @@ -293,6 +472,12 @@ public int getSerializedSize() { if (ets_ != 0L) { size += com.google.protobuf.CodedOutputStream.computeInt64Size(4, ets_); } + if (!com.google.protobuf.GeneratedMessageV3.isStringEmpty(rawJson_)) { + size += com.google.protobuf.GeneratedMessageV3.computeStringSize(5, rawJson_); + } + if (conversionRuleCase_ == 6) { + size += com.google.protobuf.GeneratedMessageV3.computeStringSize(6, conversionRule_); + } size += getUnknownFields().getSerializedSize(); memoizedSize = size; return size; @@ -313,6 +498,15 @@ public boolean equals(final java.lang.Object obj) { if (!getUserEvent().equals(other.getUserEvent())) return false; if (!getUri().equals(other.getUri())) return false; if (getEts() != other.getEts()) return false; + if (!getRawJson().equals(other.getRawJson())) return false; + if (!getConversionRuleCase().equals(other.getConversionRuleCase())) return false; + switch (conversionRuleCase_) { + case 6: + if (!getPrebuiltRule().equals(other.getPrebuiltRule())) return false; + break; + case 0: + default: + } if (!getUnknownFields().equals(other.getUnknownFields())) return false; return true; } @@ -332,6 +526,16 @@ public int hashCode() { hash = (53 * hash) + getUri().hashCode(); hash = (37 * hash) + ETS_FIELD_NUMBER; hash = (53 * hash) + com.google.protobuf.Internal.hashLong(getEts()); + hash = (37 * hash) + RAW_JSON_FIELD_NUMBER; + hash = (53 * hash) + getRawJson().hashCode(); + switch (conversionRuleCase_) { + case 6: + hash = (37 * hash) + PREBUILT_RULE_FIELD_NUMBER; + hash = (53 * hash) + getPrebuiltRule().hashCode(); + break; + case 0: + default: + } hash = (29 * hash) + getUnknownFields().hashCode(); memoizedHashCode = hash; return hash; @@ -478,6 +682,10 @@ public Builder clear() { ets_ = 0L; + rawJson_ = ""; + + conversionRuleCase_ = 0; + conversionRule_ = null; return this; } @@ -505,10 +713,15 @@ public com.google.cloud.retail.v2.CollectUserEventRequest build() { public com.google.cloud.retail.v2.CollectUserEventRequest buildPartial() { com.google.cloud.retail.v2.CollectUserEventRequest result = new com.google.cloud.retail.v2.CollectUserEventRequest(this); + if (conversionRuleCase_ == 6) { + result.conversionRule_ = conversionRule_; + } result.parent_ = parent_; result.userEvent_ = userEvent_; result.uri_ = uri_; result.ets_ = ets_; + result.rawJson_ = rawJson_; + result.conversionRuleCase_ = conversionRuleCase_; onBuilt(); return result; } @@ -574,6 +787,23 @@ public Builder mergeFrom(com.google.cloud.retail.v2.CollectUserEventRequest othe if (other.getEts() != 0L) { setEts(other.getEts()); } + if (!other.getRawJson().isEmpty()) { + rawJson_ = other.rawJson_; + onChanged(); + } + switch (other.getConversionRuleCase()) { + case PREBUILT_RULE: + { + conversionRuleCase_ = 6; + conversionRule_ = other.conversionRule_; + onChanged(); + break; + } + case CONVERSIONRULE_NOT_SET: + { + break; + } + } this.mergeUnknownFields(other.getUnknownFields()); onChanged(); return this; @@ -624,6 +854,19 @@ public Builder mergeFrom( break; } // case 32 + case 42: + { + rawJson_ = input.readStringRequireUtf8(); + + break; + } // case 42 + case 50: + { + java.lang.String s = input.readStringRequireUtf8(); + conversionRuleCase_ = 6; + conversionRule_ = s; + break; + } // case 50 default: { if (!super.parseUnknownField(input, extensionRegistry, tag)) { @@ -641,6 +884,160 @@ public Builder mergeFrom( return this; } + private int conversionRuleCase_ = 0; + private java.lang.Object conversionRule_; + + public ConversionRuleCase getConversionRuleCase() { + return ConversionRuleCase.forNumber(conversionRuleCase_); + } + + public Builder clearConversionRule() { + conversionRuleCase_ = 0; + conversionRule_ = null; + onChanged(); + return this; + } + + /** + * + * + * 
      +     * The prebuilt rule name that can convert a specific type of raw_json.
+     * For example: "default_schema/v1.0"
+     *
      + * + * string prebuilt_rule = 6; + * + * @return Whether the prebuiltRule field is set. + */ + @java.lang.Override + public boolean hasPrebuiltRule() { + return conversionRuleCase_ == 6; + } + /** + * + * + * 
      +     * The prebuilt rule name that can convert a specific type of raw_json.
+     * For example: "default_schema/v1.0"
+     *
      + * + * string prebuilt_rule = 6; + * + * @return The prebuiltRule. + */ + @java.lang.Override + public java.lang.String getPrebuiltRule() { + java.lang.Object ref = ""; + if (conversionRuleCase_ == 6) { + ref = conversionRule_; + } + if (!(ref instanceof java.lang.String)) { + com.google.protobuf.ByteString bs = (com.google.protobuf.ByteString) ref; + java.lang.String s = bs.toStringUtf8(); + if (conversionRuleCase_ == 6) { + conversionRule_ = s; + } + return s; + } else { + return (java.lang.String) ref; + } + } + /** + * + * + * 
      +     * The prebuilt rule name that can convert a specific type of raw_json.
+     * For example: "default_schema/v1.0"
+     *
      + * + * string prebuilt_rule = 6; + * + * @return The bytes for prebuiltRule. + */ + @java.lang.Override + public com.google.protobuf.ByteString getPrebuiltRuleBytes() { + java.lang.Object ref = ""; + if (conversionRuleCase_ == 6) { + ref = conversionRule_; + } + if (ref instanceof String) { + com.google.protobuf.ByteString b = + com.google.protobuf.ByteString.copyFromUtf8((java.lang.String) ref); + if (conversionRuleCase_ == 6) { + conversionRule_ = b; + } + return b; + } else { + return (com.google.protobuf.ByteString) ref; + } + } + /** + * + * + * 
      +     * The prebuilt rule name that can convert a specific type of raw_json.
+     * For example: "default_schema/v1.0"
+     *
      + * + * string prebuilt_rule = 6; + * + * @param value The prebuiltRule to set. + * @return This builder for chaining. + */ + public Builder setPrebuiltRule(java.lang.String value) { + if (value == null) { + throw new NullPointerException(); + } + conversionRuleCase_ = 6; + conversionRule_ = value; + onChanged(); + return this; + } + /** + * + * + * 
      +     * The prebuilt rule name that can convert a specific type of raw_json.
+     * For example: "default_schema/v1.0"
+     *
      + * + * string prebuilt_rule = 6; + * + * @return This builder for chaining. + */ + public Builder clearPrebuiltRule() { + if (conversionRuleCase_ == 6) { + conversionRuleCase_ = 0; + conversionRule_ = null; + onChanged(); + } + return this; + } + /** + * + * + * 
      +     * The prebuilt rule name that can convert a specific type of raw_json.
+     * For example: "default_schema/v1.0"
+     *
      + * + * string prebuilt_rule = 6; + * + * @param value The bytes for prebuiltRule to set. + * @return This builder for chaining. + */ + public Builder setPrebuiltRuleBytes(com.google.protobuf.ByteString value) { + if (value == null) { + throw new NullPointerException(); + } + checkByteStringIsUtf8(value); + conversionRuleCase_ = 6; + conversionRule_ = value; + onChanged(); + return this; + } + private java.lang.Object parent_ = ""; /** * @@ -1042,6 +1439,127 @@ public Builder clearEts() { return this; } + private java.lang.Object rawJson_ = ""; + /** + * + * + * 
      +     * An arbitrary serialized JSON string that contains necessary information
+     * that can comprise a user event. When this field is specified, the
+     * user_event field will be ignored. Note: line-delimited JSON is not
+     * supported, a single JSON only.
+     *
      + * + * string raw_json = 5; + * + * @return The rawJson. + */ + public java.lang.String getRawJson() { + java.lang.Object ref = rawJson_; + if (!(ref instanceof java.lang.String)) { + com.google.protobuf.ByteString bs = (com.google.protobuf.ByteString) ref; + java.lang.String s = bs.toStringUtf8(); + rawJson_ = s; + return s; + } else { + return (java.lang.String) ref; + } + } + /** + * + * + * 
      +     * An arbitrary serialized JSON string that contains necessary information
+     * that can comprise a user event. When this field is specified, the
+     * user_event field will be ignored. Note: line-delimited JSON is not
+     * supported, a single JSON only.
+     *
      + * + * string raw_json = 5; + * + * @return The bytes for rawJson. + */ + public com.google.protobuf.ByteString getRawJsonBytes() { + java.lang.Object ref = rawJson_; + if (ref instanceof String) { + com.google.protobuf.ByteString b = + com.google.protobuf.ByteString.copyFromUtf8((java.lang.String) ref); + rawJson_ = b; + return b; + } else { + return (com.google.protobuf.ByteString) ref; + } + } + /** + * + * + * 
      +     * An arbitrary serialized JSON string that contains necessary information
+     * that can comprise a user event. When this field is specified, the
+     * user_event field will be ignored. Note: line-delimited JSON is not
+     * supported, a single JSON only.
+     *
      + * + * string raw_json = 5; + * + * @param value The rawJson to set. + * @return This builder for chaining. + */ + public Builder setRawJson(java.lang.String value) { + if (value == null) { + throw new NullPointerException(); + } + + rawJson_ = value; + onChanged(); + return this; + } + /** + * + * + * 
      +     * An arbitrary serialized JSON string that contains necessary information
+     * that can comprise a user event. When this field is specified, the
+     * user_event field will be ignored. Note: line-delimited JSON is not
+     * supported, a single JSON only.
+     *
      + * + * string raw_json = 5; + * + * @return This builder for chaining. + */ + public Builder clearRawJson() { + + rawJson_ = getDefaultInstance().getRawJson(); + onChanged(); + return this; + } + /** + * + * + * 
      +     * An arbitrary serialized JSON string that contains necessary information
+     * that can comprise a user event. When this field is specified, the
+     * user_event field will be ignored. Note: line-delimited JSON is not
+     * supported, a single JSON only.
+     *
      + * + * string raw_json = 5; + * + * @param value The bytes for rawJson to set. + * @return This builder for chaining. + */ + public Builder setRawJsonBytes(com.google.protobuf.ByteString value) { + if (value == null) { + throw new NullPointerException(); + } + checkByteStringIsUtf8(value); + + rawJson_ = value; + onChanged(); + return this; + } + @java.lang.Override public final Builder setUnknownFields(final com.google.protobuf.UnknownFieldSet unknownFields) { return super.setUnknownFields(unknownFields); diff --git a/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/CollectUserEventRequestOrBuilder.java b/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/CollectUserEventRequestOrBuilder.java index 5083ce429f5d..8eb521f63c01 100644 --- a/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/CollectUserEventRequestOrBuilder.java +++ b/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/CollectUserEventRequestOrBuilder.java @@ -23,6 +23,46 @@ public interface CollectUserEventRequestOrBuilder // @@protoc_insertion_point(interface_extends:google.cloud.retail.v2.CollectUserEventRequest) com.google.protobuf.MessageOrBuilder { + /** + * + * + * 
      +   * The prebuilt rule name that can convert a specific type of raw_json.
+   * For example: "default_schema/v1.0"
+   *
      + * + * string prebuilt_rule = 6; + * + * @return Whether the prebuiltRule field is set. + */ + boolean hasPrebuiltRule(); + /** + * + * + * 
      +   * The prebuilt rule name that can convert a specific type of raw_json.
+   * For example: "default_schema/v1.0"
+   *
      + * + * string prebuilt_rule = 6; + * + * @return The prebuiltRule. + */ + java.lang.String getPrebuiltRule(); + /** + * + * + * 
      +   * The prebuilt rule name that can convert a specific type of raw_json.
+   * For example: "default_schema/v1.0"
+   *
      + * + * string prebuilt_rule = 6; + * + * @return The bytes for prebuiltRule. + */ + com.google.protobuf.ByteString getPrebuiltRuleBytes(); + /** * * @@ -122,4 +162,38 @@ public interface CollectUserEventRequestOrBuilder * @return The ets. */ long getEts(); + + /** + * + * + * 
      +   * An arbitrary serialized JSON string that contains necessary information
+   * that can comprise a user event. When this field is specified, the
+   * user_event field will be ignored. Note: line-delimited JSON is not
+   * supported, a single JSON only.
+   *
      + * + * string raw_json = 5; + * + * @return The rawJson. + */ + java.lang.String getRawJson(); + /** + * + * + * 
      +   * An arbitrary serialized JSON string that contains necessary information
+   * that can comprise a user event. When this field is specified, the
+   * user_event field will be ignored. Note: line-delimited JSON is not
+   * supported, a single JSON only.
+   *
      + * + * string raw_json = 5; + * + * @return The bytes for rawJson. + */ + com.google.protobuf.ByteString getRawJsonBytes(); + + public com.google.cloud.retail.v2.CollectUserEventRequest.ConversionRuleCase + getConversionRuleCase(); } diff --git a/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/CompleteQueryRequest.java b/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/CompleteQueryRequest.java index fb47d50837fc..9ea0124b380e 100644 --- a/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/CompleteQueryRequest.java +++ b/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/CompleteQueryRequest.java @@ -334,8 +334,9 @@ public com.google.protobuf.ByteString getLanguageCodesBytes(int index) { * * * 
      -   * The device type context for completion suggestions.
-   * It is useful to apply different suggestions on different device types, e.g.
+   * The device type context for completion suggestions. We recommend that you
+   * leave this field empty.
+   * It can apply different suggestions on different device types, e.g.
    * `DESKTOP`, `MOBILE`. If it is empty, the suggestions are across all device
    * types.
    * Supported formats:
@@ -365,8 +366,9 @@ public java.lang.String getDeviceType() {
    *
    *
    * 
      -   * The device type context for completion suggestions.
-   * It is useful to apply different suggestions on different device types, e.g.
+   * The device type context for completion suggestions. We recommend that you
+   * leave this field empty.
+   * It can apply different suggestions on different device types, e.g.
    * `DESKTOP`, `MOBILE`. If it is empty, the suggestions are across all device
    * types.
    * Supported formats:
@@ -1568,8 +1570,9 @@ public Builder addLanguageCodesBytes(com.google.protobuf.ByteString value) {
      *
      *
      * 
      -     * The device type context for completion suggestions.
-     * It is useful to apply different suggestions on different device types, e.g.
+     * The device type context for completion suggestions. We recommend that you
+     * leave this field empty.
+     * It can apply different suggestions on different device types, e.g.
      * `DESKTOP`, `MOBILE`. If it is empty, the suggestions are across all device
      * types.
      * Supported formats:
@@ -1598,8 +1601,9 @@ public java.lang.String getDeviceType() {
      *
      *
      * 
      -     * The device type context for completion suggestions.
-     * It is useful to apply different suggestions on different device types, e.g.
+     * The device type context for completion suggestions. We recommend that you
+     * leave this field empty.
+     * It can apply different suggestions on different device types, e.g.
      * `DESKTOP`, `MOBILE`. If it is empty, the suggestions are across all device
      * types.
      * Supported formats:
@@ -1628,8 +1632,9 @@ public com.google.protobuf.ByteString getDeviceTypeBytes() {
      *
      *
      * 
      -     * The device type context for completion suggestions.
-     * It is useful to apply different suggestions on different device types, e.g.
+     * The device type context for completion suggestions. We recommend that you
+     * leave this field empty.
+     * It can apply different suggestions on different device types, e.g.
      * `DESKTOP`, `MOBILE`. If it is empty, the suggestions are across all device
      * types.
      * Supported formats:
@@ -1657,8 +1662,9 @@ public Builder setDeviceType(java.lang.String value) {
      *
      *
      * 
      -     * The device type context for completion suggestions.
-     * It is useful to apply different suggestions on different device types, e.g.
+     * The device type context for completion suggestions. We recommend that you
+     * leave this field empty.
+     * It can apply different suggestions on different device types, e.g.
      * `DESKTOP`, `MOBILE`. If it is empty, the suggestions are across all device
      * types.
      * Supported formats:
@@ -1682,8 +1688,9 @@ public Builder clearDeviceType() {
      *
      *
      * 
      -     * The device type context for completion suggestions.
-     * It is useful to apply different suggestions on different device types, e.g.
+     * The device type context for completion suggestions. We recommend that you
+     * leave this field empty.
+     * It can apply different suggestions on different device types, e.g.
      * `DESKTOP`, `MOBILE`. If it is empty, the suggestions are across all device
      * types.
      * Supported formats:
diff --git a/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/CompleteQueryRequestOrBuilder.java b/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/CompleteQueryRequestOrBuilder.java
index 3ed3df694913..3ef447d4e23c 100644
--- a/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/CompleteQueryRequestOrBuilder.java
+++ b/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/CompleteQueryRequestOrBuilder.java
@@ -201,8 +201,9 @@ public interface CompleteQueryRequestOrBuilder
    *
    *
    * 
      -   * The device type context for completion suggestions.
-   * It is useful to apply different suggestions on different device types, e.g.
+   * The device type context for completion suggestions. We recommend that you
+   * leave this field empty.
+   * It can apply different suggestions on different device types, e.g.
    * `DESKTOP`, `MOBILE`. If it is empty, the suggestions are across all device
    * types.
    * Supported formats:
@@ -221,8 +222,9 @@ public interface CompleteQueryRequestOrBuilder
    *
    *
    * 
      -   * The device type context for completion suggestions.
-   * It is useful to apply different suggestions on different device types, e.g.
+   * The device type context for completion suggestions. We recommend that you
+   * leave this field empty.
+   * It can apply different suggestions on different device types, e.g.
    * `DESKTOP`, `MOBILE`. If it is empty, the suggestions are across all device
    * types.
    * Supported formats:
diff --git a/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/Condition.java b/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/Condition.java
index 53cf2262d387..ea8a754b10a2 100644
--- a/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/Condition.java
+++ b/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/Condition.java
@@ -86,8 +86,8 @@ public interface QueryTermOrBuilder
      * Value cannot be empty.
      * Value can have at most 3 terms if specified as a partial match. Each
      * space separated string is considered as one term.
-     * Example) "a b c" is 3 terms and allowed, " a b c d" is 4 terms and not
-     * allowed for partial match.
+     * For example, "a b c" is 3 terms and allowed, but " a b c d" is 4 terms
+     * and not allowed for a partial match.
      * 
      
      *
      * string value = 1;
@@ -103,8 +103,8 @@ public interface QueryTermOrBuilder
      * Value cannot be empty.
      * Value can have at most 3 terms if specified as a partial match. Each
      * space separated string is considered as one term.
-     * Example) "a b c" is 3 terms and allowed, " a b c d" is 4 terms and not
-     * allowed for partial match.
+     * For example, "a b c" is 3 terms and allowed, but " a b c d" is 4 terms
+     * and not allowed for a partial match.
      * 
      
      *
      * string value = 1;
@@ -185,8 +185,8 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
      * Value cannot be empty.
      * Value can have at most 3 terms if specified as a partial match. Each
      * space separated string is considered as one term.
-     * Example) "a b c" is 3 terms and allowed, " a b c d" is 4 terms and not
-     * allowed for partial match.
+     * For example, "a b c" is 3 terms and allowed, but " a b c d" is 4 terms
+     * and not allowed for a partial match.
      * 
      
      *
      * string value = 1;
@@ -213,8 +213,8 @@ public java.lang.String getValue() {
      * Value cannot be empty.
      * Value can have at most 3 terms if specified as a partial match. Each
      * space separated string is considered as one term.
-     * Example) "a b c" is 3 terms and allowed, " a b c d" is 4 terms and not
-     * allowed for partial match.
+     * For example, "a b c" is 3 terms and allowed, but " a b c d" is 4 terms
+     * and not allowed for a partial match.
      * 
      
      *
      * string value = 1;
@@ -616,8 +616,8 @@ public Builder mergeFrom(
        * Value cannot be empty.
        * Value can have at most 3 terms if specified as a partial match. Each
        * space separated string is considered as one term.
-       * Example) "a b c" is 3 terms and allowed, " a b c d" is 4 terms and not
-       * allowed for partial match.
+       * For example, "a b c" is 3 terms and allowed, but " a b c d" is 4 terms
+       * and not allowed for a partial match.
        * 
      
        *
        * string value = 1;
@@ -643,8 +643,8 @@ public java.lang.String getValue() {
        * Value cannot be empty.
        * Value can have at most 3 terms if specified as a partial match. Each
        * space separated string is considered as one term.
-       * Example) "a b c" is 3 terms and allowed, " a b c d" is 4 terms and not
-       * allowed for partial match.
+       * For example, "a b c" is 3 terms and allowed, but " a b c d" is 4 terms
+       * and not allowed for a partial match.
        * 
      
        *
        * string value = 1;
@@ -670,8 +670,8 @@ public com.google.protobuf.ByteString getValueBytes() {
        * Value cannot be empty.
        * Value can have at most 3 terms if specified as a partial match. Each
        * space separated string is considered as one term.
-       * Example) "a b c" is 3 terms and allowed, " a b c d" is 4 terms and not
-       * allowed for partial match.
+       * For example, "a b c" is 3 terms and allowed, but " a b c d" is 4 terms
+       * and not allowed for a partial match.
        * 
      
        *
        * string value = 1;
@@ -696,8 +696,8 @@ public Builder setValue(java.lang.String value) {
        * Value cannot be empty.
        * Value can have at most 3 terms if specified as a partial match. Each
        * space separated string is considered as one term.
-       * Example) "a b c" is 3 terms and allowed, " a b c d" is 4 terms and not
-       * allowed for partial match.
+       * For example, "a b c" is 3 terms and allowed, but " a b c d" is 4 terms
+       * and not allowed for a partial match.
        * 
      
        *
        * string value = 1;
@@ -718,8 +718,8 @@ public Builder clearValue() {
        * Value cannot be empty.
        * Value can have at most 3 terms if specified as a partial match. Each
        * space separated string is considered as one term.
-       * Example) "a b c" is 3 terms and allowed, " a b c d" is 4 terms and not
-       * allowed for partial match.
+       * For example, "a b c" is 3 terms and allowed, but " a b c d" is 4 terms
+       * and not allowed for a partial match.
        *
      * * string value = 1; diff --git a/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/Control.java b/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/Control.java index 7556538e1729..718b74e0f10a 100644 --- a/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/Control.java +++ b/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/Control.java @@ -284,9 +284,8 @@ public com.google.protobuf.ByteString getDisplayNameBytes() { * * * 
      -   * Output only. List of [serving
-   * configuration][google.cloud.retail.v2.ServingConfig] ids that are
-   * associated with this control in the same
+   * Output only. List of [serving config][google.cloud.retail.v2.ServingConfig]
+   * ids that are associated with this control in the same
    * [Catalog][google.cloud.retail.v2.Catalog].
    * Note the association is managed via the
    * [ServingConfig][google.cloud.retail.v2.ServingConfig], this is an output
@@ -306,9 +305,8 @@ public com.google.protobuf.ProtocolStringList getAssociatedServingConfigIdsList(
    *
    *
    * 
      -   * Output only. List of [serving
-   * configuration][google.cloud.retail.v2.ServingConfig] ids that are
-   * associated with this control in the same
+   * Output only. List of [serving config][google.cloud.retail.v2.ServingConfig]
+   * ids that are associated with this control in the same
    * [Catalog][google.cloud.retail.v2.Catalog].
    * Note the association is managed via the
    * [ServingConfig][google.cloud.retail.v2.ServingConfig], this is an output
@@ -328,9 +326,8 @@ public int getAssociatedServingConfigIdsCount() {
    *
    *
    * 
      -   * Output only. List of [serving
-   * configuration][google.cloud.retail.v2.ServingConfig] ids that are
-   * associated with this control in the same
+   * Output only. List of [serving config][google.cloud.retail.v2.ServingConfig]
+   * ids that are associated with this control in the same
    * [Catalog][google.cloud.retail.v2.Catalog].
    * Note the association is managed via the
    * [ServingConfig][google.cloud.retail.v2.ServingConfig], this is an output
@@ -351,9 +348,8 @@ public java.lang.String getAssociatedServingConfigIds(int index) {
    *
    *
    * 
      -   * Output only. List of [serving
-   * configuration][google.cloud.retail.v2.ServingConfig] ids that are
-   * associated with this control in the same
+   * Output only. List of [serving config][google.cloud.retail.v2.ServingConfig]
+   * ids that are associated with this control in the same
    * [Catalog][google.cloud.retail.v2.Catalog].
    * Note the association is managed via the
    * [ServingConfig][google.cloud.retail.v2.ServingConfig], this is an output
@@ -1683,9 +1679,8 @@ private void ensureAssociatedServingConfigIdsIsMutable() {
      *
      *
      * 
      -     * Output only. List of [serving
-     * configuration][google.cloud.retail.v2.ServingConfig] ids that are
-     * associated with this control in the same
+     * Output only. List of [serving config][google.cloud.retail.v2.ServingConfig]
+     * ids that are associated with this control in the same
      * [Catalog][google.cloud.retail.v2.Catalog].
      * Note the association is managed via the
      * [ServingConfig][google.cloud.retail.v2.ServingConfig], this is an output
@@ -1705,9 +1700,8 @@ public com.google.protobuf.ProtocolStringList getAssociatedServingConfigIdsList(
      *
      *
      * 
      -     * Output only. List of [serving
-     * configuration][google.cloud.retail.v2.ServingConfig] ids that are
-     * associated with this control in the same
+     * Output only. List of [serving config][google.cloud.retail.v2.ServingConfig]
+     * ids that are associated with this control in the same
      * [Catalog][google.cloud.retail.v2.Catalog].
      * Note the association is managed via the
      * [ServingConfig][google.cloud.retail.v2.ServingConfig], this is an output
@@ -1727,9 +1721,8 @@ public int getAssociatedServingConfigIdsCount() {
      *
      *
      * 
      -     * Output only. List of [serving
-     * configuration][google.cloud.retail.v2.ServingConfig] ids that are
-     * associated with this control in the same
+     * Output only. List of [serving config][google.cloud.retail.v2.ServingConfig]
+     * ids that are associated with this control in the same
      * [Catalog][google.cloud.retail.v2.Catalog].
      * Note the association is managed via the
      * [ServingConfig][google.cloud.retail.v2.ServingConfig], this is an output
@@ -1750,9 +1743,8 @@ public java.lang.String getAssociatedServingConfigIds(int index) {
      *
      *
      * 
      -     * Output only. List of [serving
-     * configuration][google.cloud.retail.v2.ServingConfig] ids that are
-     * associated with this control in the same
+     * Output only. List of [serving config][google.cloud.retail.v2.ServingConfig]
+     * ids that are associated with this control in the same
      * [Catalog][google.cloud.retail.v2.Catalog].
      * Note the association is managed via the
      * [ServingConfig][google.cloud.retail.v2.ServingConfig], this is an output
@@ -1773,9 +1765,8 @@ public com.google.protobuf.ByteString getAssociatedServingConfigIdsBytes(int ind
      *
      *
      * 
      -     * Output only. List of [serving
-     * configuration][google.cloud.retail.v2.ServingConfig] ids that are
-     * associated with this control in the same
+     * Output only. List of [serving config][google.cloud.retail.v2.ServingConfig]
+     * ids that are associated with this control in the same
      * [Catalog][google.cloud.retail.v2.Catalog].
      * Note the association is managed via the
      * [ServingConfig][google.cloud.retail.v2.ServingConfig], this is an output
@@ -1803,9 +1794,8 @@ public Builder setAssociatedServingConfigIds(int index, java.lang.String value)
      *
      *
      * 
      -     * Output only. List of [serving
-     * configuration][google.cloud.retail.v2.ServingConfig] ids that are
-     * associated with this control in the same
+     * Output only. List of [serving config][google.cloud.retail.v2.ServingConfig]
+     * ids that are associated with this control in the same
      * [Catalog][google.cloud.retail.v2.Catalog].
      * Note the association is managed via the
      * [ServingConfig][google.cloud.retail.v2.ServingConfig], this is an output
@@ -1832,9 +1822,8 @@ public Builder addAssociatedServingConfigIds(java.lang.String value) {
      *
      *
      * 
      -     * Output only. List of [serving
-     * configuration][google.cloud.retail.v2.ServingConfig] ids that are
-     * associated with this control in the same
+     * Output only. List of [serving config][google.cloud.retail.v2.ServingConfig]
+     * ids that are associated with this control in the same
      * [Catalog][google.cloud.retail.v2.Catalog].
      * Note the association is managed via the
      * [ServingConfig][google.cloud.retail.v2.ServingConfig], this is an output
@@ -1858,9 +1847,8 @@ public Builder addAllAssociatedServingConfigIds(java.lang.Iterable
-     * Output only. List of [serving
-     * configuration][google.cloud.retail.v2.ServingConfig] ids that are
-     * associated with this control in the same
+     * Output only. List of [serving config][google.cloud.retail.v2.ServingConfig]
+     * ids that are associated with this control in the same
      * [Catalog][google.cloud.retail.v2.Catalog].
      * Note the association is managed via the
      * [ServingConfig][google.cloud.retail.v2.ServingConfig], this is an output
@@ -1883,9 +1871,8 @@ public Builder clearAssociatedServingConfigIds() {
      *
      *
      * 
      -     * Output only. List of [serving
-     * configuration][google.cloud.retail.v2.ServingConfig] ids that are
-     * associated with this control in the same
+     * Output only. List of [serving config][google.cloud.retail.v2.ServingConfig]
+     * ids that are associated with this control in the same
      * [Catalog][google.cloud.retail.v2.Catalog].
      * Note the association is managed via the
      * [ServingConfig][google.cloud.retail.v2.ServingConfig], this is an output
diff --git a/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/ControlOrBuilder.java b/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/ControlOrBuilder.java
index 2c41fa2f5e8e..5ede9dacbd98 100644
--- a/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/ControlOrBuilder.java
+++ b/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/ControlOrBuilder.java
@@ -124,9 +124,8 @@ public interface ControlOrBuilder
    *
    *
    * 
      -   * Output only. List of [serving
-   * configuration][google.cloud.retail.v2.ServingConfig] ids that are
-   * associated with this control in the same
+   * Output only. List of [serving config][google.cloud.retail.v2.ServingConfig]
+   * ids that are associated with this control in the same
    * [Catalog][google.cloud.retail.v2.Catalog].
    * Note the association is managed via the
    * [ServingConfig][google.cloud.retail.v2.ServingConfig], this is an output
@@ -144,9 +143,8 @@ public interface ControlOrBuilder
    *
    *
    * 
      -   * Output only. List of [serving
-   * configuration][google.cloud.retail.v2.ServingConfig] ids that are
-   * associated with this control in the same
+   * Output only. List of [serving config][google.cloud.retail.v2.ServingConfig]
+   * ids that are associated with this control in the same
    * [Catalog][google.cloud.retail.v2.Catalog].
    * Note the association is managed via the
    * [ServingConfig][google.cloud.retail.v2.ServingConfig], this is an output
@@ -164,9 +162,8 @@ public interface ControlOrBuilder
    *
    *
    * 
      -   * Output only. List of [serving
-   * configuration][google.cloud.retail.v2.ServingConfig] ids that are
-   * associated with this control in the same
+   * Output only. List of [serving config][google.cloud.retail.v2.ServingConfig]
+   * ids that are associated with this control in the same
    * [Catalog][google.cloud.retail.v2.Catalog].
    * Note the association is managed via the
    * [ServingConfig][google.cloud.retail.v2.ServingConfig], this is an output
@@ -185,9 +182,8 @@ public interface ControlOrBuilder
    *
    *
    * 
      -   * Output only. List of [serving
-   * configuration][google.cloud.retail.v2.ServingConfig] ids that are
-   * associated with this control in the same
+   * Output only. List of [serving config][google.cloud.retail.v2.ServingConfig]
+   * ids that are associated with this control in the same
    * [Catalog][google.cloud.retail.v2.Catalog].
    * Note the association is managed via the
    * [ServingConfig][google.cloud.retail.v2.ServingConfig], this is an output
diff --git a/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/CustomAttribute.java b/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/CustomAttribute.java
index 8eed345009fd..98219170f7c8 100644
--- a/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/CustomAttribute.java
+++ b/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/CustomAttribute.java
@@ -238,7 +238,7 @@ public double getNumbers(int index) {
    * optional bool searchable = 3 [deprecated = true];
    *
    * @deprecated google.cloud.retail.v2.CustomAttribute.searchable is deprecated. See
-   *     google/cloud/retail/v2/common.proto;l=407
+   *     google/cloud/retail/v2/common.proto;l=409
    * @return Whether the searchable field is set.
    */
   @java.lang.Override
@@ -266,7 +266,7 @@ public boolean hasSearchable() {
    * optional bool searchable = 3 [deprecated = true];
    *
    * @deprecated google.cloud.retail.v2.CustomAttribute.searchable is deprecated. See
-   *     google/cloud/retail/v2/common.proto;l=407
+   *     google/cloud/retail/v2/common.proto;l=409
    * @return The searchable.
    */
   @java.lang.Override
@@ -301,7 +301,7 @@ public boolean getSearchable() {
    * optional bool indexable = 4 [deprecated = true];
    *
    * @deprecated google.cloud.retail.v2.CustomAttribute.indexable is deprecated. See
-   *     google/cloud/retail/v2/common.proto;l=426
+   *     google/cloud/retail/v2/common.proto;l=428
    * @return Whether the indexable field is set.
    */
   @java.lang.Override
@@ -333,7 +333,7 @@ public boolean hasIndexable() {
    * optional bool indexable = 4 [deprecated = true];
    *
    * @deprecated google.cloud.retail.v2.CustomAttribute.indexable is deprecated. See
-   *     google/cloud/retail/v2/common.proto;l=426
+   *     google/cloud/retail/v2/common.proto;l=428
    * @return The indexable.
    */
   @java.lang.Override
@@ -1208,7 +1208,7 @@ public Builder clearNumbers() {
      * optional bool searchable = 3 [deprecated = true];
      *
      * @deprecated google.cloud.retail.v2.CustomAttribute.searchable is deprecated. See
-     *     google/cloud/retail/v2/common.proto;l=407
+     *     google/cloud/retail/v2/common.proto;l=409
      * @return Whether the searchable field is set.
      */
     @java.lang.Override
@@ -1236,7 +1236,7 @@ public boolean hasSearchable() {
      * optional bool searchable = 3 [deprecated = true];
      *
      * @deprecated google.cloud.retail.v2.CustomAttribute.searchable is deprecated. See
-     *     google/cloud/retail/v2/common.proto;l=407
+     *     google/cloud/retail/v2/common.proto;l=409
      * @return The searchable.
      */
     @java.lang.Override
@@ -1264,7 +1264,7 @@ public boolean getSearchable() {
      * optional bool searchable = 3 [deprecated = true];
      *
      * @deprecated google.cloud.retail.v2.CustomAttribute.searchable is deprecated. See
-     *     google/cloud/retail/v2/common.proto;l=407
+     *     google/cloud/retail/v2/common.proto;l=409
      * @param value The searchable to set.
      * @return This builder for chaining.
      */
@@ -1295,7 +1295,7 @@ public Builder setSearchable(boolean value) {
      * optional bool searchable = 3 [deprecated = true];
      *
      * @deprecated google.cloud.retail.v2.CustomAttribute.searchable is deprecated. See
-     *     google/cloud/retail/v2/common.proto;l=407
+     *     google/cloud/retail/v2/common.proto;l=409
      * @return This builder for chaining.
      */
     @java.lang.Deprecated
@@ -1331,7 +1331,7 @@ public Builder clearSearchable() {
      * optional bool indexable = 4 [deprecated = true];
      *
      * @deprecated google.cloud.retail.v2.CustomAttribute.indexable is deprecated. See
-     *     google/cloud/retail/v2/common.proto;l=426
+     *     google/cloud/retail/v2/common.proto;l=428
      * @return Whether the indexable field is set.
      */
     @java.lang.Override
@@ -1363,7 +1363,7 @@ public boolean hasIndexable() {
      * optional bool indexable = 4 [deprecated = true];
      *
      * @deprecated google.cloud.retail.v2.CustomAttribute.indexable is deprecated. See
-     *     google/cloud/retail/v2/common.proto;l=426
+     *     google/cloud/retail/v2/common.proto;l=428
      * @return The indexable.
      */
     @java.lang.Override
@@ -1395,7 +1395,7 @@ public boolean getIndexable() {
      * optional bool indexable = 4 [deprecated = true];
      *
      * @deprecated google.cloud.retail.v2.CustomAttribute.indexable is deprecated. See
-     *     google/cloud/retail/v2/common.proto;l=426
+     *     google/cloud/retail/v2/common.proto;l=428
      * @param value The indexable to set.
      * @return This builder for chaining.
      */
@@ -1430,7 +1430,7 @@ public Builder setIndexable(boolean value) {
      * optional bool indexable = 4 [deprecated = true];
      *
      * @deprecated google.cloud.retail.v2.CustomAttribute.indexable is deprecated. See
-     *     google/cloud/retail/v2/common.proto;l=426
+     *     google/cloud/retail/v2/common.proto;l=428
      * @return This builder for chaining.
      */
     @java.lang.Deprecated
diff --git a/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/CustomAttributeOrBuilder.java b/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/CustomAttributeOrBuilder.java
index 493aa90b07ff..82203f2a64a4 100644
--- a/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/CustomAttributeOrBuilder.java
+++ b/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/CustomAttributeOrBuilder.java
@@ -168,7 +168,7 @@ public interface CustomAttributeOrBuilder
    * optional bool searchable = 3 [deprecated = true];
    *
    * @deprecated google.cloud.retail.v2.CustomAttribute.searchable is deprecated. See
-   *     google/cloud/retail/v2/common.proto;l=407
+   *     google/cloud/retail/v2/common.proto;l=409
    * @return Whether the searchable field is set.
    */
   @java.lang.Deprecated
@@ -193,7 +193,7 @@ public interface CustomAttributeOrBuilder
    * optional bool searchable = 3 [deprecated = true];
    *
    * @deprecated google.cloud.retail.v2.CustomAttribute.searchable is deprecated. See
-   *     google/cloud/retail/v2/common.proto;l=407
+   *     google/cloud/retail/v2/common.proto;l=409
    * @return The searchable.
    */
   @java.lang.Deprecated
@@ -223,7 +223,7 @@ public interface CustomAttributeOrBuilder
    * optional bool indexable = 4 [deprecated = true];
    *
    * @deprecated google.cloud.retail.v2.CustomAttribute.indexable is deprecated. See
-   *     google/cloud/retail/v2/common.proto;l=426
+   *     google/cloud/retail/v2/common.proto;l=428
    * @return Whether the indexable field is set.
    */
   @java.lang.Deprecated
@@ -252,7 +252,7 @@ public interface CustomAttributeOrBuilder
    * optional bool indexable = 4 [deprecated = true];
    *
    * @deprecated google.cloud.retail.v2.CustomAttribute.indexable is deprecated. See
-   *     google/cloud/retail/v2/common.proto;l=426
+   *     google/cloud/retail/v2/common.proto;l=428
    * @return The indexable.
    */
   @java.lang.Deprecated
diff --git a/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/DeleteServingConfigRequest.java b/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/DeleteServingConfigRequest.java
index ffe8658d13ad..5c113f15937f 100644
--- a/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/DeleteServingConfigRequest.java
+++ b/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/DeleteServingConfigRequest.java
@@ -74,7 +74,7 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    *
    * 
          * Required. The resource name of the ServingConfig to delete. Format:
-   * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+   * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
    * 
      
    *
    * 
@@ -100,7 +100,7 @@ public java.lang.String getName() {
    *
    * 
          * Required. The resource name of the ServingConfig to delete. Format:
-   * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+   * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
    * 
      
    *
    * 
@@ -459,7 +459,7 @@ public Builder mergeFrom(
      *
      * 
            * Required. The resource name of the ServingConfig to delete. Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
      * 
      
      *
      * 
@@ -484,7 +484,7 @@ public java.lang.String getName() {
      *
      * 
            * Required. The resource name of the ServingConfig to delete. Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
      * 
      
      *
      * 
@@ -509,7 +509,7 @@ public com.google.protobuf.ByteString getNameBytes() {
      *
      * 
            * Required. The resource name of the ServingConfig to delete. Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
      * 
      
      *
      * 
@@ -533,7 +533,7 @@ public Builder setName(java.lang.String value) {
      *
      * 
            * Required. The resource name of the ServingConfig to delete. Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
      * 
      
      *
      * 
@@ -553,7 +553,7 @@ public Builder clearName() {
      *
      * 
            * Required. The resource name of the ServingConfig to delete. Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
      * 
      
      *
      * 
diff --git a/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/DeleteServingConfigRequestOrBuilder.java b/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/DeleteServingConfigRequestOrBuilder.java
index 4cd7b1793a23..80b5c6ae9496 100644
--- a/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/DeleteServingConfigRequestOrBuilder.java
+++ b/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/DeleteServingConfigRequestOrBuilder.java
@@ -28,7 +28,7 @@ public interface DeleteServingConfigRequestOrBuilder
    *
    * 
          * Required. The resource name of the ServingConfig to delete. Format:
-   * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+   * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
    * 
      
    *
    * 
@@ -43,7 +43,7 @@ public interface DeleteServingConfigRequestOrBuilder
    *
    * 
          * Required. The resource name of the ServingConfig to delete. Format:
-   * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+   * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
    * 
      
    *
    * 
diff --git a/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/GetCompletionConfigRequest.java b/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/GetCompletionConfigRequest.java
index f4f21e0206bd..cad63f62092c 100644
--- a/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/GetCompletionConfigRequest.java
+++ b/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/GetCompletionConfigRequest.java
@@ -76,7 +76,7 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    *
    * 
          * 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`
    * 
      
    *
    * 
@@ -102,7 +102,7 @@ public java.lang.String getName() {
    *
    * 
          * 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`
    * 
      
    *
    * 
@@ -463,7 +463,7 @@ public Builder mergeFrom(
      *
      * 
            * 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`
      * 
      
      *
      * 
@@ -488,7 +488,7 @@ public java.lang.String getName() {
      *
      * 
            * 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`
      * 
      
      *
      * 
@@ -513,7 +513,7 @@ public com.google.protobuf.ByteString getNameBytes() {
      *
      * 
            * 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`
      * 
      
      *
      * 
@@ -537,7 +537,7 @@ public Builder setName(java.lang.String value) {
      *
      * 
            * 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`
      * 
      
      *
      * 
@@ -557,7 +557,7 @@ public Builder clearName() {
      *
      * 
            * 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`
      * 
      
      *
      * 
diff --git a/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/GetCompletionConfigRequestOrBuilder.java b/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/GetCompletionConfigRequestOrBuilder.java
index 55f2df10fd4b..ba4219d9b9b1 100644
--- a/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/GetCompletionConfigRequestOrBuilder.java
+++ b/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/GetCompletionConfigRequestOrBuilder.java
@@ -28,7 +28,7 @@ public interface GetCompletionConfigRequestOrBuilder
    *
    * 
          * 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`
    * 
      
    *
    * 
@@ -43,7 +43,7 @@ public interface GetCompletionConfigRequestOrBuilder
    *
    * 
          * 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`
    * 
      
    *
    * 
diff --git a/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/GetServingConfigRequest.java b/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/GetServingConfigRequest.java
index 2ad371051255..7d76d0cf9932 100644
--- a/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/GetServingConfigRequest.java
+++ b/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/GetServingConfigRequest.java
@@ -74,7 +74,7 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    *
    * 
          * Required. The resource name of the ServingConfig to get. Format:
-   * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+   * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
    * 
      
    *
    * 
@@ -100,7 +100,7 @@ public java.lang.String getName() {
    *
    * 
          * Required. The resource name of the ServingConfig to get. Format:
-   * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+   * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
    * 
      
    *
    * 
@@ -458,7 +458,7 @@ public Builder mergeFrom(
      *
      * 
            * Required. The resource name of the ServingConfig to get. Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
      * 
      
      *
      * 
@@ -483,7 +483,7 @@ public java.lang.String getName() {
      *
      * 
            * Required. The resource name of the ServingConfig to get. Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
      * 
      
      *
      * 
@@ -508,7 +508,7 @@ public com.google.protobuf.ByteString getNameBytes() {
      *
      * 
            * Required. The resource name of the ServingConfig to get. Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
      * 
      
      *
      * 
@@ -532,7 +532,7 @@ public Builder setName(java.lang.String value) {
      *
      * 
            * Required. The resource name of the ServingConfig to get. Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
      * 
      
      *
      * 
@@ -552,7 +552,7 @@ public Builder clearName() {
      *
      * 
            * Required. The resource name of the ServingConfig to get. Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
      * 
      
      *
      * 
diff --git a/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/GetServingConfigRequestOrBuilder.java b/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/GetServingConfigRequestOrBuilder.java
index c1661e411e81..7f95846bbfa3 100644
--- a/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/GetServingConfigRequestOrBuilder.java
+++ b/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/GetServingConfigRequestOrBuilder.java
@@ -28,7 +28,7 @@ public interface GetServingConfigRequestOrBuilder
    *
    * 
          * Required. The resource name of the ServingConfig to get. Format:
-   * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+   * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
    * 
      
    *
    * 
@@ -43,7 +43,7 @@ public interface GetServingConfigRequestOrBuilder
    *
    * 
          * Required. The resource name of the ServingConfig to get. Format:
-   * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+   * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
    * 
      
    *
    * 
diff --git a/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/ListServingConfigsRequest.java b/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/ListServingConfigsRequest.java
index 9334ba6dde58..c229bf6a9064 100644
--- a/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/ListServingConfigsRequest.java
+++ b/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/ListServingConfigsRequest.java
@@ -75,7 +75,7 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    *
    * 
          * Required. The catalog resource name. Format:
-   * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}
+   * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}`
    * 
      
    *
    * 
@@ -101,7 +101,7 @@ public java.lang.String getParent() {
    *
    * 
          * Required. The catalog resource name. Format:
-   * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}
+   * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}`
    * 
      
    *
    * 
@@ -573,7 +573,7 @@ public Builder mergeFrom(
      *
      * 
            * Required. The catalog resource name. Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}`
      * 
      
      *
      * 
@@ -598,7 +598,7 @@ public java.lang.String getParent() {
      *
      * 
            * Required. The catalog resource name. Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}`
      * 
      
      *
      * 
@@ -623,7 +623,7 @@ public com.google.protobuf.ByteString getParentBytes() {
      *
      * 
            * Required. The catalog resource name. Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}`
      * 
      
      *
      * 
@@ -647,7 +647,7 @@ public Builder setParent(java.lang.String value) {
      *
      * 
            * Required. The catalog resource name. Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}`
      * 
      
      *
      * 
@@ -667,7 +667,7 @@ public Builder clearParent() {
      *
      * 
            * Required. The catalog resource name. Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}`
      * 
      
      *
      * 
diff --git a/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/ListServingConfigsRequestOrBuilder.java b/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/ListServingConfigsRequestOrBuilder.java
index 5465fa3b0af6..5ed2240ffbd8 100644
--- a/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/ListServingConfigsRequestOrBuilder.java
+++ b/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/ListServingConfigsRequestOrBuilder.java
@@ -28,7 +28,7 @@ public interface ListServingConfigsRequestOrBuilder
    *
    * 
          * Required. The catalog resource name. Format:
-   * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}
+   * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}`
    * 
      
    *
    * 
@@ -43,7 +43,7 @@ public interface ListServingConfigsRequestOrBuilder
    *
    * 
          * Required. The catalog resource name. Format:
-   * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}
+   * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}`
    * 
      
    *
    * 
diff --git a/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/PredictRequest.java b/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/PredictRequest.java
index 30369f0b31a1..79b0e523658f 100644
--- a/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/PredictRequest.java
+++ b/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/PredictRequest.java
@@ -97,7 +97,7 @@ protected com.google.protobuf.MapField internalGetMapField(int number) {
    * The ID of the Recommendations AI serving config or placement.
    * Before you can request predictions from your model, you must create at
    * least one serving config or placement for it. For more information, see
-   * [Managing serving configurations]
+   * [Manage serving configs]
    * (https://cloud.google.com/retail/docs/manage-configs).
    * The full list of available serving configs can be seen at
    * https://console.cloud.google.com/ai/retail/catalogs/default_catalog/configs
@@ -132,7 +132,7 @@ public java.lang.String getPlacement() {
    * The ID of the Recommendations AI serving config or placement.
    * Before you can request predictions from your model, you must create at
    * least one serving config or placement for it. For more information, see
-   * [Managing serving configurations]
+   * [Manage serving configs]
    * (https://cloud.google.com/retail/docs/manage-configs).
    * The full list of available serving configs can be seen at
    * https://console.cloud.google.com/ai/retail/catalogs/default_catalog/configs
@@ -278,7 +278,7 @@ public int getPageSize() {
    * string page_token = 4 [deprecated = true];
    *
    * @deprecated google.cloud.retail.v2.PredictRequest.page_token is deprecated. See
-   *     google/cloud/retail/v2/prediction_service.proto;l=93
+   *     google/cloud/retail/v2/prediction_service.proto;l=94
    * @return The pageToken.
    */
   @java.lang.Override
@@ -304,7 +304,7 @@ public java.lang.String getPageToken() {
    * string page_token = 4 [deprecated = true];
    *
    * @deprecated google.cloud.retail.v2.PredictRequest.page_token is deprecated. See
-   *     google/cloud/retail/v2/prediction_service.proto;l=93
+   *     google/cloud/retail/v2/prediction_service.proto;l=94
    * @return The bytes for pageToken.
    */
   @java.lang.Override
@@ -344,12 +344,11 @@ public com.google.protobuf.ByteString getPageTokenBytes() {
    *  * tag=("Red" OR "Blue") tag="New-Arrival" tag=(NOT "promotional")
    *  * filterOutOfStockItems  tag=(-"promotional")
    *  * filterOutOfStockItems
-   * If your filter blocks all prediction results, the API will return generic
-   * (unfiltered) popular products. If you only want results strictly matching
-   * the filters, set `strictFiltering` to True in `PredictRequest.params` to
-   * receive empty results instead.
-   * Note that the API will never return items with storageStatus of "EXPIRED"
-   * or "DELETED" regardless of filter choices.
+   * If your filter blocks all prediction results, the API will return *no*
+   * results. If instead you want empty result sets to return generic
+   * (unfiltered) popular products, set `strictFiltering` to False in
+   * `PredictRequest.params`. Note that the API will never return items with
+   * storageStatus of "EXPIRED" or "DELETED" regardless of filter choices.
    * If `filterSyntaxV2` is set to true under the `params` field, then
    * attribute-based expressions are expected instead of the above described
    * tag-based syntax. Examples:
@@ -395,12 +394,11 @@ public java.lang.String getFilter() {
    *  * tag=("Red" OR "Blue") tag="New-Arrival" tag=(NOT "promotional")
    *  * filterOutOfStockItems  tag=(-"promotional")
    *  * filterOutOfStockItems
-   * If your filter blocks all prediction results, the API will return generic
-   * (unfiltered) popular products. If you only want results strictly matching
-   * the filters, set `strictFiltering` to True in `PredictRequest.params` to
-   * receive empty results instead.
-   * Note that the API will never return items with storageStatus of "EXPIRED"
-   * or "DELETED" regardless of filter choices.
+   * If your filter blocks all prediction results, the API will return *no*
+   * results. If instead you want empty result sets to return generic
+   * (unfiltered) popular products, set `strictFiltering` to False in
+   * `PredictRequest.params`. Note that the API will never return items with
+   * storageStatus of "EXPIRED" or "DELETED" regardless of filter choices.
    * If `filterSyntaxV2` is set to true under the `params` field, then
    * attribute-based expressions are expected instead of the above described
    * tag-based syntax. Examples:
@@ -487,7 +485,7 @@ public int getParamsCount() {
    * * `returnScore`: Boolean. If set to true, the prediction 'score'
    *    corresponding to each returned product will be set in the
    *    `results.metadata` field in the prediction response. The given
-   *    'score' indicates the probability of an product being clicked/purchased
+   *    'score' indicates the probability of a product being clicked/purchased
    *    given the user's context and history.
    * * `strictFiltering`: Boolean. True by default. If set to false, the service
    *    will return generic (unfiltered) popular products instead of empty if
@@ -533,7 +531,7 @@ public java.util.Map getParams() {
    * * `returnScore`: Boolean. If set to true, the prediction 'score'
    *    corresponding to each returned product will be set in the
    *    `results.metadata` field in the prediction response. The given
-   *    'score' indicates the probability of an product being clicked/purchased
+   *    'score' indicates the probability of a product being clicked/purchased
    *    given the user's context and history.
    * * `strictFiltering`: Boolean. True by default. If set to false, the service
    *    will return generic (unfiltered) popular products instead of empty if
@@ -570,7 +568,7 @@ public java.util.Map getParamsMap()
    * * `returnScore`: Boolean. If set to true, the prediction 'score'
    *    corresponding to each returned product will be set in the
    *    `results.metadata` field in the prediction response. The given
-   *    'score' indicates the probability of an product being clicked/purchased
+   *    'score' indicates the probability of a product being clicked/purchased
    *    given the user's context and history.
    * * `strictFiltering`: Boolean. True by default. If set to false, the service
    *    will return generic (unfiltered) popular products instead of empty if
@@ -612,7 +610,7 @@ public com.google.protobuf.Value getParamsOrDefault(
    * * `returnScore`: Boolean. If set to true, the prediction 'score'
    *    corresponding to each returned product will be set in the
    *    `results.metadata` field in the prediction response. The given
-   *    'score' indicates the probability of an product being clicked/purchased
+   *    'score' indicates the probability of a product being clicked/purchased
    *    given the user's context and history.
    * * `strictFiltering`: Boolean. True by default. If set to false, the service
    *    will return generic (unfiltered) popular products instead of empty if
@@ -1353,7 +1351,7 @@ public Builder mergeFrom(
      * The ID of the Recommendations AI serving config or placement.
      * Before you can request predictions from your model, you must create at
      * least one serving config or placement for it. For more information, see
-     * [Managing serving configurations]
+     * [Manage serving configs]
      * (https://cloud.google.com/retail/docs/manage-configs).
      * The full list of available serving configs can be seen at
      * https://console.cloud.google.com/ai/retail/catalogs/default_catalog/configs
@@ -1387,7 +1385,7 @@ public java.lang.String getPlacement() {
      * The ID of the Recommendations AI serving config or placement.
      * Before you can request predictions from your model, you must create at
      * least one serving config or placement for it. For more information, see
-     * [Managing serving configurations]
+     * [Manage serving configs]
      * (https://cloud.google.com/retail/docs/manage-configs).
      * The full list of available serving configs can be seen at
      * https://console.cloud.google.com/ai/retail/catalogs/default_catalog/configs
@@ -1421,7 +1419,7 @@ public com.google.protobuf.ByteString getPlacementBytes() {
      * The ID of the Recommendations AI serving config or placement.
      * Before you can request predictions from your model, you must create at
      * least one serving config or placement for it. For more information, see
-     * [Managing serving configurations]
+     * [Manage serving configs]
      * (https://cloud.google.com/retail/docs/manage-configs).
      * The full list of available serving configs can be seen at
      * https://console.cloud.google.com/ai/retail/catalogs/default_catalog/configs
@@ -1454,7 +1452,7 @@ public Builder setPlacement(java.lang.String value) {
      * The ID of the Recommendations AI serving config or placement.
      * Before you can request predictions from your model, you must create at
      * least one serving config or placement for it. For more information, see
-     * [Managing serving configurations]
+     * [Manage serving configs]
      * (https://cloud.google.com/retail/docs/manage-configs).
      * The full list of available serving configs can be seen at
      * https://console.cloud.google.com/ai/retail/catalogs/default_catalog/configs
@@ -1483,7 +1481,7 @@ public Builder clearPlacement() {
      * The ID of the Recommendations AI serving config or placement.
      * Before you can request predictions from your model, you must create at
      * least one serving config or placement for it. For more information, see
-     * [Managing serving configurations]
+     * [Manage serving configs]
      * (https://cloud.google.com/retail/docs/manage-configs).
      * The full list of available serving configs can be seen at
      * https://console.cloud.google.com/ai/retail/catalogs/default_catalog/configs
@@ -1888,7 +1886,7 @@ public Builder clearPageSize() {
      * string page_token = 4 [deprecated = true];
      *
      * @deprecated google.cloud.retail.v2.PredictRequest.page_token is deprecated. See
-     *     google/cloud/retail/v2/prediction_service.proto;l=93
+     *     google/cloud/retail/v2/prediction_service.proto;l=94
      * @return The pageToken.
      */
     @java.lang.Deprecated
@@ -1913,7 +1911,7 @@ public java.lang.String getPageToken() {
      * string page_token = 4 [deprecated = true];
      *
      * @deprecated google.cloud.retail.v2.PredictRequest.page_token is deprecated. See
-     *     google/cloud/retail/v2/prediction_service.proto;l=93
+     *     google/cloud/retail/v2/prediction_service.proto;l=94
      * @return The bytes for pageToken.
      */
     @java.lang.Deprecated
@@ -1938,7 +1936,7 @@ public com.google.protobuf.ByteString getPageTokenBytes() {
      * string page_token = 4 [deprecated = true];
      *
      * @deprecated google.cloud.retail.v2.PredictRequest.page_token is deprecated. See
-     *     google/cloud/retail/v2/prediction_service.proto;l=93
+     *     google/cloud/retail/v2/prediction_service.proto;l=94
      * @param value The pageToken to set.
      * @return This builder for chaining.
      */
@@ -1962,7 +1960,7 @@ public Builder setPageToken(java.lang.String value) {
      * string page_token = 4 [deprecated = true];
      *
      * @deprecated google.cloud.retail.v2.PredictRequest.page_token is deprecated. See
-     *     google/cloud/retail/v2/prediction_service.proto;l=93
+     *     google/cloud/retail/v2/prediction_service.proto;l=94
      * @return This builder for chaining.
      */
     @java.lang.Deprecated
@@ -1982,7 +1980,7 @@ public Builder clearPageToken() {
      * string page_token = 4 [deprecated = true];
      *
      * @deprecated google.cloud.retail.v2.PredictRequest.page_token is deprecated. See
-     *     google/cloud/retail/v2/prediction_service.proto;l=93
+     *     google/cloud/retail/v2/prediction_service.proto;l=94
      * @param value The bytes for pageToken to set.
      * @return This builder for chaining.
      */
@@ -2020,12 +2018,11 @@ public Builder setPageTokenBytes(com.google.protobuf.ByteString value) {
      *  * tag=("Red" OR "Blue") tag="New-Arrival" tag=(NOT "promotional")
      *  * filterOutOfStockItems  tag=(-"promotional")
      *  * filterOutOfStockItems
-     * If your filter blocks all prediction results, the API will return generic
-     * (unfiltered) popular products. If you only want results strictly matching
-     * the filters, set `strictFiltering` to True in `PredictRequest.params` to
-     * receive empty results instead.
-     * Note that the API will never return items with storageStatus of "EXPIRED"
-     * or "DELETED" regardless of filter choices.
+     * If your filter blocks all prediction results, the API will return *no*
+     * results. If instead you want empty result sets to return generic
+     * (unfiltered) popular products, set `strictFiltering` to False in
+     * `PredictRequest.params`. Note that the API will never return items with
+     * storageStatus of "EXPIRED" or "DELETED" regardless of filter choices.
      * If `filterSyntaxV2` is set to true under the `params` field, then
      * attribute-based expressions are expected instead of the above described
      * tag-based syntax. Examples:
@@ -2070,12 +2067,11 @@ public java.lang.String getFilter() {
      *  * tag=("Red" OR "Blue") tag="New-Arrival" tag=(NOT "promotional")
      *  * filterOutOfStockItems  tag=(-"promotional")
      *  * filterOutOfStockItems
-     * If your filter blocks all prediction results, the API will return generic
-     * (unfiltered) popular products. If you only want results strictly matching
-     * the filters, set `strictFiltering` to True in `PredictRequest.params` to
-     * receive empty results instead.
-     * Note that the API will never return items with storageStatus of "EXPIRED"
-     * or "DELETED" regardless of filter choices.
+     * If your filter blocks all prediction results, the API will return *no*
+     * results. If instead you want empty result sets to return generic
+     * (unfiltered) popular products, set `strictFiltering` to False in
+     * `PredictRequest.params`. Note that the API will never return items with
+     * storageStatus of "EXPIRED" or "DELETED" regardless of filter choices.
      * If `filterSyntaxV2` is set to true under the `params` field, then
      * attribute-based expressions are expected instead of the above described
      * tag-based syntax. Examples:
@@ -2120,12 +2116,11 @@ public com.google.protobuf.ByteString getFilterBytes() {
      *  * tag=("Red" OR "Blue") tag="New-Arrival" tag=(NOT "promotional")
      *  * filterOutOfStockItems  tag=(-"promotional")
      *  * filterOutOfStockItems
-     * If your filter blocks all prediction results, the API will return generic
-     * (unfiltered) popular products. If you only want results strictly matching
-     * the filters, set `strictFiltering` to True in `PredictRequest.params` to
-     * receive empty results instead.
-     * Note that the API will never return items with storageStatus of "EXPIRED"
-     * or "DELETED" regardless of filter choices.
+     * If your filter blocks all prediction results, the API will return *no*
+     * results. If instead you want empty result sets to return generic
+     * (unfiltered) popular products, set `strictFiltering` to False in
+     * `PredictRequest.params`. Note that the API will never return items with
+     * storageStatus of "EXPIRED" or "DELETED" regardless of filter choices.
      * If `filterSyntaxV2` is set to true under the `params` field, then
      * attribute-based expressions are expected instead of the above described
      * tag-based syntax. Examples:
@@ -2169,12 +2164,11 @@ public Builder setFilter(java.lang.String value) {
      *  * tag=("Red" OR "Blue") tag="New-Arrival" tag=(NOT "promotional")
      *  * filterOutOfStockItems  tag=(-"promotional")
      *  * filterOutOfStockItems
-     * If your filter blocks all prediction results, the API will return generic
-     * (unfiltered) popular products. If you only want results strictly matching
-     * the filters, set `strictFiltering` to True in `PredictRequest.params` to
-     * receive empty results instead.
-     * Note that the API will never return items with storageStatus of "EXPIRED"
-     * or "DELETED" regardless of filter choices.
+     * If your filter blocks all prediction results, the API will return *no*
+     * results. If instead you want empty result sets to return generic
+     * (unfiltered) popular products, set `strictFiltering` to False in
+     * `PredictRequest.params`. Note that the API will never return items with
+     * storageStatus of "EXPIRED" or "DELETED" regardless of filter choices.
      * If `filterSyntaxV2` is set to true under the `params` field, then
      * attribute-based expressions are expected instead of the above described
      * tag-based syntax. Examples:
@@ -2214,12 +2208,11 @@ public Builder clearFilter() {
      *  * tag=("Red" OR "Blue") tag="New-Arrival" tag=(NOT "promotional")
      *  * filterOutOfStockItems  tag=(-"promotional")
      *  * filterOutOfStockItems
-     * If your filter blocks all prediction results, the API will return generic
-     * (unfiltered) popular products. If you only want results strictly matching
-     * the filters, set `strictFiltering` to True in `PredictRequest.params` to
-     * receive empty results instead.
-     * Note that the API will never return items with storageStatus of "EXPIRED"
-     * or "DELETED" regardless of filter choices.
+     * If your filter blocks all prediction results, the API will return *no*
+     * results. If instead you want empty result sets to return generic
+     * (unfiltered) popular products, set `strictFiltering` to False in
+     * `PredictRequest.params`. Note that the API will never return items with
+     * storageStatus of "EXPIRED" or "DELETED" regardless of filter choices.
      * If `filterSyntaxV2` is set to true under the `params` field, then
      * attribute-based expressions are expected instead of the above described
      * tag-based syntax. Examples:
@@ -2343,7 +2336,7 @@ public int getParamsCount() {
      * * `returnScore`: Boolean. If set to true, the prediction 'score'
      *    corresponding to each returned product will be set in the
      *    `results.metadata` field in the prediction response. The given
-     *    'score' indicates the probability of an product being clicked/purchased
+     *    'score' indicates the probability of a product being clicked/purchased
      *    given the user's context and history.
      * * `strictFiltering`: Boolean. True by default. If set to false, the service
      *    will return generic (unfiltered) popular products instead of empty if
@@ -2389,7 +2382,7 @@ public java.util.Map getParams() {
      * * `returnScore`: Boolean. If set to true, the prediction 'score'
      *    corresponding to each returned product will be set in the
      *    `results.metadata` field in the prediction response. The given
-     *    'score' indicates the probability of an product being clicked/purchased
+     *    'score' indicates the probability of a product being clicked/purchased
      *    given the user's context and history.
      * * `strictFiltering`: Boolean. True by default. If set to false, the service
      *    will return generic (unfiltered) popular products instead of empty if
@@ -2426,7 +2419,7 @@ public java.util.Map getParamsMap()
      * * `returnScore`: Boolean. If set to true, the prediction 'score'
      *    corresponding to each returned product will be set in the
      *    `results.metadata` field in the prediction response. The given
-     *    'score' indicates the probability of an product being clicked/purchased
+     *    'score' indicates the probability of a product being clicked/purchased
      *    given the user's context and history.
      * * `strictFiltering`: Boolean. True by default. If set to false, the service
      *    will return generic (unfiltered) popular products instead of empty if
@@ -2468,7 +2461,7 @@ public com.google.protobuf.Value getParamsOrDefault(
      * * `returnScore`: Boolean. If set to true, the prediction 'score'
      *    corresponding to each returned product will be set in the
      *    `results.metadata` field in the prediction response. The given
-     *    'score' indicates the probability of an product being clicked/purchased
+     *    'score' indicates the probability of a product being clicked/purchased
      *    given the user's context and history.
      * * `strictFiltering`: Boolean. True by default. If set to false, the service
      *    will return generic (unfiltered) popular products instead of empty if
@@ -2517,7 +2510,7 @@ public Builder clearParams() {
      * * `returnScore`: Boolean. If set to true, the prediction 'score'
      *    corresponding to each returned product will be set in the
      *    `results.metadata` field in the prediction response. The given
-     *    'score' indicates the probability of an product being clicked/purchased
+     *    'score' indicates the probability of a product being clicked/purchased
      *    given the user's context and history.
      * * `strictFiltering`: Boolean. True by default. If set to false, the service
      *    will return generic (unfiltered) popular products instead of empty if
@@ -2562,7 +2555,7 @@ public java.util.Map getMutablePara
      * * `returnScore`: Boolean. If set to true, the prediction 'score'
      *    corresponding to each returned product will be set in the
      *    `results.metadata` field in the prediction response. The given
-     *    'score' indicates the probability of an product being clicked/purchased
+     *    'score' indicates the probability of a product being clicked/purchased
      *    given the user's context and history.
      * * `strictFiltering`: Boolean. True by default. If set to false, the service
      *    will return generic (unfiltered) popular products instead of empty if
@@ -2606,7 +2599,7 @@ public Builder putParams(java.lang.String key, com.google.protobuf.Value value)
      * * `returnScore`: Boolean. If set to true, the prediction 'score'
      *    corresponding to each returned product will be set in the
      *    `results.metadata` field in the prediction response. The given
-     *    'score' indicates the probability of an product being clicked/purchased
+     *    'score' indicates the probability of a product being clicked/purchased
      *    given the user's context and history.
      * * `strictFiltering`: Boolean. True by default. If set to false, the service
      *    will return generic (unfiltered) popular products instead of empty if
diff --git a/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/PredictRequestOrBuilder.java b/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/PredictRequestOrBuilder.java
index 4f0080b8f9ed..c716ee11f589 100644
--- a/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/PredictRequestOrBuilder.java
+++ b/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/PredictRequestOrBuilder.java
@@ -36,7 +36,7 @@ public interface PredictRequestOrBuilder
    * The ID of the Recommendations AI serving config or placement.
    * Before you can request predictions from your model, you must create at
    * least one serving config or placement for it. For more information, see
-   * [Managing serving configurations]
+   * [Manage serving configs]
    * (https://cloud.google.com/retail/docs/manage-configs).
    * The full list of available serving configs can be seen at
    * https://console.cloud.google.com/ai/retail/catalogs/default_catalog/configs
@@ -60,7 +60,7 @@ public interface PredictRequestOrBuilder
    * The ID of the Recommendations AI serving config or placement.
    * Before you can request predictions from your model, you must create at
    * least one serving config or placement for it. For more information, see
-   * [Managing serving configurations]
+   * [Manage serving configs]
    * (https://cloud.google.com/retail/docs/manage-configs).
    * The full list of available serving configs can be seen at
    * https://console.cloud.google.com/ai/retail/catalogs/default_catalog/configs
@@ -175,7 +175,7 @@ public interface PredictRequestOrBuilder
    * string page_token = 4 [deprecated = true];
    *
    * @deprecated google.cloud.retail.v2.PredictRequest.page_token is deprecated. See
-   *     google/cloud/retail/v2/prediction_service.proto;l=93
+   *     google/cloud/retail/v2/prediction_service.proto;l=94
    * @return The pageToken.
    */
   @java.lang.Deprecated
@@ -190,7 +190,7 @@ public interface PredictRequestOrBuilder
    * string page_token = 4 [deprecated = true];
    *
    * @deprecated google.cloud.retail.v2.PredictRequest.page_token is deprecated. See
-   *     google/cloud/retail/v2/prediction_service.proto;l=93
+   *     google/cloud/retail/v2/prediction_service.proto;l=94
    * @return The bytes for pageToken.
    */
   @java.lang.Deprecated
@@ -217,12 +217,11 @@ public interface PredictRequestOrBuilder
    *  * tag=("Red" OR "Blue") tag="New-Arrival" tag=(NOT "promotional")
    *  * filterOutOfStockItems  tag=(-"promotional")
    *  * filterOutOfStockItems
-   * If your filter blocks all prediction results, the API will return generic
-   * (unfiltered) popular products. If you only want results strictly matching
-   * the filters, set `strictFiltering` to True in `PredictRequest.params` to
-   * receive empty results instead.
-   * Note that the API will never return items with storageStatus of "EXPIRED"
-   * or "DELETED" regardless of filter choices.
+   * If your filter blocks all prediction results, the API will return *no*
+   * results. If instead you want empty result sets to return generic
+   * (unfiltered) popular products, set `strictFiltering` to False in
+   * `PredictRequest.params`. Note that the API will never return items with
+   * storageStatus of "EXPIRED" or "DELETED" regardless of filter choices.
    * If `filterSyntaxV2` is set to true under the `params` field, then
    * attribute-based expressions are expected instead of the above described
    * tag-based syntax. Examples:
@@ -257,12 +256,11 @@ public interface PredictRequestOrBuilder
    *  * tag=("Red" OR "Blue") tag="New-Arrival" tag=(NOT "promotional")
    *  * filterOutOfStockItems  tag=(-"promotional")
    *  * filterOutOfStockItems
-   * If your filter blocks all prediction results, the API will return generic
-   * (unfiltered) popular products. If you only want results strictly matching
-   * the filters, set `strictFiltering` to True in `PredictRequest.params` to
-   * receive empty results instead.
-   * Note that the API will never return items with storageStatus of "EXPIRED"
-   * or "DELETED" regardless of filter choices.
+   * If your filter blocks all prediction results, the API will return *no*
+   * results. If instead you want empty result sets to return generic
+   * (unfiltered) popular products, set `strictFiltering` to False in
+   * `PredictRequest.params`. Note that the API will never return items with
+   * storageStatus of "EXPIRED" or "DELETED" regardless of filter choices.
    * If `filterSyntaxV2` is set to true under the `params` field, then
    * attribute-based expressions are expected instead of the above described
    * tag-based syntax. Examples:
@@ -305,7 +303,7 @@ public interface PredictRequestOrBuilder
    * * `returnScore`: Boolean. If set to true, the prediction 'score'
    *    corresponding to each returned product will be set in the
    *    `results.metadata` field in the prediction response. The given
-   *    'score' indicates the probability of an product being clicked/purchased
+   *    'score' indicates the probability of a product being clicked/purchased
    *    given the user's context and history.
    * * `strictFiltering`: Boolean. True by default. If set to false, the service
    *    will return generic (unfiltered) popular products instead of empty if
@@ -339,7 +337,7 @@ public interface PredictRequestOrBuilder
    * * `returnScore`: Boolean. If set to true, the prediction 'score'
    *    corresponding to each returned product will be set in the
    *    `results.metadata` field in the prediction response. The given
-   *    'score' indicates the probability of an product being clicked/purchased
+   *    'score' indicates the probability of a product being clicked/purchased
    *    given the user's context and history.
    * * `strictFiltering`: Boolean. True by default. If set to false, the service
    *    will return generic (unfiltered) popular products instead of empty if
@@ -376,7 +374,7 @@ public interface PredictRequestOrBuilder
    * * `returnScore`: Boolean. If set to true, the prediction 'score'
    *    corresponding to each returned product will be set in the
    *    `results.metadata` field in the prediction response. The given
-   *    'score' indicates the probability of an product being clicked/purchased
+   *    'score' indicates the probability of a product being clicked/purchased
    *    given the user's context and history.
    * * `strictFiltering`: Boolean. True by default. If set to false, the service
    *    will return generic (unfiltered) popular products instead of empty if
@@ -410,7 +408,7 @@ public interface PredictRequestOrBuilder
    * * `returnScore`: Boolean. If set to true, the prediction 'score'
    *    corresponding to each returned product will be set in the
    *    `results.metadata` field in the prediction response. The given
-   *    'score' indicates the probability of an product being clicked/purchased
+   *    'score' indicates the probability of a product being clicked/purchased
    *    given the user's context and history.
    * * `strictFiltering`: Boolean. True by default. If set to false, the service
    *    will return generic (unfiltered) popular products instead of empty if
@@ -449,7 +447,7 @@ com.google.protobuf.Value getParamsOrDefault(
    * * `returnScore`: Boolean. If set to true, the prediction 'score'
    *    corresponding to each returned product will be set in the
    *    `results.metadata` field in the prediction response. The given
-   *    'score' indicates the probability of an product being clicked/purchased
+   *    'score' indicates the probability of a product being clicked/purchased
    *    given the user's context and history.
    * * `strictFiltering`: Boolean. True by default. If set to false, the service
    *    will return generic (unfiltered) popular products instead of empty if
diff --git a/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/PredictionServiceProto.java b/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/PredictionServiceProto.java
index 9c13492d1ce1..15a908a5d75e 100644
--- a/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/PredictionServiceProto.java
+++ b/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/PredictionServiceProto.java
@@ -64,43 +64,43 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
           + "ice.proto\022\026google.cloud.retail.v2\032\034googl"
           + "e/api/annotations.proto\032\027google/api/clie"
           + "nt.proto\032\037google/api/field_behavior.prot"
-          + "o\032\'google/cloud/retail/v2/user_event.pro"
-          + "to\032\034google/protobuf/struct.proto\"\264\003\n\016Pre"
-          + "dictRequest\022\026\n\tplacement\030\001 \001(\tB\003\340A\002\022:\n\nu"
-          + "ser_event\030\002 \001(\0132!.google.cloud.retail.v2"
-          + ".UserEventB\003\340A\002\022\021\n\tpage_size\030\003 \001(\005\022\026\n\npa"
-          + "ge_token\030\004 \001(\tB\002\030\001\022\016\n\006filter\030\005 \001(\t\022\025\n\rva"
-          + "lidate_only\030\006 \001(\010\022B\n\006params\030\007 \003(\01322.goog"
-          + "le.cloud.retail.v2.PredictRequest.Params"
-          + "Entry\022B\n\006labels\030\010 \003(\01322.google.cloud.ret"
-          + "ail.v2.PredictRequest.LabelsEntry\032E\n\013Par"
-          + "amsEntry\022\013\n\003key\030\001 \001(\t\022%\n\005value\030\002 \001(\0132\026.g"
-          + "oogle.protobuf.Value:\0028\001\032-\n\013LabelsEntry\022"
-          + "\013\n\003key\030\001 \001(\t\022\r\n\005value\030\002 \001(\t:\0028\001\"\347\002\n\017Pred"
-          + "ictResponse\022I\n\007results\030\001 \003(\01328.google.cl"
-          + "oud.retail.v2.PredictResponse.Prediction"
-          + "Result\022\031\n\021attribution_token\030\002 \001(\t\022\023\n\013mis"
-          + "sing_ids\030\003 \003(\t\022\025\n\rvalidate_only\030\004 \001(\010\032\301\001"
-          + "\n\020PredictionResult\022\n\n\002id\030\001 \001(\t\022X\n\010metada"
-          + "ta\030\002 \003(\0132F.google.cloud.retail.v2.Predic"
-          + "tResponse.PredictionResult.MetadataEntry"
-          + "\032G\n\rMetadataEntry\022\013\n\003key\030\001 \001(\t\022%\n\005value\030"
-          + "\002 \001(\0132\026.google.protobuf.Value:\0028\0012\341\002\n\021Pr"
-          + "edictionService\022\200\002\n\007Predict\022&.google.clo"
-          + "ud.retail.v2.PredictRequest\032\'.google.clo"
-          + "ud.retail.v2.PredictResponse\"\243\001\202\323\344\223\002\234\001\"F"
-          + "/v2/{placement=projects/*/locations/*/ca"
-          + "talogs/*/placements/*}:predict:\001*ZO\"J/v2"
-          + "/{placement=projects/*/locations/*/catal"
-          + "ogs/*/servingConfigs/*}:predict:\001*\032I\312A\025r"
-          + "etail.googleapis.com\322A.https://www.googl"
-          + "eapis.com/auth/cloud-platformB\313\001\n\032com.go"
-          + "ogle.cloud.retail.v2B\026PredictionServiceP"
-          + "rotoP\001Z
    * The timestamp when this product becomes unavailable for
-   * [SearchService.Search][google.cloud.retail.v2.SearchService.Search].
+   * [SearchService.Search][google.cloud.retail.v2.SearchService.Search]. Note
+   * that this is only applicable to
+   * [Type.PRIMARY][google.cloud.retail.v2.Product.Type.PRIMARY] and
+   * [Type.COLLECTION][google.cloud.retail.v2.Product.Type.COLLECTION], and
+   * ignored for [Type.VARIANT][google.cloud.retail.v2.Product.Type.VARIANT].
+   * In general, we suggest the users to delete the stale products explicitly,
+   * instead of using this field to determine staleness.
    * If it is set, the [Product][google.cloud.retail.v2.Product] is not
    * available for
    * [SearchService.Search][google.cloud.retail.v2.SearchService.Search] after
@@ -605,7 +611,13 @@ public boolean hasExpireTime() {
    *
    * 
          * The timestamp when this product becomes unavailable for
-   * [SearchService.Search][google.cloud.retail.v2.SearchService.Search].
+   * [SearchService.Search][google.cloud.retail.v2.SearchService.Search]. Note
+   * that this is only applicable to
+   * [Type.PRIMARY][google.cloud.retail.v2.Product.Type.PRIMARY] and
+   * [Type.COLLECTION][google.cloud.retail.v2.Product.Type.COLLECTION], and
+   * ignored for [Type.VARIANT][google.cloud.retail.v2.Product.Type.VARIANT].
+   * In general, we suggest the users to delete the stale products explicitly,
+   * instead of using this field to determine staleness.
    * If it is set, the [Product][google.cloud.retail.v2.Product] is not
    * available for
    * [SearchService.Search][google.cloud.retail.v2.SearchService.Search] after
@@ -638,7 +650,13 @@ public com.google.protobuf.Timestamp getExpireTime() {
    *
    * 
          * The timestamp when this product becomes unavailable for
-   * [SearchService.Search][google.cloud.retail.v2.SearchService.Search].
+   * [SearchService.Search][google.cloud.retail.v2.SearchService.Search]. Note
+   * that this is only applicable to
+   * [Type.PRIMARY][google.cloud.retail.v2.Product.Type.PRIMARY] and
+   * [Type.COLLECTION][google.cloud.retail.v2.Product.Type.COLLECTION], and
+   * ignored for [Type.VARIANT][google.cloud.retail.v2.Product.Type.VARIANT].
+   * In general, we suggest the users to delete the stale products explicitly,
+   * instead of using this field to determine staleness.
    * If it is set, the [Product][google.cloud.retail.v2.Product] is not
    * available for
    * [SearchService.Search][google.cloud.retail.v2.SearchService.Search] after
@@ -670,7 +688,13 @@ public com.google.protobuf.TimestampOrBuilder getExpireTimeOrBuilder() {
    *
    *
    * 
      -   * Input only. The TTL (time to live) of the product.
+   * Input only. The TTL (time to live) of the product. Note that this is only
+   * applicable to [Type.PRIMARY][google.cloud.retail.v2.Product.Type.PRIMARY]
+   * and [Type.COLLECTION][google.cloud.retail.v2.Product.Type.COLLECTION],
+   * and ignored for
+   * [Type.VARIANT][google.cloud.retail.v2.Product.Type.VARIANT]. In general,
+   * we suggest the users to delete the stale products explicitly, instead of
+   * using this field to determine staleness.
    * If it is set, it must be a non-negative value, and
    * [expire_time][google.cloud.retail.v2.Product.expire_time] is set as
    * current timestamp plus [ttl][google.cloud.retail.v2.Product.ttl]. The
@@ -698,7 +722,13 @@ public boolean hasTtl() {
    *
    *
    * 
      -   * Input only. The TTL (time to live) of the product.
+   * Input only. The TTL (time to live) of the product. Note that this is only
+   * applicable to [Type.PRIMARY][google.cloud.retail.v2.Product.Type.PRIMARY]
+   * and [Type.COLLECTION][google.cloud.retail.v2.Product.Type.COLLECTION],
+   * and ignored for
+   * [Type.VARIANT][google.cloud.retail.v2.Product.Type.VARIANT]. In general,
+   * we suggest the users to delete the stale products explicitly, instead of
+   * using this field to determine staleness.
    * If it is set, it must be a non-negative value, and
    * [expire_time][google.cloud.retail.v2.Product.expire_time] is set as
    * current timestamp plus [ttl][google.cloud.retail.v2.Product.ttl]. The
@@ -729,7 +759,13 @@ public com.google.protobuf.Duration getTtl() {
    *
    *
    * 
      -   * Input only. The TTL (time to live) of the product.
+   * Input only. The TTL (time to live) of the product. Note that this is only
+   * applicable to [Type.PRIMARY][google.cloud.retail.v2.Product.Type.PRIMARY]
+   * and [Type.COLLECTION][google.cloud.retail.v2.Product.Type.COLLECTION],
+   * and ignored for
+   * [Type.VARIANT][google.cloud.retail.v2.Product.Type.VARIANT]. In general,
+   * we suggest the users to delete the stale products explicitly, instead of
+   * using this field to determine staleness.
    * If it is set, it must be a non-negative value, and
    * [expire_time][google.cloud.retail.v2.Product.expire_time] is set as
    * current timestamp plus [ttl][google.cloud.retail.v2.Product.ttl]. The
@@ -1174,7 +1210,7 @@ public com.google.protobuf.ByteString getGtinBytes() {
    * belonging to several parallel categories. Strongly recommended using the
    * full path for better search / recommendation quality.
    * To represent full path of category, use '>' sign to separate different
-   * hierarchies. If '>' is part of the category name, please replace it with
+   * hierarchies. If '>' is part of the category name, replace it with
    * other character(s).
    * For example, if a shoes product belongs to both
    * ["Shoes & Accessories" -> "Shoes"] and
@@ -1213,7 +1249,7 @@ public com.google.protobuf.ProtocolStringList getCategoriesList() {
    * belonging to several parallel categories. Strongly recommended using the
    * full path for better search / recommendation quality.
    * To represent full path of category, use '>' sign to separate different
-   * hierarchies. If '>' is part of the category name, please replace it with
+   * hierarchies. If '>' is part of the category name, replace it with
    * other character(s).
    * For example, if a shoes product belongs to both
    * ["Shoes & Accessories" -> "Shoes"] and
@@ -1252,7 +1288,7 @@ public int getCategoriesCount() {
    * belonging to several parallel categories. Strongly recommended using the
    * full path for better search / recommendation quality.
    * To represent full path of category, use '>' sign to separate different
-   * hierarchies. If '>' is part of the category name, please replace it with
+   * hierarchies. If '>' is part of the category name, replace it with
    * other character(s).
    * For example, if a shoes product belongs to both
    * ["Shoes & Accessories" -> "Shoes"] and
@@ -1292,7 +1328,7 @@ public java.lang.String getCategories(int index) {
    * belonging to several parallel categories. Strongly recommended using the
    * full path for better search / recommendation quality.
    * To represent full path of category, use '>' sign to separate different
-   * hierarchies. If '>' is part of the category name, please replace it with
+   * hierarchies. If '>' is part of the category name, replace it with
    * other character(s).
    * For example, if a shoes product belongs to both
    * ["Shoes & Accessories" -> "Shoes"] and
@@ -1996,7 +2032,11 @@ public com.google.cloud.retail.v2.RatingOrBuilder getRatingOrBuilder() {
    * 
          * The timestamp when this [Product][google.cloud.retail.v2.Product] becomes
    * available for
-   * [SearchService.Search][google.cloud.retail.v2.SearchService.Search].
+   * [SearchService.Search][google.cloud.retail.v2.SearchService.Search]. Note
+   * that this is only applicable to
+   * [Type.PRIMARY][google.cloud.retail.v2.Product.Type.PRIMARY] and
+   * [Type.COLLECTION][google.cloud.retail.v2.Product.Type.COLLECTION], and
+   * ignored for [Type.VARIANT][google.cloud.retail.v2.Product.Type.VARIANT].
    * 
      
    *
    * .google.protobuf.Timestamp available_time = 18;
@@ -2013,7 +2053,11 @@ public boolean hasAvailableTime() {
    * 
          * The timestamp when this [Product][google.cloud.retail.v2.Product] becomes
    * available for
-   * [SearchService.Search][google.cloud.retail.v2.SearchService.Search].
+   * [SearchService.Search][google.cloud.retail.v2.SearchService.Search]. Note
+   * that this is only applicable to
+   * [Type.PRIMARY][google.cloud.retail.v2.Product.Type.PRIMARY] and
+   * [Type.COLLECTION][google.cloud.retail.v2.Product.Type.COLLECTION], and
+   * ignored for [Type.VARIANT][google.cloud.retail.v2.Product.Type.VARIANT].
    * 
      
    *
    * .google.protobuf.Timestamp available_time = 18;
@@ -2032,7 +2076,11 @@ public com.google.protobuf.Timestamp getAvailableTime() {
    * 
          * The timestamp when this [Product][google.cloud.retail.v2.Product] becomes
    * available for
-   * [SearchService.Search][google.cloud.retail.v2.SearchService.Search].
+   * [SearchService.Search][google.cloud.retail.v2.SearchService.Search]. Note
+   * that this is only applicable to
+   * [Type.PRIMARY][google.cloud.retail.v2.Product.Type.PRIMARY] and
+   * [Type.COLLECTION][google.cloud.retail.v2.Product.Type.COLLECTION], and
+   * ignored for [Type.VARIANT][google.cloud.retail.v2.Product.Type.VARIANT].
    * 
      
    *
    * .google.protobuf.Timestamp available_time = 18;
@@ -3076,13 +3124,17 @@ public com.google.protobuf.TimestampOrBuilder getPublishTimeOrBuilder() {
    * Note: Returning more fields in
    * [SearchResponse][google.cloud.retail.v2.SearchResponse] can increase
    * response payload size and serving latency.
+   * This field is deprecated. Use the retrievable site-wide control instead.
    * 
      
    *
-   * .google.protobuf.FieldMask retrievable_fields = 30;
+   * .google.protobuf.FieldMask retrievable_fields = 30 [deprecated = true];
    *
+   * @deprecated google.cloud.retail.v2.Product.retrievable_fields is deprecated. See
+   *     google/cloud/retail/v2/product.proto;l=562
    * @return Whether the retrievableFields field is set.
    */
   @java.lang.Override
+  @java.lang.Deprecated
   public boolean hasRetrievableFields() {
     return retrievableFields_ != null;
   }
@@ -3134,13 +3186,17 @@ public boolean hasRetrievableFields() {
    * Note: Returning more fields in
    * [SearchResponse][google.cloud.retail.v2.SearchResponse] can increase
    * response payload size and serving latency.
+   * This field is deprecated. Use the retrievable site-wide control instead.
    * 
      
    *
-   * .google.protobuf.FieldMask retrievable_fields = 30;
+   * .google.protobuf.FieldMask retrievable_fields = 30 [deprecated = true];
    *
+   * @deprecated google.cloud.retail.v2.Product.retrievable_fields is deprecated. See
+   *     google/cloud/retail/v2/product.proto;l=562
    * @return The retrievableFields.
    */
   @java.lang.Override
+  @java.lang.Deprecated
   public com.google.protobuf.FieldMask getRetrievableFields() {
     return retrievableFields_ == null
         ? com.google.protobuf.FieldMask.getDefaultInstance()
@@ -3194,11 +3250,13 @@ public com.google.protobuf.FieldMask getRetrievableFields() {
    * Note: Returning more fields in
    * [SearchResponse][google.cloud.retail.v2.SearchResponse] can increase
    * response payload size and serving latency.
+   * This field is deprecated. Use the retrievable site-wide control instead.
    * 
      
    *
-   * .google.protobuf.FieldMask retrievable_fields = 30;
+   * .google.protobuf.FieldMask retrievable_fields = 30 [deprecated = true];
    */
   @java.lang.Override
+  @java.lang.Deprecated
   public com.google.protobuf.FieldMaskOrBuilder getRetrievableFieldsOrBuilder() {
     return getRetrievableFields();
   }
@@ -3330,7 +3388,11 @@ public com.google.cloud.retail.v2.ProductOrBuilder getVariantsOrBuilder(int inde
    * 
          * Output only. A list of local inventories specific to different places.
    * This is only available for users who have Retail Search enabled, and it can
-   * be managed by [AddLocalInventories][] and [RemoveLocalInventories][] APIs.
+   * be managed by
+   * [ProductService.AddLocalInventories][google.cloud.retail.v2.ProductService.AddLocalInventories]
+   * and
+   * [ProductService.RemoveLocalInventories][google.cloud.retail.v2.ProductService.RemoveLocalInventories]
+   * APIs.
    * 
      
    *
    * 
@@ -3347,7 +3409,11 @@ public java.util.List getLocalInvento
    * 
          * Output only. A list of local inventories specific to different places.
    * This is only available for users who have Retail Search enabled, and it can
-   * be managed by [AddLocalInventories][] and [RemoveLocalInventories][] APIs.
+   * be managed by
+   * [ProductService.AddLocalInventories][google.cloud.retail.v2.ProductService.AddLocalInventories]
+   * and
+   * [ProductService.RemoveLocalInventories][google.cloud.retail.v2.ProductService.RemoveLocalInventories]
+   * APIs.
    * 
      
    *
    * 
@@ -3365,7 +3431,11 @@ public java.util.List getLocalInvento
    * 
          * Output only. A list of local inventories specific to different places.
    * This is only available for users who have Retail Search enabled, and it can
-   * be managed by [AddLocalInventories][] and [RemoveLocalInventories][] APIs.
+   * be managed by
+   * [ProductService.AddLocalInventories][google.cloud.retail.v2.ProductService.AddLocalInventories]
+   * and
+   * [ProductService.RemoveLocalInventories][google.cloud.retail.v2.ProductService.RemoveLocalInventories]
+   * APIs.
    * 
      
    *
    * 
@@ -3382,7 +3452,11 @@ public int getLocalInventoriesCount() {
    * 
          * Output only. A list of local inventories specific to different places.
    * This is only available for users who have Retail Search enabled, and it can
-   * be managed by [AddLocalInventories][] and [RemoveLocalInventories][] APIs.
+   * be managed by
+   * [ProductService.AddLocalInventories][google.cloud.retail.v2.ProductService.AddLocalInventories]
+   * and
+   * [ProductService.RemoveLocalInventories][google.cloud.retail.v2.ProductService.RemoveLocalInventories]
+   * APIs.
    * 
      
    *
    * 
@@ -3399,7 +3473,11 @@ public com.google.cloud.retail.v2.LocalInventory getLocalInventories(int index)
    * 
          * Output only. A list of local inventories specific to different places.
    * This is only available for users who have Retail Search enabled, and it can
-   * be managed by [AddLocalInventories][] and [RemoveLocalInventories][] APIs.
+   * be managed by
+   * [ProductService.AddLocalInventories][google.cloud.retail.v2.ProductService.AddLocalInventories]
+   * and
+   * [ProductService.RemoveLocalInventories][google.cloud.retail.v2.ProductService.RemoveLocalInventories]
+   * APIs.
    * 
      
    *
    * 
@@ -5038,7 +5116,13 @@ public Builder clearExpiration() {
      *
      * 
            * The timestamp when this product becomes unavailable for
-     * [SearchService.Search][google.cloud.retail.v2.SearchService.Search].
+     * [SearchService.Search][google.cloud.retail.v2.SearchService.Search]. Note
+     * that this is only applicable to
+     * [Type.PRIMARY][google.cloud.retail.v2.Product.Type.PRIMARY] and
+     * [Type.COLLECTION][google.cloud.retail.v2.Product.Type.COLLECTION], and
+     * ignored for [Type.VARIANT][google.cloud.retail.v2.Product.Type.VARIANT].
+     * In general, we suggest the users to delete the stale products explicitly,
+     * instead of using this field to determine staleness.
      * If it is set, the [Product][google.cloud.retail.v2.Product] is not
      * available for
      * [SearchService.Search][google.cloud.retail.v2.SearchService.Search] after
@@ -5068,7 +5152,13 @@ public boolean hasExpireTime() {
      *
      * 
            * The timestamp when this product becomes unavailable for
-     * [SearchService.Search][google.cloud.retail.v2.SearchService.Search].
+     * [SearchService.Search][google.cloud.retail.v2.SearchService.Search]. Note
+     * that this is only applicable to
+     * [Type.PRIMARY][google.cloud.retail.v2.Product.Type.PRIMARY] and
+     * [Type.COLLECTION][google.cloud.retail.v2.Product.Type.COLLECTION], and
+     * ignored for [Type.VARIANT][google.cloud.retail.v2.Product.Type.VARIANT].
+     * In general, we suggest the users to delete the stale products explicitly,
+     * instead of using this field to determine staleness.
      * If it is set, the [Product][google.cloud.retail.v2.Product] is not
      * available for
      * [SearchService.Search][google.cloud.retail.v2.SearchService.Search] after
@@ -5108,7 +5198,13 @@ public com.google.protobuf.Timestamp getExpireTime() {
      *
      * 
            * The timestamp when this product becomes unavailable for
-     * [SearchService.Search][google.cloud.retail.v2.SearchService.Search].
+     * [SearchService.Search][google.cloud.retail.v2.SearchService.Search]. Note
+     * that this is only applicable to
+     * [Type.PRIMARY][google.cloud.retail.v2.Product.Type.PRIMARY] and
+     * [Type.COLLECTION][google.cloud.retail.v2.Product.Type.COLLECTION], and
+     * ignored for [Type.VARIANT][google.cloud.retail.v2.Product.Type.VARIANT].
+     * In general, we suggest the users to delete the stale products explicitly,
+     * instead of using this field to determine staleness.
      * If it is set, the [Product][google.cloud.retail.v2.Product] is not
      * available for
      * [SearchService.Search][google.cloud.retail.v2.SearchService.Search] after
@@ -5145,7 +5241,13 @@ public Builder setExpireTime(com.google.protobuf.Timestamp value) {
      *
      * 
            * The timestamp when this product becomes unavailable for
-     * [SearchService.Search][google.cloud.retail.v2.SearchService.Search].
+     * [SearchService.Search][google.cloud.retail.v2.SearchService.Search]. Note
+     * that this is only applicable to
+     * [Type.PRIMARY][google.cloud.retail.v2.Product.Type.PRIMARY] and
+     * [Type.COLLECTION][google.cloud.retail.v2.Product.Type.COLLECTION], and
+     * ignored for [Type.VARIANT][google.cloud.retail.v2.Product.Type.VARIANT].
+     * In general, we suggest the users to delete the stale products explicitly,
+     * instead of using this field to determine staleness.
      * If it is set, the [Product][google.cloud.retail.v2.Product] is not
      * available for
      * [SearchService.Search][google.cloud.retail.v2.SearchService.Search] after
@@ -5179,7 +5281,13 @@ public Builder setExpireTime(com.google.protobuf.Timestamp.Builder builderForVal
      *
      * 
            * The timestamp when this product becomes unavailable for
-     * [SearchService.Search][google.cloud.retail.v2.SearchService.Search].
+     * [SearchService.Search][google.cloud.retail.v2.SearchService.Search]. Note
+     * that this is only applicable to
+     * [Type.PRIMARY][google.cloud.retail.v2.Product.Type.PRIMARY] and
+     * [Type.COLLECTION][google.cloud.retail.v2.Product.Type.COLLECTION], and
+     * ignored for [Type.VARIANT][google.cloud.retail.v2.Product.Type.VARIANT].
+     * In general, we suggest the users to delete the stale products explicitly,
+     * instead of using this field to determine staleness.
      * If it is set, the [Product][google.cloud.retail.v2.Product] is not
      * available for
      * [SearchService.Search][google.cloud.retail.v2.SearchService.Search] after
@@ -5225,7 +5333,13 @@ public Builder mergeExpireTime(com.google.protobuf.Timestamp value) {
      *
      * 
            * The timestamp when this product becomes unavailable for
-     * [SearchService.Search][google.cloud.retail.v2.SearchService.Search].
+     * [SearchService.Search][google.cloud.retail.v2.SearchService.Search]. Note
+     * that this is only applicable to
+     * [Type.PRIMARY][google.cloud.retail.v2.Product.Type.PRIMARY] and
+     * [Type.COLLECTION][google.cloud.retail.v2.Product.Type.COLLECTION], and
+     * ignored for [Type.VARIANT][google.cloud.retail.v2.Product.Type.VARIANT].
+     * In general, we suggest the users to delete the stale products explicitly,
+     * instead of using this field to determine staleness.
      * If it is set, the [Product][google.cloud.retail.v2.Product] is not
      * available for
      * [SearchService.Search][google.cloud.retail.v2.SearchService.Search] after
@@ -5265,7 +5379,13 @@ public Builder clearExpireTime() {
      *
      * 
            * The timestamp when this product becomes unavailable for
-     * [SearchService.Search][google.cloud.retail.v2.SearchService.Search].
+     * [SearchService.Search][google.cloud.retail.v2.SearchService.Search]. Note
+     * that this is only applicable to
+     * [Type.PRIMARY][google.cloud.retail.v2.Product.Type.PRIMARY] and
+     * [Type.COLLECTION][google.cloud.retail.v2.Product.Type.COLLECTION], and
+     * ignored for [Type.VARIANT][google.cloud.retail.v2.Product.Type.VARIANT].
+     * In general, we suggest the users to delete the stale products explicitly,
+     * instead of using this field to determine staleness.
      * If it is set, the [Product][google.cloud.retail.v2.Product] is not
      * available for
      * [SearchService.Search][google.cloud.retail.v2.SearchService.Search] after
@@ -5292,7 +5412,13 @@ public com.google.protobuf.Timestamp.Builder getExpireTimeBuilder() {
      *
      * 
            * The timestamp when this product becomes unavailable for
-     * [SearchService.Search][google.cloud.retail.v2.SearchService.Search].
+     * [SearchService.Search][google.cloud.retail.v2.SearchService.Search]. Note
+     * that this is only applicable to
+     * [Type.PRIMARY][google.cloud.retail.v2.Product.Type.PRIMARY] and
+     * [Type.COLLECTION][google.cloud.retail.v2.Product.Type.COLLECTION], and
+     * ignored for [Type.VARIANT][google.cloud.retail.v2.Product.Type.VARIANT].
+     * In general, we suggest the users to delete the stale products explicitly,
+     * instead of using this field to determine staleness.
      * If it is set, the [Product][google.cloud.retail.v2.Product] is not
      * available for
      * [SearchService.Search][google.cloud.retail.v2.SearchService.Search] after
@@ -5327,7 +5453,13 @@ public com.google.protobuf.TimestampOrBuilder getExpireTimeOrBuilder() {
      *
      * 
            * The timestamp when this product becomes unavailable for
-     * [SearchService.Search][google.cloud.retail.v2.SearchService.Search].
+     * [SearchService.Search][google.cloud.retail.v2.SearchService.Search]. Note
+     * that this is only applicable to
+     * [Type.PRIMARY][google.cloud.retail.v2.Product.Type.PRIMARY] and
+     * [Type.COLLECTION][google.cloud.retail.v2.Product.Type.COLLECTION], and
+     * ignored for [Type.VARIANT][google.cloud.retail.v2.Product.Type.VARIANT].
+     * In general, we suggest the users to delete the stale products explicitly,
+     * instead of using this field to determine staleness.
      * If it is set, the [Product][google.cloud.retail.v2.Product] is not
      * available for
      * [SearchService.Search][google.cloud.retail.v2.SearchService.Search] after
@@ -5378,7 +5510,13 @@ public com.google.protobuf.TimestampOrBuilder getExpireTimeOrBuilder() {
      *
      *
      * 
      -     * Input only. The TTL (time to live) of the product.
+     * Input only. The TTL (time to live) of the product. Note that this is only
+     * applicable to [Type.PRIMARY][google.cloud.retail.v2.Product.Type.PRIMARY]
+     * and [Type.COLLECTION][google.cloud.retail.v2.Product.Type.COLLECTION],
+     * and ignored for
+     * [Type.VARIANT][google.cloud.retail.v2.Product.Type.VARIANT]. In general,
+     * we suggest the users to delete the stale products explicitly, instead of
+     * using this field to determine staleness.
      * If it is set, it must be a non-negative value, and
      * [expire_time][google.cloud.retail.v2.Product.expire_time] is set as
      * current timestamp plus [ttl][google.cloud.retail.v2.Product.ttl]. The
@@ -5406,7 +5544,13 @@ public boolean hasTtl() {
      *
      *
      * 
      -     * Input only. The TTL (time to live) of the product.
+     * Input only. The TTL (time to live) of the product. Note that this is only
+     * applicable to [Type.PRIMARY][google.cloud.retail.v2.Product.Type.PRIMARY]
+     * and [Type.COLLECTION][google.cloud.retail.v2.Product.Type.COLLECTION],
+     * and ignored for
+     * [Type.VARIANT][google.cloud.retail.v2.Product.Type.VARIANT]. In general,
+     * we suggest the users to delete the stale products explicitly, instead of
+     * using this field to determine staleness.
      * If it is set, it must be a non-negative value, and
      * [expire_time][google.cloud.retail.v2.Product.expire_time] is set as
      * current timestamp plus [ttl][google.cloud.retail.v2.Product.ttl]. The
@@ -5444,7 +5588,13 @@ public com.google.protobuf.Duration getTtl() {
      *
      *
      * 
      -     * Input only. The TTL (time to live) of the product.
+     * Input only. The TTL (time to live) of the product. Note that this is only
+     * applicable to [Type.PRIMARY][google.cloud.retail.v2.Product.Type.PRIMARY]
+     * and [Type.COLLECTION][google.cloud.retail.v2.Product.Type.COLLECTION],
+     * and ignored for
+     * [Type.VARIANT][google.cloud.retail.v2.Product.Type.VARIANT]. In general,
+     * we suggest the users to delete the stale products explicitly, instead of
+     * using this field to determine staleness.
      * If it is set, it must be a non-negative value, and
      * [expire_time][google.cloud.retail.v2.Product.expire_time] is set as
      * current timestamp plus [ttl][google.cloud.retail.v2.Product.ttl]. The
@@ -5479,7 +5629,13 @@ public Builder setTtl(com.google.protobuf.Duration value) {
      *
      *
      * 
      -     * Input only. The TTL (time to live) of the product.
+     * Input only. The TTL (time to live) of the product. Note that this is only
+     * applicable to [Type.PRIMARY][google.cloud.retail.v2.Product.Type.PRIMARY]
+     * and [Type.COLLECTION][google.cloud.retail.v2.Product.Type.COLLECTION],
+     * and ignored for
+     * [Type.VARIANT][google.cloud.retail.v2.Product.Type.VARIANT]. In general,
+     * we suggest the users to delete the stale products explicitly, instead of
+     * using this field to determine staleness.
      * If it is set, it must be a non-negative value, and
      * [expire_time][google.cloud.retail.v2.Product.expire_time] is set as
      * current timestamp plus [ttl][google.cloud.retail.v2.Product.ttl]. The
@@ -5511,7 +5667,13 @@ public Builder setTtl(com.google.protobuf.Duration.Builder builderForValue) {
      *
      *
      * 
      -     * Input only. The TTL (time to live) of the product.
+     * Input only. The TTL (time to live) of the product. Note that this is only
+     * applicable to [Type.PRIMARY][google.cloud.retail.v2.Product.Type.PRIMARY]
+     * and [Type.COLLECTION][google.cloud.retail.v2.Product.Type.COLLECTION],
+     * and ignored for
+     * [Type.VARIANT][google.cloud.retail.v2.Product.Type.VARIANT]. In general,
+     * we suggest the users to delete the stale products explicitly, instead of
+     * using this field to determine staleness.
      * If it is set, it must be a non-negative value, and
      * [expire_time][google.cloud.retail.v2.Product.expire_time] is set as
      * current timestamp plus [ttl][google.cloud.retail.v2.Product.ttl]. The
@@ -5555,7 +5717,13 @@ public Builder mergeTtl(com.google.protobuf.Duration value) {
      *
      *
      * 
      -     * Input only. The TTL (time to live) of the product.
+     * Input only. The TTL (time to live) of the product. Note that this is only
+     * applicable to [Type.PRIMARY][google.cloud.retail.v2.Product.Type.PRIMARY]
+     * and [Type.COLLECTION][google.cloud.retail.v2.Product.Type.COLLECTION],
+     * and ignored for
+     * [Type.VARIANT][google.cloud.retail.v2.Product.Type.VARIANT]. In general,
+     * we suggest the users to delete the stale products explicitly, instead of
+     * using this field to determine staleness.
      * If it is set, it must be a non-negative value, and
      * [expire_time][google.cloud.retail.v2.Product.expire_time] is set as
      * current timestamp plus [ttl][google.cloud.retail.v2.Product.ttl]. The
@@ -5593,7 +5761,13 @@ public Builder clearTtl() {
      *
      *
      * 
      -     * Input only. The TTL (time to live) of the product.
+     * Input only. The TTL (time to live) of the product. Note that this is only
+     * applicable to [Type.PRIMARY][google.cloud.retail.v2.Product.Type.PRIMARY]
+     * and [Type.COLLECTION][google.cloud.retail.v2.Product.Type.COLLECTION],
+     * and ignored for
+     * [Type.VARIANT][google.cloud.retail.v2.Product.Type.VARIANT]. In general,
+     * we suggest the users to delete the stale products explicitly, instead of
+     * using this field to determine staleness.
      * If it is set, it must be a non-negative value, and
      * [expire_time][google.cloud.retail.v2.Product.expire_time] is set as
      * current timestamp plus [ttl][google.cloud.retail.v2.Product.ttl]. The
@@ -5618,7 +5792,13 @@ public com.google.protobuf.Duration.Builder getTtlBuilder() {
      *
      *
      * 
      -     * Input only. The TTL (time to live) of the product.
+     * Input only. The TTL (time to live) of the product. Note that this is only
+     * applicable to [Type.PRIMARY][google.cloud.retail.v2.Product.Type.PRIMARY]
+     * and [Type.COLLECTION][google.cloud.retail.v2.Product.Type.COLLECTION],
+     * and ignored for
+     * [Type.VARIANT][google.cloud.retail.v2.Product.Type.VARIANT]. In general,
+     * we suggest the users to delete the stale products explicitly, instead of
+     * using this field to determine staleness.
      * If it is set, it must be a non-negative value, and
      * [expire_time][google.cloud.retail.v2.Product.expire_time] is set as
      * current timestamp plus [ttl][google.cloud.retail.v2.Product.ttl]. The
@@ -5651,7 +5831,13 @@ public com.google.protobuf.DurationOrBuilder getTtlOrBuilder() {
      *
      *
      * 
      -     * Input only. The TTL (time to live) of the product.
+     * Input only. The TTL (time to live) of the product. Note that this is only
+     * applicable to [Type.PRIMARY][google.cloud.retail.v2.Product.Type.PRIMARY]
+     * and [Type.COLLECTION][google.cloud.retail.v2.Product.Type.COLLECTION],
+     * and ignored for
+     * [Type.VARIANT][google.cloud.retail.v2.Product.Type.VARIANT]. In general,
+     * we suggest the users to delete the stale products explicitly, instead of
+     * using this field to determine staleness.
      * If it is set, it must be a non-negative value, and
      * [expire_time][google.cloud.retail.v2.Product.expire_time] is set as
      * current timestamp plus [ttl][google.cloud.retail.v2.Product.ttl]. The
@@ -6678,7 +6864,7 @@ private void ensureCategoriesIsMutable() {
      * belonging to several parallel categories. Strongly recommended using the
      * full path for better search / recommendation quality.
      * To represent full path of category, use '>' sign to separate different
-     * hierarchies. If '>' is part of the category name, please replace it with
+     * hierarchies. If '>' is part of the category name, replace it with
      * other character(s).
      * For example, if a shoes product belongs to both
      * ["Shoes & Accessories" -> "Shoes"] and
@@ -6717,7 +6903,7 @@ public com.google.protobuf.ProtocolStringList getCategoriesList() {
      * belonging to several parallel categories. Strongly recommended using the
      * full path for better search / recommendation quality.
      * To represent full path of category, use '>' sign to separate different
-     * hierarchies. If '>' is part of the category name, please replace it with
+     * hierarchies. If '>' is part of the category name, replace it with
      * other character(s).
      * For example, if a shoes product belongs to both
      * ["Shoes & Accessories" -> "Shoes"] and
@@ -6756,7 +6942,7 @@ public int getCategoriesCount() {
      * belonging to several parallel categories. Strongly recommended using the
      * full path for better search / recommendation quality.
      * To represent full path of category, use '>' sign to separate different
-     * hierarchies. If '>' is part of the category name, please replace it with
+     * hierarchies. If '>' is part of the category name, replace it with
      * other character(s).
      * For example, if a shoes product belongs to both
      * ["Shoes & Accessories" -> "Shoes"] and
@@ -6796,7 +6982,7 @@ public java.lang.String getCategories(int index) {
      * belonging to several parallel categories. Strongly recommended using the
      * full path for better search / recommendation quality.
      * To represent full path of category, use '>' sign to separate different
-     * hierarchies. If '>' is part of the category name, please replace it with
+     * hierarchies. If '>' is part of the category name, replace it with
      * other character(s).
      * For example, if a shoes product belongs to both
      * ["Shoes & Accessories" -> "Shoes"] and
@@ -6836,7 +7022,7 @@ public com.google.protobuf.ByteString getCategoriesBytes(int index) {
      * belonging to several parallel categories. Strongly recommended using the
      * full path for better search / recommendation quality.
      * To represent full path of category, use '>' sign to separate different
-     * hierarchies. If '>' is part of the category name, please replace it with
+     * hierarchies. If '>' is part of the category name, replace it with
      * other character(s).
      * For example, if a shoes product belongs to both
      * ["Shoes & Accessories" -> "Shoes"] and
@@ -6883,7 +7069,7 @@ public Builder setCategories(int index, java.lang.String value) {
      * belonging to several parallel categories. Strongly recommended using the
      * full path for better search / recommendation quality.
      * To represent full path of category, use '>' sign to separate different
-     * hierarchies. If '>' is part of the category name, please replace it with
+     * hierarchies. If '>' is part of the category name, replace it with
      * other character(s).
      * For example, if a shoes product belongs to both
      * ["Shoes & Accessories" -> "Shoes"] and
@@ -6929,7 +7115,7 @@ public Builder addCategories(java.lang.String value) {
      * belonging to several parallel categories. Strongly recommended using the
      * full path for better search / recommendation quality.
      * To represent full path of category, use '>' sign to separate different
-     * hierarchies. If '>' is part of the category name, please replace it with
+     * hierarchies. If '>' is part of the category name, replace it with
      * other character(s).
      * For example, if a shoes product belongs to both
      * ["Shoes & Accessories" -> "Shoes"] and
@@ -6972,7 +7158,7 @@ public Builder addAllCategories(java.lang.Iterable values) {
      * belonging to several parallel categories. Strongly recommended using the
      * full path for better search / recommendation quality.
      * To represent full path of category, use '>' sign to separate different
-     * hierarchies. If '>' is part of the category name, please replace it with
+     * hierarchies. If '>' is part of the category name, replace it with
      * other character(s).
      * For example, if a shoes product belongs to both
      * ["Shoes & Accessories" -> "Shoes"] and
@@ -7014,7 +7200,7 @@ public Builder clearCategories() {
      * belonging to several parallel categories. Strongly recommended using the
      * full path for better search / recommendation quality.
      * To represent full path of category, use '>' sign to separate different
-     * hierarchies. If '>' is part of the category name, please replace it with
+     * hierarchies. If '>' is part of the category name, replace it with
      * other character(s).
      * For example, if a shoes product belongs to both
      * ["Shoes & Accessories" -> "Shoes"] and
@@ -8655,7 +8841,11 @@ public com.google.cloud.retail.v2.RatingOrBuilder getRatingOrBuilder() {
      * 
            * The timestamp when this [Product][google.cloud.retail.v2.Product] becomes
      * available for
-     * [SearchService.Search][google.cloud.retail.v2.SearchService.Search].
+     * [SearchService.Search][google.cloud.retail.v2.SearchService.Search]. Note
+     * that this is only applicable to
+     * [Type.PRIMARY][google.cloud.retail.v2.Product.Type.PRIMARY] and
+     * [Type.COLLECTION][google.cloud.retail.v2.Product.Type.COLLECTION], and
+     * ignored for [Type.VARIANT][google.cloud.retail.v2.Product.Type.VARIANT].
      * 
      
      *
      * .google.protobuf.Timestamp available_time = 18;
@@ -8671,7 +8861,11 @@ public boolean hasAvailableTime() {
      * 
            * The timestamp when this [Product][google.cloud.retail.v2.Product] becomes
      * available for
-     * [SearchService.Search][google.cloud.retail.v2.SearchService.Search].
+     * [SearchService.Search][google.cloud.retail.v2.SearchService.Search]. Note
+     * that this is only applicable to
+     * [Type.PRIMARY][google.cloud.retail.v2.Product.Type.PRIMARY] and
+     * [Type.COLLECTION][google.cloud.retail.v2.Product.Type.COLLECTION], and
+     * ignored for [Type.VARIANT][google.cloud.retail.v2.Product.Type.VARIANT].
      * 
      
      *
      * .google.protobuf.Timestamp available_time = 18;
@@ -8693,7 +8887,11 @@ public com.google.protobuf.Timestamp getAvailableTime() {
      * 
            * The timestamp when this [Product][google.cloud.retail.v2.Product] becomes
      * available for
-     * [SearchService.Search][google.cloud.retail.v2.SearchService.Search].
+     * [SearchService.Search][google.cloud.retail.v2.SearchService.Search]. Note
+     * that this is only applicable to
+     * [Type.PRIMARY][google.cloud.retail.v2.Product.Type.PRIMARY] and
+     * [Type.COLLECTION][google.cloud.retail.v2.Product.Type.COLLECTION], and
+     * ignored for [Type.VARIANT][google.cloud.retail.v2.Product.Type.VARIANT].
      * 
      
      *
      * .google.protobuf.Timestamp available_time = 18;
@@ -8717,7 +8915,11 @@ public Builder setAvailableTime(com.google.protobuf.Timestamp value) {
      * 
            * The timestamp when this [Product][google.cloud.retail.v2.Product] becomes
      * available for
-     * [SearchService.Search][google.cloud.retail.v2.SearchService.Search].
+     * [SearchService.Search][google.cloud.retail.v2.SearchService.Search]. Note
+     * that this is only applicable to
+     * [Type.PRIMARY][google.cloud.retail.v2.Product.Type.PRIMARY] and
+     * [Type.COLLECTION][google.cloud.retail.v2.Product.Type.COLLECTION], and
+     * ignored for [Type.VARIANT][google.cloud.retail.v2.Product.Type.VARIANT].
      * 
      
      *
      * .google.protobuf.Timestamp available_time = 18;
@@ -8738,7 +8940,11 @@ public Builder setAvailableTime(com.google.protobuf.Timestamp.Builder builderFor
      * 
            * The timestamp when this [Product][google.cloud.retail.v2.Product] becomes
      * available for
-     * [SearchService.Search][google.cloud.retail.v2.SearchService.Search].
+     * [SearchService.Search][google.cloud.retail.v2.SearchService.Search]. Note
+     * that this is only applicable to
+     * [Type.PRIMARY][google.cloud.retail.v2.Product.Type.PRIMARY] and
+     * [Type.COLLECTION][google.cloud.retail.v2.Product.Type.COLLECTION], and
+     * ignored for [Type.VARIANT][google.cloud.retail.v2.Product.Type.VARIANT].
      * 
      
      *
      * .google.protobuf.Timestamp available_time = 18;
@@ -8766,7 +8972,11 @@ public Builder mergeAvailableTime(com.google.protobuf.Timestamp value) {
      * 
            * The timestamp when this [Product][google.cloud.retail.v2.Product] becomes
      * available for
-     * [SearchService.Search][google.cloud.retail.v2.SearchService.Search].
+     * [SearchService.Search][google.cloud.retail.v2.SearchService.Search]. Note
+     * that this is only applicable to
+     * [Type.PRIMARY][google.cloud.retail.v2.Product.Type.PRIMARY] and
+     * [Type.COLLECTION][google.cloud.retail.v2.Product.Type.COLLECTION], and
+     * ignored for [Type.VARIANT][google.cloud.retail.v2.Product.Type.VARIANT].
      * 
      
      *
      * .google.protobuf.Timestamp available_time = 18;
@@ -8788,7 +8998,11 @@ public Builder clearAvailableTime() {
      * 
            * The timestamp when this [Product][google.cloud.retail.v2.Product] becomes
      * available for
-     * [SearchService.Search][google.cloud.retail.v2.SearchService.Search].
+     * [SearchService.Search][google.cloud.retail.v2.SearchService.Search]. Note
+     * that this is only applicable to
+     * [Type.PRIMARY][google.cloud.retail.v2.Product.Type.PRIMARY] and
+     * [Type.COLLECTION][google.cloud.retail.v2.Product.Type.COLLECTION], and
+     * ignored for [Type.VARIANT][google.cloud.retail.v2.Product.Type.VARIANT].
      * 
      
      *
      * .google.protobuf.Timestamp available_time = 18;
@@ -8804,7 +9018,11 @@ public com.google.protobuf.Timestamp.Builder getAvailableTimeBuilder() {
      * 
            * The timestamp when this [Product][google.cloud.retail.v2.Product] becomes
      * available for
-     * [SearchService.Search][google.cloud.retail.v2.SearchService.Search].
+     * [SearchService.Search][google.cloud.retail.v2.SearchService.Search]. Note
+     * that this is only applicable to
+     * [Type.PRIMARY][google.cloud.retail.v2.Product.Type.PRIMARY] and
+     * [Type.COLLECTION][google.cloud.retail.v2.Product.Type.COLLECTION], and
+     * ignored for [Type.VARIANT][google.cloud.retail.v2.Product.Type.VARIANT].
      * 
      
      *
      * .google.protobuf.Timestamp available_time = 18;
@@ -8824,7 +9042,11 @@ public com.google.protobuf.TimestampOrBuilder getAvailableTimeOrBuilder() {
      * 
            * The timestamp when this [Product][google.cloud.retail.v2.Product] becomes
      * available for
-     * [SearchService.Search][google.cloud.retail.v2.SearchService.Search].
+     * [SearchService.Search][google.cloud.retail.v2.SearchService.Search]. Note
+     * that this is only applicable to
+     * [Type.PRIMARY][google.cloud.retail.v2.Product.Type.PRIMARY] and
+     * [Type.COLLECTION][google.cloud.retail.v2.Product.Type.COLLECTION], and
+     * ignored for [Type.VARIANT][google.cloud.retail.v2.Product.Type.VARIANT].
      * 
      
      *
      * .google.protobuf.Timestamp available_time = 18;
@@ -12248,12 +12470,16 @@ public com.google.protobuf.TimestampOrBuilder getPublishTimeOrBuilder() {
      * Note: Returning more fields in
      * [SearchResponse][google.cloud.retail.v2.SearchResponse] can increase
      * response payload size and serving latency.
+     * This field is deprecated. Use the retrievable site-wide control instead.
      * 
      
      *
-     * .google.protobuf.FieldMask retrievable_fields = 30;
+     * .google.protobuf.FieldMask retrievable_fields = 30 [deprecated = true];
      *
+     * @deprecated google.cloud.retail.v2.Product.retrievable_fields is deprecated. See
+     *     google/cloud/retail/v2/product.proto;l=562
      * @return Whether the retrievableFields field is set.
      */
+    @java.lang.Deprecated
     public boolean hasRetrievableFields() {
       return retrievableFieldsBuilder_ != null || retrievableFields_ != null;
     }
@@ -12305,12 +12531,16 @@ public boolean hasRetrievableFields() {
      * Note: Returning more fields in
      * [SearchResponse][google.cloud.retail.v2.SearchResponse] can increase
      * response payload size and serving latency.
+     * This field is deprecated. Use the retrievable site-wide control instead.
      * 
      
      *
-     * .google.protobuf.FieldMask retrievable_fields = 30;
+     * .google.protobuf.FieldMask retrievable_fields = 30 [deprecated = true];
      *
+     * @deprecated google.cloud.retail.v2.Product.retrievable_fields is deprecated. See
+     *     google/cloud/retail/v2/product.proto;l=562
      * @return The retrievableFields.
      */
+    @java.lang.Deprecated
     public com.google.protobuf.FieldMask getRetrievableFields() {
       if (retrievableFieldsBuilder_ == null) {
         return retrievableFields_ == null
@@ -12368,10 +12598,12 @@ public com.google.protobuf.FieldMask getRetrievableFields() {
      * Note: Returning more fields in
      * [SearchResponse][google.cloud.retail.v2.SearchResponse] can increase
      * response payload size and serving latency.
+     * This field is deprecated. Use the retrievable site-wide control instead.
      * 
      
      *
-     * .google.protobuf.FieldMask retrievable_fields = 30;
+     * .google.protobuf.FieldMask retrievable_fields = 30 [deprecated = true];
      */
+    @java.lang.Deprecated
     public Builder setRetrievableFields(com.google.protobuf.FieldMask value) {
       if (retrievableFieldsBuilder_ == null) {
         if (value == null) {
@@ -12433,10 +12665,12 @@ public Builder setRetrievableFields(com.google.protobuf.FieldMask value) {
      * Note: Returning more fields in
      * [SearchResponse][google.cloud.retail.v2.SearchResponse] can increase
      * response payload size and serving latency.
+     * This field is deprecated. Use the retrievable site-wide control instead.
      * 
      
      *
-     * .google.protobuf.FieldMask retrievable_fields = 30;
+     * .google.protobuf.FieldMask retrievable_fields = 30 [deprecated = true];
      */
+    @java.lang.Deprecated
     public Builder setRetrievableFields(com.google.protobuf.FieldMask.Builder builderForValue) {
       if (retrievableFieldsBuilder_ == null) {
         retrievableFields_ = builderForValue.build();
@@ -12495,10 +12729,12 @@ public Builder setRetrievableFields(com.google.protobuf.FieldMask.Builder builde
      * Note: Returning more fields in
      * [SearchResponse][google.cloud.retail.v2.SearchResponse] can increase
      * response payload size and serving latency.
+     * This field is deprecated. Use the retrievable site-wide control instead.
      * 
      
      *
-     * .google.protobuf.FieldMask retrievable_fields = 30;
+     * .google.protobuf.FieldMask retrievable_fields = 30 [deprecated = true];
      */
+    @java.lang.Deprecated
     public Builder mergeRetrievableFields(com.google.protobuf.FieldMask value) {
       if (retrievableFieldsBuilder_ == null) {
         if (retrievableFields_ != null) {
@@ -12564,10 +12800,12 @@ public Builder mergeRetrievableFields(com.google.protobuf.FieldMask value) {
      * Note: Returning more fields in
      * [SearchResponse][google.cloud.retail.v2.SearchResponse] can increase
      * response payload size and serving latency.
+     * This field is deprecated. Use the retrievable site-wide control instead.
      * 
      
      *
-     * .google.protobuf.FieldMask retrievable_fields = 30;
+     * .google.protobuf.FieldMask retrievable_fields = 30 [deprecated = true];
      */
+    @java.lang.Deprecated
     public Builder clearRetrievableFields() {
       if (retrievableFieldsBuilder_ == null) {
         retrievableFields_ = null;
@@ -12627,10 +12865,12 @@ public Builder clearRetrievableFields() {
      * Note: Returning more fields in
      * [SearchResponse][google.cloud.retail.v2.SearchResponse] can increase
      * response payload size and serving latency.
+     * This field is deprecated. Use the retrievable site-wide control instead.
      * 
      
      *
-     * .google.protobuf.FieldMask retrievable_fields = 30;
+     * .google.protobuf.FieldMask retrievable_fields = 30 [deprecated = true];
      */
+    @java.lang.Deprecated
     public com.google.protobuf.FieldMask.Builder getRetrievableFieldsBuilder() {
 
       onChanged();
@@ -12684,10 +12924,12 @@ public com.google.protobuf.FieldMask.Builder getRetrievableFieldsBuilder() {
      * Note: Returning more fields in
      * [SearchResponse][google.cloud.retail.v2.SearchResponse] can increase
      * response payload size and serving latency.
+     * This field is deprecated. Use the retrievable site-wide control instead.
      * 
      
      *
-     * .google.protobuf.FieldMask retrievable_fields = 30;
+     * .google.protobuf.FieldMask retrievable_fields = 30 [deprecated = true];
      */
+    @java.lang.Deprecated
     public com.google.protobuf.FieldMaskOrBuilder getRetrievableFieldsOrBuilder() {
       if (retrievableFieldsBuilder_ != null) {
         return retrievableFieldsBuilder_.getMessageOrBuilder();
@@ -12745,9 +12987,10 @@ public com.google.protobuf.FieldMaskOrBuilder getRetrievableFieldsOrBuilder() {
      * Note: Returning more fields in
      * [SearchResponse][google.cloud.retail.v2.SearchResponse] can increase
      * response payload size and serving latency.
+     * This field is deprecated. Use the retrievable site-wide control instead.
      * 
      
      *
-     * .google.protobuf.FieldMask retrievable_fields = 30;
+     * .google.protobuf.FieldMask retrievable_fields = 30 [deprecated = true];
      */
     private com.google.protobuf.SingleFieldBuilderV3<
             com.google.protobuf.FieldMask,
@@ -13317,7 +13560,11 @@ private void ensureLocalInventoriesIsMutable() {
      * 
            * Output only. A list of local inventories specific to different places.
      * This is only available for users who have Retail Search enabled, and it can
-     * be managed by [AddLocalInventories][] and [RemoveLocalInventories][] APIs.
+     * be managed by
+     * [ProductService.AddLocalInventories][google.cloud.retail.v2.ProductService.AddLocalInventories]
+     * and
+     * [ProductService.RemoveLocalInventories][google.cloud.retail.v2.ProductService.RemoveLocalInventories]
+     * APIs.
      * 
      
      *
      * 
@@ -13337,7 +13584,11 @@ public java.util.List getLocalInvento
      * 
            * Output only. A list of local inventories specific to different places.
      * This is only available for users who have Retail Search enabled, and it can
-     * be managed by [AddLocalInventories][] and [RemoveLocalInventories][] APIs.
+     * be managed by
+     * [ProductService.AddLocalInventories][google.cloud.retail.v2.ProductService.AddLocalInventories]
+     * and
+     * [ProductService.RemoveLocalInventories][google.cloud.retail.v2.ProductService.RemoveLocalInventories]
+     * APIs.
      * 
      
      *
      * 
@@ -13357,7 +13608,11 @@ public int getLocalInventoriesCount() {
      * 
            * Output only. A list of local inventories specific to different places.
      * This is only available for users who have Retail Search enabled, and it can
-     * be managed by [AddLocalInventories][] and [RemoveLocalInventories][] APIs.
+     * be managed by
+     * [ProductService.AddLocalInventories][google.cloud.retail.v2.ProductService.AddLocalInventories]
+     * and
+     * [ProductService.RemoveLocalInventories][google.cloud.retail.v2.ProductService.RemoveLocalInventories]
+     * APIs.
      * 
      
      *
      * 
@@ -13377,7 +13632,11 @@ public com.google.cloud.retail.v2.LocalInventory getLocalInventories(int index)
      * 
            * Output only. A list of local inventories specific to different places.
      * This is only available for users who have Retail Search enabled, and it can
-     * be managed by [AddLocalInventories][] and [RemoveLocalInventories][] APIs.
+     * be managed by
+     * [ProductService.AddLocalInventories][google.cloud.retail.v2.ProductService.AddLocalInventories]
+     * and
+     * [ProductService.RemoveLocalInventories][google.cloud.retail.v2.ProductService.RemoveLocalInventories]
+     * APIs.
      * 
      
      *
      * 
@@ -13403,7 +13662,11 @@ public Builder setLocalInventories(int index, com.google.cloud.retail.v2.LocalIn
      * 
            * Output only. A list of local inventories specific to different places.
      * This is only available for users who have Retail Search enabled, and it can
-     * be managed by [AddLocalInventories][] and [RemoveLocalInventories][] APIs.
+     * be managed by
+     * [ProductService.AddLocalInventories][google.cloud.retail.v2.ProductService.AddLocalInventories]
+     * and
+     * [ProductService.RemoveLocalInventories][google.cloud.retail.v2.ProductService.RemoveLocalInventories]
+     * APIs.
      * 
      
      *
      * 
@@ -13427,7 +13690,11 @@ public Builder setLocalInventories(
      * 
            * Output only. A list of local inventories specific to different places.
      * This is only available for users who have Retail Search enabled, and it can
-     * be managed by [AddLocalInventories][] and [RemoveLocalInventories][] APIs.
+     * be managed by
+     * [ProductService.AddLocalInventories][google.cloud.retail.v2.ProductService.AddLocalInventories]
+     * and
+     * [ProductService.RemoveLocalInventories][google.cloud.retail.v2.ProductService.RemoveLocalInventories]
+     * APIs.
      * 
      
      *
      * 
@@ -13453,7 +13720,11 @@ public Builder addLocalInventories(com.google.cloud.retail.v2.LocalInventory val
      * 
            * Output only. A list of local inventories specific to different places.
      * This is only available for users who have Retail Search enabled, and it can
-     * be managed by [AddLocalInventories][] and [RemoveLocalInventories][] APIs.
+     * be managed by
+     * [ProductService.AddLocalInventories][google.cloud.retail.v2.ProductService.AddLocalInventories]
+     * and
+     * [ProductService.RemoveLocalInventories][google.cloud.retail.v2.ProductService.RemoveLocalInventories]
+     * APIs.
      * 
      
      *
      * 
@@ -13479,7 +13750,11 @@ public Builder addLocalInventories(int index, com.google.cloud.retail.v2.LocalIn
      * 
            * Output only. A list of local inventories specific to different places.
      * This is only available for users who have Retail Search enabled, and it can
-     * be managed by [AddLocalInventories][] and [RemoveLocalInventories][] APIs.
+     * be managed by
+     * [ProductService.AddLocalInventories][google.cloud.retail.v2.ProductService.AddLocalInventories]
+     * and
+     * [ProductService.RemoveLocalInventories][google.cloud.retail.v2.ProductService.RemoveLocalInventories]
+     * APIs.
      * 
      
      *
      * 
@@ -13503,7 +13778,11 @@ public Builder addLocalInventories(
      * 
            * Output only. A list of local inventories specific to different places.
      * This is only available for users who have Retail Search enabled, and it can
-     * be managed by [AddLocalInventories][] and [RemoveLocalInventories][] APIs.
+     * be managed by
+     * [ProductService.AddLocalInventories][google.cloud.retail.v2.ProductService.AddLocalInventories]
+     * and
+     * [ProductService.RemoveLocalInventories][google.cloud.retail.v2.ProductService.RemoveLocalInventories]
+     * APIs.
      * 
      
      *
      * 
@@ -13527,7 +13806,11 @@ public Builder addLocalInventories(
      * 
            * Output only. A list of local inventories specific to different places.
      * This is only available for users who have Retail Search enabled, and it can
-     * be managed by [AddLocalInventories][] and [RemoveLocalInventories][] APIs.
+     * be managed by
+     * [ProductService.AddLocalInventories][google.cloud.retail.v2.ProductService.AddLocalInventories]
+     * and
+     * [ProductService.RemoveLocalInventories][google.cloud.retail.v2.ProductService.RemoveLocalInventories]
+     * APIs.
      * 
      
      *
      * 
@@ -13551,7 +13834,11 @@ public Builder addAllLocalInventories(
      * 
            * Output only. A list of local inventories specific to different places.
      * This is only available for users who have Retail Search enabled, and it can
-     * be managed by [AddLocalInventories][] and [RemoveLocalInventories][] APIs.
+     * be managed by
+     * [ProductService.AddLocalInventories][google.cloud.retail.v2.ProductService.AddLocalInventories]
+     * and
+     * [ProductService.RemoveLocalInventories][google.cloud.retail.v2.ProductService.RemoveLocalInventories]
+     * APIs.
      * 
      
      *
      * 
@@ -13574,7 +13861,11 @@ public Builder clearLocalInventories() {
      * 
            * Output only. A list of local inventories specific to different places.
      * This is only available for users who have Retail Search enabled, and it can
-     * be managed by [AddLocalInventories][] and [RemoveLocalInventories][] APIs.
+     * be managed by
+     * [ProductService.AddLocalInventories][google.cloud.retail.v2.ProductService.AddLocalInventories]
+     * and
+     * [ProductService.RemoveLocalInventories][google.cloud.retail.v2.ProductService.RemoveLocalInventories]
+     * APIs.
      * 
      
      *
      * 
@@ -13597,7 +13888,11 @@ public Builder removeLocalInventories(int index) {
      * 
            * Output only. A list of local inventories specific to different places.
      * This is only available for users who have Retail Search enabled, and it can
-     * be managed by [AddLocalInventories][] and [RemoveLocalInventories][] APIs.
+     * be managed by
+     * [ProductService.AddLocalInventories][google.cloud.retail.v2.ProductService.AddLocalInventories]
+     * and
+     * [ProductService.RemoveLocalInventories][google.cloud.retail.v2.ProductService.RemoveLocalInventories]
+     * APIs.
      * 
      
      *
      * 
@@ -13613,7 +13908,11 @@ public com.google.cloud.retail.v2.LocalInventory.Builder getLocalInventoriesBuil
      * 
            * Output only. A list of local inventories specific to different places.
      * This is only available for users who have Retail Search enabled, and it can
-     * be managed by [AddLocalInventories][] and [RemoveLocalInventories][] APIs.
+     * be managed by
+     * [ProductService.AddLocalInventories][google.cloud.retail.v2.ProductService.AddLocalInventories]
+     * and
+     * [ProductService.RemoveLocalInventories][google.cloud.retail.v2.ProductService.RemoveLocalInventories]
+     * APIs.
      * 
      
      *
      * 
@@ -13634,7 +13933,11 @@ public com.google.cloud.retail.v2.LocalInventoryOrBuilder getLocalInventoriesOrB
      * 
            * Output only. A list of local inventories specific to different places.
      * This is only available for users who have Retail Search enabled, and it can
-     * be managed by [AddLocalInventories][] and [RemoveLocalInventories][] APIs.
+     * be managed by
+     * [ProductService.AddLocalInventories][google.cloud.retail.v2.ProductService.AddLocalInventories]
+     * and
+     * [ProductService.RemoveLocalInventories][google.cloud.retail.v2.ProductService.RemoveLocalInventories]
+     * APIs.
      * 
      
      *
      * 
@@ -13655,7 +13958,11 @@ public com.google.cloud.retail.v2.LocalInventoryOrBuilder getLocalInventoriesOrB
      * 
            * Output only. A list of local inventories specific to different places.
      * This is only available for users who have Retail Search enabled, and it can
-     * be managed by [AddLocalInventories][] and [RemoveLocalInventories][] APIs.
+     * be managed by
+     * [ProductService.AddLocalInventories][google.cloud.retail.v2.ProductService.AddLocalInventories]
+     * and
+     * [ProductService.RemoveLocalInventories][google.cloud.retail.v2.ProductService.RemoveLocalInventories]
+     * APIs.
      * 
      
      *
      * 
@@ -13672,7 +13979,11 @@ public com.google.cloud.retail.v2.LocalInventory.Builder addLocalInventoriesBuil
      * 
            * Output only. A list of local inventories specific to different places.
      * This is only available for users who have Retail Search enabled, and it can
-     * be managed by [AddLocalInventories][] and [RemoveLocalInventories][] APIs.
+     * be managed by
+     * [ProductService.AddLocalInventories][google.cloud.retail.v2.ProductService.AddLocalInventories]
+     * and
+     * [ProductService.RemoveLocalInventories][google.cloud.retail.v2.ProductService.RemoveLocalInventories]
+     * APIs.
      * 
      
      *
      * 
@@ -13689,7 +14000,11 @@ public com.google.cloud.retail.v2.LocalInventory.Builder addLocalInventoriesBuil
      * 
            * Output only. A list of local inventories specific to different places.
      * This is only available for users who have Retail Search enabled, and it can
-     * be managed by [AddLocalInventories][] and [RemoveLocalInventories][] APIs.
+     * be managed by
+     * [ProductService.AddLocalInventories][google.cloud.retail.v2.ProductService.AddLocalInventories]
+     * and
+     * [ProductService.RemoveLocalInventories][google.cloud.retail.v2.ProductService.RemoveLocalInventories]
+     * APIs.
      * 
      
      *
      * 
diff --git a/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/ProductOrBuilder.java b/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/ProductOrBuilder.java
index 259795fc97b4..afd913828386 100644
--- a/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/ProductOrBuilder.java
+++ b/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/ProductOrBuilder.java
@@ -28,7 +28,13 @@ public interface ProductOrBuilder
    *
    * 
          * The timestamp when this product becomes unavailable for
-   * [SearchService.Search][google.cloud.retail.v2.SearchService.Search].
+   * [SearchService.Search][google.cloud.retail.v2.SearchService.Search]. Note
+   * that this is only applicable to
+   * [Type.PRIMARY][google.cloud.retail.v2.Product.Type.PRIMARY] and
+   * [Type.COLLECTION][google.cloud.retail.v2.Product.Type.COLLECTION], and
+   * ignored for [Type.VARIANT][google.cloud.retail.v2.Product.Type.VARIANT].
+   * In general, we suggest the users to delete the stale products explicitly,
+   * instead of using this field to determine staleness.
    * If it is set, the [Product][google.cloud.retail.v2.Product] is not
    * available for
    * [SearchService.Search][google.cloud.retail.v2.SearchService.Search] after
@@ -55,7 +61,13 @@ public interface ProductOrBuilder
    *
    * 
          * The timestamp when this product becomes unavailable for
-   * [SearchService.Search][google.cloud.retail.v2.SearchService.Search].
+   * [SearchService.Search][google.cloud.retail.v2.SearchService.Search]. Note
+   * that this is only applicable to
+   * [Type.PRIMARY][google.cloud.retail.v2.Product.Type.PRIMARY] and
+   * [Type.COLLECTION][google.cloud.retail.v2.Product.Type.COLLECTION], and
+   * ignored for [Type.VARIANT][google.cloud.retail.v2.Product.Type.VARIANT].
+   * In general, we suggest the users to delete the stale products explicitly,
+   * instead of using this field to determine staleness.
    * If it is set, the [Product][google.cloud.retail.v2.Product] is not
    * available for
    * [SearchService.Search][google.cloud.retail.v2.SearchService.Search] after
@@ -82,7 +94,13 @@ public interface ProductOrBuilder
    *
    * 
          * The timestamp when this product becomes unavailable for
-   * [SearchService.Search][google.cloud.retail.v2.SearchService.Search].
+   * [SearchService.Search][google.cloud.retail.v2.SearchService.Search]. Note
+   * that this is only applicable to
+   * [Type.PRIMARY][google.cloud.retail.v2.Product.Type.PRIMARY] and
+   * [Type.COLLECTION][google.cloud.retail.v2.Product.Type.COLLECTION], and
+   * ignored for [Type.VARIANT][google.cloud.retail.v2.Product.Type.VARIANT].
+   * In general, we suggest the users to delete the stale products explicitly,
+   * instead of using this field to determine staleness.
    * If it is set, the [Product][google.cloud.retail.v2.Product] is not
    * available for
    * [SearchService.Search][google.cloud.retail.v2.SearchService.Search] after
@@ -107,7 +125,13 @@ public interface ProductOrBuilder
    *
    *
    * 
      -   * Input only. The TTL (time to live) of the product.
+   * Input only. The TTL (time to live) of the product. Note that this is only
+   * applicable to [Type.PRIMARY][google.cloud.retail.v2.Product.Type.PRIMARY]
+   * and [Type.COLLECTION][google.cloud.retail.v2.Product.Type.COLLECTION],
+   * and ignored for
+   * [Type.VARIANT][google.cloud.retail.v2.Product.Type.VARIANT]. In general,
+   * we suggest the users to delete the stale products explicitly, instead of
+   * using this field to determine staleness.
    * If it is set, it must be a non-negative value, and
    * [expire_time][google.cloud.retail.v2.Product.expire_time] is set as
    * current timestamp plus [ttl][google.cloud.retail.v2.Product.ttl]. The
@@ -132,7 +156,13 @@ public interface ProductOrBuilder
    *
    *
    * 
      -   * Input only. The TTL (time to live) of the product.
+   * Input only. The TTL (time to live) of the product. Note that this is only
+   * applicable to [Type.PRIMARY][google.cloud.retail.v2.Product.Type.PRIMARY]
+   * and [Type.COLLECTION][google.cloud.retail.v2.Product.Type.COLLECTION],
+   * and ignored for
+   * [Type.VARIANT][google.cloud.retail.v2.Product.Type.VARIANT]. In general,
+   * we suggest the users to delete the stale products explicitly, instead of
+   * using this field to determine staleness.
    * If it is set, it must be a non-negative value, and
    * [expire_time][google.cloud.retail.v2.Product.expire_time] is set as
    * current timestamp plus [ttl][google.cloud.retail.v2.Product.ttl]. The
@@ -157,7 +187,13 @@ public interface ProductOrBuilder
    *
    *
    * 
      -   * Input only. The TTL (time to live) of the product.
+   * Input only. The TTL (time to live) of the product. Note that this is only
+   * applicable to [Type.PRIMARY][google.cloud.retail.v2.Product.Type.PRIMARY]
+   * and [Type.COLLECTION][google.cloud.retail.v2.Product.Type.COLLECTION],
+   * and ignored for
+   * [Type.VARIANT][google.cloud.retail.v2.Product.Type.VARIANT]. In general,
+   * we suggest the users to delete the stale products explicitly, instead of
+   * using this field to determine staleness.
    * If it is set, it must be a non-negative value, and
    * [expire_time][google.cloud.retail.v2.Product.expire_time] is set as
    * current timestamp plus [ttl][google.cloud.retail.v2.Product.ttl]. The
@@ -477,7 +513,7 @@ public interface ProductOrBuilder
    * belonging to several parallel categories. Strongly recommended using the
    * full path for better search / recommendation quality.
    * To represent full path of category, use '>' sign to separate different
-   * hierarchies. If '>' is part of the category name, please replace it with
+   * hierarchies. If '>' is part of the category name, replace it with
    * other character(s).
    * For example, if a shoes product belongs to both
    * ["Shoes & Accessories" -> "Shoes"] and
@@ -514,7 +550,7 @@ public interface ProductOrBuilder
    * belonging to several parallel categories. Strongly recommended using the
    * full path for better search / recommendation quality.
    * To represent full path of category, use '>' sign to separate different
-   * hierarchies. If '>' is part of the category name, please replace it with
+   * hierarchies. If '>' is part of the category name, replace it with
    * other character(s).
    * For example, if a shoes product belongs to both
    * ["Shoes & Accessories" -> "Shoes"] and
@@ -551,7 +587,7 @@ public interface ProductOrBuilder
    * belonging to several parallel categories. Strongly recommended using the
    * full path for better search / recommendation quality.
    * To represent full path of category, use '>' sign to separate different
-   * hierarchies. If '>' is part of the category name, please replace it with
+   * hierarchies. If '>' is part of the category name, replace it with
    * other character(s).
    * For example, if a shoes product belongs to both
    * ["Shoes & Accessories" -> "Shoes"] and
@@ -589,7 +625,7 @@ public interface ProductOrBuilder
    * belonging to several parallel categories. Strongly recommended using the
    * full path for better search / recommendation quality.
    * To represent full path of category, use '>' sign to separate different
-   * hierarchies. If '>' is part of the category name, please replace it with
+   * hierarchies. If '>' is part of the category name, replace it with
    * other character(s).
    * For example, if a shoes product belongs to both
    * ["Shoes & Accessories" -> "Shoes"] and
@@ -1147,7 +1183,11 @@ com.google.cloud.retail.v2.CustomAttribute getAttributesOrDefault(
    * 
          * The timestamp when this [Product][google.cloud.retail.v2.Product] becomes
    * available for
-   * [SearchService.Search][google.cloud.retail.v2.SearchService.Search].
+   * [SearchService.Search][google.cloud.retail.v2.SearchService.Search]. Note
+   * that this is only applicable to
+   * [Type.PRIMARY][google.cloud.retail.v2.Product.Type.PRIMARY] and
+   * [Type.COLLECTION][google.cloud.retail.v2.Product.Type.COLLECTION], and
+   * ignored for [Type.VARIANT][google.cloud.retail.v2.Product.Type.VARIANT].
    * 
      
    *
    * .google.protobuf.Timestamp available_time = 18;
@@ -1161,7 +1201,11 @@ com.google.cloud.retail.v2.CustomAttribute getAttributesOrDefault(
    * 
          * The timestamp when this [Product][google.cloud.retail.v2.Product] becomes
    * available for
-   * [SearchService.Search][google.cloud.retail.v2.SearchService.Search].
+   * [SearchService.Search][google.cloud.retail.v2.SearchService.Search]. Note
+   * that this is only applicable to
+   * [Type.PRIMARY][google.cloud.retail.v2.Product.Type.PRIMARY] and
+   * [Type.COLLECTION][google.cloud.retail.v2.Product.Type.COLLECTION], and
+   * ignored for [Type.VARIANT][google.cloud.retail.v2.Product.Type.VARIANT].
    * 
      
    *
    * .google.protobuf.Timestamp available_time = 18;
@@ -1175,7 +1219,11 @@ com.google.cloud.retail.v2.CustomAttribute getAttributesOrDefault(
    * 
          * The timestamp when this [Product][google.cloud.retail.v2.Product] becomes
    * available for
-   * [SearchService.Search][google.cloud.retail.v2.SearchService.Search].
+   * [SearchService.Search][google.cloud.retail.v2.SearchService.Search]. Note
+   * that this is only applicable to
+   * [Type.PRIMARY][google.cloud.retail.v2.Product.Type.PRIMARY] and
+   * [Type.COLLECTION][google.cloud.retail.v2.Product.Type.COLLECTION], and
+   * ignored for [Type.VARIANT][google.cloud.retail.v2.Product.Type.VARIANT].
    * 
      
    *
    * .google.protobuf.Timestamp available_time = 18;
@@ -2038,12 +2086,16 @@ com.google.cloud.retail.v2.CustomAttribute getAttributesOrDefault(
    * Note: Returning more fields in
    * [SearchResponse][google.cloud.retail.v2.SearchResponse] can increase
    * response payload size and serving latency.
+   * This field is deprecated. Use the retrievable site-wide control instead.
    * 
      
    *
-   * .google.protobuf.FieldMask retrievable_fields = 30;
+   * .google.protobuf.FieldMask retrievable_fields = 30 [deprecated = true];
    *
+   * @deprecated google.cloud.retail.v2.Product.retrievable_fields is deprecated. See
+   *     google/cloud/retail/v2/product.proto;l=562
    * @return Whether the retrievableFields field is set.
    */
+  @java.lang.Deprecated
   boolean hasRetrievableFields();
   /**
    *
@@ -2093,12 +2145,16 @@ com.google.cloud.retail.v2.CustomAttribute getAttributesOrDefault(
    * Note: Returning more fields in
    * [SearchResponse][google.cloud.retail.v2.SearchResponse] can increase
    * response payload size and serving latency.
+   * This field is deprecated. Use the retrievable site-wide control instead.
    * 
      
    *
-   * .google.protobuf.FieldMask retrievable_fields = 30;
+   * .google.protobuf.FieldMask retrievable_fields = 30 [deprecated = true];
    *
+   * @deprecated google.cloud.retail.v2.Product.retrievable_fields is deprecated. See
+   *     google/cloud/retail/v2/product.proto;l=562
    * @return The retrievableFields.
    */
+  @java.lang.Deprecated
   com.google.protobuf.FieldMask getRetrievableFields();
   /**
    *
@@ -2148,10 +2204,12 @@ com.google.cloud.retail.v2.CustomAttribute getAttributesOrDefault(
    * Note: Returning more fields in
    * [SearchResponse][google.cloud.retail.v2.SearchResponse] can increase
    * response payload size and serving latency.
+   * This field is deprecated. Use the retrievable site-wide control instead.
    * 
      
    *
-   * .google.protobuf.FieldMask retrievable_fields = 30;
+   * .google.protobuf.FieldMask retrievable_fields = 30 [deprecated = true];
    */
+  @java.lang.Deprecated
   com.google.protobuf.FieldMaskOrBuilder getRetrievableFieldsOrBuilder();
 
   /**
@@ -2261,7 +2319,11 @@ com.google.cloud.retail.v2.CustomAttribute getAttributesOrDefault(
    * 
          * Output only. A list of local inventories specific to different places.
    * This is only available for users who have Retail Search enabled, and it can
-   * be managed by [AddLocalInventories][] and [RemoveLocalInventories][] APIs.
+   * be managed by
+   * [ProductService.AddLocalInventories][google.cloud.retail.v2.ProductService.AddLocalInventories]
+   * and
+   * [ProductService.RemoveLocalInventories][google.cloud.retail.v2.ProductService.RemoveLocalInventories]
+   * APIs.
    * 
      
    *
    * 
@@ -2275,7 +2337,11 @@ com.google.cloud.retail.v2.CustomAttribute getAttributesOrDefault(
    * 
          * Output only. A list of local inventories specific to different places.
    * This is only available for users who have Retail Search enabled, and it can
-   * be managed by [AddLocalInventories][] and [RemoveLocalInventories][] APIs.
+   * be managed by
+   * [ProductService.AddLocalInventories][google.cloud.retail.v2.ProductService.AddLocalInventories]
+   * and
+   * [ProductService.RemoveLocalInventories][google.cloud.retail.v2.ProductService.RemoveLocalInventories]
+   * APIs.
    * 
      
    *
    * 
@@ -2289,7 +2355,11 @@ com.google.cloud.retail.v2.CustomAttribute getAttributesOrDefault(
    * 
          * Output only. A list of local inventories specific to different places.
    * This is only available for users who have Retail Search enabled, and it can
-   * be managed by [AddLocalInventories][] and [RemoveLocalInventories][] APIs.
+   * be managed by
+   * [ProductService.AddLocalInventories][google.cloud.retail.v2.ProductService.AddLocalInventories]
+   * and
+   * [ProductService.RemoveLocalInventories][google.cloud.retail.v2.ProductService.RemoveLocalInventories]
+   * APIs.
    * 
      
    *
    * 
@@ -2303,7 +2373,11 @@ com.google.cloud.retail.v2.CustomAttribute getAttributesOrDefault(
    * 
          * Output only. A list of local inventories specific to different places.
    * This is only available for users who have Retail Search enabled, and it can
-   * be managed by [AddLocalInventories][] and [RemoveLocalInventories][] APIs.
+   * be managed by
+   * [ProductService.AddLocalInventories][google.cloud.retail.v2.ProductService.AddLocalInventories]
+   * and
+   * [ProductService.RemoveLocalInventories][google.cloud.retail.v2.ProductService.RemoveLocalInventories]
+   * APIs.
    * 
      
    *
    * 
@@ -2318,7 +2392,11 @@ com.google.cloud.retail.v2.CustomAttribute getAttributesOrDefault(
    * 
          * Output only. A list of local inventories specific to different places.
    * This is only available for users who have Retail Search enabled, and it can
-   * be managed by [AddLocalInventories][] and [RemoveLocalInventories][] APIs.
+   * be managed by
+   * [ProductService.AddLocalInventories][google.cloud.retail.v2.ProductService.AddLocalInventories]
+   * and
+   * [ProductService.RemoveLocalInventories][google.cloud.retail.v2.ProductService.RemoveLocalInventories]
+   * APIs.
    * 
      
    *
    * 
diff --git a/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/ProductProto.java b/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/ProductProto.java
index e084911b5821..9ef5a054dba0 100644
--- a/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/ProductProto.java
+++ b/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/ProductProto.java
@@ -52,7 +52,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
           + "\036google/protobuf/duration.proto\032 google/"
           + "protobuf/field_mask.proto\032\037google/protob"
           + "uf/timestamp.proto\032\036google/protobuf/wrap"
-          + "pers.proto\"\327\r\n\007Product\0221\n\013expire_time\030\020 "
+          + "pers.proto\"\333\r\n\007Product\0221\n\013expire_time\030\020 "
           + "\001(\0132\032.google.protobuf.TimestampH\000\022-\n\003ttl"
           + "\030\021 \001(\0132\031.google.protobuf.DurationB\003\340A\004H\000"
           + "\022\021\n\004name\030\001 \001(\tB\003\340A\005\022\017\n\002id\030\002 \001(\tB\003\340A\005\0227\n\004"
@@ -81,29 +81,30 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
           + "onditions\030\035 \003(\t\0225\n\npromotions\030\" \003(\0132!.go"
           + "ogle.cloud.retail.v2.Promotion\0220\n\014publis"
           + "h_time\030! \001(\0132\032.google.protobuf.Timestamp"
-          + "\0226\n\022retrievable_fields\030\036 \001(\0132\032.google.pr"
-          + "otobuf.FieldMask\0226\n\010variants\030\037 \003(\0132\037.goo"
-          + "gle.cloud.retail.v2.ProductB\003\340A\003\022F\n\021loca"
-          + "l_inventories\030# \003(\0132&.google.cloud.retai"
-          + "l.v2.LocalInventoryB\003\340A\003\032Z\n\017AttributesEn"
-          + "try\022\013\n\003key\030\001 \001(\t\0226\n\005value\030\002 \001(\0132\'.google"
-          + ".cloud.retail.v2.CustomAttribute:\0028\001\"F\n\004"
-          + "Type\022\024\n\020TYPE_UNSPECIFIED\020\000\022\013\n\007PRIMARY\020\001\022"
-          + "\013\n\007VARIANT\020\002\022\016\n\nCOLLECTION\020\003\"i\n\014Availabi"
-          + "lity\022\034\n\030AVAILABILITY_UNSPECIFIED\020\000\022\014\n\010IN"
-          + "_STOCK\020\001\022\020\n\014OUT_OF_STOCK\020\002\022\014\n\010PREORDER\020\003"
-          + "\022\r\n\tBACKORDER\020\004:\204\001\352A\200\001\n\035retail.googleapi"
-          + "s.com/Product\022_projects/{project}/locati"
-          + "ons/{location}/catalogs/{catalog}/branch"
-          + "es/{branch}/products/{product}B\014\n\nexpira"
-          + "tionB\260\002\n\032com.google.cloud.retail.v2B\014Pro"
-          + "ductProtoP\001Z
- * Metadata for RejoinUserEvents method.
+ * Metadata for `RejoinUserEvents` method.
  * 
      
  *
  * Protobuf type {@code google.cloud.retail.v2.RejoinUserEventsMetadata}
@@ -219,7 +219,7 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
    *
    *
    * 
      -   * Metadata for RejoinUserEvents method.
+   * Metadata for `RejoinUserEvents` method.
    * 
      
    *
    * Protobuf type {@code google.cloud.retail.v2.RejoinUserEventsMetadata}
diff --git a/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/RejoinUserEventsRequest.java b/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/RejoinUserEventsRequest.java
index cb61e65a9b34..cbb9d6601d85 100644
--- a/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/RejoinUserEventsRequest.java
+++ b/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/RejoinUserEventsRequest.java
@@ -74,11 +74,11 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    * 
          * The scope of user events to be rejoined with the latest product catalog.
    * If the rejoining aims at reducing number of unjoined events, set
-   * UserEventRejoinScope to UNJOINED_EVENTS.
+   * `UserEventRejoinScope` to `UNJOINED_EVENTS`.
    * If the rejoining aims at correcting product catalog information in joined
-   * events, set UserEventRejoinScope to JOINED_EVENTS.
-   * If all events needs to be rejoined, set UserEventRejoinScope to
-   * USER_EVENT_REJOIN_SCOPE_UNSPECIFIED.
+   * events, set `UserEventRejoinScope` to `JOINED_EVENTS`.
+   * If all events needs to be rejoined, set `UserEventRejoinScope` to
+   * `USER_EVENT_REJOIN_SCOPE_UNSPECIFIED`.
    * 
      
    *
    * Protobuf enum {@code google.cloud.retail.v2.RejoinUserEventsRequest.UserEventRejoinScope}
@@ -297,8 +297,8 @@ public com.google.protobuf.ByteString getParentBytes() {
    * 
          * The type of the user event rejoin to define the scope and range of the user
    * events to be rejoined with the latest product catalog. Defaults to
-   * USER_EVENT_REJOIN_SCOPE_UNSPECIFIED if this field is not set, or set to an
-   * invalid integer value.
+   * `USER_EVENT_REJOIN_SCOPE_UNSPECIFIED` if this field is not set, or set to
+   * an invalid integer value.
    * 
      
    *
    * 
@@ -317,8 +317,8 @@ public int getUserEventRejoinScopeValue() {
    * 
          * The type of the user event rejoin to define the scope and range of the user
    * events to be rejoined with the latest product catalog. Defaults to
-   * USER_EVENT_REJOIN_SCOPE_UNSPECIFIED if this field is not set, or set to an
-   * invalid integer value.
+   * `USER_EVENT_REJOIN_SCOPE_UNSPECIFIED` if this field is not set, or set to
+   * an invalid integer value.
    * 
      
    *
    * 
@@ -814,8 +814,8 @@ public Builder setParentBytes(com.google.protobuf.ByteString value) {
      * 
            * The type of the user event rejoin to define the scope and range of the user
      * events to be rejoined with the latest product catalog. Defaults to
-     * USER_EVENT_REJOIN_SCOPE_UNSPECIFIED if this field is not set, or set to an
-     * invalid integer value.
+     * `USER_EVENT_REJOIN_SCOPE_UNSPECIFIED` if this field is not set, or set to
+     * an invalid integer value.
      * 
      
      *
      * 
@@ -834,8 +834,8 @@ public int getUserEventRejoinScopeValue() {
      * 
            * The type of the user event rejoin to define the scope and range of the user
      * events to be rejoined with the latest product catalog. Defaults to
-     * USER_EVENT_REJOIN_SCOPE_UNSPECIFIED if this field is not set, or set to an
-     * invalid integer value.
+     * `USER_EVENT_REJOIN_SCOPE_UNSPECIFIED` if this field is not set, or set to
+     * an invalid integer value.
      * 
      
      *
      * 
@@ -857,8 +857,8 @@ public Builder setUserEventRejoinScopeValue(int value) {
      * 
            * The type of the user event rejoin to define the scope and range of the user
      * events to be rejoined with the latest product catalog. Defaults to
-     * USER_EVENT_REJOIN_SCOPE_UNSPECIFIED if this field is not set, or set to an
-     * invalid integer value.
+     * `USER_EVENT_REJOIN_SCOPE_UNSPECIFIED` if this field is not set, or set to
+     * an invalid integer value.
      * 
      
      *
      * 
@@ -884,8 +884,8 @@ public Builder setUserEventRejoinScopeValue(int value) {
      * 
            * The type of the user event rejoin to define the scope and range of the user
      * events to be rejoined with the latest product catalog. Defaults to
-     * USER_EVENT_REJOIN_SCOPE_UNSPECIFIED if this field is not set, or set to an
-     * invalid integer value.
+     * `USER_EVENT_REJOIN_SCOPE_UNSPECIFIED` if this field is not set, or set to
+     * an invalid integer value.
      * 
      
      *
      * 
@@ -911,8 +911,8 @@ public Builder setUserEventRejoinScope(
      * 
            * The type of the user event rejoin to define the scope and range of the user
      * events to be rejoined with the latest product catalog. Defaults to
-     * USER_EVENT_REJOIN_SCOPE_UNSPECIFIED if this field is not set, or set to an
-     * invalid integer value.
+     * `USER_EVENT_REJOIN_SCOPE_UNSPECIFIED` if this field is not set, or set to
+     * an invalid integer value.
      * 
      
      *
      * 
diff --git a/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/RejoinUserEventsRequestOrBuilder.java b/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/RejoinUserEventsRequestOrBuilder.java
index b57a63a2ef3c..20819f83c10b 100644
--- a/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/RejoinUserEventsRequestOrBuilder.java
+++ b/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/RejoinUserEventsRequestOrBuilder.java
@@ -56,8 +56,8 @@ public interface RejoinUserEventsRequestOrBuilder
    * 
          * The type of the user event rejoin to define the scope and range of the user
    * events to be rejoined with the latest product catalog. Defaults to
-   * USER_EVENT_REJOIN_SCOPE_UNSPECIFIED if this field is not set, or set to an
-   * invalid integer value.
+   * `USER_EVENT_REJOIN_SCOPE_UNSPECIFIED` if this field is not set, or set to
+   * an invalid integer value.
    * 
      
    *
    * 
@@ -73,8 +73,8 @@ public interface RejoinUserEventsRequestOrBuilder
    * 
          * The type of the user event rejoin to define the scope and range of the user
    * events to be rejoined with the latest product catalog. Defaults to
-   * USER_EVENT_REJOIN_SCOPE_UNSPECIFIED if this field is not set, or set to an
-   * invalid integer value.
+   * `USER_EVENT_REJOIN_SCOPE_UNSPECIFIED` if this field is not set, or set to
+   * an invalid integer value.
    * 
      
    *
    * 
diff --git a/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/RejoinUserEventsResponse.java b/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/RejoinUserEventsResponse.java
index b8ef64719211..c0332d930458 100644
--- a/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/RejoinUserEventsResponse.java
+++ b/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/RejoinUserEventsResponse.java
@@ -22,7 +22,7 @@
  *
  *
  * 
      - * Response message for RejoinUserEvents method.
+ * Response message for `RejoinUserEvents` method.
  * 
      
  *
  * Protobuf type {@code google.cloud.retail.v2.RejoinUserEventsResponse}
@@ -246,7 +246,7 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
    *
    *
    * 
      -   * Response message for RejoinUserEvents method.
+   * Response message for `RejoinUserEvents` method.
    * 
      
    *
    * Protobuf type {@code google.cloud.retail.v2.RejoinUserEventsResponse}
diff --git a/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/RemoveControlRequest.java b/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/RemoveControlRequest.java
index 32eea19ddcd8..9074bc94bcc5 100644
--- a/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/RemoveControlRequest.java
+++ b/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/RemoveControlRequest.java
@@ -75,7 +75,7 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    *
    * 
          * Required. The source ServingConfig resource name . Format:
-   * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+   * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
    * 
      
    *
    * 
@@ -101,7 +101,7 @@ public java.lang.String getServingConfig() {
    *
    * 
          * Required. The source ServingConfig resource name . Format:
-   * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+   * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
    * 
      
    *
    * 
@@ -532,7 +532,7 @@ public Builder mergeFrom(
      *
      * 
            * Required. The source ServingConfig resource name . Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
      * 
      
      *
      * 
@@ -557,7 +557,7 @@ public java.lang.String getServingConfig() {
      *
      * 
            * Required. The source ServingConfig resource name . Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
      * 
      
      *
      * 
@@ -582,7 +582,7 @@ public com.google.protobuf.ByteString getServingConfigBytes() {
      *
      * 
            * Required. The source ServingConfig resource name . Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
      * 
      
      *
      * 
@@ -606,7 +606,7 @@ public Builder setServingConfig(java.lang.String value) {
      *
      * 
            * Required. The source ServingConfig resource name . Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
      * 
      
      *
      * 
@@ -626,7 +626,7 @@ public Builder clearServingConfig() {
      *
      * 
            * Required. The source ServingConfig resource name . Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
      * 
      
      *
      * 
diff --git a/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/RemoveControlRequestOrBuilder.java b/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/RemoveControlRequestOrBuilder.java
index 03b719e802d0..fe697cbae8a0 100644
--- a/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/RemoveControlRequestOrBuilder.java
+++ b/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/RemoveControlRequestOrBuilder.java
@@ -28,7 +28,7 @@ public interface RemoveControlRequestOrBuilder
    *
    * 
          * Required. The source ServingConfig resource name . Format:
-   * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+   * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
    * 
      
    *
    * 
@@ -43,7 +43,7 @@ public interface RemoveControlRequestOrBuilder
    *
    * 
          * Required. The source ServingConfig resource name . Format:
-   * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+   * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
    * 
      
    *
    * 
diff --git a/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/Rule.java b/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/Rule.java
index 29ff918d58e8..a22acd78aa15 100644
--- a/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/Rule.java
+++ b/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/Rule.java
@@ -2444,7 +2444,7 @@ public interface TwowaySynonymsActionOrBuilder
    *
    * 
          * Creates a set of terms that will be treated as synonyms of each other.
-   * Example: synonyms of "sneakers" and "shoes".
+   * Example: synonyms of "sneakers" and "shoes":
    *  * "sneakers" will use a synonym of "shoes".
    *  * "shoes" will use a synonym of "sneakers".
    * 
      
@@ -2733,7 +2733,7 @@ protected Builder newBuilderForType(
      *
      * 
            * Creates a set of terms that will be treated as synonyms of each other.
-     * Example: synonyms of "sneakers" and "shoes".
+     * Example: synonyms of "sneakers" and "shoes":
      *  * "sneakers" will use a synonym of "shoes".
      *  * "shoes" will use a synonym of "sneakers".
      * 
      
diff --git a/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/SearchRequest.java b/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/SearchRequest.java
index f1ba378234a3..e16bb8084867 100644
--- a/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/SearchRequest.java
+++ b/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/SearchRequest.java
@@ -105,8 +105,10 @@ public enum SearchMode implements com.google.protobuf.ProtocolMessageEnum {
      *
      * 
            * Default value. In this case both product search and faceted search will
-     * be performed. Both [SearchResponse.SearchResult] and
-     * [SearchResponse.Facet] will be returned.
+     * be performed. Both
+     * [SearchResponse.SearchResult][google.cloud.retail.v2.SearchResponse.SearchResult]
+     * and [SearchResponse.Facet][google.cloud.retail.v2.SearchResponse.Facet]
+     * will be returned.
      * 
      
      *
      * SEARCH_MODE_UNSPECIFIED = 0;
@@ -118,8 +120,11 @@ public enum SearchMode implements com.google.protobuf.ProtocolMessageEnum {
      * 
            * Only product search will be performed. The faceted search will be
      * disabled.
-     * Only [SearchResponse.SearchResult] will be returned.
-     * [SearchResponse.Facet] will not be returned, even if
+     * Only
+     * [SearchResponse.SearchResult][google.cloud.retail.v2.SearchResponse.SearchResult]
+     * will be returned.
+     * [SearchResponse.Facet][google.cloud.retail.v2.SearchResponse.Facet] will
+     * not be returned, even if
      * [SearchRequest.facet_specs][google.cloud.retail.v2.SearchRequest.facet_specs]
      * or
      * [SearchRequest.dynamic_facet_spec][google.cloud.retail.v2.SearchRequest.dynamic_facet_spec]
@@ -140,7 +145,9 @@ public enum SearchMode implements com.google.protobuf.ProtocolMessageEnum {
      * and
      * [SearchRequest.dynamic_facet_spec][google.cloud.retail.v2.SearchRequest.dynamic_facet_spec]
      * should be set. Otherwise, an INVALID_ARGUMENT error is returned. Only
-     * [SearchResponse.Facet] will be returned. [SearchResponse.SearchResult]
+     * [SearchResponse.Facet][google.cloud.retail.v2.SearchResponse.Facet] will
+     * be returned.
+     * [SearchResponse.SearchResult][google.cloud.retail.v2.SearchResponse.SearchResult]
      * will not be returned.
      * 
      
      *
@@ -155,8 +162,10 @@ public enum SearchMode implements com.google.protobuf.ProtocolMessageEnum {
      *
      * 
            * Default value. In this case both product search and faceted search will
-     * be performed. Both [SearchResponse.SearchResult] and
-     * [SearchResponse.Facet] will be returned.
+     * be performed. Both
+     * [SearchResponse.SearchResult][google.cloud.retail.v2.SearchResponse.SearchResult]
+     * and [SearchResponse.Facet][google.cloud.retail.v2.SearchResponse.Facet]
+     * will be returned.
      * 
      
      *
      * SEARCH_MODE_UNSPECIFIED = 0;
@@ -168,8 +177,11 @@ public enum SearchMode implements com.google.protobuf.ProtocolMessageEnum {
      * 
            * Only product search will be performed. The faceted search will be
      * disabled.
-     * Only [SearchResponse.SearchResult] will be returned.
-     * [SearchResponse.Facet] will not be returned, even if
+     * Only
+     * [SearchResponse.SearchResult][google.cloud.retail.v2.SearchResponse.SearchResult]
+     * will be returned.
+     * [SearchResponse.Facet][google.cloud.retail.v2.SearchResponse.Facet] will
+     * not be returned, even if
      * [SearchRequest.facet_specs][google.cloud.retail.v2.SearchRequest.facet_specs]
      * or
      * [SearchRequest.dynamic_facet_spec][google.cloud.retail.v2.SearchRequest.dynamic_facet_spec]
@@ -190,7 +202,9 @@ public enum SearchMode implements com.google.protobuf.ProtocolMessageEnum {
      * and
      * [SearchRequest.dynamic_facet_spec][google.cloud.retail.v2.SearchRequest.dynamic_facet_spec]
      * should be set. Otherwise, an INVALID_ARGUMENT error is returned. Only
-     * [SearchResponse.Facet] will be returned. [SearchResponse.SearchResult]
+     * [SearchResponse.Facet][google.cloud.retail.v2.SearchResponse.Facet] will
+     * be returned.
+     * [SearchResponse.SearchResult][google.cloud.retail.v2.SearchResponse.SearchResult]
      * will not be returned.
      * 
      
      *
@@ -332,7 +346,7 @@ public interface FacetSpecOrBuilder
      *
      * 
            * Maximum of facet values that should be returned for this facet. If
-     * unspecified, defaults to 20. The maximum allowed value is 300. Values
+     * unspecified, defaults to 50. The maximum allowed value is 300. Values
      * above 300 will be coerced to 300.
      * If this field is negative, an INVALID_ARGUMENT is returned.
      * 
      
@@ -4481,7 +4495,7 @@ public com.google.cloud.retail.v2.SearchRequest.FacetSpec.FacetKey getFacetKey()
      *
      * 
            * Maximum of facet values that should be returned for this facet. If
-     * unspecified, defaults to 20. The maximum allowed value is 300. Values
+     * unspecified, defaults to 50. The maximum allowed value is 300. Values
      * above 300 will be coerced to 300.
      * If this field is negative, an INVALID_ARGUMENT is returned.
      * 
      
@@ -5325,7 +5339,7 @@ public Builder clearFacetKey() {
        *
        * 
              * Maximum of facet values that should be returned for this facet. If
-       * unspecified, defaults to 20. The maximum allowed value is 300. Values
+       * unspecified, defaults to 50. The maximum allowed value is 300. Values
        * above 300 will be coerced to 300.
        * If this field is negative, an INVALID_ARGUMENT is returned.
        * 
      
@@ -5343,7 +5357,7 @@ public int getLimit() {
        *
        * 
              * Maximum of facet values that should be returned for this facet. If
-       * unspecified, defaults to 20. The maximum allowed value is 300. Values
+       * unspecified, defaults to 50. The maximum allowed value is 300. Values
        * above 300 will be coerced to 300.
        * If this field is negative, an INVALID_ARGUMENT is returned.
        * 
      
@@ -5364,7 +5378,7 @@ public Builder setLimit(int value) {
        *
        * 
              * Maximum of facet values that should be returned for this facet. If
-       * unspecified, defaults to 20. The maximum allowed value is 300. Values
+       * unspecified, defaults to 50. The maximum allowed value is 300. Values
        * above 300 will be coerced to 300.
        * If this field is negative, an INVALID_ARGUMENT is returned.
        * 
      
@@ -11497,7 +11511,7 @@ public com.google.protobuf.Parser getParserForType() {
    * `projects/*/locations/global/catalogs/default_catalog/servingConfigs/default_serving_config`
    * or the name of the legacy placement resource, such as
    * `projects/*/locations/global/catalogs/default_catalog/placements/default_search`.
-   * This field is used to identify the serving configuration name and the set
+   * This field is used to identify the serving config name and the set
    * of models that will be used to make the search.
    * 
      
    *
@@ -11525,7 +11539,7 @@ public java.lang.String getPlacement() {
    * `projects/*/locations/global/catalogs/default_catalog/servingConfigs/default_serving_config`
    * or the name of the legacy placement resource, such as
    * `projects/*/locations/global/catalogs/default_catalog/placements/default_search`.
-   * This field is used to identify the serving configuration name and the set
+   * This field is used to identify the serving config name and the set
    * of models that will be used to make the search.
    * 
      
    *
@@ -12156,7 +12170,7 @@ public com.google.cloud.retail.v2.SearchRequest.FacetSpecOrBuilder getFacetSpecs
    * 
    *
    * @deprecated google.cloud.retail.v2.SearchRequest.dynamic_facet_spec is deprecated. See
-   *     google/cloud/retail/v2/search_service.proto;l=576
+   *     google/cloud/retail/v2/search_service.proto;l=583
    * @return Whether the dynamicFacetSpec field is set.
    */
   @java.lang.Override
@@ -12179,7 +12193,7 @@ public boolean hasDynamicFacetSpec() {
    * 
    *
    * @deprecated google.cloud.retail.v2.SearchRequest.dynamic_facet_spec is deprecated. See
-   *     google/cloud/retail/v2/search_service.proto;l=576
+   *     google/cloud/retail/v2/search_service.proto;l=583
    * @return The dynamicFacetSpec.
    */
   @java.lang.Override
@@ -12672,7 +12686,7 @@ public com.google.protobuf.ByteString getVariantRollupKeysBytes(int index) {
    * the same as
    * [UserEvent.page_categories][google.cloud.retail.v2.UserEvent.page_categories];
    * To represent full path of category, use '>' sign to separate different
-   * hierarchies. If '>' is part of the category name, please replace it with
+   * hierarchies. If '>' is part of the category name, replace it with
    * other character(s).
    * Category pages include special pages such as sales or promotions. For
    * instance, a special sale page may have the category hierarchy:
@@ -12695,7 +12709,7 @@ public com.google.protobuf.ProtocolStringList getPageCategoriesList() {
    * the same as
    * [UserEvent.page_categories][google.cloud.retail.v2.UserEvent.page_categories];
    * To represent full path of category, use '>' sign to separate different
-   * hierarchies. If '>' is part of the category name, please replace it with
+   * hierarchies. If '>' is part of the category name, replace it with
    * other character(s).
    * Category pages include special pages such as sales or promotions. For
    * instance, a special sale page may have the category hierarchy:
@@ -12718,7 +12732,7 @@ public int getPageCategoriesCount() {
    * the same as
    * [UserEvent.page_categories][google.cloud.retail.v2.UserEvent.page_categories];
    * To represent full path of category, use '>' sign to separate different
-   * hierarchies. If '>' is part of the category name, please replace it with
+   * hierarchies. If '>' is part of the category name, replace it with
    * other character(s).
    * Category pages include special pages such as sales or promotions. For
    * instance, a special sale page may have the category hierarchy:
@@ -12742,7 +12756,7 @@ public java.lang.String getPageCategories(int index) {
    * the same as
    * [UserEvent.page_categories][google.cloud.retail.v2.UserEvent.page_categories];
    * To represent full path of category, use '>' sign to separate different
-   * hierarchies. If '>' is part of the category name, please replace it with
+   * hierarchies. If '>' is part of the category name, replace it with
    * other character(s).
    * Category pages include special pages such as sales or promotions. For
    * instance, a special sale page may have the category hierarchy:
@@ -14075,7 +14089,7 @@ public Builder mergeFrom(
      * `projects/*/locations/global/catalogs/default_catalog/servingConfigs/default_serving_config`
      * or the name of the legacy placement resource, such as
      * `projects/*/locations/global/catalogs/default_catalog/placements/default_search`.
-     * This field is used to identify the serving configuration name and the set
+     * This field is used to identify the serving config name and the set
      * of models that will be used to make the search.
      * 
      
      *
@@ -14102,7 +14116,7 @@ public java.lang.String getPlacement() {
      * `projects/*/locations/global/catalogs/default_catalog/servingConfigs/default_serving_config`
      * or the name of the legacy placement resource, such as
      * `projects/*/locations/global/catalogs/default_catalog/placements/default_search`.
-     * This field is used to identify the serving configuration name and the set
+     * This field is used to identify the serving config name and the set
      * of models that will be used to make the search.
      * 
      
      *
@@ -14129,7 +14143,7 @@ public com.google.protobuf.ByteString getPlacementBytes() {
      * `projects/*/locations/global/catalogs/default_catalog/servingConfigs/default_serving_config`
      * or the name of the legacy placement resource, such as
      * `projects/*/locations/global/catalogs/default_catalog/placements/default_search`.
-     * This field is used to identify the serving configuration name and the set
+     * This field is used to identify the serving config name and the set
      * of models that will be used to make the search.
      * 
      
      *
@@ -14155,7 +14169,7 @@ public Builder setPlacement(java.lang.String value) {
      * `projects/*/locations/global/catalogs/default_catalog/servingConfigs/default_serving_config`
      * or the name of the legacy placement resource, such as
      * `projects/*/locations/global/catalogs/default_catalog/placements/default_search`.
-     * This field is used to identify the serving configuration name and the set
+     * This field is used to identify the serving config name and the set
      * of models that will be used to make the search.
      * 
      
      *
@@ -14177,7 +14191,7 @@ public Builder clearPlacement() {
      * `projects/*/locations/global/catalogs/default_catalog/servingConfigs/default_serving_config`
      * or the name of the legacy placement resource, such as
      * `projects/*/locations/global/catalogs/default_catalog/placements/default_search`.
-     * This field is used to identify the serving configuration name and the set
+     * This field is used to identify the serving config name and the set
      * of models that will be used to make the search.
      * 
      
      *
@@ -15867,7 +15881,7 @@ public com.google.cloud.retail.v2.SearchRequest.FacetSpec.Builder addFacetSpecsB
      * 
      *
      * @deprecated google.cloud.retail.v2.SearchRequest.dynamic_facet_spec is deprecated. See
-     *     google/cloud/retail/v2/search_service.proto;l=576
+     *     google/cloud/retail/v2/search_service.proto;l=583
      * @return Whether the dynamicFacetSpec field is set.
      */
     @java.lang.Deprecated
@@ -15889,7 +15903,7 @@ public boolean hasDynamicFacetSpec() {
      * 
      *
      * @deprecated google.cloud.retail.v2.SearchRequest.dynamic_facet_spec is deprecated. See
-     *     google/cloud/retail/v2/search_service.proto;l=576
+     *     google/cloud/retail/v2/search_service.proto;l=583
      * @return The dynamicFacetSpec.
      */
     @java.lang.Deprecated
@@ -17341,7 +17355,7 @@ private void ensurePageCategoriesIsMutable() {
      * the same as
      * [UserEvent.page_categories][google.cloud.retail.v2.UserEvent.page_categories];
      * To represent full path of category, use '>' sign to separate different
-     * hierarchies. If '>' is part of the category name, please replace it with
+     * hierarchies. If '>' is part of the category name, replace it with
      * other character(s).
      * Category pages include special pages such as sales or promotions. For
      * instance, a special sale page may have the category hierarchy:
@@ -17364,7 +17378,7 @@ public com.google.protobuf.ProtocolStringList getPageCategoriesList() {
      * the same as
      * [UserEvent.page_categories][google.cloud.retail.v2.UserEvent.page_categories];
      * To represent full path of category, use '>' sign to separate different
-     * hierarchies. If '>' is part of the category name, please replace it with
+     * hierarchies. If '>' is part of the category name, replace it with
      * other character(s).
      * Category pages include special pages such as sales or promotions. For
      * instance, a special sale page may have the category hierarchy:
@@ -17387,7 +17401,7 @@ public int getPageCategoriesCount() {
      * the same as
      * [UserEvent.page_categories][google.cloud.retail.v2.UserEvent.page_categories];
      * To represent full path of category, use '>' sign to separate different
-     * hierarchies. If '>' is part of the category name, please replace it with
+     * hierarchies. If '>' is part of the category name, replace it with
      * other character(s).
      * Category pages include special pages such as sales or promotions. For
      * instance, a special sale page may have the category hierarchy:
@@ -17411,7 +17425,7 @@ public java.lang.String getPageCategories(int index) {
      * the same as
      * [UserEvent.page_categories][google.cloud.retail.v2.UserEvent.page_categories];
      * To represent full path of category, use '>' sign to separate different
-     * hierarchies. If '>' is part of the category name, please replace it with
+     * hierarchies. If '>' is part of the category name, replace it with
      * other character(s).
      * Category pages include special pages such as sales or promotions. For
      * instance, a special sale page may have the category hierarchy:
@@ -17435,7 +17449,7 @@ public com.google.protobuf.ByteString getPageCategoriesBytes(int index) {
      * the same as
      * [UserEvent.page_categories][google.cloud.retail.v2.UserEvent.page_categories];
      * To represent full path of category, use '>' sign to separate different
-     * hierarchies. If '>' is part of the category name, please replace it with
+     * hierarchies. If '>' is part of the category name, replace it with
      * other character(s).
      * Category pages include special pages such as sales or promotions. For
      * instance, a special sale page may have the category hierarchy:
@@ -17466,7 +17480,7 @@ public Builder setPageCategories(int index, java.lang.String value) {
      * the same as
      * [UserEvent.page_categories][google.cloud.retail.v2.UserEvent.page_categories];
      * To represent full path of category, use '>' sign to separate different
-     * hierarchies. If '>' is part of the category name, please replace it with
+     * hierarchies. If '>' is part of the category name, replace it with
      * other character(s).
      * Category pages include special pages such as sales or promotions. For
      * instance, a special sale page may have the category hierarchy:
@@ -17496,7 +17510,7 @@ public Builder addPageCategories(java.lang.String value) {
      * the same as
      * [UserEvent.page_categories][google.cloud.retail.v2.UserEvent.page_categories];
      * To represent full path of category, use '>' sign to separate different
-     * hierarchies. If '>' is part of the category name, please replace it with
+     * hierarchies. If '>' is part of the category name, replace it with
      * other character(s).
      * Category pages include special pages such as sales or promotions. For
      * instance, a special sale page may have the category hierarchy:
@@ -17523,7 +17537,7 @@ public Builder addAllPageCategories(java.lang.Iterable values)
      * the same as
      * [UserEvent.page_categories][google.cloud.retail.v2.UserEvent.page_categories];
      * To represent full path of category, use '>' sign to separate different
-     * hierarchies. If '>' is part of the category name, please replace it with
+     * hierarchies. If '>' is part of the category name, replace it with
      * other character(s).
      * Category pages include special pages such as sales or promotions. For
      * instance, a special sale page may have the category hierarchy:
@@ -17549,7 +17563,7 @@ public Builder clearPageCategories() {
      * the same as
      * [UserEvent.page_categories][google.cloud.retail.v2.UserEvent.page_categories];
      * To represent full path of category, use '>' sign to separate different
-     * hierarchies. If '>' is part of the category name, please replace it with
+     * hierarchies. If '>' is part of the category name, replace it with
      * other character(s).
      * Category pages include special pages such as sales or promotions. For
      * instance, a special sale page may have the category hierarchy:
diff --git a/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/SearchRequestOrBuilder.java b/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/SearchRequestOrBuilder.java
index 2ec7c8c50faa..337dc14ff941 100644
--- a/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/SearchRequestOrBuilder.java
+++ b/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/SearchRequestOrBuilder.java
@@ -31,7 +31,7 @@ public interface SearchRequestOrBuilder
    * `projects/*/locations/global/catalogs/default_catalog/servingConfigs/default_serving_config`
    * or the name of the legacy placement resource, such as
    * `projects/*/locations/global/catalogs/default_catalog/placements/default_search`.
-   * This field is used to identify the serving configuration name and the set
+   * This field is used to identify the serving config name and the set
    * of models that will be used to make the search.
    * 
      
    *
@@ -48,7 +48,7 @@ public interface SearchRequestOrBuilder
    * `projects/*/locations/global/catalogs/default_catalog/servingConfigs/default_serving_config`
    * or the name of the legacy placement resource, such as
    * `projects/*/locations/global/catalogs/default_catalog/placements/default_search`.
-   * This field is used to identify the serving configuration name and the set
+   * This field is used to identify the serving config name and the set
    * of models that will be used to make the search.
    * 
      
    *
@@ -459,7 +459,7 @@ public interface SearchRequestOrBuilder
    * 
    *
    * @deprecated google.cloud.retail.v2.SearchRequest.dynamic_facet_spec is deprecated. See
-   *     google/cloud/retail/v2/search_service.proto;l=576
+   *     google/cloud/retail/v2/search_service.proto;l=583
    * @return Whether the dynamicFacetSpec field is set.
    */
   @java.lang.Deprecated
@@ -479,7 +479,7 @@ public interface SearchRequestOrBuilder
    * 
    *
    * @deprecated google.cloud.retail.v2.SearchRequest.dynamic_facet_spec is deprecated. See
-   *     google/cloud/retail/v2/search_service.proto;l=576
+   *     google/cloud/retail/v2/search_service.proto;l=583
    * @return The dynamicFacetSpec.
    */
   @java.lang.Deprecated
@@ -925,7 +925,7 @@ public interface SearchRequestOrBuilder
    * the same as
    * [UserEvent.page_categories][google.cloud.retail.v2.UserEvent.page_categories];
    * To represent full path of category, use '>' sign to separate different
-   * hierarchies. If '>' is part of the category name, please replace it with
+   * hierarchies. If '>' is part of the category name, replace it with
    * other character(s).
    * Category pages include special pages such as sales or promotions. For
    * instance, a special sale page may have the category hierarchy:
@@ -946,7 +946,7 @@ public interface SearchRequestOrBuilder
    * the same as
    * [UserEvent.page_categories][google.cloud.retail.v2.UserEvent.page_categories];
    * To represent full path of category, use '>' sign to separate different
-   * hierarchies. If '>' is part of the category name, please replace it with
+   * hierarchies. If '>' is part of the category name, replace it with
    * other character(s).
    * Category pages include special pages such as sales or promotions. For
    * instance, a special sale page may have the category hierarchy:
@@ -967,7 +967,7 @@ public interface SearchRequestOrBuilder
    * the same as
    * [UserEvent.page_categories][google.cloud.retail.v2.UserEvent.page_categories];
    * To represent full path of category, use '>' sign to separate different
-   * hierarchies. If '>' is part of the category name, please replace it with
+   * hierarchies. If '>' is part of the category name, replace it with
    * other character(s).
    * Category pages include special pages such as sales or promotions. For
    * instance, a special sale page may have the category hierarchy:
@@ -989,7 +989,7 @@ public interface SearchRequestOrBuilder
    * the same as
    * [UserEvent.page_categories][google.cloud.retail.v2.UserEvent.page_categories];
    * To represent full path of category, use '>' sign to separate different
-   * hierarchies. If '>' is part of the category name, please replace it with
+   * hierarchies. If '>' is part of the category name, replace it with
    * other character(s).
    * Category pages include special pages such as sales or promotions. For
    * instance, a special sale page may have the category hierarchy:
diff --git a/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/ServingConfig.java b/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/ServingConfig.java
index 7d0a906d40c9..3cffee5cf796 100644
--- a/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/ServingConfig.java
+++ b/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/ServingConfig.java
@@ -53,6 +53,7 @@ private ServingConfig() {
     replacementControlIds_ = com.google.protobuf.LazyStringArrayList.EMPTY;
     ignoreControlIds_ = com.google.protobuf.LazyStringArrayList.EMPTY;
     diversityLevel_ = "";
+    diversityType_ = 0;
     enableCategoryFilterLevel_ = "";
     solutionTypes_ = java.util.Collections.emptyList();
   }
@@ -83,6 +84,163 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
             com.google.cloud.retail.v2.ServingConfig.Builder.class);
   }
 
+  /**
+   *
+   *
+   * 
      +   * What type of diversity - data or rule based.
+   * 
      
+   *
+   * Protobuf enum {@code google.cloud.retail.v2.ServingConfig.DiversityType}
+   */
+  public enum DiversityType implements com.google.protobuf.ProtocolMessageEnum {
+    /**
+     *
+     *
+     * 
      +     * Default value.
+     * 
      
+     *
+     * DIVERSITY_TYPE_UNSPECIFIED = 0;
+     */
+    DIVERSITY_TYPE_UNSPECIFIED(0),
+    /**
+     *
+     *
+     * 
      +     * Rule based diversity.
+     * 
      
+     *
+     * RULE_BASED_DIVERSITY = 2;
+     */
+    RULE_BASED_DIVERSITY(2),
+    /**
+     *
+     *
+     * 
      +     * Data driven diversity.
+     * 
      
+     *
+     * DATA_DRIVEN_DIVERSITY = 3;
+     */
+    DATA_DRIVEN_DIVERSITY(3),
+    UNRECOGNIZED(-1),
+    ;
+
+    /**
+     *
+     *
+     * 
      +     * Default value.
+     * 
      
+     *
+     * DIVERSITY_TYPE_UNSPECIFIED = 0;
+     */
+    public static final int DIVERSITY_TYPE_UNSPECIFIED_VALUE = 0;
+    /**
+     *
+     *
+     * 
      +     * Rule based diversity.
+     * 
      
+     *
+     * RULE_BASED_DIVERSITY = 2;
+     */
+    public static final int RULE_BASED_DIVERSITY_VALUE = 2;
+    /**
+     *
+     *
+     * 
      +     * Data driven diversity.
+     * 
      
+     *
+     * DATA_DRIVEN_DIVERSITY = 3;
+     */
+    public static final int DATA_DRIVEN_DIVERSITY_VALUE = 3;
+
+    public final int getNumber() {
+      if (this == UNRECOGNIZED) {
+        throw new java.lang.IllegalArgumentException(
+            "Can't get the number of an unknown enum value.");
+      }
+      return value;
+    }
+
+    /**
+     * @param value The numeric wire value of the corresponding enum entry.
+     * @return The enum associated with the given numeric wire value.
+     * @deprecated Use {@link #forNumber(int)} instead.
+     */
+    @java.lang.Deprecated
+    public static DiversityType valueOf(int value) {
+      return forNumber(value);
+    }
+
+    /**
+     * @param value The numeric wire value of the corresponding enum entry.
+     * @return The enum associated with the given numeric wire value.
+     */
+    public static DiversityType forNumber(int value) {
+      switch (value) {
+        case 0:
+          return DIVERSITY_TYPE_UNSPECIFIED;
+        case 2:
+          return RULE_BASED_DIVERSITY;
+        case 3:
+          return DATA_DRIVEN_DIVERSITY;
+        default:
+          return null;
+      }
+    }
+
+    public static com.google.protobuf.Internal.EnumLiteMap internalGetValueMap() {
+      return internalValueMap;
+    }
+
+    private static final com.google.protobuf.Internal.EnumLiteMap internalValueMap =
+        new com.google.protobuf.Internal.EnumLiteMap() {
+          public DiversityType findValueByNumber(int number) {
+            return DiversityType.forNumber(number);
+          }
+        };
+
+    public final com.google.protobuf.Descriptors.EnumValueDescriptor getValueDescriptor() {
+      if (this == UNRECOGNIZED) {
+        throw new java.lang.IllegalStateException(
+            "Can't get the descriptor of an unrecognized enum value.");
+      }
+      return getDescriptor().getValues().get(ordinal());
+    }
+
+    public final com.google.protobuf.Descriptors.EnumDescriptor getDescriptorForType() {
+      return getDescriptor();
+    }
+
+    public static final com.google.protobuf.Descriptors.EnumDescriptor getDescriptor() {
+      return com.google.cloud.retail.v2.ServingConfig.getDescriptor().getEnumTypes().get(0);
+    }
+
+    private static final DiversityType[] VALUES = values();
+
+    public static DiversityType valueOf(com.google.protobuf.Descriptors.EnumValueDescriptor desc) {
+      if (desc.getType() != getDescriptor()) {
+        throw new java.lang.IllegalArgumentException("EnumValueDescriptor is not for this type.");
+      }
+      if (desc.getIndex() == -1) {
+        return UNRECOGNIZED;
+      }
+      return VALUES[desc.getIndex()];
+    }
+
+    private final int value;
+
+    private DiversityType(int value) {
+      this.value = value;
+    }
+
+    // @@protoc_insertion_point(enum_scope:google.cloud.retail.v2.ServingConfig.DiversityType)
+  }
+
   public static final int NAME_FIELD_NUMBER = 1;
   private volatile java.lang.Object name_;
   /**
@@ -264,12 +422,12 @@ public com.google.protobuf.ByteString getModelIdBytes() {
    * highest-priced items first. This setting could result in a decrease in
    * click-through and conversion rates.
    *  Allowed values are:
-   * * 'no-price-reranking'
-   * * 'low-price-raranking'
-   * * 'medium-price-reranking'
-   * * 'high-price-reranking'
+   * * `no-price-reranking`
+   * * `low-price-raranking`
+   * * `medium-price-reranking`
+   * * `high-price-reranking`
    * If not specified, we choose default based on model type. Default value:
-   * 'no-price-reranking'.
+   * `no-price-reranking`.
    * Can only be set if
    * [solution_types][google.cloud.retail.v2.ServingConfig.solution_types] is
    * [SOLUTION_TYPE_RECOMMENDATION][google.cloud.retail.v2main.SolutionType.SOLUTION_TYPE_RECOMMENDATION].
@@ -301,12 +459,12 @@ public java.lang.String getPriceRerankingLevel() {
    * highest-priced items first. This setting could result in a decrease in
    * click-through and conversion rates.
    *  Allowed values are:
-   * * 'no-price-reranking'
-   * * 'low-price-raranking'
-   * * 'medium-price-reranking'
-   * * 'high-price-reranking'
+   * * `no-price-reranking`
+   * * `low-price-raranking`
+   * * `medium-price-reranking`
+   * * `high-price-reranking`
    * If not specified, we choose default based on model type. Default value:
-   * 'no-price-reranking'.
+   * `no-price-reranking`.
    * Can only be set if
    * [solution_types][google.cloud.retail.v2.ServingConfig.solution_types] is
    * [SOLUTION_TYPE_RECOMMENDATION][google.cloud.retail.v2main.SolutionType.SOLUTION_TYPE_RECOMMENDATION].
@@ -1206,14 +1364,14 @@ public com.google.protobuf.ByteString getIgnoreControlIdsBytes(int index) {
    *
    * 
          * How much diversity to use in recommendation model results e.g.
-   * 'medium-diversity' or 'high-diversity'. Currently supported values:
-   * * 'no-diversity'
-   * * 'low-diversity'
-   * * 'medium-diversity'
-   * * 'high-diversity'
-   * * 'auto-diversity'
+   * `medium-diversity` or `high-diversity`. Currently supported values:
+   * * `no-diversity`
+   * * `low-diversity`
+   * * `medium-diversity`
+   * * `high-diversity`
+   * * `auto-diversity`
    * If not specified, we choose default based on recommendation model
-   * type. Default value: 'no-diversity'.
+   * type. Default value: `no-diversity`.
    * Can only be set if
    * [solution_types][google.cloud.retail.v2.ServingConfig.solution_types] is
    * [SOLUTION_TYPE_RECOMMENDATION][google.cloud.retail.v2main.SolutionType.SOLUTION_TYPE_RECOMMENDATION].
@@ -1240,14 +1398,14 @@ public java.lang.String getDiversityLevel() {
    *
    * 
          * How much diversity to use in recommendation model results e.g.
-   * 'medium-diversity' or 'high-diversity'. Currently supported values:
-   * * 'no-diversity'
-   * * 'low-diversity'
-   * * 'medium-diversity'
-   * * 'high-diversity'
-   * * 'auto-diversity'
+   * `medium-diversity` or `high-diversity`. Currently supported values:
+   * * `no-diversity`
+   * * `low-diversity`
+   * * `medium-diversity`
+   * * `high-diversity`
+   * * `auto-diversity`
    * If not specified, we choose default based on recommendation model
-   * type. Default value: 'no-diversity'.
+   * type. Default value: `no-diversity`.
    * Can only be set if
    * [solution_types][google.cloud.retail.v2.ServingConfig.solution_types] is
    * [SOLUTION_TYPE_RECOMMENDATION][google.cloud.retail.v2main.SolutionType.SOLUTION_TYPE_RECOMMENDATION].
@@ -1270,18 +1428,60 @@ public com.google.protobuf.ByteString getDiversityLevelBytes() {
     }
   }
 
+  public static final int DIVERSITY_TYPE_FIELD_NUMBER = 20;
+  private int diversityType_;
+  /**
+   *
+   *
+   * 
      +   * What kind of diversity to use - data driven or rule based. If unset,
+   * the server behavior defaults to
+   * [RULE_BASED_DIVERSITY][google.cloud.retail.v2.ServingConfig.DiversityType.RULE_BASED_DIVERSITY].
+   * 
      
+   *
+   * .google.cloud.retail.v2.ServingConfig.DiversityType diversity_type = 20;
+   *
+   * @return The enum numeric value on the wire for diversityType.
+   */
+  @java.lang.Override
+  public int getDiversityTypeValue() {
+    return diversityType_;
+  }
+  /**
+   *
+   *
+   * 
      +   * What kind of diversity to use - data driven or rule based. If unset,
+   * the server behavior defaults to
+   * [RULE_BASED_DIVERSITY][google.cloud.retail.v2.ServingConfig.DiversityType.RULE_BASED_DIVERSITY].
+   * 
      
+   *
+   * .google.cloud.retail.v2.ServingConfig.DiversityType diversity_type = 20;
+   *
+   * @return The diversityType.
+   */
+  @java.lang.Override
+  public com.google.cloud.retail.v2.ServingConfig.DiversityType getDiversityType() {
+    @SuppressWarnings("deprecation")
+    com.google.cloud.retail.v2.ServingConfig.DiversityType result =
+        com.google.cloud.retail.v2.ServingConfig.DiversityType.valueOf(diversityType_);
+    return result == null
+        ? com.google.cloud.retail.v2.ServingConfig.DiversityType.UNRECOGNIZED
+        : result;
+  }
+
   public static final int ENABLE_CATEGORY_FILTER_LEVEL_FIELD_NUMBER = 16;
   private volatile java.lang.Object enableCategoryFilterLevel_;
   /**
    *
    *
    * 
      -   * Whether to add additional category filters on the 'similar-items' model.
+   * Whether to add additional category filters on the `similar-items` model.
    * If not specified, we enable it by default.
    *  Allowed values are:
-   * * 'no-category-match': No additional filtering of original results from
+   * * `no-category-match`: No additional filtering of original results from
    *   the model and the customer's filters.
-   * * 'relaxed-category-match': Only keep results with categories that match
+   * * `relaxed-category-match`: Only keep results with categories that match
    *   at least one item categories in the PredictRequests's context item.
    *   * If customer also sends filters in the PredictRequest, then the results
    *   will satisfy both conditions (user given and category match).
@@ -1310,12 +1510,12 @@ public java.lang.String getEnableCategoryFilterLevel() {
    *
    *
    * 
      -   * Whether to add additional category filters on the 'similar-items' model.
+   * Whether to add additional category filters on the `similar-items` model.
    * If not specified, we enable it by default.
    *  Allowed values are:
-   * * 'no-category-match': No additional filtering of original results from
+   * * `no-category-match`: No additional filtering of original results from
    *   the model and the customer's filters.
-   * * 'relaxed-category-match': Only keep results with categories that match
+   * * `relaxed-category-match`: Only keep results with categories that match
    *   at least one item categories in the PredictRequests's context item.
    *   * If customer also sends filters in the PredictRequest, then the results
    *   will satisfy both conditions (user given and category match).
@@ -1611,6 +1811,11 @@ public void writeTo(com.google.protobuf.CodedOutputStream output) throws java.io
     for (int i = 0; i < solutionTypes_.size(); i++) {
       output.writeEnumNoTag(solutionTypes_.get(i));
     }
+    if (diversityType_
+        != com.google.cloud.retail.v2.ServingConfig.DiversityType.DIVERSITY_TYPE_UNSPECIFIED
+            .getNumber()) {
+      output.writeEnum(20, diversityType_);
+    }
     if (personalizationSpec_ != null) {
       output.writeMessage(21, getPersonalizationSpec());
     }
@@ -1730,6 +1935,11 @@ public int getSerializedSize() {
       }
       solutionTypesMemoizedSerializedSize = dataSize;
     }
+    if (diversityType_
+        != com.google.cloud.retail.v2.ServingConfig.DiversityType.DIVERSITY_TYPE_UNSPECIFIED
+            .getNumber()) {
+      size += com.google.protobuf.CodedOutputStream.computeEnumSize(20, diversityType_);
+    }
     if (personalizationSpec_ != null) {
       size +=
           com.google.protobuf.CodedOutputStream.computeMessageSize(21, getPersonalizationSpec());
@@ -1770,6 +1980,7 @@ public boolean equals(final java.lang.Object obj) {
     if (!getReplacementControlIdsList().equals(other.getReplacementControlIdsList())) return false;
     if (!getIgnoreControlIdsList().equals(other.getIgnoreControlIdsList())) return false;
     if (!getDiversityLevel().equals(other.getDiversityLevel())) return false;
+    if (diversityType_ != other.diversityType_) return false;
     if (!getEnableCategoryFilterLevel().equals(other.getEnableCategoryFilterLevel())) return false;
     if (hasPersonalizationSpec() != other.hasPersonalizationSpec()) return false;
     if (hasPersonalizationSpec()) {
@@ -1837,6 +2048,8 @@ public int hashCode() {
     }
     hash = (37 * hash) + DIVERSITY_LEVEL_FIELD_NUMBER;
     hash = (53 * hash) + getDiversityLevel().hashCode();
+    hash = (37 * hash) + DIVERSITY_TYPE_FIELD_NUMBER;
+    hash = (53 * hash) + diversityType_;
     hash = (37 * hash) + ENABLE_CATEGORY_FILTER_LEVEL_FIELD_NUMBER;
     hash = (53 * hash) + getEnableCategoryFilterLevel().hashCode();
     if (hasPersonalizationSpec()) {
@@ -2020,6 +2233,8 @@ public Builder clear() {
       bitField0_ = (bitField0_ & ~0x00000100);
       diversityLevel_ = "";
 
+      diversityType_ = 0;
+
       enableCategoryFilterLevel_ = "";
 
       if (personalizationSpecBuilder_ == null) {
@@ -2113,6 +2328,7 @@ public com.google.cloud.retail.v2.ServingConfig buildPartial() {
       }
       result.ignoreControlIds_ = ignoreControlIds_;
       result.diversityLevel_ = diversityLevel_;
+      result.diversityType_ = diversityType_;
       result.enableCategoryFilterLevel_ = enableCategoryFilterLevel_;
       if (personalizationSpecBuilder_ == null) {
         result.personalizationSpec_ = personalizationSpec_;
@@ -2286,6 +2502,9 @@ public Builder mergeFrom(com.google.cloud.retail.v2.ServingConfig other) {
         diversityLevel_ = other.diversityLevel_;
         onChanged();
       }
+      if (other.diversityType_ != 0) {
+        setDiversityTypeValue(other.getDiversityTypeValue());
+      }
       if (!other.getEnableCategoryFilterLevel().isEmpty()) {
         enableCategoryFilterLevel_ = other.enableCategoryFilterLevel_;
         onChanged();
@@ -2454,6 +2673,12 @@ public Builder mergeFrom(
                 input.popLimit(oldLimit);
                 break;
               } // case 154
+            case 160:
+              {
+                diversityType_ = input.readEnum();
+
+                break;
+              } // case 160
             case 170:
               {
                 input.readMessage(
@@ -2864,12 +3089,12 @@ public Builder setModelIdBytes(com.google.protobuf.ByteString value) {
      * highest-priced items first. This setting could result in a decrease in
      * click-through and conversion rates.
      *  Allowed values are:
-     * * 'no-price-reranking'
-     * * 'low-price-raranking'
-     * * 'medium-price-reranking'
-     * * 'high-price-reranking'
+     * * `no-price-reranking`
+     * * `low-price-raranking`
+     * * `medium-price-reranking`
+     * * `high-price-reranking`
      * If not specified, we choose default based on model type. Default value:
-     * 'no-price-reranking'.
+     * `no-price-reranking`.
      * Can only be set if
      * [solution_types][google.cloud.retail.v2.ServingConfig.solution_types] is
      * [SOLUTION_TYPE_RECOMMENDATION][google.cloud.retail.v2main.SolutionType.SOLUTION_TYPE_RECOMMENDATION].
@@ -2900,12 +3125,12 @@ public java.lang.String getPriceRerankingLevel() {
      * highest-priced items first. This setting could result in a decrease in
      * click-through and conversion rates.
      *  Allowed values are:
-     * * 'no-price-reranking'
-     * * 'low-price-raranking'
-     * * 'medium-price-reranking'
-     * * 'high-price-reranking'
+     * * `no-price-reranking`
+     * * `low-price-raranking`
+     * * `medium-price-reranking`
+     * * `high-price-reranking`
      * If not specified, we choose default based on model type. Default value:
-     * 'no-price-reranking'.
+     * `no-price-reranking`.
      * Can only be set if
      * [solution_types][google.cloud.retail.v2.ServingConfig.solution_types] is
      * [SOLUTION_TYPE_RECOMMENDATION][google.cloud.retail.v2main.SolutionType.SOLUTION_TYPE_RECOMMENDATION].
@@ -2936,12 +3161,12 @@ public com.google.protobuf.ByteString getPriceRerankingLevelBytes() {
      * highest-priced items first. This setting could result in a decrease in
      * click-through and conversion rates.
      *  Allowed values are:
-     * * 'no-price-reranking'
-     * * 'low-price-raranking'
-     * * 'medium-price-reranking'
-     * * 'high-price-reranking'
+     * * `no-price-reranking`
+     * * `low-price-raranking`
+     * * `medium-price-reranking`
+     * * `high-price-reranking`
      * If not specified, we choose default based on model type. Default value:
-     * 'no-price-reranking'.
+     * `no-price-reranking`.
      * Can only be set if
      * [solution_types][google.cloud.retail.v2.ServingConfig.solution_types] is
      * [SOLUTION_TYPE_RECOMMENDATION][google.cloud.retail.v2main.SolutionType.SOLUTION_TYPE_RECOMMENDATION].
@@ -2971,12 +3196,12 @@ public Builder setPriceRerankingLevel(java.lang.String value) {
      * highest-priced items first. This setting could result in a decrease in
      * click-through and conversion rates.
      *  Allowed values are:
-     * * 'no-price-reranking'
-     * * 'low-price-raranking'
-     * * 'medium-price-reranking'
-     * * 'high-price-reranking'
+     * * `no-price-reranking`
+     * * `low-price-raranking`
+     * * `medium-price-reranking`
+     * * `high-price-reranking`
      * If not specified, we choose default based on model type. Default value:
-     * 'no-price-reranking'.
+     * `no-price-reranking`.
      * Can only be set if
      * [solution_types][google.cloud.retail.v2.ServingConfig.solution_types] is
      * [SOLUTION_TYPE_RECOMMENDATION][google.cloud.retail.v2main.SolutionType.SOLUTION_TYPE_RECOMMENDATION].
@@ -3002,12 +3227,12 @@ public Builder clearPriceRerankingLevel() {
      * highest-priced items first. This setting could result in a decrease in
      * click-through and conversion rates.
      *  Allowed values are:
-     * * 'no-price-reranking'
-     * * 'low-price-raranking'
-     * * 'medium-price-reranking'
-     * * 'high-price-reranking'
+     * * `no-price-reranking`
+     * * `low-price-raranking`
+     * * `medium-price-reranking`
+     * * `high-price-reranking`
      * If not specified, we choose default based on model type. Default value:
-     * 'no-price-reranking'.
+     * `no-price-reranking`.
      * Can only be set if
      * [solution_types][google.cloud.retail.v2.ServingConfig.solution_types] is
      * [SOLUTION_TYPE_RECOMMENDATION][google.cloud.retail.v2main.SolutionType.SOLUTION_TYPE_RECOMMENDATION].
@@ -5363,14 +5588,14 @@ public Builder addIgnoreControlIdsBytes(com.google.protobuf.ByteString value) {
      *
      * 
            * How much diversity to use in recommendation model results e.g.
-     * 'medium-diversity' or 'high-diversity'. Currently supported values:
-     * * 'no-diversity'
-     * * 'low-diversity'
-     * * 'medium-diversity'
-     * * 'high-diversity'
-     * * 'auto-diversity'
+     * `medium-diversity` or `high-diversity`. Currently supported values:
+     * * `no-diversity`
+     * * `low-diversity`
+     * * `medium-diversity`
+     * * `high-diversity`
+     * * `auto-diversity`
      * If not specified, we choose default based on recommendation model
-     * type. Default value: 'no-diversity'.
+     * type. Default value: `no-diversity`.
      * Can only be set if
      * [solution_types][google.cloud.retail.v2.ServingConfig.solution_types] is
      * [SOLUTION_TYPE_RECOMMENDATION][google.cloud.retail.v2main.SolutionType.SOLUTION_TYPE_RECOMMENDATION].
@@ -5396,14 +5621,14 @@ public java.lang.String getDiversityLevel() {
      *
      * 
            * How much diversity to use in recommendation model results e.g.
-     * 'medium-diversity' or 'high-diversity'. Currently supported values:
-     * * 'no-diversity'
-     * * 'low-diversity'
-     * * 'medium-diversity'
-     * * 'high-diversity'
-     * * 'auto-diversity'
+     * `medium-diversity` or `high-diversity`. Currently supported values:
+     * * `no-diversity`
+     * * `low-diversity`
+     * * `medium-diversity`
+     * * `high-diversity`
+     * * `auto-diversity`
      * If not specified, we choose default based on recommendation model
-     * type. Default value: 'no-diversity'.
+     * type. Default value: `no-diversity`.
      * Can only be set if
      * [solution_types][google.cloud.retail.v2.ServingConfig.solution_types] is
      * [SOLUTION_TYPE_RECOMMENDATION][google.cloud.retail.v2main.SolutionType.SOLUTION_TYPE_RECOMMENDATION].
@@ -5429,14 +5654,14 @@ public com.google.protobuf.ByteString getDiversityLevelBytes() {
      *
      * 
            * How much diversity to use in recommendation model results e.g.
-     * 'medium-diversity' or 'high-diversity'. Currently supported values:
-     * * 'no-diversity'
-     * * 'low-diversity'
-     * * 'medium-diversity'
-     * * 'high-diversity'
-     * * 'auto-diversity'
+     * `medium-diversity` or `high-diversity`. Currently supported values:
+     * * `no-diversity`
+     * * `low-diversity`
+     * * `medium-diversity`
+     * * `high-diversity`
+     * * `auto-diversity`
      * If not specified, we choose default based on recommendation model
-     * type. Default value: 'no-diversity'.
+     * type. Default value: `no-diversity`.
      * Can only be set if
      * [solution_types][google.cloud.retail.v2.ServingConfig.solution_types] is
      * [SOLUTION_TYPE_RECOMMENDATION][google.cloud.retail.v2main.SolutionType.SOLUTION_TYPE_RECOMMENDATION].
@@ -5461,14 +5686,14 @@ public Builder setDiversityLevel(java.lang.String value) {
      *
      * 
            * How much diversity to use in recommendation model results e.g.
-     * 'medium-diversity' or 'high-diversity'. Currently supported values:
-     * * 'no-diversity'
-     * * 'low-diversity'
-     * * 'medium-diversity'
-     * * 'high-diversity'
-     * * 'auto-diversity'
+     * `medium-diversity` or `high-diversity`. Currently supported values:
+     * * `no-diversity`
+     * * `low-diversity`
+     * * `medium-diversity`
+     * * `high-diversity`
+     * * `auto-diversity`
      * If not specified, we choose default based on recommendation model
-     * type. Default value: 'no-diversity'.
+     * type. Default value: `no-diversity`.
      * Can only be set if
      * [solution_types][google.cloud.retail.v2.ServingConfig.solution_types] is
      * [SOLUTION_TYPE_RECOMMENDATION][google.cloud.retail.v2main.SolutionType.SOLUTION_TYPE_RECOMMENDATION].
@@ -5489,14 +5714,14 @@ public Builder clearDiversityLevel() {
      *
      * 
            * How much diversity to use in recommendation model results e.g.
-     * 'medium-diversity' or 'high-diversity'. Currently supported values:
-     * * 'no-diversity'
-     * * 'low-diversity'
-     * * 'medium-diversity'
-     * * 'high-diversity'
-     * * 'auto-diversity'
+     * `medium-diversity` or `high-diversity`. Currently supported values:
+     * * `no-diversity`
+     * * `low-diversity`
+     * * `medium-diversity`
+     * * `high-diversity`
+     * * `auto-diversity`
      * If not specified, we choose default based on recommendation model
-     * type. Default value: 'no-diversity'.
+     * type. Default value: `no-diversity`.
      * Can only be set if
      * [solution_types][google.cloud.retail.v2.ServingConfig.solution_types] is
      * [SOLUTION_TYPE_RECOMMENDATION][google.cloud.retail.v2main.SolutionType.SOLUTION_TYPE_RECOMMENDATION].
@@ -5518,17 +5743,120 @@ public Builder setDiversityLevelBytes(com.google.protobuf.ByteString value) {
       return this;
     }
 
+    private int diversityType_ = 0;
+    /**
+     *
+     *
+     * 
      +     * What kind of diversity to use - data driven or rule based. If unset,
+     * the server behavior defaults to
+     * [RULE_BASED_DIVERSITY][google.cloud.retail.v2.ServingConfig.DiversityType.RULE_BASED_DIVERSITY].
+     * 
      
+     *
+     * .google.cloud.retail.v2.ServingConfig.DiversityType diversity_type = 20;
+     *
+     * @return The enum numeric value on the wire for diversityType.
+     */
+    @java.lang.Override
+    public int getDiversityTypeValue() {
+      return diversityType_;
+    }
+    /**
+     *
+     *
+     * 
      +     * What kind of diversity to use - data driven or rule based. If unset,
+     * the server behavior defaults to
+     * [RULE_BASED_DIVERSITY][google.cloud.retail.v2.ServingConfig.DiversityType.RULE_BASED_DIVERSITY].
+     * 
      
+     *
+     * .google.cloud.retail.v2.ServingConfig.DiversityType diversity_type = 20;
+     *
+     * @param value The enum numeric value on the wire for diversityType to set.
+     * @return This builder for chaining.
+     */
+    public Builder setDiversityTypeValue(int value) {
+
+      diversityType_ = value;
+      onChanged();
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * What kind of diversity to use - data driven or rule based. If unset,
+     * the server behavior defaults to
+     * [RULE_BASED_DIVERSITY][google.cloud.retail.v2.ServingConfig.DiversityType.RULE_BASED_DIVERSITY].
+     * 
      
+     *
+     * .google.cloud.retail.v2.ServingConfig.DiversityType diversity_type = 20;
+     *
+     * @return The diversityType.
+     */
+    @java.lang.Override
+    public com.google.cloud.retail.v2.ServingConfig.DiversityType getDiversityType() {
+      @SuppressWarnings("deprecation")
+      com.google.cloud.retail.v2.ServingConfig.DiversityType result =
+          com.google.cloud.retail.v2.ServingConfig.DiversityType.valueOf(diversityType_);
+      return result == null
+          ? com.google.cloud.retail.v2.ServingConfig.DiversityType.UNRECOGNIZED
+          : result;
+    }
+    /**
+     *
+     *
+     * 
      +     * What kind of diversity to use - data driven or rule based. If unset,
+     * the server behavior defaults to
+     * [RULE_BASED_DIVERSITY][google.cloud.retail.v2.ServingConfig.DiversityType.RULE_BASED_DIVERSITY].
+     * 
      
+     *
+     * .google.cloud.retail.v2.ServingConfig.DiversityType diversity_type = 20;
+     *
+     * @param value The diversityType to set.
+     * @return This builder for chaining.
+     */
+    public Builder setDiversityType(com.google.cloud.retail.v2.ServingConfig.DiversityType value) {
+      if (value == null) {
+        throw new NullPointerException();
+      }
+
+      diversityType_ = value.getNumber();
+      onChanged();
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * What kind of diversity to use - data driven or rule based. If unset,
+     * the server behavior defaults to
+     * [RULE_BASED_DIVERSITY][google.cloud.retail.v2.ServingConfig.DiversityType.RULE_BASED_DIVERSITY].
+     * 
      
+     *
+     * .google.cloud.retail.v2.ServingConfig.DiversityType diversity_type = 20;
+     *
+     * @return This builder for chaining.
+     */
+    public Builder clearDiversityType() {
+
+      diversityType_ = 0;
+      onChanged();
+      return this;
+    }
+
     private java.lang.Object enableCategoryFilterLevel_ = "";
     /**
      *
      *
      * 
      -     * Whether to add additional category filters on the 'similar-items' model.
+     * Whether to add additional category filters on the `similar-items` model.
      * If not specified, we enable it by default.
      *  Allowed values are:
-     * * 'no-category-match': No additional filtering of original results from
+     * * `no-category-match`: No additional filtering of original results from
      *   the model and the customer's filters.
-     * * 'relaxed-category-match': Only keep results with categories that match
+     * * `relaxed-category-match`: Only keep results with categories that match
      *   at least one item categories in the PredictRequests's context item.
      *   * If customer also sends filters in the PredictRequest, then the results
      *   will satisfy both conditions (user given and category match).
@@ -5556,12 +5884,12 @@ public java.lang.String getEnableCategoryFilterLevel() {
      *
      *
      * 
      -     * Whether to add additional category filters on the 'similar-items' model.
+     * Whether to add additional category filters on the `similar-items` model.
      * If not specified, we enable it by default.
      *  Allowed values are:
-     * * 'no-category-match': No additional filtering of original results from
+     * * `no-category-match`: No additional filtering of original results from
      *   the model and the customer's filters.
-     * * 'relaxed-category-match': Only keep results with categories that match
+     * * `relaxed-category-match`: Only keep results with categories that match
      *   at least one item categories in the PredictRequests's context item.
      *   * If customer also sends filters in the PredictRequest, then the results
      *   will satisfy both conditions (user given and category match).
@@ -5589,12 +5917,12 @@ public com.google.protobuf.ByteString getEnableCategoryFilterLevelBytes() {
      *
      *
      * 
      -     * Whether to add additional category filters on the 'similar-items' model.
+     * Whether to add additional category filters on the `similar-items` model.
      * If not specified, we enable it by default.
      *  Allowed values are:
-     * * 'no-category-match': No additional filtering of original results from
+     * * `no-category-match`: No additional filtering of original results from
      *   the model and the customer's filters.
-     * * 'relaxed-category-match': Only keep results with categories that match
+     * * `relaxed-category-match`: Only keep results with categories that match
      *   at least one item categories in the PredictRequests's context item.
      *   * If customer also sends filters in the PredictRequest, then the results
      *   will satisfy both conditions (user given and category match).
@@ -5621,12 +5949,12 @@ public Builder setEnableCategoryFilterLevel(java.lang.String value) {
      *
      *
      * 
      -     * Whether to add additional category filters on the 'similar-items' model.
+     * Whether to add additional category filters on the `similar-items` model.
      * If not specified, we enable it by default.
      *  Allowed values are:
-     * * 'no-category-match': No additional filtering of original results from
+     * * `no-category-match`: No additional filtering of original results from
      *   the model and the customer's filters.
-     * * 'relaxed-category-match': Only keep results with categories that match
+     * * `relaxed-category-match`: Only keep results with categories that match
      *   at least one item categories in the PredictRequests's context item.
      *   * If customer also sends filters in the PredictRequest, then the results
      *   will satisfy both conditions (user given and category match).
@@ -5649,12 +5977,12 @@ public Builder clearEnableCategoryFilterLevel() {
      *
      *
      * 
      -     * Whether to add additional category filters on the 'similar-items' model.
+     * Whether to add additional category filters on the `similar-items` model.
      * If not specified, we enable it by default.
      *  Allowed values are:
-     * * 'no-category-match': No additional filtering of original results from
+     * * `no-category-match`: No additional filtering of original results from
      *   the model and the customer's filters.
-     * * 'relaxed-category-match': Only keep results with categories that match
+     * * `relaxed-category-match`: Only keep results with categories that match
      *   at least one item categories in the PredictRequests's context item.
      *   * If customer also sends filters in the PredictRequest, then the results
      *   will satisfy both conditions (user given and category match).
diff --git a/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/ServingConfigOrBuilder.java b/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/ServingConfigOrBuilder.java
index b57f13f1abd9..7e387fee481f 100644
--- a/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/ServingConfigOrBuilder.java
+++ b/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/ServingConfigOrBuilder.java
@@ -130,12 +130,12 @@ public interface ServingConfigOrBuilder
    * highest-priced items first. This setting could result in a decrease in
    * click-through and conversion rates.
    *  Allowed values are:
-   * * 'no-price-reranking'
-   * * 'low-price-raranking'
-   * * 'medium-price-reranking'
-   * * 'high-price-reranking'
+   * * `no-price-reranking`
+   * * `low-price-raranking`
+   * * `medium-price-reranking`
+   * * `high-price-reranking`
    * If not specified, we choose default based on model type. Default value:
-   * 'no-price-reranking'.
+   * `no-price-reranking`.
    * Can only be set if
    * [solution_types][google.cloud.retail.v2.ServingConfig.solution_types] is
    * [SOLUTION_TYPE_RECOMMENDATION][google.cloud.retail.v2main.SolutionType.SOLUTION_TYPE_RECOMMENDATION].
@@ -156,12 +156,12 @@ public interface ServingConfigOrBuilder
    * highest-priced items first. This setting could result in a decrease in
    * click-through and conversion rates.
    *  Allowed values are:
-   * * 'no-price-reranking'
-   * * 'low-price-raranking'
-   * * 'medium-price-reranking'
-   * * 'high-price-reranking'
+   * * `no-price-reranking`
+   * * `low-price-raranking`
+   * * `medium-price-reranking`
+   * * `high-price-reranking`
    * If not specified, we choose default based on model type. Default value:
-   * 'no-price-reranking'.
+   * `no-price-reranking`.
    * Can only be set if
    * [solution_types][google.cloud.retail.v2.ServingConfig.solution_types] is
    * [SOLUTION_TYPE_RECOMMENDATION][google.cloud.retail.v2main.SolutionType.SOLUTION_TYPE_RECOMMENDATION].
@@ -944,14 +944,14 @@ public interface ServingConfigOrBuilder
    *
    * 
          * How much diversity to use in recommendation model results e.g.
-   * 'medium-diversity' or 'high-diversity'. Currently supported values:
-   * * 'no-diversity'
-   * * 'low-diversity'
-   * * 'medium-diversity'
-   * * 'high-diversity'
-   * * 'auto-diversity'
+   * `medium-diversity` or `high-diversity`. Currently supported values:
+   * * `no-diversity`
+   * * `low-diversity`
+   * * `medium-diversity`
+   * * `high-diversity`
+   * * `auto-diversity`
    * If not specified, we choose default based on recommendation model
-   * type. Default value: 'no-diversity'.
+   * type. Default value: `no-diversity`.
    * Can only be set if
    * [solution_types][google.cloud.retail.v2.ServingConfig.solution_types] is
    * [SOLUTION_TYPE_RECOMMENDATION][google.cloud.retail.v2main.SolutionType.SOLUTION_TYPE_RECOMMENDATION].
@@ -967,14 +967,14 @@ public interface ServingConfigOrBuilder
    *
    * 
          * How much diversity to use in recommendation model results e.g.
-   * 'medium-diversity' or 'high-diversity'. Currently supported values:
-   * * 'no-diversity'
-   * * 'low-diversity'
-   * * 'medium-diversity'
-   * * 'high-diversity'
-   * * 'auto-diversity'
+   * `medium-diversity` or `high-diversity`. Currently supported values:
+   * * `no-diversity`
+   * * `low-diversity`
+   * * `medium-diversity`
+   * * `high-diversity`
+   * * `auto-diversity`
    * If not specified, we choose default based on recommendation model
-   * type. Default value: 'no-diversity'.
+   * type. Default value: `no-diversity`.
    * Can only be set if
    * [solution_types][google.cloud.retail.v2.ServingConfig.solution_types] is
    * [SOLUTION_TYPE_RECOMMENDATION][google.cloud.retail.v2main.SolutionType.SOLUTION_TYPE_RECOMMENDATION].
@@ -990,12 +990,41 @@ public interface ServingConfigOrBuilder
    *
    *
    * 
      -   * Whether to add additional category filters on the 'similar-items' model.
+   * What kind of diversity to use - data driven or rule based. If unset,
+   * the server behavior defaults to
+   * [RULE_BASED_DIVERSITY][google.cloud.retail.v2.ServingConfig.DiversityType.RULE_BASED_DIVERSITY].
+   * 
      
+   *
+   * .google.cloud.retail.v2.ServingConfig.DiversityType diversity_type = 20;
+   *
+   * @return The enum numeric value on the wire for diversityType.
+   */
+  int getDiversityTypeValue();
+  /**
+   *
+   *
+   * 
      +   * What kind of diversity to use - data driven or rule based. If unset,
+   * the server behavior defaults to
+   * [RULE_BASED_DIVERSITY][google.cloud.retail.v2.ServingConfig.DiversityType.RULE_BASED_DIVERSITY].
+   * 
      
+   *
+   * .google.cloud.retail.v2.ServingConfig.DiversityType diversity_type = 20;
+   *
+   * @return The diversityType.
+   */
+  com.google.cloud.retail.v2.ServingConfig.DiversityType getDiversityType();
+
+  /**
+   *
+   *
+   * 
      +   * Whether to add additional category filters on the `similar-items` model.
    * If not specified, we enable it by default.
    *  Allowed values are:
-   * * 'no-category-match': No additional filtering of original results from
+   * * `no-category-match`: No additional filtering of original results from
    *   the model and the customer's filters.
-   * * 'relaxed-category-match': Only keep results with categories that match
+   * * `relaxed-category-match`: Only keep results with categories that match
    *   at least one item categories in the PredictRequests's context item.
    *   * If customer also sends filters in the PredictRequest, then the results
    *   will satisfy both conditions (user given and category match).
@@ -1013,12 +1042,12 @@ public interface ServingConfigOrBuilder
    *
    *
    * 
      -   * Whether to add additional category filters on the 'similar-items' model.
+   * Whether to add additional category filters on the `similar-items` model.
    * If not specified, we enable it by default.
    *  Allowed values are:
-   * * 'no-category-match': No additional filtering of original results from
+   * * `no-category-match`: No additional filtering of original results from
    *   the model and the customer's filters.
-   * * 'relaxed-category-match': Only keep results with categories that match
+   * * `relaxed-category-match`: Only keep results with categories that match
    *   at least one item categories in the PredictRequests's context item.
    *   * If customer also sends filters in the PredictRequest, then the results
    *   will satisfy both conditions (user given and category match).
diff --git a/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/ServingConfigProto.java b/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/ServingConfigProto.java
index d9dac76e1fb0..de38b310f868 100644
--- a/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/ServingConfigProto.java
+++ b/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/ServingConfigProto.java
@@ -45,7 +45,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
           + "i/field_behavior.proto\032\031google/api/resou"
           + "rce.proto\032#google/cloud/retail/v2/common"
           + ".proto\032+google/cloud/retail/v2/search_se"
-          + "rvice.proto\"\305\006\n\rServingConfig\022\021\n\004name\030\001 "
+          + "rvice.proto\"\370\007\n\rServingConfig\022\021\n\004name\030\001 "
           + "\001(\tB\003\340A\005\022\031\n\014display_name\030\002 \001(\tB\003\340A\002\022\020\n\010m"
           + "odel_id\030\003 \001(\t\022\035\n\025price_reranking_level\030\004"
           + " \001(\t\022\031\n\021facet_control_ids\030\005 \003(\t\022R\n\022dynam"
@@ -57,21 +57,25 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
           + "\033oneway_synonyms_control_ids\030\014 \003(\t\022$\n\034do"
           + "_not_associate_control_ids\030\r \003(\t\022\037\n\027repl"
           + "acement_control_ids\030\016 \003(\t\022\032\n\022ignore_cont"
-          + "rol_ids\030\017 \003(\t\022\027\n\017diversity_level\030\010 \001(\t\022$"
-          + "\n\034enable_category_filter_level\030\020 \001(\t\022W\n\024"
-          + "personalization_spec\030\025 \001(\01329.google.clou"
-          + "d.retail.v2.SearchRequest.Personalizatio"
-          + "nSpec\022D\n\016solution_types\030\023 \003(\0162$.google.c"
-          + "loud.retail.v2.SolutionTypeB\006\340A\002\340A\005:\205\001\352A"
-          + "\201\001\n#retail.googleapis.com/ServingConfig\022"
-          + "Zprojects/{project}/locations/{location}"
-          + "/catalogs/{catalog}/servingConfigs/{serv"
-          + "ing_config}B\307\001\n\032com.google.cloud.retail."
-          + "v2B\022ServingConfigProtoP\001Z
    * The categories associated with a category page.
    * To represent full path of category, use '>' sign to separate different
-   * hierarchies. If '>' is part of the category name, please replace it with
+   * hierarchies. If '>' is part of the category name, replace it with
    * other character(s).
    * Category pages include special pages such as sales or promotions. For
    * instance, a special sale page may have the category hierarchy:
@@ -1220,7 +1220,7 @@ public com.google.protobuf.ProtocolStringList getPageCategoriesList() {
    * 
          * The categories associated with a category page.
    * To represent full path of category, use '>' sign to separate different
-   * hierarchies. If '>' is part of the category name, please replace it with
+   * hierarchies. If '>' is part of the category name, replace it with
    * other character(s).
    * Category pages include special pages such as sales or promotions. For
    * instance, a special sale page may have the category hierarchy:
@@ -1245,7 +1245,7 @@ public int getPageCategoriesCount() {
    * 
          * The categories associated with a category page.
    * To represent full path of category, use '>' sign to separate different
-   * hierarchies. If '>' is part of the category name, please replace it with
+   * hierarchies. If '>' is part of the category name, replace it with
    * other character(s).
    * Category pages include special pages such as sales or promotions. For
    * instance, a special sale page may have the category hierarchy:
@@ -1271,7 +1271,7 @@ public java.lang.String getPageCategories(int index) {
    * 
          * The categories associated with a category page.
    * To represent full path of category, use '>' sign to separate different
-   * hierarchies. If '>' is part of the category name, please replace it with
+   * hierarchies. If '>' is part of the category name, replace it with
    * other character(s).
    * Category pages include special pages such as sales or promotions. For
    * instance, a special sale page may have the category hierarchy:
@@ -5359,7 +5359,7 @@ private void ensurePageCategoriesIsMutable() {
      * 
            * The categories associated with a category page.
      * To represent full path of category, use '>' sign to separate different
-     * hierarchies. If '>' is part of the category name, please replace it with
+     * hierarchies. If '>' is part of the category name, replace it with
      * other character(s).
      * Category pages include special pages such as sales or promotions. For
      * instance, a special sale page may have the category hierarchy:
@@ -5384,7 +5384,7 @@ public com.google.protobuf.ProtocolStringList getPageCategoriesList() {
      * 
            * The categories associated with a category page.
      * To represent full path of category, use '>' sign to separate different
-     * hierarchies. If '>' is part of the category name, please replace it with
+     * hierarchies. If '>' is part of the category name, replace it with
      * other character(s).
      * Category pages include special pages such as sales or promotions. For
      * instance, a special sale page may have the category hierarchy:
@@ -5409,7 +5409,7 @@ public int getPageCategoriesCount() {
      * 
            * The categories associated with a category page.
      * To represent full path of category, use '>' sign to separate different
-     * hierarchies. If '>' is part of the category name, please replace it with
+     * hierarchies. If '>' is part of the category name, replace it with
      * other character(s).
      * Category pages include special pages such as sales or promotions. For
      * instance, a special sale page may have the category hierarchy:
@@ -5435,7 +5435,7 @@ public java.lang.String getPageCategories(int index) {
      * 
            * The categories associated with a category page.
      * To represent full path of category, use '>' sign to separate different
-     * hierarchies. If '>' is part of the category name, please replace it with
+     * hierarchies. If '>' is part of the category name, replace it with
      * other character(s).
      * Category pages include special pages such as sales or promotions. For
      * instance, a special sale page may have the category hierarchy:
@@ -5461,7 +5461,7 @@ public com.google.protobuf.ByteString getPageCategoriesBytes(int index) {
      * 
            * The categories associated with a category page.
      * To represent full path of category, use '>' sign to separate different
-     * hierarchies. If '>' is part of the category name, please replace it with
+     * hierarchies. If '>' is part of the category name, replace it with
      * other character(s).
      * Category pages include special pages such as sales or promotions. For
      * instance, a special sale page may have the category hierarchy:
@@ -5494,7 +5494,7 @@ public Builder setPageCategories(int index, java.lang.String value) {
      * 
            * The categories associated with a category page.
      * To represent full path of category, use '>' sign to separate different
-     * hierarchies. If '>' is part of the category name, please replace it with
+     * hierarchies. If '>' is part of the category name, replace it with
      * other character(s).
      * Category pages include special pages such as sales or promotions. For
      * instance, a special sale page may have the category hierarchy:
@@ -5526,7 +5526,7 @@ public Builder addPageCategories(java.lang.String value) {
      * 
            * The categories associated with a category page.
      * To represent full path of category, use '>' sign to separate different
-     * hierarchies. If '>' is part of the category name, please replace it with
+     * hierarchies. If '>' is part of the category name, replace it with
      * other character(s).
      * Category pages include special pages such as sales or promotions. For
      * instance, a special sale page may have the category hierarchy:
@@ -5555,7 +5555,7 @@ public Builder addAllPageCategories(java.lang.Iterable values)
      * 
            * The categories associated with a category page.
      * To represent full path of category, use '>' sign to separate different
-     * hierarchies. If '>' is part of the category name, please replace it with
+     * hierarchies. If '>' is part of the category name, replace it with
      * other character(s).
      * Category pages include special pages such as sales or promotions. For
      * instance, a special sale page may have the category hierarchy:
@@ -5583,7 +5583,7 @@ public Builder clearPageCategories() {
      * 
            * The categories associated with a category page.
      * To represent full path of category, use '>' sign to separate different
-     * hierarchies. If '>' is part of the category name, please replace it with
+     * hierarchies. If '>' is part of the category name, replace it with
      * other character(s).
      * Category pages include special pages such as sales or promotions. For
      * instance, a special sale page may have the category hierarchy:
diff --git a/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/UserEventOrBuilder.java b/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/UserEventOrBuilder.java
index d50e1f9a6ef1..a9688d793c6a 100644
--- a/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/UserEventOrBuilder.java
+++ b/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/UserEventOrBuilder.java
@@ -832,7 +832,7 @@ com.google.cloud.retail.v2.CustomAttribute getAttributesOrDefault(
    * 
          * The categories associated with a category page.
    * To represent full path of category, use '>' sign to separate different
-   * hierarchies. If '>' is part of the category name, please replace it with
+   * hierarchies. If '>' is part of the category name, replace it with
    * other character(s).
    * Category pages include special pages such as sales or promotions. For
    * instance, a special sale page may have the category hierarchy:
@@ -855,7 +855,7 @@ com.google.cloud.retail.v2.CustomAttribute getAttributesOrDefault(
    * 
          * The categories associated with a category page.
    * To represent full path of category, use '>' sign to separate different
-   * hierarchies. If '>' is part of the category name, please replace it with
+   * hierarchies. If '>' is part of the category name, replace it with
    * other character(s).
    * Category pages include special pages such as sales or promotions. For
    * instance, a special sale page may have the category hierarchy:
@@ -878,7 +878,7 @@ com.google.cloud.retail.v2.CustomAttribute getAttributesOrDefault(
    * 
          * The categories associated with a category page.
    * To represent full path of category, use '>' sign to separate different
-   * hierarchies. If '>' is part of the category name, please replace it with
+   * hierarchies. If '>' is part of the category name, replace it with
    * other character(s).
    * Category pages include special pages such as sales or promotions. For
    * instance, a special sale page may have the category hierarchy:
@@ -902,7 +902,7 @@ com.google.cloud.retail.v2.CustomAttribute getAttributesOrDefault(
    * 
          * The categories associated with a category page.
    * To represent full path of category, use '>' sign to separate different
-   * hierarchies. If '>' is part of the category name, please replace it with
+   * hierarchies. If '>' is part of the category name, replace it with
    * other character(s).
    * Category pages include special pages such as sales or promotions. For
    * instance, a special sale page may have the category hierarchy:
diff --git a/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/UserEventServiceProto.java b/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/UserEventServiceProto.java
index e3df490c1ccb..a75573cd38db 100644
--- a/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/UserEventServiceProto.java
+++ b/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/UserEventServiceProto.java
@@ -60,61 +60,64 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
           + "ice.proto\022\026google.cloud.retail.v2\032\034googl"
           + "e/api/annotations.proto\032\027google/api/clie"
           + "nt.proto\032\037google/api/field_behavior.prot"
-          + "o\032\031google/api/httpbody.proto\032*google/clo"
-          + "ud/retail/v2/import_config.proto\032)google"
-          + "/cloud/retail/v2/purge_config.proto\032\'goo"
-          + "gle/cloud/retail/v2/user_event.proto\032#go"
-          + "ogle/longrunning/operations.proto\"h\n\025Wri"
-          + "teUserEventRequest\022\023\n\006parent\030\001 \001(\tB\003\340A\002\022"
-          + ":\n\nuser_event\030\002 \001(\0132!.google.cloud.retai"
-          + "l.v2.UserEventB\003\340A\002\"a\n\027CollectUserEventR"
-          + "equest\022\023\n\006parent\030\001 \001(\tB\003\340A\002\022\027\n\nuser_even"
-          + "t\030\002 \001(\tB\003\340A\002\022\013\n\003uri\030\003 \001(\t\022\013\n\003ets\030\004 \001(\003\"\376"
-          + "\001\n\027RejoinUserEventsRequest\022\023\n\006parent\030\001 \001"
-          + "(\tB\003\340A\002\022e\n\027user_event_rejoin_scope\030\002 \001(\016"
-          + "2D.google.cloud.retail.v2.RejoinUserEven"
-          + "tsRequest.UserEventRejoinScope\"g\n\024UserEv"
-          + "entRejoinScope\022\'\n#USER_EVENT_REJOIN_SCOP"
-          + "E_UNSPECIFIED\020\000\022\021\n\rJOINED_EVENTS\020\001\022\023\n\017UN"
-          + "JOINED_EVENTS\020\002\">\n\030RejoinUserEventsRespo"
-          + "nse\022\"\n\032rejoined_user_events_count\030\001 \001(\003\""
-          + "\032\n\030RejoinUserEventsMetadata2\277\t\n\020UserEven"
-          + "tService\022\267\001\n\016WriteUserEvent\022-.google.clo"
-          + "ud.retail.v2.WriteUserEventRequest\032!.goo"
-          + "gle.cloud.retail.v2.UserEvent\"S\202\323\344\223\002M\"?/"
+          + "o\032\031google/api/httpbody.proto\032\031google/api"
+          + "/resource.proto\032*google/cloud/retail/v2/"
+          + "import_config.proto\032)google/cloud/retail"
+          + "/v2/purge_config.proto\032\'google/cloud/ret"
+          + "ail/v2/user_event.proto\032#google/longrunn"
+          + "ing/operations.proto\"}\n\025WriteUserEventRe"
+          + "quest\022\023\n\006parent\030\001 \001(\tB\003\340A\002\022:\n\nuser_event"
+          + "\030\002 \001(\0132!.google.cloud.retail.v2.UserEven"
+          + "tB\003\340A\002\022\023\n\013write_async\030\003 \001(\010\"\237\001\n\027CollectU"
+          + "serEventRequest\022\027\n\rprebuilt_rule\030\006 \001(\tH\000"
+          + "\022\023\n\006parent\030\001 \001(\tB\003\340A\002\022\027\n\nuser_event\030\002 \001("
+          + "\tB\003\340A\002\022\013\n\003uri\030\003 \001(\t\022\013\n\003ets\030\004 \001(\003\022\020\n\010raw_"
+          + "json\030\005 \001(\tB\021\n\017conversion_rule\"\376\001\n\027Rejoin"
+          + "UserEventsRequest\022\023\n\006parent\030\001 \001(\tB\003\340A\002\022e"
+          + "\n\027user_event_rejoin_scope\030\002 \001(\0162D.google"
+          + ".cloud.retail.v2.RejoinUserEventsRequest"
+          + ".UserEventRejoinScope\"g\n\024UserEventRejoin"
+          + "Scope\022\'\n#USER_EVENT_REJOIN_SCOPE_UNSPECI"
+          + "FIED\020\000\022\021\n\rJOINED_EVENTS\020\001\022\023\n\017UNJOINED_EV"
+          + "ENTS\020\002\">\n\030RejoinUserEventsResponse\022\"\n\032re"
+          + "joined_user_events_count\030\001 \001(\003\"\032\n\030Rejoin"
+          + "UserEventsMetadata2\277\t\n\020UserEventService\022"
+          + "\267\001\n\016WriteUserEvent\022-.google.cloud.retail"
+          + ".v2.WriteUserEventRequest\032!.google.cloud"
+          + ".retail.v2.UserEvent\"S\202\323\344\223\002M\"?/v2/{paren"
+          + "t=projects/*/locations/*/catalogs/*}/use"
+          + "rEvents:write:\nuser_event\022\244\001\n\020CollectUse"
+          + "rEvent\022/.google.cloud.retail.v2.CollectU"
+          + "serEventRequest\032\024.google.api.HttpBody\"I\202"
+          + "\323\344\223\002C\022A/v2/{parent=projects/*/locations/"
+          + "*/catalogs/*}/userEvents:collect\022\206\002\n\017Pur"
+          + "geUserEvents\022..google.cloud.retail.v2.Pu"
+          + "rgeUserEventsRequest\032\035.google.longrunnin"
+          + "g.Operation\"\243\001\202\323\344\223\002D\"?/v2/{parent=projec"
+          + "ts/*/locations/*/catalogs/*}/userEvents:"
+          + "purge:\001*\312AV\n.google.cloud.retail.v2.Purg"
+          + "eUserEventsResponse\022$google.cloud.retail"
+          + ".v2.PurgeMetadata\022\213\002\n\020ImportUserEvents\022/"
+          + ".google.cloud.retail.v2.ImportUserEvents"
+          + "Request\032\035.google.longrunning.Operation\"\246"
+          + "\001\202\323\344\223\002E\"@/v2/{parent=projects/*/location"
+          + "s/*/catalogs/*}/userEvents:import:\001*\312AX\n"
+          + "/google.cloud.retail.v2.ImportUserEvents"
+          + "Response\022%google.cloud.retail.v2.ImportM"
+          + "etadata\022\347\001\n\020RejoinUserEvents\022/.google.cl"
+          + "oud.retail.v2.RejoinUserEventsRequest\032\035."
+          + "google.longrunning.Operation\"\202\001\202\323\344\223\002E\"@/"
           + "v2/{parent=projects/*/locations/*/catalo"
-          + "gs/*}/userEvents:write:\nuser_event\022\244\001\n\020C"
-          + "ollectUserEvent\022/.google.cloud.retail.v2"
-          + ".CollectUserEventRequest\032\024.google.api.Ht"
-          + "tpBody\"I\202\323\344\223\002C\022A/v2/{parent=projects/*/l"
-          + "ocations/*/catalogs/*}/userEvents:collec"
-          + "t\022\206\002\n\017PurgeUserEvents\022..google.cloud.ret"
-          + "ail.v2.PurgeUserEventsRequest\032\035.google.l"
-          + "ongrunning.Operation\"\243\001\202\323\344\223\002D\"?/v2/{pare"
-          + "nt=projects/*/locations/*/catalogs/*}/us"
-          + "erEvents:purge:\001*\312AV\n.google.cloud.retai"
-          + "l.v2.PurgeUserEventsResponse\022$google.clo"
-          + "ud.retail.v2.PurgeMetadata\022\213\002\n\020ImportUse"
-          + "rEvents\022/.google.cloud.retail.v2.ImportU"
-          + "serEventsRequest\032\035.google.longrunning.Op"
-          + "eration\"\246\001\202\323\344\223\002E\"@/v2/{parent=projects/*"
-          + "/locations/*/catalogs/*}/userEvents:impo"
-          + "rt:\001*\312AX\n/google.cloud.retail.v2.ImportU"
-          + "serEventsResponse\022%google.cloud.retail.v"
-          + "2.ImportMetadata\022\347\001\n\020RejoinUserEvents\022/."
-          + "google.cloud.retail.v2.RejoinUserEventsR"
-          + "equest\032\035.google.longrunning.Operation\"\202\001"
-          + "\202\323\344\223\002E\"@/v2/{parent=projects/*/locations"
-          + "/*/catalogs/*}/userEvents:rejoin:\001*\312A4\n\030"
-          + "RejoinUserEventsResponse\022\030RejoinUserEven"
-          + "tsMetadata\032I\312A\025retail.googleapis.com\322A.h"
-          + "ttps://www.googleapis.com/auth/cloud-pla"
-          + "tformB\312\001\n\032com.google.cloud.retail.v2B\025Us"
-          + "erEventServiceProtoP\001Z
+   * If set to true, the user event will be written asynchronously after
+   * validation, and the API will respond without waiting for the write.
+   * Therefore, silent failures can occur even if the API returns success. In
+   * case of silent failures, error messages can be found in Stackdriver logs.
+   * 
      
+   *
+   * bool write_async = 3;
+   *
+   * @return The writeAsync.
+   */
+  @java.lang.Override
+  public boolean getWriteAsync() {
+    return writeAsync_;
+  }
+
   private byte memoizedIsInitialized = -1;
 
   @java.lang.Override
@@ -192,6 +213,9 @@ public void writeTo(com.google.protobuf.CodedOutputStream output) throws java.io
     if (userEvent_ != null) {
       output.writeMessage(2, getUserEvent());
     }
+    if (writeAsync_ != false) {
+      output.writeBool(3, writeAsync_);
+    }
     getUnknownFields().writeTo(output);
   }
 
@@ -207,6 +231,9 @@ public int getSerializedSize() {
     if (userEvent_ != null) {
       size += com.google.protobuf.CodedOutputStream.computeMessageSize(2, getUserEvent());
     }
+    if (writeAsync_ != false) {
+      size += com.google.protobuf.CodedOutputStream.computeBoolSize(3, writeAsync_);
+    }
     size += getUnknownFields().getSerializedSize();
     memoizedSize = size;
     return size;
@@ -228,6 +255,7 @@ public boolean equals(final java.lang.Object obj) {
     if (hasUserEvent()) {
       if (!getUserEvent().equals(other.getUserEvent())) return false;
     }
+    if (getWriteAsync() != other.getWriteAsync()) return false;
     if (!getUnknownFields().equals(other.getUnknownFields())) return false;
     return true;
   }
@@ -245,6 +273,8 @@ public int hashCode() {
       hash = (37 * hash) + USER_EVENT_FIELD_NUMBER;
       hash = (53 * hash) + getUserEvent().hashCode();
     }
+    hash = (37 * hash) + WRITE_ASYNC_FIELD_NUMBER;
+    hash = (53 * hash) + com.google.protobuf.Internal.hashBoolean(getWriteAsync());
     hash = (29 * hash) + getUnknownFields().hashCode();
     memoizedHashCode = hash;
     return hash;
@@ -391,6 +421,8 @@ public Builder clear() {
         userEvent_ = null;
         userEventBuilder_ = null;
       }
+      writeAsync_ = false;
+
       return this;
     }
 
@@ -424,6 +456,7 @@ public com.google.cloud.retail.v2.WriteUserEventRequest buildPartial() {
       } else {
         result.userEvent_ = userEventBuilder_.build();
       }
+      result.writeAsync_ = writeAsync_;
       onBuilt();
       return result;
     }
@@ -481,6 +514,9 @@ public Builder mergeFrom(com.google.cloud.retail.v2.WriteUserEventRequest other)
       if (other.hasUserEvent()) {
         mergeUserEvent(other.getUserEvent());
       }
+      if (other.getWriteAsync() != false) {
+        setWriteAsync(other.getWriteAsync());
+      }
       this.mergeUnknownFields(other.getUnknownFields());
       onChanged();
       return this;
@@ -519,6 +555,12 @@ public Builder mergeFrom(
 
                 break;
               } // case 18
+            case 24:
+              {
+                writeAsync_ = input.readBool();
+
+                break;
+              } // case 24
             default:
               {
                 if (!super.parseUnknownField(input, extensionRegistry, tag)) {
@@ -850,6 +892,67 @@ public com.google.cloud.retail.v2.UserEventOrBuilder getUserEventOrBuilder() {
       return userEventBuilder_;
     }
 
+    private boolean writeAsync_;
+    /**
+     *
+     *
+     * 
      +     * If set to true, the user event will be written asynchronously after
+     * validation, and the API will respond without waiting for the write.
+     * Therefore, silent failures can occur even if the API returns success. In
+     * case of silent failures, error messages can be found in Stackdriver logs.
+     * 
      
+     *
+     * bool write_async = 3;
+     *
+     * @return The writeAsync.
+     */
+    @java.lang.Override
+    public boolean getWriteAsync() {
+      return writeAsync_;
+    }
+    /**
+     *
+     *
+     * 
      +     * If set to true, the user event will be written asynchronously after
+     * validation, and the API will respond without waiting for the write.
+     * Therefore, silent failures can occur even if the API returns success. In
+     * case of silent failures, error messages can be found in Stackdriver logs.
+     * 
      
+     *
+     * bool write_async = 3;
+     *
+     * @param value The writeAsync to set.
+     * @return This builder for chaining.
+     */
+    public Builder setWriteAsync(boolean value) {
+
+      writeAsync_ = value;
+      onChanged();
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * If set to true, the user event will be written asynchronously after
+     * validation, and the API will respond without waiting for the write.
+     * Therefore, silent failures can occur even if the API returns success. In
+     * case of silent failures, error messages can be found in Stackdriver logs.
+     * 
      
+     *
+     * bool write_async = 3;
+     *
+     * @return This builder for chaining.
+     */
+    public Builder clearWriteAsync() {
+
+      writeAsync_ = false;
+      onChanged();
+      return this;
+    }
+
     @java.lang.Override
     public final Builder setUnknownFields(final com.google.protobuf.UnknownFieldSet unknownFields) {
       return super.setUnknownFields(unknownFields);
diff --git a/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/WriteUserEventRequestOrBuilder.java b/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/WriteUserEventRequestOrBuilder.java
index fc282b7feacf..4694ecc48541 100644
--- a/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/WriteUserEventRequestOrBuilder.java
+++ b/java-retail/proto-google-cloud-retail-v2/src/main/java/com/google/cloud/retail/v2/WriteUserEventRequestOrBuilder.java
@@ -90,4 +90,20 @@ public interface WriteUserEventRequestOrBuilder
    * 
    */
   com.google.cloud.retail.v2.UserEventOrBuilder getUserEventOrBuilder();
+
+  /**
+   *
+   *
+   * 
      +   * If set to true, the user event will be written asynchronously after
+   * validation, and the API will respond without waiting for the write.
+   * Therefore, silent failures can occur even if the API returns success. In
+   * case of silent failures, error messages can be found in Stackdriver logs.
+   * 
      
+   *
+   * bool write_async = 3;
+   *
+   * @return The writeAsync.
+   */
+  boolean getWriteAsync();
 }
diff --git a/java-retail/proto-google-cloud-retail-v2/src/main/proto/google/cloud/retail/v2/catalog.proto b/java-retail/proto-google-cloud-retail-v2/src/main/proto/google/cloud/retail/v2/catalog.proto
index 0e1b85f6af08..156e061ec945 100644
--- a/java-retail/proto-google-cloud-retail-v2/src/main/proto/google/cloud/retail/v2/catalog.proto
+++ b/java-retail/proto-google-cloud-retail-v2/src/main/proto/google/cloud/retail/v2/catalog.proto
@@ -104,8 +104,7 @@ message CatalogAttribute {
 
   // The status of the indexable option of a catalog attribute.
   enum IndexableOption {
-    // Value used when unset. Defaults to
-    // [INDEXABLE_ENABLED][google.cloud.retail.v2.CatalogAttribute.IndexableOption.INDEXABLE_ENABLED].
+    // Value used when unset.
     INDEXABLE_OPTION_UNSPECIFIED = 0;
 
     // Indexable option enabled for an attribute.
@@ -117,8 +116,7 @@ message CatalogAttribute {
 
   // The status of the dynamic facetable option of a catalog attribute.
   enum DynamicFacetableOption {
-    // Value used when unset. Defaults to
-    // [DYNAMIC_FACETABLE_ENABLED][google.cloud.retail.v2.CatalogAttribute.DynamicFacetableOption.DYNAMIC_FACETABLE_ENABLED].
+    // Value used when unset.
     DYNAMIC_FACETABLE_OPTION_UNSPECIFIED = 0;
 
     // Dynamic facetable option enabled for an attribute.
@@ -130,8 +128,7 @@ message CatalogAttribute {
 
   // The status of the searchable option of a catalog attribute.
   enum SearchableOption {
-    // Value used when unset. Defaults to
-    // [SEARCHABLE_DISABLED][google.cloud.retail.v2.CatalogAttribute.SearchableOption.SEARCHABLE_DISABLED].
+    // Value used when unset.
     SEARCHABLE_OPTION_UNSPECIFIED = 0;
 
     // Searchable option enabled for an attribute.
@@ -141,6 +138,32 @@ message CatalogAttribute {
     SEARCHABLE_DISABLED = 2;
   }
 
+  // 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].
+    EXACT_SEARCHABLE_OPTION_UNSPECIFIED = 0;
+
+    // Exact searchable option enabled for an attribute.
+    EXACT_SEARCHABLE_ENABLED = 1;
+
+    // Exact searchable option disabled for an attribute.
+    EXACT_SEARCHABLE_DISABLED = 2;
+  }
+
+  // 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].
+    RETRIEVABLE_OPTION_UNSPECIFIED = 0;
+
+    // Retrievable option enabled for an attribute.
+    RETRIEVABLE_ENABLED = 1;
+
+    // Retrievable option disabled for an attribute.
+    RETRIEVABLE_DISABLED = 2;
+  }
+
   // Required. Attribute name.
   // For example: `color`, `brands`, `attributes.custom_attribute`, such as
   // `attributes.xyz`.
@@ -164,13 +187,13 @@ message CatalogAttribute {
   // APIs. This field is `False` for pre-loaded
   // [CatalogAttribute][google.cloud.retail.v2.CatalogAttribute]s.
   //
-  // Only pre-loaded
-  // [CatalogAttribute][google.cloud.retail.v2.CatalogAttribute]s that are
-  // neither in use by products nor predefined can be deleted.
-  // [CatalogAttribute][google.cloud.retail.v2.CatalogAttribute]s that are
-  // either in use by products or are predefined cannot be deleted; however,
-  // their configuration properties will reset to default values upon removal
-  // request.
+  // Only pre-loaded [catalog
+  // attributes][google.cloud.retail.v2.CatalogAttribute] that are neither in
+  // use by products nor predefined can be deleted. [Catalog
+  // attributes][google.cloud.retail.v2.CatalogAttribute] that are
+  // either in use by products or are predefined attributes cannot be deleted;
+  // however, their configuration properties will reset to default values upon
+  // removal request.
   //
   // After catalog changes, it takes about 10 minutes for this field to update.
   bool in_use = 9 [(google.api.field_behavior) = OUTPUT_ONLY];
@@ -184,12 +207,16 @@ message CatalogAttribute {
   // is CATALOG_LEVEL_ATTRIBUTE_CONFIG, if INDEXABLE_ENABLED attribute values
   // are indexed so that it can be filtered, faceted, or boosted in
   // [SearchService.Search][google.cloud.retail.v2.SearchService.Search].
+  //
+  // Must be specified, otherwise throws INVALID_FORMAT error.
   IndexableOption indexable_option = 5;
 
   // If DYNAMIC_FACETABLE_ENABLED, attribute values are available for dynamic
   // facet. Could only be DYNAMIC_FACETABLE_DISABLED if
   // [CatalogAttribute.indexable_option][google.cloud.retail.v2.CatalogAttribute.indexable_option]
   // is INDEXABLE_DISABLED. Otherwise, an INVALID_ARGUMENT error is returned.
+  //
+  // Must be specified, otherwise throws INVALID_FORMAT error.
   DynamicFacetableOption dynamic_facetable_option = 6;
 
   // When
@@ -202,7 +229,18 @@ message CatalogAttribute {
   // will not be searchable by text queries in
   // [SearchService.Search][google.cloud.retail.v2.SearchService.Search], as
   // there are no text values associated to numerical attributes.
+  //
+  // Must be specified, otherwise throws INVALID_FORMAT error.
   SearchableOption searchable_option = 7;
+
+  // 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.
+  ExactSearchableOption exact_searchable_option = 11;
+
+  // If RETRIEVABLE_ENABLED, attribute values are retrievable in the search
+  // results.
+  RetrievableOption retrievable_option = 12;
 }
 
 // Catalog level attribute config.
diff --git a/java-retail/proto-google-cloud-retail-v2/src/main/proto/google/cloud/retail/v2/catalog_service.proto b/java-retail/proto-google-cloud-retail-v2/src/main/proto/google/cloud/retail/v2/catalog_service.proto
index 4d667d1f9e34..da6f5a2b8d8f 100644
--- a/java-retail/proto-google-cloud-retail-v2/src/main/proto/google/cloud/retail/v2/catalog_service.proto
+++ b/java-retail/proto-google-cloud-retail-v2/src/main/proto/google/cloud/retail/v2/catalog_service.proto
@@ -339,7 +339,7 @@ message GetDefaultBranchResponse {
 // method.
 message GetCompletionConfigRequest {
   // 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`
   string name = 1 [
     (google.api.field_behavior) = REQUIRED,
     (google.api.resource_reference) = {
diff --git a/java-retail/proto-google-cloud-retail-v2/src/main/proto/google/cloud/retail/v2/common.proto b/java-retail/proto-google-cloud-retail-v2/src/main/proto/google/cloud/retail/v2/common.proto
index 9864ee7d64f5..5db569dd8ab4 100644
--- a/java-retail/proto-google-cloud-retail-v2/src/main/proto/google/cloud/retail/v2/common.proto
+++ b/java-retail/proto-google-cloud-retail-v2/src/main/proto/google/cloud/retail/v2/common.proto
@@ -83,8 +83,8 @@ message Condition {
     // Value cannot be empty.
     // Value can have at most 3 terms if specified as a partial match. Each
     // space separated string is considered as one term.
-    // Example) "a b c" is 3 terms and allowed, " a b c d" is 4 terms and not
-    // allowed for partial match.
+    // For example, "a b c" is 3 terms and allowed, but " a b c d" is 4 terms
+    // and not allowed for a partial match.
     string value = 1;
 
     // Whether this is supposed to be a full or partial match.
@@ -113,6 +113,7 @@ message Condition {
 }
 
 // A rule is a condition-action pair
+//
 // * A condition defines when a rule is to be triggered.
 // * An action specifies what occurs on that trigger.
 // Currently rules only work for [controls][google.cloud.retail.v2.Control] with
@@ -201,7 +202,8 @@ message Rule {
   }
 
   // Creates a set of terms that will be treated as synonyms of each other.
-  // Example: synonyms of "sneakers" and "shoes".
+  // Example: synonyms of "sneakers" and "shoes":
+  //
   //  * "sneakers" will use a synonym of "shoes".
   //  * "shoes" will use a synonym of "sneakers".
   message TwowaySynonymsAction {
diff --git a/java-retail/proto-google-cloud-retail-v2/src/main/proto/google/cloud/retail/v2/completion_service.proto b/java-retail/proto-google-cloud-retail-v2/src/main/proto/google/cloud/retail/v2/completion_service.proto
index af0fac87e79c..86493f8a2a6e 100644
--- a/java-retail/proto-google-cloud-retail-v2/src/main/proto/google/cloud/retail/v2/completion_service.proto
+++ b/java-retail/proto-google-cloud-retail-v2/src/main/proto/google/cloud/retail/v2/completion_service.proto
@@ -36,7 +36,7 @@ option ruby_package = "Google::Cloud::Retail::V2";
 // Auto-completion service for retail.
 //
 // This feature is only available for users who have Retail Search enabled.
-// Please enable Retail Search on Cloud Console before using this feature.
+// Enable Retail Search on Cloud Console before using this feature.
 service CompletionService {
   option (google.api.default_host) = "retail.googleapis.com";
   option (google.api.oauth_scopes) =
@@ -45,7 +45,7 @@ service CompletionService {
   // Completes the specified prefix with keyword suggestions.
   //
   // This feature is only available for users who have Retail Search enabled.
-  // Please enable Retail Search on Cloud Console before using this feature.
+  // Enable Retail Search on Cloud Console before using this feature.
   rpc CompleteQuery(CompleteQueryRequest) returns (CompleteQueryResponse) {
     option (google.api.http) = {
       get: "/v2/{catalog=projects/*/locations/*/catalogs/*}:completeQuery"
@@ -60,7 +60,7 @@ service CompletionService {
   // are indexed successfully and ready for serving. The process takes hours.
   //
   // This feature is only available for users who have Retail Search enabled.
-  // Please enable Retail Search on Cloud Console before using this feature.
+  // Enable Retail Search on Cloud Console before using this feature.
   rpc ImportCompletionData(ImportCompletionDataRequest)
       returns (google.longrunning.Operation) {
     option (google.api.http) = {
@@ -110,8 +110,10 @@ message CompleteQueryRequest {
   // number of language codes is 3.
   repeated string language_codes = 3;
 
-  // The device type context for completion suggestions.
-  // It is useful to apply different suggestions on different device types, e.g.
+  // The device type context for completion suggestions. We recommend that you
+  // leave this field empty.
+  //
+  // It can apply different suggestions on different device types, e.g.
   // `DESKTOP`, `MOBILE`. If it is empty, the suggestions are across all device
   // types.
   //
diff --git a/java-retail/proto-google-cloud-retail-v2/src/main/proto/google/cloud/retail/v2/control.proto b/java-retail/proto-google-cloud-retail-v2/src/main/proto/google/cloud/retail/v2/control.proto
index 5558e44dd8cc..4dc94aa38929 100644
--- a/java-retail/proto-google-cloud-retail-v2/src/main/proto/google/cloud/retail/v2/control.proto
+++ b/java-retail/proto-google-cloud-retail-v2/src/main/proto/google/cloud/retail/v2/control.proto
@@ -60,9 +60,8 @@ message Control {
   // characters. Otherwise, an INVALID_ARGUMENT error is thrown.
   string display_name = 2 [(google.api.field_behavior) = REQUIRED];
 
-  // Output only. List of [serving
-  // configuration][google.cloud.retail.v2.ServingConfig] ids that are
-  // associated with this control in the same
+  // Output only. List of [serving config][google.cloud.retail.v2.ServingConfig]
+  // ids that are associated with this control in the same
   // [Catalog][google.cloud.retail.v2.Catalog].
   //
   // Note the association is managed via the
diff --git a/java-retail/proto-google-cloud-retail-v2/src/main/proto/google/cloud/retail/v2/prediction_service.proto b/java-retail/proto-google-cloud-retail-v2/src/main/proto/google/cloud/retail/v2/prediction_service.proto
index 717405b2b81e..48b46bc812d1 100644
--- a/java-retail/proto-google-cloud-retail-v2/src/main/proto/google/cloud/retail/v2/prediction_service.proto
+++ b/java-retail/proto-google-cloud-retail-v2/src/main/proto/google/cloud/retail/v2/prediction_service.proto
@@ -19,6 +19,7 @@ package google.cloud.retail.v2;
 import "google/api/annotations.proto";
 import "google/api/client.proto";
 import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
 import "google/cloud/retail/v2/user_event.proto";
 import "google/protobuf/struct.proto";
 
@@ -61,7 +62,7 @@ message PredictRequest {
   // The ID of the Recommendations AI serving config or placement.
   // Before you can request predictions from your model, you must create at
   // least one serving config or placement for it. For more information, see
-  // [Managing serving configurations]
+  // [Manage serving configs]
   // (https://cloud.google.com/retail/docs/manage-configs).
   //
   // The full list of available serving configs can be seen at
@@ -116,12 +117,11 @@ message PredictRequest {
   //  * filterOutOfStockItems  tag=(-"promotional")
   //  * filterOutOfStockItems
   //
-  // If your filter blocks all prediction results, the API will return generic
-  // (unfiltered) popular products. If you only want results strictly matching
-  // the filters, set `strictFiltering` to True in `PredictRequest.params` to
-  // receive empty results instead.
-  // Note that the API will never return items with storageStatus of "EXPIRED"
-  // or "DELETED" regardless of filter choices.
+  // If your filter blocks all prediction results, the API will return *no*
+  // results. If instead you want empty result sets to return generic
+  // (unfiltered) popular products, set `strictFiltering` to False in
+  // `PredictRequest.params`. Note that the API will never return items with
+  // storageStatus of "EXPIRED" or "DELETED" regardless of filter choices.
   //
   // If `filterSyntaxV2` is set to true under the `params` field, then
   // attribute-based expressions are expected instead of the above described
@@ -148,7 +148,7 @@ message PredictRequest {
   // * `returnScore`: Boolean. If set to true, the prediction 'score'
   //    corresponding to each returned product will be set in the
   //    `results.metadata` field in the prediction response. The given
-  //    'score' indicates the probability of an product being clicked/purchased
+  //    'score' indicates the probability of a product being clicked/purchased
   //    given the user's context and history.
   // * `strictFiltering`: Boolean. True by default. If set to false, the service
   //    will return generic (unfiltered) popular products instead of empty if
diff --git a/java-retail/proto-google-cloud-retail-v2/src/main/proto/google/cloud/retail/v2/product.proto b/java-retail/proto-google-cloud-retail-v2/src/main/proto/google/cloud/retail/v2/product.proto
index fe5d212cf07d..5d61470d3c21 100644
--- a/java-retail/proto-google-cloud-retail-v2/src/main/proto/google/cloud/retail/v2/product.proto
+++ b/java-retail/proto-google-cloud-retail-v2/src/main/proto/google/cloud/retail/v2/product.proto
@@ -104,7 +104,13 @@ message Product {
 
   oneof expiration {
     // The timestamp when this product becomes unavailable for
-    // [SearchService.Search][google.cloud.retail.v2.SearchService.Search].
+    // [SearchService.Search][google.cloud.retail.v2.SearchService.Search]. Note
+    // that this is only applicable to
+    // [Type.PRIMARY][google.cloud.retail.v2.Product.Type.PRIMARY] and
+    // [Type.COLLECTION][google.cloud.retail.v2.Product.Type.COLLECTION], and
+    // ignored for [Type.VARIANT][google.cloud.retail.v2.Product.Type.VARIANT].
+    // In general, we suggest the users to delete the stale products explicitly,
+    // instead of using this field to determine staleness.
     //
     // If it is set, the [Product][google.cloud.retail.v2.Product] is not
     // available for
@@ -124,7 +130,13 @@ message Product {
     // [expiration_date](https://support.google.com/merchants/answer/6324499).
     google.protobuf.Timestamp expire_time = 16;
 
-    // Input only. The TTL (time to live) of the product.
+    // Input only. The TTL (time to live) of the product. Note that this is only
+    // applicable to [Type.PRIMARY][google.cloud.retail.v2.Product.Type.PRIMARY]
+    // and [Type.COLLECTION][google.cloud.retail.v2.Product.Type.COLLECTION],
+    // and ignored for
+    // [Type.VARIANT][google.cloud.retail.v2.Product.Type.VARIANT]. In general,
+    // we suggest the users to delete the stale products explicitly, instead of
+    // using this field to determine staleness.
     //
     // If it is set, it must be a non-negative value, and
     // [expire_time][google.cloud.retail.v2.Product.expire_time] is set as
@@ -226,7 +238,7 @@ message Product {
   //
   //
   // To represent full path of category, use '>' sign to separate different
-  // hierarchies. If '>' is part of the category name, please replace it with
+  // hierarchies. If '>' is part of the category name, replace it with
   // other character(s).
   //
   // For example, if a shoes product belongs to both
@@ -356,7 +368,11 @@ message Product {
 
   // The timestamp when this [Product][google.cloud.retail.v2.Product] becomes
   // available for
-  // [SearchService.Search][google.cloud.retail.v2.SearchService.Search].
+  // [SearchService.Search][google.cloud.retail.v2.SearchService.Search]. Note
+  // that this is only applicable to
+  // [Type.PRIMARY][google.cloud.retail.v2.Product.Type.PRIMARY] and
+  // [Type.COLLECTION][google.cloud.retail.v2.Product.Type.COLLECTION], and
+  // ignored for [Type.VARIANT][google.cloud.retail.v2.Product.Type.VARIANT].
   google.protobuf.Timestamp available_time = 18;
 
   // The online availability of the [Product][google.cloud.retail.v2.Product].
@@ -542,7 +558,9 @@ message Product {
   // Note: Returning more fields in
   // [SearchResponse][google.cloud.retail.v2.SearchResponse] can increase
   // response payload size and serving latency.
-  google.protobuf.FieldMask retrievable_fields = 30;
+  //
+  // This field is deprecated. Use the retrievable site-wide control instead.
+  google.protobuf.FieldMask retrievable_fields = 30 [deprecated = true];
 
   // Output only. Product variants grouped together on primary product which
   // share similar product attributes. It's automatically grouped by
@@ -559,7 +577,11 @@ message Product {
   // Output only. A list of local inventories specific to different places.
   //
   // This is only available for users who have Retail Search enabled, and it can
-  // be managed by [AddLocalInventories][] and [RemoveLocalInventories][] APIs.
+  // be managed by
+  // [ProductService.AddLocalInventories][google.cloud.retail.v2.ProductService.AddLocalInventories]
+  // and
+  // [ProductService.RemoveLocalInventories][google.cloud.retail.v2.ProductService.RemoveLocalInventories]
+  // APIs.
   repeated LocalInventory local_inventories = 35
       [(google.api.field_behavior) = OUTPUT_ONLY];
 }
diff --git a/java-retail/proto-google-cloud-retail-v2/src/main/proto/google/cloud/retail/v2/product_service.proto b/java-retail/proto-google-cloud-retail-v2/src/main/proto/google/cloud/retail/v2/product_service.proto
index 5ca2cb326962..be83ad9fd2c1 100644
--- a/java-retail/proto-google-cloud-retail-v2/src/main/proto/google/cloud/retail/v2/product_service.proto
+++ b/java-retail/proto-google-cloud-retail-v2/src/main/proto/google/cloud/retail/v2/product_service.proto
@@ -111,9 +111,9 @@ service ProductService {
   //
   // This process is asynchronous and does not require the
   // [Product][google.cloud.retail.v2.Product] to exist before updating
-  // fulfillment information. If the request is valid, the update will be
-  // enqueued and processed downstream. As a consequence, when a response is
-  // returned, updates are not immediately manifested in the
+  // fulfillment information. If the request is valid, the update is enqueued
+  // and processed downstream. As a consequence, when a response is returned,
+  // updates are not immediately manifested in the
   // [Product][google.cloud.retail.v2.Product] queried by
   // [ProductService.GetProduct][google.cloud.retail.v2.ProductService.GetProduct]
   // or
@@ -123,10 +123,10 @@ service ProductService {
   // [ProductService.CreateProduct][google.cloud.retail.v2.ProductService.CreateProduct]
   // and
   // [ProductService.UpdateProduct][google.cloud.retail.v2.ProductService.UpdateProduct],
-  // the specified inventory field value(s) will overwrite any existing value(s)
+  // the specified inventory field value(s) overwrite any existing value(s)
   // while ignoring the last update time for this field. Furthermore, the last
-  // update time for the specified inventory fields will be overwritten to the
-  // time of the
+  // update times for the specified inventory fields are overwritten by the
+  // times of the
   // [ProductService.CreateProduct][google.cloud.retail.v2.ProductService.CreateProduct]
   // or
   // [ProductService.UpdateProduct][google.cloud.retail.v2.ProductService.UpdateProduct]
@@ -134,11 +134,11 @@ service ProductService {
   //
   // If no inventory fields are set in
   // [CreateProductRequest.product][google.cloud.retail.v2.CreateProductRequest.product],
-  // then any pre-existing inventory information for this product will be used.
+  // then any pre-existing inventory information for this product is used.
   //
   // If no inventory fields are set in
   // [SetInventoryRequest.set_mask][google.cloud.retail.v2.SetInventoryRequest.set_mask],
-  // then any existing inventory information will be preserved.
+  // then any existing inventory information is preserved.
   //
   // Pre-existing inventory information can only be updated with
   // [ProductService.SetInventory][google.cloud.retail.v2.ProductService.SetInventory],
@@ -146,15 +146,17 @@ service ProductService {
   // and
   // [ProductService.RemoveFulfillmentPlaces][google.cloud.retail.v2.ProductService.RemoveFulfillmentPlaces].
   //
-  // The returned [Operation][]s will be obsolete after 1 day, and
-  // [GetOperation][] API will return NOT_FOUND afterwards.
+  // The returned [Operation][google.longrunning.Operation]s is obsolete after
+  // one day, and the [GetOperation][google.longrunning.Operations.GetOperation]
+  // API returns `NOT_FOUND` afterwards.
   //
-  // If conflicting updates are issued, the [Operation][]s associated with the
-  // stale updates will not be marked as [done][Operation.done] until being
-  // obsolete.
+  // If conflicting updates are issued, the
+  // [Operation][google.longrunning.Operation]s associated with the stale
+  // updates are not marked as [done][google.longrunning.Operation.done] until
+  // they are obsolete.
   //
   // This feature is only available for users who have Retail Search enabled.
-  // Please enable Retail Search on Cloud Console before using this feature.
+  // Enable Retail Search on Cloud Console before using this feature.
   rpc SetInventory(SetInventoryRequest) returns (google.longrunning.Operation) {
     option (google.api.http) = {
       post: "/v2/{inventory.name=projects/*/locations/*/catalogs/*/branches/*/products/**}:setInventory"
@@ -180,15 +182,17 @@ service ProductService {
   // or
   // [ProductService.ListProducts][google.cloud.retail.v2.ProductService.ListProducts].
   //
-  // The returned [Operation][]s will be obsolete after 1 day, and
-  // [GetOperation][] API will return NOT_FOUND afterwards.
+  // The returned [Operation][google.longrunning.Operation]s will be obsolete
+  // after 1 day, and [GetOperation][google.longrunning.Operations.GetOperation]
+  // API will return NOT_FOUND afterwards.
   //
-  // If conflicting updates are issued, the [Operation][]s associated with the
-  // stale updates will not be marked as [done][Operation.done] until being
-  // obsolete.
+  // If conflicting updates are issued, the
+  // [Operation][google.longrunning.Operation]s associated with the stale
+  // updates will not be marked as [done][google.longrunning.Operation.done]
+  // until being obsolete.
   //
   // This feature is only available for users who have Retail Search enabled.
-  // Please enable Retail Search on Cloud Console before using this feature.
+  // Enable Retail Search on Cloud Console before using this feature.
   rpc AddFulfillmentPlaces(AddFulfillmentPlacesRequest)
       returns (google.longrunning.Operation) {
     option (google.api.http) = {
@@ -215,15 +219,17 @@ service ProductService {
   // or
   // [ProductService.ListProducts][google.cloud.retail.v2.ProductService.ListProducts].
   //
-  // The returned [Operation][]s will be obsolete after 1 day, and
-  // [GetOperation][] API will return NOT_FOUND afterwards.
+  // The returned [Operation][google.longrunning.Operation]s will be obsolete
+  // after 1 day, and [GetOperation][google.longrunning.Operations.GetOperation]
+  // API will return NOT_FOUND afterwards.
   //
-  // If conflicting updates are issued, the [Operation][]s associated with the
-  // stale updates will not be marked as [done][Operation.done] until being
-  // obsolete.
+  // If conflicting updates are issued, the
+  // [Operation][google.longrunning.Operation]s associated with the stale
+  // updates will not be marked as [done][google.longrunning.Operation.done]
+  // until being obsolete.
   //
   // This feature is only available for users who have Retail Search enabled.
-  // Please enable Retail Search on Cloud Console before using this feature.
+  // Enable Retail Search on Cloud Console before using this feature.
   rpc RemoveFulfillmentPlaces(RemoveFulfillmentPlacesRequest)
       returns (google.longrunning.Operation) {
     option (google.api.http) = {
@@ -257,15 +263,17 @@ service ProductService {
   // [ProductService.UpdateProduct][google.cloud.retail.v2.ProductService.UpdateProduct]
   // has no effect on local inventories.
   //
-  // The returned [Operation][]s will be obsolete after 1 day, and
-  // [GetOperation][] API will return NOT_FOUND afterwards.
+  // The returned [Operation][google.longrunning.Operation]s will be obsolete
+  // after 1 day, and [GetOperation][google.longrunning.Operations.GetOperation]
+  // API will return NOT_FOUND afterwards.
   //
-  // If conflicting updates are issued, the [Operation][]s associated with the
-  // stale updates will not be marked as [done][Operation.done] until being
-  // obsolete.
+  // If conflicting updates are issued, the
+  // [Operation][google.longrunning.Operation]s associated with the stale
+  // updates will not be marked as [done][google.longrunning.Operation.done]
+  // until being obsolete.
   //
   // This feature is only available for users who have Retail Search enabled.
-  // Please enable Retail Search on Cloud Console before using this feature.
+  // Enable Retail Search on Cloud Console before using this feature.
   rpc AddLocalInventories(AddLocalInventoriesRequest)
       returns (google.longrunning.Operation) {
     option (google.api.http) = {
@@ -297,15 +305,17 @@ service ProductService {
   // [ProductService.UpdateProduct][google.cloud.retail.v2.ProductService.UpdateProduct]
   // has no effect on local inventories.
   //
-  // The returned [Operation][]s will be obsolete after 1 day, and
-  // [GetOperation][] API will return NOT_FOUND afterwards.
+  // The returned [Operation][google.longrunning.Operation]s will be obsolete
+  // after 1 day, and [GetOperation][google.longrunning.Operations.GetOperation]
+  // API will return NOT_FOUND afterwards.
   //
-  // If conflicting updates are issued, the [Operation][]s associated with the
-  // stale updates will not be marked as [done][Operation.done] until being
-  // obsolete.
+  // If conflicting updates are issued, the
+  // [Operation][google.longrunning.Operation]s associated with the stale
+  // updates will not be marked as [done][google.longrunning.Operation.done]
+  // until being obsolete.
   //
   // This feature is only available for users who have Retail Search enabled.
-  // Please enable Retail Search on Cloud Console before using this feature.
+  // Enable Retail Search on Cloud Console before using this feature.
   rpc RemoveLocalInventories(RemoveLocalInventoriesRequest)
       returns (google.longrunning.Operation) {
     option (google.api.http) = {
diff --git a/java-retail/proto-google-cloud-retail-v2/src/main/proto/google/cloud/retail/v2/search_service.proto b/java-retail/proto-google-cloud-retail-v2/src/main/proto/google/cloud/retail/v2/search_service.proto
index 32de76da6f32..30c3c45a6962 100644
--- a/java-retail/proto-google-cloud-retail-v2/src/main/proto/google/cloud/retail/v2/search_service.proto
+++ b/java-retail/proto-google-cloud-retail-v2/src/main/proto/google/cloud/retail/v2/search_service.proto
@@ -37,7 +37,7 @@ option ruby_package = "Google::Cloud::Retail::V2";
 // Service for search.
 //
 // This feature is only available for users who have Retail Search enabled.
-// Please enable Retail Search on Cloud Console before using this feature.
+// Enable Retail Search on Cloud Console before using this feature.
 service SearchService {
   option (google.api.default_host) = "retail.googleapis.com";
   option (google.api.oauth_scopes) =
@@ -46,7 +46,7 @@ service SearchService {
   // Performs a search.
   //
   // This feature is only available for users who have Retail Search enabled.
-  // Please enable Retail Search on Cloud Console before using this feature.
+  // Enable Retail Search on Cloud Console before using this feature.
   rpc Search(SearchRequest) returns (SearchResponse) {
     option (google.api.http) = {
       post: "/v2/{placement=projects/*/locations/*/catalogs/*/placements/*}:search"
@@ -216,7 +216,7 @@ message SearchRequest {
     FacetKey facet_key = 1 [(google.api.field_behavior) = REQUIRED];
 
     // Maximum of facet values that should be returned for this facet. If
-    // unspecified, defaults to 20. The maximum allowed value is 300. Values
+    // unspecified, defaults to 50. The maximum allowed value is 300. Values
     // above 300 will be coerced to 300.
     //
     // If this field is negative, an INVALID_ARGUMENT is returned.
@@ -436,15 +436,20 @@ message SearchRequest {
   // The search mode of each search request.
   enum SearchMode {
     // Default value. In this case both product search and faceted search will
-    // be performed. Both [SearchResponse.SearchResult] and
-    // [SearchResponse.Facet] will be returned.
+    // be performed. Both
+    // [SearchResponse.SearchResult][google.cloud.retail.v2.SearchResponse.SearchResult]
+    // and [SearchResponse.Facet][google.cloud.retail.v2.SearchResponse.Facet]
+    // will be returned.
     SEARCH_MODE_UNSPECIFIED = 0;
 
     // Only product search will be performed. The faceted search will be
     // disabled.
     //
-    // Only [SearchResponse.SearchResult] will be returned.
-    // [SearchResponse.Facet] will not be returned, even if
+    // Only
+    // [SearchResponse.SearchResult][google.cloud.retail.v2.SearchResponse.SearchResult]
+    // will be returned.
+    // [SearchResponse.Facet][google.cloud.retail.v2.SearchResponse.Facet] will
+    // not be returned, even if
     // [SearchRequest.facet_specs][google.cloud.retail.v2.SearchRequest.facet_specs]
     // or
     // [SearchRequest.dynamic_facet_spec][google.cloud.retail.v2.SearchRequest.dynamic_facet_spec]
@@ -459,7 +464,9 @@ message SearchRequest {
     // and
     // [SearchRequest.dynamic_facet_spec][google.cloud.retail.v2.SearchRequest.dynamic_facet_spec]
     // should be set. Otherwise, an INVALID_ARGUMENT error is returned. Only
-    // [SearchResponse.Facet] will be returned. [SearchResponse.SearchResult]
+    // [SearchResponse.Facet][google.cloud.retail.v2.SearchResponse.Facet] will
+    // be returned.
+    // [SearchResponse.SearchResult][google.cloud.retail.v2.SearchResponse.SearchResult]
     // will not be returned.
     FACETED_SEARCH_ONLY = 2;
   }
@@ -468,7 +475,7 @@ message SearchRequest {
   // `projects/*/locations/global/catalogs/default_catalog/servingConfigs/default_serving_config`
   // or the name of the legacy placement resource, such as
   // `projects/*/locations/global/catalogs/default_catalog/placements/default_search`.
-  // This field is used to identify the serving configuration name and the set
+  // This field is used to identify the serving config name and the set
   // of models that will be used to make the search.
   string placement = 1 [(google.api.field_behavior) = REQUIRED];
 
@@ -671,7 +678,7 @@ message SearchRequest {
   // [UserEvent.page_categories][google.cloud.retail.v2.UserEvent.page_categories];
   //
   // To represent full path of category, use '>' sign to separate different
-  // hierarchies. If '>' is part of the category name, please replace it with
+  // hierarchies. If '>' is part of the category name, replace it with
   // other character(s).
   //
   // Category pages include special pages such as sales or promotions. For
diff --git a/java-retail/proto-google-cloud-retail-v2/src/main/proto/google/cloud/retail/v2/serving_config.proto b/java-retail/proto-google-cloud-retail-v2/src/main/proto/google/cloud/retail/v2/serving_config.proto
index 45f317d63b87..41e73beffc21 100644
--- a/java-retail/proto-google-cloud-retail-v2/src/main/proto/google/cloud/retail/v2/serving_config.proto
+++ b/java-retail/proto-google-cloud-retail-v2/src/main/proto/google/cloud/retail/v2/serving_config.proto
@@ -38,6 +38,18 @@ message ServingConfig {
     pattern: "projects/{project}/locations/{location}/catalogs/{catalog}/servingConfigs/{serving_config}"
   };
 
+  // What type of diversity - data or rule based.
+  enum DiversityType {
+    // Default value.
+    DIVERSITY_TYPE_UNSPECIFIED = 0;
+
+    // Rule based diversity.
+    RULE_BASED_DIVERSITY = 2;
+
+    // Data driven diversity.
+    DATA_DRIVEN_DIVERSITY = 3;
+  }
+
   // Immutable. Fully qualified name
   // `projects/*/locations/global/catalogs/*/servingConfig/*`
   string name = 1 [(google.api.field_behavior) = IMMUTABLE];
@@ -67,13 +79,13 @@ message ServingConfig {
   // click-through and conversion rates.
   //  Allowed values are:
   //
-  // * 'no-price-reranking'
-  // * 'low-price-raranking'
-  // * 'medium-price-reranking'
-  // * 'high-price-reranking'
+  // * `no-price-reranking`
+  // * `low-price-raranking`
+  // * `medium-price-reranking`
+  // * `high-price-reranking`
   //
   // If not specified, we choose default based on model type. Default value:
-  // 'no-price-reranking'.
+  // `no-price-reranking`.
   //
   // Can only be set if
   // [solution_types][google.cloud.retail.v2.ServingConfig.solution_types] is
@@ -191,29 +203,34 @@ message ServingConfig {
   repeated string ignore_control_ids = 15;
 
   // How much diversity to use in recommendation model results e.g.
-  // 'medium-diversity' or 'high-diversity'. Currently supported values:
+  // `medium-diversity` or `high-diversity`. Currently supported values:
   //
-  // * 'no-diversity'
-  // * 'low-diversity'
-  // * 'medium-diversity'
-  // * 'high-diversity'
-  // * 'auto-diversity'
+  // * `no-diversity`
+  // * `low-diversity`
+  // * `medium-diversity`
+  // * `high-diversity`
+  // * `auto-diversity`
   //
   // If not specified, we choose default based on recommendation model
-  // type. Default value: 'no-diversity'.
+  // type. Default value: `no-diversity`.
   //
   // Can only be set if
   // [solution_types][google.cloud.retail.v2.ServingConfig.solution_types] is
   // [SOLUTION_TYPE_RECOMMENDATION][google.cloud.retail.v2main.SolutionType.SOLUTION_TYPE_RECOMMENDATION].
   string diversity_level = 8;
 
-  // Whether to add additional category filters on the 'similar-items' model.
+  // What kind of diversity to use - data driven or rule based. If unset,
+  // the server behavior defaults to
+  // [RULE_BASED_DIVERSITY][google.cloud.retail.v2.ServingConfig.DiversityType.RULE_BASED_DIVERSITY].
+  DiversityType diversity_type = 20;
+
+  // Whether to add additional category filters on the `similar-items` model.
   // If not specified, we enable it by default.
   //  Allowed values are:
   //
-  // * 'no-category-match': No additional filtering of original results from
+  // * `no-category-match`: No additional filtering of original results from
   //   the model and the customer's filters.
-  // * 'relaxed-category-match': Only keep results with categories that match
+  // * `relaxed-category-match`: Only keep results with categories that match
   //   at least one item categories in the PredictRequests's context item.
   //   * If customer also sends filters in the PredictRequest, then the results
   //   will satisfy both conditions (user given and category match).
diff --git a/java-retail/proto-google-cloud-retail-v2/src/main/proto/google/cloud/retail/v2/serving_config_service.proto b/java-retail/proto-google-cloud-retail-v2/src/main/proto/google/cloud/retail/v2/serving_config_service.proto
index a4cabe26ba21..b8dbc621d732 100644
--- a/java-retail/proto-google-cloud-retail-v2/src/main/proto/google/cloud/retail/v2/serving_config_service.proto
+++ b/java-retail/proto-google-cloud-retail-v2/src/main/proto/google/cloud/retail/v2/serving_config_service.proto
@@ -158,7 +158,7 @@ message UpdateServingConfigRequest {
 // Request for DeleteServingConfig method.
 message DeleteServingConfigRequest {
   // Required. The resource name of the ServingConfig to delete. Format:
-  // projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+  // `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
   string name = 1 [
     (google.api.field_behavior) = REQUIRED,
     (google.api.resource_reference) = {
@@ -170,7 +170,7 @@ message DeleteServingConfigRequest {
 // Request for GetServingConfig method.
 message GetServingConfigRequest {
   // Required. The resource name of the ServingConfig to get. Format:
-  // projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+  // `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
   string name = 1 [
     (google.api.field_behavior) = REQUIRED,
     (google.api.resource_reference) = {
@@ -182,7 +182,7 @@ message GetServingConfigRequest {
 // Request for ListServingConfigs method.
 message ListServingConfigsRequest {
   // Required. The catalog resource name. Format:
-  // projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}
+  // `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}`
   string parent = 1 [
     (google.api.field_behavior) = REQUIRED,
     (google.api.resource_reference) = { type: "retail.googleapis.com/Catalog" }
@@ -210,7 +210,7 @@ message ListServingConfigsResponse {
 // Request for AddControl method.
 message AddControlRequest {
   // Required. The source ServingConfig resource name . Format:
-  // projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+  // `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
   string serving_config = 1 [
     (google.api.field_behavior) = REQUIRED,
     (google.api.resource_reference) = {
@@ -226,7 +226,7 @@ message AddControlRequest {
 // Request for RemoveControl method.
 message RemoveControlRequest {
   // Required. The source ServingConfig resource name . Format:
-  // projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+  // `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
   string serving_config = 1 [
     (google.api.field_behavior) = REQUIRED,
     (google.api.resource_reference) = {
diff --git a/java-retail/proto-google-cloud-retail-v2/src/main/proto/google/cloud/retail/v2/user_event.proto b/java-retail/proto-google-cloud-retail-v2/src/main/proto/google/cloud/retail/v2/user_event.proto
index fc315f88f1a9..6093c9a5f31f 100644
--- a/java-retail/proto-google-cloud-retail-v2/src/main/proto/google/cloud/retail/v2/user_event.proto
+++ b/java-retail/proto-google-cloud-retail-v2/src/main/proto/google/cloud/retail/v2/user_event.proto
@@ -226,7 +226,7 @@ message UserEvent {
   // The categories associated with a category page.
   //
   // To represent full path of category, use '>' sign to separate different
-  // hierarchies. If '>' is part of the category name, please replace it with
+  // hierarchies. If '>' is part of the category name, replace it with
   // other character(s).
   //
   // Category pages include special pages such as sales or promotions. For
diff --git a/java-retail/proto-google-cloud-retail-v2/src/main/proto/google/cloud/retail/v2/user_event_service.proto b/java-retail/proto-google-cloud-retail-v2/src/main/proto/google/cloud/retail/v2/user_event_service.proto
index 9a917bc6c6c1..23049dafe278 100644
--- a/java-retail/proto-google-cloud-retail-v2/src/main/proto/google/cloud/retail/v2/user_event_service.proto
+++ b/java-retail/proto-google-cloud-retail-v2/src/main/proto/google/cloud/retail/v2/user_event_service.proto
@@ -20,6 +20,7 @@ import "google/api/annotations.proto";
 import "google/api/client.proto";
 import "google/api/field_behavior.proto";
 import "google/api/httpbody.proto";
+import "google/api/resource.proto";
 import "google/cloud/retail/v2/import_config.proto";
 import "google/cloud/retail/v2/purge_config.proto";
 import "google/cloud/retail/v2/user_event.proto";
@@ -94,14 +95,14 @@ service UserEventService {
     };
   }
 
-  // Starts a user event rejoin operation with latest product catalog. Events
-  // will not be annotated with detailed product information if product is
-  // missing from the catalog at the time the user event is ingested, and these
-  // events are stored as unjoined events with a limited usage on training and
-  // serving. This method can be used to start a join operation on specified
-  // events with latest version of product catalog. It can also be used to
-  // correct events joined with the wrong product catalog. A rejoin operation
-  // can take hours or days to complete.
+  // Starts a user-event rejoin operation with latest product catalog. Events
+  // are not annotated with detailed product information for products that are
+  // missing from the catalog when the user event is ingested. These
+  // events are stored as unjoined events with limited usage on training and
+  // serving. You can use this method to start a join operation on specified
+  // events with the latest version of product catalog. You can also use this
+  // method to correct events joined with the wrong product catalog. A rejoin
+  // operation can take hours or days to complete.
   rpc RejoinUserEvents(RejoinUserEventsRequest)
       returns (google.longrunning.Operation) {
     option (google.api.http) = {
@@ -123,10 +124,24 @@ message WriteUserEventRequest {
 
   // Required. User event to write.
   UserEvent user_event = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // If set to true, the user event will be written asynchronously after
+  // validation, and the API will respond without waiting for the write.
+  // Therefore, silent failures can occur even if the API returns success. In
+  // case of silent failures, error messages can be found in Stackdriver logs.
+  bool write_async = 3;
 }
 
 // Request message for CollectUserEvent method.
 message CollectUserEventRequest {
+  // The rule that can convert the raw_json to a user event. It is needed
+  // only when the raw_json is set.
+  oneof conversion_rule {
+    // The prebuilt rule name that can convert a specific type of raw_json.
+    // For example: "default_schema/v1.0"
+    string prebuilt_rule = 6;
+  }
+
   // Required. The parent catalog name, such as
   // `projects/1234/locations/global/catalogs/default_catalog`.
   string parent = 1 [(google.api.field_behavior) = REQUIRED];
@@ -145,17 +160,23 @@ message CollectUserEventRequest {
   // otherwise identical get requests. The name is abbreviated to reduce the
   // payload bytes.
   int64 ets = 4;
+
+  // An arbitrary serialized JSON string that contains necessary information
+  // that can comprise a user event. When this field is specified, the
+  // user_event field will be ignored. Note: line-delimited JSON is not
+  // supported, a single JSON only.
+  string raw_json = 5;
 }
 
 // Request message for RejoinUserEvents method.
 message RejoinUserEventsRequest {
   // The scope of user events to be rejoined with the latest product catalog.
   // If the rejoining aims at reducing number of unjoined events, set
-  // UserEventRejoinScope to UNJOINED_EVENTS.
+  // `UserEventRejoinScope` to `UNJOINED_EVENTS`.
   // If the rejoining aims at correcting product catalog information in joined
-  // events, set UserEventRejoinScope to JOINED_EVENTS.
-  // If all events needs to be rejoined, set UserEventRejoinScope to
-  // USER_EVENT_REJOIN_SCOPE_UNSPECIFIED.
+  // events, set `UserEventRejoinScope` to `JOINED_EVENTS`.
+  // If all events needs to be rejoined, set `UserEventRejoinScope` to
+  // `USER_EVENT_REJOIN_SCOPE_UNSPECIFIED`.
   enum UserEventRejoinScope {
     // Rejoin all events with the latest product catalog, including both joined
     // events and unjoined events.
@@ -174,16 +195,16 @@ message RejoinUserEventsRequest {
 
   // The type of the user event rejoin to define the scope and range of the user
   // events to be rejoined with the latest product catalog. Defaults to
-  // USER_EVENT_REJOIN_SCOPE_UNSPECIFIED if this field is not set, or set to an
-  // invalid integer value.
+  // `USER_EVENT_REJOIN_SCOPE_UNSPECIFIED` if this field is not set, or set to
+  // an invalid integer value.
   UserEventRejoinScope user_event_rejoin_scope = 2;
 }
 
-// Response message for RejoinUserEvents method.
+// Response message for `RejoinUserEvents` method.
 message RejoinUserEventsResponse {
   // Number of user events that were joined with latest product catalog.
   int64 rejoined_user_events_count = 1;
 }
 
-// Metadata for RejoinUserEvents method.
+// Metadata for `RejoinUserEvents` method.
 message RejoinUserEventsMetadata {}
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/AddControlRequest.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/AddControlRequest.java
index af5fc096c05d..b78ac79fd6f8 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/AddControlRequest.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/AddControlRequest.java
@@ -75,7 +75,7 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    *
    * 
          * Required. The source ServingConfig resource name . Format:
-   * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+   * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
    * 
      
    *
    * 
@@ -101,7 +101,7 @@ public java.lang.String getServingConfig() {
    *
    * 
          * Required. The source ServingConfig resource name . Format:
-   * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+   * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
    * 
      
    *
    * 
@@ -532,7 +532,7 @@ public Builder mergeFrom(
      *
      * 
            * Required. The source ServingConfig resource name . Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
      * 
      
      *
      * 
@@ -557,7 +557,7 @@ public java.lang.String getServingConfig() {
      *
      * 
            * Required. The source ServingConfig resource name . Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
      * 
      
      *
      * 
@@ -582,7 +582,7 @@ public com.google.protobuf.ByteString getServingConfigBytes() {
      *
      * 
            * Required. The source ServingConfig resource name . Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
      * 
      
      *
      * 
@@ -606,7 +606,7 @@ public Builder setServingConfig(java.lang.String value) {
      *
      * 
            * Required. The source ServingConfig resource name . Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
      * 
      
      *
      * 
@@ -626,7 +626,7 @@ public Builder clearServingConfig() {
      *
      * 
            * Required. The source ServingConfig resource name . Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
      * 
      
      *
      * 
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/AddControlRequestOrBuilder.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/AddControlRequestOrBuilder.java
index 4b49436e1e50..c2f91e2db86e 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/AddControlRequestOrBuilder.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/AddControlRequestOrBuilder.java
@@ -28,7 +28,7 @@ public interface AddControlRequestOrBuilder
    *
    * 
          * Required. The source ServingConfig resource name . Format:
-   * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+   * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
    * 
      
    *
    * 
@@ -43,7 +43,7 @@ public interface AddControlRequestOrBuilder
    *
    * 
          * Required. The source ServingConfig resource name . Format:
-   * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+   * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
    * 
      
    *
    * 
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/BatchRemoveCatalogAttributesRequest.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/BatchRemoveCatalogAttributesRequest.java
new file mode 100644
index 000000000000..4b60ca9685cc
--- /dev/null
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/BatchRemoveCatalogAttributesRequest.java
@@ -0,0 +1,959 @@
+/*
+ * Copyright 2020 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+// Generated by the protocol buffer compiler.  DO NOT EDIT!
+// source: google/cloud/retail/v2alpha/catalog_service.proto
+
+package com.google.cloud.retail.v2alpha;
+
+/**
+ *
+ *
+ * 
      + * Request for
+ * [CatalogService.BatchRemoveCatalogAttributes][google.cloud.retail.v2alpha.CatalogService.BatchRemoveCatalogAttributes]
+ * method.
+ * 
      
+ *
+ * Protobuf type {@code google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesRequest}
+ */
+public final class BatchRemoveCatalogAttributesRequest
+    extends com.google.protobuf.GeneratedMessageV3
+    implements
+    // @@protoc_insertion_point(message_implements:google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesRequest)
+    BatchRemoveCatalogAttributesRequestOrBuilder {
+  private static final long serialVersionUID = 0L;
+  // Use BatchRemoveCatalogAttributesRequest.newBuilder() to construct.
+  private BatchRemoveCatalogAttributesRequest(
+      com.google.protobuf.GeneratedMessageV3.Builder builder) {
+    super(builder);
+  }
+
+  private BatchRemoveCatalogAttributesRequest() {
+    attributesConfig_ = "";
+    attributeKeys_ = com.google.protobuf.LazyStringArrayList.EMPTY;
+  }
+
+  @java.lang.Override
+  @SuppressWarnings({"unused"})
+  protected java.lang.Object newInstance(UnusedPrivateParameter unused) {
+    return new BatchRemoveCatalogAttributesRequest();
+  }
+
+  @java.lang.Override
+  public final com.google.protobuf.UnknownFieldSet getUnknownFields() {
+    return this.unknownFields;
+  }
+
+  public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
+    return com.google.cloud.retail.v2alpha.CatalogServiceProto
+        .internal_static_google_cloud_retail_v2alpha_BatchRemoveCatalogAttributesRequest_descriptor;
+  }
+
+  @java.lang.Override
+  protected com.google.protobuf.GeneratedMessageV3.FieldAccessorTable
+      internalGetFieldAccessorTable() {
+    return com.google.cloud.retail.v2alpha.CatalogServiceProto
+        .internal_static_google_cloud_retail_v2alpha_BatchRemoveCatalogAttributesRequest_fieldAccessorTable
+        .ensureFieldAccessorsInitialized(
+            com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesRequest.class,
+            com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesRequest.Builder.class);
+  }
+
+  public static final int ATTRIBUTES_CONFIG_FIELD_NUMBER = 1;
+  private volatile java.lang.Object attributesConfig_;
+  /**
+   *
+   *
+   * 
      +   * Required. The attributes config resource shared by all catalog attributes
+   * being deleted. Format:
+   * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/attributesConfig`
+   * 
      
+   *
+   * 
+   * string attributes_config = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { ... }
+   * 
+   *
+   * @return The attributesConfig.
+   */
+  @java.lang.Override
+  public java.lang.String getAttributesConfig() {
+    java.lang.Object ref = attributesConfig_;
+    if (ref instanceof java.lang.String) {
+      return (java.lang.String) ref;
+    } else {
+      com.google.protobuf.ByteString bs = (com.google.protobuf.ByteString) ref;
+      java.lang.String s = bs.toStringUtf8();
+      attributesConfig_ = s;
+      return s;
+    }
+  }
+  /**
+   *
+   *
+   * 
      +   * Required. The attributes config resource shared by all catalog attributes
+   * being deleted. Format:
+   * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/attributesConfig`
+   * 
      
+   *
+   * 
+   * string attributes_config = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { ... }
+   * 
+   *
+   * @return The bytes for attributesConfig.
+   */
+  @java.lang.Override
+  public com.google.protobuf.ByteString getAttributesConfigBytes() {
+    java.lang.Object ref = attributesConfig_;
+    if (ref instanceof java.lang.String) {
+      com.google.protobuf.ByteString b =
+          com.google.protobuf.ByteString.copyFromUtf8((java.lang.String) ref);
+      attributesConfig_ = b;
+      return b;
+    } else {
+      return (com.google.protobuf.ByteString) ref;
+    }
+  }
+
+  public static final int ATTRIBUTE_KEYS_FIELD_NUMBER = 2;
+  private com.google.protobuf.LazyStringList attributeKeys_;
+  /**
+   *
+   *
+   * 
      +   * Required. The attribute name keys of the
+   * [CatalogAttribute][google.cloud.retail.v2alpha.CatalogAttribute]s to
+   * delete. A maximum of 1000 catalog attributes can be deleted in a batch.
+   * 
      
+   *
+   * repeated string attribute_keys = 2 [(.google.api.field_behavior) = REQUIRED];
+   *
+   * @return A list containing the attributeKeys.
+   */
+  public com.google.protobuf.ProtocolStringList getAttributeKeysList() {
+    return attributeKeys_;
+  }
+  /**
+   *
+   *
+   * 
      +   * Required. The attribute name keys of the
+   * [CatalogAttribute][google.cloud.retail.v2alpha.CatalogAttribute]s to
+   * delete. A maximum of 1000 catalog attributes can be deleted in a batch.
+   * 
      
+   *
+   * repeated string attribute_keys = 2 [(.google.api.field_behavior) = REQUIRED];
+   *
+   * @return The count of attributeKeys.
+   */
+  public int getAttributeKeysCount() {
+    return attributeKeys_.size();
+  }
+  /**
+   *
+   *
+   * 
      +   * Required. The attribute name keys of the
+   * [CatalogAttribute][google.cloud.retail.v2alpha.CatalogAttribute]s to
+   * delete. A maximum of 1000 catalog attributes can be deleted in a batch.
+   * 
      
+   *
+   * repeated string attribute_keys = 2 [(.google.api.field_behavior) = REQUIRED];
+   *
+   * @param index The index of the element to return.
+   * @return The attributeKeys at the given index.
+   */
+  public java.lang.String getAttributeKeys(int index) {
+    return attributeKeys_.get(index);
+  }
+  /**
+   *
+   *
+   * 
      +   * Required. The attribute name keys of the
+   * [CatalogAttribute][google.cloud.retail.v2alpha.CatalogAttribute]s to
+   * delete. A maximum of 1000 catalog attributes can be deleted in a batch.
+   * 
      
+   *
+   * repeated string attribute_keys = 2 [(.google.api.field_behavior) = REQUIRED];
+   *
+   * @param index The index of the value to return.
+   * @return The bytes of the attributeKeys at the given index.
+   */
+  public com.google.protobuf.ByteString getAttributeKeysBytes(int index) {
+    return attributeKeys_.getByteString(index);
+  }
+
+  private byte memoizedIsInitialized = -1;
+
+  @java.lang.Override
+  public final boolean isInitialized() {
+    byte isInitialized = memoizedIsInitialized;
+    if (isInitialized == 1) return true;
+    if (isInitialized == 0) return false;
+
+    memoizedIsInitialized = 1;
+    return true;
+  }
+
+  @java.lang.Override
+  public void writeTo(com.google.protobuf.CodedOutputStream output) throws java.io.IOException {
+    if (!com.google.protobuf.GeneratedMessageV3.isStringEmpty(attributesConfig_)) {
+      com.google.protobuf.GeneratedMessageV3.writeString(output, 1, attributesConfig_);
+    }
+    for (int i = 0; i < attributeKeys_.size(); i++) {
+      com.google.protobuf.GeneratedMessageV3.writeString(output, 2, attributeKeys_.getRaw(i));
+    }
+    getUnknownFields().writeTo(output);
+  }
+
+  @java.lang.Override
+  public int getSerializedSize() {
+    int size = memoizedSize;
+    if (size != -1) return size;
+
+    size = 0;
+    if (!com.google.protobuf.GeneratedMessageV3.isStringEmpty(attributesConfig_)) {
+      size += com.google.protobuf.GeneratedMessageV3.computeStringSize(1, attributesConfig_);
+    }
+    {
+      int dataSize = 0;
+      for (int i = 0; i < attributeKeys_.size(); i++) {
+        dataSize += computeStringSizeNoTag(attributeKeys_.getRaw(i));
+      }
+      size += dataSize;
+      size += 1 * getAttributeKeysList().size();
+    }
+    size += getUnknownFields().getSerializedSize();
+    memoizedSize = size;
+    return size;
+  }
+
+  @java.lang.Override
+  public boolean equals(final java.lang.Object obj) {
+    if (obj == this) {
+      return true;
+    }
+    if (!(obj instanceof com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesRequest)) {
+      return super.equals(obj);
+    }
+    com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesRequest other =
+        (com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesRequest) obj;
+
+    if (!getAttributesConfig().equals(other.getAttributesConfig())) return false;
+    if (!getAttributeKeysList().equals(other.getAttributeKeysList())) return false;
+    if (!getUnknownFields().equals(other.getUnknownFields())) return false;
+    return true;
+  }
+
+  @java.lang.Override
+  public int hashCode() {
+    if (memoizedHashCode != 0) {
+      return memoizedHashCode;
+    }
+    int hash = 41;
+    hash = (19 * hash) + getDescriptor().hashCode();
+    hash = (37 * hash) + ATTRIBUTES_CONFIG_FIELD_NUMBER;
+    hash = (53 * hash) + getAttributesConfig().hashCode();
+    if (getAttributeKeysCount() > 0) {
+      hash = (37 * hash) + ATTRIBUTE_KEYS_FIELD_NUMBER;
+      hash = (53 * hash) + getAttributeKeysList().hashCode();
+    }
+    hash = (29 * hash) + getUnknownFields().hashCode();
+    memoizedHashCode = hash;
+    return hash;
+  }
+
+  public static com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesRequest parseFrom(
+      java.nio.ByteBuffer data) throws com.google.protobuf.InvalidProtocolBufferException {
+    return PARSER.parseFrom(data);
+  }
+
+  public static com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesRequest parseFrom(
+      java.nio.ByteBuffer data, com.google.protobuf.ExtensionRegistryLite extensionRegistry)
+      throws com.google.protobuf.InvalidProtocolBufferException {
+    return PARSER.parseFrom(data, extensionRegistry);
+  }
+
+  public static com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesRequest parseFrom(
+      com.google.protobuf.ByteString data)
+      throws com.google.protobuf.InvalidProtocolBufferException {
+    return PARSER.parseFrom(data);
+  }
+
+  public static com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesRequest parseFrom(
+      com.google.protobuf.ByteString data,
+      com.google.protobuf.ExtensionRegistryLite extensionRegistry)
+      throws com.google.protobuf.InvalidProtocolBufferException {
+    return PARSER.parseFrom(data, extensionRegistry);
+  }
+
+  public static com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesRequest parseFrom(
+      byte[] data) throws com.google.protobuf.InvalidProtocolBufferException {
+    return PARSER.parseFrom(data);
+  }
+
+  public static com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesRequest parseFrom(
+      byte[] data, com.google.protobuf.ExtensionRegistryLite extensionRegistry)
+      throws com.google.protobuf.InvalidProtocolBufferException {
+    return PARSER.parseFrom(data, extensionRegistry);
+  }
+
+  public static com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesRequest parseFrom(
+      java.io.InputStream input) throws java.io.IOException {
+    return com.google.protobuf.GeneratedMessageV3.parseWithIOException(PARSER, input);
+  }
+
+  public static com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesRequest parseFrom(
+      java.io.InputStream input, com.google.protobuf.ExtensionRegistryLite extensionRegistry)
+      throws java.io.IOException {
+    return com.google.protobuf.GeneratedMessageV3.parseWithIOException(
+        PARSER, input, extensionRegistry);
+  }
+
+  public static com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesRequest
+      parseDelimitedFrom(java.io.InputStream input) throws java.io.IOException {
+    return com.google.protobuf.GeneratedMessageV3.parseDelimitedWithIOException(PARSER, input);
+  }
+
+  public static com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesRequest
+      parseDelimitedFrom(
+          java.io.InputStream input, com.google.protobuf.ExtensionRegistryLite extensionRegistry)
+          throws java.io.IOException {
+    return com.google.protobuf.GeneratedMessageV3.parseDelimitedWithIOException(
+        PARSER, input, extensionRegistry);
+  }
+
+  public static com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesRequest parseFrom(
+      com.google.protobuf.CodedInputStream input) throws java.io.IOException {
+    return com.google.protobuf.GeneratedMessageV3.parseWithIOException(PARSER, input);
+  }
+
+  public static com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesRequest parseFrom(
+      com.google.protobuf.CodedInputStream input,
+      com.google.protobuf.ExtensionRegistryLite extensionRegistry)
+      throws java.io.IOException {
+    return com.google.protobuf.GeneratedMessageV3.parseWithIOException(
+        PARSER, input, extensionRegistry);
+  }
+
+  @java.lang.Override
+  public Builder newBuilderForType() {
+    return newBuilder();
+  }
+
+  public static Builder newBuilder() {
+    return DEFAULT_INSTANCE.toBuilder();
+  }
+
+  public static Builder newBuilder(
+      com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesRequest prototype) {
+    return DEFAULT_INSTANCE.toBuilder().mergeFrom(prototype);
+  }
+
+  @java.lang.Override
+  public Builder toBuilder() {
+    return this == DEFAULT_INSTANCE ? new Builder() : new Builder().mergeFrom(this);
+  }
+
+  @java.lang.Override
+  protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.BuilderParent parent) {
+    Builder builder = new Builder(parent);
+    return builder;
+  }
+  /**
+   *
+   *
+   * 
      +   * Request for
+   * [CatalogService.BatchRemoveCatalogAttributes][google.cloud.retail.v2alpha.CatalogService.BatchRemoveCatalogAttributes]
+   * method.
+   * 
      
+   *
+   * Protobuf type {@code google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesRequest}
+   */
+  public static final class Builder extends com.google.protobuf.GeneratedMessageV3.Builder
+      implements
+      // @@protoc_insertion_point(builder_implements:google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesRequest)
+      com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesRequestOrBuilder {
+    public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
+      return com.google.cloud.retail.v2alpha.CatalogServiceProto
+          .internal_static_google_cloud_retail_v2alpha_BatchRemoveCatalogAttributesRequest_descriptor;
+    }
+
+    @java.lang.Override
+    protected com.google.protobuf.GeneratedMessageV3.FieldAccessorTable
+        internalGetFieldAccessorTable() {
+      return com.google.cloud.retail.v2alpha.CatalogServiceProto
+          .internal_static_google_cloud_retail_v2alpha_BatchRemoveCatalogAttributesRequest_fieldAccessorTable
+          .ensureFieldAccessorsInitialized(
+              com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesRequest.class,
+              com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesRequest.Builder.class);
+    }
+
+    // Construct using
+    // com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesRequest.newBuilder()
+    private Builder() {}
+
+    private Builder(com.google.protobuf.GeneratedMessageV3.BuilderParent parent) {
+      super(parent);
+    }
+
+    @java.lang.Override
+    public Builder clear() {
+      super.clear();
+      attributesConfig_ = "";
+
+      attributeKeys_ = com.google.protobuf.LazyStringArrayList.EMPTY;
+      bitField0_ = (bitField0_ & ~0x00000001);
+      return this;
+    }
+
+    @java.lang.Override
+    public com.google.protobuf.Descriptors.Descriptor getDescriptorForType() {
+      return com.google.cloud.retail.v2alpha.CatalogServiceProto
+          .internal_static_google_cloud_retail_v2alpha_BatchRemoveCatalogAttributesRequest_descriptor;
+    }
+
+    @java.lang.Override
+    public com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesRequest
+        getDefaultInstanceForType() {
+      return com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesRequest
+          .getDefaultInstance();
+    }
+
+    @java.lang.Override
+    public com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesRequest build() {
+      com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesRequest result = buildPartial();
+      if (!result.isInitialized()) {
+        throw newUninitializedMessageException(result);
+      }
+      return result;
+    }
+
+    @java.lang.Override
+    public com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesRequest buildPartial() {
+      com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesRequest result =
+          new com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesRequest(this);
+      int from_bitField0_ = bitField0_;
+      result.attributesConfig_ = attributesConfig_;
+      if (((bitField0_ & 0x00000001) != 0)) {
+        attributeKeys_ = attributeKeys_.getUnmodifiableView();
+        bitField0_ = (bitField0_ & ~0x00000001);
+      }
+      result.attributeKeys_ = attributeKeys_;
+      onBuilt();
+      return result;
+    }
+
+    @java.lang.Override
+    public Builder clone() {
+      return super.clone();
+    }
+
+    @java.lang.Override
+    public Builder setField(
+        com.google.protobuf.Descriptors.FieldDescriptor field, java.lang.Object value) {
+      return super.setField(field, value);
+    }
+
+    @java.lang.Override
+    public Builder clearField(com.google.protobuf.Descriptors.FieldDescriptor field) {
+      return super.clearField(field);
+    }
+
+    @java.lang.Override
+    public Builder clearOneof(com.google.protobuf.Descriptors.OneofDescriptor oneof) {
+      return super.clearOneof(oneof);
+    }
+
+    @java.lang.Override
+    public Builder setRepeatedField(
+        com.google.protobuf.Descriptors.FieldDescriptor field, int index, java.lang.Object value) {
+      return super.setRepeatedField(field, index, value);
+    }
+
+    @java.lang.Override
+    public Builder addRepeatedField(
+        com.google.protobuf.Descriptors.FieldDescriptor field, java.lang.Object value) {
+      return super.addRepeatedField(field, value);
+    }
+
+    @java.lang.Override
+    public Builder mergeFrom(com.google.protobuf.Message other) {
+      if (other instanceof com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesRequest) {
+        return mergeFrom(
+            (com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesRequest) other);
+      } else {
+        super.mergeFrom(other);
+        return this;
+      }
+    }
+
+    public Builder mergeFrom(
+        com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesRequest other) {
+      if (other
+          == com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesRequest
+              .getDefaultInstance()) return this;
+      if (!other.getAttributesConfig().isEmpty()) {
+        attributesConfig_ = other.attributesConfig_;
+        onChanged();
+      }
+      if (!other.attributeKeys_.isEmpty()) {
+        if (attributeKeys_.isEmpty()) {
+          attributeKeys_ = other.attributeKeys_;
+          bitField0_ = (bitField0_ & ~0x00000001);
+        } else {
+          ensureAttributeKeysIsMutable();
+          attributeKeys_.addAll(other.attributeKeys_);
+        }
+        onChanged();
+      }
+      this.mergeUnknownFields(other.getUnknownFields());
+      onChanged();
+      return this;
+    }
+
+    @java.lang.Override
+    public final boolean isInitialized() {
+      return true;
+    }
+
+    @java.lang.Override
+    public Builder mergeFrom(
+        com.google.protobuf.CodedInputStream input,
+        com.google.protobuf.ExtensionRegistryLite extensionRegistry)
+        throws java.io.IOException {
+      if (extensionRegistry == null) {
+        throw new java.lang.NullPointerException();
+      }
+      try {
+        boolean done = false;
+        while (!done) {
+          int tag = input.readTag();
+          switch (tag) {
+            case 0:
+              done = true;
+              break;
+            case 10:
+              {
+                attributesConfig_ = input.readStringRequireUtf8();
+
+                break;
+              } // case 10
+            case 18:
+              {
+                java.lang.String s = input.readStringRequireUtf8();
+                ensureAttributeKeysIsMutable();
+                attributeKeys_.add(s);
+                break;
+              } // case 18
+            default:
+              {
+                if (!super.parseUnknownField(input, extensionRegistry, tag)) {
+                  done = true; // was an endgroup tag
+                }
+                break;
+              } // default:
+          } // switch (tag)
+        } // while (!done)
+      } catch (com.google.protobuf.InvalidProtocolBufferException e) {
+        throw e.unwrapIOException();
+      } finally {
+        onChanged();
+      } // finally
+      return this;
+    }
+
+    private int bitField0_;
+
+    private java.lang.Object attributesConfig_ = "";
+    /**
+     *
+     *
+     * 
      +     * Required. The attributes config resource shared by all catalog attributes
+     * being deleted. Format:
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/attributesConfig`
+     * 
      
+     *
+     * 
+     * string attributes_config = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { ... }
+     * 
+     *
+     * @return The attributesConfig.
+     */
+    public java.lang.String getAttributesConfig() {
+      java.lang.Object ref = attributesConfig_;
+      if (!(ref instanceof java.lang.String)) {
+        com.google.protobuf.ByteString bs = (com.google.protobuf.ByteString) ref;
+        java.lang.String s = bs.toStringUtf8();
+        attributesConfig_ = s;
+        return s;
+      } else {
+        return (java.lang.String) ref;
+      }
+    }
+    /**
+     *
+     *
+     * 
      +     * Required. The attributes config resource shared by all catalog attributes
+     * being deleted. Format:
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/attributesConfig`
+     * 
      
+     *
+     * 
+     * string attributes_config = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { ... }
+     * 
+     *
+     * @return The bytes for attributesConfig.
+     */
+    public com.google.protobuf.ByteString getAttributesConfigBytes() {
+      java.lang.Object ref = attributesConfig_;
+      if (ref instanceof String) {
+        com.google.protobuf.ByteString b =
+            com.google.protobuf.ByteString.copyFromUtf8((java.lang.String) ref);
+        attributesConfig_ = b;
+        return b;
+      } else {
+        return (com.google.protobuf.ByteString) ref;
+      }
+    }
+    /**
+     *
+     *
+     * 
      +     * Required. The attributes config resource shared by all catalog attributes
+     * being deleted. Format:
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/attributesConfig`
+     * 
      
+     *
+     * 
+     * string attributes_config = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { ... }
+     * 
+     *
+     * @param value The attributesConfig to set.
+     * @return This builder for chaining.
+     */
+    public Builder setAttributesConfig(java.lang.String value) {
+      if (value == null) {
+        throw new NullPointerException();
+      }
+
+      attributesConfig_ = value;
+      onChanged();
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * Required. The attributes config resource shared by all catalog attributes
+     * being deleted. Format:
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/attributesConfig`
+     * 
      
+     *
+     * 
+     * string attributes_config = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { ... }
+     * 
+     *
+     * @return This builder for chaining.
+     */
+    public Builder clearAttributesConfig() {
+
+      attributesConfig_ = getDefaultInstance().getAttributesConfig();
+      onChanged();
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * Required. The attributes config resource shared by all catalog attributes
+     * being deleted. Format:
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/attributesConfig`
+     * 
      
+     *
+     * 
+     * string attributes_config = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { ... }
+     * 
+     *
+     * @param value The bytes for attributesConfig to set.
+     * @return This builder for chaining.
+     */
+    public Builder setAttributesConfigBytes(com.google.protobuf.ByteString value) {
+      if (value == null) {
+        throw new NullPointerException();
+      }
+      checkByteStringIsUtf8(value);
+
+      attributesConfig_ = value;
+      onChanged();
+      return this;
+    }
+
+    private com.google.protobuf.LazyStringList attributeKeys_ =
+        com.google.protobuf.LazyStringArrayList.EMPTY;
+
+    private void ensureAttributeKeysIsMutable() {
+      if (!((bitField0_ & 0x00000001) != 0)) {
+        attributeKeys_ = new com.google.protobuf.LazyStringArrayList(attributeKeys_);
+        bitField0_ |= 0x00000001;
+      }
+    }
+    /**
+     *
+     *
+     * 
      +     * Required. The attribute name keys of the
+     * [CatalogAttribute][google.cloud.retail.v2alpha.CatalogAttribute]s to
+     * delete. A maximum of 1000 catalog attributes can be deleted in a batch.
+     * 
      
+     *
+     * repeated string attribute_keys = 2 [(.google.api.field_behavior) = REQUIRED];
+     *
+     * @return A list containing the attributeKeys.
+     */
+    public com.google.protobuf.ProtocolStringList getAttributeKeysList() {
+      return attributeKeys_.getUnmodifiableView();
+    }
+    /**
+     *
+     *
+     * 
      +     * Required. The attribute name keys of the
+     * [CatalogAttribute][google.cloud.retail.v2alpha.CatalogAttribute]s to
+     * delete. A maximum of 1000 catalog attributes can be deleted in a batch.
+     * 
      
+     *
+     * repeated string attribute_keys = 2 [(.google.api.field_behavior) = REQUIRED];
+     *
+     * @return The count of attributeKeys.
+     */
+    public int getAttributeKeysCount() {
+      return attributeKeys_.size();
+    }
+    /**
+     *
+     *
+     * 
      +     * Required. The attribute name keys of the
+     * [CatalogAttribute][google.cloud.retail.v2alpha.CatalogAttribute]s to
+     * delete. A maximum of 1000 catalog attributes can be deleted in a batch.
+     * 
      
+     *
+     * repeated string attribute_keys = 2 [(.google.api.field_behavior) = REQUIRED];
+     *
+     * @param index The index of the element to return.
+     * @return The attributeKeys at the given index.
+     */
+    public java.lang.String getAttributeKeys(int index) {
+      return attributeKeys_.get(index);
+    }
+    /**
+     *
+     *
+     * 
      +     * Required. The attribute name keys of the
+     * [CatalogAttribute][google.cloud.retail.v2alpha.CatalogAttribute]s to
+     * delete. A maximum of 1000 catalog attributes can be deleted in a batch.
+     * 
      
+     *
+     * repeated string attribute_keys = 2 [(.google.api.field_behavior) = REQUIRED];
+     *
+     * @param index The index of the value to return.
+     * @return The bytes of the attributeKeys at the given index.
+     */
+    public com.google.protobuf.ByteString getAttributeKeysBytes(int index) {
+      return attributeKeys_.getByteString(index);
+    }
+    /**
+     *
+     *
+     * 
      +     * Required. The attribute name keys of the
+     * [CatalogAttribute][google.cloud.retail.v2alpha.CatalogAttribute]s to
+     * delete. A maximum of 1000 catalog attributes can be deleted in a batch.
+     * 
      
+     *
+     * repeated string attribute_keys = 2 [(.google.api.field_behavior) = REQUIRED];
+     *
+     * @param index The index to set the value at.
+     * @param value The attributeKeys to set.
+     * @return This builder for chaining.
+     */
+    public Builder setAttributeKeys(int index, java.lang.String value) {
+      if (value == null) {
+        throw new NullPointerException();
+      }
+      ensureAttributeKeysIsMutable();
+      attributeKeys_.set(index, value);
+      onChanged();
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * Required. The attribute name keys of the
+     * [CatalogAttribute][google.cloud.retail.v2alpha.CatalogAttribute]s to
+     * delete. A maximum of 1000 catalog attributes can be deleted in a batch.
+     * 
      
+     *
+     * repeated string attribute_keys = 2 [(.google.api.field_behavior) = REQUIRED];
+     *
+     * @param value The attributeKeys to add.
+     * @return This builder for chaining.
+     */
+    public Builder addAttributeKeys(java.lang.String value) {
+      if (value == null) {
+        throw new NullPointerException();
+      }
+      ensureAttributeKeysIsMutable();
+      attributeKeys_.add(value);
+      onChanged();
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * Required. The attribute name keys of the
+     * [CatalogAttribute][google.cloud.retail.v2alpha.CatalogAttribute]s to
+     * delete. A maximum of 1000 catalog attributes can be deleted in a batch.
+     * 
      
+     *
+     * repeated string attribute_keys = 2 [(.google.api.field_behavior) = REQUIRED];
+     *
+     * @param values The attributeKeys to add.
+     * @return This builder for chaining.
+     */
+    public Builder addAllAttributeKeys(java.lang.Iterable values) {
+      ensureAttributeKeysIsMutable();
+      com.google.protobuf.AbstractMessageLite.Builder.addAll(values, attributeKeys_);
+      onChanged();
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * Required. The attribute name keys of the
+     * [CatalogAttribute][google.cloud.retail.v2alpha.CatalogAttribute]s to
+     * delete. A maximum of 1000 catalog attributes can be deleted in a batch.
+     * 
      
+     *
+     * repeated string attribute_keys = 2 [(.google.api.field_behavior) = REQUIRED];
+     *
+     * @return This builder for chaining.
+     */
+    public Builder clearAttributeKeys() {
+      attributeKeys_ = com.google.protobuf.LazyStringArrayList.EMPTY;
+      bitField0_ = (bitField0_ & ~0x00000001);
+      onChanged();
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * Required. The attribute name keys of the
+     * [CatalogAttribute][google.cloud.retail.v2alpha.CatalogAttribute]s to
+     * delete. A maximum of 1000 catalog attributes can be deleted in a batch.
+     * 
      
+     *
+     * repeated string attribute_keys = 2 [(.google.api.field_behavior) = REQUIRED];
+     *
+     * @param value The bytes of the attributeKeys to add.
+     * @return This builder for chaining.
+     */
+    public Builder addAttributeKeysBytes(com.google.protobuf.ByteString value) {
+      if (value == null) {
+        throw new NullPointerException();
+      }
+      checkByteStringIsUtf8(value);
+      ensureAttributeKeysIsMutable();
+      attributeKeys_.add(value);
+      onChanged();
+      return this;
+    }
+
+    @java.lang.Override
+    public final Builder setUnknownFields(final com.google.protobuf.UnknownFieldSet unknownFields) {
+      return super.setUnknownFields(unknownFields);
+    }
+
+    @java.lang.Override
+    public final Builder mergeUnknownFields(
+        final com.google.protobuf.UnknownFieldSet unknownFields) {
+      return super.mergeUnknownFields(unknownFields);
+    }
+
+    // @@protoc_insertion_point(builder_scope:google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesRequest)
+  }
+
+  // @@protoc_insertion_point(class_scope:google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesRequest)
+  private static final com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesRequest
+      DEFAULT_INSTANCE;
+
+  static {
+    DEFAULT_INSTANCE = new com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesRequest();
+  }
+
+  public static com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesRequest
+      getDefaultInstance() {
+    return DEFAULT_INSTANCE;
+  }
+
+  private static final com.google.protobuf.Parser PARSER =
+      new com.google.protobuf.AbstractParser() {
+        @java.lang.Override
+        public BatchRemoveCatalogAttributesRequest parsePartialFrom(
+            com.google.protobuf.CodedInputStream input,
+            com.google.protobuf.ExtensionRegistryLite extensionRegistry)
+            throws com.google.protobuf.InvalidProtocolBufferException {
+          Builder builder = newBuilder();
+          try {
+            builder.mergeFrom(input, extensionRegistry);
+          } catch (com.google.protobuf.InvalidProtocolBufferException e) {
+            throw e.setUnfinishedMessage(builder.buildPartial());
+          } catch (com.google.protobuf.UninitializedMessageException e) {
+            throw e.asInvalidProtocolBufferException().setUnfinishedMessage(builder.buildPartial());
+          } catch (java.io.IOException e) {
+            throw new com.google.protobuf.InvalidProtocolBufferException(e)
+                .setUnfinishedMessage(builder.buildPartial());
+          }
+          return builder.buildPartial();
+        }
+      };
+
+  public static com.google.protobuf.Parser parser() {
+    return PARSER;
+  }
+
+  @java.lang.Override
+  public com.google.protobuf.Parser getParserForType() {
+    return PARSER;
+  }
+
+  @java.lang.Override
+  public com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesRequest
+      getDefaultInstanceForType() {
+    return DEFAULT_INSTANCE;
+  }
+}
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/BatchRemoveCatalogAttributesRequestOrBuilder.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/BatchRemoveCatalogAttributesRequestOrBuilder.java
new file mode 100644
index 000000000000..0b957b561249
--- /dev/null
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/BatchRemoveCatalogAttributesRequestOrBuilder.java
@@ -0,0 +1,117 @@
+/*
+ * Copyright 2020 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+// Generated by the protocol buffer compiler.  DO NOT EDIT!
+// source: google/cloud/retail/v2alpha/catalog_service.proto
+
+package com.google.cloud.retail.v2alpha;
+
+public interface BatchRemoveCatalogAttributesRequestOrBuilder
+    extends
+    // @@protoc_insertion_point(interface_extends:google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesRequest)
+    com.google.protobuf.MessageOrBuilder {
+
+  /**
+   *
+   *
+   * 
      +   * Required. The attributes config resource shared by all catalog attributes
+   * being deleted. Format:
+   * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/attributesConfig`
+   * 
      
+   *
+   * 
+   * string attributes_config = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { ... }
+   * 
+   *
+   * @return The attributesConfig.
+   */
+  java.lang.String getAttributesConfig();
+  /**
+   *
+   *
+   * 
      +   * Required. The attributes config resource shared by all catalog attributes
+   * being deleted. Format:
+   * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/attributesConfig`
+   * 
      
+   *
+   * 
+   * string attributes_config = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { ... }
+   * 
+   *
+   * @return The bytes for attributesConfig.
+   */
+  com.google.protobuf.ByteString getAttributesConfigBytes();
+
+  /**
+   *
+   *
+   * 
      +   * Required. The attribute name keys of the
+   * [CatalogAttribute][google.cloud.retail.v2alpha.CatalogAttribute]s to
+   * delete. A maximum of 1000 catalog attributes can be deleted in a batch.
+   * 
      
+   *
+   * repeated string attribute_keys = 2 [(.google.api.field_behavior) = REQUIRED];
+   *
+   * @return A list containing the attributeKeys.
+   */
+  java.util.List getAttributeKeysList();
+  /**
+   *
+   *
+   * 
      +   * Required. The attribute name keys of the
+   * [CatalogAttribute][google.cloud.retail.v2alpha.CatalogAttribute]s to
+   * delete. A maximum of 1000 catalog attributes can be deleted in a batch.
+   * 
      
+   *
+   * repeated string attribute_keys = 2 [(.google.api.field_behavior) = REQUIRED];
+   *
+   * @return The count of attributeKeys.
+   */
+  int getAttributeKeysCount();
+  /**
+   *
+   *
+   * 
      +   * Required. The attribute name keys of the
+   * [CatalogAttribute][google.cloud.retail.v2alpha.CatalogAttribute]s to
+   * delete. A maximum of 1000 catalog attributes can be deleted in a batch.
+   * 
      
+   *
+   * repeated string attribute_keys = 2 [(.google.api.field_behavior) = REQUIRED];
+   *
+   * @param index The index of the element to return.
+   * @return The attributeKeys at the given index.
+   */
+  java.lang.String getAttributeKeys(int index);
+  /**
+   *
+   *
+   * 
      +   * Required. The attribute name keys of the
+   * [CatalogAttribute][google.cloud.retail.v2alpha.CatalogAttribute]s to
+   * delete. A maximum of 1000 catalog attributes can be deleted in a batch.
+   * 
      
+   *
+   * repeated string attribute_keys = 2 [(.google.api.field_behavior) = REQUIRED];
+   *
+   * @param index The index of the value to return.
+   * @return The bytes of the attributeKeys at the given index.
+   */
+  com.google.protobuf.ByteString getAttributeKeysBytes(int index);
+}
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/BatchRemoveCatalogAttributesResponse.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/BatchRemoveCatalogAttributesResponse.java
new file mode 100644
index 000000000000..f477975678eb
--- /dev/null
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/BatchRemoveCatalogAttributesResponse.java
@@ -0,0 +1,1105 @@
+/*
+ * Copyright 2020 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+// Generated by the protocol buffer compiler.  DO NOT EDIT!
+// source: google/cloud/retail/v2alpha/catalog_service.proto
+
+package com.google.cloud.retail.v2alpha;
+
+/**
+ *
+ *
+ * 
      + * Response of the
+ * [CatalogService.BatchRemoveCatalogAttributes][google.cloud.retail.v2alpha.CatalogService.BatchRemoveCatalogAttributes].
+ * 
      
+ *
+ * Protobuf type {@code google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesResponse}
+ */
+public final class BatchRemoveCatalogAttributesResponse
+    extends com.google.protobuf.GeneratedMessageV3
+    implements
+    // @@protoc_insertion_point(message_implements:google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesResponse)
+    BatchRemoveCatalogAttributesResponseOrBuilder {
+  private static final long serialVersionUID = 0L;
+  // Use BatchRemoveCatalogAttributesResponse.newBuilder() to construct.
+  private BatchRemoveCatalogAttributesResponse(
+      com.google.protobuf.GeneratedMessageV3.Builder builder) {
+    super(builder);
+  }
+
+  private BatchRemoveCatalogAttributesResponse() {
+    deletedCatalogAttributes_ = com.google.protobuf.LazyStringArrayList.EMPTY;
+    resetCatalogAttributes_ = com.google.protobuf.LazyStringArrayList.EMPTY;
+  }
+
+  @java.lang.Override
+  @SuppressWarnings({"unused"})
+  protected java.lang.Object newInstance(UnusedPrivateParameter unused) {
+    return new BatchRemoveCatalogAttributesResponse();
+  }
+
+  @java.lang.Override
+  public final com.google.protobuf.UnknownFieldSet getUnknownFields() {
+    return this.unknownFields;
+  }
+
+  public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
+    return com.google.cloud.retail.v2alpha.CatalogServiceProto
+        .internal_static_google_cloud_retail_v2alpha_BatchRemoveCatalogAttributesResponse_descriptor;
+  }
+
+  @java.lang.Override
+  protected com.google.protobuf.GeneratedMessageV3.FieldAccessorTable
+      internalGetFieldAccessorTable() {
+    return com.google.cloud.retail.v2alpha.CatalogServiceProto
+        .internal_static_google_cloud_retail_v2alpha_BatchRemoveCatalogAttributesResponse_fieldAccessorTable
+        .ensureFieldAccessorsInitialized(
+            com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesResponse.class,
+            com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesResponse.Builder.class);
+  }
+
+  public static final int DELETED_CATALOG_ATTRIBUTES_FIELD_NUMBER = 1;
+  private com.google.protobuf.LazyStringList deletedCatalogAttributes_;
+  /**
+   *
+   *
+   * 
      +   * Catalog attributes that were deleted. Only pre-loaded [catalog
+   * attributes][google.cloud.retail.v2alpha.CatalogAttribute] that are
+   * neither [in
+   * use][google.cloud.retail.v2alpha.CatalogAttribute.in_use] by
+   * products nor predefined can be deleted.
+   * 
      
+   *
+   * repeated string deleted_catalog_attributes = 1;
+   *
+   * @return A list containing the deletedCatalogAttributes.
+   */
+  public com.google.protobuf.ProtocolStringList getDeletedCatalogAttributesList() {
+    return deletedCatalogAttributes_;
+  }
+  /**
+   *
+   *
+   * 
      +   * Catalog attributes that were deleted. Only pre-loaded [catalog
+   * attributes][google.cloud.retail.v2alpha.CatalogAttribute] that are
+   * neither [in
+   * use][google.cloud.retail.v2alpha.CatalogAttribute.in_use] by
+   * products nor predefined can be deleted.
+   * 
      
+   *
+   * repeated string deleted_catalog_attributes = 1;
+   *
+   * @return The count of deletedCatalogAttributes.
+   */
+  public int getDeletedCatalogAttributesCount() {
+    return deletedCatalogAttributes_.size();
+  }
+  /**
+   *
+   *
+   * 
      +   * Catalog attributes that were deleted. Only pre-loaded [catalog
+   * attributes][google.cloud.retail.v2alpha.CatalogAttribute] that are
+   * neither [in
+   * use][google.cloud.retail.v2alpha.CatalogAttribute.in_use] by
+   * products nor predefined can be deleted.
+   * 
      
+   *
+   * repeated string deleted_catalog_attributes = 1;
+   *
+   * @param index The index of the element to return.
+   * @return The deletedCatalogAttributes at the given index.
+   */
+  public java.lang.String getDeletedCatalogAttributes(int index) {
+    return deletedCatalogAttributes_.get(index);
+  }
+  /**
+   *
+   *
+   * 
      +   * Catalog attributes that were deleted. Only pre-loaded [catalog
+   * attributes][google.cloud.retail.v2alpha.CatalogAttribute] that are
+   * neither [in
+   * use][google.cloud.retail.v2alpha.CatalogAttribute.in_use] by
+   * products nor predefined can be deleted.
+   * 
      
+   *
+   * repeated string deleted_catalog_attributes = 1;
+   *
+   * @param index The index of the value to return.
+   * @return The bytes of the deletedCatalogAttributes at the given index.
+   */
+  public com.google.protobuf.ByteString getDeletedCatalogAttributesBytes(int index) {
+    return deletedCatalogAttributes_.getByteString(index);
+  }
+
+  public static final int RESET_CATALOG_ATTRIBUTES_FIELD_NUMBER = 2;
+  private com.google.protobuf.LazyStringList resetCatalogAttributes_;
+  /**
+   *
+   *
+   * 
      +   * Catalog attributes that were reset. [Catalog
+   * attributes][google.cloud.retail.v2alpha.CatalogAttribute] that are either
+   * [in use][google.cloud.retail.v2alpha.CatalogAttribute.in_use] by products
+   * or are predefined attributes cannot be deleted; however, their
+   * configuration properties will reset to default values upon removal request.
+   * 
      
+   *
+   * repeated string reset_catalog_attributes = 2;
+   *
+   * @return A list containing the resetCatalogAttributes.
+   */
+  public com.google.protobuf.ProtocolStringList getResetCatalogAttributesList() {
+    return resetCatalogAttributes_;
+  }
+  /**
+   *
+   *
+   * 
      +   * Catalog attributes that were reset. [Catalog
+   * attributes][google.cloud.retail.v2alpha.CatalogAttribute] that are either
+   * [in use][google.cloud.retail.v2alpha.CatalogAttribute.in_use] by products
+   * or are predefined attributes cannot be deleted; however, their
+   * configuration properties will reset to default values upon removal request.
+   * 
      
+   *
+   * repeated string reset_catalog_attributes = 2;
+   *
+   * @return The count of resetCatalogAttributes.
+   */
+  public int getResetCatalogAttributesCount() {
+    return resetCatalogAttributes_.size();
+  }
+  /**
+   *
+   *
+   * 
      +   * Catalog attributes that were reset. [Catalog
+   * attributes][google.cloud.retail.v2alpha.CatalogAttribute] that are either
+   * [in use][google.cloud.retail.v2alpha.CatalogAttribute.in_use] by products
+   * or are predefined attributes cannot be deleted; however, their
+   * configuration properties will reset to default values upon removal request.
+   * 
      
+   *
+   * repeated string reset_catalog_attributes = 2;
+   *
+   * @param index The index of the element to return.
+   * @return The resetCatalogAttributes at the given index.
+   */
+  public java.lang.String getResetCatalogAttributes(int index) {
+    return resetCatalogAttributes_.get(index);
+  }
+  /**
+   *
+   *
+   * 
      +   * Catalog attributes that were reset. [Catalog
+   * attributes][google.cloud.retail.v2alpha.CatalogAttribute] that are either
+   * [in use][google.cloud.retail.v2alpha.CatalogAttribute.in_use] by products
+   * or are predefined attributes cannot be deleted; however, their
+   * configuration properties will reset to default values upon removal request.
+   * 
      
+   *
+   * repeated string reset_catalog_attributes = 2;
+   *
+   * @param index The index of the value to return.
+   * @return The bytes of the resetCatalogAttributes at the given index.
+   */
+  public com.google.protobuf.ByteString getResetCatalogAttributesBytes(int index) {
+    return resetCatalogAttributes_.getByteString(index);
+  }
+
+  private byte memoizedIsInitialized = -1;
+
+  @java.lang.Override
+  public final boolean isInitialized() {
+    byte isInitialized = memoizedIsInitialized;
+    if (isInitialized == 1) return true;
+    if (isInitialized == 0) return false;
+
+    memoizedIsInitialized = 1;
+    return true;
+  }
+
+  @java.lang.Override
+  public void writeTo(com.google.protobuf.CodedOutputStream output) throws java.io.IOException {
+    for (int i = 0; i < deletedCatalogAttributes_.size(); i++) {
+      com.google.protobuf.GeneratedMessageV3.writeString(
+          output, 1, deletedCatalogAttributes_.getRaw(i));
+    }
+    for (int i = 0; i < resetCatalogAttributes_.size(); i++) {
+      com.google.protobuf.GeneratedMessageV3.writeString(
+          output, 2, resetCatalogAttributes_.getRaw(i));
+    }
+    getUnknownFields().writeTo(output);
+  }
+
+  @java.lang.Override
+  public int getSerializedSize() {
+    int size = memoizedSize;
+    if (size != -1) return size;
+
+    size = 0;
+    {
+      int dataSize = 0;
+      for (int i = 0; i < deletedCatalogAttributes_.size(); i++) {
+        dataSize += computeStringSizeNoTag(deletedCatalogAttributes_.getRaw(i));
+      }
+      size += dataSize;
+      size += 1 * getDeletedCatalogAttributesList().size();
+    }
+    {
+      int dataSize = 0;
+      for (int i = 0; i < resetCatalogAttributes_.size(); i++) {
+        dataSize += computeStringSizeNoTag(resetCatalogAttributes_.getRaw(i));
+      }
+      size += dataSize;
+      size += 1 * getResetCatalogAttributesList().size();
+    }
+    size += getUnknownFields().getSerializedSize();
+    memoizedSize = size;
+    return size;
+  }
+
+  @java.lang.Override
+  public boolean equals(final java.lang.Object obj) {
+    if (obj == this) {
+      return true;
+    }
+    if (!(obj instanceof com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesResponse)) {
+      return super.equals(obj);
+    }
+    com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesResponse other =
+        (com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesResponse) obj;
+
+    if (!getDeletedCatalogAttributesList().equals(other.getDeletedCatalogAttributesList()))
+      return false;
+    if (!getResetCatalogAttributesList().equals(other.getResetCatalogAttributesList()))
+      return false;
+    if (!getUnknownFields().equals(other.getUnknownFields())) return false;
+    return true;
+  }
+
+  @java.lang.Override
+  public int hashCode() {
+    if (memoizedHashCode != 0) {
+      return memoizedHashCode;
+    }
+    int hash = 41;
+    hash = (19 * hash) + getDescriptor().hashCode();
+    if (getDeletedCatalogAttributesCount() > 0) {
+      hash = (37 * hash) + DELETED_CATALOG_ATTRIBUTES_FIELD_NUMBER;
+      hash = (53 * hash) + getDeletedCatalogAttributesList().hashCode();
+    }
+    if (getResetCatalogAttributesCount() > 0) {
+      hash = (37 * hash) + RESET_CATALOG_ATTRIBUTES_FIELD_NUMBER;
+      hash = (53 * hash) + getResetCatalogAttributesList().hashCode();
+    }
+    hash = (29 * hash) + getUnknownFields().hashCode();
+    memoizedHashCode = hash;
+    return hash;
+  }
+
+  public static com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesResponse parseFrom(
+      java.nio.ByteBuffer data) throws com.google.protobuf.InvalidProtocolBufferException {
+    return PARSER.parseFrom(data);
+  }
+
+  public static com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesResponse parseFrom(
+      java.nio.ByteBuffer data, com.google.protobuf.ExtensionRegistryLite extensionRegistry)
+      throws com.google.protobuf.InvalidProtocolBufferException {
+    return PARSER.parseFrom(data, extensionRegistry);
+  }
+
+  public static com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesResponse parseFrom(
+      com.google.protobuf.ByteString data)
+      throws com.google.protobuf.InvalidProtocolBufferException {
+    return PARSER.parseFrom(data);
+  }
+
+  public static com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesResponse parseFrom(
+      com.google.protobuf.ByteString data,
+      com.google.protobuf.ExtensionRegistryLite extensionRegistry)
+      throws com.google.protobuf.InvalidProtocolBufferException {
+    return PARSER.parseFrom(data, extensionRegistry);
+  }
+
+  public static com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesResponse parseFrom(
+      byte[] data) throws com.google.protobuf.InvalidProtocolBufferException {
+    return PARSER.parseFrom(data);
+  }
+
+  public static com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesResponse parseFrom(
+      byte[] data, com.google.protobuf.ExtensionRegistryLite extensionRegistry)
+      throws com.google.protobuf.InvalidProtocolBufferException {
+    return PARSER.parseFrom(data, extensionRegistry);
+  }
+
+  public static com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesResponse parseFrom(
+      java.io.InputStream input) throws java.io.IOException {
+    return com.google.protobuf.GeneratedMessageV3.parseWithIOException(PARSER, input);
+  }
+
+  public static com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesResponse parseFrom(
+      java.io.InputStream input, com.google.protobuf.ExtensionRegistryLite extensionRegistry)
+      throws java.io.IOException {
+    return com.google.protobuf.GeneratedMessageV3.parseWithIOException(
+        PARSER, input, extensionRegistry);
+  }
+
+  public static com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesResponse
+      parseDelimitedFrom(java.io.InputStream input) throws java.io.IOException {
+    return com.google.protobuf.GeneratedMessageV3.parseDelimitedWithIOException(PARSER, input);
+  }
+
+  public static com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesResponse
+      parseDelimitedFrom(
+          java.io.InputStream input, com.google.protobuf.ExtensionRegistryLite extensionRegistry)
+          throws java.io.IOException {
+    return com.google.protobuf.GeneratedMessageV3.parseDelimitedWithIOException(
+        PARSER, input, extensionRegistry);
+  }
+
+  public static com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesResponse parseFrom(
+      com.google.protobuf.CodedInputStream input) throws java.io.IOException {
+    return com.google.protobuf.GeneratedMessageV3.parseWithIOException(PARSER, input);
+  }
+
+  public static com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesResponse parseFrom(
+      com.google.protobuf.CodedInputStream input,
+      com.google.protobuf.ExtensionRegistryLite extensionRegistry)
+      throws java.io.IOException {
+    return com.google.protobuf.GeneratedMessageV3.parseWithIOException(
+        PARSER, input, extensionRegistry);
+  }
+
+  @java.lang.Override
+  public Builder newBuilderForType() {
+    return newBuilder();
+  }
+
+  public static Builder newBuilder() {
+    return DEFAULT_INSTANCE.toBuilder();
+  }
+
+  public static Builder newBuilder(
+      com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesResponse prototype) {
+    return DEFAULT_INSTANCE.toBuilder().mergeFrom(prototype);
+  }
+
+  @java.lang.Override
+  public Builder toBuilder() {
+    return this == DEFAULT_INSTANCE ? new Builder() : new Builder().mergeFrom(this);
+  }
+
+  @java.lang.Override
+  protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.BuilderParent parent) {
+    Builder builder = new Builder(parent);
+    return builder;
+  }
+  /**
+   *
+   *
+   * 
      +   * Response of the
+   * [CatalogService.BatchRemoveCatalogAttributes][google.cloud.retail.v2alpha.CatalogService.BatchRemoveCatalogAttributes].
+   * 
      
+   *
+   * Protobuf type {@code google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesResponse}
+   */
+  public static final class Builder extends com.google.protobuf.GeneratedMessageV3.Builder
+      implements
+      // @@protoc_insertion_point(builder_implements:google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesResponse)
+      com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesResponseOrBuilder {
+    public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
+      return com.google.cloud.retail.v2alpha.CatalogServiceProto
+          .internal_static_google_cloud_retail_v2alpha_BatchRemoveCatalogAttributesResponse_descriptor;
+    }
+
+    @java.lang.Override
+    protected com.google.protobuf.GeneratedMessageV3.FieldAccessorTable
+        internalGetFieldAccessorTable() {
+      return com.google.cloud.retail.v2alpha.CatalogServiceProto
+          .internal_static_google_cloud_retail_v2alpha_BatchRemoveCatalogAttributesResponse_fieldAccessorTable
+          .ensureFieldAccessorsInitialized(
+              com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesResponse.class,
+              com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesResponse.Builder.class);
+    }
+
+    // Construct using
+    // com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesResponse.newBuilder()
+    private Builder() {}
+
+    private Builder(com.google.protobuf.GeneratedMessageV3.BuilderParent parent) {
+      super(parent);
+    }
+
+    @java.lang.Override
+    public Builder clear() {
+      super.clear();
+      deletedCatalogAttributes_ = com.google.protobuf.LazyStringArrayList.EMPTY;
+      bitField0_ = (bitField0_ & ~0x00000001);
+      resetCatalogAttributes_ = com.google.protobuf.LazyStringArrayList.EMPTY;
+      bitField0_ = (bitField0_ & ~0x00000002);
+      return this;
+    }
+
+    @java.lang.Override
+    public com.google.protobuf.Descriptors.Descriptor getDescriptorForType() {
+      return com.google.cloud.retail.v2alpha.CatalogServiceProto
+          .internal_static_google_cloud_retail_v2alpha_BatchRemoveCatalogAttributesResponse_descriptor;
+    }
+
+    @java.lang.Override
+    public com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesResponse
+        getDefaultInstanceForType() {
+      return com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesResponse
+          .getDefaultInstance();
+    }
+
+    @java.lang.Override
+    public com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesResponse build() {
+      com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesResponse result = buildPartial();
+      if (!result.isInitialized()) {
+        throw newUninitializedMessageException(result);
+      }
+      return result;
+    }
+
+    @java.lang.Override
+    public com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesResponse buildPartial() {
+      com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesResponse result =
+          new com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesResponse(this);
+      int from_bitField0_ = bitField0_;
+      if (((bitField0_ & 0x00000001) != 0)) {
+        deletedCatalogAttributes_ = deletedCatalogAttributes_.getUnmodifiableView();
+        bitField0_ = (bitField0_ & ~0x00000001);
+      }
+      result.deletedCatalogAttributes_ = deletedCatalogAttributes_;
+      if (((bitField0_ & 0x00000002) != 0)) {
+        resetCatalogAttributes_ = resetCatalogAttributes_.getUnmodifiableView();
+        bitField0_ = (bitField0_ & ~0x00000002);
+      }
+      result.resetCatalogAttributes_ = resetCatalogAttributes_;
+      onBuilt();
+      return result;
+    }
+
+    @java.lang.Override
+    public Builder clone() {
+      return super.clone();
+    }
+
+    @java.lang.Override
+    public Builder setField(
+        com.google.protobuf.Descriptors.FieldDescriptor field, java.lang.Object value) {
+      return super.setField(field, value);
+    }
+
+    @java.lang.Override
+    public Builder clearField(com.google.protobuf.Descriptors.FieldDescriptor field) {
+      return super.clearField(field);
+    }
+
+    @java.lang.Override
+    public Builder clearOneof(com.google.protobuf.Descriptors.OneofDescriptor oneof) {
+      return super.clearOneof(oneof);
+    }
+
+    @java.lang.Override
+    public Builder setRepeatedField(
+        com.google.protobuf.Descriptors.FieldDescriptor field, int index, java.lang.Object value) {
+      return super.setRepeatedField(field, index, value);
+    }
+
+    @java.lang.Override
+    public Builder addRepeatedField(
+        com.google.protobuf.Descriptors.FieldDescriptor field, java.lang.Object value) {
+      return super.addRepeatedField(field, value);
+    }
+
+    @java.lang.Override
+    public Builder mergeFrom(com.google.protobuf.Message other) {
+      if (other instanceof com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesResponse) {
+        return mergeFrom(
+            (com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesResponse) other);
+      } else {
+        super.mergeFrom(other);
+        return this;
+      }
+    }
+
+    public Builder mergeFrom(
+        com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesResponse other) {
+      if (other
+          == com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesResponse
+              .getDefaultInstance()) return this;
+      if (!other.deletedCatalogAttributes_.isEmpty()) {
+        if (deletedCatalogAttributes_.isEmpty()) {
+          deletedCatalogAttributes_ = other.deletedCatalogAttributes_;
+          bitField0_ = (bitField0_ & ~0x00000001);
+        } else {
+          ensureDeletedCatalogAttributesIsMutable();
+          deletedCatalogAttributes_.addAll(other.deletedCatalogAttributes_);
+        }
+        onChanged();
+      }
+      if (!other.resetCatalogAttributes_.isEmpty()) {
+        if (resetCatalogAttributes_.isEmpty()) {
+          resetCatalogAttributes_ = other.resetCatalogAttributes_;
+          bitField0_ = (bitField0_ & ~0x00000002);
+        } else {
+          ensureResetCatalogAttributesIsMutable();
+          resetCatalogAttributes_.addAll(other.resetCatalogAttributes_);
+        }
+        onChanged();
+      }
+      this.mergeUnknownFields(other.getUnknownFields());
+      onChanged();
+      return this;
+    }
+
+    @java.lang.Override
+    public final boolean isInitialized() {
+      return true;
+    }
+
+    @java.lang.Override
+    public Builder mergeFrom(
+        com.google.protobuf.CodedInputStream input,
+        com.google.protobuf.ExtensionRegistryLite extensionRegistry)
+        throws java.io.IOException {
+      if (extensionRegistry == null) {
+        throw new java.lang.NullPointerException();
+      }
+      try {
+        boolean done = false;
+        while (!done) {
+          int tag = input.readTag();
+          switch (tag) {
+            case 0:
+              done = true;
+              break;
+            case 10:
+              {
+                java.lang.String s = input.readStringRequireUtf8();
+                ensureDeletedCatalogAttributesIsMutable();
+                deletedCatalogAttributes_.add(s);
+                break;
+              } // case 10
+            case 18:
+              {
+                java.lang.String s = input.readStringRequireUtf8();
+                ensureResetCatalogAttributesIsMutable();
+                resetCatalogAttributes_.add(s);
+                break;
+              } // case 18
+            default:
+              {
+                if (!super.parseUnknownField(input, extensionRegistry, tag)) {
+                  done = true; // was an endgroup tag
+                }
+                break;
+              } // default:
+          } // switch (tag)
+        } // while (!done)
+      } catch (com.google.protobuf.InvalidProtocolBufferException e) {
+        throw e.unwrapIOException();
+      } finally {
+        onChanged();
+      } // finally
+      return this;
+    }
+
+    private int bitField0_;
+
+    private com.google.protobuf.LazyStringList deletedCatalogAttributes_ =
+        com.google.protobuf.LazyStringArrayList.EMPTY;
+
+    private void ensureDeletedCatalogAttributesIsMutable() {
+      if (!((bitField0_ & 0x00000001) != 0)) {
+        deletedCatalogAttributes_ =
+            new com.google.protobuf.LazyStringArrayList(deletedCatalogAttributes_);
+        bitField0_ |= 0x00000001;
+      }
+    }
+    /**
+     *
+     *
+     * 
      +     * Catalog attributes that were deleted. Only pre-loaded [catalog
+     * attributes][google.cloud.retail.v2alpha.CatalogAttribute] that are
+     * neither [in
+     * use][google.cloud.retail.v2alpha.CatalogAttribute.in_use] by
+     * products nor predefined can be deleted.
+     * 
      
+     *
+     * repeated string deleted_catalog_attributes = 1;
+     *
+     * @return A list containing the deletedCatalogAttributes.
+     */
+    public com.google.protobuf.ProtocolStringList getDeletedCatalogAttributesList() {
+      return deletedCatalogAttributes_.getUnmodifiableView();
+    }
+    /**
+     *
+     *
+     * 
      +     * Catalog attributes that were deleted. Only pre-loaded [catalog
+     * attributes][google.cloud.retail.v2alpha.CatalogAttribute] that are
+     * neither [in
+     * use][google.cloud.retail.v2alpha.CatalogAttribute.in_use] by
+     * products nor predefined can be deleted.
+     * 
      
+     *
+     * repeated string deleted_catalog_attributes = 1;
+     *
+     * @return The count of deletedCatalogAttributes.
+     */
+    public int getDeletedCatalogAttributesCount() {
+      return deletedCatalogAttributes_.size();
+    }
+    /**
+     *
+     *
+     * 
      +     * Catalog attributes that were deleted. Only pre-loaded [catalog
+     * attributes][google.cloud.retail.v2alpha.CatalogAttribute] that are
+     * neither [in
+     * use][google.cloud.retail.v2alpha.CatalogAttribute.in_use] by
+     * products nor predefined can be deleted.
+     * 
      
+     *
+     * repeated string deleted_catalog_attributes = 1;
+     *
+     * @param index The index of the element to return.
+     * @return The deletedCatalogAttributes at the given index.
+     */
+    public java.lang.String getDeletedCatalogAttributes(int index) {
+      return deletedCatalogAttributes_.get(index);
+    }
+    /**
+     *
+     *
+     * 
      +     * Catalog attributes that were deleted. Only pre-loaded [catalog
+     * attributes][google.cloud.retail.v2alpha.CatalogAttribute] that are
+     * neither [in
+     * use][google.cloud.retail.v2alpha.CatalogAttribute.in_use] by
+     * products nor predefined can be deleted.
+     * 
      
+     *
+     * repeated string deleted_catalog_attributes = 1;
+     *
+     * @param index The index of the value to return.
+     * @return The bytes of the deletedCatalogAttributes at the given index.
+     */
+    public com.google.protobuf.ByteString getDeletedCatalogAttributesBytes(int index) {
+      return deletedCatalogAttributes_.getByteString(index);
+    }
+    /**
+     *
+     *
+     * 
      +     * Catalog attributes that were deleted. Only pre-loaded [catalog
+     * attributes][google.cloud.retail.v2alpha.CatalogAttribute] that are
+     * neither [in
+     * use][google.cloud.retail.v2alpha.CatalogAttribute.in_use] by
+     * products nor predefined can be deleted.
+     * 
      
+     *
+     * repeated string deleted_catalog_attributes = 1;
+     *
+     * @param index The index to set the value at.
+     * @param value The deletedCatalogAttributes to set.
+     * @return This builder for chaining.
+     */
+    public Builder setDeletedCatalogAttributes(int index, java.lang.String value) {
+      if (value == null) {
+        throw new NullPointerException();
+      }
+      ensureDeletedCatalogAttributesIsMutable();
+      deletedCatalogAttributes_.set(index, value);
+      onChanged();
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * Catalog attributes that were deleted. Only pre-loaded [catalog
+     * attributes][google.cloud.retail.v2alpha.CatalogAttribute] that are
+     * neither [in
+     * use][google.cloud.retail.v2alpha.CatalogAttribute.in_use] by
+     * products nor predefined can be deleted.
+     * 
      
+     *
+     * repeated string deleted_catalog_attributes = 1;
+     *
+     * @param value The deletedCatalogAttributes to add.
+     * @return This builder for chaining.
+     */
+    public Builder addDeletedCatalogAttributes(java.lang.String value) {
+      if (value == null) {
+        throw new NullPointerException();
+      }
+      ensureDeletedCatalogAttributesIsMutable();
+      deletedCatalogAttributes_.add(value);
+      onChanged();
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * Catalog attributes that were deleted. Only pre-loaded [catalog
+     * attributes][google.cloud.retail.v2alpha.CatalogAttribute] that are
+     * neither [in
+     * use][google.cloud.retail.v2alpha.CatalogAttribute.in_use] by
+     * products nor predefined can be deleted.
+     * 
      
+     *
+     * repeated string deleted_catalog_attributes = 1;
+     *
+     * @param values The deletedCatalogAttributes to add.
+     * @return This builder for chaining.
+     */
+    public Builder addAllDeletedCatalogAttributes(java.lang.Iterable values) {
+      ensureDeletedCatalogAttributesIsMutable();
+      com.google.protobuf.AbstractMessageLite.Builder.addAll(values, deletedCatalogAttributes_);
+      onChanged();
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * Catalog attributes that were deleted. Only pre-loaded [catalog
+     * attributes][google.cloud.retail.v2alpha.CatalogAttribute] that are
+     * neither [in
+     * use][google.cloud.retail.v2alpha.CatalogAttribute.in_use] by
+     * products nor predefined can be deleted.
+     * 
      
+     *
+     * repeated string deleted_catalog_attributes = 1;
+     *
+     * @return This builder for chaining.
+     */
+    public Builder clearDeletedCatalogAttributes() {
+      deletedCatalogAttributes_ = com.google.protobuf.LazyStringArrayList.EMPTY;
+      bitField0_ = (bitField0_ & ~0x00000001);
+      onChanged();
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * Catalog attributes that were deleted. Only pre-loaded [catalog
+     * attributes][google.cloud.retail.v2alpha.CatalogAttribute] that are
+     * neither [in
+     * use][google.cloud.retail.v2alpha.CatalogAttribute.in_use] by
+     * products nor predefined can be deleted.
+     * 
      
+     *
+     * repeated string deleted_catalog_attributes = 1;
+     *
+     * @param value The bytes of the deletedCatalogAttributes to add.
+     * @return This builder for chaining.
+     */
+    public Builder addDeletedCatalogAttributesBytes(com.google.protobuf.ByteString value) {
+      if (value == null) {
+        throw new NullPointerException();
+      }
+      checkByteStringIsUtf8(value);
+      ensureDeletedCatalogAttributesIsMutable();
+      deletedCatalogAttributes_.add(value);
+      onChanged();
+      return this;
+    }
+
+    private com.google.protobuf.LazyStringList resetCatalogAttributes_ =
+        com.google.protobuf.LazyStringArrayList.EMPTY;
+
+    private void ensureResetCatalogAttributesIsMutable() {
+      if (!((bitField0_ & 0x00000002) != 0)) {
+        resetCatalogAttributes_ =
+            new com.google.protobuf.LazyStringArrayList(resetCatalogAttributes_);
+        bitField0_ |= 0x00000002;
+      }
+    }
+    /**
+     *
+     *
+     * 
      +     * Catalog attributes that were reset. [Catalog
+     * attributes][google.cloud.retail.v2alpha.CatalogAttribute] that are either
+     * [in use][google.cloud.retail.v2alpha.CatalogAttribute.in_use] by products
+     * or are predefined attributes cannot be deleted; however, their
+     * configuration properties will reset to default values upon removal request.
+     * 
      
+     *
+     * repeated string reset_catalog_attributes = 2;
+     *
+     * @return A list containing the resetCatalogAttributes.
+     */
+    public com.google.protobuf.ProtocolStringList getResetCatalogAttributesList() {
+      return resetCatalogAttributes_.getUnmodifiableView();
+    }
+    /**
+     *
+     *
+     * 
      +     * Catalog attributes that were reset. [Catalog
+     * attributes][google.cloud.retail.v2alpha.CatalogAttribute] that are either
+     * [in use][google.cloud.retail.v2alpha.CatalogAttribute.in_use] by products
+     * or are predefined attributes cannot be deleted; however, their
+     * configuration properties will reset to default values upon removal request.
+     * 
      
+     *
+     * repeated string reset_catalog_attributes = 2;
+     *
+     * @return The count of resetCatalogAttributes.
+     */
+    public int getResetCatalogAttributesCount() {
+      return resetCatalogAttributes_.size();
+    }
+    /**
+     *
+     *
+     * 
      +     * Catalog attributes that were reset. [Catalog
+     * attributes][google.cloud.retail.v2alpha.CatalogAttribute] that are either
+     * [in use][google.cloud.retail.v2alpha.CatalogAttribute.in_use] by products
+     * or are predefined attributes cannot be deleted; however, their
+     * configuration properties will reset to default values upon removal request.
+     * 
      
+     *
+     * repeated string reset_catalog_attributes = 2;
+     *
+     * @param index The index of the element to return.
+     * @return The resetCatalogAttributes at the given index.
+     */
+    public java.lang.String getResetCatalogAttributes(int index) {
+      return resetCatalogAttributes_.get(index);
+    }
+    /**
+     *
+     *
+     * 
      +     * Catalog attributes that were reset. [Catalog
+     * attributes][google.cloud.retail.v2alpha.CatalogAttribute] that are either
+     * [in use][google.cloud.retail.v2alpha.CatalogAttribute.in_use] by products
+     * or are predefined attributes cannot be deleted; however, their
+     * configuration properties will reset to default values upon removal request.
+     * 
      
+     *
+     * repeated string reset_catalog_attributes = 2;
+     *
+     * @param index The index of the value to return.
+     * @return The bytes of the resetCatalogAttributes at the given index.
+     */
+    public com.google.protobuf.ByteString getResetCatalogAttributesBytes(int index) {
+      return resetCatalogAttributes_.getByteString(index);
+    }
+    /**
+     *
+     *
+     * 
      +     * Catalog attributes that were reset. [Catalog
+     * attributes][google.cloud.retail.v2alpha.CatalogAttribute] that are either
+     * [in use][google.cloud.retail.v2alpha.CatalogAttribute.in_use] by products
+     * or are predefined attributes cannot be deleted; however, their
+     * configuration properties will reset to default values upon removal request.
+     * 
      
+     *
+     * repeated string reset_catalog_attributes = 2;
+     *
+     * @param index The index to set the value at.
+     * @param value The resetCatalogAttributes to set.
+     * @return This builder for chaining.
+     */
+    public Builder setResetCatalogAttributes(int index, java.lang.String value) {
+      if (value == null) {
+        throw new NullPointerException();
+      }
+      ensureResetCatalogAttributesIsMutable();
+      resetCatalogAttributes_.set(index, value);
+      onChanged();
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * Catalog attributes that were reset. [Catalog
+     * attributes][google.cloud.retail.v2alpha.CatalogAttribute] that are either
+     * [in use][google.cloud.retail.v2alpha.CatalogAttribute.in_use] by products
+     * or are predefined attributes cannot be deleted; however, their
+     * configuration properties will reset to default values upon removal request.
+     * 
      
+     *
+     * repeated string reset_catalog_attributes = 2;
+     *
+     * @param value The resetCatalogAttributes to add.
+     * @return This builder for chaining.
+     */
+    public Builder addResetCatalogAttributes(java.lang.String value) {
+      if (value == null) {
+        throw new NullPointerException();
+      }
+      ensureResetCatalogAttributesIsMutable();
+      resetCatalogAttributes_.add(value);
+      onChanged();
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * Catalog attributes that were reset. [Catalog
+     * attributes][google.cloud.retail.v2alpha.CatalogAttribute] that are either
+     * [in use][google.cloud.retail.v2alpha.CatalogAttribute.in_use] by products
+     * or are predefined attributes cannot be deleted; however, their
+     * configuration properties will reset to default values upon removal request.
+     * 
      
+     *
+     * repeated string reset_catalog_attributes = 2;
+     *
+     * @param values The resetCatalogAttributes to add.
+     * @return This builder for chaining.
+     */
+    public Builder addAllResetCatalogAttributes(java.lang.Iterable values) {
+      ensureResetCatalogAttributesIsMutable();
+      com.google.protobuf.AbstractMessageLite.Builder.addAll(values, resetCatalogAttributes_);
+      onChanged();
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * Catalog attributes that were reset. [Catalog
+     * attributes][google.cloud.retail.v2alpha.CatalogAttribute] that are either
+     * [in use][google.cloud.retail.v2alpha.CatalogAttribute.in_use] by products
+     * or are predefined attributes cannot be deleted; however, their
+     * configuration properties will reset to default values upon removal request.
+     * 
      
+     *
+     * repeated string reset_catalog_attributes = 2;
+     *
+     * @return This builder for chaining.
+     */
+    public Builder clearResetCatalogAttributes() {
+      resetCatalogAttributes_ = com.google.protobuf.LazyStringArrayList.EMPTY;
+      bitField0_ = (bitField0_ & ~0x00000002);
+      onChanged();
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * Catalog attributes that were reset. [Catalog
+     * attributes][google.cloud.retail.v2alpha.CatalogAttribute] that are either
+     * [in use][google.cloud.retail.v2alpha.CatalogAttribute.in_use] by products
+     * or are predefined attributes cannot be deleted; however, their
+     * configuration properties will reset to default values upon removal request.
+     * 
      
+     *
+     * repeated string reset_catalog_attributes = 2;
+     *
+     * @param value The bytes of the resetCatalogAttributes to add.
+     * @return This builder for chaining.
+     */
+    public Builder addResetCatalogAttributesBytes(com.google.protobuf.ByteString value) {
+      if (value == null) {
+        throw new NullPointerException();
+      }
+      checkByteStringIsUtf8(value);
+      ensureResetCatalogAttributesIsMutable();
+      resetCatalogAttributes_.add(value);
+      onChanged();
+      return this;
+    }
+
+    @java.lang.Override
+    public final Builder setUnknownFields(final com.google.protobuf.UnknownFieldSet unknownFields) {
+      return super.setUnknownFields(unknownFields);
+    }
+
+    @java.lang.Override
+    public final Builder mergeUnknownFields(
+        final com.google.protobuf.UnknownFieldSet unknownFields) {
+      return super.mergeUnknownFields(unknownFields);
+    }
+
+    // @@protoc_insertion_point(builder_scope:google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesResponse)
+  }
+
+  // @@protoc_insertion_point(class_scope:google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesResponse)
+  private static final com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesResponse
+      DEFAULT_INSTANCE;
+
+  static {
+    DEFAULT_INSTANCE = new com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesResponse();
+  }
+
+  public static com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesResponse
+      getDefaultInstance() {
+    return DEFAULT_INSTANCE;
+  }
+
+  private static final com.google.protobuf.Parser PARSER =
+      new com.google.protobuf.AbstractParser() {
+        @java.lang.Override
+        public BatchRemoveCatalogAttributesResponse parsePartialFrom(
+            com.google.protobuf.CodedInputStream input,
+            com.google.protobuf.ExtensionRegistryLite extensionRegistry)
+            throws com.google.protobuf.InvalidProtocolBufferException {
+          Builder builder = newBuilder();
+          try {
+            builder.mergeFrom(input, extensionRegistry);
+          } catch (com.google.protobuf.InvalidProtocolBufferException e) {
+            throw e.setUnfinishedMessage(builder.buildPartial());
+          } catch (com.google.protobuf.UninitializedMessageException e) {
+            throw e.asInvalidProtocolBufferException().setUnfinishedMessage(builder.buildPartial());
+          } catch (java.io.IOException e) {
+            throw new com.google.protobuf.InvalidProtocolBufferException(e)
+                .setUnfinishedMessage(builder.buildPartial());
+          }
+          return builder.buildPartial();
+        }
+      };
+
+  public static com.google.protobuf.Parser parser() {
+    return PARSER;
+  }
+
+  @java.lang.Override
+  public com.google.protobuf.Parser getParserForType() {
+    return PARSER;
+  }
+
+  @java.lang.Override
+  public com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesResponse
+      getDefaultInstanceForType() {
+    return DEFAULT_INSTANCE;
+  }
+}
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/BatchRemoveCatalogAttributesResponseOrBuilder.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/BatchRemoveCatalogAttributesResponseOrBuilder.java
new file mode 100644
index 000000000000..4ae79d348fe1
--- /dev/null
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/BatchRemoveCatalogAttributesResponseOrBuilder.java
@@ -0,0 +1,159 @@
+/*
+ * Copyright 2020 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+// Generated by the protocol buffer compiler.  DO NOT EDIT!
+// source: google/cloud/retail/v2alpha/catalog_service.proto
+
+package com.google.cloud.retail.v2alpha;
+
+public interface BatchRemoveCatalogAttributesResponseOrBuilder
+    extends
+    // @@protoc_insertion_point(interface_extends:google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesResponse)
+    com.google.protobuf.MessageOrBuilder {
+
+  /**
+   *
+   *
+   * 
      +   * Catalog attributes that were deleted. Only pre-loaded [catalog
+   * attributes][google.cloud.retail.v2alpha.CatalogAttribute] that are
+   * neither [in
+   * use][google.cloud.retail.v2alpha.CatalogAttribute.in_use] by
+   * products nor predefined can be deleted.
+   * 
      
+   *
+   * repeated string deleted_catalog_attributes = 1;
+   *
+   * @return A list containing the deletedCatalogAttributes.
+   */
+  java.util.List getDeletedCatalogAttributesList();
+  /**
+   *
+   *
+   * 
      +   * Catalog attributes that were deleted. Only pre-loaded [catalog
+   * attributes][google.cloud.retail.v2alpha.CatalogAttribute] that are
+   * neither [in
+   * use][google.cloud.retail.v2alpha.CatalogAttribute.in_use] by
+   * products nor predefined can be deleted.
+   * 
      
+   *
+   * repeated string deleted_catalog_attributes = 1;
+   *
+   * @return The count of deletedCatalogAttributes.
+   */
+  int getDeletedCatalogAttributesCount();
+  /**
+   *
+   *
+   * 
      +   * Catalog attributes that were deleted. Only pre-loaded [catalog
+   * attributes][google.cloud.retail.v2alpha.CatalogAttribute] that are
+   * neither [in
+   * use][google.cloud.retail.v2alpha.CatalogAttribute.in_use] by
+   * products nor predefined can be deleted.
+   * 
      
+   *
+   * repeated string deleted_catalog_attributes = 1;
+   *
+   * @param index The index of the element to return.
+   * @return The deletedCatalogAttributes at the given index.
+   */
+  java.lang.String getDeletedCatalogAttributes(int index);
+  /**
+   *
+   *
+   * 
      +   * Catalog attributes that were deleted. Only pre-loaded [catalog
+   * attributes][google.cloud.retail.v2alpha.CatalogAttribute] that are
+   * neither [in
+   * use][google.cloud.retail.v2alpha.CatalogAttribute.in_use] by
+   * products nor predefined can be deleted.
+   * 
      
+   *
+   * repeated string deleted_catalog_attributes = 1;
+   *
+   * @param index The index of the value to return.
+   * @return The bytes of the deletedCatalogAttributes at the given index.
+   */
+  com.google.protobuf.ByteString getDeletedCatalogAttributesBytes(int index);
+
+  /**
+   *
+   *
+   * 
      +   * Catalog attributes that were reset. [Catalog
+   * attributes][google.cloud.retail.v2alpha.CatalogAttribute] that are either
+   * [in use][google.cloud.retail.v2alpha.CatalogAttribute.in_use] by products
+   * or are predefined attributes cannot be deleted; however, their
+   * configuration properties will reset to default values upon removal request.
+   * 
      
+   *
+   * repeated string reset_catalog_attributes = 2;
+   *
+   * @return A list containing the resetCatalogAttributes.
+   */
+  java.util.List getResetCatalogAttributesList();
+  /**
+   *
+   *
+   * 
      +   * Catalog attributes that were reset. [Catalog
+   * attributes][google.cloud.retail.v2alpha.CatalogAttribute] that are either
+   * [in use][google.cloud.retail.v2alpha.CatalogAttribute.in_use] by products
+   * or are predefined attributes cannot be deleted; however, their
+   * configuration properties will reset to default values upon removal request.
+   * 
      
+   *
+   * repeated string reset_catalog_attributes = 2;
+   *
+   * @return The count of resetCatalogAttributes.
+   */
+  int getResetCatalogAttributesCount();
+  /**
+   *
+   *
+   * 
      +   * Catalog attributes that were reset. [Catalog
+   * attributes][google.cloud.retail.v2alpha.CatalogAttribute] that are either
+   * [in use][google.cloud.retail.v2alpha.CatalogAttribute.in_use] by products
+   * or are predefined attributes cannot be deleted; however, their
+   * configuration properties will reset to default values upon removal request.
+   * 
      
+   *
+   * repeated string reset_catalog_attributes = 2;
+   *
+   * @param index The index of the element to return.
+   * @return The resetCatalogAttributes at the given index.
+   */
+  java.lang.String getResetCatalogAttributes(int index);
+  /**
+   *
+   *
+   * 
      +   * Catalog attributes that were reset. [Catalog
+   * attributes][google.cloud.retail.v2alpha.CatalogAttribute] that are either
+   * [in use][google.cloud.retail.v2alpha.CatalogAttribute.in_use] by products
+   * or are predefined attributes cannot be deleted; however, their
+   * configuration properties will reset to default values upon removal request.
+   * 
      
+   *
+   * repeated string reset_catalog_attributes = 2;
+   *
+   * @param index The index of the value to return.
+   * @return The bytes of the resetCatalogAttributes at the given index.
+   */
+  com.google.protobuf.ByteString getResetCatalogAttributesBytes(int index);
+}
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/BigQuerySource.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/BigQuerySource.java
index 6591cdd373c0..f4fb6bea4116 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/BigQuerySource.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/BigQuerySource.java
@@ -121,9 +121,8 @@ public PartitionCase getPartitionCase() {
    *
    * 
          * BigQuery time partitioned table's _PARTITIONDATE in YYYY-MM-DD format.
-   * Only supported when
-   * [ImportProductsRequest.reconciliation_mode][google.cloud.retail.v2alpha.ImportProductsRequest.reconciliation_mode]
-   * is set to `FULL`.
+   * Only supported in
+   * [ImportProductsRequest][google.cloud.retail.v2alpha.ImportProductsRequest].
    * 
      
    *
    * .google.type.Date partition_date = 6;
@@ -139,9 +138,8 @@ public boolean hasPartitionDate() {
    *
    * 
          * BigQuery time partitioned table's _PARTITIONDATE in YYYY-MM-DD format.
-   * Only supported when
-   * [ImportProductsRequest.reconciliation_mode][google.cloud.retail.v2alpha.ImportProductsRequest.reconciliation_mode]
-   * is set to `FULL`.
+   * Only supported in
+   * [ImportProductsRequest][google.cloud.retail.v2alpha.ImportProductsRequest].
    * 
      
    *
    * .google.type.Date partition_date = 6;
@@ -160,9 +158,8 @@ public com.google.type.Date getPartitionDate() {
    *
    * 
          * BigQuery time partitioned table's _PARTITIONDATE in YYYY-MM-DD format.
-   * Only supported when
-   * [ImportProductsRequest.reconciliation_mode][google.cloud.retail.v2alpha.ImportProductsRequest.reconciliation_mode]
-   * is set to `FULL`.
+   * Only supported in
+   * [ImportProductsRequest][google.cloud.retail.v2alpha.ImportProductsRequest].
    * 
      
    *
    * .google.type.Date partition_date = 6;
@@ -402,8 +399,7 @@ public com.google.protobuf.ByteString getGcsStagingDirBytes() {
    * * `user_event_ga360`:
    *   The schema is available here:
    *   https://support.google.com/analytics/answer/3437719.
-   * * `user_event_ga4`: This feature is in private preview. Please contact the
-   *   support team for importing Google Analytics 4 events.
+   * * `user_event_ga4`:
    *   The schema is available here:
    *   https://support.google.com/analytics/answer/7029846.
    * Supported values for auto-completion imports:
@@ -445,8 +441,7 @@ public java.lang.String getDataSchema() {
    * * `user_event_ga360`:
    *   The schema is available here:
    *   https://support.google.com/analytics/answer/3437719.
-   * * `user_event_ga4`: This feature is in private preview. Please contact the
-   *   support team for importing Google Analytics 4 events.
+   * * `user_event_ga4`:
    *   The schema is available here:
    *   https://support.google.com/analytics/answer/7029846.
    * Supported values for auto-completion imports:
@@ -965,9 +960,8 @@ public Builder clearPartition() {
      *
      * 
            * BigQuery time partitioned table's _PARTITIONDATE in YYYY-MM-DD format.
-     * Only supported when
-     * [ImportProductsRequest.reconciliation_mode][google.cloud.retail.v2alpha.ImportProductsRequest.reconciliation_mode]
-     * is set to `FULL`.
+     * Only supported in
+     * [ImportProductsRequest][google.cloud.retail.v2alpha.ImportProductsRequest].
      * 
      
      *
      * .google.type.Date partition_date = 6;
@@ -983,9 +977,8 @@ public boolean hasPartitionDate() {
      *
      * 
            * BigQuery time partitioned table's _PARTITIONDATE in YYYY-MM-DD format.
-     * Only supported when
-     * [ImportProductsRequest.reconciliation_mode][google.cloud.retail.v2alpha.ImportProductsRequest.reconciliation_mode]
-     * is set to `FULL`.
+     * Only supported in
+     * [ImportProductsRequest][google.cloud.retail.v2alpha.ImportProductsRequest].
      * 
      
      *
      * .google.type.Date partition_date = 6;
@@ -1011,9 +1004,8 @@ public com.google.type.Date getPartitionDate() {
      *
      * 
            * BigQuery time partitioned table's _PARTITIONDATE in YYYY-MM-DD format.
-     * Only supported when
-     * [ImportProductsRequest.reconciliation_mode][google.cloud.retail.v2alpha.ImportProductsRequest.reconciliation_mode]
-     * is set to `FULL`.
+     * Only supported in
+     * [ImportProductsRequest][google.cloud.retail.v2alpha.ImportProductsRequest].
      * 
      
      *
      * .google.type.Date partition_date = 6;
@@ -1036,9 +1028,8 @@ public Builder setPartitionDate(com.google.type.Date value) {
      *
      * 
            * BigQuery time partitioned table's _PARTITIONDATE in YYYY-MM-DD format.
-     * Only supported when
-     * [ImportProductsRequest.reconciliation_mode][google.cloud.retail.v2alpha.ImportProductsRequest.reconciliation_mode]
-     * is set to `FULL`.
+     * Only supported in
+     * [ImportProductsRequest][google.cloud.retail.v2alpha.ImportProductsRequest].
      * 
      
      *
      * .google.type.Date partition_date = 6;
@@ -1058,9 +1049,8 @@ public Builder setPartitionDate(com.google.type.Date.Builder builderForValue) {
      *
      * 
            * BigQuery time partitioned table's _PARTITIONDATE in YYYY-MM-DD format.
-     * Only supported when
-     * [ImportProductsRequest.reconciliation_mode][google.cloud.retail.v2alpha.ImportProductsRequest.reconciliation_mode]
-     * is set to `FULL`.
+     * Only supported in
+     * [ImportProductsRequest][google.cloud.retail.v2alpha.ImportProductsRequest].
      * 
      
      *
      * .google.type.Date partition_date = 6;
@@ -1091,9 +1081,8 @@ public Builder mergePartitionDate(com.google.type.Date value) {
      *
      * 
            * BigQuery time partitioned table's _PARTITIONDATE in YYYY-MM-DD format.
-     * Only supported when
-     * [ImportProductsRequest.reconciliation_mode][google.cloud.retail.v2alpha.ImportProductsRequest.reconciliation_mode]
-     * is set to `FULL`.
+     * Only supported in
+     * [ImportProductsRequest][google.cloud.retail.v2alpha.ImportProductsRequest].
      * 
      
      *
      * .google.type.Date partition_date = 6;
@@ -1119,9 +1108,8 @@ public Builder clearPartitionDate() {
      *
      * 
            * BigQuery time partitioned table's _PARTITIONDATE in YYYY-MM-DD format.
-     * Only supported when
-     * [ImportProductsRequest.reconciliation_mode][google.cloud.retail.v2alpha.ImportProductsRequest.reconciliation_mode]
-     * is set to `FULL`.
+     * Only supported in
+     * [ImportProductsRequest][google.cloud.retail.v2alpha.ImportProductsRequest].
      * 
      
      *
      * .google.type.Date partition_date = 6;
@@ -1134,9 +1122,8 @@ public com.google.type.Date.Builder getPartitionDateBuilder() {
      *
      * 
            * BigQuery time partitioned table's _PARTITIONDATE in YYYY-MM-DD format.
-     * Only supported when
-     * [ImportProductsRequest.reconciliation_mode][google.cloud.retail.v2alpha.ImportProductsRequest.reconciliation_mode]
-     * is set to `FULL`.
+     * Only supported in
+     * [ImportProductsRequest][google.cloud.retail.v2alpha.ImportProductsRequest].
      * 
      
      *
      * .google.type.Date partition_date = 6;
@@ -1157,9 +1144,8 @@ public com.google.type.DateOrBuilder getPartitionDateOrBuilder() {
      *
      * 
            * BigQuery time partitioned table's _PARTITIONDATE in YYYY-MM-DD format.
-     * Only supported when
-     * [ImportProductsRequest.reconciliation_mode][google.cloud.retail.v2alpha.ImportProductsRequest.reconciliation_mode]
-     * is set to `FULL`.
+     * Only supported in
+     * [ImportProductsRequest][google.cloud.retail.v2alpha.ImportProductsRequest].
      * 
      
      *
      * .google.type.Date partition_date = 6;
@@ -1655,8 +1641,7 @@ public Builder setGcsStagingDirBytes(com.google.protobuf.ByteString value) {
      * * `user_event_ga360`:
      *   The schema is available here:
      *   https://support.google.com/analytics/answer/3437719.
-     * * `user_event_ga4`: This feature is in private preview. Please contact the
-     *   support team for importing Google Analytics 4 events.
+     * * `user_event_ga4`:
      *   The schema is available here:
      *   https://support.google.com/analytics/answer/7029846.
      * Supported values for auto-completion imports:
@@ -1697,8 +1682,7 @@ public java.lang.String getDataSchema() {
      * * `user_event_ga360`:
      *   The schema is available here:
      *   https://support.google.com/analytics/answer/3437719.
-     * * `user_event_ga4`: This feature is in private preview. Please contact the
-     *   support team for importing Google Analytics 4 events.
+     * * `user_event_ga4`:
      *   The schema is available here:
      *   https://support.google.com/analytics/answer/7029846.
      * Supported values for auto-completion imports:
@@ -1739,8 +1723,7 @@ public com.google.protobuf.ByteString getDataSchemaBytes() {
      * * `user_event_ga360`:
      *   The schema is available here:
      *   https://support.google.com/analytics/answer/3437719.
-     * * `user_event_ga4`: This feature is in private preview. Please contact the
-     *   support team for importing Google Analytics 4 events.
+     * * `user_event_ga4`:
      *   The schema is available here:
      *   https://support.google.com/analytics/answer/7029846.
      * Supported values for auto-completion imports:
@@ -1780,8 +1763,7 @@ public Builder setDataSchema(java.lang.String value) {
      * * `user_event_ga360`:
      *   The schema is available here:
      *   https://support.google.com/analytics/answer/3437719.
-     * * `user_event_ga4`: This feature is in private preview. Please contact the
-     *   support team for importing Google Analytics 4 events.
+     * * `user_event_ga4`:
      *   The schema is available here:
      *   https://support.google.com/analytics/answer/7029846.
      * Supported values for auto-completion imports:
@@ -1817,8 +1799,7 @@ public Builder clearDataSchema() {
      * * `user_event_ga360`:
      *   The schema is available here:
      *   https://support.google.com/analytics/answer/3437719.
-     * * `user_event_ga4`: This feature is in private preview. Please contact the
-     *   support team for importing Google Analytics 4 events.
+     * * `user_event_ga4`:
      *   The schema is available here:
      *   https://support.google.com/analytics/answer/7029846.
      * Supported values for auto-completion imports:
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/BigQuerySourceOrBuilder.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/BigQuerySourceOrBuilder.java
index 42fee087091a..60b23d41b91c 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/BigQuerySourceOrBuilder.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/BigQuerySourceOrBuilder.java
@@ -28,9 +28,8 @@ public interface BigQuerySourceOrBuilder
    *
    * 
          * BigQuery time partitioned table's _PARTITIONDATE in YYYY-MM-DD format.
-   * Only supported when
-   * [ImportProductsRequest.reconciliation_mode][google.cloud.retail.v2alpha.ImportProductsRequest.reconciliation_mode]
-   * is set to `FULL`.
+   * Only supported in
+   * [ImportProductsRequest][google.cloud.retail.v2alpha.ImportProductsRequest].
    * 
      
    *
    * .google.type.Date partition_date = 6;
@@ -43,9 +42,8 @@ public interface BigQuerySourceOrBuilder
    *
    * 
          * BigQuery time partitioned table's _PARTITIONDATE in YYYY-MM-DD format.
-   * Only supported when
-   * [ImportProductsRequest.reconciliation_mode][google.cloud.retail.v2alpha.ImportProductsRequest.reconciliation_mode]
-   * is set to `FULL`.
+   * Only supported in
+   * [ImportProductsRequest][google.cloud.retail.v2alpha.ImportProductsRequest].
    * 
      
    *
    * .google.type.Date partition_date = 6;
@@ -58,9 +56,8 @@ public interface BigQuerySourceOrBuilder
    *
    * 
          * BigQuery time partitioned table's _PARTITIONDATE in YYYY-MM-DD format.
-   * Only supported when
-   * [ImportProductsRequest.reconciliation_mode][google.cloud.retail.v2alpha.ImportProductsRequest.reconciliation_mode]
-   * is set to `FULL`.
+   * Only supported in
+   * [ImportProductsRequest][google.cloud.retail.v2alpha.ImportProductsRequest].
    * 
      
    *
    * .google.type.Date partition_date = 6;
@@ -196,8 +193,7 @@ public interface BigQuerySourceOrBuilder
    * * `user_event_ga360`:
    *   The schema is available here:
    *   https://support.google.com/analytics/answer/3437719.
-   * * `user_event_ga4`: This feature is in private preview. Please contact the
-   *   support team for importing Google Analytics 4 events.
+   * * `user_event_ga4`:
    *   The schema is available here:
    *   https://support.google.com/analytics/answer/7029846.
    * Supported values for auto-completion imports:
@@ -228,8 +224,7 @@ public interface BigQuerySourceOrBuilder
    * * `user_event_ga360`:
    *   The schema is available here:
    *   https://support.google.com/analytics/answer/3437719.
-   * * `user_event_ga4`: This feature is in private preview. Please contact the
-   *   support team for importing Google Analytics 4 events.
+   * * `user_event_ga4`:
    *   The schema is available here:
    *   https://support.google.com/analytics/answer/7029846.
    * Supported values for auto-completion imports:
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/CatalogAttribute.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/CatalogAttribute.java
index 8c69f612a897..05d445808524 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/CatalogAttribute.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/CatalogAttribute.java
@@ -45,6 +45,8 @@ private CatalogAttribute() {
     dynamicFacetableOption_ = 0;
     searchableOption_ = 0;
     recommendationsFilteringOption_ = 0;
+    exactSearchableOption_ = 0;
+    retrievableOption_ = 0;
   }
 
   @java.lang.Override
@@ -248,8 +250,7 @@ public enum IndexableOption implements com.google.protobuf.ProtocolMessageEnum {
      *
      *
      * 
      -     * Value used when unset. Defaults to
-     * [INDEXABLE_ENABLED][google.cloud.retail.v2alpha.CatalogAttribute.IndexableOption.INDEXABLE_ENABLED].
+     * Value used when unset.
      * 
      
      *
      * INDEXABLE_OPTION_UNSPECIFIED = 0;
@@ -282,8 +283,7 @@ public enum IndexableOption implements com.google.protobuf.ProtocolMessageEnum {
      *
      *
      * 
      -     * Value used when unset. Defaults to
-     * [INDEXABLE_ENABLED][google.cloud.retail.v2alpha.CatalogAttribute.IndexableOption.INDEXABLE_ENABLED].
+     * Value used when unset.
      * 
      
      *
      * INDEXABLE_OPTION_UNSPECIFIED = 0;
@@ -409,8 +409,7 @@ public enum DynamicFacetableOption implements com.google.protobuf.ProtocolMessag
      *
      *
      * 
      -     * Value used when unset. Defaults to
-     * [DYNAMIC_FACETABLE_ENABLED][google.cloud.retail.v2alpha.CatalogAttribute.DynamicFacetableOption.DYNAMIC_FACETABLE_ENABLED].
+     * Value used when unset.
      * 
      
      *
      * DYNAMIC_FACETABLE_OPTION_UNSPECIFIED = 0;
@@ -443,8 +442,7 @@ public enum DynamicFacetableOption implements com.google.protobuf.ProtocolMessag
      *
      *
      * 
      -     * Value used when unset. Defaults to
-     * [DYNAMIC_FACETABLE_ENABLED][google.cloud.retail.v2alpha.CatalogAttribute.DynamicFacetableOption.DYNAMIC_FACETABLE_ENABLED].
+     * Value used when unset.
      * 
      
      *
      * DYNAMIC_FACETABLE_OPTION_UNSPECIFIED = 0;
@@ -571,8 +569,7 @@ public enum SearchableOption implements com.google.protobuf.ProtocolMessageEnum
      *
      *
      * 
      -     * Value used when unset. Defaults to
-     * [SEARCHABLE_DISABLED][google.cloud.retail.v2alpha.CatalogAttribute.SearchableOption.SEARCHABLE_DISABLED].
+     * Value used when unset.
      * 
      
      *
      * SEARCHABLE_OPTION_UNSPECIFIED = 0;
@@ -605,8 +602,7 @@ public enum SearchableOption implements com.google.protobuf.ProtocolMessageEnum
      *
      *
      * 
      -     * Value used when unset. Defaults to
-     * [SEARCHABLE_DISABLED][google.cloud.retail.v2alpha.CatalogAttribute.SearchableOption.SEARCHABLE_DISABLED].
+     * Value used when unset.
      * 
      
      *
      * SEARCHABLE_OPTION_UNSPECIFIED = 0;
@@ -718,6 +714,330 @@ private SearchableOption(int value) {
     // @@protoc_insertion_point(enum_scope:google.cloud.retail.v2alpha.CatalogAttribute.SearchableOption)
   }
 
+  /**
+   *
+   *
+   * 
      +   * The status of the exact-searchable option of a catalog attribute.
+   * 
      
+   *
+   * Protobuf enum {@code google.cloud.retail.v2alpha.CatalogAttribute.ExactSearchableOption}
+   */
+  public enum ExactSearchableOption implements com.google.protobuf.ProtocolMessageEnum {
+    /**
+     *
+     *
+     * 
      +     * Value used when unset. Defaults to
+     * [EXACT_SEARCHABLE_DISABLED][google.cloud.retail.v2alpha.CatalogAttribute.ExactSearchableOption.EXACT_SEARCHABLE_DISABLED].
+     * 
      
+     *
+     * EXACT_SEARCHABLE_OPTION_UNSPECIFIED = 0;
+     */
+    EXACT_SEARCHABLE_OPTION_UNSPECIFIED(0),
+    /**
+     *
+     *
+     * 
      +     * Exact searchable option enabled for an attribute.
+     * 
      
+     *
+     * EXACT_SEARCHABLE_ENABLED = 1;
+     */
+    EXACT_SEARCHABLE_ENABLED(1),
+    /**
+     *
+     *
+     * 
      +     * Exact searchable option disabled for an attribute.
+     * 
      
+     *
+     * EXACT_SEARCHABLE_DISABLED = 2;
+     */
+    EXACT_SEARCHABLE_DISABLED(2),
+    UNRECOGNIZED(-1),
+    ;
+
+    /**
+     *
+     *
+     * 
      +     * Value used when unset. Defaults to
+     * [EXACT_SEARCHABLE_DISABLED][google.cloud.retail.v2alpha.CatalogAttribute.ExactSearchableOption.EXACT_SEARCHABLE_DISABLED].
+     * 
      
+     *
+     * EXACT_SEARCHABLE_OPTION_UNSPECIFIED = 0;
+     */
+    public static final int EXACT_SEARCHABLE_OPTION_UNSPECIFIED_VALUE = 0;
+    /**
+     *
+     *
+     * 
      +     * Exact searchable option enabled for an attribute.
+     * 
      
+     *
+     * EXACT_SEARCHABLE_ENABLED = 1;
+     */
+    public static final int EXACT_SEARCHABLE_ENABLED_VALUE = 1;
+    /**
+     *
+     *
+     * 
      +     * Exact searchable option disabled for an attribute.
+     * 
      
+     *
+     * EXACT_SEARCHABLE_DISABLED = 2;
+     */
+    public static final int EXACT_SEARCHABLE_DISABLED_VALUE = 2;
+
+    public final int getNumber() {
+      if (this == UNRECOGNIZED) {
+        throw new java.lang.IllegalArgumentException(
+            "Can't get the number of an unknown enum value.");
+      }
+      return value;
+    }
+
+    /**
+     * @param value The numeric wire value of the corresponding enum entry.
+     * @return The enum associated with the given numeric wire value.
+     * @deprecated Use {@link #forNumber(int)} instead.
+     */
+    @java.lang.Deprecated
+    public static ExactSearchableOption valueOf(int value) {
+      return forNumber(value);
+    }
+
+    /**
+     * @param value The numeric wire value of the corresponding enum entry.
+     * @return The enum associated with the given numeric wire value.
+     */
+    public static ExactSearchableOption forNumber(int value) {
+      switch (value) {
+        case 0:
+          return EXACT_SEARCHABLE_OPTION_UNSPECIFIED;
+        case 1:
+          return EXACT_SEARCHABLE_ENABLED;
+        case 2:
+          return EXACT_SEARCHABLE_DISABLED;
+        default:
+          return null;
+      }
+    }
+
+    public static com.google.protobuf.Internal.EnumLiteMap
+        internalGetValueMap() {
+      return internalValueMap;
+    }
+
+    private static final com.google.protobuf.Internal.EnumLiteMap
+        internalValueMap =
+            new com.google.protobuf.Internal.EnumLiteMap() {
+              public ExactSearchableOption findValueByNumber(int number) {
+                return ExactSearchableOption.forNumber(number);
+              }
+            };
+
+    public final com.google.protobuf.Descriptors.EnumValueDescriptor getValueDescriptor() {
+      if (this == UNRECOGNIZED) {
+        throw new java.lang.IllegalStateException(
+            "Can't get the descriptor of an unrecognized enum value.");
+      }
+      return getDescriptor().getValues().get(ordinal());
+    }
+
+    public final com.google.protobuf.Descriptors.EnumDescriptor getDescriptorForType() {
+      return getDescriptor();
+    }
+
+    public static final com.google.protobuf.Descriptors.EnumDescriptor getDescriptor() {
+      return com.google.cloud.retail.v2alpha.CatalogAttribute.getDescriptor().getEnumTypes().get(4);
+    }
+
+    private static final ExactSearchableOption[] VALUES = values();
+
+    public static ExactSearchableOption valueOf(
+        com.google.protobuf.Descriptors.EnumValueDescriptor desc) {
+      if (desc.getType() != getDescriptor()) {
+        throw new java.lang.IllegalArgumentException("EnumValueDescriptor is not for this type.");
+      }
+      if (desc.getIndex() == -1) {
+        return UNRECOGNIZED;
+      }
+      return VALUES[desc.getIndex()];
+    }
+
+    private final int value;
+
+    private ExactSearchableOption(int value) {
+      this.value = value;
+    }
+
+    // @@protoc_insertion_point(enum_scope:google.cloud.retail.v2alpha.CatalogAttribute.ExactSearchableOption)
+  }
+
+  /**
+   *
+   *
+   * 
      +   * The status of the retrievable option of a catalog attribute.
+   * 
      
+   *
+   * Protobuf enum {@code google.cloud.retail.v2alpha.CatalogAttribute.RetrievableOption}
+   */
+  public enum RetrievableOption implements com.google.protobuf.ProtocolMessageEnum {
+    /**
+     *
+     *
+     * 
      +     * Value used when unset. Defaults to
+     * [RETRIEVABLE_DISABLED][google.cloud.retail.v2alpha.CatalogAttribute.RetrievableOption.RETRIEVABLE_DISABLED].
+     * 
      
+     *
+     * RETRIEVABLE_OPTION_UNSPECIFIED = 0;
+     */
+    RETRIEVABLE_OPTION_UNSPECIFIED(0),
+    /**
+     *
+     *
+     * 
      +     * Retrievable option enabled for an attribute.
+     * 
      
+     *
+     * RETRIEVABLE_ENABLED = 1;
+     */
+    RETRIEVABLE_ENABLED(1),
+    /**
+     *
+     *
+     * 
      +     * Retrievable option disabled for an attribute.
+     * 
      
+     *
+     * RETRIEVABLE_DISABLED = 2;
+     */
+    RETRIEVABLE_DISABLED(2),
+    UNRECOGNIZED(-1),
+    ;
+
+    /**
+     *
+     *
+     * 
      +     * Value used when unset. Defaults to
+     * [RETRIEVABLE_DISABLED][google.cloud.retail.v2alpha.CatalogAttribute.RetrievableOption.RETRIEVABLE_DISABLED].
+     * 
      
+     *
+     * RETRIEVABLE_OPTION_UNSPECIFIED = 0;
+     */
+    public static final int RETRIEVABLE_OPTION_UNSPECIFIED_VALUE = 0;
+    /**
+     *
+     *
+     * 
      +     * Retrievable option enabled for an attribute.
+     * 
      
+     *
+     * RETRIEVABLE_ENABLED = 1;
+     */
+    public static final int RETRIEVABLE_ENABLED_VALUE = 1;
+    /**
+     *
+     *
+     * 
      +     * Retrievable option disabled for an attribute.
+     * 
      
+     *
+     * RETRIEVABLE_DISABLED = 2;
+     */
+    public static final int RETRIEVABLE_DISABLED_VALUE = 2;
+
+    public final int getNumber() {
+      if (this == UNRECOGNIZED) {
+        throw new java.lang.IllegalArgumentException(
+            "Can't get the number of an unknown enum value.");
+      }
+      return value;
+    }
+
+    /**
+     * @param value The numeric wire value of the corresponding enum entry.
+     * @return The enum associated with the given numeric wire value.
+     * @deprecated Use {@link #forNumber(int)} instead.
+     */
+    @java.lang.Deprecated
+    public static RetrievableOption valueOf(int value) {
+      return forNumber(value);
+    }
+
+    /**
+     * @param value The numeric wire value of the corresponding enum entry.
+     * @return The enum associated with the given numeric wire value.
+     */
+    public static RetrievableOption forNumber(int value) {
+      switch (value) {
+        case 0:
+          return RETRIEVABLE_OPTION_UNSPECIFIED;
+        case 1:
+          return RETRIEVABLE_ENABLED;
+        case 2:
+          return RETRIEVABLE_DISABLED;
+        default:
+          return null;
+      }
+    }
+
+    public static com.google.protobuf.Internal.EnumLiteMap
+        internalGetValueMap() {
+      return internalValueMap;
+    }
+
+    private static final com.google.protobuf.Internal.EnumLiteMap
+        internalValueMap =
+            new com.google.protobuf.Internal.EnumLiteMap() {
+              public RetrievableOption findValueByNumber(int number) {
+                return RetrievableOption.forNumber(number);
+              }
+            };
+
+    public final com.google.protobuf.Descriptors.EnumValueDescriptor getValueDescriptor() {
+      if (this == UNRECOGNIZED) {
+        throw new java.lang.IllegalStateException(
+            "Can't get the descriptor of an unrecognized enum value.");
+      }
+      return getDescriptor().getValues().get(ordinal());
+    }
+
+    public final com.google.protobuf.Descriptors.EnumDescriptor getDescriptorForType() {
+      return getDescriptor();
+    }
+
+    public static final com.google.protobuf.Descriptors.EnumDescriptor getDescriptor() {
+      return com.google.cloud.retail.v2alpha.CatalogAttribute.getDescriptor().getEnumTypes().get(5);
+    }
+
+    private static final RetrievableOption[] VALUES = values();
+
+    public static RetrievableOption valueOf(
+        com.google.protobuf.Descriptors.EnumValueDescriptor desc) {
+      if (desc.getType() != getDescriptor()) {
+        throw new java.lang.IllegalArgumentException("EnumValueDescriptor is not for this type.");
+      }
+      if (desc.getIndex() == -1) {
+        return UNRECOGNIZED;
+      }
+      return VALUES[desc.getIndex()];
+    }
+
+    private final int value;
+
+    private RetrievableOption(int value) {
+      this.value = value;
+    }
+
+    // @@protoc_insertion_point(enum_scope:google.cloud.retail.v2alpha.CatalogAttribute.RetrievableOption)
+  }
+
   public static final int KEY_FIELD_NUMBER = 1;
   private volatile java.lang.Object key_;
   /**
@@ -798,13 +1118,13 @@ public com.google.protobuf.ByteString getKeyBytes() {
    * [CatalogService.UpdateAttributesConfig][google.cloud.retail.v2alpha.CatalogService.UpdateAttributesConfig]
    * APIs. This field is `False` for pre-loaded
    * [CatalogAttribute][google.cloud.retail.v2alpha.CatalogAttribute]s.
-   * Only pre-loaded
-   * [CatalogAttribute][google.cloud.retail.v2alpha.CatalogAttribute]s that are
-   * neither in use by products nor predefined can be deleted.
-   * [CatalogAttribute][google.cloud.retail.v2alpha.CatalogAttribute]s that are
-   * either in use by products or are predefined cannot be deleted; however,
-   * their configuration properties will reset to default values upon removal
-   * request.
+   * Only pre-loaded [catalog
+   * attributes][google.cloud.retail.v2alpha.CatalogAttribute] that are neither
+   * in use by products nor predefined can be deleted. [Catalog
+   * attributes][google.cloud.retail.v2alpha.CatalogAttribute] that are
+   * either in use by products or are predefined attributes cannot be deleted;
+   * however, their configuration properties will reset to default values upon
+   * removal request.
    * After catalog changes, it takes about 10 minutes for this field to update.
    * 
      
    *
@@ -872,6 +1192,7 @@ public com.google.cloud.retail.v2alpha.CatalogAttribute.AttributeType getType()
    * is CATALOG_LEVEL_ATTRIBUTE_CONFIG, if INDEXABLE_ENABLED attribute values
    * are indexed so that it can be filtered, faceted, or boosted in
    * [SearchService.Search][google.cloud.retail.v2alpha.SearchService.Search].
+   * Must be specified, otherwise throws INVALID_FORMAT error.
    * 
      
    *
    * .google.cloud.retail.v2alpha.CatalogAttribute.IndexableOption indexable_option = 5;
@@ -892,6 +1213,7 @@ public int getIndexableOptionValue() {
    * is CATALOG_LEVEL_ATTRIBUTE_CONFIG, if INDEXABLE_ENABLED attribute values
    * are indexed so that it can be filtered, faceted, or boosted in
    * [SearchService.Search][google.cloud.retail.v2alpha.SearchService.Search].
+   * Must be specified, otherwise throws INVALID_FORMAT error.
    * 
      
    *
    * .google.cloud.retail.v2alpha.CatalogAttribute.IndexableOption indexable_option = 5;
@@ -919,6 +1241,7 @@ public com.google.cloud.retail.v2alpha.CatalogAttribute.IndexableOption getIndex
    * facet. Could only be DYNAMIC_FACETABLE_DISABLED if
    * [CatalogAttribute.indexable_option][google.cloud.retail.v2alpha.CatalogAttribute.indexable_option]
    * is INDEXABLE_DISABLED. Otherwise, an INVALID_ARGUMENT error is returned.
+   * Must be specified, otherwise throws INVALID_FORMAT error.
    * 
      
    *
    * 
@@ -939,6 +1262,7 @@ public int getDynamicFacetableOptionValue() {
    * facet. Could only be DYNAMIC_FACETABLE_DISABLED if
    * [CatalogAttribute.indexable_option][google.cloud.retail.v2alpha.CatalogAttribute.indexable_option]
    * is INDEXABLE_DISABLED. Otherwise, an INVALID_ARGUMENT error is returned.
+   * Must be specified, otherwise throws INVALID_FORMAT error.
    * 
      
    *
    * 
@@ -974,6 +1298,7 @@ public int getDynamicFacetableOptionValue() {
    * will not be searchable by text queries in
    * [SearchService.Search][google.cloud.retail.v2alpha.SearchService.Search],
    * as there are no text values associated to numerical attributes.
+   * Must be specified, otherwise throws INVALID_FORMAT error.
    * 
      
    *
    * .google.cloud.retail.v2alpha.CatalogAttribute.SearchableOption searchable_option = 7;
@@ -998,6 +1323,7 @@ public int getSearchableOptionValue() {
    * will not be searchable by text queries in
    * [SearchService.Search][google.cloud.retail.v2alpha.SearchService.Search],
    * as there are no text values associated to numerical attributes.
+   * Must be specified, otherwise throws INVALID_FORMAT error.
    * 
      
    *
    * .google.cloud.retail.v2alpha.CatalogAttribute.SearchableOption searchable_option = 7;
@@ -1070,6 +1396,97 @@ public int getRecommendationsFilteringOptionValue() {
         : result;
   }
 
+  public static final int EXACT_SEARCHABLE_OPTION_FIELD_NUMBER = 11;
+  private int exactSearchableOption_;
+  /**
+   *
+   *
+   * 
      +   * 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.
+   * 
      
+   *
+   * 
+   * .google.cloud.retail.v2alpha.CatalogAttribute.ExactSearchableOption exact_searchable_option = 11;
+   * 
+   *
+   * @return The enum numeric value on the wire for exactSearchableOption.
+   */
+  @java.lang.Override
+  public int getExactSearchableOptionValue() {
+    return exactSearchableOption_;
+  }
+  /**
+   *
+   *
+   * 
      +   * 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.
+   * 
      
+   *
+   * 
+   * .google.cloud.retail.v2alpha.CatalogAttribute.ExactSearchableOption exact_searchable_option = 11;
+   * 
+   *
+   * @return The exactSearchableOption.
+   */
+  @java.lang.Override
+  public com.google.cloud.retail.v2alpha.CatalogAttribute.ExactSearchableOption
+      getExactSearchableOption() {
+    @SuppressWarnings("deprecation")
+    com.google.cloud.retail.v2alpha.CatalogAttribute.ExactSearchableOption result =
+        com.google.cloud.retail.v2alpha.CatalogAttribute.ExactSearchableOption.valueOf(
+            exactSearchableOption_);
+    return result == null
+        ? com.google.cloud.retail.v2alpha.CatalogAttribute.ExactSearchableOption.UNRECOGNIZED
+        : result;
+  }
+
+  public static final int RETRIEVABLE_OPTION_FIELD_NUMBER = 12;
+  private int retrievableOption_;
+  /**
+   *
+   *
+   * 
      +   * If RETRIEVABLE_ENABLED, attribute values are retrievable in the search
+   * results.
+   * 
      
+   *
+   * .google.cloud.retail.v2alpha.CatalogAttribute.RetrievableOption retrievable_option = 12;
+   * 
+   *
+   * @return The enum numeric value on the wire for retrievableOption.
+   */
+  @java.lang.Override
+  public int getRetrievableOptionValue() {
+    return retrievableOption_;
+  }
+  /**
+   *
+   *
+   * 
      +   * If RETRIEVABLE_ENABLED, attribute values are retrievable in the search
+   * results.
+   * 
      
+   *
+   * .google.cloud.retail.v2alpha.CatalogAttribute.RetrievableOption retrievable_option = 12;
+   * 
+   *
+   * @return The retrievableOption.
+   */
+  @java.lang.Override
+  public com.google.cloud.retail.v2alpha.CatalogAttribute.RetrievableOption getRetrievableOption() {
+    @SuppressWarnings("deprecation")
+    com.google.cloud.retail.v2alpha.CatalogAttribute.RetrievableOption result =
+        com.google.cloud.retail.v2alpha.CatalogAttribute.RetrievableOption.valueOf(
+            retrievableOption_);
+    return result == null
+        ? com.google.cloud.retail.v2alpha.CatalogAttribute.RetrievableOption.UNRECOGNIZED
+        : result;
+  }
+
   private byte memoizedIsInitialized = -1;
 
   @java.lang.Override
@@ -1118,6 +1535,18 @@ public void writeTo(com.google.protobuf.CodedOutputStream output) throws java.io
         != com.google.cloud.retail.v2alpha.CatalogAttribute.AttributeType.UNKNOWN.getNumber()) {
       output.writeEnum(10, type_);
     }
+    if (exactSearchableOption_
+        != com.google.cloud.retail.v2alpha.CatalogAttribute.ExactSearchableOption
+            .EXACT_SEARCHABLE_OPTION_UNSPECIFIED
+            .getNumber()) {
+      output.writeEnum(11, exactSearchableOption_);
+    }
+    if (retrievableOption_
+        != com.google.cloud.retail.v2alpha.CatalogAttribute.RetrievableOption
+            .RETRIEVABLE_OPTION_UNSPECIFIED
+            .getNumber()) {
+      output.writeEnum(12, retrievableOption_);
+    }
     getUnknownFields().writeTo(output);
   }
 
@@ -1162,6 +1591,18 @@ public int getSerializedSize() {
         != com.google.cloud.retail.v2alpha.CatalogAttribute.AttributeType.UNKNOWN.getNumber()) {
       size += com.google.protobuf.CodedOutputStream.computeEnumSize(10, type_);
     }
+    if (exactSearchableOption_
+        != com.google.cloud.retail.v2alpha.CatalogAttribute.ExactSearchableOption
+            .EXACT_SEARCHABLE_OPTION_UNSPECIFIED
+            .getNumber()) {
+      size += com.google.protobuf.CodedOutputStream.computeEnumSize(11, exactSearchableOption_);
+    }
+    if (retrievableOption_
+        != com.google.cloud.retail.v2alpha.CatalogAttribute.RetrievableOption
+            .RETRIEVABLE_OPTION_UNSPECIFIED
+            .getNumber()) {
+      size += com.google.protobuf.CodedOutputStream.computeEnumSize(12, retrievableOption_);
+    }
     size += getUnknownFields().getSerializedSize();
     memoizedSize = size;
     return size;
@@ -1185,6 +1626,8 @@ public boolean equals(final java.lang.Object obj) {
     if (dynamicFacetableOption_ != other.dynamicFacetableOption_) return false;
     if (searchableOption_ != other.searchableOption_) return false;
     if (recommendationsFilteringOption_ != other.recommendationsFilteringOption_) return false;
+    if (exactSearchableOption_ != other.exactSearchableOption_) return false;
+    if (retrievableOption_ != other.retrievableOption_) return false;
     if (!getUnknownFields().equals(other.getUnknownFields())) return false;
     return true;
   }
@@ -1210,6 +1653,10 @@ public int hashCode() {
     hash = (53 * hash) + searchableOption_;
     hash = (37 * hash) + RECOMMENDATIONS_FILTERING_OPTION_FIELD_NUMBER;
     hash = (53 * hash) + recommendationsFilteringOption_;
+    hash = (37 * hash) + EXACT_SEARCHABLE_OPTION_FIELD_NUMBER;
+    hash = (53 * hash) + exactSearchableOption_;
+    hash = (37 * hash) + RETRIEVABLE_OPTION_FIELD_NUMBER;
+    hash = (53 * hash) + retrievableOption_;
     hash = (29 * hash) + getUnknownFields().hashCode();
     memoizedHashCode = hash;
     return hash;
@@ -1363,6 +1810,10 @@ public Builder clear() {
 
       recommendationsFilteringOption_ = 0;
 
+      exactSearchableOption_ = 0;
+
+      retrievableOption_ = 0;
+
       return this;
     }
 
@@ -1397,6 +1848,8 @@ public com.google.cloud.retail.v2alpha.CatalogAttribute buildPartial() {
       result.dynamicFacetableOption_ = dynamicFacetableOption_;
       result.searchableOption_ = searchableOption_;
       result.recommendationsFilteringOption_ = recommendationsFilteringOption_;
+      result.exactSearchableOption_ = exactSearchableOption_;
+      result.retrievableOption_ = retrievableOption_;
       onBuilt();
       return result;
     }
@@ -1469,6 +1922,12 @@ public Builder mergeFrom(com.google.cloud.retail.v2alpha.CatalogAttribute other)
       if (other.recommendationsFilteringOption_ != 0) {
         setRecommendationsFilteringOptionValue(other.getRecommendationsFilteringOptionValue());
       }
+      if (other.exactSearchableOption_ != 0) {
+        setExactSearchableOptionValue(other.getExactSearchableOptionValue());
+      }
+      if (other.retrievableOption_ != 0) {
+        setRetrievableOptionValue(other.getRetrievableOptionValue());
+      }
       this.mergeUnknownFields(other.getUnknownFields());
       onChanged();
       return this;
@@ -1537,6 +1996,18 @@ public Builder mergeFrom(
 
                 break;
               } // case 80
+            case 88:
+              {
+                exactSearchableOption_ = input.readEnum();
+
+                break;
+              } // case 88
+            case 96:
+              {
+                retrievableOption_ = input.readEnum();
+
+                break;
+              } // case 96
             default:
               {
                 if (!super.parseUnknownField(input, extensionRegistry, tag)) {
@@ -1708,13 +2179,13 @@ public Builder setKeyBytes(com.google.protobuf.ByteString value) {
      * [CatalogService.UpdateAttributesConfig][google.cloud.retail.v2alpha.CatalogService.UpdateAttributesConfig]
      * APIs. This field is `False` for pre-loaded
      * [CatalogAttribute][google.cloud.retail.v2alpha.CatalogAttribute]s.
-     * Only pre-loaded
-     * [CatalogAttribute][google.cloud.retail.v2alpha.CatalogAttribute]s that are
-     * neither in use by products nor predefined can be deleted.
-     * [CatalogAttribute][google.cloud.retail.v2alpha.CatalogAttribute]s that are
-     * either in use by products or are predefined cannot be deleted; however,
-     * their configuration properties will reset to default values upon removal
-     * request.
+     * Only pre-loaded [catalog
+     * attributes][google.cloud.retail.v2alpha.CatalogAttribute] that are neither
+     * in use by products nor predefined can be deleted. [Catalog
+     * attributes][google.cloud.retail.v2alpha.CatalogAttribute] that are
+     * either in use by products or are predefined attributes cannot be deleted;
+     * however, their configuration properties will reset to default values upon
+     * removal request.
      * After catalog changes, it takes about 10 minutes for this field to update.
      * 
      
      *
@@ -1743,13 +2214,13 @@ public boolean getInUse() {
      * [CatalogService.UpdateAttributesConfig][google.cloud.retail.v2alpha.CatalogService.UpdateAttributesConfig]
      * APIs. This field is `False` for pre-loaded
      * [CatalogAttribute][google.cloud.retail.v2alpha.CatalogAttribute]s.
-     * Only pre-loaded
-     * [CatalogAttribute][google.cloud.retail.v2alpha.CatalogAttribute]s that are
-     * neither in use by products nor predefined can be deleted.
-     * [CatalogAttribute][google.cloud.retail.v2alpha.CatalogAttribute]s that are
-     * either in use by products or are predefined cannot be deleted; however,
-     * their configuration properties will reset to default values upon removal
-     * request.
+     * Only pre-loaded [catalog
+     * attributes][google.cloud.retail.v2alpha.CatalogAttribute] that are neither
+     * in use by products nor predefined can be deleted. [Catalog
+     * attributes][google.cloud.retail.v2alpha.CatalogAttribute] that are
+     * either in use by products or are predefined attributes cannot be deleted;
+     * however, their configuration properties will reset to default values upon
+     * removal request.
      * After catalog changes, it takes about 10 minutes for this field to update.
      * 
      
      *
@@ -1781,13 +2252,13 @@ public Builder setInUse(boolean value) {
      * [CatalogService.UpdateAttributesConfig][google.cloud.retail.v2alpha.CatalogService.UpdateAttributesConfig]
      * APIs. This field is `False` for pre-loaded
      * [CatalogAttribute][google.cloud.retail.v2alpha.CatalogAttribute]s.
-     * Only pre-loaded
-     * [CatalogAttribute][google.cloud.retail.v2alpha.CatalogAttribute]s that are
-     * neither in use by products nor predefined can be deleted.
-     * [CatalogAttribute][google.cloud.retail.v2alpha.CatalogAttribute]s that are
-     * either in use by products or are predefined cannot be deleted; however,
-     * their configuration properties will reset to default values upon removal
-     * request.
+     * Only pre-loaded [catalog
+     * attributes][google.cloud.retail.v2alpha.CatalogAttribute] that are neither
+     * in use by products nor predefined can be deleted. [Catalog
+     * attributes][google.cloud.retail.v2alpha.CatalogAttribute] that are
+     * either in use by products or are predefined attributes cannot be deleted;
+     * however, their configuration properties will reset to default values upon
+     * removal request.
      * After catalog changes, it takes about 10 minutes for this field to update.
      * 
      
      *
@@ -1920,6 +2391,7 @@ public Builder clearType() {
      * is CATALOG_LEVEL_ATTRIBUTE_CONFIG, if INDEXABLE_ENABLED attribute values
      * are indexed so that it can be filtered, faceted, or boosted in
      * [SearchService.Search][google.cloud.retail.v2alpha.SearchService.Search].
+     * Must be specified, otherwise throws INVALID_FORMAT error.
      * 
      
      *
      * .google.cloud.retail.v2alpha.CatalogAttribute.IndexableOption indexable_option = 5;
@@ -1940,6 +2412,7 @@ public int getIndexableOptionValue() {
      * is CATALOG_LEVEL_ATTRIBUTE_CONFIG, if INDEXABLE_ENABLED attribute values
      * are indexed so that it can be filtered, faceted, or boosted in
      * [SearchService.Search][google.cloud.retail.v2alpha.SearchService.Search].
+     * Must be specified, otherwise throws INVALID_FORMAT error.
      * 
      
      *
      * .google.cloud.retail.v2alpha.CatalogAttribute.IndexableOption indexable_option = 5;
@@ -1963,6 +2436,7 @@ public Builder setIndexableOptionValue(int value) {
      * is CATALOG_LEVEL_ATTRIBUTE_CONFIG, if INDEXABLE_ENABLED attribute values
      * are indexed so that it can be filtered, faceted, or boosted in
      * [SearchService.Search][google.cloud.retail.v2alpha.SearchService.Search].
+     * Must be specified, otherwise throws INVALID_FORMAT error.
      * 
      
      *
      * .google.cloud.retail.v2alpha.CatalogAttribute.IndexableOption indexable_option = 5;
@@ -1989,6 +2463,7 @@ public com.google.cloud.retail.v2alpha.CatalogAttribute.IndexableOption getIndex
      * is CATALOG_LEVEL_ATTRIBUTE_CONFIG, if INDEXABLE_ENABLED attribute values
      * are indexed so that it can be filtered, faceted, or boosted in
      * [SearchService.Search][google.cloud.retail.v2alpha.SearchService.Search].
+     * Must be specified, otherwise throws INVALID_FORMAT error.
      * 
      
      *
      * .google.cloud.retail.v2alpha.CatalogAttribute.IndexableOption indexable_option = 5;
@@ -2016,6 +2491,7 @@ public Builder setIndexableOption(
      * is CATALOG_LEVEL_ATTRIBUTE_CONFIG, if INDEXABLE_ENABLED attribute values
      * are indexed so that it can be filtered, faceted, or boosted in
      * [SearchService.Search][google.cloud.retail.v2alpha.SearchService.Search].
+     * Must be specified, otherwise throws INVALID_FORMAT error.
      * 
      
      *
      * .google.cloud.retail.v2alpha.CatalogAttribute.IndexableOption indexable_option = 5;
@@ -2039,6 +2515,7 @@ public Builder clearIndexableOption() {
      * facet. Could only be DYNAMIC_FACETABLE_DISABLED if
      * [CatalogAttribute.indexable_option][google.cloud.retail.v2alpha.CatalogAttribute.indexable_option]
      * is INDEXABLE_DISABLED. Otherwise, an INVALID_ARGUMENT error is returned.
+     * Must be specified, otherwise throws INVALID_FORMAT error.
      * 
      
      *
      * 
@@ -2059,6 +2536,7 @@ public int getDynamicFacetableOptionValue() {
      * facet. Could only be DYNAMIC_FACETABLE_DISABLED if
      * [CatalogAttribute.indexable_option][google.cloud.retail.v2alpha.CatalogAttribute.indexable_option]
      * is INDEXABLE_DISABLED. Otherwise, an INVALID_ARGUMENT error is returned.
+     * Must be specified, otherwise throws INVALID_FORMAT error.
      * 
      
      *
      * 
@@ -2082,6 +2560,7 @@ public Builder setDynamicFacetableOptionValue(int value) {
      * facet. Could only be DYNAMIC_FACETABLE_DISABLED if
      * [CatalogAttribute.indexable_option][google.cloud.retail.v2alpha.CatalogAttribute.indexable_option]
      * is INDEXABLE_DISABLED. Otherwise, an INVALID_ARGUMENT error is returned.
+     * Must be specified, otherwise throws INVALID_FORMAT error.
      * 
      
      *
      * 
@@ -2109,6 +2588,7 @@ public Builder setDynamicFacetableOptionValue(int value) {
      * facet. Could only be DYNAMIC_FACETABLE_DISABLED if
      * [CatalogAttribute.indexable_option][google.cloud.retail.v2alpha.CatalogAttribute.indexable_option]
      * is INDEXABLE_DISABLED. Otherwise, an INVALID_ARGUMENT error is returned.
+     * Must be specified, otherwise throws INVALID_FORMAT error.
      * 
      
      *
      * 
@@ -2136,6 +2616,7 @@ public Builder setDynamicFacetableOption(
      * facet. Could only be DYNAMIC_FACETABLE_DISABLED if
      * [CatalogAttribute.indexable_option][google.cloud.retail.v2alpha.CatalogAttribute.indexable_option]
      * is INDEXABLE_DISABLED. Otherwise, an INVALID_ARGUMENT error is returned.
+     * Must be specified, otherwise throws INVALID_FORMAT error.
      * 
      
      *
      * 
@@ -2165,6 +2646,7 @@ public Builder clearDynamicFacetableOption() {
      * will not be searchable by text queries in
      * [SearchService.Search][google.cloud.retail.v2alpha.SearchService.Search],
      * as there are no text values associated to numerical attributes.
+     * Must be specified, otherwise throws INVALID_FORMAT error.
      * 
      
      *
      * .google.cloud.retail.v2alpha.CatalogAttribute.SearchableOption searchable_option = 7;
@@ -2189,6 +2671,7 @@ public int getSearchableOptionValue() {
      * will not be searchable by text queries in
      * [SearchService.Search][google.cloud.retail.v2alpha.SearchService.Search],
      * as there are no text values associated to numerical attributes.
+     * Must be specified, otherwise throws INVALID_FORMAT error.
      * 
      
      *
      * .google.cloud.retail.v2alpha.CatalogAttribute.SearchableOption searchable_option = 7;
@@ -2216,6 +2699,7 @@ public Builder setSearchableOptionValue(int value) {
      * will not be searchable by text queries in
      * [SearchService.Search][google.cloud.retail.v2alpha.SearchService.Search],
      * as there are no text values associated to numerical attributes.
+     * Must be specified, otherwise throws INVALID_FORMAT error.
      * 
      
      *
      * .google.cloud.retail.v2alpha.CatalogAttribute.SearchableOption searchable_option = 7;
@@ -2246,6 +2730,7 @@ public com.google.cloud.retail.v2alpha.CatalogAttribute.SearchableOption getSear
      * will not be searchable by text queries in
      * [SearchService.Search][google.cloud.retail.v2alpha.SearchService.Search],
      * as there are no text values associated to numerical attributes.
+     * Must be specified, otherwise throws INVALID_FORMAT error.
      * 
      
      *
      * .google.cloud.retail.v2alpha.CatalogAttribute.SearchableOption searchable_option = 7;
@@ -2277,6 +2762,7 @@ public Builder setSearchableOption(
      * will not be searchable by text queries in
      * [SearchService.Search][google.cloud.retail.v2alpha.SearchService.Search],
      * as there are no text values associated to numerical attributes.
+     * Must be specified, otherwise throws INVALID_FORMAT error.
      * 
      
      *
      * .google.cloud.retail.v2alpha.CatalogAttribute.SearchableOption searchable_option = 7;
@@ -2422,6 +2908,233 @@ public Builder clearRecommendationsFilteringOption() {
       return this;
     }
 
+    private int exactSearchableOption_ = 0;
+    /**
+     *
+     *
+     * 
      +     * 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.
+     * 
      
+     *
+     * 
+     * .google.cloud.retail.v2alpha.CatalogAttribute.ExactSearchableOption exact_searchable_option = 11;
+     * 
+     *
+     * @return The enum numeric value on the wire for exactSearchableOption.
+     */
+    @java.lang.Override
+    public int getExactSearchableOptionValue() {
+      return exactSearchableOption_;
+    }
+    /**
+     *
+     *
+     * 
      +     * 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.
+     * 
      
+     *
+     * 
+     * .google.cloud.retail.v2alpha.CatalogAttribute.ExactSearchableOption exact_searchable_option = 11;
+     * 
+     *
+     * @param value The enum numeric value on the wire for exactSearchableOption to set.
+     * @return This builder for chaining.
+     */
+    public Builder setExactSearchableOptionValue(int value) {
+
+      exactSearchableOption_ = value;
+      onChanged();
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * 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.
+     * 
      
+     *
+     * 
+     * .google.cloud.retail.v2alpha.CatalogAttribute.ExactSearchableOption exact_searchable_option = 11;
+     * 
+     *
+     * @return The exactSearchableOption.
+     */
+    @java.lang.Override
+    public com.google.cloud.retail.v2alpha.CatalogAttribute.ExactSearchableOption
+        getExactSearchableOption() {
+      @SuppressWarnings("deprecation")
+      com.google.cloud.retail.v2alpha.CatalogAttribute.ExactSearchableOption result =
+          com.google.cloud.retail.v2alpha.CatalogAttribute.ExactSearchableOption.valueOf(
+              exactSearchableOption_);
+      return result == null
+          ? com.google.cloud.retail.v2alpha.CatalogAttribute.ExactSearchableOption.UNRECOGNIZED
+          : result;
+    }
+    /**
+     *
+     *
+     * 
      +     * 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.
+     * 
      
+     *
+     * 
+     * .google.cloud.retail.v2alpha.CatalogAttribute.ExactSearchableOption exact_searchable_option = 11;
+     * 
+     *
+     * @param value The exactSearchableOption to set.
+     * @return This builder for chaining.
+     */
+    public Builder setExactSearchableOption(
+        com.google.cloud.retail.v2alpha.CatalogAttribute.ExactSearchableOption value) {
+      if (value == null) {
+        throw new NullPointerException();
+      }
+
+      exactSearchableOption_ = value.getNumber();
+      onChanged();
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * 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.
+     * 
      
+     *
+     * 
+     * .google.cloud.retail.v2alpha.CatalogAttribute.ExactSearchableOption exact_searchable_option = 11;
+     * 
+     *
+     * @return This builder for chaining.
+     */
+    public Builder clearExactSearchableOption() {
+
+      exactSearchableOption_ = 0;
+      onChanged();
+      return this;
+    }
+
+    private int retrievableOption_ = 0;
+    /**
+     *
+     *
+     * 
      +     * If RETRIEVABLE_ENABLED, attribute values are retrievable in the search
+     * results.
+     * 
      
+     *
+     * 
+     * .google.cloud.retail.v2alpha.CatalogAttribute.RetrievableOption retrievable_option = 12;
+     * 
+     *
+     * @return The enum numeric value on the wire for retrievableOption.
+     */
+    @java.lang.Override
+    public int getRetrievableOptionValue() {
+      return retrievableOption_;
+    }
+    /**
+     *
+     *
+     * 
      +     * If RETRIEVABLE_ENABLED, attribute values are retrievable in the search
+     * results.
+     * 
      
+     *
+     * 
+     * .google.cloud.retail.v2alpha.CatalogAttribute.RetrievableOption retrievable_option = 12;
+     * 
+     *
+     * @param value The enum numeric value on the wire for retrievableOption to set.
+     * @return This builder for chaining.
+     */
+    public Builder setRetrievableOptionValue(int value) {
+
+      retrievableOption_ = value;
+      onChanged();
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * If RETRIEVABLE_ENABLED, attribute values are retrievable in the search
+     * results.
+     * 
      
+     *
+     * 
+     * .google.cloud.retail.v2alpha.CatalogAttribute.RetrievableOption retrievable_option = 12;
+     * 
+     *
+     * @return The retrievableOption.
+     */
+    @java.lang.Override
+    public com.google.cloud.retail.v2alpha.CatalogAttribute.RetrievableOption
+        getRetrievableOption() {
+      @SuppressWarnings("deprecation")
+      com.google.cloud.retail.v2alpha.CatalogAttribute.RetrievableOption result =
+          com.google.cloud.retail.v2alpha.CatalogAttribute.RetrievableOption.valueOf(
+              retrievableOption_);
+      return result == null
+          ? com.google.cloud.retail.v2alpha.CatalogAttribute.RetrievableOption.UNRECOGNIZED
+          : result;
+    }
+    /**
+     *
+     *
+     * 
      +     * If RETRIEVABLE_ENABLED, attribute values are retrievable in the search
+     * results.
+     * 
      
+     *
+     * 
+     * .google.cloud.retail.v2alpha.CatalogAttribute.RetrievableOption retrievable_option = 12;
+     * 
+     *
+     * @param value The retrievableOption to set.
+     * @return This builder for chaining.
+     */
+    public Builder setRetrievableOption(
+        com.google.cloud.retail.v2alpha.CatalogAttribute.RetrievableOption value) {
+      if (value == null) {
+        throw new NullPointerException();
+      }
+
+      retrievableOption_ = value.getNumber();
+      onChanged();
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * If RETRIEVABLE_ENABLED, attribute values are retrievable in the search
+     * results.
+     * 
      
+     *
+     * 
+     * .google.cloud.retail.v2alpha.CatalogAttribute.RetrievableOption retrievable_option = 12;
+     * 
+     *
+     * @return This builder for chaining.
+     */
+    public Builder clearRetrievableOption() {
+
+      retrievableOption_ = 0;
+      onChanged();
+      return this;
+    }
+
     @java.lang.Override
     public final Builder setUnknownFields(final com.google.protobuf.UnknownFieldSet unknownFields) {
       return super.setUnknownFields(unknownFields);
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/CatalogAttributeOrBuilder.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/CatalogAttributeOrBuilder.java
index 5c4272d74b44..53c6fe6e8b09 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/CatalogAttributeOrBuilder.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/CatalogAttributeOrBuilder.java
@@ -77,13 +77,13 @@ public interface CatalogAttributeOrBuilder
    * [CatalogService.UpdateAttributesConfig][google.cloud.retail.v2alpha.CatalogService.UpdateAttributesConfig]
    * APIs. This field is `False` for pre-loaded
    * [CatalogAttribute][google.cloud.retail.v2alpha.CatalogAttribute]s.
-   * Only pre-loaded
-   * [CatalogAttribute][google.cloud.retail.v2alpha.CatalogAttribute]s that are
-   * neither in use by products nor predefined can be deleted.
-   * [CatalogAttribute][google.cloud.retail.v2alpha.CatalogAttribute]s that are
-   * either in use by products or are predefined cannot be deleted; however,
-   * their configuration properties will reset to default values upon removal
-   * request.
+   * Only pre-loaded [catalog
+   * attributes][google.cloud.retail.v2alpha.CatalogAttribute] that are neither
+   * in use by products nor predefined can be deleted. [Catalog
+   * attributes][google.cloud.retail.v2alpha.CatalogAttribute] that are
+   * either in use by products or are predefined attributes cannot be deleted;
+   * however, their configuration properties will reset to default values upon
+   * removal request.
    * After catalog changes, it takes about 10 minutes for this field to update.
    * 
      
    *
@@ -133,6 +133,7 @@ public interface CatalogAttributeOrBuilder
    * is CATALOG_LEVEL_ATTRIBUTE_CONFIG, if INDEXABLE_ENABLED attribute values
    * are indexed so that it can be filtered, faceted, or boosted in
    * [SearchService.Search][google.cloud.retail.v2alpha.SearchService.Search].
+   * Must be specified, otherwise throws INVALID_FORMAT error.
    * 
      
    *
    * .google.cloud.retail.v2alpha.CatalogAttribute.IndexableOption indexable_option = 5;
@@ -150,6 +151,7 @@ public interface CatalogAttributeOrBuilder
    * is CATALOG_LEVEL_ATTRIBUTE_CONFIG, if INDEXABLE_ENABLED attribute values
    * are indexed so that it can be filtered, faceted, or boosted in
    * [SearchService.Search][google.cloud.retail.v2alpha.SearchService.Search].
+   * Must be specified, otherwise throws INVALID_FORMAT error.
    * 
      
    *
    * .google.cloud.retail.v2alpha.CatalogAttribute.IndexableOption indexable_option = 5;
@@ -167,6 +169,7 @@ public interface CatalogAttributeOrBuilder
    * facet. Could only be DYNAMIC_FACETABLE_DISABLED if
    * [CatalogAttribute.indexable_option][google.cloud.retail.v2alpha.CatalogAttribute.indexable_option]
    * is INDEXABLE_DISABLED. Otherwise, an INVALID_ARGUMENT error is returned.
+   * Must be specified, otherwise throws INVALID_FORMAT error.
    * 
      
    *
    * 
@@ -184,6 +187,7 @@ public interface CatalogAttributeOrBuilder
    * facet. Could only be DYNAMIC_FACETABLE_DISABLED if
    * [CatalogAttribute.indexable_option][google.cloud.retail.v2alpha.CatalogAttribute.indexable_option]
    * is INDEXABLE_DISABLED. Otherwise, an INVALID_ARGUMENT error is returned.
+   * Must be specified, otherwise throws INVALID_FORMAT error.
    * 
      
    *
    * 
@@ -208,6 +212,7 @@ public interface CatalogAttributeOrBuilder
    * will not be searchable by text queries in
    * [SearchService.Search][google.cloud.retail.v2alpha.SearchService.Search],
    * as there are no text values associated to numerical attributes.
+   * Must be specified, otherwise throws INVALID_FORMAT error.
    * 
      
    *
    * .google.cloud.retail.v2alpha.CatalogAttribute.SearchableOption searchable_option = 7;
@@ -229,6 +234,7 @@ public interface CatalogAttributeOrBuilder
    * will not be searchable by text queries in
    * [SearchService.Search][google.cloud.retail.v2alpha.SearchService.Search],
    * as there are no text values associated to numerical attributes.
+   * Must be specified, otherwise throws INVALID_FORMAT error.
    * 
      
    *
    * .google.cloud.retail.v2alpha.CatalogAttribute.SearchableOption searchable_option = 7;
@@ -277,4 +283,66 @@ public interface CatalogAttributeOrBuilder
    */
   com.google.cloud.retail.v2alpha.RecommendationsFilteringOption
       getRecommendationsFilteringOption();
+
+  /**
+   *
+   *
+   * 
      +   * 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.
+   * 
      
+   *
+   * 
+   * .google.cloud.retail.v2alpha.CatalogAttribute.ExactSearchableOption exact_searchable_option = 11;
+   * 
+   *
+   * @return The enum numeric value on the wire for exactSearchableOption.
+   */
+  int getExactSearchableOptionValue();
+  /**
+   *
+   *
+   * 
      +   * 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.
+   * 
      
+   *
+   * 
+   * .google.cloud.retail.v2alpha.CatalogAttribute.ExactSearchableOption exact_searchable_option = 11;
+   * 
+   *
+   * @return The exactSearchableOption.
+   */
+  com.google.cloud.retail.v2alpha.CatalogAttribute.ExactSearchableOption getExactSearchableOption();
+
+  /**
+   *
+   *
+   * 
      +   * If RETRIEVABLE_ENABLED, attribute values are retrievable in the search
+   * results.
+   * 
      
+   *
+   * .google.cloud.retail.v2alpha.CatalogAttribute.RetrievableOption retrievable_option = 12;
+   * 
+   *
+   * @return The enum numeric value on the wire for retrievableOption.
+   */
+  int getRetrievableOptionValue();
+  /**
+   *
+   *
+   * 
      +   * If RETRIEVABLE_ENABLED, attribute values are retrievable in the search
+   * results.
+   * 
      
+   *
+   * .google.cloud.retail.v2alpha.CatalogAttribute.RetrievableOption retrievable_option = 12;
+   * 
+   *
+   * @return The retrievableOption.
+   */
+  com.google.cloud.retail.v2alpha.CatalogAttribute.RetrievableOption getRetrievableOption();
 }
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/CatalogProto.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/CatalogProto.java
index 233e3edff4ff..3aec10ee6ad9 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/CatalogProto.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/CatalogProto.java
@@ -51,6 +51,10 @@ public static void registerAllExtensions(com.google.protobuf.ExtensionRegistry r
       internal_static_google_cloud_retail_v2alpha_MerchantCenterLink_descriptor;
   static final com.google.protobuf.GeneratedMessageV3.FieldAccessorTable
       internal_static_google_cloud_retail_v2alpha_MerchantCenterLink_fieldAccessorTable;
+  static final com.google.protobuf.Descriptors.Descriptor
+      internal_static_google_cloud_retail_v2alpha_MerchantCenterFeedFilter_descriptor;
+  static final com.google.protobuf.GeneratedMessageV3.FieldAccessorTable
+      internal_static_google_cloud_retail_v2alpha_MerchantCenterFeedFilter_fieldAccessorTable;
   static final com.google.protobuf.Descriptors.Descriptor
       internal_static_google_cloud_retail_v2alpha_MerchantCenterLinkingConfig_descriptor;
   static final com.google.protobuf.GeneratedMessageV3.FieldAccessorTable
@@ -76,7 +80,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
           + "pha/import_config.proto\"^\n\022ProductLevelC"
           + "onfig\022\036\n\026ingestion_product_type\030\001 \001(\t\022(\n"
           + " merchant_center_product_id_field\030\002 \001(\t\""
-          + "\226\007\n\020CatalogAttribute\022\020\n\003key\030\001 \001(\tB\003\340A\002\022\023"
+          + "\304\n\n\020CatalogAttribute\022\020\n\003key\030\001 \001(\tB\003\340A\002\022\023"
           + "\n\006in_use\030\t \001(\010B\003\340A\003\022N\n\004type\030\n \001(\0162;.goog"
           + "le.cloud.retail.v2alpha.CatalogAttribute"
           + ".AttributeTypeB\003\340A\003\022W\n\020indexable_option\030"
@@ -89,65 +93,80 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
           + "ribute.SearchableOption\022e\n recommendatio"
           + "ns_filtering_option\030\010 \001(\0162;.google.cloud"
           + ".retail.v2alpha.RecommendationsFiltering"
-          + "Option\"8\n\rAttributeType\022\013\n\007UNKNOWN\020\000\022\013\n\007"
-          + "TEXTUAL\020\001\022\r\n\tNUMERICAL\020\002\"b\n\017IndexableOpt"
-          + "ion\022 \n\034INDEXABLE_OPTION_UNSPECIFIED\020\000\022\025\n"
-          + "\021INDEXABLE_ENABLED\020\001\022\026\n\022INDEXABLE_DISABL"
-          + "ED\020\002\"\201\001\n\026DynamicFacetableOption\022(\n$DYNAM"
-          + "IC_FACETABLE_OPTION_UNSPECIFIED\020\000\022\035\n\031DYN"
-          + "AMIC_FACETABLE_ENABLED\020\001\022\036\n\032DYNAMIC_FACE"
-          + "TABLE_DISABLED\020\002\"f\n\020SearchableOption\022!\n\035"
-          + "SEARCHABLE_OPTION_UNSPECIFIED\020\000\022\026\n\022SEARC"
-          + "HABLE_ENABLED\020\001\022\027\n\023SEARCHABLE_DISABLED\020\002"
-          + "\"\305\003\n\020AttributesConfig\022\024\n\004name\030\001 \001(\tB\006\340A\002"
-          + "\340A\005\022`\n\022catalog_attributes\030\002 \003(\0132D.google"
-          + ".cloud.retail.v2alpha.AttributesConfig.C"
-          + "atalogAttributesEntry\022V\n\026attribute_confi"
-          + "g_level\030\003 \001(\01621.google.cloud.retail.v2al"
-          + "pha.AttributeConfigLevelB\003\340A\003\032g\n\026Catalog"
-          + "AttributesEntry\022\013\n\003key\030\001 \001(\t\022<\n\005value\030\002 "
-          + "\001(\0132-.google.cloud.retail.v2alpha.Catalo"
-          + "gAttribute:\0028\001:x\352Au\n&retail.googleapis.c"
-          + "om/AttributesConfig\022Kprojects/{project}/"
-          + "locations/{location}/catalogs/{catalog}/"
-          + "attributesConfig\"\250\005\n\020CompletionConfig\022\024\n"
-          + "\004name\030\001 \001(\tB\006\340A\002\340A\005\022\026\n\016matching_order\030\002 "
-          + "\001(\t\022\027\n\017max_suggestions\030\003 \001(\005\022\031\n\021min_pref"
-          + "ix_length\030\004 \001(\005\022\025\n\rauto_learning\030\013 \001(\010\022]"
-          + "\n\030suggestions_input_config\030\005 \001(\01326.googl"
-          + "e.cloud.retail.v2alpha.CompletionDataInp"
-          + "utConfigB\003\340A\003\022.\n!last_suggestions_import"
-          + "_operation\030\006 \001(\tB\003\340A\003\022Z\n\025denylist_input_"
-          + "config\030\007 \001(\01326.google.cloud.retail.v2alp"
-          + "ha.CompletionDataInputConfigB\003\340A\003\022+\n\036las"
-          + "t_denylist_import_operation\030\010 \001(\tB\003\340A\003\022["
-          + "\n\026allowlist_input_config\030\t \001(\01326.google."
-          + "cloud.retail.v2alpha.CompletionDataInput"
-          + "ConfigB\003\340A\003\022,\n\037last_allowlist_import_ope"
-          + "ration\030\n \001(\tB\003\340A\003:x\352Au\n&retail.googleapi"
-          + "s.com/CompletionConfig\022Kprojects/{projec"
-          + "t}/locations/{location}/catalogs/{catalo"
-          + "g}/completionConfig\"\222\001\n\022MerchantCenterLi"
-          + "nk\022\'\n\032merchant_center_account_id\030\001 \001(\003B\003"
-          + "\340A\002\022\021\n\tbranch_id\030\002 \001(\t\022\024\n\014destinations\030\003"
-          + " \003(\t\022\023\n\013region_code\030\004 \001(\t\022\025\n\rlanguage_co"
-          + "de\030\005 \001(\t\"]\n\033MerchantCenterLinkingConfig\022"
-          + ">\n\005links\030\001 \003(\0132/.google.cloud.retail.v2a"
-          + "lpha.MerchantCenterLink\"\323\002\n\007Catalog\022\024\n\004n"
-          + "ame\030\001 \001(\tB\006\340A\002\340A\005\022\034\n\014display_name\030\002 \001(\tB"
-          + "\006\340A\002\340A\005\022R\n\024product_level_config\030\004 \001(\0132/."
-          + "google.cloud.retail.v2alpha.ProductLevel"
-          + "ConfigB\003\340A\002\022`\n\036merchant_center_linking_c"
-          + "onfig\030\006 \001(\01328.google.cloud.retail.v2alph"
-          + "a.MerchantCenterLinkingConfig:^\352A[\n\035reta"
-          + "il.googleapis.com/Catalog\022:projects/{pro"
-          + "ject}/locations/{location}/catalogs/{cat"
-          + "alog}B\332\001\n\037com.google.cloud.retail.v2alph"
-          + "aB\014CatalogProtoP\001ZAgoogle.golang.org/gen"
-          + "proto/googleapis/cloud/retail/v2alpha;re"
-          + "tail\242\002\006RETAIL\252\002\033Google.Cloud.Retail.V2Al"
-          + "pha\312\002\033Google\\Cloud\\Retail\\V2alpha\352\002\036Goog"
-          + "le::Cloud::Retail::V2alphab\006proto3"
+          + "Option\022d\n\027exact_searchable_option\030\013 \001(\0162"
+          + "C.google.cloud.retail.v2alpha.CatalogAtt"
+          + "ribute.ExactSearchableOption\022[\n\022retrieva"
+          + "ble_option\030\014 \001(\0162?.google.cloud.retail.v"
+          + "2alpha.CatalogAttribute.RetrievableOptio"
+          + "n\"8\n\rAttributeType\022\013\n\007UNKNOWN\020\000\022\013\n\007TEXTU"
+          + "AL\020\001\022\r\n\tNUMERICAL\020\002\"b\n\017IndexableOption\022 "
+          + "\n\034INDEXABLE_OPTION_UNSPECIFIED\020\000\022\025\n\021INDE"
+          + "XABLE_ENABLED\020\001\022\026\n\022INDEXABLE_DISABLED\020\002\""
+          + "\201\001\n\026DynamicFacetableOption\022(\n$DYNAMIC_FA"
+          + "CETABLE_OPTION_UNSPECIFIED\020\000\022\035\n\031DYNAMIC_"
+          + "FACETABLE_ENABLED\020\001\022\036\n\032DYNAMIC_FACETABLE"
+          + "_DISABLED\020\002\"f\n\020SearchableOption\022!\n\035SEARC"
+          + "HABLE_OPTION_UNSPECIFIED\020\000\022\026\n\022SEARCHABLE"
+          + "_ENABLED\020\001\022\027\n\023SEARCHABLE_DISABLED\020\002\"}\n\025E"
+          + "xactSearchableOption\022\'\n#EXACT_SEARCHABLE"
+          + "_OPTION_UNSPECIFIED\020\000\022\034\n\030EXACT_SEARCHABL"
+          + "E_ENABLED\020\001\022\035\n\031EXACT_SEARCHABLE_DISABLED"
+          + "\020\002\"j\n\021RetrievableOption\022\"\n\036RETRIEVABLE_O"
+          + "PTION_UNSPECIFIED\020\000\022\027\n\023RETRIEVABLE_ENABL"
+          + "ED\020\001\022\030\n\024RETRIEVABLE_DISABLED\020\002\"\305\003\n\020Attri"
+          + "butesConfig\022\024\n\004name\030\001 \001(\tB\006\340A\002\340A\005\022`\n\022cat"
+          + "alog_attributes\030\002 \003(\0132D.google.cloud.ret"
+          + "ail.v2alpha.AttributesConfig.CatalogAttr"
+          + "ibutesEntry\022V\n\026attribute_config_level\030\003 "
+          + "\001(\01621.google.cloud.retail.v2alpha.Attrib"
+          + "uteConfigLevelB\003\340A\003\032g\n\026CatalogAttributes"
+          + "Entry\022\013\n\003key\030\001 \001(\t\022<\n\005value\030\002 \001(\0132-.goog"
+          + "le.cloud.retail.v2alpha.CatalogAttribute"
+          + ":\0028\001:x\352Au\n&retail.googleapis.com/Attribu"
+          + "tesConfig\022Kprojects/{project}/locations/"
+          + "{location}/catalogs/{catalog}/attributes"
+          + "Config\"\250\005\n\020CompletionConfig\022\024\n\004name\030\001 \001("
+          + "\tB\006\340A\002\340A\005\022\026\n\016matching_order\030\002 \001(\t\022\027\n\017max"
+          + "_suggestions\030\003 \001(\005\022\031\n\021min_prefix_length\030"
+          + "\004 \001(\005\022\025\n\rauto_learning\030\013 \001(\010\022]\n\030suggesti"
+          + "ons_input_config\030\005 \001(\01326.google.cloud.re"
+          + "tail.v2alpha.CompletionDataInputConfigB\003"
+          + "\340A\003\022.\n!last_suggestions_import_operation"
+          + "\030\006 \001(\tB\003\340A\003\022Z\n\025denylist_input_config\030\007 \001"
+          + "(\01326.google.cloud.retail.v2alpha.Complet"
+          + "ionDataInputConfigB\003\340A\003\022+\n\036last_denylist"
+          + "_import_operation\030\010 \001(\tB\003\340A\003\022[\n\026allowlis"
+          + "t_input_config\030\t \001(\01326.google.cloud.reta"
+          + "il.v2alpha.CompletionDataInputConfigB\003\340A"
+          + "\003\022,\n\037last_allowlist_import_operation\030\n \001"
+          + "(\tB\003\340A\003:x\352Au\n&retail.googleapis.com/Comp"
+          + "letionConfig\022Kprojects/{project}/locatio"
+          + "ns/{location}/catalogs/{catalog}/complet"
+          + "ionConfig\"\330\001\n\022MerchantCenterLink\022\'\n\032merc"
+          + "hant_center_account_id\030\001 \001(\003B\003\340A\002\022\021\n\tbra"
+          + "nch_id\030\002 \001(\t\022\024\n\014destinations\030\003 \003(\t\022\023\n\013re"
+          + "gion_code\030\004 \001(\t\022\025\n\rlanguage_code\030\005 \001(\t\022D"
+          + "\n\005feeds\030\006 \003(\01325.google.cloud.retail.v2al"
+          + "pha.MerchantCenterFeedFilter\"N\n\030Merchant"
+          + "CenterFeedFilter\022\027\n\017primary_feed_id\030\001 \001("
+          + "\003\022\031\n\021primary_feed_name\030\002 \001(\t\"]\n\033Merchant"
+          + "CenterLinkingConfig\022>\n\005links\030\001 \003(\0132/.goo"
+          + "gle.cloud.retail.v2alpha.MerchantCenterL"
+          + "ink\"\323\002\n\007Catalog\022\024\n\004name\030\001 \001(\tB\006\340A\002\340A\005\022\034\n"
+          + "\014display_name\030\002 \001(\tB\006\340A\002\340A\005\022R\n\024product_l"
+          + "evel_config\030\004 \001(\0132/.google.cloud.retail."
+          + "v2alpha.ProductLevelConfigB\003\340A\002\022`\n\036merch"
+          + "ant_center_linking_config\030\006 \001(\01328.google"
+          + ".cloud.retail.v2alpha.MerchantCenterLink"
+          + "ingConfig:^\352A[\n\035retail.googleapis.com/Ca"
+          + "talog\022:projects/{project}/locations/{loc"
+          + "ation}/catalogs/{catalog}B\332\001\n\037com.google"
+          + ".cloud.retail.v2alphaB\014CatalogProtoP\001ZAg"
+          + "oogle.golang.org/genproto/googleapis/clo"
+          + "ud/retail/v2alpha;retail\242\002\006RETAIL\252\002\033Goog"
+          + "le.Cloud.Retail.V2Alpha\312\002\033Google\\Cloud\\R"
+          + "etail\\V2alpha\352\002\036Google::Cloud::Retail::V"
+          + "2alphab\006proto3"
     };
     descriptor =
         com.google.protobuf.Descriptors.FileDescriptor.internalBuildGeneratedFileFrom(
@@ -179,6 +198,8 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
               "DynamicFacetableOption",
               "SearchableOption",
               "RecommendationsFilteringOption",
+              "ExactSearchableOption",
+              "RetrievableOption",
             });
     internal_static_google_cloud_retail_v2alpha_AttributesConfig_descriptor =
         getDescriptor().getMessageTypes().get(2);
@@ -222,10 +243,23 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
         new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable(
             internal_static_google_cloud_retail_v2alpha_MerchantCenterLink_descriptor,
             new java.lang.String[] {
-              "MerchantCenterAccountId", "BranchId", "Destinations", "RegionCode", "LanguageCode",
+              "MerchantCenterAccountId",
+              "BranchId",
+              "Destinations",
+              "RegionCode",
+              "LanguageCode",
+              "Feeds",
             });
-    internal_static_google_cloud_retail_v2alpha_MerchantCenterLinkingConfig_descriptor =
+    internal_static_google_cloud_retail_v2alpha_MerchantCenterFeedFilter_descriptor =
         getDescriptor().getMessageTypes().get(5);
+    internal_static_google_cloud_retail_v2alpha_MerchantCenterFeedFilter_fieldAccessorTable =
+        new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable(
+            internal_static_google_cloud_retail_v2alpha_MerchantCenterFeedFilter_descriptor,
+            new java.lang.String[] {
+              "PrimaryFeedId", "PrimaryFeedName",
+            });
+    internal_static_google_cloud_retail_v2alpha_MerchantCenterLinkingConfig_descriptor =
+        getDescriptor().getMessageTypes().get(6);
     internal_static_google_cloud_retail_v2alpha_MerchantCenterLinkingConfig_fieldAccessorTable =
         new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable(
             internal_static_google_cloud_retail_v2alpha_MerchantCenterLinkingConfig_descriptor,
@@ -233,7 +267,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
               "Links",
             });
     internal_static_google_cloud_retail_v2alpha_Catalog_descriptor =
-        getDescriptor().getMessageTypes().get(6);
+        getDescriptor().getMessageTypes().get(7);
     internal_static_google_cloud_retail_v2alpha_Catalog_fieldAccessorTable =
         new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable(
             internal_static_google_cloud_retail_v2alpha_Catalog_descriptor,
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/CatalogServiceProto.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/CatalogServiceProto.java
index c9207e9b62d6..6bba0534bca0 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/CatalogServiceProto.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/CatalogServiceProto.java
@@ -75,6 +75,14 @@ public static void registerAllExtensions(com.google.protobuf.ExtensionRegistry r
       internal_static_google_cloud_retail_v2alpha_RemoveCatalogAttributeRequest_descriptor;
   static final com.google.protobuf.GeneratedMessageV3.FieldAccessorTable
       internal_static_google_cloud_retail_v2alpha_RemoveCatalogAttributeRequest_fieldAccessorTable;
+  static final com.google.protobuf.Descriptors.Descriptor
+      internal_static_google_cloud_retail_v2alpha_BatchRemoveCatalogAttributesRequest_descriptor;
+  static final com.google.protobuf.GeneratedMessageV3.FieldAccessorTable
+      internal_static_google_cloud_retail_v2alpha_BatchRemoveCatalogAttributesRequest_fieldAccessorTable;
+  static final com.google.protobuf.Descriptors.Descriptor
+      internal_static_google_cloud_retail_v2alpha_BatchRemoveCatalogAttributesResponse_descriptor;
+  static final com.google.protobuf.GeneratedMessageV3.FieldAccessorTable
+      internal_static_google_cloud_retail_v2alpha_BatchRemoveCatalogAttributesResponse_fieldAccessorTable;
   static final com.google.protobuf.Descriptors.Descriptor
       internal_static_google_cloud_retail_v2alpha_ReplaceCatalogAttributeRequest_descriptor;
   static final com.google.protobuf.GeneratedMessageV3.FieldAccessorTable
@@ -135,84 +143,98 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
           + "ributeB\003\340A\002\"|\n\035RemoveCatalogAttributeReq"
           + "uest\022I\n\021attributes_config\030\001 \001(\tB.\340A\002\372A(\n"
           + "&retail.googleapis.com/AttributesConfig\022"
-          + "\020\n\003key\030\002 \001(\tB\003\340A\002\"\353\001\n\036ReplaceCatalogAttr"
-          + "ibuteRequest\022I\n\021attributes_config\030\001 \001(\tB"
-          + ".\340A\002\372A(\n&retail.googleapis.com/Attribute"
-          + "sConfig\022M\n\021catalog_attribute\030\002 \001(\0132-.goo"
-          + "gle.cloud.retail.v2alpha.CatalogAttribut"
-          + "eB\003\340A\002\022/\n\013update_mask\030\003 \001(\0132\032.google.pro"
-          + "tobuf.FieldMask2\267\024\n\016CatalogService\022\267\001\n\014L"
-          + "istCatalogs\0220.google.cloud.retail.v2alph"
-          + "a.ListCatalogsRequest\0321.google.cloud.ret"
-          + "ail.v2alpha.ListCatalogsResponse\"B\202\323\344\223\0023"
-          + "\0221/v2alpha/{parent=projects/*/locations/"
-          + "*}/catalogs\332A\006parent\022\312\001\n\rUpdateCatalog\0221"
-          + ".google.cloud.retail.v2alpha.UpdateCatal"
-          + "ogRequest\032$.google.cloud.retail.v2alpha."
-          + "Catalog\"`\202\323\344\223\002D29/v2alpha/{catalog.name="
-          + "projects/*/locations/*/catalogs/*}:\007cata"
-          + "log\332A\023catalog,update_mask\022\274\001\n\020SetDefault"
-          + "Branch\0224.google.cloud.retail.v2alpha.Set"
-          + "DefaultBranchRequest\032\026.google.protobuf.E"
-          + "mpty\"Z\202\323\344\223\002J\"E/v2alpha/{catalog=projects"
-          + "/*/locations/*/catalogs/*}:setDefaultBra"
-          + "nch:\001*\332A\007catalog\022\330\001\n\020GetDefaultBranch\0224."
-          + "google.cloud.retail.v2alpha.GetDefaultBr"
-          + "anchRequest\0325.google.cloud.retail.v2alph"
-          + "a.GetDefaultBranchResponse\"W\202\323\344\223\002G\022E/v2a"
-          + "lpha/{catalog=projects/*/locations/*/cat"
-          + "alogs/*}:getDefaultBranch\332A\007catalog\022\320\001\n\023"
-          + "GetCompletionConfig\0227.google.cloud.retai"
-          + "l.v2alpha.GetCompletionConfigRequest\032-.g"
-          + "oogle.cloud.retail.v2alpha.CompletionCon"
-          + "fig\"Q\202\323\344\223\002D\022B/v2alpha/{name=projects/*/l"
-          + "ocations/*/catalogs/*/completionConfig}\332"
-          + "A\004name\022\225\002\n\026UpdateCompletionConfig\022:.goog"
-          + "le.cloud.retail.v2alpha.UpdateCompletion"
-          + "ConfigRequest\032-.google.cloud.retail.v2al"
-          + "pha.CompletionConfig\"\217\001\202\323\344\223\002i2T/v2alpha/"
-          + "{completion_config.name=projects/*/locat"
-          + "ions/*/catalogs/*/completionConfig}:\021com"
-          + "pletion_config\332A\035completion_config,updat"
-          + "e_mask\022\320\001\n\023GetAttributesConfig\0227.google."
-          + "cloud.retail.v2alpha.GetAttributesConfig"
-          + "Request\032-.google.cloud.retail.v2alpha.At"
-          + "tributesConfig\"Q\202\323\344\223\002D\022B/v2alpha/{name=p"
-          + "rojects/*/locations/*/catalogs/*/attribu"
-          + "tesConfig}\332A\004name\022\225\002\n\026UpdateAttributesCo"
-          + "nfig\022:.google.cloud.retail.v2alpha.Updat"
-          + "eAttributesConfigRequest\032-.google.cloud."
-          + "retail.v2alpha.AttributesConfig\"\217\001\202\323\344\223\002i"
-          + "2T/v2alpha/{attributes_config.name=proje"
-          + "cts/*/locations/*/catalogs/*/attributesC"
-          + "onfig}:\021attributes_config\332A\035attributes_c"
-          + "onfig,update_mask\022\355\001\n\023AddCatalogAttribut"
-          + "e\0227.google.cloud.retail.v2alpha.AddCatal"
-          + "ogAttributeRequest\032-.google.cloud.retail"
-          + ".v2alpha.AttributesConfig\"n\202\323\344\223\002h\"c/v2al"
-          + "pha/{attributes_config=projects/*/locati"
-          + "ons/*/catalogs/*/attributesConfig}:addCa"
-          + "talogAttribute:\001*\022\366\001\n\026RemoveCatalogAttri"
-          + "bute\022:.google.cloud.retail.v2alpha.Remov"
-          + "eCatalogAttributeRequest\032-.google.cloud."
-          + "retail.v2alpha.AttributesConfig\"q\202\323\344\223\002k\""
-          + "f/v2alpha/{attributes_config=projects/*/"
-          + "locations/*/catalogs/*/attributesConfig}"
-          + ":removeCatalogAttribute:\001*\022\371\001\n\027ReplaceCa"
-          + "talogAttribute\022;.google.cloud.retail.v2a"
-          + "lpha.ReplaceCatalogAttributeRequest\032-.go"
-          + "ogle.cloud.retail.v2alpha.AttributesConf"
-          + "ig\"r\202\323\344\223\002l\"g/v2alpha/{attributes_config="
-          + "projects/*/locations/*/catalogs/*/attrib"
-          + "utesConfig}:replaceCatalogAttribute:\001*\032I"
-          + "\312A\025retail.googleapis.com\322A.https://www.g"
-          + "oogleapis.com/auth/cloud-platformB\341\001\n\037co"
-          + "m.google.cloud.retail.v2alphaB\023CatalogSe"
-          + "rviceProtoP\001ZAgoogle.golang.org/genproto"
-          + "/googleapis/cloud/retail/v2alpha;retail\242"
-          + "\002\006RETAIL\252\002\033Google.Cloud.Retail.V2Alpha\312\002"
-          + "\033Google\\Cloud\\Retail\\V2alpha\352\002\036Google::C"
-          + "loud::Retail::V2alphab\006proto3"
+          + "\020\n\003key\030\002 \001(\tB\003\340A\002\"\215\001\n#BatchRemoveCatalog"
+          + "AttributesRequest\022I\n\021attributes_config\030\001"
+          + " \001(\tB.\340A\002\372A(\n&retail.googleapis.com/Attr"
+          + "ibutesConfig\022\033\n\016attribute_keys\030\002 \003(\tB\003\340A"
+          + "\002\"l\n$BatchRemoveCatalogAttributesRespons"
+          + "e\022\"\n\032deleted_catalog_attributes\030\001 \003(\t\022 \n"
+          + "\030reset_catalog_attributes\030\002 \003(\t\"\353\001\n\036Repl"
+          + "aceCatalogAttributeRequest\022I\n\021attributes"
+          + "_config\030\001 \001(\tB.\340A\002\372A(\n&retail.googleapis"
+          + ".com/AttributesConfig\022M\n\021catalog_attribu"
+          + "te\030\002 \001(\0132-.google.cloud.retail.v2alpha.C"
+          + "atalogAttributeB\003\340A\002\022/\n\013update_mask\030\003 \001("
+          + "\0132\032.google.protobuf.FieldMask2\326\026\n\016Catalo"
+          + "gService\022\267\001\n\014ListCatalogs\0220.google.cloud"
+          + ".retail.v2alpha.ListCatalogsRequest\0321.go"
+          + "ogle.cloud.retail.v2alpha.ListCatalogsRe"
+          + "sponse\"B\202\323\344\223\0023\0221/v2alpha/{parent=project"
+          + "s/*/locations/*}/catalogs\332A\006parent\022\312\001\n\rU"
+          + "pdateCatalog\0221.google.cloud.retail.v2alp"
+          + "ha.UpdateCatalogRequest\032$.google.cloud.r"
+          + "etail.v2alpha.Catalog\"`\202\323\344\223\002D29/v2alpha/"
+          + "{catalog.name=projects/*/locations/*/cat"
+          + "alogs/*}:\007catalog\332A\023catalog,update_mask\022"
+          + "\274\001\n\020SetDefaultBranch\0224.google.cloud.reta"
+          + "il.v2alpha.SetDefaultBranchRequest\032\026.goo"
+          + "gle.protobuf.Empty\"Z\202\323\344\223\002J\"E/v2alpha/{ca"
+          + "talog=projects/*/locations/*/catalogs/*}"
+          + ":setDefaultBranch:\001*\332A\007catalog\022\330\001\n\020GetDe"
+          + "faultBranch\0224.google.cloud.retail.v2alph"
+          + "a.GetDefaultBranchRequest\0325.google.cloud"
+          + ".retail.v2alpha.GetDefaultBranchResponse"
+          + "\"W\202\323\344\223\002G\022E/v2alpha/{catalog=projects/*/l"
+          + "ocations/*/catalogs/*}:getDefaultBranch\332"
+          + "A\007catalog\022\320\001\n\023GetCompletionConfig\0227.goog"
+          + "le.cloud.retail.v2alpha.GetCompletionCon"
+          + "figRequest\032-.google.cloud.retail.v2alpha"
+          + ".CompletionConfig\"Q\202\323\344\223\002D\022B/v2alpha/{nam"
+          + "e=projects/*/locations/*/catalogs/*/comp"
+          + "letionConfig}\332A\004name\022\225\002\n\026UpdateCompletio"
+          + "nConfig\022:.google.cloud.retail.v2alpha.Up"
+          + "dateCompletionConfigRequest\032-.google.clo"
+          + "ud.retail.v2alpha.CompletionConfig\"\217\001\202\323\344"
+          + "\223\002i2T/v2alpha/{completion_config.name=pr"
+          + "ojects/*/locations/*/catalogs/*/completi"
+          + "onConfig}:\021completion_config\332A\035completio"
+          + "n_config,update_mask\022\320\001\n\023GetAttributesCo"
+          + "nfig\0227.google.cloud.retail.v2alpha.GetAt"
+          + "tributesConfigRequest\032-.google.cloud.ret"
+          + "ail.v2alpha.AttributesConfig\"Q\202\323\344\223\002D\022B/v"
+          + "2alpha/{name=projects/*/locations/*/cata"
+          + "logs/*/attributesConfig}\332A\004name\022\225\002\n\026Upda"
+          + "teAttributesConfig\022:.google.cloud.retail"
+          + ".v2alpha.UpdateAttributesConfigRequest\032-"
+          + ".google.cloud.retail.v2alpha.AttributesC"
+          + "onfig\"\217\001\202\323\344\223\002i2T/v2alpha/{attributes_con"
+          + "fig.name=projects/*/locations/*/catalogs"
+          + "/*/attributesConfig}:\021attributes_config\332"
+          + "A\035attributes_config,update_mask\022\355\001\n\023AddC"
+          + "atalogAttribute\0227.google.cloud.retail.v2"
+          + "alpha.AddCatalogAttributeRequest\032-.googl"
+          + "e.cloud.retail.v2alpha.AttributesConfig\""
+          + "n\202\323\344\223\002h\"c/v2alpha/{attributes_config=pro"
+          + "jects/*/locations/*/catalogs/*/attribute"
+          + "sConfig}:addCatalogAttribute:\001*\022\366\001\n\026Remo"
+          + "veCatalogAttribute\022:.google.cloud.retail"
+          + ".v2alpha.RemoveCatalogAttributeRequest\032-"
+          + ".google.cloud.retail.v2alpha.AttributesC"
+          + "onfig\"q\202\323\344\223\002k\"f/v2alpha/{attributes_conf"
+          + "ig=projects/*/locations/*/catalogs/*/att"
+          + "ributesConfig}:removeCatalogAttribute:\001*"
+          + "\022\234\002\n\034BatchRemoveCatalogAttributes\022@.goog"
+          + "le.cloud.retail.v2alpha.BatchRemoveCatal"
+          + "ogAttributesRequest\032A.google.cloud.retai"
+          + "l.v2alpha.BatchRemoveCatalogAttributesRe"
+          + "sponse\"w\202\323\344\223\002q\"l/v2alpha/{attributes_con"
+          + "fig=projects/*/locations/*/catalogs/*/at"
+          + "tributesConfig}:batchRemoveCatalogAttrib"
+          + "utes:\001*\022\371\001\n\027ReplaceCatalogAttribute\022;.go"
+          + "ogle.cloud.retail.v2alpha.ReplaceCatalog"
+          + "AttributeRequest\032-.google.cloud.retail.v"
+          + "2alpha.AttributesConfig\"r\202\323\344\223\002l\"g/v2alph"
+          + "a/{attributes_config=projects/*/location"
+          + "s/*/catalogs/*/attributesConfig}:replace"
+          + "CatalogAttribute:\001*\032I\312A\025retail.googleapi"
+          + "s.com\322A.https://www.googleapis.com/auth/"
+          + "cloud-platformB\341\001\n\037com.google.cloud.reta"
+          + "il.v2alphaB\023CatalogServiceProtoP\001ZAgoogl"
+          + "e.golang.org/genproto/googleapis/cloud/r"
+          + "etail/v2alpha;retail\242\002\006RETAIL\252\002\033Google.C"
+          + "loud.Retail.V2Alpha\312\002\033Google\\Cloud\\Retai"
+          + "l\\V2alpha\352\002\036Google::Cloud::Retail::V2alp"
+          + "hab\006proto3"
     };
     descriptor =
         com.google.protobuf.Descriptors.FileDescriptor.internalBuildGeneratedFileFrom(
@@ -323,8 +345,24 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
             new java.lang.String[] {
               "AttributesConfig", "Key",
             });
-    internal_static_google_cloud_retail_v2alpha_ReplaceCatalogAttributeRequest_descriptor =
+    internal_static_google_cloud_retail_v2alpha_BatchRemoveCatalogAttributesRequest_descriptor =
         getDescriptor().getMessageTypes().get(12);
+    internal_static_google_cloud_retail_v2alpha_BatchRemoveCatalogAttributesRequest_fieldAccessorTable =
+        new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable(
+            internal_static_google_cloud_retail_v2alpha_BatchRemoveCatalogAttributesRequest_descriptor,
+            new java.lang.String[] {
+              "AttributesConfig", "AttributeKeys",
+            });
+    internal_static_google_cloud_retail_v2alpha_BatchRemoveCatalogAttributesResponse_descriptor =
+        getDescriptor().getMessageTypes().get(13);
+    internal_static_google_cloud_retail_v2alpha_BatchRemoveCatalogAttributesResponse_fieldAccessorTable =
+        new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable(
+            internal_static_google_cloud_retail_v2alpha_BatchRemoveCatalogAttributesResponse_descriptor,
+            new java.lang.String[] {
+              "DeletedCatalogAttributes", "ResetCatalogAttributes",
+            });
+    internal_static_google_cloud_retail_v2alpha_ReplaceCatalogAttributeRequest_descriptor =
+        getDescriptor().getMessageTypes().get(14);
     internal_static_google_cloud_retail_v2alpha_ReplaceCatalogAttributeRequest_fieldAccessorTable =
         new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable(
             internal_static_google_cloud_retail_v2alpha_ReplaceCatalogAttributeRequest_descriptor,
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/CollectUserEventRequest.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/CollectUserEventRequest.java
index f96c2fc049a1..40091c0492b3 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/CollectUserEventRequest.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/CollectUserEventRequest.java
@@ -41,6 +41,7 @@ private CollectUserEventRequest() {
     parent_ = "";
     userEvent_ = "";
     uri_ = "";
+    rawJson_ = "";
   }
 
   @java.lang.Override
@@ -69,6 +70,123 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
             com.google.cloud.retail.v2alpha.CollectUserEventRequest.Builder.class);
   }
 
+  private int conversionRuleCase_ = 0;
+  private java.lang.Object conversionRule_;
+
+  public enum ConversionRuleCase
+      implements
+          com.google.protobuf.Internal.EnumLite,
+          com.google.protobuf.AbstractMessage.InternalOneOfEnum {
+    PREBUILT_RULE(6),
+    CONVERSIONRULE_NOT_SET(0);
+    private final int value;
+
+    private ConversionRuleCase(int value) {
+      this.value = value;
+    }
+    /**
+     * @param value The number of the enum to look for.
+     * @return The enum associated with the given number.
+     * @deprecated Use {@link #forNumber(int)} instead.
+     */
+    @java.lang.Deprecated
+    public static ConversionRuleCase valueOf(int value) {
+      return forNumber(value);
+    }
+
+    public static ConversionRuleCase forNumber(int value) {
+      switch (value) {
+        case 6:
+          return PREBUILT_RULE;
+        case 0:
+          return CONVERSIONRULE_NOT_SET;
+        default:
+          return null;
+      }
+    }
+
+    public int getNumber() {
+      return this.value;
+    }
+  };
+
+  public ConversionRuleCase getConversionRuleCase() {
+    return ConversionRuleCase.forNumber(conversionRuleCase_);
+  }
+
+  public static final int PREBUILT_RULE_FIELD_NUMBER = 6;
+  /**
+   *
+   *
+   * 
      +   * The prebuilt rule name that can convert a specific type of raw_json.
+   * For example: "default_schema/v1.0"
+   * 
      
+   *
+   * string prebuilt_rule = 6;
+   *
+   * @return Whether the prebuiltRule field is set.
+   */
+  public boolean hasPrebuiltRule() {
+    return conversionRuleCase_ == 6;
+  }
+  /**
+   *
+   *
+   * 
      +   * The prebuilt rule name that can convert a specific type of raw_json.
+   * For example: "default_schema/v1.0"
+   * 
      
+   *
+   * string prebuilt_rule = 6;
+   *
+   * @return The prebuiltRule.
+   */
+  public java.lang.String getPrebuiltRule() {
+    java.lang.Object ref = "";
+    if (conversionRuleCase_ == 6) {
+      ref = conversionRule_;
+    }
+    if (ref instanceof java.lang.String) {
+      return (java.lang.String) ref;
+    } else {
+      com.google.protobuf.ByteString bs = (com.google.protobuf.ByteString) ref;
+      java.lang.String s = bs.toStringUtf8();
+      if (conversionRuleCase_ == 6) {
+        conversionRule_ = s;
+      }
+      return s;
+    }
+  }
+  /**
+   *
+   *
+   * 
      +   * The prebuilt rule name that can convert a specific type of raw_json.
+   * For example: "default_schema/v1.0"
+   * 
      
+   *
+   * string prebuilt_rule = 6;
+   *
+   * @return The bytes for prebuiltRule.
+   */
+  public com.google.protobuf.ByteString getPrebuiltRuleBytes() {
+    java.lang.Object ref = "";
+    if (conversionRuleCase_ == 6) {
+      ref = conversionRule_;
+    }
+    if (ref instanceof java.lang.String) {
+      com.google.protobuf.ByteString b =
+          com.google.protobuf.ByteString.copyFromUtf8((java.lang.String) ref);
+      if (conversionRuleCase_ == 6) {
+        conversionRule_ = b;
+      }
+      return b;
+    } else {
+      return (com.google.protobuf.ByteString) ref;
+    }
+  }
+
   public static final int PARENT_FIELD_NUMBER = 1;
   private volatile java.lang.Object parent_;
   /**
@@ -246,6 +364,61 @@ public long getEts() {
     return ets_;
   }
 
+  public static final int RAW_JSON_FIELD_NUMBER = 5;
+  private volatile java.lang.Object rawJson_;
+  /**
+   *
+   *
+   * 
      +   * An arbitrary serialized JSON string that contains necessary information
+   * that can comprise a user event. When this field is specified, the
+   * user_event field will be ignored. Note: line-delimited JSON is not
+   * supported, a single JSON only.
+   * 
      
+   *
+   * string raw_json = 5;
+   *
+   * @return The rawJson.
+   */
+  @java.lang.Override
+  public java.lang.String getRawJson() {
+    java.lang.Object ref = rawJson_;
+    if (ref instanceof java.lang.String) {
+      return (java.lang.String) ref;
+    } else {
+      com.google.protobuf.ByteString bs = (com.google.protobuf.ByteString) ref;
+      java.lang.String s = bs.toStringUtf8();
+      rawJson_ = s;
+      return s;
+    }
+  }
+  /**
+   *
+   *
+   * 
      +   * An arbitrary serialized JSON string that contains necessary information
+   * that can comprise a user event. When this field is specified, the
+   * user_event field will be ignored. Note: line-delimited JSON is not
+   * supported, a single JSON only.
+   * 
      
+   *
+   * string raw_json = 5;
+   *
+   * @return The bytes for rawJson.
+   */
+  @java.lang.Override
+  public com.google.protobuf.ByteString getRawJsonBytes() {
+    java.lang.Object ref = rawJson_;
+    if (ref instanceof java.lang.String) {
+      com.google.protobuf.ByteString b =
+          com.google.protobuf.ByteString.copyFromUtf8((java.lang.String) ref);
+      rawJson_ = b;
+      return b;
+    } else {
+      return (com.google.protobuf.ByteString) ref;
+    }
+  }
+
   private byte memoizedIsInitialized = -1;
 
   @java.lang.Override
@@ -272,6 +445,12 @@ public void writeTo(com.google.protobuf.CodedOutputStream output) throws java.io
     if (ets_ != 0L) {
       output.writeInt64(4, ets_);
     }
+    if (!com.google.protobuf.GeneratedMessageV3.isStringEmpty(rawJson_)) {
+      com.google.protobuf.GeneratedMessageV3.writeString(output, 5, rawJson_);
+    }
+    if (conversionRuleCase_ == 6) {
+      com.google.protobuf.GeneratedMessageV3.writeString(output, 6, conversionRule_);
+    }
     getUnknownFields().writeTo(output);
   }
 
@@ -293,6 +472,12 @@ public int getSerializedSize() {
     if (ets_ != 0L) {
       size += com.google.protobuf.CodedOutputStream.computeInt64Size(4, ets_);
     }
+    if (!com.google.protobuf.GeneratedMessageV3.isStringEmpty(rawJson_)) {
+      size += com.google.protobuf.GeneratedMessageV3.computeStringSize(5, rawJson_);
+    }
+    if (conversionRuleCase_ == 6) {
+      size += com.google.protobuf.GeneratedMessageV3.computeStringSize(6, conversionRule_);
+    }
     size += getUnknownFields().getSerializedSize();
     memoizedSize = size;
     return size;
@@ -313,6 +498,15 @@ public boolean equals(final java.lang.Object obj) {
     if (!getUserEvent().equals(other.getUserEvent())) return false;
     if (!getUri().equals(other.getUri())) return false;
     if (getEts() != other.getEts()) return false;
+    if (!getRawJson().equals(other.getRawJson())) return false;
+    if (!getConversionRuleCase().equals(other.getConversionRuleCase())) return false;
+    switch (conversionRuleCase_) {
+      case 6:
+        if (!getPrebuiltRule().equals(other.getPrebuiltRule())) return false;
+        break;
+      case 0:
+      default:
+    }
     if (!getUnknownFields().equals(other.getUnknownFields())) return false;
     return true;
   }
@@ -332,6 +526,16 @@ public int hashCode() {
     hash = (53 * hash) + getUri().hashCode();
     hash = (37 * hash) + ETS_FIELD_NUMBER;
     hash = (53 * hash) + com.google.protobuf.Internal.hashLong(getEts());
+    hash = (37 * hash) + RAW_JSON_FIELD_NUMBER;
+    hash = (53 * hash) + getRawJson().hashCode();
+    switch (conversionRuleCase_) {
+      case 6:
+        hash = (37 * hash) + PREBUILT_RULE_FIELD_NUMBER;
+        hash = (53 * hash) + getPrebuiltRule().hashCode();
+        break;
+      case 0:
+      default:
+    }
     hash = (29 * hash) + getUnknownFields().hashCode();
     memoizedHashCode = hash;
     return hash;
@@ -479,6 +683,10 @@ public Builder clear() {
 
       ets_ = 0L;
 
+      rawJson_ = "";
+
+      conversionRuleCase_ = 0;
+      conversionRule_ = null;
       return this;
     }
 
@@ -506,10 +714,15 @@ public com.google.cloud.retail.v2alpha.CollectUserEventRequest build() {
     public com.google.cloud.retail.v2alpha.CollectUserEventRequest buildPartial() {
       com.google.cloud.retail.v2alpha.CollectUserEventRequest result =
           new com.google.cloud.retail.v2alpha.CollectUserEventRequest(this);
+      if (conversionRuleCase_ == 6) {
+        result.conversionRule_ = conversionRule_;
+      }
       result.parent_ = parent_;
       result.userEvent_ = userEvent_;
       result.uri_ = uri_;
       result.ets_ = ets_;
+      result.rawJson_ = rawJson_;
+      result.conversionRuleCase_ = conversionRuleCase_;
       onBuilt();
       return result;
     }
@@ -575,6 +788,23 @@ public Builder mergeFrom(com.google.cloud.retail.v2alpha.CollectUserEventRequest
       if (other.getEts() != 0L) {
         setEts(other.getEts());
       }
+      if (!other.getRawJson().isEmpty()) {
+        rawJson_ = other.rawJson_;
+        onChanged();
+      }
+      switch (other.getConversionRuleCase()) {
+        case PREBUILT_RULE:
+          {
+            conversionRuleCase_ = 6;
+            conversionRule_ = other.conversionRule_;
+            onChanged();
+            break;
+          }
+        case CONVERSIONRULE_NOT_SET:
+          {
+            break;
+          }
+      }
       this.mergeUnknownFields(other.getUnknownFields());
       onChanged();
       return this;
@@ -625,6 +855,19 @@ public Builder mergeFrom(
 
                 break;
               } // case 32
+            case 42:
+              {
+                rawJson_ = input.readStringRequireUtf8();
+
+                break;
+              } // case 42
+            case 50:
+              {
+                java.lang.String s = input.readStringRequireUtf8();
+                conversionRuleCase_ = 6;
+                conversionRule_ = s;
+                break;
+              } // case 50
             default:
               {
                 if (!super.parseUnknownField(input, extensionRegistry, tag)) {
@@ -642,6 +885,160 @@ public Builder mergeFrom(
       return this;
     }
 
+    private int conversionRuleCase_ = 0;
+    private java.lang.Object conversionRule_;
+
+    public ConversionRuleCase getConversionRuleCase() {
+      return ConversionRuleCase.forNumber(conversionRuleCase_);
+    }
+
+    public Builder clearConversionRule() {
+      conversionRuleCase_ = 0;
+      conversionRule_ = null;
+      onChanged();
+      return this;
+    }
+
+    /**
+     *
+     *
+     * 
      +     * The prebuilt rule name that can convert a specific type of raw_json.
+     * For example: "default_schema/v1.0"
+     * 
      
+     *
+     * string prebuilt_rule = 6;
+     *
+     * @return Whether the prebuiltRule field is set.
+     */
+    @java.lang.Override
+    public boolean hasPrebuiltRule() {
+      return conversionRuleCase_ == 6;
+    }
+    /**
+     *
+     *
+     * 
      +     * The prebuilt rule name that can convert a specific type of raw_json.
+     * For example: "default_schema/v1.0"
+     * 
      
+     *
+     * string prebuilt_rule = 6;
+     *
+     * @return The prebuiltRule.
+     */
+    @java.lang.Override
+    public java.lang.String getPrebuiltRule() {
+      java.lang.Object ref = "";
+      if (conversionRuleCase_ == 6) {
+        ref = conversionRule_;
+      }
+      if (!(ref instanceof java.lang.String)) {
+        com.google.protobuf.ByteString bs = (com.google.protobuf.ByteString) ref;
+        java.lang.String s = bs.toStringUtf8();
+        if (conversionRuleCase_ == 6) {
+          conversionRule_ = s;
+        }
+        return s;
+      } else {
+        return (java.lang.String) ref;
+      }
+    }
+    /**
+     *
+     *
+     * 
      +     * The prebuilt rule name that can convert a specific type of raw_json.
+     * For example: "default_schema/v1.0"
+     * 
      
+     *
+     * string prebuilt_rule = 6;
+     *
+     * @return The bytes for prebuiltRule.
+     */
+    @java.lang.Override
+    public com.google.protobuf.ByteString getPrebuiltRuleBytes() {
+      java.lang.Object ref = "";
+      if (conversionRuleCase_ == 6) {
+        ref = conversionRule_;
+      }
+      if (ref instanceof String) {
+        com.google.protobuf.ByteString b =
+            com.google.protobuf.ByteString.copyFromUtf8((java.lang.String) ref);
+        if (conversionRuleCase_ == 6) {
+          conversionRule_ = b;
+        }
+        return b;
+      } else {
+        return (com.google.protobuf.ByteString) ref;
+      }
+    }
+    /**
+     *
+     *
+     * 
      +     * The prebuilt rule name that can convert a specific type of raw_json.
+     * For example: "default_schema/v1.0"
+     * 
      
+     *
+     * string prebuilt_rule = 6;
+     *
+     * @param value The prebuiltRule to set.
+     * @return This builder for chaining.
+     */
+    public Builder setPrebuiltRule(java.lang.String value) {
+      if (value == null) {
+        throw new NullPointerException();
+      }
+      conversionRuleCase_ = 6;
+      conversionRule_ = value;
+      onChanged();
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * The prebuilt rule name that can convert a specific type of raw_json.
+     * For example: "default_schema/v1.0"
+     * 
      
+     *
+     * string prebuilt_rule = 6;
+     *
+     * @return This builder for chaining.
+     */
+    public Builder clearPrebuiltRule() {
+      if (conversionRuleCase_ == 6) {
+        conversionRuleCase_ = 0;
+        conversionRule_ = null;
+        onChanged();
+      }
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * The prebuilt rule name that can convert a specific type of raw_json.
+     * For example: "default_schema/v1.0"
+     * 
      
+     *
+     * string prebuilt_rule = 6;
+     *
+     * @param value The bytes for prebuiltRule to set.
+     * @return This builder for chaining.
+     */
+    public Builder setPrebuiltRuleBytes(com.google.protobuf.ByteString value) {
+      if (value == null) {
+        throw new NullPointerException();
+      }
+      checkByteStringIsUtf8(value);
+      conversionRuleCase_ = 6;
+      conversionRule_ = value;
+      onChanged();
+      return this;
+    }
+
     private java.lang.Object parent_ = "";
     /**
      *
@@ -1043,6 +1440,127 @@ public Builder clearEts() {
       return this;
     }
 
+    private java.lang.Object rawJson_ = "";
+    /**
+     *
+     *
+     * 
      +     * An arbitrary serialized JSON string that contains necessary information
+     * that can comprise a user event. When this field is specified, the
+     * user_event field will be ignored. Note: line-delimited JSON is not
+     * supported, a single JSON only.
+     * 
      
+     *
+     * string raw_json = 5;
+     *
+     * @return The rawJson.
+     */
+    public java.lang.String getRawJson() {
+      java.lang.Object ref = rawJson_;
+      if (!(ref instanceof java.lang.String)) {
+        com.google.protobuf.ByteString bs = (com.google.protobuf.ByteString) ref;
+        java.lang.String s = bs.toStringUtf8();
+        rawJson_ = s;
+        return s;
+      } else {
+        return (java.lang.String) ref;
+      }
+    }
+    /**
+     *
+     *
+     * 
      +     * An arbitrary serialized JSON string that contains necessary information
+     * that can comprise a user event. When this field is specified, the
+     * user_event field will be ignored. Note: line-delimited JSON is not
+     * supported, a single JSON only.
+     * 
      
+     *
+     * string raw_json = 5;
+     *
+     * @return The bytes for rawJson.
+     */
+    public com.google.protobuf.ByteString getRawJsonBytes() {
+      java.lang.Object ref = rawJson_;
+      if (ref instanceof String) {
+        com.google.protobuf.ByteString b =
+            com.google.protobuf.ByteString.copyFromUtf8((java.lang.String) ref);
+        rawJson_ = b;
+        return b;
+      } else {
+        return (com.google.protobuf.ByteString) ref;
+      }
+    }
+    /**
+     *
+     *
+     * 
      +     * An arbitrary serialized JSON string that contains necessary information
+     * that can comprise a user event. When this field is specified, the
+     * user_event field will be ignored. Note: line-delimited JSON is not
+     * supported, a single JSON only.
+     * 
      
+     *
+     * string raw_json = 5;
+     *
+     * @param value The rawJson to set.
+     * @return This builder for chaining.
+     */
+    public Builder setRawJson(java.lang.String value) {
+      if (value == null) {
+        throw new NullPointerException();
+      }
+
+      rawJson_ = value;
+      onChanged();
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * An arbitrary serialized JSON string that contains necessary information
+     * that can comprise a user event. When this field is specified, the
+     * user_event field will be ignored. Note: line-delimited JSON is not
+     * supported, a single JSON only.
+     * 
      
+     *
+     * string raw_json = 5;
+     *
+     * @return This builder for chaining.
+     */
+    public Builder clearRawJson() {
+
+      rawJson_ = getDefaultInstance().getRawJson();
+      onChanged();
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * An arbitrary serialized JSON string that contains necessary information
+     * that can comprise a user event. When this field is specified, the
+     * user_event field will be ignored. Note: line-delimited JSON is not
+     * supported, a single JSON only.
+     * 
      
+     *
+     * string raw_json = 5;
+     *
+     * @param value The bytes for rawJson to set.
+     * @return This builder for chaining.
+     */
+    public Builder setRawJsonBytes(com.google.protobuf.ByteString value) {
+      if (value == null) {
+        throw new NullPointerException();
+      }
+      checkByteStringIsUtf8(value);
+
+      rawJson_ = value;
+      onChanged();
+      return this;
+    }
+
     @java.lang.Override
     public final Builder setUnknownFields(final com.google.protobuf.UnknownFieldSet unknownFields) {
       return super.setUnknownFields(unknownFields);
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/CollectUserEventRequestOrBuilder.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/CollectUserEventRequestOrBuilder.java
index 4122ae5d6a22..93f003071700 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/CollectUserEventRequestOrBuilder.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/CollectUserEventRequestOrBuilder.java
@@ -23,6 +23,46 @@ public interface CollectUserEventRequestOrBuilder
     // @@protoc_insertion_point(interface_extends:google.cloud.retail.v2alpha.CollectUserEventRequest)
     com.google.protobuf.MessageOrBuilder {
 
+  /**
+   *
+   *
+   * 
      +   * The prebuilt rule name that can convert a specific type of raw_json.
+   * For example: "default_schema/v1.0"
+   * 
      
+   *
+   * string prebuilt_rule = 6;
+   *
+   * @return Whether the prebuiltRule field is set.
+   */
+  boolean hasPrebuiltRule();
+  /**
+   *
+   *
+   * 
      +   * The prebuilt rule name that can convert a specific type of raw_json.
+   * For example: "default_schema/v1.0"
+   * 
      
+   *
+   * string prebuilt_rule = 6;
+   *
+   * @return The prebuiltRule.
+   */
+  java.lang.String getPrebuiltRule();
+  /**
+   *
+   *
+   * 
      +   * The prebuilt rule name that can convert a specific type of raw_json.
+   * For example: "default_schema/v1.0"
+   * 
      
+   *
+   * string prebuilt_rule = 6;
+   *
+   * @return The bytes for prebuiltRule.
+   */
+  com.google.protobuf.ByteString getPrebuiltRuleBytes();
+
   /**
    *
    *
@@ -122,4 +162,38 @@ public interface CollectUserEventRequestOrBuilder
    * @return The ets.
    */
   long getEts();
+
+  /**
+   *
+   *
+   * 
      +   * An arbitrary serialized JSON string that contains necessary information
+   * that can comprise a user event. When this field is specified, the
+   * user_event field will be ignored. Note: line-delimited JSON is not
+   * supported, a single JSON only.
+   * 
      
+   *
+   * string raw_json = 5;
+   *
+   * @return The rawJson.
+   */
+  java.lang.String getRawJson();
+  /**
+   *
+   *
+   * 
      +   * An arbitrary serialized JSON string that contains necessary information
+   * that can comprise a user event. When this field is specified, the
+   * user_event field will be ignored. Note: line-delimited JSON is not
+   * supported, a single JSON only.
+   * 
      
+   *
+   * string raw_json = 5;
+   *
+   * @return The bytes for rawJson.
+   */
+  com.google.protobuf.ByteString getRawJsonBytes();
+
+  public com.google.cloud.retail.v2alpha.CollectUserEventRequest.ConversionRuleCase
+      getConversionRuleCase();
 }
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/CompleteQueryRequest.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/CompleteQueryRequest.java
index 3d788e9e1ef8..20f1d99b2599 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/CompleteQueryRequest.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/CompleteQueryRequest.java
@@ -334,8 +334,9 @@ public com.google.protobuf.ByteString getLanguageCodesBytes(int index) {
    *
    *
    * 
      -   * The device type context for completion suggestions.
-   * It is useful to apply different suggestions on different device types, e.g.
+   * The device type context for completion suggestions. We recommend that you
+   * leave this field empty.
+   * It can apply different suggestions on different device types, e.g.
    * `DESKTOP`, `MOBILE`. If it is empty, the suggestions are across all device
    * types.
    * Supported formats:
@@ -365,8 +366,9 @@ public java.lang.String getDeviceType() {
    *
    *
    * 
      -   * The device type context for completion suggestions.
-   * It is useful to apply different suggestions on different device types, e.g.
+   * The device type context for completion suggestions. We recommend that you
+   * leave this field empty.
+   * It can apply different suggestions on different device types, e.g.
    * `DESKTOP`, `MOBILE`. If it is empty, the suggestions are across all device
    * types.
    * Supported formats:
@@ -482,6 +484,25 @@ public int getMaxSuggestions() {
     return maxSuggestions_;
   }
 
+  public static final int ENABLE_ATTRIBUTE_SUGGESTIONS_FIELD_NUMBER = 9;
+  private boolean enableAttributeSuggestions_;
+  /**
+   *
+   *
+   * 
      +   * If true, attribute suggestions are enabled and provided in response.
+   * This field is only available for "cloud-retail" dataset.
+   * 
      
+   *
+   * bool enable_attribute_suggestions = 9;
+   *
+   * @return The enableAttributeSuggestions.
+   */
+  @java.lang.Override
+  public boolean getEnableAttributeSuggestions() {
+    return enableAttributeSuggestions_;
+  }
+
   private byte memoizedIsInitialized = -1;
 
   @java.lang.Override
@@ -517,6 +538,9 @@ public void writeTo(com.google.protobuf.CodedOutputStream output) throws java.io
     if (!com.google.protobuf.GeneratedMessageV3.isStringEmpty(visitorId_)) {
       com.google.protobuf.GeneratedMessageV3.writeString(output, 7, visitorId_);
     }
+    if (enableAttributeSuggestions_ != false) {
+      output.writeBool(9, enableAttributeSuggestions_);
+    }
     getUnknownFields().writeTo(output);
   }
 
@@ -552,6 +576,9 @@ public int getSerializedSize() {
     if (!com.google.protobuf.GeneratedMessageV3.isStringEmpty(visitorId_)) {
       size += com.google.protobuf.GeneratedMessageV3.computeStringSize(7, visitorId_);
     }
+    if (enableAttributeSuggestions_ != false) {
+      size += com.google.protobuf.CodedOutputStream.computeBoolSize(9, enableAttributeSuggestions_);
+    }
     size += getUnknownFields().getSerializedSize();
     memoizedSize = size;
     return size;
@@ -575,6 +602,7 @@ public boolean equals(final java.lang.Object obj) {
     if (!getDeviceType().equals(other.getDeviceType())) return false;
     if (!getDataset().equals(other.getDataset())) return false;
     if (getMaxSuggestions() != other.getMaxSuggestions()) return false;
+    if (getEnableAttributeSuggestions() != other.getEnableAttributeSuggestions()) return false;
     if (!getUnknownFields().equals(other.getUnknownFields())) return false;
     return true;
   }
@@ -602,6 +630,8 @@ public int hashCode() {
     hash = (53 * hash) + getDataset().hashCode();
     hash = (37 * hash) + MAX_SUGGESTIONS_FIELD_NUMBER;
     hash = (53 * hash) + getMaxSuggestions();
+    hash = (37 * hash) + ENABLE_ATTRIBUTE_SUGGESTIONS_FIELD_NUMBER;
+    hash = (53 * hash) + com.google.protobuf.Internal.hashBoolean(getEnableAttributeSuggestions());
     hash = (29 * hash) + getUnknownFields().hashCode();
     memoizedHashCode = hash;
     return hash;
@@ -754,6 +784,8 @@ public Builder clear() {
 
       maxSuggestions_ = 0;
 
+      enableAttributeSuggestions_ = false;
+
       return this;
     }
 
@@ -793,6 +825,7 @@ public com.google.cloud.retail.v2alpha.CompleteQueryRequest buildPartial() {
       result.deviceType_ = deviceType_;
       result.dataset_ = dataset_;
       result.maxSuggestions_ = maxSuggestions_;
+      result.enableAttributeSuggestions_ = enableAttributeSuggestions_;
       onBuilt();
       return result;
     }
@@ -876,6 +909,9 @@ public Builder mergeFrom(com.google.cloud.retail.v2alpha.CompleteQueryRequest ot
       if (other.getMaxSuggestions() != 0) {
         setMaxSuggestions(other.getMaxSuggestions());
       }
+      if (other.getEnableAttributeSuggestions() != false) {
+        setEnableAttributeSuggestions(other.getEnableAttributeSuggestions());
+      }
       this.mergeUnknownFields(other.getUnknownFields());
       onChanged();
       return this;
@@ -945,6 +981,12 @@ public Builder mergeFrom(
 
                 break;
               } // case 58
+            case 72:
+              {
+                enableAttributeSuggestions_ = input.readBool();
+
+                break;
+              } // case 72
             default:
               {
                 if (!super.parseUnknownField(input, extensionRegistry, tag)) {
@@ -1568,8 +1610,9 @@ public Builder addLanguageCodesBytes(com.google.protobuf.ByteString value) {
      *
      *
      * 
      -     * The device type context for completion suggestions.
-     * It is useful to apply different suggestions on different device types, e.g.
+     * The device type context for completion suggestions. We recommend that you
+     * leave this field empty.
+     * It can apply different suggestions on different device types, e.g.
      * `DESKTOP`, `MOBILE`. If it is empty, the suggestions are across all device
      * types.
      * Supported formats:
@@ -1598,8 +1641,9 @@ public java.lang.String getDeviceType() {
      *
      *
      * 
      -     * The device type context for completion suggestions.
-     * It is useful to apply different suggestions on different device types, e.g.
+     * The device type context for completion suggestions. We recommend that you
+     * leave this field empty.
+     * It can apply different suggestions on different device types, e.g.
      * `DESKTOP`, `MOBILE`. If it is empty, the suggestions are across all device
      * types.
      * Supported formats:
@@ -1628,8 +1672,9 @@ public com.google.protobuf.ByteString getDeviceTypeBytes() {
      *
      *
      * 
      -     * The device type context for completion suggestions.
-     * It is useful to apply different suggestions on different device types, e.g.
+     * The device type context for completion suggestions. We recommend that you
+     * leave this field empty.
+     * It can apply different suggestions on different device types, e.g.
      * `DESKTOP`, `MOBILE`. If it is empty, the suggestions are across all device
      * types.
      * Supported formats:
@@ -1657,8 +1702,9 @@ public Builder setDeviceType(java.lang.String value) {
      *
      *
      * 
      -     * The device type context for completion suggestions.
-     * It is useful to apply different suggestions on different device types, e.g.
+     * The device type context for completion suggestions. We recommend that you
+     * leave this field empty.
+     * It can apply different suggestions on different device types, e.g.
      * `DESKTOP`, `MOBILE`. If it is empty, the suggestions are across all device
      * types.
      * Supported formats:
@@ -1682,8 +1728,9 @@ public Builder clearDeviceType() {
      *
      *
      * 
      -     * The device type context for completion suggestions.
-     * It is useful to apply different suggestions on different device types, e.g.
+     * The device type context for completion suggestions. We recommend that you
+     * leave this field empty.
+     * It can apply different suggestions on different device types, e.g.
      * `DESKTOP`, `MOBILE`. If it is empty, the suggestions are across all device
      * types.
      * Supported formats:
@@ -1924,6 +1971,61 @@ public Builder clearMaxSuggestions() {
       return this;
     }
 
+    private boolean enableAttributeSuggestions_;
+    /**
+     *
+     *
+     * 
      +     * If true, attribute suggestions are enabled and provided in response.
+     * This field is only available for "cloud-retail" dataset.
+     * 
      
+     *
+     * bool enable_attribute_suggestions = 9;
+     *
+     * @return The enableAttributeSuggestions.
+     */
+    @java.lang.Override
+    public boolean getEnableAttributeSuggestions() {
+      return enableAttributeSuggestions_;
+    }
+    /**
+     *
+     *
+     * 
      +     * If true, attribute suggestions are enabled and provided in response.
+     * This field is only available for "cloud-retail" dataset.
+     * 
      
+     *
+     * bool enable_attribute_suggestions = 9;
+     *
+     * @param value The enableAttributeSuggestions to set.
+     * @return This builder for chaining.
+     */
+    public Builder setEnableAttributeSuggestions(boolean value) {
+
+      enableAttributeSuggestions_ = value;
+      onChanged();
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * If true, attribute suggestions are enabled and provided in response.
+     * This field is only available for "cloud-retail" dataset.
+     * 
      
+     *
+     * bool enable_attribute_suggestions = 9;
+     *
+     * @return This builder for chaining.
+     */
+    public Builder clearEnableAttributeSuggestions() {
+
+      enableAttributeSuggestions_ = false;
+      onChanged();
+      return this;
+    }
+
     @java.lang.Override
     public final Builder setUnknownFields(final com.google.protobuf.UnknownFieldSet unknownFields) {
       return super.setUnknownFields(unknownFields);
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/CompleteQueryRequestOrBuilder.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/CompleteQueryRequestOrBuilder.java
index a1918443d328..d116e6103834 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/CompleteQueryRequestOrBuilder.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/CompleteQueryRequestOrBuilder.java
@@ -201,8 +201,9 @@ public interface CompleteQueryRequestOrBuilder
    *
    *
    * 
      -   * The device type context for completion suggestions.
-   * It is useful to apply different suggestions on different device types, e.g.
+   * The device type context for completion suggestions. We recommend that you
+   * leave this field empty.
+   * It can apply different suggestions on different device types, e.g.
    * `DESKTOP`, `MOBILE`. If it is empty, the suggestions are across all device
    * types.
    * Supported formats:
@@ -221,8 +222,9 @@ public interface CompleteQueryRequestOrBuilder
    *
    *
    * 
      -   * The device type context for completion suggestions.
-   * It is useful to apply different suggestions on different device types, e.g.
+   * The device type context for completion suggestions. We recommend that you
+   * leave this field empty.
+   * It can apply different suggestions on different device types, e.g.
    * `DESKTOP`, `MOBILE`. If it is empty, the suggestions are across all device
    * types.
    * Supported formats:
@@ -297,4 +299,18 @@ public interface CompleteQueryRequestOrBuilder
    * @return The maxSuggestions.
    */
   int getMaxSuggestions();
+
+  /**
+   *
+   *
+   * 
      +   * If true, attribute suggestions are enabled and provided in response.
+   * This field is only available for "cloud-retail" dataset.
+   * 
      
+   *
+   * bool enable_attribute_suggestions = 9;
+   *
+   * @return The enableAttributeSuggestions.
+   */
+  boolean getEnableAttributeSuggestions();
 }
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/CompleteQueryResponse.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/CompleteQueryResponse.java
index 7da6edc217c3..c81ce0d1c021 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/CompleteQueryResponse.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/CompleteQueryResponse.java
@@ -59,6 +59,17 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
         .internal_static_google_cloud_retail_v2alpha_CompleteQueryResponse_descriptor;
   }
 
+  @SuppressWarnings({"rawtypes"})
+  @java.lang.Override
+  protected com.google.protobuf.MapField internalGetMapField(int number) {
+    switch (number) {
+      case 4:
+        return internalGetAttributeResults();
+      default:
+        throw new RuntimeException("Invalid map field number: " + number);
+    }
+  }
+
   @java.lang.Override
   protected com.google.protobuf.GeneratedMessageV3.FieldAccessorTable
       internalGetFieldAccessorTable() {
@@ -1745,42 +1756,810 @@ public java.lang.String getRecentSearch() {
        *
        *
        * 
      -       * The recent search query.
+       * The recent search query.
+       * 
      
+       *
+       * string recent_search = 1;
+       *
+       * @return The bytes for recentSearch.
+       */
+      public com.google.protobuf.ByteString getRecentSearchBytes() {
+        java.lang.Object ref = recentSearch_;
+        if (ref instanceof String) {
+          com.google.protobuf.ByteString b =
+              com.google.protobuf.ByteString.copyFromUtf8((java.lang.String) ref);
+          recentSearch_ = b;
+          return b;
+        } else {
+          return (com.google.protobuf.ByteString) ref;
+        }
+      }
+      /**
+       *
+       *
+       * 
      +       * The recent search query.
+       * 
      
+       *
+       * string recent_search = 1;
+       *
+       * @param value The recentSearch to set.
+       * @return This builder for chaining.
+       */
+      public Builder setRecentSearch(java.lang.String value) {
+        if (value == null) {
+          throw new NullPointerException();
+        }
+
+        recentSearch_ = value;
+        onChanged();
+        return this;
+      }
+      /**
+       *
+       *
+       * 
      +       * The recent search query.
+       * 
      
+       *
+       * string recent_search = 1;
+       *
+       * @return This builder for chaining.
+       */
+      public Builder clearRecentSearch() {
+
+        recentSearch_ = getDefaultInstance().getRecentSearch();
+        onChanged();
+        return this;
+      }
+      /**
+       *
+       *
+       * 
      +       * The recent search query.
+       * 
      
+       *
+       * string recent_search = 1;
+       *
+       * @param value The bytes for recentSearch to set.
+       * @return This builder for chaining.
+       */
+      public Builder setRecentSearchBytes(com.google.protobuf.ByteString value) {
+        if (value == null) {
+          throw new NullPointerException();
+        }
+        checkByteStringIsUtf8(value);
+
+        recentSearch_ = value;
+        onChanged();
+        return this;
+      }
+
+      @java.lang.Override
+      public final Builder setUnknownFields(
+          final com.google.protobuf.UnknownFieldSet unknownFields) {
+        return super.setUnknownFields(unknownFields);
+      }
+
+      @java.lang.Override
+      public final Builder mergeUnknownFields(
+          final com.google.protobuf.UnknownFieldSet unknownFields) {
+        return super.mergeUnknownFields(unknownFields);
+      }
+
+      // @@protoc_insertion_point(builder_scope:google.cloud.retail.v2alpha.CompleteQueryResponse.RecentSearchResult)
+    }
+
+    // @@protoc_insertion_point(class_scope:google.cloud.retail.v2alpha.CompleteQueryResponse.RecentSearchResult)
+    private static final com.google.cloud.retail.v2alpha.CompleteQueryResponse.RecentSearchResult
+        DEFAULT_INSTANCE;
+
+    static {
+      DEFAULT_INSTANCE =
+          new com.google.cloud.retail.v2alpha.CompleteQueryResponse.RecentSearchResult();
+    }
+
+    public static com.google.cloud.retail.v2alpha.CompleteQueryResponse.RecentSearchResult
+        getDefaultInstance() {
+      return DEFAULT_INSTANCE;
+    }
+
+    private static final com.google.protobuf.Parser PARSER =
+        new com.google.protobuf.AbstractParser() {
+          @java.lang.Override
+          public RecentSearchResult parsePartialFrom(
+              com.google.protobuf.CodedInputStream input,
+              com.google.protobuf.ExtensionRegistryLite extensionRegistry)
+              throws com.google.protobuf.InvalidProtocolBufferException {
+            Builder builder = newBuilder();
+            try {
+              builder.mergeFrom(input, extensionRegistry);
+            } catch (com.google.protobuf.InvalidProtocolBufferException e) {
+              throw e.setUnfinishedMessage(builder.buildPartial());
+            } catch (com.google.protobuf.UninitializedMessageException e) {
+              throw e.asInvalidProtocolBufferException()
+                  .setUnfinishedMessage(builder.buildPartial());
+            } catch (java.io.IOException e) {
+              throw new com.google.protobuf.InvalidProtocolBufferException(e)
+                  .setUnfinishedMessage(builder.buildPartial());
+            }
+            return builder.buildPartial();
+          }
+        };
+
+    public static com.google.protobuf.Parser parser() {
+      return PARSER;
+    }
+
+    @java.lang.Override
+    public com.google.protobuf.Parser getParserForType() {
+      return PARSER;
+    }
+
+    @java.lang.Override
+    public com.google.cloud.retail.v2alpha.CompleteQueryResponse.RecentSearchResult
+        getDefaultInstanceForType() {
+      return DEFAULT_INSTANCE;
+    }
+  }
+
+  public interface AttributeResultOrBuilder
+      extends
+      // @@protoc_insertion_point(interface_extends:google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult)
+      com.google.protobuf.MessageOrBuilder {
+
+    /**
+     *
+     *
+     * 
      +     * The list of suggestions for the attribute.
+     * 
      
+     *
+     * repeated string suggestions = 1;
+     *
+     * @return A list containing the suggestions.
+     */
+    java.util.List getSuggestionsList();
+    /**
+     *
+     *
+     * 
      +     * The list of suggestions for the attribute.
+     * 
      
+     *
+     * repeated string suggestions = 1;
+     *
+     * @return The count of suggestions.
+     */
+    int getSuggestionsCount();
+    /**
+     *
+     *
+     * 
      +     * The list of suggestions for the attribute.
+     * 
      
+     *
+     * repeated string suggestions = 1;
+     *
+     * @param index The index of the element to return.
+     * @return The suggestions at the given index.
+     */
+    java.lang.String getSuggestions(int index);
+    /**
+     *
+     *
+     * 
      +     * The list of suggestions for the attribute.
+     * 
      
+     *
+     * repeated string suggestions = 1;
+     *
+     * @param index The index of the value to return.
+     * @return The bytes of the suggestions at the given index.
+     */
+    com.google.protobuf.ByteString getSuggestionsBytes(int index);
+  }
+  /**
+   *
+   *
+   * 
      +   * Resource that represents attribute results.
+   * 
      
+   *
+   * Protobuf type {@code google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult}
+   */
+  public static final class AttributeResult extends com.google.protobuf.GeneratedMessageV3
+      implements
+      // @@protoc_insertion_point(message_implements:google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult)
+      AttributeResultOrBuilder {
+    private static final long serialVersionUID = 0L;
+    // Use AttributeResult.newBuilder() to construct.
+    private AttributeResult(com.google.protobuf.GeneratedMessageV3.Builder builder) {
+      super(builder);
+    }
+
+    private AttributeResult() {
+      suggestions_ = com.google.protobuf.LazyStringArrayList.EMPTY;
+    }
+
+    @java.lang.Override
+    @SuppressWarnings({"unused"})
+    protected java.lang.Object newInstance(UnusedPrivateParameter unused) {
+      return new AttributeResult();
+    }
+
+    @java.lang.Override
+    public final com.google.protobuf.UnknownFieldSet getUnknownFields() {
+      return this.unknownFields;
+    }
+
+    public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
+      return com.google.cloud.retail.v2alpha.CompletionServiceProto
+          .internal_static_google_cloud_retail_v2alpha_CompleteQueryResponse_AttributeResult_descriptor;
+    }
+
+    @java.lang.Override
+    protected com.google.protobuf.GeneratedMessageV3.FieldAccessorTable
+        internalGetFieldAccessorTable() {
+      return com.google.cloud.retail.v2alpha.CompletionServiceProto
+          .internal_static_google_cloud_retail_v2alpha_CompleteQueryResponse_AttributeResult_fieldAccessorTable
+          .ensureFieldAccessorsInitialized(
+              com.google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult.class,
+              com.google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult.Builder.class);
+    }
+
+    public static final int SUGGESTIONS_FIELD_NUMBER = 1;
+    private com.google.protobuf.LazyStringList suggestions_;
+    /**
+     *
+     *
+     * 
      +     * The list of suggestions for the attribute.
+     * 
      
+     *
+     * repeated string suggestions = 1;
+     *
+     * @return A list containing the suggestions.
+     */
+    public com.google.protobuf.ProtocolStringList getSuggestionsList() {
+      return suggestions_;
+    }
+    /**
+     *
+     *
+     * 
      +     * The list of suggestions for the attribute.
+     * 
      
+     *
+     * repeated string suggestions = 1;
+     *
+     * @return The count of suggestions.
+     */
+    public int getSuggestionsCount() {
+      return suggestions_.size();
+    }
+    /**
+     *
+     *
+     * 
      +     * The list of suggestions for the attribute.
+     * 
      
+     *
+     * repeated string suggestions = 1;
+     *
+     * @param index The index of the element to return.
+     * @return The suggestions at the given index.
+     */
+    public java.lang.String getSuggestions(int index) {
+      return suggestions_.get(index);
+    }
+    /**
+     *
+     *
+     * 
      +     * The list of suggestions for the attribute.
+     * 
      
+     *
+     * repeated string suggestions = 1;
+     *
+     * @param index The index of the value to return.
+     * @return The bytes of the suggestions at the given index.
+     */
+    public com.google.protobuf.ByteString getSuggestionsBytes(int index) {
+      return suggestions_.getByteString(index);
+    }
+
+    private byte memoizedIsInitialized = -1;
+
+    @java.lang.Override
+    public final boolean isInitialized() {
+      byte isInitialized = memoizedIsInitialized;
+      if (isInitialized == 1) return true;
+      if (isInitialized == 0) return false;
+
+      memoizedIsInitialized = 1;
+      return true;
+    }
+
+    @java.lang.Override
+    public void writeTo(com.google.protobuf.CodedOutputStream output) throws java.io.IOException {
+      for (int i = 0; i < suggestions_.size(); i++) {
+        com.google.protobuf.GeneratedMessageV3.writeString(output, 1, suggestions_.getRaw(i));
+      }
+      getUnknownFields().writeTo(output);
+    }
+
+    @java.lang.Override
+    public int getSerializedSize() {
+      int size = memoizedSize;
+      if (size != -1) return size;
+
+      size = 0;
+      {
+        int dataSize = 0;
+        for (int i = 0; i < suggestions_.size(); i++) {
+          dataSize += computeStringSizeNoTag(suggestions_.getRaw(i));
+        }
+        size += dataSize;
+        size += 1 * getSuggestionsList().size();
+      }
+      size += getUnknownFields().getSerializedSize();
+      memoizedSize = size;
+      return size;
+    }
+
+    @java.lang.Override
+    public boolean equals(final java.lang.Object obj) {
+      if (obj == this) {
+        return true;
+      }
+      if (!(obj instanceof com.google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult)) {
+        return super.equals(obj);
+      }
+      com.google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult other =
+          (com.google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult) obj;
+
+      if (!getSuggestionsList().equals(other.getSuggestionsList())) return false;
+      if (!getUnknownFields().equals(other.getUnknownFields())) return false;
+      return true;
+    }
+
+    @java.lang.Override
+    public int hashCode() {
+      if (memoizedHashCode != 0) {
+        return memoizedHashCode;
+      }
+      int hash = 41;
+      hash = (19 * hash) + getDescriptor().hashCode();
+      if (getSuggestionsCount() > 0) {
+        hash = (37 * hash) + SUGGESTIONS_FIELD_NUMBER;
+        hash = (53 * hash) + getSuggestionsList().hashCode();
+      }
+      hash = (29 * hash) + getUnknownFields().hashCode();
+      memoizedHashCode = hash;
+      return hash;
+    }
+
+    public static com.google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult parseFrom(
+        java.nio.ByteBuffer data) throws com.google.protobuf.InvalidProtocolBufferException {
+      return PARSER.parseFrom(data);
+    }
+
+    public static com.google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult parseFrom(
+        java.nio.ByteBuffer data, com.google.protobuf.ExtensionRegistryLite extensionRegistry)
+        throws com.google.protobuf.InvalidProtocolBufferException {
+      return PARSER.parseFrom(data, extensionRegistry);
+    }
+
+    public static com.google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult parseFrom(
+        com.google.protobuf.ByteString data)
+        throws com.google.protobuf.InvalidProtocolBufferException {
+      return PARSER.parseFrom(data);
+    }
+
+    public static com.google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult parseFrom(
+        com.google.protobuf.ByteString data,
+        com.google.protobuf.ExtensionRegistryLite extensionRegistry)
+        throws com.google.protobuf.InvalidProtocolBufferException {
+      return PARSER.parseFrom(data, extensionRegistry);
+    }
+
+    public static com.google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult parseFrom(
+        byte[] data) throws com.google.protobuf.InvalidProtocolBufferException {
+      return PARSER.parseFrom(data);
+    }
+
+    public static com.google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult parseFrom(
+        byte[] data, com.google.protobuf.ExtensionRegistryLite extensionRegistry)
+        throws com.google.protobuf.InvalidProtocolBufferException {
+      return PARSER.parseFrom(data, extensionRegistry);
+    }
+
+    public static com.google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult parseFrom(
+        java.io.InputStream input) throws java.io.IOException {
+      return com.google.protobuf.GeneratedMessageV3.parseWithIOException(PARSER, input);
+    }
+
+    public static com.google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult parseFrom(
+        java.io.InputStream input, com.google.protobuf.ExtensionRegistryLite extensionRegistry)
+        throws java.io.IOException {
+      return com.google.protobuf.GeneratedMessageV3.parseWithIOException(
+          PARSER, input, extensionRegistry);
+    }
+
+    public static com.google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult
+        parseDelimitedFrom(java.io.InputStream input) throws java.io.IOException {
+      return com.google.protobuf.GeneratedMessageV3.parseDelimitedWithIOException(PARSER, input);
+    }
+
+    public static com.google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult
+        parseDelimitedFrom(
+            java.io.InputStream input, com.google.protobuf.ExtensionRegistryLite extensionRegistry)
+            throws java.io.IOException {
+      return com.google.protobuf.GeneratedMessageV3.parseDelimitedWithIOException(
+          PARSER, input, extensionRegistry);
+    }
+
+    public static com.google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult parseFrom(
+        com.google.protobuf.CodedInputStream input) throws java.io.IOException {
+      return com.google.protobuf.GeneratedMessageV3.parseWithIOException(PARSER, input);
+    }
+
+    public static com.google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult parseFrom(
+        com.google.protobuf.CodedInputStream input,
+        com.google.protobuf.ExtensionRegistryLite extensionRegistry)
+        throws java.io.IOException {
+      return com.google.protobuf.GeneratedMessageV3.parseWithIOException(
+          PARSER, input, extensionRegistry);
+    }
+
+    @java.lang.Override
+    public Builder newBuilderForType() {
+      return newBuilder();
+    }
+
+    public static Builder newBuilder() {
+      return DEFAULT_INSTANCE.toBuilder();
+    }
+
+    public static Builder newBuilder(
+        com.google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult prototype) {
+      return DEFAULT_INSTANCE.toBuilder().mergeFrom(prototype);
+    }
+
+    @java.lang.Override
+    public Builder toBuilder() {
+      return this == DEFAULT_INSTANCE ? new Builder() : new Builder().mergeFrom(this);
+    }
+
+    @java.lang.Override
+    protected Builder newBuilderForType(
+        com.google.protobuf.GeneratedMessageV3.BuilderParent parent) {
+      Builder builder = new Builder(parent);
+      return builder;
+    }
+    /**
+     *
+     *
+     * 
      +     * Resource that represents attribute results.
+     * 
      
+     *
+     * Protobuf type {@code google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult}
+     */
+    public static final class Builder
+        extends com.google.protobuf.GeneratedMessageV3.Builder
+        implements
+        // @@protoc_insertion_point(builder_implements:google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult)
+        com.google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResultOrBuilder {
+      public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
+        return com.google.cloud.retail.v2alpha.CompletionServiceProto
+            .internal_static_google_cloud_retail_v2alpha_CompleteQueryResponse_AttributeResult_descriptor;
+      }
+
+      @java.lang.Override
+      protected com.google.protobuf.GeneratedMessageV3.FieldAccessorTable
+          internalGetFieldAccessorTable() {
+        return com.google.cloud.retail.v2alpha.CompletionServiceProto
+            .internal_static_google_cloud_retail_v2alpha_CompleteQueryResponse_AttributeResult_fieldAccessorTable
+            .ensureFieldAccessorsInitialized(
+                com.google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult.class,
+                com.google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult.Builder
+                    .class);
+      }
+
+      // Construct using
+      // com.google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult.newBuilder()
+      private Builder() {}
+
+      private Builder(com.google.protobuf.GeneratedMessageV3.BuilderParent parent) {
+        super(parent);
+      }
+
+      @java.lang.Override
+      public Builder clear() {
+        super.clear();
+        suggestions_ = com.google.protobuf.LazyStringArrayList.EMPTY;
+        bitField0_ = (bitField0_ & ~0x00000001);
+        return this;
+      }
+
+      @java.lang.Override
+      public com.google.protobuf.Descriptors.Descriptor getDescriptorForType() {
+        return com.google.cloud.retail.v2alpha.CompletionServiceProto
+            .internal_static_google_cloud_retail_v2alpha_CompleteQueryResponse_AttributeResult_descriptor;
+      }
+
+      @java.lang.Override
+      public com.google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult
+          getDefaultInstanceForType() {
+        return com.google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult
+            .getDefaultInstance();
+      }
+
+      @java.lang.Override
+      public com.google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult build() {
+        com.google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult result =
+            buildPartial();
+        if (!result.isInitialized()) {
+          throw newUninitializedMessageException(result);
+        }
+        return result;
+      }
+
+      @java.lang.Override
+      public com.google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult buildPartial() {
+        com.google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult result =
+            new com.google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult(this);
+        int from_bitField0_ = bitField0_;
+        if (((bitField0_ & 0x00000001) != 0)) {
+          suggestions_ = suggestions_.getUnmodifiableView();
+          bitField0_ = (bitField0_ & ~0x00000001);
+        }
+        result.suggestions_ = suggestions_;
+        onBuilt();
+        return result;
+      }
+
+      @java.lang.Override
+      public Builder clone() {
+        return super.clone();
+      }
+
+      @java.lang.Override
+      public Builder setField(
+          com.google.protobuf.Descriptors.FieldDescriptor field, java.lang.Object value) {
+        return super.setField(field, value);
+      }
+
+      @java.lang.Override
+      public Builder clearField(com.google.protobuf.Descriptors.FieldDescriptor field) {
+        return super.clearField(field);
+      }
+
+      @java.lang.Override
+      public Builder clearOneof(com.google.protobuf.Descriptors.OneofDescriptor oneof) {
+        return super.clearOneof(oneof);
+      }
+
+      @java.lang.Override
+      public Builder setRepeatedField(
+          com.google.protobuf.Descriptors.FieldDescriptor field,
+          int index,
+          java.lang.Object value) {
+        return super.setRepeatedField(field, index, value);
+      }
+
+      @java.lang.Override
+      public Builder addRepeatedField(
+          com.google.protobuf.Descriptors.FieldDescriptor field, java.lang.Object value) {
+        return super.addRepeatedField(field, value);
+      }
+
+      @java.lang.Override
+      public Builder mergeFrom(com.google.protobuf.Message other) {
+        if (other
+            instanceof com.google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult) {
+          return mergeFrom(
+              (com.google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult) other);
+        } else {
+          super.mergeFrom(other);
+          return this;
+        }
+      }
+
+      public Builder mergeFrom(
+          com.google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult other) {
+        if (other
+            == com.google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult
+                .getDefaultInstance()) return this;
+        if (!other.suggestions_.isEmpty()) {
+          if (suggestions_.isEmpty()) {
+            suggestions_ = other.suggestions_;
+            bitField0_ = (bitField0_ & ~0x00000001);
+          } else {
+            ensureSuggestionsIsMutable();
+            suggestions_.addAll(other.suggestions_);
+          }
+          onChanged();
+        }
+        this.mergeUnknownFields(other.getUnknownFields());
+        onChanged();
+        return this;
+      }
+
+      @java.lang.Override
+      public final boolean isInitialized() {
+        return true;
+      }
+
+      @java.lang.Override
+      public Builder mergeFrom(
+          com.google.protobuf.CodedInputStream input,
+          com.google.protobuf.ExtensionRegistryLite extensionRegistry)
+          throws java.io.IOException {
+        if (extensionRegistry == null) {
+          throw new java.lang.NullPointerException();
+        }
+        try {
+          boolean done = false;
+          while (!done) {
+            int tag = input.readTag();
+            switch (tag) {
+              case 0:
+                done = true;
+                break;
+              case 10:
+                {
+                  java.lang.String s = input.readStringRequireUtf8();
+                  ensureSuggestionsIsMutable();
+                  suggestions_.add(s);
+                  break;
+                } // case 10
+              default:
+                {
+                  if (!super.parseUnknownField(input, extensionRegistry, tag)) {
+                    done = true; // was an endgroup tag
+                  }
+                  break;
+                } // default:
+            } // switch (tag)
+          } // while (!done)
+        } catch (com.google.protobuf.InvalidProtocolBufferException e) {
+          throw e.unwrapIOException();
+        } finally {
+          onChanged();
+        } // finally
+        return this;
+      }
+
+      private int bitField0_;
+
+      private com.google.protobuf.LazyStringList suggestions_ =
+          com.google.protobuf.LazyStringArrayList.EMPTY;
+
+      private void ensureSuggestionsIsMutable() {
+        if (!((bitField0_ & 0x00000001) != 0)) {
+          suggestions_ = new com.google.protobuf.LazyStringArrayList(suggestions_);
+          bitField0_ |= 0x00000001;
+        }
+      }
+      /**
+       *
+       *
+       * 
      +       * The list of suggestions for the attribute.
+       * 
      
+       *
+       * repeated string suggestions = 1;
+       *
+       * @return A list containing the suggestions.
+       */
+      public com.google.protobuf.ProtocolStringList getSuggestionsList() {
+        return suggestions_.getUnmodifiableView();
+      }
+      /**
+       *
+       *
+       * 
      +       * The list of suggestions for the attribute.
+       * 
      
+       *
+       * repeated string suggestions = 1;
+       *
+       * @return The count of suggestions.
+       */
+      public int getSuggestionsCount() {
+        return suggestions_.size();
+      }
+      /**
+       *
+       *
+       * 
      +       * The list of suggestions for the attribute.
+       * 
      
+       *
+       * repeated string suggestions = 1;
+       *
+       * @param index The index of the element to return.
+       * @return The suggestions at the given index.
+       */
+      public java.lang.String getSuggestions(int index) {
+        return suggestions_.get(index);
+      }
+      /**
+       *
+       *
+       * 
      +       * The list of suggestions for the attribute.
+       * 
      
+       *
+       * repeated string suggestions = 1;
+       *
+       * @param index The index of the value to return.
+       * @return The bytes of the suggestions at the given index.
+       */
+      public com.google.protobuf.ByteString getSuggestionsBytes(int index) {
+        return suggestions_.getByteString(index);
+      }
+      /**
+       *
+       *
+       * 
      +       * The list of suggestions for the attribute.
+       * 
      
+       *
+       * repeated string suggestions = 1;
+       *
+       * @param index The index to set the value at.
+       * @param value The suggestions to set.
+       * @return This builder for chaining.
+       */
+      public Builder setSuggestions(int index, java.lang.String value) {
+        if (value == null) {
+          throw new NullPointerException();
+        }
+        ensureSuggestionsIsMutable();
+        suggestions_.set(index, value);
+        onChanged();
+        return this;
+      }
+      /**
+       *
+       *
+       * 
      +       * The list of suggestions for the attribute.
        * 
      
        *
-       * string recent_search = 1;
+       * repeated string suggestions = 1;
        *
-       * @return The bytes for recentSearch.
+       * @param value The suggestions to add.
+       * @return This builder for chaining.
        */
-      public com.google.protobuf.ByteString getRecentSearchBytes() {
-        java.lang.Object ref = recentSearch_;
-        if (ref instanceof String) {
-          com.google.protobuf.ByteString b =
-              com.google.protobuf.ByteString.copyFromUtf8((java.lang.String) ref);
-          recentSearch_ = b;
-          return b;
-        } else {
-          return (com.google.protobuf.ByteString) ref;
+      public Builder addSuggestions(java.lang.String value) {
+        if (value == null) {
+          throw new NullPointerException();
         }
+        ensureSuggestionsIsMutable();
+        suggestions_.add(value);
+        onChanged();
+        return this;
       }
       /**
        *
        *
        * 
      -       * The recent search query.
+       * The list of suggestions for the attribute.
        * 
      
        *
-       * string recent_search = 1;
+       * repeated string suggestions = 1;
        *
-       * @param value The recentSearch to set.
+       * @param values The suggestions to add.
        * @return This builder for chaining.
        */
-      public Builder setRecentSearch(java.lang.String value) {
-        if (value == null) {
-          throw new NullPointerException();
-        }
-
-        recentSearch_ = value;
+      public Builder addAllSuggestions(java.lang.Iterable values) {
+        ensureSuggestionsIsMutable();
+        com.google.protobuf.AbstractMessageLite.Builder.addAll(values, suggestions_);
         onChanged();
         return this;
       }
@@ -1788,16 +2567,16 @@ public Builder setRecentSearch(java.lang.String value) {
        *
        *
        * 
      -       * The recent search query.
+       * The list of suggestions for the attribute.
        * 
      
        *
-       * string recent_search = 1;
+       * repeated string suggestions = 1;
        *
        * @return This builder for chaining.
        */
-      public Builder clearRecentSearch() {
-
-        recentSearch_ = getDefaultInstance().getRecentSearch();
+      public Builder clearSuggestions() {
+        suggestions_ = com.google.protobuf.LazyStringArrayList.EMPTY;
+        bitField0_ = (bitField0_ & ~0x00000001);
         onChanged();
         return this;
       }
@@ -1805,21 +2584,21 @@ public Builder clearRecentSearch() {
        *
        *
        * 
      -       * The recent search query.
+       * The list of suggestions for the attribute.
        * 
      
        *
-       * string recent_search = 1;
+       * repeated string suggestions = 1;
        *
-       * @param value The bytes for recentSearch to set.
+       * @param value The bytes of the suggestions to add.
        * @return This builder for chaining.
        */
-      public Builder setRecentSearchBytes(com.google.protobuf.ByteString value) {
+      public Builder addSuggestionsBytes(com.google.protobuf.ByteString value) {
         if (value == null) {
           throw new NullPointerException();
         }
         checkByteStringIsUtf8(value);
-
-        recentSearch_ = value;
+        ensureSuggestionsIsMutable();
+        suggestions_.add(value);
         onChanged();
         return this;
       }
@@ -1836,27 +2615,27 @@ public final Builder mergeUnknownFields(
         return super.mergeUnknownFields(unknownFields);
       }
 
-      // @@protoc_insertion_point(builder_scope:google.cloud.retail.v2alpha.CompleteQueryResponse.RecentSearchResult)
+      // @@protoc_insertion_point(builder_scope:google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult)
     }
 
-    // @@protoc_insertion_point(class_scope:google.cloud.retail.v2alpha.CompleteQueryResponse.RecentSearchResult)
-    private static final com.google.cloud.retail.v2alpha.CompleteQueryResponse.RecentSearchResult
+    // @@protoc_insertion_point(class_scope:google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult)
+    private static final com.google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult
         DEFAULT_INSTANCE;
 
     static {
       DEFAULT_INSTANCE =
-          new com.google.cloud.retail.v2alpha.CompleteQueryResponse.RecentSearchResult();
+          new com.google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult();
     }
 
-    public static com.google.cloud.retail.v2alpha.CompleteQueryResponse.RecentSearchResult
+    public static com.google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult
         getDefaultInstance() {
       return DEFAULT_INSTANCE;
     }
 
-    private static final com.google.protobuf.Parser PARSER =
-        new com.google.protobuf.AbstractParser() {
+    private static final com.google.protobuf.Parser PARSER =
+        new com.google.protobuf.AbstractParser() {
           @java.lang.Override
-          public RecentSearchResult parsePartialFrom(
+          public AttributeResult parsePartialFrom(
               com.google.protobuf.CodedInputStream input,
               com.google.protobuf.ExtensionRegistryLite extensionRegistry)
               throws com.google.protobuf.InvalidProtocolBufferException {
@@ -1876,17 +2655,17 @@ public RecentSearchResult parsePartialFrom(
           }
         };
 
-    public static com.google.protobuf.Parser parser() {
+    public static com.google.protobuf.Parser parser() {
       return PARSER;
     }
 
     @java.lang.Override
-    public com.google.protobuf.Parser getParserForType() {
+    public com.google.protobuf.Parser getParserForType() {
       return PARSER;
     }
 
     @java.lang.Override
-    public com.google.cloud.retail.v2alpha.CompleteQueryResponse.RecentSearchResult
+    public com.google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult
         getDefaultInstanceForType() {
       return DEFAULT_INSTANCE;
     }
@@ -2191,6 +2970,151 @@ public int getRecentSearchResultsCount() {
     return recentSearchResults_.get(index);
   }
 
+  public static final int ATTRIBUTE_RESULTS_FIELD_NUMBER = 4;
+
+  private static final class AttributeResultsDefaultEntryHolder {
+    static final com.google.protobuf.MapEntry<
+            java.lang.String, com.google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult>
+        defaultEntry =
+            com.google.protobuf.MapEntry
+                .
+                    newDefaultInstance(
+                        com.google.cloud.retail.v2alpha.CompletionServiceProto
+                            .internal_static_google_cloud_retail_v2alpha_CompleteQueryResponse_AttributeResultsEntry_descriptor,
+                        com.google.protobuf.WireFormat.FieldType.STRING,
+                        "",
+                        com.google.protobuf.WireFormat.FieldType.MESSAGE,
+                        com.google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult
+                            .getDefaultInstance());
+  }
+
+  private com.google.protobuf.MapField<
+          java.lang.String, com.google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult>
+      attributeResults_;
+
+  private com.google.protobuf.MapField<
+          java.lang.String, com.google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult>
+      internalGetAttributeResults() {
+    if (attributeResults_ == null) {
+      return com.google.protobuf.MapField.emptyMapField(
+          AttributeResultsDefaultEntryHolder.defaultEntry);
+    }
+    return attributeResults_;
+  }
+
+  public int getAttributeResultsCount() {
+    return internalGetAttributeResults().getMap().size();
+  }
+  /**
+   *
+   *
+   * 
      +   * A map of matched attribute suggestions. This field is only available for
+   * "cloud-retail" dataset.
+   * Current supported keys:
+   * * `brands`
+   * * `categories`
+   * 
      
+   *
+   * 
+   * map<string, .google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult> attribute_results = 4;
+   * 
+   */
+  @java.lang.Override
+  public boolean containsAttributeResults(java.lang.String key) {
+    if (key == null) {
+      throw new NullPointerException("map key");
+    }
+    return internalGetAttributeResults().getMap().containsKey(key);
+  }
+  /** Use {@link #getAttributeResultsMap()} instead. */
+  @java.lang.Override
+  @java.lang.Deprecated
+  public java.util.Map<
+          java.lang.String, com.google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult>
+      getAttributeResults() {
+    return getAttributeResultsMap();
+  }
+  /**
+   *
+   *
+   * 
      +   * A map of matched attribute suggestions. This field is only available for
+   * "cloud-retail" dataset.
+   * Current supported keys:
+   * * `brands`
+   * * `categories`
+   * 
      
+   *
+   * 
+   * map<string, .google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult> attribute_results = 4;
+   * 
+   */
+  @java.lang.Override
+  public java.util.Map<
+          java.lang.String, com.google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult>
+      getAttributeResultsMap() {
+    return internalGetAttributeResults().getMap();
+  }
+  /**
+   *
+   *
+   * 
      +   * A map of matched attribute suggestions. This field is only available for
+   * "cloud-retail" dataset.
+   * Current supported keys:
+   * * `brands`
+   * * `categories`
+   * 
      
+   *
+   * 
+   * map<string, .google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult> attribute_results = 4;
+   * 
+   */
+  @java.lang.Override
+  public com.google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult
+      getAttributeResultsOrDefault(
+          java.lang.String key,
+          com.google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult defaultValue) {
+    if (key == null) {
+      throw new NullPointerException("map key");
+    }
+    java.util.Map<
+            java.lang.String, com.google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult>
+        map = internalGetAttributeResults().getMap();
+    return map.containsKey(key) ? map.get(key) : defaultValue;
+  }
+  /**
+   *
+   *
+   * 
      +   * A map of matched attribute suggestions. This field is only available for
+   * "cloud-retail" dataset.
+   * Current supported keys:
+   * * `brands`
+   * * `categories`
+   * 
      
+   *
+   * 
+   * map<string, .google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult> attribute_results = 4;
+   * 
+   */
+  @java.lang.Override
+  public com.google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult
+      getAttributeResultsOrThrow(java.lang.String key) {
+    if (key == null) {
+      throw new NullPointerException("map key");
+    }
+    java.util.Map<
+            java.lang.String, com.google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult>
+        map = internalGetAttributeResults().getMap();
+    if (!map.containsKey(key)) {
+      throw new java.lang.IllegalArgumentException();
+    }
+    return map.get(key);
+  }
+
   private byte memoizedIsInitialized = -1;
 
   @java.lang.Override
@@ -2214,6 +3138,8 @@ public void writeTo(com.google.protobuf.CodedOutputStream output) throws java.io
     for (int i = 0; i < recentSearchResults_.size(); i++) {
       output.writeMessage(3, recentSearchResults_.get(i));
     }
+    com.google.protobuf.GeneratedMessageV3.serializeStringMapTo(
+        output, internalGetAttributeResults(), AttributeResultsDefaultEntryHolder.defaultEntry, 4);
     getUnknownFields().writeTo(output);
   }
 
@@ -2234,6 +3160,20 @@ public int getSerializedSize() {
       size +=
           com.google.protobuf.CodedOutputStream.computeMessageSize(3, recentSearchResults_.get(i));
     }
+    for (java.util.Map.Entry<
+            java.lang.String, com.google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult>
+        entry : internalGetAttributeResults().getMap().entrySet()) {
+      com.google.protobuf.MapEntry<
+              java.lang.String,
+              com.google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult>
+          attributeResults__ =
+              AttributeResultsDefaultEntryHolder.defaultEntry
+                  .newBuilderForType()
+                  .setKey(entry.getKey())
+                  .setValue(entry.getValue())
+                  .build();
+      size += com.google.protobuf.CodedOutputStream.computeMessageSize(4, attributeResults__);
+    }
     size += getUnknownFields().getSerializedSize();
     memoizedSize = size;
     return size;
@@ -2253,6 +3193,7 @@ public boolean equals(final java.lang.Object obj) {
     if (!getCompletionResultsList().equals(other.getCompletionResultsList())) return false;
     if (!getAttributionToken().equals(other.getAttributionToken())) return false;
     if (!getRecentSearchResultsList().equals(other.getRecentSearchResultsList())) return false;
+    if (!internalGetAttributeResults().equals(other.internalGetAttributeResults())) return false;
     if (!getUnknownFields().equals(other.getUnknownFields())) return false;
     return true;
   }
@@ -2274,6 +3215,10 @@ public int hashCode() {
       hash = (37 * hash) + RECENT_SEARCH_RESULTS_FIELD_NUMBER;
       hash = (53 * hash) + getRecentSearchResultsList().hashCode();
     }
+    if (!internalGetAttributeResults().getMap().isEmpty()) {
+      hash = (37 * hash) + ATTRIBUTE_RESULTS_FIELD_NUMBER;
+      hash = (53 * hash) + internalGetAttributeResults().hashCode();
+    }
     hash = (29 * hash) + getUnknownFields().hashCode();
     memoizedHashCode = hash;
     return hash;
@@ -2393,6 +3338,26 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
           .internal_static_google_cloud_retail_v2alpha_CompleteQueryResponse_descriptor;
     }
 
+    @SuppressWarnings({"rawtypes"})
+    protected com.google.protobuf.MapField internalGetMapField(int number) {
+      switch (number) {
+        case 4:
+          return internalGetAttributeResults();
+        default:
+          throw new RuntimeException("Invalid map field number: " + number);
+      }
+    }
+
+    @SuppressWarnings({"rawtypes"})
+    protected com.google.protobuf.MapField internalGetMutableMapField(int number) {
+      switch (number) {
+        case 4:
+          return internalGetMutableAttributeResults();
+        default:
+          throw new RuntimeException("Invalid map field number: " + number);
+      }
+    }
+
     @java.lang.Override
     protected com.google.protobuf.GeneratedMessageV3.FieldAccessorTable
         internalGetFieldAccessorTable() {
@@ -2429,6 +3394,7 @@ public Builder clear() {
         recentSearchResultsBuilder_.clear();
       }
       bitField0_ = (bitField0_ & ~0x00000002);
+      internalGetMutableAttributeResults().clear();
       return this;
     }
 
@@ -2476,6 +3442,8 @@ public com.google.cloud.retail.v2alpha.CompleteQueryResponse buildPartial() {
       } else {
         result.recentSearchResults_ = recentSearchResultsBuilder_.build();
       }
+      result.attributeResults_ = internalGetAttributeResults();
+      result.attributeResults_.makeImmutable();
       onBuilt();
       return result;
     }
@@ -2584,6 +3552,7 @@ public Builder mergeFrom(com.google.cloud.retail.v2alpha.CompleteQueryResponse o
           }
         }
       }
+      internalGetMutableAttributeResults().mergeFrom(other.internalGetAttributeResults());
       this.mergeUnknownFields(other.getUnknownFields());
       onChanged();
       return this;
@@ -2646,6 +3615,20 @@ public Builder mergeFrom(
                 }
                 break;
               } // case 26
+            case 34:
+              {
+                com.google.protobuf.MapEntry<
+                        java.lang.String,
+                        com.google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult>
+                    attributeResults__ =
+                        input.readMessage(
+                            AttributeResultsDefaultEntryHolder.defaultEntry.getParserForType(),
+                            extensionRegistry);
+                internalGetMutableAttributeResults()
+                    .getMutableMap()
+                    .put(attributeResults__.getKey(), attributeResults__.getValue());
+                break;
+              } // case 34
             default:
               {
                 if (!super.parseUnknownField(input, extensionRegistry, tag)) {
@@ -3888,6 +4871,235 @@ public Builder removeRecentSearchResults(int index) {
       return recentSearchResultsBuilder_;
     }
 
+    private com.google.protobuf.MapField<
+            java.lang.String, com.google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult>
+        attributeResults_;
+
+    private com.google.protobuf.MapField<
+            java.lang.String, com.google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult>
+        internalGetAttributeResults() {
+      if (attributeResults_ == null) {
+        return com.google.protobuf.MapField.emptyMapField(
+            AttributeResultsDefaultEntryHolder.defaultEntry);
+      }
+      return attributeResults_;
+    }
+
+    private com.google.protobuf.MapField<
+            java.lang.String, com.google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult>
+        internalGetMutableAttributeResults() {
+      onChanged();
+      ;
+      if (attributeResults_ == null) {
+        attributeResults_ =
+            com.google.protobuf.MapField.newMapField(
+                AttributeResultsDefaultEntryHolder.defaultEntry);
+      }
+      if (!attributeResults_.isMutable()) {
+        attributeResults_ = attributeResults_.copy();
+      }
+      return attributeResults_;
+    }
+
+    public int getAttributeResultsCount() {
+      return internalGetAttributeResults().getMap().size();
+    }
+    /**
+     *
+     *
+     * 
      +     * A map of matched attribute suggestions. This field is only available for
+     * "cloud-retail" dataset.
+     * Current supported keys:
+     * * `brands`
+     * * `categories`
+     * 
      
+     *
+     * 
+     * map<string, .google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult> attribute_results = 4;
+     * 
+     */
+    @java.lang.Override
+    public boolean containsAttributeResults(java.lang.String key) {
+      if (key == null) {
+        throw new NullPointerException("map key");
+      }
+      return internalGetAttributeResults().getMap().containsKey(key);
+    }
+    /** Use {@link #getAttributeResultsMap()} instead. */
+    @java.lang.Override
+    @java.lang.Deprecated
+    public java.util.Map<
+            java.lang.String, com.google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult>
+        getAttributeResults() {
+      return getAttributeResultsMap();
+    }
+    /**
+     *
+     *
+     * 
      +     * A map of matched attribute suggestions. This field is only available for
+     * "cloud-retail" dataset.
+     * Current supported keys:
+     * * `brands`
+     * * `categories`
+     * 
      
+     *
+     * 
+     * map<string, .google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult> attribute_results = 4;
+     * 
+     */
+    @java.lang.Override
+    public java.util.Map<
+            java.lang.String, com.google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult>
+        getAttributeResultsMap() {
+      return internalGetAttributeResults().getMap();
+    }
+    /**
+     *
+     *
+     * 
      +     * A map of matched attribute suggestions. This field is only available for
+     * "cloud-retail" dataset.
+     * Current supported keys:
+     * * `brands`
+     * * `categories`
+     * 
      
+     *
+     * 
+     * map<string, .google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult> attribute_results = 4;
+     * 
+     */
+    @java.lang.Override
+    public com.google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult
+        getAttributeResultsOrDefault(
+            java.lang.String key,
+            com.google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult defaultValue) {
+      if (key == null) {
+        throw new NullPointerException("map key");
+      }
+      java.util.Map<
+              java.lang.String,
+              com.google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult>
+          map = internalGetAttributeResults().getMap();
+      return map.containsKey(key) ? map.get(key) : defaultValue;
+    }
+    /**
+     *
+     *
+     * 
      +     * A map of matched attribute suggestions. This field is only available for
+     * "cloud-retail" dataset.
+     * Current supported keys:
+     * * `brands`
+     * * `categories`
+     * 
      
+     *
+     * 
+     * map<string, .google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult> attribute_results = 4;
+     * 
+     */
+    @java.lang.Override
+    public com.google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult
+        getAttributeResultsOrThrow(java.lang.String key) {
+      if (key == null) {
+        throw new NullPointerException("map key");
+      }
+      java.util.Map<
+              java.lang.String,
+              com.google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult>
+          map = internalGetAttributeResults().getMap();
+      if (!map.containsKey(key)) {
+        throw new java.lang.IllegalArgumentException();
+      }
+      return map.get(key);
+    }
+
+    public Builder clearAttributeResults() {
+      internalGetMutableAttributeResults().getMutableMap().clear();
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * A map of matched attribute suggestions. This field is only available for
+     * "cloud-retail" dataset.
+     * Current supported keys:
+     * * `brands`
+     * * `categories`
+     * 
      
+     *
+     * 
+     * map<string, .google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult> attribute_results = 4;
+     * 
+     */
+    public Builder removeAttributeResults(java.lang.String key) {
+      if (key == null) {
+        throw new NullPointerException("map key");
+      }
+      internalGetMutableAttributeResults().getMutableMap().remove(key);
+      return this;
+    }
+    /** Use alternate mutation accessors instead. */
+    @java.lang.Deprecated
+    public java.util.Map<
+            java.lang.String, com.google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult>
+        getMutableAttributeResults() {
+      return internalGetMutableAttributeResults().getMutableMap();
+    }
+    /**
+     *
+     *
+     * 
      +     * A map of matched attribute suggestions. This field is only available for
+     * "cloud-retail" dataset.
+     * Current supported keys:
+     * * `brands`
+     * * `categories`
+     * 
      
+     *
+     * 
+     * map<string, .google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult> attribute_results = 4;
+     * 
+     */
+    public Builder putAttributeResults(
+        java.lang.String key,
+        com.google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult value) {
+      if (key == null) {
+        throw new NullPointerException("map key");
+      }
+      if (value == null) {
+        throw new NullPointerException("map value");
+      }
+
+      internalGetMutableAttributeResults().getMutableMap().put(key, value);
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * A map of matched attribute suggestions. This field is only available for
+     * "cloud-retail" dataset.
+     * Current supported keys:
+     * * `brands`
+     * * `categories`
+     * 
      
+     *
+     * 
+     * map<string, .google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult> attribute_results = 4;
+     * 
+     */
+    public Builder putAllAttributeResults(
+        java.util.Map<
+                java.lang.String,
+                com.google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult>
+            values) {
+      internalGetMutableAttributeResults().getMutableMap().putAll(values);
+      return this;
+    }
+
     @java.lang.Override
     public final Builder setUnknownFields(final com.google.protobuf.UnknownFieldSet unknownFields) {
       return super.setUnknownFields(unknownFields);
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/CompleteQueryResponseOrBuilder.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/CompleteQueryResponseOrBuilder.java
index d813f6f0a8bd..223e9a3fbfcf 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/CompleteQueryResponseOrBuilder.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/CompleteQueryResponseOrBuilder.java
@@ -261,4 +261,99 @@ com.google.cloud.retail.v2alpha.CompleteQueryResponse.RecentSearchResult getRece
    */
   com.google.cloud.retail.v2alpha.CompleteQueryResponse.RecentSearchResultOrBuilder
       getRecentSearchResultsOrBuilder(int index);
+
+  /**
+   *
+   *
+   * 
      +   * A map of matched attribute suggestions. This field is only available for
+   * "cloud-retail" dataset.
+   * Current supported keys:
+   * * `brands`
+   * * `categories`
+   * 
      
+   *
+   * 
+   * map<string, .google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult> attribute_results = 4;
+   * 
+   */
+  int getAttributeResultsCount();
+  /**
+   *
+   *
+   * 
      +   * A map of matched attribute suggestions. This field is only available for
+   * "cloud-retail" dataset.
+   * Current supported keys:
+   * * `brands`
+   * * `categories`
+   * 
      
+   *
+   * 
+   * map<string, .google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult> attribute_results = 4;
+   * 
+   */
+  boolean containsAttributeResults(java.lang.String key);
+  /** Use {@link #getAttributeResultsMap()} instead. */
+  @java.lang.Deprecated
+  java.util.Map<
+          java.lang.String, com.google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult>
+      getAttributeResults();
+  /**
+   *
+   *
+   * 
      +   * A map of matched attribute suggestions. This field is only available for
+   * "cloud-retail" dataset.
+   * Current supported keys:
+   * * `brands`
+   * * `categories`
+   * 
      
+   *
+   * 
+   * map<string, .google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult> attribute_results = 4;
+   * 
+   */
+  java.util.Map<
+          java.lang.String, com.google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult>
+      getAttributeResultsMap();
+  /**
+   *
+   *
+   * 
      +   * A map of matched attribute suggestions. This field is only available for
+   * "cloud-retail" dataset.
+   * Current supported keys:
+   * * `brands`
+   * * `categories`
+   * 
      
+   *
+   * 
+   * map<string, .google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult> attribute_results = 4;
+   * 
+   */
+
+  /* nullable */
+  com.google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult
+      getAttributeResultsOrDefault(
+          java.lang.String key,
+          /* nullable */
+          com.google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult defaultValue);
+  /**
+   *
+   *
+   * 
      +   * A map of matched attribute suggestions. This field is only available for
+   * "cloud-retail" dataset.
+   * Current supported keys:
+   * * `brands`
+   * * `categories`
+   * 
      
+   *
+   * 
+   * map<string, .google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult> attribute_results = 4;
+   * 
+   */
+  com.google.cloud.retail.v2alpha.CompleteQueryResponse.AttributeResult getAttributeResultsOrThrow(
+      java.lang.String key);
 }
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/CompletionServiceProto.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/CompletionServiceProto.java
index a37e5b107b58..e596737b5ad1 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/CompletionServiceProto.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/CompletionServiceProto.java
@@ -47,6 +47,14 @@ public static void registerAllExtensions(com.google.protobuf.ExtensionRegistry r
       internal_static_google_cloud_retail_v2alpha_CompleteQueryResponse_RecentSearchResult_descriptor;
   static final com.google.protobuf.GeneratedMessageV3.FieldAccessorTable
       internal_static_google_cloud_retail_v2alpha_CompleteQueryResponse_RecentSearchResult_fieldAccessorTable;
+  static final com.google.protobuf.Descriptors.Descriptor
+      internal_static_google_cloud_retail_v2alpha_CompleteQueryResponse_AttributeResult_descriptor;
+  static final com.google.protobuf.GeneratedMessageV3.FieldAccessorTable
+      internal_static_google_cloud_retail_v2alpha_CompleteQueryResponse_AttributeResult_fieldAccessorTable;
+  static final com.google.protobuf.Descriptors.Descriptor
+      internal_static_google_cloud_retail_v2alpha_CompleteQueryResponse_AttributeResultsEntry_descriptor;
+  static final com.google.protobuf.GeneratedMessageV3.FieldAccessorTable
+      internal_static_google_cloud_retail_v2alpha_CompleteQueryResponse_AttributeResultsEntry_fieldAccessorTable;
 
   public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
     return descriptor;
@@ -64,46 +72,54 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
           + "google/cloud/retail/v2alpha/common.proto"
           + "\032/google/cloud/retail/v2alpha/import_con"
           + "fig.proto\032#google/longrunning/operations"
-          + ".proto\"\315\001\n\024CompleteQueryRequest\0226\n\007catal"
+          + ".proto\"\363\001\n\024CompleteQueryRequest\0226\n\007catal"
           + "og\030\001 \001(\tB%\340A\002\372A\037\n\035retail.googleapis.com/"
           + "Catalog\022\022\n\005query\030\002 \001(\tB\003\340A\002\022\022\n\nvisitor_i"
           + "d\030\007 \001(\t\022\026\n\016language_codes\030\003 \003(\t\022\023\n\013devic"
           + "e_type\030\004 \001(\t\022\017\n\007dataset\030\006 \001(\t\022\027\n\017max_sug"
-          + "gestions\030\005 \001(\005\"\231\004\n\025CompleteQueryResponse"
-          + "\022_\n\022completion_results\030\001 \003(\0132C.google.cl"
-          + "oud.retail.v2alpha.CompleteQueryResponse"
-          + ".CompletionResult\022\031\n\021attribution_token\030\002"
-          + " \001(\t\022d\n\025recent_search_results\030\003 \003(\0132E.go"
-          + "ogle.cloud.retail.v2alpha.CompleteQueryR"
-          + "esponse.RecentSearchResult\032\360\001\n\020Completio"
-          + "nResult\022\022\n\nsuggestion\030\001 \001(\t\022g\n\nattribute"
-          + "s\030\002 \003(\0132S.google.cloud.retail.v2alpha.Co"
-          + "mpleteQueryResponse.CompletionResult.Att"
-          + "ributesEntry\032_\n\017AttributesEntry\022\013\n\003key\030\001"
-          + " \001(\t\022;\n\005value\030\002 \001(\0132,.google.cloud.retai"
-          + "l.v2alpha.CustomAttribute:\0028\001\032+\n\022RecentS"
-          + "earchResult\022\025\n\rrecent_search\030\001 \001(\t2\325\004\n\021C"
-          + "ompletionService\022\302\001\n\rCompleteQuery\0221.goo"
-          + "gle.cloud.retail.v2alpha.CompleteQueryRe"
-          + "quest\0322.google.cloud.retail.v2alpha.Comp"
-          + "leteQueryResponse\"J\202\323\344\223\002D\022B/v2alpha/{cat"
-          + "alog=projects/*/locations/*/catalogs/*}:"
-          + "completeQuery\022\257\002\n\024ImportCompletionData\0228"
-          + ".google.cloud.retail.v2alpha.ImportCompl"
-          + "etionDataRequest\032\035.google.longrunning.Op"
-          + "eration\"\275\001\202\323\344\223\002N\"I/v2alpha/{parent=proje"
-          + "cts/*/locations/*/catalogs/*}/completion"
-          + "Data:import:\001*\312Af\n8google.cloud.retail.v"
-          + "2alpha.ImportCompletionDataResponse\022*goo"
-          + "gle.cloud.retail.v2alpha.ImportMetadata\032"
-          + "I\312A\025retail.googleapis.com\322A.https://www."
-          + "googleapis.com/auth/cloud-platformB\344\001\n\037c"
-          + "om.google.cloud.retail.v2alphaB\026Completi"
-          + "onServiceProtoP\001ZAgoogle.golang.org/genp"
-          + "roto/googleapis/cloud/retail/v2alpha;ret"
-          + "ail\242\002\006RETAIL\252\002\033Google.Cloud.Retail.V2Alp"
-          + "ha\312\002\033Google\\Cloud\\Retail\\V2alpha\352\002\036Googl"
-          + "e::Cloud::Retail::V2alphab\006proto3"
+          + "gestions\030\005 \001(\005\022$\n\034enable_attribute_sugge"
+          + "stions\030\t \001(\010\"\243\006\n\025CompleteQueryResponse\022_"
+          + "\n\022completion_results\030\001 \003(\0132C.google.clou"
+          + "d.retail.v2alpha.CompleteQueryResponse.C"
+          + "ompletionResult\022\031\n\021attribution_token\030\002 \001"
+          + "(\t\022d\n\025recent_search_results\030\003 \003(\0132E.goog"
+          + "le.cloud.retail.v2alpha.CompleteQueryRes"
+          + "ponse.RecentSearchResult\022c\n\021attribute_re"
+          + "sults\030\004 \003(\0132H.google.cloud.retail.v2alph"
+          + "a.CompleteQueryResponse.AttributeResults"
+          + "Entry\032\360\001\n\020CompletionResult\022\022\n\nsuggestion"
+          + "\030\001 \001(\t\022g\n\nattributes\030\002 \003(\0132S.google.clou"
+          + "d.retail.v2alpha.CompleteQueryResponse.C"
+          + "ompletionResult.AttributesEntry\032_\n\017Attri"
+          + "butesEntry\022\013\n\003key\030\001 \001(\t\022;\n\005value\030\002 \001(\0132,"
+          + ".google.cloud.retail.v2alpha.CustomAttri"
+          + "bute:\0028\001\032+\n\022RecentSearchResult\022\025\n\rrecent"
+          + "_search\030\001 \001(\t\032&\n\017AttributeResult\022\023\n\013sugg"
+          + "estions\030\001 \003(\t\032{\n\025AttributeResultsEntry\022\013"
+          + "\n\003key\030\001 \001(\t\022Q\n\005value\030\002 \001(\0132B.google.clou"
+          + "d.retail.v2alpha.CompleteQueryResponse.A"
+          + "ttributeResult:\0028\0012\325\004\n\021CompletionService"
+          + "\022\302\001\n\rCompleteQuery\0221.google.cloud.retail"
+          + ".v2alpha.CompleteQueryRequest\0322.google.c"
+          + "loud.retail.v2alpha.CompleteQueryRespons"
+          + "e\"J\202\323\344\223\002D\022B/v2alpha/{catalog=projects/*/"
+          + "locations/*/catalogs/*}:completeQuery\022\257\002"
+          + "\n\024ImportCompletionData\0228.google.cloud.re"
+          + "tail.v2alpha.ImportCompletionDataRequest"
+          + "\032\035.google.longrunning.Operation\"\275\001\202\323\344\223\002N"
+          + "\"I/v2alpha/{parent=projects/*/locations/"
+          + "*/catalogs/*}/completionData:import:\001*\312A"
+          + "f\n8google.cloud.retail.v2alpha.ImportCom"
+          + "pletionDataResponse\022*google.cloud.retail"
+          + ".v2alpha.ImportMetadata\032I\312A\025retail.googl"
+          + "eapis.com\322A.https://www.googleapis.com/a"
+          + "uth/cloud-platformB\344\001\n\037com.google.cloud."
+          + "retail.v2alphaB\026CompletionServiceProtoP\001"
+          + "ZAgoogle.golang.org/genproto/googleapis/"
+          + "cloud/retail/v2alpha;retail\242\002\006RETAIL\252\002\033G"
+          + "oogle.Cloud.Retail.V2Alpha\312\002\033Google\\Clou"
+          + "d\\Retail\\V2alpha\352\002\036Google::Cloud::Retail"
+          + "::V2alphab\006proto3"
     };
     descriptor =
         com.google.protobuf.Descriptors.FileDescriptor.internalBuildGeneratedFileFrom(
@@ -130,6 +146,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
               "DeviceType",
               "Dataset",
               "MaxSuggestions",
+              "EnableAttributeSuggestions",
             });
     internal_static_google_cloud_retail_v2alpha_CompleteQueryResponse_descriptor =
         getDescriptor().getMessageTypes().get(1);
@@ -137,7 +154,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
         new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable(
             internal_static_google_cloud_retail_v2alpha_CompleteQueryResponse_descriptor,
             new java.lang.String[] {
-              "CompletionResults", "AttributionToken", "RecentSearchResults",
+              "CompletionResults", "AttributionToken", "RecentSearchResults", "AttributeResults",
             });
     internal_static_google_cloud_retail_v2alpha_CompleteQueryResponse_CompletionResult_descriptor =
         internal_static_google_cloud_retail_v2alpha_CompleteQueryResponse_descriptor
@@ -169,6 +186,26 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
             new java.lang.String[] {
               "RecentSearch",
             });
+    internal_static_google_cloud_retail_v2alpha_CompleteQueryResponse_AttributeResult_descriptor =
+        internal_static_google_cloud_retail_v2alpha_CompleteQueryResponse_descriptor
+            .getNestedTypes()
+            .get(2);
+    internal_static_google_cloud_retail_v2alpha_CompleteQueryResponse_AttributeResult_fieldAccessorTable =
+        new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable(
+            internal_static_google_cloud_retail_v2alpha_CompleteQueryResponse_AttributeResult_descriptor,
+            new java.lang.String[] {
+              "Suggestions",
+            });
+    internal_static_google_cloud_retail_v2alpha_CompleteQueryResponse_AttributeResultsEntry_descriptor =
+        internal_static_google_cloud_retail_v2alpha_CompleteQueryResponse_descriptor
+            .getNestedTypes()
+            .get(3);
+    internal_static_google_cloud_retail_v2alpha_CompleteQueryResponse_AttributeResultsEntry_fieldAccessorTable =
+        new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable(
+            internal_static_google_cloud_retail_v2alpha_CompleteQueryResponse_AttributeResultsEntry_descriptor,
+            new java.lang.String[] {
+              "Key", "Value",
+            });
     com.google.protobuf.ExtensionRegistry registry =
         com.google.protobuf.ExtensionRegistry.newInstance();
     registry.add(com.google.api.ClientProto.defaultHost);
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/Condition.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/Condition.java
index f2f7426b9813..9e9025563055 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/Condition.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/Condition.java
@@ -86,8 +86,8 @@ public interface QueryTermOrBuilder
      * Value cannot be empty.
      * Value can have at most 3 terms if specified as a partial match. Each
      * space separated string is considered as one term.
-     * Example) "a b c" is 3 terms and allowed, " a b c d" is 4 terms and not
-     * allowed for partial match.
+     * For example, "a b c" is 3 terms and allowed, but " a b c d" is 4 terms
+     * and not allowed for a partial match.
      * 
      
      *
      * string value = 1;
@@ -103,8 +103,8 @@ public interface QueryTermOrBuilder
      * Value cannot be empty.
      * Value can have at most 3 terms if specified as a partial match. Each
      * space separated string is considered as one term.
-     * Example) "a b c" is 3 terms and allowed, " a b c d" is 4 terms and not
-     * allowed for partial match.
+     * For example, "a b c" is 3 terms and allowed, but " a b c d" is 4 terms
+     * and not allowed for a partial match.
      * 
      
      *
      * string value = 1;
@@ -185,8 +185,8 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
      * Value cannot be empty.
      * Value can have at most 3 terms if specified as a partial match. Each
      * space separated string is considered as one term.
-     * Example) "a b c" is 3 terms and allowed, " a b c d" is 4 terms and not
-     * allowed for partial match.
+     * For example, "a b c" is 3 terms and allowed, but " a b c d" is 4 terms
+     * and not allowed for a partial match.
      * 
      
      *
      * string value = 1;
@@ -213,8 +213,8 @@ public java.lang.String getValue() {
      * Value cannot be empty.
      * Value can have at most 3 terms if specified as a partial match. Each
      * space separated string is considered as one term.
-     * Example) "a b c" is 3 terms and allowed, " a b c d" is 4 terms and not
-     * allowed for partial match.
+     * For example, "a b c" is 3 terms and allowed, but " a b c d" is 4 terms
+     * and not allowed for a partial match.
      * 
      
      *
      * string value = 1;
@@ -617,8 +617,8 @@ public Builder mergeFrom(
        * Value cannot be empty.
        * Value can have at most 3 terms if specified as a partial match. Each
        * space separated string is considered as one term.
-       * Example) "a b c" is 3 terms and allowed, " a b c d" is 4 terms and not
-       * allowed for partial match.
+       * For example, "a b c" is 3 terms and allowed, but " a b c d" is 4 terms
+       * and not allowed for a partial match.
        * 
      
        *
        * string value = 1;
@@ -644,8 +644,8 @@ public java.lang.String getValue() {
        * Value cannot be empty.
        * Value can have at most 3 terms if specified as a partial match. Each
        * space separated string is considered as one term.
-       * Example) "a b c" is 3 terms and allowed, " a b c d" is 4 terms and not
-       * allowed for partial match.
+       * For example, "a b c" is 3 terms and allowed, but " a b c d" is 4 terms
+       * and not allowed for a partial match.
        * 
      
        *
        * string value = 1;
@@ -671,8 +671,8 @@ public com.google.protobuf.ByteString getValueBytes() {
        * Value cannot be empty.
        * Value can have at most 3 terms if specified as a partial match. Each
        * space separated string is considered as one term.
-       * Example) "a b c" is 3 terms and allowed, " a b c d" is 4 terms and not
-       * allowed for partial match.
+       * For example, "a b c" is 3 terms and allowed, but " a b c d" is 4 terms
+       * and not allowed for a partial match.
        * 
      
        *
        * string value = 1;
@@ -697,8 +697,8 @@ public Builder setValue(java.lang.String value) {
        * Value cannot be empty.
        * Value can have at most 3 terms if specified as a partial match. Each
        * space separated string is considered as one term.
-       * Example) "a b c" is 3 terms and allowed, " a b c d" is 4 terms and not
-       * allowed for partial match.
+       * For example, "a b c" is 3 terms and allowed, but " a b c d" is 4 terms
+       * and not allowed for a partial match.
        * 
      
        *
        * string value = 1;
@@ -719,8 +719,8 @@ public Builder clearValue() {
        * Value cannot be empty.
        * Value can have at most 3 terms if specified as a partial match. Each
        * space separated string is considered as one term.
-       * Example) "a b c" is 3 terms and allowed, " a b c d" is 4 terms and not
-       * allowed for partial match.
+       * For example, "a b c" is 3 terms and allowed, but " a b c d" is 4 terms
+       * and not allowed for a partial match.
        * 
      
        *
        * string value = 1;
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/Control.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/Control.java
index ad1a92b1d802..78d82fb4970e 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/Control.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/Control.java
@@ -22,8 +22,9 @@
  *
  *
  * 
      - * Configures dynamic serving time metadata that is used to pre and post
- * process search/recommendation model results.
+ * Configures dynamic metadata that can be linked to a
+ * [ServingConfig][google.cloud.retail.v2alpha.ServingConfig] and affect search
+ * or recommendation results at serving time.
  * 
      
  *
  * Protobuf type {@code google.cloud.retail.v2alpha.Control}
@@ -79,6 +80,7 @@ public enum ControlCase
       implements
           com.google.protobuf.Internal.EnumLite,
           com.google.protobuf.AbstractMessage.InternalOneOfEnum {
+    @java.lang.Deprecated
     FACET_SPEC(3),
     RULE(4),
     CONTROL_NOT_SET(0);
@@ -125,13 +127,19 @@ public ControlCase getControlCase() {
    *
    * 
          * A facet specification to perform faceted search.
+   * Note that this field is deprecated and will throw NOT_IMPLEMENTED if
+   * used for creating a control.
    * 
      
    *
-   * .google.cloud.retail.v2alpha.SearchRequest.FacetSpec facet_spec = 3;
+   * .google.cloud.retail.v2alpha.SearchRequest.FacetSpec facet_spec = 3 [deprecated = true];
+   * 
    *
+   * @deprecated google.cloud.retail.v2alpha.Control.facet_spec is deprecated. See
+   *     google/cloud/retail/v2alpha/control.proto;l=51
    * @return Whether the facetSpec field is set.
    */
   @java.lang.Override
+  @java.lang.Deprecated
   public boolean hasFacetSpec() {
     return controlCase_ == 3;
   }
@@ -140,13 +148,19 @@ public boolean hasFacetSpec() {
    *
    * 
          * A facet specification to perform faceted search.
+   * Note that this field is deprecated and will throw NOT_IMPLEMENTED if
+   * used for creating a control.
    * 
      
    *
-   * .google.cloud.retail.v2alpha.SearchRequest.FacetSpec facet_spec = 3;
+   * .google.cloud.retail.v2alpha.SearchRequest.FacetSpec facet_spec = 3 [deprecated = true];
+   * 
    *
+   * @deprecated google.cloud.retail.v2alpha.Control.facet_spec is deprecated. See
+   *     google/cloud/retail/v2alpha/control.proto;l=51
    * @return The facetSpec.
    */
   @java.lang.Override
+  @java.lang.Deprecated
   public com.google.cloud.retail.v2alpha.SearchRequest.FacetSpec getFacetSpec() {
     if (controlCase_ == 3) {
       return (com.google.cloud.retail.v2alpha.SearchRequest.FacetSpec) control_;
@@ -158,11 +172,15 @@ public com.google.cloud.retail.v2alpha.SearchRequest.FacetSpec getFacetSpec() {
    *
    * 
          * A facet specification to perform faceted search.
+   * Note that this field is deprecated and will throw NOT_IMPLEMENTED if
+   * used for creating a control.
    * 
      
    *
-   * .google.cloud.retail.v2alpha.SearchRequest.FacetSpec facet_spec = 3;
+   * .google.cloud.retail.v2alpha.SearchRequest.FacetSpec facet_spec = 3 [deprecated = true];
+   * 
    */
   @java.lang.Override
+  @java.lang.Deprecated
   public com.google.cloud.retail.v2alpha.SearchRequest.FacetSpecOrBuilder getFacetSpecOrBuilder() {
     if (controlCase_ == 3) {
       return (com.google.cloud.retail.v2alpha.SearchRequest.FacetSpec) control_;
@@ -337,10 +355,13 @@ public com.google.protobuf.ByteString getDisplayNameBytes() {
    *
    *
    * 
      -   * Output only. List of serving configuration ids that that are associated
-   * with this control. Note the association is managed via the ServingConfig,
-   * this is an output only denormalizeed  view. Assumed to be in the same
-   * catalog.
+   * Output only. List of [serving
+   * config][google.cloud.retail.v2alpha.ServingConfig] ids that are associated
+   * with this control in the same
+   * [Catalog][google.cloud.retail.v2alpha.Catalog].
+   * Note the association is managed via the
+   * [ServingConfig][google.cloud.retail.v2alpha.ServingConfig], this is an
+   * output only denormalized view.
    * 
      
    *
    * 
@@ -356,10 +377,13 @@ public com.google.protobuf.ProtocolStringList getAssociatedServingConfigIdsList(
    *
    *
    * 
      -   * Output only. List of serving configuration ids that that are associated
-   * with this control. Note the association is managed via the ServingConfig,
-   * this is an output only denormalizeed  view. Assumed to be in the same
-   * catalog.
+   * Output only. List of [serving
+   * config][google.cloud.retail.v2alpha.ServingConfig] ids that are associated
+   * with this control in the same
+   * [Catalog][google.cloud.retail.v2alpha.Catalog].
+   * Note the association is managed via the
+   * [ServingConfig][google.cloud.retail.v2alpha.ServingConfig], this is an
+   * output only denormalized view.
    * 
      
    *
    * 
@@ -375,10 +399,13 @@ public int getAssociatedServingConfigIdsCount() {
    *
    *
    * 
      -   * Output only. List of serving configuration ids that that are associated
-   * with this control. Note the association is managed via the ServingConfig,
-   * this is an output only denormalizeed  view. Assumed to be in the same
-   * catalog.
+   * Output only. List of [serving
+   * config][google.cloud.retail.v2alpha.ServingConfig] ids that are associated
+   * with this control in the same
+   * [Catalog][google.cloud.retail.v2alpha.Catalog].
+   * Note the association is managed via the
+   * [ServingConfig][google.cloud.retail.v2alpha.ServingConfig], this is an
+   * output only denormalized view.
    * 
      
    *
    * 
@@ -395,10 +422,13 @@ public java.lang.String getAssociatedServingConfigIds(int index) {
    *
    *
    * 
      -   * Output only. List of serving configuration ids that that are associated
-   * with this control. Note the association is managed via the ServingConfig,
-   * this is an output only denormalizeed  view. Assumed to be in the same
-   * catalog.
+   * Output only. List of [serving
+   * config][google.cloud.retail.v2alpha.ServingConfig] ids that are associated
+   * with this control in the same
+   * [Catalog][google.cloud.retail.v2alpha.Catalog].
+   * Note the association is managed via the
+   * [ServingConfig][google.cloud.retail.v2alpha.ServingConfig], this is an
+   * output only denormalized view.
    * 
      
    *
    * 
@@ -432,12 +462,11 @@ public com.google.cloud.retail.v2alpha.SolutionType convert(java.lang.Integer fr
    *
    *
    * 
      -   * Required. Immutable. The solution types that the serving config is used
-   * for. Currently we support setting only one type of solution at creation
-   * time.
+   * Required. Immutable. The solution types that the control is used for.
+   * Currently we support setting only one type of solution at creation time.
    * Only `SOLUTION_TYPE_SEARCH` value is supported at the moment.
    * If no solution type is provided at creation time, will default to
-   * SOLUTION_TYPE_SEARCH.
+   * [SOLUTION_TYPE_SEARCH][google.cloud.retail.v2alpha.SolutionType.SOLUTION_TYPE_SEARCH].
    * 
      
    *
    * 
@@ -456,12 +485,11 @@ public java.util.List getSolutionT
    *
    *
    * 
      -   * Required. Immutable. The solution types that the serving config is used
-   * for. Currently we support setting only one type of solution at creation
-   * time.
+   * Required. Immutable. The solution types that the control is used for.
+   * Currently we support setting only one type of solution at creation time.
    * Only `SOLUTION_TYPE_SEARCH` value is supported at the moment.
    * If no solution type is provided at creation time, will default to
-   * SOLUTION_TYPE_SEARCH.
+   * [SOLUTION_TYPE_SEARCH][google.cloud.retail.v2alpha.SolutionType.SOLUTION_TYPE_SEARCH].
    * 
      
    *
    * 
@@ -478,12 +506,11 @@ public int getSolutionTypesCount() {
    *
    *
    * 
      -   * Required. Immutable. The solution types that the serving config is used
-   * for. Currently we support setting only one type of solution at creation
-   * time.
+   * Required. Immutable. The solution types that the control is used for.
+   * Currently we support setting only one type of solution at creation time.
    * Only `SOLUTION_TYPE_SEARCH` value is supported at the moment.
    * If no solution type is provided at creation time, will default to
-   * SOLUTION_TYPE_SEARCH.
+   * [SOLUTION_TYPE_SEARCH][google.cloud.retail.v2alpha.SolutionType.SOLUTION_TYPE_SEARCH].
    * 
      
    *
    * 
@@ -501,12 +528,11 @@ public com.google.cloud.retail.v2alpha.SolutionType getSolutionTypes(int index)
    *
    *
    * 
      -   * Required. Immutable. The solution types that the serving config is used
-   * for. Currently we support setting only one type of solution at creation
-   * time.
+   * Required. Immutable. The solution types that the control is used for.
+   * Currently we support setting only one type of solution at creation time.
    * Only `SOLUTION_TYPE_SEARCH` value is supported at the moment.
    * If no solution type is provided at creation time, will default to
-   * SOLUTION_TYPE_SEARCH.
+   * [SOLUTION_TYPE_SEARCH][google.cloud.retail.v2alpha.SolutionType.SOLUTION_TYPE_SEARCH].
    * 
      
    *
    * 
@@ -523,12 +549,11 @@ public java.util.List getSolutionTypesValueList() {
    *
    *
    * 
      -   * Required. Immutable. The solution types that the serving config is used
-   * for. Currently we support setting only one type of solution at creation
-   * time.
+   * Required. Immutable. The solution types that the control is used for.
+   * Currently we support setting only one type of solution at creation time.
    * Only `SOLUTION_TYPE_SEARCH` value is supported at the moment.
    * If no solution type is provided at creation time, will default to
-   * SOLUTION_TYPE_SEARCH.
+   * [SOLUTION_TYPE_SEARCH][google.cloud.retail.v2alpha.SolutionType.SOLUTION_TYPE_SEARCH].
    * 
      
    *
    * 
@@ -566,15 +591,16 @@ public com.google.cloud.retail.v2alpha.SearchSolutionUseCase convert(
    *
    *
    * 
      -   * Required. Specifies the use case for the control.
+   * Specifies the use case for the control.
    * Affects what condition fields can be set.
    * Only settable by search controls.
-   * Will default to SEARCH_SOLUTION_USE_CASE_SEARCH if not specified.
-   * Currently only allow one search_solution_use_case per control.
+   * Will default to
+   * [SEARCH_SOLUTION_USE_CASE_SEARCH][google.cloud.retail.v2alpha.SearchSolutionUseCase.SEARCH_SOLUTION_USE_CASE_SEARCH]
+   * if not specified. Currently only allow one search_solution_use_case per
+   * control.
    * 
      
    *
-   * 
-   * repeated .google.cloud.retail.v2alpha.SearchSolutionUseCase search_solution_use_case = 7 [(.google.api.field_behavior) = REQUIRED];
+   * repeated .google.cloud.retail.v2alpha.SearchSolutionUseCase search_solution_use_case = 7;
    * 
    *
    * @return A list containing the searchSolutionUseCase.
@@ -590,15 +616,16 @@ public com.google.cloud.retail.v2alpha.SearchSolutionUseCase convert(
    *
    *
    * 
      -   * Required. Specifies the use case for the control.
+   * Specifies the use case for the control.
    * Affects what condition fields can be set.
    * Only settable by search controls.
-   * Will default to SEARCH_SOLUTION_USE_CASE_SEARCH if not specified.
-   * Currently only allow one search_solution_use_case per control.
+   * Will default to
+   * [SEARCH_SOLUTION_USE_CASE_SEARCH][google.cloud.retail.v2alpha.SearchSolutionUseCase.SEARCH_SOLUTION_USE_CASE_SEARCH]
+   * if not specified. Currently only allow one search_solution_use_case per
+   * control.
    * 
      
    *
-   * 
-   * repeated .google.cloud.retail.v2alpha.SearchSolutionUseCase search_solution_use_case = 7 [(.google.api.field_behavior) = REQUIRED];
+   * repeated .google.cloud.retail.v2alpha.SearchSolutionUseCase search_solution_use_case = 7;
    * 
    *
    * @return The count of searchSolutionUseCase.
@@ -611,15 +638,16 @@ public int getSearchSolutionUseCaseCount() {
    *
    *
    * 
      -   * Required. Specifies the use case for the control.
+   * Specifies the use case for the control.
    * Affects what condition fields can be set.
    * Only settable by search controls.
-   * Will default to SEARCH_SOLUTION_USE_CASE_SEARCH if not specified.
-   * Currently only allow one search_solution_use_case per control.
+   * Will default to
+   * [SEARCH_SOLUTION_USE_CASE_SEARCH][google.cloud.retail.v2alpha.SearchSolutionUseCase.SEARCH_SOLUTION_USE_CASE_SEARCH]
+   * if not specified. Currently only allow one search_solution_use_case per
+   * control.
    * 
      
    *
-   * 
-   * repeated .google.cloud.retail.v2alpha.SearchSolutionUseCase search_solution_use_case = 7 [(.google.api.field_behavior) = REQUIRED];
+   * repeated .google.cloud.retail.v2alpha.SearchSolutionUseCase search_solution_use_case = 7;
    * 
    *
    * @param index The index of the element to return.
@@ -633,15 +661,16 @@ public com.google.cloud.retail.v2alpha.SearchSolutionUseCase getSearchSolutionUs
    *
    *
    * 
      -   * Required. Specifies the use case for the control.
+   * Specifies the use case for the control.
    * Affects what condition fields can be set.
    * Only settable by search controls.
-   * Will default to SEARCH_SOLUTION_USE_CASE_SEARCH if not specified.
-   * Currently only allow one search_solution_use_case per control.
+   * Will default to
+   * [SEARCH_SOLUTION_USE_CASE_SEARCH][google.cloud.retail.v2alpha.SearchSolutionUseCase.SEARCH_SOLUTION_USE_CASE_SEARCH]
+   * if not specified. Currently only allow one search_solution_use_case per
+   * control.
    * 
      
    *
-   * 
-   * repeated .google.cloud.retail.v2alpha.SearchSolutionUseCase search_solution_use_case = 7 [(.google.api.field_behavior) = REQUIRED];
+   * repeated .google.cloud.retail.v2alpha.SearchSolutionUseCase search_solution_use_case = 7;
    * 
    *
    * @return A list containing the enum numeric values on the wire for searchSolutionUseCase.
@@ -654,15 +683,16 @@ public java.util.List getSearchSolutionUseCaseValueList() {
    *
    *
    * 
      -   * Required. Specifies the use case for the control.
+   * Specifies the use case for the control.
    * Affects what condition fields can be set.
    * Only settable by search controls.
-   * Will default to SEARCH_SOLUTION_USE_CASE_SEARCH if not specified.
-   * Currently only allow one search_solution_use_case per control.
+   * Will default to
+   * [SEARCH_SOLUTION_USE_CASE_SEARCH][google.cloud.retail.v2alpha.SearchSolutionUseCase.SEARCH_SOLUTION_USE_CASE_SEARCH]
+   * if not specified. Currently only allow one search_solution_use_case per
+   * control.
    * 
      
    *
-   * 
-   * repeated .google.cloud.retail.v2alpha.SearchSolutionUseCase search_solution_use_case = 7 [(.google.api.field_behavior) = REQUIRED];
+   * repeated .google.cloud.retail.v2alpha.SearchSolutionUseCase search_solution_use_case = 7;
    * 
    *
    * @param index The index of the value to return.
@@ -955,8 +985,9 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
    *
    *
    * 
      -   * Configures dynamic serving time metadata that is used to pre and post
-   * process search/recommendation model results.
+   * Configures dynamic metadata that can be linked to a
+   * [ServingConfig][google.cloud.retail.v2alpha.ServingConfig] and affect search
+   * or recommendation results at serving time.
    * 
      
    *
    * Protobuf type {@code google.cloud.retail.v2alpha.Control}
@@ -1309,13 +1340,20 @@ public Builder clearControl() {
      *
      * 
            * A facet specification to perform faceted search.
+     * Note that this field is deprecated and will throw NOT_IMPLEMENTED if
+     * used for creating a control.
      * 
      
      *
-     * .google.cloud.retail.v2alpha.SearchRequest.FacetSpec facet_spec = 3;
+     * 
+     * .google.cloud.retail.v2alpha.SearchRequest.FacetSpec facet_spec = 3 [deprecated = true];
+     * 
      *
+     * @deprecated google.cloud.retail.v2alpha.Control.facet_spec is deprecated. See
+     *     google/cloud/retail/v2alpha/control.proto;l=51
      * @return Whether the facetSpec field is set.
      */
     @java.lang.Override
+    @java.lang.Deprecated
     public boolean hasFacetSpec() {
       return controlCase_ == 3;
     }
@@ -1324,13 +1362,20 @@ public boolean hasFacetSpec() {
      *
      * 
            * A facet specification to perform faceted search.
+     * Note that this field is deprecated and will throw NOT_IMPLEMENTED if
+     * used for creating a control.
      * 
      
      *
-     * .google.cloud.retail.v2alpha.SearchRequest.FacetSpec facet_spec = 3;
+     * 
+     * .google.cloud.retail.v2alpha.SearchRequest.FacetSpec facet_spec = 3 [deprecated = true];
+     * 
      *
+     * @deprecated google.cloud.retail.v2alpha.Control.facet_spec is deprecated. See
+     *     google/cloud/retail/v2alpha/control.proto;l=51
      * @return The facetSpec.
      */
     @java.lang.Override
+    @java.lang.Deprecated
     public com.google.cloud.retail.v2alpha.SearchRequest.FacetSpec getFacetSpec() {
       if (facetSpecBuilder_ == null) {
         if (controlCase_ == 3) {
@@ -1349,10 +1394,15 @@ public com.google.cloud.retail.v2alpha.SearchRequest.FacetSpec getFacetSpec() {
      *
      * 
            * A facet specification to perform faceted search.
+     * Note that this field is deprecated and will throw NOT_IMPLEMENTED if
+     * used for creating a control.
      * 
      
      *
-     * .google.cloud.retail.v2alpha.SearchRequest.FacetSpec facet_spec = 3;
+     * 
+     * .google.cloud.retail.v2alpha.SearchRequest.FacetSpec facet_spec = 3 [deprecated = true];
+     * 
      */
+    @java.lang.Deprecated
     public Builder setFacetSpec(com.google.cloud.retail.v2alpha.SearchRequest.FacetSpec value) {
       if (facetSpecBuilder_ == null) {
         if (value == null) {
@@ -1371,10 +1421,15 @@ public Builder setFacetSpec(com.google.cloud.retail.v2alpha.SearchRequest.FacetS
      *
      * 
            * A facet specification to perform faceted search.
+     * Note that this field is deprecated and will throw NOT_IMPLEMENTED if
+     * used for creating a control.
      * 
      
      *
-     * .google.cloud.retail.v2alpha.SearchRequest.FacetSpec facet_spec = 3;
+     * 
+     * .google.cloud.retail.v2alpha.SearchRequest.FacetSpec facet_spec = 3 [deprecated = true];
+     * 
      */
+    @java.lang.Deprecated
     public Builder setFacetSpec(
         com.google.cloud.retail.v2alpha.SearchRequest.FacetSpec.Builder builderForValue) {
       if (facetSpecBuilder_ == null) {
@@ -1391,10 +1446,15 @@ public Builder setFacetSpec(
      *
      * 
            * A facet specification to perform faceted search.
+     * Note that this field is deprecated and will throw NOT_IMPLEMENTED if
+     * used for creating a control.
      * 
      
      *
-     * .google.cloud.retail.v2alpha.SearchRequest.FacetSpec facet_spec = 3;
+     * 
+     * .google.cloud.retail.v2alpha.SearchRequest.FacetSpec facet_spec = 3 [deprecated = true];
+     * 
      */
+    @java.lang.Deprecated
     public Builder mergeFacetSpec(com.google.cloud.retail.v2alpha.SearchRequest.FacetSpec value) {
       if (facetSpecBuilder_ == null) {
         if (controlCase_ == 3
@@ -1424,10 +1484,15 @@ public Builder mergeFacetSpec(com.google.cloud.retail.v2alpha.SearchRequest.Face
      *
      * 
            * A facet specification to perform faceted search.
+     * Note that this field is deprecated and will throw NOT_IMPLEMENTED if
+     * used for creating a control.
      * 
      
      *
-     * .google.cloud.retail.v2alpha.SearchRequest.FacetSpec facet_spec = 3;
+     * 
+     * .google.cloud.retail.v2alpha.SearchRequest.FacetSpec facet_spec = 3 [deprecated = true];
+     * 
      */
+    @java.lang.Deprecated
     public Builder clearFacetSpec() {
       if (facetSpecBuilder_ == null) {
         if (controlCase_ == 3) {
@@ -1449,10 +1514,15 @@ public Builder clearFacetSpec() {
      *
      * 
            * A facet specification to perform faceted search.
+     * Note that this field is deprecated and will throw NOT_IMPLEMENTED if
+     * used for creating a control.
      * 
      
      *
-     * .google.cloud.retail.v2alpha.SearchRequest.FacetSpec facet_spec = 3;
+     * 
+     * .google.cloud.retail.v2alpha.SearchRequest.FacetSpec facet_spec = 3 [deprecated = true];
+     * 
      */
+    @java.lang.Deprecated
     public com.google.cloud.retail.v2alpha.SearchRequest.FacetSpec.Builder getFacetSpecBuilder() {
       return getFacetSpecFieldBuilder().getBuilder();
     }
@@ -1461,11 +1531,16 @@ public com.google.cloud.retail.v2alpha.SearchRequest.FacetSpec.Builder getFacetS
      *
      * 
            * A facet specification to perform faceted search.
+     * Note that this field is deprecated and will throw NOT_IMPLEMENTED if
+     * used for creating a control.
      * 
      
      *
-     * .google.cloud.retail.v2alpha.SearchRequest.FacetSpec facet_spec = 3;
+     * 
+     * .google.cloud.retail.v2alpha.SearchRequest.FacetSpec facet_spec = 3 [deprecated = true];
+     * 
      */
     @java.lang.Override
+    @java.lang.Deprecated
     public com.google.cloud.retail.v2alpha.SearchRequest.FacetSpecOrBuilder
         getFacetSpecOrBuilder() {
       if ((controlCase_ == 3) && (facetSpecBuilder_ != null)) {
@@ -1482,9 +1557,13 @@ public com.google.cloud.retail.v2alpha.SearchRequest.FacetSpec.Builder getFacetS
      *
      * 
            * A facet specification to perform faceted search.
+     * Note that this field is deprecated and will throw NOT_IMPLEMENTED if
+     * used for creating a control.
      * 
      
      *
-     * .google.cloud.retail.v2alpha.SearchRequest.FacetSpec facet_spec = 3;
+     * 
+     * .google.cloud.retail.v2alpha.SearchRequest.FacetSpec facet_spec = 3 [deprecated = true];
+     * 
      */
     private com.google.protobuf.SingleFieldBuilderV3<
             com.google.cloud.retail.v2alpha.SearchRequest.FacetSpec,
@@ -1977,10 +2056,13 @@ private void ensureAssociatedServingConfigIdsIsMutable() {
      *
      *
      * 
      -     * Output only. List of serving configuration ids that that are associated
-     * with this control. Note the association is managed via the ServingConfig,
-     * this is an output only denormalizeed  view. Assumed to be in the same
-     * catalog.
+     * Output only. List of [serving
+     * config][google.cloud.retail.v2alpha.ServingConfig] ids that are associated
+     * with this control in the same
+     * [Catalog][google.cloud.retail.v2alpha.Catalog].
+     * Note the association is managed via the
+     * [ServingConfig][google.cloud.retail.v2alpha.ServingConfig], this is an
+     * output only denormalized view.
      * 
      
      *
      * 
@@ -1996,10 +2078,13 @@ public com.google.protobuf.ProtocolStringList getAssociatedServingConfigIdsList(
      *
      *
      * 
      -     * Output only. List of serving configuration ids that that are associated
-     * with this control. Note the association is managed via the ServingConfig,
-     * this is an output only denormalizeed  view. Assumed to be in the same
-     * catalog.
+     * Output only. List of [serving
+     * config][google.cloud.retail.v2alpha.ServingConfig] ids that are associated
+     * with this control in the same
+     * [Catalog][google.cloud.retail.v2alpha.Catalog].
+     * Note the association is managed via the
+     * [ServingConfig][google.cloud.retail.v2alpha.ServingConfig], this is an
+     * output only denormalized view.
      * 
      
      *
      * 
@@ -2015,10 +2100,13 @@ public int getAssociatedServingConfigIdsCount() {
      *
      *
      * 
      -     * Output only. List of serving configuration ids that that are associated
-     * with this control. Note the association is managed via the ServingConfig,
-     * this is an output only denormalizeed  view. Assumed to be in the same
-     * catalog.
+     * Output only. List of [serving
+     * config][google.cloud.retail.v2alpha.ServingConfig] ids that are associated
+     * with this control in the same
+     * [Catalog][google.cloud.retail.v2alpha.Catalog].
+     * Note the association is managed via the
+     * [ServingConfig][google.cloud.retail.v2alpha.ServingConfig], this is an
+     * output only denormalized view.
      * 
      
      *
      * 
@@ -2035,10 +2123,13 @@ public java.lang.String getAssociatedServingConfigIds(int index) {
      *
      *
      * 
      -     * Output only. List of serving configuration ids that that are associated
-     * with this control. Note the association is managed via the ServingConfig,
-     * this is an output only denormalizeed  view. Assumed to be in the same
-     * catalog.
+     * Output only. List of [serving
+     * config][google.cloud.retail.v2alpha.ServingConfig] ids that are associated
+     * with this control in the same
+     * [Catalog][google.cloud.retail.v2alpha.Catalog].
+     * Note the association is managed via the
+     * [ServingConfig][google.cloud.retail.v2alpha.ServingConfig], this is an
+     * output only denormalized view.
      * 
      
      *
      * 
@@ -2055,10 +2146,13 @@ public com.google.protobuf.ByteString getAssociatedServingConfigIdsBytes(int ind
      *
      *
      * 
      -     * Output only. List of serving configuration ids that that are associated
-     * with this control. Note the association is managed via the ServingConfig,
-     * this is an output only denormalizeed  view. Assumed to be in the same
-     * catalog.
+     * Output only. List of [serving
+     * config][google.cloud.retail.v2alpha.ServingConfig] ids that are associated
+     * with this control in the same
+     * [Catalog][google.cloud.retail.v2alpha.Catalog].
+     * Note the association is managed via the
+     * [ServingConfig][google.cloud.retail.v2alpha.ServingConfig], this is an
+     * output only denormalized view.
      * 
      
      *
      * 
@@ -2082,10 +2176,13 @@ public Builder setAssociatedServingConfigIds(int index, java.lang.String value)
      *
      *
      * 
      -     * Output only. List of serving configuration ids that that are associated
-     * with this control. Note the association is managed via the ServingConfig,
-     * this is an output only denormalizeed  view. Assumed to be in the same
-     * catalog.
+     * Output only. List of [serving
+     * config][google.cloud.retail.v2alpha.ServingConfig] ids that are associated
+     * with this control in the same
+     * [Catalog][google.cloud.retail.v2alpha.Catalog].
+     * Note the association is managed via the
+     * [ServingConfig][google.cloud.retail.v2alpha.ServingConfig], this is an
+     * output only denormalized view.
      * 
      
      *
      * 
@@ -2108,10 +2205,13 @@ public Builder addAssociatedServingConfigIds(java.lang.String value) {
      *
      *
      * 
      -     * Output only. List of serving configuration ids that that are associated
-     * with this control. Note the association is managed via the ServingConfig,
-     * this is an output only denormalizeed  view. Assumed to be in the same
-     * catalog.
+     * Output only. List of [serving
+     * config][google.cloud.retail.v2alpha.ServingConfig] ids that are associated
+     * with this control in the same
+     * [Catalog][google.cloud.retail.v2alpha.Catalog].
+     * Note the association is managed via the
+     * [ServingConfig][google.cloud.retail.v2alpha.ServingConfig], this is an
+     * output only denormalized view.
      * 
      
      *
      * 
@@ -2131,10 +2231,13 @@ public Builder addAllAssociatedServingConfigIds(java.lang.Iterable
-     * Output only. List of serving configuration ids that that are associated
-     * with this control. Note the association is managed via the ServingConfig,
-     * this is an output only denormalizeed  view. Assumed to be in the same
-     * catalog.
+     * Output only. List of [serving
+     * config][google.cloud.retail.v2alpha.ServingConfig] ids that are associated
+     * with this control in the same
+     * [Catalog][google.cloud.retail.v2alpha.Catalog].
+     * Note the association is managed via the
+     * [ServingConfig][google.cloud.retail.v2alpha.ServingConfig], this is an
+     * output only denormalized view.
      * 
      
      *
      * 
@@ -2153,10 +2256,13 @@ public Builder clearAssociatedServingConfigIds() {
      *
      *
      * 
      -     * Output only. List of serving configuration ids that that are associated
-     * with this control. Note the association is managed via the ServingConfig,
-     * this is an output only denormalizeed  view. Assumed to be in the same
-     * catalog.
+     * Output only. List of [serving
+     * config][google.cloud.retail.v2alpha.ServingConfig] ids that are associated
+     * with this control in the same
+     * [Catalog][google.cloud.retail.v2alpha.Catalog].
+     * Note the association is managed via the
+     * [ServingConfig][google.cloud.retail.v2alpha.ServingConfig], this is an
+     * output only denormalized view.
      * 
      
      *
      * 
@@ -2189,12 +2295,11 @@ private void ensureSolutionTypesIsMutable() {
      *
      *
      * 
      -     * Required. Immutable. The solution types that the serving config is used
-     * for. Currently we support setting only one type of solution at creation
-     * time.
+     * Required. Immutable. The solution types that the control is used for.
+     * Currently we support setting only one type of solution at creation time.
      * Only `SOLUTION_TYPE_SEARCH` value is supported at the moment.
      * If no solution type is provided at creation time, will default to
-     * SOLUTION_TYPE_SEARCH.
+     * [SOLUTION_TYPE_SEARCH][google.cloud.retail.v2alpha.SolutionType.SOLUTION_TYPE_SEARCH].
      * 
      
      *
      * 
@@ -2212,12 +2317,11 @@ public java.util.List getSolutionT
      *
      *
      * 
      -     * Required. Immutable. The solution types that the serving config is used
-     * for. Currently we support setting only one type of solution at creation
-     * time.
+     * Required. Immutable. The solution types that the control is used for.
+     * Currently we support setting only one type of solution at creation time.
      * Only `SOLUTION_TYPE_SEARCH` value is supported at the moment.
      * If no solution type is provided at creation time, will default to
-     * SOLUTION_TYPE_SEARCH.
+     * [SOLUTION_TYPE_SEARCH][google.cloud.retail.v2alpha.SolutionType.SOLUTION_TYPE_SEARCH].
      * 
      
      *
      * 
@@ -2233,12 +2337,11 @@ public int getSolutionTypesCount() {
      *
      *
      * 
      -     * Required. Immutable. The solution types that the serving config is used
-     * for. Currently we support setting only one type of solution at creation
-     * time.
+     * Required. Immutable. The solution types that the control is used for.
+     * Currently we support setting only one type of solution at creation time.
      * Only `SOLUTION_TYPE_SEARCH` value is supported at the moment.
      * If no solution type is provided at creation time, will default to
-     * SOLUTION_TYPE_SEARCH.
+     * [SOLUTION_TYPE_SEARCH][google.cloud.retail.v2alpha.SolutionType.SOLUTION_TYPE_SEARCH].
      * 
      
      *
      * 
@@ -2255,12 +2358,11 @@ public com.google.cloud.retail.v2alpha.SolutionType getSolutionTypes(int index)
      *
      *
      * 
      -     * Required. Immutable. The solution types that the serving config is used
-     * for. Currently we support setting only one type of solution at creation
-     * time.
+     * Required. Immutable. The solution types that the control is used for.
+     * Currently we support setting only one type of solution at creation time.
      * Only `SOLUTION_TYPE_SEARCH` value is supported at the moment.
      * If no solution type is provided at creation time, will default to
-     * SOLUTION_TYPE_SEARCH.
+     * [SOLUTION_TYPE_SEARCH][google.cloud.retail.v2alpha.SolutionType.SOLUTION_TYPE_SEARCH].
      * 
      
      *
      * 
@@ -2284,12 +2386,11 @@ public Builder setSolutionTypes(int index, com.google.cloud.retail.v2alpha.Solut
      *
      *
      * 
      -     * Required. Immutable. The solution types that the serving config is used
-     * for. Currently we support setting only one type of solution at creation
-     * time.
+     * Required. Immutable. The solution types that the control is used for.
+     * Currently we support setting only one type of solution at creation time.
      * Only `SOLUTION_TYPE_SEARCH` value is supported at the moment.
      * If no solution type is provided at creation time, will default to
-     * SOLUTION_TYPE_SEARCH.
+     * [SOLUTION_TYPE_SEARCH][google.cloud.retail.v2alpha.SolutionType.SOLUTION_TYPE_SEARCH].
      * 
      
      *
      * 
@@ -2312,12 +2413,11 @@ public Builder addSolutionTypes(com.google.cloud.retail.v2alpha.SolutionType val
      *
      *
      * 
      -     * Required. Immutable. The solution types that the serving config is used
-     * for. Currently we support setting only one type of solution at creation
-     * time.
+     * Required. Immutable. The solution types that the control is used for.
+     * Currently we support setting only one type of solution at creation time.
      * Only `SOLUTION_TYPE_SEARCH` value is supported at the moment.
      * If no solution type is provided at creation time, will default to
-     * SOLUTION_TYPE_SEARCH.
+     * [SOLUTION_TYPE_SEARCH][google.cloud.retail.v2alpha.SolutionType.SOLUTION_TYPE_SEARCH].
      * 
      
      *
      * 
@@ -2340,12 +2440,11 @@ public Builder addAllSolutionTypes(
      *
      *
      * 
      -     * Required. Immutable. The solution types that the serving config is used
-     * for. Currently we support setting only one type of solution at creation
-     * time.
+     * Required. Immutable. The solution types that the control is used for.
+     * Currently we support setting only one type of solution at creation time.
      * Only `SOLUTION_TYPE_SEARCH` value is supported at the moment.
      * If no solution type is provided at creation time, will default to
-     * SOLUTION_TYPE_SEARCH.
+     * [SOLUTION_TYPE_SEARCH][google.cloud.retail.v2alpha.SolutionType.SOLUTION_TYPE_SEARCH].
      * 
      
      *
      * 
@@ -2364,12 +2463,11 @@ public Builder clearSolutionTypes() {
      *
      *
      * 
      -     * Required. Immutable. The solution types that the serving config is used
-     * for. Currently we support setting only one type of solution at creation
-     * time.
+     * Required. Immutable. The solution types that the control is used for.
+     * Currently we support setting only one type of solution at creation time.
      * Only `SOLUTION_TYPE_SEARCH` value is supported at the moment.
      * If no solution type is provided at creation time, will default to
-     * SOLUTION_TYPE_SEARCH.
+     * [SOLUTION_TYPE_SEARCH][google.cloud.retail.v2alpha.SolutionType.SOLUTION_TYPE_SEARCH].
      * 
      
      *
      * 
@@ -2385,12 +2483,11 @@ public java.util.List getSolutionTypesValueList() {
      *
      *
      * 
      -     * Required. Immutable. The solution types that the serving config is used
-     * for. Currently we support setting only one type of solution at creation
-     * time.
+     * Required. Immutable. The solution types that the control is used for.
+     * Currently we support setting only one type of solution at creation time.
      * Only `SOLUTION_TYPE_SEARCH` value is supported at the moment.
      * If no solution type is provided at creation time, will default to
-     * SOLUTION_TYPE_SEARCH.
+     * [SOLUTION_TYPE_SEARCH][google.cloud.retail.v2alpha.SolutionType.SOLUTION_TYPE_SEARCH].
      * 
      
      *
      * 
@@ -2407,12 +2504,11 @@ public int getSolutionTypesValue(int index) {
      *
      *
      * 
      -     * Required. Immutable. The solution types that the serving config is used
-     * for. Currently we support setting only one type of solution at creation
-     * time.
+     * Required. Immutable. The solution types that the control is used for.
+     * Currently we support setting only one type of solution at creation time.
      * Only `SOLUTION_TYPE_SEARCH` value is supported at the moment.
      * If no solution type is provided at creation time, will default to
-     * SOLUTION_TYPE_SEARCH.
+     * [SOLUTION_TYPE_SEARCH][google.cloud.retail.v2alpha.SolutionType.SOLUTION_TYPE_SEARCH].
      * 
      
      *
      * 
@@ -2433,12 +2529,11 @@ public Builder setSolutionTypesValue(int index, int value) {
      *
      *
      * 
      -     * Required. Immutable. The solution types that the serving config is used
-     * for. Currently we support setting only one type of solution at creation
-     * time.
+     * Required. Immutable. The solution types that the control is used for.
+     * Currently we support setting only one type of solution at creation time.
      * Only `SOLUTION_TYPE_SEARCH` value is supported at the moment.
      * If no solution type is provided at creation time, will default to
-     * SOLUTION_TYPE_SEARCH.
+     * [SOLUTION_TYPE_SEARCH][google.cloud.retail.v2alpha.SolutionType.SOLUTION_TYPE_SEARCH].
      * 
      
      *
      * 
@@ -2458,12 +2553,11 @@ public Builder addSolutionTypesValue(int value) {
      *
      *
      * 
      -     * Required. Immutable. The solution types that the serving config is used
-     * for. Currently we support setting only one type of solution at creation
-     * time.
+     * Required. Immutable. The solution types that the control is used for.
+     * Currently we support setting only one type of solution at creation time.
      * Only `SOLUTION_TYPE_SEARCH` value is supported at the moment.
      * If no solution type is provided at creation time, will default to
-     * SOLUTION_TYPE_SEARCH.
+     * [SOLUTION_TYPE_SEARCH][google.cloud.retail.v2alpha.SolutionType.SOLUTION_TYPE_SEARCH].
      * 
      
      *
      * 
@@ -2495,15 +2589,17 @@ private void ensureSearchSolutionUseCaseIsMutable() {
      *
      *
      * 
      -     * Required. Specifies the use case for the control.
+     * Specifies the use case for the control.
      * Affects what condition fields can be set.
      * Only settable by search controls.
-     * Will default to SEARCH_SOLUTION_USE_CASE_SEARCH if not specified.
-     * Currently only allow one search_solution_use_case per control.
+     * Will default to
+     * [SEARCH_SOLUTION_USE_CASE_SEARCH][google.cloud.retail.v2alpha.SearchSolutionUseCase.SEARCH_SOLUTION_USE_CASE_SEARCH]
+     * if not specified. Currently only allow one search_solution_use_case per
+     * control.
      * 
      
      *
      * 
-     * repeated .google.cloud.retail.v2alpha.SearchSolutionUseCase search_solution_use_case = 7 [(.google.api.field_behavior) = REQUIRED];
+     * repeated .google.cloud.retail.v2alpha.SearchSolutionUseCase search_solution_use_case = 7;
      * 
      *
      * @return A list containing the searchSolutionUseCase.
@@ -2518,15 +2614,17 @@ private void ensureSearchSolutionUseCaseIsMutable() {
      *
      *
      * 
      -     * Required. Specifies the use case for the control.
+     * Specifies the use case for the control.
      * Affects what condition fields can be set.
      * Only settable by search controls.
-     * Will default to SEARCH_SOLUTION_USE_CASE_SEARCH if not specified.
-     * Currently only allow one search_solution_use_case per control.
+     * Will default to
+     * [SEARCH_SOLUTION_USE_CASE_SEARCH][google.cloud.retail.v2alpha.SearchSolutionUseCase.SEARCH_SOLUTION_USE_CASE_SEARCH]
+     * if not specified. Currently only allow one search_solution_use_case per
+     * control.
      * 
      
      *
      * 
-     * repeated .google.cloud.retail.v2alpha.SearchSolutionUseCase search_solution_use_case = 7 [(.google.api.field_behavior) = REQUIRED];
+     * repeated .google.cloud.retail.v2alpha.SearchSolutionUseCase search_solution_use_case = 7;
      * 
      *
      * @return The count of searchSolutionUseCase.
@@ -2538,15 +2636,17 @@ public int getSearchSolutionUseCaseCount() {
      *
      *
      * 
      -     * Required. Specifies the use case for the control.
+     * Specifies the use case for the control.
      * Affects what condition fields can be set.
      * Only settable by search controls.
-     * Will default to SEARCH_SOLUTION_USE_CASE_SEARCH if not specified.
-     * Currently only allow one search_solution_use_case per control.
+     * Will default to
+     * [SEARCH_SOLUTION_USE_CASE_SEARCH][google.cloud.retail.v2alpha.SearchSolutionUseCase.SEARCH_SOLUTION_USE_CASE_SEARCH]
+     * if not specified. Currently only allow one search_solution_use_case per
+     * control.
      * 
      
      *
      * 
-     * repeated .google.cloud.retail.v2alpha.SearchSolutionUseCase search_solution_use_case = 7 [(.google.api.field_behavior) = REQUIRED];
+     * repeated .google.cloud.retail.v2alpha.SearchSolutionUseCase search_solution_use_case = 7;
      * 
      *
      * @param index The index of the element to return.
@@ -2560,15 +2660,17 @@ public com.google.cloud.retail.v2alpha.SearchSolutionUseCase getSearchSolutionUs
      *
      *
      * 
      -     * Required. Specifies the use case for the control.
+     * Specifies the use case for the control.
      * Affects what condition fields can be set.
      * Only settable by search controls.
-     * Will default to SEARCH_SOLUTION_USE_CASE_SEARCH if not specified.
-     * Currently only allow one search_solution_use_case per control.
+     * Will default to
+     * [SEARCH_SOLUTION_USE_CASE_SEARCH][google.cloud.retail.v2alpha.SearchSolutionUseCase.SEARCH_SOLUTION_USE_CASE_SEARCH]
+     * if not specified. Currently only allow one search_solution_use_case per
+     * control.
      * 
      
      *
      * 
-     * repeated .google.cloud.retail.v2alpha.SearchSolutionUseCase search_solution_use_case = 7 [(.google.api.field_behavior) = REQUIRED];
+     * repeated .google.cloud.retail.v2alpha.SearchSolutionUseCase search_solution_use_case = 7;
      * 
      *
      * @param index The index to set the value at.
@@ -2589,15 +2691,17 @@ public Builder setSearchSolutionUseCase(
      *
      *
      * 
      -     * Required. Specifies the use case for the control.
+     * Specifies the use case for the control.
      * Affects what condition fields can be set.
      * Only settable by search controls.
-     * Will default to SEARCH_SOLUTION_USE_CASE_SEARCH if not specified.
-     * Currently only allow one search_solution_use_case per control.
+     * Will default to
+     * [SEARCH_SOLUTION_USE_CASE_SEARCH][google.cloud.retail.v2alpha.SearchSolutionUseCase.SEARCH_SOLUTION_USE_CASE_SEARCH]
+     * if not specified. Currently only allow one search_solution_use_case per
+     * control.
      * 
      
      *
      * 
-     * repeated .google.cloud.retail.v2alpha.SearchSolutionUseCase search_solution_use_case = 7 [(.google.api.field_behavior) = REQUIRED];
+     * repeated .google.cloud.retail.v2alpha.SearchSolutionUseCase search_solution_use_case = 7;
      * 
      *
      * @param value The searchSolutionUseCase to add.
@@ -2617,15 +2721,17 @@ public Builder addSearchSolutionUseCase(
      *
      *
      * 
      -     * Required. Specifies the use case for the control.
+     * Specifies the use case for the control.
      * Affects what condition fields can be set.
      * Only settable by search controls.
-     * Will default to SEARCH_SOLUTION_USE_CASE_SEARCH if not specified.
-     * Currently only allow one search_solution_use_case per control.
+     * Will default to
+     * [SEARCH_SOLUTION_USE_CASE_SEARCH][google.cloud.retail.v2alpha.SearchSolutionUseCase.SEARCH_SOLUTION_USE_CASE_SEARCH]
+     * if not specified. Currently only allow one search_solution_use_case per
+     * control.
      * 
      
      *
      * 
-     * repeated .google.cloud.retail.v2alpha.SearchSolutionUseCase search_solution_use_case = 7 [(.google.api.field_behavior) = REQUIRED];
+     * repeated .google.cloud.retail.v2alpha.SearchSolutionUseCase search_solution_use_case = 7;
      * 
      *
      * @param values The searchSolutionUseCase to add.
@@ -2645,15 +2751,17 @@ public Builder addAllSearchSolutionUseCase(
      *
      *
      * 
      -     * Required. Specifies the use case for the control.
+     * Specifies the use case for the control.
      * Affects what condition fields can be set.
      * Only settable by search controls.
-     * Will default to SEARCH_SOLUTION_USE_CASE_SEARCH if not specified.
-     * Currently only allow one search_solution_use_case per control.
+     * Will default to
+     * [SEARCH_SOLUTION_USE_CASE_SEARCH][google.cloud.retail.v2alpha.SearchSolutionUseCase.SEARCH_SOLUTION_USE_CASE_SEARCH]
+     * if not specified. Currently only allow one search_solution_use_case per
+     * control.
      * 
      
      *
      * 
-     * repeated .google.cloud.retail.v2alpha.SearchSolutionUseCase search_solution_use_case = 7 [(.google.api.field_behavior) = REQUIRED];
+     * repeated .google.cloud.retail.v2alpha.SearchSolutionUseCase search_solution_use_case = 7;
      * 
      *
      * @return This builder for chaining.
@@ -2668,15 +2776,17 @@ public Builder clearSearchSolutionUseCase() {
      *
      *
      * 
      -     * Required. Specifies the use case for the control.
+     * Specifies the use case for the control.
      * Affects what condition fields can be set.
      * Only settable by search controls.
-     * Will default to SEARCH_SOLUTION_USE_CASE_SEARCH if not specified.
-     * Currently only allow one search_solution_use_case per control.
+     * Will default to
+     * [SEARCH_SOLUTION_USE_CASE_SEARCH][google.cloud.retail.v2alpha.SearchSolutionUseCase.SEARCH_SOLUTION_USE_CASE_SEARCH]
+     * if not specified. Currently only allow one search_solution_use_case per
+     * control.
      * 
      
      *
      * 
-     * repeated .google.cloud.retail.v2alpha.SearchSolutionUseCase search_solution_use_case = 7 [(.google.api.field_behavior) = REQUIRED];
+     * repeated .google.cloud.retail.v2alpha.SearchSolutionUseCase search_solution_use_case = 7;
      * 
      *
      * @return A list containing the enum numeric values on the wire for searchSolutionUseCase.
@@ -2688,15 +2798,17 @@ public java.util.List getSearchSolutionUseCaseValueList() {
      *
      *
      * 
      -     * Required. Specifies the use case for the control.
+     * Specifies the use case for the control.
      * Affects what condition fields can be set.
      * Only settable by search controls.
-     * Will default to SEARCH_SOLUTION_USE_CASE_SEARCH if not specified.
-     * Currently only allow one search_solution_use_case per control.
+     * Will default to
+     * [SEARCH_SOLUTION_USE_CASE_SEARCH][google.cloud.retail.v2alpha.SearchSolutionUseCase.SEARCH_SOLUTION_USE_CASE_SEARCH]
+     * if not specified. Currently only allow one search_solution_use_case per
+     * control.
      * 
      
      *
      * 
-     * repeated .google.cloud.retail.v2alpha.SearchSolutionUseCase search_solution_use_case = 7 [(.google.api.field_behavior) = REQUIRED];
+     * repeated .google.cloud.retail.v2alpha.SearchSolutionUseCase search_solution_use_case = 7;
      * 
      *
      * @param index The index of the value to return.
@@ -2709,15 +2821,17 @@ public int getSearchSolutionUseCaseValue(int index) {
      *
      *
      * 
      -     * Required. Specifies the use case for the control.
+     * Specifies the use case for the control.
      * Affects what condition fields can be set.
      * Only settable by search controls.
-     * Will default to SEARCH_SOLUTION_USE_CASE_SEARCH if not specified.
-     * Currently only allow one search_solution_use_case per control.
+     * Will default to
+     * [SEARCH_SOLUTION_USE_CASE_SEARCH][google.cloud.retail.v2alpha.SearchSolutionUseCase.SEARCH_SOLUTION_USE_CASE_SEARCH]
+     * if not specified. Currently only allow one search_solution_use_case per
+     * control.
      * 
      
      *
      * 
-     * repeated .google.cloud.retail.v2alpha.SearchSolutionUseCase search_solution_use_case = 7 [(.google.api.field_behavior) = REQUIRED];
+     * repeated .google.cloud.retail.v2alpha.SearchSolutionUseCase search_solution_use_case = 7;
      * 
      *
      * @param index The index to set the value at.
@@ -2734,15 +2848,17 @@ public Builder setSearchSolutionUseCaseValue(int index, int value) {
      *
      *
      * 
      -     * Required. Specifies the use case for the control.
+     * Specifies the use case for the control.
      * Affects what condition fields can be set.
      * Only settable by search controls.
-     * Will default to SEARCH_SOLUTION_USE_CASE_SEARCH if not specified.
-     * Currently only allow one search_solution_use_case per control.
+     * Will default to
+     * [SEARCH_SOLUTION_USE_CASE_SEARCH][google.cloud.retail.v2alpha.SearchSolutionUseCase.SEARCH_SOLUTION_USE_CASE_SEARCH]
+     * if not specified. Currently only allow one search_solution_use_case per
+     * control.
      * 
      
      *
      * 
-     * repeated .google.cloud.retail.v2alpha.SearchSolutionUseCase search_solution_use_case = 7 [(.google.api.field_behavior) = REQUIRED];
+     * repeated .google.cloud.retail.v2alpha.SearchSolutionUseCase search_solution_use_case = 7;
      * 
      *
      * @param value The enum numeric value on the wire for searchSolutionUseCase to add.
@@ -2758,15 +2874,17 @@ public Builder addSearchSolutionUseCaseValue(int value) {
      *
      *
      * 
      -     * Required. Specifies the use case for the control.
+     * Specifies the use case for the control.
      * Affects what condition fields can be set.
      * Only settable by search controls.
-     * Will default to SEARCH_SOLUTION_USE_CASE_SEARCH if not specified.
-     * Currently only allow one search_solution_use_case per control.
+     * Will default to
+     * [SEARCH_SOLUTION_USE_CASE_SEARCH][google.cloud.retail.v2alpha.SearchSolutionUseCase.SEARCH_SOLUTION_USE_CASE_SEARCH]
+     * if not specified. Currently only allow one search_solution_use_case per
+     * control.
      * 
      
      *
      * 
-     * repeated .google.cloud.retail.v2alpha.SearchSolutionUseCase search_solution_use_case = 7 [(.google.api.field_behavior) = REQUIRED];
+     * repeated .google.cloud.retail.v2alpha.SearchSolutionUseCase search_solution_use_case = 7;
      * 
      *
      * @param values The enum numeric values on the wire for searchSolutionUseCase to add.
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ControlOrBuilder.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ControlOrBuilder.java
index 73dea8b0dd73..8dacf04f7be0 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ControlOrBuilder.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ControlOrBuilder.java
@@ -28,34 +28,50 @@ public interface ControlOrBuilder
    *
    * 
          * A facet specification to perform faceted search.
+   * Note that this field is deprecated and will throw NOT_IMPLEMENTED if
+   * used for creating a control.
    * 
      
    *
-   * .google.cloud.retail.v2alpha.SearchRequest.FacetSpec facet_spec = 3;
+   * .google.cloud.retail.v2alpha.SearchRequest.FacetSpec facet_spec = 3 [deprecated = true];
+   * 
    *
+   * @deprecated google.cloud.retail.v2alpha.Control.facet_spec is deprecated. See
+   *     google/cloud/retail/v2alpha/control.proto;l=51
    * @return Whether the facetSpec field is set.
    */
+  @java.lang.Deprecated
   boolean hasFacetSpec();
   /**
    *
    *
    * 
          * A facet specification to perform faceted search.
+   * Note that this field is deprecated and will throw NOT_IMPLEMENTED if
+   * used for creating a control.
    * 
      
    *
-   * .google.cloud.retail.v2alpha.SearchRequest.FacetSpec facet_spec = 3;
+   * .google.cloud.retail.v2alpha.SearchRequest.FacetSpec facet_spec = 3 [deprecated = true];
+   * 
    *
+   * @deprecated google.cloud.retail.v2alpha.Control.facet_spec is deprecated. See
+   *     google/cloud/retail/v2alpha/control.proto;l=51
    * @return The facetSpec.
    */
+  @java.lang.Deprecated
   com.google.cloud.retail.v2alpha.SearchRequest.FacetSpec getFacetSpec();
   /**
    *
    *
    * 
          * A facet specification to perform faceted search.
+   * Note that this field is deprecated and will throw NOT_IMPLEMENTED if
+   * used for creating a control.
    * 
      
    *
-   * .google.cloud.retail.v2alpha.SearchRequest.FacetSpec facet_spec = 3;
+   * .google.cloud.retail.v2alpha.SearchRequest.FacetSpec facet_spec = 3 [deprecated = true];
+   * 
    */
+  @java.lang.Deprecated
   com.google.cloud.retail.v2alpha.SearchRequest.FacetSpecOrBuilder getFacetSpecOrBuilder();
 
   /**
@@ -159,10 +175,13 @@ public interface ControlOrBuilder
    *
    *
    * 
      -   * Output only. List of serving configuration ids that that are associated
-   * with this control. Note the association is managed via the ServingConfig,
-   * this is an output only denormalizeed  view. Assumed to be in the same
-   * catalog.
+   * Output only. List of [serving
+   * config][google.cloud.retail.v2alpha.ServingConfig] ids that are associated
+   * with this control in the same
+   * [Catalog][google.cloud.retail.v2alpha.Catalog].
+   * Note the association is managed via the
+   * [ServingConfig][google.cloud.retail.v2alpha.ServingConfig], this is an
+   * output only denormalized view.
    * 
      
    *
    * 
@@ -176,10 +195,13 @@ public interface ControlOrBuilder
    *
    *
    * 
      -   * Output only. List of serving configuration ids that that are associated
-   * with this control. Note the association is managed via the ServingConfig,
-   * this is an output only denormalizeed  view. Assumed to be in the same
-   * catalog.
+   * Output only. List of [serving
+   * config][google.cloud.retail.v2alpha.ServingConfig] ids that are associated
+   * with this control in the same
+   * [Catalog][google.cloud.retail.v2alpha.Catalog].
+   * Note the association is managed via the
+   * [ServingConfig][google.cloud.retail.v2alpha.ServingConfig], this is an
+   * output only denormalized view.
    * 
      
    *
    * 
@@ -193,10 +215,13 @@ public interface ControlOrBuilder
    *
    *
    * 
      -   * Output only. List of serving configuration ids that that are associated
-   * with this control. Note the association is managed via the ServingConfig,
-   * this is an output only denormalizeed  view. Assumed to be in the same
-   * catalog.
+   * Output only. List of [serving
+   * config][google.cloud.retail.v2alpha.ServingConfig] ids that are associated
+   * with this control in the same
+   * [Catalog][google.cloud.retail.v2alpha.Catalog].
+   * Note the association is managed via the
+   * [ServingConfig][google.cloud.retail.v2alpha.ServingConfig], this is an
+   * output only denormalized view.
    * 
      
    *
    * 
@@ -211,10 +236,13 @@ public interface ControlOrBuilder
    *
    *
    * 
      -   * Output only. List of serving configuration ids that that are associated
-   * with this control. Note the association is managed via the ServingConfig,
-   * this is an output only denormalizeed  view. Assumed to be in the same
-   * catalog.
+   * Output only. List of [serving
+   * config][google.cloud.retail.v2alpha.ServingConfig] ids that are associated
+   * with this control in the same
+   * [Catalog][google.cloud.retail.v2alpha.Catalog].
+   * Note the association is managed via the
+   * [ServingConfig][google.cloud.retail.v2alpha.ServingConfig], this is an
+   * output only denormalized view.
    * 
      
    *
    * 
@@ -230,12 +258,11 @@ public interface ControlOrBuilder
    *
    *
    * 
      -   * Required. Immutable. The solution types that the serving config is used
-   * for. Currently we support setting only one type of solution at creation
-   * time.
+   * Required. Immutable. The solution types that the control is used for.
+   * Currently we support setting only one type of solution at creation time.
    * Only `SOLUTION_TYPE_SEARCH` value is supported at the moment.
    * If no solution type is provided at creation time, will default to
-   * SOLUTION_TYPE_SEARCH.
+   * [SOLUTION_TYPE_SEARCH][google.cloud.retail.v2alpha.SolutionType.SOLUTION_TYPE_SEARCH].
    * 
      
    *
    * 
@@ -249,12 +276,11 @@ public interface ControlOrBuilder
    *
    *
    * 
      -   * Required. Immutable. The solution types that the serving config is used
-   * for. Currently we support setting only one type of solution at creation
-   * time.
+   * Required. Immutable. The solution types that the control is used for.
+   * Currently we support setting only one type of solution at creation time.
    * Only `SOLUTION_TYPE_SEARCH` value is supported at the moment.
    * If no solution type is provided at creation time, will default to
-   * SOLUTION_TYPE_SEARCH.
+   * [SOLUTION_TYPE_SEARCH][google.cloud.retail.v2alpha.SolutionType.SOLUTION_TYPE_SEARCH].
    * 
      
    *
    * 
@@ -268,12 +294,11 @@ public interface ControlOrBuilder
    *
    *
    * 
      -   * Required. Immutable. The solution types that the serving config is used
-   * for. Currently we support setting only one type of solution at creation
-   * time.
+   * Required. Immutable. The solution types that the control is used for.
+   * Currently we support setting only one type of solution at creation time.
    * Only `SOLUTION_TYPE_SEARCH` value is supported at the moment.
    * If no solution type is provided at creation time, will default to
-   * SOLUTION_TYPE_SEARCH.
+   * [SOLUTION_TYPE_SEARCH][google.cloud.retail.v2alpha.SolutionType.SOLUTION_TYPE_SEARCH].
    * 
      
    *
    * 
@@ -288,12 +313,11 @@ public interface ControlOrBuilder
    *
    *
    * 
      -   * Required. Immutable. The solution types that the serving config is used
-   * for. Currently we support setting only one type of solution at creation
-   * time.
+   * Required. Immutable. The solution types that the control is used for.
+   * Currently we support setting only one type of solution at creation time.
    * Only `SOLUTION_TYPE_SEARCH` value is supported at the moment.
    * If no solution type is provided at creation time, will default to
-   * SOLUTION_TYPE_SEARCH.
+   * [SOLUTION_TYPE_SEARCH][google.cloud.retail.v2alpha.SolutionType.SOLUTION_TYPE_SEARCH].
    * 
      
    *
    * 
@@ -307,12 +331,11 @@ public interface ControlOrBuilder
    *
    *
    * 
      -   * Required. Immutable. The solution types that the serving config is used
-   * for. Currently we support setting only one type of solution at creation
-   * time.
+   * Required. Immutable. The solution types that the control is used for.
+   * Currently we support setting only one type of solution at creation time.
    * Only `SOLUTION_TYPE_SEARCH` value is supported at the moment.
    * If no solution type is provided at creation time, will default to
-   * SOLUTION_TYPE_SEARCH.
+   * [SOLUTION_TYPE_SEARCH][google.cloud.retail.v2alpha.SolutionType.SOLUTION_TYPE_SEARCH].
    * 
      
    *
    * 
@@ -328,15 +351,16 @@ public interface ControlOrBuilder
    *
    *
    * 
      -   * Required. Specifies the use case for the control.
+   * Specifies the use case for the control.
    * Affects what condition fields can be set.
    * Only settable by search controls.
-   * Will default to SEARCH_SOLUTION_USE_CASE_SEARCH if not specified.
-   * Currently only allow one search_solution_use_case per control.
+   * Will default to
+   * [SEARCH_SOLUTION_USE_CASE_SEARCH][google.cloud.retail.v2alpha.SearchSolutionUseCase.SEARCH_SOLUTION_USE_CASE_SEARCH]
+   * if not specified. Currently only allow one search_solution_use_case per
+   * control.
    * 
      
    *
-   * 
-   * repeated .google.cloud.retail.v2alpha.SearchSolutionUseCase search_solution_use_case = 7 [(.google.api.field_behavior) = REQUIRED];
+   * repeated .google.cloud.retail.v2alpha.SearchSolutionUseCase search_solution_use_case = 7;
    * 
    *
    * @return A list containing the searchSolutionUseCase.
@@ -347,15 +371,16 @@ public interface ControlOrBuilder
    *
    *
    * 
      -   * Required. Specifies the use case for the control.
+   * Specifies the use case for the control.
    * Affects what condition fields can be set.
    * Only settable by search controls.
-   * Will default to SEARCH_SOLUTION_USE_CASE_SEARCH if not specified.
-   * Currently only allow one search_solution_use_case per control.
+   * Will default to
+   * [SEARCH_SOLUTION_USE_CASE_SEARCH][google.cloud.retail.v2alpha.SearchSolutionUseCase.SEARCH_SOLUTION_USE_CASE_SEARCH]
+   * if not specified. Currently only allow one search_solution_use_case per
+   * control.
    * 
      
    *
-   * 
-   * repeated .google.cloud.retail.v2alpha.SearchSolutionUseCase search_solution_use_case = 7 [(.google.api.field_behavior) = REQUIRED];
+   * repeated .google.cloud.retail.v2alpha.SearchSolutionUseCase search_solution_use_case = 7;
    * 
    *
    * @return The count of searchSolutionUseCase.
@@ -365,15 +390,16 @@ public interface ControlOrBuilder
    *
    *
    * 
      -   * Required. Specifies the use case for the control.
+   * Specifies the use case for the control.
    * Affects what condition fields can be set.
    * Only settable by search controls.
-   * Will default to SEARCH_SOLUTION_USE_CASE_SEARCH if not specified.
-   * Currently only allow one search_solution_use_case per control.
+   * Will default to
+   * [SEARCH_SOLUTION_USE_CASE_SEARCH][google.cloud.retail.v2alpha.SearchSolutionUseCase.SEARCH_SOLUTION_USE_CASE_SEARCH]
+   * if not specified. Currently only allow one search_solution_use_case per
+   * control.
    * 
      
    *
-   * 
-   * repeated .google.cloud.retail.v2alpha.SearchSolutionUseCase search_solution_use_case = 7 [(.google.api.field_behavior) = REQUIRED];
+   * repeated .google.cloud.retail.v2alpha.SearchSolutionUseCase search_solution_use_case = 7;
    * 
    *
    * @param index The index of the element to return.
@@ -384,15 +410,16 @@ public interface ControlOrBuilder
    *
    *
    * 
      -   * Required. Specifies the use case for the control.
+   * Specifies the use case for the control.
    * Affects what condition fields can be set.
    * Only settable by search controls.
-   * Will default to SEARCH_SOLUTION_USE_CASE_SEARCH if not specified.
-   * Currently only allow one search_solution_use_case per control.
+   * Will default to
+   * [SEARCH_SOLUTION_USE_CASE_SEARCH][google.cloud.retail.v2alpha.SearchSolutionUseCase.SEARCH_SOLUTION_USE_CASE_SEARCH]
+   * if not specified. Currently only allow one search_solution_use_case per
+   * control.
    * 
      
    *
-   * 
-   * repeated .google.cloud.retail.v2alpha.SearchSolutionUseCase search_solution_use_case = 7 [(.google.api.field_behavior) = REQUIRED];
+   * repeated .google.cloud.retail.v2alpha.SearchSolutionUseCase search_solution_use_case = 7;
    * 
    *
    * @return A list containing the enum numeric values on the wire for searchSolutionUseCase.
@@ -402,15 +429,16 @@ public interface ControlOrBuilder
    *
    *
    * 
      -   * Required. Specifies the use case for the control.
+   * Specifies the use case for the control.
    * Affects what condition fields can be set.
    * Only settable by search controls.
-   * Will default to SEARCH_SOLUTION_USE_CASE_SEARCH if not specified.
-   * Currently only allow one search_solution_use_case per control.
+   * Will default to
+   * [SEARCH_SOLUTION_USE_CASE_SEARCH][google.cloud.retail.v2alpha.SearchSolutionUseCase.SEARCH_SOLUTION_USE_CASE_SEARCH]
+   * if not specified. Currently only allow one search_solution_use_case per
+   * control.
    * 
      
    *
-   * 
-   * repeated .google.cloud.retail.v2alpha.SearchSolutionUseCase search_solution_use_case = 7 [(.google.api.field_behavior) = REQUIRED];
+   * repeated .google.cloud.retail.v2alpha.SearchSolutionUseCase search_solution_use_case = 7;
    * 
    *
    * @param index The index of the value to return.
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ControlProto.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ControlProto.java
index da64e9940140..ae60703bc859 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ControlProto.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ControlProto.java
@@ -45,26 +45,26 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
           + "/api/field_behavior.proto\032\031google/api/re"
           + "source.proto\032(google/cloud/retail/v2alph"
           + "a/common.proto\0320google/cloud/retail/v2al"
-          + "pha/search_service.proto\"\206\004\n\007Control\022J\n\n"
+          + "pha/search_service.proto\"\205\004\n\007Control\022N\n\n"
           + "facet_spec\030\003 \001(\01324.google.cloud.retail.v"
-          + "2alpha.SearchRequest.FacetSpecH\000\0221\n\004rule"
-          + "\030\004 \001(\0132!.google.cloud.retail.v2alpha.Rul"
-          + "eH\000\022\021\n\004name\030\001 \001(\tB\003\340A\005\022\031\n\014display_name\030\002"
-          + " \001(\tB\003\340A\002\022*\n\035associated_serving_config_i"
-          + "ds\030\005 \003(\tB\003\340A\003\022I\n\016solution_types\030\006 \003(\0162)."
-          + "google.cloud.retail.v2alpha.SolutionType"
-          + "B\006\340A\002\340A\005\022Y\n\030search_solution_use_case\030\007 \003"
-          + "(\01622.google.cloud.retail.v2alpha.SearchS"
-          + "olutionUseCaseB\003\340A\002:q\352An\n\035retail.googlea"
-          + "pis.com/Control\022Mprojects/{project}/loca"
-          + "tions/{location}/catalogs/{catalog}/cont"
-          + "rols/{control}B\t\n\007controlB\332\001\n\037com.google"
-          + ".cloud.retail.v2alphaB\014ControlProtoP\001ZAg"
-          + "oogle.golang.org/genproto/googleapis/clo"
-          + "ud/retail/v2alpha;retail\242\002\006RETAIL\252\002\033Goog"
-          + "le.Cloud.Retail.V2Alpha\312\002\033Google\\Cloud\\R"
-          + "etail\\V2alpha\352\002\036Google::Cloud::Retail::V"
-          + "2alphab\006proto3"
+          + "2alpha.SearchRequest.FacetSpecB\002\030\001H\000\0221\n\004"
+          + "rule\030\004 \001(\0132!.google.cloud.retail.v2alpha"
+          + ".RuleH\000\022\021\n\004name\030\001 \001(\tB\003\340A\005\022\031\n\014display_na"
+          + "me\030\002 \001(\tB\003\340A\002\022*\n\035associated_serving_conf"
+          + "ig_ids\030\005 \003(\tB\003\340A\003\022I\n\016solution_types\030\006 \003("
+          + "\0162).google.cloud.retail.v2alpha.Solution"
+          + "TypeB\006\340A\002\340A\005\022T\n\030search_solution_use_case"
+          + "\030\007 \003(\01622.google.cloud.retail.v2alpha.Sea"
+          + "rchSolutionUseCase:q\352An\n\035retail.googleap"
+          + "is.com/Control\022Mprojects/{project}/locat"
+          + "ions/{location}/catalogs/{catalog}/contr"
+          + "ols/{control}B\t\n\007controlB\332\001\n\037com.google."
+          + "cloud.retail.v2alphaB\014ControlProtoP\001ZAgo"
+          + "ogle.golang.org/genproto/googleapis/clou"
+          + "d/retail/v2alpha;retail\242\002\006RETAIL\252\002\033Googl"
+          + "e.Cloud.Retail.V2Alpha\312\002\033Google\\Cloud\\Re"
+          + "tail\\V2alpha\352\002\036Google::Cloud::Retail::V2"
+          + "alphab\006proto3"
     };
     descriptor =
         com.google.protobuf.Descriptors.FileDescriptor.internalBuildGeneratedFileFrom(
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/CreateModelMetadata.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/CreateModelMetadata.java
index bf727b60e6c0..4c2fdaba4dcc 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/CreateModelMetadata.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/CreateModelMetadata.java
@@ -75,7 +75,7 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    * 
          * The resource name of the model that this create applies to.
    * Format:
-   * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}
+   * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}`
    * 
      
    *
    * string model = 1;
@@ -100,7 +100,7 @@ public java.lang.String getModel() {
    * 
          * The resource name of the model that this create applies to.
    * Format:
-   * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}
+   * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}`
    * 
      
    *
    * string model = 1;
@@ -457,7 +457,7 @@ public Builder mergeFrom(
      * 
            * The resource name of the model that this create applies to.
      * Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}`
      * 
      
      *
      * string model = 1;
@@ -481,7 +481,7 @@ public java.lang.String getModel() {
      * 
            * The resource name of the model that this create applies to.
      * Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}`
      * 
      
      *
      * string model = 1;
@@ -505,7 +505,7 @@ public com.google.protobuf.ByteString getModelBytes() {
      * 
            * The resource name of the model that this create applies to.
      * Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}`
      * 
      
      *
      * string model = 1;
@@ -528,7 +528,7 @@ public Builder setModel(java.lang.String value) {
      * 
            * The resource name of the model that this create applies to.
      * Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}`
      * 
      
      *
      * string model = 1;
@@ -547,7 +547,7 @@ public Builder clearModel() {
      * 
            * The resource name of the model that this create applies to.
      * Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}`
      * 
      
      *
      * string model = 1;
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/CreateModelMetadataOrBuilder.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/CreateModelMetadataOrBuilder.java
index 6fba60b1e776..b2dec2a8a0fe 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/CreateModelMetadataOrBuilder.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/CreateModelMetadataOrBuilder.java
@@ -29,7 +29,7 @@ public interface CreateModelMetadataOrBuilder
    * 
          * The resource name of the model that this create applies to.
    * Format:
-   * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}
+   * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}`
    * 
      
    *
    * string model = 1;
@@ -43,7 +43,7 @@ public interface CreateModelMetadataOrBuilder
    * 
          * The resource name of the model that this create applies to.
    * Format:
-   * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}
+   * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}`
    * 
      
    *
    * string model = 1;
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/CreateModelRequest.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/CreateModelRequest.java
index be664bd4fff7..c0fd2972b7b5 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/CreateModelRequest.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/CreateModelRequest.java
@@ -74,7 +74,7 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    *
    * 
          * Required. The parent resource under which to create the model. Format:
-   * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}
+   * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}`
    * 
      
    *
    * 
@@ -100,7 +100,7 @@ public java.lang.String getParent() {
    *
    * 
          * Required. The parent resource under which to create the model. Format:
-   * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}
+   * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}`
    * 
      
    *
    * 
@@ -128,7 +128,8 @@ public com.google.protobuf.ByteString getParentBytes() {
    *
    *
    * 
      -   * Required. The payload of the [Model]  to create.
+   * Required. The payload of the [Model][google.cloud.retail.v2alpha.Model]  to
+   * create.
    * 
      
    *
    * .google.cloud.retail.v2alpha.Model model = 2 [(.google.api.field_behavior) = REQUIRED];
@@ -144,7 +145,8 @@ public boolean hasModel() {
    *
    *
    * 
      -   * Required. The payload of the [Model]  to create.
+   * Required. The payload of the [Model][google.cloud.retail.v2alpha.Model]  to
+   * create.
    * 
      
    *
    * .google.cloud.retail.v2alpha.Model model = 2 [(.google.api.field_behavior) = REQUIRED];
@@ -160,7 +162,8 @@ public com.google.cloud.retail.v2alpha.Model getModel() {
    *
    *
    * 
      -   * Required. The payload of the [Model]  to create.
+   * Required. The payload of the [Model][google.cloud.retail.v2alpha.Model]  to
+   * create.
    * 
      
    *
    * .google.cloud.retail.v2alpha.Model model = 2 [(.google.api.field_behavior) = REQUIRED];
@@ -177,7 +180,7 @@ public com.google.cloud.retail.v2alpha.ModelOrBuilder getModelOrBuilder() {
    *
    *
    * 
      -   * Optional. Whether to run a dry_run to validate the request (without
+   * Optional. Whether to run a dry run to validate the request (without
    * actually creating the model).
    * 
      
    *
@@ -581,7 +584,7 @@ public Builder mergeFrom(
      *
      * 
            * Required. The parent resource under which to create the model. Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}`
      * 
      
      *
      * 
@@ -606,7 +609,7 @@ public java.lang.String getParent() {
      *
      * 
            * Required. The parent resource under which to create the model. Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}`
      * 
      
      *
      * 
@@ -631,7 +634,7 @@ public com.google.protobuf.ByteString getParentBytes() {
      *
      * 
            * Required. The parent resource under which to create the model. Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}`
      * 
      
      *
      * 
@@ -655,7 +658,7 @@ public Builder setParent(java.lang.String value) {
      *
      * 
            * Required. The parent resource under which to create the model. Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}`
      * 
      
      *
      * 
@@ -675,7 +678,7 @@ public Builder clearParent() {
      *
      * 
            * Required. The parent resource under which to create the model. Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}`
      * 
      
      *
      * 
@@ -706,7 +709,8 @@ public Builder setParentBytes(com.google.protobuf.ByteString value) {
      *
      *
      * 
      -     * Required. The payload of the [Model]  to create.
+     * Required. The payload of the [Model][google.cloud.retail.v2alpha.Model]  to
+     * create.
      * 
      
      *
      * .google.cloud.retail.v2alpha.Model model = 2 [(.google.api.field_behavior) = REQUIRED];
@@ -721,7 +725,8 @@ public boolean hasModel() {
      *
      *
      * 
      -     * Required. The payload of the [Model]  to create.
+     * Required. The payload of the [Model][google.cloud.retail.v2alpha.Model]  to
+     * create.
      * 
      
      *
      * .google.cloud.retail.v2alpha.Model model = 2 [(.google.api.field_behavior) = REQUIRED];
@@ -740,7 +745,8 @@ public com.google.cloud.retail.v2alpha.Model getModel() {
      *
      *
      * 
      -     * Required. The payload of the [Model]  to create.
+     * Required. The payload of the [Model][google.cloud.retail.v2alpha.Model]  to
+     * create.
      * 
      
      *
      * .google.cloud.retail.v2alpha.Model model = 2 [(.google.api.field_behavior) = REQUIRED];
@@ -763,7 +769,8 @@ public Builder setModel(com.google.cloud.retail.v2alpha.Model value) {
      *
      *
      * 
      -     * Required. The payload of the [Model]  to create.
+     * Required. The payload of the [Model][google.cloud.retail.v2alpha.Model]  to
+     * create.
      * 
      
      *
      * .google.cloud.retail.v2alpha.Model model = 2 [(.google.api.field_behavior) = REQUIRED];
@@ -783,7 +790,8 @@ public Builder setModel(com.google.cloud.retail.v2alpha.Model.Builder builderFor
      *
      *
      * 
      -     * Required. The payload of the [Model]  to create.
+     * Required. The payload of the [Model][google.cloud.retail.v2alpha.Model]  to
+     * create.
      * 
      
      *
      * .google.cloud.retail.v2alpha.Model model = 2 [(.google.api.field_behavior) = REQUIRED];
@@ -810,7 +818,8 @@ public Builder mergeModel(com.google.cloud.retail.v2alpha.Model value) {
      *
      *
      * 
      -     * Required. The payload of the [Model]  to create.
+     * Required. The payload of the [Model][google.cloud.retail.v2alpha.Model]  to
+     * create.
      * 
      
      *
      * .google.cloud.retail.v2alpha.Model model = 2 [(.google.api.field_behavior) = REQUIRED];
@@ -831,7 +840,8 @@ public Builder clearModel() {
      *
      *
      * 
      -     * Required. The payload of the [Model]  to create.
+     * Required. The payload of the [Model][google.cloud.retail.v2alpha.Model]  to
+     * create.
      * 
      
      *
      * .google.cloud.retail.v2alpha.Model model = 2 [(.google.api.field_behavior) = REQUIRED];
@@ -846,7 +856,8 @@ public com.google.cloud.retail.v2alpha.Model.Builder getModelBuilder() {
      *
      *
      * 
      -     * Required. The payload of the [Model]  to create.
+     * Required. The payload of the [Model][google.cloud.retail.v2alpha.Model]  to
+     * create.
      * 
      
      *
      * .google.cloud.retail.v2alpha.Model model = 2 [(.google.api.field_behavior) = REQUIRED];
@@ -863,7 +874,8 @@ public com.google.cloud.retail.v2alpha.ModelOrBuilder getModelOrBuilder() {
      *
      *
      * 
      -     * Required. The payload of the [Model]  to create.
+     * Required. The payload of the [Model][google.cloud.retail.v2alpha.Model]  to
+     * create.
      * 
      
      *
      * .google.cloud.retail.v2alpha.Model model = 2 [(.google.api.field_behavior) = REQUIRED];
@@ -891,7 +903,7 @@ public com.google.cloud.retail.v2alpha.ModelOrBuilder getModelOrBuilder() {
      *
      *
      * 
      -     * Optional. Whether to run a dry_run to validate the request (without
+     * Optional. Whether to run a dry run to validate the request (without
      * actually creating the model).
      * 
      
      *
@@ -907,7 +919,7 @@ public boolean getDryRun() {
      *
      *
      * 
      -     * Optional. Whether to run a dry_run to validate the request (without
+     * Optional. Whether to run a dry run to validate the request (without
      * actually creating the model).
      * 
      
      *
@@ -926,7 +938,7 @@ public Builder setDryRun(boolean value) {
      *
      *
      * 
      -     * Optional. Whether to run a dry_run to validate the request (without
+     * Optional. Whether to run a dry run to validate the request (without
      * actually creating the model).
      * 
      
      *
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/CreateModelRequestOrBuilder.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/CreateModelRequestOrBuilder.java
index cedbd6789197..b1466de1185a 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/CreateModelRequestOrBuilder.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/CreateModelRequestOrBuilder.java
@@ -28,7 +28,7 @@ public interface CreateModelRequestOrBuilder
    *
    * 
          * Required. The parent resource under which to create the model. Format:
-   * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}
+   * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}`
    * 
      
    *
    * 
@@ -43,7 +43,7 @@ public interface CreateModelRequestOrBuilder
    *
    * 
          * Required. The parent resource under which to create the model. Format:
-   * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}
+   * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}`
    * 
      
    *
    * 
@@ -58,7 +58,8 @@ public interface CreateModelRequestOrBuilder
    *
    *
    * 
      -   * Required. The payload of the [Model]  to create.
+   * Required. The payload of the [Model][google.cloud.retail.v2alpha.Model]  to
+   * create.
    * 
      
    *
    * .google.cloud.retail.v2alpha.Model model = 2 [(.google.api.field_behavior) = REQUIRED];
@@ -71,7 +72,8 @@ public interface CreateModelRequestOrBuilder
    *
    *
    * 
      -   * Required. The payload of the [Model]  to create.
+   * Required. The payload of the [Model][google.cloud.retail.v2alpha.Model]  to
+   * create.
    * 
      
    *
    * .google.cloud.retail.v2alpha.Model model = 2 [(.google.api.field_behavior) = REQUIRED];
@@ -84,7 +86,8 @@ public interface CreateModelRequestOrBuilder
    *
    *
    * 
      -   * Required. The payload of the [Model]  to create.
+   * Required. The payload of the [Model][google.cloud.retail.v2alpha.Model]  to
+   * create.
    * 
      
    *
    * .google.cloud.retail.v2alpha.Model model = 2 [(.google.api.field_behavior) = REQUIRED];
@@ -96,7 +99,7 @@ public interface CreateModelRequestOrBuilder
    *
    *
    * 
      -   * Optional. Whether to run a dry_run to validate the request (without
+   * Optional. Whether to run a dry run to validate the request (without
    * actually creating the model).
    * 
      
    *
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/CustomAttribute.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/CustomAttribute.java
index 4ab3baa635b8..196cc812446a 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/CustomAttribute.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/CustomAttribute.java
@@ -239,7 +239,7 @@ public double getNumbers(int index) {
    * optional bool searchable = 3 [deprecated = true];
    *
    * @deprecated google.cloud.retail.v2alpha.CustomAttribute.searchable is deprecated. See
-   *     google/cloud/retail/v2alpha/common.proto;l=423
+   *     google/cloud/retail/v2alpha/common.proto;l=426
    * @return Whether the searchable field is set.
    */
   @java.lang.Override
@@ -268,7 +268,7 @@ public boolean hasSearchable() {
    * optional bool searchable = 3 [deprecated = true];
    *
    * @deprecated google.cloud.retail.v2alpha.CustomAttribute.searchable is deprecated. See
-   *     google/cloud/retail/v2alpha/common.proto;l=423
+   *     google/cloud/retail/v2alpha/common.proto;l=426
    * @return The searchable.
    */
   @java.lang.Override
@@ -305,7 +305,7 @@ public boolean getSearchable() {
    * optional bool indexable = 4 [deprecated = true];
    *
    * @deprecated google.cloud.retail.v2alpha.CustomAttribute.indexable is deprecated. See
-   *     google/cloud/retail/v2alpha/common.proto;l=444
+   *     google/cloud/retail/v2alpha/common.proto;l=447
    * @return Whether the indexable field is set.
    */
   @java.lang.Override
@@ -339,7 +339,7 @@ public boolean hasIndexable() {
    * optional bool indexable = 4 [deprecated = true];
    *
    * @deprecated google.cloud.retail.v2alpha.CustomAttribute.indexable is deprecated. See
-   *     google/cloud/retail/v2alpha/common.proto;l=444
+   *     google/cloud/retail/v2alpha/common.proto;l=447
    * @return The indexable.
    */
   @java.lang.Override
@@ -1216,7 +1216,7 @@ public Builder clearNumbers() {
      * optional bool searchable = 3 [deprecated = true];
      *
      * @deprecated google.cloud.retail.v2alpha.CustomAttribute.searchable is deprecated. See
-     *     google/cloud/retail/v2alpha/common.proto;l=423
+     *     google/cloud/retail/v2alpha/common.proto;l=426
      * @return Whether the searchable field is set.
      */
     @java.lang.Override
@@ -1245,7 +1245,7 @@ public boolean hasSearchable() {
      * optional bool searchable = 3 [deprecated = true];
      *
      * @deprecated google.cloud.retail.v2alpha.CustomAttribute.searchable is deprecated. See
-     *     google/cloud/retail/v2alpha/common.proto;l=423
+     *     google/cloud/retail/v2alpha/common.proto;l=426
      * @return The searchable.
      */
     @java.lang.Override
@@ -1274,7 +1274,7 @@ public boolean getSearchable() {
      * optional bool searchable = 3 [deprecated = true];
      *
      * @deprecated google.cloud.retail.v2alpha.CustomAttribute.searchable is deprecated. See
-     *     google/cloud/retail/v2alpha/common.proto;l=423
+     *     google/cloud/retail/v2alpha/common.proto;l=426
      * @param value The searchable to set.
      * @return This builder for chaining.
      */
@@ -1306,7 +1306,7 @@ public Builder setSearchable(boolean value) {
      * optional bool searchable = 3 [deprecated = true];
      *
      * @deprecated google.cloud.retail.v2alpha.CustomAttribute.searchable is deprecated. See
-     *     google/cloud/retail/v2alpha/common.proto;l=423
+     *     google/cloud/retail/v2alpha/common.proto;l=426
      * @return This builder for chaining.
      */
     @java.lang.Deprecated
@@ -1344,7 +1344,7 @@ public Builder clearSearchable() {
      * optional bool indexable = 4 [deprecated = true];
      *
      * @deprecated google.cloud.retail.v2alpha.CustomAttribute.indexable is deprecated. See
-     *     google/cloud/retail/v2alpha/common.proto;l=444
+     *     google/cloud/retail/v2alpha/common.proto;l=447
      * @return Whether the indexable field is set.
      */
     @java.lang.Override
@@ -1378,7 +1378,7 @@ public boolean hasIndexable() {
      * optional bool indexable = 4 [deprecated = true];
      *
      * @deprecated google.cloud.retail.v2alpha.CustomAttribute.indexable is deprecated. See
-     *     google/cloud/retail/v2alpha/common.proto;l=444
+     *     google/cloud/retail/v2alpha/common.proto;l=447
      * @return The indexable.
      */
     @java.lang.Override
@@ -1412,7 +1412,7 @@ public boolean getIndexable() {
      * optional bool indexable = 4 [deprecated = true];
      *
      * @deprecated google.cloud.retail.v2alpha.CustomAttribute.indexable is deprecated. See
-     *     google/cloud/retail/v2alpha/common.proto;l=444
+     *     google/cloud/retail/v2alpha/common.proto;l=447
      * @param value The indexable to set.
      * @return This builder for chaining.
      */
@@ -1449,7 +1449,7 @@ public Builder setIndexable(boolean value) {
      * optional bool indexable = 4 [deprecated = true];
      *
      * @deprecated google.cloud.retail.v2alpha.CustomAttribute.indexable is deprecated. See
-     *     google/cloud/retail/v2alpha/common.proto;l=444
+     *     google/cloud/retail/v2alpha/common.proto;l=447
      * @return This builder for chaining.
      */
     @java.lang.Deprecated
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/CustomAttributeOrBuilder.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/CustomAttributeOrBuilder.java
index 27698d0efee4..6fe5c64393c7 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/CustomAttributeOrBuilder.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/CustomAttributeOrBuilder.java
@@ -169,7 +169,7 @@ public interface CustomAttributeOrBuilder
    * optional bool searchable = 3 [deprecated = true];
    *
    * @deprecated google.cloud.retail.v2alpha.CustomAttribute.searchable is deprecated. See
-   *     google/cloud/retail/v2alpha/common.proto;l=423
+   *     google/cloud/retail/v2alpha/common.proto;l=426
    * @return Whether the searchable field is set.
    */
   @java.lang.Deprecated
@@ -195,7 +195,7 @@ public interface CustomAttributeOrBuilder
    * optional bool searchable = 3 [deprecated = true];
    *
    * @deprecated google.cloud.retail.v2alpha.CustomAttribute.searchable is deprecated. See
-   *     google/cloud/retail/v2alpha/common.proto;l=423
+   *     google/cloud/retail/v2alpha/common.proto;l=426
    * @return The searchable.
    */
   @java.lang.Deprecated
@@ -227,7 +227,7 @@ public interface CustomAttributeOrBuilder
    * optional bool indexable = 4 [deprecated = true];
    *
    * @deprecated google.cloud.retail.v2alpha.CustomAttribute.indexable is deprecated. See
-   *     google/cloud/retail/v2alpha/common.proto;l=444
+   *     google/cloud/retail/v2alpha/common.proto;l=447
    * @return Whether the indexable field is set.
    */
   @java.lang.Deprecated
@@ -258,7 +258,7 @@ public interface CustomAttributeOrBuilder
    * optional bool indexable = 4 [deprecated = true];
    *
    * @deprecated google.cloud.retail.v2alpha.CustomAttribute.indexable is deprecated. See
-   *     google/cloud/retail/v2alpha/common.proto;l=444
+   *     google/cloud/retail/v2alpha/common.proto;l=447
    * @return The indexable.
    */
   @java.lang.Deprecated
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/DeleteModelRequest.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/DeleteModelRequest.java
index 008d654d7719..de6bbe1ef26f 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/DeleteModelRequest.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/DeleteModelRequest.java
@@ -73,9 +73,9 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    *
    *
    * 
      -   * Required. The resource name of the [Model] to delete.
-   * Format:
-   * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}
+   * Required. The resource name of the
+   * [Model][google.cloud.retail.v2alpha.Model] to delete. Format:
+   * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}`
    * 
      
    *
    * 
@@ -100,9 +100,9 @@ public java.lang.String getName() {
    *
    *
    * 
      -   * Required. The resource name of the [Model] to delete.
-   * Format:
-   * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}
+   * Required. The resource name of the
+   * [Model][google.cloud.retail.v2alpha.Model] to delete. Format:
+   * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}`
    * 
      
    *
    * 
@@ -459,9 +459,9 @@ public Builder mergeFrom(
      *
      *
      * 
      -     * Required. The resource name of the [Model] to delete.
-     * Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}
+     * Required. The resource name of the
+     * [Model][google.cloud.retail.v2alpha.Model] to delete. Format:
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}`
      * 
      
      *
      * 
@@ -485,9 +485,9 @@ public java.lang.String getName() {
      *
      *
      * 
      -     * Required. The resource name of the [Model] to delete.
-     * Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}
+     * Required. The resource name of the
+     * [Model][google.cloud.retail.v2alpha.Model] to delete. Format:
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}`
      * 
      
      *
      * 
@@ -511,9 +511,9 @@ public com.google.protobuf.ByteString getNameBytes() {
      *
      *
      * 
      -     * Required. The resource name of the [Model] to delete.
-     * Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}
+     * Required. The resource name of the
+     * [Model][google.cloud.retail.v2alpha.Model] to delete. Format:
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}`
      * 
      
      *
      * 
@@ -536,9 +536,9 @@ public Builder setName(java.lang.String value) {
      *
      *
      * 
      -     * Required. The resource name of the [Model] to delete.
-     * Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}
+     * Required. The resource name of the
+     * [Model][google.cloud.retail.v2alpha.Model] to delete. Format:
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}`
      * 
      
      *
      * 
@@ -557,9 +557,9 @@ public Builder clearName() {
      *
      *
      * 
      -     * Required. The resource name of the [Model] to delete.
-     * Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}
+     * Required. The resource name of the
+     * [Model][google.cloud.retail.v2alpha.Model] to delete. Format:
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}`
      * 
      
      *
      * 
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/DeleteModelRequestOrBuilder.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/DeleteModelRequestOrBuilder.java
index 02dd694b3449..de52c4e5c1a2 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/DeleteModelRequestOrBuilder.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/DeleteModelRequestOrBuilder.java
@@ -27,9 +27,9 @@ public interface DeleteModelRequestOrBuilder
    *
    *
    * 
      -   * Required. The resource name of the [Model] to delete.
-   * Format:
-   * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}
+   * Required. The resource name of the
+   * [Model][google.cloud.retail.v2alpha.Model] to delete. Format:
+   * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}`
    * 
      
    *
    * 
@@ -43,9 +43,9 @@ public interface DeleteModelRequestOrBuilder
    *
    *
    * 
      -   * Required. The resource name of the [Model] to delete.
-   * Format:
-   * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}
+   * Required. The resource name of the
+   * [Model][google.cloud.retail.v2alpha.Model] to delete. Format:
+   * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}`
    * 
      
    *
    * 
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/DeleteServingConfigRequest.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/DeleteServingConfigRequest.java
index 7ea1af23773e..cf6c8219223c 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/DeleteServingConfigRequest.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/DeleteServingConfigRequest.java
@@ -74,7 +74,7 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    *
    * 
          * Required. The resource name of the ServingConfig to delete. Format:
-   * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+   * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
    * 
      
    *
    * 
@@ -100,7 +100,7 @@ public java.lang.String getName() {
    *
    * 
          * Required. The resource name of the ServingConfig to delete. Format:
-   * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+   * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
    * 
      
    *
    * 
@@ -459,7 +459,7 @@ public Builder mergeFrom(
      *
      * 
            * Required. The resource name of the ServingConfig to delete. Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
      * 
      
      *
      * 
@@ -484,7 +484,7 @@ public java.lang.String getName() {
      *
      * 
            * Required. The resource name of the ServingConfig to delete. Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
      * 
      
      *
      * 
@@ -509,7 +509,7 @@ public com.google.protobuf.ByteString getNameBytes() {
      *
      * 
            * Required. The resource name of the ServingConfig to delete. Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
      * 
      
      *
      * 
@@ -533,7 +533,7 @@ public Builder setName(java.lang.String value) {
      *
      * 
            * Required. The resource name of the ServingConfig to delete. Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
      * 
      
      *
      * 
@@ -553,7 +553,7 @@ public Builder clearName() {
      *
      * 
            * Required. The resource name of the ServingConfig to delete. Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
      * 
      
      *
      * 
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/DeleteServingConfigRequestOrBuilder.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/DeleteServingConfigRequestOrBuilder.java
index 7d5792a5c477..85d6284ea1ee 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/DeleteServingConfigRequestOrBuilder.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/DeleteServingConfigRequestOrBuilder.java
@@ -28,7 +28,7 @@ public interface DeleteServingConfigRequestOrBuilder
    *
    * 
          * Required. The resource name of the ServingConfig to delete. Format:
-   * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+   * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
    * 
      
    *
    * 
@@ -43,7 +43,7 @@ public interface DeleteServingConfigRequestOrBuilder
    *
    * 
          * Required. The resource name of the ServingConfig to delete. Format:
-   * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+   * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
    * 
      
    *
    * 
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ExportConfigProto.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ExportConfigProto.java
index 717ce21f56c9..40e42d78e7ab 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ExportConfigProto.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ExportConfigProto.java
@@ -51,6 +51,10 @@ public static void registerAllExtensions(com.google.protobuf.ExtensionRegistry r
       internal_static_google_cloud_retail_v2alpha_BigQueryOutputResult_descriptor;
   static final com.google.protobuf.GeneratedMessageV3.FieldAccessorTable
       internal_static_google_cloud_retail_v2alpha_BigQueryOutputResult_fieldAccessorTable;
+  static final com.google.protobuf.Descriptors.Descriptor
+      internal_static_google_cloud_retail_v2alpha_GcsOutputResult_descriptor;
+  static final com.google.protobuf.GeneratedMessageV3.FieldAccessorTable
+      internal_static_google_cloud_retail_v2alpha_GcsOutputResult_fieldAccessorTable;
 
   public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
     return descriptor;
@@ -62,37 +66,44 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
     java.lang.String[] descriptorData = {
       "\n/google/cloud/retail/v2alpha/export_con"
           + "fig.proto\022\033google.cloud.retail.v2alpha\032\037"
-          + "google/protobuf/timestamp.proto\032\027google/"
-          + "rpc/status.proto\"9\n\022ExportErrorsConfig\022\024"
-          + "\n\ngcs_prefix\030\001 \001(\tH\000B\r\n\013destination\"r\n\016E"
-          + "xportMetadata\022/\n\013create_time\030\001 \001(\0132\032.goo"
-          + "gle.protobuf.Timestamp\022/\n\013update_time\030\002 "
-          + "\001(\0132\032.google.protobuf.Timestamp\"\315\001\n\026Expo"
-          + "rtProductsResponse\022)\n\rerror_samples\030\001 \003("
-          + "\0132\022.google.rpc.Status\022F\n\rerrors_config\030\002"
-          + " \001(\0132/.google.cloud.retail.v2alpha.Expor"
-          + "tErrorsConfig\022@\n\routput_result\030\003 \001(\0132).g"
-          + "oogle.cloud.retail.v2alpha.OutputResult\""
-          + "\317\001\n\030ExportUserEventsResponse\022)\n\rerror_sa"
-          + "mples\030\001 \003(\0132\022.google.rpc.Status\022F\n\rerror"
-          + "s_config\030\002 \001(\0132/.google.cloud.retail.v2a"
-          + "lpha.ExportErrorsConfig\022@\n\routput_result"
-          + "\030\003 \001(\0132).google.cloud.retail.v2alpha.Out"
-          + "putResult\"Z\n\014OutputResult\022J\n\017bigquery_re"
-          + "sult\030\001 \003(\01321.google.cloud.retail.v2alpha"
-          + ".BigQueryOutputResult\"<\n\024BigQueryOutputR"
-          + "esult\022\022\n\ndataset_id\030\001 \001(\t\022\020\n\010table_id\030\002 "
-          + "\001(\tB\337\001\n\037com.google.cloud.retail.v2alphaB"
-          + "\021ExportConfigProtoP\001ZAgoogle.golang.org/"
-          + "genproto/googleapis/cloud/retail/v2alpha"
-          + ";retail\242\002\006RETAIL\252\002\033Google.Cloud.Retail.V"
-          + "2Alpha\312\002\033Google\\Cloud\\Retail\\V2alpha\352\002\036G"
-          + "oogle::Cloud::Retail::V2alphab\006proto3"
+          + "google/api/field_behavior.proto\032\031google/"
+          + "api/resource.proto\032\037google/protobuf/time"
+          + "stamp.proto\032\027google/rpc/status.proto\"9\n\022"
+          + "ExportErrorsConfig\022\024\n\ngcs_prefix\030\001 \001(\tH\000"
+          + "B\r\n\013destination\"r\n\016ExportMetadata\022/\n\013cre"
+          + "ate_time\030\001 \001(\0132\032.google.protobuf.Timesta"
+          + "mp\022/\n\013update_time\030\002 \001(\0132\032.google.protobu"
+          + "f.Timestamp\"\315\001\n\026ExportProductsResponse\022)"
+          + "\n\rerror_samples\030\001 \003(\0132\022.google.rpc.Statu"
+          + "s\022F\n\rerrors_config\030\002 \001(\0132/.google.cloud."
+          + "retail.v2alpha.ExportErrorsConfig\022@\n\rout"
+          + "put_result\030\003 \001(\0132).google.cloud.retail.v"
+          + "2alpha.OutputResult\"\317\001\n\030ExportUserEvents"
+          + "Response\022)\n\rerror_samples\030\001 \003(\0132\022.google"
+          + ".rpc.Status\022F\n\rerrors_config\030\002 \001(\0132/.goo"
+          + "gle.cloud.retail.v2alpha.ExportErrorsCon"
+          + "fig\022@\n\routput_result\030\003 \001(\0132).google.clou"
+          + "d.retail.v2alpha.OutputResult\"\234\001\n\014Output"
+          + "Result\022J\n\017bigquery_result\030\001 \003(\01321.google"
+          + ".cloud.retail.v2alpha.BigQueryOutputResu"
+          + "lt\022@\n\ngcs_result\030\002 \003(\0132,.google.cloud.re"
+          + "tail.v2alpha.GcsOutputResult\"<\n\024BigQuery"
+          + "OutputResult\022\022\n\ndataset_id\030\001 \001(\t\022\020\n\010tabl"
+          + "e_id\030\002 \001(\t\"%\n\017GcsOutputResult\022\022\n\noutput_"
+          + "uri\030\001 \001(\tB\337\001\n\037com.google.cloud.retail.v2"
+          + "alphaB\021ExportConfigProtoP\001ZAgoogle.golan"
+          + "g.org/genproto/googleapis/cloud/retail/v"
+          + "2alpha;retail\242\002\006RETAIL\252\002\033Google.Cloud.Re"
+          + "tail.V2Alpha\312\002\033Google\\Cloud\\Retail\\V2alp"
+          + "ha\352\002\036Google::Cloud::Retail::V2alphab\006pro"
+          + "to3"
     };
     descriptor =
         com.google.protobuf.Descriptors.FileDescriptor.internalBuildGeneratedFileFrom(
             descriptorData,
             new com.google.protobuf.Descriptors.FileDescriptor[] {
+              com.google.api.FieldBehaviorProto.getDescriptor(),
+              com.google.api.ResourceProto.getDescriptor(),
               com.google.protobuf.TimestampProto.getDescriptor(),
               com.google.rpc.StatusProto.getDescriptor(),
             });
@@ -134,7 +145,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
         new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable(
             internal_static_google_cloud_retail_v2alpha_OutputResult_descriptor,
             new java.lang.String[] {
-              "BigqueryResult",
+              "BigqueryResult", "GcsResult",
             });
     internal_static_google_cloud_retail_v2alpha_BigQueryOutputResult_descriptor =
         getDescriptor().getMessageTypes().get(5);
@@ -144,6 +155,16 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
             new java.lang.String[] {
               "DatasetId", "TableId",
             });
+    internal_static_google_cloud_retail_v2alpha_GcsOutputResult_descriptor =
+        getDescriptor().getMessageTypes().get(6);
+    internal_static_google_cloud_retail_v2alpha_GcsOutputResult_fieldAccessorTable =
+        new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable(
+            internal_static_google_cloud_retail_v2alpha_GcsOutputResult_descriptor,
+            new java.lang.String[] {
+              "OutputUri",
+            });
+    com.google.api.FieldBehaviorProto.getDescriptor();
+    com.google.api.ResourceProto.getDescriptor();
     com.google.protobuf.TimestampProto.getDescriptor();
     com.google.rpc.StatusProto.getDescriptor();
   }
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ExportMetadata.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ExportMetadata.java
index f692e5838956..8629f7c8cd4b 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ExportMetadata.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ExportMetadata.java
@@ -22,7 +22,7 @@
  *
  *
  * 
      - * Metadata related to the progress of the Export operation. This will be
+ * Metadata related to the progress of the Export operation. This is
  * returned by the google.longrunning.Operation.metadata field.
  * 
      
  *
@@ -343,7 +343,7 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
    *
    *
    * 
      -   * Metadata related to the progress of the Export operation. This will be
+   * Metadata related to the progress of the Export operation. This is
    * returned by the google.longrunning.Operation.metadata field.
    * 
      
    *
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/GcsOutputResult.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/GcsOutputResult.java
new file mode 100644
index 000000000000..e1e2e9663ac7
--- /dev/null
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/GcsOutputResult.java
@@ -0,0 +1,615 @@
+/*
+ * Copyright 2020 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+// Generated by the protocol buffer compiler.  DO NOT EDIT!
+// source: google/cloud/retail/v2alpha/export_config.proto
+
+package com.google.cloud.retail.v2alpha;
+
+/**
+ *
+ *
+ * 
      + * A Gcs output result.
+ * 
      
+ *
+ * Protobuf type {@code google.cloud.retail.v2alpha.GcsOutputResult}
+ */
+public final class GcsOutputResult extends com.google.protobuf.GeneratedMessageV3
+    implements
+    // @@protoc_insertion_point(message_implements:google.cloud.retail.v2alpha.GcsOutputResult)
+    GcsOutputResultOrBuilder {
+  private static final long serialVersionUID = 0L;
+  // Use GcsOutputResult.newBuilder() to construct.
+  private GcsOutputResult(com.google.protobuf.GeneratedMessageV3.Builder builder) {
+    super(builder);
+  }
+
+  private GcsOutputResult() {
+    outputUri_ = "";
+  }
+
+  @java.lang.Override
+  @SuppressWarnings({"unused"})
+  protected java.lang.Object newInstance(UnusedPrivateParameter unused) {
+    return new GcsOutputResult();
+  }
+
+  @java.lang.Override
+  public final com.google.protobuf.UnknownFieldSet getUnknownFields() {
+    return this.unknownFields;
+  }
+
+  public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
+    return com.google.cloud.retail.v2alpha.ExportConfigProto
+        .internal_static_google_cloud_retail_v2alpha_GcsOutputResult_descriptor;
+  }
+
+  @java.lang.Override
+  protected com.google.protobuf.GeneratedMessageV3.FieldAccessorTable
+      internalGetFieldAccessorTable() {
+    return com.google.cloud.retail.v2alpha.ExportConfigProto
+        .internal_static_google_cloud_retail_v2alpha_GcsOutputResult_fieldAccessorTable
+        .ensureFieldAccessorsInitialized(
+            com.google.cloud.retail.v2alpha.GcsOutputResult.class,
+            com.google.cloud.retail.v2alpha.GcsOutputResult.Builder.class);
+  }
+
+  public static final int OUTPUT_URI_FIELD_NUMBER = 1;
+  private volatile java.lang.Object outputUri_;
+  /**
+   *
+   *
+   * 
      +   * The uri of Gcs output
+   * 
      
+   *
+   * string output_uri = 1;
+   *
+   * @return The outputUri.
+   */
+  @java.lang.Override
+  public java.lang.String getOutputUri() {
+    java.lang.Object ref = outputUri_;
+    if (ref instanceof java.lang.String) {
+      return (java.lang.String) ref;
+    } else {
+      com.google.protobuf.ByteString bs = (com.google.protobuf.ByteString) ref;
+      java.lang.String s = bs.toStringUtf8();
+      outputUri_ = s;
+      return s;
+    }
+  }
+  /**
+   *
+   *
+   * 
      +   * The uri of Gcs output
+   * 
      
+   *
+   * string output_uri = 1;
+   *
+   * @return The bytes for outputUri.
+   */
+  @java.lang.Override
+  public com.google.protobuf.ByteString getOutputUriBytes() {
+    java.lang.Object ref = outputUri_;
+    if (ref instanceof java.lang.String) {
+      com.google.protobuf.ByteString b =
+          com.google.protobuf.ByteString.copyFromUtf8((java.lang.String) ref);
+      outputUri_ = b;
+      return b;
+    } else {
+      return (com.google.protobuf.ByteString) ref;
+    }
+  }
+
+  private byte memoizedIsInitialized = -1;
+
+  @java.lang.Override
+  public final boolean isInitialized() {
+    byte isInitialized = memoizedIsInitialized;
+    if (isInitialized == 1) return true;
+    if (isInitialized == 0) return false;
+
+    memoizedIsInitialized = 1;
+    return true;
+  }
+
+  @java.lang.Override
+  public void writeTo(com.google.protobuf.CodedOutputStream output) throws java.io.IOException {
+    if (!com.google.protobuf.GeneratedMessageV3.isStringEmpty(outputUri_)) {
+      com.google.protobuf.GeneratedMessageV3.writeString(output, 1, outputUri_);
+    }
+    getUnknownFields().writeTo(output);
+  }
+
+  @java.lang.Override
+  public int getSerializedSize() {
+    int size = memoizedSize;
+    if (size != -1) return size;
+
+    size = 0;
+    if (!com.google.protobuf.GeneratedMessageV3.isStringEmpty(outputUri_)) {
+      size += com.google.protobuf.GeneratedMessageV3.computeStringSize(1, outputUri_);
+    }
+    size += getUnknownFields().getSerializedSize();
+    memoizedSize = size;
+    return size;
+  }
+
+  @java.lang.Override
+  public boolean equals(final java.lang.Object obj) {
+    if (obj == this) {
+      return true;
+    }
+    if (!(obj instanceof com.google.cloud.retail.v2alpha.GcsOutputResult)) {
+      return super.equals(obj);
+    }
+    com.google.cloud.retail.v2alpha.GcsOutputResult other =
+        (com.google.cloud.retail.v2alpha.GcsOutputResult) obj;
+
+    if (!getOutputUri().equals(other.getOutputUri())) return false;
+    if (!getUnknownFields().equals(other.getUnknownFields())) return false;
+    return true;
+  }
+
+  @java.lang.Override
+  public int hashCode() {
+    if (memoizedHashCode != 0) {
+      return memoizedHashCode;
+    }
+    int hash = 41;
+    hash = (19 * hash) + getDescriptor().hashCode();
+    hash = (37 * hash) + OUTPUT_URI_FIELD_NUMBER;
+    hash = (53 * hash) + getOutputUri().hashCode();
+    hash = (29 * hash) + getUnknownFields().hashCode();
+    memoizedHashCode = hash;
+    return hash;
+  }
+
+  public static com.google.cloud.retail.v2alpha.GcsOutputResult parseFrom(java.nio.ByteBuffer data)
+      throws com.google.protobuf.InvalidProtocolBufferException {
+    return PARSER.parseFrom(data);
+  }
+
+  public static com.google.cloud.retail.v2alpha.GcsOutputResult parseFrom(
+      java.nio.ByteBuffer data, com.google.protobuf.ExtensionRegistryLite extensionRegistry)
+      throws com.google.protobuf.InvalidProtocolBufferException {
+    return PARSER.parseFrom(data, extensionRegistry);
+  }
+
+  public static com.google.cloud.retail.v2alpha.GcsOutputResult parseFrom(
+      com.google.protobuf.ByteString data)
+      throws com.google.protobuf.InvalidProtocolBufferException {
+    return PARSER.parseFrom(data);
+  }
+
+  public static com.google.cloud.retail.v2alpha.GcsOutputResult parseFrom(
+      com.google.protobuf.ByteString data,
+      com.google.protobuf.ExtensionRegistryLite extensionRegistry)
+      throws com.google.protobuf.InvalidProtocolBufferException {
+    return PARSER.parseFrom(data, extensionRegistry);
+  }
+
+  public static com.google.cloud.retail.v2alpha.GcsOutputResult parseFrom(byte[] data)
+      throws com.google.protobuf.InvalidProtocolBufferException {
+    return PARSER.parseFrom(data);
+  }
+
+  public static com.google.cloud.retail.v2alpha.GcsOutputResult parseFrom(
+      byte[] data, com.google.protobuf.ExtensionRegistryLite extensionRegistry)
+      throws com.google.protobuf.InvalidProtocolBufferException {
+    return PARSER.parseFrom(data, extensionRegistry);
+  }
+
+  public static com.google.cloud.retail.v2alpha.GcsOutputResult parseFrom(java.io.InputStream input)
+      throws java.io.IOException {
+    return com.google.protobuf.GeneratedMessageV3.parseWithIOException(PARSER, input);
+  }
+
+  public static com.google.cloud.retail.v2alpha.GcsOutputResult parseFrom(
+      java.io.InputStream input, com.google.protobuf.ExtensionRegistryLite extensionRegistry)
+      throws java.io.IOException {
+    return com.google.protobuf.GeneratedMessageV3.parseWithIOException(
+        PARSER, input, extensionRegistry);
+  }
+
+  public static com.google.cloud.retail.v2alpha.GcsOutputResult parseDelimitedFrom(
+      java.io.InputStream input) throws java.io.IOException {
+    return com.google.protobuf.GeneratedMessageV3.parseDelimitedWithIOException(PARSER, input);
+  }
+
+  public static com.google.cloud.retail.v2alpha.GcsOutputResult parseDelimitedFrom(
+      java.io.InputStream input, com.google.protobuf.ExtensionRegistryLite extensionRegistry)
+      throws java.io.IOException {
+    return com.google.protobuf.GeneratedMessageV3.parseDelimitedWithIOException(
+        PARSER, input, extensionRegistry);
+  }
+
+  public static com.google.cloud.retail.v2alpha.GcsOutputResult parseFrom(
+      com.google.protobuf.CodedInputStream input) throws java.io.IOException {
+    return com.google.protobuf.GeneratedMessageV3.parseWithIOException(PARSER, input);
+  }
+
+  public static com.google.cloud.retail.v2alpha.GcsOutputResult parseFrom(
+      com.google.protobuf.CodedInputStream input,
+      com.google.protobuf.ExtensionRegistryLite extensionRegistry)
+      throws java.io.IOException {
+    return com.google.protobuf.GeneratedMessageV3.parseWithIOException(
+        PARSER, input, extensionRegistry);
+  }
+
+  @java.lang.Override
+  public Builder newBuilderForType() {
+    return newBuilder();
+  }
+
+  public static Builder newBuilder() {
+    return DEFAULT_INSTANCE.toBuilder();
+  }
+
+  public static Builder newBuilder(com.google.cloud.retail.v2alpha.GcsOutputResult prototype) {
+    return DEFAULT_INSTANCE.toBuilder().mergeFrom(prototype);
+  }
+
+  @java.lang.Override
+  public Builder toBuilder() {
+    return this == DEFAULT_INSTANCE ? new Builder() : new Builder().mergeFrom(this);
+  }
+
+  @java.lang.Override
+  protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.BuilderParent parent) {
+    Builder builder = new Builder(parent);
+    return builder;
+  }
+  /**
+   *
+   *
+   * 
      +   * A Gcs output result.
+   * 
      
+   *
+   * Protobuf type {@code google.cloud.retail.v2alpha.GcsOutputResult}
+   */
+  public static final class Builder extends com.google.protobuf.GeneratedMessageV3.Builder
+      implements
+      // @@protoc_insertion_point(builder_implements:google.cloud.retail.v2alpha.GcsOutputResult)
+      com.google.cloud.retail.v2alpha.GcsOutputResultOrBuilder {
+    public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
+      return com.google.cloud.retail.v2alpha.ExportConfigProto
+          .internal_static_google_cloud_retail_v2alpha_GcsOutputResult_descriptor;
+    }
+
+    @java.lang.Override
+    protected com.google.protobuf.GeneratedMessageV3.FieldAccessorTable
+        internalGetFieldAccessorTable() {
+      return com.google.cloud.retail.v2alpha.ExportConfigProto
+          .internal_static_google_cloud_retail_v2alpha_GcsOutputResult_fieldAccessorTable
+          .ensureFieldAccessorsInitialized(
+              com.google.cloud.retail.v2alpha.GcsOutputResult.class,
+              com.google.cloud.retail.v2alpha.GcsOutputResult.Builder.class);
+    }
+
+    // Construct using com.google.cloud.retail.v2alpha.GcsOutputResult.newBuilder()
+    private Builder() {}
+
+    private Builder(com.google.protobuf.GeneratedMessageV3.BuilderParent parent) {
+      super(parent);
+    }
+
+    @java.lang.Override
+    public Builder clear() {
+      super.clear();
+      outputUri_ = "";
+
+      return this;
+    }
+
+    @java.lang.Override
+    public com.google.protobuf.Descriptors.Descriptor getDescriptorForType() {
+      return com.google.cloud.retail.v2alpha.ExportConfigProto
+          .internal_static_google_cloud_retail_v2alpha_GcsOutputResult_descriptor;
+    }
+
+    @java.lang.Override
+    public com.google.cloud.retail.v2alpha.GcsOutputResult getDefaultInstanceForType() {
+      return com.google.cloud.retail.v2alpha.GcsOutputResult.getDefaultInstance();
+    }
+
+    @java.lang.Override
+    public com.google.cloud.retail.v2alpha.GcsOutputResult build() {
+      com.google.cloud.retail.v2alpha.GcsOutputResult result = buildPartial();
+      if (!result.isInitialized()) {
+        throw newUninitializedMessageException(result);
+      }
+      return result;
+    }
+
+    @java.lang.Override
+    public com.google.cloud.retail.v2alpha.GcsOutputResult buildPartial() {
+      com.google.cloud.retail.v2alpha.GcsOutputResult result =
+          new com.google.cloud.retail.v2alpha.GcsOutputResult(this);
+      result.outputUri_ = outputUri_;
+      onBuilt();
+      return result;
+    }
+
+    @java.lang.Override
+    public Builder clone() {
+      return super.clone();
+    }
+
+    @java.lang.Override
+    public Builder setField(
+        com.google.protobuf.Descriptors.FieldDescriptor field, java.lang.Object value) {
+      return super.setField(field, value);
+    }
+
+    @java.lang.Override
+    public Builder clearField(com.google.protobuf.Descriptors.FieldDescriptor field) {
+      return super.clearField(field);
+    }
+
+    @java.lang.Override
+    public Builder clearOneof(com.google.protobuf.Descriptors.OneofDescriptor oneof) {
+      return super.clearOneof(oneof);
+    }
+
+    @java.lang.Override
+    public Builder setRepeatedField(
+        com.google.protobuf.Descriptors.FieldDescriptor field, int index, java.lang.Object value) {
+      return super.setRepeatedField(field, index, value);
+    }
+
+    @java.lang.Override
+    public Builder addRepeatedField(
+        com.google.protobuf.Descriptors.FieldDescriptor field, java.lang.Object value) {
+      return super.addRepeatedField(field, value);
+    }
+
+    @java.lang.Override
+    public Builder mergeFrom(com.google.protobuf.Message other) {
+      if (other instanceof com.google.cloud.retail.v2alpha.GcsOutputResult) {
+        return mergeFrom((com.google.cloud.retail.v2alpha.GcsOutputResult) other);
+      } else {
+        super.mergeFrom(other);
+        return this;
+      }
+    }
+
+    public Builder mergeFrom(com.google.cloud.retail.v2alpha.GcsOutputResult other) {
+      if (other == com.google.cloud.retail.v2alpha.GcsOutputResult.getDefaultInstance())
+        return this;
+      if (!other.getOutputUri().isEmpty()) {
+        outputUri_ = other.outputUri_;
+        onChanged();
+      }
+      this.mergeUnknownFields(other.getUnknownFields());
+      onChanged();
+      return this;
+    }
+
+    @java.lang.Override
+    public final boolean isInitialized() {
+      return true;
+    }
+
+    @java.lang.Override
+    public Builder mergeFrom(
+        com.google.protobuf.CodedInputStream input,
+        com.google.protobuf.ExtensionRegistryLite extensionRegistry)
+        throws java.io.IOException {
+      if (extensionRegistry == null) {
+        throw new java.lang.NullPointerException();
+      }
+      try {
+        boolean done = false;
+        while (!done) {
+          int tag = input.readTag();
+          switch (tag) {
+            case 0:
+              done = true;
+              break;
+            case 10:
+              {
+                outputUri_ = input.readStringRequireUtf8();
+
+                break;
+              } // case 10
+            default:
+              {
+                if (!super.parseUnknownField(input, extensionRegistry, tag)) {
+                  done = true; // was an endgroup tag
+                }
+                break;
+              } // default:
+          } // switch (tag)
+        } // while (!done)
+      } catch (com.google.protobuf.InvalidProtocolBufferException e) {
+        throw e.unwrapIOException();
+      } finally {
+        onChanged();
+      } // finally
+      return this;
+    }
+
+    private java.lang.Object outputUri_ = "";
+    /**
+     *
+     *
+     * 
      +     * The uri of Gcs output
+     * 
      
+     *
+     * string output_uri = 1;
+     *
+     * @return The outputUri.
+     */
+    public java.lang.String getOutputUri() {
+      java.lang.Object ref = outputUri_;
+      if (!(ref instanceof java.lang.String)) {
+        com.google.protobuf.ByteString bs = (com.google.protobuf.ByteString) ref;
+        java.lang.String s = bs.toStringUtf8();
+        outputUri_ = s;
+        return s;
+      } else {
+        return (java.lang.String) ref;
+      }
+    }
+    /**
+     *
+     *
+     * 
      +     * The uri of Gcs output
+     * 
      
+     *
+     * string output_uri = 1;
+     *
+     * @return The bytes for outputUri.
+     */
+    public com.google.protobuf.ByteString getOutputUriBytes() {
+      java.lang.Object ref = outputUri_;
+      if (ref instanceof String) {
+        com.google.protobuf.ByteString b =
+            com.google.protobuf.ByteString.copyFromUtf8((java.lang.String) ref);
+        outputUri_ = b;
+        return b;
+      } else {
+        return (com.google.protobuf.ByteString) ref;
+      }
+    }
+    /**
+     *
+     *
+     * 
      +     * The uri of Gcs output
+     * 
      
+     *
+     * string output_uri = 1;
+     *
+     * @param value The outputUri to set.
+     * @return This builder for chaining.
+     */
+    public Builder setOutputUri(java.lang.String value) {
+      if (value == null) {
+        throw new NullPointerException();
+      }
+
+      outputUri_ = value;
+      onChanged();
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * The uri of Gcs output
+     * 
      
+     *
+     * string output_uri = 1;
+     *
+     * @return This builder for chaining.
+     */
+    public Builder clearOutputUri() {
+
+      outputUri_ = getDefaultInstance().getOutputUri();
+      onChanged();
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * The uri of Gcs output
+     * 
      
+     *
+     * string output_uri = 1;
+     *
+     * @param value The bytes for outputUri to set.
+     * @return This builder for chaining.
+     */
+    public Builder setOutputUriBytes(com.google.protobuf.ByteString value) {
+      if (value == null) {
+        throw new NullPointerException();
+      }
+      checkByteStringIsUtf8(value);
+
+      outputUri_ = value;
+      onChanged();
+      return this;
+    }
+
+    @java.lang.Override
+    public final Builder setUnknownFields(final com.google.protobuf.UnknownFieldSet unknownFields) {
+      return super.setUnknownFields(unknownFields);
+    }
+
+    @java.lang.Override
+    public final Builder mergeUnknownFields(
+        final com.google.protobuf.UnknownFieldSet unknownFields) {
+      return super.mergeUnknownFields(unknownFields);
+    }
+
+    // @@protoc_insertion_point(builder_scope:google.cloud.retail.v2alpha.GcsOutputResult)
+  }
+
+  // @@protoc_insertion_point(class_scope:google.cloud.retail.v2alpha.GcsOutputResult)
+  private static final com.google.cloud.retail.v2alpha.GcsOutputResult DEFAULT_INSTANCE;
+
+  static {
+    DEFAULT_INSTANCE = new com.google.cloud.retail.v2alpha.GcsOutputResult();
+  }
+
+  public static com.google.cloud.retail.v2alpha.GcsOutputResult getDefaultInstance() {
+    return DEFAULT_INSTANCE;
+  }
+
+  private static final com.google.protobuf.Parser PARSER =
+      new com.google.protobuf.AbstractParser() {
+        @java.lang.Override
+        public GcsOutputResult parsePartialFrom(
+            com.google.protobuf.CodedInputStream input,
+            com.google.protobuf.ExtensionRegistryLite extensionRegistry)
+            throws com.google.protobuf.InvalidProtocolBufferException {
+          Builder builder = newBuilder();
+          try {
+            builder.mergeFrom(input, extensionRegistry);
+          } catch (com.google.protobuf.InvalidProtocolBufferException e) {
+            throw e.setUnfinishedMessage(builder.buildPartial());
+          } catch (com.google.protobuf.UninitializedMessageException e) {
+            throw e.asInvalidProtocolBufferException().setUnfinishedMessage(builder.buildPartial());
+          } catch (java.io.IOException e) {
+            throw new com.google.protobuf.InvalidProtocolBufferException(e)
+                .setUnfinishedMessage(builder.buildPartial());
+          }
+          return builder.buildPartial();
+        }
+      };
+
+  public static com.google.protobuf.Parser parser() {
+    return PARSER;
+  }
+
+  @java.lang.Override
+  public com.google.protobuf.Parser getParserForType() {
+    return PARSER;
+  }
+
+  @java.lang.Override
+  public com.google.cloud.retail.v2alpha.GcsOutputResult getDefaultInstanceForType() {
+    return DEFAULT_INSTANCE;
+  }
+}
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/GcsOutputResultOrBuilder.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/GcsOutputResultOrBuilder.java
new file mode 100644
index 000000000000..1e619b727eae
--- /dev/null
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/GcsOutputResultOrBuilder.java
@@ -0,0 +1,50 @@
+/*
+ * Copyright 2020 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+// Generated by the protocol buffer compiler.  DO NOT EDIT!
+// source: google/cloud/retail/v2alpha/export_config.proto
+
+package com.google.cloud.retail.v2alpha;
+
+public interface GcsOutputResultOrBuilder
+    extends
+    // @@protoc_insertion_point(interface_extends:google.cloud.retail.v2alpha.GcsOutputResult)
+    com.google.protobuf.MessageOrBuilder {
+
+  /**
+   *
+   *
+   * 
      +   * The uri of Gcs output
+   * 
      
+   *
+   * string output_uri = 1;
+   *
+   * @return The outputUri.
+   */
+  java.lang.String getOutputUri();
+  /**
+   *
+   *
+   * 
      +   * The uri of Gcs output
+   * 
      
+   *
+   * string output_uri = 1;
+   *
+   * @return The bytes for outputUri.
+   */
+  com.google.protobuf.ByteString getOutputUriBytes();
+}
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/GcsSource.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/GcsSource.java
index b547a3ea9b51..53f529b320fa 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/GcsSource.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/GcsSource.java
@@ -23,7 +23,6 @@
  *
  * 
        * Google Cloud Storage location for input content.
- * format.
  * 
      
  *
  * Protobuf type {@code google.cloud.retail.v2alpha.GcsSource}
@@ -177,10 +176,10 @@ public com.google.protobuf.ByteString getInputUrisBytes(int index) {
    * * `user_event_ga360`: Using
    *   https://support.google.com/analytics/answer/3437719.
    * Supported values for control imports:
-   * * 'control' (default): One JSON
+   * * `control` (default): One JSON
    * [Control][google.cloud.retail.v2alpha.Control] per line.
    * Supported values for catalog attribute imports:
-   * * 'catalog_attribute' (default): One CSV
+   * * `catalog_attribute` (default): One CSV
    * [CatalogAttribute][google.cloud.retail.v2alpha.CatalogAttribute] per line.
    * 
      
    *
@@ -217,10 +216,10 @@ public java.lang.String getDataSchema() {
    * * `user_event_ga360`: Using
    *   https://support.google.com/analytics/answer/3437719.
    * Supported values for control imports:
-   * * 'control' (default): One JSON
+   * * `control` (default): One JSON
    * [Control][google.cloud.retail.v2alpha.Control] per line.
    * Supported values for catalog attribute imports:
-   * * 'catalog_attribute' (default): One CSV
+   * * `catalog_attribute` (default): One CSV
    * [CatalogAttribute][google.cloud.retail.v2alpha.CatalogAttribute] per line.
    * 
      
    *
@@ -421,7 +420,6 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
    *
    * 
          * Google Cloud Storage location for input content.
-   * format.
    * 
      
    *
    * Protobuf type {@code google.cloud.retail.v2alpha.GcsSource}
@@ -863,10 +861,10 @@ public Builder addInputUrisBytes(com.google.protobuf.ByteString value) {
      * * `user_event_ga360`: Using
      *   https://support.google.com/analytics/answer/3437719.
      * Supported values for control imports:
-     * * 'control' (default): One JSON
+     * * `control` (default): One JSON
      * [Control][google.cloud.retail.v2alpha.Control] per line.
      * Supported values for catalog attribute imports:
-     * * 'catalog_attribute' (default): One CSV
+     * * `catalog_attribute` (default): One CSV
      * [CatalogAttribute][google.cloud.retail.v2alpha.CatalogAttribute] per line.
      * 
      
      *
@@ -902,10 +900,10 @@ public java.lang.String getDataSchema() {
      * * `user_event_ga360`: Using
      *   https://support.google.com/analytics/answer/3437719.
      * Supported values for control imports:
-     * * 'control' (default): One JSON
+     * * `control` (default): One JSON
      * [Control][google.cloud.retail.v2alpha.Control] per line.
      * Supported values for catalog attribute imports:
-     * * 'catalog_attribute' (default): One CSV
+     * * `catalog_attribute` (default): One CSV
      * [CatalogAttribute][google.cloud.retail.v2alpha.CatalogAttribute] per line.
      * 
      
      *
@@ -941,10 +939,10 @@ public com.google.protobuf.ByteString getDataSchemaBytes() {
      * * `user_event_ga360`: Using
      *   https://support.google.com/analytics/answer/3437719.
      * Supported values for control imports:
-     * * 'control' (default): One JSON
+     * * `control` (default): One JSON
      * [Control][google.cloud.retail.v2alpha.Control] per line.
      * Supported values for catalog attribute imports:
-     * * 'catalog_attribute' (default): One CSV
+     * * `catalog_attribute` (default): One CSV
      * [CatalogAttribute][google.cloud.retail.v2alpha.CatalogAttribute] per line.
      * 
      
      *
@@ -979,10 +977,10 @@ public Builder setDataSchema(java.lang.String value) {
      * * `user_event_ga360`: Using
      *   https://support.google.com/analytics/answer/3437719.
      * Supported values for control imports:
-     * * 'control' (default): One JSON
+     * * `control` (default): One JSON
      * [Control][google.cloud.retail.v2alpha.Control] per line.
      * Supported values for catalog attribute imports:
-     * * 'catalog_attribute' (default): One CSV
+     * * `catalog_attribute` (default): One CSV
      * [CatalogAttribute][google.cloud.retail.v2alpha.CatalogAttribute] per line.
      * 
      
      *
@@ -1013,10 +1011,10 @@ public Builder clearDataSchema() {
      * * `user_event_ga360`: Using
      *   https://support.google.com/analytics/answer/3437719.
      * Supported values for control imports:
-     * * 'control' (default): One JSON
+     * * `control` (default): One JSON
      * [Control][google.cloud.retail.v2alpha.Control] per line.
      * Supported values for catalog attribute imports:
-     * * 'catalog_attribute' (default): One CSV
+     * * `catalog_attribute` (default): One CSV
      * [CatalogAttribute][google.cloud.retail.v2alpha.CatalogAttribute] per line.
      * 
      
      *
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/GcsSourceOrBuilder.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/GcsSourceOrBuilder.java
index 7dae0f666e2c..0eb9dd2572ec 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/GcsSourceOrBuilder.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/GcsSourceOrBuilder.java
@@ -119,10 +119,10 @@ public interface GcsSourceOrBuilder
    * * `user_event_ga360`: Using
    *   https://support.google.com/analytics/answer/3437719.
    * Supported values for control imports:
-   * * 'control' (default): One JSON
+   * * `control` (default): One JSON
    * [Control][google.cloud.retail.v2alpha.Control] per line.
    * Supported values for catalog attribute imports:
-   * * 'catalog_attribute' (default): One CSV
+   * * `catalog_attribute` (default): One CSV
    * [CatalogAttribute][google.cloud.retail.v2alpha.CatalogAttribute] per line.
    * 
      
    *
@@ -148,10 +148,10 @@ public interface GcsSourceOrBuilder
    * * `user_event_ga360`: Using
    *   https://support.google.com/analytics/answer/3437719.
    * Supported values for control imports:
-   * * 'control' (default): One JSON
+   * * `control` (default): One JSON
    * [Control][google.cloud.retail.v2alpha.Control] per line.
    * Supported values for catalog attribute imports:
-   * * 'catalog_attribute' (default): One CSV
+   * * `catalog_attribute` (default): One CSV
    * [CatalogAttribute][google.cloud.retail.v2alpha.CatalogAttribute] per line.
    * 
      
    *
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/GetCompletionConfigRequest.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/GetCompletionConfigRequest.java
index 0625cbb4945b..e889e82651b6 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/GetCompletionConfigRequest.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/GetCompletionConfigRequest.java
@@ -76,7 +76,7 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    *
    * 
          * 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`
    * 
      
    *
    * 
@@ -102,7 +102,7 @@ public java.lang.String getName() {
    *
    * 
          * 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`
    * 
      
    *
    * 
@@ -463,7 +463,7 @@ public Builder mergeFrom(
      *
      * 
            * 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`
      * 
      
      *
      * 
@@ -488,7 +488,7 @@ public java.lang.String getName() {
      *
      * 
            * 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`
      * 
      
      *
      * 
@@ -513,7 +513,7 @@ public com.google.protobuf.ByteString getNameBytes() {
      *
      * 
            * 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`
      * 
      
      *
      * 
@@ -537,7 +537,7 @@ public Builder setName(java.lang.String value) {
      *
      * 
            * 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`
      * 
      
      *
      * 
@@ -557,7 +557,7 @@ public Builder clearName() {
      *
      * 
            * 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`
      * 
      
      *
      * 
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/GetCompletionConfigRequestOrBuilder.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/GetCompletionConfigRequestOrBuilder.java
index 9e07c1857f4d..4171d1496eec 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/GetCompletionConfigRequestOrBuilder.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/GetCompletionConfigRequestOrBuilder.java
@@ -28,7 +28,7 @@ public interface GetCompletionConfigRequestOrBuilder
    *
    * 
          * 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`
    * 
      
    *
    * 
@@ -43,7 +43,7 @@ public interface GetCompletionConfigRequestOrBuilder
    *
    * 
          * 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`
    * 
      
    *
    * 
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/GetControlRequest.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/GetControlRequest.java
index 8e557ef11cf1..c11fb7adbf11 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/GetControlRequest.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/GetControlRequest.java
@@ -73,7 +73,7 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    *
    *
    * 
      -   * Required. The resource name of the Control to delete. Format:
+   * Required. The resource name of the Control to get. Format:
    * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/controls/{control_id}`
    * 
      
    *
@@ -99,7 +99,7 @@ public java.lang.String getName() {
    *
    *
    * 
      -   * Required. The resource name of the Control to delete. Format:
+   * Required. The resource name of the Control to get. Format:
    * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/controls/{control_id}`
    * 
      
    *
@@ -457,7 +457,7 @@ public Builder mergeFrom(
      *
      *
      * 
      -     * Required. The resource name of the Control to delete. Format:
+     * Required. The resource name of the Control to get. Format:
      * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/controls/{control_id}`
      * 
      
      *
@@ -482,7 +482,7 @@ public java.lang.String getName() {
      *
      *
      * 
      -     * Required. The resource name of the Control to delete. Format:
+     * Required. The resource name of the Control to get. Format:
      * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/controls/{control_id}`
      * 
      
      *
@@ -507,7 +507,7 @@ public com.google.protobuf.ByteString getNameBytes() {
      *
      *
      * 
      -     * Required. The resource name of the Control to delete. Format:
+     * Required. The resource name of the Control to get. Format:
      * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/controls/{control_id}`
      * 
      
      *
@@ -531,7 +531,7 @@ public Builder setName(java.lang.String value) {
      *
      *
      * 
      -     * Required. The resource name of the Control to delete. Format:
+     * Required. The resource name of the Control to get. Format:
      * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/controls/{control_id}`
      * 
      
      *
@@ -551,7 +551,7 @@ public Builder clearName() {
      *
      *
      * 
      -     * Required. The resource name of the Control to delete. Format:
+     * Required. The resource name of the Control to get. Format:
      * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/controls/{control_id}`
      * 
      
      *
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/GetControlRequestOrBuilder.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/GetControlRequestOrBuilder.java
index a4d02d8a0ca7..e949b1355580 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/GetControlRequestOrBuilder.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/GetControlRequestOrBuilder.java
@@ -27,7 +27,7 @@ public interface GetControlRequestOrBuilder
    *
    *
    * 
      -   * Required. The resource name of the Control to delete. Format:
+   * Required. The resource name of the Control to get. Format:
    * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/controls/{control_id}`
    * 
      
    *
@@ -42,7 +42,7 @@ public interface GetControlRequestOrBuilder
    *
    *
    * 
      -   * Required. The resource name of the Control to delete. Format:
+   * Required. The resource name of the Control to get. Format:
    * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/controls/{control_id}`
    * 
      
    *
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/GetServingConfigRequest.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/GetServingConfigRequest.java
index 60bff1c3bd15..1abb1221467c 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/GetServingConfigRequest.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/GetServingConfigRequest.java
@@ -74,7 +74,7 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    *
    * 
          * Required. The resource name of the ServingConfig to get. Format:
-   * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+   * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
    * 
      
    *
    * 
@@ -100,7 +100,7 @@ public java.lang.String getName() {
    *
    * 
          * Required. The resource name of the ServingConfig to get. Format:
-   * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+   * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
    * 
      
    *
    * 
@@ -459,7 +459,7 @@ public Builder mergeFrom(
      *
      * 
            * Required. The resource name of the ServingConfig to get. Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
      * 
      
      *
      * 
@@ -484,7 +484,7 @@ public java.lang.String getName() {
      *
      * 
            * Required. The resource name of the ServingConfig to get. Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
      * 
      
      *
      * 
@@ -509,7 +509,7 @@ public com.google.protobuf.ByteString getNameBytes() {
      *
      * 
            * Required. The resource name of the ServingConfig to get. Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
      * 
      
      *
      * 
@@ -533,7 +533,7 @@ public Builder setName(java.lang.String value) {
      *
      * 
            * Required. The resource name of the ServingConfig to get. Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
      * 
      
      *
      * 
@@ -553,7 +553,7 @@ public Builder clearName() {
      *
      * 
            * Required. The resource name of the ServingConfig to get. Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
      * 
      
      *
      * 
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/GetServingConfigRequestOrBuilder.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/GetServingConfigRequestOrBuilder.java
index 604b7bb25a2a..5573cd4ac991 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/GetServingConfigRequestOrBuilder.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/GetServingConfigRequestOrBuilder.java
@@ -28,7 +28,7 @@ public interface GetServingConfigRequestOrBuilder
    *
    * 
          * Required. The resource name of the ServingConfig to get. Format:
-   * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+   * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
    * 
      
    *
    * 
@@ -43,7 +43,7 @@ public interface GetServingConfigRequestOrBuilder
    *
    * 
          * Required. The resource name of the ServingConfig to get. Format:
-   * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+   * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
    * 
      
    *
    * 
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ImportCompletionDataRequest.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ImportCompletionDataRequest.java
index ab931c10a570..628cc0e0b896 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ImportCompletionDataRequest.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ImportCompletionDataRequest.java
@@ -185,8 +185,8 @@ public com.google.cloud.retail.v2alpha.CompletionDataInputConfig getInputConfig(
    *
    * 
          * Pub/Sub topic for receiving notification. If this field is set,
-   * when the import is finished, a notification will be sent to
-   * specified Pub/Sub topic. The message data will be JSON string of a
+   * when the import is finished, a notification is sent to
+   * specified Pub/Sub topic. The message data is JSON string of a
    * [Operation][google.longrunning.Operation].
    * Format of the Pub/Sub topic is `projects/{project}/topics/{topic}`.
    * 
      
@@ -212,8 +212,8 @@ public java.lang.String getNotificationPubsubTopic() {
    *
    * 
          * Pub/Sub topic for receiving notification. If this field is set,
-   * when the import is finished, a notification will be sent to
-   * specified Pub/Sub topic. The message data will be JSON string of a
+   * when the import is finished, a notification is sent to
+   * specified Pub/Sub topic. The message data is JSON string of a
    * [Operation][google.longrunning.Operation].
    * Format of the Pub/Sub topic is `projects/{project}/topics/{topic}`.
    * 
      
@@ -956,8 +956,8 @@ public Builder clearInputConfig() {
      *
      * 
            * Pub/Sub topic for receiving notification. If this field is set,
-     * when the import is finished, a notification will be sent to
-     * specified Pub/Sub topic. The message data will be JSON string of a
+     * when the import is finished, a notification is sent to
+     * specified Pub/Sub topic. The message data is JSON string of a
      * [Operation][google.longrunning.Operation].
      * Format of the Pub/Sub topic is `projects/{project}/topics/{topic}`.
      * 
      
@@ -982,8 +982,8 @@ public java.lang.String getNotificationPubsubTopic() {
      *
      * 
            * Pub/Sub topic for receiving notification. If this field is set,
-     * when the import is finished, a notification will be sent to
-     * specified Pub/Sub topic. The message data will be JSON string of a
+     * when the import is finished, a notification is sent to
+     * specified Pub/Sub topic. The message data is JSON string of a
      * [Operation][google.longrunning.Operation].
      * Format of the Pub/Sub topic is `projects/{project}/topics/{topic}`.
      * 
      
@@ -1008,8 +1008,8 @@ public com.google.protobuf.ByteString getNotificationPubsubTopicBytes() {
      *
      * 
            * Pub/Sub topic for receiving notification. If this field is set,
-     * when the import is finished, a notification will be sent to
-     * specified Pub/Sub topic. The message data will be JSON string of a
+     * when the import is finished, a notification is sent to
+     * specified Pub/Sub topic. The message data is JSON string of a
      * [Operation][google.longrunning.Operation].
      * Format of the Pub/Sub topic is `projects/{project}/topics/{topic}`.
      * 
      
@@ -1033,8 +1033,8 @@ public Builder setNotificationPubsubTopic(java.lang.String value) {
      *
      * 
            * Pub/Sub topic for receiving notification. If this field is set,
-     * when the import is finished, a notification will be sent to
-     * specified Pub/Sub topic. The message data will be JSON string of a
+     * when the import is finished, a notification is sent to
+     * specified Pub/Sub topic. The message data is JSON string of a
      * [Operation][google.longrunning.Operation].
      * Format of the Pub/Sub topic is `projects/{project}/topics/{topic}`.
      * 
      
@@ -1054,8 +1054,8 @@ public Builder clearNotificationPubsubTopic() {
      *
      * 
            * Pub/Sub topic for receiving notification. If this field is set,
-     * when the import is finished, a notification will be sent to
-     * specified Pub/Sub topic. The message data will be JSON string of a
+     * when the import is finished, a notification is sent to
+     * specified Pub/Sub topic. The message data is JSON string of a
      * [Operation][google.longrunning.Operation].
      * Format of the Pub/Sub topic is `projects/{project}/topics/{topic}`.
      * 
      
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ImportCompletionDataRequestOrBuilder.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ImportCompletionDataRequestOrBuilder.java
index 0583edd11dec..f1a1e645568c 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ImportCompletionDataRequestOrBuilder.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ImportCompletionDataRequestOrBuilder.java
@@ -100,8 +100,8 @@ public interface ImportCompletionDataRequestOrBuilder
    *
    * 
          * Pub/Sub topic for receiving notification. If this field is set,
-   * when the import is finished, a notification will be sent to
-   * specified Pub/Sub topic. The message data will be JSON string of a
+   * when the import is finished, a notification is sent to
+   * specified Pub/Sub topic. The message data is JSON string of a
    * [Operation][google.longrunning.Operation].
    * Format of the Pub/Sub topic is `projects/{project}/topics/{topic}`.
    * 
      
@@ -116,8 +116,8 @@ public interface ImportCompletionDataRequestOrBuilder
    *
    * 
          * Pub/Sub topic for receiving notification. If this field is set,
-   * when the import is finished, a notification will be sent to
-   * specified Pub/Sub topic. The message data will be JSON string of a
+   * when the import is finished, a notification is sent to
+   * specified Pub/Sub topic. The message data is JSON string of a
    * [Operation][google.longrunning.Operation].
    * Format of the Pub/Sub topic is `projects/{project}/topics/{topic}`.
    * 
      
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ImportConfigProto.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ImportConfigProto.java
index 4e90fcd0e9bd..9d605874aa36 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ImportConfigProto.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ImportConfigProto.java
@@ -75,6 +75,10 @@ public static void registerAllExtensions(com.google.protobuf.ExtensionRegistry r
       internal_static_google_cloud_retail_v2alpha_ImportMetadata_descriptor;
   static final com.google.protobuf.GeneratedMessageV3.FieldAccessorTable
       internal_static_google_cloud_retail_v2alpha_ImportMetadata_fieldAccessorTable;
+  static final com.google.protobuf.Descriptors.Descriptor
+      internal_static_google_cloud_retail_v2alpha_TransformedUserEventsMetadata_descriptor;
+  static final com.google.protobuf.GeneratedMessageV3.FieldAccessorTable
+      internal_static_google_cloud_retail_v2alpha_TransformedUserEventsMetadata_fieldAccessorTable;
   static final com.google.protobuf.Descriptors.Descriptor
       internal_static_google_cloud_retail_v2alpha_ImportProductsResponse_descriptor;
   static final com.google.protobuf.GeneratedMessageV3.FieldAccessorTable
@@ -161,32 +165,37 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
           + "BigQuerySourceB\003\340A\002H\000B\010\n\006source\"s\n\031Compl"
           + "etionDataInputConfig\022L\n\020big_query_source"
           + "\030\001 \001(\0132+.google.cloud.retail.v2alpha.Big"
-          + "QuerySourceB\003\340A\002H\000B\010\n\006source\"\333\001\n\016ImportM"
+          + "QuerySourceB\003\340A\002H\000B\010\n\006source\"\301\002\n\016ImportM"
           + "etadata\022/\n\013create_time\030\001 \001(\0132\032.google.pr"
           + "otobuf.Timestamp\022/\n\013update_time\030\002 \001(\0132\032."
           + "google.protobuf.Timestamp\022\025\n\rsuccess_cou"
           + "nt\030\003 \001(\003\022\025\n\rfailure_count\030\004 \001(\003\022\026\n\nreque"
           + "st_id\030\005 \001(\tB\002\030\001\022!\n\031notification_pubsub_t"
-          + "opic\030\006 \001(\t\"\213\001\n\026ImportProductsResponse\022)\n"
-          + "\rerror_samples\030\001 \003(\0132\022.google.rpc.Status"
-          + "\022F\n\rerrors_config\030\002 \001(\0132/.google.cloud.r"
-          + "etail.v2alpha.ImportErrorsConfig\"\332\001\n\030Imp"
-          + "ortUserEventsResponse\022)\n\rerror_samples\030\001"
-          + " \003(\0132\022.google.rpc.Status\022F\n\rerrors_confi"
-          + "g\030\002 \001(\0132/.google.cloud.retail.v2alpha.Im"
-          + "portErrorsConfig\022K\n\016import_summary\030\003 \001(\013"
-          + "23.google.cloud.retail.v2alpha.UserEvent"
-          + "ImportSummary\"T\n\026UserEventImportSummary\022"
-          + "\033\n\023joined_events_count\030\001 \001(\003\022\035\n\025unjoined"
-          + "_events_count\030\002 \001(\003\"I\n\034ImportCompletionD"
-          + "ataResponse\022)\n\rerror_samples\030\001 \003(\0132\022.goo"
-          + "gle.rpc.StatusB\337\001\n\037com.google.cloud.reta"
-          + "il.v2alphaB\021ImportConfigProtoP\001ZAgoogle."
-          + "golang.org/genproto/googleapis/cloud/ret"
-          + "ail/v2alpha;retail\242\002\006RETAIL\252\002\033Google.Clo"
-          + "ud.Retail.V2Alpha\312\002\033Google\\Cloud\\Retail\\"
-          + "V2alpha\352\002\036Google::Cloud::Retail::V2alpha"
-          + "b\006proto3"
+          + "opic\030\006 \001(\t\022d\n transformed_user_events_me"
+          + "tadata\030\007 \001(\0132:.google.cloud.retail.v2alp"
+          + "ha.TransformedUserEventsMetadata\"^\n\035Tran"
+          + "sformedUserEventsMetadata\022\033\n\023source_even"
+          + "ts_count\030\001 \001(\003\022 \n\030transformed_events_cou"
+          + "nt\030\002 \001(\003\"\213\001\n\026ImportProductsResponse\022)\n\re"
+          + "rror_samples\030\001 \003(\0132\022.google.rpc.Status\022F"
+          + "\n\rerrors_config\030\002 \001(\0132/.google.cloud.ret"
+          + "ail.v2alpha.ImportErrorsConfig\"\332\001\n\030Impor"
+          + "tUserEventsResponse\022)\n\rerror_samples\030\001 \003"
+          + "(\0132\022.google.rpc.Status\022F\n\rerrors_config\030"
+          + "\002 \001(\0132/.google.cloud.retail.v2alpha.Impo"
+          + "rtErrorsConfig\022K\n\016import_summary\030\003 \001(\01323"
+          + ".google.cloud.retail.v2alpha.UserEventIm"
+          + "portSummary\"T\n\026UserEventImportSummary\022\033\n"
+          + "\023joined_events_count\030\001 \001(\003\022\035\n\025unjoined_e"
+          + "vents_count\030\002 \001(\003\"I\n\034ImportCompletionDat"
+          + "aResponse\022)\n\rerror_samples\030\001 \003(\0132\022.googl"
+          + "e.rpc.StatusB\337\001\n\037com.google.cloud.retail"
+          + ".v2alphaB\021ImportConfigProtoP\001ZAgoogle.go"
+          + "lang.org/genproto/googleapis/cloud/retai"
+          + "l/v2alpha;retail\242\002\006RETAIL\252\002\033Google.Cloud"
+          + ".Retail.V2Alpha\312\002\033Google\\Cloud\\Retail\\V2"
+          + "alpha\352\002\036Google::Cloud::Retail::V2alphab\006"
+          + "proto3"
     };
     descriptor =
         com.google.protobuf.Descriptors.FileDescriptor.internalBuildGeneratedFileFrom(
@@ -314,9 +323,18 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
               "FailureCount",
               "RequestId",
               "NotificationPubsubTopic",
+              "TransformedUserEventsMetadata",
             });
-    internal_static_google_cloud_retail_v2alpha_ImportProductsResponse_descriptor =
+    internal_static_google_cloud_retail_v2alpha_TransformedUserEventsMetadata_descriptor =
         getDescriptor().getMessageTypes().get(12);
+    internal_static_google_cloud_retail_v2alpha_TransformedUserEventsMetadata_fieldAccessorTable =
+        new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable(
+            internal_static_google_cloud_retail_v2alpha_TransformedUserEventsMetadata_descriptor,
+            new java.lang.String[] {
+              "SourceEventsCount", "TransformedEventsCount",
+            });
+    internal_static_google_cloud_retail_v2alpha_ImportProductsResponse_descriptor =
+        getDescriptor().getMessageTypes().get(13);
     internal_static_google_cloud_retail_v2alpha_ImportProductsResponse_fieldAccessorTable =
         new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable(
             internal_static_google_cloud_retail_v2alpha_ImportProductsResponse_descriptor,
@@ -324,7 +342,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
               "ErrorSamples", "ErrorsConfig",
             });
     internal_static_google_cloud_retail_v2alpha_ImportUserEventsResponse_descriptor =
-        getDescriptor().getMessageTypes().get(13);
+        getDescriptor().getMessageTypes().get(14);
     internal_static_google_cloud_retail_v2alpha_ImportUserEventsResponse_fieldAccessorTable =
         new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable(
             internal_static_google_cloud_retail_v2alpha_ImportUserEventsResponse_descriptor,
@@ -332,7 +350,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
               "ErrorSamples", "ErrorsConfig", "ImportSummary",
             });
     internal_static_google_cloud_retail_v2alpha_UserEventImportSummary_descriptor =
-        getDescriptor().getMessageTypes().get(14);
+        getDescriptor().getMessageTypes().get(15);
     internal_static_google_cloud_retail_v2alpha_UserEventImportSummary_fieldAccessorTable =
         new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable(
             internal_static_google_cloud_retail_v2alpha_UserEventImportSummary_descriptor,
@@ -340,7 +358,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
               "JoinedEventsCount", "UnjoinedEventsCount",
             });
     internal_static_google_cloud_retail_v2alpha_ImportCompletionDataResponse_descriptor =
-        getDescriptor().getMessageTypes().get(15);
+        getDescriptor().getMessageTypes().get(16);
     internal_static_google_cloud_retail_v2alpha_ImportCompletionDataResponse_fieldAccessorTable =
         new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable(
             internal_static_google_cloud_retail_v2alpha_ImportCompletionDataResponse_descriptor,
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ImportErrorsConfig.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ImportErrorsConfig.java
index ec7b39b18abb..89e59ae8c561 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ImportErrorsConfig.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ImportErrorsConfig.java
@@ -115,7 +115,7 @@ public DestinationCase getDestinationCase() {
    *
    * 
          * Google Cloud Storage prefix for import errors. This must be an empty,
-   * existing Cloud Storage directory. Import errors will be written to
+   * existing Cloud Storage directory. Import errors are written to
    * sharded files in this directory, one per line, as a JSON-encoded
    * `google.rpc.Status` message.
    * 
      
@@ -132,7 +132,7 @@ public boolean hasGcsPrefix() {
    *
    * 
          * Google Cloud Storage prefix for import errors. This must be an empty,
-   * existing Cloud Storage directory. Import errors will be written to
+   * existing Cloud Storage directory. Import errors are written to
    * sharded files in this directory, one per line, as a JSON-encoded
    * `google.rpc.Status` message.
    * 
      
@@ -162,7 +162,7 @@ public java.lang.String getGcsPrefix() {
    *
    * 
          * Google Cloud Storage prefix for import errors. This must be an empty,
-   * existing Cloud Storage directory. Import errors will be written to
+   * existing Cloud Storage directory. Import errors are written to
    * sharded files in this directory, one per line, as a JSON-encoded
    * `google.rpc.Status` message.
    * 
      
@@ -563,7 +563,7 @@ public Builder clearDestination() {
      *
      * 
            * Google Cloud Storage prefix for import errors. This must be an empty,
-     * existing Cloud Storage directory. Import errors will be written to
+     * existing Cloud Storage directory. Import errors are written to
      * sharded files in this directory, one per line, as a JSON-encoded
      * `google.rpc.Status` message.
      * 
      
@@ -581,7 +581,7 @@ public boolean hasGcsPrefix() {
      *
      * 
            * Google Cloud Storage prefix for import errors. This must be an empty,
-     * existing Cloud Storage directory. Import errors will be written to
+     * existing Cloud Storage directory. Import errors are written to
      * sharded files in this directory, one per line, as a JSON-encoded
      * `google.rpc.Status` message.
      * 
      
@@ -612,7 +612,7 @@ public java.lang.String getGcsPrefix() {
      *
      * 
            * Google Cloud Storage prefix for import errors. This must be an empty,
-     * existing Cloud Storage directory. Import errors will be written to
+     * existing Cloud Storage directory. Import errors are written to
      * sharded files in this directory, one per line, as a JSON-encoded
      * `google.rpc.Status` message.
      * 
      
@@ -643,7 +643,7 @@ public com.google.protobuf.ByteString getGcsPrefixBytes() {
      *
      * 
            * Google Cloud Storage prefix for import errors. This must be an empty,
-     * existing Cloud Storage directory. Import errors will be written to
+     * existing Cloud Storage directory. Import errors are written to
      * sharded files in this directory, one per line, as a JSON-encoded
      * `google.rpc.Status` message.
      * 
      
@@ -667,7 +667,7 @@ public Builder setGcsPrefix(java.lang.String value) {
      *
      * 
            * Google Cloud Storage prefix for import errors. This must be an empty,
-     * existing Cloud Storage directory. Import errors will be written to
+     * existing Cloud Storage directory. Import errors are written to
      * sharded files in this directory, one per line, as a JSON-encoded
      * `google.rpc.Status` message.
      * 
      
@@ -689,7 +689,7 @@ public Builder clearGcsPrefix() {
      *
      * 
            * Google Cloud Storage prefix for import errors. This must be an empty,
-     * existing Cloud Storage directory. Import errors will be written to
+     * existing Cloud Storage directory. Import errors are written to
      * sharded files in this directory, one per line, as a JSON-encoded
      * `google.rpc.Status` message.
      * 
      
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ImportErrorsConfigOrBuilder.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ImportErrorsConfigOrBuilder.java
index e7ac9ef6e05c..646808275ab8 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ImportErrorsConfigOrBuilder.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ImportErrorsConfigOrBuilder.java
@@ -28,7 +28,7 @@ public interface ImportErrorsConfigOrBuilder
    *
    * 
          * Google Cloud Storage prefix for import errors. This must be an empty,
-   * existing Cloud Storage directory. Import errors will be written to
+   * existing Cloud Storage directory. Import errors are written to
    * sharded files in this directory, one per line, as a JSON-encoded
    * `google.rpc.Status` message.
    * 
      
@@ -43,7 +43,7 @@ public interface ImportErrorsConfigOrBuilder
    *
    * 
          * Google Cloud Storage prefix for import errors. This must be an empty,
-   * existing Cloud Storage directory. Import errors will be written to
+   * existing Cloud Storage directory. Import errors are written to
    * sharded files in this directory, one per line, as a JSON-encoded
    * `google.rpc.Status` message.
    * 
      
@@ -58,7 +58,7 @@ public interface ImportErrorsConfigOrBuilder
    *
    * 
          * Google Cloud Storage prefix for import errors. This must be an empty,
-   * existing Cloud Storage directory. Import errors will be written to
+   * existing Cloud Storage directory. Import errors are written to
    * sharded files in this directory, one per line, as a JSON-encoded
    * `google.rpc.Status` message.
    * 
      
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ImportMetadata.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ImportMetadata.java
index ba77869e1c58..3c8471cda2c5 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ImportMetadata.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ImportMetadata.java
@@ -22,7 +22,7 @@
  *
  *
  * 
      - * Metadata related to the progress of the Import operation. This will be
+ * Metadata related to the progress of the Import operation. This is
  * returned by the google.longrunning.Operation.metadata field.
  * 
      
  *
@@ -212,7 +212,7 @@ public long getFailureCount() {
    * string request_id = 5 [deprecated = true];
    *
    * @deprecated google.cloud.retail.v2alpha.ImportMetadata.request_id is deprecated. See
-   *     google/cloud/retail/v2alpha/import_config.proto;l=357
+   *     google/cloud/retail/v2alpha/import_config.proto;l=339
    * @return The requestId.
    */
   @java.lang.Override
@@ -238,7 +238,7 @@ public java.lang.String getRequestId() {
    * string request_id = 5 [deprecated = true];
    *
    * @deprecated google.cloud.retail.v2alpha.ImportMetadata.request_id is deprecated. See
-   *     google/cloud/retail/v2alpha/import_config.proto;l=357
+   *     google/cloud/retail/v2alpha/import_config.proto;l=339
    * @return The bytes for requestId.
    */
   @java.lang.Override
@@ -262,8 +262,8 @@ public com.google.protobuf.ByteString getRequestIdBytes() {
    *
    * 
          * Pub/Sub topic for receiving notification. If this field is set,
-   * when the import is finished, a notification will be sent to
-   * specified Pub/Sub topic. The message data will be JSON string of a
+   * when the import is finished, a notification is sent to
+   * specified Pub/Sub topic. The message data is JSON string of a
    * [Operation][google.longrunning.Operation].
    * Format of the Pub/Sub topic is `projects/{project}/topics/{topic}`.
    * 
      
@@ -289,8 +289,8 @@ public java.lang.String getNotificationPubsubTopic() {
    *
    * 
          * Pub/Sub topic for receiving notification. If this field is set,
-   * when the import is finished, a notification will be sent to
-   * specified Pub/Sub topic. The message data will be JSON string of a
+   * when the import is finished, a notification is sent to
+   * specified Pub/Sub topic. The message data is JSON string of a
    * [Operation][google.longrunning.Operation].
    * Format of the Pub/Sub topic is `projects/{project}/topics/{topic}`.
    * 
      
@@ -312,6 +312,63 @@ public com.google.protobuf.ByteString getNotificationPubsubTopicBytes() {
     }
   }
 
+  public static final int TRANSFORMED_USER_EVENTS_METADATA_FIELD_NUMBER = 7;
+  private com.google.cloud.retail.v2alpha.TransformedUserEventsMetadata
+      transformedUserEventsMetadata_;
+  /**
+   *
+   *
+   * 
      +   * Metadata related to transform user events.
+   * 
      
+   *
+   * 
+   * .google.cloud.retail.v2alpha.TransformedUserEventsMetadata transformed_user_events_metadata = 7;
+   * 
+   *
+   * @return Whether the transformedUserEventsMetadata field is set.
+   */
+  @java.lang.Override
+  public boolean hasTransformedUserEventsMetadata() {
+    return transformedUserEventsMetadata_ != null;
+  }
+  /**
+   *
+   *
+   * 
      +   * Metadata related to transform user events.
+   * 
      
+   *
+   * 
+   * .google.cloud.retail.v2alpha.TransformedUserEventsMetadata transformed_user_events_metadata = 7;
+   * 
+   *
+   * @return The transformedUserEventsMetadata.
+   */
+  @java.lang.Override
+  public com.google.cloud.retail.v2alpha.TransformedUserEventsMetadata
+      getTransformedUserEventsMetadata() {
+    return transformedUserEventsMetadata_ == null
+        ? com.google.cloud.retail.v2alpha.TransformedUserEventsMetadata.getDefaultInstance()
+        : transformedUserEventsMetadata_;
+  }
+  /**
+   *
+   *
+   * 
      +   * Metadata related to transform user events.
+   * 
      
+   *
+   * 
+   * .google.cloud.retail.v2alpha.TransformedUserEventsMetadata transformed_user_events_metadata = 7;
+   * 
+   */
+  @java.lang.Override
+  public com.google.cloud.retail.v2alpha.TransformedUserEventsMetadataOrBuilder
+      getTransformedUserEventsMetadataOrBuilder() {
+    return getTransformedUserEventsMetadata();
+  }
+
   private byte memoizedIsInitialized = -1;
 
   @java.lang.Override
@@ -344,6 +401,9 @@ public void writeTo(com.google.protobuf.CodedOutputStream output) throws java.io
     if (!com.google.protobuf.GeneratedMessageV3.isStringEmpty(notificationPubsubTopic_)) {
       com.google.protobuf.GeneratedMessageV3.writeString(output, 6, notificationPubsubTopic_);
     }
+    if (transformedUserEventsMetadata_ != null) {
+      output.writeMessage(7, getTransformedUserEventsMetadata());
+    }
     getUnknownFields().writeTo(output);
   }
 
@@ -371,6 +431,11 @@ public int getSerializedSize() {
     if (!com.google.protobuf.GeneratedMessageV3.isStringEmpty(notificationPubsubTopic_)) {
       size += com.google.protobuf.GeneratedMessageV3.computeStringSize(6, notificationPubsubTopic_);
     }
+    if (transformedUserEventsMetadata_ != null) {
+      size +=
+          com.google.protobuf.CodedOutputStream.computeMessageSize(
+              7, getTransformedUserEventsMetadata());
+    }
     size += getUnknownFields().getSerializedSize();
     memoizedSize = size;
     return size;
@@ -399,6 +464,12 @@ public boolean equals(final java.lang.Object obj) {
     if (getFailureCount() != other.getFailureCount()) return false;
     if (!getRequestId().equals(other.getRequestId())) return false;
     if (!getNotificationPubsubTopic().equals(other.getNotificationPubsubTopic())) return false;
+    if (hasTransformedUserEventsMetadata() != other.hasTransformedUserEventsMetadata())
+      return false;
+    if (hasTransformedUserEventsMetadata()) {
+      if (!getTransformedUserEventsMetadata().equals(other.getTransformedUserEventsMetadata()))
+        return false;
+    }
     if (!getUnknownFields().equals(other.getUnknownFields())) return false;
     return true;
   }
@@ -426,6 +497,10 @@ public int hashCode() {
     hash = (53 * hash) + getRequestId().hashCode();
     hash = (37 * hash) + NOTIFICATION_PUBSUB_TOPIC_FIELD_NUMBER;
     hash = (53 * hash) + getNotificationPubsubTopic().hashCode();
+    if (hasTransformedUserEventsMetadata()) {
+      hash = (37 * hash) + TRANSFORMED_USER_EVENTS_METADATA_FIELD_NUMBER;
+      hash = (53 * hash) + getTransformedUserEventsMetadata().hashCode();
+    }
     hash = (29 * hash) + getUnknownFields().hashCode();
     memoizedHashCode = hash;
     return hash;
@@ -530,7 +605,7 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
    *
    *
    * 
      -   * Metadata related to the progress of the Import operation. This will be
+   * Metadata related to the progress of the Import operation. This is
    * returned by the google.longrunning.Operation.metadata field.
    * 
      
    *
@@ -585,6 +660,12 @@ public Builder clear() {
 
       notificationPubsubTopic_ = "";
 
+      if (transformedUserEventsMetadataBuilder_ == null) {
+        transformedUserEventsMetadata_ = null;
+      } else {
+        transformedUserEventsMetadata_ = null;
+        transformedUserEventsMetadataBuilder_ = null;
+      }
       return this;
     }
 
@@ -626,6 +707,11 @@ public com.google.cloud.retail.v2alpha.ImportMetadata buildPartial() {
       result.failureCount_ = failureCount_;
       result.requestId_ = requestId_;
       result.notificationPubsubTopic_ = notificationPubsubTopic_;
+      if (transformedUserEventsMetadataBuilder_ == null) {
+        result.transformedUserEventsMetadata_ = transformedUserEventsMetadata_;
+      } else {
+        result.transformedUserEventsMetadata_ = transformedUserEventsMetadataBuilder_.build();
+      }
       onBuilt();
       return result;
     }
@@ -695,6 +781,9 @@ public Builder mergeFrom(com.google.cloud.retail.v2alpha.ImportMetadata other) {
         notificationPubsubTopic_ = other.notificationPubsubTopic_;
         onChanged();
       }
+      if (other.hasTransformedUserEventsMetadata()) {
+        mergeTransformedUserEventsMetadata(other.getTransformedUserEventsMetadata());
+      }
       this.mergeUnknownFields(other.getUnknownFields());
       onChanged();
       return this;
@@ -757,6 +846,13 @@ public Builder mergeFrom(
 
                 break;
               } // case 50
+            case 58:
+              {
+                input.readMessage(
+                    getTransformedUserEventsMetadataFieldBuilder().getBuilder(), extensionRegistry);
+
+                break;
+              } // case 58
             default:
               {
                 if (!super.parseUnknownField(input, extensionRegistry, tag)) {
@@ -1264,7 +1360,7 @@ public Builder clearFailureCount() {
      * string request_id = 5 [deprecated = true];
      *
      * @deprecated google.cloud.retail.v2alpha.ImportMetadata.request_id is deprecated. See
-     *     google/cloud/retail/v2alpha/import_config.proto;l=357
+     *     google/cloud/retail/v2alpha/import_config.proto;l=339
      * @return The requestId.
      */
     @java.lang.Deprecated
@@ -1289,7 +1385,7 @@ public java.lang.String getRequestId() {
      * string request_id = 5 [deprecated = true];
      *
      * @deprecated google.cloud.retail.v2alpha.ImportMetadata.request_id is deprecated. See
-     *     google/cloud/retail/v2alpha/import_config.proto;l=357
+     *     google/cloud/retail/v2alpha/import_config.proto;l=339
      * @return The bytes for requestId.
      */
     @java.lang.Deprecated
@@ -1314,7 +1410,7 @@ public com.google.protobuf.ByteString getRequestIdBytes() {
      * string request_id = 5 [deprecated = true];
      *
      * @deprecated google.cloud.retail.v2alpha.ImportMetadata.request_id is deprecated. See
-     *     google/cloud/retail/v2alpha/import_config.proto;l=357
+     *     google/cloud/retail/v2alpha/import_config.proto;l=339
      * @param value The requestId to set.
      * @return This builder for chaining.
      */
@@ -1338,7 +1434,7 @@ public Builder setRequestId(java.lang.String value) {
      * string request_id = 5 [deprecated = true];
      *
      * @deprecated google.cloud.retail.v2alpha.ImportMetadata.request_id is deprecated. See
-     *     google/cloud/retail/v2alpha/import_config.proto;l=357
+     *     google/cloud/retail/v2alpha/import_config.proto;l=339
      * @return This builder for chaining.
      */
     @java.lang.Deprecated
@@ -1358,7 +1454,7 @@ public Builder clearRequestId() {
      * string request_id = 5 [deprecated = true];
      *
      * @deprecated google.cloud.retail.v2alpha.ImportMetadata.request_id is deprecated. See
-     *     google/cloud/retail/v2alpha/import_config.proto;l=357
+     *     google/cloud/retail/v2alpha/import_config.proto;l=339
      * @param value The bytes for requestId to set.
      * @return This builder for chaining.
      */
@@ -1380,8 +1476,8 @@ public Builder setRequestIdBytes(com.google.protobuf.ByteString value) {
      *
      * 
            * Pub/Sub topic for receiving notification. If this field is set,
-     * when the import is finished, a notification will be sent to
-     * specified Pub/Sub topic. The message data will be JSON string of a
+     * when the import is finished, a notification is sent to
+     * specified Pub/Sub topic. The message data is JSON string of a
      * [Operation][google.longrunning.Operation].
      * Format of the Pub/Sub topic is `projects/{project}/topics/{topic}`.
      * 
      
@@ -1406,8 +1502,8 @@ public java.lang.String getNotificationPubsubTopic() {
      *
      * 
            * Pub/Sub topic for receiving notification. If this field is set,
-     * when the import is finished, a notification will be sent to
-     * specified Pub/Sub topic. The message data will be JSON string of a
+     * when the import is finished, a notification is sent to
+     * specified Pub/Sub topic. The message data is JSON string of a
      * [Operation][google.longrunning.Operation].
      * Format of the Pub/Sub topic is `projects/{project}/topics/{topic}`.
      * 
      
@@ -1432,8 +1528,8 @@ public com.google.protobuf.ByteString getNotificationPubsubTopicBytes() {
      *
      * 
            * Pub/Sub topic for receiving notification. If this field is set,
-     * when the import is finished, a notification will be sent to
-     * specified Pub/Sub topic. The message data will be JSON string of a
+     * when the import is finished, a notification is sent to
+     * specified Pub/Sub topic. The message data is JSON string of a
      * [Operation][google.longrunning.Operation].
      * Format of the Pub/Sub topic is `projects/{project}/topics/{topic}`.
      * 
      
@@ -1457,8 +1553,8 @@ public Builder setNotificationPubsubTopic(java.lang.String value) {
      *
      * 
            * Pub/Sub topic for receiving notification. If this field is set,
-     * when the import is finished, a notification will be sent to
-     * specified Pub/Sub topic. The message data will be JSON string of a
+     * when the import is finished, a notification is sent to
+     * specified Pub/Sub topic. The message data is JSON string of a
      * [Operation][google.longrunning.Operation].
      * Format of the Pub/Sub topic is `projects/{project}/topics/{topic}`.
      * 
      
@@ -1478,8 +1574,8 @@ public Builder clearNotificationPubsubTopic() {
      *
      * 
            * Pub/Sub topic for receiving notification. If this field is set,
-     * when the import is finished, a notification will be sent to
-     * specified Pub/Sub topic. The message data will be JSON string of a
+     * when the import is finished, a notification is sent to
+     * specified Pub/Sub topic. The message data is JSON string of a
      * [Operation][google.longrunning.Operation].
      * Format of the Pub/Sub topic is `projects/{project}/topics/{topic}`.
      * 
      
@@ -1500,6 +1596,218 @@ public Builder setNotificationPubsubTopicBytes(com.google.protobuf.ByteString va
       return this;
     }
 
+    private com.google.cloud.retail.v2alpha.TransformedUserEventsMetadata
+        transformedUserEventsMetadata_;
+    private com.google.protobuf.SingleFieldBuilderV3<
+            com.google.cloud.retail.v2alpha.TransformedUserEventsMetadata,
+            com.google.cloud.retail.v2alpha.TransformedUserEventsMetadata.Builder,
+            com.google.cloud.retail.v2alpha.TransformedUserEventsMetadataOrBuilder>
+        transformedUserEventsMetadataBuilder_;
+    /**
+     *
+     *
+     * 
      +     * Metadata related to transform user events.
+     * 
      
+     *
+     * 
+     * .google.cloud.retail.v2alpha.TransformedUserEventsMetadata transformed_user_events_metadata = 7;
+     * 
+     *
+     * @return Whether the transformedUserEventsMetadata field is set.
+     */
+    public boolean hasTransformedUserEventsMetadata() {
+      return transformedUserEventsMetadataBuilder_ != null
+          || transformedUserEventsMetadata_ != null;
+    }
+    /**
+     *
+     *
+     * 
      +     * Metadata related to transform user events.
+     * 
      
+     *
+     * 
+     * .google.cloud.retail.v2alpha.TransformedUserEventsMetadata transformed_user_events_metadata = 7;
+     * 
+     *
+     * @return The transformedUserEventsMetadata.
+     */
+    public com.google.cloud.retail.v2alpha.TransformedUserEventsMetadata
+        getTransformedUserEventsMetadata() {
+      if (transformedUserEventsMetadataBuilder_ == null) {
+        return transformedUserEventsMetadata_ == null
+            ? com.google.cloud.retail.v2alpha.TransformedUserEventsMetadata.getDefaultInstance()
+            : transformedUserEventsMetadata_;
+      } else {
+        return transformedUserEventsMetadataBuilder_.getMessage();
+      }
+    }
+    /**
+     *
+     *
+     * 
      +     * Metadata related to transform user events.
+     * 
      
+     *
+     * 
+     * .google.cloud.retail.v2alpha.TransformedUserEventsMetadata transformed_user_events_metadata = 7;
+     * 
+     */
+    public Builder setTransformedUserEventsMetadata(
+        com.google.cloud.retail.v2alpha.TransformedUserEventsMetadata value) {
+      if (transformedUserEventsMetadataBuilder_ == null) {
+        if (value == null) {
+          throw new NullPointerException();
+        }
+        transformedUserEventsMetadata_ = value;
+        onChanged();
+      } else {
+        transformedUserEventsMetadataBuilder_.setMessage(value);
+      }
+
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * Metadata related to transform user events.
+     * 
      
+     *
+     * 
+     * .google.cloud.retail.v2alpha.TransformedUserEventsMetadata transformed_user_events_metadata = 7;
+     * 
+     */
+    public Builder setTransformedUserEventsMetadata(
+        com.google.cloud.retail.v2alpha.TransformedUserEventsMetadata.Builder builderForValue) {
+      if (transformedUserEventsMetadataBuilder_ == null) {
+        transformedUserEventsMetadata_ = builderForValue.build();
+        onChanged();
+      } else {
+        transformedUserEventsMetadataBuilder_.setMessage(builderForValue.build());
+      }
+
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * Metadata related to transform user events.
+     * 
      
+     *
+     * 
+     * .google.cloud.retail.v2alpha.TransformedUserEventsMetadata transformed_user_events_metadata = 7;
+     * 
+     */
+    public Builder mergeTransformedUserEventsMetadata(
+        com.google.cloud.retail.v2alpha.TransformedUserEventsMetadata value) {
+      if (transformedUserEventsMetadataBuilder_ == null) {
+        if (transformedUserEventsMetadata_ != null) {
+          transformedUserEventsMetadata_ =
+              com.google.cloud.retail.v2alpha.TransformedUserEventsMetadata.newBuilder(
+                      transformedUserEventsMetadata_)
+                  .mergeFrom(value)
+                  .buildPartial();
+        } else {
+          transformedUserEventsMetadata_ = value;
+        }
+        onChanged();
+      } else {
+        transformedUserEventsMetadataBuilder_.mergeFrom(value);
+      }
+
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * Metadata related to transform user events.
+     * 
      
+     *
+     * 
+     * .google.cloud.retail.v2alpha.TransformedUserEventsMetadata transformed_user_events_metadata = 7;
+     * 
+     */
+    public Builder clearTransformedUserEventsMetadata() {
+      if (transformedUserEventsMetadataBuilder_ == null) {
+        transformedUserEventsMetadata_ = null;
+        onChanged();
+      } else {
+        transformedUserEventsMetadata_ = null;
+        transformedUserEventsMetadataBuilder_ = null;
+      }
+
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * Metadata related to transform user events.
+     * 
      
+     *
+     * 
+     * .google.cloud.retail.v2alpha.TransformedUserEventsMetadata transformed_user_events_metadata = 7;
+     * 
+     */
+    public com.google.cloud.retail.v2alpha.TransformedUserEventsMetadata.Builder
+        getTransformedUserEventsMetadataBuilder() {
+
+      onChanged();
+      return getTransformedUserEventsMetadataFieldBuilder().getBuilder();
+    }
+    /**
+     *
+     *
+     * 
      +     * Metadata related to transform user events.
+     * 
      
+     *
+     * 
+     * .google.cloud.retail.v2alpha.TransformedUserEventsMetadata transformed_user_events_metadata = 7;
+     * 
+     */
+    public com.google.cloud.retail.v2alpha.TransformedUserEventsMetadataOrBuilder
+        getTransformedUserEventsMetadataOrBuilder() {
+      if (transformedUserEventsMetadataBuilder_ != null) {
+        return transformedUserEventsMetadataBuilder_.getMessageOrBuilder();
+      } else {
+        return transformedUserEventsMetadata_ == null
+            ? com.google.cloud.retail.v2alpha.TransformedUserEventsMetadata.getDefaultInstance()
+            : transformedUserEventsMetadata_;
+      }
+    }
+    /**
+     *
+     *
+     * 
      +     * Metadata related to transform user events.
+     * 
      
+     *
+     * 
+     * .google.cloud.retail.v2alpha.TransformedUserEventsMetadata transformed_user_events_metadata = 7;
+     * 
+     */
+    private com.google.protobuf.SingleFieldBuilderV3<
+            com.google.cloud.retail.v2alpha.TransformedUserEventsMetadata,
+            com.google.cloud.retail.v2alpha.TransformedUserEventsMetadata.Builder,
+            com.google.cloud.retail.v2alpha.TransformedUserEventsMetadataOrBuilder>
+        getTransformedUserEventsMetadataFieldBuilder() {
+      if (transformedUserEventsMetadataBuilder_ == null) {
+        transformedUserEventsMetadataBuilder_ =
+            new com.google.protobuf.SingleFieldBuilderV3<
+                com.google.cloud.retail.v2alpha.TransformedUserEventsMetadata,
+                com.google.cloud.retail.v2alpha.TransformedUserEventsMetadata.Builder,
+                com.google.cloud.retail.v2alpha.TransformedUserEventsMetadataOrBuilder>(
+                getTransformedUserEventsMetadata(), getParentForChildren(), isClean());
+        transformedUserEventsMetadata_ = null;
+      }
+      return transformedUserEventsMetadataBuilder_;
+    }
+
     @java.lang.Override
     public final Builder setUnknownFields(final com.google.protobuf.UnknownFieldSet unknownFields) {
       return super.setUnknownFields(unknownFields);
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ImportMetadataOrBuilder.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ImportMetadataOrBuilder.java
index 9c41fbf59a02..a47ef7f3d304 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ImportMetadataOrBuilder.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ImportMetadataOrBuilder.java
@@ -132,7 +132,7 @@ public interface ImportMetadataOrBuilder
    * string request_id = 5 [deprecated = true];
    *
    * @deprecated google.cloud.retail.v2alpha.ImportMetadata.request_id is deprecated. See
-   *     google/cloud/retail/v2alpha/import_config.proto;l=357
+   *     google/cloud/retail/v2alpha/import_config.proto;l=339
    * @return The requestId.
    */
   @java.lang.Deprecated
@@ -147,7 +147,7 @@ public interface ImportMetadataOrBuilder
    * string request_id = 5 [deprecated = true];
    *
    * @deprecated google.cloud.retail.v2alpha.ImportMetadata.request_id is deprecated. See
-   *     google/cloud/retail/v2alpha/import_config.proto;l=357
+   *     google/cloud/retail/v2alpha/import_config.proto;l=339
    * @return The bytes for requestId.
    */
   @java.lang.Deprecated
@@ -158,8 +158,8 @@ public interface ImportMetadataOrBuilder
    *
    * 
          * Pub/Sub topic for receiving notification. If this field is set,
-   * when the import is finished, a notification will be sent to
-   * specified Pub/Sub topic. The message data will be JSON string of a
+   * when the import is finished, a notification is sent to
+   * specified Pub/Sub topic. The message data is JSON string of a
    * [Operation][google.longrunning.Operation].
    * Format of the Pub/Sub topic is `projects/{project}/topics/{topic}`.
    * 
      
@@ -174,8 +174,8 @@ public interface ImportMetadataOrBuilder
    *
    * 
          * Pub/Sub topic for receiving notification. If this field is set,
-   * when the import is finished, a notification will be sent to
-   * specified Pub/Sub topic. The message data will be JSON string of a
+   * when the import is finished, a notification is sent to
+   * specified Pub/Sub topic. The message data is JSON string of a
    * [Operation][google.longrunning.Operation].
    * Format of the Pub/Sub topic is `projects/{project}/topics/{topic}`.
    * 
      
@@ -185,4 +185,46 @@ public interface ImportMetadataOrBuilder
    * @return The bytes for notificationPubsubTopic.
    */
   com.google.protobuf.ByteString getNotificationPubsubTopicBytes();
+
+  /**
+   *
+   *
+   * 
      +   * Metadata related to transform user events.
+   * 
      
+   *
+   * 
+   * .google.cloud.retail.v2alpha.TransformedUserEventsMetadata transformed_user_events_metadata = 7;
+   * 
+   *
+   * @return Whether the transformedUserEventsMetadata field is set.
+   */
+  boolean hasTransformedUserEventsMetadata();
+  /**
+   *
+   *
+   * 
      +   * Metadata related to transform user events.
+   * 
      
+   *
+   * 
+   * .google.cloud.retail.v2alpha.TransformedUserEventsMetadata transformed_user_events_metadata = 7;
+   * 
+   *
+   * @return The transformedUserEventsMetadata.
+   */
+  com.google.cloud.retail.v2alpha.TransformedUserEventsMetadata getTransformedUserEventsMetadata();
+  /**
+   *
+   *
+   * 
      +   * Metadata related to transform user events.
+   * 
      
+   *
+   * 
+   * .google.cloud.retail.v2alpha.TransformedUserEventsMetadata transformed_user_events_metadata = 7;
+   * 
+   */
+  com.google.cloud.retail.v2alpha.TransformedUserEventsMetadataOrBuilder
+      getTransformedUserEventsMetadataOrBuilder();
 }
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ImportProductsRequest.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ImportProductsRequest.java
index 3e8119c3c72a..f347604530f7 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ImportProductsRequest.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ImportProductsRequest.java
@@ -107,14 +107,6 @@ public enum ReconciliationMode implements com.google.protobuf.ProtocolMessageEnu
      * 
            * Calculates diff and replaces the entire product dataset. Existing
      * products may be deleted if they are not present in the source location.
-     * Can only be set while using
-     * [BigQuerySource][google.cloud.retail.v2alpha.BigQuerySource]. And the
-     * BigQuery dataset must be created in the data location "us (multiple
-     * regions in United States)", otherwise a PERMISSION_DENIED error is
-     * thrown.
-     * Add the IAM permission "BigQuery Data Viewer" for
-     * cloud-retail-customer-data-access@system.gserviceaccount.com before
-     * using this feature otherwise an error is thrown.
      * 
      
      *
      * FULL = 2;
@@ -149,14 +141,6 @@ public enum ReconciliationMode implements com.google.protobuf.ProtocolMessageEnu
      * 
            * Calculates diff and replaces the entire product dataset. Existing
      * products may be deleted if they are not present in the source location.
-     * Can only be set while using
-     * [BigQuerySource][google.cloud.retail.v2alpha.BigQuerySource]. And the
-     * BigQuery dataset must be created in the data location "us (multiple
-     * regions in United States)", otherwise a PERMISSION_DENIED error is
-     * thrown.
-     * Add the IAM permission "BigQuery Data Viewer" for
-     * cloud-retail-customer-data-access@system.gserviceaccount.com before
-     * using this feature otherwise an error is thrown.
      * 
      
      *
      * FULL = 2;
@@ -322,7 +306,7 @@ public com.google.protobuf.ByteString getParentBytes() {
    * string request_id = 6 [deprecated = true];
    *
    * @deprecated google.cloud.retail.v2alpha.ImportProductsRequest.request_id is deprecated. See
-   *     google/cloud/retail/v2alpha/import_config.proto;l=202
+   *     google/cloud/retail/v2alpha/import_config.proto;l=189
    * @return The requestId.
    */
   @java.lang.Override
@@ -348,7 +332,7 @@ public java.lang.String getRequestId() {
    * string request_id = 6 [deprecated = true];
    *
    * @deprecated google.cloud.retail.v2alpha.ImportProductsRequest.request_id is deprecated. See
-   *     google/cloud/retail/v2alpha/import_config.proto;l=202
+   *     google/cloud/retail/v2alpha/import_config.proto;l=189
    * @return The bytes for requestId.
    */
   @java.lang.Override
@@ -473,8 +457,8 @@ public com.google.cloud.retail.v2alpha.ImportErrorsConfigOrBuilder getErrorsConf
    *
    *
    * 
      -   * Indicates which fields in the provided imported 'products' to update. If
-   * not set, will by default update all fields.
+   * Indicates which fields in the provided imported `products` to update. If
+   * not set, all fields are updated.
    * 
      
    *
    * .google.protobuf.FieldMask update_mask = 4;
@@ -489,8 +473,8 @@ public boolean hasUpdateMask() {
    *
    *
    * 
      -   * Indicates which fields in the provided imported 'products' to update. If
-   * not set, will by default update all fields.
+   * Indicates which fields in the provided imported `products` to update. If
+   * not set, all fields are updated.
    * 
      
    *
    * .google.protobuf.FieldMask update_mask = 4;
@@ -505,8 +489,8 @@ public com.google.protobuf.FieldMask getUpdateMask() {
    *
    *
    * 
      -   * Indicates which fields in the provided imported 'products' to update. If
-   * not set, will by default update all fields.
+   * Indicates which fields in the provided imported `products` to update. If
+   * not set, all fields are updated.
    * 
      
    *
    * .google.protobuf.FieldMask update_mask = 4;
@@ -571,19 +555,15 @@ public int getReconciliationModeValue() {
    *
    * 
          * Full Pub/Sub topic name for receiving notification. If this field is set,
-   * when the import is finished, a notification will be sent to
-   * specified Pub/Sub topic. The message data will be JSON string of a
+   * when the import is finished, a notification is sent to
+   * specified Pub/Sub topic. The message data is JSON string of a
    * [Operation][google.longrunning.Operation].
    * Format of the Pub/Sub topic is `projects/{project}/topics/{topic}`. It has
    * to be within the same project as
    * [ImportProductsRequest.parent][google.cloud.retail.v2alpha.ImportProductsRequest.parent].
-   * Make sure that both
-   * `cloud-retail-customer-data-access@system.gserviceaccount.com` and
-   * `service-<project number>@gcp-sa-retail.iam.gserviceaccount.com`
-   * have the `pubsub.topics.publish` IAM permission on the topic.
-   * Only supported when
-   * [ImportProductsRequest.reconciliation_mode][google.cloud.retail.v2alpha.ImportProductsRequest.reconciliation_mode]
-   * is set to `FULL`.
+   * Make sure that `service-<project
+   * number>@gcp-sa-retail.iam.gserviceaccount.com` has the
+   * `pubsub.topics.publish` IAM permission on the topic.
    * 
      
    *
    * string notification_pubsub_topic = 7;
@@ -607,19 +587,15 @@ public java.lang.String getNotificationPubsubTopic() {
    *
    * 
          * Full Pub/Sub topic name for receiving notification. If this field is set,
-   * when the import is finished, a notification will be sent to
-   * specified Pub/Sub topic. The message data will be JSON string of a
+   * when the import is finished, a notification is sent to
+   * specified Pub/Sub topic. The message data is JSON string of a
    * [Operation][google.longrunning.Operation].
    * Format of the Pub/Sub topic is `projects/{project}/topics/{topic}`. It has
    * to be within the same project as
    * [ImportProductsRequest.parent][google.cloud.retail.v2alpha.ImportProductsRequest.parent].
-   * Make sure that both
-   * `cloud-retail-customer-data-access@system.gserviceaccount.com` and
-   * `service-<project number>@gcp-sa-retail.iam.gserviceaccount.com`
-   * have the `pubsub.topics.publish` IAM permission on the topic.
-   * Only supported when
-   * [ImportProductsRequest.reconciliation_mode][google.cloud.retail.v2alpha.ImportProductsRequest.reconciliation_mode]
-   * is set to `FULL`.
+   * Make sure that `service-<project
+   * number>@gcp-sa-retail.iam.gserviceaccount.com` has the
+   * `pubsub.topics.publish` IAM permission on the topic.
    * 
      
    *
    * string notification_pubsub_topic = 7;
@@ -645,7 +621,7 @@ public com.google.protobuf.ByteString getNotificationPubsubTopicBytes() {
    *
    *
    * 
      -   * If true, will perform the FULL import even if it would delete a large
+   * If true, this performs the FULL import even if it would delete a large
    * proportion of the products in the default branch, which could potentially
    * cause outages if you have live predict/search traffic.
    * Only supported when
@@ -1330,7 +1306,7 @@ public Builder setParentBytes(com.google.protobuf.ByteString value) {
      * string request_id = 6 [deprecated = true];
      *
      * @deprecated google.cloud.retail.v2alpha.ImportProductsRequest.request_id is deprecated. See
-     *     google/cloud/retail/v2alpha/import_config.proto;l=202
+     *     google/cloud/retail/v2alpha/import_config.proto;l=189
      * @return The requestId.
      */
     @java.lang.Deprecated
@@ -1355,7 +1331,7 @@ public java.lang.String getRequestId() {
      * string request_id = 6 [deprecated = true];
      *
      * @deprecated google.cloud.retail.v2alpha.ImportProductsRequest.request_id is deprecated. See
-     *     google/cloud/retail/v2alpha/import_config.proto;l=202
+     *     google/cloud/retail/v2alpha/import_config.proto;l=189
      * @return The bytes for requestId.
      */
     @java.lang.Deprecated
@@ -1380,7 +1356,7 @@ public com.google.protobuf.ByteString getRequestIdBytes() {
      * string request_id = 6 [deprecated = true];
      *
      * @deprecated google.cloud.retail.v2alpha.ImportProductsRequest.request_id is deprecated. See
-     *     google/cloud/retail/v2alpha/import_config.proto;l=202
+     *     google/cloud/retail/v2alpha/import_config.proto;l=189
      * @param value The requestId to set.
      * @return This builder for chaining.
      */
@@ -1404,7 +1380,7 @@ public Builder setRequestId(java.lang.String value) {
      * string request_id = 6 [deprecated = true];
      *
      * @deprecated google.cloud.retail.v2alpha.ImportProductsRequest.request_id is deprecated. See
-     *     google/cloud/retail/v2alpha/import_config.proto;l=202
+     *     google/cloud/retail/v2alpha/import_config.proto;l=189
      * @return This builder for chaining.
      */
     @java.lang.Deprecated
@@ -1424,7 +1400,7 @@ public Builder clearRequestId() {
      * string request_id = 6 [deprecated = true];
      *
      * @deprecated google.cloud.retail.v2alpha.ImportProductsRequest.request_id is deprecated. See
-     *     google/cloud/retail/v2alpha/import_config.proto;l=202
+     *     google/cloud/retail/v2alpha/import_config.proto;l=189
      * @param value The bytes for requestId to set.
      * @return This builder for chaining.
      */
@@ -1840,8 +1816,8 @@ public com.google.cloud.retail.v2alpha.ImportErrorsConfigOrBuilder getErrorsConf
      *
      *
      * 
      -     * Indicates which fields in the provided imported 'products' to update. If
-     * not set, will by default update all fields.
+     * Indicates which fields in the provided imported `products` to update. If
+     * not set, all fields are updated.
      * 
      
      *
      * .google.protobuf.FieldMask update_mask = 4;
@@ -1855,8 +1831,8 @@ public boolean hasUpdateMask() {
      *
      *
      * 
      -     * Indicates which fields in the provided imported 'products' to update. If
-     * not set, will by default update all fields.
+     * Indicates which fields in the provided imported `products` to update. If
+     * not set, all fields are updated.
      * 
      
      *
      * .google.protobuf.FieldMask update_mask = 4;
@@ -1876,8 +1852,8 @@ public com.google.protobuf.FieldMask getUpdateMask() {
      *
      *
      * 
      -     * Indicates which fields in the provided imported 'products' to update. If
-     * not set, will by default update all fields.
+     * Indicates which fields in the provided imported `products` to update. If
+     * not set, all fields are updated.
      * 
      
      *
      * .google.protobuf.FieldMask update_mask = 4;
@@ -1899,8 +1875,8 @@ public Builder setUpdateMask(com.google.protobuf.FieldMask value) {
      *
      *
      * 
      -     * Indicates which fields in the provided imported 'products' to update. If
-     * not set, will by default update all fields.
+     * Indicates which fields in the provided imported `products` to update. If
+     * not set, all fields are updated.
      * 
      
      *
      * .google.protobuf.FieldMask update_mask = 4;
@@ -1919,8 +1895,8 @@ public Builder setUpdateMask(com.google.protobuf.FieldMask.Builder builderForVal
      *
      *
      * 
      -     * Indicates which fields in the provided imported 'products' to update. If
-     * not set, will by default update all fields.
+     * Indicates which fields in the provided imported `products` to update. If
+     * not set, all fields are updated.
      * 
      
      *
      * .google.protobuf.FieldMask update_mask = 4;
@@ -1944,8 +1920,8 @@ public Builder mergeUpdateMask(com.google.protobuf.FieldMask value) {
      *
      *
      * 
      -     * Indicates which fields in the provided imported 'products' to update. If
-     * not set, will by default update all fields.
+     * Indicates which fields in the provided imported `products` to update. If
+     * not set, all fields are updated.
      * 
      
      *
      * .google.protobuf.FieldMask update_mask = 4;
@@ -1965,8 +1941,8 @@ public Builder clearUpdateMask() {
      *
      *
      * 
      -     * Indicates which fields in the provided imported 'products' to update. If
-     * not set, will by default update all fields.
+     * Indicates which fields in the provided imported `products` to update. If
+     * not set, all fields are updated.
      * 
      
      *
      * .google.protobuf.FieldMask update_mask = 4;
@@ -1980,8 +1956,8 @@ public com.google.protobuf.FieldMask.Builder getUpdateMaskBuilder() {
      *
      *
      * 
      -     * Indicates which fields in the provided imported 'products' to update. If
-     * not set, will by default update all fields.
+     * Indicates which fields in the provided imported `products` to update. If
+     * not set, all fields are updated.
      * 
      
      *
      * .google.protobuf.FieldMask update_mask = 4;
@@ -1999,8 +1975,8 @@ public com.google.protobuf.FieldMaskOrBuilder getUpdateMaskOrBuilder() {
      *
      *
      * 
      -     * Indicates which fields in the provided imported 'products' to update. If
-     * not set, will by default update all fields.
+     * Indicates which fields in the provided imported `products` to update. If
+     * not set, all fields are updated.
      * 
      
      *
      * .google.protobuf.FieldMask update_mask = 4;
@@ -2144,19 +2120,15 @@ public Builder clearReconciliationMode() {
      *
      * 
            * Full Pub/Sub topic name for receiving notification. If this field is set,
-     * when the import is finished, a notification will be sent to
-     * specified Pub/Sub topic. The message data will be JSON string of a
+     * when the import is finished, a notification is sent to
+     * specified Pub/Sub topic. The message data is JSON string of a
      * [Operation][google.longrunning.Operation].
      * Format of the Pub/Sub topic is `projects/{project}/topics/{topic}`. It has
      * to be within the same project as
      * [ImportProductsRequest.parent][google.cloud.retail.v2alpha.ImportProductsRequest.parent].
-     * Make sure that both
-     * `cloud-retail-customer-data-access@system.gserviceaccount.com` and
-     * `service-<project number>@gcp-sa-retail.iam.gserviceaccount.com`
-     * have the `pubsub.topics.publish` IAM permission on the topic.
-     * Only supported when
-     * [ImportProductsRequest.reconciliation_mode][google.cloud.retail.v2alpha.ImportProductsRequest.reconciliation_mode]
-     * is set to `FULL`.
+     * Make sure that `service-<project
+     * number>@gcp-sa-retail.iam.gserviceaccount.com` has the
+     * `pubsub.topics.publish` IAM permission on the topic.
      * 
      
      *
      * string notification_pubsub_topic = 7;
@@ -2179,19 +2151,15 @@ public java.lang.String getNotificationPubsubTopic() {
      *
      * 
            * Full Pub/Sub topic name for receiving notification. If this field is set,
-     * when the import is finished, a notification will be sent to
-     * specified Pub/Sub topic. The message data will be JSON string of a
+     * when the import is finished, a notification is sent to
+     * specified Pub/Sub topic. The message data is JSON string of a
      * [Operation][google.longrunning.Operation].
      * Format of the Pub/Sub topic is `projects/{project}/topics/{topic}`. It has
      * to be within the same project as
      * [ImportProductsRequest.parent][google.cloud.retail.v2alpha.ImportProductsRequest.parent].
-     * Make sure that both
-     * `cloud-retail-customer-data-access@system.gserviceaccount.com` and
-     * `service-<project number>@gcp-sa-retail.iam.gserviceaccount.com`
-     * have the `pubsub.topics.publish` IAM permission on the topic.
-     * Only supported when
-     * [ImportProductsRequest.reconciliation_mode][google.cloud.retail.v2alpha.ImportProductsRequest.reconciliation_mode]
-     * is set to `FULL`.
+     * Make sure that `service-<project
+     * number>@gcp-sa-retail.iam.gserviceaccount.com` has the
+     * `pubsub.topics.publish` IAM permission on the topic.
      * 
      
      *
      * string notification_pubsub_topic = 7;
@@ -2214,19 +2182,15 @@ public com.google.protobuf.ByteString getNotificationPubsubTopicBytes() {
      *
      * 
            * Full Pub/Sub topic name for receiving notification. If this field is set,
-     * when the import is finished, a notification will be sent to
-     * specified Pub/Sub topic. The message data will be JSON string of a
+     * when the import is finished, a notification is sent to
+     * specified Pub/Sub topic. The message data is JSON string of a
      * [Operation][google.longrunning.Operation].
      * Format of the Pub/Sub topic is `projects/{project}/topics/{topic}`. It has
      * to be within the same project as
      * [ImportProductsRequest.parent][google.cloud.retail.v2alpha.ImportProductsRequest.parent].
-     * Make sure that both
-     * `cloud-retail-customer-data-access@system.gserviceaccount.com` and
-     * `service-<project number>@gcp-sa-retail.iam.gserviceaccount.com`
-     * have the `pubsub.topics.publish` IAM permission on the topic.
-     * Only supported when
-     * [ImportProductsRequest.reconciliation_mode][google.cloud.retail.v2alpha.ImportProductsRequest.reconciliation_mode]
-     * is set to `FULL`.
+     * Make sure that `service-<project
+     * number>@gcp-sa-retail.iam.gserviceaccount.com` has the
+     * `pubsub.topics.publish` IAM permission on the topic.
      * 
      
      *
      * string notification_pubsub_topic = 7;
@@ -2248,19 +2212,15 @@ public Builder setNotificationPubsubTopic(java.lang.String value) {
      *
      * 
            * Full Pub/Sub topic name for receiving notification. If this field is set,
-     * when the import is finished, a notification will be sent to
-     * specified Pub/Sub topic. The message data will be JSON string of a
+     * when the import is finished, a notification is sent to
+     * specified Pub/Sub topic. The message data is JSON string of a
      * [Operation][google.longrunning.Operation].
      * Format of the Pub/Sub topic is `projects/{project}/topics/{topic}`. It has
      * to be within the same project as
      * [ImportProductsRequest.parent][google.cloud.retail.v2alpha.ImportProductsRequest.parent].
-     * Make sure that both
-     * `cloud-retail-customer-data-access@system.gserviceaccount.com` and
-     * `service-<project number>@gcp-sa-retail.iam.gserviceaccount.com`
-     * have the `pubsub.topics.publish` IAM permission on the topic.
-     * Only supported when
-     * [ImportProductsRequest.reconciliation_mode][google.cloud.retail.v2alpha.ImportProductsRequest.reconciliation_mode]
-     * is set to `FULL`.
+     * Make sure that `service-<project
+     * number>@gcp-sa-retail.iam.gserviceaccount.com` has the
+     * `pubsub.topics.publish` IAM permission on the topic.
      * 
      
      *
      * string notification_pubsub_topic = 7;
@@ -2278,19 +2238,15 @@ public Builder clearNotificationPubsubTopic() {
      *
      * 
            * Full Pub/Sub topic name for receiving notification. If this field is set,
-     * when the import is finished, a notification will be sent to
-     * specified Pub/Sub topic. The message data will be JSON string of a
+     * when the import is finished, a notification is sent to
+     * specified Pub/Sub topic. The message data is JSON string of a
      * [Operation][google.longrunning.Operation].
      * Format of the Pub/Sub topic is `projects/{project}/topics/{topic}`. It has
      * to be within the same project as
      * [ImportProductsRequest.parent][google.cloud.retail.v2alpha.ImportProductsRequest.parent].
-     * Make sure that both
-     * `cloud-retail-customer-data-access@system.gserviceaccount.com` and
-     * `service-<project number>@gcp-sa-retail.iam.gserviceaccount.com`
-     * have the `pubsub.topics.publish` IAM permission on the topic.
-     * Only supported when
-     * [ImportProductsRequest.reconciliation_mode][google.cloud.retail.v2alpha.ImportProductsRequest.reconciliation_mode]
-     * is set to `FULL`.
+     * Make sure that `service-<project
+     * number>@gcp-sa-retail.iam.gserviceaccount.com` has the
+     * `pubsub.topics.publish` IAM permission on the topic.
      * 
      
      *
      * string notification_pubsub_topic = 7;
@@ -2314,7 +2270,7 @@ public Builder setNotificationPubsubTopicBytes(com.google.protobuf.ByteString va
      *
      *
      * 
      -     * If true, will perform the FULL import even if it would delete a large
+     * If true, this performs the FULL import even if it would delete a large
      * proportion of the products in the default branch, which could potentially
      * cause outages if you have live predict/search traffic.
      * Only supported when
@@ -2334,7 +2290,7 @@ public boolean getSkipDefaultBranchProtection() {
      *
      *
      * 
      -     * If true, will perform the FULL import even if it would delete a large
+     * If true, this performs the FULL import even if it would delete a large
      * proportion of the products in the default branch, which could potentially
      * cause outages if you have live predict/search traffic.
      * Only supported when
@@ -2357,7 +2313,7 @@ public Builder setSkipDefaultBranchProtection(boolean value) {
      *
      *
      * 
      -     * If true, will perform the FULL import even if it would delete a large
+     * If true, this performs the FULL import even if it would delete a large
      * proportion of the products in the default branch, which could potentially
      * cause outages if you have live predict/search traffic.
      * Only supported when
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ImportProductsRequestOrBuilder.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ImportProductsRequestOrBuilder.java
index 33865e56c328..4c5ab041e1df 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ImportProductsRequestOrBuilder.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ImportProductsRequestOrBuilder.java
@@ -68,7 +68,7 @@ public interface ImportProductsRequestOrBuilder
    * string request_id = 6 [deprecated = true];
    *
    * @deprecated google.cloud.retail.v2alpha.ImportProductsRequest.request_id is deprecated. See
-   *     google/cloud/retail/v2alpha/import_config.proto;l=202
+   *     google/cloud/retail/v2alpha/import_config.proto;l=189
    * @return The requestId.
    */
   @java.lang.Deprecated
@@ -83,7 +83,7 @@ public interface ImportProductsRequestOrBuilder
    * string request_id = 6 [deprecated = true];
    *
    * @deprecated google.cloud.retail.v2alpha.ImportProductsRequest.request_id is deprecated. See
-   *     google/cloud/retail/v2alpha/import_config.proto;l=202
+   *     google/cloud/retail/v2alpha/import_config.proto;l=189
    * @return The bytes for requestId.
    */
   @java.lang.Deprecated
@@ -169,8 +169,8 @@ public interface ImportProductsRequestOrBuilder
    *
    *
    * 
      -   * Indicates which fields in the provided imported 'products' to update. If
-   * not set, will by default update all fields.
+   * Indicates which fields in the provided imported `products` to update. If
+   * not set, all fields are updated.
    * 
      
    *
    * .google.protobuf.FieldMask update_mask = 4;
@@ -182,8 +182,8 @@ public interface ImportProductsRequestOrBuilder
    *
    *
    * 
      -   * Indicates which fields in the provided imported 'products' to update. If
-   * not set, will by default update all fields.
+   * Indicates which fields in the provided imported `products` to update. If
+   * not set, all fields are updated.
    * 
      
    *
    * .google.protobuf.FieldMask update_mask = 4;
@@ -195,8 +195,8 @@ public interface ImportProductsRequestOrBuilder
    *
    *
    * 
      -   * Indicates which fields in the provided imported 'products' to update. If
-   * not set, will by default update all fields.
+   * Indicates which fields in the provided imported `products` to update. If
+   * not set, all fields are updated.
    * 
      
    *
    * .google.protobuf.FieldMask update_mask = 4;
@@ -241,19 +241,15 @@ public interface ImportProductsRequestOrBuilder
    *
    * 
          * Full Pub/Sub topic name for receiving notification. If this field is set,
-   * when the import is finished, a notification will be sent to
-   * specified Pub/Sub topic. The message data will be JSON string of a
+   * when the import is finished, a notification is sent to
+   * specified Pub/Sub topic. The message data is JSON string of a
    * [Operation][google.longrunning.Operation].
    * Format of the Pub/Sub topic is `projects/{project}/topics/{topic}`. It has
    * to be within the same project as
    * [ImportProductsRequest.parent][google.cloud.retail.v2alpha.ImportProductsRequest.parent].
-   * Make sure that both
-   * `cloud-retail-customer-data-access@system.gserviceaccount.com` and
-   * `service-<project number>@gcp-sa-retail.iam.gserviceaccount.com`
-   * have the `pubsub.topics.publish` IAM permission on the topic.
-   * Only supported when
-   * [ImportProductsRequest.reconciliation_mode][google.cloud.retail.v2alpha.ImportProductsRequest.reconciliation_mode]
-   * is set to `FULL`.
+   * Make sure that `service-<project
+   * number>@gcp-sa-retail.iam.gserviceaccount.com` has the
+   * `pubsub.topics.publish` IAM permission on the topic.
    * 
      
    *
    * string notification_pubsub_topic = 7;
@@ -266,19 +262,15 @@ public interface ImportProductsRequestOrBuilder
    *
    * 
          * Full Pub/Sub topic name for receiving notification. If this field is set,
-   * when the import is finished, a notification will be sent to
-   * specified Pub/Sub topic. The message data will be JSON string of a
+   * when the import is finished, a notification is sent to
+   * specified Pub/Sub topic. The message data is JSON string of a
    * [Operation][google.longrunning.Operation].
    * Format of the Pub/Sub topic is `projects/{project}/topics/{topic}`. It has
    * to be within the same project as
    * [ImportProductsRequest.parent][google.cloud.retail.v2alpha.ImportProductsRequest.parent].
-   * Make sure that both
-   * `cloud-retail-customer-data-access@system.gserviceaccount.com` and
-   * `service-<project number>@gcp-sa-retail.iam.gserviceaccount.com`
-   * have the `pubsub.topics.publish` IAM permission on the topic.
-   * Only supported when
-   * [ImportProductsRequest.reconciliation_mode][google.cloud.retail.v2alpha.ImportProductsRequest.reconciliation_mode]
-   * is set to `FULL`.
+   * Make sure that `service-<project
+   * number>@gcp-sa-retail.iam.gserviceaccount.com` has the
+   * `pubsub.topics.publish` IAM permission on the topic.
    * 
      
    *
    * string notification_pubsub_topic = 7;
@@ -291,7 +283,7 @@ public interface ImportProductsRequestOrBuilder
    *
    *
    * 
      -   * If true, will perform the FULL import even if it would delete a large
+   * If true, this performs the FULL import even if it would delete a large
    * proportion of the products in the default branch, which could potentially
    * cause outages if you have live predict/search traffic.
    * Only supported when
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ListModelsRequest.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ListModelsRequest.java
index 943cb945b7ce..3098fa056ff9 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ListModelsRequest.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ListModelsRequest.java
@@ -76,7 +76,7 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    * 
          * Required. The parent for which to list models.
    * Format:
-   * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}
+   * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}`
    * 
      
    *
    * 
@@ -103,7 +103,7 @@ public java.lang.String getParent() {
    * 
          * Required. The parent for which to list models.
    * Format:
-   * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}
+   * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}`
    * 
      
    *
    * 
@@ -575,7 +575,7 @@ public Builder mergeFrom(
      * 
            * Required. The parent for which to list models.
      * Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}`
      * 
      
      *
      * 
@@ -601,7 +601,7 @@ public java.lang.String getParent() {
      * 
            * Required. The parent for which to list models.
      * Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}`
      * 
      
      *
      * 
@@ -627,7 +627,7 @@ public com.google.protobuf.ByteString getParentBytes() {
      * 
            * Required. The parent for which to list models.
      * Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}`
      * 
      
      *
      * 
@@ -652,7 +652,7 @@ public Builder setParent(java.lang.String value) {
      * 
            * Required. The parent for which to list models.
      * Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}`
      * 
      
      *
      * 
@@ -673,7 +673,7 @@ public Builder clearParent() {
      * 
            * Required. The parent for which to list models.
      * Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}`
      * 
      
      *
      * 
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ListModelsRequestOrBuilder.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ListModelsRequestOrBuilder.java
index f31fc42d7aab..6c5f8d68e425 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ListModelsRequestOrBuilder.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ListModelsRequestOrBuilder.java
@@ -29,7 +29,7 @@ public interface ListModelsRequestOrBuilder
    * 
          * Required. The parent for which to list models.
    * Format:
-   * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}
+   * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}`
    * 
      
    *
    * 
@@ -45,7 +45,7 @@ public interface ListModelsRequestOrBuilder
    * 
          * Required. The parent for which to list models.
    * Format:
-   * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}
+   * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}`
    * 
      
    *
    * 
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ListServingConfigsRequest.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ListServingConfigsRequest.java
index 17fe443a0105..a63b199283d7 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ListServingConfigsRequest.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ListServingConfigsRequest.java
@@ -75,7 +75,7 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    *
    * 
          * Required. The catalog resource name. Format:
-   * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}
+   * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}`
    * 
      
    *
    * 
@@ -101,7 +101,7 @@ public java.lang.String getParent() {
    *
    * 
          * Required. The catalog resource name. Format:
-   * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}
+   * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}`
    * 
      
    *
    * 
@@ -574,7 +574,7 @@ public Builder mergeFrom(
      *
      * 
            * Required. The catalog resource name. Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}`
      * 
      
      *
      * 
@@ -599,7 +599,7 @@ public java.lang.String getParent() {
      *
      * 
            * Required. The catalog resource name. Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}`
      * 
      
      *
      * 
@@ -624,7 +624,7 @@ public com.google.protobuf.ByteString getParentBytes() {
      *
      * 
            * Required. The catalog resource name. Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}`
      * 
      
      *
      * 
@@ -648,7 +648,7 @@ public Builder setParent(java.lang.String value) {
      *
      * 
            * Required. The catalog resource name. Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}`
      * 
      
      *
      * 
@@ -668,7 +668,7 @@ public Builder clearParent() {
      *
      * 
            * Required. The catalog resource name. Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}`
      * 
      
      *
      * 
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ListServingConfigsRequestOrBuilder.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ListServingConfigsRequestOrBuilder.java
index 2b6f015030e1..04f2ff51a33c 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ListServingConfigsRequestOrBuilder.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ListServingConfigsRequestOrBuilder.java
@@ -28,7 +28,7 @@ public interface ListServingConfigsRequestOrBuilder
    *
    * 
          * Required. The catalog resource name. Format:
-   * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}
+   * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}`
    * 
      
    *
    * 
@@ -43,7 +43,7 @@ public interface ListServingConfigsRequestOrBuilder
    *
    * 
          * Required. The catalog resource name. Format:
-   * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}
+   * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}`
    * 
      
    *
    * 
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/MerchantCenterFeedFilter.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/MerchantCenterFeedFilter.java
new file mode 100644
index 000000000000..5676796f9e19
--- /dev/null
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/MerchantCenterFeedFilter.java
@@ -0,0 +1,714 @@
+/*
+ * Copyright 2020 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+// Generated by the protocol buffer compiler.  DO NOT EDIT!
+// source: google/cloud/retail/v2alpha/catalog.proto
+
+package com.google.cloud.retail.v2alpha;
+
+/**
+ *
+ *
+ * 
      + * Merchant Center Feed filter criterion.
+ * 
      
+ *
+ * Protobuf type {@code google.cloud.retail.v2alpha.MerchantCenterFeedFilter}
+ */
+public final class MerchantCenterFeedFilter extends com.google.protobuf.GeneratedMessageV3
+    implements
+    // @@protoc_insertion_point(message_implements:google.cloud.retail.v2alpha.MerchantCenterFeedFilter)
+    MerchantCenterFeedFilterOrBuilder {
+  private static final long serialVersionUID = 0L;
+  // Use MerchantCenterFeedFilter.newBuilder() to construct.
+  private MerchantCenterFeedFilter(com.google.protobuf.GeneratedMessageV3.Builder builder) {
+    super(builder);
+  }
+
+  private MerchantCenterFeedFilter() {
+    primaryFeedName_ = "";
+  }
+
+  @java.lang.Override
+  @SuppressWarnings({"unused"})
+  protected java.lang.Object newInstance(UnusedPrivateParameter unused) {
+    return new MerchantCenterFeedFilter();
+  }
+
+  @java.lang.Override
+  public final com.google.protobuf.UnknownFieldSet getUnknownFields() {
+    return this.unknownFields;
+  }
+
+  public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
+    return com.google.cloud.retail.v2alpha.CatalogProto
+        .internal_static_google_cloud_retail_v2alpha_MerchantCenterFeedFilter_descriptor;
+  }
+
+  @java.lang.Override
+  protected com.google.protobuf.GeneratedMessageV3.FieldAccessorTable
+      internalGetFieldAccessorTable() {
+    return com.google.cloud.retail.v2alpha.CatalogProto
+        .internal_static_google_cloud_retail_v2alpha_MerchantCenterFeedFilter_fieldAccessorTable
+        .ensureFieldAccessorsInitialized(
+            com.google.cloud.retail.v2alpha.MerchantCenterFeedFilter.class,
+            com.google.cloud.retail.v2alpha.MerchantCenterFeedFilter.Builder.class);
+  }
+
+  public static final int PRIMARY_FEED_ID_FIELD_NUMBER = 1;
+  private long primaryFeedId_;
+  /**
+   *
+   *
+   * 
      +   * Merchant Center primary feed ID.
+   * 
      
+   *
+   * int64 primary_feed_id = 1;
+   *
+   * @return The primaryFeedId.
+   */
+  @java.lang.Override
+  public long getPrimaryFeedId() {
+    return primaryFeedId_;
+  }
+
+  public static final int PRIMARY_FEED_NAME_FIELD_NUMBER = 2;
+  private volatile java.lang.Object primaryFeedName_;
+  /**
+   *
+   *
+   * 
      +   * Merchant Center primary feed name. The name is used for the display
+   * purposes only.
+   * 
      
+   *
+   * string primary_feed_name = 2;
+   *
+   * @return The primaryFeedName.
+   */
+  @java.lang.Override
+  public java.lang.String getPrimaryFeedName() {
+    java.lang.Object ref = primaryFeedName_;
+    if (ref instanceof java.lang.String) {
+      return (java.lang.String) ref;
+    } else {
+      com.google.protobuf.ByteString bs = (com.google.protobuf.ByteString) ref;
+      java.lang.String s = bs.toStringUtf8();
+      primaryFeedName_ = s;
+      return s;
+    }
+  }
+  /**
+   *
+   *
+   * 
      +   * Merchant Center primary feed name. The name is used for the display
+   * purposes only.
+   * 
      
+   *
+   * string primary_feed_name = 2;
+   *
+   * @return The bytes for primaryFeedName.
+   */
+  @java.lang.Override
+  public com.google.protobuf.ByteString getPrimaryFeedNameBytes() {
+    java.lang.Object ref = primaryFeedName_;
+    if (ref instanceof java.lang.String) {
+      com.google.protobuf.ByteString b =
+          com.google.protobuf.ByteString.copyFromUtf8((java.lang.String) ref);
+      primaryFeedName_ = b;
+      return b;
+    } else {
+      return (com.google.protobuf.ByteString) ref;
+    }
+  }
+
+  private byte memoizedIsInitialized = -1;
+
+  @java.lang.Override
+  public final boolean isInitialized() {
+    byte isInitialized = memoizedIsInitialized;
+    if (isInitialized == 1) return true;
+    if (isInitialized == 0) return false;
+
+    memoizedIsInitialized = 1;
+    return true;
+  }
+
+  @java.lang.Override
+  public void writeTo(com.google.protobuf.CodedOutputStream output) throws java.io.IOException {
+    if (primaryFeedId_ != 0L) {
+      output.writeInt64(1, primaryFeedId_);
+    }
+    if (!com.google.protobuf.GeneratedMessageV3.isStringEmpty(primaryFeedName_)) {
+      com.google.protobuf.GeneratedMessageV3.writeString(output, 2, primaryFeedName_);
+    }
+    getUnknownFields().writeTo(output);
+  }
+
+  @java.lang.Override
+  public int getSerializedSize() {
+    int size = memoizedSize;
+    if (size != -1) return size;
+
+    size = 0;
+    if (primaryFeedId_ != 0L) {
+      size += com.google.protobuf.CodedOutputStream.computeInt64Size(1, primaryFeedId_);
+    }
+    if (!com.google.protobuf.GeneratedMessageV3.isStringEmpty(primaryFeedName_)) {
+      size += com.google.protobuf.GeneratedMessageV3.computeStringSize(2, primaryFeedName_);
+    }
+    size += getUnknownFields().getSerializedSize();
+    memoizedSize = size;
+    return size;
+  }
+
+  @java.lang.Override
+  public boolean equals(final java.lang.Object obj) {
+    if (obj == this) {
+      return true;
+    }
+    if (!(obj instanceof com.google.cloud.retail.v2alpha.MerchantCenterFeedFilter)) {
+      return super.equals(obj);
+    }
+    com.google.cloud.retail.v2alpha.MerchantCenterFeedFilter other =
+        (com.google.cloud.retail.v2alpha.MerchantCenterFeedFilter) obj;
+
+    if (getPrimaryFeedId() != other.getPrimaryFeedId()) return false;
+    if (!getPrimaryFeedName().equals(other.getPrimaryFeedName())) return false;
+    if (!getUnknownFields().equals(other.getUnknownFields())) return false;
+    return true;
+  }
+
+  @java.lang.Override
+  public int hashCode() {
+    if (memoizedHashCode != 0) {
+      return memoizedHashCode;
+    }
+    int hash = 41;
+    hash = (19 * hash) + getDescriptor().hashCode();
+    hash = (37 * hash) + PRIMARY_FEED_ID_FIELD_NUMBER;
+    hash = (53 * hash) + com.google.protobuf.Internal.hashLong(getPrimaryFeedId());
+    hash = (37 * hash) + PRIMARY_FEED_NAME_FIELD_NUMBER;
+    hash = (53 * hash) + getPrimaryFeedName().hashCode();
+    hash = (29 * hash) + getUnknownFields().hashCode();
+    memoizedHashCode = hash;
+    return hash;
+  }
+
+  public static com.google.cloud.retail.v2alpha.MerchantCenterFeedFilter parseFrom(
+      java.nio.ByteBuffer data) throws com.google.protobuf.InvalidProtocolBufferException {
+    return PARSER.parseFrom(data);
+  }
+
+  public static com.google.cloud.retail.v2alpha.MerchantCenterFeedFilter parseFrom(
+      java.nio.ByteBuffer data, com.google.protobuf.ExtensionRegistryLite extensionRegistry)
+      throws com.google.protobuf.InvalidProtocolBufferException {
+    return PARSER.parseFrom(data, extensionRegistry);
+  }
+
+  public static com.google.cloud.retail.v2alpha.MerchantCenterFeedFilter parseFrom(
+      com.google.protobuf.ByteString data)
+      throws com.google.protobuf.InvalidProtocolBufferException {
+    return PARSER.parseFrom(data);
+  }
+
+  public static com.google.cloud.retail.v2alpha.MerchantCenterFeedFilter parseFrom(
+      com.google.protobuf.ByteString data,
+      com.google.protobuf.ExtensionRegistryLite extensionRegistry)
+      throws com.google.protobuf.InvalidProtocolBufferException {
+    return PARSER.parseFrom(data, extensionRegistry);
+  }
+
+  public static com.google.cloud.retail.v2alpha.MerchantCenterFeedFilter parseFrom(byte[] data)
+      throws com.google.protobuf.InvalidProtocolBufferException {
+    return PARSER.parseFrom(data);
+  }
+
+  public static com.google.cloud.retail.v2alpha.MerchantCenterFeedFilter parseFrom(
+      byte[] data, com.google.protobuf.ExtensionRegistryLite extensionRegistry)
+      throws com.google.protobuf.InvalidProtocolBufferException {
+    return PARSER.parseFrom(data, extensionRegistry);
+  }
+
+  public static com.google.cloud.retail.v2alpha.MerchantCenterFeedFilter parseFrom(
+      java.io.InputStream input) throws java.io.IOException {
+    return com.google.protobuf.GeneratedMessageV3.parseWithIOException(PARSER, input);
+  }
+
+  public static com.google.cloud.retail.v2alpha.MerchantCenterFeedFilter parseFrom(
+      java.io.InputStream input, com.google.protobuf.ExtensionRegistryLite extensionRegistry)
+      throws java.io.IOException {
+    return com.google.protobuf.GeneratedMessageV3.parseWithIOException(
+        PARSER, input, extensionRegistry);
+  }
+
+  public static com.google.cloud.retail.v2alpha.MerchantCenterFeedFilter parseDelimitedFrom(
+      java.io.InputStream input) throws java.io.IOException {
+    return com.google.protobuf.GeneratedMessageV3.parseDelimitedWithIOException(PARSER, input);
+  }
+
+  public static com.google.cloud.retail.v2alpha.MerchantCenterFeedFilter parseDelimitedFrom(
+      java.io.InputStream input, com.google.protobuf.ExtensionRegistryLite extensionRegistry)
+      throws java.io.IOException {
+    return com.google.protobuf.GeneratedMessageV3.parseDelimitedWithIOException(
+        PARSER, input, extensionRegistry);
+  }
+
+  public static com.google.cloud.retail.v2alpha.MerchantCenterFeedFilter parseFrom(
+      com.google.protobuf.CodedInputStream input) throws java.io.IOException {
+    return com.google.protobuf.GeneratedMessageV3.parseWithIOException(PARSER, input);
+  }
+
+  public static com.google.cloud.retail.v2alpha.MerchantCenterFeedFilter parseFrom(
+      com.google.protobuf.CodedInputStream input,
+      com.google.protobuf.ExtensionRegistryLite extensionRegistry)
+      throws java.io.IOException {
+    return com.google.protobuf.GeneratedMessageV3.parseWithIOException(
+        PARSER, input, extensionRegistry);
+  }
+
+  @java.lang.Override
+  public Builder newBuilderForType() {
+    return newBuilder();
+  }
+
+  public static Builder newBuilder() {
+    return DEFAULT_INSTANCE.toBuilder();
+  }
+
+  public static Builder newBuilder(
+      com.google.cloud.retail.v2alpha.MerchantCenterFeedFilter prototype) {
+    return DEFAULT_INSTANCE.toBuilder().mergeFrom(prototype);
+  }
+
+  @java.lang.Override
+  public Builder toBuilder() {
+    return this == DEFAULT_INSTANCE ? new Builder() : new Builder().mergeFrom(this);
+  }
+
+  @java.lang.Override
+  protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.BuilderParent parent) {
+    Builder builder = new Builder(parent);
+    return builder;
+  }
+  /**
+   *
+   *
+   * 
      +   * Merchant Center Feed filter criterion.
+   * 
      
+   *
+   * Protobuf type {@code google.cloud.retail.v2alpha.MerchantCenterFeedFilter}
+   */
+  public static final class Builder extends com.google.protobuf.GeneratedMessageV3.Builder
+      implements
+      // @@protoc_insertion_point(builder_implements:google.cloud.retail.v2alpha.MerchantCenterFeedFilter)
+      com.google.cloud.retail.v2alpha.MerchantCenterFeedFilterOrBuilder {
+    public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
+      return com.google.cloud.retail.v2alpha.CatalogProto
+          .internal_static_google_cloud_retail_v2alpha_MerchantCenterFeedFilter_descriptor;
+    }
+
+    @java.lang.Override
+    protected com.google.protobuf.GeneratedMessageV3.FieldAccessorTable
+        internalGetFieldAccessorTable() {
+      return com.google.cloud.retail.v2alpha.CatalogProto
+          .internal_static_google_cloud_retail_v2alpha_MerchantCenterFeedFilter_fieldAccessorTable
+          .ensureFieldAccessorsInitialized(
+              com.google.cloud.retail.v2alpha.MerchantCenterFeedFilter.class,
+              com.google.cloud.retail.v2alpha.MerchantCenterFeedFilter.Builder.class);
+    }
+
+    // Construct using com.google.cloud.retail.v2alpha.MerchantCenterFeedFilter.newBuilder()
+    private Builder() {}
+
+    private Builder(com.google.protobuf.GeneratedMessageV3.BuilderParent parent) {
+      super(parent);
+    }
+
+    @java.lang.Override
+    public Builder clear() {
+      super.clear();
+      primaryFeedId_ = 0L;
+
+      primaryFeedName_ = "";
+
+      return this;
+    }
+
+    @java.lang.Override
+    public com.google.protobuf.Descriptors.Descriptor getDescriptorForType() {
+      return com.google.cloud.retail.v2alpha.CatalogProto
+          .internal_static_google_cloud_retail_v2alpha_MerchantCenterFeedFilter_descriptor;
+    }
+
+    @java.lang.Override
+    public com.google.cloud.retail.v2alpha.MerchantCenterFeedFilter getDefaultInstanceForType() {
+      return com.google.cloud.retail.v2alpha.MerchantCenterFeedFilter.getDefaultInstance();
+    }
+
+    @java.lang.Override
+    public com.google.cloud.retail.v2alpha.MerchantCenterFeedFilter build() {
+      com.google.cloud.retail.v2alpha.MerchantCenterFeedFilter result = buildPartial();
+      if (!result.isInitialized()) {
+        throw newUninitializedMessageException(result);
+      }
+      return result;
+    }
+
+    @java.lang.Override
+    public com.google.cloud.retail.v2alpha.MerchantCenterFeedFilter buildPartial() {
+      com.google.cloud.retail.v2alpha.MerchantCenterFeedFilter result =
+          new com.google.cloud.retail.v2alpha.MerchantCenterFeedFilter(this);
+      result.primaryFeedId_ = primaryFeedId_;
+      result.primaryFeedName_ = primaryFeedName_;
+      onBuilt();
+      return result;
+    }
+
+    @java.lang.Override
+    public Builder clone() {
+      return super.clone();
+    }
+
+    @java.lang.Override
+    public Builder setField(
+        com.google.protobuf.Descriptors.FieldDescriptor field, java.lang.Object value) {
+      return super.setField(field, value);
+    }
+
+    @java.lang.Override
+    public Builder clearField(com.google.protobuf.Descriptors.FieldDescriptor field) {
+      return super.clearField(field);
+    }
+
+    @java.lang.Override
+    public Builder clearOneof(com.google.protobuf.Descriptors.OneofDescriptor oneof) {
+      return super.clearOneof(oneof);
+    }
+
+    @java.lang.Override
+    public Builder setRepeatedField(
+        com.google.protobuf.Descriptors.FieldDescriptor field, int index, java.lang.Object value) {
+      return super.setRepeatedField(field, index, value);
+    }
+
+    @java.lang.Override
+    public Builder addRepeatedField(
+        com.google.protobuf.Descriptors.FieldDescriptor field, java.lang.Object value) {
+      return super.addRepeatedField(field, value);
+    }
+
+    @java.lang.Override
+    public Builder mergeFrom(com.google.protobuf.Message other) {
+      if (other instanceof com.google.cloud.retail.v2alpha.MerchantCenterFeedFilter) {
+        return mergeFrom((com.google.cloud.retail.v2alpha.MerchantCenterFeedFilter) other);
+      } else {
+        super.mergeFrom(other);
+        return this;
+      }
+    }
+
+    public Builder mergeFrom(com.google.cloud.retail.v2alpha.MerchantCenterFeedFilter other) {
+      if (other == com.google.cloud.retail.v2alpha.MerchantCenterFeedFilter.getDefaultInstance())
+        return this;
+      if (other.getPrimaryFeedId() != 0L) {
+        setPrimaryFeedId(other.getPrimaryFeedId());
+      }
+      if (!other.getPrimaryFeedName().isEmpty()) {
+        primaryFeedName_ = other.primaryFeedName_;
+        onChanged();
+      }
+      this.mergeUnknownFields(other.getUnknownFields());
+      onChanged();
+      return this;
+    }
+
+    @java.lang.Override
+    public final boolean isInitialized() {
+      return true;
+    }
+
+    @java.lang.Override
+    public Builder mergeFrom(
+        com.google.protobuf.CodedInputStream input,
+        com.google.protobuf.ExtensionRegistryLite extensionRegistry)
+        throws java.io.IOException {
+      if (extensionRegistry == null) {
+        throw new java.lang.NullPointerException();
+      }
+      try {
+        boolean done = false;
+        while (!done) {
+          int tag = input.readTag();
+          switch (tag) {
+            case 0:
+              done = true;
+              break;
+            case 8:
+              {
+                primaryFeedId_ = input.readInt64();
+
+                break;
+              } // case 8
+            case 18:
+              {
+                primaryFeedName_ = input.readStringRequireUtf8();
+
+                break;
+              } // case 18
+            default:
+              {
+                if (!super.parseUnknownField(input, extensionRegistry, tag)) {
+                  done = true; // was an endgroup tag
+                }
+                break;
+              } // default:
+          } // switch (tag)
+        } // while (!done)
+      } catch (com.google.protobuf.InvalidProtocolBufferException e) {
+        throw e.unwrapIOException();
+      } finally {
+        onChanged();
+      } // finally
+      return this;
+    }
+
+    private long primaryFeedId_;
+    /**
+     *
+     *
+     * 
      +     * Merchant Center primary feed ID.
+     * 
      
+     *
+     * int64 primary_feed_id = 1;
+     *
+     * @return The primaryFeedId.
+     */
+    @java.lang.Override
+    public long getPrimaryFeedId() {
+      return primaryFeedId_;
+    }
+    /**
+     *
+     *
+     * 
      +     * Merchant Center primary feed ID.
+     * 
      
+     *
+     * int64 primary_feed_id = 1;
+     *
+     * @param value The primaryFeedId to set.
+     * @return This builder for chaining.
+     */
+    public Builder setPrimaryFeedId(long value) {
+
+      primaryFeedId_ = value;
+      onChanged();
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * Merchant Center primary feed ID.
+     * 
      
+     *
+     * int64 primary_feed_id = 1;
+     *
+     * @return This builder for chaining.
+     */
+    public Builder clearPrimaryFeedId() {
+
+      primaryFeedId_ = 0L;
+      onChanged();
+      return this;
+    }
+
+    private java.lang.Object primaryFeedName_ = "";
+    /**
+     *
+     *
+     * 
      +     * Merchant Center primary feed name. The name is used for the display
+     * purposes only.
+     * 
      
+     *
+     * string primary_feed_name = 2;
+     *
+     * @return The primaryFeedName.
+     */
+    public java.lang.String getPrimaryFeedName() {
+      java.lang.Object ref = primaryFeedName_;
+      if (!(ref instanceof java.lang.String)) {
+        com.google.protobuf.ByteString bs = (com.google.protobuf.ByteString) ref;
+        java.lang.String s = bs.toStringUtf8();
+        primaryFeedName_ = s;
+        return s;
+      } else {
+        return (java.lang.String) ref;
+      }
+    }
+    /**
+     *
+     *
+     * 
      +     * Merchant Center primary feed name. The name is used for the display
+     * purposes only.
+     * 
      
+     *
+     * string primary_feed_name = 2;
+     *
+     * @return The bytes for primaryFeedName.
+     */
+    public com.google.protobuf.ByteString getPrimaryFeedNameBytes() {
+      java.lang.Object ref = primaryFeedName_;
+      if (ref instanceof String) {
+        com.google.protobuf.ByteString b =
+            com.google.protobuf.ByteString.copyFromUtf8((java.lang.String) ref);
+        primaryFeedName_ = b;
+        return b;
+      } else {
+        return (com.google.protobuf.ByteString) ref;
+      }
+    }
+    /**
+     *
+     *
+     * 
      +     * Merchant Center primary feed name. The name is used for the display
+     * purposes only.
+     * 
      
+     *
+     * string primary_feed_name = 2;
+     *
+     * @param value The primaryFeedName to set.
+     * @return This builder for chaining.
+     */
+    public Builder setPrimaryFeedName(java.lang.String value) {
+      if (value == null) {
+        throw new NullPointerException();
+      }
+
+      primaryFeedName_ = value;
+      onChanged();
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * Merchant Center primary feed name. The name is used for the display
+     * purposes only.
+     * 
      
+     *
+     * string primary_feed_name = 2;
+     *
+     * @return This builder for chaining.
+     */
+    public Builder clearPrimaryFeedName() {
+
+      primaryFeedName_ = getDefaultInstance().getPrimaryFeedName();
+      onChanged();
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * Merchant Center primary feed name. The name is used for the display
+     * purposes only.
+     * 
      
+     *
+     * string primary_feed_name = 2;
+     *
+     * @param value The bytes for primaryFeedName to set.
+     * @return This builder for chaining.
+     */
+    public Builder setPrimaryFeedNameBytes(com.google.protobuf.ByteString value) {
+      if (value == null) {
+        throw new NullPointerException();
+      }
+      checkByteStringIsUtf8(value);
+
+      primaryFeedName_ = value;
+      onChanged();
+      return this;
+    }
+
+    @java.lang.Override
+    public final Builder setUnknownFields(final com.google.protobuf.UnknownFieldSet unknownFields) {
+      return super.setUnknownFields(unknownFields);
+    }
+
+    @java.lang.Override
+    public final Builder mergeUnknownFields(
+        final com.google.protobuf.UnknownFieldSet unknownFields) {
+      return super.mergeUnknownFields(unknownFields);
+    }
+
+    // @@protoc_insertion_point(builder_scope:google.cloud.retail.v2alpha.MerchantCenterFeedFilter)
+  }
+
+  // @@protoc_insertion_point(class_scope:google.cloud.retail.v2alpha.MerchantCenterFeedFilter)
+  private static final com.google.cloud.retail.v2alpha.MerchantCenterFeedFilter DEFAULT_INSTANCE;
+
+  static {
+    DEFAULT_INSTANCE = new com.google.cloud.retail.v2alpha.MerchantCenterFeedFilter();
+  }
+
+  public static com.google.cloud.retail.v2alpha.MerchantCenterFeedFilter getDefaultInstance() {
+    return DEFAULT_INSTANCE;
+  }
+
+  private static final com.google.protobuf.Parser PARSER =
+      new com.google.protobuf.AbstractParser() {
+        @java.lang.Override
+        public MerchantCenterFeedFilter parsePartialFrom(
+            com.google.protobuf.CodedInputStream input,
+            com.google.protobuf.ExtensionRegistryLite extensionRegistry)
+            throws com.google.protobuf.InvalidProtocolBufferException {
+          Builder builder = newBuilder();
+          try {
+            builder.mergeFrom(input, extensionRegistry);
+          } catch (com.google.protobuf.InvalidProtocolBufferException e) {
+            throw e.setUnfinishedMessage(builder.buildPartial());
+          } catch (com.google.protobuf.UninitializedMessageException e) {
+            throw e.asInvalidProtocolBufferException().setUnfinishedMessage(builder.buildPartial());
+          } catch (java.io.IOException e) {
+            throw new com.google.protobuf.InvalidProtocolBufferException(e)
+                .setUnfinishedMessage(builder.buildPartial());
+          }
+          return builder.buildPartial();
+        }
+      };
+
+  public static com.google.protobuf.Parser parser() {
+    return PARSER;
+  }
+
+  @java.lang.Override
+  public com.google.protobuf.Parser getParserForType() {
+    return PARSER;
+  }
+
+  @java.lang.Override
+  public com.google.cloud.retail.v2alpha.MerchantCenterFeedFilter getDefaultInstanceForType() {
+    return DEFAULT_INSTANCE;
+  }
+}
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/MerchantCenterFeedFilterOrBuilder.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/MerchantCenterFeedFilterOrBuilder.java
new file mode 100644
index 000000000000..fd98003c54b3
--- /dev/null
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/MerchantCenterFeedFilterOrBuilder.java
@@ -0,0 +1,65 @@
+/*
+ * Copyright 2020 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+// Generated by the protocol buffer compiler.  DO NOT EDIT!
+// source: google/cloud/retail/v2alpha/catalog.proto
+
+package com.google.cloud.retail.v2alpha;
+
+public interface MerchantCenterFeedFilterOrBuilder
+    extends
+    // @@protoc_insertion_point(interface_extends:google.cloud.retail.v2alpha.MerchantCenterFeedFilter)
+    com.google.protobuf.MessageOrBuilder {
+
+  /**
+   *
+   *
+   * 
      +   * Merchant Center primary feed ID.
+   * 
      
+   *
+   * int64 primary_feed_id = 1;
+   *
+   * @return The primaryFeedId.
+   */
+  long getPrimaryFeedId();
+
+  /**
+   *
+   *
+   * 
      +   * Merchant Center primary feed name. The name is used for the display
+   * purposes only.
+   * 
      
+   *
+   * string primary_feed_name = 2;
+   *
+   * @return The primaryFeedName.
+   */
+  java.lang.String getPrimaryFeedName();
+  /**
+   *
+   *
+   * 
      +   * Merchant Center primary feed name. The name is used for the display
+   * purposes only.
+   * 
      
+   *
+   * string primary_feed_name = 2;
+   *
+   * @return The bytes for primaryFeedName.
+   */
+  com.google.protobuf.ByteString getPrimaryFeedNameBytes();
+}
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/MerchantCenterLink.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/MerchantCenterLink.java
index aa45a3182df2..2a530912f0fa 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/MerchantCenterLink.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/MerchantCenterLink.java
@@ -44,6 +44,7 @@ private MerchantCenterLink() {
     destinations_ = com.google.protobuf.LazyStringArrayList.EMPTY;
     regionCode_ = "";
     languageCode_ = "";
+    feeds_ = java.util.Collections.emptyList();
   }
 
   @java.lang.Override
@@ -79,7 +80,7 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    *
    * 
          * Required. The linked [Merchant center account
-   * id](https://developers.google.com/shopping-content/guides/accountstatuses).
+   * ID](https://developers.google.com/shopping-content/guides/accountstatuses).
    * The account must be a standalone account or a sub-account of a MCA.
    * 
      
    *
@@ -98,11 +99,11 @@ public long getMerchantCenterAccountId() {
    *
    *
    * 
      -   * The branch id (e.g. 0/1/2) within this catalog that products from
+   * The branch ID (e.g. 0/1/2) within this catalog that products from
    * merchant_center_account_id are streamed to. When updating this field, an
    * empty value will use the currently configured default branch. However,
    * changing the default branch later on won't change the linked branch here.
-   * A single branch id can only have one linked merchant center account id.
+   * A single branch ID can only have one linked merchant center account ID.
    * 
      
    *
    * string branch_id = 2;
@@ -125,11 +126,11 @@ public java.lang.String getBranchId() {
    *
    *
    * 
      -   * The branch id (e.g. 0/1/2) within this catalog that products from
+   * The branch ID (e.g. 0/1/2) within this catalog that products from
    * merchant_center_account_id are streamed to. When updating this field, an
    * empty value will use the currently configured default branch. However,
    * changing the default branch later on won't change the linked branch here.
-   * A single branch id can only have one linked merchant center account id.
+   * A single branch ID can only have one linked merchant center account ID.
    * 
      
    *
    * string branch_id = 2;
@@ -156,8 +157,8 @@ public com.google.protobuf.ByteString getBranchIdBytes() {
    *
    * 
          * String representing the destination to import for, all if left empty.
-   * List of possible values can be found here.
-   * [https://support.google.com/merchants/answer/7501026]
+   * List of possible values is given in [Included
+   * destination](https://support.google.com/merchants/answer/7501026).
    * List of allowed string values:
    * "Shopping_ads", "Buy_on_google_listings", "Display_ads", "Local_inventory
    * _ads", "Free_listings", "Free_local_listings"
@@ -176,8 +177,8 @@ public com.google.protobuf.ProtocolStringList getDestinationsList() {
    *
    * 
          * String representing the destination to import for, all if left empty.
-   * List of possible values can be found here.
-   * [https://support.google.com/merchants/answer/7501026]
+   * List of possible values is given in [Included
+   * destination](https://support.google.com/merchants/answer/7501026).
    * List of allowed string values:
    * "Shopping_ads", "Buy_on_google_listings", "Display_ads", "Local_inventory
    * _ads", "Free_listings", "Free_local_listings"
@@ -196,8 +197,8 @@ public int getDestinationsCount() {
    *
    * 
          * String representing the destination to import for, all if left empty.
-   * List of possible values can be found here.
-   * [https://support.google.com/merchants/answer/7501026]
+   * List of possible values is given in [Included
+   * destination](https://support.google.com/merchants/answer/7501026).
    * List of allowed string values:
    * "Shopping_ads", "Buy_on_google_listings", "Display_ads", "Local_inventory
    * _ads", "Free_listings", "Free_local_listings"
@@ -217,8 +218,8 @@ public java.lang.String getDestinations(int index) {
    *
    * 
          * String representing the destination to import for, all if left empty.
-   * List of possible values can be found here.
-   * [https://support.google.com/merchants/answer/7501026]
+   * List of possible values is given in [Included
+   * destination](https://support.google.com/merchants/answer/7501026).
    * List of allowed string values:
    * "Shopping_ads", "Buy_on_google_listings", "Display_ads", "Local_inventory
    * _ads", "Free_listings", "Free_local_listings"
@@ -352,6 +353,86 @@ public com.google.protobuf.ByteString getLanguageCodeBytes() {
     }
   }
 
+  public static final int FEEDS_FIELD_NUMBER = 6;
+  private java.util.List feeds_;
+  /**
+   *
+   *
+   * 
      +   * Criteria for the Merchant Center feeds to be ingested via the link.
+   * All offers will be ingested if the list is empty.
+   * Otherwise the offers will be ingested from selected feeds.
+   * 
      
+   *
+   * repeated .google.cloud.retail.v2alpha.MerchantCenterFeedFilter feeds = 6;
+   */
+  @java.lang.Override
+  public java.util.List getFeedsList() {
+    return feeds_;
+  }
+  /**
+   *
+   *
+   * 
      +   * Criteria for the Merchant Center feeds to be ingested via the link.
+   * All offers will be ingested if the list is empty.
+   * Otherwise the offers will be ingested from selected feeds.
+   * 
      
+   *
+   * repeated .google.cloud.retail.v2alpha.MerchantCenterFeedFilter feeds = 6;
+   */
+  @java.lang.Override
+  public java.util.List
+      getFeedsOrBuilderList() {
+    return feeds_;
+  }
+  /**
+   *
+   *
+   * 
      +   * Criteria for the Merchant Center feeds to be ingested via the link.
+   * All offers will be ingested if the list is empty.
+   * Otherwise the offers will be ingested from selected feeds.
+   * 
      
+   *
+   * repeated .google.cloud.retail.v2alpha.MerchantCenterFeedFilter feeds = 6;
+   */
+  @java.lang.Override
+  public int getFeedsCount() {
+    return feeds_.size();
+  }
+  /**
+   *
+   *
+   * 
      +   * Criteria for the Merchant Center feeds to be ingested via the link.
+   * All offers will be ingested if the list is empty.
+   * Otherwise the offers will be ingested from selected feeds.
+   * 
      
+   *
+   * repeated .google.cloud.retail.v2alpha.MerchantCenterFeedFilter feeds = 6;
+   */
+  @java.lang.Override
+  public com.google.cloud.retail.v2alpha.MerchantCenterFeedFilter getFeeds(int index) {
+    return feeds_.get(index);
+  }
+  /**
+   *
+   *
+   * 
      +   * Criteria for the Merchant Center feeds to be ingested via the link.
+   * All offers will be ingested if the list is empty.
+   * Otherwise the offers will be ingested from selected feeds.
+   * 
      
+   *
+   * repeated .google.cloud.retail.v2alpha.MerchantCenterFeedFilter feeds = 6;
+   */
+  @java.lang.Override
+  public com.google.cloud.retail.v2alpha.MerchantCenterFeedFilterOrBuilder getFeedsOrBuilder(
+      int index) {
+    return feeds_.get(index);
+  }
+
   private byte memoizedIsInitialized = -1;
 
   @java.lang.Override
@@ -381,6 +462,9 @@ public void writeTo(com.google.protobuf.CodedOutputStream output) throws java.io
     if (!com.google.protobuf.GeneratedMessageV3.isStringEmpty(languageCode_)) {
       com.google.protobuf.GeneratedMessageV3.writeString(output, 5, languageCode_);
     }
+    for (int i = 0; i < feeds_.size(); i++) {
+      output.writeMessage(6, feeds_.get(i));
+    }
     getUnknownFields().writeTo(output);
   }
 
@@ -410,6 +494,9 @@ public int getSerializedSize() {
     if (!com.google.protobuf.GeneratedMessageV3.isStringEmpty(languageCode_)) {
       size += com.google.protobuf.GeneratedMessageV3.computeStringSize(5, languageCode_);
     }
+    for (int i = 0; i < feeds_.size(); i++) {
+      size += com.google.protobuf.CodedOutputStream.computeMessageSize(6, feeds_.get(i));
+    }
     size += getUnknownFields().getSerializedSize();
     memoizedSize = size;
     return size;
@@ -431,6 +518,7 @@ public boolean equals(final java.lang.Object obj) {
     if (!getDestinationsList().equals(other.getDestinationsList())) return false;
     if (!getRegionCode().equals(other.getRegionCode())) return false;
     if (!getLanguageCode().equals(other.getLanguageCode())) return false;
+    if (!getFeedsList().equals(other.getFeedsList())) return false;
     if (!getUnknownFields().equals(other.getUnknownFields())) return false;
     return true;
   }
@@ -454,6 +542,10 @@ public int hashCode() {
     hash = (53 * hash) + getRegionCode().hashCode();
     hash = (37 * hash) + LANGUAGE_CODE_FIELD_NUMBER;
     hash = (53 * hash) + getLanguageCode().hashCode();
+    if (getFeedsCount() > 0) {
+      hash = (37 * hash) + FEEDS_FIELD_NUMBER;
+      hash = (53 * hash) + getFeedsList().hashCode();
+    }
     hash = (29 * hash) + getUnknownFields().hashCode();
     memoizedHashCode = hash;
     return hash;
@@ -604,6 +696,13 @@ public Builder clear() {
 
       languageCode_ = "";
 
+      if (feedsBuilder_ == null) {
+        feeds_ = java.util.Collections.emptyList();
+      } else {
+        feeds_ = null;
+        feedsBuilder_.clear();
+      }
+      bitField0_ = (bitField0_ & ~0x00000002);
       return this;
     }
 
@@ -641,6 +740,15 @@ public com.google.cloud.retail.v2alpha.MerchantCenterLink buildPartial() {
       result.destinations_ = destinations_;
       result.regionCode_ = regionCode_;
       result.languageCode_ = languageCode_;
+      if (feedsBuilder_ == null) {
+        if (((bitField0_ & 0x00000002) != 0)) {
+          feeds_ = java.util.Collections.unmodifiableList(feeds_);
+          bitField0_ = (bitField0_ & ~0x00000002);
+        }
+        result.feeds_ = feeds_;
+      } else {
+        result.feeds_ = feedsBuilder_.build();
+      }
       onBuilt();
       return result;
     }
@@ -716,6 +824,33 @@ public Builder mergeFrom(com.google.cloud.retail.v2alpha.MerchantCenterLink othe
         languageCode_ = other.languageCode_;
         onChanged();
       }
+      if (feedsBuilder_ == null) {
+        if (!other.feeds_.isEmpty()) {
+          if (feeds_.isEmpty()) {
+            feeds_ = other.feeds_;
+            bitField0_ = (bitField0_ & ~0x00000002);
+          } else {
+            ensureFeedsIsMutable();
+            feeds_.addAll(other.feeds_);
+          }
+          onChanged();
+        }
+      } else {
+        if (!other.feeds_.isEmpty()) {
+          if (feedsBuilder_.isEmpty()) {
+            feedsBuilder_.dispose();
+            feedsBuilder_ = null;
+            feeds_ = other.feeds_;
+            bitField0_ = (bitField0_ & ~0x00000002);
+            feedsBuilder_ =
+                com.google.protobuf.GeneratedMessageV3.alwaysUseFieldBuilders
+                    ? getFeedsFieldBuilder()
+                    : null;
+          } else {
+            feedsBuilder_.addAllMessages(other.feeds_);
+          }
+        }
+      }
       this.mergeUnknownFields(other.getUnknownFields());
       onChanged();
       return this;
@@ -773,6 +908,20 @@ public Builder mergeFrom(
 
                 break;
               } // case 42
+            case 50:
+              {
+                com.google.cloud.retail.v2alpha.MerchantCenterFeedFilter m =
+                    input.readMessage(
+                        com.google.cloud.retail.v2alpha.MerchantCenterFeedFilter.parser(),
+                        extensionRegistry);
+                if (feedsBuilder_ == null) {
+                  ensureFeedsIsMutable();
+                  feeds_.add(m);
+                } else {
+                  feedsBuilder_.addMessage(m);
+                }
+                break;
+              } // case 50
             default:
               {
                 if (!super.parseUnknownField(input, extensionRegistry, tag)) {
@@ -798,7 +947,7 @@ public Builder mergeFrom(
      *
      * 
            * Required. The linked [Merchant center account
-     * id](https://developers.google.com/shopping-content/guides/accountstatuses).
+     * ID](https://developers.google.com/shopping-content/guides/accountstatuses).
      * The account must be a standalone account or a sub-account of a MCA.
      * 
      
      *
@@ -815,7 +964,7 @@ public long getMerchantCenterAccountId() {
      *
      * 
            * Required. The linked [Merchant center account
-     * id](https://developers.google.com/shopping-content/guides/accountstatuses).
+     * ID](https://developers.google.com/shopping-content/guides/accountstatuses).
      * The account must be a standalone account or a sub-account of a MCA.
      * 
      
      *
@@ -835,7 +984,7 @@ public Builder setMerchantCenterAccountId(long value) {
      *
      * 
            * Required. The linked [Merchant center account
-     * id](https://developers.google.com/shopping-content/guides/accountstatuses).
+     * ID](https://developers.google.com/shopping-content/guides/accountstatuses).
      * The account must be a standalone account or a sub-account of a MCA.
      * 
      
      *
@@ -855,11 +1004,11 @@ public Builder clearMerchantCenterAccountId() {
      *
      *
      * 
      -     * The branch id (e.g. 0/1/2) within this catalog that products from
+     * The branch ID (e.g. 0/1/2) within this catalog that products from
      * merchant_center_account_id are streamed to. When updating this field, an
      * empty value will use the currently configured default branch. However,
      * changing the default branch later on won't change the linked branch here.
-     * A single branch id can only have one linked merchant center account id.
+     * A single branch ID can only have one linked merchant center account ID.
      * 
      
      *
      * string branch_id = 2;
@@ -881,11 +1030,11 @@ public java.lang.String getBranchId() {
      *
      *
      * 
      -     * The branch id (e.g. 0/1/2) within this catalog that products from
+     * The branch ID (e.g. 0/1/2) within this catalog that products from
      * merchant_center_account_id are streamed to. When updating this field, an
      * empty value will use the currently configured default branch. However,
      * changing the default branch later on won't change the linked branch here.
-     * A single branch id can only have one linked merchant center account id.
+     * A single branch ID can only have one linked merchant center account ID.
      * 
      
      *
      * string branch_id = 2;
@@ -907,11 +1056,11 @@ public com.google.protobuf.ByteString getBranchIdBytes() {
      *
      *
      * 
      -     * The branch id (e.g. 0/1/2) within this catalog that products from
+     * The branch ID (e.g. 0/1/2) within this catalog that products from
      * merchant_center_account_id are streamed to. When updating this field, an
      * empty value will use the currently configured default branch. However,
      * changing the default branch later on won't change the linked branch here.
-     * A single branch id can only have one linked merchant center account id.
+     * A single branch ID can only have one linked merchant center account ID.
      * 
      
      *
      * string branch_id = 2;
@@ -932,11 +1081,11 @@ public Builder setBranchId(java.lang.String value) {
      *
      *
      * 
      -     * The branch id (e.g. 0/1/2) within this catalog that products from
+     * The branch ID (e.g. 0/1/2) within this catalog that products from
      * merchant_center_account_id are streamed to. When updating this field, an
      * empty value will use the currently configured default branch. However,
      * changing the default branch later on won't change the linked branch here.
-     * A single branch id can only have one linked merchant center account id.
+     * A single branch ID can only have one linked merchant center account ID.
      * 
      
      *
      * string branch_id = 2;
@@ -953,11 +1102,11 @@ public Builder clearBranchId() {
      *
      *
      * 
      -     * The branch id (e.g. 0/1/2) within this catalog that products from
+     * The branch ID (e.g. 0/1/2) within this catalog that products from
      * merchant_center_account_id are streamed to. When updating this field, an
      * empty value will use the currently configured default branch. However,
      * changing the default branch later on won't change the linked branch here.
-     * A single branch id can only have one linked merchant center account id.
+     * A single branch ID can only have one linked merchant center account ID.
      * 
      
      *
      * string branch_id = 2;
@@ -990,8 +1139,8 @@ private void ensureDestinationsIsMutable() {
      *
      * 
            * String representing the destination to import for, all if left empty.
-     * List of possible values can be found here.
-     * [https://support.google.com/merchants/answer/7501026]
+     * List of possible values is given in [Included
+     * destination](https://support.google.com/merchants/answer/7501026).
      * List of allowed string values:
      * "Shopping_ads", "Buy_on_google_listings", "Display_ads", "Local_inventory
      * _ads", "Free_listings", "Free_local_listings"
@@ -1010,8 +1159,8 @@ public com.google.protobuf.ProtocolStringList getDestinationsList() {
      *
      * 
            * String representing the destination to import for, all if left empty.
-     * List of possible values can be found here.
-     * [https://support.google.com/merchants/answer/7501026]
+     * List of possible values is given in [Included
+     * destination](https://support.google.com/merchants/answer/7501026).
      * List of allowed string values:
      * "Shopping_ads", "Buy_on_google_listings", "Display_ads", "Local_inventory
      * _ads", "Free_listings", "Free_local_listings"
@@ -1030,8 +1179,8 @@ public int getDestinationsCount() {
      *
      * 
            * String representing the destination to import for, all if left empty.
-     * List of possible values can be found here.
-     * [https://support.google.com/merchants/answer/7501026]
+     * List of possible values is given in [Included
+     * destination](https://support.google.com/merchants/answer/7501026).
      * List of allowed string values:
      * "Shopping_ads", "Buy_on_google_listings", "Display_ads", "Local_inventory
      * _ads", "Free_listings", "Free_local_listings"
@@ -1051,8 +1200,8 @@ public java.lang.String getDestinations(int index) {
      *
      * 
            * String representing the destination to import for, all if left empty.
-     * List of possible values can be found here.
-     * [https://support.google.com/merchants/answer/7501026]
+     * List of possible values is given in [Included
+     * destination](https://support.google.com/merchants/answer/7501026).
      * List of allowed string values:
      * "Shopping_ads", "Buy_on_google_listings", "Display_ads", "Local_inventory
      * _ads", "Free_listings", "Free_local_listings"
@@ -1072,8 +1221,8 @@ public com.google.protobuf.ByteString getDestinationsBytes(int index) {
      *
      * 
            * String representing the destination to import for, all if left empty.
-     * List of possible values can be found here.
-     * [https://support.google.com/merchants/answer/7501026]
+     * List of possible values is given in [Included
+     * destination](https://support.google.com/merchants/answer/7501026).
      * List of allowed string values:
      * "Shopping_ads", "Buy_on_google_listings", "Display_ads", "Local_inventory
      * _ads", "Free_listings", "Free_local_listings"
@@ -1100,8 +1249,8 @@ public Builder setDestinations(int index, java.lang.String value) {
      *
      * 
            * String representing the destination to import for, all if left empty.
-     * List of possible values can be found here.
-     * [https://support.google.com/merchants/answer/7501026]
+     * List of possible values is given in [Included
+     * destination](https://support.google.com/merchants/answer/7501026).
      * List of allowed string values:
      * "Shopping_ads", "Buy_on_google_listings", "Display_ads", "Local_inventory
      * _ads", "Free_listings", "Free_local_listings"
@@ -1127,8 +1276,8 @@ public Builder addDestinations(java.lang.String value) {
      *
      * 
            * String representing the destination to import for, all if left empty.
-     * List of possible values can be found here.
-     * [https://support.google.com/merchants/answer/7501026]
+     * List of possible values is given in [Included
+     * destination](https://support.google.com/merchants/answer/7501026).
      * List of allowed string values:
      * "Shopping_ads", "Buy_on_google_listings", "Display_ads", "Local_inventory
      * _ads", "Free_listings", "Free_local_listings"
@@ -1151,8 +1300,8 @@ public Builder addAllDestinations(java.lang.Iterable values) {
      *
      * 
            * String representing the destination to import for, all if left empty.
-     * List of possible values can be found here.
-     * [https://support.google.com/merchants/answer/7501026]
+     * List of possible values is given in [Included
+     * destination](https://support.google.com/merchants/answer/7501026).
      * List of allowed string values:
      * "Shopping_ads", "Buy_on_google_listings", "Display_ads", "Local_inventory
      * _ads", "Free_listings", "Free_local_listings"
@@ -1174,8 +1323,8 @@ public Builder clearDestinations() {
      *
      * 
            * String representing the destination to import for, all if left empty.
-     * List of possible values can be found here.
-     * [https://support.google.com/merchants/answer/7501026]
+     * List of possible values is given in [Included
+     * destination](https://support.google.com/merchants/answer/7501026).
      * List of allowed string values:
      * "Shopping_ads", "Buy_on_google_listings", "Display_ads", "Local_inventory
      * _ads", "Free_listings", "Free_local_listings"
@@ -1460,6 +1609,405 @@ public Builder setLanguageCodeBytes(com.google.protobuf.ByteString value) {
       return this;
     }
 
+    private java.util.List feeds_ =
+        java.util.Collections.emptyList();
+
+    private void ensureFeedsIsMutable() {
+      if (!((bitField0_ & 0x00000002) != 0)) {
+        feeds_ =
+            new java.util.ArrayList(
+                feeds_);
+        bitField0_ |= 0x00000002;
+      }
+    }
+
+    private com.google.protobuf.RepeatedFieldBuilderV3<
+            com.google.cloud.retail.v2alpha.MerchantCenterFeedFilter,
+            com.google.cloud.retail.v2alpha.MerchantCenterFeedFilter.Builder,
+            com.google.cloud.retail.v2alpha.MerchantCenterFeedFilterOrBuilder>
+        feedsBuilder_;
+
+    /**
+     *
+     *
+     * 
      +     * Criteria for the Merchant Center feeds to be ingested via the link.
+     * All offers will be ingested if the list is empty.
+     * Otherwise the offers will be ingested from selected feeds.
+     * 
      
+     *
+     * repeated .google.cloud.retail.v2alpha.MerchantCenterFeedFilter feeds = 6;
+     */
+    public java.util.List getFeedsList() {
+      if (feedsBuilder_ == null) {
+        return java.util.Collections.unmodifiableList(feeds_);
+      } else {
+        return feedsBuilder_.getMessageList();
+      }
+    }
+    /**
+     *
+     *
+     * 
      +     * Criteria for the Merchant Center feeds to be ingested via the link.
+     * All offers will be ingested if the list is empty.
+     * Otherwise the offers will be ingested from selected feeds.
+     * 
      
+     *
+     * repeated .google.cloud.retail.v2alpha.MerchantCenterFeedFilter feeds = 6;
+     */
+    public int getFeedsCount() {
+      if (feedsBuilder_ == null) {
+        return feeds_.size();
+      } else {
+        return feedsBuilder_.getCount();
+      }
+    }
+    /**
+     *
+     *
+     * 
      +     * Criteria for the Merchant Center feeds to be ingested via the link.
+     * All offers will be ingested if the list is empty.
+     * Otherwise the offers will be ingested from selected feeds.
+     * 
      
+     *
+     * repeated .google.cloud.retail.v2alpha.MerchantCenterFeedFilter feeds = 6;
+     */
+    public com.google.cloud.retail.v2alpha.MerchantCenterFeedFilter getFeeds(int index) {
+      if (feedsBuilder_ == null) {
+        return feeds_.get(index);
+      } else {
+        return feedsBuilder_.getMessage(index);
+      }
+    }
+    /**
+     *
+     *
+     * 
      +     * Criteria for the Merchant Center feeds to be ingested via the link.
+     * All offers will be ingested if the list is empty.
+     * Otherwise the offers will be ingested from selected feeds.
+     * 
      
+     *
+     * repeated .google.cloud.retail.v2alpha.MerchantCenterFeedFilter feeds = 6;
+     */
+    public Builder setFeeds(
+        int index, com.google.cloud.retail.v2alpha.MerchantCenterFeedFilter value) {
+      if (feedsBuilder_ == null) {
+        if (value == null) {
+          throw new NullPointerException();
+        }
+        ensureFeedsIsMutable();
+        feeds_.set(index, value);
+        onChanged();
+      } else {
+        feedsBuilder_.setMessage(index, value);
+      }
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * Criteria for the Merchant Center feeds to be ingested via the link.
+     * All offers will be ingested if the list is empty.
+     * Otherwise the offers will be ingested from selected feeds.
+     * 
      
+     *
+     * repeated .google.cloud.retail.v2alpha.MerchantCenterFeedFilter feeds = 6;
+     */
+    public Builder setFeeds(
+        int index,
+        com.google.cloud.retail.v2alpha.MerchantCenterFeedFilter.Builder builderForValue) {
+      if (feedsBuilder_ == null) {
+        ensureFeedsIsMutable();
+        feeds_.set(index, builderForValue.build());
+        onChanged();
+      } else {
+        feedsBuilder_.setMessage(index, builderForValue.build());
+      }
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * Criteria for the Merchant Center feeds to be ingested via the link.
+     * All offers will be ingested if the list is empty.
+     * Otherwise the offers will be ingested from selected feeds.
+     * 
      
+     *
+     * repeated .google.cloud.retail.v2alpha.MerchantCenterFeedFilter feeds = 6;
+     */
+    public Builder addFeeds(com.google.cloud.retail.v2alpha.MerchantCenterFeedFilter value) {
+      if (feedsBuilder_ == null) {
+        if (value == null) {
+          throw new NullPointerException();
+        }
+        ensureFeedsIsMutable();
+        feeds_.add(value);
+        onChanged();
+      } else {
+        feedsBuilder_.addMessage(value);
+      }
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * Criteria for the Merchant Center feeds to be ingested via the link.
+     * All offers will be ingested if the list is empty.
+     * Otherwise the offers will be ingested from selected feeds.
+     * 
      
+     *
+     * repeated .google.cloud.retail.v2alpha.MerchantCenterFeedFilter feeds = 6;
+     */
+    public Builder addFeeds(
+        int index, com.google.cloud.retail.v2alpha.MerchantCenterFeedFilter value) {
+      if (feedsBuilder_ == null) {
+        if (value == null) {
+          throw new NullPointerException();
+        }
+        ensureFeedsIsMutable();
+        feeds_.add(index, value);
+        onChanged();
+      } else {
+        feedsBuilder_.addMessage(index, value);
+      }
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * Criteria for the Merchant Center feeds to be ingested via the link.
+     * All offers will be ingested if the list is empty.
+     * Otherwise the offers will be ingested from selected feeds.
+     * 
      
+     *
+     * repeated .google.cloud.retail.v2alpha.MerchantCenterFeedFilter feeds = 6;
+     */
+    public Builder addFeeds(
+        com.google.cloud.retail.v2alpha.MerchantCenterFeedFilter.Builder builderForValue) {
+      if (feedsBuilder_ == null) {
+        ensureFeedsIsMutable();
+        feeds_.add(builderForValue.build());
+        onChanged();
+      } else {
+        feedsBuilder_.addMessage(builderForValue.build());
+      }
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * Criteria for the Merchant Center feeds to be ingested via the link.
+     * All offers will be ingested if the list is empty.
+     * Otherwise the offers will be ingested from selected feeds.
+     * 
      
+     *
+     * repeated .google.cloud.retail.v2alpha.MerchantCenterFeedFilter feeds = 6;
+     */
+    public Builder addFeeds(
+        int index,
+        com.google.cloud.retail.v2alpha.MerchantCenterFeedFilter.Builder builderForValue) {
+      if (feedsBuilder_ == null) {
+        ensureFeedsIsMutable();
+        feeds_.add(index, builderForValue.build());
+        onChanged();
+      } else {
+        feedsBuilder_.addMessage(index, builderForValue.build());
+      }
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * Criteria for the Merchant Center feeds to be ingested via the link.
+     * All offers will be ingested if the list is empty.
+     * Otherwise the offers will be ingested from selected feeds.
+     * 
      
+     *
+     * repeated .google.cloud.retail.v2alpha.MerchantCenterFeedFilter feeds = 6;
+     */
+    public Builder addAllFeeds(
+        java.lang.Iterable
+            values) {
+      if (feedsBuilder_ == null) {
+        ensureFeedsIsMutable();
+        com.google.protobuf.AbstractMessageLite.Builder.addAll(values, feeds_);
+        onChanged();
+      } else {
+        feedsBuilder_.addAllMessages(values);
+      }
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * Criteria for the Merchant Center feeds to be ingested via the link.
+     * All offers will be ingested if the list is empty.
+     * Otherwise the offers will be ingested from selected feeds.
+     * 
      
+     *
+     * repeated .google.cloud.retail.v2alpha.MerchantCenterFeedFilter feeds = 6;
+     */
+    public Builder clearFeeds() {
+      if (feedsBuilder_ == null) {
+        feeds_ = java.util.Collections.emptyList();
+        bitField0_ = (bitField0_ & ~0x00000002);
+        onChanged();
+      } else {
+        feedsBuilder_.clear();
+      }
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * Criteria for the Merchant Center feeds to be ingested via the link.
+     * All offers will be ingested if the list is empty.
+     * Otherwise the offers will be ingested from selected feeds.
+     * 
      
+     *
+     * repeated .google.cloud.retail.v2alpha.MerchantCenterFeedFilter feeds = 6;
+     */
+    public Builder removeFeeds(int index) {
+      if (feedsBuilder_ == null) {
+        ensureFeedsIsMutable();
+        feeds_.remove(index);
+        onChanged();
+      } else {
+        feedsBuilder_.remove(index);
+      }
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * Criteria for the Merchant Center feeds to be ingested via the link.
+     * All offers will be ingested if the list is empty.
+     * Otherwise the offers will be ingested from selected feeds.
+     * 
      
+     *
+     * repeated .google.cloud.retail.v2alpha.MerchantCenterFeedFilter feeds = 6;
+     */
+    public com.google.cloud.retail.v2alpha.MerchantCenterFeedFilter.Builder getFeedsBuilder(
+        int index) {
+      return getFeedsFieldBuilder().getBuilder(index);
+    }
+    /**
+     *
+     *
+     * 
      +     * Criteria for the Merchant Center feeds to be ingested via the link.
+     * All offers will be ingested if the list is empty.
+     * Otherwise the offers will be ingested from selected feeds.
+     * 
      
+     *
+     * repeated .google.cloud.retail.v2alpha.MerchantCenterFeedFilter feeds = 6;
+     */
+    public com.google.cloud.retail.v2alpha.MerchantCenterFeedFilterOrBuilder getFeedsOrBuilder(
+        int index) {
+      if (feedsBuilder_ == null) {
+        return feeds_.get(index);
+      } else {
+        return feedsBuilder_.getMessageOrBuilder(index);
+      }
+    }
+    /**
+     *
+     *
+     * 
      +     * Criteria for the Merchant Center feeds to be ingested via the link.
+     * All offers will be ingested if the list is empty.
+     * Otherwise the offers will be ingested from selected feeds.
+     * 
      
+     *
+     * repeated .google.cloud.retail.v2alpha.MerchantCenterFeedFilter feeds = 6;
+     */
+    public java.util.List<
+            ? extends com.google.cloud.retail.v2alpha.MerchantCenterFeedFilterOrBuilder>
+        getFeedsOrBuilderList() {
+      if (feedsBuilder_ != null) {
+        return feedsBuilder_.getMessageOrBuilderList();
+      } else {
+        return java.util.Collections.unmodifiableList(feeds_);
+      }
+    }
+    /**
+     *
+     *
+     * 
      +     * Criteria for the Merchant Center feeds to be ingested via the link.
+     * All offers will be ingested if the list is empty.
+     * Otherwise the offers will be ingested from selected feeds.
+     * 
      
+     *
+     * repeated .google.cloud.retail.v2alpha.MerchantCenterFeedFilter feeds = 6;
+     */
+    public com.google.cloud.retail.v2alpha.MerchantCenterFeedFilter.Builder addFeedsBuilder() {
+      return getFeedsFieldBuilder()
+          .addBuilder(
+              com.google.cloud.retail.v2alpha.MerchantCenterFeedFilter.getDefaultInstance());
+    }
+    /**
+     *
+     *
+     * 
      +     * Criteria for the Merchant Center feeds to be ingested via the link.
+     * All offers will be ingested if the list is empty.
+     * Otherwise the offers will be ingested from selected feeds.
+     * 
      
+     *
+     * repeated .google.cloud.retail.v2alpha.MerchantCenterFeedFilter feeds = 6;
+     */
+    public com.google.cloud.retail.v2alpha.MerchantCenterFeedFilter.Builder addFeedsBuilder(
+        int index) {
+      return getFeedsFieldBuilder()
+          .addBuilder(
+              index, com.google.cloud.retail.v2alpha.MerchantCenterFeedFilter.getDefaultInstance());
+    }
+    /**
+     *
+     *
+     * 
      +     * Criteria for the Merchant Center feeds to be ingested via the link.
+     * All offers will be ingested if the list is empty.
+     * Otherwise the offers will be ingested from selected feeds.
+     * 
      
+     *
+     * repeated .google.cloud.retail.v2alpha.MerchantCenterFeedFilter feeds = 6;
+     */
+    public java.util.List
+        getFeedsBuilderList() {
+      return getFeedsFieldBuilder().getBuilderList();
+    }
+
+    private com.google.protobuf.RepeatedFieldBuilderV3<
+            com.google.cloud.retail.v2alpha.MerchantCenterFeedFilter,
+            com.google.cloud.retail.v2alpha.MerchantCenterFeedFilter.Builder,
+            com.google.cloud.retail.v2alpha.MerchantCenterFeedFilterOrBuilder>
+        getFeedsFieldBuilder() {
+      if (feedsBuilder_ == null) {
+        feedsBuilder_ =
+            new com.google.protobuf.RepeatedFieldBuilderV3<
+                com.google.cloud.retail.v2alpha.MerchantCenterFeedFilter,
+                com.google.cloud.retail.v2alpha.MerchantCenterFeedFilter.Builder,
+                com.google.cloud.retail.v2alpha.MerchantCenterFeedFilterOrBuilder>(
+                feeds_, ((bitField0_ & 0x00000002) != 0), getParentForChildren(), isClean());
+        feeds_ = null;
+      }
+      return feedsBuilder_;
+    }
+
     @java.lang.Override
     public final Builder setUnknownFields(final com.google.protobuf.UnknownFieldSet unknownFields) {
       return super.setUnknownFields(unknownFields);
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/MerchantCenterLinkOrBuilder.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/MerchantCenterLinkOrBuilder.java
index 79b5015c40bb..ed596578a002 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/MerchantCenterLinkOrBuilder.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/MerchantCenterLinkOrBuilder.java
@@ -28,7 +28,7 @@ public interface MerchantCenterLinkOrBuilder
    *
    * 
          * Required. The linked [Merchant center account
-   * id](https://developers.google.com/shopping-content/guides/accountstatuses).
+   * ID](https://developers.google.com/shopping-content/guides/accountstatuses).
    * The account must be a standalone account or a sub-account of a MCA.
    * 
      
    *
@@ -42,11 +42,11 @@ public interface MerchantCenterLinkOrBuilder
    *
    *
    * 
      -   * The branch id (e.g. 0/1/2) within this catalog that products from
+   * The branch ID (e.g. 0/1/2) within this catalog that products from
    * merchant_center_account_id are streamed to. When updating this field, an
    * empty value will use the currently configured default branch. However,
    * changing the default branch later on won't change the linked branch here.
-   * A single branch id can only have one linked merchant center account id.
+   * A single branch ID can only have one linked merchant center account ID.
    * 
      
    *
    * string branch_id = 2;
@@ -58,11 +58,11 @@ public interface MerchantCenterLinkOrBuilder
    *
    *
    * 
      -   * The branch id (e.g. 0/1/2) within this catalog that products from
+   * The branch ID (e.g. 0/1/2) within this catalog that products from
    * merchant_center_account_id are streamed to. When updating this field, an
    * empty value will use the currently configured default branch. However,
    * changing the default branch later on won't change the linked branch here.
-   * A single branch id can only have one linked merchant center account id.
+   * A single branch ID can only have one linked merchant center account ID.
    * 
      
    *
    * string branch_id = 2;
@@ -76,8 +76,8 @@ public interface MerchantCenterLinkOrBuilder
    *
    * 
          * String representing the destination to import for, all if left empty.
-   * List of possible values can be found here.
-   * [https://support.google.com/merchants/answer/7501026]
+   * List of possible values is given in [Included
+   * destination](https://support.google.com/merchants/answer/7501026).
    * List of allowed string values:
    * "Shopping_ads", "Buy_on_google_listings", "Display_ads", "Local_inventory
    * _ads", "Free_listings", "Free_local_listings"
@@ -94,8 +94,8 @@ public interface MerchantCenterLinkOrBuilder
    *
    * 
          * String representing the destination to import for, all if left empty.
-   * List of possible values can be found here.
-   * [https://support.google.com/merchants/answer/7501026]
+   * List of possible values is given in [Included
+   * destination](https://support.google.com/merchants/answer/7501026).
    * List of allowed string values:
    * "Shopping_ads", "Buy_on_google_listings", "Display_ads", "Local_inventory
    * _ads", "Free_listings", "Free_local_listings"
@@ -112,8 +112,8 @@ public interface MerchantCenterLinkOrBuilder
    *
    * 
          * String representing the destination to import for, all if left empty.
-   * List of possible values can be found here.
-   * [https://support.google.com/merchants/answer/7501026]
+   * List of possible values is given in [Included
+   * destination](https://support.google.com/merchants/answer/7501026).
    * List of allowed string values:
    * "Shopping_ads", "Buy_on_google_listings", "Display_ads", "Local_inventory
    * _ads", "Free_listings", "Free_local_listings"
@@ -131,8 +131,8 @@ public interface MerchantCenterLinkOrBuilder
    *
    * 
          * String representing the destination to import for, all if left empty.
-   * List of possible values can be found here.
-   * [https://support.google.com/merchants/answer/7501026]
+   * List of possible values is given in [Included
+   * destination](https://support.google.com/merchants/answer/7501026).
    * List of allowed string values:
    * "Shopping_ads", "Buy_on_google_listings", "Display_ads", "Local_inventory
    * _ads", "Free_listings", "Free_local_listings"
@@ -215,4 +215,66 @@ public interface MerchantCenterLinkOrBuilder
    * @return The bytes for languageCode.
    */
   com.google.protobuf.ByteString getLanguageCodeBytes();
+
+  /**
+   *
+   *
+   * 
      +   * Criteria for the Merchant Center feeds to be ingested via the link.
+   * All offers will be ingested if the list is empty.
+   * Otherwise the offers will be ingested from selected feeds.
+   * 
      
+   *
+   * repeated .google.cloud.retail.v2alpha.MerchantCenterFeedFilter feeds = 6;
+   */
+  java.util.List getFeedsList();
+  /**
+   *
+   *
+   * 
      +   * Criteria for the Merchant Center feeds to be ingested via the link.
+   * All offers will be ingested if the list is empty.
+   * Otherwise the offers will be ingested from selected feeds.
+   * 
      
+   *
+   * repeated .google.cloud.retail.v2alpha.MerchantCenterFeedFilter feeds = 6;
+   */
+  com.google.cloud.retail.v2alpha.MerchantCenterFeedFilter getFeeds(int index);
+  /**
+   *
+   *
+   * 
      +   * Criteria for the Merchant Center feeds to be ingested via the link.
+   * All offers will be ingested if the list is empty.
+   * Otherwise the offers will be ingested from selected feeds.
+   * 
      
+   *
+   * repeated .google.cloud.retail.v2alpha.MerchantCenterFeedFilter feeds = 6;
+   */
+  int getFeedsCount();
+  /**
+   *
+   *
+   * 
      +   * Criteria for the Merchant Center feeds to be ingested via the link.
+   * All offers will be ingested if the list is empty.
+   * Otherwise the offers will be ingested from selected feeds.
+   * 
      
+   *
+   * repeated .google.cloud.retail.v2alpha.MerchantCenterFeedFilter feeds = 6;
+   */
+  java.util.List
+      getFeedsOrBuilderList();
+  /**
+   *
+   *
+   * 
      +   * Criteria for the Merchant Center feeds to be ingested via the link.
+   * All offers will be ingested if the list is empty.
+   * Otherwise the offers will be ingested from selected feeds.
+   * 
      
+   *
+   * repeated .google.cloud.retail.v2alpha.MerchantCenterFeedFilter feeds = 6;
+   */
+  com.google.cloud.retail.v2alpha.MerchantCenterFeedFilterOrBuilder getFeedsOrBuilder(int index);
 }
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/Model.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/Model.java
index 944164101d51..573274e7b15b 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/Model.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/Model.java
@@ -26,7 +26,7 @@
  * [Model][google.cloud.retail.v2alpha.Model]. A
  * [Model][google.cloud.retail.v2alpha.Model] can be associated with a
  * [ServingConfig][google.cloud.retail.v2alpha.ServingConfig] and then queried
- * through the Predict api.
+ * through the Predict API.
  * 
      
  *
  * Protobuf type {@code google.cloud.retail.v2alpha.Model}
@@ -125,7 +125,7 @@ public enum ServingState implements com.google.protobuf.ProtocolMessageEnum {
      *
      *
      * 
      -     * The model is trained on tuned hyperparameters, and can be
+     * The model is trained on tuned hyperparameters and can be
      * queried.
      * 
      
      *
@@ -169,7 +169,7 @@ public enum ServingState implements com.google.protobuf.ProtocolMessageEnum {
      *
      *
      * 
      -     * The model is trained on tuned hyperparameters, and can be
+     * The model is trained on tuned hyperparameters and can be
      * queried.
      * 
      
      *
@@ -425,7 +425,7 @@ private TrainingState(int value) {
    * 
          * Describes whether periodic tuning is enabled for this model
    * or not. Periodic tuning is scheduled at most every three months. You can
-   * start a tuning process manually by using the ModelTune
+   * start a tuning process manually by using the `TuneModel`
    * method, which starts a tuning process immediately and resets the quarterly
    * schedule. Enabling or disabling periodic tuning does not affect any
    * current tuning processes.
@@ -438,7 +438,7 @@ public enum PeriodicTuningState implements com.google.protobuf.ProtocolMessageEn
      *
      *
      * 
      -     * Unspecified default value - should never be explicitly set.
+     * Unspecified default value, should never be explicitly set.
      * 
      
      *
      * PERIODIC_TUNING_STATE_UNSPECIFIED = 0;
@@ -449,8 +449,8 @@ public enum PeriodicTuningState implements com.google.protobuf.ProtocolMessageEn
      *
      * 
            * The model has periodic tuning disabled. Tuning
-     * can be reenabled by calling the EnableModelPeriodicTuning
-     * method or by calling the TuneModel method.
+     * can be reenabled by calling the `EnableModelPeriodicTuning`
+     * method or by calling the `TuneModel` method.
      * 
      
      *
      * PERIODIC_TUNING_DISABLED = 1;
@@ -461,7 +461,7 @@ public enum PeriodicTuningState implements com.google.protobuf.ProtocolMessageEn
      *
      * 
            * The model cannot be tuned with periodic tuning OR the
-     * TuneModel method. Hide the options in customer UI and
+     * `TuneModel` method. Hide the options in customer UI and
      * reject any requests through the backend self serve API.
      * 
      
      *
@@ -473,7 +473,7 @@ public enum PeriodicTuningState implements com.google.protobuf.ProtocolMessageEn
      *
      * 
            * The model has periodic tuning enabled. Tuning
-     * can be disabled by calling the DisableModelPeriodicTuning
+     * can be disabled by calling the `DisableModelPeriodicTuning`
      * method.
      * 
      
      *
@@ -487,7 +487,7 @@ public enum PeriodicTuningState implements com.google.protobuf.ProtocolMessageEn
      *
      *
      * 
      -     * Unspecified default value - should never be explicitly set.
+     * Unspecified default value, should never be explicitly set.
      * 
      
      *
      * PERIODIC_TUNING_STATE_UNSPECIFIED = 0;
@@ -498,8 +498,8 @@ public enum PeriodicTuningState implements com.google.protobuf.ProtocolMessageEn
      *
      * 
            * The model has periodic tuning disabled. Tuning
-     * can be reenabled by calling the EnableModelPeriodicTuning
-     * method or by calling the TuneModel method.
+     * can be reenabled by calling the `EnableModelPeriodicTuning`
+     * method or by calling the `TuneModel` method.
      * 
      
      *
      * PERIODIC_TUNING_DISABLED = 1;
@@ -510,7 +510,7 @@ public enum PeriodicTuningState implements com.google.protobuf.ProtocolMessageEn
      *
      * 
            * The model cannot be tuned with periodic tuning OR the
-     * TuneModel method. Hide the options in customer UI and
+     * `TuneModel` method. Hide the options in customer UI and
      * reject any requests through the backend self serve API.
      * 
      
      *
@@ -522,7 +522,7 @@ public enum PeriodicTuningState implements com.google.protobuf.ProtocolMessageEn
      *
      * 
            * The model has periodic tuning enabled. Tuning
-     * can be disabled by calling the DisableModelPeriodicTuning
+     * can be disabled by calling the `DisableModelPeriodicTuning`
      * method.
      * 
      
      *
@@ -633,7 +633,7 @@ public enum DataState implements com.google.protobuf.ProtocolMessageEnum {
      *
      *
      * 
      -     * Unspecified default value - should never be explicitly set.
+     * Unspecified default value, should never be explicitly set.
      * 
      
      *
      * DATA_STATE_UNSPECIFIED = 0;
@@ -667,7 +667,7 @@ public enum DataState implements com.google.protobuf.ProtocolMessageEnum {
      *
      *
      * 
      -     * Unspecified default value - should never be explicitly set.
+     * Unspecified default value, should never be explicitly set.
      * 
      
      *
      * DATA_STATE_UNSPECIFIED = 0;
@@ -947,7 +947,7 @@ com.google.cloud.retail.v2alpha.Model.PageOptimizationConfig.PanelOrBuilder getP
    * 
          * The PageOptimizationConfig for model training.
    * This determines how many panels to optimize for, and which serving
-   * configurations to consider for each panel.
+   * configs to consider for each panel.
    * The purpose of this model is to optimize which
    * [ServingConfig][google.cloud.retail.v2alpha.ServingConfig] to show on which
    * panels in way that optimizes the visitors shopping journey.
@@ -1058,7 +1058,7 @@ public enum Restriction implements com.google.protobuf.ProtocolMessageEnum {
        * `Panel2 candidates`: <i> home_page_ctr_no_diversity,
        * home_page_ctr_diversity_low,
        *    pdp_cvr_no_diversity </i>
-       * `Restriction` = UNIQUE_SERVING_CONFIG_RESTRICTION
+       * `Restriction` = `UNIQUE_SERVING_CONFIG_RESTRICTION`
        * `Valid combinations`:
        *   * <i> (pdp_ctr, home_page_ctr_no_diversity)
        *   * (pdp_ctr, home_page_ctr_diversity_low)
@@ -1090,7 +1090,7 @@ public enum Restriction implements com.google.protobuf.ProtocolMessageEnum {
        * `Panel2 candidates`: <i> home_page_ctr_no_diversity,
        * home_page_ctr_diversity_low,
        *  pdp_cvr_no_diversity </i>
-       * `Restriction` = UNIQUE_MODEL_RESTRICTION
+       * `Restriction` = `UNIQUE_MODEL_RESTRICTION`
        * `Valid combinations`:
        *  * <i> (pdp_ctr, home_page_ctr_no_diversity)
        *  * (pdp_ctr, home_page_ctr_diversity)
@@ -1121,7 +1121,7 @@ public enum Restriction implements com.google.protobuf.ProtocolMessageEnum {
        * `Panel2 candidates`: <i> home_page_ctr_no_diversity,
        * home_page_ctr_diversity_low,
        *  pdp_cvr_no_diversity </i>
-       * `Restriction` = UNIQUE_MODEL_RESTRICTION
+       * `Restriction` = `UNIQUE_MODEL_RESTRICTION`
        * `Valid combinations`:
        * * <i> (pdp_ctr, home_page_ctr_no_diversity)
        * * (pdp_ctr, home_page_ctr_diversity)
@@ -1193,7 +1193,7 @@ public enum Restriction implements com.google.protobuf.ProtocolMessageEnum {
        * `Panel2 candidates`: <i> home_page_ctr_no_diversity,
        * home_page_ctr_diversity_low,
        *    pdp_cvr_no_diversity </i>
-       * `Restriction` = UNIQUE_SERVING_CONFIG_RESTRICTION
+       * `Restriction` = `UNIQUE_SERVING_CONFIG_RESTRICTION`
        * `Valid combinations`:
        *   * <i> (pdp_ctr, home_page_ctr_no_diversity)
        *   * (pdp_ctr, home_page_ctr_diversity_low)
@@ -1225,7 +1225,7 @@ public enum Restriction implements com.google.protobuf.ProtocolMessageEnum {
        * `Panel2 candidates`: <i> home_page_ctr_no_diversity,
        * home_page_ctr_diversity_low,
        *  pdp_cvr_no_diversity </i>
-       * `Restriction` = UNIQUE_MODEL_RESTRICTION
+       * `Restriction` = `UNIQUE_MODEL_RESTRICTION`
        * `Valid combinations`:
        *  * <i> (pdp_ctr, home_page_ctr_no_diversity)
        *  * (pdp_ctr, home_page_ctr_diversity)
@@ -1256,7 +1256,7 @@ public enum Restriction implements com.google.protobuf.ProtocolMessageEnum {
        * `Panel2 candidates`: <i> home_page_ctr_no_diversity,
        * home_page_ctr_diversity_low,
        *  pdp_cvr_no_diversity </i>
-       * `Restriction` = UNIQUE_MODEL_RESTRICTION
+       * `Restriction` = `UNIQUE_MODEL_RESTRICTION`
        * `Valid combinations`:
        * * <i> (pdp_ctr, home_page_ctr_no_diversity)
        * * (pdp_ctr, home_page_ctr_diversity)
@@ -1375,9 +1375,9 @@ public interface CandidateOrBuilder
        * 
              * This has to be a valid
        * [ServingConfig][google.cloud.retail.v2alpha.ServingConfig]
-       * identifier. e.g. for a ServingConfig with full name:
-       * `projects/*/locations/global/catalogs/default_catalog/servingConfigs/my_candidate_config`
-       * this would be 'my_candidate_config'
+       * identifier. For example, for a ServingConfig with full name:
+       * `projects/*/locations/global/catalogs/default_catalog/servingConfigs/my_candidate_config`,
+       * this would be `my_candidate_config`.
        * 
      
        *
        * string serving_config_id = 1;
@@ -1391,9 +1391,9 @@ public interface CandidateOrBuilder
        * 
              * This has to be a valid
        * [ServingConfig][google.cloud.retail.v2alpha.ServingConfig]
-       * identifier. e.g. for a ServingConfig with full name:
-       * `projects/*/locations/global/catalogs/default_catalog/servingConfigs/my_candidate_config`
-       * this would be 'my_candidate_config'
+       * identifier. For example, for a ServingConfig with full name:
+       * `projects/*/locations/global/catalogs/default_catalog/servingConfigs/my_candidate_config`,
+       * this would be `my_candidate_config`.
        * 
      
        *
        * string serving_config_id = 1;
@@ -1407,9 +1407,9 @@ public interface CandidateOrBuilder
        * 
              * This has to be a valid
        * [ServingConfig][google.cloud.retail.v2alpha.ServingConfig]
-       * identifier. e.g. for a ServingConfig with full name:
-       * `projects/*/locations/global/catalogs/default_catalog/servingConfigs/my_candidate_config`
-       * this would be 'my_candidate_config'
+       * identifier. For example, for a ServingConfig with full name:
+       * `projects/*/locations/global/catalogs/default_catalog/servingConfigs/my_candidate_config`,
+       * this would be `my_candidate_config`.
        * 
      
        *
        * string serving_config_id = 1;
@@ -1522,9 +1522,9 @@ public CandidateCase getCandidateCase() {
        * 
              * This has to be a valid
        * [ServingConfig][google.cloud.retail.v2alpha.ServingConfig]
-       * identifier. e.g. for a ServingConfig with full name:
-       * `projects/*/locations/global/catalogs/default_catalog/servingConfigs/my_candidate_config`
-       * this would be 'my_candidate_config'
+       * identifier. For example, for a ServingConfig with full name:
+       * `projects/*/locations/global/catalogs/default_catalog/servingConfigs/my_candidate_config`,
+       * this would be `my_candidate_config`.
        * 
      
        *
        * string serving_config_id = 1;
@@ -1540,9 +1540,9 @@ public boolean hasServingConfigId() {
        * 
              * This has to be a valid
        * [ServingConfig][google.cloud.retail.v2alpha.ServingConfig]
-       * identifier. e.g. for a ServingConfig with full name:
-       * `projects/*/locations/global/catalogs/default_catalog/servingConfigs/my_candidate_config`
-       * this would be 'my_candidate_config'
+       * identifier. For example, for a ServingConfig with full name:
+       * `projects/*/locations/global/catalogs/default_catalog/servingConfigs/my_candidate_config`,
+       * this would be `my_candidate_config`.
        * 
      
        *
        * string serving_config_id = 1;
@@ -1571,9 +1571,9 @@ public java.lang.String getServingConfigId() {
        * 
              * This has to be a valid
        * [ServingConfig][google.cloud.retail.v2alpha.ServingConfig]
-       * identifier. e.g. for a ServingConfig with full name:
-       * `projects/*/locations/global/catalogs/default_catalog/servingConfigs/my_candidate_config`
-       * this would be 'my_candidate_config'
+       * identifier. For example, for a ServingConfig with full name:
+       * `projects/*/locations/global/catalogs/default_catalog/servingConfigs/my_candidate_config`,
+       * this would be `my_candidate_config`.
        * 
      
        *
        * string serving_config_id = 1;
@@ -1999,9 +1999,9 @@ public Builder clearCandidate() {
          * 
                * This has to be a valid
          * [ServingConfig][google.cloud.retail.v2alpha.ServingConfig]
-         * identifier. e.g. for a ServingConfig with full name:
-         * `projects/*/locations/global/catalogs/default_catalog/servingConfigs/my_candidate_config`
-         * this would be 'my_candidate_config'
+         * identifier. For example, for a ServingConfig with full name:
+         * `projects/*/locations/global/catalogs/default_catalog/servingConfigs/my_candidate_config`,
+         * this would be `my_candidate_config`.
          * 
      
          *
          * string serving_config_id = 1;
@@ -2018,9 +2018,9 @@ public boolean hasServingConfigId() {
          * 
                * This has to be a valid
          * [ServingConfig][google.cloud.retail.v2alpha.ServingConfig]
-         * identifier. e.g. for a ServingConfig with full name:
-         * `projects/*/locations/global/catalogs/default_catalog/servingConfigs/my_candidate_config`
-         * this would be 'my_candidate_config'
+         * identifier. For example, for a ServingConfig with full name:
+         * `projects/*/locations/global/catalogs/default_catalog/servingConfigs/my_candidate_config`,
+         * this would be `my_candidate_config`.
          * 
      
          *
          * string serving_config_id = 1;
@@ -2050,9 +2050,9 @@ public java.lang.String getServingConfigId() {
          * 
                * This has to be a valid
          * [ServingConfig][google.cloud.retail.v2alpha.ServingConfig]
-         * identifier. e.g. for a ServingConfig with full name:
-         * `projects/*/locations/global/catalogs/default_catalog/servingConfigs/my_candidate_config`
-         * this would be 'my_candidate_config'
+         * identifier. For example, for a ServingConfig with full name:
+         * `projects/*/locations/global/catalogs/default_catalog/servingConfigs/my_candidate_config`,
+         * this would be `my_candidate_config`.
          * 
      
          *
          * string serving_config_id = 1;
@@ -2082,9 +2082,9 @@ public com.google.protobuf.ByteString getServingConfigIdBytes() {
          * 
                * This has to be a valid
          * [ServingConfig][google.cloud.retail.v2alpha.ServingConfig]
-         * identifier. e.g. for a ServingConfig with full name:
-         * `projects/*/locations/global/catalogs/default_catalog/servingConfigs/my_candidate_config`
-         * this would be 'my_candidate_config'
+         * identifier. For example, for a ServingConfig with full name:
+         * `projects/*/locations/global/catalogs/default_catalog/servingConfigs/my_candidate_config`,
+         * this would be `my_candidate_config`.
          * 
      
          *
          * string serving_config_id = 1;
@@ -2107,9 +2107,9 @@ public Builder setServingConfigId(java.lang.String value) {
          * 
                * This has to be a valid
          * [ServingConfig][google.cloud.retail.v2alpha.ServingConfig]
-         * identifier. e.g. for a ServingConfig with full name:
-         * `projects/*/locations/global/catalogs/default_catalog/servingConfigs/my_candidate_config`
-         * this would be 'my_candidate_config'
+         * identifier. For example, for a ServingConfig with full name:
+         * `projects/*/locations/global/catalogs/default_catalog/servingConfigs/my_candidate_config`,
+         * this would be `my_candidate_config`.
          * 
      
          *
          * string serving_config_id = 1;
@@ -2130,9 +2130,9 @@ public Builder clearServingConfigId() {
          * 
                * This has to be a valid
          * [ServingConfig][google.cloud.retail.v2alpha.ServingConfig]
-         * identifier. e.g. for a ServingConfig with full name:
-         * `projects/*/locations/global/catalogs/default_catalog/servingConfigs/my_candidate_config`
-         * this would be 'my_candidate_config'
+         * identifier. For example, for a ServingConfig with full name:
+         * `projects/*/locations/global/catalogs/default_catalog/servingConfigs/my_candidate_config`,
+         * this would be `my_candidate_config`.
          * 
      
          *
          * string serving_config_id = 1;
@@ -2254,7 +2254,6 @@ public interface PanelOrBuilder
        *
        * 
              * Required. The candidates to consider on the panel.
-       * Limit = 10.
        * 
      
        *
        * 
@@ -2268,7 +2267,6 @@ public interface PanelOrBuilder
        *
        * 
              * Required. The candidates to consider on the panel.
-       * Limit = 10.
        * 
      
        *
        * 
@@ -2282,7 +2280,6 @@ com.google.cloud.retail.v2alpha.Model.PageOptimizationConfig.Candidate getCandid
        *
        * 
              * Required. The candidates to consider on the panel.
-       * Limit = 10.
        * 
      
        *
        * 
@@ -2295,7 +2292,6 @@ com.google.cloud.retail.v2alpha.Model.PageOptimizationConfig.Candidate getCandid
        *
        * 
              * Required. The candidates to consider on the panel.
-       * Limit = 10.
        * 
      
        *
        * 
@@ -2311,7 +2307,6 @@ com.google.cloud.retail.v2alpha.Model.PageOptimizationConfig.Candidate getCandid
        *
        * 
              * Required. The candidates to consider on the panel.
-       * Limit = 10.
        * 
      
        *
        * 
@@ -2325,8 +2320,8 @@ com.google.cloud.retail.v2alpha.Model.PageOptimizationConfig.Candidate getCandid
        *
        *
        * 
      -       * Required. The default candidate (in case the model fails at serving
-       * time, we can fall back to the default).
+       * Required. The default candidate. If the model fails at serving time,
+       * we fall back to the default.
        * 
      
        *
        * 
@@ -2340,8 +2335,8 @@ com.google.cloud.retail.v2alpha.Model.PageOptimizationConfig.Candidate getCandid
        *
        *
        * 
      -       * Required. The default candidate (in case the model fails at serving
-       * time, we can fall back to the default).
+       * Required. The default candidate. If the model fails at serving time,
+       * we fall back to the default.
        * 
      
        *
        * 
@@ -2355,8 +2350,8 @@ com.google.cloud.retail.v2alpha.Model.PageOptimizationConfig.Candidate getCandid
        *
        *
        * 
      -       * Required. The default candidate (in case the model fails at serving
-       * time, we can fall back to the default).
+       * Required. The default candidate. If the model fails at serving time,
+       * we fall back to the default.
        * 
      
        *
        * 
@@ -2475,7 +2470,6 @@ public com.google.protobuf.ByteString getDisplayNameBytes() {
        *
        * 
              * Required. The candidates to consider on the panel.
-       * Limit = 10.
        * 
      
        *
        * 
@@ -2492,7 +2486,6 @@ public com.google.protobuf.ByteString getDisplayNameBytes() {
        *
        * 
              * Required. The candidates to consider on the panel.
-       * Limit = 10.
        * 
      
        *
        * 
@@ -2511,7 +2504,6 @@ public com.google.protobuf.ByteString getDisplayNameBytes() {
        *
        * 
              * Required. The candidates to consider on the panel.
-       * Limit = 10.
        * 
      
        *
        * 
@@ -2527,7 +2519,6 @@ public int getCandidatesCount() {
        *
        * 
              * Required. The candidates to consider on the panel.
-       * Limit = 10.
        * 
      
        *
        * 
@@ -2544,7 +2535,6 @@ public com.google.cloud.retail.v2alpha.Model.PageOptimizationConfig.Candidate ge
        *
        * 
              * Required. The candidates to consider on the panel.
-       * Limit = 10.
        * 
      
        *
        * 
@@ -2564,8 +2554,8 @@ public com.google.cloud.retail.v2alpha.Model.PageOptimizationConfig.Candidate ge
        *
        *
        * 
      -       * Required. The default candidate (in case the model fails at serving
-       * time, we can fall back to the default).
+       * Required. The default candidate. If the model fails at serving time,
+       * we fall back to the default.
        * 
      
        *
        * 
@@ -2582,8 +2572,8 @@ public boolean hasDefaultCandidate() {
        *
        *
        * 
      -       * Required. The default candidate (in case the model fails at serving
-       * time, we can fall back to the default).
+       * Required. The default candidate. If the model fails at serving time,
+       * we fall back to the default.
        * 
      
        *
        * 
@@ -2604,8 +2594,8 @@ public boolean hasDefaultCandidate() {
        *
        *
        * 
      -       * Required. The default candidate (in case the model fails at serving
-       * time, we can fall back to the default).
+       * Required. The default candidate. If the model fails at serving time,
+       * we fall back to the default.
        * 
      
        *
        * 
@@ -3203,7 +3193,6 @@ private void ensureCandidatesIsMutable() {
          *
          * 
                * Required. The candidates to consider on the panel.
-         * Limit = 10.
          * 
      
          *
          * 
@@ -3224,7 +3213,6 @@ private void ensureCandidatesIsMutable() {
          *
          * 
                * Required. The candidates to consider on the panel.
-         * Limit = 10.
          * 
      
          *
          * 
@@ -3243,7 +3231,6 @@ public int getCandidatesCount() {
          *
          * 
                * Required. The candidates to consider on the panel.
-         * Limit = 10.
          * 
      
          *
          * 
@@ -3263,7 +3250,6 @@ public com.google.cloud.retail.v2alpha.Model.PageOptimizationConfig.Candidate ge
          *
          * 
                * Required. The candidates to consider on the panel.
-         * Limit = 10.
          * 
      
          *
          * 
@@ -3290,7 +3276,6 @@ public Builder setCandidates(
          *
          * 
                * Required. The candidates to consider on the panel.
-         * Limit = 10.
          * 
      
          *
          * 
@@ -3315,7 +3300,6 @@ public Builder setCandidates(
          *
          * 
                * Required. The candidates to consider on the panel.
-         * Limit = 10.
          * 
      
          *
          * 
@@ -3341,7 +3325,6 @@ public Builder addCandidates(
          *
          * 
                * Required. The candidates to consider on the panel.
-         * Limit = 10.
          * 
      
          *
          * 
@@ -3368,7 +3351,6 @@ public Builder addCandidates(
          *
          * 
                * Required. The candidates to consider on the panel.
-         * Limit = 10.
          * 
      
          *
          * 
@@ -3392,7 +3374,6 @@ public Builder addCandidates(
          *
          * 
                * Required. The candidates to consider on the panel.
-         * Limit = 10.
          * 
      
          *
          * 
@@ -3417,7 +3398,6 @@ public Builder addCandidates(
          *
          * 
                * Required. The candidates to consider on the panel.
-         * Limit = 10.
          * 
      
          *
          * 
@@ -3443,7 +3423,6 @@ public Builder addAllCandidates(
          *
          * 
                * Required. The candidates to consider on the panel.
-         * Limit = 10.
          * 
      
          *
          * 
@@ -3465,7 +3444,6 @@ public Builder clearCandidates() {
          *
          * 
                * Required. The candidates to consider on the panel.
-         * Limit = 10.
          * 
      
          *
          * 
@@ -3487,7 +3465,6 @@ public Builder removeCandidates(int index) {
          *
          * 
                * Required. The candidates to consider on the panel.
-         * Limit = 10.
          * 
      
          *
          * 
@@ -3503,7 +3480,6 @@ public Builder removeCandidates(int index) {
          *
          * 
                * Required. The candidates to consider on the panel.
-         * Limit = 10.
          * 
      
          *
          * 
@@ -3523,7 +3499,6 @@ public Builder removeCandidates(int index) {
          *
          * 
                * Required. The candidates to consider on the panel.
-         * Limit = 10.
          * 
      
          *
          * 
@@ -3545,7 +3520,6 @@ public Builder removeCandidates(int index) {
          *
          * 
                * Required. The candidates to consider on the panel.
-         * Limit = 10.
          * 
      
          *
          * 
@@ -3564,7 +3538,6 @@ public Builder removeCandidates(int index) {
          *
          * 
                * Required. The candidates to consider on the panel.
-         * Limit = 10.
          * 
      
          *
          * 
@@ -3584,7 +3557,6 @@ public Builder removeCandidates(int index) {
          *
          * 
                * Required. The candidates to consider on the panel.
-         * Limit = 10.
          * 
      
          *
          * 
@@ -3629,8 +3601,8 @@ public Builder removeCandidates(int index) {
          *
          *
          * 
      -         * Required. The default candidate (in case the model fails at serving
-         * time, we can fall back to the default).
+         * Required. The default candidate. If the model fails at serving time,
+         * we fall back to the default.
          * 
      
          *
          * 
@@ -3646,8 +3618,8 @@ public boolean hasDefaultCandidate() {
          *
          *
          * 
      -         * Required. The default candidate (in case the model fails at serving
-         * time, we can fall back to the default).
+         * Required. The default candidate. If the model fails at serving time,
+         * we fall back to the default.
          * 
      
          *
          * 
@@ -3671,8 +3643,8 @@ public boolean hasDefaultCandidate() {
          *
          *
          * 
      -         * Required. The default candidate (in case the model fails at serving
-         * time, we can fall back to the default).
+         * Required. The default candidate. If the model fails at serving time,
+         * we fall back to the default.
          * 
      
          *
          * 
@@ -3697,8 +3669,8 @@ public Builder setDefaultCandidate(
          *
          *
          * 
      -         * Required. The default candidate (in case the model fails at serving
-         * time, we can fall back to the default).
+         * Required. The default candidate. If the model fails at serving time,
+         * we fall back to the default.
          * 
      
          *
          * 
@@ -3721,8 +3693,8 @@ public Builder setDefaultCandidate(
          *
          *
          * 
      -         * Required. The default candidate (in case the model fails at serving
-         * time, we can fall back to the default).
+         * Required. The default candidate. If the model fails at serving time,
+         * we fall back to the default.
          * 
      
          *
          * 
@@ -3752,8 +3724,8 @@ public Builder mergeDefaultCandidate(
          *
          *
          * 
      -         * Required. The default candidate (in case the model fails at serving
-         * time, we can fall back to the default).
+         * Required. The default candidate. If the model fails at serving time,
+         * we fall back to the default.
          * 
      
          *
          * 
@@ -3775,8 +3747,8 @@ public Builder clearDefaultCandidate() {
          *
          *
          * 
      -         * Required. The default candidate (in case the model fails at serving
-         * time, we can fall back to the default).
+         * Required. The default candidate. If the model fails at serving time,
+         * we fall back to the default.
          * 
      
          *
          * 
@@ -3793,8 +3765,8 @@ public Builder clearDefaultCandidate() {
          *
          *
          * 
      -         * Required. The default candidate (in case the model fails at serving
-         * time, we can fall back to the default).
+         * Required. The default candidate. If the model fails at serving time,
+         * we fall back to the default.
          * 
      
          *
          * 
@@ -3816,8 +3788,8 @@ public Builder clearDefaultCandidate() {
          *
          *
          * 
      -         * Required. The default candidate (in case the model fails at serving
-         * time, we can fall back to the default).
+         * Required. The default candidate. If the model fails at serving time,
+         * we fall back to the default.
          * 
      
          *
          * 
@@ -4319,7 +4291,7 @@ protected Builder newBuilderForType(
      * 
            * The PageOptimizationConfig for model training.
      * This determines how many panels to optimize for, and which serving
-     * configurations to consider for each panel.
+     * configs to consider for each panel.
      * The purpose of this model is to optimize which
      * [ServingConfig][google.cloud.retail.v2alpha.ServingConfig] to show on which
      * panels in way that optimizes the visitors shopping journey.
@@ -5370,7 +5342,7 @@ public interface ServingConfigListOrBuilder
      *
      * 
            * Optional. A set of valid serving configs that may be used for
-     * PAGE_OPTIMIZATION.
+     * `PAGE_OPTIMIZATION`.
      * 
      
      *
      * repeated string serving_config_ids = 1 [(.google.api.field_behavior) = OPTIONAL];
@@ -5384,7 +5356,7 @@ public interface ServingConfigListOrBuilder
      *
      * 
            * Optional. A set of valid serving configs that may be used for
-     * PAGE_OPTIMIZATION.
+     * `PAGE_OPTIMIZATION`.
      * 
      
      *
      * repeated string serving_config_ids = 1 [(.google.api.field_behavior) = OPTIONAL];
@@ -5398,7 +5370,7 @@ public interface ServingConfigListOrBuilder
      *
      * 
            * Optional. A set of valid serving configs that may be used for
-     * PAGE_OPTIMIZATION.
+     * `PAGE_OPTIMIZATION`.
      * 
      
      *
      * repeated string serving_config_ids = 1 [(.google.api.field_behavior) = OPTIONAL];
@@ -5413,7 +5385,7 @@ public interface ServingConfigListOrBuilder
      *
      * 
            * Optional. A set of valid serving configs that may be used for
-     * PAGE_OPTIMIZATION.
+     * `PAGE_OPTIMIZATION`.
      * 
      
      *
      * repeated string serving_config_ids = 1 [(.google.api.field_behavior) = OPTIONAL];
@@ -5429,7 +5401,7 @@ public interface ServingConfigListOrBuilder
    *
    * 
          * Represents an ordered combination of valid serving configs, which
-   * / may be used for PAGE_OPTIMIZATION recommendations.
+   * can be used for `PAGE_OPTIMIZATION` recommendations.
    * 
      
    *
    * Protobuf type {@code google.cloud.retail.v2alpha.Model.ServingConfigList}
@@ -5481,7 +5453,7 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
      *
      * 
            * Optional. A set of valid serving configs that may be used for
-     * PAGE_OPTIMIZATION.
+     * `PAGE_OPTIMIZATION`.
      * 
      
      *
      * repeated string serving_config_ids = 1 [(.google.api.field_behavior) = OPTIONAL];
@@ -5497,7 +5469,7 @@ public com.google.protobuf.ProtocolStringList getServingConfigIdsList() {
      *
      * 
            * Optional. A set of valid serving configs that may be used for
-     * PAGE_OPTIMIZATION.
+     * `PAGE_OPTIMIZATION`.
      * 
      
      *
      * repeated string serving_config_ids = 1 [(.google.api.field_behavior) = OPTIONAL];
@@ -5513,7 +5485,7 @@ public int getServingConfigIdsCount() {
      *
      * 
            * Optional. A set of valid serving configs that may be used for
-     * PAGE_OPTIMIZATION.
+     * `PAGE_OPTIMIZATION`.
      * 
      
      *
      * repeated string serving_config_ids = 1 [(.google.api.field_behavior) = OPTIONAL];
@@ -5530,7 +5502,7 @@ public java.lang.String getServingConfigIds(int index) {
      *
      * 
            * Optional. A set of valid serving configs that may be used for
-     * PAGE_OPTIMIZATION.
+     * `PAGE_OPTIMIZATION`.
      * 
      
      *
      * repeated string serving_config_ids = 1 [(.google.api.field_behavior) = OPTIONAL];
@@ -5716,7 +5688,7 @@ protected Builder newBuilderForType(
      *
      * 
            * Represents an ordered combination of valid serving configs, which
-     * / may be used for PAGE_OPTIMIZATION recommendations.
+     * can be used for `PAGE_OPTIMIZATION` recommendations.
      * 
      
      *
      * Protobuf type {@code google.cloud.retail.v2alpha.Model.ServingConfigList}
@@ -5914,7 +5886,7 @@ private void ensureServingConfigIdsIsMutable() {
        *
        * 
              * Optional. A set of valid serving configs that may be used for
-       * PAGE_OPTIMIZATION.
+       * `PAGE_OPTIMIZATION`.
        * 
      
        *
        * repeated string serving_config_ids = 1 [(.google.api.field_behavior) = OPTIONAL];
@@ -5930,7 +5902,7 @@ public com.google.protobuf.ProtocolStringList getServingConfigIdsList() {
        *
        * 
              * Optional. A set of valid serving configs that may be used for
-       * PAGE_OPTIMIZATION.
+       * `PAGE_OPTIMIZATION`.
        * 
      
        *
        * repeated string serving_config_ids = 1 [(.google.api.field_behavior) = OPTIONAL];
@@ -5946,7 +5918,7 @@ public int getServingConfigIdsCount() {
        *
        * 
              * Optional. A set of valid serving configs that may be used for
-       * PAGE_OPTIMIZATION.
+       * `PAGE_OPTIMIZATION`.
        * 
      
        *
        * repeated string serving_config_ids = 1 [(.google.api.field_behavior) = OPTIONAL];
@@ -5963,7 +5935,7 @@ public java.lang.String getServingConfigIds(int index) {
        *
        * 
              * Optional. A set of valid serving configs that may be used for
-       * PAGE_OPTIMIZATION.
+       * `PAGE_OPTIMIZATION`.
        * 
      
        *
        * repeated string serving_config_ids = 1 [(.google.api.field_behavior) = OPTIONAL];
@@ -5980,7 +5952,7 @@ public com.google.protobuf.ByteString getServingConfigIdsBytes(int index) {
        *
        * 
              * Optional. A set of valid serving configs that may be used for
-       * PAGE_OPTIMIZATION.
+       * `PAGE_OPTIMIZATION`.
        * 
      
        *
        * repeated string serving_config_ids = 1 [(.google.api.field_behavior) = OPTIONAL];
@@ -6004,7 +5976,7 @@ public Builder setServingConfigIds(int index, java.lang.String value) {
        *
        * 
              * Optional. A set of valid serving configs that may be used for
-       * PAGE_OPTIMIZATION.
+       * `PAGE_OPTIMIZATION`.
        * 
      
        *
        * repeated string serving_config_ids = 1 [(.google.api.field_behavior) = OPTIONAL];
@@ -6027,7 +5999,7 @@ public Builder addServingConfigIds(java.lang.String value) {
        *
        * 
              * Optional. A set of valid serving configs that may be used for
-       * PAGE_OPTIMIZATION.
+       * `PAGE_OPTIMIZATION`.
        * 
      
        *
        * repeated string serving_config_ids = 1 [(.google.api.field_behavior) = OPTIONAL];
@@ -6047,7 +6019,7 @@ public Builder addAllServingConfigIds(java.lang.Iterable value
        *
        * 
              * Optional. A set of valid serving configs that may be used for
-       * PAGE_OPTIMIZATION.
+       * `PAGE_OPTIMIZATION`.
        * 
      
        *
        * repeated string serving_config_ids = 1 [(.google.api.field_behavior) = OPTIONAL];
@@ -6066,7 +6038,7 @@ public Builder clearServingConfigIds() {
        *
        * 
              * Optional. A set of valid serving configs that may be used for
-       * PAGE_OPTIMIZATION.
+       * `PAGE_OPTIMIZATION`.
        * 
      
        *
        * repeated string serving_config_ids = 1 [(.google.api.field_behavior) = OPTIONAL];
@@ -6260,7 +6232,7 @@ public com.google.cloud.retail.v2alpha.Model.PageOptimizationConfig getPageOptim
    * 
          * Required. The fully qualified resource name of the model.
    * Format:
-   * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}
+   * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}`
    * catalog_id has char limit of 50.
    * recommendation_model_id has char limit of 40.
    * 
      
@@ -6287,7 +6259,7 @@ public java.lang.String getName() {
    * 
          * Required. The fully qualified resource name of the model.
    * Format:
-   * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}
+   * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}`
    * catalog_id has char limit of 50.
    * recommendation_model_id has char limit of 40.
    * 
      
@@ -6317,7 +6289,7 @@ public com.google.protobuf.ByteString getNameBytes() {
    * 
          * Required. The display name of the model.
    * Should be human readable, used to display Recommendation Models in the
-   * Retail Cloud Cosole Dashboard. UTF-8 encoded string with limit of 1024
+   * Retail Cloud Console Dashboard. UTF-8 encoded string with limit of 1024
    * characters.
    * 
      
    *
@@ -6343,7 +6315,7 @@ public java.lang.String getDisplayName() {
    * 
          * Required. The display name of the model.
    * Should be human readable, used to display Recommendation Models in the
-   * Retail Cloud Cosole Dashboard. UTF-8 encoded string with limit of 1024
+   * Retail Cloud Console Dashboard. UTF-8 encoded string with limit of 1024
    * characters.
    * 
      
    *
@@ -6371,12 +6343,12 @@ public com.google.protobuf.ByteString getDisplayNameBytes() {
    *
    * 
          * Optional. The training state that the model is in (e.g.
-   * TRAINING or PAUSED).
+   * `TRAINING` or `PAUSED`).
    * Since part of the cost of running the service
    * is frequency of training - this can be used to determine when to train
    * model in order to control cost. If not specified: the default value for
-   * CreateModel method is TRAINING. the default value for
-   * UpdateModel method is to keep the state the same as before.
+   * `CreateModel` method is `TRAINING`. The default value for
+   * `UpdateModel` method is to keep the state the same as before.
    * 
      
    *
    * 
@@ -6394,12 +6366,12 @@ public int getTrainingStateValue() {
    *
    * 
          * Optional. The training state that the model is in (e.g.
-   * TRAINING or PAUSED).
+   * `TRAINING` or `PAUSED`).
    * Since part of the cost of running the service
    * is frequency of training - this can be used to determine when to train
    * model in order to control cost. If not specified: the default value for
-   * CreateModel method is TRAINING. the default value for
-   * UpdateModel method is to keep the state the same as before.
+   * `CreateModel` method is `TRAINING`. The default value for
+   * `UpdateModel` method is to keep the state the same as before.
    * 
      
    *
    * 
@@ -6424,7 +6396,7 @@ public com.google.cloud.retail.v2alpha.Model.TrainingState getTrainingState() {
    *
    *
    * 
      -   * Output only. The serving state of the model: ACTIVE, NOT_ACTIVE.
+   * Output only. The serving state of the model: `ACTIVE`, `NOT_ACTIVE`.
    * 
      
    *
    * 
@@ -6441,7 +6413,7 @@ public int getServingStateValue() {
    *
    *
    * 
      -   * Output only. The serving state of the model: ACTIVE, NOT_ACTIVE.
+   * Output only. The serving state of the model: `ACTIVE`, `NOT_ACTIVE`.
    * 
      
    *
    * 
@@ -6572,8 +6544,17 @@ public com.google.protobuf.TimestampOrBuilder getUpdateTimeOrBuilder() {
    * 
          * Required. The type of model e.g. `home-page`.
    * Currently supported values: `recommended-for-you`, `others-you-may-like`,
-   * `frequently-bought-together`, `page-optimization`, 'similar-items',
-   * 'buy-it-again', `recently-viewed`(readonly value).
+   * `frequently-bought-together`, `page-optimization`, `similar-items`,
+   * `buy-it-again`, `on-sale-items`, and `recently-viewed`(readonly value).
+   * This field together with
+   * [optimization_objective][google.cloud.retail.v2alpha.Model.optimization_objective]
+   * describe model metadata to use to control model training and serving.
+   * See https://cloud.google.com/retail/docs/models
+   * for more details on what the model metadata control and which combination
+   * of parameters are valid. For invalid combinations of parameters (e.g. type
+   * = `frequently-bought-together` and optimization_objective = `ctr`), you
+   * receive an error 400 if you try to create/update a recommendation with
+   * this set of knobs.
    * 
      
    *
    * string type = 7 [(.google.api.field_behavior) = REQUIRED];
@@ -6598,8 +6579,17 @@ public java.lang.String getType() {
    * 
          * Required. The type of model e.g. `home-page`.
    * Currently supported values: `recommended-for-you`, `others-you-may-like`,
-   * `frequently-bought-together`, `page-optimization`, 'similar-items',
-   * 'buy-it-again', `recently-viewed`(readonly value).
+   * `frequently-bought-together`, `page-optimization`, `similar-items`,
+   * `buy-it-again`, `on-sale-items`, and `recently-viewed`(readonly value).
+   * This field together with
+   * [optimization_objective][google.cloud.retail.v2alpha.Model.optimization_objective]
+   * describe model metadata to use to control model training and serving.
+   * See https://cloud.google.com/retail/docs/models
+   * for more details on what the model metadata control and which combination
+   * of parameters are valid. For invalid combinations of parameters (e.g. type
+   * = `frequently-bought-together` and optimization_objective = `ctr`), you
+   * receive an error 400 if you try to create/update a recommendation with
+   * this set of knobs.
    * 
      
    *
    * string type = 7 [(.google.api.field_behavior) = REQUIRED];
@@ -6633,6 +6623,15 @@ public com.google.protobuf.ByteString getTypeBytes() {
    * `recommended-for-you` => `ctr`
    * `others-you-may-like` => `ctr`
    * `frequently-bought-together` => `revenue_per_order`
+   * This field together with
+   * [optimization_objective][google.cloud.retail.v2alpha.Model.type]
+   * describe model metadata to use to control model training and serving.
+   * See https://cloud.google.com/retail/docs/models
+   * for more details on what the model metadata control and which combination
+   * of parameters are valid. For invalid combinations of parameters (e.g. type
+   * = `frequently-bought-together` and optimization_objective = `ctr`), you
+   * receive an error 400 if you try to create/update a recommendation with
+   * this set of knobs.
    * 
      
    *
    * string optimization_objective = 8 [(.google.api.field_behavior) = OPTIONAL];
@@ -6663,6 +6662,15 @@ public java.lang.String getOptimizationObjective() {
    * `recommended-for-you` => `ctr`
    * `others-you-may-like` => `ctr`
    * `frequently-bought-together` => `revenue_per_order`
+   * This field together with
+   * [optimization_objective][google.cloud.retail.v2alpha.Model.type]
+   * describe model metadata to use to control model training and serving.
+   * See https://cloud.google.com/retail/docs/models
+   * for more details on what the model metadata control and which combination
+   * of parameters are valid. For invalid combinations of parameters (e.g. type
+   * = `frequently-bought-together` and optimization_objective = `ctr`), you
+   * receive an error 400 if you try to create/update a recommendation with
+   * this set of knobs.
    * 
      
    *
    * string optimization_objective = 8 [(.google.api.field_behavior) = OPTIONAL];
@@ -6690,8 +6698,8 @@ public com.google.protobuf.ByteString getOptimizationObjectiveBytes() {
    * 
          * Optional. The state of periodic tuning.
    * The period we use is 3 months - to do a
-   * one-off tune earlier use the TuneModel method. Default value
-   * is PERIODIC_TUNING_ENABLED.
+   * one-off tune earlier use the `TuneModel` method. Default value
+   * is `PERIODIC_TUNING_ENABLED`.
    * 
      
    *
    * 
@@ -6710,8 +6718,8 @@ public int getPeriodicTuningStateValue() {
    * 
          * Optional. The state of periodic tuning.
    * The period we use is 3 months - to do a
-   * one-off tune earlier use the TuneModel method. Default value
-   * is PERIODIC_TUNING_ENABLED.
+   * one-off tune earlier use the `TuneModel` method. Default value
+   * is `PERIODIC_TUNING_ENABLED`.
    * 
      
    *
    * 
@@ -6843,11 +6851,11 @@ public com.google.protobuf.ByteString getTuningOperationBytes() {
    *
    *
    * 
      -   * Output only. The state of data requirements for this model: DATA_OK and
-   * DATA_ERROR.
+   * Output only. The state of data requirements for this model: `DATA_OK` and
+   * `DATA_ERROR`.
    * Recommendation model cannot be trained if the data is in
-   * DATA_ERROR state. Recommendation model can have DATA_ERROR state even if
-   * serving state is ACTIVE: models were trained successfully before, but
+   * `DATA_ERROR` state. Recommendation model can have `DATA_ERROR` state even
+   * if serving state is `ACTIVE`: models were trained successfully before, but
    * cannot be refreshed because model no longer has sufficient
    * data for training.
    * 
      
@@ -6866,11 +6874,11 @@ public int getDataStateValue() {
    *
    *
    * 
      -   * Output only. The state of data requirements for this model: DATA_OK and
-   * DATA_ERROR.
+   * Output only. The state of data requirements for this model: `DATA_OK` and
+   * `DATA_ERROR`.
    * Recommendation model cannot be trained if the data is in
-   * DATA_ERROR state. Recommendation model can have DATA_ERROR state even if
-   * serving state is ACTIVE: models were trained successfully before, but
+   * `DATA_ERROR` state. Recommendation model can have `DATA_ERROR` state even
+   * if serving state is `ACTIVE`: models were trained successfully before, but
    * cannot be refreshed because model no longer has sufficient
    * data for training.
    * 
      
@@ -6895,8 +6903,8 @@ public com.google.cloud.retail.v2alpha.Model.DataState getDataState() {
    *
    *
    * 
      -   * Optional. If RECOMMENDATIONS_FILTERING_ENABLED, recommendation filtering by
-   * attributes is enabled for the model.
+   * Optional. If `RECOMMENDATIONS_FILTERING_ENABLED`, recommendation filtering
+   * by attributes is enabled for the model.
    * 
      
    *
    * 
@@ -6913,8 +6921,8 @@ public int getFilteringOptionValue() {
    *
    *
    * 
      -   * Optional. If RECOMMENDATIONS_FILTERING_ENABLED, recommendation filtering by
-   * attributes is enabled for the model.
+   * Optional. If `RECOMMENDATIONS_FILTERING_ENABLED`, recommendation filtering
+   * by attributes is enabled for the model.
    * 
      
    *
    * 
@@ -7367,7 +7375,7 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
    * [Model][google.cloud.retail.v2alpha.Model]. A
    * [Model][google.cloud.retail.v2alpha.Model] can be associated with a
    * [ServingConfig][google.cloud.retail.v2alpha.ServingConfig] and then queried
-   * through the Predict api.
+   * through the Predict API.
    * 
      
    *
    * Protobuf type {@code google.cloud.retail.v2alpha.Model}
@@ -8054,7 +8062,7 @@ public Builder clearPageOptimizationConfig() {
      * 
            * Required. The fully qualified resource name of the model.
      * Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}`
      * catalog_id has char limit of 50.
      * recommendation_model_id has char limit of 40.
      * 
      
@@ -8080,7 +8088,7 @@ public java.lang.String getName() {
      * 
            * Required. The fully qualified resource name of the model.
      * Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}`
      * catalog_id has char limit of 50.
      * recommendation_model_id has char limit of 40.
      * 
      
@@ -8106,7 +8114,7 @@ public com.google.protobuf.ByteString getNameBytes() {
      * 
            * Required. The fully qualified resource name of the model.
      * Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}`
      * catalog_id has char limit of 50.
      * recommendation_model_id has char limit of 40.
      * 
      
@@ -8131,7 +8139,7 @@ public Builder setName(java.lang.String value) {
      * 
            * Required. The fully qualified resource name of the model.
      * Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}`
      * catalog_id has char limit of 50.
      * recommendation_model_id has char limit of 40.
      * 
      
@@ -8152,7 +8160,7 @@ public Builder clearName() {
      * 
            * Required. The fully qualified resource name of the model.
      * Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}`
      * catalog_id has char limit of 50.
      * recommendation_model_id has char limit of 40.
      * 
      
@@ -8180,7 +8188,7 @@ public Builder setNameBytes(com.google.protobuf.ByteString value) {
      * 
            * Required. The display name of the model.
      * Should be human readable, used to display Recommendation Models in the
-     * Retail Cloud Cosole Dashboard. UTF-8 encoded string with limit of 1024
+     * Retail Cloud Console Dashboard. UTF-8 encoded string with limit of 1024
      * characters.
      * 
      
      *
@@ -8205,7 +8213,7 @@ public java.lang.String getDisplayName() {
      * 
            * Required. The display name of the model.
      * Should be human readable, used to display Recommendation Models in the
-     * Retail Cloud Cosole Dashboard. UTF-8 encoded string with limit of 1024
+     * Retail Cloud Console Dashboard. UTF-8 encoded string with limit of 1024
      * characters.
      * 
      
      *
@@ -8230,7 +8238,7 @@ public com.google.protobuf.ByteString getDisplayNameBytes() {
      * 
            * Required. The display name of the model.
      * Should be human readable, used to display Recommendation Models in the
-     * Retail Cloud Cosole Dashboard. UTF-8 encoded string with limit of 1024
+     * Retail Cloud Console Dashboard. UTF-8 encoded string with limit of 1024
      * characters.
      * 
      
      *
@@ -8254,7 +8262,7 @@ public Builder setDisplayName(java.lang.String value) {
      * 
            * Required. The display name of the model.
      * Should be human readable, used to display Recommendation Models in the
-     * Retail Cloud Cosole Dashboard. UTF-8 encoded string with limit of 1024
+     * Retail Cloud Console Dashboard. UTF-8 encoded string with limit of 1024
      * characters.
      * 
      
      *
@@ -8274,7 +8282,7 @@ public Builder clearDisplayName() {
      * 
            * Required. The display name of the model.
      * Should be human readable, used to display Recommendation Models in the
-     * Retail Cloud Cosole Dashboard. UTF-8 encoded string with limit of 1024
+     * Retail Cloud Console Dashboard. UTF-8 encoded string with limit of 1024
      * characters.
      * 
      
      *
@@ -8300,12 +8308,12 @@ public Builder setDisplayNameBytes(com.google.protobuf.ByteString value) {
      *
      * 
            * Optional. The training state that the model is in (e.g.
-     * TRAINING or PAUSED).
+     * `TRAINING` or `PAUSED`).
      * Since part of the cost of running the service
      * is frequency of training - this can be used to determine when to train
      * model in order to control cost. If not specified: the default value for
-     * CreateModel method is TRAINING. the default value for
-     * UpdateModel method is to keep the state the same as before.
+     * `CreateModel` method is `TRAINING`. The default value for
+     * `UpdateModel` method is to keep the state the same as before.
      * 
      
      *
      * 
@@ -8323,12 +8331,12 @@ public int getTrainingStateValue() {
      *
      * 
            * Optional. The training state that the model is in (e.g.
-     * TRAINING or PAUSED).
+     * `TRAINING` or `PAUSED`).
      * Since part of the cost of running the service
      * is frequency of training - this can be used to determine when to train
      * model in order to control cost. If not specified: the default value for
-     * CreateModel method is TRAINING. the default value for
-     * UpdateModel method is to keep the state the same as before.
+     * `CreateModel` method is `TRAINING`. The default value for
+     * `UpdateModel` method is to keep the state the same as before.
      * 
      
      *
      * 
@@ -8349,12 +8357,12 @@ public Builder setTrainingStateValue(int value) {
      *
      * 
            * Optional. The training state that the model is in (e.g.
-     * TRAINING or PAUSED).
+     * `TRAINING` or `PAUSED`).
      * Since part of the cost of running the service
      * is frequency of training - this can be used to determine when to train
      * model in order to control cost. If not specified: the default value for
-     * CreateModel method is TRAINING. the default value for
-     * UpdateModel method is to keep the state the same as before.
+     * `CreateModel` method is `TRAINING`. The default value for
+     * `UpdateModel` method is to keep the state the same as before.
      * 
      
      *
      * 
@@ -8377,12 +8385,12 @@ public com.google.cloud.retail.v2alpha.Model.TrainingState getTrainingState() {
      *
      * 
            * Optional. The training state that the model is in (e.g.
-     * TRAINING or PAUSED).
+     * `TRAINING` or `PAUSED`).
      * Since part of the cost of running the service
      * is frequency of training - this can be used to determine when to train
      * model in order to control cost. If not specified: the default value for
-     * CreateModel method is TRAINING. the default value for
-     * UpdateModel method is to keep the state the same as before.
+     * `CreateModel` method is `TRAINING`. The default value for
+     * `UpdateModel` method is to keep the state the same as before.
      * 
      
      *
      * 
@@ -8406,12 +8414,12 @@ public Builder setTrainingState(com.google.cloud.retail.v2alpha.Model.TrainingSt
      *
      * 
            * Optional. The training state that the model is in (e.g.
-     * TRAINING or PAUSED).
+     * `TRAINING` or `PAUSED`).
      * Since part of the cost of running the service
      * is frequency of training - this can be used to determine when to train
      * model in order to control cost. If not specified: the default value for
-     * CreateModel method is TRAINING. the default value for
-     * UpdateModel method is to keep the state the same as before.
+     * `CreateModel` method is `TRAINING`. The default value for
+     * `UpdateModel` method is to keep the state the same as before.
      * 
      
      *
      * 
@@ -8432,7 +8440,7 @@ public Builder clearTrainingState() {
      *
      *
      * 
      -     * Output only. The serving state of the model: ACTIVE, NOT_ACTIVE.
+     * Output only. The serving state of the model: `ACTIVE`, `NOT_ACTIVE`.
      * 
      
      *
      * 
@@ -8449,7 +8457,7 @@ public int getServingStateValue() {
      *
      *
      * 
      -     * Output only. The serving state of the model: ACTIVE, NOT_ACTIVE.
+     * Output only. The serving state of the model: `ACTIVE`, `NOT_ACTIVE`.
      * 
      
      *
      * 
@@ -8469,7 +8477,7 @@ public Builder setServingStateValue(int value) {
      *
      *
      * 
      -     * Output only. The serving state of the model: ACTIVE, NOT_ACTIVE.
+     * Output only. The serving state of the model: `ACTIVE`, `NOT_ACTIVE`.
      * 
      
      *
      * 
@@ -8491,7 +8499,7 @@ public com.google.cloud.retail.v2alpha.Model.ServingState getServingState() {
      *
      *
      * 
      -     * Output only. The serving state of the model: ACTIVE, NOT_ACTIVE.
+     * Output only. The serving state of the model: `ACTIVE`, `NOT_ACTIVE`.
      * 
      
      *
      * 
@@ -8514,7 +8522,7 @@ public Builder setServingState(com.google.cloud.retail.v2alpha.Model.ServingStat
      *
      *
      * 
      -     * Output only. The serving state of the model: ACTIVE, NOT_ACTIVE.
+     * Output only. The serving state of the model: `ACTIVE`, `NOT_ACTIVE`.
      * 
      
      *
      * 
@@ -8957,8 +8965,17 @@ public com.google.protobuf.TimestampOrBuilder getUpdateTimeOrBuilder() {
      * 
            * Required. The type of model e.g. `home-page`.
      * Currently supported values: `recommended-for-you`, `others-you-may-like`,
-     * `frequently-bought-together`, `page-optimization`, 'similar-items',
-     * 'buy-it-again', `recently-viewed`(readonly value).
+     * `frequently-bought-together`, `page-optimization`, `similar-items`,
+     * `buy-it-again`, `on-sale-items`, and `recently-viewed`(readonly value).
+     * This field together with
+     * [optimization_objective][google.cloud.retail.v2alpha.Model.optimization_objective]
+     * describe model metadata to use to control model training and serving.
+     * See https://cloud.google.com/retail/docs/models
+     * for more details on what the model metadata control and which combination
+     * of parameters are valid. For invalid combinations of parameters (e.g. type
+     * = `frequently-bought-together` and optimization_objective = `ctr`), you
+     * receive an error 400 if you try to create/update a recommendation with
+     * this set of knobs.
      * 
      
      *
      * string type = 7 [(.google.api.field_behavior) = REQUIRED];
@@ -8982,8 +8999,17 @@ public java.lang.String getType() {
      * 
            * Required. The type of model e.g. `home-page`.
      * Currently supported values: `recommended-for-you`, `others-you-may-like`,
-     * `frequently-bought-together`, `page-optimization`, 'similar-items',
-     * 'buy-it-again', `recently-viewed`(readonly value).
+     * `frequently-bought-together`, `page-optimization`, `similar-items`,
+     * `buy-it-again`, `on-sale-items`, and `recently-viewed`(readonly value).
+     * This field together with
+     * [optimization_objective][google.cloud.retail.v2alpha.Model.optimization_objective]
+     * describe model metadata to use to control model training and serving.
+     * See https://cloud.google.com/retail/docs/models
+     * for more details on what the model metadata control and which combination
+     * of parameters are valid. For invalid combinations of parameters (e.g. type
+     * = `frequently-bought-together` and optimization_objective = `ctr`), you
+     * receive an error 400 if you try to create/update a recommendation with
+     * this set of knobs.
      * 
      
      *
      * string type = 7 [(.google.api.field_behavior) = REQUIRED];
@@ -9007,8 +9033,17 @@ public com.google.protobuf.ByteString getTypeBytes() {
      * 
            * Required. The type of model e.g. `home-page`.
      * Currently supported values: `recommended-for-you`, `others-you-may-like`,
-     * `frequently-bought-together`, `page-optimization`, 'similar-items',
-     * 'buy-it-again', `recently-viewed`(readonly value).
+     * `frequently-bought-together`, `page-optimization`, `similar-items`,
+     * `buy-it-again`, `on-sale-items`, and `recently-viewed`(readonly value).
+     * This field together with
+     * [optimization_objective][google.cloud.retail.v2alpha.Model.optimization_objective]
+     * describe model metadata to use to control model training and serving.
+     * See https://cloud.google.com/retail/docs/models
+     * for more details on what the model metadata control and which combination
+     * of parameters are valid. For invalid combinations of parameters (e.g. type
+     * = `frequently-bought-together` and optimization_objective = `ctr`), you
+     * receive an error 400 if you try to create/update a recommendation with
+     * this set of knobs.
      * 
      
      *
      * string type = 7 [(.google.api.field_behavior) = REQUIRED];
@@ -9031,8 +9066,17 @@ public Builder setType(java.lang.String value) {
      * 
            * Required. The type of model e.g. `home-page`.
      * Currently supported values: `recommended-for-you`, `others-you-may-like`,
-     * `frequently-bought-together`, `page-optimization`, 'similar-items',
-     * 'buy-it-again', `recently-viewed`(readonly value).
+     * `frequently-bought-together`, `page-optimization`, `similar-items`,
+     * `buy-it-again`, `on-sale-items`, and `recently-viewed`(readonly value).
+     * This field together with
+     * [optimization_objective][google.cloud.retail.v2alpha.Model.optimization_objective]
+     * describe model metadata to use to control model training and serving.
+     * See https://cloud.google.com/retail/docs/models
+     * for more details on what the model metadata control and which combination
+     * of parameters are valid. For invalid combinations of parameters (e.g. type
+     * = `frequently-bought-together` and optimization_objective = `ctr`), you
+     * receive an error 400 if you try to create/update a recommendation with
+     * this set of knobs.
      * 
      
      *
      * string type = 7 [(.google.api.field_behavior) = REQUIRED];
@@ -9051,8 +9095,17 @@ public Builder clearType() {
      * 
            * Required. The type of model e.g. `home-page`.
      * Currently supported values: `recommended-for-you`, `others-you-may-like`,
-     * `frequently-bought-together`, `page-optimization`, 'similar-items',
-     * 'buy-it-again', `recently-viewed`(readonly value).
+     * `frequently-bought-together`, `page-optimization`, `similar-items`,
+     * `buy-it-again`, `on-sale-items`, and `recently-viewed`(readonly value).
+     * This field together with
+     * [optimization_objective][google.cloud.retail.v2alpha.Model.optimization_objective]
+     * describe model metadata to use to control model training and serving.
+     * See https://cloud.google.com/retail/docs/models
+     * for more details on what the model metadata control and which combination
+     * of parameters are valid. For invalid combinations of parameters (e.g. type
+     * = `frequently-bought-together` and optimization_objective = `ctr`), you
+     * receive an error 400 if you try to create/update a recommendation with
+     * this set of knobs.
      * 
      
      *
      * string type = 7 [(.google.api.field_behavior) = REQUIRED];
@@ -9084,6 +9137,15 @@ public Builder setTypeBytes(com.google.protobuf.ByteString value) {
      * `recommended-for-you` => `ctr`
      * `others-you-may-like` => `ctr`
      * `frequently-bought-together` => `revenue_per_order`
+     * This field together with
+     * [optimization_objective][google.cloud.retail.v2alpha.Model.type]
+     * describe model metadata to use to control model training and serving.
+     * See https://cloud.google.com/retail/docs/models
+     * for more details on what the model metadata control and which combination
+     * of parameters are valid. For invalid combinations of parameters (e.g. type
+     * = `frequently-bought-together` and optimization_objective = `ctr`), you
+     * receive an error 400 if you try to create/update a recommendation with
+     * this set of knobs.
      * 
      
      *
      * string optimization_objective = 8 [(.google.api.field_behavior) = OPTIONAL];
@@ -9113,6 +9175,15 @@ public java.lang.String getOptimizationObjective() {
      * `recommended-for-you` => `ctr`
      * `others-you-may-like` => `ctr`
      * `frequently-bought-together` => `revenue_per_order`
+     * This field together with
+     * [optimization_objective][google.cloud.retail.v2alpha.Model.type]
+     * describe model metadata to use to control model training and serving.
+     * See https://cloud.google.com/retail/docs/models
+     * for more details on what the model metadata control and which combination
+     * of parameters are valid. For invalid combinations of parameters (e.g. type
+     * = `frequently-bought-together` and optimization_objective = `ctr`), you
+     * receive an error 400 if you try to create/update a recommendation with
+     * this set of knobs.
      * 
      
      *
      * string optimization_objective = 8 [(.google.api.field_behavior) = OPTIONAL];
@@ -9142,6 +9213,15 @@ public com.google.protobuf.ByteString getOptimizationObjectiveBytes() {
      * `recommended-for-you` => `ctr`
      * `others-you-may-like` => `ctr`
      * `frequently-bought-together` => `revenue_per_order`
+     * This field together with
+     * [optimization_objective][google.cloud.retail.v2alpha.Model.type]
+     * describe model metadata to use to control model training and serving.
+     * See https://cloud.google.com/retail/docs/models
+     * for more details on what the model metadata control and which combination
+     * of parameters are valid. For invalid combinations of parameters (e.g. type
+     * = `frequently-bought-together` and optimization_objective = `ctr`), you
+     * receive an error 400 if you try to create/update a recommendation with
+     * this set of knobs.
      * 
      
      *
      * string optimization_objective = 8 [(.google.api.field_behavior) = OPTIONAL];
@@ -9170,6 +9250,15 @@ public Builder setOptimizationObjective(java.lang.String value) {
      * `recommended-for-you` => `ctr`
      * `others-you-may-like` => `ctr`
      * `frequently-bought-together` => `revenue_per_order`
+     * This field together with
+     * [optimization_objective][google.cloud.retail.v2alpha.Model.type]
+     * describe model metadata to use to control model training and serving.
+     * See https://cloud.google.com/retail/docs/models
+     * for more details on what the model metadata control and which combination
+     * of parameters are valid. For invalid combinations of parameters (e.g. type
+     * = `frequently-bought-together` and optimization_objective = `ctr`), you
+     * receive an error 400 if you try to create/update a recommendation with
+     * this set of knobs.
      * 
      
      *
      * string optimization_objective = 8 [(.google.api.field_behavior) = OPTIONAL];
@@ -9194,6 +9283,15 @@ public Builder clearOptimizationObjective() {
      * `recommended-for-you` => `ctr`
      * `others-you-may-like` => `ctr`
      * `frequently-bought-together` => `revenue_per_order`
+     * This field together with
+     * [optimization_objective][google.cloud.retail.v2alpha.Model.type]
+     * describe model metadata to use to control model training and serving.
+     * See https://cloud.google.com/retail/docs/models
+     * for more details on what the model metadata control and which combination
+     * of parameters are valid. For invalid combinations of parameters (e.g. type
+     * = `frequently-bought-together` and optimization_objective = `ctr`), you
+     * receive an error 400 if you try to create/update a recommendation with
+     * this set of knobs.
      * 
      
      *
      * string optimization_objective = 8 [(.google.api.field_behavior) = OPTIONAL];
@@ -9219,8 +9317,8 @@ public Builder setOptimizationObjectiveBytes(com.google.protobuf.ByteString valu
      * 
            * Optional. The state of periodic tuning.
      * The period we use is 3 months - to do a
-     * one-off tune earlier use the TuneModel method. Default value
-     * is PERIODIC_TUNING_ENABLED.
+     * one-off tune earlier use the `TuneModel` method. Default value
+     * is `PERIODIC_TUNING_ENABLED`.
      * 
      
      *
      * 
@@ -9239,8 +9337,8 @@ public int getPeriodicTuningStateValue() {
      * 
            * Optional. The state of periodic tuning.
      * The period we use is 3 months - to do a
-     * one-off tune earlier use the TuneModel method. Default value
-     * is PERIODIC_TUNING_ENABLED.
+     * one-off tune earlier use the `TuneModel` method. Default value
+     * is `PERIODIC_TUNING_ENABLED`.
      * 
      
      *
      * 
@@ -9262,8 +9360,8 @@ public Builder setPeriodicTuningStateValue(int value) {
      * 
            * Optional. The state of periodic tuning.
      * The period we use is 3 months - to do a
-     * one-off tune earlier use the TuneModel method. Default value
-     * is PERIODIC_TUNING_ENABLED.
+     * one-off tune earlier use the `TuneModel` method. Default value
+     * is `PERIODIC_TUNING_ENABLED`.
      * 
      
      *
      * 
@@ -9287,8 +9385,8 @@ public com.google.cloud.retail.v2alpha.Model.PeriodicTuningState getPeriodicTuni
      * 
            * Optional. The state of periodic tuning.
      * The period we use is 3 months - to do a
-     * one-off tune earlier use the TuneModel method. Default value
-     * is PERIODIC_TUNING_ENABLED.
+     * one-off tune earlier use the `TuneModel` method. Default value
+     * is `PERIODIC_TUNING_ENABLED`.
      * 
      
      *
      * 
@@ -9314,8 +9412,8 @@ public Builder setPeriodicTuningState(
      * 
            * Optional. The state of periodic tuning.
      * The period we use is 3 months - to do a
-     * one-off tune earlier use the TuneModel method. Default value
-     * is PERIODIC_TUNING_ENABLED.
+     * one-off tune earlier use the `TuneModel` method. Default value
+     * is `PERIODIC_TUNING_ENABLED`.
      * 
      
      *
      * 
@@ -9655,11 +9753,11 @@ public Builder setTuningOperationBytes(com.google.protobuf.ByteString value) {
      *
      *
      * 
      -     * Output only. The state of data requirements for this model: DATA_OK and
-     * DATA_ERROR.
+     * Output only. The state of data requirements for this model: `DATA_OK` and
+     * `DATA_ERROR`.
      * Recommendation model cannot be trained if the data is in
-     * DATA_ERROR state. Recommendation model can have DATA_ERROR state even if
-     * serving state is ACTIVE: models were trained successfully before, but
+     * `DATA_ERROR` state. Recommendation model can have `DATA_ERROR` state even
+     * if serving state is `ACTIVE`: models were trained successfully before, but
      * cannot be refreshed because model no longer has sufficient
      * data for training.
      * 
      
@@ -9678,11 +9776,11 @@ public int getDataStateValue() {
      *
      *
      * 
      -     * Output only. The state of data requirements for this model: DATA_OK and
-     * DATA_ERROR.
+     * Output only. The state of data requirements for this model: `DATA_OK` and
+     * `DATA_ERROR`.
      * Recommendation model cannot be trained if the data is in
-     * DATA_ERROR state. Recommendation model can have DATA_ERROR state even if
-     * serving state is ACTIVE: models were trained successfully before, but
+     * `DATA_ERROR` state. Recommendation model can have `DATA_ERROR` state even
+     * if serving state is `ACTIVE`: models were trained successfully before, but
      * cannot be refreshed because model no longer has sufficient
      * data for training.
      * 
      
@@ -9704,11 +9802,11 @@ public Builder setDataStateValue(int value) {
      *
      *
      * 
      -     * Output only. The state of data requirements for this model: DATA_OK and
-     * DATA_ERROR.
+     * Output only. The state of data requirements for this model: `DATA_OK` and
+     * `DATA_ERROR`.
      * Recommendation model cannot be trained if the data is in
-     * DATA_ERROR state. Recommendation model can have DATA_ERROR state even if
-     * serving state is ACTIVE: models were trained successfully before, but
+     * `DATA_ERROR` state. Recommendation model can have `DATA_ERROR` state even
+     * if serving state is `ACTIVE`: models were trained successfully before, but
      * cannot be refreshed because model no longer has sufficient
      * data for training.
      * 
      
@@ -9730,11 +9828,11 @@ public com.google.cloud.retail.v2alpha.Model.DataState getDataState() {
      *
      *
      * 
      -     * Output only. The state of data requirements for this model: DATA_OK and
-     * DATA_ERROR.
+     * Output only. The state of data requirements for this model: `DATA_OK` and
+     * `DATA_ERROR`.
      * Recommendation model cannot be trained if the data is in
-     * DATA_ERROR state. Recommendation model can have DATA_ERROR state even if
-     * serving state is ACTIVE: models were trained successfully before, but
+     * `DATA_ERROR` state. Recommendation model can have `DATA_ERROR` state even
+     * if serving state is `ACTIVE`: models were trained successfully before, but
      * cannot be refreshed because model no longer has sufficient
      * data for training.
      * 
      
@@ -9759,11 +9857,11 @@ public Builder setDataState(com.google.cloud.retail.v2alpha.Model.DataState valu
      *
      *
      * 
      -     * Output only. The state of data requirements for this model: DATA_OK and
-     * DATA_ERROR.
+     * Output only. The state of data requirements for this model: `DATA_OK` and
+     * `DATA_ERROR`.
      * Recommendation model cannot be trained if the data is in
-     * DATA_ERROR state. Recommendation model can have DATA_ERROR state even if
-     * serving state is ACTIVE: models were trained successfully before, but
+     * `DATA_ERROR` state. Recommendation model can have `DATA_ERROR` state even
+     * if serving state is `ACTIVE`: models were trained successfully before, but
      * cannot be refreshed because model no longer has sufficient
      * data for training.
      * 
      
@@ -9786,8 +9884,8 @@ public Builder clearDataState() {
      *
      *
      * 
      -     * Optional. If RECOMMENDATIONS_FILTERING_ENABLED, recommendation filtering by
-     * attributes is enabled for the model.
+     * Optional. If `RECOMMENDATIONS_FILTERING_ENABLED`, recommendation filtering
+     * by attributes is enabled for the model.
      * 
      
      *
      * 
@@ -9804,8 +9902,8 @@ public int getFilteringOptionValue() {
      *
      *
      * 
      -     * Optional. If RECOMMENDATIONS_FILTERING_ENABLED, recommendation filtering by
-     * attributes is enabled for the model.
+     * Optional. If `RECOMMENDATIONS_FILTERING_ENABLED`, recommendation filtering
+     * by attributes is enabled for the model.
      * 
      
      *
      * 
@@ -9825,8 +9923,8 @@ public Builder setFilteringOptionValue(int value) {
      *
      *
      * 
      -     * Optional. If RECOMMENDATIONS_FILTERING_ENABLED, recommendation filtering by
-     * attributes is enabled for the model.
+     * Optional. If `RECOMMENDATIONS_FILTERING_ENABLED`, recommendation filtering
+     * by attributes is enabled for the model.
      * 
      
      *
      * 
@@ -9848,8 +9946,8 @@ public com.google.cloud.retail.v2alpha.RecommendationsFilteringOption getFilteri
      *
      *
      * 
      -     * Optional. If RECOMMENDATIONS_FILTERING_ENABLED, recommendation filtering by
-     * attributes is enabled for the model.
+     * Optional. If `RECOMMENDATIONS_FILTERING_ENABLED`, recommendation filtering
+     * by attributes is enabled for the model.
      * 
      
      *
      * 
@@ -9873,8 +9971,8 @@ public Builder setFilteringOption(
      *
      *
      * 
      -     * Optional. If RECOMMENDATIONS_FILTERING_ENABLED, recommendation filtering by
-     * attributes is enabled for the model.
+     * Optional. If `RECOMMENDATIONS_FILTERING_ENABLED`, recommendation filtering
+     * by attributes is enabled for the model.
      * 
      
      *
      * 
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ModelOrBuilder.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ModelOrBuilder.java
index 7f8bc77f77bd..ad25684171f8 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ModelOrBuilder.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ModelOrBuilder.java
@@ -71,7 +71,7 @@ public interface ModelOrBuilder
    * 
          * Required. The fully qualified resource name of the model.
    * Format:
-   * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}
+   * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}`
    * catalog_id has char limit of 50.
    * recommendation_model_id has char limit of 40.
    * 
      
@@ -87,7 +87,7 @@ public interface ModelOrBuilder
    * 
          * Required. The fully qualified resource name of the model.
    * Format:
-   * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}
+   * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}`
    * catalog_id has char limit of 50.
    * recommendation_model_id has char limit of 40.
    * 
      
@@ -104,7 +104,7 @@ public interface ModelOrBuilder
    * 
          * Required. The display name of the model.
    * Should be human readable, used to display Recommendation Models in the
-   * Retail Cloud Cosole Dashboard. UTF-8 encoded string with limit of 1024
+   * Retail Cloud Console Dashboard. UTF-8 encoded string with limit of 1024
    * characters.
    * 
      
    *
@@ -119,7 +119,7 @@ public interface ModelOrBuilder
    * 
          * Required. The display name of the model.
    * Should be human readable, used to display Recommendation Models in the
-   * Retail Cloud Cosole Dashboard. UTF-8 encoded string with limit of 1024
+   * Retail Cloud Console Dashboard. UTF-8 encoded string with limit of 1024
    * characters.
    * 
      
    *
@@ -134,12 +134,12 @@ public interface ModelOrBuilder
    *
    * 
          * Optional. The training state that the model is in (e.g.
-   * TRAINING or PAUSED).
+   * `TRAINING` or `PAUSED`).
    * Since part of the cost of running the service
    * is frequency of training - this can be used to determine when to train
    * model in order to control cost. If not specified: the default value for
-   * CreateModel method is TRAINING. the default value for
-   * UpdateModel method is to keep the state the same as before.
+   * `CreateModel` method is `TRAINING`. The default value for
+   * `UpdateModel` method is to keep the state the same as before.
    * 
      
    *
    * 
@@ -154,12 +154,12 @@ public interface ModelOrBuilder
    *
    * 
          * Optional. The training state that the model is in (e.g.
-   * TRAINING or PAUSED).
+   * `TRAINING` or `PAUSED`).
    * Since part of the cost of running the service
    * is frequency of training - this can be used to determine when to train
    * model in order to control cost. If not specified: the default value for
-   * CreateModel method is TRAINING. the default value for
-   * UpdateModel method is to keep the state the same as before.
+   * `CreateModel` method is `TRAINING`. The default value for
+   * `UpdateModel` method is to keep the state the same as before.
    * 
      
    *
    * 
@@ -174,7 +174,7 @@ public interface ModelOrBuilder
    *
    *
    * 
      -   * Output only. The serving state of the model: ACTIVE, NOT_ACTIVE.
+   * Output only. The serving state of the model: `ACTIVE`, `NOT_ACTIVE`.
    * 
      
    *
    * 
@@ -188,7 +188,7 @@ public interface ModelOrBuilder
    *
    *
    * 
      -   * Output only. The serving state of the model: ACTIVE, NOT_ACTIVE.
+   * Output only. The serving state of the model: `ACTIVE`, `NOT_ACTIVE`.
    * 
      
    *
    * 
@@ -287,8 +287,17 @@ public interface ModelOrBuilder
    * 
          * Required. The type of model e.g. `home-page`.
    * Currently supported values: `recommended-for-you`, `others-you-may-like`,
-   * `frequently-bought-together`, `page-optimization`, 'similar-items',
-   * 'buy-it-again', `recently-viewed`(readonly value).
+   * `frequently-bought-together`, `page-optimization`, `similar-items`,
+   * `buy-it-again`, `on-sale-items`, and `recently-viewed`(readonly value).
+   * This field together with
+   * [optimization_objective][google.cloud.retail.v2alpha.Model.optimization_objective]
+   * describe model metadata to use to control model training and serving.
+   * See https://cloud.google.com/retail/docs/models
+   * for more details on what the model metadata control and which combination
+   * of parameters are valid. For invalid combinations of parameters (e.g. type
+   * = `frequently-bought-together` and optimization_objective = `ctr`), you
+   * receive an error 400 if you try to create/update a recommendation with
+   * this set of knobs.
    * 
      
    *
    * string type = 7 [(.google.api.field_behavior) = REQUIRED];
@@ -302,8 +311,17 @@ public interface ModelOrBuilder
    * 
          * Required. The type of model e.g. `home-page`.
    * Currently supported values: `recommended-for-you`, `others-you-may-like`,
-   * `frequently-bought-together`, `page-optimization`, 'similar-items',
-   * 'buy-it-again', `recently-viewed`(readonly value).
+   * `frequently-bought-together`, `page-optimization`, `similar-items`,
+   * `buy-it-again`, `on-sale-items`, and `recently-viewed`(readonly value).
+   * This field together with
+   * [optimization_objective][google.cloud.retail.v2alpha.Model.optimization_objective]
+   * describe model metadata to use to control model training and serving.
+   * See https://cloud.google.com/retail/docs/models
+   * for more details on what the model metadata control and which combination
+   * of parameters are valid. For invalid combinations of parameters (e.g. type
+   * = `frequently-bought-together` and optimization_objective = `ctr`), you
+   * receive an error 400 if you try to create/update a recommendation with
+   * this set of knobs.
    * 
      
    *
    * string type = 7 [(.google.api.field_behavior) = REQUIRED];
@@ -324,6 +342,15 @@ public interface ModelOrBuilder
    * `recommended-for-you` => `ctr`
    * `others-you-may-like` => `ctr`
    * `frequently-bought-together` => `revenue_per_order`
+   * This field together with
+   * [optimization_objective][google.cloud.retail.v2alpha.Model.type]
+   * describe model metadata to use to control model training and serving.
+   * See https://cloud.google.com/retail/docs/models
+   * for more details on what the model metadata control and which combination
+   * of parameters are valid. For invalid combinations of parameters (e.g. type
+   * = `frequently-bought-together` and optimization_objective = `ctr`), you
+   * receive an error 400 if you try to create/update a recommendation with
+   * this set of knobs.
    * 
      
    *
    * string optimization_objective = 8 [(.google.api.field_behavior) = OPTIONAL];
@@ -343,6 +370,15 @@ public interface ModelOrBuilder
    * `recommended-for-you` => `ctr`
    * `others-you-may-like` => `ctr`
    * `frequently-bought-together` => `revenue_per_order`
+   * This field together with
+   * [optimization_objective][google.cloud.retail.v2alpha.Model.type]
+   * describe model metadata to use to control model training and serving.
+   * See https://cloud.google.com/retail/docs/models
+   * for more details on what the model metadata control and which combination
+   * of parameters are valid. For invalid combinations of parameters (e.g. type
+   * = `frequently-bought-together` and optimization_objective = `ctr`), you
+   * receive an error 400 if you try to create/update a recommendation with
+   * this set of knobs.
    * 
      
    *
    * string optimization_objective = 8 [(.google.api.field_behavior) = OPTIONAL];
@@ -357,8 +393,8 @@ public interface ModelOrBuilder
    * 
          * Optional. The state of periodic tuning.
    * The period we use is 3 months - to do a
-   * one-off tune earlier use the TuneModel method. Default value
-   * is PERIODIC_TUNING_ENABLED.
+   * one-off tune earlier use the `TuneModel` method. Default value
+   * is `PERIODIC_TUNING_ENABLED`.
    * 
      
    *
    * 
@@ -374,8 +410,8 @@ public interface ModelOrBuilder
    * 
          * Optional. The state of periodic tuning.
    * The period we use is 3 months - to do a
-   * one-off tune earlier use the TuneModel method. Default value
-   * is PERIODIC_TUNING_ENABLED.
+   * one-off tune earlier use the `TuneModel` method. Default value
+   * is `PERIODIC_TUNING_ENABLED`.
    * 
      
    *
    * 
@@ -460,11 +496,11 @@ public interface ModelOrBuilder
    *
    *
    * 
      -   * Output only. The state of data requirements for this model: DATA_OK and
-   * DATA_ERROR.
+   * Output only. The state of data requirements for this model: `DATA_OK` and
+   * `DATA_ERROR`.
    * Recommendation model cannot be trained if the data is in
-   * DATA_ERROR state. Recommendation model can have DATA_ERROR state even if
-   * serving state is ACTIVE: models were trained successfully before, but
+   * `DATA_ERROR` state. Recommendation model can have `DATA_ERROR` state even
+   * if serving state is `ACTIVE`: models were trained successfully before, but
    * cannot be refreshed because model no longer has sufficient
    * data for training.
    * 
      
@@ -480,11 +516,11 @@ public interface ModelOrBuilder
    *
    *
    * 
      -   * Output only. The state of data requirements for this model: DATA_OK and
-   * DATA_ERROR.
+   * Output only. The state of data requirements for this model: `DATA_OK` and
+   * `DATA_ERROR`.
    * Recommendation model cannot be trained if the data is in
-   * DATA_ERROR state. Recommendation model can have DATA_ERROR state even if
-   * serving state is ACTIVE: models were trained successfully before, but
+   * `DATA_ERROR` state. Recommendation model can have `DATA_ERROR` state even
+   * if serving state is `ACTIVE`: models were trained successfully before, but
    * cannot be refreshed because model no longer has sufficient
    * data for training.
    * 
      
@@ -501,8 +537,8 @@ public interface ModelOrBuilder
    *
    *
    * 
      -   * Optional. If RECOMMENDATIONS_FILTERING_ENABLED, recommendation filtering by
-   * attributes is enabled for the model.
+   * Optional. If `RECOMMENDATIONS_FILTERING_ENABLED`, recommendation filtering
+   * by attributes is enabled for the model.
    * 
      
    *
    * 
@@ -516,8 +552,8 @@ public interface ModelOrBuilder
    *
    *
    * 
      -   * Optional. If RECOMMENDATIONS_FILTERING_ENABLED, recommendation filtering by
-   * attributes is enabled for the model.
+   * Optional. If `RECOMMENDATIONS_FILTERING_ENABLED`, recommendation filtering
+   * by attributes is enabled for the model.
    * 
      
    *
    * 
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ModelServiceProto.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ModelServiceProto.java
index cf9d31abd3dd..e9129b5e8ffe 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ModelServiceProto.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ModelServiceProto.java
@@ -110,49 +110,51 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
           + "ail.googleapis.com/Model\"$\n\023CreateModelM"
           + "etadata\022\r\n\005model\030\001 \001(\t\"\"\n\021TuneModelMetad"
           + "ata\022\r\n\005model\030\001 \001(\t\"\023\n\021TuneModelResponse2"
-          + "\246\013\n\014ModelService\022\326\001\n\013CreateModel\022/.googl"
+          + "\230\014\n\014ModelService\022\217\002\n\013CreateModel\022/.googl"
           + "e.cloud.retail.v2alpha.CreateModelReques"
-          + "t\032\035.google.longrunning.Operation\"w\202\323\344\223\002C"
-          + "\":/v2alpha/{parent=projects/*/locations/"
-          + "*/catalogs/*}/models:\005model\332A\014parent,mod"
-          + "el\312A\034\n\005Model\022\023CreateModelMetadata\022\264\001\n\nPa"
-          + "useModel\022..google.cloud.retail.v2alpha.P"
-          + "auseModelRequest\032\".google.cloud.retail.v"
-          + "2alpha.Model\"R\202\323\344\223\002E\"@/v2alpha/{name=pro"
-          + "jects/*/locations/*/catalogs/*/models/*}"
-          + ":pause:\001*\332A\004name\022\267\001\n\013ResumeModel\022/.googl"
-          + "e.cloud.retail.v2alpha.ResumeModelReques"
-          + "t\032\".google.cloud.retail.v2alpha.Model\"S\202"
-          + "\323\344\223\002F\"A/v2alpha/{name=projects/*/locatio"
-          + "ns/*/catalogs/*/models/*}:resume:\001*\332A\004na"
-          + "me\022\241\001\n\013DeleteModel\022/.google.cloud.retail"
-          + ".v2alpha.DeleteModelRequest\032\026.google.pro"
-          + "tobuf.Empty\"I\202\323\344\223\002<*:/v2alpha/{name=proj"
-          + "ects/*/locations/*/catalogs/*/models/*}\332"
-          + "A\004name\022\272\001\n\nListModels\022..google.cloud.ret"
-          + "ail.v2alpha.ListModelsRequest\032/.google.c"
-          + "loud.retail.v2alpha.ListModelsResponse\"K"
-          + "\202\323\344\223\002<\022:/v2alpha/{parent=projects/*/loca"
-          + "tions/*/catalogs/*}/models\332A\006parent\022\307\001\n\013"
-          + "UpdateModel\022/.google.cloud.retail.v2alph"
-          + "a.UpdateModelRequest\032\".google.cloud.reta"
-          + "il.v2alpha.Model\"c\202\323\344\223\002I2@/v2alpha/{mode"
-          + "l.name=projects/*/locations/*/catalogs/*"
-          + "/models/*}:\005model\332A\021model,update_mask\022\325\001"
-          + "\n\tTuneModel\022-.google.cloud.retail.v2alph"
-          + "a.TuneModelRequest\032\035.google.longrunning."
-          + "Operation\"z\202\323\344\223\002D\"?/v2alpha/{name=projec"
-          + "ts/*/locations/*/catalogs/*/models/*}:tu"
-          + "ne:\001*\332A\004name\312A&\n\021TuneModelResponse\022\021Tune"
-          + "ModelMetadata\032I\312A\025retail.googleapis.com\322"
-          + "A.https://www.googleapis.com/auth/cloud-"
-          + "platformB\337\001\n\037com.google.cloud.retail.v2a"
-          + "lphaB\021ModelServiceProtoP\001ZAgoogle.golang"
-          + ".org/genproto/googleapis/cloud/retail/v2"
-          + "alpha;retail\242\002\006RETAIL\252\002\033Google.Cloud.Ret"
-          + "ail.V2Alpha\312\002\033Google\\Cloud\\Retail\\V2alph"
-          + "a\352\002\036Google::Cloud::Retail::V2alphab\006prot"
-          + "o3"
+          + "t\032\035.google.longrunning.Operation\"\257\001\202\323\344\223\002"
+          + "C\":/v2alpha/{parent=projects/*/locations"
+          + "/*/catalogs/*}/models:\005model\332A\014parent,mo"
+          + "del\312AT\n!google.cloud.retail.v2alpha.Mode"
+          + "l\022/google.cloud.retail.v2alpha.CreateMod"
+          + "elMetadata\022\264\001\n\nPauseModel\022..google.cloud"
+          + ".retail.v2alpha.PauseModelRequest\032\".goog"
+          + "le.cloud.retail.v2alpha.Model\"R\202\323\344\223\002E\"@/"
+          + "v2alpha/{name=projects/*/locations/*/cat"
+          + "alogs/*/models/*}:pause:\001*\332A\004name\022\267\001\n\013Re"
+          + "sumeModel\022/.google.cloud.retail.v2alpha."
+          + "ResumeModelRequest\032\".google.cloud.retail"
+          + ".v2alpha.Model\"S\202\323\344\223\002F\"A/v2alpha/{name=p"
+          + "rojects/*/locations/*/catalogs/*/models/"
+          + "*}:resume:\001*\332A\004name\022\241\001\n\013DeleteModel\022/.go"
+          + "ogle.cloud.retail.v2alpha.DeleteModelReq"
+          + "uest\032\026.google.protobuf.Empty\"I\202\323\344\223\002<*:/v"
+          + "2alpha/{name=projects/*/locations/*/cata"
+          + "logs/*/models/*}\332A\004name\022\272\001\n\nListModels\022."
+          + ".google.cloud.retail.v2alpha.ListModelsR"
+          + "equest\032/.google.cloud.retail.v2alpha.Lis"
+          + "tModelsResponse\"K\202\323\344\223\002<\022:/v2alpha/{paren"
+          + "t=projects/*/locations/*/catalogs/*}/mod"
+          + "els\332A\006parent\022\307\001\n\013UpdateModel\022/.google.cl"
+          + "oud.retail.v2alpha.UpdateModelRequest\032\"."
+          + "google.cloud.retail.v2alpha.Model\"c\202\323\344\223\002"
+          + "I2@/v2alpha/{model.name=projects/*/locat"
+          + "ions/*/catalogs/*/models/*}:\005model\332A\021mod"
+          + "el,update_mask\022\216\002\n\tTuneModel\022-.google.cl"
+          + "oud.retail.v2alpha.TuneModelRequest\032\035.go"
+          + "ogle.longrunning.Operation\"\262\001\202\323\344\223\002D\"?/v2"
+          + "alpha/{name=projects/*/locations/*/catal"
+          + "ogs/*/models/*}:tune:\001*\332A\004name\312A^\n-googl"
+          + "e.cloud.retail.v2alpha.TuneModelResponse"
+          + "\022-google.cloud.retail.v2alpha.TuneModelM"
+          + "etadata\032I\312A\025retail.googleapis.com\322A.http"
+          + "s://www.googleapis.com/auth/cloud-platfo"
+          + "rmB\337\001\n\037com.google.cloud.retail.v2alphaB\021"
+          + "ModelServiceProtoP\001ZAgoogle.golang.org/g"
+          + "enproto/googleapis/cloud/retail/v2alpha;"
+          + "retail\242\002\006RETAIL\252\002\033Google.Cloud.Retail.V2"
+          + "Alpha\312\002\033Google\\Cloud\\Retail\\V2alpha\352\002\036Go"
+          + "ogle::Cloud::Retail::V2alphab\006proto3"
     };
     descriptor =
         com.google.protobuf.Descriptors.FileDescriptor.internalBuildGeneratedFileFrom(
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/OutputResult.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/OutputResult.java
index e9384d15202c..9dde6d5d6c1d 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/OutputResult.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/OutputResult.java
@@ -22,7 +22,8 @@
  *
  *
  * 
      - * Output result.
+ * Output result that stores the information about where the exported data is
+ * stored.
  * 
      
  *
  * Protobuf type {@code google.cloud.retail.v2alpha.OutputResult}
@@ -39,6 +40,7 @@ private OutputResult(com.google.protobuf.GeneratedMessageV3.Builder builder)
 
   private OutputResult() {
     bigqueryResult_ = java.util.Collections.emptyList();
+    gcsResult_ = java.util.Collections.emptyList();
   }
 
   @java.lang.Override
@@ -73,7 +75,7 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    *
    *
    * 
      -   * Export result in BigQuery.
+   * The BigQuery location where the result is stored.
    * 
      
    *
    * repeated .google.cloud.retail.v2alpha.BigQueryOutputResult bigquery_result = 1;
@@ -87,7 +89,7 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    *
    *
    * 
      -   * Export result in BigQuery.
+   * The BigQuery location where the result is stored.
    * 
      
    *
    * repeated .google.cloud.retail.v2alpha.BigQueryOutputResult bigquery_result = 1;
@@ -101,7 +103,7 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    *
    *
    * 
      -   * Export result in BigQuery.
+   * The BigQuery location where the result is stored.
    * 
      
    *
    * repeated .google.cloud.retail.v2alpha.BigQueryOutputResult bigquery_result = 1;
@@ -114,7 +116,7 @@ public int getBigqueryResultCount() {
    *
    *
    * 
      -   * Export result in BigQuery.
+   * The BigQuery location where the result is stored.
    * 
      
    *
    * repeated .google.cloud.retail.v2alpha.BigQueryOutputResult bigquery_result = 1;
@@ -127,7 +129,7 @@ public com.google.cloud.retail.v2alpha.BigQueryOutputResult getBigqueryResult(in
    *
    *
    * 
      -   * Export result in BigQuery.
+   * The BigQuery location where the result is stored.
    * 
      
    *
    * repeated .google.cloud.retail.v2alpha.BigQueryOutputResult bigquery_result = 1;
@@ -138,6 +140,75 @@ public com.google.cloud.retail.v2alpha.BigQueryOutputResultOrBuilder getBigquery
     return bigqueryResult_.get(index);
   }
 
+  public static final int GCS_RESULT_FIELD_NUMBER = 2;
+  private java.util.List gcsResult_;
+  /**
+   *
+   *
+   * 
      +   * The Google Cloud Storage location where the result is stored.
+   * 
      
+   *
+   * repeated .google.cloud.retail.v2alpha.GcsOutputResult gcs_result = 2;
+   */
+  @java.lang.Override
+  public java.util.List getGcsResultList() {
+    return gcsResult_;
+  }
+  /**
+   *
+   *
+   * 
      +   * The Google Cloud Storage location where the result is stored.
+   * 
      
+   *
+   * repeated .google.cloud.retail.v2alpha.GcsOutputResult gcs_result = 2;
+   */
+  @java.lang.Override
+  public java.util.List
+      getGcsResultOrBuilderList() {
+    return gcsResult_;
+  }
+  /**
+   *
+   *
+   * 
      +   * The Google Cloud Storage location where the result is stored.
+   * 
      
+   *
+   * repeated .google.cloud.retail.v2alpha.GcsOutputResult gcs_result = 2;
+   */
+  @java.lang.Override
+  public int getGcsResultCount() {
+    return gcsResult_.size();
+  }
+  /**
+   *
+   *
+   * 
      +   * The Google Cloud Storage location where the result is stored.
+   * 
      
+   *
+   * repeated .google.cloud.retail.v2alpha.GcsOutputResult gcs_result = 2;
+   */
+  @java.lang.Override
+  public com.google.cloud.retail.v2alpha.GcsOutputResult getGcsResult(int index) {
+    return gcsResult_.get(index);
+  }
+  /**
+   *
+   *
+   * 
      +   * The Google Cloud Storage location where the result is stored.
+   * 
      
+   *
+   * repeated .google.cloud.retail.v2alpha.GcsOutputResult gcs_result = 2;
+   */
+  @java.lang.Override
+  public com.google.cloud.retail.v2alpha.GcsOutputResultOrBuilder getGcsResultOrBuilder(int index) {
+    return gcsResult_.get(index);
+  }
+
   private byte memoizedIsInitialized = -1;
 
   @java.lang.Override
@@ -155,6 +226,9 @@ public void writeTo(com.google.protobuf.CodedOutputStream output) throws java.io
     for (int i = 0; i < bigqueryResult_.size(); i++) {
       output.writeMessage(1, bigqueryResult_.get(i));
     }
+    for (int i = 0; i < gcsResult_.size(); i++) {
+      output.writeMessage(2, gcsResult_.get(i));
+    }
     getUnknownFields().writeTo(output);
   }
 
@@ -167,6 +241,9 @@ public int getSerializedSize() {
     for (int i = 0; i < bigqueryResult_.size(); i++) {
       size += com.google.protobuf.CodedOutputStream.computeMessageSize(1, bigqueryResult_.get(i));
     }
+    for (int i = 0; i < gcsResult_.size(); i++) {
+      size += com.google.protobuf.CodedOutputStream.computeMessageSize(2, gcsResult_.get(i));
+    }
     size += getUnknownFields().getSerializedSize();
     memoizedSize = size;
     return size;
@@ -184,6 +261,7 @@ public boolean equals(final java.lang.Object obj) {
         (com.google.cloud.retail.v2alpha.OutputResult) obj;
 
     if (!getBigqueryResultList().equals(other.getBigqueryResultList())) return false;
+    if (!getGcsResultList().equals(other.getGcsResultList())) return false;
     if (!getUnknownFields().equals(other.getUnknownFields())) return false;
     return true;
   }
@@ -199,6 +277,10 @@ public int hashCode() {
       hash = (37 * hash) + BIGQUERY_RESULT_FIELD_NUMBER;
       hash = (53 * hash) + getBigqueryResultList().hashCode();
     }
+    if (getGcsResultCount() > 0) {
+      hash = (37 * hash) + GCS_RESULT_FIELD_NUMBER;
+      hash = (53 * hash) + getGcsResultList().hashCode();
+    }
     hash = (29 * hash) + getUnknownFields().hashCode();
     memoizedHashCode = hash;
     return hash;
@@ -303,7 +385,8 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
    *
    *
    * 
      -   * Output result.
+   * Output result that stores the information about where the exported data is
+   * stored.
    * 
      
    *
    * Protobuf type {@code google.cloud.retail.v2alpha.OutputResult}
@@ -344,6 +427,13 @@ public Builder clear() {
         bigqueryResultBuilder_.clear();
       }
       bitField0_ = (bitField0_ & ~0x00000001);
+      if (gcsResultBuilder_ == null) {
+        gcsResult_ = java.util.Collections.emptyList();
+      } else {
+        gcsResult_ = null;
+        gcsResultBuilder_.clear();
+      }
+      bitField0_ = (bitField0_ & ~0x00000002);
       return this;
     }
 
@@ -381,6 +471,15 @@ public com.google.cloud.retail.v2alpha.OutputResult buildPartial() {
       } else {
         result.bigqueryResult_ = bigqueryResultBuilder_.build();
       }
+      if (gcsResultBuilder_ == null) {
+        if (((bitField0_ & 0x00000002) != 0)) {
+          gcsResult_ = java.util.Collections.unmodifiableList(gcsResult_);
+          bitField0_ = (bitField0_ & ~0x00000002);
+        }
+        result.gcsResult_ = gcsResult_;
+      } else {
+        result.gcsResult_ = gcsResultBuilder_.build();
+      }
       onBuilt();
       return result;
     }
@@ -457,6 +556,33 @@ public Builder mergeFrom(com.google.cloud.retail.v2alpha.OutputResult other) {
           }
         }
       }
+      if (gcsResultBuilder_ == null) {
+        if (!other.gcsResult_.isEmpty()) {
+          if (gcsResult_.isEmpty()) {
+            gcsResult_ = other.gcsResult_;
+            bitField0_ = (bitField0_ & ~0x00000002);
+          } else {
+            ensureGcsResultIsMutable();
+            gcsResult_.addAll(other.gcsResult_);
+          }
+          onChanged();
+        }
+      } else {
+        if (!other.gcsResult_.isEmpty()) {
+          if (gcsResultBuilder_.isEmpty()) {
+            gcsResultBuilder_.dispose();
+            gcsResultBuilder_ = null;
+            gcsResult_ = other.gcsResult_;
+            bitField0_ = (bitField0_ & ~0x00000002);
+            gcsResultBuilder_ =
+                com.google.protobuf.GeneratedMessageV3.alwaysUseFieldBuilders
+                    ? getGcsResultFieldBuilder()
+                    : null;
+          } else {
+            gcsResultBuilder_.addAllMessages(other.gcsResult_);
+          }
+        }
+      }
       this.mergeUnknownFields(other.getUnknownFields());
       onChanged();
       return this;
@@ -497,6 +623,20 @@ public Builder mergeFrom(
                 }
                 break;
               } // case 10
+            case 18:
+              {
+                com.google.cloud.retail.v2alpha.GcsOutputResult m =
+                    input.readMessage(
+                        com.google.cloud.retail.v2alpha.GcsOutputResult.parser(),
+                        extensionRegistry);
+                if (gcsResultBuilder_ == null) {
+                  ensureGcsResultIsMutable();
+                  gcsResult_.add(m);
+                } else {
+                  gcsResultBuilder_.addMessage(m);
+                }
+                break;
+              } // case 18
             default:
               {
                 if (!super.parseUnknownField(input, extensionRegistry, tag)) {
@@ -538,7 +678,7 @@ private void ensureBigqueryResultIsMutable() {
      *
      *
      * 
      -     * Export result in BigQuery.
+     * The BigQuery location where the result is stored.
      * 
      
      *
      * repeated .google.cloud.retail.v2alpha.BigQueryOutputResult bigquery_result = 1;
@@ -555,7 +695,7 @@ private void ensureBigqueryResultIsMutable() {
      *
      *
      * 
      -     * Export result in BigQuery.
+     * The BigQuery location where the result is stored.
      * 
      
      *
      * repeated .google.cloud.retail.v2alpha.BigQueryOutputResult bigquery_result = 1;
@@ -571,7 +711,7 @@ public int getBigqueryResultCount() {
      *
      *
      * 
      -     * Export result in BigQuery.
+     * The BigQuery location where the result is stored.
      * 
      
      *
      * repeated .google.cloud.retail.v2alpha.BigQueryOutputResult bigquery_result = 1;
@@ -587,7 +727,7 @@ public com.google.cloud.retail.v2alpha.BigQueryOutputResult getBigqueryResult(in
      *
      *
      * 
      -     * Export result in BigQuery.
+     * The BigQuery location where the result is stored.
      * 
      
      *
      * repeated .google.cloud.retail.v2alpha.BigQueryOutputResult bigquery_result = 1;
@@ -610,7 +750,7 @@ public Builder setBigqueryResult(
      *
      *
      * 
      -     * Export result in BigQuery.
+     * The BigQuery location where the result is stored.
      * 
      
      *
      * repeated .google.cloud.retail.v2alpha.BigQueryOutputResult bigquery_result = 1;
@@ -630,7 +770,7 @@ public Builder setBigqueryResult(
      *
      *
      * 
      -     * Export result in BigQuery.
+     * The BigQuery location where the result is stored.
      * 
      
      *
      * repeated .google.cloud.retail.v2alpha.BigQueryOutputResult bigquery_result = 1;
@@ -652,7 +792,7 @@ public Builder addBigqueryResult(com.google.cloud.retail.v2alpha.BigQueryOutputR
      *
      *
      * 
      -     * Export result in BigQuery.
+     * The BigQuery location where the result is stored.
      * 
      
      *
      * repeated .google.cloud.retail.v2alpha.BigQueryOutputResult bigquery_result = 1;
@@ -675,7 +815,7 @@ public Builder addBigqueryResult(
      *
      *
      * 
      -     * Export result in BigQuery.
+     * The BigQuery location where the result is stored.
      * 
      
      *
      * repeated .google.cloud.retail.v2alpha.BigQueryOutputResult bigquery_result = 1;
@@ -695,7 +835,7 @@ public Builder addBigqueryResult(
      *
      *
      * 
      -     * Export result in BigQuery.
+     * The BigQuery location where the result is stored.
      * 
      
      *
      * repeated .google.cloud.retail.v2alpha.BigQueryOutputResult bigquery_result = 1;
@@ -715,7 +855,7 @@ public Builder addBigqueryResult(
      *
      *
      * 
      -     * Export result in BigQuery.
+     * The BigQuery location where the result is stored.
      * 
      
      *
      * repeated .google.cloud.retail.v2alpha.BigQueryOutputResult bigquery_result = 1;
@@ -735,7 +875,7 @@ public Builder addAllBigqueryResult(
      *
      *
      * 
      -     * Export result in BigQuery.
+     * The BigQuery location where the result is stored.
      * 
      
      *
      * repeated .google.cloud.retail.v2alpha.BigQueryOutputResult bigquery_result = 1;
@@ -754,7 +894,7 @@ public Builder clearBigqueryResult() {
      *
      *
      * 
      -     * Export result in BigQuery.
+     * The BigQuery location where the result is stored.
      * 
      
      *
      * repeated .google.cloud.retail.v2alpha.BigQueryOutputResult bigquery_result = 1;
@@ -773,7 +913,7 @@ public Builder removeBigqueryResult(int index) {
      *
      *
      * 
      -     * Export result in BigQuery.
+     * The BigQuery location where the result is stored.
      * 
      
      *
      * repeated .google.cloud.retail.v2alpha.BigQueryOutputResult bigquery_result = 1;
@@ -786,7 +926,7 @@ public com.google.cloud.retail.v2alpha.BigQueryOutputResult.Builder getBigqueryR
      *
      *
      * 
      -     * Export result in BigQuery.
+     * The BigQuery location where the result is stored.
      * 
      
      *
      * repeated .google.cloud.retail.v2alpha.BigQueryOutputResult bigquery_result = 1;
@@ -803,7 +943,7 @@ public com.google.cloud.retail.v2alpha.BigQueryOutputResultOrBuilder getBigquery
      *
      *
      * 
      -     * Export result in BigQuery.
+     * The BigQuery location where the result is stored.
      * 
      
      *
      * repeated .google.cloud.retail.v2alpha.BigQueryOutputResult bigquery_result = 1;
@@ -820,7 +960,7 @@ public com.google.cloud.retail.v2alpha.BigQueryOutputResultOrBuilder getBigquery
      *
      *
      * 
      -     * Export result in BigQuery.
+     * The BigQuery location where the result is stored.
      * 
      
      *
      * repeated .google.cloud.retail.v2alpha.BigQueryOutputResult bigquery_result = 1;
@@ -833,7 +973,7 @@ public com.google.cloud.retail.v2alpha.BigQueryOutputResult.Builder addBigqueryR
      *
      *
      * 
      -     * Export result in BigQuery.
+     * The BigQuery location where the result is stored.
      * 
      
      *
      * repeated .google.cloud.retail.v2alpha.BigQueryOutputResult bigquery_result = 1;
@@ -848,7 +988,7 @@ public com.google.cloud.retail.v2alpha.BigQueryOutputResult.Builder addBigqueryR
      *
      *
      * 
      -     * Export result in BigQuery.
+     * The BigQuery location where the result is stored.
      * 
      
      *
      * repeated .google.cloud.retail.v2alpha.BigQueryOutputResult bigquery_result = 1;
@@ -878,6 +1018,358 @@ public com.google.cloud.retail.v2alpha.BigQueryOutputResult.Builder addBigqueryR
       return bigqueryResultBuilder_;
     }
 
+    private java.util.List gcsResult_ =
+        java.util.Collections.emptyList();
+
+    private void ensureGcsResultIsMutable() {
+      if (!((bitField0_ & 0x00000002) != 0)) {
+        gcsResult_ =
+            new java.util.ArrayList(gcsResult_);
+        bitField0_ |= 0x00000002;
+      }
+    }
+
+    private com.google.protobuf.RepeatedFieldBuilderV3<
+            com.google.cloud.retail.v2alpha.GcsOutputResult,
+            com.google.cloud.retail.v2alpha.GcsOutputResult.Builder,
+            com.google.cloud.retail.v2alpha.GcsOutputResultOrBuilder>
+        gcsResultBuilder_;
+
+    /**
+     *
+     *
+     * 
      +     * The Google Cloud Storage location where the result is stored.
+     * 
      
+     *
+     * repeated .google.cloud.retail.v2alpha.GcsOutputResult gcs_result = 2;
+     */
+    public java.util.List getGcsResultList() {
+      if (gcsResultBuilder_ == null) {
+        return java.util.Collections.unmodifiableList(gcsResult_);
+      } else {
+        return gcsResultBuilder_.getMessageList();
+      }
+    }
+    /**
+     *
+     *
+     * 
      +     * The Google Cloud Storage location where the result is stored.
+     * 
      
+     *
+     * repeated .google.cloud.retail.v2alpha.GcsOutputResult gcs_result = 2;
+     */
+    public int getGcsResultCount() {
+      if (gcsResultBuilder_ == null) {
+        return gcsResult_.size();
+      } else {
+        return gcsResultBuilder_.getCount();
+      }
+    }
+    /**
+     *
+     *
+     * 
      +     * The Google Cloud Storage location where the result is stored.
+     * 
      
+     *
+     * repeated .google.cloud.retail.v2alpha.GcsOutputResult gcs_result = 2;
+     */
+    public com.google.cloud.retail.v2alpha.GcsOutputResult getGcsResult(int index) {
+      if (gcsResultBuilder_ == null) {
+        return gcsResult_.get(index);
+      } else {
+        return gcsResultBuilder_.getMessage(index);
+      }
+    }
+    /**
+     *
+     *
+     * 
      +     * The Google Cloud Storage location where the result is stored.
+     * 
      
+     *
+     * repeated .google.cloud.retail.v2alpha.GcsOutputResult gcs_result = 2;
+     */
+    public Builder setGcsResult(int index, com.google.cloud.retail.v2alpha.GcsOutputResult value) {
+      if (gcsResultBuilder_ == null) {
+        if (value == null) {
+          throw new NullPointerException();
+        }
+        ensureGcsResultIsMutable();
+        gcsResult_.set(index, value);
+        onChanged();
+      } else {
+        gcsResultBuilder_.setMessage(index, value);
+      }
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * The Google Cloud Storage location where the result is stored.
+     * 
      
+     *
+     * repeated .google.cloud.retail.v2alpha.GcsOutputResult gcs_result = 2;
+     */
+    public Builder setGcsResult(
+        int index, com.google.cloud.retail.v2alpha.GcsOutputResult.Builder builderForValue) {
+      if (gcsResultBuilder_ == null) {
+        ensureGcsResultIsMutable();
+        gcsResult_.set(index, builderForValue.build());
+        onChanged();
+      } else {
+        gcsResultBuilder_.setMessage(index, builderForValue.build());
+      }
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * The Google Cloud Storage location where the result is stored.
+     * 
      
+     *
+     * repeated .google.cloud.retail.v2alpha.GcsOutputResult gcs_result = 2;
+     */
+    public Builder addGcsResult(com.google.cloud.retail.v2alpha.GcsOutputResult value) {
+      if (gcsResultBuilder_ == null) {
+        if (value == null) {
+          throw new NullPointerException();
+        }
+        ensureGcsResultIsMutable();
+        gcsResult_.add(value);
+        onChanged();
+      } else {
+        gcsResultBuilder_.addMessage(value);
+      }
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * The Google Cloud Storage location where the result is stored.
+     * 
      
+     *
+     * repeated .google.cloud.retail.v2alpha.GcsOutputResult gcs_result = 2;
+     */
+    public Builder addGcsResult(int index, com.google.cloud.retail.v2alpha.GcsOutputResult value) {
+      if (gcsResultBuilder_ == null) {
+        if (value == null) {
+          throw new NullPointerException();
+        }
+        ensureGcsResultIsMutable();
+        gcsResult_.add(index, value);
+        onChanged();
+      } else {
+        gcsResultBuilder_.addMessage(index, value);
+      }
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * The Google Cloud Storage location where the result is stored.
+     * 
      
+     *
+     * repeated .google.cloud.retail.v2alpha.GcsOutputResult gcs_result = 2;
+     */
+    public Builder addGcsResult(
+        com.google.cloud.retail.v2alpha.GcsOutputResult.Builder builderForValue) {
+      if (gcsResultBuilder_ == null) {
+        ensureGcsResultIsMutable();
+        gcsResult_.add(builderForValue.build());
+        onChanged();
+      } else {
+        gcsResultBuilder_.addMessage(builderForValue.build());
+      }
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * The Google Cloud Storage location where the result is stored.
+     * 
      
+     *
+     * repeated .google.cloud.retail.v2alpha.GcsOutputResult gcs_result = 2;
+     */
+    public Builder addGcsResult(
+        int index, com.google.cloud.retail.v2alpha.GcsOutputResult.Builder builderForValue) {
+      if (gcsResultBuilder_ == null) {
+        ensureGcsResultIsMutable();
+        gcsResult_.add(index, builderForValue.build());
+        onChanged();
+      } else {
+        gcsResultBuilder_.addMessage(index, builderForValue.build());
+      }
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * The Google Cloud Storage location where the result is stored.
+     * 
      
+     *
+     * repeated .google.cloud.retail.v2alpha.GcsOutputResult gcs_result = 2;
+     */
+    public Builder addAllGcsResult(
+        java.lang.Iterable values) {
+      if (gcsResultBuilder_ == null) {
+        ensureGcsResultIsMutable();
+        com.google.protobuf.AbstractMessageLite.Builder.addAll(values, gcsResult_);
+        onChanged();
+      } else {
+        gcsResultBuilder_.addAllMessages(values);
+      }
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * The Google Cloud Storage location where the result is stored.
+     * 
      
+     *
+     * repeated .google.cloud.retail.v2alpha.GcsOutputResult gcs_result = 2;
+     */
+    public Builder clearGcsResult() {
+      if (gcsResultBuilder_ == null) {
+        gcsResult_ = java.util.Collections.emptyList();
+        bitField0_ = (bitField0_ & ~0x00000002);
+        onChanged();
+      } else {
+        gcsResultBuilder_.clear();
+      }
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * The Google Cloud Storage location where the result is stored.
+     * 
      
+     *
+     * repeated .google.cloud.retail.v2alpha.GcsOutputResult gcs_result = 2;
+     */
+    public Builder removeGcsResult(int index) {
+      if (gcsResultBuilder_ == null) {
+        ensureGcsResultIsMutable();
+        gcsResult_.remove(index);
+        onChanged();
+      } else {
+        gcsResultBuilder_.remove(index);
+      }
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * The Google Cloud Storage location where the result is stored.
+     * 
      
+     *
+     * repeated .google.cloud.retail.v2alpha.GcsOutputResult gcs_result = 2;
+     */
+    public com.google.cloud.retail.v2alpha.GcsOutputResult.Builder getGcsResultBuilder(int index) {
+      return getGcsResultFieldBuilder().getBuilder(index);
+    }
+    /**
+     *
+     *
+     * 
      +     * The Google Cloud Storage location where the result is stored.
+     * 
      
+     *
+     * repeated .google.cloud.retail.v2alpha.GcsOutputResult gcs_result = 2;
+     */
+    public com.google.cloud.retail.v2alpha.GcsOutputResultOrBuilder getGcsResultOrBuilder(
+        int index) {
+      if (gcsResultBuilder_ == null) {
+        return gcsResult_.get(index);
+      } else {
+        return gcsResultBuilder_.getMessageOrBuilder(index);
+      }
+    }
+    /**
+     *
+     *
+     * 
      +     * The Google Cloud Storage location where the result is stored.
+     * 
      
+     *
+     * repeated .google.cloud.retail.v2alpha.GcsOutputResult gcs_result = 2;
+     */
+    public java.util.List
+        getGcsResultOrBuilderList() {
+      if (gcsResultBuilder_ != null) {
+        return gcsResultBuilder_.getMessageOrBuilderList();
+      } else {
+        return java.util.Collections.unmodifiableList(gcsResult_);
+      }
+    }
+    /**
+     *
+     *
+     * 
      +     * The Google Cloud Storage location where the result is stored.
+     * 
      
+     *
+     * repeated .google.cloud.retail.v2alpha.GcsOutputResult gcs_result = 2;
+     */
+    public com.google.cloud.retail.v2alpha.GcsOutputResult.Builder addGcsResultBuilder() {
+      return getGcsResultFieldBuilder()
+          .addBuilder(com.google.cloud.retail.v2alpha.GcsOutputResult.getDefaultInstance());
+    }
+    /**
+     *
+     *
+     * 
      +     * The Google Cloud Storage location where the result is stored.
+     * 
      
+     *
+     * repeated .google.cloud.retail.v2alpha.GcsOutputResult gcs_result = 2;
+     */
+    public com.google.cloud.retail.v2alpha.GcsOutputResult.Builder addGcsResultBuilder(int index) {
+      return getGcsResultFieldBuilder()
+          .addBuilder(index, com.google.cloud.retail.v2alpha.GcsOutputResult.getDefaultInstance());
+    }
+    /**
+     *
+     *
+     * 
      +     * The Google Cloud Storage location where the result is stored.
+     * 
      
+     *
+     * repeated .google.cloud.retail.v2alpha.GcsOutputResult gcs_result = 2;
+     */
+    public java.util.List
+        getGcsResultBuilderList() {
+      return getGcsResultFieldBuilder().getBuilderList();
+    }
+
+    private com.google.protobuf.RepeatedFieldBuilderV3<
+            com.google.cloud.retail.v2alpha.GcsOutputResult,
+            com.google.cloud.retail.v2alpha.GcsOutputResult.Builder,
+            com.google.cloud.retail.v2alpha.GcsOutputResultOrBuilder>
+        getGcsResultFieldBuilder() {
+      if (gcsResultBuilder_ == null) {
+        gcsResultBuilder_ =
+            new com.google.protobuf.RepeatedFieldBuilderV3<
+                com.google.cloud.retail.v2alpha.GcsOutputResult,
+                com.google.cloud.retail.v2alpha.GcsOutputResult.Builder,
+                com.google.cloud.retail.v2alpha.GcsOutputResultOrBuilder>(
+                gcsResult_, ((bitField0_ & 0x00000002) != 0), getParentForChildren(), isClean());
+        gcsResult_ = null;
+      }
+      return gcsResultBuilder_;
+    }
+
     @java.lang.Override
     public final Builder setUnknownFields(final com.google.protobuf.UnknownFieldSet unknownFields) {
       return super.setUnknownFields(unknownFields);
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/OutputResultOrBuilder.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/OutputResultOrBuilder.java
index 0382c7125494..1a78a148cbca 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/OutputResultOrBuilder.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/OutputResultOrBuilder.java
@@ -27,7 +27,7 @@ public interface OutputResultOrBuilder
    *
    *
    * 
      -   * Export result in BigQuery.
+   * The BigQuery location where the result is stored.
    * 
      
    *
    * repeated .google.cloud.retail.v2alpha.BigQueryOutputResult bigquery_result = 1;
@@ -37,7 +37,7 @@ public interface OutputResultOrBuilder
    *
    *
    * 
      -   * Export result in BigQuery.
+   * The BigQuery location where the result is stored.
    * 
      
    *
    * repeated .google.cloud.retail.v2alpha.BigQueryOutputResult bigquery_result = 1;
@@ -47,7 +47,7 @@ public interface OutputResultOrBuilder
    *
    *
    * 
      -   * Export result in BigQuery.
+   * The BigQuery location where the result is stored.
    * 
      
    *
    * repeated .google.cloud.retail.v2alpha.BigQueryOutputResult bigquery_result = 1;
@@ -57,7 +57,7 @@ public interface OutputResultOrBuilder
    *
    *
    * 
      -   * Export result in BigQuery.
+   * The BigQuery location where the result is stored.
    * 
      
    *
    * repeated .google.cloud.retail.v2alpha.BigQueryOutputResult bigquery_result = 1;
@@ -68,11 +68,63 @@ public interface OutputResultOrBuilder
    *
    *
    * 
      -   * Export result in BigQuery.
+   * The BigQuery location where the result is stored.
    * 
      
    *
    * repeated .google.cloud.retail.v2alpha.BigQueryOutputResult bigquery_result = 1;
    */
   com.google.cloud.retail.v2alpha.BigQueryOutputResultOrBuilder getBigqueryResultOrBuilder(
       int index);
+
+  /**
+   *
+   *
+   * 
      +   * The Google Cloud Storage location where the result is stored.
+   * 
      
+   *
+   * repeated .google.cloud.retail.v2alpha.GcsOutputResult gcs_result = 2;
+   */
+  java.util.List getGcsResultList();
+  /**
+   *
+   *
+   * 
      +   * The Google Cloud Storage location where the result is stored.
+   * 
      
+   *
+   * repeated .google.cloud.retail.v2alpha.GcsOutputResult gcs_result = 2;
+   */
+  com.google.cloud.retail.v2alpha.GcsOutputResult getGcsResult(int index);
+  /**
+   *
+   *
+   * 
      +   * The Google Cloud Storage location where the result is stored.
+   * 
      
+   *
+   * repeated .google.cloud.retail.v2alpha.GcsOutputResult gcs_result = 2;
+   */
+  int getGcsResultCount();
+  /**
+   *
+   *
+   * 
      +   * The Google Cloud Storage location where the result is stored.
+   * 
      
+   *
+   * repeated .google.cloud.retail.v2alpha.GcsOutputResult gcs_result = 2;
+   */
+  java.util.List
+      getGcsResultOrBuilderList();
+  /**
+   *
+   *
+   * 
      +   * The Google Cloud Storage location where the result is stored.
+   * 
      
+   *
+   * repeated .google.cloud.retail.v2alpha.GcsOutputResult gcs_result = 2;
+   */
+  com.google.cloud.retail.v2alpha.GcsOutputResultOrBuilder getGcsResultOrBuilder(int index);
 }
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/PauseModelRequest.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/PauseModelRequest.java
index ad510d7e32fc..8db775840ecf 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/PauseModelRequest.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/PauseModelRequest.java
@@ -75,7 +75,7 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    * 
          * Required. The name of the model to pause.
    * Format:
-   * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}
+   * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}`
    * 
      
    *
    * 
@@ -102,7 +102,7 @@ public java.lang.String getName() {
    * 
          * Required. The name of the model to pause.
    * Format:
-   * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}
+   * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}`
    * 
      
    *
    * 
@@ -461,7 +461,7 @@ public Builder mergeFrom(
      * 
            * Required. The name of the model to pause.
      * Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}`
      * 
      
      *
      * 
@@ -487,7 +487,7 @@ public java.lang.String getName() {
      * 
            * Required. The name of the model to pause.
      * Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}`
      * 
      
      *
      * 
@@ -513,7 +513,7 @@ public com.google.protobuf.ByteString getNameBytes() {
      * 
            * Required. The name of the model to pause.
      * Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}`
      * 
      
      *
      * 
@@ -538,7 +538,7 @@ public Builder setName(java.lang.String value) {
      * 
            * Required. The name of the model to pause.
      * Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}`
      * 
      
      *
      * 
@@ -559,7 +559,7 @@ public Builder clearName() {
      * 
            * Required. The name of the model to pause.
      * Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}`
      * 
      
      *
      * 
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/PauseModelRequestOrBuilder.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/PauseModelRequestOrBuilder.java
index a3e021d611b4..355921ea6409 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/PauseModelRequestOrBuilder.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/PauseModelRequestOrBuilder.java
@@ -29,7 +29,7 @@ public interface PauseModelRequestOrBuilder
    * 
          * Required. The name of the model to pause.
    * Format:
-   * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}
+   * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}`
    * 
      
    *
    * 
@@ -45,7 +45,7 @@ public interface PauseModelRequestOrBuilder
    * 
          * Required. The name of the model to pause.
    * Format:
-   * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}
+   * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}`
    * 
      
    *
    * 
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/PredictRequest.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/PredictRequest.java
index c9a137fcd923..e0a8cb64e77a 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/PredictRequest.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/PredictRequest.java
@@ -97,7 +97,7 @@ protected com.google.protobuf.MapField internalGetMapField(int number) {
    * The ID of the Recommendations AI serving config or placement.
    * Before you can request predictions from your model, you must create at
    * least one serving config or placement for it. For more information, see
-   * [Managing serving configurations]
+   * [Manage serving configs]
    * (https://cloud.google.com/retail/docs/manage-configs).
    * The full list of available serving configs can be seen at
    * https://console.cloud.google.com/ai/retail/catalogs/default_catalog/configs
@@ -132,7 +132,7 @@ public java.lang.String getPlacement() {
    * The ID of the Recommendations AI serving config or placement.
    * Before you can request predictions from your model, you must create at
    * least one serving config or placement for it. For more information, see
-   * [Managing serving configurations]
+   * [Manage serving configs]
    * (https://cloud.google.com/retail/docs/manage-configs).
    * The full list of available serving configs can be seen at
    * https://console.cloud.google.com/ai/retail/catalogs/default_catalog/configs
@@ -251,10 +251,10 @@ public com.google.cloud.retail.v2alpha.UserEventOrBuilder getUserEventOrBuilder(
    *
    *
    * 
      -   * Maximum number of results to return per page. Set this property
-   * to the number of prediction results needed. If zero, the service will
-   * choose a reasonable default. The maximum allowed value is 100. Values
-   * above 100 will be coerced to 100.
+   * Maximum number of results to return. Set this property to the number of
+   * prediction results needed. If zero, the service will choose a reasonable
+   * default. The maximum allowed value is 100. Values above 100 will be coerced
+   * to 100.
    * 
      
    *
    * int32 page_size = 3;
@@ -272,13 +272,13 @@ public int getPageSize() {
    *
    *
    * 
      -   * This field is not used for now; leave it unset.
+   * This field is not used; leave it unset.
    * 
      
    *
    * string page_token = 4 [deprecated = true];
    *
    * @deprecated google.cloud.retail.v2alpha.PredictRequest.page_token is deprecated. See
-   *     google/cloud/retail/v2alpha/prediction_service.proto;l=93
+   *     google/cloud/retail/v2alpha/prediction_service.proto;l=94
    * @return The pageToken.
    */
   @java.lang.Override
@@ -298,13 +298,13 @@ public java.lang.String getPageToken() {
    *
    *
    * 
      -   * This field is not used for now; leave it unset.
+   * This field is not used; leave it unset.
    * 
      
    *
    * string page_token = 4 [deprecated = true];
    *
    * @deprecated google.cloud.retail.v2alpha.PredictRequest.page_token is deprecated. See
-   *     google/cloud/retail/v2alpha/prediction_service.proto;l=93
+   *     google/cloud/retail/v2alpha/prediction_service.proto;l=94
    * @return The bytes for pageToken.
    */
   @java.lang.Override
@@ -344,12 +344,11 @@ public com.google.protobuf.ByteString getPageTokenBytes() {
    *  * tag=("Red" OR "Blue") tag="New-Arrival" tag=(NOT "promotional")
    *  * filterOutOfStockItems  tag=(-"promotional")
    *  * filterOutOfStockItems
-   * If your filter blocks all prediction results, the API will return generic
-   * (unfiltered) popular products. If you only want results strictly matching
-   * the filters, set `strictFiltering` to True in `PredictRequest.params` to
-   * receive empty results instead.
-   * Note that the API will never return items with storageStatus of "EXPIRED"
-   * or "DELETED" regardless of filter choices.
+   * If your filter blocks all prediction results, the API will return *no*
+   * results. If instead you want empty result sets to return generic
+   * (unfiltered) popular products, set `strictFiltering` to False in
+   * `PredictRequest.params`. Note that the API will never return items with
+   * storageStatus of "EXPIRED" or "DELETED" regardless of filter choices.
    * If `filterSyntaxV2` is set to true under the `params` field, then
    * attribute-based expressions are expected instead of the above described
    * tag-based syntax. Examples:
@@ -395,12 +394,11 @@ public java.lang.String getFilter() {
    *  * tag=("Red" OR "Blue") tag="New-Arrival" tag=(NOT "promotional")
    *  * filterOutOfStockItems  tag=(-"promotional")
    *  * filterOutOfStockItems
-   * If your filter blocks all prediction results, the API will return generic
-   * (unfiltered) popular products. If you only want results strictly matching
-   * the filters, set `strictFiltering` to True in `PredictRequest.params` to
-   * receive empty results instead.
-   * Note that the API will never return items with storageStatus of "EXPIRED"
-   * or "DELETED" regardless of filter choices.
+   * If your filter blocks all prediction results, the API will return *no*
+   * results. If instead you want empty result sets to return generic
+   * (unfiltered) popular products, set `strictFiltering` to False in
+   * `PredictRequest.params`. Note that the API will never return items with
+   * storageStatus of "EXPIRED" or "DELETED" regardless of filter choices.
    * If `filterSyntaxV2` is set to true under the `params` field, then
    * attribute-based expressions are expected instead of the above described
    * tag-based syntax. Examples:
@@ -487,7 +485,7 @@ public int getParamsCount() {
    * * `returnScore`: Boolean. If set to true, the prediction 'score'
    *    corresponding to each returned product will be set in the
    *    `results.metadata` field in the prediction response. The given
-   *    'score' indicates the probability of an product being clicked/purchased
+   *    'score' indicates the probability of a product being clicked/purchased
    *    given the user's context and history.
    * * `strictFiltering`: Boolean. True by default. If set to false, the service
    *    will return generic (unfiltered) popular products instead of empty if
@@ -533,7 +531,7 @@ public java.util.Map getParams() {
    * * `returnScore`: Boolean. If set to true, the prediction 'score'
    *    corresponding to each returned product will be set in the
    *    `results.metadata` field in the prediction response. The given
-   *    'score' indicates the probability of an product being clicked/purchased
+   *    'score' indicates the probability of a product being clicked/purchased
    *    given the user's context and history.
    * * `strictFiltering`: Boolean. True by default. If set to false, the service
    *    will return generic (unfiltered) popular products instead of empty if
@@ -570,7 +568,7 @@ public java.util.Map getParamsMap()
    * * `returnScore`: Boolean. If set to true, the prediction 'score'
    *    corresponding to each returned product will be set in the
    *    `results.metadata` field in the prediction response. The given
-   *    'score' indicates the probability of an product being clicked/purchased
+   *    'score' indicates the probability of a product being clicked/purchased
    *    given the user's context and history.
    * * `strictFiltering`: Boolean. True by default. If set to false, the service
    *    will return generic (unfiltered) popular products instead of empty if
@@ -612,7 +610,7 @@ public com.google.protobuf.Value getParamsOrDefault(
    * * `returnScore`: Boolean. If set to true, the prediction 'score'
    *    corresponding to each returned product will be set in the
    *    `results.metadata` field in the prediction response. The given
-   *    'score' indicates the probability of an product being clicked/purchased
+   *    'score' indicates the probability of a product being clicked/purchased
    *    given the user's context and history.
    * * `strictFiltering`: Boolean. True by default. If set to false, the service
    *    will return generic (unfiltered) popular products instead of empty if
@@ -1353,7 +1351,7 @@ public Builder mergeFrom(
      * The ID of the Recommendations AI serving config or placement.
      * Before you can request predictions from your model, you must create at
      * least one serving config or placement for it. For more information, see
-     * [Managing serving configurations]
+     * [Manage serving configs]
      * (https://cloud.google.com/retail/docs/manage-configs).
      * The full list of available serving configs can be seen at
      * https://console.cloud.google.com/ai/retail/catalogs/default_catalog/configs
@@ -1387,7 +1385,7 @@ public java.lang.String getPlacement() {
      * The ID of the Recommendations AI serving config or placement.
      * Before you can request predictions from your model, you must create at
      * least one serving config or placement for it. For more information, see
-     * [Managing serving configurations]
+     * [Manage serving configs]
      * (https://cloud.google.com/retail/docs/manage-configs).
      * The full list of available serving configs can be seen at
      * https://console.cloud.google.com/ai/retail/catalogs/default_catalog/configs
@@ -1421,7 +1419,7 @@ public com.google.protobuf.ByteString getPlacementBytes() {
      * The ID of the Recommendations AI serving config or placement.
      * Before you can request predictions from your model, you must create at
      * least one serving config or placement for it. For more information, see
-     * [Managing serving configurations]
+     * [Manage serving configs]
      * (https://cloud.google.com/retail/docs/manage-configs).
      * The full list of available serving configs can be seen at
      * https://console.cloud.google.com/ai/retail/catalogs/default_catalog/configs
@@ -1454,7 +1452,7 @@ public Builder setPlacement(java.lang.String value) {
      * The ID of the Recommendations AI serving config or placement.
      * Before you can request predictions from your model, you must create at
      * least one serving config or placement for it. For more information, see
-     * [Managing serving configurations]
+     * [Manage serving configs]
      * (https://cloud.google.com/retail/docs/manage-configs).
      * The full list of available serving configs can be seen at
      * https://console.cloud.google.com/ai/retail/catalogs/default_catalog/configs
@@ -1483,7 +1481,7 @@ public Builder clearPlacement() {
      * The ID of the Recommendations AI serving config or placement.
      * Before you can request predictions from your model, you must create at
      * least one serving config or placement for it. For more information, see
-     * [Managing serving configurations]
+     * [Manage serving configs]
      * (https://cloud.google.com/retail/docs/manage-configs).
      * The full list of available serving configs can be seen at
      * https://console.cloud.google.com/ai/retail/catalogs/default_catalog/configs
@@ -1821,10 +1819,10 @@ public com.google.cloud.retail.v2alpha.UserEventOrBuilder getUserEventOrBuilder(
      *
      *
      * 
      -     * Maximum number of results to return per page. Set this property
-     * to the number of prediction results needed. If zero, the service will
-     * choose a reasonable default. The maximum allowed value is 100. Values
-     * above 100 will be coerced to 100.
+     * Maximum number of results to return. Set this property to the number of
+     * prediction results needed. If zero, the service will choose a reasonable
+     * default. The maximum allowed value is 100. Values above 100 will be coerced
+     * to 100.
      * 
      
      *
      * int32 page_size = 3;
@@ -1839,10 +1837,10 @@ public int getPageSize() {
      *
      *
      * 
      -     * Maximum number of results to return per page. Set this property
-     * to the number of prediction results needed. If zero, the service will
-     * choose a reasonable default. The maximum allowed value is 100. Values
-     * above 100 will be coerced to 100.
+     * Maximum number of results to return. Set this property to the number of
+     * prediction results needed. If zero, the service will choose a reasonable
+     * default. The maximum allowed value is 100. Values above 100 will be coerced
+     * to 100.
      * 
      
      *
      * int32 page_size = 3;
@@ -1860,10 +1858,10 @@ public Builder setPageSize(int value) {
      *
      *
      * 
      -     * Maximum number of results to return per page. Set this property
-     * to the number of prediction results needed. If zero, the service will
-     * choose a reasonable default. The maximum allowed value is 100. Values
-     * above 100 will be coerced to 100.
+     * Maximum number of results to return. Set this property to the number of
+     * prediction results needed. If zero, the service will choose a reasonable
+     * default. The maximum allowed value is 100. Values above 100 will be coerced
+     * to 100.
      * 
      
      *
      * int32 page_size = 3;
@@ -1882,13 +1880,13 @@ public Builder clearPageSize() {
      *
      *
      * 
      -     * This field is not used for now; leave it unset.
+     * This field is not used; leave it unset.
      * 
      
      *
      * string page_token = 4 [deprecated = true];
      *
      * @deprecated google.cloud.retail.v2alpha.PredictRequest.page_token is deprecated. See
-     *     google/cloud/retail/v2alpha/prediction_service.proto;l=93
+     *     google/cloud/retail/v2alpha/prediction_service.proto;l=94
      * @return The pageToken.
      */
     @java.lang.Deprecated
@@ -1907,13 +1905,13 @@ public java.lang.String getPageToken() {
      *
      *
      * 
      -     * This field is not used for now; leave it unset.
+     * This field is not used; leave it unset.
      * 
      
      *
      * string page_token = 4 [deprecated = true];
      *
      * @deprecated google.cloud.retail.v2alpha.PredictRequest.page_token is deprecated. See
-     *     google/cloud/retail/v2alpha/prediction_service.proto;l=93
+     *     google/cloud/retail/v2alpha/prediction_service.proto;l=94
      * @return The bytes for pageToken.
      */
     @java.lang.Deprecated
@@ -1932,13 +1930,13 @@ public com.google.protobuf.ByteString getPageTokenBytes() {
      *
      *
      * 
      -     * This field is not used for now; leave it unset.
+     * This field is not used; leave it unset.
      * 
      
      *
      * string page_token = 4 [deprecated = true];
      *
      * @deprecated google.cloud.retail.v2alpha.PredictRequest.page_token is deprecated. See
-     *     google/cloud/retail/v2alpha/prediction_service.proto;l=93
+     *     google/cloud/retail/v2alpha/prediction_service.proto;l=94
      * @param value The pageToken to set.
      * @return This builder for chaining.
      */
@@ -1956,13 +1954,13 @@ public Builder setPageToken(java.lang.String value) {
      *
      *
      * 
      -     * This field is not used for now; leave it unset.
+     * This field is not used; leave it unset.
      * 
      
      *
      * string page_token = 4 [deprecated = true];
      *
      * @deprecated google.cloud.retail.v2alpha.PredictRequest.page_token is deprecated. See
-     *     google/cloud/retail/v2alpha/prediction_service.proto;l=93
+     *     google/cloud/retail/v2alpha/prediction_service.proto;l=94
      * @return This builder for chaining.
      */
     @java.lang.Deprecated
@@ -1976,13 +1974,13 @@ public Builder clearPageToken() {
      *
      *
      * 
      -     * This field is not used for now; leave it unset.
+     * This field is not used; leave it unset.
      * 
      
      *
      * string page_token = 4 [deprecated = true];
      *
      * @deprecated google.cloud.retail.v2alpha.PredictRequest.page_token is deprecated. See
-     *     google/cloud/retail/v2alpha/prediction_service.proto;l=93
+     *     google/cloud/retail/v2alpha/prediction_service.proto;l=94
      * @param value The bytes for pageToken to set.
      * @return This builder for chaining.
      */
@@ -2020,12 +2018,11 @@ public Builder setPageTokenBytes(com.google.protobuf.ByteString value) {
      *  * tag=("Red" OR "Blue") tag="New-Arrival" tag=(NOT "promotional")
      *  * filterOutOfStockItems  tag=(-"promotional")
      *  * filterOutOfStockItems
-     * If your filter blocks all prediction results, the API will return generic
-     * (unfiltered) popular products. If you only want results strictly matching
-     * the filters, set `strictFiltering` to True in `PredictRequest.params` to
-     * receive empty results instead.
-     * Note that the API will never return items with storageStatus of "EXPIRED"
-     * or "DELETED" regardless of filter choices.
+     * If your filter blocks all prediction results, the API will return *no*
+     * results. If instead you want empty result sets to return generic
+     * (unfiltered) popular products, set `strictFiltering` to False in
+     * `PredictRequest.params`. Note that the API will never return items with
+     * storageStatus of "EXPIRED" or "DELETED" regardless of filter choices.
      * If `filterSyntaxV2` is set to true under the `params` field, then
      * attribute-based expressions are expected instead of the above described
      * tag-based syntax. Examples:
@@ -2070,12 +2067,11 @@ public java.lang.String getFilter() {
      *  * tag=("Red" OR "Blue") tag="New-Arrival" tag=(NOT "promotional")
      *  * filterOutOfStockItems  tag=(-"promotional")
      *  * filterOutOfStockItems
-     * If your filter blocks all prediction results, the API will return generic
-     * (unfiltered) popular products. If you only want results strictly matching
-     * the filters, set `strictFiltering` to True in `PredictRequest.params` to
-     * receive empty results instead.
-     * Note that the API will never return items with storageStatus of "EXPIRED"
-     * or "DELETED" regardless of filter choices.
+     * If your filter blocks all prediction results, the API will return *no*
+     * results. If instead you want empty result sets to return generic
+     * (unfiltered) popular products, set `strictFiltering` to False in
+     * `PredictRequest.params`. Note that the API will never return items with
+     * storageStatus of "EXPIRED" or "DELETED" regardless of filter choices.
      * If `filterSyntaxV2` is set to true under the `params` field, then
      * attribute-based expressions are expected instead of the above described
      * tag-based syntax. Examples:
@@ -2120,12 +2116,11 @@ public com.google.protobuf.ByteString getFilterBytes() {
      *  * tag=("Red" OR "Blue") tag="New-Arrival" tag=(NOT "promotional")
      *  * filterOutOfStockItems  tag=(-"promotional")
      *  * filterOutOfStockItems
-     * If your filter blocks all prediction results, the API will return generic
-     * (unfiltered) popular products. If you only want results strictly matching
-     * the filters, set `strictFiltering` to True in `PredictRequest.params` to
-     * receive empty results instead.
-     * Note that the API will never return items with storageStatus of "EXPIRED"
-     * or "DELETED" regardless of filter choices.
+     * If your filter blocks all prediction results, the API will return *no*
+     * results. If instead you want empty result sets to return generic
+     * (unfiltered) popular products, set `strictFiltering` to False in
+     * `PredictRequest.params`. Note that the API will never return items with
+     * storageStatus of "EXPIRED" or "DELETED" regardless of filter choices.
      * If `filterSyntaxV2` is set to true under the `params` field, then
      * attribute-based expressions are expected instead of the above described
      * tag-based syntax. Examples:
@@ -2169,12 +2164,11 @@ public Builder setFilter(java.lang.String value) {
      *  * tag=("Red" OR "Blue") tag="New-Arrival" tag=(NOT "promotional")
      *  * filterOutOfStockItems  tag=(-"promotional")
      *  * filterOutOfStockItems
-     * If your filter blocks all prediction results, the API will return generic
-     * (unfiltered) popular products. If you only want results strictly matching
-     * the filters, set `strictFiltering` to True in `PredictRequest.params` to
-     * receive empty results instead.
-     * Note that the API will never return items with storageStatus of "EXPIRED"
-     * or "DELETED" regardless of filter choices.
+     * If your filter blocks all prediction results, the API will return *no*
+     * results. If instead you want empty result sets to return generic
+     * (unfiltered) popular products, set `strictFiltering` to False in
+     * `PredictRequest.params`. Note that the API will never return items with
+     * storageStatus of "EXPIRED" or "DELETED" regardless of filter choices.
      * If `filterSyntaxV2` is set to true under the `params` field, then
      * attribute-based expressions are expected instead of the above described
      * tag-based syntax. Examples:
@@ -2214,12 +2208,11 @@ public Builder clearFilter() {
      *  * tag=("Red" OR "Blue") tag="New-Arrival" tag=(NOT "promotional")
      *  * filterOutOfStockItems  tag=(-"promotional")
      *  * filterOutOfStockItems
-     * If your filter blocks all prediction results, the API will return generic
-     * (unfiltered) popular products. If you only want results strictly matching
-     * the filters, set `strictFiltering` to True in `PredictRequest.params` to
-     * receive empty results instead.
-     * Note that the API will never return items with storageStatus of "EXPIRED"
-     * or "DELETED" regardless of filter choices.
+     * If your filter blocks all prediction results, the API will return *no*
+     * results. If instead you want empty result sets to return generic
+     * (unfiltered) popular products, set `strictFiltering` to False in
+     * `PredictRequest.params`. Note that the API will never return items with
+     * storageStatus of "EXPIRED" or "DELETED" regardless of filter choices.
      * If `filterSyntaxV2` is set to true under the `params` field, then
      * attribute-based expressions are expected instead of the above described
      * tag-based syntax. Examples:
@@ -2343,7 +2336,7 @@ public int getParamsCount() {
      * * `returnScore`: Boolean. If set to true, the prediction 'score'
      *    corresponding to each returned product will be set in the
      *    `results.metadata` field in the prediction response. The given
-     *    'score' indicates the probability of an product being clicked/purchased
+     *    'score' indicates the probability of a product being clicked/purchased
      *    given the user's context and history.
      * * `strictFiltering`: Boolean. True by default. If set to false, the service
      *    will return generic (unfiltered) popular products instead of empty if
@@ -2389,7 +2382,7 @@ public java.util.Map getParams() {
      * * `returnScore`: Boolean. If set to true, the prediction 'score'
      *    corresponding to each returned product will be set in the
      *    `results.metadata` field in the prediction response. The given
-     *    'score' indicates the probability of an product being clicked/purchased
+     *    'score' indicates the probability of a product being clicked/purchased
      *    given the user's context and history.
      * * `strictFiltering`: Boolean. True by default. If set to false, the service
      *    will return generic (unfiltered) popular products instead of empty if
@@ -2426,7 +2419,7 @@ public java.util.Map getParamsMap()
      * * `returnScore`: Boolean. If set to true, the prediction 'score'
      *    corresponding to each returned product will be set in the
      *    `results.metadata` field in the prediction response. The given
-     *    'score' indicates the probability of an product being clicked/purchased
+     *    'score' indicates the probability of a product being clicked/purchased
      *    given the user's context and history.
      * * `strictFiltering`: Boolean. True by default. If set to false, the service
      *    will return generic (unfiltered) popular products instead of empty if
@@ -2468,7 +2461,7 @@ public com.google.protobuf.Value getParamsOrDefault(
      * * `returnScore`: Boolean. If set to true, the prediction 'score'
      *    corresponding to each returned product will be set in the
      *    `results.metadata` field in the prediction response. The given
-     *    'score' indicates the probability of an product being clicked/purchased
+     *    'score' indicates the probability of a product being clicked/purchased
      *    given the user's context and history.
      * * `strictFiltering`: Boolean. True by default. If set to false, the service
      *    will return generic (unfiltered) popular products instead of empty if
@@ -2517,7 +2510,7 @@ public Builder clearParams() {
      * * `returnScore`: Boolean. If set to true, the prediction 'score'
      *    corresponding to each returned product will be set in the
      *    `results.metadata` field in the prediction response. The given
-     *    'score' indicates the probability of an product being clicked/purchased
+     *    'score' indicates the probability of a product being clicked/purchased
      *    given the user's context and history.
      * * `strictFiltering`: Boolean. True by default. If set to false, the service
      *    will return generic (unfiltered) popular products instead of empty if
@@ -2562,7 +2555,7 @@ public java.util.Map getMutablePara
      * * `returnScore`: Boolean. If set to true, the prediction 'score'
      *    corresponding to each returned product will be set in the
      *    `results.metadata` field in the prediction response. The given
-     *    'score' indicates the probability of an product being clicked/purchased
+     *    'score' indicates the probability of a product being clicked/purchased
      *    given the user's context and history.
      * * `strictFiltering`: Boolean. True by default. If set to false, the service
      *    will return generic (unfiltered) popular products instead of empty if
@@ -2606,7 +2599,7 @@ public Builder putParams(java.lang.String key, com.google.protobuf.Value value)
      * * `returnScore`: Boolean. If set to true, the prediction 'score'
      *    corresponding to each returned product will be set in the
      *    `results.metadata` field in the prediction response. The given
-     *    'score' indicates the probability of an product being clicked/purchased
+     *    'score' indicates the probability of a product being clicked/purchased
      *    given the user's context and history.
      * * `strictFiltering`: Boolean. True by default. If set to false, the service
      *    will return generic (unfiltered) popular products instead of empty if
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/PredictRequestOrBuilder.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/PredictRequestOrBuilder.java
index 0adcd91df474..601b792e6c3b 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/PredictRequestOrBuilder.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/PredictRequestOrBuilder.java
@@ -36,7 +36,7 @@ public interface PredictRequestOrBuilder
    * The ID of the Recommendations AI serving config or placement.
    * Before you can request predictions from your model, you must create at
    * least one serving config or placement for it. For more information, see
-   * [Managing serving configurations]
+   * [Manage serving configs]
    * (https://cloud.google.com/retail/docs/manage-configs).
    * The full list of available serving configs can be seen at
    * https://console.cloud.google.com/ai/retail/catalogs/default_catalog/configs
@@ -60,7 +60,7 @@ public interface PredictRequestOrBuilder
    * The ID of the Recommendations AI serving config or placement.
    * Before you can request predictions from your model, you must create at
    * least one serving config or placement for it. For more information, see
-   * [Managing serving configurations]
+   * [Manage serving configs]
    * (https://cloud.google.com/retail/docs/manage-configs).
    * The full list of available serving configs can be seen at
    * https://console.cloud.google.com/ai/retail/catalogs/default_catalog/configs
@@ -153,10 +153,10 @@ public interface PredictRequestOrBuilder
    *
    *
    * 
      -   * Maximum number of results to return per page. Set this property
-   * to the number of prediction results needed. If zero, the service will
-   * choose a reasonable default. The maximum allowed value is 100. Values
-   * above 100 will be coerced to 100.
+   * Maximum number of results to return. Set this property to the number of
+   * prediction results needed. If zero, the service will choose a reasonable
+   * default. The maximum allowed value is 100. Values above 100 will be coerced
+   * to 100.
    * 
      
    *
    * int32 page_size = 3;
@@ -169,13 +169,13 @@ public interface PredictRequestOrBuilder
    *
    *
    * 
      -   * This field is not used for now; leave it unset.
+   * This field is not used; leave it unset.
    * 
      
    *
    * string page_token = 4 [deprecated = true];
    *
    * @deprecated google.cloud.retail.v2alpha.PredictRequest.page_token is deprecated. See
-   *     google/cloud/retail/v2alpha/prediction_service.proto;l=93
+   *     google/cloud/retail/v2alpha/prediction_service.proto;l=94
    * @return The pageToken.
    */
   @java.lang.Deprecated
@@ -184,13 +184,13 @@ public interface PredictRequestOrBuilder
    *
    *
    * 
      -   * This field is not used for now; leave it unset.
+   * This field is not used; leave it unset.
    * 
      
    *
    * string page_token = 4 [deprecated = true];
    *
    * @deprecated google.cloud.retail.v2alpha.PredictRequest.page_token is deprecated. See
-   *     google/cloud/retail/v2alpha/prediction_service.proto;l=93
+   *     google/cloud/retail/v2alpha/prediction_service.proto;l=94
    * @return The bytes for pageToken.
    */
   @java.lang.Deprecated
@@ -217,12 +217,11 @@ public interface PredictRequestOrBuilder
    *  * tag=("Red" OR "Blue") tag="New-Arrival" tag=(NOT "promotional")
    *  * filterOutOfStockItems  tag=(-"promotional")
    *  * filterOutOfStockItems
-   * If your filter blocks all prediction results, the API will return generic
-   * (unfiltered) popular products. If you only want results strictly matching
-   * the filters, set `strictFiltering` to True in `PredictRequest.params` to
-   * receive empty results instead.
-   * Note that the API will never return items with storageStatus of "EXPIRED"
-   * or "DELETED" regardless of filter choices.
+   * If your filter blocks all prediction results, the API will return *no*
+   * results. If instead you want empty result sets to return generic
+   * (unfiltered) popular products, set `strictFiltering` to False in
+   * `PredictRequest.params`. Note that the API will never return items with
+   * storageStatus of "EXPIRED" or "DELETED" regardless of filter choices.
    * If `filterSyntaxV2` is set to true under the `params` field, then
    * attribute-based expressions are expected instead of the above described
    * tag-based syntax. Examples:
@@ -257,12 +256,11 @@ public interface PredictRequestOrBuilder
    *  * tag=("Red" OR "Blue") tag="New-Arrival" tag=(NOT "promotional")
    *  * filterOutOfStockItems  tag=(-"promotional")
    *  * filterOutOfStockItems
-   * If your filter blocks all prediction results, the API will return generic
-   * (unfiltered) popular products. If you only want results strictly matching
-   * the filters, set `strictFiltering` to True in `PredictRequest.params` to
-   * receive empty results instead.
-   * Note that the API will never return items with storageStatus of "EXPIRED"
-   * or "DELETED" regardless of filter choices.
+   * If your filter blocks all prediction results, the API will return *no*
+   * results. If instead you want empty result sets to return generic
+   * (unfiltered) popular products, set `strictFiltering` to False in
+   * `PredictRequest.params`. Note that the API will never return items with
+   * storageStatus of "EXPIRED" or "DELETED" regardless of filter choices.
    * If `filterSyntaxV2` is set to true under the `params` field, then
    * attribute-based expressions are expected instead of the above described
    * tag-based syntax. Examples:
@@ -305,7 +303,7 @@ public interface PredictRequestOrBuilder
    * * `returnScore`: Boolean. If set to true, the prediction 'score'
    *    corresponding to each returned product will be set in the
    *    `results.metadata` field in the prediction response. The given
-   *    'score' indicates the probability of an product being clicked/purchased
+   *    'score' indicates the probability of a product being clicked/purchased
    *    given the user's context and history.
    * * `strictFiltering`: Boolean. True by default. If set to false, the service
    *    will return generic (unfiltered) popular products instead of empty if
@@ -339,7 +337,7 @@ public interface PredictRequestOrBuilder
    * * `returnScore`: Boolean. If set to true, the prediction 'score'
    *    corresponding to each returned product will be set in the
    *    `results.metadata` field in the prediction response. The given
-   *    'score' indicates the probability of an product being clicked/purchased
+   *    'score' indicates the probability of a product being clicked/purchased
    *    given the user's context and history.
    * * `strictFiltering`: Boolean. True by default. If set to false, the service
    *    will return generic (unfiltered) popular products instead of empty if
@@ -376,7 +374,7 @@ public interface PredictRequestOrBuilder
    * * `returnScore`: Boolean. If set to true, the prediction 'score'
    *    corresponding to each returned product will be set in the
    *    `results.metadata` field in the prediction response. The given
-   *    'score' indicates the probability of an product being clicked/purchased
+   *    'score' indicates the probability of a product being clicked/purchased
    *    given the user's context and history.
    * * `strictFiltering`: Boolean. True by default. If set to false, the service
    *    will return generic (unfiltered) popular products instead of empty if
@@ -410,7 +408,7 @@ public interface PredictRequestOrBuilder
    * * `returnScore`: Boolean. If set to true, the prediction 'score'
    *    corresponding to each returned product will be set in the
    *    `results.metadata` field in the prediction response. The given
-   *    'score' indicates the probability of an product being clicked/purchased
+   *    'score' indicates the probability of a product being clicked/purchased
    *    given the user's context and history.
    * * `strictFiltering`: Boolean. True by default. If set to false, the service
    *    will return generic (unfiltered) popular products instead of empty if
@@ -449,7 +447,7 @@ com.google.protobuf.Value getParamsOrDefault(
    * * `returnScore`: Boolean. If set to true, the prediction 'score'
    *    corresponding to each returned product will be set in the
    *    `results.metadata` field in the prediction response. The given
-   *    'score' indicates the probability of an product being clicked/purchased
+   *    'score' indicates the probability of a product being clicked/purchased
    *    given the user's context and history.
    * * `strictFiltering`: Boolean. True by default. If set to false, the service
    *    will return generic (unfiltered) popular products instead of empty if
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/PredictionServiceProto.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/PredictionServiceProto.java
index 97e756dae900..cb5bcab8ace4 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/PredictionServiceProto.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/PredictionServiceProto.java
@@ -64,45 +64,45 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
           + "_service.proto\022\033google.cloud.retail.v2al"
           + "pha\032\034google/api/annotations.proto\032\027googl"
           + "e/api/client.proto\032\037google/api/field_beh"
-          + "avior.proto\032,google/cloud/retail/v2alpha"
-          + "/user_event.proto\032\034google/protobuf/struc"
-          + "t.proto\"\303\003\n\016PredictRequest\022\026\n\tplacement\030"
-          + "\001 \001(\tB\003\340A\002\022?\n\nuser_event\030\002 \001(\0132&.google."
-          + "cloud.retail.v2alpha.UserEventB\003\340A\002\022\021\n\tp"
-          + "age_size\030\003 \001(\005\022\026\n\npage_token\030\004 \001(\tB\002\030\001\022\016"
-          + "\n\006filter\030\005 \001(\t\022\025\n\rvalidate_only\030\006 \001(\010\022G\n"
-          + "\006params\030\007 \003(\01327.google.cloud.retail.v2al"
-          + "pha.PredictRequest.ParamsEntry\022G\n\006labels"
-          + "\030\010 \003(\01327.google.cloud.retail.v2alpha.Pre"
-          + "dictRequest.LabelsEntry\032E\n\013ParamsEntry\022\013"
-          + "\n\003key\030\001 \001(\t\022%\n\005value\030\002 \001(\0132\026.google.prot"
-          + "obuf.Value:\0028\001\032-\n\013LabelsEntry\022\013\n\003key\030\001 \001"
-          + "(\t\022\r\n\005value\030\002 \001(\t:\0028\001\"\361\002\n\017PredictRespons"
-          + "e\022N\n\007results\030\001 \003(\0132=.google.cloud.retail"
-          + ".v2alpha.PredictResponse.PredictionResul"
-          + "t\022\031\n\021attribution_token\030\002 \001(\t\022\023\n\013missing_"
-          + "ids\030\003 \003(\t\022\025\n\rvalidate_only\030\004 \001(\010\032\306\001\n\020Pre"
-          + "dictionResult\022\n\n\002id\030\001 \001(\t\022]\n\010metadata\030\002 "
-          + "\003(\0132K.google.cloud.retail.v2alpha.Predic"
-          + "tResponse.PredictionResult.MetadataEntry"
-          + "\032G\n\rMetadataEntry\022\013\n\003key\030\001 \001(\t\022%\n\005value\030"
-          + "\002 \001(\0132\026.google.protobuf.Value:\0028\0012\365\002\n\021Pr"
-          + "edictionService\022\224\002\n\007Predict\022+.google.clo"
-          + "ud.retail.v2alpha.PredictRequest\032,.googl"
-          + "e.cloud.retail.v2alpha.PredictResponse\"\255"
-          + "\001\202\323\344\223\002\246\001\"K/v2alpha/{placement=projects/*"
-          + "/locations/*/catalogs/*/placements/*}:pr"
-          + "edict:\001*ZT\"O/v2alpha/{placement=projects"
-          + "/*/locations/*/catalogs/*/servingConfigs"
-          + "/*}:predict:\001*\032I\312A\025retail.googleapis.com"
-          + "\322A.https://www.googleapis.com/auth/cloud"
-          + "-platformB\344\001\n\037com.google.cloud.retail.v2"
-          + "alphaB\026PredictionServiceProtoP\001ZAgoogle."
-          + "golang.org/genproto/googleapis/cloud/ret"
-          + "ail/v2alpha;retail\242\002\006RETAIL\252\002\033Google.Clo"
-          + "ud.Retail.V2Alpha\312\002\033Google\\Cloud\\Retail\\"
-          + "V2alpha\352\002\036Google::Cloud::Retail::V2alpha"
-          + "b\006proto3"
+          + "avior.proto\032\031google/api/resource.proto\032,"
+          + "google/cloud/retail/v2alpha/user_event.p"
+          + "roto\032\034google/protobuf/struct.proto\"\303\003\n\016P"
+          + "redictRequest\022\026\n\tplacement\030\001 \001(\tB\003\340A\002\022?\n"
+          + "\nuser_event\030\002 \001(\0132&.google.cloud.retail."
+          + "v2alpha.UserEventB\003\340A\002\022\021\n\tpage_size\030\003 \001("
+          + "\005\022\026\n\npage_token\030\004 \001(\tB\002\030\001\022\016\n\006filter\030\005 \001("
+          + "\t\022\025\n\rvalidate_only\030\006 \001(\010\022G\n\006params\030\007 \003(\013"
+          + "27.google.cloud.retail.v2alpha.PredictRe"
+          + "quest.ParamsEntry\022G\n\006labels\030\010 \003(\01327.goog"
+          + "le.cloud.retail.v2alpha.PredictRequest.L"
+          + "abelsEntry\032E\n\013ParamsEntry\022\013\n\003key\030\001 \001(\t\022%"
+          + "\n\005value\030\002 \001(\0132\026.google.protobuf.Value:\0028"
+          + "\001\032-\n\013LabelsEntry\022\013\n\003key\030\001 \001(\t\022\r\n\005value\030\002"
+          + " \001(\t:\0028\001\"\361\002\n\017PredictResponse\022N\n\007results\030"
+          + "\001 \003(\0132=.google.cloud.retail.v2alpha.Pred"
+          + "ictResponse.PredictionResult\022\031\n\021attribut"
+          + "ion_token\030\002 \001(\t\022\023\n\013missing_ids\030\003 \003(\t\022\025\n\r"
+          + "validate_only\030\004 \001(\010\032\306\001\n\020PredictionResult"
+          + "\022\n\n\002id\030\001 \001(\t\022]\n\010metadata\030\002 \003(\0132K.google."
+          + "cloud.retail.v2alpha.PredictResponse.Pre"
+          + "dictionResult.MetadataEntry\032G\n\rMetadataE"
+          + "ntry\022\013\n\003key\030\001 \001(\t\022%\n\005value\030\002 \001(\0132\026.googl"
+          + "e.protobuf.Value:\0028\0012\365\002\n\021PredictionServi"
+          + "ce\022\224\002\n\007Predict\022+.google.cloud.retail.v2a"
+          + "lpha.PredictRequest\032,.google.cloud.retai"
+          + "l.v2alpha.PredictResponse\"\255\001\202\323\344\223\002\246\001\"K/v2"
+          + "alpha/{placement=projects/*/locations/*/"
+          + "catalogs/*/placements/*}:predict:\001*ZT\"O/"
+          + "v2alpha/{placement=projects/*/locations/"
+          + "*/catalogs/*/servingConfigs/*}:predict:\001"
+          + "*\032I\312A\025retail.googleapis.com\322A.https://ww"
+          + "w.googleapis.com/auth/cloud-platformB\344\001\n"
+          + "\037com.google.cloud.retail.v2alphaB\026Predic"
+          + "tionServiceProtoP\001ZAgoogle.golang.org/ge"
+          + "nproto/googleapis/cloud/retail/v2alpha;r"
+          + "etail\242\002\006RETAIL\252\002\033Google.Cloud.Retail.V2A"
+          + "lpha\312\002\033Google\\Cloud\\Retail\\V2alpha\352\002\036Goo"
+          + "gle::Cloud::Retail::V2alphab\006proto3"
     };
     descriptor =
         com.google.protobuf.Descriptors.FileDescriptor.internalBuildGeneratedFileFrom(
@@ -111,6 +111,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
               com.google.api.AnnotationsProto.getDescriptor(),
               com.google.api.ClientProto.getDescriptor(),
               com.google.api.FieldBehaviorProto.getDescriptor(),
+              com.google.api.ResourceProto.getDescriptor(),
               com.google.cloud.retail.v2alpha.UserEventProto.getDescriptor(),
               com.google.protobuf.StructProto.getDescriptor(),
             });
@@ -188,6 +189,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
     com.google.api.AnnotationsProto.getDescriptor();
     com.google.api.ClientProto.getDescriptor();
     com.google.api.FieldBehaviorProto.getDescriptor();
+    com.google.api.ResourceProto.getDescriptor();
     com.google.cloud.retail.v2alpha.UserEventProto.getDescriptor();
     com.google.protobuf.StructProto.getDescriptor();
   }
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/Product.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/Product.java
index 857282bc1d30..5859a5a9e2f3 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/Product.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/Product.java
@@ -61,6 +61,7 @@ private Product() {
     conditions_ = com.google.protobuf.LazyStringArrayList.EMPTY;
     promotions_ = java.util.Collections.emptyList();
     variants_ = java.util.Collections.emptyList();
+    localInventories_ = java.util.Collections.emptyList();
   }
 
   @java.lang.Override
@@ -575,6 +576,13 @@ public ExpirationCase getExpirationCase() {
    * 
          * The timestamp when this product becomes unavailable for
    * [SearchService.Search][google.cloud.retail.v2alpha.SearchService.Search].
+   * Note that this is only applicable to
+   * [Type.PRIMARY][google.cloud.retail.v2alpha.Product.Type.PRIMARY] and
+   * [Type.COLLECTION][google.cloud.retail.v2alpha.Product.Type.COLLECTION],
+   * and ignored for
+   * [Type.VARIANT][google.cloud.retail.v2alpha.Product.Type.VARIANT]. In
+   * general, we suggest the users to delete the stale products explicitly,
+   * instead of using this field to determine staleness.
    * If it is set, the [Product][google.cloud.retail.v2alpha.Product] is not
    * available for
    * [SearchService.Search][google.cloud.retail.v2alpha.SearchService.Search]
@@ -606,6 +614,13 @@ public boolean hasExpireTime() {
    * 
          * The timestamp when this product becomes unavailable for
    * [SearchService.Search][google.cloud.retail.v2alpha.SearchService.Search].
+   * Note that this is only applicable to
+   * [Type.PRIMARY][google.cloud.retail.v2alpha.Product.Type.PRIMARY] and
+   * [Type.COLLECTION][google.cloud.retail.v2alpha.Product.Type.COLLECTION],
+   * and ignored for
+   * [Type.VARIANT][google.cloud.retail.v2alpha.Product.Type.VARIANT]. In
+   * general, we suggest the users to delete the stale products explicitly,
+   * instead of using this field to determine staleness.
    * If it is set, the [Product][google.cloud.retail.v2alpha.Product] is not
    * available for
    * [SearchService.Search][google.cloud.retail.v2alpha.SearchService.Search]
@@ -640,6 +655,13 @@ public com.google.protobuf.Timestamp getExpireTime() {
    * 
          * The timestamp when this product becomes unavailable for
    * [SearchService.Search][google.cloud.retail.v2alpha.SearchService.Search].
+   * Note that this is only applicable to
+   * [Type.PRIMARY][google.cloud.retail.v2alpha.Product.Type.PRIMARY] and
+   * [Type.COLLECTION][google.cloud.retail.v2alpha.Product.Type.COLLECTION],
+   * and ignored for
+   * [Type.VARIANT][google.cloud.retail.v2alpha.Product.Type.VARIANT]. In
+   * general, we suggest the users to delete the stale products explicitly,
+   * instead of using this field to determine staleness.
    * If it is set, the [Product][google.cloud.retail.v2alpha.Product] is not
    * available for
    * [SearchService.Search][google.cloud.retail.v2alpha.SearchService.Search]
@@ -672,7 +694,14 @@ public com.google.protobuf.TimestampOrBuilder getExpireTimeOrBuilder() {
    *
    *
    * 
      -   * Input only. The TTL (time to live) of the product.
+   * Input only. The TTL (time to live) of the product. Note that this is only
+   * applicable to
+   * [Type.PRIMARY][google.cloud.retail.v2alpha.Product.Type.PRIMARY] and
+   * [Type.COLLECTION][google.cloud.retail.v2alpha.Product.Type.COLLECTION],
+   * and ignored for
+   * [Type.VARIANT][google.cloud.retail.v2alpha.Product.Type.VARIANT]. In
+   * general, we suggest the users to delete the stale products explicitly,
+   * instead of using this field to determine staleness.
    * If it is set, it must be a non-negative value, and
    * [expire_time][google.cloud.retail.v2alpha.Product.expire_time] is set as
    * current timestamp plus [ttl][google.cloud.retail.v2alpha.Product.ttl].
@@ -703,7 +732,14 @@ public boolean hasTtl() {
    *
    *
    * 
      -   * Input only. The TTL (time to live) of the product.
+   * Input only. The TTL (time to live) of the product. Note that this is only
+   * applicable to
+   * [Type.PRIMARY][google.cloud.retail.v2alpha.Product.Type.PRIMARY] and
+   * [Type.COLLECTION][google.cloud.retail.v2alpha.Product.Type.COLLECTION],
+   * and ignored for
+   * [Type.VARIANT][google.cloud.retail.v2alpha.Product.Type.VARIANT]. In
+   * general, we suggest the users to delete the stale products explicitly,
+   * instead of using this field to determine staleness.
    * If it is set, it must be a non-negative value, and
    * [expire_time][google.cloud.retail.v2alpha.Product.expire_time] is set as
    * current timestamp plus [ttl][google.cloud.retail.v2alpha.Product.ttl].
@@ -737,7 +773,14 @@ public com.google.protobuf.Duration getTtl() {
    *
    *
    * 
      -   * Input only. The TTL (time to live) of the product.
+   * Input only. The TTL (time to live) of the product. Note that this is only
+   * applicable to
+   * [Type.PRIMARY][google.cloud.retail.v2alpha.Product.Type.PRIMARY] and
+   * [Type.COLLECTION][google.cloud.retail.v2alpha.Product.Type.COLLECTION],
+   * and ignored for
+   * [Type.VARIANT][google.cloud.retail.v2alpha.Product.Type.VARIANT]. In
+   * general, we suggest the users to delete the stale products explicitly,
+   * instead of using this field to determine staleness.
    * If it is set, it must be a non-negative value, and
    * [expire_time][google.cloud.retail.v2alpha.Product.expire_time] is set as
    * current timestamp plus [ttl][google.cloud.retail.v2alpha.Product.ttl].
@@ -1020,7 +1063,7 @@ public com.google.protobuf.ByteString getPrimaryProductIdBytes() {
    * The [type][google.cloud.retail.v2alpha.Product.type] of the members must be
    * either [Type.PRIMARY][google.cloud.retail.v2alpha.Product.Type.PRIMARY] or
    * [Type.VARIANT][google.cloud.retail.v2alpha.Product.Type.VARIANT] otherwise
-   * and INVALID_ARGUMENT error is thrown. Should not set it for other types. A
+   * an INVALID_ARGUMENT error is thrown. Should not set it for other types. A
    * maximum of 1000 values are allowed. Otherwise, an INVALID_ARGUMENT error is
    * return.
    * 
      
@@ -1043,7 +1086,7 @@ public com.google.protobuf.ProtocolStringList getCollectionMemberIdsList() {
    * The [type][google.cloud.retail.v2alpha.Product.type] of the members must be
    * either [Type.PRIMARY][google.cloud.retail.v2alpha.Product.Type.PRIMARY] or
    * [Type.VARIANT][google.cloud.retail.v2alpha.Product.Type.VARIANT] otherwise
-   * and INVALID_ARGUMENT error is thrown. Should not set it for other types. A
+   * an INVALID_ARGUMENT error is thrown. Should not set it for other types. A
    * maximum of 1000 values are allowed. Otherwise, an INVALID_ARGUMENT error is
    * return.
    * 
      
@@ -1066,7 +1109,7 @@ public int getCollectionMemberIdsCount() {
    * The [type][google.cloud.retail.v2alpha.Product.type] of the members must be
    * either [Type.PRIMARY][google.cloud.retail.v2alpha.Product.Type.PRIMARY] or
    * [Type.VARIANT][google.cloud.retail.v2alpha.Product.Type.VARIANT] otherwise
-   * and INVALID_ARGUMENT error is thrown. Should not set it for other types. A
+   * an INVALID_ARGUMENT error is thrown. Should not set it for other types. A
    * maximum of 1000 values are allowed. Otherwise, an INVALID_ARGUMENT error is
    * return.
    * 
      
@@ -1090,7 +1133,7 @@ public java.lang.String getCollectionMemberIds(int index) {
    * The [type][google.cloud.retail.v2alpha.Product.type] of the members must be
    * either [Type.PRIMARY][google.cloud.retail.v2alpha.Product.Type.PRIMARY] or
    * [Type.VARIANT][google.cloud.retail.v2alpha.Product.Type.VARIANT] otherwise
-   * and INVALID_ARGUMENT error is thrown. Should not set it for other types. A
+   * an INVALID_ARGUMENT error is thrown. Should not set it for other types. A
    * maximum of 1000 values are allowed. Otherwise, an INVALID_ARGUMENT error is
    * return.
    * 
      
@@ -1189,7 +1232,7 @@ public com.google.protobuf.ByteString getGtinBytes() {
    * belonging to several parallel categories. Strongly recommended using the
    * full path for better search / recommendation quality.
    * To represent full path of category, use '>' sign to separate different
-   * hierarchies. If '>' is part of the category name, please replace it with
+   * hierarchies. If '>' is part of the category name, replace it with
    * other character(s).
    * For example, if a shoes product belongs to both
    * ["Shoes & Accessories" -> "Shoes"] and
@@ -1229,7 +1272,7 @@ public com.google.protobuf.ProtocolStringList getCategoriesList() {
    * belonging to several parallel categories. Strongly recommended using the
    * full path for better search / recommendation quality.
    * To represent full path of category, use '>' sign to separate different
-   * hierarchies. If '>' is part of the category name, please replace it with
+   * hierarchies. If '>' is part of the category name, replace it with
    * other character(s).
    * For example, if a shoes product belongs to both
    * ["Shoes & Accessories" -> "Shoes"] and
@@ -1269,7 +1312,7 @@ public int getCategoriesCount() {
    * belonging to several parallel categories. Strongly recommended using the
    * full path for better search / recommendation quality.
    * To represent full path of category, use '>' sign to separate different
-   * hierarchies. If '>' is part of the category name, please replace it with
+   * hierarchies. If '>' is part of the category name, replace it with
    * other character(s).
    * For example, if a shoes product belongs to both
    * ["Shoes & Accessories" -> "Shoes"] and
@@ -1310,7 +1353,7 @@ public java.lang.String getCategories(int index) {
    * belonging to several parallel categories. Strongly recommended using the
    * full path for better search / recommendation quality.
    * To represent full path of category, use '>' sign to separate different
-   * hierarchies. If '>' is part of the category name, please replace it with
+   * hierarchies. If '>' is part of the category name, replace it with
    * other character(s).
    * For example, if a shoes product belongs to both
    * ["Shoes & Accessories" -> "Shoes"] and
@@ -2022,6 +2065,11 @@ public com.google.cloud.retail.v2alpha.RatingOrBuilder getRatingOrBuilder() {
    * The timestamp when this [Product][google.cloud.retail.v2alpha.Product]
    * becomes available for
    * [SearchService.Search][google.cloud.retail.v2alpha.SearchService.Search].
+   * Note that this is only applicable to
+   * [Type.PRIMARY][google.cloud.retail.v2alpha.Product.Type.PRIMARY] and
+   * [Type.COLLECTION][google.cloud.retail.v2alpha.Product.Type.COLLECTION], and
+   * ignored for
+   * [Type.VARIANT][google.cloud.retail.v2alpha.Product.Type.VARIANT].
    * 
      
    *
    * .google.protobuf.Timestamp available_time = 18;
@@ -2039,6 +2087,11 @@ public boolean hasAvailableTime() {
    * The timestamp when this [Product][google.cloud.retail.v2alpha.Product]
    * becomes available for
    * [SearchService.Search][google.cloud.retail.v2alpha.SearchService.Search].
+   * Note that this is only applicable to
+   * [Type.PRIMARY][google.cloud.retail.v2alpha.Product.Type.PRIMARY] and
+   * [Type.COLLECTION][google.cloud.retail.v2alpha.Product.Type.COLLECTION], and
+   * ignored for
+   * [Type.VARIANT][google.cloud.retail.v2alpha.Product.Type.VARIANT].
    * 
      
    *
    * .google.protobuf.Timestamp available_time = 18;
@@ -2058,6 +2111,11 @@ public com.google.protobuf.Timestamp getAvailableTime() {
    * The timestamp when this [Product][google.cloud.retail.v2alpha.Product]
    * becomes available for
    * [SearchService.Search][google.cloud.retail.v2alpha.SearchService.Search].
+   * Note that this is only applicable to
+   * [Type.PRIMARY][google.cloud.retail.v2alpha.Product.Type.PRIMARY] and
+   * [Type.COLLECTION][google.cloud.retail.v2alpha.Product.Type.COLLECTION], and
+   * ignored for
+   * [Type.VARIANT][google.cloud.retail.v2alpha.Product.Type.VARIANT].
    * 
      
    *
    * .google.protobuf.Timestamp available_time = 18;
@@ -3107,13 +3165,17 @@ public com.google.protobuf.TimestampOrBuilder getPublishTimeOrBuilder() {
    * Note: Returning more fields in
    * [SearchResponse][google.cloud.retail.v2alpha.SearchResponse] can increase
    * response payload size and serving latency.
+   * This field is deprecated. Use the retrievable site-wide control instead.
    * 
      
    *
-   * .google.protobuf.FieldMask retrievable_fields = 30;
+   * .google.protobuf.FieldMask retrievable_fields = 30 [deprecated = true];
    *
+   * @deprecated google.cloud.retail.v2alpha.Product.retrievable_fields is deprecated. See
+   *     google/cloud/retail/v2alpha/product.proto;l=574
    * @return Whether the retrievableFields field is set.
    */
   @java.lang.Override
+  @java.lang.Deprecated
   public boolean hasRetrievableFields() {
     return retrievableFields_ != null;
   }
@@ -3167,13 +3229,17 @@ public boolean hasRetrievableFields() {
    * Note: Returning more fields in
    * [SearchResponse][google.cloud.retail.v2alpha.SearchResponse] can increase
    * response payload size and serving latency.
+   * This field is deprecated. Use the retrievable site-wide control instead.
    * 
      
    *
-   * .google.protobuf.FieldMask retrievable_fields = 30;
+   * .google.protobuf.FieldMask retrievable_fields = 30 [deprecated = true];
    *
+   * @deprecated google.cloud.retail.v2alpha.Product.retrievable_fields is deprecated. See
+   *     google/cloud/retail/v2alpha/product.proto;l=574
    * @return The retrievableFields.
    */
   @java.lang.Override
+  @java.lang.Deprecated
   public com.google.protobuf.FieldMask getRetrievableFields() {
     return retrievableFields_ == null
         ? com.google.protobuf.FieldMask.getDefaultInstance()
@@ -3229,11 +3295,13 @@ public com.google.protobuf.FieldMask getRetrievableFields() {
    * Note: Returning more fields in
    * [SearchResponse][google.cloud.retail.v2alpha.SearchResponse] can increase
    * response payload size and serving latency.
+   * This field is deprecated. Use the retrievable site-wide control instead.
    * 
      
    *
-   * .google.protobuf.FieldMask retrievable_fields = 30;
+   * .google.protobuf.FieldMask retrievable_fields = 30 [deprecated = true];
    */
   @java.lang.Override
+  @java.lang.Deprecated
   public com.google.protobuf.FieldMaskOrBuilder getRetrievableFieldsOrBuilder() {
     return getRetrievableFields();
   }
@@ -3357,6 +3425,116 @@ public com.google.cloud.retail.v2alpha.ProductOrBuilder getVariantsOrBuilder(int
     return variants_.get(index);
   }
 
+  public static final int LOCAL_INVENTORIES_FIELD_NUMBER = 35;
+  private java.util.List localInventories_;
+  /**
+   *
+   *
+   * 
      +   * Output only. A list of local inventories specific to different places.
+   * This is only available for users who have Retail Search enabled, and it can
+   * be managed by
+   * [ProductService.AddLocalInventories][google.cloud.retail.v2alpha.ProductService.AddLocalInventories]
+   * and
+   * [ProductService.RemoveLocalInventories][google.cloud.retail.v2alpha.ProductService.RemoveLocalInventories]
+   * APIs.
+   * 
      
+   *
+   * 
+   * repeated .google.cloud.retail.v2alpha.LocalInventory local_inventories = 35 [(.google.api.field_behavior) = OUTPUT_ONLY];
+   * 
+   */
+  @java.lang.Override
+  public java.util.List getLocalInventoriesList() {
+    return localInventories_;
+  }
+  /**
+   *
+   *
+   * 
      +   * Output only. A list of local inventories specific to different places.
+   * This is only available for users who have Retail Search enabled, and it can
+   * be managed by
+   * [ProductService.AddLocalInventories][google.cloud.retail.v2alpha.ProductService.AddLocalInventories]
+   * and
+   * [ProductService.RemoveLocalInventories][google.cloud.retail.v2alpha.ProductService.RemoveLocalInventories]
+   * APIs.
+   * 
      
+   *
+   * 
+   * repeated .google.cloud.retail.v2alpha.LocalInventory local_inventories = 35 [(.google.api.field_behavior) = OUTPUT_ONLY];
+   * 
+   */
+  @java.lang.Override
+  public java.util.List
+      getLocalInventoriesOrBuilderList() {
+    return localInventories_;
+  }
+  /**
+   *
+   *
+   * 
      +   * Output only. A list of local inventories specific to different places.
+   * This is only available for users who have Retail Search enabled, and it can
+   * be managed by
+   * [ProductService.AddLocalInventories][google.cloud.retail.v2alpha.ProductService.AddLocalInventories]
+   * and
+   * [ProductService.RemoveLocalInventories][google.cloud.retail.v2alpha.ProductService.RemoveLocalInventories]
+   * APIs.
+   * 
      
+   *
+   * 
+   * repeated .google.cloud.retail.v2alpha.LocalInventory local_inventories = 35 [(.google.api.field_behavior) = OUTPUT_ONLY];
+   * 
+   */
+  @java.lang.Override
+  public int getLocalInventoriesCount() {
+    return localInventories_.size();
+  }
+  /**
+   *
+   *
+   * 
      +   * Output only. A list of local inventories specific to different places.
+   * This is only available for users who have Retail Search enabled, and it can
+   * be managed by
+   * [ProductService.AddLocalInventories][google.cloud.retail.v2alpha.ProductService.AddLocalInventories]
+   * and
+   * [ProductService.RemoveLocalInventories][google.cloud.retail.v2alpha.ProductService.RemoveLocalInventories]
+   * APIs.
+   * 
      
+   *
+   * 
+   * repeated .google.cloud.retail.v2alpha.LocalInventory local_inventories = 35 [(.google.api.field_behavior) = OUTPUT_ONLY];
+   * 
+   */
+  @java.lang.Override
+  public com.google.cloud.retail.v2alpha.LocalInventory getLocalInventories(int index) {
+    return localInventories_.get(index);
+  }
+  /**
+   *
+   *
+   * 
      +   * Output only. A list of local inventories specific to different places.
+   * This is only available for users who have Retail Search enabled, and it can
+   * be managed by
+   * [ProductService.AddLocalInventories][google.cloud.retail.v2alpha.ProductService.AddLocalInventories]
+   * and
+   * [ProductService.RemoveLocalInventories][google.cloud.retail.v2alpha.ProductService.RemoveLocalInventories]
+   * APIs.
+   * 
      
+   *
+   * 
+   * repeated .google.cloud.retail.v2alpha.LocalInventory local_inventories = 35 [(.google.api.field_behavior) = OUTPUT_ONLY];
+   * 
+   */
+  @java.lang.Override
+  public com.google.cloud.retail.v2alpha.LocalInventoryOrBuilder getLocalInventoriesOrBuilder(
+      int index) {
+    return localInventories_.get(index);
+  }
+
   private byte memoizedIsInitialized = -1;
 
   @java.lang.Override
@@ -3471,6 +3649,9 @@ public void writeTo(com.google.protobuf.CodedOutputStream output) throws java.io
     for (int i = 0; i < promotions_.size(); i++) {
       output.writeMessage(34, promotions_.get(i));
     }
+    for (int i = 0; i < localInventories_.size(); i++) {
+      output.writeMessage(35, localInventories_.get(i));
+    }
     getUnknownFields().writeTo(output);
   }
 
@@ -3634,6 +3815,10 @@ public int getSerializedSize() {
     for (int i = 0; i < promotions_.size(); i++) {
       size += com.google.protobuf.CodedOutputStream.computeMessageSize(34, promotions_.get(i));
     }
+    for (int i = 0; i < localInventories_.size(); i++) {
+      size +=
+          com.google.protobuf.CodedOutputStream.computeMessageSize(35, localInventories_.get(i));
+    }
     size += getUnknownFields().getSerializedSize();
     memoizedSize = size;
     return size;
@@ -3704,6 +3889,7 @@ public boolean equals(final java.lang.Object obj) {
       if (!getRetrievableFields().equals(other.getRetrievableFields())) return false;
     }
     if (!getVariantsList().equals(other.getVariantsList())) return false;
+    if (!getLocalInventoriesList().equals(other.getLocalInventoriesList())) return false;
     if (!getExpirationCase().equals(other.getExpirationCase())) return false;
     switch (expirationCase_) {
       case 16:
@@ -3830,6 +4016,10 @@ public int hashCode() {
       hash = (37 * hash) + VARIANTS_FIELD_NUMBER;
       hash = (53 * hash) + getVariantsList().hashCode();
     }
+    if (getLocalInventoriesCount() > 0) {
+      hash = (37 * hash) + LOCAL_INVENTORIES_FIELD_NUMBER;
+      hash = (53 * hash) + getLocalInventoriesList().hashCode();
+    }
     switch (expirationCase_) {
       case 16:
         hash = (37 * hash) + EXPIRE_TIME_FIELD_NUMBER;
@@ -4120,6 +4310,13 @@ public Builder clear() {
         variantsBuilder_.clear();
       }
       bitField0_ = (bitField0_ & ~0x00001000);
+      if (localInventoriesBuilder_ == null) {
+        localInventories_ = java.util.Collections.emptyList();
+      } else {
+        localInventories_ = null;
+        localInventoriesBuilder_.clear();
+      }
+      bitField0_ = (bitField0_ & ~0x00002000);
       expirationCase_ = 0;
       expiration_ = null;
       return this;
@@ -4292,6 +4489,15 @@ public com.google.cloud.retail.v2alpha.Product buildPartial() {
       } else {
         result.variants_ = variantsBuilder_.build();
       }
+      if (localInventoriesBuilder_ == null) {
+        if (((bitField0_ & 0x00002000) != 0)) {
+          localInventories_ = java.util.Collections.unmodifiableList(localInventories_);
+          bitField0_ = (bitField0_ & ~0x00002000);
+        }
+        result.localInventories_ = localInventories_;
+      } else {
+        result.localInventories_ = localInventoriesBuilder_.build();
+      }
       result.expirationCase_ = expirationCase_;
       onBuilt();
       return result;
@@ -4593,6 +4799,33 @@ public Builder mergeFrom(com.google.cloud.retail.v2alpha.Product other) {
           }
         }
       }
+      if (localInventoriesBuilder_ == null) {
+        if (!other.localInventories_.isEmpty()) {
+          if (localInventories_.isEmpty()) {
+            localInventories_ = other.localInventories_;
+            bitField0_ = (bitField0_ & ~0x00002000);
+          } else {
+            ensureLocalInventoriesIsMutable();
+            localInventories_.addAll(other.localInventories_);
+          }
+          onChanged();
+        }
+      } else {
+        if (!other.localInventories_.isEmpty()) {
+          if (localInventoriesBuilder_.isEmpty()) {
+            localInventoriesBuilder_.dispose();
+            localInventoriesBuilder_ = null;
+            localInventories_ = other.localInventories_;
+            bitField0_ = (bitField0_ & ~0x00002000);
+            localInventoriesBuilder_ =
+                com.google.protobuf.GeneratedMessageV3.alwaysUseFieldBuilders
+                    ? getLocalInventoriesFieldBuilder()
+                    : null;
+          } else {
+            localInventoriesBuilder_.addAllMessages(other.localInventories_);
+          }
+        }
+      }
       switch (other.getExpirationCase()) {
         case EXPIRE_TIME:
           {
@@ -4879,6 +5112,19 @@ public Builder mergeFrom(
                 }
                 break;
               } // case 274
+            case 282:
+              {
+                com.google.cloud.retail.v2alpha.LocalInventory m =
+                    input.readMessage(
+                        com.google.cloud.retail.v2alpha.LocalInventory.parser(), extensionRegistry);
+                if (localInventoriesBuilder_ == null) {
+                  ensureLocalInventoriesIsMutable();
+                  localInventories_.add(m);
+                } else {
+                  localInventoriesBuilder_.addMessage(m);
+                }
+                break;
+              } // case 282
             default:
               {
                 if (!super.parseUnknownField(input, extensionRegistry, tag)) {
@@ -4923,6 +5169,13 @@ public Builder clearExpiration() {
      * 
            * The timestamp when this product becomes unavailable for
      * [SearchService.Search][google.cloud.retail.v2alpha.SearchService.Search].
+     * Note that this is only applicable to
+     * [Type.PRIMARY][google.cloud.retail.v2alpha.Product.Type.PRIMARY] and
+     * [Type.COLLECTION][google.cloud.retail.v2alpha.Product.Type.COLLECTION],
+     * and ignored for
+     * [Type.VARIANT][google.cloud.retail.v2alpha.Product.Type.VARIANT]. In
+     * general, we suggest the users to delete the stale products explicitly,
+     * instead of using this field to determine staleness.
      * If it is set, the [Product][google.cloud.retail.v2alpha.Product] is not
      * available for
      * [SearchService.Search][google.cloud.retail.v2alpha.SearchService.Search]
@@ -4954,6 +5207,13 @@ public boolean hasExpireTime() {
      * 
            * The timestamp when this product becomes unavailable for
      * [SearchService.Search][google.cloud.retail.v2alpha.SearchService.Search].
+     * Note that this is only applicable to
+     * [Type.PRIMARY][google.cloud.retail.v2alpha.Product.Type.PRIMARY] and
+     * [Type.COLLECTION][google.cloud.retail.v2alpha.Product.Type.COLLECTION],
+     * and ignored for
+     * [Type.VARIANT][google.cloud.retail.v2alpha.Product.Type.VARIANT]. In
+     * general, we suggest the users to delete the stale products explicitly,
+     * instead of using this field to determine staleness.
      * If it is set, the [Product][google.cloud.retail.v2alpha.Product] is not
      * available for
      * [SearchService.Search][google.cloud.retail.v2alpha.SearchService.Search]
@@ -4995,6 +5255,13 @@ public com.google.protobuf.Timestamp getExpireTime() {
      * 
            * The timestamp when this product becomes unavailable for
      * [SearchService.Search][google.cloud.retail.v2alpha.SearchService.Search].
+     * Note that this is only applicable to
+     * [Type.PRIMARY][google.cloud.retail.v2alpha.Product.Type.PRIMARY] and
+     * [Type.COLLECTION][google.cloud.retail.v2alpha.Product.Type.COLLECTION],
+     * and ignored for
+     * [Type.VARIANT][google.cloud.retail.v2alpha.Product.Type.VARIANT]. In
+     * general, we suggest the users to delete the stale products explicitly,
+     * instead of using this field to determine staleness.
      * If it is set, the [Product][google.cloud.retail.v2alpha.Product] is not
      * available for
      * [SearchService.Search][google.cloud.retail.v2alpha.SearchService.Search]
@@ -5033,6 +5300,13 @@ public Builder setExpireTime(com.google.protobuf.Timestamp value) {
      * 
            * The timestamp when this product becomes unavailable for
      * [SearchService.Search][google.cloud.retail.v2alpha.SearchService.Search].
+     * Note that this is only applicable to
+     * [Type.PRIMARY][google.cloud.retail.v2alpha.Product.Type.PRIMARY] and
+     * [Type.COLLECTION][google.cloud.retail.v2alpha.Product.Type.COLLECTION],
+     * and ignored for
+     * [Type.VARIANT][google.cloud.retail.v2alpha.Product.Type.VARIANT]. In
+     * general, we suggest the users to delete the stale products explicitly,
+     * instead of using this field to determine staleness.
      * If it is set, the [Product][google.cloud.retail.v2alpha.Product] is not
      * available for
      * [SearchService.Search][google.cloud.retail.v2alpha.SearchService.Search]
@@ -5068,6 +5342,13 @@ public Builder setExpireTime(com.google.protobuf.Timestamp.Builder builderForVal
      * 
            * The timestamp when this product becomes unavailable for
      * [SearchService.Search][google.cloud.retail.v2alpha.SearchService.Search].
+     * Note that this is only applicable to
+     * [Type.PRIMARY][google.cloud.retail.v2alpha.Product.Type.PRIMARY] and
+     * [Type.COLLECTION][google.cloud.retail.v2alpha.Product.Type.COLLECTION],
+     * and ignored for
+     * [Type.VARIANT][google.cloud.retail.v2alpha.Product.Type.VARIANT]. In
+     * general, we suggest the users to delete the stale products explicitly,
+     * instead of using this field to determine staleness.
      * If it is set, the [Product][google.cloud.retail.v2alpha.Product] is not
      * available for
      * [SearchService.Search][google.cloud.retail.v2alpha.SearchService.Search]
@@ -5115,6 +5396,13 @@ public Builder mergeExpireTime(com.google.protobuf.Timestamp value) {
      * 
            * The timestamp when this product becomes unavailable for
      * [SearchService.Search][google.cloud.retail.v2alpha.SearchService.Search].
+     * Note that this is only applicable to
+     * [Type.PRIMARY][google.cloud.retail.v2alpha.Product.Type.PRIMARY] and
+     * [Type.COLLECTION][google.cloud.retail.v2alpha.Product.Type.COLLECTION],
+     * and ignored for
+     * [Type.VARIANT][google.cloud.retail.v2alpha.Product.Type.VARIANT]. In
+     * general, we suggest the users to delete the stale products explicitly,
+     * instead of using this field to determine staleness.
      * If it is set, the [Product][google.cloud.retail.v2alpha.Product] is not
      * available for
      * [SearchService.Search][google.cloud.retail.v2alpha.SearchService.Search]
@@ -5156,6 +5444,13 @@ public Builder clearExpireTime() {
      * 
            * The timestamp when this product becomes unavailable for
      * [SearchService.Search][google.cloud.retail.v2alpha.SearchService.Search].
+     * Note that this is only applicable to
+     * [Type.PRIMARY][google.cloud.retail.v2alpha.Product.Type.PRIMARY] and
+     * [Type.COLLECTION][google.cloud.retail.v2alpha.Product.Type.COLLECTION],
+     * and ignored for
+     * [Type.VARIANT][google.cloud.retail.v2alpha.Product.Type.VARIANT]. In
+     * general, we suggest the users to delete the stale products explicitly,
+     * instead of using this field to determine staleness.
      * If it is set, the [Product][google.cloud.retail.v2alpha.Product] is not
      * available for
      * [SearchService.Search][google.cloud.retail.v2alpha.SearchService.Search]
@@ -5184,6 +5479,13 @@ public com.google.protobuf.Timestamp.Builder getExpireTimeBuilder() {
      * 
            * The timestamp when this product becomes unavailable for
      * [SearchService.Search][google.cloud.retail.v2alpha.SearchService.Search].
+     * Note that this is only applicable to
+     * [Type.PRIMARY][google.cloud.retail.v2alpha.Product.Type.PRIMARY] and
+     * [Type.COLLECTION][google.cloud.retail.v2alpha.Product.Type.COLLECTION],
+     * and ignored for
+     * [Type.VARIANT][google.cloud.retail.v2alpha.Product.Type.VARIANT]. In
+     * general, we suggest the users to delete the stale products explicitly,
+     * instead of using this field to determine staleness.
      * If it is set, the [Product][google.cloud.retail.v2alpha.Product] is not
      * available for
      * [SearchService.Search][google.cloud.retail.v2alpha.SearchService.Search]
@@ -5220,6 +5522,13 @@ public com.google.protobuf.TimestampOrBuilder getExpireTimeOrBuilder() {
      * 
            * The timestamp when this product becomes unavailable for
      * [SearchService.Search][google.cloud.retail.v2alpha.SearchService.Search].
+     * Note that this is only applicable to
+     * [Type.PRIMARY][google.cloud.retail.v2alpha.Product.Type.PRIMARY] and
+     * [Type.COLLECTION][google.cloud.retail.v2alpha.Product.Type.COLLECTION],
+     * and ignored for
+     * [Type.VARIANT][google.cloud.retail.v2alpha.Product.Type.VARIANT]. In
+     * general, we suggest the users to delete the stale products explicitly,
+     * instead of using this field to determine staleness.
      * If it is set, the [Product][google.cloud.retail.v2alpha.Product] is not
      * available for
      * [SearchService.Search][google.cloud.retail.v2alpha.SearchService.Search]
@@ -5271,7 +5580,14 @@ public com.google.protobuf.TimestampOrBuilder getExpireTimeOrBuilder() {
      *
      *
      * 
      -     * Input only. The TTL (time to live) of the product.
+     * Input only. The TTL (time to live) of the product. Note that this is only
+     * applicable to
+     * [Type.PRIMARY][google.cloud.retail.v2alpha.Product.Type.PRIMARY] and
+     * [Type.COLLECTION][google.cloud.retail.v2alpha.Product.Type.COLLECTION],
+     * and ignored for
+     * [Type.VARIANT][google.cloud.retail.v2alpha.Product.Type.VARIANT]. In
+     * general, we suggest the users to delete the stale products explicitly,
+     * instead of using this field to determine staleness.
      * If it is set, it must be a non-negative value, and
      * [expire_time][google.cloud.retail.v2alpha.Product.expire_time] is set as
      * current timestamp plus [ttl][google.cloud.retail.v2alpha.Product.ttl].
@@ -5302,7 +5618,14 @@ public boolean hasTtl() {
      *
      *
      * 
      -     * Input only. The TTL (time to live) of the product.
+     * Input only. The TTL (time to live) of the product. Note that this is only
+     * applicable to
+     * [Type.PRIMARY][google.cloud.retail.v2alpha.Product.Type.PRIMARY] and
+     * [Type.COLLECTION][google.cloud.retail.v2alpha.Product.Type.COLLECTION],
+     * and ignored for
+     * [Type.VARIANT][google.cloud.retail.v2alpha.Product.Type.VARIANT]. In
+     * general, we suggest the users to delete the stale products explicitly,
+     * instead of using this field to determine staleness.
      * If it is set, it must be a non-negative value, and
      * [expire_time][google.cloud.retail.v2alpha.Product.expire_time] is set as
      * current timestamp plus [ttl][google.cloud.retail.v2alpha.Product.ttl].
@@ -5343,7 +5666,14 @@ public com.google.protobuf.Duration getTtl() {
      *
      *
      * 
      -     * Input only. The TTL (time to live) of the product.
+     * Input only. The TTL (time to live) of the product. Note that this is only
+     * applicable to
+     * [Type.PRIMARY][google.cloud.retail.v2alpha.Product.Type.PRIMARY] and
+     * [Type.COLLECTION][google.cloud.retail.v2alpha.Product.Type.COLLECTION],
+     * and ignored for
+     * [Type.VARIANT][google.cloud.retail.v2alpha.Product.Type.VARIANT]. In
+     * general, we suggest the users to delete the stale products explicitly,
+     * instead of using this field to determine staleness.
      * If it is set, it must be a non-negative value, and
      * [expire_time][google.cloud.retail.v2alpha.Product.expire_time] is set as
      * current timestamp plus [ttl][google.cloud.retail.v2alpha.Product.ttl].
@@ -5381,7 +5711,14 @@ public Builder setTtl(com.google.protobuf.Duration value) {
      *
      *
      * 
      -     * Input only. The TTL (time to live) of the product.
+     * Input only. The TTL (time to live) of the product. Note that this is only
+     * applicable to
+     * [Type.PRIMARY][google.cloud.retail.v2alpha.Product.Type.PRIMARY] and
+     * [Type.COLLECTION][google.cloud.retail.v2alpha.Product.Type.COLLECTION],
+     * and ignored for
+     * [Type.VARIANT][google.cloud.retail.v2alpha.Product.Type.VARIANT]. In
+     * general, we suggest the users to delete the stale products explicitly,
+     * instead of using this field to determine staleness.
      * If it is set, it must be a non-negative value, and
      * [expire_time][google.cloud.retail.v2alpha.Product.expire_time] is set as
      * current timestamp plus [ttl][google.cloud.retail.v2alpha.Product.ttl].
@@ -5416,7 +5753,14 @@ public Builder setTtl(com.google.protobuf.Duration.Builder builderForValue) {
      *
      *
      * 
      -     * Input only. The TTL (time to live) of the product.
+     * Input only. The TTL (time to live) of the product. Note that this is only
+     * applicable to
+     * [Type.PRIMARY][google.cloud.retail.v2alpha.Product.Type.PRIMARY] and
+     * [Type.COLLECTION][google.cloud.retail.v2alpha.Product.Type.COLLECTION],
+     * and ignored for
+     * [Type.VARIANT][google.cloud.retail.v2alpha.Product.Type.VARIANT]. In
+     * general, we suggest the users to delete the stale products explicitly,
+     * instead of using this field to determine staleness.
      * If it is set, it must be a non-negative value, and
      * [expire_time][google.cloud.retail.v2alpha.Product.expire_time] is set as
      * current timestamp plus [ttl][google.cloud.retail.v2alpha.Product.ttl].
@@ -5463,7 +5807,14 @@ public Builder mergeTtl(com.google.protobuf.Duration value) {
      *
      *
      * 
      -     * Input only. The TTL (time to live) of the product.
+     * Input only. The TTL (time to live) of the product. Note that this is only
+     * applicable to
+     * [Type.PRIMARY][google.cloud.retail.v2alpha.Product.Type.PRIMARY] and
+     * [Type.COLLECTION][google.cloud.retail.v2alpha.Product.Type.COLLECTION],
+     * and ignored for
+     * [Type.VARIANT][google.cloud.retail.v2alpha.Product.Type.VARIANT]. In
+     * general, we suggest the users to delete the stale products explicitly,
+     * instead of using this field to determine staleness.
      * If it is set, it must be a non-negative value, and
      * [expire_time][google.cloud.retail.v2alpha.Product.expire_time] is set as
      * current timestamp plus [ttl][google.cloud.retail.v2alpha.Product.ttl].
@@ -5504,7 +5855,14 @@ public Builder clearTtl() {
      *
      *
      * 
      -     * Input only. The TTL (time to live) of the product.
+     * Input only. The TTL (time to live) of the product. Note that this is only
+     * applicable to
+     * [Type.PRIMARY][google.cloud.retail.v2alpha.Product.Type.PRIMARY] and
+     * [Type.COLLECTION][google.cloud.retail.v2alpha.Product.Type.COLLECTION],
+     * and ignored for
+     * [Type.VARIANT][google.cloud.retail.v2alpha.Product.Type.VARIANT]. In
+     * general, we suggest the users to delete the stale products explicitly,
+     * instead of using this field to determine staleness.
      * If it is set, it must be a non-negative value, and
      * [expire_time][google.cloud.retail.v2alpha.Product.expire_time] is set as
      * current timestamp plus [ttl][google.cloud.retail.v2alpha.Product.ttl].
@@ -5532,7 +5890,14 @@ public com.google.protobuf.Duration.Builder getTtlBuilder() {
      *
      *
      * 
      -     * Input only. The TTL (time to live) of the product.
+     * Input only. The TTL (time to live) of the product. Note that this is only
+     * applicable to
+     * [Type.PRIMARY][google.cloud.retail.v2alpha.Product.Type.PRIMARY] and
+     * [Type.COLLECTION][google.cloud.retail.v2alpha.Product.Type.COLLECTION],
+     * and ignored for
+     * [Type.VARIANT][google.cloud.retail.v2alpha.Product.Type.VARIANT]. In
+     * general, we suggest the users to delete the stale products explicitly,
+     * instead of using this field to determine staleness.
      * If it is set, it must be a non-negative value, and
      * [expire_time][google.cloud.retail.v2alpha.Product.expire_time] is set as
      * current timestamp plus [ttl][google.cloud.retail.v2alpha.Product.ttl].
@@ -5568,7 +5933,14 @@ public com.google.protobuf.DurationOrBuilder getTtlOrBuilder() {
      *
      *
      * 
      -     * Input only. The TTL (time to live) of the product.
+     * Input only. The TTL (time to live) of the product. Note that this is only
+     * applicable to
+     * [Type.PRIMARY][google.cloud.retail.v2alpha.Product.Type.PRIMARY] and
+     * [Type.COLLECTION][google.cloud.retail.v2alpha.Product.Type.COLLECTION],
+     * and ignored for
+     * [Type.VARIANT][google.cloud.retail.v2alpha.Product.Type.VARIANT]. In
+     * general, we suggest the users to delete the stale products explicitly,
+     * instead of using this field to determine staleness.
      * If it is set, it must be a non-negative value, and
      * [expire_time][google.cloud.retail.v2alpha.Product.expire_time] is set as
      * current timestamp plus [ttl][google.cloud.retail.v2alpha.Product.ttl].
@@ -6186,7 +6558,7 @@ private void ensureCollectionMemberIdsIsMutable() {
      * The [type][google.cloud.retail.v2alpha.Product.type] of the members must be
      * either [Type.PRIMARY][google.cloud.retail.v2alpha.Product.Type.PRIMARY] or
      * [Type.VARIANT][google.cloud.retail.v2alpha.Product.Type.VARIANT] otherwise
-     * and INVALID_ARGUMENT error is thrown. Should not set it for other types. A
+     * an INVALID_ARGUMENT error is thrown. Should not set it for other types. A
      * maximum of 1000 values are allowed. Otherwise, an INVALID_ARGUMENT error is
      * return.
      * 
      
@@ -6209,7 +6581,7 @@ public com.google.protobuf.ProtocolStringList getCollectionMemberIdsList() {
      * The [type][google.cloud.retail.v2alpha.Product.type] of the members must be
      * either [Type.PRIMARY][google.cloud.retail.v2alpha.Product.Type.PRIMARY] or
      * [Type.VARIANT][google.cloud.retail.v2alpha.Product.Type.VARIANT] otherwise
-     * and INVALID_ARGUMENT error is thrown. Should not set it for other types. A
+     * an INVALID_ARGUMENT error is thrown. Should not set it for other types. A
      * maximum of 1000 values are allowed. Otherwise, an INVALID_ARGUMENT error is
      * return.
      * 
      
@@ -6232,7 +6604,7 @@ public int getCollectionMemberIdsCount() {
      * The [type][google.cloud.retail.v2alpha.Product.type] of the members must be
      * either [Type.PRIMARY][google.cloud.retail.v2alpha.Product.Type.PRIMARY] or
      * [Type.VARIANT][google.cloud.retail.v2alpha.Product.Type.VARIANT] otherwise
-     * and INVALID_ARGUMENT error is thrown. Should not set it for other types. A
+     * an INVALID_ARGUMENT error is thrown. Should not set it for other types. A
      * maximum of 1000 values are allowed. Otherwise, an INVALID_ARGUMENT error is
      * return.
      * 
      
@@ -6256,7 +6628,7 @@ public java.lang.String getCollectionMemberIds(int index) {
      * The [type][google.cloud.retail.v2alpha.Product.type] of the members must be
      * either [Type.PRIMARY][google.cloud.retail.v2alpha.Product.Type.PRIMARY] or
      * [Type.VARIANT][google.cloud.retail.v2alpha.Product.Type.VARIANT] otherwise
-     * and INVALID_ARGUMENT error is thrown. Should not set it for other types. A
+     * an INVALID_ARGUMENT error is thrown. Should not set it for other types. A
      * maximum of 1000 values are allowed. Otherwise, an INVALID_ARGUMENT error is
      * return.
      * 
      
@@ -6280,7 +6652,7 @@ public com.google.protobuf.ByteString getCollectionMemberIdsBytes(int index) {
      * The [type][google.cloud.retail.v2alpha.Product.type] of the members must be
      * either [Type.PRIMARY][google.cloud.retail.v2alpha.Product.Type.PRIMARY] or
      * [Type.VARIANT][google.cloud.retail.v2alpha.Product.Type.VARIANT] otherwise
-     * and INVALID_ARGUMENT error is thrown. Should not set it for other types. A
+     * an INVALID_ARGUMENT error is thrown. Should not set it for other types. A
      * maximum of 1000 values are allowed. Otherwise, an INVALID_ARGUMENT error is
      * return.
      * 
      
@@ -6311,7 +6683,7 @@ public Builder setCollectionMemberIds(int index, java.lang.String value) {
      * The [type][google.cloud.retail.v2alpha.Product.type] of the members must be
      * either [Type.PRIMARY][google.cloud.retail.v2alpha.Product.Type.PRIMARY] or
      * [Type.VARIANT][google.cloud.retail.v2alpha.Product.Type.VARIANT] otherwise
-     * and INVALID_ARGUMENT error is thrown. Should not set it for other types. A
+     * an INVALID_ARGUMENT error is thrown. Should not set it for other types. A
      * maximum of 1000 values are allowed. Otherwise, an INVALID_ARGUMENT error is
      * return.
      * 
      
@@ -6341,7 +6713,7 @@ public Builder addCollectionMemberIds(java.lang.String value) {
      * The [type][google.cloud.retail.v2alpha.Product.type] of the members must be
      * either [Type.PRIMARY][google.cloud.retail.v2alpha.Product.Type.PRIMARY] or
      * [Type.VARIANT][google.cloud.retail.v2alpha.Product.Type.VARIANT] otherwise
-     * and INVALID_ARGUMENT error is thrown. Should not set it for other types. A
+     * an INVALID_ARGUMENT error is thrown. Should not set it for other types. A
      * maximum of 1000 values are allowed. Otherwise, an INVALID_ARGUMENT error is
      * return.
      * 
      
@@ -6368,7 +6740,7 @@ public Builder addAllCollectionMemberIds(java.lang.Iterable va
      * The [type][google.cloud.retail.v2alpha.Product.type] of the members must be
      * either [Type.PRIMARY][google.cloud.retail.v2alpha.Product.Type.PRIMARY] or
      * [Type.VARIANT][google.cloud.retail.v2alpha.Product.Type.VARIANT] otherwise
-     * and INVALID_ARGUMENT error is thrown. Should not set it for other types. A
+     * an INVALID_ARGUMENT error is thrown. Should not set it for other types. A
      * maximum of 1000 values are allowed. Otherwise, an INVALID_ARGUMENT error is
      * return.
      * 
      
@@ -6394,7 +6766,7 @@ public Builder clearCollectionMemberIds() {
      * The [type][google.cloud.retail.v2alpha.Product.type] of the members must be
      * either [Type.PRIMARY][google.cloud.retail.v2alpha.Product.Type.PRIMARY] or
      * [Type.VARIANT][google.cloud.retail.v2alpha.Product.Type.VARIANT] otherwise
-     * and INVALID_ARGUMENT error is thrown. Should not set it for other types. A
+     * an INVALID_ARGUMENT error is thrown. Should not set it for other types. A
      * maximum of 1000 values are allowed. Otherwise, an INVALID_ARGUMENT error is
      * return.
      * 
      
@@ -6603,7 +6975,7 @@ private void ensureCategoriesIsMutable() {
      * belonging to several parallel categories. Strongly recommended using the
      * full path for better search / recommendation quality.
      * To represent full path of category, use '>' sign to separate different
-     * hierarchies. If '>' is part of the category name, please replace it with
+     * hierarchies. If '>' is part of the category name, replace it with
      * other character(s).
      * For example, if a shoes product belongs to both
      * ["Shoes & Accessories" -> "Shoes"] and
@@ -6643,7 +7015,7 @@ public com.google.protobuf.ProtocolStringList getCategoriesList() {
      * belonging to several parallel categories. Strongly recommended using the
      * full path for better search / recommendation quality.
      * To represent full path of category, use '>' sign to separate different
-     * hierarchies. If '>' is part of the category name, please replace it with
+     * hierarchies. If '>' is part of the category name, replace it with
      * other character(s).
      * For example, if a shoes product belongs to both
      * ["Shoes & Accessories" -> "Shoes"] and
@@ -6683,7 +7055,7 @@ public int getCategoriesCount() {
      * belonging to several parallel categories. Strongly recommended using the
      * full path for better search / recommendation quality.
      * To represent full path of category, use '>' sign to separate different
-     * hierarchies. If '>' is part of the category name, please replace it with
+     * hierarchies. If '>' is part of the category name, replace it with
      * other character(s).
      * For example, if a shoes product belongs to both
      * ["Shoes & Accessories" -> "Shoes"] and
@@ -6724,7 +7096,7 @@ public java.lang.String getCategories(int index) {
      * belonging to several parallel categories. Strongly recommended using the
      * full path for better search / recommendation quality.
      * To represent full path of category, use '>' sign to separate different
-     * hierarchies. If '>' is part of the category name, please replace it with
+     * hierarchies. If '>' is part of the category name, replace it with
      * other character(s).
      * For example, if a shoes product belongs to both
      * ["Shoes & Accessories" -> "Shoes"] and
@@ -6765,7 +7137,7 @@ public com.google.protobuf.ByteString getCategoriesBytes(int index) {
      * belonging to several parallel categories. Strongly recommended using the
      * full path for better search / recommendation quality.
      * To represent full path of category, use '>' sign to separate different
-     * hierarchies. If '>' is part of the category name, please replace it with
+     * hierarchies. If '>' is part of the category name, replace it with
      * other character(s).
      * For example, if a shoes product belongs to both
      * ["Shoes & Accessories" -> "Shoes"] and
@@ -6813,7 +7185,7 @@ public Builder setCategories(int index, java.lang.String value) {
      * belonging to several parallel categories. Strongly recommended using the
      * full path for better search / recommendation quality.
      * To represent full path of category, use '>' sign to separate different
-     * hierarchies. If '>' is part of the category name, please replace it with
+     * hierarchies. If '>' is part of the category name, replace it with
      * other character(s).
      * For example, if a shoes product belongs to both
      * ["Shoes & Accessories" -> "Shoes"] and
@@ -6860,7 +7232,7 @@ public Builder addCategories(java.lang.String value) {
      * belonging to several parallel categories. Strongly recommended using the
      * full path for better search / recommendation quality.
      * To represent full path of category, use '>' sign to separate different
-     * hierarchies. If '>' is part of the category name, please replace it with
+     * hierarchies. If '>' is part of the category name, replace it with
      * other character(s).
      * For example, if a shoes product belongs to both
      * ["Shoes & Accessories" -> "Shoes"] and
@@ -6904,7 +7276,7 @@ public Builder addAllCategories(java.lang.Iterable values) {
      * belonging to several parallel categories. Strongly recommended using the
      * full path for better search / recommendation quality.
      * To represent full path of category, use '>' sign to separate different
-     * hierarchies. If '>' is part of the category name, please replace it with
+     * hierarchies. If '>' is part of the category name, replace it with
      * other character(s).
      * For example, if a shoes product belongs to both
      * ["Shoes & Accessories" -> "Shoes"] and
@@ -6947,7 +7319,7 @@ public Builder clearCategories() {
      * belonging to several parallel categories. Strongly recommended using the
      * full path for better search / recommendation quality.
      * To represent full path of category, use '>' sign to separate different
-     * hierarchies. If '>' is part of the category name, please replace it with
+     * hierarchies. If '>' is part of the category name, replace it with
      * other character(s).
      * For example, if a shoes product belongs to both
      * ["Shoes & Accessories" -> "Shoes"] and
@@ -8602,6 +8974,11 @@ public com.google.cloud.retail.v2alpha.RatingOrBuilder getRatingOrBuilder() {
      * The timestamp when this [Product][google.cloud.retail.v2alpha.Product]
      * becomes available for
      * [SearchService.Search][google.cloud.retail.v2alpha.SearchService.Search].
+     * Note that this is only applicable to
+     * [Type.PRIMARY][google.cloud.retail.v2alpha.Product.Type.PRIMARY] and
+     * [Type.COLLECTION][google.cloud.retail.v2alpha.Product.Type.COLLECTION], and
+     * ignored for
+     * [Type.VARIANT][google.cloud.retail.v2alpha.Product.Type.VARIANT].
      * 
      
      *
      * .google.protobuf.Timestamp available_time = 18;
@@ -8618,6 +8995,11 @@ public boolean hasAvailableTime() {
      * The timestamp when this [Product][google.cloud.retail.v2alpha.Product]
      * becomes available for
      * [SearchService.Search][google.cloud.retail.v2alpha.SearchService.Search].
+     * Note that this is only applicable to
+     * [Type.PRIMARY][google.cloud.retail.v2alpha.Product.Type.PRIMARY] and
+     * [Type.COLLECTION][google.cloud.retail.v2alpha.Product.Type.COLLECTION], and
+     * ignored for
+     * [Type.VARIANT][google.cloud.retail.v2alpha.Product.Type.VARIANT].
      * 
      
      *
      * .google.protobuf.Timestamp available_time = 18;
@@ -8640,6 +9022,11 @@ public com.google.protobuf.Timestamp getAvailableTime() {
      * The timestamp when this [Product][google.cloud.retail.v2alpha.Product]
      * becomes available for
      * [SearchService.Search][google.cloud.retail.v2alpha.SearchService.Search].
+     * Note that this is only applicable to
+     * [Type.PRIMARY][google.cloud.retail.v2alpha.Product.Type.PRIMARY] and
+     * [Type.COLLECTION][google.cloud.retail.v2alpha.Product.Type.COLLECTION], and
+     * ignored for
+     * [Type.VARIANT][google.cloud.retail.v2alpha.Product.Type.VARIANT].
      * 
      
      *
      * .google.protobuf.Timestamp available_time = 18;
@@ -8664,6 +9051,11 @@ public Builder setAvailableTime(com.google.protobuf.Timestamp value) {
      * The timestamp when this [Product][google.cloud.retail.v2alpha.Product]
      * becomes available for
      * [SearchService.Search][google.cloud.retail.v2alpha.SearchService.Search].
+     * Note that this is only applicable to
+     * [Type.PRIMARY][google.cloud.retail.v2alpha.Product.Type.PRIMARY] and
+     * [Type.COLLECTION][google.cloud.retail.v2alpha.Product.Type.COLLECTION], and
+     * ignored for
+     * [Type.VARIANT][google.cloud.retail.v2alpha.Product.Type.VARIANT].
      * 
      
      *
      * .google.protobuf.Timestamp available_time = 18;
@@ -8685,6 +9077,11 @@ public Builder setAvailableTime(com.google.protobuf.Timestamp.Builder builderFor
      * The timestamp when this [Product][google.cloud.retail.v2alpha.Product]
      * becomes available for
      * [SearchService.Search][google.cloud.retail.v2alpha.SearchService.Search].
+     * Note that this is only applicable to
+     * [Type.PRIMARY][google.cloud.retail.v2alpha.Product.Type.PRIMARY] and
+     * [Type.COLLECTION][google.cloud.retail.v2alpha.Product.Type.COLLECTION], and
+     * ignored for
+     * [Type.VARIANT][google.cloud.retail.v2alpha.Product.Type.VARIANT].
      * 
      
      *
      * .google.protobuf.Timestamp available_time = 18;
@@ -8713,6 +9110,11 @@ public Builder mergeAvailableTime(com.google.protobuf.Timestamp value) {
      * The timestamp when this [Product][google.cloud.retail.v2alpha.Product]
      * becomes available for
      * [SearchService.Search][google.cloud.retail.v2alpha.SearchService.Search].
+     * Note that this is only applicable to
+     * [Type.PRIMARY][google.cloud.retail.v2alpha.Product.Type.PRIMARY] and
+     * [Type.COLLECTION][google.cloud.retail.v2alpha.Product.Type.COLLECTION], and
+     * ignored for
+     * [Type.VARIANT][google.cloud.retail.v2alpha.Product.Type.VARIANT].
      * 
      
      *
      * .google.protobuf.Timestamp available_time = 18;
@@ -8735,6 +9137,11 @@ public Builder clearAvailableTime() {
      * The timestamp when this [Product][google.cloud.retail.v2alpha.Product]
      * becomes available for
      * [SearchService.Search][google.cloud.retail.v2alpha.SearchService.Search].
+     * Note that this is only applicable to
+     * [Type.PRIMARY][google.cloud.retail.v2alpha.Product.Type.PRIMARY] and
+     * [Type.COLLECTION][google.cloud.retail.v2alpha.Product.Type.COLLECTION], and
+     * ignored for
+     * [Type.VARIANT][google.cloud.retail.v2alpha.Product.Type.VARIANT].
      * 
      
      *
      * .google.protobuf.Timestamp available_time = 18;
@@ -8751,6 +9158,11 @@ public com.google.protobuf.Timestamp.Builder getAvailableTimeBuilder() {
      * The timestamp when this [Product][google.cloud.retail.v2alpha.Product]
      * becomes available for
      * [SearchService.Search][google.cloud.retail.v2alpha.SearchService.Search].
+     * Note that this is only applicable to
+     * [Type.PRIMARY][google.cloud.retail.v2alpha.Product.Type.PRIMARY] and
+     * [Type.COLLECTION][google.cloud.retail.v2alpha.Product.Type.COLLECTION], and
+     * ignored for
+     * [Type.VARIANT][google.cloud.retail.v2alpha.Product.Type.VARIANT].
      * 
      
      *
      * .google.protobuf.Timestamp available_time = 18;
@@ -8771,6 +9183,11 @@ public com.google.protobuf.TimestampOrBuilder getAvailableTimeOrBuilder() {
      * The timestamp when this [Product][google.cloud.retail.v2alpha.Product]
      * becomes available for
      * [SearchService.Search][google.cloud.retail.v2alpha.SearchService.Search].
+     * Note that this is only applicable to
+     * [Type.PRIMARY][google.cloud.retail.v2alpha.Product.Type.PRIMARY] and
+     * [Type.COLLECTION][google.cloud.retail.v2alpha.Product.Type.COLLECTION], and
+     * ignored for
+     * [Type.VARIANT][google.cloud.retail.v2alpha.Product.Type.VARIANT].
      * 
      
      *
      * .google.protobuf.Timestamp available_time = 18;
@@ -12209,12 +12626,16 @@ public com.google.protobuf.TimestampOrBuilder getPublishTimeOrBuilder() {
      * Note: Returning more fields in
      * [SearchResponse][google.cloud.retail.v2alpha.SearchResponse] can increase
      * response payload size and serving latency.
+     * This field is deprecated. Use the retrievable site-wide control instead.
      * 
      
      *
-     * .google.protobuf.FieldMask retrievable_fields = 30;
+     * .google.protobuf.FieldMask retrievable_fields = 30 [deprecated = true];
      *
+     * @deprecated google.cloud.retail.v2alpha.Product.retrievable_fields is deprecated. See
+     *     google/cloud/retail/v2alpha/product.proto;l=574
      * @return Whether the retrievableFields field is set.
      */
+    @java.lang.Deprecated
     public boolean hasRetrievableFields() {
       return retrievableFieldsBuilder_ != null || retrievableFields_ != null;
     }
@@ -12268,12 +12689,16 @@ public boolean hasRetrievableFields() {
      * Note: Returning more fields in
      * [SearchResponse][google.cloud.retail.v2alpha.SearchResponse] can increase
      * response payload size and serving latency.
+     * This field is deprecated. Use the retrievable site-wide control instead.
      * 
      
      *
-     * .google.protobuf.FieldMask retrievable_fields = 30;
+     * .google.protobuf.FieldMask retrievable_fields = 30 [deprecated = true];
      *
+     * @deprecated google.cloud.retail.v2alpha.Product.retrievable_fields is deprecated. See
+     *     google/cloud/retail/v2alpha/product.proto;l=574
      * @return The retrievableFields.
      */
+    @java.lang.Deprecated
     public com.google.protobuf.FieldMask getRetrievableFields() {
       if (retrievableFieldsBuilder_ == null) {
         return retrievableFields_ == null
@@ -12333,10 +12758,12 @@ public com.google.protobuf.FieldMask getRetrievableFields() {
      * Note: Returning more fields in
      * [SearchResponse][google.cloud.retail.v2alpha.SearchResponse] can increase
      * response payload size and serving latency.
+     * This field is deprecated. Use the retrievable site-wide control instead.
      * 
      
      *
-     * .google.protobuf.FieldMask retrievable_fields = 30;
+     * .google.protobuf.FieldMask retrievable_fields = 30 [deprecated = true];
      */
+    @java.lang.Deprecated
     public Builder setRetrievableFields(com.google.protobuf.FieldMask value) {
       if (retrievableFieldsBuilder_ == null) {
         if (value == null) {
@@ -12400,10 +12827,12 @@ public Builder setRetrievableFields(com.google.protobuf.FieldMask value) {
      * Note: Returning more fields in
      * [SearchResponse][google.cloud.retail.v2alpha.SearchResponse] can increase
      * response payload size and serving latency.
+     * This field is deprecated. Use the retrievable site-wide control instead.
      * 
      
      *
-     * .google.protobuf.FieldMask retrievable_fields = 30;
+     * .google.protobuf.FieldMask retrievable_fields = 30 [deprecated = true];
      */
+    @java.lang.Deprecated
     public Builder setRetrievableFields(com.google.protobuf.FieldMask.Builder builderForValue) {
       if (retrievableFieldsBuilder_ == null) {
         retrievableFields_ = builderForValue.build();
@@ -12464,10 +12893,12 @@ public Builder setRetrievableFields(com.google.protobuf.FieldMask.Builder builde
      * Note: Returning more fields in
      * [SearchResponse][google.cloud.retail.v2alpha.SearchResponse] can increase
      * response payload size and serving latency.
+     * This field is deprecated. Use the retrievable site-wide control instead.
      * 
      
      *
-     * .google.protobuf.FieldMask retrievable_fields = 30;
+     * .google.protobuf.FieldMask retrievable_fields = 30 [deprecated = true];
      */
+    @java.lang.Deprecated
     public Builder mergeRetrievableFields(com.google.protobuf.FieldMask value) {
       if (retrievableFieldsBuilder_ == null) {
         if (retrievableFields_ != null) {
@@ -12535,10 +12966,12 @@ public Builder mergeRetrievableFields(com.google.protobuf.FieldMask value) {
      * Note: Returning more fields in
      * [SearchResponse][google.cloud.retail.v2alpha.SearchResponse] can increase
      * response payload size and serving latency.
+     * This field is deprecated. Use the retrievable site-wide control instead.
      * 
      
      *
-     * .google.protobuf.FieldMask retrievable_fields = 30;
+     * .google.protobuf.FieldMask retrievable_fields = 30 [deprecated = true];
      */
+    @java.lang.Deprecated
     public Builder clearRetrievableFields() {
       if (retrievableFieldsBuilder_ == null) {
         retrievableFields_ = null;
@@ -12600,10 +13033,12 @@ public Builder clearRetrievableFields() {
      * Note: Returning more fields in
      * [SearchResponse][google.cloud.retail.v2alpha.SearchResponse] can increase
      * response payload size and serving latency.
+     * This field is deprecated. Use the retrievable site-wide control instead.
      * 
      
      *
-     * .google.protobuf.FieldMask retrievable_fields = 30;
+     * .google.protobuf.FieldMask retrievable_fields = 30 [deprecated = true];
      */
+    @java.lang.Deprecated
     public com.google.protobuf.FieldMask.Builder getRetrievableFieldsBuilder() {
 
       onChanged();
@@ -12659,10 +13094,12 @@ public com.google.protobuf.FieldMask.Builder getRetrievableFieldsBuilder() {
      * Note: Returning more fields in
      * [SearchResponse][google.cloud.retail.v2alpha.SearchResponse] can increase
      * response payload size and serving latency.
+     * This field is deprecated. Use the retrievable site-wide control instead.
      * 
      
      *
-     * .google.protobuf.FieldMask retrievable_fields = 30;
+     * .google.protobuf.FieldMask retrievable_fields = 30 [deprecated = true];
      */
+    @java.lang.Deprecated
     public com.google.protobuf.FieldMaskOrBuilder getRetrievableFieldsOrBuilder() {
       if (retrievableFieldsBuilder_ != null) {
         return retrievableFieldsBuilder_.getMessageOrBuilder();
@@ -12722,9 +13159,10 @@ public com.google.protobuf.FieldMaskOrBuilder getRetrievableFieldsOrBuilder() {
      * Note: Returning more fields in
      * [SearchResponse][google.cloud.retail.v2alpha.SearchResponse] can increase
      * response payload size and serving latency.
+     * This field is deprecated. Use the retrievable site-wide control instead.
      * 
      
      *
-     * .google.protobuf.FieldMask retrievable_fields = 30;
+     * .google.protobuf.FieldMask retrievable_fields = 30 [deprecated = true];
      */
     private com.google.protobuf.SingleFieldBuilderV3<
             com.google.protobuf.FieldMask,
@@ -13272,6 +13710,511 @@ public com.google.cloud.retail.v2alpha.Product.Builder addVariantsBuilder(int in
       return variantsBuilder_;
     }
 
+    private java.util.List localInventories_ =
+        java.util.Collections.emptyList();
+
+    private void ensureLocalInventoriesIsMutable() {
+      if (!((bitField0_ & 0x00002000) != 0)) {
+        localInventories_ =
+            new java.util.ArrayList(
+                localInventories_);
+        bitField0_ |= 0x00002000;
+      }
+    }
+
+    private com.google.protobuf.RepeatedFieldBuilderV3<
+            com.google.cloud.retail.v2alpha.LocalInventory,
+            com.google.cloud.retail.v2alpha.LocalInventory.Builder,
+            com.google.cloud.retail.v2alpha.LocalInventoryOrBuilder>
+        localInventoriesBuilder_;
+
+    /**
+     *
+     *
+     * 
      +     * Output only. A list of local inventories specific to different places.
+     * This is only available for users who have Retail Search enabled, and it can
+     * be managed by
+     * [ProductService.AddLocalInventories][google.cloud.retail.v2alpha.ProductService.AddLocalInventories]
+     * and
+     * [ProductService.RemoveLocalInventories][google.cloud.retail.v2alpha.ProductService.RemoveLocalInventories]
+     * APIs.
+     * 
      
+     *
+     * 
+     * repeated .google.cloud.retail.v2alpha.LocalInventory local_inventories = 35 [(.google.api.field_behavior) = OUTPUT_ONLY];
+     * 
+     */
+    public java.util.List
+        getLocalInventoriesList() {
+      if (localInventoriesBuilder_ == null) {
+        return java.util.Collections.unmodifiableList(localInventories_);
+      } else {
+        return localInventoriesBuilder_.getMessageList();
+      }
+    }
+    /**
+     *
+     *
+     * 
      +     * Output only. A list of local inventories specific to different places.
+     * This is only available for users who have Retail Search enabled, and it can
+     * be managed by
+     * [ProductService.AddLocalInventories][google.cloud.retail.v2alpha.ProductService.AddLocalInventories]
+     * and
+     * [ProductService.RemoveLocalInventories][google.cloud.retail.v2alpha.ProductService.RemoveLocalInventories]
+     * APIs.
+     * 
      
+     *
+     * 
+     * repeated .google.cloud.retail.v2alpha.LocalInventory local_inventories = 35 [(.google.api.field_behavior) = OUTPUT_ONLY];
+     * 
+     */
+    public int getLocalInventoriesCount() {
+      if (localInventoriesBuilder_ == null) {
+        return localInventories_.size();
+      } else {
+        return localInventoriesBuilder_.getCount();
+      }
+    }
+    /**
+     *
+     *
+     * 
      +     * Output only. A list of local inventories specific to different places.
+     * This is only available for users who have Retail Search enabled, and it can
+     * be managed by
+     * [ProductService.AddLocalInventories][google.cloud.retail.v2alpha.ProductService.AddLocalInventories]
+     * and
+     * [ProductService.RemoveLocalInventories][google.cloud.retail.v2alpha.ProductService.RemoveLocalInventories]
+     * APIs.
+     * 
      
+     *
+     * 
+     * repeated .google.cloud.retail.v2alpha.LocalInventory local_inventories = 35 [(.google.api.field_behavior) = OUTPUT_ONLY];
+     * 
+     */
+    public com.google.cloud.retail.v2alpha.LocalInventory getLocalInventories(int index) {
+      if (localInventoriesBuilder_ == null) {
+        return localInventories_.get(index);
+      } else {
+        return localInventoriesBuilder_.getMessage(index);
+      }
+    }
+    /**
+     *
+     *
+     * 
      +     * Output only. A list of local inventories specific to different places.
+     * This is only available for users who have Retail Search enabled, and it can
+     * be managed by
+     * [ProductService.AddLocalInventories][google.cloud.retail.v2alpha.ProductService.AddLocalInventories]
+     * and
+     * [ProductService.RemoveLocalInventories][google.cloud.retail.v2alpha.ProductService.RemoveLocalInventories]
+     * APIs.
+     * 
      
+     *
+     * 
+     * repeated .google.cloud.retail.v2alpha.LocalInventory local_inventories = 35 [(.google.api.field_behavior) = OUTPUT_ONLY];
+     * 
+     */
+    public Builder setLocalInventories(
+        int index, com.google.cloud.retail.v2alpha.LocalInventory value) {
+      if (localInventoriesBuilder_ == null) {
+        if (value == null) {
+          throw new NullPointerException();
+        }
+        ensureLocalInventoriesIsMutable();
+        localInventories_.set(index, value);
+        onChanged();
+      } else {
+        localInventoriesBuilder_.setMessage(index, value);
+      }
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * Output only. A list of local inventories specific to different places.
+     * This is only available for users who have Retail Search enabled, and it can
+     * be managed by
+     * [ProductService.AddLocalInventories][google.cloud.retail.v2alpha.ProductService.AddLocalInventories]
+     * and
+     * [ProductService.RemoveLocalInventories][google.cloud.retail.v2alpha.ProductService.RemoveLocalInventories]
+     * APIs.
+     * 
      
+     *
+     * 
+     * repeated .google.cloud.retail.v2alpha.LocalInventory local_inventories = 35 [(.google.api.field_behavior) = OUTPUT_ONLY];
+     * 
+     */
+    public Builder setLocalInventories(
+        int index, com.google.cloud.retail.v2alpha.LocalInventory.Builder builderForValue) {
+      if (localInventoriesBuilder_ == null) {
+        ensureLocalInventoriesIsMutable();
+        localInventories_.set(index, builderForValue.build());
+        onChanged();
+      } else {
+        localInventoriesBuilder_.setMessage(index, builderForValue.build());
+      }
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * Output only. A list of local inventories specific to different places.
+     * This is only available for users who have Retail Search enabled, and it can
+     * be managed by
+     * [ProductService.AddLocalInventories][google.cloud.retail.v2alpha.ProductService.AddLocalInventories]
+     * and
+     * [ProductService.RemoveLocalInventories][google.cloud.retail.v2alpha.ProductService.RemoveLocalInventories]
+     * APIs.
+     * 
      
+     *
+     * 
+     * repeated .google.cloud.retail.v2alpha.LocalInventory local_inventories = 35 [(.google.api.field_behavior) = OUTPUT_ONLY];
+     * 
+     */
+    public Builder addLocalInventories(com.google.cloud.retail.v2alpha.LocalInventory value) {
+      if (localInventoriesBuilder_ == null) {
+        if (value == null) {
+          throw new NullPointerException();
+        }
+        ensureLocalInventoriesIsMutable();
+        localInventories_.add(value);
+        onChanged();
+      } else {
+        localInventoriesBuilder_.addMessage(value);
+      }
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * Output only. A list of local inventories specific to different places.
+     * This is only available for users who have Retail Search enabled, and it can
+     * be managed by
+     * [ProductService.AddLocalInventories][google.cloud.retail.v2alpha.ProductService.AddLocalInventories]
+     * and
+     * [ProductService.RemoveLocalInventories][google.cloud.retail.v2alpha.ProductService.RemoveLocalInventories]
+     * APIs.
+     * 
      
+     *
+     * 
+     * repeated .google.cloud.retail.v2alpha.LocalInventory local_inventories = 35 [(.google.api.field_behavior) = OUTPUT_ONLY];
+     * 
+     */
+    public Builder addLocalInventories(
+        int index, com.google.cloud.retail.v2alpha.LocalInventory value) {
+      if (localInventoriesBuilder_ == null) {
+        if (value == null) {
+          throw new NullPointerException();
+        }
+        ensureLocalInventoriesIsMutable();
+        localInventories_.add(index, value);
+        onChanged();
+      } else {
+        localInventoriesBuilder_.addMessage(index, value);
+      }
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * Output only. A list of local inventories specific to different places.
+     * This is only available for users who have Retail Search enabled, and it can
+     * be managed by
+     * [ProductService.AddLocalInventories][google.cloud.retail.v2alpha.ProductService.AddLocalInventories]
+     * and
+     * [ProductService.RemoveLocalInventories][google.cloud.retail.v2alpha.ProductService.RemoveLocalInventories]
+     * APIs.
+     * 
      
+     *
+     * 
+     * repeated .google.cloud.retail.v2alpha.LocalInventory local_inventories = 35 [(.google.api.field_behavior) = OUTPUT_ONLY];
+     * 
+     */
+    public Builder addLocalInventories(
+        com.google.cloud.retail.v2alpha.LocalInventory.Builder builderForValue) {
+      if (localInventoriesBuilder_ == null) {
+        ensureLocalInventoriesIsMutable();
+        localInventories_.add(builderForValue.build());
+        onChanged();
+      } else {
+        localInventoriesBuilder_.addMessage(builderForValue.build());
+      }
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * Output only. A list of local inventories specific to different places.
+     * This is only available for users who have Retail Search enabled, and it can
+     * be managed by
+     * [ProductService.AddLocalInventories][google.cloud.retail.v2alpha.ProductService.AddLocalInventories]
+     * and
+     * [ProductService.RemoveLocalInventories][google.cloud.retail.v2alpha.ProductService.RemoveLocalInventories]
+     * APIs.
+     * 
      
+     *
+     * 
+     * repeated .google.cloud.retail.v2alpha.LocalInventory local_inventories = 35 [(.google.api.field_behavior) = OUTPUT_ONLY];
+     * 
+     */
+    public Builder addLocalInventories(
+        int index, com.google.cloud.retail.v2alpha.LocalInventory.Builder builderForValue) {
+      if (localInventoriesBuilder_ == null) {
+        ensureLocalInventoriesIsMutable();
+        localInventories_.add(index, builderForValue.build());
+        onChanged();
+      } else {
+        localInventoriesBuilder_.addMessage(index, builderForValue.build());
+      }
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * Output only. A list of local inventories specific to different places.
+     * This is only available for users who have Retail Search enabled, and it can
+     * be managed by
+     * [ProductService.AddLocalInventories][google.cloud.retail.v2alpha.ProductService.AddLocalInventories]
+     * and
+     * [ProductService.RemoveLocalInventories][google.cloud.retail.v2alpha.ProductService.RemoveLocalInventories]
+     * APIs.
+     * 
      
+     *
+     * 
+     * repeated .google.cloud.retail.v2alpha.LocalInventory local_inventories = 35 [(.google.api.field_behavior) = OUTPUT_ONLY];
+     * 
+     */
+    public Builder addAllLocalInventories(
+        java.lang.Iterable values) {
+      if (localInventoriesBuilder_ == null) {
+        ensureLocalInventoriesIsMutable();
+        com.google.protobuf.AbstractMessageLite.Builder.addAll(values, localInventories_);
+        onChanged();
+      } else {
+        localInventoriesBuilder_.addAllMessages(values);
+      }
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * Output only. A list of local inventories specific to different places.
+     * This is only available for users who have Retail Search enabled, and it can
+     * be managed by
+     * [ProductService.AddLocalInventories][google.cloud.retail.v2alpha.ProductService.AddLocalInventories]
+     * and
+     * [ProductService.RemoveLocalInventories][google.cloud.retail.v2alpha.ProductService.RemoveLocalInventories]
+     * APIs.
+     * 
      
+     *
+     * 
+     * repeated .google.cloud.retail.v2alpha.LocalInventory local_inventories = 35 [(.google.api.field_behavior) = OUTPUT_ONLY];
+     * 
+     */
+    public Builder clearLocalInventories() {
+      if (localInventoriesBuilder_ == null) {
+        localInventories_ = java.util.Collections.emptyList();
+        bitField0_ = (bitField0_ & ~0x00002000);
+        onChanged();
+      } else {
+        localInventoriesBuilder_.clear();
+      }
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * Output only. A list of local inventories specific to different places.
+     * This is only available for users who have Retail Search enabled, and it can
+     * be managed by
+     * [ProductService.AddLocalInventories][google.cloud.retail.v2alpha.ProductService.AddLocalInventories]
+     * and
+     * [ProductService.RemoveLocalInventories][google.cloud.retail.v2alpha.ProductService.RemoveLocalInventories]
+     * APIs.
+     * 
      
+     *
+     * 
+     * repeated .google.cloud.retail.v2alpha.LocalInventory local_inventories = 35 [(.google.api.field_behavior) = OUTPUT_ONLY];
+     * 
+     */
+    public Builder removeLocalInventories(int index) {
+      if (localInventoriesBuilder_ == null) {
+        ensureLocalInventoriesIsMutable();
+        localInventories_.remove(index);
+        onChanged();
+      } else {
+        localInventoriesBuilder_.remove(index);
+      }
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * Output only. A list of local inventories specific to different places.
+     * This is only available for users who have Retail Search enabled, and it can
+     * be managed by
+     * [ProductService.AddLocalInventories][google.cloud.retail.v2alpha.ProductService.AddLocalInventories]
+     * and
+     * [ProductService.RemoveLocalInventories][google.cloud.retail.v2alpha.ProductService.RemoveLocalInventories]
+     * APIs.
+     * 
      
+     *
+     * 
+     * repeated .google.cloud.retail.v2alpha.LocalInventory local_inventories = 35 [(.google.api.field_behavior) = OUTPUT_ONLY];
+     * 
+     */
+    public com.google.cloud.retail.v2alpha.LocalInventory.Builder getLocalInventoriesBuilder(
+        int index) {
+      return getLocalInventoriesFieldBuilder().getBuilder(index);
+    }
+    /**
+     *
+     *
+     * 
      +     * Output only. A list of local inventories specific to different places.
+     * This is only available for users who have Retail Search enabled, and it can
+     * be managed by
+     * [ProductService.AddLocalInventories][google.cloud.retail.v2alpha.ProductService.AddLocalInventories]
+     * and
+     * [ProductService.RemoveLocalInventories][google.cloud.retail.v2alpha.ProductService.RemoveLocalInventories]
+     * APIs.
+     * 
      
+     *
+     * 
+     * repeated .google.cloud.retail.v2alpha.LocalInventory local_inventories = 35 [(.google.api.field_behavior) = OUTPUT_ONLY];
+     * 
+     */
+    public com.google.cloud.retail.v2alpha.LocalInventoryOrBuilder getLocalInventoriesOrBuilder(
+        int index) {
+      if (localInventoriesBuilder_ == null) {
+        return localInventories_.get(index);
+      } else {
+        return localInventoriesBuilder_.getMessageOrBuilder(index);
+      }
+    }
+    /**
+     *
+     *
+     * 
      +     * Output only. A list of local inventories specific to different places.
+     * This is only available for users who have Retail Search enabled, and it can
+     * be managed by
+     * [ProductService.AddLocalInventories][google.cloud.retail.v2alpha.ProductService.AddLocalInventories]
+     * and
+     * [ProductService.RemoveLocalInventories][google.cloud.retail.v2alpha.ProductService.RemoveLocalInventories]
+     * APIs.
+     * 
      
+     *
+     * 
+     * repeated .google.cloud.retail.v2alpha.LocalInventory local_inventories = 35 [(.google.api.field_behavior) = OUTPUT_ONLY];
+     * 
+     */
+    public java.util.List
+        getLocalInventoriesOrBuilderList() {
+      if (localInventoriesBuilder_ != null) {
+        return localInventoriesBuilder_.getMessageOrBuilderList();
+      } else {
+        return java.util.Collections.unmodifiableList(localInventories_);
+      }
+    }
+    /**
+     *
+     *
+     * 
      +     * Output only. A list of local inventories specific to different places.
+     * This is only available for users who have Retail Search enabled, and it can
+     * be managed by
+     * [ProductService.AddLocalInventories][google.cloud.retail.v2alpha.ProductService.AddLocalInventories]
+     * and
+     * [ProductService.RemoveLocalInventories][google.cloud.retail.v2alpha.ProductService.RemoveLocalInventories]
+     * APIs.
+     * 
      
+     *
+     * 
+     * repeated .google.cloud.retail.v2alpha.LocalInventory local_inventories = 35 [(.google.api.field_behavior) = OUTPUT_ONLY];
+     * 
+     */
+    public com.google.cloud.retail.v2alpha.LocalInventory.Builder addLocalInventoriesBuilder() {
+      return getLocalInventoriesFieldBuilder()
+          .addBuilder(com.google.cloud.retail.v2alpha.LocalInventory.getDefaultInstance());
+    }
+    /**
+     *
+     *
+     * 
      +     * Output only. A list of local inventories specific to different places.
+     * This is only available for users who have Retail Search enabled, and it can
+     * be managed by
+     * [ProductService.AddLocalInventories][google.cloud.retail.v2alpha.ProductService.AddLocalInventories]
+     * and
+     * [ProductService.RemoveLocalInventories][google.cloud.retail.v2alpha.ProductService.RemoveLocalInventories]
+     * APIs.
+     * 
      
+     *
+     * 
+     * repeated .google.cloud.retail.v2alpha.LocalInventory local_inventories = 35 [(.google.api.field_behavior) = OUTPUT_ONLY];
+     * 
+     */
+    public com.google.cloud.retail.v2alpha.LocalInventory.Builder addLocalInventoriesBuilder(
+        int index) {
+      return getLocalInventoriesFieldBuilder()
+          .addBuilder(index, com.google.cloud.retail.v2alpha.LocalInventory.getDefaultInstance());
+    }
+    /**
+     *
+     *
+     * 
      +     * Output only. A list of local inventories specific to different places.
+     * This is only available for users who have Retail Search enabled, and it can
+     * be managed by
+     * [ProductService.AddLocalInventories][google.cloud.retail.v2alpha.ProductService.AddLocalInventories]
+     * and
+     * [ProductService.RemoveLocalInventories][google.cloud.retail.v2alpha.ProductService.RemoveLocalInventories]
+     * APIs.
+     * 
      
+     *
+     * 
+     * repeated .google.cloud.retail.v2alpha.LocalInventory local_inventories = 35 [(.google.api.field_behavior) = OUTPUT_ONLY];
+     * 
+     */
+    public java.util.List
+        getLocalInventoriesBuilderList() {
+      return getLocalInventoriesFieldBuilder().getBuilderList();
+    }
+
+    private com.google.protobuf.RepeatedFieldBuilderV3<
+            com.google.cloud.retail.v2alpha.LocalInventory,
+            com.google.cloud.retail.v2alpha.LocalInventory.Builder,
+            com.google.cloud.retail.v2alpha.LocalInventoryOrBuilder>
+        getLocalInventoriesFieldBuilder() {
+      if (localInventoriesBuilder_ == null) {
+        localInventoriesBuilder_ =
+            new com.google.protobuf.RepeatedFieldBuilderV3<
+                com.google.cloud.retail.v2alpha.LocalInventory,
+                com.google.cloud.retail.v2alpha.LocalInventory.Builder,
+                com.google.cloud.retail.v2alpha.LocalInventoryOrBuilder>(
+                localInventories_,
+                ((bitField0_ & 0x00002000) != 0),
+                getParentForChildren(),
+                isClean());
+        localInventories_ = null;
+      }
+      return localInventoriesBuilder_;
+    }
+
     @java.lang.Override
     public final Builder setUnknownFields(final com.google.protobuf.UnknownFieldSet unknownFields) {
       return super.setUnknownFields(unknownFields);
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ProductOrBuilder.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ProductOrBuilder.java
index 633205edc43b..8a8480f37e95 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ProductOrBuilder.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ProductOrBuilder.java
@@ -29,6 +29,13 @@ public interface ProductOrBuilder
    * 
          * The timestamp when this product becomes unavailable for
    * [SearchService.Search][google.cloud.retail.v2alpha.SearchService.Search].
+   * Note that this is only applicable to
+   * [Type.PRIMARY][google.cloud.retail.v2alpha.Product.Type.PRIMARY] and
+   * [Type.COLLECTION][google.cloud.retail.v2alpha.Product.Type.COLLECTION],
+   * and ignored for
+   * [Type.VARIANT][google.cloud.retail.v2alpha.Product.Type.VARIANT]. In
+   * general, we suggest the users to delete the stale products explicitly,
+   * instead of using this field to determine staleness.
    * If it is set, the [Product][google.cloud.retail.v2alpha.Product] is not
    * available for
    * [SearchService.Search][google.cloud.retail.v2alpha.SearchService.Search]
@@ -57,6 +64,13 @@ public interface ProductOrBuilder
    * 
          * The timestamp when this product becomes unavailable for
    * [SearchService.Search][google.cloud.retail.v2alpha.SearchService.Search].
+   * Note that this is only applicable to
+   * [Type.PRIMARY][google.cloud.retail.v2alpha.Product.Type.PRIMARY] and
+   * [Type.COLLECTION][google.cloud.retail.v2alpha.Product.Type.COLLECTION],
+   * and ignored for
+   * [Type.VARIANT][google.cloud.retail.v2alpha.Product.Type.VARIANT]. In
+   * general, we suggest the users to delete the stale products explicitly,
+   * instead of using this field to determine staleness.
    * If it is set, the [Product][google.cloud.retail.v2alpha.Product] is not
    * available for
    * [SearchService.Search][google.cloud.retail.v2alpha.SearchService.Search]
@@ -85,6 +99,13 @@ public interface ProductOrBuilder
    * 
          * The timestamp when this product becomes unavailable for
    * [SearchService.Search][google.cloud.retail.v2alpha.SearchService.Search].
+   * Note that this is only applicable to
+   * [Type.PRIMARY][google.cloud.retail.v2alpha.Product.Type.PRIMARY] and
+   * [Type.COLLECTION][google.cloud.retail.v2alpha.Product.Type.COLLECTION],
+   * and ignored for
+   * [Type.VARIANT][google.cloud.retail.v2alpha.Product.Type.VARIANT]. In
+   * general, we suggest the users to delete the stale products explicitly,
+   * instead of using this field to determine staleness.
    * If it is set, the [Product][google.cloud.retail.v2alpha.Product] is not
    * available for
    * [SearchService.Search][google.cloud.retail.v2alpha.SearchService.Search]
@@ -110,7 +131,14 @@ public interface ProductOrBuilder
    *
    *
    * 
      -   * Input only. The TTL (time to live) of the product.
+   * Input only. The TTL (time to live) of the product. Note that this is only
+   * applicable to
+   * [Type.PRIMARY][google.cloud.retail.v2alpha.Product.Type.PRIMARY] and
+   * [Type.COLLECTION][google.cloud.retail.v2alpha.Product.Type.COLLECTION],
+   * and ignored for
+   * [Type.VARIANT][google.cloud.retail.v2alpha.Product.Type.VARIANT]. In
+   * general, we suggest the users to delete the stale products explicitly,
+   * instead of using this field to determine staleness.
    * If it is set, it must be a non-negative value, and
    * [expire_time][google.cloud.retail.v2alpha.Product.expire_time] is set as
    * current timestamp plus [ttl][google.cloud.retail.v2alpha.Product.ttl].
@@ -138,7 +166,14 @@ public interface ProductOrBuilder
    *
    *
    * 
      -   * Input only. The TTL (time to live) of the product.
+   * Input only. The TTL (time to live) of the product. Note that this is only
+   * applicable to
+   * [Type.PRIMARY][google.cloud.retail.v2alpha.Product.Type.PRIMARY] and
+   * [Type.COLLECTION][google.cloud.retail.v2alpha.Product.Type.COLLECTION],
+   * and ignored for
+   * [Type.VARIANT][google.cloud.retail.v2alpha.Product.Type.VARIANT]. In
+   * general, we suggest the users to delete the stale products explicitly,
+   * instead of using this field to determine staleness.
    * If it is set, it must be a non-negative value, and
    * [expire_time][google.cloud.retail.v2alpha.Product.expire_time] is set as
    * current timestamp plus [ttl][google.cloud.retail.v2alpha.Product.ttl].
@@ -166,7 +201,14 @@ public interface ProductOrBuilder
    *
    *
    * 
      -   * Input only. The TTL (time to live) of the product.
+   * Input only. The TTL (time to live) of the product. Note that this is only
+   * applicable to
+   * [Type.PRIMARY][google.cloud.retail.v2alpha.Product.Type.PRIMARY] and
+   * [Type.COLLECTION][google.cloud.retail.v2alpha.Product.Type.COLLECTION],
+   * and ignored for
+   * [Type.VARIANT][google.cloud.retail.v2alpha.Product.Type.VARIANT]. In
+   * general, we suggest the users to delete the stale products explicitly,
+   * instead of using this field to determine staleness.
    * If it is set, it must be a non-negative value, and
    * [expire_time][google.cloud.retail.v2alpha.Product.expire_time] is set as
    * current timestamp plus [ttl][google.cloud.retail.v2alpha.Product.ttl].
@@ -358,7 +400,7 @@ public interface ProductOrBuilder
    * The [type][google.cloud.retail.v2alpha.Product.type] of the members must be
    * either [Type.PRIMARY][google.cloud.retail.v2alpha.Product.Type.PRIMARY] or
    * [Type.VARIANT][google.cloud.retail.v2alpha.Product.Type.VARIANT] otherwise
-   * and INVALID_ARGUMENT error is thrown. Should not set it for other types. A
+   * an INVALID_ARGUMENT error is thrown. Should not set it for other types. A
    * maximum of 1000 values are allowed. Otherwise, an INVALID_ARGUMENT error is
    * return.
    * 
      
@@ -379,7 +421,7 @@ public interface ProductOrBuilder
    * The [type][google.cloud.retail.v2alpha.Product.type] of the members must be
    * either [Type.PRIMARY][google.cloud.retail.v2alpha.Product.Type.PRIMARY] or
    * [Type.VARIANT][google.cloud.retail.v2alpha.Product.Type.VARIANT] otherwise
-   * and INVALID_ARGUMENT error is thrown. Should not set it for other types. A
+   * an INVALID_ARGUMENT error is thrown. Should not set it for other types. A
    * maximum of 1000 values are allowed. Otherwise, an INVALID_ARGUMENT error is
    * return.
    * 
      
@@ -400,7 +442,7 @@ public interface ProductOrBuilder
    * The [type][google.cloud.retail.v2alpha.Product.type] of the members must be
    * either [Type.PRIMARY][google.cloud.retail.v2alpha.Product.Type.PRIMARY] or
    * [Type.VARIANT][google.cloud.retail.v2alpha.Product.Type.VARIANT] otherwise
-   * and INVALID_ARGUMENT error is thrown. Should not set it for other types. A
+   * an INVALID_ARGUMENT error is thrown. Should not set it for other types. A
    * maximum of 1000 values are allowed. Otherwise, an INVALID_ARGUMENT error is
    * return.
    * 
      
@@ -422,7 +464,7 @@ public interface ProductOrBuilder
    * The [type][google.cloud.retail.v2alpha.Product.type] of the members must be
    * either [Type.PRIMARY][google.cloud.retail.v2alpha.Product.Type.PRIMARY] or
    * [Type.VARIANT][google.cloud.retail.v2alpha.Product.Type.VARIANT] otherwise
-   * and INVALID_ARGUMENT error is thrown. Should not set it for other types. A
+   * an INVALID_ARGUMENT error is thrown. Should not set it for other types. A
    * maximum of 1000 values are allowed. Otherwise, an INVALID_ARGUMENT error is
    * return.
    * 
      
@@ -493,7 +535,7 @@ public interface ProductOrBuilder
    * belonging to several parallel categories. Strongly recommended using the
    * full path for better search / recommendation quality.
    * To represent full path of category, use '>' sign to separate different
-   * hierarchies. If '>' is part of the category name, please replace it with
+   * hierarchies. If '>' is part of the category name, replace it with
    * other character(s).
    * For example, if a shoes product belongs to both
    * ["Shoes & Accessories" -> "Shoes"] and
@@ -531,7 +573,7 @@ public interface ProductOrBuilder
    * belonging to several parallel categories. Strongly recommended using the
    * full path for better search / recommendation quality.
    * To represent full path of category, use '>' sign to separate different
-   * hierarchies. If '>' is part of the category name, please replace it with
+   * hierarchies. If '>' is part of the category name, replace it with
    * other character(s).
    * For example, if a shoes product belongs to both
    * ["Shoes & Accessories" -> "Shoes"] and
@@ -569,7 +611,7 @@ public interface ProductOrBuilder
    * belonging to several parallel categories. Strongly recommended using the
    * full path for better search / recommendation quality.
    * To represent full path of category, use '>' sign to separate different
-   * hierarchies. If '>' is part of the category name, please replace it with
+   * hierarchies. If '>' is part of the category name, replace it with
    * other character(s).
    * For example, if a shoes product belongs to both
    * ["Shoes & Accessories" -> "Shoes"] and
@@ -608,7 +650,7 @@ public interface ProductOrBuilder
    * belonging to several parallel categories. Strongly recommended using the
    * full path for better search / recommendation quality.
    * To represent full path of category, use '>' sign to separate different
-   * hierarchies. If '>' is part of the category name, please replace it with
+   * hierarchies. If '>' is part of the category name, replace it with
    * other character(s).
    * For example, if a shoes product belongs to both
    * ["Shoes & Accessories" -> "Shoes"] and
@@ -1171,6 +1213,11 @@ com.google.cloud.retail.v2alpha.CustomAttribute getAttributesOrDefault(
    * The timestamp when this [Product][google.cloud.retail.v2alpha.Product]
    * becomes available for
    * [SearchService.Search][google.cloud.retail.v2alpha.SearchService.Search].
+   * Note that this is only applicable to
+   * [Type.PRIMARY][google.cloud.retail.v2alpha.Product.Type.PRIMARY] and
+   * [Type.COLLECTION][google.cloud.retail.v2alpha.Product.Type.COLLECTION], and
+   * ignored for
+   * [Type.VARIANT][google.cloud.retail.v2alpha.Product.Type.VARIANT].
    * 
      
    *
    * .google.protobuf.Timestamp available_time = 18;
@@ -1185,6 +1232,11 @@ com.google.cloud.retail.v2alpha.CustomAttribute getAttributesOrDefault(
    * The timestamp when this [Product][google.cloud.retail.v2alpha.Product]
    * becomes available for
    * [SearchService.Search][google.cloud.retail.v2alpha.SearchService.Search].
+   * Note that this is only applicable to
+   * [Type.PRIMARY][google.cloud.retail.v2alpha.Product.Type.PRIMARY] and
+   * [Type.COLLECTION][google.cloud.retail.v2alpha.Product.Type.COLLECTION], and
+   * ignored for
+   * [Type.VARIANT][google.cloud.retail.v2alpha.Product.Type.VARIANT].
    * 
      
    *
    * .google.protobuf.Timestamp available_time = 18;
@@ -1199,6 +1251,11 @@ com.google.cloud.retail.v2alpha.CustomAttribute getAttributesOrDefault(
    * The timestamp when this [Product][google.cloud.retail.v2alpha.Product]
    * becomes available for
    * [SearchService.Search][google.cloud.retail.v2alpha.SearchService.Search].
+   * Note that this is only applicable to
+   * [Type.PRIMARY][google.cloud.retail.v2alpha.Product.Type.PRIMARY] and
+   * [Type.COLLECTION][google.cloud.retail.v2alpha.Product.Type.COLLECTION], and
+   * ignored for
+   * [Type.VARIANT][google.cloud.retail.v2alpha.Product.Type.VARIANT].
    * 
      
    *
    * .google.protobuf.Timestamp available_time = 18;
@@ -2063,12 +2120,16 @@ com.google.cloud.retail.v2alpha.CustomAttribute getAttributesOrDefault(
    * Note: Returning more fields in
    * [SearchResponse][google.cloud.retail.v2alpha.SearchResponse] can increase
    * response payload size and serving latency.
+   * This field is deprecated. Use the retrievable site-wide control instead.
    * 
      
    *
-   * .google.protobuf.FieldMask retrievable_fields = 30;
+   * .google.protobuf.FieldMask retrievable_fields = 30 [deprecated = true];
    *
+   * @deprecated google.cloud.retail.v2alpha.Product.retrievable_fields is deprecated. See
+   *     google/cloud/retail/v2alpha/product.proto;l=574
    * @return Whether the retrievableFields field is set.
    */
+  @java.lang.Deprecated
   boolean hasRetrievableFields();
   /**
    *
@@ -2120,12 +2181,16 @@ com.google.cloud.retail.v2alpha.CustomAttribute getAttributesOrDefault(
    * Note: Returning more fields in
    * [SearchResponse][google.cloud.retail.v2alpha.SearchResponse] can increase
    * response payload size and serving latency.
+   * This field is deprecated. Use the retrievable site-wide control instead.
    * 
      
    *
-   * .google.protobuf.FieldMask retrievable_fields = 30;
+   * .google.protobuf.FieldMask retrievable_fields = 30 [deprecated = true];
    *
+   * @deprecated google.cloud.retail.v2alpha.Product.retrievable_fields is deprecated. See
+   *     google/cloud/retail/v2alpha/product.proto;l=574
    * @return The retrievableFields.
    */
+  @java.lang.Deprecated
   com.google.protobuf.FieldMask getRetrievableFields();
   /**
    *
@@ -2177,10 +2242,12 @@ com.google.cloud.retail.v2alpha.CustomAttribute getAttributesOrDefault(
    * Note: Returning more fields in
    * [SearchResponse][google.cloud.retail.v2alpha.SearchResponse] can increase
    * response payload size and serving latency.
+   * This field is deprecated. Use the retrievable site-wide control instead.
    * 
      
    *
-   * .google.protobuf.FieldMask retrievable_fields = 30;
+   * .google.protobuf.FieldMask retrievable_fields = 30 [deprecated = true];
    */
+  @java.lang.Deprecated
   com.google.protobuf.FieldMaskOrBuilder getRetrievableFieldsOrBuilder();
 
   /**
@@ -2285,5 +2352,97 @@ com.google.cloud.retail.v2alpha.CustomAttribute getAttributesOrDefault(
    */
   com.google.cloud.retail.v2alpha.ProductOrBuilder getVariantsOrBuilder(int index);
 
+  /**
+   *
+   *
+   * 
      +   * Output only. A list of local inventories specific to different places.
+   * This is only available for users who have Retail Search enabled, and it can
+   * be managed by
+   * [ProductService.AddLocalInventories][google.cloud.retail.v2alpha.ProductService.AddLocalInventories]
+   * and
+   * [ProductService.RemoveLocalInventories][google.cloud.retail.v2alpha.ProductService.RemoveLocalInventories]
+   * APIs.
+   * 
      
+   *
+   * 
+   * repeated .google.cloud.retail.v2alpha.LocalInventory local_inventories = 35 [(.google.api.field_behavior) = OUTPUT_ONLY];
+   * 
+   */
+  java.util.List getLocalInventoriesList();
+  /**
+   *
+   *
+   * 
      +   * Output only. A list of local inventories specific to different places.
+   * This is only available for users who have Retail Search enabled, and it can
+   * be managed by
+   * [ProductService.AddLocalInventories][google.cloud.retail.v2alpha.ProductService.AddLocalInventories]
+   * and
+   * [ProductService.RemoveLocalInventories][google.cloud.retail.v2alpha.ProductService.RemoveLocalInventories]
+   * APIs.
+   * 
      
+   *
+   * 
+   * repeated .google.cloud.retail.v2alpha.LocalInventory local_inventories = 35 [(.google.api.field_behavior) = OUTPUT_ONLY];
+   * 
+   */
+  com.google.cloud.retail.v2alpha.LocalInventory getLocalInventories(int index);
+  /**
+   *
+   *
+   * 
      +   * Output only. A list of local inventories specific to different places.
+   * This is only available for users who have Retail Search enabled, and it can
+   * be managed by
+   * [ProductService.AddLocalInventories][google.cloud.retail.v2alpha.ProductService.AddLocalInventories]
+   * and
+   * [ProductService.RemoveLocalInventories][google.cloud.retail.v2alpha.ProductService.RemoveLocalInventories]
+   * APIs.
+   * 
      
+   *
+   * 
+   * repeated .google.cloud.retail.v2alpha.LocalInventory local_inventories = 35 [(.google.api.field_behavior) = OUTPUT_ONLY];
+   * 
+   */
+  int getLocalInventoriesCount();
+  /**
+   *
+   *
+   * 
      +   * Output only. A list of local inventories specific to different places.
+   * This is only available for users who have Retail Search enabled, and it can
+   * be managed by
+   * [ProductService.AddLocalInventories][google.cloud.retail.v2alpha.ProductService.AddLocalInventories]
+   * and
+   * [ProductService.RemoveLocalInventories][google.cloud.retail.v2alpha.ProductService.RemoveLocalInventories]
+   * APIs.
+   * 
      
+   *
+   * 
+   * repeated .google.cloud.retail.v2alpha.LocalInventory local_inventories = 35 [(.google.api.field_behavior) = OUTPUT_ONLY];
+   * 
+   */
+  java.util.List
+      getLocalInventoriesOrBuilderList();
+  /**
+   *
+   *
+   * 
      +   * Output only. A list of local inventories specific to different places.
+   * This is only available for users who have Retail Search enabled, and it can
+   * be managed by
+   * [ProductService.AddLocalInventories][google.cloud.retail.v2alpha.ProductService.AddLocalInventories]
+   * and
+   * [ProductService.RemoveLocalInventories][google.cloud.retail.v2alpha.ProductService.RemoveLocalInventories]
+   * APIs.
+   * 
      
+   *
+   * 
+   * repeated .google.cloud.retail.v2alpha.LocalInventory local_inventories = 35 [(.google.api.field_behavior) = OUTPUT_ONLY];
+   * 
+   */
+  com.google.cloud.retail.v2alpha.LocalInventoryOrBuilder getLocalInventoriesOrBuilder(int index);
+
   public com.google.cloud.retail.v2alpha.Product.ExpirationCase getExpirationCase();
 }
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ProductProto.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ProductProto.java
index e7bd31eb49a9..9c7767266f37 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ProductProto.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ProductProto.java
@@ -52,7 +52,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
           + "pha/promotion.proto\032\036google/protobuf/dur"
           + "ation.proto\032 google/protobuf/field_mask."
           + "proto\032\037google/protobuf/timestamp.proto\032\036"
-          + "google/protobuf/wrappers.proto\"\313\r\n\007Produ"
+          + "google/protobuf/wrappers.proto\"\234\016\n\007Produ"
           + "ct\0221\n\013expire_time\030\020 \001(\0132\032.google.protobu"
           + "f.TimestampH\000\022-\n\003ttl\030\021 \001(\0132\031.google.prot"
           + "obuf.DurationB\003\340A\004H\000\022\021\n\004name\030\001 \001(\tB\003\340A\005\022"
@@ -82,29 +82,31 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
           + "(\t\022\020\n\010patterns\030\034 \003(\t\022\022\n\nconditions\030\035 \003(\t"
           + "\022:\n\npromotions\030\" \003(\0132&.google.cloud.reta"
           + "il.v2alpha.Promotion\0220\n\014publish_time\030! \001"
-          + "(\0132\032.google.protobuf.Timestamp\0226\n\022retrie"
+          + "(\0132\032.google.protobuf.Timestamp\022:\n\022retrie"
           + "vable_fields\030\036 \001(\0132\032.google.protobuf.Fie"
-          + "ldMask\022;\n\010variants\030\037 \003(\0132$.google.cloud."
-          + "retail.v2alpha.ProductB\003\340A\003\032_\n\017Attribute"
-          + "sEntry\022\013\n\003key\030\001 \001(\t\022;\n\005value\030\002 \001(\0132,.goo"
-          + "gle.cloud.retail.v2alpha.CustomAttribute"
-          + ":\0028\001\"F\n\004Type\022\024\n\020TYPE_UNSPECIFIED\020\000\022\013\n\007PR"
-          + "IMARY\020\001\022\013\n\007VARIANT\020\002\022\016\n\nCOLLECTION\020\003\"i\n\014"
-          + "Availability\022\034\n\030AVAILABILITY_UNSPECIFIED"
-          + "\020\000\022\014\n\010IN_STOCK\020\001\022\020\n\014OUT_OF_STOCK\020\002\022\014\n\010PR"
-          + "EORDER\020\003\022\r\n\tBACKORDER\020\004:\204\001\352A\200\001\n\035retail.g"
-          + "oogleapis.com/Product\022_projects/{project"
-          + "}/locations/{location}/catalogs/{catalog"
-          + "}/branches/{branch}/products/{product}B\014"
-          + "\n\nexpirationB\311\002\n\037com.google.cloud.retail"
-          + ".v2alphaB\014ProductProtoP\001ZAgoogle.golang."
-          + "org/genproto/googleapis/cloud/retail/v2a"
-          + "lpha;retail\242\002\006RETAIL\252\002\033Google.Cloud.Reta"
-          + "il.V2Alpha\312\002\033Google\\Cloud\\Retail\\V2alpha"
-          + "\352\002\036Google::Cloud::Retail::V2alpha\352Al\n\034re"
-          + "tail.googleapis.com/Branch\022Lprojects/{pr"
-          + "oject}/locations/{location}/catalogs/{ca"
-          + "talog}/branches/{branch}b\006proto3"
+          + "ldMaskB\002\030\001\022;\n\010variants\030\037 \003(\0132$.google.cl"
+          + "oud.retail.v2alpha.ProductB\003\340A\003\022K\n\021local"
+          + "_inventories\030# \003(\0132+.google.cloud.retail"
+          + ".v2alpha.LocalInventoryB\003\340A\003\032_\n\017Attribut"
+          + "esEntry\022\013\n\003key\030\001 \001(\t\022;\n\005value\030\002 \001(\0132,.go"
+          + "ogle.cloud.retail.v2alpha.CustomAttribut"
+          + "e:\0028\001\"F\n\004Type\022\024\n\020TYPE_UNSPECIFIED\020\000\022\013\n\007P"
+          + "RIMARY\020\001\022\013\n\007VARIANT\020\002\022\016\n\nCOLLECTION\020\003\"i\n"
+          + "\014Availability\022\034\n\030AVAILABILITY_UNSPECIFIE"
+          + "D\020\000\022\014\n\010IN_STOCK\020\001\022\020\n\014OUT_OF_STOCK\020\002\022\014\n\010P"
+          + "REORDER\020\003\022\r\n\tBACKORDER\020\004:\204\001\352A\200\001\n\035retail."
+          + "googleapis.com/Product\022_projects/{projec"
+          + "t}/locations/{location}/catalogs/{catalo"
+          + "g}/branches/{branch}/products/{product}B"
+          + "\014\n\nexpirationB\311\002\n\037com.google.cloud.retai"
+          + "l.v2alphaB\014ProductProtoP\001ZAgoogle.golang"
+          + ".org/genproto/googleapis/cloud/retail/v2"
+          + "alpha;retail\242\002\006RETAIL\252\002\033Google.Cloud.Ret"
+          + "ail.V2Alpha\312\002\033Google\\Cloud\\Retail\\V2alph"
+          + "a\352\002\036Google::Cloud::Retail::V2alpha\352Al\n\034r"
+          + "etail.googleapis.com/Branch\022Lprojects/{p"
+          + "roject}/locations/{location}/catalogs/{c"
+          + "atalog}/branches/{branch}b\006proto3"
     };
     descriptor =
         com.google.protobuf.Descriptors.FileDescriptor.internalBuildGeneratedFileFrom(
@@ -158,6 +160,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
               "PublishTime",
               "RetrievableFields",
               "Variants",
+              "LocalInventories",
               "Expiration",
             });
     internal_static_google_cloud_retail_v2alpha_Product_AttributesEntry_descriptor =
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/RejoinUserEventsMetadata.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/RejoinUserEventsMetadata.java
index a66b44d5d76f..67a9e5d863ef 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/RejoinUserEventsMetadata.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/RejoinUserEventsMetadata.java
@@ -22,7 +22,7 @@
  *
  *
  * 
      - * Metadata for RejoinUserEvents method.
+ * Metadata for `RejoinUserEvents` method.
  * 
      
  *
  * Protobuf type {@code google.cloud.retail.v2alpha.RejoinUserEventsMetadata}
@@ -220,7 +220,7 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
    *
    *
    * 
      -   * Metadata for RejoinUserEvents method.
+   * Metadata for `RejoinUserEvents` method.
    * 
      
    *
    * Protobuf type {@code google.cloud.retail.v2alpha.RejoinUserEventsMetadata}
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/RejoinUserEventsRequest.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/RejoinUserEventsRequest.java
index b3b89e7863bc..785131a72f6a 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/RejoinUserEventsRequest.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/RejoinUserEventsRequest.java
@@ -74,11 +74,11 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    * 
          * The scope of user events to be rejoined with the latest product catalog.
    * If the rejoining aims at reducing number of unjoined events, set
-   * UserEventRejoinScope to UNJOINED_EVENTS.
+   * `UserEventRejoinScope` to `UNJOINED_EVENTS`.
    * If the rejoining aims at correcting product catalog information in joined
-   * events, set UserEventRejoinScope to JOINED_EVENTS.
-   * If all events needs to be rejoined, set UserEventRejoinScope to
-   * USER_EVENT_REJOIN_SCOPE_UNSPECIFIED.
+   * events, set `UserEventRejoinScope` to `JOINED_EVENTS`.
+   * If all events needs to be rejoined, set `UserEventRejoinScope` to
+   * `USER_EVENT_REJOIN_SCOPE_UNSPECIFIED`.
    * 
      
    *
    * Protobuf enum {@code google.cloud.retail.v2alpha.RejoinUserEventsRequest.UserEventRejoinScope}
@@ -297,8 +297,8 @@ public com.google.protobuf.ByteString getParentBytes() {
    * 
          * The type of the user event rejoin to define the scope and range of the user
    * events to be rejoined with the latest product catalog. Defaults to
-   * USER_EVENT_REJOIN_SCOPE_UNSPECIFIED if this field is not set, or set to an
-   * invalid integer value.
+   * `USER_EVENT_REJOIN_SCOPE_UNSPECIFIED` if this field is not set, or set to
+   * an invalid integer value.
    * 
      
    *
    * 
@@ -317,8 +317,8 @@ public int getUserEventRejoinScopeValue() {
    * 
          * The type of the user event rejoin to define the scope and range of the user
    * events to be rejoined with the latest product catalog. Defaults to
-   * USER_EVENT_REJOIN_SCOPE_UNSPECIFIED if this field is not set, or set to an
-   * invalid integer value.
+   * `USER_EVENT_REJOIN_SCOPE_UNSPECIFIED` if this field is not set, or set to
+   * an invalid integer value.
    * 
      
    *
    * 
@@ -815,8 +815,8 @@ public Builder setParentBytes(com.google.protobuf.ByteString value) {
      * 
            * The type of the user event rejoin to define the scope and range of the user
      * events to be rejoined with the latest product catalog. Defaults to
-     * USER_EVENT_REJOIN_SCOPE_UNSPECIFIED if this field is not set, or set to an
-     * invalid integer value.
+     * `USER_EVENT_REJOIN_SCOPE_UNSPECIFIED` if this field is not set, or set to
+     * an invalid integer value.
      * 
      
      *
      * 
@@ -835,8 +835,8 @@ public int getUserEventRejoinScopeValue() {
      * 
            * The type of the user event rejoin to define the scope and range of the user
      * events to be rejoined with the latest product catalog. Defaults to
-     * USER_EVENT_REJOIN_SCOPE_UNSPECIFIED if this field is not set, or set to an
-     * invalid integer value.
+     * `USER_EVENT_REJOIN_SCOPE_UNSPECIFIED` if this field is not set, or set to
+     * an invalid integer value.
      * 
      
      *
      * 
@@ -858,8 +858,8 @@ public Builder setUserEventRejoinScopeValue(int value) {
      * 
            * The type of the user event rejoin to define the scope and range of the user
      * events to be rejoined with the latest product catalog. Defaults to
-     * USER_EVENT_REJOIN_SCOPE_UNSPECIFIED if this field is not set, or set to an
-     * invalid integer value.
+     * `USER_EVENT_REJOIN_SCOPE_UNSPECIFIED` if this field is not set, or set to
+     * an invalid integer value.
      * 
      
      *
      * 
@@ -886,8 +886,8 @@ public Builder setUserEventRejoinScopeValue(int value) {
      * 
            * The type of the user event rejoin to define the scope and range of the user
      * events to be rejoined with the latest product catalog. Defaults to
-     * USER_EVENT_REJOIN_SCOPE_UNSPECIFIED if this field is not set, or set to an
-     * invalid integer value.
+     * `USER_EVENT_REJOIN_SCOPE_UNSPECIFIED` if this field is not set, or set to
+     * an invalid integer value.
      * 
      
      *
      * 
@@ -913,8 +913,8 @@ public Builder setUserEventRejoinScope(
      * 
            * The type of the user event rejoin to define the scope and range of the user
      * events to be rejoined with the latest product catalog. Defaults to
-     * USER_EVENT_REJOIN_SCOPE_UNSPECIFIED if this field is not set, or set to an
-     * invalid integer value.
+     * `USER_EVENT_REJOIN_SCOPE_UNSPECIFIED` if this field is not set, or set to
+     * an invalid integer value.
      * 
      
      *
      * 
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/RejoinUserEventsRequestOrBuilder.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/RejoinUserEventsRequestOrBuilder.java
index d2ba7c476958..5e09c10586b7 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/RejoinUserEventsRequestOrBuilder.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/RejoinUserEventsRequestOrBuilder.java
@@ -56,8 +56,8 @@ public interface RejoinUserEventsRequestOrBuilder
    * 
          * The type of the user event rejoin to define the scope and range of the user
    * events to be rejoined with the latest product catalog. Defaults to
-   * USER_EVENT_REJOIN_SCOPE_UNSPECIFIED if this field is not set, or set to an
-   * invalid integer value.
+   * `USER_EVENT_REJOIN_SCOPE_UNSPECIFIED` if this field is not set, or set to
+   * an invalid integer value.
    * 
      
    *
    * 
@@ -73,8 +73,8 @@ public interface RejoinUserEventsRequestOrBuilder
    * 
          * The type of the user event rejoin to define the scope and range of the user
    * events to be rejoined with the latest product catalog. Defaults to
-   * USER_EVENT_REJOIN_SCOPE_UNSPECIFIED if this field is not set, or set to an
-   * invalid integer value.
+   * `USER_EVENT_REJOIN_SCOPE_UNSPECIFIED` if this field is not set, or set to
+   * an invalid integer value.
    * 
      
    *
    * 
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/RejoinUserEventsResponse.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/RejoinUserEventsResponse.java
index 29c6a1569bec..32195260814e 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/RejoinUserEventsResponse.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/RejoinUserEventsResponse.java
@@ -22,7 +22,7 @@
  *
  *
  * 
      - * Response message for RejoinUserEvents method.
+ * Response message for `RejoinUserEvents` method.
  * 
      
  *
  * Protobuf type {@code google.cloud.retail.v2alpha.RejoinUserEventsResponse}
@@ -247,7 +247,7 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
    *
    *
    * 
      -   * Response message for RejoinUserEvents method.
+   * Response message for `RejoinUserEvents` method.
    * 
      
    *
    * Protobuf type {@code google.cloud.retail.v2alpha.RejoinUserEventsResponse}
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/RemoveControlRequest.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/RemoveControlRequest.java
index 7c7efe2d02d6..c000aa21dbbf 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/RemoveControlRequest.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/RemoveControlRequest.java
@@ -75,7 +75,7 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    *
    * 
          * Required. The source ServingConfig resource name . Format:
-   * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+   * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
    * 
      
    *
    * 
@@ -101,7 +101,7 @@ public java.lang.String getServingConfig() {
    *
    * 
          * Required. The source ServingConfig resource name . Format:
-   * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+   * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
    * 
      
    *
    * 
@@ -532,7 +532,7 @@ public Builder mergeFrom(
      *
      * 
            * Required. The source ServingConfig resource name . Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
      * 
      
      *
      * 
@@ -557,7 +557,7 @@ public java.lang.String getServingConfig() {
      *
      * 
            * Required. The source ServingConfig resource name . Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
      * 
      
      *
      * 
@@ -582,7 +582,7 @@ public com.google.protobuf.ByteString getServingConfigBytes() {
      *
      * 
            * Required. The source ServingConfig resource name . Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
      * 
      
      *
      * 
@@ -606,7 +606,7 @@ public Builder setServingConfig(java.lang.String value) {
      *
      * 
            * Required. The source ServingConfig resource name . Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
      * 
      
      *
      * 
@@ -626,7 +626,7 @@ public Builder clearServingConfig() {
      *
      * 
            * Required. The source ServingConfig resource name . Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
      * 
      
      *
      * 
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/RemoveControlRequestOrBuilder.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/RemoveControlRequestOrBuilder.java
index c6ecc3db1995..d9a3b1b2c373 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/RemoveControlRequestOrBuilder.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/RemoveControlRequestOrBuilder.java
@@ -28,7 +28,7 @@ public interface RemoveControlRequestOrBuilder
    *
    * 
          * Required. The source ServingConfig resource name . Format:
-   * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+   * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
    * 
      
    *
    * 
@@ -43,7 +43,7 @@ public interface RemoveControlRequestOrBuilder
    *
    * 
          * Required. The source ServingConfig resource name . Format:
-   * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+   * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
    * 
      
    *
    * 
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ResumeModelRequest.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ResumeModelRequest.java
index a77eb9963910..1fa64b112327 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ResumeModelRequest.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ResumeModelRequest.java
@@ -75,7 +75,7 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    * 
          * Required. The name of the model to resume.
    * Format:
-   * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}
+   * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}`
    * 
      
    *
    * string name = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -100,7 +100,7 @@ public java.lang.String getName() {
    * 
          * Required. The name of the model to resume.
    * Format:
-   * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}
+   * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}`
    * 
      
    *
    * string name = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -457,7 +457,7 @@ public Builder mergeFrom(
      * 
            * Required. The name of the model to resume.
      * Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}`
      * 
      
      *
      * string name = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -481,7 +481,7 @@ public java.lang.String getName() {
      * 
            * Required. The name of the model to resume.
      * Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}`
      * 
      
      *
      * string name = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -505,7 +505,7 @@ public com.google.protobuf.ByteString getNameBytes() {
      * 
            * Required. The name of the model to resume.
      * Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}`
      * 
      
      *
      * string name = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -528,7 +528,7 @@ public Builder setName(java.lang.String value) {
      * 
            * Required. The name of the model to resume.
      * Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}`
      * 
      
      *
      * string name = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -547,7 +547,7 @@ public Builder clearName() {
      * 
            * Required. The name of the model to resume.
      * Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}`
      * 
      
      *
      * string name = 1 [(.google.api.field_behavior) = REQUIRED];
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ResumeModelRequestOrBuilder.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ResumeModelRequestOrBuilder.java
index c398d8905350..7bd99662016d 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ResumeModelRequestOrBuilder.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ResumeModelRequestOrBuilder.java
@@ -29,7 +29,7 @@ public interface ResumeModelRequestOrBuilder
    * 
          * Required. The name of the model to resume.
    * Format:
-   * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}
+   * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}`
    * 
      
    *
    * string name = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -43,7 +43,7 @@ public interface ResumeModelRequestOrBuilder
    * 
          * Required. The name of the model to resume.
    * Format:
-   * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}
+   * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}`
    * 
      
    *
    * string name = 1 [(.google.api.field_behavior) = REQUIRED];
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/Rule.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/Rule.java
index bbaff3cfb9db..6f831d713a4d 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/Rule.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/Rule.java
@@ -25,8 +25,9 @@
  * A rule is a condition-action pair
  * * A condition defines when a rule is to be triggered.
  * * An action specifies what occurs on that trigger.
- * Currently only boost rules are supported.
- * Currently only supported by the search endpoint.
+ * Currently rules only work for [controls][google.cloud.retail.v2alpha.Control]
+ * with
+ * [SOLUTION_TYPE_SEARCH][google.cloud.retail.v2alpha.SolutionType.SOLUTION_TYPE_SEARCH].
  * 
      
  *
  * Protobuf type {@code google.cloud.retail.v2alpha.Rule}
@@ -2457,7 +2458,7 @@ public interface TwowaySynonymsActionOrBuilder
    *
    * 
          * Creates a set of terms that will be treated as synonyms of each other.
-   * Example: synonyms of "sneakers" and "shoes".
+   * Example: synonyms of "sneakers" and "shoes":
    *  * "sneakers" will use a synonym of "shoes".
    *  * "shoes" will use a synonym of "sneakers".
    * 
      
@@ -2746,7 +2747,7 @@ protected Builder newBuilderForType(
      *
      * 
            * Creates a set of terms that will be treated as synonyms of each other.
-     * Example: synonyms of "sneakers" and "shoes".
+     * Example: synonyms of "sneakers" and "shoes":
      *  * "sneakers" will use a synonym of "shoes".
      *  * "shoes" will use a synonym of "sneakers".
      * 
      
@@ -8917,8 +8918,9 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
    * A rule is a condition-action pair
    * * A condition defines when a rule is to be triggered.
    * * An action specifies what occurs on that trigger.
-   * Currently only boost rules are supported.
-   * Currently only supported by the search endpoint.
+   * Currently rules only work for [controls][google.cloud.retail.v2alpha.Control]
+   * with
+   * [SOLUTION_TYPE_SEARCH][google.cloud.retail.v2alpha.SolutionType.SOLUTION_TYPE_SEARCH].
    * 
      
    *
    * Protobuf type {@code google.cloud.retail.v2alpha.Rule}
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/SearchRequest.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/SearchRequest.java
index 078eee7e8ca7..e7ab3a9aff80 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/SearchRequest.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/SearchRequest.java
@@ -315,8 +315,11 @@ public enum SearchMode implements com.google.protobuf.ProtocolMessageEnum {
      *
      * 
            * Default value. In this case both product search and faceted search will
-     * be performed. Both [SearchResponse.SearchResult] and
-     * [SearchResponse.Facet] will be returned.
+     * be performed. Both
+     * [SearchResponse.SearchResult][google.cloud.retail.v2alpha.SearchResponse.SearchResult]
+     * and
+     * [SearchResponse.Facet][google.cloud.retail.v2alpha.SearchResponse.Facet]
+     * will be returned.
      * 
      
      *
      * SEARCH_MODE_UNSPECIFIED = 0;
@@ -328,8 +331,11 @@ public enum SearchMode implements com.google.protobuf.ProtocolMessageEnum {
      * 
            * Only product search will be performed. The faceted search will be
      * disabled.
-     * Only [SearchResponse.SearchResult] will be returned.
-     * [SearchResponse.Facet] will not be returned, even if
+     * Only
+     * [SearchResponse.SearchResult][google.cloud.retail.v2alpha.SearchResponse.SearchResult]
+     * will be returned.
+     * [SearchResponse.Facet][google.cloud.retail.v2alpha.SearchResponse.Facet]
+     * will not be returned, even if
      * [SearchRequest.facet_specs][google.cloud.retail.v2alpha.SearchRequest.facet_specs]
      * or
      * [SearchRequest.dynamic_facet_spec][google.cloud.retail.v2alpha.SearchRequest.dynamic_facet_spec]
@@ -350,7 +356,9 @@ public enum SearchMode implements com.google.protobuf.ProtocolMessageEnum {
      * and
      * [SearchRequest.dynamic_facet_spec][google.cloud.retail.v2alpha.SearchRequest.dynamic_facet_spec]
      * should be set. Otherwise, an INVALID_ARGUMENT error is returned. Only
-     * [SearchResponse.Facet] will be returned. [SearchResponse.SearchResult]
+     * [SearchResponse.Facet][google.cloud.retail.v2alpha.SearchResponse.Facet]
+     * will be returned.
+     * [SearchResponse.SearchResult][google.cloud.retail.v2alpha.SearchResponse.SearchResult]
      * will not be returned.
      * 
      
      *
@@ -365,8 +373,11 @@ public enum SearchMode implements com.google.protobuf.ProtocolMessageEnum {
      *
      * 
            * Default value. In this case both product search and faceted search will
-     * be performed. Both [SearchResponse.SearchResult] and
-     * [SearchResponse.Facet] will be returned.
+     * be performed. Both
+     * [SearchResponse.SearchResult][google.cloud.retail.v2alpha.SearchResponse.SearchResult]
+     * and
+     * [SearchResponse.Facet][google.cloud.retail.v2alpha.SearchResponse.Facet]
+     * will be returned.
      * 
      
      *
      * SEARCH_MODE_UNSPECIFIED = 0;
@@ -378,8 +389,11 @@ public enum SearchMode implements com.google.protobuf.ProtocolMessageEnum {
      * 
            * Only product search will be performed. The faceted search will be
      * disabled.
-     * Only [SearchResponse.SearchResult] will be returned.
-     * [SearchResponse.Facet] will not be returned, even if
+     * Only
+     * [SearchResponse.SearchResult][google.cloud.retail.v2alpha.SearchResponse.SearchResult]
+     * will be returned.
+     * [SearchResponse.Facet][google.cloud.retail.v2alpha.SearchResponse.Facet]
+     * will not be returned, even if
      * [SearchRequest.facet_specs][google.cloud.retail.v2alpha.SearchRequest.facet_specs]
      * or
      * [SearchRequest.dynamic_facet_spec][google.cloud.retail.v2alpha.SearchRequest.dynamic_facet_spec]
@@ -400,7 +414,9 @@ public enum SearchMode implements com.google.protobuf.ProtocolMessageEnum {
      * and
      * [SearchRequest.dynamic_facet_spec][google.cloud.retail.v2alpha.SearchRequest.dynamic_facet_spec]
      * should be set. Otherwise, an INVALID_ARGUMENT error is returned. Only
-     * [SearchResponse.Facet] will be returned. [SearchResponse.SearchResult]
+     * [SearchResponse.Facet][google.cloud.retail.v2alpha.SearchResponse.Facet]
+     * will be returned.
+     * [SearchResponse.SearchResult][google.cloud.retail.v2alpha.SearchResponse.SearchResult]
      * will not be returned.
      * 
      
      *
@@ -543,7 +559,7 @@ public interface FacetSpecOrBuilder
      *
      * 
            * Maximum of facet values that should be returned for this facet. If
-     * unspecified, defaults to 20. The maximum allowed value is 300. Values
+     * unspecified, defaults to 50. The maximum allowed value is 300. Values
      * above 300 will be coerced to 300.
      * If this field is negative, an INVALID_ARGUMENT is returned.
      * 
      
@@ -4708,7 +4724,7 @@ public com.google.cloud.retail.v2alpha.SearchRequest.FacetSpec.FacetKey getFacet
      *
      * 
            * Maximum of facet values that should be returned for this facet. If
-     * unspecified, defaults to 20. The maximum allowed value is 300. Values
+     * unspecified, defaults to 50. The maximum allowed value is 300. Values
      * above 300 will be coerced to 300.
      * If this field is negative, an INVALID_ARGUMENT is returned.
      * 
      
@@ -5557,7 +5573,7 @@ public Builder clearFacetKey() {
        *
        * 
              * Maximum of facet values that should be returned for this facet. If
-       * unspecified, defaults to 20. The maximum allowed value is 300. Values
+       * unspecified, defaults to 50. The maximum allowed value is 300. Values
        * above 300 will be coerced to 300.
        * If this field is negative, an INVALID_ARGUMENT is returned.
        * 
      
@@ -5575,7 +5591,7 @@ public int getLimit() {
        *
        * 
              * Maximum of facet values that should be returned for this facet. If
-       * unspecified, defaults to 20. The maximum allowed value is 300. Values
+       * unspecified, defaults to 50. The maximum allowed value is 300. Values
        * above 300 will be coerced to 300.
        * If this field is negative, an INVALID_ARGUMENT is returned.
        * 
      
@@ -5596,7 +5612,7 @@ public Builder setLimit(int value) {
        *
        * 
              * Maximum of facet values that should be returned for this facet. If
-       * unspecified, defaults to 20. The maximum allowed value is 300. Values
+       * unspecified, defaults to 50. The maximum allowed value is 300. Values
        * above 300 will be coerced to 300.
        * If this field is negative, an INVALID_ARGUMENT is returned.
        * 
      
@@ -10271,7 +10287,8 @@ public enum Mode implements com.google.protobuf.ProtocolMessageEnum {
        *
        *
        * 
      -       * Let CRS decide whether to use personalization.
+       * Let CRS decide whether to use personalization based on quality of user
+       * event data.
        * 
      
        *
        * AUTO = 1;
@@ -10305,7 +10322,8 @@ public enum Mode implements com.google.protobuf.ProtocolMessageEnum {
        *
        *
        * 
      -       * Let CRS decide whether to use personalization.
+       * Let CRS decide whether to use personalization based on quality of user
+       * event data.
        * 
      
        *
        * AUTO = 1;
@@ -11781,7 +11799,7 @@ public com.google.protobuf.Parser getParserForType() {
    * `projects/*/locations/global/catalogs/default_catalog/servingConfigs/default_serving_config`
    * or the name of the legacy placement resource, such as
    * `projects/*/locations/global/catalogs/default_catalog/placements/default_search`.
-   * This field is used to identify the serving configuration name and the set
+   * This field is used to identify the serving config name and the set
    * of models that will be used to make the search.
    * 
      
    *
@@ -11809,7 +11827,7 @@ public java.lang.String getPlacement() {
    * `projects/*/locations/global/catalogs/default_catalog/servingConfigs/default_serving_config`
    * or the name of the legacy placement resource, such as
    * `projects/*/locations/global/catalogs/default_catalog/placements/default_search`.
-   * This field is used to identify the serving configuration name and the set
+   * This field is used to identify the serving config name and the set
    * of models that will be used to make the search.
    * 
      
    *
@@ -12446,7 +12464,7 @@ public com.google.cloud.retail.v2alpha.SearchRequest.FacetSpecOrBuilder getFacet
    * 
    *
    * @deprecated google.cloud.retail.v2alpha.SearchRequest.dynamic_facet_spec is deprecated. See
-   *     google/cloud/retail/v2alpha/search_service.proto;l=600
+   *     google/cloud/retail/v2alpha/search_service.proto;l=609
    * @return Whether the dynamicFacetSpec field is set.
    */
   @java.lang.Override
@@ -12469,7 +12487,7 @@ public boolean hasDynamicFacetSpec() {
    * 
    *
    * @deprecated google.cloud.retail.v2alpha.SearchRequest.dynamic_facet_spec is deprecated. See
-   *     google/cloud/retail/v2alpha/search_service.proto;l=600
+   *     google/cloud/retail/v2alpha/search_service.proto;l=609
    * @return The dynamicFacetSpec.
    */
   @java.lang.Override
@@ -13049,7 +13067,7 @@ public com.google.protobuf.ByteString getVariantRollupKeysBytes(int index) {
    * the same as
    * [UserEvent.page_categories][google.cloud.retail.v2alpha.UserEvent.page_categories];
    * To represent full path of category, use '>' sign to separate different
-   * hierarchies. If '>' is part of the category name, please replace it with
+   * hierarchies. If '>' is part of the category name, replace it with
    * other character(s).
    * Category pages include special pages such as sales or promotions. For
    * instance, a special sale page may have the category hierarchy:
@@ -13072,7 +13090,7 @@ public com.google.protobuf.ProtocolStringList getPageCategoriesList() {
    * the same as
    * [UserEvent.page_categories][google.cloud.retail.v2alpha.UserEvent.page_categories];
    * To represent full path of category, use '>' sign to separate different
-   * hierarchies. If '>' is part of the category name, please replace it with
+   * hierarchies. If '>' is part of the category name, replace it with
    * other character(s).
    * Category pages include special pages such as sales or promotions. For
    * instance, a special sale page may have the category hierarchy:
@@ -13095,7 +13113,7 @@ public int getPageCategoriesCount() {
    * the same as
    * [UserEvent.page_categories][google.cloud.retail.v2alpha.UserEvent.page_categories];
    * To represent full path of category, use '>' sign to separate different
-   * hierarchies. If '>' is part of the category name, please replace it with
+   * hierarchies. If '>' is part of the category name, replace it with
    * other character(s).
    * Category pages include special pages such as sales or promotions. For
    * instance, a special sale page may have the category hierarchy:
@@ -13119,7 +13137,7 @@ public java.lang.String getPageCategories(int index) {
    * the same as
    * [UserEvent.page_categories][google.cloud.retail.v2alpha.UserEvent.page_categories];
    * To represent full path of category, use '>' sign to separate different
-   * hierarchies. If '>' is part of the category name, please replace it with
+   * hierarchies. If '>' is part of the category name, replace it with
    * other character(s).
    * Category pages include special pages such as sales or promotions. For
    * instance, a special sale page may have the category hierarchy:
@@ -13182,6 +13200,14 @@ public com.google.cloud.retail.v2alpha.SearchRequest.SearchMode getSearchMode()
    *
    * 
          * The specification for personalization.
+   * Notice that if both
+   * [ServingConfig.personalization_spec][google.cloud.retail.v2alpha.ServingConfig.personalization_spec]
+   * and
+   * [SearchRequest.personalization_spec][google.cloud.retail.v2alpha.SearchRequest.personalization_spec]
+   * are set.
+   * [SearchRequest.personalization_spec][google.cloud.retail.v2alpha.SearchRequest.personalization_spec]
+   * will override
+   * [ServingConfig.personalization_spec][google.cloud.retail.v2alpha.ServingConfig.personalization_spec].
    * 
      
    *
    * .google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpec personalization_spec = 32;
@@ -13198,6 +13224,14 @@ public boolean hasPersonalizationSpec() {
    *
    * 
          * The specification for personalization.
+   * Notice that if both
+   * [ServingConfig.personalization_spec][google.cloud.retail.v2alpha.ServingConfig.personalization_spec]
+   * and
+   * [SearchRequest.personalization_spec][google.cloud.retail.v2alpha.SearchRequest.personalization_spec]
+   * are set.
+   * [SearchRequest.personalization_spec][google.cloud.retail.v2alpha.SearchRequest.personalization_spec]
+   * will override
+   * [ServingConfig.personalization_spec][google.cloud.retail.v2alpha.ServingConfig.personalization_spec].
    * 
      
    *
    * .google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpec personalization_spec = 32;
@@ -13217,6 +13251,14 @@ public boolean hasPersonalizationSpec() {
    *
    * 
          * The specification for personalization.
+   * Notice that if both
+   * [ServingConfig.personalization_spec][google.cloud.retail.v2alpha.ServingConfig.personalization_spec]
+   * and
+   * [SearchRequest.personalization_spec][google.cloud.retail.v2alpha.SearchRequest.personalization_spec]
+   * are set.
+   * [SearchRequest.personalization_spec][google.cloud.retail.v2alpha.SearchRequest.personalization_spec]
+   * will override
+   * [ServingConfig.personalization_spec][google.cloud.retail.v2alpha.ServingConfig.personalization_spec].
    * 
      
    *
    * .google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpec personalization_spec = 32;
@@ -14459,7 +14501,7 @@ public Builder mergeFrom(
      * `projects/*/locations/global/catalogs/default_catalog/servingConfigs/default_serving_config`
      * or the name of the legacy placement resource, such as
      * `projects/*/locations/global/catalogs/default_catalog/placements/default_search`.
-     * This field is used to identify the serving configuration name and the set
+     * This field is used to identify the serving config name and the set
      * of models that will be used to make the search.
      * 
      
      *
@@ -14486,7 +14528,7 @@ public java.lang.String getPlacement() {
      * `projects/*/locations/global/catalogs/default_catalog/servingConfigs/default_serving_config`
      * or the name of the legacy placement resource, such as
      * `projects/*/locations/global/catalogs/default_catalog/placements/default_search`.
-     * This field is used to identify the serving configuration name and the set
+     * This field is used to identify the serving config name and the set
      * of models that will be used to make the search.
      * 
      
      *
@@ -14513,7 +14555,7 @@ public com.google.protobuf.ByteString getPlacementBytes() {
      * `projects/*/locations/global/catalogs/default_catalog/servingConfigs/default_serving_config`
      * or the name of the legacy placement resource, such as
      * `projects/*/locations/global/catalogs/default_catalog/placements/default_search`.
-     * This field is used to identify the serving configuration name and the set
+     * This field is used to identify the serving config name and the set
      * of models that will be used to make the search.
      * 
      
      *
@@ -14539,7 +14581,7 @@ public Builder setPlacement(java.lang.String value) {
      * `projects/*/locations/global/catalogs/default_catalog/servingConfigs/default_serving_config`
      * or the name of the legacy placement resource, such as
      * `projects/*/locations/global/catalogs/default_catalog/placements/default_search`.
-     * This field is used to identify the serving configuration name and the set
+     * This field is used to identify the serving config name and the set
      * of models that will be used to make the search.
      *
      * @@ -14561,7 +14603,7 @@ public Builder clearPlacement() { * `projects/*/locations/global/catalogs/default_catalog/servingConfigs/default_serving_config` * or the name of the legacy placement resource, such as * `projects/*/locations/global/catalogs/default_catalog/placements/default_search`. - * This field is used to identify the serving configuration name and the set + * This field is used to identify the serving config name and the set * of models that will be used to make the search. * * @@ -16264,7 +16306,7 @@ public com.google.cloud.retail.v2alpha.SearchRequest.FacetSpec.Builder addFacetS * * * @deprecated google.cloud.retail.v2alpha.SearchRequest.dynamic_facet_spec is deprecated. See - * google/cloud/retail/v2alpha/search_service.proto;l=600 + * google/cloud/retail/v2alpha/search_service.proto;l=609 * @return Whether the dynamicFacetSpec field is set. */ @java.lang.Deprecated @@ -16286,7 +16328,7 @@ public boolean hasDynamicFacetSpec() { * * * @deprecated google.cloud.retail.v2alpha.SearchRequest.dynamic_facet_spec is deprecated. See - * google/cloud/retail/v2alpha/search_service.proto;l=600 + * google/cloud/retail/v2alpha/search_service.proto;l=609 * @return The dynamicFacetSpec. */ @java.lang.Deprecated @@ -17956,7 +17998,7 @@ private void ensurePageCategoriesIsMutable() { * the same as * [UserEvent.page_categories][google.cloud.retail.v2alpha.UserEvent.page_categories]; * To represent full path of category, use '>' sign to separate different - * hierarchies. If '>' is part of the category name, please replace it with + * hierarchies. If '>' is part of the category name, replace it with * other character(s). * Category pages include special pages such as sales or promotions. For * instance, a special sale page may have the category hierarchy: @@ -17979,7 +18021,7 @@ public com.google.protobuf.ProtocolStringList getPageCategoriesList() { * the same as * [UserEvent.page_categories][google.cloud.retail.v2alpha.UserEvent.page_categories]; * To represent full path of category, use '>' sign to separate different - * hierarchies. If '>' is part of the category name, please replace it with + * hierarchies. If '>' is part of the category name, replace it with * other character(s). * Category pages include special pages such as sales or promotions. For * instance, a special sale page may have the category hierarchy: @@ -18002,7 +18044,7 @@ public int getPageCategoriesCount() { * the same as * [UserEvent.page_categories][google.cloud.retail.v2alpha.UserEvent.page_categories]; * To represent full path of category, use '>' sign to separate different - * hierarchies. If '>' is part of the category name, please replace it with + * hierarchies. If '>' is part of the category name, replace it with * other character(s). * Category pages include special pages such as sales or promotions. For * instance, a special sale page may have the category hierarchy: @@ -18026,7 +18068,7 @@ public java.lang.String getPageCategories(int index) { * the same as * [UserEvent.page_categories][google.cloud.retail.v2alpha.UserEvent.page_categories]; * To represent full path of category, use '>' sign to separate different - * hierarchies. If '>' is part of the category name, please replace it with + * hierarchies. If '>' is part of the category name, replace it with * other character(s). * Category pages include special pages such as sales or promotions. For * instance, a special sale page may have the category hierarchy: @@ -18050,7 +18092,7 @@ public com.google.protobuf.ByteString getPageCategoriesBytes(int index) { * the same as * [UserEvent.page_categories][google.cloud.retail.v2alpha.UserEvent.page_categories]; * To represent full path of category, use '>' sign to separate different - * hierarchies. If '>' is part of the category name, please replace it with + * hierarchies. If '>' is part of the category name, replace it with * other character(s). * Category pages include special pages such as sales or promotions. For * instance, a special sale page may have the category hierarchy: @@ -18081,7 +18123,7 @@ public Builder setPageCategories(int index, java.lang.String value) { * the same as * [UserEvent.page_categories][google.cloud.retail.v2alpha.UserEvent.page_categories]; * To represent full path of category, use '>' sign to separate different - * hierarchies. If '>' is part of the category name, please replace it with + * hierarchies. If '>' is part of the category name, replace it with * other character(s). * Category pages include special pages such as sales or promotions. For * instance, a special sale page may have the category hierarchy: @@ -18111,7 +18153,7 @@ public Builder addPageCategories(java.lang.String value) { * the same as * [UserEvent.page_categories][google.cloud.retail.v2alpha.UserEvent.page_categories]; * To represent full path of category, use '>' sign to separate different - * hierarchies. If '>' is part of the category name, please replace it with + * hierarchies. If '>' is part of the category name, replace it with * other character(s). * Category pages include special pages such as sales or promotions. For * instance, a special sale page may have the category hierarchy: @@ -18138,7 +18180,7 @@ public Builder addAllPageCategories(java.lang.Iterable values) * the same as * [UserEvent.page_categories][google.cloud.retail.v2alpha.UserEvent.page_categories]; * To represent full path of category, use '>' sign to separate different - * hierarchies. If '>' is part of the category name, please replace it with + * hierarchies. If '>' is part of the category name, replace it with * other character(s). * Category pages include special pages such as sales or promotions. For * instance, a special sale page may have the category hierarchy: @@ -18164,7 +18206,7 @@ public Builder clearPageCategories() { * the same as * [UserEvent.page_categories][google.cloud.retail.v2alpha.UserEvent.page_categories]; * To represent full path of category, use '>' sign to separate different - * hierarchies. If '>' is part of the category name, please replace it with + * hierarchies. If '>' is part of the category name, replace it with * other character(s). * Category pages include special pages such as sales or promotions. For * instance, a special sale page may have the category hierarchy: @@ -18296,6 +18338,14 @@ public Builder clearSearchMode() { * * 
            * The specification for personalization.
+     * Notice that if both
+     * [ServingConfig.personalization_spec][google.cloud.retail.v2alpha.ServingConfig.personalization_spec]
+     * and
+     * [SearchRequest.personalization_spec][google.cloud.retail.v2alpha.SearchRequest.personalization_spec]
+     * are set.
+     * [SearchRequest.personalization_spec][google.cloud.retail.v2alpha.SearchRequest.personalization_spec]
+     * will override
+     * [ServingConfig.personalization_spec][google.cloud.retail.v2alpha.ServingConfig.personalization_spec].
      *
      * * @@ -18312,6 +18362,14 @@ public boolean hasPersonalizationSpec() { * * 
            * The specification for personalization.
+     * Notice that if both
+     * [ServingConfig.personalization_spec][google.cloud.retail.v2alpha.ServingConfig.personalization_spec]
+     * and
+     * [SearchRequest.personalization_spec][google.cloud.retail.v2alpha.SearchRequest.personalization_spec]
+     * are set.
+     * [SearchRequest.personalization_spec][google.cloud.retail.v2alpha.SearchRequest.personalization_spec]
+     * will override
+     * [ServingConfig.personalization_spec][google.cloud.retail.v2alpha.ServingConfig.personalization_spec].
      *
      * * @@ -18335,6 +18393,14 @@ public boolean hasPersonalizationSpec() { * * 
            * The specification for personalization.
+     * Notice that if both
+     * [ServingConfig.personalization_spec][google.cloud.retail.v2alpha.ServingConfig.personalization_spec]
+     * and
+     * [SearchRequest.personalization_spec][google.cloud.retail.v2alpha.SearchRequest.personalization_spec]
+     * are set.
+     * [SearchRequest.personalization_spec][google.cloud.retail.v2alpha.SearchRequest.personalization_spec]
+     * will override
+     * [ServingConfig.personalization_spec][google.cloud.retail.v2alpha.ServingConfig.personalization_spec].
      *
      * * @@ -18360,6 +18426,14 @@ public Builder setPersonalizationSpec( * * 
            * The specification for personalization.
+     * Notice that if both
+     * [ServingConfig.personalization_spec][google.cloud.retail.v2alpha.ServingConfig.personalization_spec]
+     * and
+     * [SearchRequest.personalization_spec][google.cloud.retail.v2alpha.SearchRequest.personalization_spec]
+     * are set.
+     * [SearchRequest.personalization_spec][google.cloud.retail.v2alpha.SearchRequest.personalization_spec]
+     * will override
+     * [ServingConfig.personalization_spec][google.cloud.retail.v2alpha.ServingConfig.personalization_spec].
      *
      * * @@ -18382,6 +18456,14 @@ public Builder setPersonalizationSpec( * * 
            * The specification for personalization.
+     * Notice that if both
+     * [ServingConfig.personalization_spec][google.cloud.retail.v2alpha.ServingConfig.personalization_spec]
+     * and
+     * [SearchRequest.personalization_spec][google.cloud.retail.v2alpha.SearchRequest.personalization_spec]
+     * are set.
+     * [SearchRequest.personalization_spec][google.cloud.retail.v2alpha.SearchRequest.personalization_spec]
+     * will override
+     * [ServingConfig.personalization_spec][google.cloud.retail.v2alpha.ServingConfig.personalization_spec].
      *
      * * @@ -18412,6 +18494,14 @@ public Builder mergePersonalizationSpec( * * 
            * The specification for personalization.
+     * Notice that if both
+     * [ServingConfig.personalization_spec][google.cloud.retail.v2alpha.ServingConfig.personalization_spec]
+     * and
+     * [SearchRequest.personalization_spec][google.cloud.retail.v2alpha.SearchRequest.personalization_spec]
+     * are set.
+     * [SearchRequest.personalization_spec][google.cloud.retail.v2alpha.SearchRequest.personalization_spec]
+     * will override
+     * [ServingConfig.personalization_spec][google.cloud.retail.v2alpha.ServingConfig.personalization_spec].
      *
      * * @@ -18434,6 +18524,14 @@ public Builder clearPersonalizationSpec() { * * 
            * The specification for personalization.
+     * Notice that if both
+     * [ServingConfig.personalization_spec][google.cloud.retail.v2alpha.ServingConfig.personalization_spec]
+     * and
+     * [SearchRequest.personalization_spec][google.cloud.retail.v2alpha.SearchRequest.personalization_spec]
+     * are set.
+     * [SearchRequest.personalization_spec][google.cloud.retail.v2alpha.SearchRequest.personalization_spec]
+     * will override
+     * [ServingConfig.personalization_spec][google.cloud.retail.v2alpha.ServingConfig.personalization_spec].
      *
      * * @@ -18451,6 +18549,14 @@ public Builder clearPersonalizationSpec() { * * 
            * The specification for personalization.
+     * Notice that if both
+     * [ServingConfig.personalization_spec][google.cloud.retail.v2alpha.ServingConfig.personalization_spec]
+     * and
+     * [SearchRequest.personalization_spec][google.cloud.retail.v2alpha.SearchRequest.personalization_spec]
+     * are set.
+     * [SearchRequest.personalization_spec][google.cloud.retail.v2alpha.SearchRequest.personalization_spec]
+     * will override
+     * [ServingConfig.personalization_spec][google.cloud.retail.v2alpha.ServingConfig.personalization_spec].
      *
      * * @@ -18472,6 +18578,14 @@ public Builder clearPersonalizationSpec() { * * 
            * The specification for personalization.
+     * Notice that if both
+     * [ServingConfig.personalization_spec][google.cloud.retail.v2alpha.ServingConfig.personalization_spec]
+     * and
+     * [SearchRequest.personalization_spec][google.cloud.retail.v2alpha.SearchRequest.personalization_spec]
+     * are set.
+     * [SearchRequest.personalization_spec][google.cloud.retail.v2alpha.SearchRequest.personalization_spec]
+     * will override
+     * [ServingConfig.personalization_spec][google.cloud.retail.v2alpha.ServingConfig.personalization_spec].
      *
      * * diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/SearchRequestOrBuilder.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/SearchRequestOrBuilder.java index b1a6f0f66f90..b28cfc9d2d53 100644 --- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/SearchRequestOrBuilder.java +++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/SearchRequestOrBuilder.java @@ -31,7 +31,7 @@ public interface SearchRequestOrBuilder * `projects/*/locations/global/catalogs/default_catalog/servingConfigs/default_serving_config` * or the name of the legacy placement resource, such as * `projects/*/locations/global/catalogs/default_catalog/placements/default_search`. - * This field is used to identify the serving configuration name and the set + * This field is used to identify the serving config name and the set * of models that will be used to make the search. * * @@ -48,7 +48,7 @@ public interface SearchRequestOrBuilder * `projects/*/locations/global/catalogs/default_catalog/servingConfigs/default_serving_config` * or the name of the legacy placement resource, such as * `projects/*/locations/global/catalogs/default_catalog/placements/default_search`. - * This field is used to identify the serving configuration name and the set + * This field is used to identify the serving config name and the set * of models that will be used to make the search. * * @@ -463,7 +463,7 @@ com.google.cloud.retail.v2alpha.SearchRequest.FacetSpecOrBuilder getFacetSpecsOr * * * @deprecated google.cloud.retail.v2alpha.SearchRequest.dynamic_facet_spec is deprecated. See - * google/cloud/retail/v2alpha/search_service.proto;l=600 + * google/cloud/retail/v2alpha/search_service.proto;l=609 * @return Whether the dynamicFacetSpec field is set. */ @java.lang.Deprecated @@ -483,7 +483,7 @@ com.google.cloud.retail.v2alpha.SearchRequest.FacetSpecOrBuilder getFacetSpecsOr *       * * @deprecated google.cloud.retail.v2alpha.SearchRequest.dynamic_facet_spec is deprecated. See - * google/cloud/retail/v2alpha/search_service.proto;l=600 + * google/cloud/retail/v2alpha/search_service.proto;l=609 * @return The dynamicFacetSpec. */ @java.lang.Deprecated @@ -1003,7 +1003,7 @@ com.google.cloud.retail.v2alpha.SearchRequest.FacetSpecOrBuilder getFacetSpecsOr * the same as * [UserEvent.page_categories][google.cloud.retail.v2alpha.UserEvent.page_categories]; * To represent full path of category, use '>' sign to separate different - * hierarchies. If '>' is part of the category name, please replace it with + * hierarchies. If '>' is part of the category name, replace it with * other character(s). * Category pages include special pages such as sales or promotions. For * instance, a special sale page may have the category hierarchy: @@ -1024,7 +1024,7 @@ com.google.cloud.retail.v2alpha.SearchRequest.FacetSpecOrBuilder getFacetSpecsOr * the same as * [UserEvent.page_categories][google.cloud.retail.v2alpha.UserEvent.page_categories]; * To represent full path of category, use '>' sign to separate different - * hierarchies. If '>' is part of the category name, please replace it with + * hierarchies. If '>' is part of the category name, replace it with * other character(s). * Category pages include special pages such as sales or promotions. For * instance, a special sale page may have the category hierarchy: @@ -1045,7 +1045,7 @@ com.google.cloud.retail.v2alpha.SearchRequest.FacetSpecOrBuilder getFacetSpecsOr * the same as * [UserEvent.page_categories][google.cloud.retail.v2alpha.UserEvent.page_categories]; * To represent full path of category, use '>' sign to separate different - * hierarchies. If '>' is part of the category name, please replace it with + * hierarchies. If '>' is part of the category name, replace it with * other character(s). * Category pages include special pages such as sales or promotions. For * instance, a special sale page may have the category hierarchy: @@ -1067,7 +1067,7 @@ com.google.cloud.retail.v2alpha.SearchRequest.FacetSpecOrBuilder getFacetSpecsOr * the same as * [UserEvent.page_categories][google.cloud.retail.v2alpha.UserEvent.page_categories]; * To represent full path of category, use '>' sign to separate different - * hierarchies. If '>' is part of the category name, please replace it with + * hierarchies. If '>' is part of the category name, replace it with * other character(s). * Category pages include special pages such as sales or promotions. For * instance, a special sale page may have the category hierarchy: @@ -1113,6 +1113,14 @@ com.google.cloud.retail.v2alpha.SearchRequest.FacetSpecOrBuilder getFacetSpecsOr * * 
          * The specification for personalization.
+   * Notice that if both
+   * [ServingConfig.personalization_spec][google.cloud.retail.v2alpha.ServingConfig.personalization_spec]
+   * and
+   * [SearchRequest.personalization_spec][google.cloud.retail.v2alpha.SearchRequest.personalization_spec]
+   * are set.
+   * [SearchRequest.personalization_spec][google.cloud.retail.v2alpha.SearchRequest.personalization_spec]
+   * will override
+   * [ServingConfig.personalization_spec][google.cloud.retail.v2alpha.ServingConfig.personalization_spec].
    *
      * * .google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpec personalization_spec = 32; @@ -1126,6 +1134,14 @@ com.google.cloud.retail.v2alpha.SearchRequest.FacetSpecOrBuilder getFacetSpecsOr * * 
          * The specification for personalization.
+   * Notice that if both
+   * [ServingConfig.personalization_spec][google.cloud.retail.v2alpha.ServingConfig.personalization_spec]
+   * and
+   * [SearchRequest.personalization_spec][google.cloud.retail.v2alpha.SearchRequest.personalization_spec]
+   * are set.
+   * [SearchRequest.personalization_spec][google.cloud.retail.v2alpha.SearchRequest.personalization_spec]
+   * will override
+   * [ServingConfig.personalization_spec][google.cloud.retail.v2alpha.ServingConfig.personalization_spec].
    *
      * * .google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpec personalization_spec = 32; @@ -1139,6 +1155,14 @@ com.google.cloud.retail.v2alpha.SearchRequest.FacetSpecOrBuilder getFacetSpecsOr * * 
          * The specification for personalization.
+   * Notice that if both
+   * [ServingConfig.personalization_spec][google.cloud.retail.v2alpha.ServingConfig.personalization_spec]
+   * and
+   * [SearchRequest.personalization_spec][google.cloud.retail.v2alpha.SearchRequest.personalization_spec]
+   * are set.
+   * [SearchRequest.personalization_spec][google.cloud.retail.v2alpha.SearchRequest.personalization_spec]
+   * will override
+   * [ServingConfig.personalization_spec][google.cloud.retail.v2alpha.ServingConfig.personalization_spec].
    *
      * * .google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpec personalization_spec = 32; diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/SearchResponse.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/SearchResponse.java index fb9c2e881975..6066c0586e78 100644 --- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/SearchResponse.java +++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/SearchResponse.java @@ -493,6 +493,93 @@ com.google.protobuf.Value getVariantRollupValuesOrDefault( * map<string, .google.protobuf.Value> variant_rollup_values = 5; */ com.google.protobuf.Value getVariantRollupValuesOrThrow(java.lang.String key); + + /** + * + * + * 
      +     * Specifies previous events related to this product for this user based on
+     * [UserEvent][google.cloud.retail.v2alpha.UserEvent] with same
+     * [SearchRequest.visitor_id][google.cloud.retail.v2alpha.SearchRequest.visitor_id]
+     * or [UserInfo.user_id][google.cloud.retail.v2alpha.UserInfo.user_id].
+     * This is set only when
+     * [SearchRequest.PersonalizationSpec.mode][google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpec.mode]
+     * is
+     * [SearchRequest.PersonalizationSpec.Mode.AUTO][google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpec.Mode.AUTO].
+     * Possible values:
+     * * `purchased`: Indicates that this product has been purchased before.
+     *
      + * + * repeated string personal_labels = 7; + * + * @return A list containing the personalLabels. + */ + java.util.List getPersonalLabelsList(); + /** + * + * + * 
      +     * Specifies previous events related to this product for this user based on
+     * [UserEvent][google.cloud.retail.v2alpha.UserEvent] with same
+     * [SearchRequest.visitor_id][google.cloud.retail.v2alpha.SearchRequest.visitor_id]
+     * or [UserInfo.user_id][google.cloud.retail.v2alpha.UserInfo.user_id].
+     * This is set only when
+     * [SearchRequest.PersonalizationSpec.mode][google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpec.mode]
+     * is
+     * [SearchRequest.PersonalizationSpec.Mode.AUTO][google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpec.Mode.AUTO].
+     * Possible values:
+     * * `purchased`: Indicates that this product has been purchased before.
+     *
      + * + * repeated string personal_labels = 7; + * + * @return The count of personalLabels. + */ + int getPersonalLabelsCount(); + /** + * + * + * 
      +     * Specifies previous events related to this product for this user based on
+     * [UserEvent][google.cloud.retail.v2alpha.UserEvent] with same
+     * [SearchRequest.visitor_id][google.cloud.retail.v2alpha.SearchRequest.visitor_id]
+     * or [UserInfo.user_id][google.cloud.retail.v2alpha.UserInfo.user_id].
+     * This is set only when
+     * [SearchRequest.PersonalizationSpec.mode][google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpec.mode]
+     * is
+     * [SearchRequest.PersonalizationSpec.Mode.AUTO][google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpec.Mode.AUTO].
+     * Possible values:
+     * * `purchased`: Indicates that this product has been purchased before.
+     *
      + * + * repeated string personal_labels = 7; + * + * @param index The index of the element to return. + * @return The personalLabels at the given index. + */ + java.lang.String getPersonalLabels(int index); + /** + * + * + * 
      +     * Specifies previous events related to this product for this user based on
+     * [UserEvent][google.cloud.retail.v2alpha.UserEvent] with same
+     * [SearchRequest.visitor_id][google.cloud.retail.v2alpha.SearchRequest.visitor_id]
+     * or [UserInfo.user_id][google.cloud.retail.v2alpha.UserInfo.user_id].
+     * This is set only when
+     * [SearchRequest.PersonalizationSpec.mode][google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpec.mode]
+     * is
+     * [SearchRequest.PersonalizationSpec.Mode.AUTO][google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpec.Mode.AUTO].
+     * Possible values:
+     * * `purchased`: Indicates that this product has been purchased before.
+     *
      + * + * repeated string personal_labels = 7; + * + * @param index The index of the value to return. + * @return The bytes of the personalLabels at the given index. + */ + com.google.protobuf.ByteString getPersonalLabelsBytes(int index); } /** * @@ -515,6 +602,7 @@ private SearchResult(com.google.protobuf.GeneratedMessageV3.Builder builder) private SearchResult() { id_ = ""; + personalLabels_ = com.google.protobuf.LazyStringArrayList.EMPTY; } @java.lang.Override @@ -1070,6 +1158,103 @@ public com.google.protobuf.Value getVariantRollupValuesOrThrow(java.lang.String return map.get(key); } + public static final int PERSONAL_LABELS_FIELD_NUMBER = 7; + private com.google.protobuf.LazyStringList personalLabels_; + /** + * + * + * 
      +     * Specifies previous events related to this product for this user based on
+     * [UserEvent][google.cloud.retail.v2alpha.UserEvent] with same
+     * [SearchRequest.visitor_id][google.cloud.retail.v2alpha.SearchRequest.visitor_id]
+     * or [UserInfo.user_id][google.cloud.retail.v2alpha.UserInfo.user_id].
+     * This is set only when
+     * [SearchRequest.PersonalizationSpec.mode][google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpec.mode]
+     * is
+     * [SearchRequest.PersonalizationSpec.Mode.AUTO][google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpec.Mode.AUTO].
+     * Possible values:
+     * * `purchased`: Indicates that this product has been purchased before.
+     *
      + * + * repeated string personal_labels = 7; + * + * @return A list containing the personalLabels. + */ + public com.google.protobuf.ProtocolStringList getPersonalLabelsList() { + return personalLabels_; + } + /** + * + * + * 
      +     * Specifies previous events related to this product for this user based on
+     * [UserEvent][google.cloud.retail.v2alpha.UserEvent] with same
+     * [SearchRequest.visitor_id][google.cloud.retail.v2alpha.SearchRequest.visitor_id]
+     * or [UserInfo.user_id][google.cloud.retail.v2alpha.UserInfo.user_id].
+     * This is set only when
+     * [SearchRequest.PersonalizationSpec.mode][google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpec.mode]
+     * is
+     * [SearchRequest.PersonalizationSpec.Mode.AUTO][google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpec.Mode.AUTO].
+     * Possible values:
+     * * `purchased`: Indicates that this product has been purchased before.
+     *
      + * + * repeated string personal_labels = 7; + * + * @return The count of personalLabels. + */ + public int getPersonalLabelsCount() { + return personalLabels_.size(); + } + /** + * + * + * 
      +     * Specifies previous events related to this product for this user based on
+     * [UserEvent][google.cloud.retail.v2alpha.UserEvent] with same
+     * [SearchRequest.visitor_id][google.cloud.retail.v2alpha.SearchRequest.visitor_id]
+     * or [UserInfo.user_id][google.cloud.retail.v2alpha.UserInfo.user_id].
+     * This is set only when
+     * [SearchRequest.PersonalizationSpec.mode][google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpec.mode]
+     * is
+     * [SearchRequest.PersonalizationSpec.Mode.AUTO][google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpec.Mode.AUTO].
+     * Possible values:
+     * * `purchased`: Indicates that this product has been purchased before.
+     *
      + * + * repeated string personal_labels = 7; + * + * @param index The index of the element to return. + * @return The personalLabels at the given index. + */ + public java.lang.String getPersonalLabels(int index) { + return personalLabels_.get(index); + } + /** + * + * + * 
      +     * Specifies previous events related to this product for this user based on
+     * [UserEvent][google.cloud.retail.v2alpha.UserEvent] with same
+     * [SearchRequest.visitor_id][google.cloud.retail.v2alpha.SearchRequest.visitor_id]
+     * or [UserInfo.user_id][google.cloud.retail.v2alpha.UserInfo.user_id].
+     * This is set only when
+     * [SearchRequest.PersonalizationSpec.mode][google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpec.mode]
+     * is
+     * [SearchRequest.PersonalizationSpec.Mode.AUTO][google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpec.Mode.AUTO].
+     * Possible values:
+     * * `purchased`: Indicates that this product has been purchased before.
+     *
      + * + * repeated string personal_labels = 7; + * + * @param index The index of the value to return. + * @return The bytes of the personalLabels at the given index. + */ + public com.google.protobuf.ByteString getPersonalLabelsBytes(int index) { + return personalLabels_.getByteString(index); + } + private byte memoizedIsInitialized = -1; @java.lang.Override @@ -1103,6 +1288,9 @@ public void writeTo(com.google.protobuf.CodedOutputStream output) throws java.io internalGetVariantRollupValues(), VariantRollupValuesDefaultEntryHolder.defaultEntry, 5); + for (int i = 0; i < personalLabels_.size(); i++) { + com.google.protobuf.GeneratedMessageV3.writeString(output, 7, personalLabels_.getRaw(i)); + } getUnknownFields().writeTo(output); } @@ -1144,6 +1332,14 @@ public int getSerializedSize() { .build(); size += com.google.protobuf.CodedOutputStream.computeMessageSize(5, variantRollupValues__); } + { + int dataSize = 0; + for (int i = 0; i < personalLabels_.size(); i++) { + dataSize += computeStringSizeNoTag(personalLabels_.getRaw(i)); + } + size += dataSize; + size += 1 * getPersonalLabelsList().size(); + } size += getUnknownFields().getSerializedSize(); memoizedSize = size; return size; @@ -1170,6 +1366,7 @@ public boolean equals(final java.lang.Object obj) { return false; if (!internalGetVariantRollupValues().equals(other.internalGetVariantRollupValues())) return false; + if (!getPersonalLabelsList().equals(other.getPersonalLabelsList())) return false; if (!getUnknownFields().equals(other.getUnknownFields())) return false; return true; } @@ -1197,6 +1394,10 @@ public int hashCode() { hash = (37 * hash) + VARIANT_ROLLUP_VALUES_FIELD_NUMBER; hash = (53 * hash) + internalGetVariantRollupValues().hashCode(); } + if (getPersonalLabelsCount() > 0) { + hash = (37 * hash) + PERSONAL_LABELS_FIELD_NUMBER; + hash = (53 * hash) + getPersonalLabelsList().hashCode(); + } hash = (29 * hash) + getUnknownFields().hashCode(); memoizedHashCode = hash; return hash; @@ -1374,6 +1575,8 @@ public Builder clear() { internalGetMutableMatchingVariantFields().clear(); internalGetMutableVariantRollupValues().clear(); + personalLabels_ = com.google.protobuf.LazyStringArrayList.EMPTY; + bitField0_ = (bitField0_ & ~0x00000004); return this; } @@ -1414,6 +1617,11 @@ public com.google.cloud.retail.v2alpha.SearchResponse.SearchResult buildPartial( result.matchingVariantFields_.makeImmutable(); result.variantRollupValues_ = internalGetVariantRollupValues(); result.variantRollupValues_.makeImmutable(); + if (((bitField0_ & 0x00000004) != 0)) { + personalLabels_ = personalLabels_.getUnmodifiableView(); + bitField0_ = (bitField0_ & ~0x00000004); + } + result.personalLabels_ = personalLabels_; onBuilt(); return result; } @@ -1480,6 +1688,16 @@ public Builder mergeFrom(com.google.cloud.retail.v2alpha.SearchResponse.SearchRe internalGetMutableMatchingVariantFields() .mergeFrom(other.internalGetMatchingVariantFields()); internalGetMutableVariantRollupValues().mergeFrom(other.internalGetVariantRollupValues()); + if (!other.personalLabels_.isEmpty()) { + if (personalLabels_.isEmpty()) { + personalLabels_ = other.personalLabels_; + bitField0_ = (bitField0_ & ~0x00000004); + } else { + ensurePersonalLabelsIsMutable(); + personalLabels_.addAll(other.personalLabels_); + } + onChanged(); + } this.mergeUnknownFields(other.getUnknownFields()); onChanged(); return this; @@ -1549,6 +1767,13 @@ public Builder mergeFrom( .put(variantRollupValues__.getKey(), variantRollupValues__.getValue()); break; } // case 42 + case 58: + { + java.lang.String s = input.readStringRequireUtf8(); + ensurePersonalLabelsIsMutable(); + personalLabels_.add(s); + break; + } // case 58 default: { if (!super.parseUnknownField(input, extensionRegistry, tag)) { @@ -2618,6 +2843,255 @@ public Builder putAllVariantRollupValues( return this; } + private com.google.protobuf.LazyStringList personalLabels_ = + com.google.protobuf.LazyStringArrayList.EMPTY; + + private void ensurePersonalLabelsIsMutable() { + if (!((bitField0_ & 0x00000004) != 0)) { + personalLabels_ = new com.google.protobuf.LazyStringArrayList(personalLabels_); + bitField0_ |= 0x00000004; + } + } + /** + * + * + * 
      +       * Specifies previous events related to this product for this user based on
+       * [UserEvent][google.cloud.retail.v2alpha.UserEvent] with same
+       * [SearchRequest.visitor_id][google.cloud.retail.v2alpha.SearchRequest.visitor_id]
+       * or [UserInfo.user_id][google.cloud.retail.v2alpha.UserInfo.user_id].
+       * This is set only when
+       * [SearchRequest.PersonalizationSpec.mode][google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpec.mode]
+       * is
+       * [SearchRequest.PersonalizationSpec.Mode.AUTO][google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpec.Mode.AUTO].
+       * Possible values:
+       * * `purchased`: Indicates that this product has been purchased before.
+       *
      + * + * repeated string personal_labels = 7; + * + * @return A list containing the personalLabels. + */ + public com.google.protobuf.ProtocolStringList getPersonalLabelsList() { + return personalLabels_.getUnmodifiableView(); + } + /** + * + * + * 
      +       * Specifies previous events related to this product for this user based on
+       * [UserEvent][google.cloud.retail.v2alpha.UserEvent] with same
+       * [SearchRequest.visitor_id][google.cloud.retail.v2alpha.SearchRequest.visitor_id]
+       * or [UserInfo.user_id][google.cloud.retail.v2alpha.UserInfo.user_id].
+       * This is set only when
+       * [SearchRequest.PersonalizationSpec.mode][google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpec.mode]
+       * is
+       * [SearchRequest.PersonalizationSpec.Mode.AUTO][google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpec.Mode.AUTO].
+       * Possible values:
+       * * `purchased`: Indicates that this product has been purchased before.
+       *
      + * + * repeated string personal_labels = 7; + * + * @return The count of personalLabels. + */ + public int getPersonalLabelsCount() { + return personalLabels_.size(); + } + /** + * + * + * 
      +       * Specifies previous events related to this product for this user based on
+       * [UserEvent][google.cloud.retail.v2alpha.UserEvent] with same
+       * [SearchRequest.visitor_id][google.cloud.retail.v2alpha.SearchRequest.visitor_id]
+       * or [UserInfo.user_id][google.cloud.retail.v2alpha.UserInfo.user_id].
+       * This is set only when
+       * [SearchRequest.PersonalizationSpec.mode][google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpec.mode]
+       * is
+       * [SearchRequest.PersonalizationSpec.Mode.AUTO][google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpec.Mode.AUTO].
+       * Possible values:
+       * * `purchased`: Indicates that this product has been purchased before.
+       *
      + * + * repeated string personal_labels = 7; + * + * @param index The index of the element to return. + * @return The personalLabels at the given index. + */ + public java.lang.String getPersonalLabels(int index) { + return personalLabels_.get(index); + } + /** + * + * + * 
      +       * Specifies previous events related to this product for this user based on
+       * [UserEvent][google.cloud.retail.v2alpha.UserEvent] with same
+       * [SearchRequest.visitor_id][google.cloud.retail.v2alpha.SearchRequest.visitor_id]
+       * or [UserInfo.user_id][google.cloud.retail.v2alpha.UserInfo.user_id].
+       * This is set only when
+       * [SearchRequest.PersonalizationSpec.mode][google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpec.mode]
+       * is
+       * [SearchRequest.PersonalizationSpec.Mode.AUTO][google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpec.Mode.AUTO].
+       * Possible values:
+       * * `purchased`: Indicates that this product has been purchased before.
+       *
      + * + * repeated string personal_labels = 7; + * + * @param index The index of the value to return. + * @return The bytes of the personalLabels at the given index. + */ + public com.google.protobuf.ByteString getPersonalLabelsBytes(int index) { + return personalLabels_.getByteString(index); + } + /** + * + * + * 
      +       * Specifies previous events related to this product for this user based on
+       * [UserEvent][google.cloud.retail.v2alpha.UserEvent] with same
+       * [SearchRequest.visitor_id][google.cloud.retail.v2alpha.SearchRequest.visitor_id]
+       * or [UserInfo.user_id][google.cloud.retail.v2alpha.UserInfo.user_id].
+       * This is set only when
+       * [SearchRequest.PersonalizationSpec.mode][google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpec.mode]
+       * is
+       * [SearchRequest.PersonalizationSpec.Mode.AUTO][google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpec.Mode.AUTO].
+       * Possible values:
+       * * `purchased`: Indicates that this product has been purchased before.
+       *
      + * + * repeated string personal_labels = 7; + * + * @param index The index to set the value at. + * @param value The personalLabels to set. + * @return This builder for chaining. + */ + public Builder setPersonalLabels(int index, java.lang.String value) { + if (value == null) { + throw new NullPointerException(); + } + ensurePersonalLabelsIsMutable(); + personalLabels_.set(index, value); + onChanged(); + return this; + } + /** + * + * + * 
      +       * Specifies previous events related to this product for this user based on
+       * [UserEvent][google.cloud.retail.v2alpha.UserEvent] with same
+       * [SearchRequest.visitor_id][google.cloud.retail.v2alpha.SearchRequest.visitor_id]
+       * or [UserInfo.user_id][google.cloud.retail.v2alpha.UserInfo.user_id].
+       * This is set only when
+       * [SearchRequest.PersonalizationSpec.mode][google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpec.mode]
+       * is
+       * [SearchRequest.PersonalizationSpec.Mode.AUTO][google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpec.Mode.AUTO].
+       * Possible values:
+       * * `purchased`: Indicates that this product has been purchased before.
+       *
      + * + * repeated string personal_labels = 7; + * + * @param value The personalLabels to add. + * @return This builder for chaining. + */ + public Builder addPersonalLabels(java.lang.String value) { + if (value == null) { + throw new NullPointerException(); + } + ensurePersonalLabelsIsMutable(); + personalLabels_.add(value); + onChanged(); + return this; + } + /** + * + * + * 
      +       * Specifies previous events related to this product for this user based on
+       * [UserEvent][google.cloud.retail.v2alpha.UserEvent] with same
+       * [SearchRequest.visitor_id][google.cloud.retail.v2alpha.SearchRequest.visitor_id]
+       * or [UserInfo.user_id][google.cloud.retail.v2alpha.UserInfo.user_id].
+       * This is set only when
+       * [SearchRequest.PersonalizationSpec.mode][google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpec.mode]
+       * is
+       * [SearchRequest.PersonalizationSpec.Mode.AUTO][google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpec.Mode.AUTO].
+       * Possible values:
+       * * `purchased`: Indicates that this product has been purchased before.
+       *
      + * + * repeated string personal_labels = 7; + * + * @param values The personalLabels to add. + * @return This builder for chaining. + */ + public Builder addAllPersonalLabels(java.lang.Iterable values) { + ensurePersonalLabelsIsMutable(); + com.google.protobuf.AbstractMessageLite.Builder.addAll(values, personalLabels_); + onChanged(); + return this; + } + /** + * + * + * 
      +       * Specifies previous events related to this product for this user based on
+       * [UserEvent][google.cloud.retail.v2alpha.UserEvent] with same
+       * [SearchRequest.visitor_id][google.cloud.retail.v2alpha.SearchRequest.visitor_id]
+       * or [UserInfo.user_id][google.cloud.retail.v2alpha.UserInfo.user_id].
+       * This is set only when
+       * [SearchRequest.PersonalizationSpec.mode][google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpec.mode]
+       * is
+       * [SearchRequest.PersonalizationSpec.Mode.AUTO][google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpec.Mode.AUTO].
+       * Possible values:
+       * * `purchased`: Indicates that this product has been purchased before.
+       *
      + * + * repeated string personal_labels = 7; + * + * @return This builder for chaining. + */ + public Builder clearPersonalLabels() { + personalLabels_ = com.google.protobuf.LazyStringArrayList.EMPTY; + bitField0_ = (bitField0_ & ~0x00000004); + onChanged(); + return this; + } + /** + * + * + * 
      +       * Specifies previous events related to this product for this user based on
+       * [UserEvent][google.cloud.retail.v2alpha.UserEvent] with same
+       * [SearchRequest.visitor_id][google.cloud.retail.v2alpha.SearchRequest.visitor_id]
+       * or [UserInfo.user_id][google.cloud.retail.v2alpha.UserInfo.user_id].
+       * This is set only when
+       * [SearchRequest.PersonalizationSpec.mode][google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpec.mode]
+       * is
+       * [SearchRequest.PersonalizationSpec.Mode.AUTO][google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpec.Mode.AUTO].
+       * Possible values:
+       * * `purchased`: Indicates that this product has been purchased before.
+       *
      + * + * repeated string personal_labels = 7; + * + * @param value The bytes of the personalLabels to add. + * @return This builder for chaining. + */ + public Builder addPersonalLabelsBytes(com.google.protobuf.ByteString value) { + if (value == null) { + throw new NullPointerException(); + } + checkByteStringIsUtf8(value); + ensurePersonalLabelsIsMutable(); + personalLabels_.add(value); + onChanged(); + return this; + } + @java.lang.Override public final Builder setUnknownFields( final com.google.protobuf.UnknownFieldSet unknownFields) { diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/SearchServiceProto.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/SearchServiceProto.java index 6b63bc623fee..ed9baf7f85b9 100644 --- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/SearchServiceProto.java +++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/SearchServiceProto.java @@ -181,7 +181,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() { + "\n\003LOW\020\003\022\n\n\006LOWEST\020\004\"[\n\nSearchMode\022\033\n\027SEA" + "RCH_MODE_UNSPECIFIED\020\000\022\027\n\023PRODUCT_SEARCH" + "_ONLY\020\001\022\027\n\023FACETED_SEARCH_ONLY\020\002B\030\n\026_spe" - + "ll_correction_spec\"\355\n\n\016SearchResponse\022I\n" + + "ll_correction_spec\"\206\013\n\016SearchResponse\022I\n" + "\007results\030\001 \003(\01328.google.cloud.retail.v2a" + "lpha.SearchResponse.SearchResult\022A\n\006face" + "ts\030\002 \003(\01321.google.cloud.retail.v2alpha.S" @@ -194,7 +194,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() { + "ied_controls\030\014 \003(\t\022n\n\035invalid_condition_" + "boost_specs\030\016 \003(\0132G.google.cloud.retail." + "v2alpha.SearchRequest.BoostSpec.Conditio" - + "nBoostSpec\032\207\004\n\014SearchResult\022\n\n\002id\030\001 \001(\t\022" + + "nBoostSpec\032\240\004\n\014SearchResult\022\n\n\002id\030\001 \001(\t\022" + "5\n\007product\030\002 \001(\0132$.google.cloud.retail.v" + "2alpha.Product\022\036\n\026matching_variant_count" + "\030\003 \001(\005\022t\n\027matching_variant_fields\030\004 \003(\0132" @@ -202,36 +202,36 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() { + "onse.SearchResult.MatchingVariantFieldsE" + "ntry\022p\n\025variant_rollup_values\030\005 \003(\0132Q.go" + "ogle.cloud.retail.v2alpha.SearchResponse" - + ".SearchResult.VariantRollupValuesEntry\032X" - + "\n\032MatchingVariantFieldsEntry\022\013\n\003key\030\001 \001(" - + "\t\022)\n\005value\030\002 \001(\0132\032.google.protobuf.Field" - + "Mask:\0028\001\032R\n\030VariantRollupValuesEntry\022\013\n\003" - + "key\030\001 \001(\t\022%\n\005value\030\002 \001(\0132\026.google.protob" - + "uf.Value:\0028\001\032\230\002\n\005Facet\022\013\n\003key\030\001 \001(\t\022L\n\006v" - + "alues\030\002 \003(\0132<.google.cloud.retail.v2alph" - + "a.SearchResponse.Facet.FacetValue\022\025\n\rdyn" - + "amic_facet\030\003 \001(\010\032\234\001\n\nFacetValue\022\017\n\005value" - + "\030\001 \001(\tH\000\0229\n\010interval\030\002 \001(\0132%.google.clou" - + "d.retail.v2alpha.IntervalH\000\022\r\n\005count\030\003 \001" - + "(\003\022\021\n\tmin_value\030\005 \001(\001\022\021\n\tmax_value\030\006 \001(\001" - + "B\r\n\013facet_value\032I\n\022QueryExpansionInfo\022\026\n" - + "\016expanded_query\030\001 \001(\010\022\033\n\023pinned_result_c" - + "ount\030\002 \001(\0032\354\002\n\rSearchService\022\217\002\n\006Search\022" - + "*.google.cloud.retail.v2alpha.SearchRequ" - + "est\032+.google.cloud.retail.v2alpha.Search" - + "Response\"\253\001\202\323\344\223\002\244\001\"J/v2alpha/{placement=" - + "projects/*/locations/*/catalogs/*/placem" - + "ents/*}:search:\001*ZS\"N/v2alpha/{placement" - + "=projects/*/locations/*/catalogs/*/servi" - + "ngConfigs/*}:search:\001*\032I\312A\025retail.google" - + "apis.com\322A.https://www.googleapis.com/au" - + "th/cloud-platformB\340\001\n\037com.google.cloud.r" - + "etail.v2alphaB\022SearchServiceProtoP\001ZAgoo" - + "gle.golang.org/genproto/googleapis/cloud" - + "/retail/v2alpha;retail\242\002\006RETAIL\252\002\033Google" - + ".Cloud.Retail.V2Alpha\312\002\033Google\\Cloud\\Ret" - + "ail\\V2alpha\352\002\036Google::Cloud::Retail::V2a" - + "lphab\006proto3" + + ".SearchResult.VariantRollupValuesEntry\022\027" + + "\n\017personal_labels\030\007 \003(\t\032X\n\032MatchingVaria" + + "ntFieldsEntry\022\013\n\003key\030\001 \001(\t\022)\n\005value\030\002 \001(" + + "\0132\032.google.protobuf.FieldMask:\0028\001\032R\n\030Var" + + "iantRollupValuesEntry\022\013\n\003key\030\001 \001(\t\022%\n\005va" + + "lue\030\002 \001(\0132\026.google.protobuf.Value:\0028\001\032\230\002" + + "\n\005Facet\022\013\n\003key\030\001 \001(\t\022L\n\006values\030\002 \003(\0132<.g" + + "oogle.cloud.retail.v2alpha.SearchRespons" + + "e.Facet.FacetValue\022\025\n\rdynamic_facet\030\003 \001(" + + "\010\032\234\001\n\nFacetValue\022\017\n\005value\030\001 \001(\tH\000\0229\n\010int" + + "erval\030\002 \001(\0132%.google.cloud.retail.v2alph" + + "a.IntervalH\000\022\r\n\005count\030\003 \001(\003\022\021\n\tmin_value" + + "\030\005 \001(\001\022\021\n\tmax_value\030\006 \001(\001B\r\n\013facet_value" + + "\032I\n\022QueryExpansionInfo\022\026\n\016expanded_query" + + "\030\001 \001(\010\022\033\n\023pinned_result_count\030\002 \001(\0032\354\002\n\r" + + "SearchService\022\217\002\n\006Search\022*.google.cloud." + + "retail.v2alpha.SearchRequest\032+.google.cl" + + "oud.retail.v2alpha.SearchResponse\"\253\001\202\323\344\223" + + "\002\244\001\"J/v2alpha/{placement=projects/*/loca" + + "tions/*/catalogs/*/placements/*}:search:" + + "\001*ZS\"N/v2alpha/{placement=projects/*/loc" + + "ations/*/catalogs/*/servingConfigs/*}:se" + + "arch:\001*\032I\312A\025retail.googleapis.com\322A.http" + + "s://www.googleapis.com/auth/cloud-platfo" + + "rmB\340\001\n\037com.google.cloud.retail.v2alphaB\022" + + "SearchServiceProtoP\001ZAgoogle.golang.org/" + + "genproto/googleapis/cloud/retail/v2alpha" + + ";retail\242\002\006RETAIL\252\002\033Google.Cloud.Retail.V" + + "2Alpha\312\002\033Google\\Cloud\\Retail\\V2alpha\352\002\036G" + + "oogle::Cloud::Retail::V2alphab\006proto3" }; descriptor = com.google.protobuf.Descriptors.FileDescriptor.internalBuildGeneratedFileFrom( @@ -404,6 +404,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() { "MatchingVariantCount", "MatchingVariantFields", "VariantRollupValues", + "PersonalLabels", }); internal_static_google_cloud_retail_v2alpha_SearchResponse_SearchResult_MatchingVariantFieldsEntry_descriptor = internal_static_google_cloud_retail_v2alpha_SearchResponse_SearchResult_descriptor diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/SearchSolutionUseCase.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/SearchSolutionUseCase.java index 46295b0f7a66..e0d3ed8d4132 100644 --- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/SearchSolutionUseCase.java +++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/SearchSolutionUseCase.java @@ -33,7 +33,7 @@ public enum SearchSolutionUseCase implements com.google.protobuf.ProtocolMessage * * 
          * The value when it's unspecified. In this case, server behavior defaults to
-   * [SEARCH_SOLUTION_USE_CASE_SEARCH][].
+   * [SEARCH_SOLUTION_USE_CASE_SEARCH][google.cloud.retail.v2alpha.SearchSolutionUseCase.SEARCH_SOLUTION_USE_CASE_SEARCH].
    *
      * * SEARCH_SOLUTION_USE_CASE_UNSPECIFIED = 0; @@ -69,7 +69,7 @@ public enum SearchSolutionUseCase implements com.google.protobuf.ProtocolMessage * * 
          * The value when it's unspecified. In this case, server behavior defaults to
-   * [SEARCH_SOLUTION_USE_CASE_SEARCH][].
+   * [SEARCH_SOLUTION_USE_CASE_SEARCH][google.cloud.retail.v2alpha.SearchSolutionUseCase.SEARCH_SOLUTION_USE_CASE_SEARCH].
    *
      * * SEARCH_SOLUTION_USE_CASE_UNSPECIFIED = 0; diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ServingConfig.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ServingConfig.java index f400a9964eff..cca79344f49d 100644 --- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ServingConfig.java +++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ServingConfig.java @@ -24,8 +24,6 @@ * 
        * Configures metadata that is used to generate serving time results (e.g.
  * search results or recommendation predictions).
- * The ServingConfig is passed in the search and predict request and together
- * with the Catalog.default_branch, generates results.
  *
      * * Protobuf type {@code google.cloud.retail.v2alpha.ServingConfig} @@ -55,6 +53,7 @@ private ServingConfig() { replacementControlIds_ = com.google.protobuf.LazyStringArrayList.EMPTY; ignoreControlIds_ = com.google.protobuf.LazyStringArrayList.EMPTY; diversityLevel_ = ""; + diversityType_ = 0; enableCategoryFilterLevel_ = ""; solutionTypes_ = java.util.Collections.emptyList(); } @@ -85,6 +84,164 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() { com.google.cloud.retail.v2alpha.ServingConfig.Builder.class); } + /** + * + * + * 
      +   * What type of diversity - data or rule based.
+   * If none is specified, default to rule based.
+   *
      + * + * Protobuf enum {@code google.cloud.retail.v2alpha.ServingConfig.DiversityType} + */ + public enum DiversityType implements com.google.protobuf.ProtocolMessageEnum { + /** + * + * + * 
      +     * Default value.
+     *
      + * + * DIVERSITY_TYPE_UNSPECIFIED = 0; + */ + DIVERSITY_TYPE_UNSPECIFIED(0), + /** + * + * + * 
      +     * Rule based diversity.
+     *
      + * + * RULE_BASED_DIVERSITY = 2; + */ + RULE_BASED_DIVERSITY(2), + /** + * + * + * 
      +     * Data driven diversity.
+     *
      + * + * DATA_DRIVEN_DIVERSITY = 3; + */ + DATA_DRIVEN_DIVERSITY(3), + UNRECOGNIZED(-1), + ; + + /** + * + * + * 
      +     * Default value.
+     *
      + * + * DIVERSITY_TYPE_UNSPECIFIED = 0; + */ + public static final int DIVERSITY_TYPE_UNSPECIFIED_VALUE = 0; + /** + * + * + * 
      +     * Rule based diversity.
+     *
      + * + * RULE_BASED_DIVERSITY = 2; + */ + public static final int RULE_BASED_DIVERSITY_VALUE = 2; + /** + * + * + * 
      +     * Data driven diversity.
+     *
      + * + * DATA_DRIVEN_DIVERSITY = 3; + */ + public static final int DATA_DRIVEN_DIVERSITY_VALUE = 3; + + public final int getNumber() { + if (this == UNRECOGNIZED) { + throw new java.lang.IllegalArgumentException( + "Can't get the number of an unknown enum value."); + } + return value; + } + + /** + * @param value The numeric wire value of the corresponding enum entry. + * @return The enum associated with the given numeric wire value. + * @deprecated Use {@link #forNumber(int)} instead. + */ + @java.lang.Deprecated + public static DiversityType valueOf(int value) { + return forNumber(value); + } + + /** + * @param value The numeric wire value of the corresponding enum entry. + * @return The enum associated with the given numeric wire value. + */ + public static DiversityType forNumber(int value) { + switch (value) { + case 0: + return DIVERSITY_TYPE_UNSPECIFIED; + case 2: + return RULE_BASED_DIVERSITY; + case 3: + return DATA_DRIVEN_DIVERSITY; + default: + return null; + } + } + + public static com.google.protobuf.Internal.EnumLiteMap internalGetValueMap() { + return internalValueMap; + } + + private static final com.google.protobuf.Internal.EnumLiteMap internalValueMap = + new com.google.protobuf.Internal.EnumLiteMap() { + public DiversityType findValueByNumber(int number) { + return DiversityType.forNumber(number); + } + }; + + public final com.google.protobuf.Descriptors.EnumValueDescriptor getValueDescriptor() { + if (this == UNRECOGNIZED) { + throw new java.lang.IllegalStateException( + "Can't get the descriptor of an unrecognized enum value."); + } + return getDescriptor().getValues().get(ordinal()); + } + + public final com.google.protobuf.Descriptors.EnumDescriptor getDescriptorForType() { + return getDescriptor(); + } + + public static final com.google.protobuf.Descriptors.EnumDescriptor getDescriptor() { + return com.google.cloud.retail.v2alpha.ServingConfig.getDescriptor().getEnumTypes().get(0); + } + + private static final DiversityType[] VALUES = values(); + + public static DiversityType valueOf(com.google.protobuf.Descriptors.EnumValueDescriptor desc) { + if (desc.getType() != getDescriptor()) { + throw new java.lang.IllegalArgumentException("EnumValueDescriptor is not for this type."); + } + if (desc.getIndex() == -1) { + return UNRECOGNIZED; + } + return VALUES[desc.getIndex()]; + } + + private final int value; + + private DiversityType(int value) { + this.value = value; + } + + // @@protoc_insertion_point(enum_scope:google.cloud.retail.v2alpha.ServingConfig.DiversityType) + } + public static final int NAME_FIELD_NUMBER = 1; private volatile java.lang.Object name_; /** @@ -197,7 +354,8 @@ public com.google.protobuf.ByteString getDisplayNameBytes() { * * * 
      -   * The id of the model to use at serving time.
+   * The id of the model in the same
+   * [Catalog][google.cloud.retail.v2alpha.Catalog] to use at serving time.
    * Currently only RecommendationModels are supported:
    * https://cloud.google.com/retail/recommendations-ai/docs/create-models
    * Can be changed but only to a compatible model (e.g.
@@ -228,7 +386,8 @@ public java.lang.String getModelId() {
    *
    *
    * 
      -   * The id of the model to use at serving time.
+   * The id of the model in the same
+   * [Catalog][google.cloud.retail.v2alpha.Catalog] to use at serving time.
    * Currently only RecommendationModels are supported:
    * https://cloud.google.com/retail/recommendations-ai/docs/create-models
    * Can be changed but only to a compatible model (e.g.
@@ -268,12 +427,12 @@ public com.google.protobuf.ByteString getModelIdBytes() {
    * highest-priced items first. This setting could result in a decrease in
    * click-through and conversion rates.
    *  Allowed values are:
-   * * 'no-price-reranking'
-   * * 'low-price-raranking'
-   * * 'medium-price-reranking'
-   * * 'high-price-reranking'
+   * * `no-price-reranking`
+   * * `low-price-raranking`
+   * * `medium-price-reranking`
+   * * `high-price-reranking`
    * If not specified, we choose default based on model type. Default value:
-   * 'no-price-reranking'.
+   * `no-price-reranking`.
    * Can only be set if
    * [solution_types][google.cloud.retail.v2alpha.ServingConfig.solution_types]
    * is
@@ -306,12 +465,12 @@ public java.lang.String getPriceRerankingLevel() {
    * highest-priced items first. This setting could result in a decrease in
    * click-through and conversion rates.
    *  Allowed values are:
-   * * 'no-price-reranking'
-   * * 'low-price-raranking'
-   * * 'medium-price-reranking'
-   * * 'high-price-reranking'
+   * * `no-price-reranking`
+   * * `low-price-raranking`
+   * * `medium-price-reranking`
+   * * `high-price-reranking`
    * If not specified, we choose default based on model type. Default value:
-   * 'no-price-reranking'.
+   * `no-price-reranking`.
    * Can only be set if
    * [solution_types][google.cloud.retail.v2alpha.ServingConfig.solution_types]
    * is
@@ -1254,14 +1413,14 @@ public com.google.protobuf.ByteString getIgnoreControlIdsBytes(int index) {
    *
    * 
          * How much diversity to use in recommendation model results e.g.
-   * 'medium-diversity' or 'high-diversity'. Currently supported values:
-   * * 'no-diversity'
-   * * 'low-diversity'
-   * * 'medium-diversity'
-   * * 'high-diversity'
-   * * 'auto-diversity'
+   * `medium-diversity` or `high-diversity`. Currently supported values:
+   * * `no-diversity`
+   * * `low-diversity`
+   * * `medium-diversity`
+   * * `high-diversity`
+   * * `auto-diversity`
    * If not specified, we choose default based on recommendation model
-   * type. Default value: 'no-diversity'.
+   * type. Default value: `no-diversity`.
    * Can only be set if
    * [solution_types][google.cloud.retail.v2alpha.ServingConfig.solution_types]
    * is
@@ -1289,14 +1448,14 @@ public java.lang.String getDiversityLevel() {
    *
    * 
          * How much diversity to use in recommendation model results e.g.
-   * 'medium-diversity' or 'high-diversity'. Currently supported values:
-   * * 'no-diversity'
-   * * 'low-diversity'
-   * * 'medium-diversity'
-   * * 'high-diversity'
-   * * 'auto-diversity'
+   * `medium-diversity` or `high-diversity`. Currently supported values:
+   * * `no-diversity`
+   * * `low-diversity`
+   * * `medium-diversity`
+   * * `high-diversity`
+   * * `auto-diversity`
    * If not specified, we choose default based on recommendation model
-   * type. Default value: 'no-diversity'.
+   * type. Default value: `no-diversity`.
    * Can only be set if
    * [solution_types][google.cloud.retail.v2alpha.ServingConfig.solution_types]
    * is
@@ -1320,18 +1479,56 @@ public com.google.protobuf.ByteString getDiversityLevelBytes() {
     }
   }
 
+  public static final int DIVERSITY_TYPE_FIELD_NUMBER = 20;
+  private int diversityType_;
+  /**
+   *
+   *
+   * 
      +   * What kind of diversity to use - data driven or rule based.
+   * 
      
+   *
+   * .google.cloud.retail.v2alpha.ServingConfig.DiversityType diversity_type = 20;
+   *
+   * @return The enum numeric value on the wire for diversityType.
+   */
+  @java.lang.Override
+  public int getDiversityTypeValue() {
+    return diversityType_;
+  }
+  /**
+   *
+   *
+   * 
      +   * What kind of diversity to use - data driven or rule based.
+   * 
      
+   *
+   * .google.cloud.retail.v2alpha.ServingConfig.DiversityType diversity_type = 20;
+   *
+   * @return The diversityType.
+   */
+  @java.lang.Override
+  public com.google.cloud.retail.v2alpha.ServingConfig.DiversityType getDiversityType() {
+    @SuppressWarnings("deprecation")
+    com.google.cloud.retail.v2alpha.ServingConfig.DiversityType result =
+        com.google.cloud.retail.v2alpha.ServingConfig.DiversityType.valueOf(diversityType_);
+    return result == null
+        ? com.google.cloud.retail.v2alpha.ServingConfig.DiversityType.UNRECOGNIZED
+        : result;
+  }
+
   public static final int ENABLE_CATEGORY_FILTER_LEVEL_FIELD_NUMBER = 16;
   private volatile java.lang.Object enableCategoryFilterLevel_;
   /**
    *
    *
    * 
      -   * Whether to add additional category filters on the 'similar-items' model.
+   * Whether to add additional category filters on the `similar-items` model.
    * If not specified, we enable it by default.
    *  Allowed values are:
-   * * 'no-category-match': No additional filtering of original results from
+   * * `no-category-match`: No additional filtering of original results from
    *   the model and the customer's filters.
-   * * 'relaxed-category-match': Only keep results with categories that match
+   * * `relaxed-category-match`: Only keep results with categories that match
    *   at least one item categories in the PredictRequests's context item.
    *   * If customer also sends filters in the PredictRequest, then the results
    *   will satisfy both conditions (user given and category match).
@@ -1361,12 +1558,12 @@ public java.lang.String getEnableCategoryFilterLevel() {
    *
    *
    * 
      -   * Whether to add additional category filters on the 'similar-items' model.
+   * Whether to add additional category filters on the `similar-items` model.
    * If not specified, we enable it by default.
    *  Allowed values are:
-   * * 'no-category-match': No additional filtering of original results from
+   * * `no-category-match`: No additional filtering of original results from
    *   the model and the customer's filters.
-   * * 'relaxed-category-match': Only keep results with categories that match
+   * * `relaxed-category-match`: Only keep results with categories that match
    *   at least one item categories in the PredictRequests's context item.
    *   * If customer also sends filters in the PredictRequest, then the results
    *   will satisfy both conditions (user given and category match).
@@ -1393,6 +1590,95 @@ public com.google.protobuf.ByteString getEnableCategoryFilterLevelBytes() {
     }
   }
 
+  public static final int PERSONALIZATION_SPEC_FIELD_NUMBER = 21;
+  private com.google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpec personalizationSpec_;
+  /**
+   *
+   *
+   * 
      +   * The specification for personalization spec.
+   * Can only be set if
+   * [solution_types][google.cloud.retail.v2alpha.ServingConfig.solution_types]
+   * is
+   * [SOLUTION_TYPE_SEARCH][google.cloud.retail.v2main.SolutionType.SOLUTION_TYPE_SEARCH].
+   * Notice that if both
+   * [ServingConfig.personalization_spec][google.cloud.retail.v2alpha.ServingConfig.personalization_spec]
+   * and
+   * [SearchRequest.personalization_spec][google.cloud.retail.v2alpha.SearchRequest.personalization_spec]
+   * are set.
+   * [SearchRequest.personalization_spec][google.cloud.retail.v2alpha.SearchRequest.personalization_spec]
+   * will override
+   * [ServingConfig.personalization_spec][google.cloud.retail.v2alpha.ServingConfig.personalization_spec].
+   * 
      
+   *
+   * .google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpec personalization_spec = 21;
+   * 
+   *
+   * @return Whether the personalizationSpec field is set.
+   */
+  @java.lang.Override
+  public boolean hasPersonalizationSpec() {
+    return personalizationSpec_ != null;
+  }
+  /**
+   *
+   *
+   * 
      +   * The specification for personalization spec.
+   * Can only be set if
+   * [solution_types][google.cloud.retail.v2alpha.ServingConfig.solution_types]
+   * is
+   * [SOLUTION_TYPE_SEARCH][google.cloud.retail.v2main.SolutionType.SOLUTION_TYPE_SEARCH].
+   * Notice that if both
+   * [ServingConfig.personalization_spec][google.cloud.retail.v2alpha.ServingConfig.personalization_spec]
+   * and
+   * [SearchRequest.personalization_spec][google.cloud.retail.v2alpha.SearchRequest.personalization_spec]
+   * are set.
+   * [SearchRequest.personalization_spec][google.cloud.retail.v2alpha.SearchRequest.personalization_spec]
+   * will override
+   * [ServingConfig.personalization_spec][google.cloud.retail.v2alpha.ServingConfig.personalization_spec].
+   * 
      
+   *
+   * .google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpec personalization_spec = 21;
+   * 
+   *
+   * @return The personalizationSpec.
+   */
+  @java.lang.Override
+  public com.google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpec
+      getPersonalizationSpec() {
+    return personalizationSpec_ == null
+        ? com.google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpec.getDefaultInstance()
+        : personalizationSpec_;
+  }
+  /**
+   *
+   *
+   * 
      +   * The specification for personalization spec.
+   * Can only be set if
+   * [solution_types][google.cloud.retail.v2alpha.ServingConfig.solution_types]
+   * is
+   * [SOLUTION_TYPE_SEARCH][google.cloud.retail.v2main.SolutionType.SOLUTION_TYPE_SEARCH].
+   * Notice that if both
+   * [ServingConfig.personalization_spec][google.cloud.retail.v2alpha.ServingConfig.personalization_spec]
+   * and
+   * [SearchRequest.personalization_spec][google.cloud.retail.v2alpha.SearchRequest.personalization_spec]
+   * are set.
+   * [SearchRequest.personalization_spec][google.cloud.retail.v2alpha.SearchRequest.personalization_spec]
+   * will override
+   * [ServingConfig.personalization_spec][google.cloud.retail.v2alpha.ServingConfig.personalization_spec].
+   * 
      
+   *
+   * .google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpec personalization_spec = 21;
+   * 
+   */
+  @java.lang.Override
+  public com.google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpecOrBuilder
+      getPersonalizationSpecOrBuilder() {
+    return getPersonalizationSpec();
+  }
+
   public static final int SOLUTION_TYPES_FIELD_NUMBER = 19;
   private java.util.List solutionTypes_;
   private static final com.google.protobuf.Internal.ListAdapter.Converter<
@@ -1580,6 +1866,14 @@ public void writeTo(com.google.protobuf.CodedOutputStream output) throws java.io
     for (int i = 0; i < solutionTypes_.size(); i++) {
       output.writeEnumNoTag(solutionTypes_.get(i));
     }
+    if (diversityType_
+        != com.google.cloud.retail.v2alpha.ServingConfig.DiversityType.DIVERSITY_TYPE_UNSPECIFIED
+            .getNumber()) {
+      output.writeEnum(20, diversityType_);
+    }
+    if (personalizationSpec_ != null) {
+      output.writeMessage(21, getPersonalizationSpec());
+    }
     getUnknownFields().writeTo(output);
   }
 
@@ -1696,6 +1990,15 @@ public int getSerializedSize() {
       }
       solutionTypesMemoizedSerializedSize = dataSize;
     }
+    if (diversityType_
+        != com.google.cloud.retail.v2alpha.ServingConfig.DiversityType.DIVERSITY_TYPE_UNSPECIFIED
+            .getNumber()) {
+      size += com.google.protobuf.CodedOutputStream.computeEnumSize(20, diversityType_);
+    }
+    if (personalizationSpec_ != null) {
+      size +=
+          com.google.protobuf.CodedOutputStream.computeMessageSize(21, getPersonalizationSpec());
+    }
     size += getUnknownFields().getSerializedSize();
     memoizedSize = size;
     return size;
@@ -1733,7 +2036,12 @@ public boolean equals(final java.lang.Object obj) {
     if (!getReplacementControlIdsList().equals(other.getReplacementControlIdsList())) return false;
     if (!getIgnoreControlIdsList().equals(other.getIgnoreControlIdsList())) return false;
     if (!getDiversityLevel().equals(other.getDiversityLevel())) return false;
+    if (diversityType_ != other.diversityType_) return false;
     if (!getEnableCategoryFilterLevel().equals(other.getEnableCategoryFilterLevel())) return false;
+    if (hasPersonalizationSpec() != other.hasPersonalizationSpec()) return false;
+    if (hasPersonalizationSpec()) {
+      if (!getPersonalizationSpec().equals(other.getPersonalizationSpec())) return false;
+    }
     if (!solutionTypes_.equals(other.solutionTypes_)) return false;
     if (!getUnknownFields().equals(other.getUnknownFields())) return false;
     return true;
@@ -1796,8 +2104,14 @@ public int hashCode() {
     }
     hash = (37 * hash) + DIVERSITY_LEVEL_FIELD_NUMBER;
     hash = (53 * hash) + getDiversityLevel().hashCode();
+    hash = (37 * hash) + DIVERSITY_TYPE_FIELD_NUMBER;
+    hash = (53 * hash) + diversityType_;
     hash = (37 * hash) + ENABLE_CATEGORY_FILTER_LEVEL_FIELD_NUMBER;
     hash = (53 * hash) + getEnableCategoryFilterLevel().hashCode();
+    if (hasPersonalizationSpec()) {
+      hash = (37 * hash) + PERSONALIZATION_SPEC_FIELD_NUMBER;
+      hash = (53 * hash) + getPersonalizationSpec().hashCode();
+    }
     if (getSolutionTypesCount() > 0) {
       hash = (37 * hash) + SOLUTION_TYPES_FIELD_NUMBER;
       hash = (53 * hash) + solutionTypes_.hashCode();
@@ -1908,8 +2222,6 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
    * 
          * Configures metadata that is used to generate serving time results (e.g.
    * search results or recommendation predictions).
-   * The ServingConfig is passed in the search and predict request and together
-   * with the Catalog.default_branch, generates results.
    * 
      
    *
    * Protobuf type {@code google.cloud.retail.v2alpha.ServingConfig}
@@ -1977,8 +2289,16 @@ public Builder clear() {
       bitField0_ = (bitField0_ & ~0x00000100);
       diversityLevel_ = "";
 
+      diversityType_ = 0;
+
       enableCategoryFilterLevel_ = "";
 
+      if (personalizationSpecBuilder_ == null) {
+        personalizationSpec_ = null;
+      } else {
+        personalizationSpec_ = null;
+        personalizationSpecBuilder_ = null;
+      }
       solutionTypes_ = java.util.Collections.emptyList();
       bitField0_ = (bitField0_ & ~0x00000200);
       return this;
@@ -2064,7 +2384,13 @@ public com.google.cloud.retail.v2alpha.ServingConfig buildPartial() {
       }
       result.ignoreControlIds_ = ignoreControlIds_;
       result.diversityLevel_ = diversityLevel_;
+      result.diversityType_ = diversityType_;
       result.enableCategoryFilterLevel_ = enableCategoryFilterLevel_;
+      if (personalizationSpecBuilder_ == null) {
+        result.personalizationSpec_ = personalizationSpec_;
+      } else {
+        result.personalizationSpec_ = personalizationSpecBuilder_.build();
+      }
       if (((bitField0_ & 0x00000200) != 0)) {
         solutionTypes_ = java.util.Collections.unmodifiableList(solutionTypes_);
         bitField0_ = (bitField0_ & ~0x00000200);
@@ -2232,10 +2558,16 @@ public Builder mergeFrom(com.google.cloud.retail.v2alpha.ServingConfig other) {
         diversityLevel_ = other.diversityLevel_;
         onChanged();
       }
+      if (other.diversityType_ != 0) {
+        setDiversityTypeValue(other.getDiversityTypeValue());
+      }
       if (!other.getEnableCategoryFilterLevel().isEmpty()) {
         enableCategoryFilterLevel_ = other.enableCategoryFilterLevel_;
         onChanged();
       }
+      if (other.hasPersonalizationSpec()) {
+        mergePersonalizationSpec(other.getPersonalizationSpec());
+      }
       if (!other.solutionTypes_.isEmpty()) {
         if (solutionTypes_.isEmpty()) {
           solutionTypes_ = other.solutionTypes_;
@@ -2397,6 +2729,19 @@ public Builder mergeFrom(
                 input.popLimit(oldLimit);
                 break;
               } // case 154
+            case 160:
+              {
+                diversityType_ = input.readEnum();
+
+                break;
+              } // case 160
+            case 170:
+              {
+                input.readMessage(
+                    getPersonalizationSpecFieldBuilder().getBuilder(), extensionRegistry);
+
+                break;
+              } // case 170
             default:
               {
                 if (!super.parseUnknownField(input, extensionRegistry, tag)) {
@@ -2653,7 +2998,8 @@ public Builder setDisplayNameBytes(com.google.protobuf.ByteString value) {
      *
      *
      * 
      -     * The id of the model to use at serving time.
+     * The id of the model in the same
+     * [Catalog][google.cloud.retail.v2alpha.Catalog] to use at serving time.
      * Currently only RecommendationModels are supported:
      * https://cloud.google.com/retail/recommendations-ai/docs/create-models
      * Can be changed but only to a compatible model (e.g.
@@ -2683,7 +3029,8 @@ public java.lang.String getModelId() {
      *
      *
      * 
      -     * The id of the model to use at serving time.
+     * The id of the model in the same
+     * [Catalog][google.cloud.retail.v2alpha.Catalog] to use at serving time.
      * Currently only RecommendationModels are supported:
      * https://cloud.google.com/retail/recommendations-ai/docs/create-models
      * Can be changed but only to a compatible model (e.g.
@@ -2713,7 +3060,8 @@ public com.google.protobuf.ByteString getModelIdBytes() {
      *
      *
      * 
      -     * The id of the model to use at serving time.
+     * The id of the model in the same
+     * [Catalog][google.cloud.retail.v2alpha.Catalog] to use at serving time.
      * Currently only RecommendationModels are supported:
      * https://cloud.google.com/retail/recommendations-ai/docs/create-models
      * Can be changed but only to a compatible model (e.g.
@@ -2742,7 +3090,8 @@ public Builder setModelId(java.lang.String value) {
      *
      *
      * 
      -     * The id of the model to use at serving time.
+     * The id of the model in the same
+     * [Catalog][google.cloud.retail.v2alpha.Catalog] to use at serving time.
      * Currently only RecommendationModels are supported:
      * https://cloud.google.com/retail/recommendations-ai/docs/create-models
      * Can be changed but only to a compatible model (e.g.
@@ -2767,7 +3116,8 @@ public Builder clearModelId() {
      *
      *
      * 
      -     * The id of the model to use at serving time.
+     * The id of the model in the same
+     * [Catalog][google.cloud.retail.v2alpha.Catalog] to use at serving time.
      * Currently only RecommendationModels are supported:
      * https://cloud.google.com/retail/recommendations-ai/docs/create-models
      * Can be changed but only to a compatible model (e.g.
@@ -2805,12 +3155,12 @@ public Builder setModelIdBytes(com.google.protobuf.ByteString value) {
      * highest-priced items first. This setting could result in a decrease in
      * click-through and conversion rates.
      *  Allowed values are:
-     * * 'no-price-reranking'
-     * * 'low-price-raranking'
-     * * 'medium-price-reranking'
-     * * 'high-price-reranking'
+     * * `no-price-reranking`
+     * * `low-price-raranking`
+     * * `medium-price-reranking`
+     * * `high-price-reranking`
      * If not specified, we choose default based on model type. Default value:
-     * 'no-price-reranking'.
+     * `no-price-reranking`.
      * Can only be set if
      * [solution_types][google.cloud.retail.v2alpha.ServingConfig.solution_types]
      * is
@@ -2842,12 +3192,12 @@ public java.lang.String getPriceRerankingLevel() {
      * highest-priced items first. This setting could result in a decrease in
      * click-through and conversion rates.
      *  Allowed values are:
-     * * 'no-price-reranking'
-     * * 'low-price-raranking'
-     * * 'medium-price-reranking'
-     * * 'high-price-reranking'
+     * * `no-price-reranking`
+     * * `low-price-raranking`
+     * * `medium-price-reranking`
+     * * `high-price-reranking`
      * If not specified, we choose default based on model type. Default value:
-     * 'no-price-reranking'.
+     * `no-price-reranking`.
      * Can only be set if
      * [solution_types][google.cloud.retail.v2alpha.ServingConfig.solution_types]
      * is
@@ -2879,12 +3229,12 @@ public com.google.protobuf.ByteString getPriceRerankingLevelBytes() {
      * highest-priced items first. This setting could result in a decrease in
      * click-through and conversion rates.
      *  Allowed values are:
-     * * 'no-price-reranking'
-     * * 'low-price-raranking'
-     * * 'medium-price-reranking'
-     * * 'high-price-reranking'
+     * * `no-price-reranking`
+     * * `low-price-raranking`
+     * * `medium-price-reranking`
+     * * `high-price-reranking`
      * If not specified, we choose default based on model type. Default value:
-     * 'no-price-reranking'.
+     * `no-price-reranking`.
      * Can only be set if
      * [solution_types][google.cloud.retail.v2alpha.ServingConfig.solution_types]
      * is
@@ -2915,12 +3265,12 @@ public Builder setPriceRerankingLevel(java.lang.String value) {
      * highest-priced items first. This setting could result in a decrease in
      * click-through and conversion rates.
      *  Allowed values are:
-     * * 'no-price-reranking'
-     * * 'low-price-raranking'
-     * * 'medium-price-reranking'
-     * * 'high-price-reranking'
+     * * `no-price-reranking`
+     * * `low-price-raranking`
+     * * `medium-price-reranking`
+     * * `high-price-reranking`
      * If not specified, we choose default based on model type. Default value:
-     * 'no-price-reranking'.
+     * `no-price-reranking`.
      * Can only be set if
      * [solution_types][google.cloud.retail.v2alpha.ServingConfig.solution_types]
      * is
@@ -2947,12 +3297,12 @@ public Builder clearPriceRerankingLevel() {
      * highest-priced items first. This setting could result in a decrease in
      * click-through and conversion rates.
      *  Allowed values are:
-     * * 'no-price-reranking'
-     * * 'low-price-raranking'
-     * * 'medium-price-reranking'
-     * * 'high-price-reranking'
+     * * `no-price-reranking`
+     * * `low-price-raranking`
+     * * `medium-price-reranking`
+     * * `high-price-reranking`
      * If not specified, we choose default based on model type. Default value:
-     * 'no-price-reranking'.
+     * `no-price-reranking`.
      * Can only be set if
      * [solution_types][google.cloud.retail.v2alpha.ServingConfig.solution_types]
      * is
@@ -5408,14 +5758,14 @@ public Builder addIgnoreControlIdsBytes(com.google.protobuf.ByteString value) {
      *
      * 
            * How much diversity to use in recommendation model results e.g.
-     * 'medium-diversity' or 'high-diversity'. Currently supported values:
-     * * 'no-diversity'
-     * * 'low-diversity'
-     * * 'medium-diversity'
-     * * 'high-diversity'
-     * * 'auto-diversity'
+     * `medium-diversity` or `high-diversity`. Currently supported values:
+     * * `no-diversity`
+     * * `low-diversity`
+     * * `medium-diversity`
+     * * `high-diversity`
+     * * `auto-diversity`
      * If not specified, we choose default based on recommendation model
-     * type. Default value: 'no-diversity'.
+     * type. Default value: `no-diversity`.
      * Can only be set if
      * [solution_types][google.cloud.retail.v2alpha.ServingConfig.solution_types]
      * is
@@ -5442,14 +5792,14 @@ public java.lang.String getDiversityLevel() {
      *
      * 
            * How much diversity to use in recommendation model results e.g.
-     * 'medium-diversity' or 'high-diversity'. Currently supported values:
-     * * 'no-diversity'
-     * * 'low-diversity'
-     * * 'medium-diversity'
-     * * 'high-diversity'
-     * * 'auto-diversity'
+     * `medium-diversity` or `high-diversity`. Currently supported values:
+     * * `no-diversity`
+     * * `low-diversity`
+     * * `medium-diversity`
+     * * `high-diversity`
+     * * `auto-diversity`
      * If not specified, we choose default based on recommendation model
-     * type. Default value: 'no-diversity'.
+     * type. Default value: `no-diversity`.
      * Can only be set if
      * [solution_types][google.cloud.retail.v2alpha.ServingConfig.solution_types]
      * is
@@ -5476,14 +5826,14 @@ public com.google.protobuf.ByteString getDiversityLevelBytes() {
      *
      * 
            * How much diversity to use in recommendation model results e.g.
-     * 'medium-diversity' or 'high-diversity'. Currently supported values:
-     * * 'no-diversity'
-     * * 'low-diversity'
-     * * 'medium-diversity'
-     * * 'high-diversity'
-     * * 'auto-diversity'
+     * `medium-diversity` or `high-diversity`. Currently supported values:
+     * * `no-diversity`
+     * * `low-diversity`
+     * * `medium-diversity`
+     * * `high-diversity`
+     * * `auto-diversity`
      * If not specified, we choose default based on recommendation model
-     * type. Default value: 'no-diversity'.
+     * type. Default value: `no-diversity`.
      * Can only be set if
      * [solution_types][google.cloud.retail.v2alpha.ServingConfig.solution_types]
      * is
@@ -5509,14 +5859,14 @@ public Builder setDiversityLevel(java.lang.String value) {
      *
      * 
            * How much diversity to use in recommendation model results e.g.
-     * 'medium-diversity' or 'high-diversity'. Currently supported values:
-     * * 'no-diversity'
-     * * 'low-diversity'
-     * * 'medium-diversity'
-     * * 'high-diversity'
-     * * 'auto-diversity'
+     * `medium-diversity` or `high-diversity`. Currently supported values:
+     * * `no-diversity`
+     * * `low-diversity`
+     * * `medium-diversity`
+     * * `high-diversity`
+     * * `auto-diversity`
      * If not specified, we choose default based on recommendation model
-     * type. Default value: 'no-diversity'.
+     * type. Default value: `no-diversity`.
      * Can only be set if
      * [solution_types][google.cloud.retail.v2alpha.ServingConfig.solution_types]
      * is
@@ -5538,14 +5888,14 @@ public Builder clearDiversityLevel() {
      *
      * 
            * How much diversity to use in recommendation model results e.g.
-     * 'medium-diversity' or 'high-diversity'. Currently supported values:
-     * * 'no-diversity'
-     * * 'low-diversity'
-     * * 'medium-diversity'
-     * * 'high-diversity'
-     * * 'auto-diversity'
+     * `medium-diversity` or `high-diversity`. Currently supported values:
+     * * `no-diversity`
+     * * `low-diversity`
+     * * `medium-diversity`
+     * * `high-diversity`
+     * * `auto-diversity`
      * If not specified, we choose default based on recommendation model
-     * type. Default value: 'no-diversity'.
+     * type. Default value: `no-diversity`.
      * Can only be set if
      * [solution_types][google.cloud.retail.v2alpha.ServingConfig.solution_types]
      * is
@@ -5568,17 +5918,111 @@ public Builder setDiversityLevelBytes(com.google.protobuf.ByteString value) {
       return this;
     }
 
+    private int diversityType_ = 0;
+    /**
+     *
+     *
+     * 
      +     * What kind of diversity to use - data driven or rule based.
+     * 
      
+     *
+     * .google.cloud.retail.v2alpha.ServingConfig.DiversityType diversity_type = 20;
+     *
+     * @return The enum numeric value on the wire for diversityType.
+     */
+    @java.lang.Override
+    public int getDiversityTypeValue() {
+      return diversityType_;
+    }
+    /**
+     *
+     *
+     * 
      +     * What kind of diversity to use - data driven or rule based.
+     * 
      
+     *
+     * .google.cloud.retail.v2alpha.ServingConfig.DiversityType diversity_type = 20;
+     *
+     * @param value The enum numeric value on the wire for diversityType to set.
+     * @return This builder for chaining.
+     */
+    public Builder setDiversityTypeValue(int value) {
+
+      diversityType_ = value;
+      onChanged();
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * What kind of diversity to use - data driven or rule based.
+     * 
      
+     *
+     * .google.cloud.retail.v2alpha.ServingConfig.DiversityType diversity_type = 20;
+     *
+     * @return The diversityType.
+     */
+    @java.lang.Override
+    public com.google.cloud.retail.v2alpha.ServingConfig.DiversityType getDiversityType() {
+      @SuppressWarnings("deprecation")
+      com.google.cloud.retail.v2alpha.ServingConfig.DiversityType result =
+          com.google.cloud.retail.v2alpha.ServingConfig.DiversityType.valueOf(diversityType_);
+      return result == null
+          ? com.google.cloud.retail.v2alpha.ServingConfig.DiversityType.UNRECOGNIZED
+          : result;
+    }
+    /**
+     *
+     *
+     * 
      +     * What kind of diversity to use - data driven or rule based.
+     * 
      
+     *
+     * .google.cloud.retail.v2alpha.ServingConfig.DiversityType diversity_type = 20;
+     *
+     * @param value The diversityType to set.
+     * @return This builder for chaining.
+     */
+    public Builder setDiversityType(
+        com.google.cloud.retail.v2alpha.ServingConfig.DiversityType value) {
+      if (value == null) {
+        throw new NullPointerException();
+      }
+
+      diversityType_ = value.getNumber();
+      onChanged();
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * What kind of diversity to use - data driven or rule based.
+     * 
      
+     *
+     * .google.cloud.retail.v2alpha.ServingConfig.DiversityType diversity_type = 20;
+     *
+     * @return This builder for chaining.
+     */
+    public Builder clearDiversityType() {
+
+      diversityType_ = 0;
+      onChanged();
+      return this;
+    }
+
     private java.lang.Object enableCategoryFilterLevel_ = "";
     /**
      *
      *
      * 
      -     * Whether to add additional category filters on the 'similar-items' model.
+     * Whether to add additional category filters on the `similar-items` model.
      * If not specified, we enable it by default.
      *  Allowed values are:
-     * * 'no-category-match': No additional filtering of original results from
+     * * `no-category-match`: No additional filtering of original results from
      *   the model and the customer's filters.
-     * * 'relaxed-category-match': Only keep results with categories that match
+     * * `relaxed-category-match`: Only keep results with categories that match
      *   at least one item categories in the PredictRequests's context item.
      *   * If customer also sends filters in the PredictRequest, then the results
      *   will satisfy both conditions (user given and category match).
@@ -5607,12 +6051,12 @@ public java.lang.String getEnableCategoryFilterLevel() {
      *
      *
      * 
      -     * Whether to add additional category filters on the 'similar-items' model.
+     * Whether to add additional category filters on the `similar-items` model.
      * If not specified, we enable it by default.
      *  Allowed values are:
-     * * 'no-category-match': No additional filtering of original results from
+     * * `no-category-match`: No additional filtering of original results from
      *   the model and the customer's filters.
-     * * 'relaxed-category-match': Only keep results with categories that match
+     * * `relaxed-category-match`: Only keep results with categories that match
      *   at least one item categories in the PredictRequests's context item.
      *   * If customer also sends filters in the PredictRequest, then the results
      *   will satisfy both conditions (user given and category match).
@@ -5641,12 +6085,12 @@ public com.google.protobuf.ByteString getEnableCategoryFilterLevelBytes() {
      *
      *
      * 
      -     * Whether to add additional category filters on the 'similar-items' model.
+     * Whether to add additional category filters on the `similar-items` model.
      * If not specified, we enable it by default.
      *  Allowed values are:
-     * * 'no-category-match': No additional filtering of original results from
+     * * `no-category-match`: No additional filtering of original results from
      *   the model and the customer's filters.
-     * * 'relaxed-category-match': Only keep results with categories that match
+     * * `relaxed-category-match`: Only keep results with categories that match
      *   at least one item categories in the PredictRequests's context item.
      *   * If customer also sends filters in the PredictRequest, then the results
      *   will satisfy both conditions (user given and category match).
@@ -5674,12 +6118,12 @@ public Builder setEnableCategoryFilterLevel(java.lang.String value) {
      *
      *
      * 
      -     * Whether to add additional category filters on the 'similar-items' model.
+     * Whether to add additional category filters on the `similar-items` model.
      * If not specified, we enable it by default.
      *  Allowed values are:
-     * * 'no-category-match': No additional filtering of original results from
+     * * `no-category-match`: No additional filtering of original results from
      *   the model and the customer's filters.
-     * * 'relaxed-category-match': Only keep results with categories that match
+     * * `relaxed-category-match`: Only keep results with categories that match
      *   at least one item categories in the PredictRequests's context item.
      *   * If customer also sends filters in the PredictRequest, then the results
      *   will satisfy both conditions (user given and category match).
@@ -5703,12 +6147,12 @@ public Builder clearEnableCategoryFilterLevel() {
      *
      *
      * 
      -     * Whether to add additional category filters on the 'similar-items' model.
+     * Whether to add additional category filters on the `similar-items` model.
      * If not specified, we enable it by default.
      *  Allowed values are:
-     * * 'no-category-match': No additional filtering of original results from
+     * * `no-category-match`: No additional filtering of original results from
      *   the model and the customer's filters.
-     * * 'relaxed-category-match': Only keep results with categories that match
+     * * `relaxed-category-match`: Only keep results with categories that match
      *   at least one item categories in the PredictRequests's context item.
      *   * If customer also sends filters in the PredictRequest, then the results
      *   will satisfy both conditions (user given and category match).
@@ -5734,6 +6178,324 @@ public Builder setEnableCategoryFilterLevelBytes(com.google.protobuf.ByteString
       return this;
     }
 
+    private com.google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpec personalizationSpec_;
+    private com.google.protobuf.SingleFieldBuilderV3<
+            com.google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpec,
+            com.google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpec.Builder,
+            com.google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpecOrBuilder>
+        personalizationSpecBuilder_;
+    /**
+     *
+     *
+     * 
      +     * The specification for personalization spec.
+     * Can only be set if
+     * [solution_types][google.cloud.retail.v2alpha.ServingConfig.solution_types]
+     * is
+     * [SOLUTION_TYPE_SEARCH][google.cloud.retail.v2main.SolutionType.SOLUTION_TYPE_SEARCH].
+     * Notice that if both
+     * [ServingConfig.personalization_spec][google.cloud.retail.v2alpha.ServingConfig.personalization_spec]
+     * and
+     * [SearchRequest.personalization_spec][google.cloud.retail.v2alpha.SearchRequest.personalization_spec]
+     * are set.
+     * [SearchRequest.personalization_spec][google.cloud.retail.v2alpha.SearchRequest.personalization_spec]
+     * will override
+     * [ServingConfig.personalization_spec][google.cloud.retail.v2alpha.ServingConfig.personalization_spec].
+     * 
      
+     *
+     * 
+     * .google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpec personalization_spec = 21;
+     * 
+     *
+     * @return Whether the personalizationSpec field is set.
+     */
+    public boolean hasPersonalizationSpec() {
+      return personalizationSpecBuilder_ != null || personalizationSpec_ != null;
+    }
+    /**
+     *
+     *
+     * 
      +     * The specification for personalization spec.
+     * Can only be set if
+     * [solution_types][google.cloud.retail.v2alpha.ServingConfig.solution_types]
+     * is
+     * [SOLUTION_TYPE_SEARCH][google.cloud.retail.v2main.SolutionType.SOLUTION_TYPE_SEARCH].
+     * Notice that if both
+     * [ServingConfig.personalization_spec][google.cloud.retail.v2alpha.ServingConfig.personalization_spec]
+     * and
+     * [SearchRequest.personalization_spec][google.cloud.retail.v2alpha.SearchRequest.personalization_spec]
+     * are set.
+     * [SearchRequest.personalization_spec][google.cloud.retail.v2alpha.SearchRequest.personalization_spec]
+     * will override
+     * [ServingConfig.personalization_spec][google.cloud.retail.v2alpha.ServingConfig.personalization_spec].
+     * 
      
+     *
+     * 
+     * .google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpec personalization_spec = 21;
+     * 
+     *
+     * @return The personalizationSpec.
+     */
+    public com.google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpec
+        getPersonalizationSpec() {
+      if (personalizationSpecBuilder_ == null) {
+        return personalizationSpec_ == null
+            ? com.google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpec.getDefaultInstance()
+            : personalizationSpec_;
+      } else {
+        return personalizationSpecBuilder_.getMessage();
+      }
+    }
+    /**
+     *
+     *
+     * 
      +     * The specification for personalization spec.
+     * Can only be set if
+     * [solution_types][google.cloud.retail.v2alpha.ServingConfig.solution_types]
+     * is
+     * [SOLUTION_TYPE_SEARCH][google.cloud.retail.v2main.SolutionType.SOLUTION_TYPE_SEARCH].
+     * Notice that if both
+     * [ServingConfig.personalization_spec][google.cloud.retail.v2alpha.ServingConfig.personalization_spec]
+     * and
+     * [SearchRequest.personalization_spec][google.cloud.retail.v2alpha.SearchRequest.personalization_spec]
+     * are set.
+     * [SearchRequest.personalization_spec][google.cloud.retail.v2alpha.SearchRequest.personalization_spec]
+     * will override
+     * [ServingConfig.personalization_spec][google.cloud.retail.v2alpha.ServingConfig.personalization_spec].
+     * 
      
+     *
+     * 
+     * .google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpec personalization_spec = 21;
+     * 
+     */
+    public Builder setPersonalizationSpec(
+        com.google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpec value) {
+      if (personalizationSpecBuilder_ == null) {
+        if (value == null) {
+          throw new NullPointerException();
+        }
+        personalizationSpec_ = value;
+        onChanged();
+      } else {
+        personalizationSpecBuilder_.setMessage(value);
+      }
+
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * The specification for personalization spec.
+     * Can only be set if
+     * [solution_types][google.cloud.retail.v2alpha.ServingConfig.solution_types]
+     * is
+     * [SOLUTION_TYPE_SEARCH][google.cloud.retail.v2main.SolutionType.SOLUTION_TYPE_SEARCH].
+     * Notice that if both
+     * [ServingConfig.personalization_spec][google.cloud.retail.v2alpha.ServingConfig.personalization_spec]
+     * and
+     * [SearchRequest.personalization_spec][google.cloud.retail.v2alpha.SearchRequest.personalization_spec]
+     * are set.
+     * [SearchRequest.personalization_spec][google.cloud.retail.v2alpha.SearchRequest.personalization_spec]
+     * will override
+     * [ServingConfig.personalization_spec][google.cloud.retail.v2alpha.ServingConfig.personalization_spec].
+     * 
      
+     *
+     * 
+     * .google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpec personalization_spec = 21;
+     * 
+     */
+    public Builder setPersonalizationSpec(
+        com.google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpec.Builder builderForValue) {
+      if (personalizationSpecBuilder_ == null) {
+        personalizationSpec_ = builderForValue.build();
+        onChanged();
+      } else {
+        personalizationSpecBuilder_.setMessage(builderForValue.build());
+      }
+
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * The specification for personalization spec.
+     * Can only be set if
+     * [solution_types][google.cloud.retail.v2alpha.ServingConfig.solution_types]
+     * is
+     * [SOLUTION_TYPE_SEARCH][google.cloud.retail.v2main.SolutionType.SOLUTION_TYPE_SEARCH].
+     * Notice that if both
+     * [ServingConfig.personalization_spec][google.cloud.retail.v2alpha.ServingConfig.personalization_spec]
+     * and
+     * [SearchRequest.personalization_spec][google.cloud.retail.v2alpha.SearchRequest.personalization_spec]
+     * are set.
+     * [SearchRequest.personalization_spec][google.cloud.retail.v2alpha.SearchRequest.personalization_spec]
+     * will override
+     * [ServingConfig.personalization_spec][google.cloud.retail.v2alpha.ServingConfig.personalization_spec].
+     * 
      
+     *
+     * 
+     * .google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpec personalization_spec = 21;
+     * 
+     */
+    public Builder mergePersonalizationSpec(
+        com.google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpec value) {
+      if (personalizationSpecBuilder_ == null) {
+        if (personalizationSpec_ != null) {
+          personalizationSpec_ =
+              com.google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpec.newBuilder(
+                      personalizationSpec_)
+                  .mergeFrom(value)
+                  .buildPartial();
+        } else {
+          personalizationSpec_ = value;
+        }
+        onChanged();
+      } else {
+        personalizationSpecBuilder_.mergeFrom(value);
+      }
+
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * The specification for personalization spec.
+     * Can only be set if
+     * [solution_types][google.cloud.retail.v2alpha.ServingConfig.solution_types]
+     * is
+     * [SOLUTION_TYPE_SEARCH][google.cloud.retail.v2main.SolutionType.SOLUTION_TYPE_SEARCH].
+     * Notice that if both
+     * [ServingConfig.personalization_spec][google.cloud.retail.v2alpha.ServingConfig.personalization_spec]
+     * and
+     * [SearchRequest.personalization_spec][google.cloud.retail.v2alpha.SearchRequest.personalization_spec]
+     * are set.
+     * [SearchRequest.personalization_spec][google.cloud.retail.v2alpha.SearchRequest.personalization_spec]
+     * will override
+     * [ServingConfig.personalization_spec][google.cloud.retail.v2alpha.ServingConfig.personalization_spec].
+     * 
      
+     *
+     * 
+     * .google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpec personalization_spec = 21;
+     * 
+     */
+    public Builder clearPersonalizationSpec() {
+      if (personalizationSpecBuilder_ == null) {
+        personalizationSpec_ = null;
+        onChanged();
+      } else {
+        personalizationSpec_ = null;
+        personalizationSpecBuilder_ = null;
+      }
+
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * The specification for personalization spec.
+     * Can only be set if
+     * [solution_types][google.cloud.retail.v2alpha.ServingConfig.solution_types]
+     * is
+     * [SOLUTION_TYPE_SEARCH][google.cloud.retail.v2main.SolutionType.SOLUTION_TYPE_SEARCH].
+     * Notice that if both
+     * [ServingConfig.personalization_spec][google.cloud.retail.v2alpha.ServingConfig.personalization_spec]
+     * and
+     * [SearchRequest.personalization_spec][google.cloud.retail.v2alpha.SearchRequest.personalization_spec]
+     * are set.
+     * [SearchRequest.personalization_spec][google.cloud.retail.v2alpha.SearchRequest.personalization_spec]
+     * will override
+     * [ServingConfig.personalization_spec][google.cloud.retail.v2alpha.ServingConfig.personalization_spec].
+     * 
      
+     *
+     * 
+     * .google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpec personalization_spec = 21;
+     * 
+     */
+    public com.google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpec.Builder
+        getPersonalizationSpecBuilder() {
+
+      onChanged();
+      return getPersonalizationSpecFieldBuilder().getBuilder();
+    }
+    /**
+     *
+     *
+     * 
      +     * The specification for personalization spec.
+     * Can only be set if
+     * [solution_types][google.cloud.retail.v2alpha.ServingConfig.solution_types]
+     * is
+     * [SOLUTION_TYPE_SEARCH][google.cloud.retail.v2main.SolutionType.SOLUTION_TYPE_SEARCH].
+     * Notice that if both
+     * [ServingConfig.personalization_spec][google.cloud.retail.v2alpha.ServingConfig.personalization_spec]
+     * and
+     * [SearchRequest.personalization_spec][google.cloud.retail.v2alpha.SearchRequest.personalization_spec]
+     * are set.
+     * [SearchRequest.personalization_spec][google.cloud.retail.v2alpha.SearchRequest.personalization_spec]
+     * will override
+     * [ServingConfig.personalization_spec][google.cloud.retail.v2alpha.ServingConfig.personalization_spec].
+     * 
      
+     *
+     * 
+     * .google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpec personalization_spec = 21;
+     * 
+     */
+    public com.google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpecOrBuilder
+        getPersonalizationSpecOrBuilder() {
+      if (personalizationSpecBuilder_ != null) {
+        return personalizationSpecBuilder_.getMessageOrBuilder();
+      } else {
+        return personalizationSpec_ == null
+            ? com.google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpec.getDefaultInstance()
+            : personalizationSpec_;
+      }
+    }
+    /**
+     *
+     *
+     * 
      +     * The specification for personalization spec.
+     * Can only be set if
+     * [solution_types][google.cloud.retail.v2alpha.ServingConfig.solution_types]
+     * is
+     * [SOLUTION_TYPE_SEARCH][google.cloud.retail.v2main.SolutionType.SOLUTION_TYPE_SEARCH].
+     * Notice that if both
+     * [ServingConfig.personalization_spec][google.cloud.retail.v2alpha.ServingConfig.personalization_spec]
+     * and
+     * [SearchRequest.personalization_spec][google.cloud.retail.v2alpha.SearchRequest.personalization_spec]
+     * are set.
+     * [SearchRequest.personalization_spec][google.cloud.retail.v2alpha.SearchRequest.personalization_spec]
+     * will override
+     * [ServingConfig.personalization_spec][google.cloud.retail.v2alpha.ServingConfig.personalization_spec].
+     * 
      
+     *
+     * 
+     * .google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpec personalization_spec = 21;
+     * 
+     */
+    private com.google.protobuf.SingleFieldBuilderV3<
+            com.google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpec,
+            com.google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpec.Builder,
+            com.google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpecOrBuilder>
+        getPersonalizationSpecFieldBuilder() {
+      if (personalizationSpecBuilder_ == null) {
+        personalizationSpecBuilder_ =
+            new com.google.protobuf.SingleFieldBuilderV3<
+                com.google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpec,
+                com.google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpec.Builder,
+                com.google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpecOrBuilder>(
+                getPersonalizationSpec(), getParentForChildren(), isClean());
+        personalizationSpec_ = null;
+      }
+      return personalizationSpecBuilder_;
+    }
+
     private java.util.List solutionTypes_ = java.util.Collections.emptyList();
 
     private void ensureSolutionTypesIsMutable() {
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ServingConfigOrBuilder.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ServingConfigOrBuilder.java
index 8e9cee98acaf..32cf1ce7c3e7 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ServingConfigOrBuilder.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ServingConfigOrBuilder.java
@@ -85,7 +85,8 @@ public interface ServingConfigOrBuilder
    *
    *
    * 
      -   * The id of the model to use at serving time.
+   * The id of the model in the same
+   * [Catalog][google.cloud.retail.v2alpha.Catalog] to use at serving time.
    * Currently only RecommendationModels are supported:
    * https://cloud.google.com/retail/recommendations-ai/docs/create-models
    * Can be changed but only to a compatible model (e.g.
@@ -105,7 +106,8 @@ public interface ServingConfigOrBuilder
    *
    *
    * 
      -   * The id of the model to use at serving time.
+   * The id of the model in the same
+   * [Catalog][google.cloud.retail.v2alpha.Catalog] to use at serving time.
    * Currently only RecommendationModels are supported:
    * https://cloud.google.com/retail/recommendations-ai/docs/create-models
    * Can be changed but only to a compatible model (e.g.
@@ -132,12 +134,12 @@ public interface ServingConfigOrBuilder
    * highest-priced items first. This setting could result in a decrease in
    * click-through and conversion rates.
    *  Allowed values are:
-   * * 'no-price-reranking'
-   * * 'low-price-raranking'
-   * * 'medium-price-reranking'
-   * * 'high-price-reranking'
+   * * `no-price-reranking`
+   * * `low-price-raranking`
+   * * `medium-price-reranking`
+   * * `high-price-reranking`
    * If not specified, we choose default based on model type. Default value:
-   * 'no-price-reranking'.
+   * `no-price-reranking`.
    * Can only be set if
    * [solution_types][google.cloud.retail.v2alpha.ServingConfig.solution_types]
    * is
@@ -159,12 +161,12 @@ public interface ServingConfigOrBuilder
    * highest-priced items first. This setting could result in a decrease in
    * click-through and conversion rates.
    *  Allowed values are:
-   * * 'no-price-reranking'
-   * * 'low-price-raranking'
-   * * 'medium-price-reranking'
-   * * 'high-price-reranking'
+   * * `no-price-reranking`
+   * * `low-price-raranking`
+   * * `medium-price-reranking`
+   * * `high-price-reranking`
    * If not specified, we choose default based on model type. Default value:
-   * 'no-price-reranking'.
+   * `no-price-reranking`.
    * Can only be set if
    * [solution_types][google.cloud.retail.v2alpha.ServingConfig.solution_types]
    * is
@@ -991,14 +993,14 @@ public interface ServingConfigOrBuilder
    *
    * 
          * How much diversity to use in recommendation model results e.g.
-   * 'medium-diversity' or 'high-diversity'. Currently supported values:
-   * * 'no-diversity'
-   * * 'low-diversity'
-   * * 'medium-diversity'
-   * * 'high-diversity'
-   * * 'auto-diversity'
+   * `medium-diversity` or `high-diversity`. Currently supported values:
+   * * `no-diversity`
+   * * `low-diversity`
+   * * `medium-diversity`
+   * * `high-diversity`
+   * * `auto-diversity`
    * If not specified, we choose default based on recommendation model
-   * type. Default value: 'no-diversity'.
+   * type. Default value: `no-diversity`.
    * Can only be set if
    * [solution_types][google.cloud.retail.v2alpha.ServingConfig.solution_types]
    * is
@@ -1015,14 +1017,14 @@ public interface ServingConfigOrBuilder
    *
    * 
          * How much diversity to use in recommendation model results e.g.
-   * 'medium-diversity' or 'high-diversity'. Currently supported values:
-   * * 'no-diversity'
-   * * 'low-diversity'
-   * * 'medium-diversity'
-   * * 'high-diversity'
-   * * 'auto-diversity'
+   * `medium-diversity` or `high-diversity`. Currently supported values:
+   * * `no-diversity`
+   * * `low-diversity`
+   * * `medium-diversity`
+   * * `high-diversity`
+   * * `auto-diversity`
    * If not specified, we choose default based on recommendation model
-   * type. Default value: 'no-diversity'.
+   * type. Default value: `no-diversity`.
    * Can only be set if
    * [solution_types][google.cloud.retail.v2alpha.ServingConfig.solution_types]
    * is
@@ -1039,12 +1041,37 @@ public interface ServingConfigOrBuilder
    *
    *
    * 
      -   * Whether to add additional category filters on the 'similar-items' model.
+   * What kind of diversity to use - data driven or rule based.
+   * 
      
+   *
+   * .google.cloud.retail.v2alpha.ServingConfig.DiversityType diversity_type = 20;
+   *
+   * @return The enum numeric value on the wire for diversityType.
+   */
+  int getDiversityTypeValue();
+  /**
+   *
+   *
+   * 
      +   * What kind of diversity to use - data driven or rule based.
+   * 
      
+   *
+   * .google.cloud.retail.v2alpha.ServingConfig.DiversityType diversity_type = 20;
+   *
+   * @return The diversityType.
+   */
+  com.google.cloud.retail.v2alpha.ServingConfig.DiversityType getDiversityType();
+
+  /**
+   *
+   *
+   * 
      +   * Whether to add additional category filters on the `similar-items` model.
    * If not specified, we enable it by default.
    *  Allowed values are:
-   * * 'no-category-match': No additional filtering of original results from
+   * * `no-category-match`: No additional filtering of original results from
    *   the model and the customer's filters.
-   * * 'relaxed-category-match': Only keep results with categories that match
+   * * `relaxed-category-match`: Only keep results with categories that match
    *   at least one item categories in the PredictRequests's context item.
    *   * If customer also sends filters in the PredictRequest, then the results
    *   will satisfy both conditions (user given and category match).
@@ -1063,12 +1090,12 @@ public interface ServingConfigOrBuilder
    *
    *
    * 
      -   * Whether to add additional category filters on the 'similar-items' model.
+   * Whether to add additional category filters on the `similar-items` model.
    * If not specified, we enable it by default.
    *  Allowed values are:
-   * * 'no-category-match': No additional filtering of original results from
+   * * `no-category-match`: No additional filtering of original results from
    *   the model and the customer's filters.
-   * * 'relaxed-category-match': Only keep results with categories that match
+   * * `relaxed-category-match`: Only keep results with categories that match
    *   at least one item categories in the PredictRequests's context item.
    *   * If customer also sends filters in the PredictRequest, then the results
    *   will satisfy both conditions (user given and category match).
@@ -1084,6 +1111,81 @@ public interface ServingConfigOrBuilder
    */
   com.google.protobuf.ByteString getEnableCategoryFilterLevelBytes();
 
+  /**
+   *
+   *
+   * 
      +   * The specification for personalization spec.
+   * Can only be set if
+   * [solution_types][google.cloud.retail.v2alpha.ServingConfig.solution_types]
+   * is
+   * [SOLUTION_TYPE_SEARCH][google.cloud.retail.v2main.SolutionType.SOLUTION_TYPE_SEARCH].
+   * Notice that if both
+   * [ServingConfig.personalization_spec][google.cloud.retail.v2alpha.ServingConfig.personalization_spec]
+   * and
+   * [SearchRequest.personalization_spec][google.cloud.retail.v2alpha.SearchRequest.personalization_spec]
+   * are set.
+   * [SearchRequest.personalization_spec][google.cloud.retail.v2alpha.SearchRequest.personalization_spec]
+   * will override
+   * [ServingConfig.personalization_spec][google.cloud.retail.v2alpha.ServingConfig.personalization_spec].
+   * 
      
+   *
+   * .google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpec personalization_spec = 21;
+   * 
+   *
+   * @return Whether the personalizationSpec field is set.
+   */
+  boolean hasPersonalizationSpec();
+  /**
+   *
+   *
+   * 
      +   * The specification for personalization spec.
+   * Can only be set if
+   * [solution_types][google.cloud.retail.v2alpha.ServingConfig.solution_types]
+   * is
+   * [SOLUTION_TYPE_SEARCH][google.cloud.retail.v2main.SolutionType.SOLUTION_TYPE_SEARCH].
+   * Notice that if both
+   * [ServingConfig.personalization_spec][google.cloud.retail.v2alpha.ServingConfig.personalization_spec]
+   * and
+   * [SearchRequest.personalization_spec][google.cloud.retail.v2alpha.SearchRequest.personalization_spec]
+   * are set.
+   * [SearchRequest.personalization_spec][google.cloud.retail.v2alpha.SearchRequest.personalization_spec]
+   * will override
+   * [ServingConfig.personalization_spec][google.cloud.retail.v2alpha.ServingConfig.personalization_spec].
+   * 
      
+   *
+   * .google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpec personalization_spec = 21;
+   * 
+   *
+   * @return The personalizationSpec.
+   */
+  com.google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpec getPersonalizationSpec();
+  /**
+   *
+   *
+   * 
      +   * The specification for personalization spec.
+   * Can only be set if
+   * [solution_types][google.cloud.retail.v2alpha.ServingConfig.solution_types]
+   * is
+   * [SOLUTION_TYPE_SEARCH][google.cloud.retail.v2main.SolutionType.SOLUTION_TYPE_SEARCH].
+   * Notice that if both
+   * [ServingConfig.personalization_spec][google.cloud.retail.v2alpha.ServingConfig.personalization_spec]
+   * and
+   * [SearchRequest.personalization_spec][google.cloud.retail.v2alpha.SearchRequest.personalization_spec]
+   * are set.
+   * [SearchRequest.personalization_spec][google.cloud.retail.v2alpha.SearchRequest.personalization_spec]
+   * will override
+   * [ServingConfig.personalization_spec][google.cloud.retail.v2alpha.ServingConfig.personalization_spec].
+   * 
      
+   *
+   * .google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpec personalization_spec = 21;
+   * 
+   */
+  com.google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpecOrBuilder
+      getPersonalizationSpecOrBuilder();
+
   /**
    *
    *
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ServingConfigProto.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ServingConfigProto.java
index 34cfd94b2042..aead4a2d2c6e 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ServingConfigProto.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/ServingConfigProto.java
@@ -45,7 +45,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
           + "\037google/api/field_behavior.proto\032\031google"
           + "/api/resource.proto\032(google/cloud/retail"
           + "/v2alpha/common.proto\0320google/cloud/reta"
-          + "il/v2alpha/search_service.proto\"\366\005\n\rServ"
+          + "il/v2alpha/search_service.proto\"\214\010\n\rServ"
           + "ingConfig\022\021\n\004name\030\001 \001(\tB\003\340A\005\022\031\n\014display_"
           + "name\030\002 \001(\tB\003\340A\002\022\020\n\010model_id\030\003 \001(\t\022\035\n\025pri"
           + "ce_reranking_level\030\004 \001(\t\022\031\n\021facet_contro"
@@ -58,19 +58,26 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
           + "s_control_ids\030\014 \003(\t\022$\n\034do_not_associate_"
           + "control_ids\030\r \003(\t\022\037\n\027replacement_control"
           + "_ids\030\016 \003(\t\022\032\n\022ignore_control_ids\030\017 \003(\t\022\027"
-          + "\n\017diversity_level\030\010 \001(\t\022$\n\034enable_catego"
-          + "ry_filter_level\030\020 \001(\t\022I\n\016solution_types\030"
-          + "\023 \003(\0162).google.cloud.retail.v2alpha.Solu"
-          + "tionTypeB\006\340A\002\340A\005:\205\001\352A\201\001\n#retail.googleap"
-          + "is.com/ServingConfig\022Zprojects/{project}"
-          + "/locations/{location}/catalogs/{catalog}"
-          + "/servingConfigs/{serving_config}B\340\001\n\037com"
-          + ".google.cloud.retail.v2alphaB\022ServingCon"
-          + "figProtoP\001ZAgoogle.golang.org/genproto/g"
-          + "oogleapis/cloud/retail/v2alpha;retail\242\002\006"
-          + "RETAIL\252\002\033Google.Cloud.Retail.V2Alpha\312\002\033G"
-          + "oogle\\Cloud\\Retail\\V2alpha\352\002\036Google::Clo"
-          + "ud::Retail::V2alphab\006proto3"
+          + "\n\017diversity_level\030\010 \001(\t\022P\n\016diversity_typ"
+          + "e\030\024 \001(\01628.google.cloud.retail.v2alpha.Se"
+          + "rvingConfig.DiversityType\022$\n\034enable_cate"
+          + "gory_filter_level\030\020 \001(\t\022\\\n\024personalizati"
+          + "on_spec\030\025 \001(\0132>.google.cloud.retail.v2al"
+          + "pha.SearchRequest.PersonalizationSpec\022I\n"
+          + "\016solution_types\030\023 \003(\0162).google.cloud.ret"
+          + "ail.v2alpha.SolutionTypeB\006\340A\002\340A\005\"d\n\rDive"
+          + "rsityType\022\036\n\032DIVERSITY_TYPE_UNSPECIFIED\020"
+          + "\000\022\030\n\024RULE_BASED_DIVERSITY\020\002\022\031\n\025DATA_DRIV"
+          + "EN_DIVERSITY\020\003:\205\001\352A\201\001\n#retail.googleapis"
+          + ".com/ServingConfig\022Zprojects/{project}/l"
+          + "ocations/{location}/catalogs/{catalog}/s"
+          + "ervingConfigs/{serving_config}B\340\001\n\037com.g"
+          + "oogle.cloud.retail.v2alphaB\022ServingConfi"
+          + "gProtoP\001ZAgoogle.golang.org/genproto/goo"
+          + "gleapis/cloud/retail/v2alpha;retail\242\002\006RE"
+          + "TAIL\252\002\033Google.Cloud.Retail.V2Alpha\312\002\033Goo"
+          + "gle\\Cloud\\Retail\\V2alpha\352\002\036Google::Cloud"
+          + "::Retail::V2alphab\006proto3"
     };
     descriptor =
         com.google.protobuf.Descriptors.FileDescriptor.internalBuildGeneratedFileFrom(
@@ -102,7 +109,9 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
               "ReplacementControlIds",
               "IgnoreControlIds",
               "DiversityLevel",
+              "DiversityType",
               "EnableCategoryFilterLevel",
+              "PersonalizationSpec",
               "SolutionTypes",
             });
     com.google.protobuf.ExtensionRegistry registry =
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/TransformedUserEventsMetadata.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/TransformedUserEventsMetadata.java
new file mode 100644
index 000000000000..8ff92dd7e849
--- /dev/null
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/TransformedUserEventsMetadata.java
@@ -0,0 +1,626 @@
+/*
+ * Copyright 2020 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+// Generated by the protocol buffer compiler.  DO NOT EDIT!
+// source: google/cloud/retail/v2alpha/import_config.proto
+
+package com.google.cloud.retail.v2alpha;
+
+/**
+ *
+ *
+ * 
      + * Metadata related to transform user events operation.
+ * 
      
+ *
+ * Protobuf type {@code google.cloud.retail.v2alpha.TransformedUserEventsMetadata}
+ */
+public final class TransformedUserEventsMetadata extends com.google.protobuf.GeneratedMessageV3
+    implements
+    // @@protoc_insertion_point(message_implements:google.cloud.retail.v2alpha.TransformedUserEventsMetadata)
+    TransformedUserEventsMetadataOrBuilder {
+  private static final long serialVersionUID = 0L;
+  // Use TransformedUserEventsMetadata.newBuilder() to construct.
+  private TransformedUserEventsMetadata(com.google.protobuf.GeneratedMessageV3.Builder builder) {
+    super(builder);
+  }
+
+  private TransformedUserEventsMetadata() {}
+
+  @java.lang.Override
+  @SuppressWarnings({"unused"})
+  protected java.lang.Object newInstance(UnusedPrivateParameter unused) {
+    return new TransformedUserEventsMetadata();
+  }
+
+  @java.lang.Override
+  public final com.google.protobuf.UnknownFieldSet getUnknownFields() {
+    return this.unknownFields;
+  }
+
+  public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
+    return com.google.cloud.retail.v2alpha.ImportConfigProto
+        .internal_static_google_cloud_retail_v2alpha_TransformedUserEventsMetadata_descriptor;
+  }
+
+  @java.lang.Override
+  protected com.google.protobuf.GeneratedMessageV3.FieldAccessorTable
+      internalGetFieldAccessorTable() {
+    return com.google.cloud.retail.v2alpha.ImportConfigProto
+        .internal_static_google_cloud_retail_v2alpha_TransformedUserEventsMetadata_fieldAccessorTable
+        .ensureFieldAccessorsInitialized(
+            com.google.cloud.retail.v2alpha.TransformedUserEventsMetadata.class,
+            com.google.cloud.retail.v2alpha.TransformedUserEventsMetadata.Builder.class);
+  }
+
+  public static final int SOURCE_EVENTS_COUNT_FIELD_NUMBER = 1;
+  private long sourceEventsCount_;
+  /**
+   *
+   *
+   * 
      +   * Count of entries in the source user events BigQuery table.
+   * 
      
+   *
+   * int64 source_events_count = 1;
+   *
+   * @return The sourceEventsCount.
+   */
+  @java.lang.Override
+  public long getSourceEventsCount() {
+    return sourceEventsCount_;
+  }
+
+  public static final int TRANSFORMED_EVENTS_COUNT_FIELD_NUMBER = 2;
+  private long transformedEventsCount_;
+  /**
+   *
+   *
+   * 
      +   * Count of entries in the transformed user events BigQuery table, which could
+   * be different from the actually imported number of user events.
+   * 
      
+   *
+   * int64 transformed_events_count = 2;
+   *
+   * @return The transformedEventsCount.
+   */
+  @java.lang.Override
+  public long getTransformedEventsCount() {
+    return transformedEventsCount_;
+  }
+
+  private byte memoizedIsInitialized = -1;
+
+  @java.lang.Override
+  public final boolean isInitialized() {
+    byte isInitialized = memoizedIsInitialized;
+    if (isInitialized == 1) return true;
+    if (isInitialized == 0) return false;
+
+    memoizedIsInitialized = 1;
+    return true;
+  }
+
+  @java.lang.Override
+  public void writeTo(com.google.protobuf.CodedOutputStream output) throws java.io.IOException {
+    if (sourceEventsCount_ != 0L) {
+      output.writeInt64(1, sourceEventsCount_);
+    }
+    if (transformedEventsCount_ != 0L) {
+      output.writeInt64(2, transformedEventsCount_);
+    }
+    getUnknownFields().writeTo(output);
+  }
+
+  @java.lang.Override
+  public int getSerializedSize() {
+    int size = memoizedSize;
+    if (size != -1) return size;
+
+    size = 0;
+    if (sourceEventsCount_ != 0L) {
+      size += com.google.protobuf.CodedOutputStream.computeInt64Size(1, sourceEventsCount_);
+    }
+    if (transformedEventsCount_ != 0L) {
+      size += com.google.protobuf.CodedOutputStream.computeInt64Size(2, transformedEventsCount_);
+    }
+    size += getUnknownFields().getSerializedSize();
+    memoizedSize = size;
+    return size;
+  }
+
+  @java.lang.Override
+  public boolean equals(final java.lang.Object obj) {
+    if (obj == this) {
+      return true;
+    }
+    if (!(obj instanceof com.google.cloud.retail.v2alpha.TransformedUserEventsMetadata)) {
+      return super.equals(obj);
+    }
+    com.google.cloud.retail.v2alpha.TransformedUserEventsMetadata other =
+        (com.google.cloud.retail.v2alpha.TransformedUserEventsMetadata) obj;
+
+    if (getSourceEventsCount() != other.getSourceEventsCount()) return false;
+    if (getTransformedEventsCount() != other.getTransformedEventsCount()) return false;
+    if (!getUnknownFields().equals(other.getUnknownFields())) return false;
+    return true;
+  }
+
+  @java.lang.Override
+  public int hashCode() {
+    if (memoizedHashCode != 0) {
+      return memoizedHashCode;
+    }
+    int hash = 41;
+    hash = (19 * hash) + getDescriptor().hashCode();
+    hash = (37 * hash) + SOURCE_EVENTS_COUNT_FIELD_NUMBER;
+    hash = (53 * hash) + com.google.protobuf.Internal.hashLong(getSourceEventsCount());
+    hash = (37 * hash) + TRANSFORMED_EVENTS_COUNT_FIELD_NUMBER;
+    hash = (53 * hash) + com.google.protobuf.Internal.hashLong(getTransformedEventsCount());
+    hash = (29 * hash) + getUnknownFields().hashCode();
+    memoizedHashCode = hash;
+    return hash;
+  }
+
+  public static com.google.cloud.retail.v2alpha.TransformedUserEventsMetadata parseFrom(
+      java.nio.ByteBuffer data) throws com.google.protobuf.InvalidProtocolBufferException {
+    return PARSER.parseFrom(data);
+  }
+
+  public static com.google.cloud.retail.v2alpha.TransformedUserEventsMetadata parseFrom(
+      java.nio.ByteBuffer data, com.google.protobuf.ExtensionRegistryLite extensionRegistry)
+      throws com.google.protobuf.InvalidProtocolBufferException {
+    return PARSER.parseFrom(data, extensionRegistry);
+  }
+
+  public static com.google.cloud.retail.v2alpha.TransformedUserEventsMetadata parseFrom(
+      com.google.protobuf.ByteString data)
+      throws com.google.protobuf.InvalidProtocolBufferException {
+    return PARSER.parseFrom(data);
+  }
+
+  public static com.google.cloud.retail.v2alpha.TransformedUserEventsMetadata parseFrom(
+      com.google.protobuf.ByteString data,
+      com.google.protobuf.ExtensionRegistryLite extensionRegistry)
+      throws com.google.protobuf.InvalidProtocolBufferException {
+    return PARSER.parseFrom(data, extensionRegistry);
+  }
+
+  public static com.google.cloud.retail.v2alpha.TransformedUserEventsMetadata parseFrom(byte[] data)
+      throws com.google.protobuf.InvalidProtocolBufferException {
+    return PARSER.parseFrom(data);
+  }
+
+  public static com.google.cloud.retail.v2alpha.TransformedUserEventsMetadata parseFrom(
+      byte[] data, com.google.protobuf.ExtensionRegistryLite extensionRegistry)
+      throws com.google.protobuf.InvalidProtocolBufferException {
+    return PARSER.parseFrom(data, extensionRegistry);
+  }
+
+  public static com.google.cloud.retail.v2alpha.TransformedUserEventsMetadata parseFrom(
+      java.io.InputStream input) throws java.io.IOException {
+    return com.google.protobuf.GeneratedMessageV3.parseWithIOException(PARSER, input);
+  }
+
+  public static com.google.cloud.retail.v2alpha.TransformedUserEventsMetadata parseFrom(
+      java.io.InputStream input, com.google.protobuf.ExtensionRegistryLite extensionRegistry)
+      throws java.io.IOException {
+    return com.google.protobuf.GeneratedMessageV3.parseWithIOException(
+        PARSER, input, extensionRegistry);
+  }
+
+  public static com.google.cloud.retail.v2alpha.TransformedUserEventsMetadata parseDelimitedFrom(
+      java.io.InputStream input) throws java.io.IOException {
+    return com.google.protobuf.GeneratedMessageV3.parseDelimitedWithIOException(PARSER, input);
+  }
+
+  public static com.google.cloud.retail.v2alpha.TransformedUserEventsMetadata parseDelimitedFrom(
+      java.io.InputStream input, com.google.protobuf.ExtensionRegistryLite extensionRegistry)
+      throws java.io.IOException {
+    return com.google.protobuf.GeneratedMessageV3.parseDelimitedWithIOException(
+        PARSER, input, extensionRegistry);
+  }
+
+  public static com.google.cloud.retail.v2alpha.TransformedUserEventsMetadata parseFrom(
+      com.google.protobuf.CodedInputStream input) throws java.io.IOException {
+    return com.google.protobuf.GeneratedMessageV3.parseWithIOException(PARSER, input);
+  }
+
+  public static com.google.cloud.retail.v2alpha.TransformedUserEventsMetadata parseFrom(
+      com.google.protobuf.CodedInputStream input,
+      com.google.protobuf.ExtensionRegistryLite extensionRegistry)
+      throws java.io.IOException {
+    return com.google.protobuf.GeneratedMessageV3.parseWithIOException(
+        PARSER, input, extensionRegistry);
+  }
+
+  @java.lang.Override
+  public Builder newBuilderForType() {
+    return newBuilder();
+  }
+
+  public static Builder newBuilder() {
+    return DEFAULT_INSTANCE.toBuilder();
+  }
+
+  public static Builder newBuilder(
+      com.google.cloud.retail.v2alpha.TransformedUserEventsMetadata prototype) {
+    return DEFAULT_INSTANCE.toBuilder().mergeFrom(prototype);
+  }
+
+  @java.lang.Override
+  public Builder toBuilder() {
+    return this == DEFAULT_INSTANCE ? new Builder() : new Builder().mergeFrom(this);
+  }
+
+  @java.lang.Override
+  protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.BuilderParent parent) {
+    Builder builder = new Builder(parent);
+    return builder;
+  }
+  /**
+   *
+   *
+   * 
      +   * Metadata related to transform user events operation.
+   * 
      
+   *
+   * Protobuf type {@code google.cloud.retail.v2alpha.TransformedUserEventsMetadata}
+   */
+  public static final class Builder extends com.google.protobuf.GeneratedMessageV3.Builder
+      implements
+      // @@protoc_insertion_point(builder_implements:google.cloud.retail.v2alpha.TransformedUserEventsMetadata)
+      com.google.cloud.retail.v2alpha.TransformedUserEventsMetadataOrBuilder {
+    public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
+      return com.google.cloud.retail.v2alpha.ImportConfigProto
+          .internal_static_google_cloud_retail_v2alpha_TransformedUserEventsMetadata_descriptor;
+    }
+
+    @java.lang.Override
+    protected com.google.protobuf.GeneratedMessageV3.FieldAccessorTable
+        internalGetFieldAccessorTable() {
+      return com.google.cloud.retail.v2alpha.ImportConfigProto
+          .internal_static_google_cloud_retail_v2alpha_TransformedUserEventsMetadata_fieldAccessorTable
+          .ensureFieldAccessorsInitialized(
+              com.google.cloud.retail.v2alpha.TransformedUserEventsMetadata.class,
+              com.google.cloud.retail.v2alpha.TransformedUserEventsMetadata.Builder.class);
+    }
+
+    // Construct using com.google.cloud.retail.v2alpha.TransformedUserEventsMetadata.newBuilder()
+    private Builder() {}
+
+    private Builder(com.google.protobuf.GeneratedMessageV3.BuilderParent parent) {
+      super(parent);
+    }
+
+    @java.lang.Override
+    public Builder clear() {
+      super.clear();
+      sourceEventsCount_ = 0L;
+
+      transformedEventsCount_ = 0L;
+
+      return this;
+    }
+
+    @java.lang.Override
+    public com.google.protobuf.Descriptors.Descriptor getDescriptorForType() {
+      return com.google.cloud.retail.v2alpha.ImportConfigProto
+          .internal_static_google_cloud_retail_v2alpha_TransformedUserEventsMetadata_descriptor;
+    }
+
+    @java.lang.Override
+    public com.google.cloud.retail.v2alpha.TransformedUserEventsMetadata
+        getDefaultInstanceForType() {
+      return com.google.cloud.retail.v2alpha.TransformedUserEventsMetadata.getDefaultInstance();
+    }
+
+    @java.lang.Override
+    public com.google.cloud.retail.v2alpha.TransformedUserEventsMetadata build() {
+      com.google.cloud.retail.v2alpha.TransformedUserEventsMetadata result = buildPartial();
+      if (!result.isInitialized()) {
+        throw newUninitializedMessageException(result);
+      }
+      return result;
+    }
+
+    @java.lang.Override
+    public com.google.cloud.retail.v2alpha.TransformedUserEventsMetadata buildPartial() {
+      com.google.cloud.retail.v2alpha.TransformedUserEventsMetadata result =
+          new com.google.cloud.retail.v2alpha.TransformedUserEventsMetadata(this);
+      result.sourceEventsCount_ = sourceEventsCount_;
+      result.transformedEventsCount_ = transformedEventsCount_;
+      onBuilt();
+      return result;
+    }
+
+    @java.lang.Override
+    public Builder clone() {
+      return super.clone();
+    }
+
+    @java.lang.Override
+    public Builder setField(
+        com.google.protobuf.Descriptors.FieldDescriptor field, java.lang.Object value) {
+      return super.setField(field, value);
+    }
+
+    @java.lang.Override
+    public Builder clearField(com.google.protobuf.Descriptors.FieldDescriptor field) {
+      return super.clearField(field);
+    }
+
+    @java.lang.Override
+    public Builder clearOneof(com.google.protobuf.Descriptors.OneofDescriptor oneof) {
+      return super.clearOneof(oneof);
+    }
+
+    @java.lang.Override
+    public Builder setRepeatedField(
+        com.google.protobuf.Descriptors.FieldDescriptor field, int index, java.lang.Object value) {
+      return super.setRepeatedField(field, index, value);
+    }
+
+    @java.lang.Override
+    public Builder addRepeatedField(
+        com.google.protobuf.Descriptors.FieldDescriptor field, java.lang.Object value) {
+      return super.addRepeatedField(field, value);
+    }
+
+    @java.lang.Override
+    public Builder mergeFrom(com.google.protobuf.Message other) {
+      if (other instanceof com.google.cloud.retail.v2alpha.TransformedUserEventsMetadata) {
+        return mergeFrom((com.google.cloud.retail.v2alpha.TransformedUserEventsMetadata) other);
+      } else {
+        super.mergeFrom(other);
+        return this;
+      }
+    }
+
+    public Builder mergeFrom(com.google.cloud.retail.v2alpha.TransformedUserEventsMetadata other) {
+      if (other
+          == com.google.cloud.retail.v2alpha.TransformedUserEventsMetadata.getDefaultInstance())
+        return this;
+      if (other.getSourceEventsCount() != 0L) {
+        setSourceEventsCount(other.getSourceEventsCount());
+      }
+      if (other.getTransformedEventsCount() != 0L) {
+        setTransformedEventsCount(other.getTransformedEventsCount());
+      }
+      this.mergeUnknownFields(other.getUnknownFields());
+      onChanged();
+      return this;
+    }
+
+    @java.lang.Override
+    public final boolean isInitialized() {
+      return true;
+    }
+
+    @java.lang.Override
+    public Builder mergeFrom(
+        com.google.protobuf.CodedInputStream input,
+        com.google.protobuf.ExtensionRegistryLite extensionRegistry)
+        throws java.io.IOException {
+      if (extensionRegistry == null) {
+        throw new java.lang.NullPointerException();
+      }
+      try {
+        boolean done = false;
+        while (!done) {
+          int tag = input.readTag();
+          switch (tag) {
+            case 0:
+              done = true;
+              break;
+            case 8:
+              {
+                sourceEventsCount_ = input.readInt64();
+
+                break;
+              } // case 8
+            case 16:
+              {
+                transformedEventsCount_ = input.readInt64();
+
+                break;
+              } // case 16
+            default:
+              {
+                if (!super.parseUnknownField(input, extensionRegistry, tag)) {
+                  done = true; // was an endgroup tag
+                }
+                break;
+              } // default:
+          } // switch (tag)
+        } // while (!done)
+      } catch (com.google.protobuf.InvalidProtocolBufferException e) {
+        throw e.unwrapIOException();
+      } finally {
+        onChanged();
+      } // finally
+      return this;
+    }
+
+    private long sourceEventsCount_;
+    /**
+     *
+     *
+     * 
      +     * Count of entries in the source user events BigQuery table.
+     * 
      
+     *
+     * int64 source_events_count = 1;
+     *
+     * @return The sourceEventsCount.
+     */
+    @java.lang.Override
+    public long getSourceEventsCount() {
+      return sourceEventsCount_;
+    }
+    /**
+     *
+     *
+     * 
      +     * Count of entries in the source user events BigQuery table.
+     * 
      
+     *
+     * int64 source_events_count = 1;
+     *
+     * @param value The sourceEventsCount to set.
+     * @return This builder for chaining.
+     */
+    public Builder setSourceEventsCount(long value) {
+
+      sourceEventsCount_ = value;
+      onChanged();
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * Count of entries in the source user events BigQuery table.
+     * 
      
+     *
+     * int64 source_events_count = 1;
+     *
+     * @return This builder for chaining.
+     */
+    public Builder clearSourceEventsCount() {
+
+      sourceEventsCount_ = 0L;
+      onChanged();
+      return this;
+    }
+
+    private long transformedEventsCount_;
+    /**
+     *
+     *
+     * 
      +     * Count of entries in the transformed user events BigQuery table, which could
+     * be different from the actually imported number of user events.
+     * 
      
+     *
+     * int64 transformed_events_count = 2;
+     *
+     * @return The transformedEventsCount.
+     */
+    @java.lang.Override
+    public long getTransformedEventsCount() {
+      return transformedEventsCount_;
+    }
+    /**
+     *
+     *
+     * 
      +     * Count of entries in the transformed user events BigQuery table, which could
+     * be different from the actually imported number of user events.
+     * 
      
+     *
+     * int64 transformed_events_count = 2;
+     *
+     * @param value The transformedEventsCount to set.
+     * @return This builder for chaining.
+     */
+    public Builder setTransformedEventsCount(long value) {
+
+      transformedEventsCount_ = value;
+      onChanged();
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * Count of entries in the transformed user events BigQuery table, which could
+     * be different from the actually imported number of user events.
+     * 
      
+     *
+     * int64 transformed_events_count = 2;
+     *
+     * @return This builder for chaining.
+     */
+    public Builder clearTransformedEventsCount() {
+
+      transformedEventsCount_ = 0L;
+      onChanged();
+      return this;
+    }
+
+    @java.lang.Override
+    public final Builder setUnknownFields(final com.google.protobuf.UnknownFieldSet unknownFields) {
+      return super.setUnknownFields(unknownFields);
+    }
+
+    @java.lang.Override
+    public final Builder mergeUnknownFields(
+        final com.google.protobuf.UnknownFieldSet unknownFields) {
+      return super.mergeUnknownFields(unknownFields);
+    }
+
+    // @@protoc_insertion_point(builder_scope:google.cloud.retail.v2alpha.TransformedUserEventsMetadata)
+  }
+
+  // @@protoc_insertion_point(class_scope:google.cloud.retail.v2alpha.TransformedUserEventsMetadata)
+  private static final com.google.cloud.retail.v2alpha.TransformedUserEventsMetadata
+      DEFAULT_INSTANCE;
+
+  static {
+    DEFAULT_INSTANCE = new com.google.cloud.retail.v2alpha.TransformedUserEventsMetadata();
+  }
+
+  public static com.google.cloud.retail.v2alpha.TransformedUserEventsMetadata getDefaultInstance() {
+    return DEFAULT_INSTANCE;
+  }
+
+  private static final com.google.protobuf.Parser PARSER =
+      new com.google.protobuf.AbstractParser() {
+        @java.lang.Override
+        public TransformedUserEventsMetadata parsePartialFrom(
+            com.google.protobuf.CodedInputStream input,
+            com.google.protobuf.ExtensionRegistryLite extensionRegistry)
+            throws com.google.protobuf.InvalidProtocolBufferException {
+          Builder builder = newBuilder();
+          try {
+            builder.mergeFrom(input, extensionRegistry);
+          } catch (com.google.protobuf.InvalidProtocolBufferException e) {
+            throw e.setUnfinishedMessage(builder.buildPartial());
+          } catch (com.google.protobuf.UninitializedMessageException e) {
+            throw e.asInvalidProtocolBufferException().setUnfinishedMessage(builder.buildPartial());
+          } catch (java.io.IOException e) {
+            throw new com.google.protobuf.InvalidProtocolBufferException(e)
+                .setUnfinishedMessage(builder.buildPartial());
+          }
+          return builder.buildPartial();
+        }
+      };
+
+  public static com.google.protobuf.Parser parser() {
+    return PARSER;
+  }
+
+  @java.lang.Override
+  public com.google.protobuf.Parser getParserForType() {
+    return PARSER;
+  }
+
+  @java.lang.Override
+  public com.google.cloud.retail.v2alpha.TransformedUserEventsMetadata getDefaultInstanceForType() {
+    return DEFAULT_INSTANCE;
+  }
+}
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/TransformedUserEventsMetadataOrBuilder.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/TransformedUserEventsMetadataOrBuilder.java
new file mode 100644
index 000000000000..492fdd9bc4f0
--- /dev/null
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/TransformedUserEventsMetadataOrBuilder.java
@@ -0,0 +1,52 @@
+/*
+ * Copyright 2020 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+// Generated by the protocol buffer compiler.  DO NOT EDIT!
+// source: google/cloud/retail/v2alpha/import_config.proto
+
+package com.google.cloud.retail.v2alpha;
+
+public interface TransformedUserEventsMetadataOrBuilder
+    extends
+    // @@protoc_insertion_point(interface_extends:google.cloud.retail.v2alpha.TransformedUserEventsMetadata)
+    com.google.protobuf.MessageOrBuilder {
+
+  /**
+   *
+   *
+   * 
      +   * Count of entries in the source user events BigQuery table.
+   * 
      
+   *
+   * int64 source_events_count = 1;
+   *
+   * @return The sourceEventsCount.
+   */
+  long getSourceEventsCount();
+
+  /**
+   *
+   *
+   * 
      +   * Count of entries in the transformed user events BigQuery table, which could
+   * be different from the actually imported number of user events.
+   * 
      
+   *
+   * int64 transformed_events_count = 2;
+   *
+   * @return The transformedEventsCount.
+   */
+  long getTransformedEventsCount();
+}
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/TuneModelMetadata.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/TuneModelMetadata.java
index a26685f6831d..2f2d0b082686 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/TuneModelMetadata.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/TuneModelMetadata.java
@@ -75,7 +75,7 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    * 
          * The resource name of the model that this tune applies to.
    * Format:
-   * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}
+   * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}`
    * 
      
    *
    * string model = 1;
@@ -100,7 +100,7 @@ public java.lang.String getModel() {
    * 
          * The resource name of the model that this tune applies to.
    * Format:
-   * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}
+   * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}`
    * 
      
    *
    * string model = 1;
@@ -457,7 +457,7 @@ public Builder mergeFrom(
      * 
            * The resource name of the model that this tune applies to.
      * Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}`
      * 
      
      *
      * string model = 1;
@@ -481,7 +481,7 @@ public java.lang.String getModel() {
      * 
            * The resource name of the model that this tune applies to.
      * Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}`
      * 
      
      *
      * string model = 1;
@@ -505,7 +505,7 @@ public com.google.protobuf.ByteString getModelBytes() {
      * 
            * The resource name of the model that this tune applies to.
      * Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}`
      * 
      
      *
      * string model = 1;
@@ -528,7 +528,7 @@ public Builder setModel(java.lang.String value) {
      * 
            * The resource name of the model that this tune applies to.
      * Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}`
      * 
      
      *
      * string model = 1;
@@ -547,7 +547,7 @@ public Builder clearModel() {
      * 
            * The resource name of the model that this tune applies to.
      * Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}`
      * 
      
      *
      * string model = 1;
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/TuneModelMetadataOrBuilder.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/TuneModelMetadataOrBuilder.java
index d0d6d8d87089..8852375a41ca 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/TuneModelMetadataOrBuilder.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/TuneModelMetadataOrBuilder.java
@@ -29,7 +29,7 @@ public interface TuneModelMetadataOrBuilder
    * 
          * The resource name of the model that this tune applies to.
    * Format:
-   * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}
+   * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}`
    * 
      
    *
    * string model = 1;
@@ -43,7 +43,7 @@ public interface TuneModelMetadataOrBuilder
    * 
          * The resource name of the model that this tune applies to.
    * Format:
-   * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}
+   * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}`
    * 
      
    *
    * string model = 1;
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/TuneModelRequest.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/TuneModelRequest.java
index fdb76dc4c0a0..11e15fc84d51 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/TuneModelRequest.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/TuneModelRequest.java
@@ -76,7 +76,7 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    * 
          * Required. The resource name of the model to tune.
    * Format:
-   * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}
+   * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}`
    * 
      
    *
    * 
@@ -103,7 +103,7 @@ public java.lang.String getName() {
    * 
          * Required. The resource name of the model to tune.
    * Format:
-   * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}
+   * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}`
    * 
      
    *
    * 
@@ -463,7 +463,7 @@ public Builder mergeFrom(
      * 
            * Required. The resource name of the model to tune.
      * Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}`
      * 
      
      *
      * 
@@ -489,7 +489,7 @@ public java.lang.String getName() {
      * 
            * Required. The resource name of the model to tune.
      * Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}`
      * 
      
      *
      * 
@@ -515,7 +515,7 @@ public com.google.protobuf.ByteString getNameBytes() {
      * 
            * Required. The resource name of the model to tune.
      * Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}`
      * 
      
      *
      * 
@@ -540,7 +540,7 @@ public Builder setName(java.lang.String value) {
      * 
            * Required. The resource name of the model to tune.
      * Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}`
      * 
      
      *
      * 
@@ -561,7 +561,7 @@ public Builder clearName() {
      * 
            * Required. The resource name of the model to tune.
      * Format:
-     * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}
+     * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}`
      * 
      
      *
      * 
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/TuneModelRequestOrBuilder.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/TuneModelRequestOrBuilder.java
index 2f37fd7bad41..881cc950387c 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/TuneModelRequestOrBuilder.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/TuneModelRequestOrBuilder.java
@@ -29,7 +29,7 @@ public interface TuneModelRequestOrBuilder
    * 
          * Required. The resource name of the model to tune.
    * Format:
-   * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}
+   * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}`
    * 
      
    *
    * 
@@ -45,7 +45,7 @@ public interface TuneModelRequestOrBuilder
    * 
          * Required. The resource name of the model to tune.
    * Format:
-   * projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}
+   * `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}`
    * 
      
    *
    * 
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/UpdateModelRequest.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/UpdateModelRequest.java
index 637b105928c4..7932d495eda6 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/UpdateModelRequest.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/UpdateModelRequest.java
@@ -71,7 +71,8 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    *
    *
    * 
      -   * Required. The body of the updated [Model].
+   * Required. The body of the updated
+   * [Model][google.cloud.retail.v2alpha.Model].
    * 
      
    *
    * .google.cloud.retail.v2alpha.Model model = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -87,7 +88,8 @@ public boolean hasModel() {
    *
    *
    * 
      -   * Required. The body of the updated [Model].
+   * Required. The body of the updated
+   * [Model][google.cloud.retail.v2alpha.Model].
    * 
      
    *
    * .google.cloud.retail.v2alpha.Model model = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -103,7 +105,8 @@ public com.google.cloud.retail.v2alpha.Model getModel() {
    *
    *
    * 
      -   * Required. The body of the updated [Model].
+   * Required. The body of the updated
+   * [Model][google.cloud.retail.v2alpha.Model].
    * 
      
    *
    * .google.cloud.retail.v2alpha.Model model = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -121,7 +124,7 @@ public com.google.cloud.retail.v2alpha.ModelOrBuilder getModelOrBuilder() {
    *
    * 
          * Optional. Indicates which fields in the provided 'model' to
-   * update. If not set, will by default update all fields.
+   * update. If not set, by default updates all fields.
    * 
      
    *
    * .google.protobuf.FieldMask update_mask = 2 [(.google.api.field_behavior) = OPTIONAL];
@@ -138,7 +141,7 @@ public boolean hasUpdateMask() {
    *
    * 
          * Optional. Indicates which fields in the provided 'model' to
-   * update. If not set, will by default update all fields.
+   * update. If not set, by default updates all fields.
    * 
      
    *
    * .google.protobuf.FieldMask update_mask = 2 [(.google.api.field_behavior) = OPTIONAL];
@@ -155,7 +158,7 @@ public com.google.protobuf.FieldMask getUpdateMask() {
    *
    * 
          * Optional. Indicates which fields in the provided 'model' to
-   * update. If not set, will by default update all fields.
+   * update. If not set, by default updates all fields.
    * 
      
    *
    * .google.protobuf.FieldMask update_mask = 2 [(.google.api.field_behavior) = OPTIONAL];
@@ -552,7 +555,8 @@ public Builder mergeFrom(
      *
      *
      * 
      -     * Required. The body of the updated [Model].
+     * Required. The body of the updated
+     * [Model][google.cloud.retail.v2alpha.Model].
      * 
      
      *
      * .google.cloud.retail.v2alpha.Model model = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -567,7 +571,8 @@ public boolean hasModel() {
      *
      *
      * 
      -     * Required. The body of the updated [Model].
+     * Required. The body of the updated
+     * [Model][google.cloud.retail.v2alpha.Model].
      * 
      
      *
      * .google.cloud.retail.v2alpha.Model model = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -586,7 +591,8 @@ public com.google.cloud.retail.v2alpha.Model getModel() {
      *
      *
      * 
      -     * Required. The body of the updated [Model].
+     * Required. The body of the updated
+     * [Model][google.cloud.retail.v2alpha.Model].
      * 
      
      *
      * .google.cloud.retail.v2alpha.Model model = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -609,7 +615,8 @@ public Builder setModel(com.google.cloud.retail.v2alpha.Model value) {
      *
      *
      * 
      -     * Required. The body of the updated [Model].
+     * Required. The body of the updated
+     * [Model][google.cloud.retail.v2alpha.Model].
      * 
      
      *
      * .google.cloud.retail.v2alpha.Model model = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -629,7 +636,8 @@ public Builder setModel(com.google.cloud.retail.v2alpha.Model.Builder builderFor
      *
      *
      * 
      -     * Required. The body of the updated [Model].
+     * Required. The body of the updated
+     * [Model][google.cloud.retail.v2alpha.Model].
      * 
      
      *
      * .google.cloud.retail.v2alpha.Model model = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -656,7 +664,8 @@ public Builder mergeModel(com.google.cloud.retail.v2alpha.Model value) {
      *
      *
      * 
      -     * Required. The body of the updated [Model].
+     * Required. The body of the updated
+     * [Model][google.cloud.retail.v2alpha.Model].
      * 
      
      *
      * .google.cloud.retail.v2alpha.Model model = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -677,7 +686,8 @@ public Builder clearModel() {
      *
      *
      * 
      -     * Required. The body of the updated [Model].
+     * Required. The body of the updated
+     * [Model][google.cloud.retail.v2alpha.Model].
      * 
      
      *
      * .google.cloud.retail.v2alpha.Model model = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -692,7 +702,8 @@ public com.google.cloud.retail.v2alpha.Model.Builder getModelBuilder() {
      *
      *
      * 
      -     * Required. The body of the updated [Model].
+     * Required. The body of the updated
+     * [Model][google.cloud.retail.v2alpha.Model].
      * 
      
      *
      * .google.cloud.retail.v2alpha.Model model = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -709,7 +720,8 @@ public com.google.cloud.retail.v2alpha.ModelOrBuilder getModelOrBuilder() {
      *
      *
      * 
      -     * Required. The body of the updated [Model].
+     * Required. The body of the updated
+     * [Model][google.cloud.retail.v2alpha.Model].
      * 
      
      *
      * .google.cloud.retail.v2alpha.Model model = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -743,7 +755,7 @@ public com.google.cloud.retail.v2alpha.ModelOrBuilder getModelOrBuilder() {
      *
      * 
            * Optional. Indicates which fields in the provided 'model' to
-     * update. If not set, will by default update all fields.
+     * update. If not set, by default updates all fields.
      * 
      
      *
      * .google.protobuf.FieldMask update_mask = 2 [(.google.api.field_behavior) = OPTIONAL];
@@ -759,7 +771,7 @@ public boolean hasUpdateMask() {
      *
      * 
            * Optional. Indicates which fields in the provided 'model' to
-     * update. If not set, will by default update all fields.
+     * update. If not set, by default updates all fields.
      * 
      
      *
      * .google.protobuf.FieldMask update_mask = 2 [(.google.api.field_behavior) = OPTIONAL];
@@ -781,7 +793,7 @@ public com.google.protobuf.FieldMask getUpdateMask() {
      *
      * 
            * Optional. Indicates which fields in the provided 'model' to
-     * update. If not set, will by default update all fields.
+     * update. If not set, by default updates all fields.
      * 
      
      *
      * .google.protobuf.FieldMask update_mask = 2 [(.google.api.field_behavior) = OPTIONAL];
@@ -805,7 +817,7 @@ public Builder setUpdateMask(com.google.protobuf.FieldMask value) {
      *
      * 
            * Optional. Indicates which fields in the provided 'model' to
-     * update. If not set, will by default update all fields.
+     * update. If not set, by default updates all fields.
      * 
      
      *
      * .google.protobuf.FieldMask update_mask = 2 [(.google.api.field_behavior) = OPTIONAL];
@@ -826,7 +838,7 @@ public Builder setUpdateMask(com.google.protobuf.FieldMask.Builder builderForVal
      *
      * 
            * Optional. Indicates which fields in the provided 'model' to
-     * update. If not set, will by default update all fields.
+     * update. If not set, by default updates all fields.
      * 
      
      *
      * .google.protobuf.FieldMask update_mask = 2 [(.google.api.field_behavior) = OPTIONAL];
@@ -852,7 +864,7 @@ public Builder mergeUpdateMask(com.google.protobuf.FieldMask value) {
      *
      * 
            * Optional. Indicates which fields in the provided 'model' to
-     * update. If not set, will by default update all fields.
+     * update. If not set, by default updates all fields.
      * 
      
      *
      * .google.protobuf.FieldMask update_mask = 2 [(.google.api.field_behavior) = OPTIONAL];
@@ -874,7 +886,7 @@ public Builder clearUpdateMask() {
      *
      * 
            * Optional. Indicates which fields in the provided 'model' to
-     * update. If not set, will by default update all fields.
+     * update. If not set, by default updates all fields.
      * 
      
      *
      * .google.protobuf.FieldMask update_mask = 2 [(.google.api.field_behavior) = OPTIONAL];
@@ -890,7 +902,7 @@ public com.google.protobuf.FieldMask.Builder getUpdateMaskBuilder() {
      *
      * 
            * Optional. Indicates which fields in the provided 'model' to
-     * update. If not set, will by default update all fields.
+     * update. If not set, by default updates all fields.
      * 
      
      *
      * .google.protobuf.FieldMask update_mask = 2 [(.google.api.field_behavior) = OPTIONAL];
@@ -910,7 +922,7 @@ public com.google.protobuf.FieldMaskOrBuilder getUpdateMaskOrBuilder() {
      *
      * 
            * Optional. Indicates which fields in the provided 'model' to
-     * update. If not set, will by default update all fields.
+     * update. If not set, by default updates all fields.
      * 
      
      *
      * .google.protobuf.FieldMask update_mask = 2 [(.google.api.field_behavior) = OPTIONAL];
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/UpdateModelRequestOrBuilder.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/UpdateModelRequestOrBuilder.java
index ee10f0653f04..8bbdfadfa804 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/UpdateModelRequestOrBuilder.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/UpdateModelRequestOrBuilder.java
@@ -27,7 +27,8 @@ public interface UpdateModelRequestOrBuilder
    *
    *
    * 
      -   * Required. The body of the updated [Model].
+   * Required. The body of the updated
+   * [Model][google.cloud.retail.v2alpha.Model].
    * 
      
    *
    * .google.cloud.retail.v2alpha.Model model = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -40,7 +41,8 @@ public interface UpdateModelRequestOrBuilder
    *
    *
    * 
      -   * Required. The body of the updated [Model].
+   * Required. The body of the updated
+   * [Model][google.cloud.retail.v2alpha.Model].
    * 
      
    *
    * .google.cloud.retail.v2alpha.Model model = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -53,7 +55,8 @@ public interface UpdateModelRequestOrBuilder
    *
    *
    * 
      -   * Required. The body of the updated [Model].
+   * Required. The body of the updated
+   * [Model][google.cloud.retail.v2alpha.Model].
    * 
      
    *
    * .google.cloud.retail.v2alpha.Model model = 1 [(.google.api.field_behavior) = REQUIRED];
@@ -66,7 +69,7 @@ public interface UpdateModelRequestOrBuilder
    *
    * 
          * Optional. Indicates which fields in the provided 'model' to
-   * update. If not set, will by default update all fields.
+   * update. If not set, by default updates all fields.
    * 
      
    *
    * .google.protobuf.FieldMask update_mask = 2 [(.google.api.field_behavior) = OPTIONAL];
@@ -80,7 +83,7 @@ public interface UpdateModelRequestOrBuilder
    *
    * 
          * Optional. Indicates which fields in the provided 'model' to
-   * update. If not set, will by default update all fields.
+   * update. If not set, by default updates all fields.
    * 
      
    *
    * .google.protobuf.FieldMask update_mask = 2 [(.google.api.field_behavior) = OPTIONAL];
@@ -94,7 +97,7 @@ public interface UpdateModelRequestOrBuilder
    *
    * 
          * Optional. Indicates which fields in the provided 'model' to
-   * update. If not set, will by default update all fields.
+   * update. If not set, by default updates all fields.
    * 
      
    *
    * .google.protobuf.FieldMask update_mask = 2 [(.google.api.field_behavior) = OPTIONAL];
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/UserEvent.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/UserEvent.java
index b3a977773350..d435b1497f27 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/UserEvent.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/UserEvent.java
@@ -1206,7 +1206,7 @@ public int getOffset() {
    * 
          * The categories associated with a category page.
    * To represent full path of category, use '>' sign to separate different
-   * hierarchies. If '>' is part of the category name, please replace it with
+   * hierarchies. If '>' is part of the category name, replace it with
    * other character(s).
    * Category pages include special pages such as sales or promotions. For
    * instance, a special sale page may have the category hierarchy:
@@ -1231,7 +1231,7 @@ public com.google.protobuf.ProtocolStringList getPageCategoriesList() {
    * 
          * The categories associated with a category page.
    * To represent full path of category, use '>' sign to separate different
-   * hierarchies. If '>' is part of the category name, please replace it with
+   * hierarchies. If '>' is part of the category name, replace it with
    * other character(s).
    * Category pages include special pages such as sales or promotions. For
    * instance, a special sale page may have the category hierarchy:
@@ -1256,7 +1256,7 @@ public int getPageCategoriesCount() {
    * 
          * The categories associated with a category page.
    * To represent full path of category, use '>' sign to separate different
-   * hierarchies. If '>' is part of the category name, please replace it with
+   * hierarchies. If '>' is part of the category name, replace it with
    * other character(s).
    * Category pages include special pages such as sales or promotions. For
    * instance, a special sale page may have the category hierarchy:
@@ -1282,7 +1282,7 @@ public java.lang.String getPageCategories(int index) {
    * 
          * The categories associated with a category page.
    * To represent full path of category, use '>' sign to separate different
-   * hierarchies. If '>' is part of the category name, please replace it with
+   * hierarchies. If '>' is part of the category name, replace it with
    * other character(s).
    * Category pages include special pages such as sales or promotions. For
    * instance, a special sale page may have the category hierarchy:
@@ -5399,7 +5399,7 @@ private void ensurePageCategoriesIsMutable() {
      * 
            * The categories associated with a category page.
      * To represent full path of category, use '>' sign to separate different
-     * hierarchies. If '>' is part of the category name, please replace it with
+     * hierarchies. If '>' is part of the category name, replace it with
      * other character(s).
      * Category pages include special pages such as sales or promotions. For
      * instance, a special sale page may have the category hierarchy:
@@ -5424,7 +5424,7 @@ public com.google.protobuf.ProtocolStringList getPageCategoriesList() {
      * 
            * The categories associated with a category page.
      * To represent full path of category, use '>' sign to separate different
-     * hierarchies. If '>' is part of the category name, please replace it with
+     * hierarchies. If '>' is part of the category name, replace it with
      * other character(s).
      * Category pages include special pages such as sales or promotions. For
      * instance, a special sale page may have the category hierarchy:
@@ -5449,7 +5449,7 @@ public int getPageCategoriesCount() {
      * 
            * The categories associated with a category page.
      * To represent full path of category, use '>' sign to separate different
-     * hierarchies. If '>' is part of the category name, please replace it with
+     * hierarchies. If '>' is part of the category name, replace it with
      * other character(s).
      * Category pages include special pages such as sales or promotions. For
      * instance, a special sale page may have the category hierarchy:
@@ -5475,7 +5475,7 @@ public java.lang.String getPageCategories(int index) {
      * 
            * The categories associated with a category page.
      * To represent full path of category, use '>' sign to separate different
-     * hierarchies. If '>' is part of the category name, please replace it with
+     * hierarchies. If '>' is part of the category name, replace it with
      * other character(s).
      * Category pages include special pages such as sales or promotions. For
      * instance, a special sale page may have the category hierarchy:
@@ -5501,7 +5501,7 @@ public com.google.protobuf.ByteString getPageCategoriesBytes(int index) {
      * 
            * The categories associated with a category page.
      * To represent full path of category, use '>' sign to separate different
-     * hierarchies. If '>' is part of the category name, please replace it with
+     * hierarchies. If '>' is part of the category name, replace it with
      * other character(s).
      * Category pages include special pages such as sales or promotions. For
      * instance, a special sale page may have the category hierarchy:
@@ -5534,7 +5534,7 @@ public Builder setPageCategories(int index, java.lang.String value) {
      * 
            * The categories associated with a category page.
      * To represent full path of category, use '>' sign to separate different
-     * hierarchies. If '>' is part of the category name, please replace it with
+     * hierarchies. If '>' is part of the category name, replace it with
      * other character(s).
      * Category pages include special pages such as sales or promotions. For
      * instance, a special sale page may have the category hierarchy:
@@ -5566,7 +5566,7 @@ public Builder addPageCategories(java.lang.String value) {
      * 
            * The categories associated with a category page.
      * To represent full path of category, use '>' sign to separate different
-     * hierarchies. If '>' is part of the category name, please replace it with
+     * hierarchies. If '>' is part of the category name, replace it with
      * other character(s).
      * Category pages include special pages such as sales or promotions. For
      * instance, a special sale page may have the category hierarchy:
@@ -5595,7 +5595,7 @@ public Builder addAllPageCategories(java.lang.Iterable values)
      * 
            * The categories associated with a category page.
      * To represent full path of category, use '>' sign to separate different
-     * hierarchies. If '>' is part of the category name, please replace it with
+     * hierarchies. If '>' is part of the category name, replace it with
      * other character(s).
      * Category pages include special pages such as sales or promotions. For
      * instance, a special sale page may have the category hierarchy:
@@ -5623,7 +5623,7 @@ public Builder clearPageCategories() {
      * 
            * The categories associated with a category page.
      * To represent full path of category, use '>' sign to separate different
-     * hierarchies. If '>' is part of the category name, please replace it with
+     * hierarchies. If '>' is part of the category name, replace it with
      * other character(s).
      * Category pages include special pages such as sales or promotions. For
      * instance, a special sale page may have the category hierarchy:
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/UserEventOrBuilder.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/UserEventOrBuilder.java
index bb480d022291..ad02ae5ad7f5 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/UserEventOrBuilder.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/UserEventOrBuilder.java
@@ -838,7 +838,7 @@ com.google.cloud.retail.v2alpha.CustomAttribute getAttributesOrDefault(
    * 
          * The categories associated with a category page.
    * To represent full path of category, use '>' sign to separate different
-   * hierarchies. If '>' is part of the category name, please replace it with
+   * hierarchies. If '>' is part of the category name, replace it with
    * other character(s).
    * Category pages include special pages such as sales or promotions. For
    * instance, a special sale page may have the category hierarchy:
@@ -861,7 +861,7 @@ com.google.cloud.retail.v2alpha.CustomAttribute getAttributesOrDefault(
    * 
          * The categories associated with a category page.
    * To represent full path of category, use '>' sign to separate different
-   * hierarchies. If '>' is part of the category name, please replace it with
+   * hierarchies. If '>' is part of the category name, replace it with
    * other character(s).
    * Category pages include special pages such as sales or promotions. For
    * instance, a special sale page may have the category hierarchy:
@@ -884,7 +884,7 @@ com.google.cloud.retail.v2alpha.CustomAttribute getAttributesOrDefault(
    * 
          * The categories associated with a category page.
    * To represent full path of category, use '>' sign to separate different
-   * hierarchies. If '>' is part of the category name, please replace it with
+   * hierarchies. If '>' is part of the category name, replace it with
    * other character(s).
    * Category pages include special pages such as sales or promotions. For
    * instance, a special sale page may have the category hierarchy:
@@ -908,7 +908,7 @@ com.google.cloud.retail.v2alpha.CustomAttribute getAttributesOrDefault(
    * 
          * The categories associated with a category page.
    * To represent full path of category, use '>' sign to separate different
-   * hierarchies. If '>' is part of the category name, please replace it with
+   * hierarchies. If '>' is part of the category name, replace it with
    * other character(s).
    * Category pages include special pages such as sales or promotions. For
    * instance, a special sale page may have the category hierarchy:
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/UserEventServiceProto.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/UserEventServiceProto.java
index 19c30fdaad38..5df8432ba337 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/UserEventServiceProto.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/UserEventServiceProto.java
@@ -60,64 +60,67 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
           + "_service.proto\022\033google.cloud.retail.v2al"
           + "pha\032\034google/api/annotations.proto\032\027googl"
           + "e/api/client.proto\032\037google/api/field_beh"
-          + "avior.proto\032\031google/api/httpbody.proto\032/"
-          + "google/cloud/retail/v2alpha/import_confi"
-          + "g.proto\032.google/cloud/retail/v2alpha/pur"
-          + "ge_config.proto\032,google/cloud/retail/v2a"
-          + "lpha/user_event.proto\032#google/longrunnin"
-          + "g/operations.proto\"m\n\025WriteUserEventRequ"
-          + "est\022\023\n\006parent\030\001 \001(\tB\003\340A\002\022?\n\nuser_event\030\002"
-          + " \001(\0132&.google.cloud.retail.v2alpha.UserE"
-          + "ventB\003\340A\002\"a\n\027CollectUserEventRequest\022\023\n\006"
-          + "parent\030\001 \001(\tB\003\340A\002\022\027\n\nuser_event\030\002 \001(\tB\003\340"
-          + "A\002\022\013\n\003uri\030\003 \001(\t\022\013\n\003ets\030\004 \001(\003\"\203\002\n\027RejoinU"
-          + "serEventsRequest\022\023\n\006parent\030\001 \001(\tB\003\340A\002\022j\n"
-          + "\027user_event_rejoin_scope\030\002 \001(\0162I.google."
-          + "cloud.retail.v2alpha.RejoinUserEventsReq"
-          + "uest.UserEventRejoinScope\"g\n\024UserEventRe"
-          + "joinScope\022\'\n#USER_EVENT_REJOIN_SCOPE_UNS"
-          + "PECIFIED\020\000\022\021\n\rJOINED_EVENTS\020\001\022\023\n\017UNJOINE"
-          + "D_EVENTS\020\002\">\n\030RejoinUserEventsResponse\022\""
-          + "\n\032rejoined_user_events_count\030\001 \001(\003\"\032\n\030Re"
-          + "joinUserEventsMetadata2\212\n\n\020UserEventServ"
-          + "ice\022\306\001\n\016WriteUserEvent\0222.google.cloud.re"
-          + "tail.v2alpha.WriteUserEventRequest\032&.goo"
-          + "gle.cloud.retail.v2alpha.UserEvent\"X\202\323\344\223"
-          + "\002R\"D/v2alpha/{parent=projects/*/location"
-          + "s/*/catalogs/*}/userEvents:write:\nuser_e"
-          + "vent\022\256\001\n\020CollectUserEvent\0224.google.cloud"
-          + ".retail.v2alpha.CollectUserEventRequest\032"
-          + "\024.google.api.HttpBody\"N\202\323\344\223\002H\022F/v2alpha/"
-          + "{parent=projects/*/locations/*/catalogs/"
-          + "*}/userEvents:collect\022\232\002\n\017PurgeUserEvent"
-          + "s\0223.google.cloud.retail.v2alpha.PurgeUse"
-          + "rEventsRequest\032\035.google.longrunning.Oper"
-          + "ation\"\262\001\202\323\344\223\002I\"D/v2alpha/{parent=project"
-          + "s/*/locations/*/catalogs/*}/userEvents:p"
-          + "urge:\001*\312A`\n3google.cloud.retail.v2alpha."
-          + "PurgeUserEventsResponse\022)google.cloud.re"
-          + "tail.v2alpha.PurgeMetadata\022\237\002\n\020ImportUse"
-          + "rEvents\0224.google.cloud.retail.v2alpha.Im"
-          + "portUserEventsRequest\032\035.google.longrunni"
-          + "ng.Operation\"\265\001\202\323\344\223\002J\"E/v2alpha/{parent="
+          + "avior.proto\032\031google/api/httpbody.proto\032\031"
+          + "google/api/resource.proto\032/google/cloud/"
+          + "retail/v2alpha/import_config.proto\032.goog"
+          + "le/cloud/retail/v2alpha/purge_config.pro"
+          + "to\032,google/cloud/retail/v2alpha/user_eve"
+          + "nt.proto\032#google/longrunning/operations."
+          + "proto\"\202\001\n\025WriteUserEventRequest\022\023\n\006paren"
+          + "t\030\001 \001(\tB\003\340A\002\022?\n\nuser_event\030\002 \001(\0132&.googl"
+          + "e.cloud.retail.v2alpha.UserEventB\003\340A\002\022\023\n"
+          + "\013write_async\030\003 \001(\010\"\237\001\n\027CollectUserEventR"
+          + "equest\022\027\n\rprebuilt_rule\030\006 \001(\tH\000\022\023\n\006paren"
+          + "t\030\001 \001(\tB\003\340A\002\022\027\n\nuser_event\030\002 \001(\tB\003\340A\002\022\013\n"
+          + "\003uri\030\003 \001(\t\022\013\n\003ets\030\004 \001(\003\022\020\n\010raw_json\030\005 \001("
+          + "\tB\021\n\017conversion_rule\"\203\002\n\027RejoinUserEvent"
+          + "sRequest\022\023\n\006parent\030\001 \001(\tB\003\340A\002\022j\n\027user_ev"
+          + "ent_rejoin_scope\030\002 \001(\0162I.google.cloud.re"
+          + "tail.v2alpha.RejoinUserEventsRequest.Use"
+          + "rEventRejoinScope\"g\n\024UserEventRejoinScop"
+          + "e\022\'\n#USER_EVENT_REJOIN_SCOPE_UNSPECIFIED"
+          + "\020\000\022\021\n\rJOINED_EVENTS\020\001\022\023\n\017UNJOINED_EVENTS"
+          + "\020\002\">\n\030RejoinUserEventsResponse\022\"\n\032rejoin"
+          + "ed_user_events_count\030\001 \001(\003\"\032\n\030RejoinUser"
+          + "EventsMetadata2\212\n\n\020UserEventService\022\306\001\n\016"
+          + "WriteUserEvent\0222.google.cloud.retail.v2a"
+          + "lpha.WriteUserEventRequest\032&.google.clou"
+          + "d.retail.v2alpha.UserEvent\"X\202\323\344\223\002R\"D/v2a"
+          + "lpha/{parent=projects/*/locations/*/cata"
+          + "logs/*}/userEvents:write:\nuser_event\022\256\001\n"
+          + "\020CollectUserEvent\0224.google.cloud.retail."
+          + "v2alpha.CollectUserEventRequest\032\024.google"
+          + ".api.HttpBody\"N\202\323\344\223\002H\022F/v2alpha/{parent="
           + "projects/*/locations/*/catalogs/*}/userE"
-          + "vents:import:\001*\312Ab\n4google.cloud.retail."
-          + "v2alpha.ImportUserEventsResponse\022*google"
-          + ".cloud.retail.v2alpha.ImportMetadata\022\361\001\n"
-          + "\020RejoinUserEvents\0224.google.cloud.retail."
-          + "v2alpha.RejoinUserEventsRequest\032\035.google"
-          + ".longrunning.Operation\"\207\001\202\323\344\223\002J\"E/v2alph"
-          + "a/{parent=projects/*/locations/*/catalog"
-          + "s/*}/userEvents:rejoin:\001*\312A4\n\030RejoinUser"
-          + "EventsResponse\022\030RejoinUserEventsMetadata"
-          + "\032I\312A\025retail.googleapis.com\322A.https://www"
-          + ".googleapis.com/auth/cloud-platformB\343\001\n\037"
-          + "com.google.cloud.retail.v2alphaB\025UserEve"
-          + "ntServiceProtoP\001ZAgoogle.golang.org/genp"
-          + "roto/googleapis/cloud/retail/v2alpha;ret"
-          + "ail\242\002\006RETAIL\252\002\033Google.Cloud.Retail.V2Alp"
-          + "ha\312\002\033Google\\Cloud\\Retail\\V2alpha\352\002\036Googl"
-          + "e::Cloud::Retail::V2alphab\006proto3"
+          + "vents:collect\022\232\002\n\017PurgeUserEvents\0223.goog"
+          + "le.cloud.retail.v2alpha.PurgeUserEventsR"
+          + "equest\032\035.google.longrunning.Operation\"\262\001"
+          + "\202\323\344\223\002I\"D/v2alpha/{parent=projects/*/loca"
+          + "tions/*/catalogs/*}/userEvents:purge:\001*\312"
+          + "A`\n3google.cloud.retail.v2alpha.PurgeUse"
+          + "rEventsResponse\022)google.cloud.retail.v2a"
+          + "lpha.PurgeMetadata\022\237\002\n\020ImportUserEvents\022"
+          + "4.google.cloud.retail.v2alpha.ImportUser"
+          + "EventsRequest\032\035.google.longrunning.Opera"
+          + "tion\"\265\001\202\323\344\223\002J\"E/v2alpha/{parent=projects"
+          + "/*/locations/*/catalogs/*}/userEvents:im"
+          + "port:\001*\312Ab\n4google.cloud.retail.v2alpha."
+          + "ImportUserEventsResponse\022*google.cloud.r"
+          + "etail.v2alpha.ImportMetadata\022\361\001\n\020RejoinU"
+          + "serEvents\0224.google.cloud.retail.v2alpha."
+          + "RejoinUserEventsRequest\032\035.google.longrun"
+          + "ning.Operation\"\207\001\202\323\344\223\002J\"E/v2alpha/{paren"
+          + "t=projects/*/locations/*/catalogs/*}/use"
+          + "rEvents:rejoin:\001*\312A4\n\030RejoinUserEventsRe"
+          + "sponse\022\030RejoinUserEventsMetadata\032I\312A\025ret"
+          + "ail.googleapis.com\322A.https://www.googlea"
+          + "pis.com/auth/cloud-platformB\343\001\n\037com.goog"
+          + "le.cloud.retail.v2alphaB\025UserEventServic"
+          + "eProtoP\001ZAgoogle.golang.org/genproto/goo"
+          + "gleapis/cloud/retail/v2alpha;retail\242\002\006RE"
+          + "TAIL\252\002\033Google.Cloud.Retail.V2Alpha\312\002\033Goo"
+          + "gle\\Cloud\\Retail\\V2alpha\352\002\036Google::Cloud"
+          + "::Retail::V2alphab\006proto3"
     };
     descriptor =
         com.google.protobuf.Descriptors.FileDescriptor.internalBuildGeneratedFileFrom(
@@ -127,6 +130,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
               com.google.api.ClientProto.getDescriptor(),
               com.google.api.FieldBehaviorProto.getDescriptor(),
               com.google.api.HttpBodyProto.getDescriptor(),
+              com.google.api.ResourceProto.getDescriptor(),
               com.google.cloud.retail.v2alpha.ImportConfigProto.getDescriptor(),
               com.google.cloud.retail.v2alpha.PurgeConfigProto.getDescriptor(),
               com.google.cloud.retail.v2alpha.UserEventProto.getDescriptor(),
@@ -138,7 +142,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
         new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable(
             internal_static_google_cloud_retail_v2alpha_WriteUserEventRequest_descriptor,
             new java.lang.String[] {
-              "Parent", "UserEvent",
+              "Parent", "UserEvent", "WriteAsync",
             });
     internal_static_google_cloud_retail_v2alpha_CollectUserEventRequest_descriptor =
         getDescriptor().getMessageTypes().get(1);
@@ -146,7 +150,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
         new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable(
             internal_static_google_cloud_retail_v2alpha_CollectUserEventRequest_descriptor,
             new java.lang.String[] {
-              "Parent", "UserEvent", "Uri", "Ets",
+              "PrebuiltRule", "Parent", "UserEvent", "Uri", "Ets", "RawJson", "ConversionRule",
             });
     internal_static_google_cloud_retail_v2alpha_RejoinUserEventsRequest_descriptor =
         getDescriptor().getMessageTypes().get(2);
@@ -183,6 +187,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
     com.google.api.ClientProto.getDescriptor();
     com.google.api.FieldBehaviorProto.getDescriptor();
     com.google.api.HttpBodyProto.getDescriptor();
+    com.google.api.ResourceProto.getDescriptor();
     com.google.cloud.retail.v2alpha.ImportConfigProto.getDescriptor();
     com.google.cloud.retail.v2alpha.PurgeConfigProto.getDescriptor();
     com.google.cloud.retail.v2alpha.UserEventProto.getDescriptor();
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/WriteUserEventRequest.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/WriteUserEventRequest.java
index 725f6c28dcd3..5130e4d1278c 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/WriteUserEventRequest.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/WriteUserEventRequest.java
@@ -172,6 +172,27 @@ public com.google.cloud.retail.v2alpha.UserEventOrBuilder getUserEventOrBuilder(
     return getUserEvent();
   }
 
+  public static final int WRITE_ASYNC_FIELD_NUMBER = 3;
+  private boolean writeAsync_;
+  /**
+   *
+   *
+   * 
      +   * If set to true, the user event will be written asynchronously after
+   * validation, and the API will respond without waiting for the write.
+   * Therefore, silent failures can occur even if the API returns success. In
+   * case of silent failures, error messages can be found in Stackdriver logs.
+   * 
      
+   *
+   * bool write_async = 3;
+   *
+   * @return The writeAsync.
+   */
+  @java.lang.Override
+  public boolean getWriteAsync() {
+    return writeAsync_;
+  }
+
   private byte memoizedIsInitialized = -1;
 
   @java.lang.Override
@@ -192,6 +213,9 @@ public void writeTo(com.google.protobuf.CodedOutputStream output) throws java.io
     if (userEvent_ != null) {
       output.writeMessage(2, getUserEvent());
     }
+    if (writeAsync_ != false) {
+      output.writeBool(3, writeAsync_);
+    }
     getUnknownFields().writeTo(output);
   }
 
@@ -207,6 +231,9 @@ public int getSerializedSize() {
     if (userEvent_ != null) {
       size += com.google.protobuf.CodedOutputStream.computeMessageSize(2, getUserEvent());
     }
+    if (writeAsync_ != false) {
+      size += com.google.protobuf.CodedOutputStream.computeBoolSize(3, writeAsync_);
+    }
     size += getUnknownFields().getSerializedSize();
     memoizedSize = size;
     return size;
@@ -228,6 +255,7 @@ public boolean equals(final java.lang.Object obj) {
     if (hasUserEvent()) {
       if (!getUserEvent().equals(other.getUserEvent())) return false;
     }
+    if (getWriteAsync() != other.getWriteAsync()) return false;
     if (!getUnknownFields().equals(other.getUnknownFields())) return false;
     return true;
   }
@@ -245,6 +273,8 @@ public int hashCode() {
       hash = (37 * hash) + USER_EVENT_FIELD_NUMBER;
       hash = (53 * hash) + getUserEvent().hashCode();
     }
+    hash = (37 * hash) + WRITE_ASYNC_FIELD_NUMBER;
+    hash = (53 * hash) + com.google.protobuf.Internal.hashBoolean(getWriteAsync());
     hash = (29 * hash) + getUnknownFields().hashCode();
     memoizedHashCode = hash;
     return hash;
@@ -392,6 +422,8 @@ public Builder clear() {
         userEvent_ = null;
         userEventBuilder_ = null;
       }
+      writeAsync_ = false;
+
       return this;
     }
 
@@ -425,6 +457,7 @@ public com.google.cloud.retail.v2alpha.WriteUserEventRequest buildPartial() {
       } else {
         result.userEvent_ = userEventBuilder_.build();
       }
+      result.writeAsync_ = writeAsync_;
       onBuilt();
       return result;
     }
@@ -482,6 +515,9 @@ public Builder mergeFrom(com.google.cloud.retail.v2alpha.WriteUserEventRequest o
       if (other.hasUserEvent()) {
         mergeUserEvent(other.getUserEvent());
       }
+      if (other.getWriteAsync() != false) {
+        setWriteAsync(other.getWriteAsync());
+      }
       this.mergeUnknownFields(other.getUnknownFields());
       onChanged();
       return this;
@@ -520,6 +556,12 @@ public Builder mergeFrom(
 
                 break;
               } // case 18
+            case 24:
+              {
+                writeAsync_ = input.readBool();
+
+                break;
+              } // case 24
             default:
               {
                 if (!super.parseUnknownField(input, extensionRegistry, tag)) {
@@ -851,6 +893,67 @@ public com.google.cloud.retail.v2alpha.UserEventOrBuilder getUserEventOrBuilder(
       return userEventBuilder_;
     }
 
+    private boolean writeAsync_;
+    /**
+     *
+     *
+     * 
      +     * If set to true, the user event will be written asynchronously after
+     * validation, and the API will respond without waiting for the write.
+     * Therefore, silent failures can occur even if the API returns success. In
+     * case of silent failures, error messages can be found in Stackdriver logs.
+     * 
      
+     *
+     * bool write_async = 3;
+     *
+     * @return The writeAsync.
+     */
+    @java.lang.Override
+    public boolean getWriteAsync() {
+      return writeAsync_;
+    }
+    /**
+     *
+     *
+     * 
      +     * If set to true, the user event will be written asynchronously after
+     * validation, and the API will respond without waiting for the write.
+     * Therefore, silent failures can occur even if the API returns success. In
+     * case of silent failures, error messages can be found in Stackdriver logs.
+     * 
      
+     *
+     * bool write_async = 3;
+     *
+     * @param value The writeAsync to set.
+     * @return This builder for chaining.
+     */
+    public Builder setWriteAsync(boolean value) {
+
+      writeAsync_ = value;
+      onChanged();
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * If set to true, the user event will be written asynchronously after
+     * validation, and the API will respond without waiting for the write.
+     * Therefore, silent failures can occur even if the API returns success. In
+     * case of silent failures, error messages can be found in Stackdriver logs.
+     * 
      
+     *
+     * bool write_async = 3;
+     *
+     * @return This builder for chaining.
+     */
+    public Builder clearWriteAsync() {
+
+      writeAsync_ = false;
+      onChanged();
+      return this;
+    }
+
     @java.lang.Override
     public final Builder setUnknownFields(final com.google.protobuf.UnknownFieldSet unknownFields) {
       return super.setUnknownFields(unknownFields);
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/WriteUserEventRequestOrBuilder.java b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/WriteUserEventRequestOrBuilder.java
index df58c835875a..d6c1322ada4f 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/WriteUserEventRequestOrBuilder.java
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/java/com/google/cloud/retail/v2alpha/WriteUserEventRequestOrBuilder.java
@@ -90,4 +90,20 @@ public interface WriteUserEventRequestOrBuilder
    * 
    */
   com.google.cloud.retail.v2alpha.UserEventOrBuilder getUserEventOrBuilder();
+
+  /**
+   *
+   *
+   * 
      +   * If set to true, the user event will be written asynchronously after
+   * validation, and the API will respond without waiting for the write.
+   * Therefore, silent failures can occur even if the API returns success. In
+   * case of silent failures, error messages can be found in Stackdriver logs.
+   * 
      
+   *
+   * bool write_async = 3;
+   *
+   * @return The writeAsync.
+   */
+  boolean getWriteAsync();
 }
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/proto/google/cloud/retail/v2alpha/catalog.proto b/java-retail/proto-google-cloud-retail-v2alpha/src/main/proto/google/cloud/retail/v2alpha/catalog.proto
index f6c114d7ca46..95b7dd9443d4 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/proto/google/cloud/retail/v2alpha/catalog.proto
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/proto/google/cloud/retail/v2alpha/catalog.proto
@@ -104,8 +104,7 @@ message CatalogAttribute {
 
   // The status of the indexable option of a catalog attribute.
   enum IndexableOption {
-    // Value used when unset. Defaults to
-    // [INDEXABLE_ENABLED][google.cloud.retail.v2alpha.CatalogAttribute.IndexableOption.INDEXABLE_ENABLED].
+    // Value used when unset.
     INDEXABLE_OPTION_UNSPECIFIED = 0;
 
     // Indexable option enabled for an attribute.
@@ -117,8 +116,7 @@ message CatalogAttribute {
 
   // The status of the dynamic facetable option of a catalog attribute.
   enum DynamicFacetableOption {
-    // Value used when unset. Defaults to
-    // [DYNAMIC_FACETABLE_ENABLED][google.cloud.retail.v2alpha.CatalogAttribute.DynamicFacetableOption.DYNAMIC_FACETABLE_ENABLED].
+    // Value used when unset.
     DYNAMIC_FACETABLE_OPTION_UNSPECIFIED = 0;
 
     // Dynamic facetable option enabled for an attribute.
@@ -130,8 +128,7 @@ message CatalogAttribute {
 
   // The status of the searchable option of a catalog attribute.
   enum SearchableOption {
-    // Value used when unset. Defaults to
-    // [SEARCHABLE_DISABLED][google.cloud.retail.v2alpha.CatalogAttribute.SearchableOption.SEARCHABLE_DISABLED].
+    // Value used when unset.
     SEARCHABLE_OPTION_UNSPECIFIED = 0;
 
     // Searchable option enabled for an attribute.
@@ -141,6 +138,32 @@ message CatalogAttribute {
     SEARCHABLE_DISABLED = 2;
   }
 
+  // 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.v2alpha.CatalogAttribute.ExactSearchableOption.EXACT_SEARCHABLE_DISABLED].
+    EXACT_SEARCHABLE_OPTION_UNSPECIFIED = 0;
+
+    // Exact searchable option enabled for an attribute.
+    EXACT_SEARCHABLE_ENABLED = 1;
+
+    // Exact searchable option disabled for an attribute.
+    EXACT_SEARCHABLE_DISABLED = 2;
+  }
+
+  // The status of the retrievable option of a catalog attribute.
+  enum RetrievableOption {
+    // Value used when unset. Defaults to
+    // [RETRIEVABLE_DISABLED][google.cloud.retail.v2alpha.CatalogAttribute.RetrievableOption.RETRIEVABLE_DISABLED].
+    RETRIEVABLE_OPTION_UNSPECIFIED = 0;
+
+    // Retrievable option enabled for an attribute.
+    RETRIEVABLE_ENABLED = 1;
+
+    // Retrievable option disabled for an attribute.
+    RETRIEVABLE_DISABLED = 2;
+  }
+
   // Required. Attribute name.
   // For example: `color`, `brands`, `attributes.custom_attribute`, such as
   // `attributes.xyz`.
@@ -165,13 +188,13 @@ message CatalogAttribute {
   // APIs. This field is `False` for pre-loaded
   // [CatalogAttribute][google.cloud.retail.v2alpha.CatalogAttribute]s.
   //
-  // Only pre-loaded
-  // [CatalogAttribute][google.cloud.retail.v2alpha.CatalogAttribute]s that are
-  // neither in use by products nor predefined can be deleted.
-  // [CatalogAttribute][google.cloud.retail.v2alpha.CatalogAttribute]s that are
-  // either in use by products or are predefined cannot be deleted; however,
-  // their configuration properties will reset to default values upon removal
-  // request.
+  // Only pre-loaded [catalog
+  // attributes][google.cloud.retail.v2alpha.CatalogAttribute] that are neither
+  // in use by products nor predefined can be deleted. [Catalog
+  // attributes][google.cloud.retail.v2alpha.CatalogAttribute] that are
+  // either in use by products or are predefined attributes cannot be deleted;
+  // however, their configuration properties will reset to default values upon
+  // removal request.
   //
   // After catalog changes, it takes about 10 minutes for this field to update.
   bool in_use = 9 [(google.api.field_behavior) = OUTPUT_ONLY];
@@ -185,12 +208,16 @@ message CatalogAttribute {
   // is CATALOG_LEVEL_ATTRIBUTE_CONFIG, if INDEXABLE_ENABLED attribute values
   // are indexed so that it can be filtered, faceted, or boosted in
   // [SearchService.Search][google.cloud.retail.v2alpha.SearchService.Search].
+  //
+  // Must be specified, otherwise throws INVALID_FORMAT error.
   IndexableOption indexable_option = 5;
 
   // If DYNAMIC_FACETABLE_ENABLED, attribute values are available for dynamic
   // facet. Could only be DYNAMIC_FACETABLE_DISABLED if
   // [CatalogAttribute.indexable_option][google.cloud.retail.v2alpha.CatalogAttribute.indexable_option]
   // is INDEXABLE_DISABLED. Otherwise, an INVALID_ARGUMENT error is returned.
+  //
+  // Must be specified, otherwise throws INVALID_FORMAT error.
   DynamicFacetableOption dynamic_facetable_option = 6;
 
   // When
@@ -203,6 +230,8 @@ message CatalogAttribute {
   // will not be searchable by text queries in
   // [SearchService.Search][google.cloud.retail.v2alpha.SearchService.Search],
   // as there are no text values associated to numerical attributes.
+  //
+  // Must be specified, otherwise throws INVALID_FORMAT error.
   SearchableOption searchable_option = 7;
 
   // When
@@ -212,6 +241,15 @@ message CatalogAttribute {
   // This option works for categorical features only,
   // does not work for numerical features, inventory filtering.
   RecommendationsFilteringOption recommendations_filtering_option = 8;
+
+  // 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.
+  ExactSearchableOption exact_searchable_option = 11;
+
+  // If RETRIEVABLE_ENABLED, attribute values are retrievable in the search
+  // results.
+  RetrievableOption retrievable_option = 12;
 }
 
 // Catalog level attribute config.
@@ -336,21 +374,21 @@ message CompletionConfig {
 // will be streamed to the linked branch.
 message MerchantCenterLink {
   // Required. The linked [Merchant center account
-  // id](https://developers.google.com/shopping-content/guides/accountstatuses).
+  // ID](https://developers.google.com/shopping-content/guides/accountstatuses).
   // The account must be a standalone account or a sub-account of a MCA.
   int64 merchant_center_account_id = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // The branch id (e.g. 0/1/2) within this catalog that products from
+  // The branch ID (e.g. 0/1/2) within this catalog that products from
   // merchant_center_account_id are streamed to. When updating this field, an
   // empty value will use the currently configured default branch. However,
   // changing the default branch later on won't change the linked branch here.
   //
-  // A single branch id can only have one linked merchant center account id.
+  // A single branch ID can only have one linked merchant center account ID.
   string branch_id = 2;
 
   // String representing the destination to import for, all if left empty.
-  // List of possible values can be found here.
-  // [https://support.google.com/merchants/answer/7501026]
+  // List of possible values is given in [Included
+  // destination](https://support.google.com/merchants/answer/7501026).
   // List of allowed string values:
   // "Shopping_ads", "Buy_on_google_listings", "Display_ads", "Local_inventory
   // _ads", "Free_listings", "Free_local_listings"
@@ -375,6 +413,21 @@ message MerchantCenterLink {
   //
   // Example value: `en`.
   string language_code = 5;
+
+  // Criteria for the Merchant Center feeds to be ingested via the link.
+  // All offers will be ingested if the list is empty.
+  // Otherwise the offers will be ingested from selected feeds.
+  repeated MerchantCenterFeedFilter feeds = 6;
+}
+
+// Merchant Center Feed filter criterion.
+message MerchantCenterFeedFilter {
+  // Merchant Center primary feed ID.
+  int64 primary_feed_id = 1;
+
+  // Merchant Center primary feed name. The name is used for the display
+  // purposes only.
+  string primary_feed_name = 2;
 }
 
 // Configures Merchant Center linking.
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/proto/google/cloud/retail/v2alpha/catalog_service.proto b/java-retail/proto-google-cloud-retail-v2alpha/src/main/proto/google/cloud/retail/v2alpha/catalog_service.proto
index 088c01922de2..d14a79a83c98 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/proto/google/cloud/retail/v2alpha/catalog_service.proto
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/proto/google/cloud/retail/v2alpha/catalog_service.proto
@@ -186,6 +186,17 @@ service CatalogService {
     };
   }
 
+  // Removes all specified
+  // [CatalogAttribute][google.cloud.retail.v2alpha.CatalogAttribute]s from the
+  // [AttributesConfig][google.cloud.retail.v2alpha.AttributesConfig].
+  rpc BatchRemoveCatalogAttributes(BatchRemoveCatalogAttributesRequest)
+      returns (BatchRemoveCatalogAttributesResponse) {
+    option (google.api.http) = {
+      post: "/v2alpha/{attributes_config=projects/*/locations/*/catalogs/*/attributesConfig}:batchRemoveCatalogAttributes"
+      body: "*"
+    };
+  }
+
   // Replaces the specified
   // [CatalogAttribute][google.cloud.retail.v2alpha.CatalogAttribute] in the
   // [AttributesConfig][google.cloud.retail.v2alpha.AttributesConfig] by
@@ -341,7 +352,7 @@ message GetDefaultBranchResponse {
 // method.
 message GetCompletionConfigRequest {
   // 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`
   string name = 1 [
     (google.api.field_behavior) = REQUIRED,
     (google.api.resource_reference) = {
@@ -449,6 +460,44 @@ message RemoveCatalogAttributeRequest {
   string key = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
+// Request for
+// [CatalogService.BatchRemoveCatalogAttributes][google.cloud.retail.v2alpha.CatalogService.BatchRemoveCatalogAttributes]
+// method.
+message BatchRemoveCatalogAttributesRequest {
+  // Required. The attributes config resource shared by all catalog attributes
+  // being deleted. Format:
+  // `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/attributesConfig`
+  string attributes_config = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "retail.googleapis.com/AttributesConfig"
+    }
+  ];
+
+  // Required. The attribute name keys of the
+  // [CatalogAttribute][google.cloud.retail.v2alpha.CatalogAttribute]s to
+  // delete. A maximum of 1000 catalog attributes can be deleted in a batch.
+  repeated string attribute_keys = 2 [(google.api.field_behavior) = REQUIRED];
+}
+
+// Response of the
+// [CatalogService.BatchRemoveCatalogAttributes][google.cloud.retail.v2alpha.CatalogService.BatchRemoveCatalogAttributes].
+message BatchRemoveCatalogAttributesResponse {
+  // Catalog attributes that were deleted. Only pre-loaded [catalog
+  // attributes][google.cloud.retail.v2alpha.CatalogAttribute] that are
+  // neither [in
+  // use][google.cloud.retail.v2alpha.CatalogAttribute.in_use] by
+  // products nor predefined can be deleted.
+  repeated string deleted_catalog_attributes = 1;
+
+  // Catalog attributes that were reset. [Catalog
+  // attributes][google.cloud.retail.v2alpha.CatalogAttribute] that are either
+  // [in use][google.cloud.retail.v2alpha.CatalogAttribute.in_use] by products
+  // or are predefined attributes cannot be deleted; however, their
+  // configuration properties will reset to default values upon removal request.
+  repeated string reset_catalog_attributes = 2;
+}
+
 // Request for
 // [CatalogService.ReplaceCatalogAttribute][google.cloud.retail.v2alpha.CatalogService.ReplaceCatalogAttribute]
 // method.
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/proto/google/cloud/retail/v2alpha/common.proto b/java-retail/proto-google-cloud-retail-v2alpha/src/main/proto/google/cloud/retail/v2alpha/common.proto
index 02cf05ba8ec9..4a06b4273ef5 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/proto/google/cloud/retail/v2alpha/common.proto
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/proto/google/cloud/retail/v2alpha/common.proto
@@ -72,7 +72,7 @@ enum RecommendationsFilteringOption {
 // The use case of Cloud Retail Search.
 enum SearchSolutionUseCase {
   // The value when it's unspecified. In this case, server behavior defaults to
-  // [SEARCH_SOLUTION_USE_CASE_SEARCH][].
+  // [SEARCH_SOLUTION_USE_CASE_SEARCH][google.cloud.retail.v2alpha.SearchSolutionUseCase.SEARCH_SOLUTION_USE_CASE_SEARCH].
   SEARCH_SOLUTION_USE_CASE_UNSPECIFIED = 0;
 
   // Search use case. Expects the traffic has a non-empty
@@ -97,8 +97,8 @@ message Condition {
     // Value cannot be empty.
     // Value can have at most 3 terms if specified as a partial match. Each
     // space separated string is considered as one term.
-    // Example) "a b c" is 3 terms and allowed, " a b c d" is 4 terms and not
-    // allowed for partial match.
+    // For example, "a b c" is 3 terms and allowed, but " a b c d" is 4 terms
+    // and not allowed for a partial match.
     string value = 1;
 
     // Whether this is supposed to be a full or partial match.
@@ -127,10 +127,12 @@ message Condition {
 }
 
 // A rule is a condition-action pair
+//
 // * A condition defines when a rule is to be triggered.
 // * An action specifies what occurs on that trigger.
-// Currently only boost rules are supported.
-// Currently only supported by the search endpoint.
+// Currently rules only work for [controls][google.cloud.retail.v2alpha.Control]
+// with
+// [SOLUTION_TYPE_SEARCH][google.cloud.retail.v2alpha.SolutionType.SOLUTION_TYPE_SEARCH].
 message Rule {
   // A boost action to apply to results matching condition specified above.
   message BoostAction {
@@ -216,7 +218,8 @@ message Rule {
   }
 
   // Creates a set of terms that will be treated as synonyms of each other.
-  // Example: synonyms of "sneakers" and "shoes".
+  // Example: synonyms of "sneakers" and "shoes":
+  //
   //  * "sneakers" will use a synonym of "shoes".
   //  * "shoes" will use a synonym of "sneakers".
   message TwowaySynonymsAction {
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/proto/google/cloud/retail/v2alpha/completion_service.proto b/java-retail/proto-google-cloud-retail-v2alpha/src/main/proto/google/cloud/retail/v2alpha/completion_service.proto
index 9f399d2233b6..323bc05d607a 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/proto/google/cloud/retail/v2alpha/completion_service.proto
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/proto/google/cloud/retail/v2alpha/completion_service.proto
@@ -36,7 +36,7 @@ option ruby_package = "Google::Cloud::Retail::V2alpha";
 // Auto-completion service for retail.
 //
 // This feature is only available for users who have Retail Search enabled.
-// Please enable Retail Search on Cloud Console before using this feature.
+// Enable Retail Search on Cloud Console before using this feature.
 service CompletionService {
   option (google.api.default_host) = "retail.googleapis.com";
   option (google.api.oauth_scopes) =
@@ -45,7 +45,7 @@ service CompletionService {
   // Completes the specified prefix with keyword suggestions.
   //
   // This feature is only available for users who have Retail Search enabled.
-  // Please enable Retail Search on Cloud Console before using this feature.
+  // Enable Retail Search on Cloud Console before using this feature.
   rpc CompleteQuery(CompleteQueryRequest) returns (CompleteQueryResponse) {
     option (google.api.http) = {
       get: "/v2alpha/{catalog=projects/*/locations/*/catalogs/*}:completeQuery"
@@ -60,7 +60,7 @@ service CompletionService {
   // are indexed successfully and ready for serving. The process takes hours.
   //
   // This feature is only available for users who have Retail Search enabled.
-  // Please enable Retail Search on Cloud Console before using this feature.
+  // Enable Retail Search on Cloud Console before using this feature.
   rpc ImportCompletionData(ImportCompletionDataRequest)
       returns (google.longrunning.Operation) {
     option (google.api.http) = {
@@ -110,8 +110,10 @@ message CompleteQueryRequest {
   // number of language codes is 3.
   repeated string language_codes = 3;
 
-  // The device type context for completion suggestions.
-  // It is useful to apply different suggestions on different device types, e.g.
+  // The device type context for completion suggestions. We recommend that you
+  // leave this field empty.
+  //
+  // It can apply different suggestions on different device types, e.g.
   // `DESKTOP`, `MOBILE`. If it is empty, the suggestions are across all device
   // types.
   //
@@ -148,6 +150,11 @@ message CompleteQueryRequest {
   // The maximum allowed max suggestions is 20. If it is set higher, it will be
   // capped by 20.
   int32 max_suggestions = 5;
+
+  // If true, attribute suggestions are enabled and provided in response.
+  //
+  // This field is only available for "cloud-retail" dataset.
+  bool enable_attribute_suggestions = 9;
 }
 
 // Response of the auto-complete query.
@@ -175,6 +182,12 @@ message CompleteQueryResponse {
     string recent_search = 1;
   }
 
+  // Resource that represents attribute results.
+  message AttributeResult {
+    // The list of suggestions for the attribute.
+    repeated string suggestions = 1;
+  }
+
   // Results of the matching suggestions. The result list is ordered and the
   // first result is top suggestion.
   repeated CompletionResult completion_results = 1;
@@ -207,4 +220,14 @@ message CompleteQueryResponse {
   // Recent searches are deduplicated. More recent searches will be reserved
   // when duplication happens.
   repeated RecentSearchResult recent_search_results = 3;
+
+  // A map of matched attribute suggestions. This field is only available for
+  // "cloud-retail" dataset.
+  //
+  // Current supported keys:
+  //
+  // * `brands`
+  //
+  // * `categories`
+  map attribute_results = 4;
 }
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/proto/google/cloud/retail/v2alpha/control.proto b/java-retail/proto-google-cloud-retail-v2alpha/src/main/proto/google/cloud/retail/v2alpha/control.proto
index cdd683d573e5..6ad604ea42b7 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/proto/google/cloud/retail/v2alpha/control.proto
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/proto/google/cloud/retail/v2alpha/control.proto
@@ -30,8 +30,9 @@ option objc_class_prefix = "RETAIL";
 option php_namespace = "Google\\Cloud\\Retail\\V2alpha";
 option ruby_package = "Google::Cloud::Retail::V2alpha";
 
-// Configures dynamic serving time metadata that is used to pre and post
-// process search/recommendation model results.
+// Configures dynamic metadata that can be linked to a
+// [ServingConfig][google.cloud.retail.v2alpha.ServingConfig] and affect search
+// or recommendation results at serving time.
 message Control {
   option (google.api.resource) = {
     type: "retail.googleapis.com/Control"
@@ -45,7 +46,10 @@ message Control {
   // INVALID_ARGUMENT will be returned if either condition is violated.
   oneof control {
     // A facet specification to perform faceted search.
-    SearchRequest.FacetSpec facet_spec = 3;
+    //
+    // Note that this field is deprecated and will throw NOT_IMPLEMENTED if
+    // used for creating a control.
+    SearchRequest.FacetSpec facet_spec = 3 [deprecated = true];
 
     // A rule control - a condition-action pair.
     // Enacts a set action when the condition is triggered.
@@ -63,30 +67,34 @@ message Control {
   // characters. Otherwise, an INVALID_ARGUMENT error is thrown.
   string display_name = 2 [(google.api.field_behavior) = REQUIRED];
 
-  // Output only. List of serving configuration ids that that are associated
-  // with this control. Note the association is managed via the ServingConfig,
-  // this is an output only denormalizeed  view. Assumed to be in the same
-  // catalog.
+  // Output only. List of [serving
+  // config][google.cloud.retail.v2alpha.ServingConfig] ids that are associated
+  // with this control in the same
+  // [Catalog][google.cloud.retail.v2alpha.Catalog].
+  //
+  // Note the association is managed via the
+  // [ServingConfig][google.cloud.retail.v2alpha.ServingConfig], this is an
+  // output only denormalized view.
   repeated string associated_serving_config_ids = 5
       [(google.api.field_behavior) = OUTPUT_ONLY];
 
-  // Required. Immutable. The solution types that the serving config is used
-  // for. Currently we support setting only one type of solution at creation
-  // time.
+  // Required. Immutable. The solution types that the control is used for.
+  // Currently we support setting only one type of solution at creation time.
   //
   // Only `SOLUTION_TYPE_SEARCH` value is supported at the moment.
   // If no solution type is provided at creation time, will default to
-  // SOLUTION_TYPE_SEARCH.
+  // [SOLUTION_TYPE_SEARCH][google.cloud.retail.v2alpha.SolutionType.SOLUTION_TYPE_SEARCH].
   repeated SolutionType solution_types = 6 [
     (google.api.field_behavior) = REQUIRED,
     (google.api.field_behavior) = IMMUTABLE
   ];
 
-  // Required. Specifies the use case for the control.
+  // Specifies the use case for the control.
   // Affects what condition fields can be set.
   // Only settable by search controls.
-  // Will default to SEARCH_SOLUTION_USE_CASE_SEARCH if not specified.
-  // Currently only allow one search_solution_use_case per control.
-  repeated SearchSolutionUseCase search_solution_use_case = 7
-      [(google.api.field_behavior) = REQUIRED];
+  // Will default to
+  // [SEARCH_SOLUTION_USE_CASE_SEARCH][google.cloud.retail.v2alpha.SearchSolutionUseCase.SEARCH_SOLUTION_USE_CASE_SEARCH]
+  // if not specified. Currently only allow one search_solution_use_case per
+  // control.
+  repeated SearchSolutionUseCase search_solution_use_case = 7;
 }
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/proto/google/cloud/retail/v2alpha/control_service.proto b/java-retail/proto-google-cloud-retail-v2alpha/src/main/proto/google/cloud/retail/v2alpha/control_service.proto
index d69201a3d18f..53744cded224 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/proto/google/cloud/retail/v2alpha/control_service.proto
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/proto/google/cloud/retail/v2alpha/control_service.proto
@@ -66,7 +66,7 @@ service ControlService {
   //
   // [Control][google.cloud.retail.v2alpha.Control] cannot be set to a different
   // oneof field, if so an INVALID_ARGUMENT is returned. If the
-  // [Control][google.cloud.retail.v2alpha.Control] to delete does not exist, a
+  // [Control][google.cloud.retail.v2alpha.Control] to update does not exist, a
   // NOT_FOUND error is returned.
   rpc UpdateControl(UpdateControlRequest) returns (Control) {
     option (google.api.http) = {
@@ -84,7 +84,8 @@ service ControlService {
     option (google.api.method_signature) = "name";
   }
 
-  // Lists all Controls linked to this catalog.
+  // Lists all Controls by their parent
+  // [Catalog][google.cloud.retail.v2alpha.Catalog].
   rpc ListControls(ListControlsRequest) returns (ListControlsResponse) {
     option (google.api.http) = {
       get: "/v2alpha/{parent=projects/*/locations/*/catalogs/*}/controls"
@@ -140,7 +141,7 @@ message DeleteControlRequest {
 
 // Request for GetControl method.
 message GetControlRequest {
-  // Required. The resource name of the Control to delete. Format:
+  // Required. The resource name of the Control to get. Format:
   // `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/controls/{control_id}`
   string name = 1 [
     (google.api.field_behavior) = REQUIRED,
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/proto/google/cloud/retail/v2alpha/export_config.proto b/java-retail/proto-google-cloud-retail-v2alpha/src/main/proto/google/cloud/retail/v2alpha/export_config.proto
index dd907d1ea915..831bb2ec5507 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/proto/google/cloud/retail/v2alpha/export_config.proto
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/proto/google/cloud/retail/v2alpha/export_config.proto
@@ -16,6 +16,8 @@ syntax = "proto3";
 
 package google.cloud.retail.v2alpha;
 
+import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
 import "google/protobuf/timestamp.proto";
 import "google/rpc/status.proto";
 
@@ -40,7 +42,7 @@ message ExportErrorsConfig {
   }
 }
 
-// Metadata related to the progress of the Export operation. This will be
+// Metadata related to the progress of the Export operation. This is
 // returned by the google.longrunning.Operation.metadata field.
 message ExportMetadata {
   // Operation create time.
@@ -79,10 +81,14 @@ message ExportUserEventsResponse {
   OutputResult output_result = 3;
 }
 
-// Output result.
+// Output result that stores the information about where the exported data is
+// stored.
 message OutputResult {
-  // Export result in BigQuery.
+  // The BigQuery location where the result is stored.
   repeated BigQueryOutputResult bigquery_result = 1;
+
+  // The Google Cloud Storage location where the result is stored.
+  repeated GcsOutputResult gcs_result = 2;
 }
 
 // A BigQuery output result.
@@ -93,3 +99,9 @@ message BigQueryOutputResult {
   // The ID of a BigQuery Table.
   string table_id = 2;
 }
+
+// A Gcs output result.
+message GcsOutputResult {
+  // The uri of Gcs output
+  string output_uri = 1;
+}
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/proto/google/cloud/retail/v2alpha/import_config.proto b/java-retail/proto-google-cloud-retail-v2alpha/src/main/proto/google/cloud/retail/v2alpha/import_config.proto
index 319edb1eacb1..8b7d87b95680 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/proto/google/cloud/retail/v2alpha/import_config.proto
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/proto/google/cloud/retail/v2alpha/import_config.proto
@@ -35,7 +35,6 @@ option php_namespace = "Google\\Cloud\\Retail\\V2alpha";
 option ruby_package = "Google::Cloud::Retail::V2alpha";
 
 // Google Cloud Storage location for input content.
-// format.
 message GcsSource {
   // Required. Google Cloud Storage URIs to input files. URI can be up to
   // 2000 characters long. URIs can match the full object path (for example,
@@ -66,12 +65,12 @@ message GcsSource {
   //
   // Supported values for control imports:
   //
-  // * 'control' (default): One JSON
+  // * `control` (default): One JSON
   // [Control][google.cloud.retail.v2alpha.Control] per line.
   //
   // Supported values for catalog attribute imports:
   //
-  // * 'catalog_attribute' (default): One CSV
+  // * `catalog_attribute` (default): One CSV
   // [CatalogAttribute][google.cloud.retail.v2alpha.CatalogAttribute] per line.
   string data_schema = 2;
 }
@@ -83,9 +82,8 @@ message BigQuerySource {
   oneof partition {
     // BigQuery time partitioned table's _PARTITIONDATE in YYYY-MM-DD format.
     //
-    // Only supported when
-    // [ImportProductsRequest.reconciliation_mode][google.cloud.retail.v2alpha.ImportProductsRequest.reconciliation_mode]
-    // is set to `FULL`.
+    // Only supported in
+    // [ImportProductsRequest][google.cloud.retail.v2alpha.ImportProductsRequest].
     google.type.Date partition_date = 6;
   }
 
@@ -124,8 +122,7 @@ message BigQuerySource {
   // * `user_event_ga360`:
   //   The schema is available here:
   //   https://support.google.com/analytics/answer/3437719.
-  // * `user_event_ga4`: This feature is in private preview. Please contact the
-  //   support team for importing Google Analytics 4 events.
+  // * `user_event_ga4`:
   //   The schema is available here:
   //   https://support.google.com/analytics/answer/7029846.
   //
@@ -156,7 +153,7 @@ message ImportErrorsConfig {
   // Required. Errors destination.
   oneof destination {
     // Google Cloud Storage prefix for import errors. This must be an empty,
-    // existing Cloud Storage directory. Import errors will be written to
+    // existing Cloud Storage directory. Import errors are written to
     // sharded files in this directory, one per line, as a JSON-encoded
     // `google.rpc.Status` message.
     string gcs_prefix = 1;
@@ -176,16 +173,6 @@ message ImportProductsRequest {
 
     // Calculates diff and replaces the entire product dataset. Existing
     // products may be deleted if they are not present in the source location.
-    //
-    // Can only be set while using
-    // [BigQuerySource][google.cloud.retail.v2alpha.BigQuerySource]. And the
-    // BigQuery dataset must be created in the data location "us (multiple
-    // regions in United States)", otherwise a PERMISSION_DENIED error is
-    // thrown.
-    //
-    // Add the IAM permission "BigQuery Data Viewer" for
-    // cloud-retail-customer-data-access@system.gserviceaccount.com before
-    // using this feature otherwise an error is thrown.
     FULL = 2;
   }
 
@@ -208,8 +195,8 @@ message ImportProductsRequest {
   // The desired location of errors incurred during the Import.
   ImportErrorsConfig errors_config = 3;
 
-  // Indicates which fields in the provided imported 'products' to update. If
-  // not set, will by default update all fields.
+  // Indicates which fields in the provided imported `products` to update. If
+  // not set, all fields are updated.
   google.protobuf.FieldMask update_mask = 4;
 
   // The mode of reconciliation between existing products and the products to be
@@ -218,24 +205,19 @@ message ImportProductsRequest {
   ReconciliationMode reconciliation_mode = 5;
 
   // Full Pub/Sub topic name for receiving notification. If this field is set,
-  // when the import is finished, a notification will be sent to
-  // specified Pub/Sub topic. The message data will be JSON string of a
+  // when the import is finished, a notification is sent to
+  // specified Pub/Sub topic. The message data is JSON string of a
   // [Operation][google.longrunning.Operation].
   //
   // Format of the Pub/Sub topic is `projects/{project}/topics/{topic}`. It has
   // to be within the same project as
   // [ImportProductsRequest.parent][google.cloud.retail.v2alpha.ImportProductsRequest.parent].
-  // Make sure that both
-  // `cloud-retail-customer-data-access@system.gserviceaccount.com` and
-  // `service-@gcp-sa-retail.iam.gserviceaccount.com`
-  // have the `pubsub.topics.publish` IAM permission on the topic.
-  //
-  // Only supported when
-  // [ImportProductsRequest.reconciliation_mode][google.cloud.retail.v2alpha.ImportProductsRequest.reconciliation_mode]
-  // is set to `FULL`.
+  // Make sure that `service-@gcp-sa-retail.iam.gserviceaccount.com` has the
+  // `pubsub.topics.publish` IAM permission on the topic.
   string notification_pubsub_topic = 7;
 
-  // If true, will perform the FULL import even if it would delete a large
+  // If true, this performs the FULL import even if it would delete a large
   // proportion of the products in the default branch, which could potentially
   // cause outages if you have live predict/search traffic.
   //
@@ -277,8 +259,8 @@ message ImportCompletionDataRequest {
       [(google.api.field_behavior) = REQUIRED];
 
   // Pub/Sub topic for receiving notification. If this field is set,
-  // when the import is finished, a notification will be sent to
-  // specified Pub/Sub topic. The message data will be JSON string of a
+  // when the import is finished, a notification is sent to
+  // specified Pub/Sub topic. The message data is JSON string of a
   // [Operation][google.longrunning.Operation].
   // Format of the Pub/Sub topic is `projects/{project}/topics/{topic}`.
   string notification_pubsub_topic = 3;
@@ -338,7 +320,7 @@ message CompletionDataInputConfig {
   }
 }
 
-// Metadata related to the progress of the Import operation. This will be
+// Metadata related to the progress of the Import operation. This is
 // returned by the google.longrunning.Operation.metadata field.
 message ImportMetadata {
   // Operation create time.
@@ -358,11 +340,24 @@ message ImportMetadata {
   string request_id = 5 [deprecated = true];
 
   // Pub/Sub topic for receiving notification. If this field is set,
-  // when the import is finished, a notification will be sent to
-  // specified Pub/Sub topic. The message data will be JSON string of a
+  // when the import is finished, a notification is sent to
+  // specified Pub/Sub topic. The message data is JSON string of a
   // [Operation][google.longrunning.Operation].
   // Format of the Pub/Sub topic is `projects/{project}/topics/{topic}`.
   string notification_pubsub_topic = 6;
+
+  // Metadata related to transform user events.
+  TransformedUserEventsMetadata transformed_user_events_metadata = 7;
+}
+
+// Metadata related to transform user events operation.
+message TransformedUserEventsMetadata {
+  // Count of entries in the source user events BigQuery table.
+  int64 source_events_count = 1;
+
+  // Count of entries in the transformed user events BigQuery table, which could
+  // be different from the actually imported number of user events.
+  int64 transformed_events_count = 2;
 }
 
 // Response of the
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/proto/google/cloud/retail/v2alpha/model.proto b/java-retail/proto-google-cloud-retail-v2alpha/src/main/proto/google/cloud/retail/v2alpha/model.proto
index 5f4ead9f7d2b..1b60792dbfa2 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/proto/google/cloud/retail/v2alpha/model.proto
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/proto/google/cloud/retail/v2alpha/model.proto
@@ -34,7 +34,7 @@ option ruby_package = "Google::Cloud::Retail::V2alpha";
 // [Model][google.cloud.retail.v2alpha.Model]. A
 // [Model][google.cloud.retail.v2alpha.Model] can be associated with a
 // [ServingConfig][google.cloud.retail.v2alpha.ServingConfig] and then queried
-// through the Predict api.
+// through the Predict API.
 message Model {
   option (google.api.resource) = {
     type: "retail.googleapis.com/Model"
@@ -44,7 +44,7 @@ message Model {
   // The PageOptimizationConfig for model training.
   //
   // This determines how many panels to optimize for, and which serving
-  // configurations to consider for each panel.
+  // configs to consider for each panel.
   // The purpose of this model is to optimize which
   // [ServingConfig][google.cloud.retail.v2alpha.ServingConfig] to show on which
   // panels in way that optimizes the visitors shopping journey.
@@ -56,9 +56,9 @@ message Model {
       oneof candidate {
         // This has to be a valid
         // [ServingConfig][google.cloud.retail.v2alpha.ServingConfig]
-        // identifier. e.g. for a ServingConfig with full name:
-        // `projects/*/locations/global/catalogs/default_catalog/servingConfigs/my_candidate_config`
-        // this would be 'my_candidate_config'
+        // identifier. For example, for a ServingConfig with full name:
+        // `projects/*/locations/global/catalogs/default_catalog/servingConfigs/my_candidate_config`,
+        // this would be `my_candidate_config`.
         string serving_config_id = 1;
       }
     }
@@ -71,13 +71,11 @@ message Model {
       string display_name = 1 [(google.api.field_behavior) = OPTIONAL];
 
       // Required. The candidates to consider on the panel.
-      //
-      // Limit = 10.
       repeated Candidate candidates = 2
           [(google.api.field_behavior) = REQUIRED];
 
-      // Required. The default candidate (in case the model fails at serving
-      // time, we can fall back to the default).
+      // Required. The default candidate. If the model fails at serving time,
+      // we fall back to the default.
       Candidate default_candidate = 3 [(google.api.field_behavior) = REQUIRED];
     }
 
@@ -127,7 +125,7 @@ message Model {
       // home_page_ctr_diversity_low,
       //    pdp_cvr_no_diversity 
       //
-      // `Restriction` = UNIQUE_SERVING_CONFIG_RESTRICTION
+      // `Restriction` = `UNIQUE_SERVING_CONFIG_RESTRICTION`
       //
       // `Valid combinations`:
       //
@@ -160,7 +158,7 @@ message Model {
       // home_page_ctr_diversity_low,
       //  pdp_cvr_no_diversity 
       //
-      // `Restriction` = UNIQUE_MODEL_RESTRICTION
+      // `Restriction` = `UNIQUE_MODEL_RESTRICTION`
       //
       // `Valid combinations`:
       //
@@ -192,7 +190,7 @@ message Model {
       // home_page_ctr_diversity_low,
       //  pdp_cvr_no_diversity 
       //
-      // `Restriction` = UNIQUE_MODEL_RESTRICTION
+      // `Restriction` = `UNIQUE_MODEL_RESTRICTION`
       //
       // `Valid combinations`:
       //
@@ -247,10 +245,10 @@ message Model {
   }
 
   // Represents an ordered combination of valid serving configs, which
-  // / may be used for PAGE_OPTIMIZATION recommendations.
+  // can be used for `PAGE_OPTIMIZATION` recommendations.
   message ServingConfigList {
     // Optional. A set of valid serving configs that may be used for
-    // PAGE_OPTIMIZATION.
+    // `PAGE_OPTIMIZATION`.
     repeated string serving_config_ids = 1
         [(google.api.field_behavior) = OPTIONAL];
   }
@@ -266,7 +264,7 @@ message Model {
     // The model is serving and can be queried.
     ACTIVE = 2;
 
-    // The model is trained on tuned hyperparameters, and can be
+    // The model is trained on tuned hyperparameters and can be
     // queried.
     TUNED = 3;
   }
@@ -285,26 +283,26 @@ message Model {
 
   // Describes whether periodic tuning is enabled for this model
   // or not. Periodic tuning is scheduled at most every three months. You can
-  // start a tuning process manually by using the ModelTune
+  // start a tuning process manually by using the `TuneModel`
   // method, which starts a tuning process immediately and resets the quarterly
   // schedule. Enabling or disabling periodic tuning does not affect any
   // current tuning processes.
   enum PeriodicTuningState {
-    // Unspecified default value - should never be explicitly set.
+    // Unspecified default value, should never be explicitly set.
     PERIODIC_TUNING_STATE_UNSPECIFIED = 0;
 
     // The model has periodic tuning disabled. Tuning
-    // can be reenabled by calling the EnableModelPeriodicTuning
-    // method or by calling the TuneModel method.
+    // can be reenabled by calling the `EnableModelPeriodicTuning`
+    // method or by calling the `TuneModel` method.
     PERIODIC_TUNING_DISABLED = 1;
 
     // The model cannot be tuned with periodic tuning OR the
-    // TuneModel method. Hide the options in customer UI and
+    // `TuneModel` method. Hide the options in customer UI and
     // reject any requests through the backend self serve API.
     ALL_TUNING_DISABLED = 3;
 
     // The model has periodic tuning enabled. Tuning
-    // can be disabled by calling the DisableModelPeriodicTuning
+    // can be disabled by calling the `DisableModelPeriodicTuning`
     // method.
     PERIODIC_TUNING_ENABLED = 2;
   }
@@ -312,7 +310,7 @@ message Model {
   // Describes whether this model have sufficient training data
   // to be continuously trained.
   enum DataState {
-    // Unspecified default value - should never be explicitly set.
+    // Unspecified default value, should never be explicitly set.
     DATA_STATE_UNSPECIFIED = 0;
 
     // The model has sufficient training data.
@@ -335,7 +333,7 @@ message Model {
   // Required. The fully qualified resource name of the model.
   //
   // Format:
-  // projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}
+  // `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}`
   // catalog_id has char limit of 50.
   // recommendation_model_id has char limit of 40.
   string name = 1 [(google.api.field_behavior) = REQUIRED];
@@ -343,21 +341,21 @@ message Model {
   // Required. The display name of the model.
   //
   // Should be human readable, used to display Recommendation Models in the
-  // Retail Cloud Cosole Dashboard. UTF-8 encoded string with limit of 1024
+  // Retail Cloud Console Dashboard. UTF-8 encoded string with limit of 1024
   // characters.
   string display_name = 2 [(google.api.field_behavior) = REQUIRED];
 
   // Optional. The training state that the model is in (e.g.
-  // TRAINING or PAUSED).
+  // `TRAINING` or `PAUSED`).
   //
   // Since part of the cost of running the service
   // is frequency of training - this can be used to determine when to train
   // model in order to control cost. If not specified: the default value for
-  // CreateModel method is TRAINING. the default value for
-  // UpdateModel method is to keep the state the same as before.
+  // `CreateModel` method is `TRAINING`. The default value for
+  // `UpdateModel` method is to keep the state the same as before.
   TrainingState training_state = 3 [(google.api.field_behavior) = OPTIONAL];
 
-  // Output only. The serving state of the model: ACTIVE, NOT_ACTIVE.
+  // Output only. The serving state of the model: `ACTIVE`, `NOT_ACTIVE`.
   ServingState serving_state = 4 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Output only. Timestamp the Recommendation Model was created at.
@@ -373,8 +371,19 @@ message Model {
   // Required. The type of model e.g. `home-page`.
   //
   // Currently supported values: `recommended-for-you`, `others-you-may-like`,
-  // `frequently-bought-together`, `page-optimization`, 'similar-items',
-  // 'buy-it-again', `recently-viewed`(readonly value).
+  // `frequently-bought-together`, `page-optimization`, `similar-items`,
+  // `buy-it-again`, `on-sale-items`, and `recently-viewed`(readonly value).
+  //
+  //
+  // This field together with
+  // [optimization_objective][google.cloud.retail.v2alpha.Model.optimization_objective]
+  // describe model metadata to use to control model training and serving.
+  // See https://cloud.google.com/retail/docs/models
+  // for more details on what the model metadata control and which combination
+  // of parameters are valid. For invalid combinations of parameters (e.g. type
+  // = `frequently-bought-together` and optimization_objective = `ctr`), you
+  // receive an error 400 if you try to create/update a recommendation with
+  // this set of knobs.
   string type = 7 [(google.api.field_behavior) = REQUIRED];
 
   // Optional. The optimization objective e.g. `cvr`.
@@ -390,13 +399,23 @@ message Model {
   // `others-you-may-like` => `ctr`
   //
   // `frequently-bought-together` => `revenue_per_order`
+  //
+  // This field together with
+  // [optimization_objective][google.cloud.retail.v2alpha.Model.type]
+  // describe model metadata to use to control model training and serving.
+  // See https://cloud.google.com/retail/docs/models
+  // for more details on what the model metadata control and which combination
+  // of parameters are valid. For invalid combinations of parameters (e.g. type
+  // = `frequently-bought-together` and optimization_objective = `ctr`), you
+  // receive an error 400 if you try to create/update a recommendation with
+  // this set of knobs.
   string optimization_objective = 8 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. The state of periodic tuning.
   //
   // The period we use is 3 months - to do a
-  // one-off tune earlier use the TuneModel method. Default value
-  // is PERIODIC_TUNING_ENABLED.
+  // one-off tune earlier use the `TuneModel` method. Default value
+  // is `PERIODIC_TUNING_ENABLED`.
   PeriodicTuningState periodic_tuning_state = 11
       [(google.api.field_behavior) = OPTIONAL];
 
@@ -410,18 +429,18 @@ message Model {
   // recommendation. Empty field implies no tune is goig on.
   string tuning_operation = 15 [(google.api.field_behavior) = OUTPUT_ONLY];
 
-  // Output only. The state of data requirements for this model: DATA_OK and
-  // DATA_ERROR.
+  // Output only. The state of data requirements for this model: `DATA_OK` and
+  // `DATA_ERROR`.
   //
   // Recommendation model cannot be trained if the data is in
-  // DATA_ERROR state. Recommendation model can have DATA_ERROR state even if
-  // serving state is ACTIVE: models were trained successfully before, but
+  // `DATA_ERROR` state. Recommendation model can have `DATA_ERROR` state even
+  // if serving state is `ACTIVE`: models were trained successfully before, but
   // cannot be refreshed because model no longer has sufficient
   // data for training.
   DataState data_state = 16 [(google.api.field_behavior) = OUTPUT_ONLY];
 
-  // Optional. If RECOMMENDATIONS_FILTERING_ENABLED, recommendation filtering by
-  // attributes is enabled for the model.
+  // Optional. If `RECOMMENDATIONS_FILTERING_ENABLED`, recommendation filtering
+  // by attributes is enabled for the model.
   RecommendationsFilteringOption filtering_option = 18
       [(google.api.field_behavior) = OPTIONAL];
 
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/proto/google/cloud/retail/v2alpha/model_service.proto b/java-retail/proto-google-cloud-retail-v2alpha/src/main/proto/google/cloud/retail/v2alpha/model_service.proto
index 30690f538f5d..af057c514261 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/proto/google/cloud/retail/v2alpha/model_service.proto
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/proto/google/cloud/retail/v2alpha/model_service.proto
@@ -36,11 +36,11 @@ option ruby_package = "Google::Cloud::Retail::V2alpha";
 
 // Service for performing CRUD operations on models.
 // Recommendation models contain all the metadata necessary to generate a set of
-// models for the Predict() api. A model is queried
+// models for the `Predict()` API. A model is queried
 // indirectly via a ServingConfig, which associates a model with a
 // given Placement (e.g. Frequently Bought Together on Home Page).
 //
-// This service allows customers to e.g.:
+// This service allows you to do the following:
 //
 // * Initiate training of a model.
 // * Pause training of an existing model.
@@ -59,8 +59,8 @@ service ModelService {
     };
     option (google.api.method_signature) = "parent,model";
     option (google.longrunning.operation_info) = {
-      response_type: "Model"
-      metadata_type: "CreateModelMetadata"
+      response_type: "google.cloud.retail.v2alpha.Model"
+      metadata_type: "google.cloud.retail.v2alpha.CreateModelMetadata"
     };
   }
 
@@ -99,8 +99,9 @@ service ModelService {
   }
 
   // Update of model metadata. Only fields that
-  // currently can be updated are: filtering_option, periodic_tuning_state.
-  // If other values are provided, this API method will ignore them.
+  // currently can be updated are: `filtering_option` and
+  // `periodic_tuning_state`.
+  // If other values are provided, this API method ignores them.
   rpc UpdateModel(UpdateModelRequest) returns (Model) {
     option (google.api.http) = {
       patch: "/v2alpha/{model.name=projects/*/locations/*/catalogs/*/models/*}"
@@ -117,8 +118,8 @@ service ModelService {
     };
     option (google.api.method_signature) = "name";
     option (google.longrunning.operation_info) = {
-      response_type: "TuneModelResponse"
-      metadata_type: "TuneModelMetadata"
+      response_type: "google.cloud.retail.v2alpha.TuneModelResponse"
+      metadata_type: "google.cloud.retail.v2alpha.TuneModelMetadata"
     };
   }
 }
@@ -126,27 +127,29 @@ service ModelService {
 // Request for creating a model.
 message CreateModelRequest {
   // Required. The parent resource under which to create the model. Format:
-  // projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}
+  // `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}`
   string parent = 1 [
     (google.api.field_behavior) = REQUIRED,
     (google.api.resource_reference) = { type: "retail.googleapis.com/Catalog" }
   ];
 
-  // Required. The payload of the [Model]  to create.
+  // Required. The payload of the [Model][google.cloud.retail.v2alpha.Model]  to
+  // create.
   Model model = 2 [(google.api.field_behavior) = REQUIRED];
 
-  // Optional. Whether to run a dry_run to validate the request (without
+  // Optional. Whether to run a dry run to validate the request (without
   // actually creating the model).
   bool dry_run = 3 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Request for updating an existing model.
 message UpdateModelRequest {
-  // Required. The body of the updated [Model].
+  // Required. The body of the updated
+  // [Model][google.cloud.retail.v2alpha.Model].
   Model model = 1 [(google.api.field_behavior) = REQUIRED];
 
   // Optional. Indicates which fields in the provided 'model' to
-  // update. If not set, will by default update all fields.
+  // update. If not set, by default updates all fields.
   google.protobuf.FieldMask update_mask = 2
       [(google.api.field_behavior) = OPTIONAL];
 }
@@ -155,7 +158,7 @@ message UpdateModelRequest {
 message PauseModelRequest {
   // Required. The name of the model to pause.
   // Format:
-  // projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}
+  // `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}`
   string name = 1 [
     (google.api.field_behavior) = REQUIRED,
     (google.api.resource_reference) = { type: "retail.googleapis.com/Model" }
@@ -166,7 +169,7 @@ message PauseModelRequest {
 message ResumeModelRequest {
   // Required. The name of the model to resume.
   // Format:
-  // projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}
+  // `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}`
   string name = 1 [(google.api.field_behavior) = REQUIRED];
 }
 
@@ -174,7 +177,7 @@ message ResumeModelRequest {
 message ListModelsRequest {
   // Required. The parent for which to list models.
   // Format:
-  // projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}
+  // `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}`
   string parent = 1 [
     (google.api.field_behavior) = REQUIRED,
     (google.api.resource_reference) = { type: "retail.googleapis.com/Catalog" }
@@ -191,9 +194,9 @@ message ListModelsRequest {
 
 // Request for deleting a model.
 message DeleteModelRequest {
-  // Required. The resource name of the [Model] to delete.
-  // Format:
-  // projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}
+  // Required. The resource name of the
+  // [Model][google.cloud.retail.v2alpha.Model] to delete. Format:
+  // `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}`
   string name = 1 [
     (google.api.field_behavior) = REQUIRED,
     (google.api.resource_reference) = { type: "retail.googleapis.com/Model" }
@@ -214,7 +217,7 @@ message ListModelsResponse {
 message TuneModelRequest {
   // Required. The resource name of the model to tune.
   // Format:
-  // projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}
+  // `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}`
   string name = 1 [
     (google.api.field_behavior) = REQUIRED,
     (google.api.resource_reference) = { type: "retail.googleapis.com/Model" }
@@ -225,7 +228,7 @@ message TuneModelRequest {
 message CreateModelMetadata {
   // The resource name of the model that this create applies to.
   // Format:
-  // projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}
+  // `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}`
   string model = 1;
 }
 
@@ -233,7 +236,7 @@ message CreateModelMetadata {
 message TuneModelMetadata {
   // The resource name of the model that this tune applies to.
   // Format:
-  // projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}
+  // `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/models/{model_id}`
   string model = 1;
 }
 
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/proto/google/cloud/retail/v2alpha/prediction_service.proto b/java-retail/proto-google-cloud-retail-v2alpha/src/main/proto/google/cloud/retail/v2alpha/prediction_service.proto
index b76aed50b11a..b88e97e7a34a 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/proto/google/cloud/retail/v2alpha/prediction_service.proto
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/proto/google/cloud/retail/v2alpha/prediction_service.proto
@@ -19,6 +19,7 @@ package google.cloud.retail.v2alpha;
 import "google/api/annotations.proto";
 import "google/api/client.proto";
 import "google/api/field_behavior.proto";
+import "google/api/resource.proto";
 import "google/cloud/retail/v2alpha/user_event.proto";
 import "google/protobuf/struct.proto";
 
@@ -61,7 +62,7 @@ message PredictRequest {
   // The ID of the Recommendations AI serving config or placement.
   // Before you can request predictions from your model, you must create at
   // least one serving config or placement for it. For more information, see
-  // [Managing serving configurations]
+  // [Manage serving configs]
   // (https://cloud.google.com/retail/docs/manage-configs).
   //
   // The full list of available serving configs can be seen at
@@ -84,13 +85,13 @@ message PredictRequest {
   // [UserInfo.user_id][google.cloud.retail.v2alpha.UserInfo.user_id] unset.
   UserEvent user_event = 2 [(google.api.field_behavior) = REQUIRED];
 
-  // Maximum number of results to return per page. Set this property
-  // to the number of prediction results needed. If zero, the service will
-  // choose a reasonable default. The maximum allowed value is 100. Values
-  // above 100 will be coerced to 100.
+  // Maximum number of results to return. Set this property to the number of
+  // prediction results needed. If zero, the service will choose a reasonable
+  // default. The maximum allowed value is 100. Values above 100 will be coerced
+  // to 100.
   int32 page_size = 3;
 
-  // This field is not used for now; leave it unset.
+  // This field is not used; leave it unset.
   string page_token = 4 [deprecated = true];
 
   // Filter for restricting prediction results with a length limit of 5,000
@@ -116,12 +117,11 @@ message PredictRequest {
   //  * filterOutOfStockItems  tag=(-"promotional")
   //  * filterOutOfStockItems
   //
-  // If your filter blocks all prediction results, the API will return generic
-  // (unfiltered) popular products. If you only want results strictly matching
-  // the filters, set `strictFiltering` to True in `PredictRequest.params` to
-  // receive empty results instead.
-  // Note that the API will never return items with storageStatus of "EXPIRED"
-  // or "DELETED" regardless of filter choices.
+  // If your filter blocks all prediction results, the API will return *no*
+  // results. If instead you want empty result sets to return generic
+  // (unfiltered) popular products, set `strictFiltering` to False in
+  // `PredictRequest.params`. Note that the API will never return items with
+  // storageStatus of "EXPIRED" or "DELETED" regardless of filter choices.
   //
   // If `filterSyntaxV2` is set to true under the `params` field, then
   // attribute-based expressions are expected instead of the above described
@@ -148,7 +148,7 @@ message PredictRequest {
   // * `returnScore`: Boolean. If set to true, the prediction 'score'
   //    corresponding to each returned product will be set in the
   //    `results.metadata` field in the prediction response. The given
-  //    'score' indicates the probability of an product being clicked/purchased
+  //    'score' indicates the probability of a product being clicked/purchased
   //    given the user's context and history.
   // * `strictFiltering`: Boolean. True by default. If set to false, the service
   //    will return generic (unfiltered) popular products instead of empty if
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/proto/google/cloud/retail/v2alpha/product.proto b/java-retail/proto-google-cloud-retail-v2alpha/src/main/proto/google/cloud/retail/v2alpha/product.proto
index f4826f1bdd0c..7dd20a744b3e 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/proto/google/cloud/retail/v2alpha/product.proto
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/proto/google/cloud/retail/v2alpha/product.proto
@@ -105,6 +105,13 @@ message Product {
   oneof expiration {
     // The timestamp when this product becomes unavailable for
     // [SearchService.Search][google.cloud.retail.v2alpha.SearchService.Search].
+    // Note that this is only applicable to
+    // [Type.PRIMARY][google.cloud.retail.v2alpha.Product.Type.PRIMARY] and
+    // [Type.COLLECTION][google.cloud.retail.v2alpha.Product.Type.COLLECTION],
+    // and ignored for
+    // [Type.VARIANT][google.cloud.retail.v2alpha.Product.Type.VARIANT]. In
+    // general, we suggest the users to delete the stale products explicitly,
+    // instead of using this field to determine staleness.
     //
     // If it is set, the [Product][google.cloud.retail.v2alpha.Product] is not
     // available for
@@ -125,7 +132,14 @@ message Product {
     // [expiration_date](https://support.google.com/merchants/answer/6324499).
     google.protobuf.Timestamp expire_time = 16;
 
-    // Input only. The TTL (time to live) of the product.
+    // Input only. The TTL (time to live) of the product. Note that this is only
+    // applicable to
+    // [Type.PRIMARY][google.cloud.retail.v2alpha.Product.Type.PRIMARY] and
+    // [Type.COLLECTION][google.cloud.retail.v2alpha.Product.Type.COLLECTION],
+    // and ignored for
+    // [Type.VARIANT][google.cloud.retail.v2alpha.Product.Type.VARIANT]. In
+    // general, we suggest the users to delete the stale products explicitly,
+    // instead of using this field to determine staleness.
     //
     // If it is set, it must be a non-negative value, and
     // [expire_time][google.cloud.retail.v2alpha.Product.expire_time] is set as
@@ -200,7 +214,7 @@ message Product {
   // The [type][google.cloud.retail.v2alpha.Product.type] of the members must be
   // either [Type.PRIMARY][google.cloud.retail.v2alpha.Product.Type.PRIMARY] or
   // [Type.VARIANT][google.cloud.retail.v2alpha.Product.Type.VARIANT] otherwise
-  // and INVALID_ARGUMENT error is thrown. Should not set it for other types. A
+  // an INVALID_ARGUMENT error is thrown. Should not set it for other types. A
   // maximum of 1000 values are allowed. Otherwise, an INVALID_ARGUMENT error is
   // return.
   repeated string collection_member_ids = 5;
@@ -231,7 +245,7 @@ message Product {
   //
   //
   // To represent full path of category, use '>' sign to separate different
-  // hierarchies. If '>' is part of the category name, please replace it with
+  // hierarchies. If '>' is part of the category name, replace it with
   // other character(s).
   //
   // For example, if a shoes product belongs to both
@@ -364,6 +378,11 @@ message Product {
   // The timestamp when this [Product][google.cloud.retail.v2alpha.Product]
   // becomes available for
   // [SearchService.Search][google.cloud.retail.v2alpha.SearchService.Search].
+  // Note that this is only applicable to
+  // [Type.PRIMARY][google.cloud.retail.v2alpha.Product.Type.PRIMARY] and
+  // [Type.COLLECTION][google.cloud.retail.v2alpha.Product.Type.COLLECTION], and
+  // ignored for
+  // [Type.VARIANT][google.cloud.retail.v2alpha.Product.Type.VARIANT].
   google.protobuf.Timestamp available_time = 18;
 
   // The online availability of the
@@ -551,7 +570,9 @@ message Product {
   // Note: Returning more fields in
   // [SearchResponse][google.cloud.retail.v2alpha.SearchResponse] can increase
   // response payload size and serving latency.
-  google.protobuf.FieldMask retrievable_fields = 30;
+  //
+  // This field is deprecated. Use the retrievable site-wide control instead.
+  google.protobuf.FieldMask retrievable_fields = 30 [deprecated = true];
 
   // Output only. Product variants grouped together on primary product which
   // share similar product attributes. It's automatically grouped by
@@ -564,4 +585,15 @@ message Product {
   // [ProductService.GetProduct][google.cloud.retail.v2alpha.ProductService.GetProduct].
   // Do not set this field in API requests.
   repeated Product variants = 31 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. A list of local inventories specific to different places.
+  //
+  // This is only available for users who have Retail Search enabled, and it can
+  // be managed by
+  // [ProductService.AddLocalInventories][google.cloud.retail.v2alpha.ProductService.AddLocalInventories]
+  // and
+  // [ProductService.RemoveLocalInventories][google.cloud.retail.v2alpha.ProductService.RemoveLocalInventories]
+  // APIs.
+  repeated LocalInventory local_inventories = 35
+      [(google.api.field_behavior) = OUTPUT_ONLY];
 }
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/proto/google/cloud/retail/v2alpha/product_service.proto b/java-retail/proto-google-cloud-retail-v2alpha/src/main/proto/google/cloud/retail/v2alpha/product_service.proto
index 1a5f702bb057..ec82c437f445 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/proto/google/cloud/retail/v2alpha/product_service.proto
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/proto/google/cloud/retail/v2alpha/product_service.proto
@@ -141,9 +141,9 @@ service ProductService {
   //
   // This process is asynchronous and does not require the
   // [Product][google.cloud.retail.v2alpha.Product] to exist before updating
-  // fulfillment information. If the request is valid, the update will be
-  // enqueued and processed downstream. As a consequence, when a response is
-  // returned, updates are not immediately manifested in the
+  // fulfillment information. If the request is valid, the update is enqueued
+  // and processed downstream. As a consequence, when a response is returned,
+  // updates are not immediately manifested in the
   // [Product][google.cloud.retail.v2alpha.Product] queried by
   // [ProductService.GetProduct][google.cloud.retail.v2alpha.ProductService.GetProduct]
   // or
@@ -153,10 +153,10 @@ service ProductService {
   // [ProductService.CreateProduct][google.cloud.retail.v2alpha.ProductService.CreateProduct]
   // and
   // [ProductService.UpdateProduct][google.cloud.retail.v2alpha.ProductService.UpdateProduct],
-  // the specified inventory field value(s) will overwrite any existing value(s)
+  // the specified inventory field value(s) overwrite any existing value(s)
   // while ignoring the last update time for this field. Furthermore, the last
-  // update time for the specified inventory fields will be overwritten to the
-  // time of the
+  // update times for the specified inventory fields are overwritten by the
+  // times of the
   // [ProductService.CreateProduct][google.cloud.retail.v2alpha.ProductService.CreateProduct]
   // or
   // [ProductService.UpdateProduct][google.cloud.retail.v2alpha.ProductService.UpdateProduct]
@@ -164,11 +164,11 @@ service ProductService {
   //
   // If no inventory fields are set in
   // [CreateProductRequest.product][google.cloud.retail.v2alpha.CreateProductRequest.product],
-  // then any pre-existing inventory information for this product will be used.
+  // then any pre-existing inventory information for this product is used.
   //
   // If no inventory fields are set in
   // [SetInventoryRequest.set_mask][google.cloud.retail.v2alpha.SetInventoryRequest.set_mask],
-  // then any existing inventory information will be preserved.
+  // then any existing inventory information is preserved.
   //
   // Pre-existing inventory information can only be updated with
   // [ProductService.SetInventory][google.cloud.retail.v2alpha.ProductService.SetInventory],
@@ -176,8 +176,17 @@ service ProductService {
   // and
   // [ProductService.RemoveFulfillmentPlaces][google.cloud.retail.v2alpha.ProductService.RemoveFulfillmentPlaces].
   //
+  // The returned [Operation][google.longrunning.Operation]s is obsolete after
+  // one day, and the [GetOperation][google.longrunning.Operations.GetOperation]
+  // API returns `NOT_FOUND` afterwards.
+  //
+  // If conflicting updates are issued, the
+  // [Operation][google.longrunning.Operation]s associated with the stale
+  // updates are not marked as [done][google.longrunning.Operation.done] until
+  // they are obsolete.
+  //
   // This feature is only available for users who have Retail Search enabled.
-  // Please enable Retail Search on Cloud Console before using this feature.
+  // Enable Retail Search on Cloud Console before using this feature.
   rpc SetInventory(SetInventoryRequest) returns (google.longrunning.Operation) {
     option (google.api.http) = {
       post: "/v2alpha/{inventory.name=projects/*/locations/*/catalogs/*/branches/*/products/**}:setInventory"
@@ -203,8 +212,17 @@ service ProductService {
   // or
   // [ProductService.ListProducts][google.cloud.retail.v2alpha.ProductService.ListProducts].
   //
+  // The returned [Operation][google.longrunning.Operation]s will be obsolete
+  // after 1 day, and [GetOperation][google.longrunning.Operations.GetOperation]
+  // API will return NOT_FOUND afterwards.
+  //
+  // If conflicting updates are issued, the
+  // [Operation][google.longrunning.Operation]s associated with the stale
+  // updates will not be marked as [done][google.longrunning.Operation.done]
+  // until being obsolete.
+  //
   // This feature is only available for users who have Retail Search enabled.
-  // Please enable Retail Search on Cloud Console before using this feature.
+  // Enable Retail Search on Cloud Console before using this feature.
   rpc AddFulfillmentPlaces(AddFulfillmentPlacesRequest)
       returns (google.longrunning.Operation) {
     option (google.api.http) = {
@@ -231,8 +249,17 @@ service ProductService {
   // or
   // [ProductService.ListProducts][google.cloud.retail.v2alpha.ProductService.ListProducts].
   //
+  // The returned [Operation][google.longrunning.Operation]s will be obsolete
+  // after 1 day, and [GetOperation][google.longrunning.Operations.GetOperation]
+  // API will return NOT_FOUND afterwards.
+  //
+  // If conflicting updates are issued, the
+  // [Operation][google.longrunning.Operation]s associated with the stale
+  // updates will not be marked as [done][google.longrunning.Operation.done]
+  // until being obsolete.
+  //
   // This feature is only available for users who have Retail Search enabled.
-  // Please enable Retail Search on Cloud Console before using this feature.
+  // Enable Retail Search on Cloud Console before using this feature.
   rpc RemoveFulfillmentPlaces(RemoveFulfillmentPlacesRequest)
       returns (google.longrunning.Operation) {
     option (google.api.http) = {
@@ -266,8 +293,17 @@ service ProductService {
   // [ProductService.UpdateProduct][google.cloud.retail.v2alpha.ProductService.UpdateProduct]
   // has no effect on local inventories.
   //
+  // The returned [Operation][google.longrunning.Operation]s will be obsolete
+  // after 1 day, and [GetOperation][google.longrunning.Operations.GetOperation]
+  // API will return NOT_FOUND afterwards.
+  //
+  // If conflicting updates are issued, the
+  // [Operation][google.longrunning.Operation]s associated with the stale
+  // updates will not be marked as [done][google.longrunning.Operation.done]
+  // until being obsolete.
+  //
   // This feature is only available for users who have Retail Search enabled.
-  // Please enable Retail Search on Cloud Console before using this feature.
+  // Enable Retail Search on Cloud Console before using this feature.
   rpc AddLocalInventories(AddLocalInventoriesRequest)
       returns (google.longrunning.Operation) {
     option (google.api.http) = {
@@ -299,8 +335,17 @@ service ProductService {
   // [ProductService.UpdateProduct][google.cloud.retail.v2alpha.ProductService.UpdateProduct]
   // has no effect on local inventories.
   //
+  // The returned [Operation][google.longrunning.Operation]s will be obsolete
+  // after 1 day, and [GetOperation][google.longrunning.Operations.GetOperation]
+  // API will return NOT_FOUND afterwards.
+  //
+  // If conflicting updates are issued, the
+  // [Operation][google.longrunning.Operation]s associated with the stale
+  // updates will not be marked as [done][google.longrunning.Operation.done]
+  // until being obsolete.
+  //
   // This feature is only available for users who have Retail Search enabled.
-  // Please enable Retail Search on Cloud Console before using this feature.
+  // Enable Retail Search on Cloud Console before using this feature.
   rpc RemoveLocalInventories(RemoveLocalInventoriesRequest)
       returns (google.longrunning.Operation) {
     option (google.api.http) = {
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/proto/google/cloud/retail/v2alpha/search_service.proto b/java-retail/proto-google-cloud-retail-v2alpha/src/main/proto/google/cloud/retail/v2alpha/search_service.proto
index 24bfa34aacd7..37526c1f7530 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/proto/google/cloud/retail/v2alpha/search_service.proto
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/proto/google/cloud/retail/v2alpha/search_service.proto
@@ -37,7 +37,7 @@ option ruby_package = "Google::Cloud::Retail::V2alpha";
 // Service for search.
 //
 // This feature is only available for users who have Retail Search enabled.
-// Please enable Retail Search on Cloud Console before using this feature.
+// Enable Retail Search on Cloud Console before using this feature.
 service SearchService {
   option (google.api.default_host) = "retail.googleapis.com";
   option (google.api.oauth_scopes) =
@@ -46,7 +46,7 @@ service SearchService {
   // Performs a search.
   //
   // This feature is only available for users who have Retail Search enabled.
-  // Please enable Retail Search on Cloud Console before using this feature.
+  // Enable Retail Search on Cloud Console before using this feature.
   rpc Search(SearchRequest) returns (SearchResponse) {
     option (google.api.http) = {
       post: "/v2alpha/{placement=projects/*/locations/*/catalogs/*/placements/*}:search"
@@ -218,7 +218,7 @@ message SearchRequest {
     FacetKey facet_key = 1 [(google.api.field_behavior) = REQUIRED];
 
     // Maximum of facet values that should be returned for this facet. If
-    // unspecified, defaults to 20. The maximum allowed value is 300. Values
+    // unspecified, defaults to 50. The maximum allowed value is 300. Values
     // above 300 will be coerced to 300.
     //
     // If this field is negative, an INVALID_ARGUMENT is returned.
@@ -396,7 +396,8 @@ message SearchRequest {
       // [Mode.AUTO][google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpec.Mode.AUTO].
       MODE_UNSPECIFIED = 0;
 
-      // Let CRS decide whether to use personalization.
+      // Let CRS decide whether to use personalization based on quality of user
+      // event data.
       AUTO = 1;
 
       // Disable personalization.
@@ -458,15 +459,21 @@ message SearchRequest {
   // The search mode of each search request.
   enum SearchMode {
     // Default value. In this case both product search and faceted search will
-    // be performed. Both [SearchResponse.SearchResult] and
-    // [SearchResponse.Facet] will be returned.
+    // be performed. Both
+    // [SearchResponse.SearchResult][google.cloud.retail.v2alpha.SearchResponse.SearchResult]
+    // and
+    // [SearchResponse.Facet][google.cloud.retail.v2alpha.SearchResponse.Facet]
+    // will be returned.
     SEARCH_MODE_UNSPECIFIED = 0;
 
     // Only product search will be performed. The faceted search will be
     // disabled.
     //
-    // Only [SearchResponse.SearchResult] will be returned.
-    // [SearchResponse.Facet] will not be returned, even if
+    // Only
+    // [SearchResponse.SearchResult][google.cloud.retail.v2alpha.SearchResponse.SearchResult]
+    // will be returned.
+    // [SearchResponse.Facet][google.cloud.retail.v2alpha.SearchResponse.Facet]
+    // will not be returned, even if
     // [SearchRequest.facet_specs][google.cloud.retail.v2alpha.SearchRequest.facet_specs]
     // or
     // [SearchRequest.dynamic_facet_spec][google.cloud.retail.v2alpha.SearchRequest.dynamic_facet_spec]
@@ -481,7 +488,9 @@ message SearchRequest {
     // and
     // [SearchRequest.dynamic_facet_spec][google.cloud.retail.v2alpha.SearchRequest.dynamic_facet_spec]
     // should be set. Otherwise, an INVALID_ARGUMENT error is returned. Only
-    // [SearchResponse.Facet] will be returned. [SearchResponse.SearchResult]
+    // [SearchResponse.Facet][google.cloud.retail.v2alpha.SearchResponse.Facet]
+    // will be returned.
+    // [SearchResponse.SearchResult][google.cloud.retail.v2alpha.SearchResponse.SearchResult]
     // will not be returned.
     FACETED_SEARCH_ONLY = 2;
   }
@@ -490,7 +499,7 @@ message SearchRequest {
   // `projects/*/locations/global/catalogs/default_catalog/servingConfigs/default_serving_config`
   // or the name of the legacy placement resource, such as
   // `projects/*/locations/global/catalogs/default_catalog/placements/default_search`.
-  // This field is used to identify the serving configuration name and the set
+  // This field is used to identify the serving config name and the set
   // of models that will be used to make the search.
   string placement = 1 [(google.api.field_behavior) = REQUIRED];
 
@@ -713,7 +722,7 @@ message SearchRequest {
   // [UserEvent.page_categories][google.cloud.retail.v2alpha.UserEvent.page_categories];
   //
   // To represent full path of category, use '>' sign to separate different
-  // hierarchies. If '>' is part of the category name, please replace it with
+  // hierarchies. If '>' is part of the category name, replace it with
   // other character(s).
   //
   // Category pages include special pages such as sales or promotions. For
@@ -726,6 +735,15 @@ message SearchRequest {
   SearchMode search_mode = 31;
 
   // The specification for personalization.
+  //
+  // Notice that if both
+  // [ServingConfig.personalization_spec][google.cloud.retail.v2alpha.ServingConfig.personalization_spec]
+  // and
+  // [SearchRequest.personalization_spec][google.cloud.retail.v2alpha.SearchRequest.personalization_spec]
+  // are set.
+  // [SearchRequest.personalization_spec][google.cloud.retail.v2alpha.SearchRequest.personalization_spec]
+  // will override
+  // [ServingConfig.personalization_spec][google.cloud.retail.v2alpha.ServingConfig.personalization_spec].
   PersonalizationSpec personalization_spec = 32;
 
   // The labels applied to a resource must meet the following requirements:
@@ -829,6 +847,21 @@ message SearchResponse {
     // `{key: "pickupInStore.store1" value { number_value: 10 }}` means a there
     // are 10 variants in this product are available in the store "store1".
     map variant_rollup_values = 5;
+
+    // Specifies previous events related to this product for this user based on
+    // [UserEvent][google.cloud.retail.v2alpha.UserEvent] with same
+    // [SearchRequest.visitor_id][google.cloud.retail.v2alpha.SearchRequest.visitor_id]
+    // or [UserInfo.user_id][google.cloud.retail.v2alpha.UserInfo.user_id].
+    //
+    // This is set only when
+    // [SearchRequest.PersonalizationSpec.mode][google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpec.mode]
+    // is
+    // [SearchRequest.PersonalizationSpec.Mode.AUTO][google.cloud.retail.v2alpha.SearchRequest.PersonalizationSpec.Mode.AUTO].
+    //
+    // Possible values:
+    //
+    // * `purchased`: Indicates that this product has been purchased before.
+    repeated string personal_labels = 7;
   }
 
   // A facet result.
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/proto/google/cloud/retail/v2alpha/serving_config.proto b/java-retail/proto-google-cloud-retail-v2alpha/src/main/proto/google/cloud/retail/v2alpha/serving_config.proto
index d0524012454e..d4d02c70c47e 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/proto/google/cloud/retail/v2alpha/serving_config.proto
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/proto/google/cloud/retail/v2alpha/serving_config.proto
@@ -32,14 +32,25 @@ option ruby_package = "Google::Cloud::Retail::V2alpha";
 
 // Configures metadata that is used to generate serving time results (e.g.
 // search results or recommendation predictions).
-// The ServingConfig is passed in the search and predict request and together
-// with the Catalog.default_branch, generates results.
 message ServingConfig {
   option (google.api.resource) = {
     type: "retail.googleapis.com/ServingConfig"
     pattern: "projects/{project}/locations/{location}/catalogs/{catalog}/servingConfigs/{serving_config}"
   };
 
+  // What type of diversity - data or rule based.
+  // If none is specified, default to rule based.
+  enum DiversityType {
+    // Default value.
+    DIVERSITY_TYPE_UNSPECIFIED = 0;
+
+    // Rule based diversity.
+    RULE_BASED_DIVERSITY = 2;
+
+    // Data driven diversity.
+    DATA_DRIVEN_DIVERSITY = 3;
+  }
+
   // Immutable. Fully qualified name
   // `projects/*/locations/global/catalogs/*/servingConfig/*`
   string name = 1 [(google.api.field_behavior) = IMMUTABLE];
@@ -51,7 +62,8 @@ message ServingConfig {
   // characters. Otherwise, an INVALID_ARGUMENT error is returned.
   string display_name = 2 [(google.api.field_behavior) = REQUIRED];
 
-  // The id of the model to use at serving time.
+  // The id of the model in the same
+  // [Catalog][google.cloud.retail.v2alpha.Catalog] to use at serving time.
   // Currently only RecommendationModels are supported:
   // https://cloud.google.com/retail/recommendations-ai/docs/create-models
   // Can be changed but only to a compatible model (e.g.
@@ -70,13 +82,13 @@ message ServingConfig {
   // click-through and conversion rates.
   //  Allowed values are:
   //
-  // * 'no-price-reranking'
-  // * 'low-price-raranking'
-  // * 'medium-price-reranking'
-  // * 'high-price-reranking'
+  // * `no-price-reranking`
+  // * `low-price-raranking`
+  // * `medium-price-reranking`
+  // * `high-price-reranking`
   //
   // If not specified, we choose default based on model type. Default value:
-  // 'no-price-reranking'.
+  // `no-price-reranking`.
   //
   // Can only be set if
   // [solution_types][google.cloud.retail.v2alpha.ServingConfig.solution_types]
@@ -205,16 +217,16 @@ message ServingConfig {
   repeated string ignore_control_ids = 15;
 
   // How much diversity to use in recommendation model results e.g.
-  // 'medium-diversity' or 'high-diversity'. Currently supported values:
+  // `medium-diversity` or `high-diversity`. Currently supported values:
   //
-  // * 'no-diversity'
-  // * 'low-diversity'
-  // * 'medium-diversity'
-  // * 'high-diversity'
-  // * 'auto-diversity'
+  // * `no-diversity`
+  // * `low-diversity`
+  // * `medium-diversity`
+  // * `high-diversity`
+  // * `auto-diversity`
   //
   // If not specified, we choose default based on recommendation model
-  // type. Default value: 'no-diversity'.
+  // type. Default value: `no-diversity`.
   //
   // Can only be set if
   // [solution_types][google.cloud.retail.v2alpha.ServingConfig.solution_types]
@@ -222,13 +234,16 @@ message ServingConfig {
   // [SOLUTION_TYPE_RECOMMENDATION][google.cloud.retail.v2main.SolutionType.SOLUTION_TYPE_RECOMMENDATION].
   string diversity_level = 8;
 
-  // Whether to add additional category filters on the 'similar-items' model.
+  // What kind of diversity to use - data driven or rule based.
+  DiversityType diversity_type = 20;
+
+  // Whether to add additional category filters on the `similar-items` model.
   // If not specified, we enable it by default.
   //  Allowed values are:
   //
-  // * 'no-category-match': No additional filtering of original results from
+  // * `no-category-match`: No additional filtering of original results from
   //   the model and the customer's filters.
-  // * 'relaxed-category-match': Only keep results with categories that match
+  // * `relaxed-category-match`: Only keep results with categories that match
   //   at least one item categories in the PredictRequests's context item.
   //   * If customer also sends filters in the PredictRequest, then the results
   //   will satisfy both conditions (user given and category match).
@@ -239,6 +254,23 @@ message ServingConfig {
   // [SOLUTION_TYPE_RECOMMENDATION][google.cloud.retail.v2main.SolutionType.SOLUTION_TYPE_RECOMMENDATION].
   string enable_category_filter_level = 16;
 
+  // The specification for personalization spec.
+  //
+  // Can only be set if
+  // [solution_types][google.cloud.retail.v2alpha.ServingConfig.solution_types]
+  // is
+  // [SOLUTION_TYPE_SEARCH][google.cloud.retail.v2main.SolutionType.SOLUTION_TYPE_SEARCH].
+  //
+  // Notice that if both
+  // [ServingConfig.personalization_spec][google.cloud.retail.v2alpha.ServingConfig.personalization_spec]
+  // and
+  // [SearchRequest.personalization_spec][google.cloud.retail.v2alpha.SearchRequest.personalization_spec]
+  // are set.
+  // [SearchRequest.personalization_spec][google.cloud.retail.v2alpha.SearchRequest.personalization_spec]
+  // will override
+  // [ServingConfig.personalization_spec][google.cloud.retail.v2alpha.ServingConfig.personalization_spec].
+  SearchRequest.PersonalizationSpec personalization_spec = 21;
+
   // Required. Immutable. Specifies the solution types that a serving config can
   // be associated with. Currently we support setting only one type of solution.
   repeated SolutionType solution_types = 19 [
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/proto/google/cloud/retail/v2alpha/serving_config_service.proto b/java-retail/proto-google-cloud-retail-v2alpha/src/main/proto/google/cloud/retail/v2alpha/serving_config_service.proto
index 311126510e2a..387091079cc1 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/proto/google/cloud/retail/v2alpha/serving_config_service.proto
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/proto/google/cloud/retail/v2alpha/serving_config_service.proto
@@ -159,7 +159,7 @@ message UpdateServingConfigRequest {
 // Request for DeleteServingConfig method.
 message DeleteServingConfigRequest {
   // Required. The resource name of the ServingConfig to delete. Format:
-  // projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+  // `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
   string name = 1 [
     (google.api.field_behavior) = REQUIRED,
     (google.api.resource_reference) = {
@@ -171,7 +171,7 @@ message DeleteServingConfigRequest {
 // Request for GetServingConfig method.
 message GetServingConfigRequest {
   // Required. The resource name of the ServingConfig to get. Format:
-  // projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+  // `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
   string name = 1 [
     (google.api.field_behavior) = REQUIRED,
     (google.api.resource_reference) = {
@@ -183,7 +183,7 @@ message GetServingConfigRequest {
 // Request for ListServingConfigs method.
 message ListServingConfigsRequest {
   // Required. The catalog resource name. Format:
-  // projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}
+  // `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}`
   string parent = 1 [
     (google.api.field_behavior) = REQUIRED,
     (google.api.resource_reference) = { type: "retail.googleapis.com/Catalog" }
@@ -211,7 +211,7 @@ message ListServingConfigsResponse {
 // Request for AddControl method.
 message AddControlRequest {
   // Required. The source ServingConfig resource name . Format:
-  // projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+  // `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
   string serving_config = 1 [
     (google.api.field_behavior) = REQUIRED,
     (google.api.resource_reference) = {
@@ -227,7 +227,7 @@ message AddControlRequest {
 // Request for RemoveControl method.
 message RemoveControlRequest {
   // Required. The source ServingConfig resource name . Format:
-  // projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
+  // `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}`
   string serving_config = 1 [
     (google.api.field_behavior) = REQUIRED,
     (google.api.resource_reference) = {
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/proto/google/cloud/retail/v2alpha/user_event.proto b/java-retail/proto-google-cloud-retail-v2alpha/src/main/proto/google/cloud/retail/v2alpha/user_event.proto
index ca25f3003fed..6d24ca244879 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/proto/google/cloud/retail/v2alpha/user_event.proto
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/proto/google/cloud/retail/v2alpha/user_event.proto
@@ -229,7 +229,7 @@ message UserEvent {
   // The categories associated with a category page.
   //
   // To represent full path of category, use '>' sign to separate different
-  // hierarchies. If '>' is part of the category name, please replace it with
+  // hierarchies. If '>' is part of the category name, replace it with
   // other character(s).
   //
   // Category pages include special pages such as sales or promotions. For
diff --git a/java-retail/proto-google-cloud-retail-v2alpha/src/main/proto/google/cloud/retail/v2alpha/user_event_service.proto b/java-retail/proto-google-cloud-retail-v2alpha/src/main/proto/google/cloud/retail/v2alpha/user_event_service.proto
index 35fe33f4bae0..5e0702bca510 100644
--- a/java-retail/proto-google-cloud-retail-v2alpha/src/main/proto/google/cloud/retail/v2alpha/user_event_service.proto
+++ b/java-retail/proto-google-cloud-retail-v2alpha/src/main/proto/google/cloud/retail/v2alpha/user_event_service.proto
@@ -20,6 +20,7 @@ import "google/api/annotations.proto";
 import "google/api/client.proto";
 import "google/api/field_behavior.proto";
 import "google/api/httpbody.proto";
+import "google/api/resource.proto";
 import "google/cloud/retail/v2alpha/import_config.proto";
 import "google/cloud/retail/v2alpha/purge_config.proto";
 import "google/cloud/retail/v2alpha/user_event.proto";
@@ -79,9 +80,9 @@ service UserEventService {
   // synchronous. Events that already exist are skipped.
   // Use this method for backfilling historical user events.
   //
-  // Operation.response is of type ImportResponse. Note that it is
+  // `Operation.response` is of type `ImportResponse`. Note that it is
   // possible for a subset of the items to be successfully inserted.
-  // Operation.metadata is of type ImportMetadata.
+  // `Operation.metadata` is of type `ImportMetadata`.
   rpc ImportUserEvents(ImportUserEventsRequest)
       returns (google.longrunning.Operation) {
     option (google.api.http) = {
@@ -94,14 +95,14 @@ service UserEventService {
     };
   }
 
-  // Starts a user event rejoin operation with latest product catalog. Events
-  // will not be annotated with detailed product information if product is
-  // missing from the catalog at the time the user event is ingested, and these
-  // events are stored as unjoined events with a limited usage on training and
-  // serving. This method can be used to start a join operation on specified
-  // events with latest version of product catalog. It can also be used to
-  // correct events joined with the wrong product catalog. A rejoin operation
-  // can take hours or days to complete.
+  // Starts a user-event rejoin operation with latest product catalog. Events
+  // are not annotated with detailed product information for products that are
+  // missing from the catalog when the user event is ingested. These
+  // events are stored as unjoined events with limited usage on training and
+  // serving. You can use this method to start a join operation on specified
+  // events with the latest version of product catalog. You can also use this
+  // method to correct events joined with the wrong product catalog. A rejoin
+  // operation can take hours or days to complete.
   rpc RejoinUserEvents(RejoinUserEventsRequest)
       returns (google.longrunning.Operation) {
     option (google.api.http) = {
@@ -123,10 +124,24 @@ message WriteUserEventRequest {
 
   // Required. User event to write.
   UserEvent user_event = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // If set to true, the user event will be written asynchronously after
+  // validation, and the API will respond without waiting for the write.
+  // Therefore, silent failures can occur even if the API returns success. In
+  // case of silent failures, error messages can be found in Stackdriver logs.
+  bool write_async = 3;
 }
 
 // Request message for CollectUserEvent method.
 message CollectUserEventRequest {
+  // The rule that can convert the raw_json to a user event. It is needed
+  // only when the raw_json is set.
+  oneof conversion_rule {
+    // The prebuilt rule name that can convert a specific type of raw_json.
+    // For example: "default_schema/v1.0"
+    string prebuilt_rule = 6;
+  }
+
   // Required. The parent catalog name, such as
   // `projects/1234/locations/global/catalogs/default_catalog`.
   string parent = 1 [(google.api.field_behavior) = REQUIRED];
@@ -145,17 +160,23 @@ message CollectUserEventRequest {
   // otherwise identical get requests. The name is abbreviated to reduce the
   // payload bytes.
   int64 ets = 4;
+
+  // An arbitrary serialized JSON string that contains necessary information
+  // that can comprise a user event. When this field is specified, the
+  // user_event field will be ignored. Note: line-delimited JSON is not
+  // supported, a single JSON only.
+  string raw_json = 5;
 }
 
 // Request message for RejoinUserEvents method.
 message RejoinUserEventsRequest {
   // The scope of user events to be rejoined with the latest product catalog.
   // If the rejoining aims at reducing number of unjoined events, set
-  // UserEventRejoinScope to UNJOINED_EVENTS.
+  // `UserEventRejoinScope` to `UNJOINED_EVENTS`.
   // If the rejoining aims at correcting product catalog information in joined
-  // events, set UserEventRejoinScope to JOINED_EVENTS.
-  // If all events needs to be rejoined, set UserEventRejoinScope to
-  // USER_EVENT_REJOIN_SCOPE_UNSPECIFIED.
+  // events, set `UserEventRejoinScope` to `JOINED_EVENTS`.
+  // If all events needs to be rejoined, set `UserEventRejoinScope` to
+  // `USER_EVENT_REJOIN_SCOPE_UNSPECIFIED`.
   enum UserEventRejoinScope {
     // Rejoin all events with the latest product catalog, including both joined
     // events and unjoined events.
@@ -174,16 +195,16 @@ message RejoinUserEventsRequest {
 
   // The type of the user event rejoin to define the scope and range of the user
   // events to be rejoined with the latest product catalog. Defaults to
-  // USER_EVENT_REJOIN_SCOPE_UNSPECIFIED if this field is not set, or set to an
-  // invalid integer value.
+  // `USER_EVENT_REJOIN_SCOPE_UNSPECIFIED` if this field is not set, or set to
+  // an invalid integer value.
   UserEventRejoinScope user_event_rejoin_scope = 2;
 }
 
-// Response message for RejoinUserEvents method.
+// Response message for `RejoinUserEvents` method.
 message RejoinUserEventsResponse {
   // Number of user events that were joined with latest product catalog.
   int64 rejoined_user_events_count = 1;
 }
 
-// Metadata for RejoinUserEvents method.
+// Metadata for `RejoinUserEvents` method.
 message RejoinUserEventsMetadata {}
diff --git a/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/BatchRemoveCatalogAttributesResponse.java b/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/BatchRemoveCatalogAttributesResponse.java
index b6c17dcb14d2..527317824251 100644
--- a/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/BatchRemoveCatalogAttributesResponse.java
+++ b/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/BatchRemoveCatalogAttributesResponse.java
@@ -77,8 +77,11 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    *
    *
    * 
      -   * Catalog attributes that were deleted. Only attributes that are not [in
-   * use][CatalogAttribute.in_use] by products can be deleted.
+   * Catalog attributes that were deleted. Only pre-loaded [catalog
+   * attributes][google.cloud.retail.v2beta.CatalogAttribute] that are
+   * neither [in
+   * use][google.cloud.retail.v2beta.CatalogAttribute.in_use] by
+   * products nor predefined can be deleted.
    * 
      
    *
    * repeated string deleted_catalog_attributes = 1;
@@ -92,8 +95,11 @@ public com.google.protobuf.ProtocolStringList getDeletedCatalogAttributesList()
    *
    *
    * 
      -   * Catalog attributes that were deleted. Only attributes that are not [in
-   * use][CatalogAttribute.in_use] by products can be deleted.
+   * Catalog attributes that were deleted. Only pre-loaded [catalog
+   * attributes][google.cloud.retail.v2beta.CatalogAttribute] that are
+   * neither [in
+   * use][google.cloud.retail.v2beta.CatalogAttribute.in_use] by
+   * products nor predefined can be deleted.
    * 
      
    *
    * repeated string deleted_catalog_attributes = 1;
@@ -107,8 +113,11 @@ public int getDeletedCatalogAttributesCount() {
    *
    *
    * 
      -   * Catalog attributes that were deleted. Only attributes that are not [in
-   * use][CatalogAttribute.in_use] by products can be deleted.
+   * Catalog attributes that were deleted. Only pre-loaded [catalog
+   * attributes][google.cloud.retail.v2beta.CatalogAttribute] that are
+   * neither [in
+   * use][google.cloud.retail.v2beta.CatalogAttribute.in_use] by
+   * products nor predefined can be deleted.
    * 
      
    *
    * repeated string deleted_catalog_attributes = 1;
@@ -123,8 +132,11 @@ public java.lang.String getDeletedCatalogAttributes(int index) {
    *
    *
    * 
      -   * Catalog attributes that were deleted. Only attributes that are not [in
-   * use][CatalogAttribute.in_use] by products can be deleted.
+   * Catalog attributes that were deleted. Only pre-loaded [catalog
+   * attributes][google.cloud.retail.v2beta.CatalogAttribute] that are
+   * neither [in
+   * use][google.cloud.retail.v2beta.CatalogAttribute.in_use] by
+   * products nor predefined can be deleted.
    * 
      
    *
    * repeated string deleted_catalog_attributes = 1;
@@ -142,9 +154,11 @@ public com.google.protobuf.ByteString getDeletedCatalogAttributesBytes(int index
    *
    *
    * 
      -   * Catalog attributes that were reset. Attributes that are [in
-   * use][CatalogAttribute.in_use] by products cannot be deleted, however their
-   * configuration properties will reset to default values upon removal request.
+   * Catalog attributes that were reset. [Catalog
+   * attributes][google.cloud.retail.v2beta.CatalogAttribute] that are either
+   * [in use][google.cloud.retail.v2beta.CatalogAttribute.in_use] by products or
+   * are predefined attributes cannot be deleted; however, their configuration
+   * properties will reset to default values upon removal request.
    * 
      
    *
    * repeated string reset_catalog_attributes = 2;
@@ -158,9 +172,11 @@ public com.google.protobuf.ProtocolStringList getResetCatalogAttributesList() {
    *
    *
    * 
      -   * Catalog attributes that were reset. Attributes that are [in
-   * use][CatalogAttribute.in_use] by products cannot be deleted, however their
-   * configuration properties will reset to default values upon removal request.
+   * Catalog attributes that were reset. [Catalog
+   * attributes][google.cloud.retail.v2beta.CatalogAttribute] that are either
+   * [in use][google.cloud.retail.v2beta.CatalogAttribute.in_use] by products or
+   * are predefined attributes cannot be deleted; however, their configuration
+   * properties will reset to default values upon removal request.
    * 
      
    *
    * repeated string reset_catalog_attributes = 2;
@@ -174,9 +190,11 @@ public int getResetCatalogAttributesCount() {
    *
    *
    * 
      -   * Catalog attributes that were reset. Attributes that are [in
-   * use][CatalogAttribute.in_use] by products cannot be deleted, however their
-   * configuration properties will reset to default values upon removal request.
+   * Catalog attributes that were reset. [Catalog
+   * attributes][google.cloud.retail.v2beta.CatalogAttribute] that are either
+   * [in use][google.cloud.retail.v2beta.CatalogAttribute.in_use] by products or
+   * are predefined attributes cannot be deleted; however, their configuration
+   * properties will reset to default values upon removal request.
    * 
      
    *
    * repeated string reset_catalog_attributes = 2;
@@ -191,9 +209,11 @@ public java.lang.String getResetCatalogAttributes(int index) {
    *
    *
    * 
      -   * Catalog attributes that were reset. Attributes that are [in
-   * use][CatalogAttribute.in_use] by products cannot be deleted, however their
-   * configuration properties will reset to default values upon removal request.
+   * Catalog attributes that were reset. [Catalog
+   * attributes][google.cloud.retail.v2beta.CatalogAttribute] that are either
+   * [in use][google.cloud.retail.v2beta.CatalogAttribute.in_use] by products or
+   * are predefined attributes cannot be deleted; however, their configuration
+   * properties will reset to default values upon removal request.
    * 
      
    *
    * repeated string reset_catalog_attributes = 2;
@@ -623,8 +643,11 @@ private void ensureDeletedCatalogAttributesIsMutable() {
      *
      *
      * 
      -     * Catalog attributes that were deleted. Only attributes that are not [in
-     * use][CatalogAttribute.in_use] by products can be deleted.
+     * Catalog attributes that were deleted. Only pre-loaded [catalog
+     * attributes][google.cloud.retail.v2beta.CatalogAttribute] that are
+     * neither [in
+     * use][google.cloud.retail.v2beta.CatalogAttribute.in_use] by
+     * products nor predefined can be deleted.
      * 
      
      *
      * repeated string deleted_catalog_attributes = 1;
@@ -638,8 +661,11 @@ public com.google.protobuf.ProtocolStringList getDeletedCatalogAttributesList()
      *
      *
      * 
      -     * Catalog attributes that were deleted. Only attributes that are not [in
-     * use][CatalogAttribute.in_use] by products can be deleted.
+     * Catalog attributes that were deleted. Only pre-loaded [catalog
+     * attributes][google.cloud.retail.v2beta.CatalogAttribute] that are
+     * neither [in
+     * use][google.cloud.retail.v2beta.CatalogAttribute.in_use] by
+     * products nor predefined can be deleted.
      * 
      
      *
      * repeated string deleted_catalog_attributes = 1;
@@ -653,8 +679,11 @@ public int getDeletedCatalogAttributesCount() {
      *
      *
      * 
      -     * Catalog attributes that were deleted. Only attributes that are not [in
-     * use][CatalogAttribute.in_use] by products can be deleted.
+     * Catalog attributes that were deleted. Only pre-loaded [catalog
+     * attributes][google.cloud.retail.v2beta.CatalogAttribute] that are
+     * neither [in
+     * use][google.cloud.retail.v2beta.CatalogAttribute.in_use] by
+     * products nor predefined can be deleted.
      * 
      
      *
      * repeated string deleted_catalog_attributes = 1;
@@ -669,8 +698,11 @@ public java.lang.String getDeletedCatalogAttributes(int index) {
      *
      *
      * 
      -     * Catalog attributes that were deleted. Only attributes that are not [in
-     * use][CatalogAttribute.in_use] by products can be deleted.
+     * Catalog attributes that were deleted. Only pre-loaded [catalog
+     * attributes][google.cloud.retail.v2beta.CatalogAttribute] that are
+     * neither [in
+     * use][google.cloud.retail.v2beta.CatalogAttribute.in_use] by
+     * products nor predefined can be deleted.
      * 
      
      *
      * repeated string deleted_catalog_attributes = 1;
@@ -685,8 +717,11 @@ public com.google.protobuf.ByteString getDeletedCatalogAttributesBytes(int index
      *
      *
      * 
      -     * Catalog attributes that were deleted. Only attributes that are not [in
-     * use][CatalogAttribute.in_use] by products can be deleted.
+     * Catalog attributes that were deleted. Only pre-loaded [catalog
+     * attributes][google.cloud.retail.v2beta.CatalogAttribute] that are
+     * neither [in
+     * use][google.cloud.retail.v2beta.CatalogAttribute.in_use] by
+     * products nor predefined can be deleted.
      * 
      
      *
      * repeated string deleted_catalog_attributes = 1;
@@ -708,8 +743,11 @@ public Builder setDeletedCatalogAttributes(int index, java.lang.String value) {
      *
      *
      * 
      -     * Catalog attributes that were deleted. Only attributes that are not [in
-     * use][CatalogAttribute.in_use] by products can be deleted.
+     * Catalog attributes that were deleted. Only pre-loaded [catalog
+     * attributes][google.cloud.retail.v2beta.CatalogAttribute] that are
+     * neither [in
+     * use][google.cloud.retail.v2beta.CatalogAttribute.in_use] by
+     * products nor predefined can be deleted.
      * 
      
      *
      * repeated string deleted_catalog_attributes = 1;
@@ -730,8 +768,11 @@ public Builder addDeletedCatalogAttributes(java.lang.String value) {
      *
      *
      * 
      -     * Catalog attributes that were deleted. Only attributes that are not [in
-     * use][CatalogAttribute.in_use] by products can be deleted.
+     * Catalog attributes that were deleted. Only pre-loaded [catalog
+     * attributes][google.cloud.retail.v2beta.CatalogAttribute] that are
+     * neither [in
+     * use][google.cloud.retail.v2beta.CatalogAttribute.in_use] by
+     * products nor predefined can be deleted.
      * 
      
      *
      * repeated string deleted_catalog_attributes = 1;
@@ -749,8 +790,11 @@ public Builder addAllDeletedCatalogAttributes(java.lang.Iterable
-     * Catalog attributes that were deleted. Only attributes that are not [in
-     * use][CatalogAttribute.in_use] by products can be deleted.
+     * Catalog attributes that were deleted. Only pre-loaded [catalog
+     * attributes][google.cloud.retail.v2beta.CatalogAttribute] that are
+     * neither [in
+     * use][google.cloud.retail.v2beta.CatalogAttribute.in_use] by
+     * products nor predefined can be deleted.
      * 
      
      *
      * repeated string deleted_catalog_attributes = 1;
@@ -767,8 +811,11 @@ public Builder clearDeletedCatalogAttributes() {
      *
      *
      * 
      -     * Catalog attributes that were deleted. Only attributes that are not [in
-     * use][CatalogAttribute.in_use] by products can be deleted.
+     * Catalog attributes that were deleted. Only pre-loaded [catalog
+     * attributes][google.cloud.retail.v2beta.CatalogAttribute] that are
+     * neither [in
+     * use][google.cloud.retail.v2beta.CatalogAttribute.in_use] by
+     * products nor predefined can be deleted.
      * 
      
      *
      * repeated string deleted_catalog_attributes = 1;
@@ -801,9 +848,11 @@ private void ensureResetCatalogAttributesIsMutable() {
      *
      *
      * 
      -     * Catalog attributes that were reset. Attributes that are [in
-     * use][CatalogAttribute.in_use] by products cannot be deleted, however their
-     * configuration properties will reset to default values upon removal request.
+     * Catalog attributes that were reset. [Catalog
+     * attributes][google.cloud.retail.v2beta.CatalogAttribute] that are either
+     * [in use][google.cloud.retail.v2beta.CatalogAttribute.in_use] by products or
+     * are predefined attributes cannot be deleted; however, their configuration
+     * properties will reset to default values upon removal request.
      * 
      
      *
      * repeated string reset_catalog_attributes = 2;
@@ -817,9 +866,11 @@ public com.google.protobuf.ProtocolStringList getResetCatalogAttributesList() {
      *
      *
      * 
      -     * Catalog attributes that were reset. Attributes that are [in
-     * use][CatalogAttribute.in_use] by products cannot be deleted, however their
-     * configuration properties will reset to default values upon removal request.
+     * Catalog attributes that were reset. [Catalog
+     * attributes][google.cloud.retail.v2beta.CatalogAttribute] that are either
+     * [in use][google.cloud.retail.v2beta.CatalogAttribute.in_use] by products or
+     * are predefined attributes cannot be deleted; however, their configuration
+     * properties will reset to default values upon removal request.
      * 
      
      *
      * repeated string reset_catalog_attributes = 2;
@@ -833,9 +884,11 @@ public int getResetCatalogAttributesCount() {
      *
      *
      * 
      -     * Catalog attributes that were reset. Attributes that are [in
-     * use][CatalogAttribute.in_use] by products cannot be deleted, however their
-     * configuration properties will reset to default values upon removal request.
+     * Catalog attributes that were reset. [Catalog
+     * attributes][google.cloud.retail.v2beta.CatalogAttribute] that are either
+     * [in use][google.cloud.retail.v2beta.CatalogAttribute.in_use] by products or
+     * are predefined attributes cannot be deleted; however, their configuration
+     * properties will reset to default values upon removal request.
      * 
      
      *
      * repeated string reset_catalog_attributes = 2;
@@ -850,9 +903,11 @@ public java.lang.String getResetCatalogAttributes(int index) {
      *
      *
      * 
      -     * Catalog attributes that were reset. Attributes that are [in
-     * use][CatalogAttribute.in_use] by products cannot be deleted, however their
-     * configuration properties will reset to default values upon removal request.
+     * Catalog attributes that were reset. [Catalog
+     * attributes][google.cloud.retail.v2beta.CatalogAttribute] that are either
+     * [in use][google.cloud.retail.v2beta.CatalogAttribute.in_use] by products or
+     * are predefined attributes cannot be deleted; however, their configuration
+     * properties will reset to default values upon removal request.
      * 
      
      *
      * repeated string reset_catalog_attributes = 2;
@@ -867,9 +922,11 @@ public com.google.protobuf.ByteString getResetCatalogAttributesBytes(int index)
      *
      *
      * 
      -     * Catalog attributes that were reset. Attributes that are [in
-     * use][CatalogAttribute.in_use] by products cannot be deleted, however their
-     * configuration properties will reset to default values upon removal request.
+     * Catalog attributes that were reset. [Catalog
+     * attributes][google.cloud.retail.v2beta.CatalogAttribute] that are either
+     * [in use][google.cloud.retail.v2beta.CatalogAttribute.in_use] by products or
+     * are predefined attributes cannot be deleted; however, their configuration
+     * properties will reset to default values upon removal request.
      * 
      
      *
      * repeated string reset_catalog_attributes = 2;
@@ -891,9 +948,11 @@ public Builder setResetCatalogAttributes(int index, java.lang.String value) {
      *
      *
      * 
      -     * Catalog attributes that were reset. Attributes that are [in
-     * use][CatalogAttribute.in_use] by products cannot be deleted, however their
-     * configuration properties will reset to default values upon removal request.
+     * Catalog attributes that were reset. [Catalog
+     * attributes][google.cloud.retail.v2beta.CatalogAttribute] that are either
+     * [in use][google.cloud.retail.v2beta.CatalogAttribute.in_use] by products or
+     * are predefined attributes cannot be deleted; however, their configuration
+     * properties will reset to default values upon removal request.
      * 
      
      *
      * repeated string reset_catalog_attributes = 2;
@@ -914,9 +973,11 @@ public Builder addResetCatalogAttributes(java.lang.String value) {
      *
      *
      * 
      -     * Catalog attributes that were reset. Attributes that are [in
-     * use][CatalogAttribute.in_use] by products cannot be deleted, however their
-     * configuration properties will reset to default values upon removal request.
+     * Catalog attributes that were reset. [Catalog
+     * attributes][google.cloud.retail.v2beta.CatalogAttribute] that are either
+     * [in use][google.cloud.retail.v2beta.CatalogAttribute.in_use] by products or
+     * are predefined attributes cannot be deleted; however, their configuration
+     * properties will reset to default values upon removal request.
      * 
      
      *
      * repeated string reset_catalog_attributes = 2;
@@ -934,9 +995,11 @@ public Builder addAllResetCatalogAttributes(java.lang.Iterable
      *
      *
      * 
      -     * Catalog attributes that were reset. Attributes that are [in
-     * use][CatalogAttribute.in_use] by products cannot be deleted, however their
-     * configuration properties will reset to default values upon removal request.
+     * Catalog attributes that were reset. [Catalog
+     * attributes][google.cloud.retail.v2beta.CatalogAttribute] that are either
+     * [in use][google.cloud.retail.v2beta.CatalogAttribute.in_use] by products or
+     * are predefined attributes cannot be deleted; however, their configuration
+     * properties will reset to default values upon removal request.
      * 
      
      *
      * repeated string reset_catalog_attributes = 2;
@@ -953,9 +1016,11 @@ public Builder clearResetCatalogAttributes() {
      *
      *
      * 
      -     * Catalog attributes that were reset. Attributes that are [in
-     * use][CatalogAttribute.in_use] by products cannot be deleted, however their
-     * configuration properties will reset to default values upon removal request.
+     * Catalog attributes that were reset. [Catalog
+     * attributes][google.cloud.retail.v2beta.CatalogAttribute] that are either
+     * [in use][google.cloud.retail.v2beta.CatalogAttribute.in_use] by products or
+     * are predefined attributes cannot be deleted; however, their configuration
+     * properties will reset to default values upon removal request.
      * 
      
      *
      * repeated string reset_catalog_attributes = 2;
diff --git a/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/BatchRemoveCatalogAttributesResponseOrBuilder.java b/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/BatchRemoveCatalogAttributesResponseOrBuilder.java
index 4e42b8983d53..b64e40aacae4 100644
--- a/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/BatchRemoveCatalogAttributesResponseOrBuilder.java
+++ b/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/BatchRemoveCatalogAttributesResponseOrBuilder.java
@@ -27,8 +27,11 @@ public interface BatchRemoveCatalogAttributesResponseOrBuilder
    *
    *
    * 
      -   * Catalog attributes that were deleted. Only attributes that are not [in
-   * use][CatalogAttribute.in_use] by products can be deleted.
+   * Catalog attributes that were deleted. Only pre-loaded [catalog
+   * attributes][google.cloud.retail.v2beta.CatalogAttribute] that are
+   * neither [in
+   * use][google.cloud.retail.v2beta.CatalogAttribute.in_use] by
+   * products nor predefined can be deleted.
    * 
      
    *
    * repeated string deleted_catalog_attributes = 1;
@@ -40,8 +43,11 @@ public interface BatchRemoveCatalogAttributesResponseOrBuilder
    *
    *
    * 
      -   * Catalog attributes that were deleted. Only attributes that are not [in
-   * use][CatalogAttribute.in_use] by products can be deleted.
+   * Catalog attributes that were deleted. Only pre-loaded [catalog
+   * attributes][google.cloud.retail.v2beta.CatalogAttribute] that are
+   * neither [in
+   * use][google.cloud.retail.v2beta.CatalogAttribute.in_use] by
+   * products nor predefined can be deleted.
    * 
      
    *
    * repeated string deleted_catalog_attributes = 1;
@@ -53,8 +59,11 @@ public interface BatchRemoveCatalogAttributesResponseOrBuilder
    *
    *
    * 
      -   * Catalog attributes that were deleted. Only attributes that are not [in
-   * use][CatalogAttribute.in_use] by products can be deleted.
+   * Catalog attributes that were deleted. Only pre-loaded [catalog
+   * attributes][google.cloud.retail.v2beta.CatalogAttribute] that are
+   * neither [in
+   * use][google.cloud.retail.v2beta.CatalogAttribute.in_use] by
+   * products nor predefined can be deleted.
    * 
      
    *
    * repeated string deleted_catalog_attributes = 1;
@@ -67,8 +76,11 @@ public interface BatchRemoveCatalogAttributesResponseOrBuilder
    *
    *
    * 
      -   * Catalog attributes that were deleted. Only attributes that are not [in
-   * use][CatalogAttribute.in_use] by products can be deleted.
+   * Catalog attributes that were deleted. Only pre-loaded [catalog
+   * attributes][google.cloud.retail.v2beta.CatalogAttribute] that are
+   * neither [in
+   * use][google.cloud.retail.v2beta.CatalogAttribute.in_use] by
+   * products nor predefined can be deleted.
    * 
      
    *
    * repeated string deleted_catalog_attributes = 1;
@@ -82,9 +94,11 @@ public interface BatchRemoveCatalogAttributesResponseOrBuilder
    *
    *
    * 
      -   * Catalog attributes that were reset. Attributes that are [in
-   * use][CatalogAttribute.in_use] by products cannot be deleted, however their
-   * configuration properties will reset to default values upon removal request.
+   * Catalog attributes that were reset. [Catalog
+   * attributes][google.cloud.retail.v2beta.CatalogAttribute] that are either
+   * [in use][google.cloud.retail.v2beta.CatalogAttribute.in_use] by products or
+   * are predefined attributes cannot be deleted; however, their configuration
+   * properties will reset to default values upon removal request.
    * 
      
    *
    * repeated string reset_catalog_attributes = 2;
@@ -96,9 +110,11 @@ public interface BatchRemoveCatalogAttributesResponseOrBuilder
    *
    *
    * 
      -   * Catalog attributes that were reset. Attributes that are [in
-   * use][CatalogAttribute.in_use] by products cannot be deleted, however their
-   * configuration properties will reset to default values upon removal request.
+   * Catalog attributes that were reset. [Catalog
+   * attributes][google.cloud.retail.v2beta.CatalogAttribute] that are either
+   * [in use][google.cloud.retail.v2beta.CatalogAttribute.in_use] by products or
+   * are predefined attributes cannot be deleted; however, their configuration
+   * properties will reset to default values upon removal request.
    * 
      
    *
    * repeated string reset_catalog_attributes = 2;
@@ -110,9 +126,11 @@ public interface BatchRemoveCatalogAttributesResponseOrBuilder
    *
    *
    * 
      -   * Catalog attributes that were reset. Attributes that are [in
-   * use][CatalogAttribute.in_use] by products cannot be deleted, however their
-   * configuration properties will reset to default values upon removal request.
+   * Catalog attributes that were reset. [Catalog
+   * attributes][google.cloud.retail.v2beta.CatalogAttribute] that are either
+   * [in use][google.cloud.retail.v2beta.CatalogAttribute.in_use] by products or
+   * are predefined attributes cannot be deleted; however, their configuration
+   * properties will reset to default values upon removal request.
    * 
      
    *
    * repeated string reset_catalog_attributes = 2;
@@ -125,9 +143,11 @@ public interface BatchRemoveCatalogAttributesResponseOrBuilder
    *
    *
    * 
      -   * Catalog attributes that were reset. Attributes that are [in
-   * use][CatalogAttribute.in_use] by products cannot be deleted, however their
-   * configuration properties will reset to default values upon removal request.
+   * Catalog attributes that were reset. [Catalog
+   * attributes][google.cloud.retail.v2beta.CatalogAttribute] that are either
+   * [in use][google.cloud.retail.v2beta.CatalogAttribute.in_use] by products or
+   * are predefined attributes cannot be deleted; however, their configuration
+   * properties will reset to default values upon removal request.
    * 
      
    *
    * repeated string reset_catalog_attributes = 2;
diff --git a/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/CatalogAttribute.java b/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/CatalogAttribute.java
index a38847b595f8..db33ad7060b7 100644
--- a/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/CatalogAttribute.java
+++ b/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/CatalogAttribute.java
@@ -46,6 +46,7 @@ private CatalogAttribute() {
     searchableOption_ = 0;
     recommendationsFilteringOption_ = 0;
     exactSearchableOption_ = 0;
+    retrievableOption_ = 0;
   }
 
   @java.lang.Override
@@ -249,8 +250,7 @@ public enum IndexableOption implements com.google.protobuf.ProtocolMessageEnum {
      *
      *
      * 
      -     * Value used when unset. Defaults to
-     * [INDEXABLE_ENABLED][google.cloud.retail.v2beta.CatalogAttribute.IndexableOption.INDEXABLE_ENABLED].
+     * Value used when unset.
      * 
      
      *
      * INDEXABLE_OPTION_UNSPECIFIED = 0;
@@ -283,8 +283,7 @@ public enum IndexableOption implements com.google.protobuf.ProtocolMessageEnum {
      *
      *
      * 
      -     * Value used when unset. Defaults to
-     * [INDEXABLE_ENABLED][google.cloud.retail.v2beta.CatalogAttribute.IndexableOption.INDEXABLE_ENABLED].
+     * Value used when unset.
      * 
      
      *
      * INDEXABLE_OPTION_UNSPECIFIED = 0;
@@ -410,8 +409,7 @@ public enum DynamicFacetableOption implements com.google.protobuf.ProtocolMessag
      *
      *
      * 
      -     * Value used when unset. Defaults to
-     * [DYNAMIC_FACETABLE_ENABLED][google.cloud.retail.v2beta.CatalogAttribute.DynamicFacetableOption.DYNAMIC_FACETABLE_ENABLED].
+     * Value used when unset.
      * 
      
      *
      * DYNAMIC_FACETABLE_OPTION_UNSPECIFIED = 0;
@@ -444,8 +442,7 @@ public enum DynamicFacetableOption implements com.google.protobuf.ProtocolMessag
      *
      *
      * 
      -     * Value used when unset. Defaults to
-     * [DYNAMIC_FACETABLE_ENABLED][google.cloud.retail.v2beta.CatalogAttribute.DynamicFacetableOption.DYNAMIC_FACETABLE_ENABLED].
+     * Value used when unset.
      * 
      
      *
      * DYNAMIC_FACETABLE_OPTION_UNSPECIFIED = 0;
@@ -572,8 +569,7 @@ public enum SearchableOption implements com.google.protobuf.ProtocolMessageEnum
      *
      *
      * 
      -     * Value used when unset. Defaults to
-     * [SEARCHABLE_DISABLED][google.cloud.retail.v2beta.CatalogAttribute.SearchableOption.SEARCHABLE_DISABLED].
+     * Value used when unset.
      * 
      
      *
      * SEARCHABLE_OPTION_UNSPECIFIED = 0;
@@ -606,8 +602,7 @@ public enum SearchableOption implements com.google.protobuf.ProtocolMessageEnum
      *
      *
      * 
      -     * Value used when unset. Defaults to
-     * [SEARCHABLE_DISABLED][google.cloud.retail.v2beta.CatalogAttribute.SearchableOption.SEARCHABLE_DISABLED].
+     * Value used when unset.
      * 
      
      *
      * SEARCHABLE_OPTION_UNSPECIFIED = 0;
@@ -881,6 +876,168 @@ private ExactSearchableOption(int value) {
     // @@protoc_insertion_point(enum_scope:google.cloud.retail.v2beta.CatalogAttribute.ExactSearchableOption)
   }
 
+  /**
+   *
+   *
+   * 
      +   * The status of the retrievable option of a catalog attribute.
+   * 
      
+   *
+   * Protobuf enum {@code google.cloud.retail.v2beta.CatalogAttribute.RetrievableOption}
+   */
+  public enum RetrievableOption implements com.google.protobuf.ProtocolMessageEnum {
+    /**
+     *
+     *
+     * 
      +     * Value used when unset. Defaults to
+     * [RETRIEVABLE_DISABLED][google.cloud.retail.v2beta.CatalogAttribute.RetrievableOption.RETRIEVABLE_DISABLED].
+     * 
      
+     *
+     * RETRIEVABLE_OPTION_UNSPECIFIED = 0;
+     */
+    RETRIEVABLE_OPTION_UNSPECIFIED(0),
+    /**
+     *
+     *
+     * 
      +     * Retrievable option enabled for an attribute.
+     * 
      
+     *
+     * RETRIEVABLE_ENABLED = 1;
+     */
+    RETRIEVABLE_ENABLED(1),
+    /**
+     *
+     *
+     * 
      +     * Retrievable option disabled for an attribute.
+     * 
      
+     *
+     * RETRIEVABLE_DISABLED = 2;
+     */
+    RETRIEVABLE_DISABLED(2),
+    UNRECOGNIZED(-1),
+    ;
+
+    /**
+     *
+     *
+     * 
      +     * Value used when unset. Defaults to
+     * [RETRIEVABLE_DISABLED][google.cloud.retail.v2beta.CatalogAttribute.RetrievableOption.RETRIEVABLE_DISABLED].
+     * 
      
+     *
+     * RETRIEVABLE_OPTION_UNSPECIFIED = 0;
+     */
+    public static final int RETRIEVABLE_OPTION_UNSPECIFIED_VALUE = 0;
+    /**
+     *
+     *
+     * 
      +     * Retrievable option enabled for an attribute.
+     * 
      
+     *
+     * RETRIEVABLE_ENABLED = 1;
+     */
+    public static final int RETRIEVABLE_ENABLED_VALUE = 1;
+    /**
+     *
+     *
+     * 
      +     * Retrievable option disabled for an attribute.
+     * 
      
+     *
+     * RETRIEVABLE_DISABLED = 2;
+     */
+    public static final int RETRIEVABLE_DISABLED_VALUE = 2;
+
+    public final int getNumber() {
+      if (this == UNRECOGNIZED) {
+        throw new java.lang.IllegalArgumentException(
+            "Can't get the number of an unknown enum value.");
+      }
+      return value;
+    }
+
+    /**
+     * @param value The numeric wire value of the corresponding enum entry.
+     * @return The enum associated with the given numeric wire value.
+     * @deprecated Use {@link #forNumber(int)} instead.
+     */
+    @java.lang.Deprecated
+    public static RetrievableOption valueOf(int value) {
+      return forNumber(value);
+    }
+
+    /**
+     * @param value The numeric wire value of the corresponding enum entry.
+     * @return The enum associated with the given numeric wire value.
+     */
+    public static RetrievableOption forNumber(int value) {
+      switch (value) {
+        case 0:
+          return RETRIEVABLE_OPTION_UNSPECIFIED;
+        case 1:
+          return RETRIEVABLE_ENABLED;
+        case 2:
+          return RETRIEVABLE_DISABLED;
+        default:
+          return null;
+      }
+    }
+
+    public static com.google.protobuf.Internal.EnumLiteMap
+        internalGetValueMap() {
+      return internalValueMap;
+    }
+
+    private static final com.google.protobuf.Internal.EnumLiteMap
+        internalValueMap =
+            new com.google.protobuf.Internal.EnumLiteMap() {
+              public RetrievableOption findValueByNumber(int number) {
+                return RetrievableOption.forNumber(number);
+              }
+            };
+
+    public final com.google.protobuf.Descriptors.EnumValueDescriptor getValueDescriptor() {
+      if (this == UNRECOGNIZED) {
+        throw new java.lang.IllegalStateException(
+            "Can't get the descriptor of an unrecognized enum value.");
+      }
+      return getDescriptor().getValues().get(ordinal());
+    }
+
+    public final com.google.protobuf.Descriptors.EnumDescriptor getDescriptorForType() {
+      return getDescriptor();
+    }
+
+    public static final com.google.protobuf.Descriptors.EnumDescriptor getDescriptor() {
+      return com.google.cloud.retail.v2beta.CatalogAttribute.getDescriptor().getEnumTypes().get(5);
+    }
+
+    private static final RetrievableOption[] VALUES = values();
+
+    public static RetrievableOption valueOf(
+        com.google.protobuf.Descriptors.EnumValueDescriptor desc) {
+      if (desc.getType() != getDescriptor()) {
+        throw new java.lang.IllegalArgumentException("EnumValueDescriptor is not for this type.");
+      }
+      if (desc.getIndex() == -1) {
+        return UNRECOGNIZED;
+      }
+      return VALUES[desc.getIndex()];
+    }
+
+    private final int value;
+
+    private RetrievableOption(int value) {
+      this.value = value;
+    }
+
+    // @@protoc_insertion_point(enum_scope:google.cloud.retail.v2beta.CatalogAttribute.RetrievableOption)
+  }
+
   public static final int KEY_FIELD_NUMBER = 1;
   private volatile java.lang.Object key_;
   /**
@@ -960,13 +1117,13 @@ public com.google.protobuf.ByteString getKeyBytes() {
    * [CatalogService.UpdateAttributesConfig][google.cloud.retail.v2beta.CatalogService.UpdateAttributesConfig]
    * APIs. This field is `False` for pre-loaded
    * [CatalogAttribute][google.cloud.retail.v2beta.CatalogAttribute]s.
-   * Only pre-loaded
-   * [CatalogAttribute][google.cloud.retail.v2beta.CatalogAttribute]s that are
-   * neither in use by products nor predefined can be deleted.
-   * [CatalogAttribute][google.cloud.retail.v2beta.CatalogAttribute]s that are
-   * either in use by products or are predefined cannot be deleted; however,
-   * their configuration properties will reset to default values upon removal
-   * request.
+   * Only pre-loaded [catalog
+   * attributes][google.cloud.retail.v2beta.CatalogAttribute] that are neither
+   * in use by products nor predefined can be deleted. [Catalog
+   * attributes][google.cloud.retail.v2beta.CatalogAttribute] that are
+   * either in use by products or are predefined attributes cannot be deleted;
+   * however, their configuration properties will reset to default values upon
+   * removal request.
    * After catalog changes, it takes about 10 minutes for this field to update.
    * 
      
    *
@@ -1034,6 +1191,7 @@ public com.google.cloud.retail.v2beta.CatalogAttribute.AttributeType getType() {
    * is CATALOG_LEVEL_ATTRIBUTE_CONFIG, if INDEXABLE_ENABLED attribute values
    * are indexed so that it can be filtered, faceted, or boosted in
    * [SearchService.Search][google.cloud.retail.v2beta.SearchService.Search].
+   * Must be specified, otherwise throws INVALID_FORMAT error.
    * 
      
    *
    * .google.cloud.retail.v2beta.CatalogAttribute.IndexableOption indexable_option = 5;
@@ -1053,6 +1211,7 @@ public int getIndexableOptionValue() {
    * is CATALOG_LEVEL_ATTRIBUTE_CONFIG, if INDEXABLE_ENABLED attribute values
    * are indexed so that it can be filtered, faceted, or boosted in
    * [SearchService.Search][google.cloud.retail.v2beta.SearchService.Search].
+   * Must be specified, otherwise throws INVALID_FORMAT error.
    * 
      
    *
    * .google.cloud.retail.v2beta.CatalogAttribute.IndexableOption indexable_option = 5;
@@ -1079,6 +1238,7 @@ public com.google.cloud.retail.v2beta.CatalogAttribute.IndexableOption getIndexa
    * facet. Could only be DYNAMIC_FACETABLE_DISABLED if
    * [CatalogAttribute.indexable_option][google.cloud.retail.v2beta.CatalogAttribute.indexable_option]
    * is INDEXABLE_DISABLED. Otherwise, an INVALID_ARGUMENT error is returned.
+   * Must be specified, otherwise throws INVALID_FORMAT error.
    * 
      
    *
    * 
@@ -1099,6 +1259,7 @@ public int getDynamicFacetableOptionValue() {
    * facet. Could only be DYNAMIC_FACETABLE_DISABLED if
    * [CatalogAttribute.indexable_option][google.cloud.retail.v2beta.CatalogAttribute.indexable_option]
    * is INDEXABLE_DISABLED. Otherwise, an INVALID_ARGUMENT error is returned.
+   * Must be specified, otherwise throws INVALID_FORMAT error.
    * 
      
    *
    * 
@@ -1134,6 +1295,7 @@ public int getDynamicFacetableOptionValue() {
    * will not be searchable by text queries in
    * [SearchService.Search][google.cloud.retail.v2beta.SearchService.Search], as
    * there are no text values associated to numerical attributes.
+   * Must be specified, otherwise throws INVALID_FORMAT error.
    * 
      
    *
    * .google.cloud.retail.v2beta.CatalogAttribute.SearchableOption searchable_option = 7;
@@ -1158,6 +1320,7 @@ public int getSearchableOptionValue() {
    * will not be searchable by text queries in
    * [SearchService.Search][google.cloud.retail.v2beta.SearchService.Search], as
    * there are no text values associated to numerical attributes.
+   * Must be specified, otherwise throws INVALID_FORMAT error.
    * 
      
    *
    * .google.cloud.retail.v2beta.CatalogAttribute.SearchableOption searchable_option = 7;
@@ -1277,6 +1440,49 @@ public int getExactSearchableOptionValue() {
         : result;
   }
 
+  public static final int RETRIEVABLE_OPTION_FIELD_NUMBER = 12;
+  private int retrievableOption_;
+  /**
+   *
+   *
+   * 
      +   * If RETRIEVABLE_ENABLED, attribute values are retrievable in the search
+   * results.
+   * 
      
+   *
+   * .google.cloud.retail.v2beta.CatalogAttribute.RetrievableOption retrievable_option = 12;
+   * 
+   *
+   * @return The enum numeric value on the wire for retrievableOption.
+   */
+  @java.lang.Override
+  public int getRetrievableOptionValue() {
+    return retrievableOption_;
+  }
+  /**
+   *
+   *
+   * 
      +   * If RETRIEVABLE_ENABLED, attribute values are retrievable in the search
+   * results.
+   * 
      
+   *
+   * .google.cloud.retail.v2beta.CatalogAttribute.RetrievableOption retrievable_option = 12;
+   * 
+   *
+   * @return The retrievableOption.
+   */
+  @java.lang.Override
+  public com.google.cloud.retail.v2beta.CatalogAttribute.RetrievableOption getRetrievableOption() {
+    @SuppressWarnings("deprecation")
+    com.google.cloud.retail.v2beta.CatalogAttribute.RetrievableOption result =
+        com.google.cloud.retail.v2beta.CatalogAttribute.RetrievableOption.valueOf(
+            retrievableOption_);
+    return result == null
+        ? com.google.cloud.retail.v2beta.CatalogAttribute.RetrievableOption.UNRECOGNIZED
+        : result;
+  }
+
   private byte memoizedIsInitialized = -1;
 
   @java.lang.Override
@@ -1331,6 +1537,12 @@ public void writeTo(com.google.protobuf.CodedOutputStream output) throws java.io
             .getNumber()) {
       output.writeEnum(11, exactSearchableOption_);
     }
+    if (retrievableOption_
+        != com.google.cloud.retail.v2beta.CatalogAttribute.RetrievableOption
+            .RETRIEVABLE_OPTION_UNSPECIFIED
+            .getNumber()) {
+      output.writeEnum(12, retrievableOption_);
+    }
     getUnknownFields().writeTo(output);
   }
 
@@ -1381,6 +1593,12 @@ public int getSerializedSize() {
             .getNumber()) {
       size += com.google.protobuf.CodedOutputStream.computeEnumSize(11, exactSearchableOption_);
     }
+    if (retrievableOption_
+        != com.google.cloud.retail.v2beta.CatalogAttribute.RetrievableOption
+            .RETRIEVABLE_OPTION_UNSPECIFIED
+            .getNumber()) {
+      size += com.google.protobuf.CodedOutputStream.computeEnumSize(12, retrievableOption_);
+    }
     size += getUnknownFields().getSerializedSize();
     memoizedSize = size;
     return size;
@@ -1405,6 +1623,7 @@ public boolean equals(final java.lang.Object obj) {
     if (searchableOption_ != other.searchableOption_) return false;
     if (recommendationsFilteringOption_ != other.recommendationsFilteringOption_) return false;
     if (exactSearchableOption_ != other.exactSearchableOption_) return false;
+    if (retrievableOption_ != other.retrievableOption_) return false;
     if (!getUnknownFields().equals(other.getUnknownFields())) return false;
     return true;
   }
@@ -1432,6 +1651,8 @@ public int hashCode() {
     hash = (53 * hash) + recommendationsFilteringOption_;
     hash = (37 * hash) + EXACT_SEARCHABLE_OPTION_FIELD_NUMBER;
     hash = (53 * hash) + exactSearchableOption_;
+    hash = (37 * hash) + RETRIEVABLE_OPTION_FIELD_NUMBER;
+    hash = (53 * hash) + retrievableOption_;
     hash = (29 * hash) + getUnknownFields().hashCode();
     memoizedHashCode = hash;
     return hash;
@@ -1587,6 +1808,8 @@ public Builder clear() {
 
       exactSearchableOption_ = 0;
 
+      retrievableOption_ = 0;
+
       return this;
     }
 
@@ -1622,6 +1845,7 @@ public com.google.cloud.retail.v2beta.CatalogAttribute buildPartial() {
       result.searchableOption_ = searchableOption_;
       result.recommendationsFilteringOption_ = recommendationsFilteringOption_;
       result.exactSearchableOption_ = exactSearchableOption_;
+      result.retrievableOption_ = retrievableOption_;
       onBuilt();
       return result;
     }
@@ -1697,6 +1921,9 @@ public Builder mergeFrom(com.google.cloud.retail.v2beta.CatalogAttribute other)
       if (other.exactSearchableOption_ != 0) {
         setExactSearchableOptionValue(other.getExactSearchableOptionValue());
       }
+      if (other.retrievableOption_ != 0) {
+        setRetrievableOptionValue(other.getRetrievableOptionValue());
+      }
       this.mergeUnknownFields(other.getUnknownFields());
       onChanged();
       return this;
@@ -1771,6 +1998,12 @@ public Builder mergeFrom(
 
                 break;
               } // case 88
+            case 96:
+              {
+                retrievableOption_ = input.readEnum();
+
+                break;
+              } // case 96
             default:
               {
                 if (!super.parseUnknownField(input, extensionRegistry, tag)) {
@@ -1941,13 +2174,13 @@ public Builder setKeyBytes(com.google.protobuf.ByteString value) {
      * [CatalogService.UpdateAttributesConfig][google.cloud.retail.v2beta.CatalogService.UpdateAttributesConfig]
      * APIs. This field is `False` for pre-loaded
      * [CatalogAttribute][google.cloud.retail.v2beta.CatalogAttribute]s.
-     * Only pre-loaded
-     * [CatalogAttribute][google.cloud.retail.v2beta.CatalogAttribute]s that are
-     * neither in use by products nor predefined can be deleted.
-     * [CatalogAttribute][google.cloud.retail.v2beta.CatalogAttribute]s that are
-     * either in use by products or are predefined cannot be deleted; however,
-     * their configuration properties will reset to default values upon removal
-     * request.
+     * Only pre-loaded [catalog
+     * attributes][google.cloud.retail.v2beta.CatalogAttribute] that are neither
+     * in use by products nor predefined can be deleted. [Catalog
+     * attributes][google.cloud.retail.v2beta.CatalogAttribute] that are
+     * either in use by products or are predefined attributes cannot be deleted;
+     * however, their configuration properties will reset to default values upon
+     * removal request.
      * After catalog changes, it takes about 10 minutes for this field to update.
      * 
      
      *
@@ -1975,13 +2208,13 @@ public boolean getInUse() {
      * [CatalogService.UpdateAttributesConfig][google.cloud.retail.v2beta.CatalogService.UpdateAttributesConfig]
      * APIs. This field is `False` for pre-loaded
      * [CatalogAttribute][google.cloud.retail.v2beta.CatalogAttribute]s.
-     * Only pre-loaded
-     * [CatalogAttribute][google.cloud.retail.v2beta.CatalogAttribute]s that are
-     * neither in use by products nor predefined can be deleted.
-     * [CatalogAttribute][google.cloud.retail.v2beta.CatalogAttribute]s that are
-     * either in use by products or are predefined cannot be deleted; however,
-     * their configuration properties will reset to default values upon removal
-     * request.
+     * Only pre-loaded [catalog
+     * attributes][google.cloud.retail.v2beta.CatalogAttribute] that are neither
+     * in use by products nor predefined can be deleted. [Catalog
+     * attributes][google.cloud.retail.v2beta.CatalogAttribute] that are
+     * either in use by products or are predefined attributes cannot be deleted;
+     * however, their configuration properties will reset to default values upon
+     * removal request.
      * After catalog changes, it takes about 10 minutes for this field to update.
      * 
      
      *
@@ -2012,13 +2245,13 @@ public Builder setInUse(boolean value) {
      * [CatalogService.UpdateAttributesConfig][google.cloud.retail.v2beta.CatalogService.UpdateAttributesConfig]
      * APIs. This field is `False` for pre-loaded
      * [CatalogAttribute][google.cloud.retail.v2beta.CatalogAttribute]s.
-     * Only pre-loaded
-     * [CatalogAttribute][google.cloud.retail.v2beta.CatalogAttribute]s that are
-     * neither in use by products nor predefined can be deleted.
-     * [CatalogAttribute][google.cloud.retail.v2beta.CatalogAttribute]s that are
-     * either in use by products or are predefined cannot be deleted; however,
-     * their configuration properties will reset to default values upon removal
-     * request.
+     * Only pre-loaded [catalog
+     * attributes][google.cloud.retail.v2beta.CatalogAttribute] that are neither
+     * in use by products nor predefined can be deleted. [Catalog
+     * attributes][google.cloud.retail.v2beta.CatalogAttribute] that are
+     * either in use by products or are predefined attributes cannot be deleted;
+     * however, their configuration properties will reset to default values upon
+     * removal request.
      * After catalog changes, it takes about 10 minutes for this field to update.
      * 
      
      *
@@ -2151,6 +2384,7 @@ public Builder clearType() {
      * is CATALOG_LEVEL_ATTRIBUTE_CONFIG, if INDEXABLE_ENABLED attribute values
      * are indexed so that it can be filtered, faceted, or boosted in
      * [SearchService.Search][google.cloud.retail.v2beta.SearchService.Search].
+     * Must be specified, otherwise throws INVALID_FORMAT error.
      * 
      
      *
      * .google.cloud.retail.v2beta.CatalogAttribute.IndexableOption indexable_option = 5;
@@ -2171,6 +2405,7 @@ public int getIndexableOptionValue() {
      * is CATALOG_LEVEL_ATTRIBUTE_CONFIG, if INDEXABLE_ENABLED attribute values
      * are indexed so that it can be filtered, faceted, or boosted in
      * [SearchService.Search][google.cloud.retail.v2beta.SearchService.Search].
+     * Must be specified, otherwise throws INVALID_FORMAT error.
      * 
      
      *
      * .google.cloud.retail.v2beta.CatalogAttribute.IndexableOption indexable_option = 5;
@@ -2194,6 +2429,7 @@ public Builder setIndexableOptionValue(int value) {
      * is CATALOG_LEVEL_ATTRIBUTE_CONFIG, if INDEXABLE_ENABLED attribute values
      * are indexed so that it can be filtered, faceted, or boosted in
      * [SearchService.Search][google.cloud.retail.v2beta.SearchService.Search].
+     * Must be specified, otherwise throws INVALID_FORMAT error.
      * 
      
      *
      * .google.cloud.retail.v2beta.CatalogAttribute.IndexableOption indexable_option = 5;
@@ -2219,6 +2455,7 @@ public com.google.cloud.retail.v2beta.CatalogAttribute.IndexableOption getIndexa
      * is CATALOG_LEVEL_ATTRIBUTE_CONFIG, if INDEXABLE_ENABLED attribute values
      * are indexed so that it can be filtered, faceted, or boosted in
      * [SearchService.Search][google.cloud.retail.v2beta.SearchService.Search].
+     * Must be specified, otherwise throws INVALID_FORMAT error.
      * 
      
      *
      * .google.cloud.retail.v2beta.CatalogAttribute.IndexableOption indexable_option = 5;
@@ -2246,6 +2483,7 @@ public Builder setIndexableOption(
      * is CATALOG_LEVEL_ATTRIBUTE_CONFIG, if INDEXABLE_ENABLED attribute values
      * are indexed so that it can be filtered, faceted, or boosted in
      * [SearchService.Search][google.cloud.retail.v2beta.SearchService.Search].
+     * Must be specified, otherwise throws INVALID_FORMAT error.
      * 
      
      *
      * .google.cloud.retail.v2beta.CatalogAttribute.IndexableOption indexable_option = 5;
@@ -2269,6 +2507,7 @@ public Builder clearIndexableOption() {
      * facet. Could only be DYNAMIC_FACETABLE_DISABLED if
      * [CatalogAttribute.indexable_option][google.cloud.retail.v2beta.CatalogAttribute.indexable_option]
      * is INDEXABLE_DISABLED. Otherwise, an INVALID_ARGUMENT error is returned.
+     * Must be specified, otherwise throws INVALID_FORMAT error.
      * 
      
      *
      * 
@@ -2289,6 +2528,7 @@ public int getDynamicFacetableOptionValue() {
      * facet. Could only be DYNAMIC_FACETABLE_DISABLED if
      * [CatalogAttribute.indexable_option][google.cloud.retail.v2beta.CatalogAttribute.indexable_option]
      * is INDEXABLE_DISABLED. Otherwise, an INVALID_ARGUMENT error is returned.
+     * Must be specified, otherwise throws INVALID_FORMAT error.
      * 
      
      *
      * 
@@ -2312,6 +2552,7 @@ public Builder setDynamicFacetableOptionValue(int value) {
      * facet. Could only be DYNAMIC_FACETABLE_DISABLED if
      * [CatalogAttribute.indexable_option][google.cloud.retail.v2beta.CatalogAttribute.indexable_option]
      * is INDEXABLE_DISABLED. Otherwise, an INVALID_ARGUMENT error is returned.
+     * Must be specified, otherwise throws INVALID_FORMAT error.
      * 
      
      *
      * 
@@ -2339,6 +2580,7 @@ public Builder setDynamicFacetableOptionValue(int value) {
      * facet. Could only be DYNAMIC_FACETABLE_DISABLED if
      * [CatalogAttribute.indexable_option][google.cloud.retail.v2beta.CatalogAttribute.indexable_option]
      * is INDEXABLE_DISABLED. Otherwise, an INVALID_ARGUMENT error is returned.
+     * Must be specified, otherwise throws INVALID_FORMAT error.
      * 
      
      *
      * 
@@ -2366,6 +2608,7 @@ public Builder setDynamicFacetableOption(
      * facet. Could only be DYNAMIC_FACETABLE_DISABLED if
      * [CatalogAttribute.indexable_option][google.cloud.retail.v2beta.CatalogAttribute.indexable_option]
      * is INDEXABLE_DISABLED. Otherwise, an INVALID_ARGUMENT error is returned.
+     * Must be specified, otherwise throws INVALID_FORMAT error.
      * 
      
      *
      * 
@@ -2395,6 +2638,7 @@ public Builder clearDynamicFacetableOption() {
      * will not be searchable by text queries in
      * [SearchService.Search][google.cloud.retail.v2beta.SearchService.Search], as
      * there are no text values associated to numerical attributes.
+     * Must be specified, otherwise throws INVALID_FORMAT error.
      * 
      
      *
      * .google.cloud.retail.v2beta.CatalogAttribute.SearchableOption searchable_option = 7;
@@ -2419,6 +2663,7 @@ public int getSearchableOptionValue() {
      * will not be searchable by text queries in
      * [SearchService.Search][google.cloud.retail.v2beta.SearchService.Search], as
      * there are no text values associated to numerical attributes.
+     * Must be specified, otherwise throws INVALID_FORMAT error.
      * 
      
      *
      * .google.cloud.retail.v2beta.CatalogAttribute.SearchableOption searchable_option = 7;
@@ -2446,6 +2691,7 @@ public Builder setSearchableOptionValue(int value) {
      * will not be searchable by text queries in
      * [SearchService.Search][google.cloud.retail.v2beta.SearchService.Search], as
      * there are no text values associated to numerical attributes.
+     * Must be specified, otherwise throws INVALID_FORMAT error.
      * 
      
      *
      * .google.cloud.retail.v2beta.CatalogAttribute.SearchableOption searchable_option = 7;
@@ -2476,6 +2722,7 @@ public com.google.cloud.retail.v2beta.CatalogAttribute.SearchableOption getSearc
      * will not be searchable by text queries in
      * [SearchService.Search][google.cloud.retail.v2beta.SearchService.Search], as
      * there are no text values associated to numerical attributes.
+     * Must be specified, otherwise throws INVALID_FORMAT error.
      * 
      
      *
      * .google.cloud.retail.v2beta.CatalogAttribute.SearchableOption searchable_option = 7;
@@ -2507,6 +2754,7 @@ public Builder setSearchableOption(
      * will not be searchable by text queries in
      * [SearchService.Search][google.cloud.retail.v2beta.SearchService.Search], as
      * there are no text values associated to numerical attributes.
+     * Must be specified, otherwise throws INVALID_FORMAT error.
      * 
      
      *
      * .google.cloud.retail.v2beta.CatalogAttribute.SearchableOption searchable_option = 7;
@@ -2768,6 +3016,112 @@ public Builder clearExactSearchableOption() {
       return this;
     }
 
+    private int retrievableOption_ = 0;
+    /**
+     *
+     *
+     * 
      +     * If RETRIEVABLE_ENABLED, attribute values are retrievable in the search
+     * results.
+     * 
      
+     *
+     * .google.cloud.retail.v2beta.CatalogAttribute.RetrievableOption retrievable_option = 12;
+     * 
+     *
+     * @return The enum numeric value on the wire for retrievableOption.
+     */
+    @java.lang.Override
+    public int getRetrievableOptionValue() {
+      return retrievableOption_;
+    }
+    /**
+     *
+     *
+     * 
      +     * If RETRIEVABLE_ENABLED, attribute values are retrievable in the search
+     * results.
+     * 
      
+     *
+     * .google.cloud.retail.v2beta.CatalogAttribute.RetrievableOption retrievable_option = 12;
+     * 
+     *
+     * @param value The enum numeric value on the wire for retrievableOption to set.
+     * @return This builder for chaining.
+     */
+    public Builder setRetrievableOptionValue(int value) {
+
+      retrievableOption_ = value;
+      onChanged();
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * If RETRIEVABLE_ENABLED, attribute values are retrievable in the search
+     * results.
+     * 
      
+     *
+     * .google.cloud.retail.v2beta.CatalogAttribute.RetrievableOption retrievable_option = 12;
+     * 
+     *
+     * @return The retrievableOption.
+     */
+    @java.lang.Override
+    public com.google.cloud.retail.v2beta.CatalogAttribute.RetrievableOption
+        getRetrievableOption() {
+      @SuppressWarnings("deprecation")
+      com.google.cloud.retail.v2beta.CatalogAttribute.RetrievableOption result =
+          com.google.cloud.retail.v2beta.CatalogAttribute.RetrievableOption.valueOf(
+              retrievableOption_);
+      return result == null
+          ? com.google.cloud.retail.v2beta.CatalogAttribute.RetrievableOption.UNRECOGNIZED
+          : result;
+    }
+    /**
+     *
+     *
+     * 
      +     * If RETRIEVABLE_ENABLED, attribute values are retrievable in the search
+     * results.
+     * 
      
+     *
+     * .google.cloud.retail.v2beta.CatalogAttribute.RetrievableOption retrievable_option = 12;
+     * 
+     *
+     * @param value The retrievableOption to set.
+     * @return This builder for chaining.
+     */
+    public Builder setRetrievableOption(
+        com.google.cloud.retail.v2beta.CatalogAttribute.RetrievableOption value) {
+      if (value == null) {
+        throw new NullPointerException();
+      }
+
+      retrievableOption_ = value.getNumber();
+      onChanged();
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * If RETRIEVABLE_ENABLED, attribute values are retrievable in the search
+     * results.
+     * 
      
+     *
+     * .google.cloud.retail.v2beta.CatalogAttribute.RetrievableOption retrievable_option = 12;
+     * 
+     *
+     * @return This builder for chaining.
+     */
+    public Builder clearRetrievableOption() {
+
+      retrievableOption_ = 0;
+      onChanged();
+      return this;
+    }
+
     @java.lang.Override
     public final Builder setUnknownFields(final com.google.protobuf.UnknownFieldSet unknownFields) {
       return super.setUnknownFields(unknownFields);
diff --git a/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/CatalogAttributeOrBuilder.java b/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/CatalogAttributeOrBuilder.java
index 19f81a3b6556..48e41125ee33 100644
--- a/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/CatalogAttributeOrBuilder.java
+++ b/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/CatalogAttributeOrBuilder.java
@@ -76,13 +76,13 @@ public interface CatalogAttributeOrBuilder
    * [CatalogService.UpdateAttributesConfig][google.cloud.retail.v2beta.CatalogService.UpdateAttributesConfig]
    * APIs. This field is `False` for pre-loaded
    * [CatalogAttribute][google.cloud.retail.v2beta.CatalogAttribute]s.
-   * Only pre-loaded
-   * [CatalogAttribute][google.cloud.retail.v2beta.CatalogAttribute]s that are
-   * neither in use by products nor predefined can be deleted.
-   * [CatalogAttribute][google.cloud.retail.v2beta.CatalogAttribute]s that are
-   * either in use by products or are predefined cannot be deleted; however,
-   * their configuration properties will reset to default values upon removal
-   * request.
+   * Only pre-loaded [catalog
+   * attributes][google.cloud.retail.v2beta.CatalogAttribute] that are neither
+   * in use by products nor predefined can be deleted. [Catalog
+   * attributes][google.cloud.retail.v2beta.CatalogAttribute] that are
+   * either in use by products or are predefined attributes cannot be deleted;
+   * however, their configuration properties will reset to default values upon
+   * removal request.
    * After catalog changes, it takes about 10 minutes for this field to update.
    * 
      
    *
@@ -132,6 +132,7 @@ public interface CatalogAttributeOrBuilder
    * is CATALOG_LEVEL_ATTRIBUTE_CONFIG, if INDEXABLE_ENABLED attribute values
    * are indexed so that it can be filtered, faceted, or boosted in
    * [SearchService.Search][google.cloud.retail.v2beta.SearchService.Search].
+   * Must be specified, otherwise throws INVALID_FORMAT error.
    * 
      
    *
    * .google.cloud.retail.v2beta.CatalogAttribute.IndexableOption indexable_option = 5;
@@ -148,6 +149,7 @@ public interface CatalogAttributeOrBuilder
    * is CATALOG_LEVEL_ATTRIBUTE_CONFIG, if INDEXABLE_ENABLED attribute values
    * are indexed so that it can be filtered, faceted, or boosted in
    * [SearchService.Search][google.cloud.retail.v2beta.SearchService.Search].
+   * Must be specified, otherwise throws INVALID_FORMAT error.
    * 
      
    *
    * .google.cloud.retail.v2beta.CatalogAttribute.IndexableOption indexable_option = 5;
@@ -164,6 +166,7 @@ public interface CatalogAttributeOrBuilder
    * facet. Could only be DYNAMIC_FACETABLE_DISABLED if
    * [CatalogAttribute.indexable_option][google.cloud.retail.v2beta.CatalogAttribute.indexable_option]
    * is INDEXABLE_DISABLED. Otherwise, an INVALID_ARGUMENT error is returned.
+   * Must be specified, otherwise throws INVALID_FORMAT error.
    * 
      
    *
    * 
@@ -181,6 +184,7 @@ public interface CatalogAttributeOrBuilder
    * facet. Could only be DYNAMIC_FACETABLE_DISABLED if
    * [CatalogAttribute.indexable_option][google.cloud.retail.v2beta.CatalogAttribute.indexable_option]
    * is INDEXABLE_DISABLED. Otherwise, an INVALID_ARGUMENT error is returned.
+   * Must be specified, otherwise throws INVALID_FORMAT error.
    * 
      
    *
    * 
@@ -205,6 +209,7 @@ public interface CatalogAttributeOrBuilder
    * will not be searchable by text queries in
    * [SearchService.Search][google.cloud.retail.v2beta.SearchService.Search], as
    * there are no text values associated to numerical attributes.
+   * Must be specified, otherwise throws INVALID_FORMAT error.
    * 
      
    *
    * .google.cloud.retail.v2beta.CatalogAttribute.SearchableOption searchable_option = 7;
@@ -226,6 +231,7 @@ public interface CatalogAttributeOrBuilder
    * will not be searchable by text queries in
    * [SearchService.Search][google.cloud.retail.v2beta.SearchService.Search], as
    * there are no text values associated to numerical attributes.
+   * Must be specified, otherwise throws INVALID_FORMAT error.
    * 
      
    *
    * .google.cloud.retail.v2beta.CatalogAttribute.SearchableOption searchable_option = 7;
@@ -306,4 +312,33 @@ public interface CatalogAttributeOrBuilder
    * @return The exactSearchableOption.
    */
   com.google.cloud.retail.v2beta.CatalogAttribute.ExactSearchableOption getExactSearchableOption();
+
+  /**
+   *
+   *
+   * 
      +   * If RETRIEVABLE_ENABLED, attribute values are retrievable in the search
+   * results.
+   * 
      
+   *
+   * .google.cloud.retail.v2beta.CatalogAttribute.RetrievableOption retrievable_option = 12;
+   * 
+   *
+   * @return The enum numeric value on the wire for retrievableOption.
+   */
+  int getRetrievableOptionValue();
+  /**
+   *
+   *
+   * 
      +   * If RETRIEVABLE_ENABLED, attribute values are retrievable in the search
+   * results.
+   * 
      
+   *
+   * .google.cloud.retail.v2beta.CatalogAttribute.RetrievableOption retrievable_option = 12;
+   * 
+   *
+   * @return The retrievableOption.
+   */
+  com.google.cloud.retail.v2beta.CatalogAttribute.RetrievableOption getRetrievableOption();
 }
diff --git a/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/CatalogProto.java b/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/CatalogProto.java
index 2683735a1783..b7a8fe15721f 100644
--- a/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/CatalogProto.java
+++ b/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/CatalogProto.java
@@ -51,6 +51,10 @@ public static void registerAllExtensions(com.google.protobuf.ExtensionRegistry r
       internal_static_google_cloud_retail_v2beta_MerchantCenterLink_descriptor;
   static final com.google.protobuf.GeneratedMessageV3.FieldAccessorTable
       internal_static_google_cloud_retail_v2beta_MerchantCenterLink_fieldAccessorTable;
+  static final com.google.protobuf.Descriptors.Descriptor
+      internal_static_google_cloud_retail_v2beta_MerchantCenterFeedFilter_descriptor;
+  static final com.google.protobuf.GeneratedMessageV3.FieldAccessorTable
+      internal_static_google_cloud_retail_v2beta_MerchantCenterFeedFilter_fieldAccessorTable;
   static final com.google.protobuf.Descriptors.Descriptor
       internal_static_google_cloud_retail_v2beta_MerchantCenterLinkingConfig_descriptor;
   static final com.google.protobuf.GeneratedMessageV3.FieldAccessorTable
@@ -75,7 +79,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
           + "ommon.proto\032.google/cloud/retail/v2beta/"
           + "import_config.proto\"^\n\022ProductLevelConfi"
           + "g\022\036\n\026ingestion_product_type\030\001 \001(\t\022(\n mer"
-          + "chant_center_product_id_field\030\002 \001(\t\"\365\010\n\020"
+          + "chant_center_product_id_field\030\002 \001(\t\"\275\n\n\020"
           + "CatalogAttribute\022\020\n\003key\030\001 \001(\tB\003\340A\002\022\023\n\006in"
           + "_use\030\t \001(\010B\003\340A\003\022M\n\004type\030\n \001(\0162:.google.c"
           + "loud.retail.v2beta.CatalogAttribute.Attr"
@@ -91,20 +95,25 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
           + "v2beta.RecommendationsFilteringOption\022c\n"
           + "\027exact_searchable_option\030\013 \001(\0162B.google."
           + "cloud.retail.v2beta.CatalogAttribute.Exa"
-          + "ctSearchableOption\"8\n\rAttributeType\022\013\n\007U"
-          + "NKNOWN\020\000\022\013\n\007TEXTUAL\020\001\022\r\n\tNUMERICAL\020\002\"b\n\017"
-          + "IndexableOption\022 \n\034INDEXABLE_OPTION_UNSP"
-          + "ECIFIED\020\000\022\025\n\021INDEXABLE_ENABLED\020\001\022\026\n\022INDE"
-          + "XABLE_DISABLED\020\002\"\201\001\n\026DynamicFacetableOpt"
-          + "ion\022(\n$DYNAMIC_FACETABLE_OPTION_UNSPECIF"
-          + "IED\020\000\022\035\n\031DYNAMIC_FACETABLE_ENABLED\020\001\022\036\n\032"
-          + "DYNAMIC_FACETABLE_DISABLED\020\002\"f\n\020Searchab"
-          + "leOption\022!\n\035SEARCHABLE_OPTION_UNSPECIFIE"
-          + "D\020\000\022\026\n\022SEARCHABLE_ENABLED\020\001\022\027\n\023SEARCHABL"
-          + "E_DISABLED\020\002\"}\n\025ExactSearchableOption\022\'\n"
-          + "#EXACT_SEARCHABLE_OPTION_UNSPECIFIED\020\000\022\034"
-          + "\n\030EXACT_SEARCHABLE_ENABLED\020\001\022\035\n\031EXACT_SE"
-          + "ARCHABLE_DISABLED\020\002\"\302\003\n\020AttributesConfig"
+          + "ctSearchableOption\022Z\n\022retrievable_option"
+          + "\030\014 \001(\0162>.google.cloud.retail.v2beta.Cata"
+          + "logAttribute.RetrievableOption\"8\n\rAttrib"
+          + "uteType\022\013\n\007UNKNOWN\020\000\022\013\n\007TEXTUAL\020\001\022\r\n\tNUM"
+          + "ERICAL\020\002\"b\n\017IndexableOption\022 \n\034INDEXABLE"
+          + "_OPTION_UNSPECIFIED\020\000\022\025\n\021INDEXABLE_ENABL"
+          + "ED\020\001\022\026\n\022INDEXABLE_DISABLED\020\002\"\201\001\n\026Dynamic"
+          + "FacetableOption\022(\n$DYNAMIC_FACETABLE_OPT"
+          + "ION_UNSPECIFIED\020\000\022\035\n\031DYNAMIC_FACETABLE_E"
+          + "NABLED\020\001\022\036\n\032DYNAMIC_FACETABLE_DISABLED\020\002"
+          + "\"f\n\020SearchableOption\022!\n\035SEARCHABLE_OPTIO"
+          + "N_UNSPECIFIED\020\000\022\026\n\022SEARCHABLE_ENABLED\020\001\022"
+          + "\027\n\023SEARCHABLE_DISABLED\020\002\"}\n\025ExactSearcha"
+          + "bleOption\022\'\n#EXACT_SEARCHABLE_OPTION_UNS"
+          + "PECIFIED\020\000\022\034\n\030EXACT_SEARCHABLE_ENABLED\020\001"
+          + "\022\035\n\031EXACT_SEARCHABLE_DISABLED\020\002\"j\n\021Retri"
+          + "evableOption\022\"\n\036RETRIEVABLE_OPTION_UNSPE"
+          + "CIFIED\020\000\022\027\n\023RETRIEVABLE_ENABLED\020\001\022\030\n\024RET"
+          + "RIEVABLE_DISABLED\020\002\"\302\003\n\020AttributesConfig"
           + "\022\024\n\004name\030\001 \001(\tB\006\340A\002\340A\005\022_\n\022catalog_attrib"
           + "utes\030\002 \003(\0132C.google.cloud.retail.v2beta."
           + "AttributesConfig.CatalogAttributesEntry\022"
@@ -132,27 +141,31 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
           + "st_import_operation\030\n \001(\tB\003\340A\003:x\352Au\n&ret"
           + "ail.googleapis.com/CompletionConfig\022Kpro"
           + "jects/{project}/locations/{location}/cat"
-          + "alogs/{catalog}/completionConfig\"\222\001\n\022Mer"
+          + "alogs/{catalog}/completionConfig\"\327\001\n\022Mer"
           + "chantCenterLink\022\'\n\032merchant_center_accou"
           + "nt_id\030\001 \001(\003B\003\340A\002\022\021\n\tbranch_id\030\002 \001(\t\022\024\n\014d"
           + "estinations\030\003 \003(\t\022\023\n\013region_code\030\004 \001(\t\022\025"
-          + "\n\rlanguage_code\030\005 \001(\t\"\\\n\033MerchantCenterL"
-          + "inkingConfig\022=\n\005links\030\001 \003(\0132..google.clo"
-          + "ud.retail.v2beta.MerchantCenterLink\"\321\002\n\007"
-          + "Catalog\022\024\n\004name\030\001 \001(\tB\006\340A\002\340A\005\022\034\n\014display"
-          + "_name\030\002 \001(\tB\006\340A\002\340A\005\022Q\n\024product_level_con"
-          + "fig\030\004 \001(\0132..google.cloud.retail.v2beta.P"
-          + "roductLevelConfigB\003\340A\002\022_\n\036merchant_cente"
-          + "r_linking_config\030\006 \001(\01327.google.cloud.re"
-          + "tail.v2beta.MerchantCenterLinkingConfig:"
-          + "^\352A[\n\035retail.googleapis.com/Catalog\022:pro"
-          + "jects/{project}/locations/{location}/cat"
-          + "alogs/{catalog}B\325\001\n\036com.google.cloud.ret"
-          + "ail.v2betaB\014CatalogProtoP\001Z@google.golan"
-          + "g.org/genproto/googleapis/cloud/retail/v"
-          + "2beta;retail\242\002\006RETAIL\252\002\032Google.Cloud.Ret"
-          + "ail.V2Beta\312\002\032Google\\Cloud\\Retail\\V2beta\352"
-          + "\002\035Google::Cloud::Retail::V2betab\006proto3"
+          + "\n\rlanguage_code\030\005 \001(\t\022C\n\005feeds\030\006 \003(\01324.g"
+          + "oogle.cloud.retail.v2beta.MerchantCenter"
+          + "FeedFilter\"N\n\030MerchantCenterFeedFilter\022\027"
+          + "\n\017primary_feed_id\030\001 \001(\003\022\031\n\021primary_feed_"
+          + "name\030\002 \001(\t\"\\\n\033MerchantCenterLinkingConfi"
+          + "g\022=\n\005links\030\001 \003(\0132..google.cloud.retail.v"
+          + "2beta.MerchantCenterLink\"\321\002\n\007Catalog\022\024\n\004"
+          + "name\030\001 \001(\tB\006\340A\002\340A\005\022\034\n\014display_name\030\002 \001(\t"
+          + "B\006\340A\002\340A\005\022Q\n\024product_level_config\030\004 \001(\0132."
+          + ".google.cloud.retail.v2beta.ProductLevel"
+          + "ConfigB\003\340A\002\022_\n\036merchant_center_linking_c"
+          + "onfig\030\006 \001(\01327.google.cloud.retail.v2beta"
+          + ".MerchantCenterLinkingConfig:^\352A[\n\035retai"
+          + "l.googleapis.com/Catalog\022:projects/{proj"
+          + "ect}/locations/{location}/catalogs/{cata"
+          + "log}B\325\001\n\036com.google.cloud.retail.v2betaB"
+          + "\014CatalogProtoP\001Z@google.golang.org/genpr"
+          + "oto/googleapis/cloud/retail/v2beta;retai"
+          + "l\242\002\006RETAIL\252\002\032Google.Cloud.Retail.V2Beta\312"
+          + "\002\032Google\\Cloud\\Retail\\V2beta\352\002\035Google::C"
+          + "loud::Retail::V2betab\006proto3"
     };
     descriptor =
         com.google.protobuf.Descriptors.FileDescriptor.internalBuildGeneratedFileFrom(
@@ -185,6 +198,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
               "SearchableOption",
               "RecommendationsFilteringOption",
               "ExactSearchableOption",
+              "RetrievableOption",
             });
     internal_static_google_cloud_retail_v2beta_AttributesConfig_descriptor =
         getDescriptor().getMessageTypes().get(2);
@@ -228,10 +242,23 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
         new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable(
             internal_static_google_cloud_retail_v2beta_MerchantCenterLink_descriptor,
             new java.lang.String[] {
-              "MerchantCenterAccountId", "BranchId", "Destinations", "RegionCode", "LanguageCode",
+              "MerchantCenterAccountId",
+              "BranchId",
+              "Destinations",
+              "RegionCode",
+              "LanguageCode",
+              "Feeds",
             });
-    internal_static_google_cloud_retail_v2beta_MerchantCenterLinkingConfig_descriptor =
+    internal_static_google_cloud_retail_v2beta_MerchantCenterFeedFilter_descriptor =
         getDescriptor().getMessageTypes().get(5);
+    internal_static_google_cloud_retail_v2beta_MerchantCenterFeedFilter_fieldAccessorTable =
+        new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable(
+            internal_static_google_cloud_retail_v2beta_MerchantCenterFeedFilter_descriptor,
+            new java.lang.String[] {
+              "PrimaryFeedId", "PrimaryFeedName",
+            });
+    internal_static_google_cloud_retail_v2beta_MerchantCenterLinkingConfig_descriptor =
+        getDescriptor().getMessageTypes().get(6);
     internal_static_google_cloud_retail_v2beta_MerchantCenterLinkingConfig_fieldAccessorTable =
         new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable(
             internal_static_google_cloud_retail_v2beta_MerchantCenterLinkingConfig_descriptor,
@@ -239,7 +266,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
               "Links",
             });
     internal_static_google_cloud_retail_v2beta_Catalog_descriptor =
-        getDescriptor().getMessageTypes().get(6);
+        getDescriptor().getMessageTypes().get(7);
     internal_static_google_cloud_retail_v2beta_Catalog_fieldAccessorTable =
         new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable(
             internal_static_google_cloud_retail_v2beta_Catalog_descriptor,
diff --git a/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/CollectUserEventRequest.java b/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/CollectUserEventRequest.java
index f2924749ee58..7c60c8ea9b53 100644
--- a/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/CollectUserEventRequest.java
+++ b/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/CollectUserEventRequest.java
@@ -41,6 +41,7 @@ private CollectUserEventRequest() {
     parent_ = "";
     userEvent_ = "";
     uri_ = "";
+    rawJson_ = "";
   }
 
   @java.lang.Override
@@ -69,6 +70,123 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
             com.google.cloud.retail.v2beta.CollectUserEventRequest.Builder.class);
   }
 
+  private int conversionRuleCase_ = 0;
+  private java.lang.Object conversionRule_;
+
+  public enum ConversionRuleCase
+      implements
+          com.google.protobuf.Internal.EnumLite,
+          com.google.protobuf.AbstractMessage.InternalOneOfEnum {
+    PREBUILT_RULE(6),
+    CONVERSIONRULE_NOT_SET(0);
+    private final int value;
+
+    private ConversionRuleCase(int value) {
+      this.value = value;
+    }
+    /**
+     * @param value The number of the enum to look for.
+     * @return The enum associated with the given number.
+     * @deprecated Use {@link #forNumber(int)} instead.
+     */
+    @java.lang.Deprecated
+    public static ConversionRuleCase valueOf(int value) {
+      return forNumber(value);
+    }
+
+    public static ConversionRuleCase forNumber(int value) {
+      switch (value) {
+        case 6:
+          return PREBUILT_RULE;
+        case 0:
+          return CONVERSIONRULE_NOT_SET;
+        default:
+          return null;
+      }
+    }
+
+    public int getNumber() {
+      return this.value;
+    }
+  };
+
+  public ConversionRuleCase getConversionRuleCase() {
+    return ConversionRuleCase.forNumber(conversionRuleCase_);
+  }
+
+  public static final int PREBUILT_RULE_FIELD_NUMBER = 6;
+  /**
+   *
+   *
+   * 
      +   * The prebuilt rule name that can convert a specific type of raw_json.
+   * For example: "default_schema/v1.0"
+   * 
      
+   *
+   * string prebuilt_rule = 6;
+   *
+   * @return Whether the prebuiltRule field is set.
+   */
+  public boolean hasPrebuiltRule() {
+    return conversionRuleCase_ == 6;
+  }
+  /**
+   *
+   *
+   * 
      +   * The prebuilt rule name that can convert a specific type of raw_json.
+   * For example: "default_schema/v1.0"
+   * 
      
+   *
+   * string prebuilt_rule = 6;
+   *
+   * @return The prebuiltRule.
+   */
+  public java.lang.String getPrebuiltRule() {
+    java.lang.Object ref = "";
+    if (conversionRuleCase_ == 6) {
+      ref = conversionRule_;
+    }
+    if (ref instanceof java.lang.String) {
+      return (java.lang.String) ref;
+    } else {
+      com.google.protobuf.ByteString bs = (com.google.protobuf.ByteString) ref;
+      java.lang.String s = bs.toStringUtf8();
+      if (conversionRuleCase_ == 6) {
+        conversionRule_ = s;
+      }
+      return s;
+    }
+  }
+  /**
+   *
+   *
+   * 
      +   * The prebuilt rule name that can convert a specific type of raw_json.
+   * For example: "default_schema/v1.0"
+   * 
      
+   *
+   * string prebuilt_rule = 6;
+   *
+   * @return The bytes for prebuiltRule.
+   */
+  public com.google.protobuf.ByteString getPrebuiltRuleBytes() {
+    java.lang.Object ref = "";
+    if (conversionRuleCase_ == 6) {
+      ref = conversionRule_;
+    }
+    if (ref instanceof java.lang.String) {
+      com.google.protobuf.ByteString b =
+          com.google.protobuf.ByteString.copyFromUtf8((java.lang.String) ref);
+      if (conversionRuleCase_ == 6) {
+        conversionRule_ = b;
+      }
+      return b;
+    } else {
+      return (com.google.protobuf.ByteString) ref;
+    }
+  }
+
   public static final int PARENT_FIELD_NUMBER = 1;
   private volatile java.lang.Object parent_;
   /**
@@ -246,6 +364,61 @@ public long getEts() {
     return ets_;
   }
 
+  public static final int RAW_JSON_FIELD_NUMBER = 5;
+  private volatile java.lang.Object rawJson_;
+  /**
+   *
+   *
+   * 
      +   * An arbitrary serialized JSON string that contains necessary information
+   * that can comprise a user event. When this field is specified, the
+   * user_event field will be ignored. Note: line-delimited JSON is not
+   * supported, a single JSON only.
+   * 
      
+   *
+   * string raw_json = 5;
+   *
+   * @return The rawJson.
+   */
+  @java.lang.Override
+  public java.lang.String getRawJson() {
+    java.lang.Object ref = rawJson_;
+    if (ref instanceof java.lang.String) {
+      return (java.lang.String) ref;
+    } else {
+      com.google.protobuf.ByteString bs = (com.google.protobuf.ByteString) ref;
+      java.lang.String s = bs.toStringUtf8();
+      rawJson_ = s;
+      return s;
+    }
+  }
+  /**
+   *
+   *
+   * 
      +   * An arbitrary serialized JSON string that contains necessary information
+   * that can comprise a user event. When this field is specified, the
+   * user_event field will be ignored. Note: line-delimited JSON is not
+   * supported, a single JSON only.
+   * 
      
+   *
+   * string raw_json = 5;
+   *
+   * @return The bytes for rawJson.
+   */
+  @java.lang.Override
+  public com.google.protobuf.ByteString getRawJsonBytes() {
+    java.lang.Object ref = rawJson_;
+    if (ref instanceof java.lang.String) {
+      com.google.protobuf.ByteString b =
+          com.google.protobuf.ByteString.copyFromUtf8((java.lang.String) ref);
+      rawJson_ = b;
+      return b;
+    } else {
+      return (com.google.protobuf.ByteString) ref;
+    }
+  }
+
   private byte memoizedIsInitialized = -1;
 
   @java.lang.Override
@@ -272,6 +445,12 @@ public void writeTo(com.google.protobuf.CodedOutputStream output) throws java.io
     if (ets_ != 0L) {
       output.writeInt64(4, ets_);
     }
+    if (!com.google.protobuf.GeneratedMessageV3.isStringEmpty(rawJson_)) {
+      com.google.protobuf.GeneratedMessageV3.writeString(output, 5, rawJson_);
+    }
+    if (conversionRuleCase_ == 6) {
+      com.google.protobuf.GeneratedMessageV3.writeString(output, 6, conversionRule_);
+    }
     getUnknownFields().writeTo(output);
   }
 
@@ -293,6 +472,12 @@ public int getSerializedSize() {
     if (ets_ != 0L) {
       size += com.google.protobuf.CodedOutputStream.computeInt64Size(4, ets_);
     }
+    if (!com.google.protobuf.GeneratedMessageV3.isStringEmpty(rawJson_)) {
+      size += com.google.protobuf.GeneratedMessageV3.computeStringSize(5, rawJson_);
+    }
+    if (conversionRuleCase_ == 6) {
+      size += com.google.protobuf.GeneratedMessageV3.computeStringSize(6, conversionRule_);
+    }
     size += getUnknownFields().getSerializedSize();
     memoizedSize = size;
     return size;
@@ -313,6 +498,15 @@ public boolean equals(final java.lang.Object obj) {
     if (!getUserEvent().equals(other.getUserEvent())) return false;
     if (!getUri().equals(other.getUri())) return false;
     if (getEts() != other.getEts()) return false;
+    if (!getRawJson().equals(other.getRawJson())) return false;
+    if (!getConversionRuleCase().equals(other.getConversionRuleCase())) return false;
+    switch (conversionRuleCase_) {
+      case 6:
+        if (!getPrebuiltRule().equals(other.getPrebuiltRule())) return false;
+        break;
+      case 0:
+      default:
+    }
     if (!getUnknownFields().equals(other.getUnknownFields())) return false;
     return true;
   }
@@ -332,6 +526,16 @@ public int hashCode() {
     hash = (53 * hash) + getUri().hashCode();
     hash = (37 * hash) + ETS_FIELD_NUMBER;
     hash = (53 * hash) + com.google.protobuf.Internal.hashLong(getEts());
+    hash = (37 * hash) + RAW_JSON_FIELD_NUMBER;
+    hash = (53 * hash) + getRawJson().hashCode();
+    switch (conversionRuleCase_) {
+      case 6:
+        hash = (37 * hash) + PREBUILT_RULE_FIELD_NUMBER;
+        hash = (53 * hash) + getPrebuiltRule().hashCode();
+        break;
+      case 0:
+      default:
+    }
     hash = (29 * hash) + getUnknownFields().hashCode();
     memoizedHashCode = hash;
     return hash;
@@ -479,6 +683,10 @@ public Builder clear() {
 
       ets_ = 0L;
 
+      rawJson_ = "";
+
+      conversionRuleCase_ = 0;
+      conversionRule_ = null;
       return this;
     }
 
@@ -506,10 +714,15 @@ public com.google.cloud.retail.v2beta.CollectUserEventRequest build() {
     public com.google.cloud.retail.v2beta.CollectUserEventRequest buildPartial() {
       com.google.cloud.retail.v2beta.CollectUserEventRequest result =
           new com.google.cloud.retail.v2beta.CollectUserEventRequest(this);
+      if (conversionRuleCase_ == 6) {
+        result.conversionRule_ = conversionRule_;
+      }
       result.parent_ = parent_;
       result.userEvent_ = userEvent_;
       result.uri_ = uri_;
       result.ets_ = ets_;
+      result.rawJson_ = rawJson_;
+      result.conversionRuleCase_ = conversionRuleCase_;
       onBuilt();
       return result;
     }
@@ -575,6 +788,23 @@ public Builder mergeFrom(com.google.cloud.retail.v2beta.CollectUserEventRequest
       if (other.getEts() != 0L) {
         setEts(other.getEts());
       }
+      if (!other.getRawJson().isEmpty()) {
+        rawJson_ = other.rawJson_;
+        onChanged();
+      }
+      switch (other.getConversionRuleCase()) {
+        case PREBUILT_RULE:
+          {
+            conversionRuleCase_ = 6;
+            conversionRule_ = other.conversionRule_;
+            onChanged();
+            break;
+          }
+        case CONVERSIONRULE_NOT_SET:
+          {
+            break;
+          }
+      }
       this.mergeUnknownFields(other.getUnknownFields());
       onChanged();
       return this;
@@ -625,6 +855,19 @@ public Builder mergeFrom(
 
                 break;
               } // case 32
+            case 42:
+              {
+                rawJson_ = input.readStringRequireUtf8();
+
+                break;
+              } // case 42
+            case 50:
+              {
+                java.lang.String s = input.readStringRequireUtf8();
+                conversionRuleCase_ = 6;
+                conversionRule_ = s;
+                break;
+              } // case 50
             default:
               {
                 if (!super.parseUnknownField(input, extensionRegistry, tag)) {
@@ -642,6 +885,160 @@ public Builder mergeFrom(
       return this;
     }
 
+    private int conversionRuleCase_ = 0;
+    private java.lang.Object conversionRule_;
+
+    public ConversionRuleCase getConversionRuleCase() {
+      return ConversionRuleCase.forNumber(conversionRuleCase_);
+    }
+
+    public Builder clearConversionRule() {
+      conversionRuleCase_ = 0;
+      conversionRule_ = null;
+      onChanged();
+      return this;
+    }
+
+    /**
+     *
+     *
+     * 
      +     * The prebuilt rule name that can convert a specific type of raw_json.
+     * For example: "default_schema/v1.0"
+     * 
      
+     *
+     * string prebuilt_rule = 6;
+     *
+     * @return Whether the prebuiltRule field is set.
+     */
+    @java.lang.Override
+    public boolean hasPrebuiltRule() {
+      return conversionRuleCase_ == 6;
+    }
+    /**
+     *
+     *
+     * 
      +     * The prebuilt rule name that can convert a specific type of raw_json.
+     * For example: "default_schema/v1.0"
+     * 
      
+     *
+     * string prebuilt_rule = 6;
+     *
+     * @return The prebuiltRule.
+     */
+    @java.lang.Override
+    public java.lang.String getPrebuiltRule() {
+      java.lang.Object ref = "";
+      if (conversionRuleCase_ == 6) {
+        ref = conversionRule_;
+      }
+      if (!(ref instanceof java.lang.String)) {
+        com.google.protobuf.ByteString bs = (com.google.protobuf.ByteString) ref;
+        java.lang.String s = bs.toStringUtf8();
+        if (conversionRuleCase_ == 6) {
+          conversionRule_ = s;
+        }
+        return s;
+      } else {
+        return (java.lang.String) ref;
+      }
+    }
+    /**
+     *
+     *
+     * 
      +     * The prebuilt rule name that can convert a specific type of raw_json.
+     * For example: "default_schema/v1.0"
+     * 
      
+     *
+     * string prebuilt_rule = 6;
+     *
+     * @return The bytes for prebuiltRule.
+     */
+    @java.lang.Override
+    public com.google.protobuf.ByteString getPrebuiltRuleBytes() {
+      java.lang.Object ref = "";
+      if (conversionRuleCase_ == 6) {
+        ref = conversionRule_;
+      }
+      if (ref instanceof String) {
+        com.google.protobuf.ByteString b =
+            com.google.protobuf.ByteString.copyFromUtf8((java.lang.String) ref);
+        if (conversionRuleCase_ == 6) {
+          conversionRule_ = b;
+        }
+        return b;
+      } else {
+        return (com.google.protobuf.ByteString) ref;
+      }
+    }
+    /**
+     *
+     *
+     * 
      +     * The prebuilt rule name that can convert a specific type of raw_json.
+     * For example: "default_schema/v1.0"
+     * 
      
+     *
+     * string prebuilt_rule = 6;
+     *
+     * @param value The prebuiltRule to set.
+     * @return This builder for chaining.
+     */
+    public Builder setPrebuiltRule(java.lang.String value) {
+      if (value == null) {
+        throw new NullPointerException();
+      }
+      conversionRuleCase_ = 6;
+      conversionRule_ = value;
+      onChanged();
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * The prebuilt rule name that can convert a specific type of raw_json.
+     * For example: "default_schema/v1.0"
+     * 
      
+     *
+     * string prebuilt_rule = 6;
+     *
+     * @return This builder for chaining.
+     */
+    public Builder clearPrebuiltRule() {
+      if (conversionRuleCase_ == 6) {
+        conversionRuleCase_ = 0;
+        conversionRule_ = null;
+        onChanged();
+      }
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * The prebuilt rule name that can convert a specific type of raw_json.
+     * For example: "default_schema/v1.0"
+     * 
      
+     *
+     * string prebuilt_rule = 6;
+     *
+     * @param value The bytes for prebuiltRule to set.
+     * @return This builder for chaining.
+     */
+    public Builder setPrebuiltRuleBytes(com.google.protobuf.ByteString value) {
+      if (value == null) {
+        throw new NullPointerException();
+      }
+      checkByteStringIsUtf8(value);
+      conversionRuleCase_ = 6;
+      conversionRule_ = value;
+      onChanged();
+      return this;
+    }
+
     private java.lang.Object parent_ = "";
     /**
      *
@@ -1043,6 +1440,127 @@ public Builder clearEts() {
       return this;
     }
 
+    private java.lang.Object rawJson_ = "";
+    /**
+     *
+     *
+     * 
      +     * An arbitrary serialized JSON string that contains necessary information
+     * that can comprise a user event. When this field is specified, the
+     * user_event field will be ignored. Note: line-delimited JSON is not
+     * supported, a single JSON only.
+     * 
      
+     *
+     * string raw_json = 5;
+     *
+     * @return The rawJson.
+     */
+    public java.lang.String getRawJson() {
+      java.lang.Object ref = rawJson_;
+      if (!(ref instanceof java.lang.String)) {
+        com.google.protobuf.ByteString bs = (com.google.protobuf.ByteString) ref;
+        java.lang.String s = bs.toStringUtf8();
+        rawJson_ = s;
+        return s;
+      } else {
+        return (java.lang.String) ref;
+      }
+    }
+    /**
+     *
+     *
+     * 
      +     * An arbitrary serialized JSON string that contains necessary information
+     * that can comprise a user event. When this field is specified, the
+     * user_event field will be ignored. Note: line-delimited JSON is not
+     * supported, a single JSON only.
+     * 
      
+     *
+     * string raw_json = 5;
+     *
+     * @return The bytes for rawJson.
+     */
+    public com.google.protobuf.ByteString getRawJsonBytes() {
+      java.lang.Object ref = rawJson_;
+      if (ref instanceof String) {
+        com.google.protobuf.ByteString b =
+            com.google.protobuf.ByteString.copyFromUtf8((java.lang.String) ref);
+        rawJson_ = b;
+        return b;
+      } else {
+        return (com.google.protobuf.ByteString) ref;
+      }
+    }
+    /**
+     *
+     *
+     * 
      +     * An arbitrary serialized JSON string that contains necessary information
+     * that can comprise a user event. When this field is specified, the
+     * user_event field will be ignored. Note: line-delimited JSON is not
+     * supported, a single JSON only.
+     * 
      
+     *
+     * string raw_json = 5;
+     *
+     * @param value The rawJson to set.
+     * @return This builder for chaining.
+     */
+    public Builder setRawJson(java.lang.String value) {
+      if (value == null) {
+        throw new NullPointerException();
+      }
+
+      rawJson_ = value;
+      onChanged();
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * An arbitrary serialized JSON string that contains necessary information
+     * that can comprise a user event. When this field is specified, the
+     * user_event field will be ignored. Note: line-delimited JSON is not
+     * supported, a single JSON only.
+     * 
      
+     *
+     * string raw_json = 5;
+     *
+     * @return This builder for chaining.
+     */
+    public Builder clearRawJson() {
+
+      rawJson_ = getDefaultInstance().getRawJson();
+      onChanged();
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * An arbitrary serialized JSON string that contains necessary information
+     * that can comprise a user event. When this field is specified, the
+     * user_event field will be ignored. Note: line-delimited JSON is not
+     * supported, a single JSON only.
+     * 
      
+     *
+     * string raw_json = 5;
+     *
+     * @param value The bytes for rawJson to set.
+     * @return This builder for chaining.
+     */
+    public Builder setRawJsonBytes(com.google.protobuf.ByteString value) {
+      if (value == null) {
+        throw new NullPointerException();
+      }
+      checkByteStringIsUtf8(value);
+
+      rawJson_ = value;
+      onChanged();
+      return this;
+    }
+
     @java.lang.Override
     public final Builder setUnknownFields(final com.google.protobuf.UnknownFieldSet unknownFields) {
       return super.setUnknownFields(unknownFields);
diff --git a/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/CollectUserEventRequestOrBuilder.java b/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/CollectUserEventRequestOrBuilder.java
index 566165c10588..3848550f9735 100644
--- a/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/CollectUserEventRequestOrBuilder.java
+++ b/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/CollectUserEventRequestOrBuilder.java
@@ -23,6 +23,46 @@ public interface CollectUserEventRequestOrBuilder
     // @@protoc_insertion_point(interface_extends:google.cloud.retail.v2beta.CollectUserEventRequest)
     com.google.protobuf.MessageOrBuilder {
 
+  /**
+   *
+   *
+   * 
      +   * The prebuilt rule name that can convert a specific type of raw_json.
+   * For example: "default_schema/v1.0"
+   * 
      
+   *
+   * string prebuilt_rule = 6;
+   *
+   * @return Whether the prebuiltRule field is set.
+   */
+  boolean hasPrebuiltRule();
+  /**
+   *
+   *
+   * 
      +   * The prebuilt rule name that can convert a specific type of raw_json.
+   * For example: "default_schema/v1.0"
+   * 
      
+   *
+   * string prebuilt_rule = 6;
+   *
+   * @return The prebuiltRule.
+   */
+  java.lang.String getPrebuiltRule();
+  /**
+   *
+   *
+   * 
      +   * The prebuilt rule name that can convert a specific type of raw_json.
+   * For example: "default_schema/v1.0"
+   * 
      
+   *
+   * string prebuilt_rule = 6;
+   *
+   * @return The bytes for prebuiltRule.
+   */
+  com.google.protobuf.ByteString getPrebuiltRuleBytes();
+
   /**
    *
    *
@@ -122,4 +162,38 @@ public interface CollectUserEventRequestOrBuilder
    * @return The ets.
    */
   long getEts();
+
+  /**
+   *
+   *
+   * 
      +   * An arbitrary serialized JSON string that contains necessary information
+   * that can comprise a user event. When this field is specified, the
+   * user_event field will be ignored. Note: line-delimited JSON is not
+   * supported, a single JSON only.
+   * 
      
+   *
+   * string raw_json = 5;
+   *
+   * @return The rawJson.
+   */
+  java.lang.String getRawJson();
+  /**
+   *
+   *
+   * 
      +   * An arbitrary serialized JSON string that contains necessary information
+   * that can comprise a user event. When this field is specified, the
+   * user_event field will be ignored. Note: line-delimited JSON is not
+   * supported, a single JSON only.
+   * 
      
+   *
+   * string raw_json = 5;
+   *
+   * @return The bytes for rawJson.
+   */
+  com.google.protobuf.ByteString getRawJsonBytes();
+
+  public com.google.cloud.retail.v2beta.CollectUserEventRequest.ConversionRuleCase
+      getConversionRuleCase();
 }
diff --git a/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/CompleteQueryRequest.java b/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/CompleteQueryRequest.java
index 3222996d1ebc..241bf617f1fe 100644
--- a/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/CompleteQueryRequest.java
+++ b/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/CompleteQueryRequest.java
@@ -334,8 +334,9 @@ public com.google.protobuf.ByteString getLanguageCodesBytes(int index) {
    *
    *
    * 
      -   * The device type context for completion suggestions.
-   * It is useful to apply different suggestions on different device types, e.g.
+   * The device type context for completion suggestions. We recommend that you
+   * leave this field empty.
+   * It can apply different suggestions on different device types, e.g.
    * `DESKTOP`, `MOBILE`. If it is empty, the suggestions are across all device
    * types.
    * Supported formats:
@@ -365,8 +366,9 @@ public java.lang.String getDeviceType() {
    *
    *
    * 
      -   * The device type context for completion suggestions.
-   * It is useful to apply different suggestions on different device types, e.g.
+   * The device type context for completion suggestions. We recommend that you
+   * leave this field empty.
+   * It can apply different suggestions on different device types, e.g.
    * `DESKTOP`, `MOBILE`. If it is empty, the suggestions are across all device
    * types.
    * Supported formats:
@@ -1568,8 +1570,9 @@ public Builder addLanguageCodesBytes(com.google.protobuf.ByteString value) {
      *
      *
      * 
      -     * The device type context for completion suggestions.
-     * It is useful to apply different suggestions on different device types, e.g.
+     * The device type context for completion suggestions. We recommend that you
+     * leave this field empty.
+     * It can apply different suggestions on different device types, e.g.
      * `DESKTOP`, `MOBILE`. If it is empty, the suggestions are across all device
      * types.
      * Supported formats:
@@ -1598,8 +1601,9 @@ public java.lang.String getDeviceType() {
      *
      *
      * 
      -     * The device type context for completion suggestions.
-     * It is useful to apply different suggestions on different device types, e.g.
+     * The device type context for completion suggestions. We recommend that you
+     * leave this field empty.
+     * It can apply different suggestions on different device types, e.g.
      * `DESKTOP`, `MOBILE`. If it is empty, the suggestions are across all device
      * types.
      * Supported formats:
@@ -1628,8 +1632,9 @@ public com.google.protobuf.ByteString getDeviceTypeBytes() {
      *
      *
      * 
      -     * The device type context for completion suggestions.
-     * It is useful to apply different suggestions on different device types, e.g.
+     * The device type context for completion suggestions. We recommend that you
+     * leave this field empty.
+     * It can apply different suggestions on different device types, e.g.
      * `DESKTOP`, `MOBILE`. If it is empty, the suggestions are across all device
      * types.
      * Supported formats:
@@ -1657,8 +1662,9 @@ public Builder setDeviceType(java.lang.String value) {
      *
      *
      * 
      -     * The device type context for completion suggestions.
-     * It is useful to apply different suggestions on different device types, e.g.
+     * The device type context for completion suggestions. We recommend that you
+     * leave this field empty.
+     * It can apply different suggestions on different device types, e.g.
      * `DESKTOP`, `MOBILE`. If it is empty, the suggestions are across all device
      * types.
      * Supported formats:
@@ -1682,8 +1688,9 @@ public Builder clearDeviceType() {
      *
      *
      * 
      -     * The device type context for completion suggestions.
-     * It is useful to apply different suggestions on different device types, e.g.
+     * The device type context for completion suggestions. We recommend that you
+     * leave this field empty.
+     * It can apply different suggestions on different device types, e.g.
      * `DESKTOP`, `MOBILE`. If it is empty, the suggestions are across all device
      * types.
      * Supported formats:
diff --git a/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/CompleteQueryRequestOrBuilder.java b/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/CompleteQueryRequestOrBuilder.java
index f683a3d9e402..b6cae09d60e3 100644
--- a/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/CompleteQueryRequestOrBuilder.java
+++ b/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/CompleteQueryRequestOrBuilder.java
@@ -201,8 +201,9 @@ public interface CompleteQueryRequestOrBuilder
    *
    *
    * 
      -   * The device type context for completion suggestions.
-   * It is useful to apply different suggestions on different device types, e.g.
+   * The device type context for completion suggestions. We recommend that you
+   * leave this field empty.
+   * It can apply different suggestions on different device types, e.g.
    * `DESKTOP`, `MOBILE`. If it is empty, the suggestions are across all device
    * types.
    * Supported formats:
@@ -221,8 +222,9 @@ public interface CompleteQueryRequestOrBuilder
    *
    *
    * 
      -   * The device type context for completion suggestions.
-   * It is useful to apply different suggestions on different device types, e.g.
+   * The device type context for completion suggestions. We recommend that you
+   * leave this field empty.
+   * It can apply different suggestions on different device types, e.g.
    * `DESKTOP`, `MOBILE`. If it is empty, the suggestions are across all device
    * types.
    * Supported formats:
diff --git a/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/Control.java b/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/Control.java
index c67c1faa7c5c..dc177b002465 100644
--- a/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/Control.java
+++ b/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/Control.java
@@ -356,8 +356,8 @@ public com.google.protobuf.ByteString getDisplayNameBytes() {
    *
    * 
          * Output only. List of [serving
-   * configuration][google.cloud.retail.v2beta.ServingConfig] ids that are
-   * associated with this control in the same
+   * config][google.cloud.retail.v2beta.ServingConfig] ids that are associated
+   * with this control in the same
    * [Catalog][google.cloud.retail.v2beta.Catalog].
    * Note the association is managed via the
    * [ServingConfig][google.cloud.retail.v2beta.ServingConfig], this is an
@@ -378,8 +378,8 @@ public com.google.protobuf.ProtocolStringList getAssociatedServingConfigIdsList(
    *
    * 
          * Output only. List of [serving
-   * configuration][google.cloud.retail.v2beta.ServingConfig] ids that are
-   * associated with this control in the same
+   * config][google.cloud.retail.v2beta.ServingConfig] ids that are associated
+   * with this control in the same
    * [Catalog][google.cloud.retail.v2beta.Catalog].
    * Note the association is managed via the
    * [ServingConfig][google.cloud.retail.v2beta.ServingConfig], this is an
@@ -400,8 +400,8 @@ public int getAssociatedServingConfigIdsCount() {
    *
    * 
          * Output only. List of [serving
-   * configuration][google.cloud.retail.v2beta.ServingConfig] ids that are
-   * associated with this control in the same
+   * config][google.cloud.retail.v2beta.ServingConfig] ids that are associated
+   * with this control in the same
    * [Catalog][google.cloud.retail.v2beta.Catalog].
    * Note the association is managed via the
    * [ServingConfig][google.cloud.retail.v2beta.ServingConfig], this is an
@@ -423,8 +423,8 @@ public java.lang.String getAssociatedServingConfigIds(int index) {
    *
    * 
          * Output only. List of [serving
-   * configuration][google.cloud.retail.v2beta.ServingConfig] ids that are
-   * associated with this control in the same
+   * config][google.cloud.retail.v2beta.ServingConfig] ids that are associated
+   * with this control in the same
    * [Catalog][google.cloud.retail.v2beta.Catalog].
    * Note the association is managed via the
    * [ServingConfig][google.cloud.retail.v2beta.ServingConfig], this is an
@@ -2047,8 +2047,8 @@ private void ensureAssociatedServingConfigIdsIsMutable() {
      *
      * 
            * Output only. List of [serving
-     * configuration][google.cloud.retail.v2beta.ServingConfig] ids that are
-     * associated with this control in the same
+     * config][google.cloud.retail.v2beta.ServingConfig] ids that are associated
+     * with this control in the same
      * [Catalog][google.cloud.retail.v2beta.Catalog].
      * Note the association is managed via the
      * [ServingConfig][google.cloud.retail.v2beta.ServingConfig], this is an
@@ -2069,8 +2069,8 @@ public com.google.protobuf.ProtocolStringList getAssociatedServingConfigIdsList(
      *
      * 
            * Output only. List of [serving
-     * configuration][google.cloud.retail.v2beta.ServingConfig] ids that are
-     * associated with this control in the same
+     * config][google.cloud.retail.v2beta.ServingConfig] ids that are associated
+     * with this control in the same
      * [Catalog][google.cloud.retail.v2beta.Catalog].
      * Note the association is managed via the
      * [ServingConfig][google.cloud.retail.v2beta.ServingConfig], this is an
@@ -2091,8 +2091,8 @@ public int getAssociatedServingConfigIdsCount() {
      *
      * 
            * Output only. List of [serving
-     * configuration][google.cloud.retail.v2beta.ServingConfig] ids that are
-     * associated with this control in the same
+     * config][google.cloud.retail.v2beta.ServingConfig] ids that are associated
+     * with this control in the same
      * [Catalog][google.cloud.retail.v2beta.Catalog].
      * Note the association is managed via the
      * [ServingConfig][google.cloud.retail.v2beta.ServingConfig], this is an
@@ -2114,8 +2114,8 @@ public java.lang.String getAssociatedServingConfigIds(int index) {
      *
      * 
            * Output only. List of [serving
-     * configuration][google.cloud.retail.v2beta.ServingConfig] ids that are
-     * associated with this control in the same
+     * config][google.cloud.retail.v2beta.ServingConfig] ids that are associated
+     * with this control in the same
      * [Catalog][google.cloud.retail.v2beta.Catalog].
      * Note the association is managed via the
      * [ServingConfig][google.cloud.retail.v2beta.ServingConfig], this is an
@@ -2137,8 +2137,8 @@ public com.google.protobuf.ByteString getAssociatedServingConfigIdsBytes(int ind
      *
      * 
            * Output only. List of [serving
-     * configuration][google.cloud.retail.v2beta.ServingConfig] ids that are
-     * associated with this control in the same
+     * config][google.cloud.retail.v2beta.ServingConfig] ids that are associated
+     * with this control in the same
      * [Catalog][google.cloud.retail.v2beta.Catalog].
      * Note the association is managed via the
      * [ServingConfig][google.cloud.retail.v2beta.ServingConfig], this is an
@@ -2167,8 +2167,8 @@ public Builder setAssociatedServingConfigIds(int index, java.lang.String value)
      *
      * 
            * Output only. List of [serving
-     * configuration][google.cloud.retail.v2beta.ServingConfig] ids that are
-     * associated with this control in the same
+     * config][google.cloud.retail.v2beta.ServingConfig] ids that are associated
+     * with this control in the same
      * [Catalog][google.cloud.retail.v2beta.Catalog].
      * Note the association is managed via the
      * [ServingConfig][google.cloud.retail.v2beta.ServingConfig], this is an
@@ -2196,8 +2196,8 @@ public Builder addAssociatedServingConfigIds(java.lang.String value) {
      *
      * 
            * Output only. List of [serving
-     * configuration][google.cloud.retail.v2beta.ServingConfig] ids that are
-     * associated with this control in the same
+     * config][google.cloud.retail.v2beta.ServingConfig] ids that are associated
+     * with this control in the same
      * [Catalog][google.cloud.retail.v2beta.Catalog].
      * Note the association is managed via the
      * [ServingConfig][google.cloud.retail.v2beta.ServingConfig], this is an
@@ -2222,8 +2222,8 @@ public Builder addAllAssociatedServingConfigIds(java.lang.Iterable
      * Output only. List of [serving
-     * configuration][google.cloud.retail.v2beta.ServingConfig] ids that are
-     * associated with this control in the same
+     * config][google.cloud.retail.v2beta.ServingConfig] ids that are associated
+     * with this control in the same
      * [Catalog][google.cloud.retail.v2beta.Catalog].
      * Note the association is managed via the
      * [ServingConfig][google.cloud.retail.v2beta.ServingConfig], this is an
@@ -2247,8 +2247,8 @@ public Builder clearAssociatedServingConfigIds() {
      *
      * 
            * Output only. List of [serving
-     * configuration][google.cloud.retail.v2beta.ServingConfig] ids that are
-     * associated with this control in the same
+     * config][google.cloud.retail.v2beta.ServingConfig] ids that are associated
+     * with this control in the same
      * [Catalog][google.cloud.retail.v2beta.Catalog].
      * Note the association is managed via the
      * [ServingConfig][google.cloud.retail.v2beta.ServingConfig], this is an
diff --git a/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/ControlOrBuilder.java b/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/ControlOrBuilder.java
index c31de227a140..1b85d1004e8d 100644
--- a/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/ControlOrBuilder.java
+++ b/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/ControlOrBuilder.java
@@ -176,8 +176,8 @@ public interface ControlOrBuilder
    *
    * 
          * Output only. List of [serving
-   * configuration][google.cloud.retail.v2beta.ServingConfig] ids that are
-   * associated with this control in the same
+   * config][google.cloud.retail.v2beta.ServingConfig] ids that are associated
+   * with this control in the same
    * [Catalog][google.cloud.retail.v2beta.Catalog].
    * Note the association is managed via the
    * [ServingConfig][google.cloud.retail.v2beta.ServingConfig], this is an
@@ -196,8 +196,8 @@ public interface ControlOrBuilder
    *
    * 
          * Output only. List of [serving
-   * configuration][google.cloud.retail.v2beta.ServingConfig] ids that are
-   * associated with this control in the same
+   * config][google.cloud.retail.v2beta.ServingConfig] ids that are associated
+   * with this control in the same
    * [Catalog][google.cloud.retail.v2beta.Catalog].
    * Note the association is managed via the
    * [ServingConfig][google.cloud.retail.v2beta.ServingConfig], this is an
@@ -216,8 +216,8 @@ public interface ControlOrBuilder
    *
    * 
          * Output only. List of [serving
-   * configuration][google.cloud.retail.v2beta.ServingConfig] ids that are
-   * associated with this control in the same
+   * config][google.cloud.retail.v2beta.ServingConfig] ids that are associated
+   * with this control in the same
    * [Catalog][google.cloud.retail.v2beta.Catalog].
    * Note the association is managed via the
    * [ServingConfig][google.cloud.retail.v2beta.ServingConfig], this is an
@@ -237,8 +237,8 @@ public interface ControlOrBuilder
    *
    * 
          * Output only. List of [serving
-   * configuration][google.cloud.retail.v2beta.ServingConfig] ids that are
-   * associated with this control in the same
+   * config][google.cloud.retail.v2beta.ServingConfig] ids that are associated
+   * with this control in the same
    * [Catalog][google.cloud.retail.v2beta.Catalog].
    * Note the association is managed via the
    * [ServingConfig][google.cloud.retail.v2beta.ServingConfig], this is an
diff --git a/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/CustomAttribute.java b/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/CustomAttribute.java
index cb9e6f5f35df..800b8d1fd184 100644
--- a/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/CustomAttribute.java
+++ b/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/CustomAttribute.java
@@ -239,7 +239,7 @@ public double getNumbers(int index) {
    * optional bool searchable = 3 [deprecated = true];
    *
    * @deprecated google.cloud.retail.v2beta.CustomAttribute.searchable is deprecated. See
-   *     google/cloud/retail/v2beta/common.proto;l=425
+   *     google/cloud/retail/v2beta/common.proto;l=426
    * @return Whether the searchable field is set.
    */
   @java.lang.Override
@@ -268,7 +268,7 @@ public boolean hasSearchable() {
    * optional bool searchable = 3 [deprecated = true];
    *
    * @deprecated google.cloud.retail.v2beta.CustomAttribute.searchable is deprecated. See
-   *     google/cloud/retail/v2beta/common.proto;l=425
+   *     google/cloud/retail/v2beta/common.proto;l=426
    * @return The searchable.
    */
   @java.lang.Override
@@ -305,7 +305,7 @@ public boolean getSearchable() {
    * optional bool indexable = 4 [deprecated = true];
    *
    * @deprecated google.cloud.retail.v2beta.CustomAttribute.indexable is deprecated. See
-   *     google/cloud/retail/v2beta/common.proto;l=446
+   *     google/cloud/retail/v2beta/common.proto;l=447
    * @return Whether the indexable field is set.
    */
   @java.lang.Override
@@ -339,7 +339,7 @@ public boolean hasIndexable() {
    * optional bool indexable = 4 [deprecated = true];
    *
    * @deprecated google.cloud.retail.v2beta.CustomAttribute.indexable is deprecated. See
-   *     google/cloud/retail/v2beta/common.proto;l=446
+   *     google/cloud/retail/v2beta/common.proto;l=447
    * @return The indexable.
    */
   @java.lang.Override
@@ -1215,7 +1215,7 @@ public Builder clearNumbers() {
      * optional bool searchable = 3 [deprecated = true];
      *
      * @deprecated google.cloud.retail.v2beta.CustomAttribute.searchable is deprecated. See
-     *     google/cloud/retail/v2beta/common.proto;l=425
+     *     google/cloud/retail/v2beta/common.proto;l=426
      * @return Whether the searchable field is set.
      */
     @java.lang.Override
@@ -1244,7 +1244,7 @@ public boolean hasSearchable() {
      * optional bool searchable = 3 [deprecated = true];
      *
      * @deprecated google.cloud.retail.v2beta.CustomAttribute.searchable is deprecated. See
-     *     google/cloud/retail/v2beta/common.proto;l=425
+     *     google/cloud/retail/v2beta/common.proto;l=426
      * @return The searchable.
      */
     @java.lang.Override
@@ -1273,7 +1273,7 @@ public boolean getSearchable() {
      * optional bool searchable = 3 [deprecated = true];
      *
      * @deprecated google.cloud.retail.v2beta.CustomAttribute.searchable is deprecated. See
-     *     google/cloud/retail/v2beta/common.proto;l=425
+     *     google/cloud/retail/v2beta/common.proto;l=426
      * @param value The searchable to set.
      * @return This builder for chaining.
      */
@@ -1305,7 +1305,7 @@ public Builder setSearchable(boolean value) {
      * optional bool searchable = 3 [deprecated = true];
      *
      * @deprecated google.cloud.retail.v2beta.CustomAttribute.searchable is deprecated. See
-     *     google/cloud/retail/v2beta/common.proto;l=425
+     *     google/cloud/retail/v2beta/common.proto;l=426
      * @return This builder for chaining.
      */
     @java.lang.Deprecated
@@ -1343,7 +1343,7 @@ public Builder clearSearchable() {
      * optional bool indexable = 4 [deprecated = true];
      *
      * @deprecated google.cloud.retail.v2beta.CustomAttribute.indexable is deprecated. See
-     *     google/cloud/retail/v2beta/common.proto;l=446
+     *     google/cloud/retail/v2beta/common.proto;l=447
      * @return Whether the indexable field is set.
      */
     @java.lang.Override
@@ -1377,7 +1377,7 @@ public boolean hasIndexable() {
      * optional bool indexable = 4 [deprecated = true];
      *
      * @deprecated google.cloud.retail.v2beta.CustomAttribute.indexable is deprecated. See
-     *     google/cloud/retail/v2beta/common.proto;l=446
+     *     google/cloud/retail/v2beta/common.proto;l=447
      * @return The indexable.
      */
     @java.lang.Override
@@ -1411,7 +1411,7 @@ public boolean getIndexable() {
      * optional bool indexable = 4 [deprecated = true];
      *
      * @deprecated google.cloud.retail.v2beta.CustomAttribute.indexable is deprecated. See
-     *     google/cloud/retail/v2beta/common.proto;l=446
+     *     google/cloud/retail/v2beta/common.proto;l=447
      * @param value The indexable to set.
      * @return This builder for chaining.
      */
@@ -1448,7 +1448,7 @@ public Builder setIndexable(boolean value) {
      * optional bool indexable = 4 [deprecated = true];
      *
      * @deprecated google.cloud.retail.v2beta.CustomAttribute.indexable is deprecated. See
-     *     google/cloud/retail/v2beta/common.proto;l=446
+     *     google/cloud/retail/v2beta/common.proto;l=447
      * @return This builder for chaining.
      */
     @java.lang.Deprecated
diff --git a/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/CustomAttributeOrBuilder.java b/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/CustomAttributeOrBuilder.java
index cf0373c9562b..eebadf2decfc 100644
--- a/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/CustomAttributeOrBuilder.java
+++ b/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/CustomAttributeOrBuilder.java
@@ -169,7 +169,7 @@ public interface CustomAttributeOrBuilder
    * optional bool searchable = 3 [deprecated = true];
    *
    * @deprecated google.cloud.retail.v2beta.CustomAttribute.searchable is deprecated. See
-   *     google/cloud/retail/v2beta/common.proto;l=425
+   *     google/cloud/retail/v2beta/common.proto;l=426
    * @return Whether the searchable field is set.
    */
   @java.lang.Deprecated
@@ -195,7 +195,7 @@ public interface CustomAttributeOrBuilder
    * optional bool searchable = 3 [deprecated = true];
    *
    * @deprecated google.cloud.retail.v2beta.CustomAttribute.searchable is deprecated. See
-   *     google/cloud/retail/v2beta/common.proto;l=425
+   *     google/cloud/retail/v2beta/common.proto;l=426
    * @return The searchable.
    */
   @java.lang.Deprecated
@@ -227,7 +227,7 @@ public interface CustomAttributeOrBuilder
    * optional bool indexable = 4 [deprecated = true];
    *
    * @deprecated google.cloud.retail.v2beta.CustomAttribute.indexable is deprecated. See
-   *     google/cloud/retail/v2beta/common.proto;l=446
+   *     google/cloud/retail/v2beta/common.proto;l=447
    * @return Whether the indexable field is set.
    */
   @java.lang.Deprecated
@@ -258,7 +258,7 @@ public interface CustomAttributeOrBuilder
    * optional bool indexable = 4 [deprecated = true];
    *
    * @deprecated google.cloud.retail.v2beta.CustomAttribute.indexable is deprecated. See
-   *     google/cloud/retail/v2beta/common.proto;l=446
+   *     google/cloud/retail/v2beta/common.proto;l=447
    * @return The indexable.
    */
   @java.lang.Deprecated
diff --git a/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/ExportConfigProto.java b/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/ExportConfigProto.java
index e83032696c13..8ec79ff24519 100644
--- a/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/ExportConfigProto.java
+++ b/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/ExportConfigProto.java
@@ -51,6 +51,10 @@ public static void registerAllExtensions(com.google.protobuf.ExtensionRegistry r
       internal_static_google_cloud_retail_v2beta_BigQueryOutputResult_descriptor;
   static final com.google.protobuf.GeneratedMessageV3.FieldAccessorTable
       internal_static_google_cloud_retail_v2beta_BigQueryOutputResult_fieldAccessorTable;
+  static final com.google.protobuf.Descriptors.Descriptor
+      internal_static_google_cloud_retail_v2beta_GcsOutputResult_descriptor;
+  static final com.google.protobuf.GeneratedMessageV3.FieldAccessorTable
+      internal_static_google_cloud_retail_v2beta_GcsOutputResult_fieldAccessorTable;
 
   public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
     return descriptor;
@@ -79,17 +83,19 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
           + ".Status\022E\n\rerrors_config\030\002 \001(\0132..google."
           + "cloud.retail.v2beta.ExportErrorsConfig\022?"
           + "\n\routput_result\030\003 \001(\0132(.google.cloud.ret"
-          + "ail.v2beta.OutputResult\"Y\n\014OutputResult\022"
-          + "I\n\017bigquery_result\030\001 \003(\01320.google.cloud."
-          + "retail.v2beta.BigQueryOutputResult\"<\n\024Bi"
-          + "gQueryOutputResult\022\022\n\ndataset_id\030\001 \001(\t\022\020"
-          + "\n\010table_id\030\002 \001(\tB\332\001\n\036com.google.cloud.re"
-          + "tail.v2betaB\021ExportConfigProtoP\001Z@google"
-          + ".golang.org/genproto/googleapis/cloud/re"
-          + "tail/v2beta;retail\242\002\006RETAIL\252\002\032Google.Clo"
-          + "ud.Retail.V2Beta\312\002\032Google\\Cloud\\Retail\\V"
-          + "2beta\352\002\035Google::Cloud::Retail::V2betab\006p"
-          + "roto3"
+          + "ail.v2beta.OutputResult\"\232\001\n\014OutputResult"
+          + "\022I\n\017bigquery_result\030\001 \003(\01320.google.cloud"
+          + ".retail.v2beta.BigQueryOutputResult\022?\n\ng"
+          + "cs_result\030\002 \003(\0132+.google.cloud.retail.v2"
+          + "beta.GcsOutputResult\"<\n\024BigQueryOutputRe"
+          + "sult\022\022\n\ndataset_id\030\001 \001(\t\022\020\n\010table_id\030\002 \001"
+          + "(\t\"%\n\017GcsOutputResult\022\022\n\noutput_uri\030\001 \001("
+          + "\tB\332\001\n\036com.google.cloud.retail.v2betaB\021Ex"
+          + "portConfigProtoP\001Z@google.golang.org/gen"
+          + "proto/googleapis/cloud/retail/v2beta;ret"
+          + "ail\242\002\006RETAIL\252\002\032Google.Cloud.Retail.V2Bet"
+          + "a\312\002\032Google\\Cloud\\Retail\\V2beta\352\002\035Google:"
+          + ":Cloud::Retail::V2betab\006proto3"
     };
     descriptor =
         com.google.protobuf.Descriptors.FileDescriptor.internalBuildGeneratedFileFrom(
@@ -138,7 +144,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
         new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable(
             internal_static_google_cloud_retail_v2beta_OutputResult_descriptor,
             new java.lang.String[] {
-              "BigqueryResult",
+              "BigqueryResult", "GcsResult",
             });
     internal_static_google_cloud_retail_v2beta_BigQueryOutputResult_descriptor =
         getDescriptor().getMessageTypes().get(5);
@@ -148,6 +154,14 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
             new java.lang.String[] {
               "DatasetId", "TableId",
             });
+    internal_static_google_cloud_retail_v2beta_GcsOutputResult_descriptor =
+        getDescriptor().getMessageTypes().get(6);
+    internal_static_google_cloud_retail_v2beta_GcsOutputResult_fieldAccessorTable =
+        new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable(
+            internal_static_google_cloud_retail_v2beta_GcsOutputResult_descriptor,
+            new java.lang.String[] {
+              "OutputUri",
+            });
     com.google.api.FieldBehaviorProto.getDescriptor();
     com.google.api.ResourceProto.getDescriptor();
     com.google.protobuf.TimestampProto.getDescriptor();
diff --git a/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/GcsOutputResult.java b/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/GcsOutputResult.java
new file mode 100644
index 000000000000..e3b0caef3ce6
--- /dev/null
+++ b/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/GcsOutputResult.java
@@ -0,0 +1,614 @@
+/*
+ * Copyright 2020 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+// Generated by the protocol buffer compiler.  DO NOT EDIT!
+// source: google/cloud/retail/v2beta/export_config.proto
+
+package com.google.cloud.retail.v2beta;
+
+/**
+ *
+ *
+ * 
      + * A Gcs output result.
+ * 
      
+ *
+ * Protobuf type {@code google.cloud.retail.v2beta.GcsOutputResult}
+ */
+public final class GcsOutputResult extends com.google.protobuf.GeneratedMessageV3
+    implements
+    // @@protoc_insertion_point(message_implements:google.cloud.retail.v2beta.GcsOutputResult)
+    GcsOutputResultOrBuilder {
+  private static final long serialVersionUID = 0L;
+  // Use GcsOutputResult.newBuilder() to construct.
+  private GcsOutputResult(com.google.protobuf.GeneratedMessageV3.Builder builder) {
+    super(builder);
+  }
+
+  private GcsOutputResult() {
+    outputUri_ = "";
+  }
+
+  @java.lang.Override
+  @SuppressWarnings({"unused"})
+  protected java.lang.Object newInstance(UnusedPrivateParameter unused) {
+    return new GcsOutputResult();
+  }
+
+  @java.lang.Override
+  public final com.google.protobuf.UnknownFieldSet getUnknownFields() {
+    return this.unknownFields;
+  }
+
+  public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
+    return com.google.cloud.retail.v2beta.ExportConfigProto
+        .internal_static_google_cloud_retail_v2beta_GcsOutputResult_descriptor;
+  }
+
+  @java.lang.Override
+  protected com.google.protobuf.GeneratedMessageV3.FieldAccessorTable
+      internalGetFieldAccessorTable() {
+    return com.google.cloud.retail.v2beta.ExportConfigProto
+        .internal_static_google_cloud_retail_v2beta_GcsOutputResult_fieldAccessorTable
+        .ensureFieldAccessorsInitialized(
+            com.google.cloud.retail.v2beta.GcsOutputResult.class,
+            com.google.cloud.retail.v2beta.GcsOutputResult.Builder.class);
+  }
+
+  public static final int OUTPUT_URI_FIELD_NUMBER = 1;
+  private volatile java.lang.Object outputUri_;
+  /**
+   *
+   *
+   * 
      +   * The uri of Gcs output
+   * 
      
+   *
+   * string output_uri = 1;
+   *
+   * @return The outputUri.
+   */
+  @java.lang.Override
+  public java.lang.String getOutputUri() {
+    java.lang.Object ref = outputUri_;
+    if (ref instanceof java.lang.String) {
+      return (java.lang.String) ref;
+    } else {
+      com.google.protobuf.ByteString bs = (com.google.protobuf.ByteString) ref;
+      java.lang.String s = bs.toStringUtf8();
+      outputUri_ = s;
+      return s;
+    }
+  }
+  /**
+   *
+   *
+   * 
      +   * The uri of Gcs output
+   * 
      
+   *
+   * string output_uri = 1;
+   *
+   * @return The bytes for outputUri.
+   */
+  @java.lang.Override
+  public com.google.protobuf.ByteString getOutputUriBytes() {
+    java.lang.Object ref = outputUri_;
+    if (ref instanceof java.lang.String) {
+      com.google.protobuf.ByteString b =
+          com.google.protobuf.ByteString.copyFromUtf8((java.lang.String) ref);
+      outputUri_ = b;
+      return b;
+    } else {
+      return (com.google.protobuf.ByteString) ref;
+    }
+  }
+
+  private byte memoizedIsInitialized = -1;
+
+  @java.lang.Override
+  public final boolean isInitialized() {
+    byte isInitialized = memoizedIsInitialized;
+    if (isInitialized == 1) return true;
+    if (isInitialized == 0) return false;
+
+    memoizedIsInitialized = 1;
+    return true;
+  }
+
+  @java.lang.Override
+  public void writeTo(com.google.protobuf.CodedOutputStream output) throws java.io.IOException {
+    if (!com.google.protobuf.GeneratedMessageV3.isStringEmpty(outputUri_)) {
+      com.google.protobuf.GeneratedMessageV3.writeString(output, 1, outputUri_);
+    }
+    getUnknownFields().writeTo(output);
+  }
+
+  @java.lang.Override
+  public int getSerializedSize() {
+    int size = memoizedSize;
+    if (size != -1) return size;
+
+    size = 0;
+    if (!com.google.protobuf.GeneratedMessageV3.isStringEmpty(outputUri_)) {
+      size += com.google.protobuf.GeneratedMessageV3.computeStringSize(1, outputUri_);
+    }
+    size += getUnknownFields().getSerializedSize();
+    memoizedSize = size;
+    return size;
+  }
+
+  @java.lang.Override
+  public boolean equals(final java.lang.Object obj) {
+    if (obj == this) {
+      return true;
+    }
+    if (!(obj instanceof com.google.cloud.retail.v2beta.GcsOutputResult)) {
+      return super.equals(obj);
+    }
+    com.google.cloud.retail.v2beta.GcsOutputResult other =
+        (com.google.cloud.retail.v2beta.GcsOutputResult) obj;
+
+    if (!getOutputUri().equals(other.getOutputUri())) return false;
+    if (!getUnknownFields().equals(other.getUnknownFields())) return false;
+    return true;
+  }
+
+  @java.lang.Override
+  public int hashCode() {
+    if (memoizedHashCode != 0) {
+      return memoizedHashCode;
+    }
+    int hash = 41;
+    hash = (19 * hash) + getDescriptor().hashCode();
+    hash = (37 * hash) + OUTPUT_URI_FIELD_NUMBER;
+    hash = (53 * hash) + getOutputUri().hashCode();
+    hash = (29 * hash) + getUnknownFields().hashCode();
+    memoizedHashCode = hash;
+    return hash;
+  }
+
+  public static com.google.cloud.retail.v2beta.GcsOutputResult parseFrom(java.nio.ByteBuffer data)
+      throws com.google.protobuf.InvalidProtocolBufferException {
+    return PARSER.parseFrom(data);
+  }
+
+  public static com.google.cloud.retail.v2beta.GcsOutputResult parseFrom(
+      java.nio.ByteBuffer data, com.google.protobuf.ExtensionRegistryLite extensionRegistry)
+      throws com.google.protobuf.InvalidProtocolBufferException {
+    return PARSER.parseFrom(data, extensionRegistry);
+  }
+
+  public static com.google.cloud.retail.v2beta.GcsOutputResult parseFrom(
+      com.google.protobuf.ByteString data)
+      throws com.google.protobuf.InvalidProtocolBufferException {
+    return PARSER.parseFrom(data);
+  }
+
+  public static com.google.cloud.retail.v2beta.GcsOutputResult parseFrom(
+      com.google.protobuf.ByteString data,
+      com.google.protobuf.ExtensionRegistryLite extensionRegistry)
+      throws com.google.protobuf.InvalidProtocolBufferException {
+    return PARSER.parseFrom(data, extensionRegistry);
+  }
+
+  public static com.google.cloud.retail.v2beta.GcsOutputResult parseFrom(byte[] data)
+      throws com.google.protobuf.InvalidProtocolBufferException {
+    return PARSER.parseFrom(data);
+  }
+
+  public static com.google.cloud.retail.v2beta.GcsOutputResult parseFrom(
+      byte[] data, com.google.protobuf.ExtensionRegistryLite extensionRegistry)
+      throws com.google.protobuf.InvalidProtocolBufferException {
+    return PARSER.parseFrom(data, extensionRegistry);
+  }
+
+  public static com.google.cloud.retail.v2beta.GcsOutputResult parseFrom(java.io.InputStream input)
+      throws java.io.IOException {
+    return com.google.protobuf.GeneratedMessageV3.parseWithIOException(PARSER, input);
+  }
+
+  public static com.google.cloud.retail.v2beta.GcsOutputResult parseFrom(
+      java.io.InputStream input, com.google.protobuf.ExtensionRegistryLite extensionRegistry)
+      throws java.io.IOException {
+    return com.google.protobuf.GeneratedMessageV3.parseWithIOException(
+        PARSER, input, extensionRegistry);
+  }
+
+  public static com.google.cloud.retail.v2beta.GcsOutputResult parseDelimitedFrom(
+      java.io.InputStream input) throws java.io.IOException {
+    return com.google.protobuf.GeneratedMessageV3.parseDelimitedWithIOException(PARSER, input);
+  }
+
+  public static com.google.cloud.retail.v2beta.GcsOutputResult parseDelimitedFrom(
+      java.io.InputStream input, com.google.protobuf.ExtensionRegistryLite extensionRegistry)
+      throws java.io.IOException {
+    return com.google.protobuf.GeneratedMessageV3.parseDelimitedWithIOException(
+        PARSER, input, extensionRegistry);
+  }
+
+  public static com.google.cloud.retail.v2beta.GcsOutputResult parseFrom(
+      com.google.protobuf.CodedInputStream input) throws java.io.IOException {
+    return com.google.protobuf.GeneratedMessageV3.parseWithIOException(PARSER, input);
+  }
+
+  public static com.google.cloud.retail.v2beta.GcsOutputResult parseFrom(
+      com.google.protobuf.CodedInputStream input,
+      com.google.protobuf.ExtensionRegistryLite extensionRegistry)
+      throws java.io.IOException {
+    return com.google.protobuf.GeneratedMessageV3.parseWithIOException(
+        PARSER, input, extensionRegistry);
+  }
+
+  @java.lang.Override
+  public Builder newBuilderForType() {
+    return newBuilder();
+  }
+
+  public static Builder newBuilder() {
+    return DEFAULT_INSTANCE.toBuilder();
+  }
+
+  public static Builder newBuilder(com.google.cloud.retail.v2beta.GcsOutputResult prototype) {
+    return DEFAULT_INSTANCE.toBuilder().mergeFrom(prototype);
+  }
+
+  @java.lang.Override
+  public Builder toBuilder() {
+    return this == DEFAULT_INSTANCE ? new Builder() : new Builder().mergeFrom(this);
+  }
+
+  @java.lang.Override
+  protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.BuilderParent parent) {
+    Builder builder = new Builder(parent);
+    return builder;
+  }
+  /**
+   *
+   *
+   * 
      +   * A Gcs output result.
+   * 
      
+   *
+   * Protobuf type {@code google.cloud.retail.v2beta.GcsOutputResult}
+   */
+  public static final class Builder extends com.google.protobuf.GeneratedMessageV3.Builder
+      implements
+      // @@protoc_insertion_point(builder_implements:google.cloud.retail.v2beta.GcsOutputResult)
+      com.google.cloud.retail.v2beta.GcsOutputResultOrBuilder {
+    public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
+      return com.google.cloud.retail.v2beta.ExportConfigProto
+          .internal_static_google_cloud_retail_v2beta_GcsOutputResult_descriptor;
+    }
+
+    @java.lang.Override
+    protected com.google.protobuf.GeneratedMessageV3.FieldAccessorTable
+        internalGetFieldAccessorTable() {
+      return com.google.cloud.retail.v2beta.ExportConfigProto
+          .internal_static_google_cloud_retail_v2beta_GcsOutputResult_fieldAccessorTable
+          .ensureFieldAccessorsInitialized(
+              com.google.cloud.retail.v2beta.GcsOutputResult.class,
+              com.google.cloud.retail.v2beta.GcsOutputResult.Builder.class);
+    }
+
+    // Construct using com.google.cloud.retail.v2beta.GcsOutputResult.newBuilder()
+    private Builder() {}
+
+    private Builder(com.google.protobuf.GeneratedMessageV3.BuilderParent parent) {
+      super(parent);
+    }
+
+    @java.lang.Override
+    public Builder clear() {
+      super.clear();
+      outputUri_ = "";
+
+      return this;
+    }
+
+    @java.lang.Override
+    public com.google.protobuf.Descriptors.Descriptor getDescriptorForType() {
+      return com.google.cloud.retail.v2beta.ExportConfigProto
+          .internal_static_google_cloud_retail_v2beta_GcsOutputResult_descriptor;
+    }
+
+    @java.lang.Override
+    public com.google.cloud.retail.v2beta.GcsOutputResult getDefaultInstanceForType() {
+      return com.google.cloud.retail.v2beta.GcsOutputResult.getDefaultInstance();
+    }
+
+    @java.lang.Override
+    public com.google.cloud.retail.v2beta.GcsOutputResult build() {
+      com.google.cloud.retail.v2beta.GcsOutputResult result = buildPartial();
+      if (!result.isInitialized()) {
+        throw newUninitializedMessageException(result);
+      }
+      return result;
+    }
+
+    @java.lang.Override
+    public com.google.cloud.retail.v2beta.GcsOutputResult buildPartial() {
+      com.google.cloud.retail.v2beta.GcsOutputResult result =
+          new com.google.cloud.retail.v2beta.GcsOutputResult(this);
+      result.outputUri_ = outputUri_;
+      onBuilt();
+      return result;
+    }
+
+    @java.lang.Override
+    public Builder clone() {
+      return super.clone();
+    }
+
+    @java.lang.Override
+    public Builder setField(
+        com.google.protobuf.Descriptors.FieldDescriptor field, java.lang.Object value) {
+      return super.setField(field, value);
+    }
+
+    @java.lang.Override
+    public Builder clearField(com.google.protobuf.Descriptors.FieldDescriptor field) {
+      return super.clearField(field);
+    }
+
+    @java.lang.Override
+    public Builder clearOneof(com.google.protobuf.Descriptors.OneofDescriptor oneof) {
+      return super.clearOneof(oneof);
+    }
+
+    @java.lang.Override
+    public Builder setRepeatedField(
+        com.google.protobuf.Descriptors.FieldDescriptor field, int index, java.lang.Object value) {
+      return super.setRepeatedField(field, index, value);
+    }
+
+    @java.lang.Override
+    public Builder addRepeatedField(
+        com.google.protobuf.Descriptors.FieldDescriptor field, java.lang.Object value) {
+      return super.addRepeatedField(field, value);
+    }
+
+    @java.lang.Override
+    public Builder mergeFrom(com.google.protobuf.Message other) {
+      if (other instanceof com.google.cloud.retail.v2beta.GcsOutputResult) {
+        return mergeFrom((com.google.cloud.retail.v2beta.GcsOutputResult) other);
+      } else {
+        super.mergeFrom(other);
+        return this;
+      }
+    }
+
+    public Builder mergeFrom(com.google.cloud.retail.v2beta.GcsOutputResult other) {
+      if (other == com.google.cloud.retail.v2beta.GcsOutputResult.getDefaultInstance()) return this;
+      if (!other.getOutputUri().isEmpty()) {
+        outputUri_ = other.outputUri_;
+        onChanged();
+      }
+      this.mergeUnknownFields(other.getUnknownFields());
+      onChanged();
+      return this;
+    }
+
+    @java.lang.Override
+    public final boolean isInitialized() {
+      return true;
+    }
+
+    @java.lang.Override
+    public Builder mergeFrom(
+        com.google.protobuf.CodedInputStream input,
+        com.google.protobuf.ExtensionRegistryLite extensionRegistry)
+        throws java.io.IOException {
+      if (extensionRegistry == null) {
+        throw new java.lang.NullPointerException();
+      }
+      try {
+        boolean done = false;
+        while (!done) {
+          int tag = input.readTag();
+          switch (tag) {
+            case 0:
+              done = true;
+              break;
+            case 10:
+              {
+                outputUri_ = input.readStringRequireUtf8();
+
+                break;
+              } // case 10
+            default:
+              {
+                if (!super.parseUnknownField(input, extensionRegistry, tag)) {
+                  done = true; // was an endgroup tag
+                }
+                break;
+              } // default:
+          } // switch (tag)
+        } // while (!done)
+      } catch (com.google.protobuf.InvalidProtocolBufferException e) {
+        throw e.unwrapIOException();
+      } finally {
+        onChanged();
+      } // finally
+      return this;
+    }
+
+    private java.lang.Object outputUri_ = "";
+    /**
+     *
+     *
+     * 
      +     * The uri of Gcs output
+     * 
      
+     *
+     * string output_uri = 1;
+     *
+     * @return The outputUri.
+     */
+    public java.lang.String getOutputUri() {
+      java.lang.Object ref = outputUri_;
+      if (!(ref instanceof java.lang.String)) {
+        com.google.protobuf.ByteString bs = (com.google.protobuf.ByteString) ref;
+        java.lang.String s = bs.toStringUtf8();
+        outputUri_ = s;
+        return s;
+      } else {
+        return (java.lang.String) ref;
+      }
+    }
+    /**
+     *
+     *
+     * 
      +     * The uri of Gcs output
+     * 
      
+     *
+     * string output_uri = 1;
+     *
+     * @return The bytes for outputUri.
+     */
+    public com.google.protobuf.ByteString getOutputUriBytes() {
+      java.lang.Object ref = outputUri_;
+      if (ref instanceof String) {
+        com.google.protobuf.ByteString b =
+            com.google.protobuf.ByteString.copyFromUtf8((java.lang.String) ref);
+        outputUri_ = b;
+        return b;
+      } else {
+        return (com.google.protobuf.ByteString) ref;
+      }
+    }
+    /**
+     *
+     *
+     * 
      +     * The uri of Gcs output
+     * 
      
+     *
+     * string output_uri = 1;
+     *
+     * @param value The outputUri to set.
+     * @return This builder for chaining.
+     */
+    public Builder setOutputUri(java.lang.String value) {
+      if (value == null) {
+        throw new NullPointerException();
+      }
+
+      outputUri_ = value;
+      onChanged();
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * The uri of Gcs output
+     * 
      
+     *
+     * string output_uri = 1;
+     *
+     * @return This builder for chaining.
+     */
+    public Builder clearOutputUri() {
+
+      outputUri_ = getDefaultInstance().getOutputUri();
+      onChanged();
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * The uri of Gcs output
+     * 
      
+     *
+     * string output_uri = 1;
+     *
+     * @param value The bytes for outputUri to set.
+     * @return This builder for chaining.
+     */
+    public Builder setOutputUriBytes(com.google.protobuf.ByteString value) {
+      if (value == null) {
+        throw new NullPointerException();
+      }
+      checkByteStringIsUtf8(value);
+
+      outputUri_ = value;
+      onChanged();
+      return this;
+    }
+
+    @java.lang.Override
+    public final Builder setUnknownFields(final com.google.protobuf.UnknownFieldSet unknownFields) {
+      return super.setUnknownFields(unknownFields);
+    }
+
+    @java.lang.Override
+    public final Builder mergeUnknownFields(
+        final com.google.protobuf.UnknownFieldSet unknownFields) {
+      return super.mergeUnknownFields(unknownFields);
+    }
+
+    // @@protoc_insertion_point(builder_scope:google.cloud.retail.v2beta.GcsOutputResult)
+  }
+
+  // @@protoc_insertion_point(class_scope:google.cloud.retail.v2beta.GcsOutputResult)
+  private static final com.google.cloud.retail.v2beta.GcsOutputResult DEFAULT_INSTANCE;
+
+  static {
+    DEFAULT_INSTANCE = new com.google.cloud.retail.v2beta.GcsOutputResult();
+  }
+
+  public static com.google.cloud.retail.v2beta.GcsOutputResult getDefaultInstance() {
+    return DEFAULT_INSTANCE;
+  }
+
+  private static final com.google.protobuf.Parser PARSER =
+      new com.google.protobuf.AbstractParser() {
+        @java.lang.Override
+        public GcsOutputResult parsePartialFrom(
+            com.google.protobuf.CodedInputStream input,
+            com.google.protobuf.ExtensionRegistryLite extensionRegistry)
+            throws com.google.protobuf.InvalidProtocolBufferException {
+          Builder builder = newBuilder();
+          try {
+            builder.mergeFrom(input, extensionRegistry);
+          } catch (com.google.protobuf.InvalidProtocolBufferException e) {
+            throw e.setUnfinishedMessage(builder.buildPartial());
+          } catch (com.google.protobuf.UninitializedMessageException e) {
+            throw e.asInvalidProtocolBufferException().setUnfinishedMessage(builder.buildPartial());
+          } catch (java.io.IOException e) {
+            throw new com.google.protobuf.InvalidProtocolBufferException(e)
+                .setUnfinishedMessage(builder.buildPartial());
+          }
+          return builder.buildPartial();
+        }
+      };
+
+  public static com.google.protobuf.Parser parser() {
+    return PARSER;
+  }
+
+  @java.lang.Override
+  public com.google.protobuf.Parser getParserForType() {
+    return PARSER;
+  }
+
+  @java.lang.Override
+  public com.google.cloud.retail.v2beta.GcsOutputResult getDefaultInstanceForType() {
+    return DEFAULT_INSTANCE;
+  }
+}
diff --git a/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/GcsOutputResultOrBuilder.java b/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/GcsOutputResultOrBuilder.java
new file mode 100644
index 000000000000..01cba2d9aeab
--- /dev/null
+++ b/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/GcsOutputResultOrBuilder.java
@@ -0,0 +1,50 @@
+/*
+ * Copyright 2020 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+// Generated by the protocol buffer compiler.  DO NOT EDIT!
+// source: google/cloud/retail/v2beta/export_config.proto
+
+package com.google.cloud.retail.v2beta;
+
+public interface GcsOutputResultOrBuilder
+    extends
+    // @@protoc_insertion_point(interface_extends:google.cloud.retail.v2beta.GcsOutputResult)
+    com.google.protobuf.MessageOrBuilder {
+
+  /**
+   *
+   *
+   * 
      +   * The uri of Gcs output
+   * 
      
+   *
+   * string output_uri = 1;
+   *
+   * @return The outputUri.
+   */
+  java.lang.String getOutputUri();
+  /**
+   *
+   *
+   * 
      +   * The uri of Gcs output
+   * 
      
+   *
+   * string output_uri = 1;
+   *
+   * @return The bytes for outputUri.
+   */
+  com.google.protobuf.ByteString getOutputUriBytes();
+}
diff --git a/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/MerchantCenterFeedFilter.java b/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/MerchantCenterFeedFilter.java
new file mode 100644
index 000000000000..96b5d09bb7c1
--- /dev/null
+++ b/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/MerchantCenterFeedFilter.java
@@ -0,0 +1,714 @@
+/*
+ * Copyright 2020 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+// Generated by the protocol buffer compiler.  DO NOT EDIT!
+// source: google/cloud/retail/v2beta/catalog.proto
+
+package com.google.cloud.retail.v2beta;
+
+/**
+ *
+ *
+ * 
      + * Merchant Center Feed filter criterion.
+ * 
      
+ *
+ * Protobuf type {@code google.cloud.retail.v2beta.MerchantCenterFeedFilter}
+ */
+public final class MerchantCenterFeedFilter extends com.google.protobuf.GeneratedMessageV3
+    implements
+    // @@protoc_insertion_point(message_implements:google.cloud.retail.v2beta.MerchantCenterFeedFilter)
+    MerchantCenterFeedFilterOrBuilder {
+  private static final long serialVersionUID = 0L;
+  // Use MerchantCenterFeedFilter.newBuilder() to construct.
+  private MerchantCenterFeedFilter(com.google.protobuf.GeneratedMessageV3.Builder builder) {
+    super(builder);
+  }
+
+  private MerchantCenterFeedFilter() {
+    primaryFeedName_ = "";
+  }
+
+  @java.lang.Override
+  @SuppressWarnings({"unused"})
+  protected java.lang.Object newInstance(UnusedPrivateParameter unused) {
+    return new MerchantCenterFeedFilter();
+  }
+
+  @java.lang.Override
+  public final com.google.protobuf.UnknownFieldSet getUnknownFields() {
+    return this.unknownFields;
+  }
+
+  public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
+    return com.google.cloud.retail.v2beta.CatalogProto
+        .internal_static_google_cloud_retail_v2beta_MerchantCenterFeedFilter_descriptor;
+  }
+
+  @java.lang.Override
+  protected com.google.protobuf.GeneratedMessageV3.FieldAccessorTable
+      internalGetFieldAccessorTable() {
+    return com.google.cloud.retail.v2beta.CatalogProto
+        .internal_static_google_cloud_retail_v2beta_MerchantCenterFeedFilter_fieldAccessorTable
+        .ensureFieldAccessorsInitialized(
+            com.google.cloud.retail.v2beta.MerchantCenterFeedFilter.class,
+            com.google.cloud.retail.v2beta.MerchantCenterFeedFilter.Builder.class);
+  }
+
+  public static final int PRIMARY_FEED_ID_FIELD_NUMBER = 1;
+  private long primaryFeedId_;
+  /**
+   *
+   *
+   * 
      +   * Merchant Center primary feed ID.
+   * 
      
+   *
+   * int64 primary_feed_id = 1;
+   *
+   * @return The primaryFeedId.
+   */
+  @java.lang.Override
+  public long getPrimaryFeedId() {
+    return primaryFeedId_;
+  }
+
+  public static final int PRIMARY_FEED_NAME_FIELD_NUMBER = 2;
+  private volatile java.lang.Object primaryFeedName_;
+  /**
+   *
+   *
+   * 
      +   * Merchant Center primary feed name. The name is used for the display
+   * purposes only.
+   * 
      
+   *
+   * string primary_feed_name = 2;
+   *
+   * @return The primaryFeedName.
+   */
+  @java.lang.Override
+  public java.lang.String getPrimaryFeedName() {
+    java.lang.Object ref = primaryFeedName_;
+    if (ref instanceof java.lang.String) {
+      return (java.lang.String) ref;
+    } else {
+      com.google.protobuf.ByteString bs = (com.google.protobuf.ByteString) ref;
+      java.lang.String s = bs.toStringUtf8();
+      primaryFeedName_ = s;
+      return s;
+    }
+  }
+  /**
+   *
+   *
+   * 
      +   * Merchant Center primary feed name. The name is used for the display
+   * purposes only.
+   * 
      
+   *
+   * string primary_feed_name = 2;
+   *
+   * @return The bytes for primaryFeedName.
+   */
+  @java.lang.Override
+  public com.google.protobuf.ByteString getPrimaryFeedNameBytes() {
+    java.lang.Object ref = primaryFeedName_;
+    if (ref instanceof java.lang.String) {
+      com.google.protobuf.ByteString b =
+          com.google.protobuf.ByteString.copyFromUtf8((java.lang.String) ref);
+      primaryFeedName_ = b;
+      return b;
+    } else {
+      return (com.google.protobuf.ByteString) ref;
+    }
+  }
+
+  private byte memoizedIsInitialized = -1;
+
+  @java.lang.Override
+  public final boolean isInitialized() {
+    byte isInitialized = memoizedIsInitialized;
+    if (isInitialized == 1) return true;
+    if (isInitialized == 0) return false;
+
+    memoizedIsInitialized = 1;
+    return true;
+  }
+
+  @java.lang.Override
+  public void writeTo(com.google.protobuf.CodedOutputStream output) throws java.io.IOException {
+    if (primaryFeedId_ != 0L) {
+      output.writeInt64(1, primaryFeedId_);
+    }
+    if (!com.google.protobuf.GeneratedMessageV3.isStringEmpty(primaryFeedName_)) {
+      com.google.protobuf.GeneratedMessageV3.writeString(output, 2, primaryFeedName_);
+    }
+    getUnknownFields().writeTo(output);
+  }
+
+  @java.lang.Override
+  public int getSerializedSize() {
+    int size = memoizedSize;
+    if (size != -1) return size;
+
+    size = 0;
+    if (primaryFeedId_ != 0L) {
+      size += com.google.protobuf.CodedOutputStream.computeInt64Size(1, primaryFeedId_);
+    }
+    if (!com.google.protobuf.GeneratedMessageV3.isStringEmpty(primaryFeedName_)) {
+      size += com.google.protobuf.GeneratedMessageV3.computeStringSize(2, primaryFeedName_);
+    }
+    size += getUnknownFields().getSerializedSize();
+    memoizedSize = size;
+    return size;
+  }
+
+  @java.lang.Override
+  public boolean equals(final java.lang.Object obj) {
+    if (obj == this) {
+      return true;
+    }
+    if (!(obj instanceof com.google.cloud.retail.v2beta.MerchantCenterFeedFilter)) {
+      return super.equals(obj);
+    }
+    com.google.cloud.retail.v2beta.MerchantCenterFeedFilter other =
+        (com.google.cloud.retail.v2beta.MerchantCenterFeedFilter) obj;
+
+    if (getPrimaryFeedId() != other.getPrimaryFeedId()) return false;
+    if (!getPrimaryFeedName().equals(other.getPrimaryFeedName())) return false;
+    if (!getUnknownFields().equals(other.getUnknownFields())) return false;
+    return true;
+  }
+
+  @java.lang.Override
+  public int hashCode() {
+    if (memoizedHashCode != 0) {
+      return memoizedHashCode;
+    }
+    int hash = 41;
+    hash = (19 * hash) + getDescriptor().hashCode();
+    hash = (37 * hash) + PRIMARY_FEED_ID_FIELD_NUMBER;
+    hash = (53 * hash) + com.google.protobuf.Internal.hashLong(getPrimaryFeedId());
+    hash = (37 * hash) + PRIMARY_FEED_NAME_FIELD_NUMBER;
+    hash = (53 * hash) + getPrimaryFeedName().hashCode();
+    hash = (29 * hash) + getUnknownFields().hashCode();
+    memoizedHashCode = hash;
+    return hash;
+  }
+
+  public static com.google.cloud.retail.v2beta.MerchantCenterFeedFilter parseFrom(
+      java.nio.ByteBuffer data) throws com.google.protobuf.InvalidProtocolBufferException {
+    return PARSER.parseFrom(data);
+  }
+
+  public static com.google.cloud.retail.v2beta.MerchantCenterFeedFilter parseFrom(
+      java.nio.ByteBuffer data, com.google.protobuf.ExtensionRegistryLite extensionRegistry)
+      throws com.google.protobuf.InvalidProtocolBufferException {
+    return PARSER.parseFrom(data, extensionRegistry);
+  }
+
+  public static com.google.cloud.retail.v2beta.MerchantCenterFeedFilter parseFrom(
+      com.google.protobuf.ByteString data)
+      throws com.google.protobuf.InvalidProtocolBufferException {
+    return PARSER.parseFrom(data);
+  }
+
+  public static com.google.cloud.retail.v2beta.MerchantCenterFeedFilter parseFrom(
+      com.google.protobuf.ByteString data,
+      com.google.protobuf.ExtensionRegistryLite extensionRegistry)
+      throws com.google.protobuf.InvalidProtocolBufferException {
+    return PARSER.parseFrom(data, extensionRegistry);
+  }
+
+  public static com.google.cloud.retail.v2beta.MerchantCenterFeedFilter parseFrom(byte[] data)
+      throws com.google.protobuf.InvalidProtocolBufferException {
+    return PARSER.parseFrom(data);
+  }
+
+  public static com.google.cloud.retail.v2beta.MerchantCenterFeedFilter parseFrom(
+      byte[] data, com.google.protobuf.ExtensionRegistryLite extensionRegistry)
+      throws com.google.protobuf.InvalidProtocolBufferException {
+    return PARSER.parseFrom(data, extensionRegistry);
+  }
+
+  public static com.google.cloud.retail.v2beta.MerchantCenterFeedFilter parseFrom(
+      java.io.InputStream input) throws java.io.IOException {
+    return com.google.protobuf.GeneratedMessageV3.parseWithIOException(PARSER, input);
+  }
+
+  public static com.google.cloud.retail.v2beta.MerchantCenterFeedFilter parseFrom(
+      java.io.InputStream input, com.google.protobuf.ExtensionRegistryLite extensionRegistry)
+      throws java.io.IOException {
+    return com.google.protobuf.GeneratedMessageV3.parseWithIOException(
+        PARSER, input, extensionRegistry);
+  }
+
+  public static com.google.cloud.retail.v2beta.MerchantCenterFeedFilter parseDelimitedFrom(
+      java.io.InputStream input) throws java.io.IOException {
+    return com.google.protobuf.GeneratedMessageV3.parseDelimitedWithIOException(PARSER, input);
+  }
+
+  public static com.google.cloud.retail.v2beta.MerchantCenterFeedFilter parseDelimitedFrom(
+      java.io.InputStream input, com.google.protobuf.ExtensionRegistryLite extensionRegistry)
+      throws java.io.IOException {
+    return com.google.protobuf.GeneratedMessageV3.parseDelimitedWithIOException(
+        PARSER, input, extensionRegistry);
+  }
+
+  public static com.google.cloud.retail.v2beta.MerchantCenterFeedFilter parseFrom(
+      com.google.protobuf.CodedInputStream input) throws java.io.IOException {
+    return com.google.protobuf.GeneratedMessageV3.parseWithIOException(PARSER, input);
+  }
+
+  public static com.google.cloud.retail.v2beta.MerchantCenterFeedFilter parseFrom(
+      com.google.protobuf.CodedInputStream input,
+      com.google.protobuf.ExtensionRegistryLite extensionRegistry)
+      throws java.io.IOException {
+    return com.google.protobuf.GeneratedMessageV3.parseWithIOException(
+        PARSER, input, extensionRegistry);
+  }
+
+  @java.lang.Override
+  public Builder newBuilderForType() {
+    return newBuilder();
+  }
+
+  public static Builder newBuilder() {
+    return DEFAULT_INSTANCE.toBuilder();
+  }
+
+  public static Builder newBuilder(
+      com.google.cloud.retail.v2beta.MerchantCenterFeedFilter prototype) {
+    return DEFAULT_INSTANCE.toBuilder().mergeFrom(prototype);
+  }
+
+  @java.lang.Override
+  public Builder toBuilder() {
+    return this == DEFAULT_INSTANCE ? new Builder() : new Builder().mergeFrom(this);
+  }
+
+  @java.lang.Override
+  protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.BuilderParent parent) {
+    Builder builder = new Builder(parent);
+    return builder;
+  }
+  /**
+   *
+   *
+   * 
      +   * Merchant Center Feed filter criterion.
+   * 
      
+   *
+   * Protobuf type {@code google.cloud.retail.v2beta.MerchantCenterFeedFilter}
+   */
+  public static final class Builder extends com.google.protobuf.GeneratedMessageV3.Builder
+      implements
+      // @@protoc_insertion_point(builder_implements:google.cloud.retail.v2beta.MerchantCenterFeedFilter)
+      com.google.cloud.retail.v2beta.MerchantCenterFeedFilterOrBuilder {
+    public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
+      return com.google.cloud.retail.v2beta.CatalogProto
+          .internal_static_google_cloud_retail_v2beta_MerchantCenterFeedFilter_descriptor;
+    }
+
+    @java.lang.Override
+    protected com.google.protobuf.GeneratedMessageV3.FieldAccessorTable
+        internalGetFieldAccessorTable() {
+      return com.google.cloud.retail.v2beta.CatalogProto
+          .internal_static_google_cloud_retail_v2beta_MerchantCenterFeedFilter_fieldAccessorTable
+          .ensureFieldAccessorsInitialized(
+              com.google.cloud.retail.v2beta.MerchantCenterFeedFilter.class,
+              com.google.cloud.retail.v2beta.MerchantCenterFeedFilter.Builder.class);
+    }
+
+    // Construct using com.google.cloud.retail.v2beta.MerchantCenterFeedFilter.newBuilder()
+    private Builder() {}
+
+    private Builder(com.google.protobuf.GeneratedMessageV3.BuilderParent parent) {
+      super(parent);
+    }
+
+    @java.lang.Override
+    public Builder clear() {
+      super.clear();
+      primaryFeedId_ = 0L;
+
+      primaryFeedName_ = "";
+
+      return this;
+    }
+
+    @java.lang.Override
+    public com.google.protobuf.Descriptors.Descriptor getDescriptorForType() {
+      return com.google.cloud.retail.v2beta.CatalogProto
+          .internal_static_google_cloud_retail_v2beta_MerchantCenterFeedFilter_descriptor;
+    }
+
+    @java.lang.Override
+    public com.google.cloud.retail.v2beta.MerchantCenterFeedFilter getDefaultInstanceForType() {
+      return com.google.cloud.retail.v2beta.MerchantCenterFeedFilter.getDefaultInstance();
+    }
+
+    @java.lang.Override
+    public com.google.cloud.retail.v2beta.MerchantCenterFeedFilter build() {
+      com.google.cloud.retail.v2beta.MerchantCenterFeedFilter result = buildPartial();
+      if (!result.isInitialized()) {
+        throw newUninitializedMessageException(result);
+      }
+      return result;
+    }
+
+    @java.lang.Override
+    public com.google.cloud.retail.v2beta.MerchantCenterFeedFilter buildPartial() {
+      com.google.cloud.retail.v2beta.MerchantCenterFeedFilter result =
+          new com.google.cloud.retail.v2beta.MerchantCenterFeedFilter(this);
+      result.primaryFeedId_ = primaryFeedId_;
+      result.primaryFeedName_ = primaryFeedName_;
+      onBuilt();
+      return result;
+    }
+
+    @java.lang.Override
+    public Builder clone() {
+      return super.clone();
+    }
+
+    @java.lang.Override
+    public Builder setField(
+        com.google.protobuf.Descriptors.FieldDescriptor field, java.lang.Object value) {
+      return super.setField(field, value);
+    }
+
+    @java.lang.Override
+    public Builder clearField(com.google.protobuf.Descriptors.FieldDescriptor field) {
+      return super.clearField(field);
+    }
+
+    @java.lang.Override
+    public Builder clearOneof(com.google.protobuf.Descriptors.OneofDescriptor oneof) {
+      return super.clearOneof(oneof);
+    }
+
+    @java.lang.Override
+    public Builder setRepeatedField(
+        com.google.protobuf.Descriptors.FieldDescriptor field, int index, java.lang.Object value) {
+      return super.setRepeatedField(field, index, value);
+    }
+
+    @java.lang.Override
+    public Builder addRepeatedField(
+        com.google.protobuf.Descriptors.FieldDescriptor field, java.lang.Object value) {
+      return super.addRepeatedField(field, value);
+    }
+
+    @java.lang.Override
+    public Builder mergeFrom(com.google.protobuf.Message other) {
+      if (other instanceof com.google.cloud.retail.v2beta.MerchantCenterFeedFilter) {
+        return mergeFrom((com.google.cloud.retail.v2beta.MerchantCenterFeedFilter) other);
+      } else {
+        super.mergeFrom(other);
+        return this;
+      }
+    }
+
+    public Builder mergeFrom(com.google.cloud.retail.v2beta.MerchantCenterFeedFilter other) {
+      if (other == com.google.cloud.retail.v2beta.MerchantCenterFeedFilter.getDefaultInstance())
+        return this;
+      if (other.getPrimaryFeedId() != 0L) {
+        setPrimaryFeedId(other.getPrimaryFeedId());
+      }
+      if (!other.getPrimaryFeedName().isEmpty()) {
+        primaryFeedName_ = other.primaryFeedName_;
+        onChanged();
+      }
+      this.mergeUnknownFields(other.getUnknownFields());
+      onChanged();
+      return this;
+    }
+
+    @java.lang.Override
+    public final boolean isInitialized() {
+      return true;
+    }
+
+    @java.lang.Override
+    public Builder mergeFrom(
+        com.google.protobuf.CodedInputStream input,
+        com.google.protobuf.ExtensionRegistryLite extensionRegistry)
+        throws java.io.IOException {
+      if (extensionRegistry == null) {
+        throw new java.lang.NullPointerException();
+      }
+      try {
+        boolean done = false;
+        while (!done) {
+          int tag = input.readTag();
+          switch (tag) {
+            case 0:
+              done = true;
+              break;
+            case 8:
+              {
+                primaryFeedId_ = input.readInt64();
+
+                break;
+              } // case 8
+            case 18:
+              {
+                primaryFeedName_ = input.readStringRequireUtf8();
+
+                break;
+              } // case 18
+            default:
+              {
+                if (!super.parseUnknownField(input, extensionRegistry, tag)) {
+                  done = true; // was an endgroup tag
+                }
+                break;
+              } // default:
+          } // switch (tag)
+        } // while (!done)
+      } catch (com.google.protobuf.InvalidProtocolBufferException e) {
+        throw e.unwrapIOException();
+      } finally {
+        onChanged();
+      } // finally
+      return this;
+    }
+
+    private long primaryFeedId_;
+    /**
+     *
+     *
+     * 
      +     * Merchant Center primary feed ID.
+     * 
      
+     *
+     * int64 primary_feed_id = 1;
+     *
+     * @return The primaryFeedId.
+     */
+    @java.lang.Override
+    public long getPrimaryFeedId() {
+      return primaryFeedId_;
+    }
+    /**
+     *
+     *
+     * 
      +     * Merchant Center primary feed ID.
+     * 
      
+     *
+     * int64 primary_feed_id = 1;
+     *
+     * @param value The primaryFeedId to set.
+     * @return This builder for chaining.
+     */
+    public Builder setPrimaryFeedId(long value) {
+
+      primaryFeedId_ = value;
+      onChanged();
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * Merchant Center primary feed ID.
+     * 
      
+     *
+     * int64 primary_feed_id = 1;
+     *
+     * @return This builder for chaining.
+     */
+    public Builder clearPrimaryFeedId() {
+
+      primaryFeedId_ = 0L;
+      onChanged();
+      return this;
+    }
+
+    private java.lang.Object primaryFeedName_ = "";
+    /**
+     *
+     *
+     * 
      +     * Merchant Center primary feed name. The name is used for the display
+     * purposes only.
+     * 
      
+     *
+     * string primary_feed_name = 2;
+     *
+     * @return The primaryFeedName.
+     */
+    public java.lang.String getPrimaryFeedName() {
+      java.lang.Object ref = primaryFeedName_;
+      if (!(ref instanceof java.lang.String)) {
+        com.google.protobuf.ByteString bs = (com.google.protobuf.ByteString) ref;
+        java.lang.String s = bs.toStringUtf8();
+        primaryFeedName_ = s;
+        return s;
+      } else {
+        return (java.lang.String) ref;
+      }
+    }
+    /**
+     *
+     *
+     * 
      +     * Merchant Center primary feed name. The name is used for the display
+     * purposes only.
+     * 
      
+     *
+     * string primary_feed_name = 2;
+     *
+     * @return The bytes for primaryFeedName.
+     */
+    public com.google.protobuf.ByteString getPrimaryFeedNameBytes() {
+      java.lang.Object ref = primaryFeedName_;
+      if (ref instanceof String) {
+        com.google.protobuf.ByteString b =
+            com.google.protobuf.ByteString.copyFromUtf8((java.lang.String) ref);
+        primaryFeedName_ = b;
+        return b;
+      } else {
+        return (com.google.protobuf.ByteString) ref;
+      }
+    }
+    /**
+     *
+     *
+     * 
      +     * Merchant Center primary feed name. The name is used for the display
+     * purposes only.
+     * 
      
+     *
+     * string primary_feed_name = 2;
+     *
+     * @param value The primaryFeedName to set.
+     * @return This builder for chaining.
+     */
+    public Builder setPrimaryFeedName(java.lang.String value) {
+      if (value == null) {
+        throw new NullPointerException();
+      }
+
+      primaryFeedName_ = value;
+      onChanged();
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * Merchant Center primary feed name. The name is used for the display
+     * purposes only.
+     * 
      
+     *
+     * string primary_feed_name = 2;
+     *
+     * @return This builder for chaining.
+     */
+    public Builder clearPrimaryFeedName() {
+
+      primaryFeedName_ = getDefaultInstance().getPrimaryFeedName();
+      onChanged();
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * Merchant Center primary feed name. The name is used for the display
+     * purposes only.
+     * 
      
+     *
+     * string primary_feed_name = 2;
+     *
+     * @param value The bytes for primaryFeedName to set.
+     * @return This builder for chaining.
+     */
+    public Builder setPrimaryFeedNameBytes(com.google.protobuf.ByteString value) {
+      if (value == null) {
+        throw new NullPointerException();
+      }
+      checkByteStringIsUtf8(value);
+
+      primaryFeedName_ = value;
+      onChanged();
+      return this;
+    }
+
+    @java.lang.Override
+    public final Builder setUnknownFields(final com.google.protobuf.UnknownFieldSet unknownFields) {
+      return super.setUnknownFields(unknownFields);
+    }
+
+    @java.lang.Override
+    public final Builder mergeUnknownFields(
+        final com.google.protobuf.UnknownFieldSet unknownFields) {
+      return super.mergeUnknownFields(unknownFields);
+    }
+
+    // @@protoc_insertion_point(builder_scope:google.cloud.retail.v2beta.MerchantCenterFeedFilter)
+  }
+
+  // @@protoc_insertion_point(class_scope:google.cloud.retail.v2beta.MerchantCenterFeedFilter)
+  private static final com.google.cloud.retail.v2beta.MerchantCenterFeedFilter DEFAULT_INSTANCE;
+
+  static {
+    DEFAULT_INSTANCE = new com.google.cloud.retail.v2beta.MerchantCenterFeedFilter();
+  }
+
+  public static com.google.cloud.retail.v2beta.MerchantCenterFeedFilter getDefaultInstance() {
+    return DEFAULT_INSTANCE;
+  }
+
+  private static final com.google.protobuf.Parser PARSER =
+      new com.google.protobuf.AbstractParser() {
+        @java.lang.Override
+        public MerchantCenterFeedFilter parsePartialFrom(
+            com.google.protobuf.CodedInputStream input,
+            com.google.protobuf.ExtensionRegistryLite extensionRegistry)
+            throws com.google.protobuf.InvalidProtocolBufferException {
+          Builder builder = newBuilder();
+          try {
+            builder.mergeFrom(input, extensionRegistry);
+          } catch (com.google.protobuf.InvalidProtocolBufferException e) {
+            throw e.setUnfinishedMessage(builder.buildPartial());
+          } catch (com.google.protobuf.UninitializedMessageException e) {
+            throw e.asInvalidProtocolBufferException().setUnfinishedMessage(builder.buildPartial());
+          } catch (java.io.IOException e) {
+            throw new com.google.protobuf.InvalidProtocolBufferException(e)
+                .setUnfinishedMessage(builder.buildPartial());
+          }
+          return builder.buildPartial();
+        }
+      };
+
+  public static com.google.protobuf.Parser parser() {
+    return PARSER;
+  }
+
+  @java.lang.Override
+  public com.google.protobuf.Parser getParserForType() {
+    return PARSER;
+  }
+
+  @java.lang.Override
+  public com.google.cloud.retail.v2beta.MerchantCenterFeedFilter getDefaultInstanceForType() {
+    return DEFAULT_INSTANCE;
+  }
+}
diff --git a/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/MerchantCenterFeedFilterOrBuilder.java b/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/MerchantCenterFeedFilterOrBuilder.java
new file mode 100644
index 000000000000..6a7c30194062
--- /dev/null
+++ b/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/MerchantCenterFeedFilterOrBuilder.java
@@ -0,0 +1,65 @@
+/*
+ * Copyright 2020 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+// Generated by the protocol buffer compiler.  DO NOT EDIT!
+// source: google/cloud/retail/v2beta/catalog.proto
+
+package com.google.cloud.retail.v2beta;
+
+public interface MerchantCenterFeedFilterOrBuilder
+    extends
+    // @@protoc_insertion_point(interface_extends:google.cloud.retail.v2beta.MerchantCenterFeedFilter)
+    com.google.protobuf.MessageOrBuilder {
+
+  /**
+   *
+   *
+   * 
      +   * Merchant Center primary feed ID.
+   * 
      
+   *
+   * int64 primary_feed_id = 1;
+   *
+   * @return The primaryFeedId.
+   */
+  long getPrimaryFeedId();
+
+  /**
+   *
+   *
+   * 
      +   * Merchant Center primary feed name. The name is used for the display
+   * purposes only.
+   * 
      
+   *
+   * string primary_feed_name = 2;
+   *
+   * @return The primaryFeedName.
+   */
+  java.lang.String getPrimaryFeedName();
+  /**
+   *
+   *
+   * 
      +   * Merchant Center primary feed name. The name is used for the display
+   * purposes only.
+   * 
      
+   *
+   * string primary_feed_name = 2;
+   *
+   * @return The bytes for primaryFeedName.
+   */
+  com.google.protobuf.ByteString getPrimaryFeedNameBytes();
+}
diff --git a/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/MerchantCenterLink.java b/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/MerchantCenterLink.java
index 570610f92d4b..72da7520e1d3 100644
--- a/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/MerchantCenterLink.java
+++ b/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/MerchantCenterLink.java
@@ -44,6 +44,7 @@ private MerchantCenterLink() {
     destinations_ = com.google.protobuf.LazyStringArrayList.EMPTY;
     regionCode_ = "";
     languageCode_ = "";
+    feeds_ = java.util.Collections.emptyList();
   }
 
   @java.lang.Override
@@ -79,7 +80,7 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    *
    * 
          * Required. The linked [Merchant center account
-   * id](https://developers.google.com/shopping-content/guides/accountstatuses).
+   * ID](https://developers.google.com/shopping-content/guides/accountstatuses).
    * The account must be a standalone account or a sub-account of a MCA.
    * 
      
    *
@@ -98,11 +99,11 @@ public long getMerchantCenterAccountId() {
    *
    *
    * 
      -   * The branch id (e.g. 0/1/2) within this catalog that products from
+   * The branch ID (e.g. 0/1/2) within this catalog that products from
    * merchant_center_account_id are streamed to. When updating this field, an
    * empty value will use the currently configured default branch. However,
    * changing the default branch later on won't change the linked branch here.
-   * A single branch id can only have one linked merchant center account id.
+   * A single branch ID can only have one linked merchant center account ID.
    * 
      
    *
    * string branch_id = 2;
@@ -125,11 +126,11 @@ public java.lang.String getBranchId() {
    *
    *
    * 
      -   * The branch id (e.g. 0/1/2) within this catalog that products from
+   * The branch ID (e.g. 0/1/2) within this catalog that products from
    * merchant_center_account_id are streamed to. When updating this field, an
    * empty value will use the currently configured default branch. However,
    * changing the default branch later on won't change the linked branch here.
-   * A single branch id can only have one linked merchant center account id.
+   * A single branch ID can only have one linked merchant center account ID.
    * 
      
    *
    * string branch_id = 2;
@@ -352,6 +353,86 @@ public com.google.protobuf.ByteString getLanguageCodeBytes() {
     }
   }
 
+  public static final int FEEDS_FIELD_NUMBER = 6;
+  private java.util.List feeds_;
+  /**
+   *
+   *
+   * 
      +   * Criteria for the Merchant Center feeds to be ingested via the link.
+   * All offers will be ingested if the list is empty.
+   * Otherwise the offers will be ingested from selected feeds.
+   * 
      
+   *
+   * repeated .google.cloud.retail.v2beta.MerchantCenterFeedFilter feeds = 6;
+   */
+  @java.lang.Override
+  public java.util.List getFeedsList() {
+    return feeds_;
+  }
+  /**
+   *
+   *
+   * 
      +   * Criteria for the Merchant Center feeds to be ingested via the link.
+   * All offers will be ingested if the list is empty.
+   * Otherwise the offers will be ingested from selected feeds.
+   * 
      
+   *
+   * repeated .google.cloud.retail.v2beta.MerchantCenterFeedFilter feeds = 6;
+   */
+  @java.lang.Override
+  public java.util.List
+      getFeedsOrBuilderList() {
+    return feeds_;
+  }
+  /**
+   *
+   *
+   * 
      +   * Criteria for the Merchant Center feeds to be ingested via the link.
+   * All offers will be ingested if the list is empty.
+   * Otherwise the offers will be ingested from selected feeds.
+   * 
      
+   *
+   * repeated .google.cloud.retail.v2beta.MerchantCenterFeedFilter feeds = 6;
+   */
+  @java.lang.Override
+  public int getFeedsCount() {
+    return feeds_.size();
+  }
+  /**
+   *
+   *
+   * 
      +   * Criteria for the Merchant Center feeds to be ingested via the link.
+   * All offers will be ingested if the list is empty.
+   * Otherwise the offers will be ingested from selected feeds.
+   * 
      
+   *
+   * repeated .google.cloud.retail.v2beta.MerchantCenterFeedFilter feeds = 6;
+   */
+  @java.lang.Override
+  public com.google.cloud.retail.v2beta.MerchantCenterFeedFilter getFeeds(int index) {
+    return feeds_.get(index);
+  }
+  /**
+   *
+   *
+   * 
      +   * Criteria for the Merchant Center feeds to be ingested via the link.
+   * All offers will be ingested if the list is empty.
+   * Otherwise the offers will be ingested from selected feeds.
+   * 
      
+   *
+   * repeated .google.cloud.retail.v2beta.MerchantCenterFeedFilter feeds = 6;
+   */
+  @java.lang.Override
+  public com.google.cloud.retail.v2beta.MerchantCenterFeedFilterOrBuilder getFeedsOrBuilder(
+      int index) {
+    return feeds_.get(index);
+  }
+
   private byte memoizedIsInitialized = -1;
 
   @java.lang.Override
@@ -381,6 +462,9 @@ public void writeTo(com.google.protobuf.CodedOutputStream output) throws java.io
     if (!com.google.protobuf.GeneratedMessageV3.isStringEmpty(languageCode_)) {
       com.google.protobuf.GeneratedMessageV3.writeString(output, 5, languageCode_);
     }
+    for (int i = 0; i < feeds_.size(); i++) {
+      output.writeMessage(6, feeds_.get(i));
+    }
     getUnknownFields().writeTo(output);
   }
 
@@ -410,6 +494,9 @@ public int getSerializedSize() {
     if (!com.google.protobuf.GeneratedMessageV3.isStringEmpty(languageCode_)) {
       size += com.google.protobuf.GeneratedMessageV3.computeStringSize(5, languageCode_);
     }
+    for (int i = 0; i < feeds_.size(); i++) {
+      size += com.google.protobuf.CodedOutputStream.computeMessageSize(6, feeds_.get(i));
+    }
     size += getUnknownFields().getSerializedSize();
     memoizedSize = size;
     return size;
@@ -431,6 +518,7 @@ public boolean equals(final java.lang.Object obj) {
     if (!getDestinationsList().equals(other.getDestinationsList())) return false;
     if (!getRegionCode().equals(other.getRegionCode())) return false;
     if (!getLanguageCode().equals(other.getLanguageCode())) return false;
+    if (!getFeedsList().equals(other.getFeedsList())) return false;
     if (!getUnknownFields().equals(other.getUnknownFields())) return false;
     return true;
   }
@@ -454,6 +542,10 @@ public int hashCode() {
     hash = (53 * hash) + getRegionCode().hashCode();
     hash = (37 * hash) + LANGUAGE_CODE_FIELD_NUMBER;
     hash = (53 * hash) + getLanguageCode().hashCode();
+    if (getFeedsCount() > 0) {
+      hash = (37 * hash) + FEEDS_FIELD_NUMBER;
+      hash = (53 * hash) + getFeedsList().hashCode();
+    }
     hash = (29 * hash) + getUnknownFields().hashCode();
     memoizedHashCode = hash;
     return hash;
@@ -604,6 +696,13 @@ public Builder clear() {
 
       languageCode_ = "";
 
+      if (feedsBuilder_ == null) {
+        feeds_ = java.util.Collections.emptyList();
+      } else {
+        feeds_ = null;
+        feedsBuilder_.clear();
+      }
+      bitField0_ = (bitField0_ & ~0x00000002);
       return this;
     }
 
@@ -641,6 +740,15 @@ public com.google.cloud.retail.v2beta.MerchantCenterLink buildPartial() {
       result.destinations_ = destinations_;
       result.regionCode_ = regionCode_;
       result.languageCode_ = languageCode_;
+      if (feedsBuilder_ == null) {
+        if (((bitField0_ & 0x00000002) != 0)) {
+          feeds_ = java.util.Collections.unmodifiableList(feeds_);
+          bitField0_ = (bitField0_ & ~0x00000002);
+        }
+        result.feeds_ = feeds_;
+      } else {
+        result.feeds_ = feedsBuilder_.build();
+      }
       onBuilt();
       return result;
     }
@@ -716,6 +824,33 @@ public Builder mergeFrom(com.google.cloud.retail.v2beta.MerchantCenterLink other
         languageCode_ = other.languageCode_;
         onChanged();
       }
+      if (feedsBuilder_ == null) {
+        if (!other.feeds_.isEmpty()) {
+          if (feeds_.isEmpty()) {
+            feeds_ = other.feeds_;
+            bitField0_ = (bitField0_ & ~0x00000002);
+          } else {
+            ensureFeedsIsMutable();
+            feeds_.addAll(other.feeds_);
+          }
+          onChanged();
+        }
+      } else {
+        if (!other.feeds_.isEmpty()) {
+          if (feedsBuilder_.isEmpty()) {
+            feedsBuilder_.dispose();
+            feedsBuilder_ = null;
+            feeds_ = other.feeds_;
+            bitField0_ = (bitField0_ & ~0x00000002);
+            feedsBuilder_ =
+                com.google.protobuf.GeneratedMessageV3.alwaysUseFieldBuilders
+                    ? getFeedsFieldBuilder()
+                    : null;
+          } else {
+            feedsBuilder_.addAllMessages(other.feeds_);
+          }
+        }
+      }
       this.mergeUnknownFields(other.getUnknownFields());
       onChanged();
       return this;
@@ -773,6 +908,20 @@ public Builder mergeFrom(
 
                 break;
               } // case 42
+            case 50:
+              {
+                com.google.cloud.retail.v2beta.MerchantCenterFeedFilter m =
+                    input.readMessage(
+                        com.google.cloud.retail.v2beta.MerchantCenterFeedFilter.parser(),
+                        extensionRegistry);
+                if (feedsBuilder_ == null) {
+                  ensureFeedsIsMutable();
+                  feeds_.add(m);
+                } else {
+                  feedsBuilder_.addMessage(m);
+                }
+                break;
+              } // case 50
             default:
               {
                 if (!super.parseUnknownField(input, extensionRegistry, tag)) {
@@ -798,7 +947,7 @@ public Builder mergeFrom(
      *
      * 
            * Required. The linked [Merchant center account
-     * id](https://developers.google.com/shopping-content/guides/accountstatuses).
+     * ID](https://developers.google.com/shopping-content/guides/accountstatuses).
      * The account must be a standalone account or a sub-account of a MCA.
      * 
      
      *
@@ -815,7 +964,7 @@ public long getMerchantCenterAccountId() {
      *
      * 
            * Required. The linked [Merchant center account
-     * id](https://developers.google.com/shopping-content/guides/accountstatuses).
+     * ID](https://developers.google.com/shopping-content/guides/accountstatuses).
      * The account must be a standalone account or a sub-account of a MCA.
      * 
      
      *
@@ -835,7 +984,7 @@ public Builder setMerchantCenterAccountId(long value) {
      *
      * 
            * Required. The linked [Merchant center account
-     * id](https://developers.google.com/shopping-content/guides/accountstatuses).
+     * ID](https://developers.google.com/shopping-content/guides/accountstatuses).
      * The account must be a standalone account or a sub-account of a MCA.
      * 
      
      *
@@ -855,11 +1004,11 @@ public Builder clearMerchantCenterAccountId() {
      *
      *
      * 
      -     * The branch id (e.g. 0/1/2) within this catalog that products from
+     * The branch ID (e.g. 0/1/2) within this catalog that products from
      * merchant_center_account_id are streamed to. When updating this field, an
      * empty value will use the currently configured default branch. However,
      * changing the default branch later on won't change the linked branch here.
-     * A single branch id can only have one linked merchant center account id.
+     * A single branch ID can only have one linked merchant center account ID.
      * 
      
      *
      * string branch_id = 2;
@@ -881,11 +1030,11 @@ public java.lang.String getBranchId() {
      *
      *
      * 
      -     * The branch id (e.g. 0/1/2) within this catalog that products from
+     * The branch ID (e.g. 0/1/2) within this catalog that products from
      * merchant_center_account_id are streamed to. When updating this field, an
      * empty value will use the currently configured default branch. However,
      * changing the default branch later on won't change the linked branch here.
-     * A single branch id can only have one linked merchant center account id.
+     * A single branch ID can only have one linked merchant center account ID.
      * 
      
      *
      * string branch_id = 2;
@@ -907,11 +1056,11 @@ public com.google.protobuf.ByteString getBranchIdBytes() {
      *
      *
      * 
      -     * The branch id (e.g. 0/1/2) within this catalog that products from
+     * The branch ID (e.g. 0/1/2) within this catalog that products from
      * merchant_center_account_id are streamed to. When updating this field, an
      * empty value will use the currently configured default branch. However,
      * changing the default branch later on won't change the linked branch here.
-     * A single branch id can only have one linked merchant center account id.
+     * A single branch ID can only have one linked merchant center account ID.
      * 
      
      *
      * string branch_id = 2;
@@ -932,11 +1081,11 @@ public Builder setBranchId(java.lang.String value) {
      *
      *
      * 
      -     * The branch id (e.g. 0/1/2) within this catalog that products from
+     * The branch ID (e.g. 0/1/2) within this catalog that products from
      * merchant_center_account_id are streamed to. When updating this field, an
      * empty value will use the currently configured default branch. However,
      * changing the default branch later on won't change the linked branch here.
-     * A single branch id can only have one linked merchant center account id.
+     * A single branch ID can only have one linked merchant center account ID.
      * 
      
      *
      * string branch_id = 2;
@@ -953,11 +1102,11 @@ public Builder clearBranchId() {
      *
      *
      * 
      -     * The branch id (e.g. 0/1/2) within this catalog that products from
+     * The branch ID (e.g. 0/1/2) within this catalog that products from
      * merchant_center_account_id are streamed to. When updating this field, an
      * empty value will use the currently configured default branch. However,
      * changing the default branch later on won't change the linked branch here.
-     * A single branch id can only have one linked merchant center account id.
+     * A single branch ID can only have one linked merchant center account ID.
      * 
      
      *
      * string branch_id = 2;
@@ -1460,6 +1609,404 @@ public Builder setLanguageCodeBytes(com.google.protobuf.ByteString value) {
       return this;
     }
 
+    private java.util.List feeds_ =
+        java.util.Collections.emptyList();
+
+    private void ensureFeedsIsMutable() {
+      if (!((bitField0_ & 0x00000002) != 0)) {
+        feeds_ =
+            new java.util.ArrayList(
+                feeds_);
+        bitField0_ |= 0x00000002;
+      }
+    }
+
+    private com.google.protobuf.RepeatedFieldBuilderV3<
+            com.google.cloud.retail.v2beta.MerchantCenterFeedFilter,
+            com.google.cloud.retail.v2beta.MerchantCenterFeedFilter.Builder,
+            com.google.cloud.retail.v2beta.MerchantCenterFeedFilterOrBuilder>
+        feedsBuilder_;
+
+    /**
+     *
+     *
+     * 
      +     * Criteria for the Merchant Center feeds to be ingested via the link.
+     * All offers will be ingested if the list is empty.
+     * Otherwise the offers will be ingested from selected feeds.
+     * 
      
+     *
+     * repeated .google.cloud.retail.v2beta.MerchantCenterFeedFilter feeds = 6;
+     */
+    public java.util.List getFeedsList() {
+      if (feedsBuilder_ == null) {
+        return java.util.Collections.unmodifiableList(feeds_);
+      } else {
+        return feedsBuilder_.getMessageList();
+      }
+    }
+    /**
+     *
+     *
+     * 
      +     * Criteria for the Merchant Center feeds to be ingested via the link.
+     * All offers will be ingested if the list is empty.
+     * Otherwise the offers will be ingested from selected feeds.
+     * 
      
+     *
+     * repeated .google.cloud.retail.v2beta.MerchantCenterFeedFilter feeds = 6;
+     */
+    public int getFeedsCount() {
+      if (feedsBuilder_ == null) {
+        return feeds_.size();
+      } else {
+        return feedsBuilder_.getCount();
+      }
+    }
+    /**
+     *
+     *
+     * 
      +     * Criteria for the Merchant Center feeds to be ingested via the link.
+     * All offers will be ingested if the list is empty.
+     * Otherwise the offers will be ingested from selected feeds.
+     * 
      
+     *
+     * repeated .google.cloud.retail.v2beta.MerchantCenterFeedFilter feeds = 6;
+     */
+    public com.google.cloud.retail.v2beta.MerchantCenterFeedFilter getFeeds(int index) {
+      if (feedsBuilder_ == null) {
+        return feeds_.get(index);
+      } else {
+        return feedsBuilder_.getMessage(index);
+      }
+    }
+    /**
+     *
+     *
+     * 
      +     * Criteria for the Merchant Center feeds to be ingested via the link.
+     * All offers will be ingested if the list is empty.
+     * Otherwise the offers will be ingested from selected feeds.
+     * 
      
+     *
+     * repeated .google.cloud.retail.v2beta.MerchantCenterFeedFilter feeds = 6;
+     */
+    public Builder setFeeds(
+        int index, com.google.cloud.retail.v2beta.MerchantCenterFeedFilter value) {
+      if (feedsBuilder_ == null) {
+        if (value == null) {
+          throw new NullPointerException();
+        }
+        ensureFeedsIsMutable();
+        feeds_.set(index, value);
+        onChanged();
+      } else {
+        feedsBuilder_.setMessage(index, value);
+      }
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * Criteria for the Merchant Center feeds to be ingested via the link.
+     * All offers will be ingested if the list is empty.
+     * Otherwise the offers will be ingested from selected feeds.
+     * 
      
+     *
+     * repeated .google.cloud.retail.v2beta.MerchantCenterFeedFilter feeds = 6;
+     */
+    public Builder setFeeds(
+        int index,
+        com.google.cloud.retail.v2beta.MerchantCenterFeedFilter.Builder builderForValue) {
+      if (feedsBuilder_ == null) {
+        ensureFeedsIsMutable();
+        feeds_.set(index, builderForValue.build());
+        onChanged();
+      } else {
+        feedsBuilder_.setMessage(index, builderForValue.build());
+      }
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * Criteria for the Merchant Center feeds to be ingested via the link.
+     * All offers will be ingested if the list is empty.
+     * Otherwise the offers will be ingested from selected feeds.
+     * 
      
+     *
+     * repeated .google.cloud.retail.v2beta.MerchantCenterFeedFilter feeds = 6;
+     */
+    public Builder addFeeds(com.google.cloud.retail.v2beta.MerchantCenterFeedFilter value) {
+      if (feedsBuilder_ == null) {
+        if (value == null) {
+          throw new NullPointerException();
+        }
+        ensureFeedsIsMutable();
+        feeds_.add(value);
+        onChanged();
+      } else {
+        feedsBuilder_.addMessage(value);
+      }
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * Criteria for the Merchant Center feeds to be ingested via the link.
+     * All offers will be ingested if the list is empty.
+     * Otherwise the offers will be ingested from selected feeds.
+     * 
      
+     *
+     * repeated .google.cloud.retail.v2beta.MerchantCenterFeedFilter feeds = 6;
+     */
+    public Builder addFeeds(
+        int index, com.google.cloud.retail.v2beta.MerchantCenterFeedFilter value) {
+      if (feedsBuilder_ == null) {
+        if (value == null) {
+          throw new NullPointerException();
+        }
+        ensureFeedsIsMutable();
+        feeds_.add(index, value);
+        onChanged();
+      } else {
+        feedsBuilder_.addMessage(index, value);
+      }
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * Criteria for the Merchant Center feeds to be ingested via the link.
+     * All offers will be ingested if the list is empty.
+     * Otherwise the offers will be ingested from selected feeds.
+     * 
      
+     *
+     * repeated .google.cloud.retail.v2beta.MerchantCenterFeedFilter feeds = 6;
+     */
+    public Builder addFeeds(
+        com.google.cloud.retail.v2beta.MerchantCenterFeedFilter.Builder builderForValue) {
+      if (feedsBuilder_ == null) {
+        ensureFeedsIsMutable();
+        feeds_.add(builderForValue.build());
+        onChanged();
+      } else {
+        feedsBuilder_.addMessage(builderForValue.build());
+      }
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * Criteria for the Merchant Center feeds to be ingested via the link.
+     * All offers will be ingested if the list is empty.
+     * Otherwise the offers will be ingested from selected feeds.
+     * 
      
+     *
+     * repeated .google.cloud.retail.v2beta.MerchantCenterFeedFilter feeds = 6;
+     */
+    public Builder addFeeds(
+        int index,
+        com.google.cloud.retail.v2beta.MerchantCenterFeedFilter.Builder builderForValue) {
+      if (feedsBuilder_ == null) {
+        ensureFeedsIsMutable();
+        feeds_.add(index, builderForValue.build());
+        onChanged();
+      } else {
+        feedsBuilder_.addMessage(index, builderForValue.build());
+      }
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * Criteria for the Merchant Center feeds to be ingested via the link.
+     * All offers will be ingested if the list is empty.
+     * Otherwise the offers will be ingested from selected feeds.
+     * 
      
+     *
+     * repeated .google.cloud.retail.v2beta.MerchantCenterFeedFilter feeds = 6;
+     */
+    public Builder addAllFeeds(
+        java.lang.Iterable
+            values) {
+      if (feedsBuilder_ == null) {
+        ensureFeedsIsMutable();
+        com.google.protobuf.AbstractMessageLite.Builder.addAll(values, feeds_);
+        onChanged();
+      } else {
+        feedsBuilder_.addAllMessages(values);
+      }
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * Criteria for the Merchant Center feeds to be ingested via the link.
+     * All offers will be ingested if the list is empty.
+     * Otherwise the offers will be ingested from selected feeds.
+     * 
      
+     *
+     * repeated .google.cloud.retail.v2beta.MerchantCenterFeedFilter feeds = 6;
+     */
+    public Builder clearFeeds() {
+      if (feedsBuilder_ == null) {
+        feeds_ = java.util.Collections.emptyList();
+        bitField0_ = (bitField0_ & ~0x00000002);
+        onChanged();
+      } else {
+        feedsBuilder_.clear();
+      }
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * Criteria for the Merchant Center feeds to be ingested via the link.
+     * All offers will be ingested if the list is empty.
+     * Otherwise the offers will be ingested from selected feeds.
+     * 
      
+     *
+     * repeated .google.cloud.retail.v2beta.MerchantCenterFeedFilter feeds = 6;
+     */
+    public Builder removeFeeds(int index) {
+      if (feedsBuilder_ == null) {
+        ensureFeedsIsMutable();
+        feeds_.remove(index);
+        onChanged();
+      } else {
+        feedsBuilder_.remove(index);
+      }
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * Criteria for the Merchant Center feeds to be ingested via the link.
+     * All offers will be ingested if the list is empty.
+     * Otherwise the offers will be ingested from selected feeds.
+     * 
      
+     *
+     * repeated .google.cloud.retail.v2beta.MerchantCenterFeedFilter feeds = 6;
+     */
+    public com.google.cloud.retail.v2beta.MerchantCenterFeedFilter.Builder getFeedsBuilder(
+        int index) {
+      return getFeedsFieldBuilder().getBuilder(index);
+    }
+    /**
+     *
+     *
+     * 
      +     * Criteria for the Merchant Center feeds to be ingested via the link.
+     * All offers will be ingested if the list is empty.
+     * Otherwise the offers will be ingested from selected feeds.
+     * 
      
+     *
+     * repeated .google.cloud.retail.v2beta.MerchantCenterFeedFilter feeds = 6;
+     */
+    public com.google.cloud.retail.v2beta.MerchantCenterFeedFilterOrBuilder getFeedsOrBuilder(
+        int index) {
+      if (feedsBuilder_ == null) {
+        return feeds_.get(index);
+      } else {
+        return feedsBuilder_.getMessageOrBuilder(index);
+      }
+    }
+    /**
+     *
+     *
+     * 
      +     * Criteria for the Merchant Center feeds to be ingested via the link.
+     * All offers will be ingested if the list is empty.
+     * Otherwise the offers will be ingested from selected feeds.
+     * 
      
+     *
+     * repeated .google.cloud.retail.v2beta.MerchantCenterFeedFilter feeds = 6;
+     */
+    public java.util.List<
+            ? extends com.google.cloud.retail.v2beta.MerchantCenterFeedFilterOrBuilder>
+        getFeedsOrBuilderList() {
+      if (feedsBuilder_ != null) {
+        return feedsBuilder_.getMessageOrBuilderList();
+      } else {
+        return java.util.Collections.unmodifiableList(feeds_);
+      }
+    }
+    /**
+     *
+     *
+     * 
      +     * Criteria for the Merchant Center feeds to be ingested via the link.
+     * All offers will be ingested if the list is empty.
+     * Otherwise the offers will be ingested from selected feeds.
+     * 
      
+     *
+     * repeated .google.cloud.retail.v2beta.MerchantCenterFeedFilter feeds = 6;
+     */
+    public com.google.cloud.retail.v2beta.MerchantCenterFeedFilter.Builder addFeedsBuilder() {
+      return getFeedsFieldBuilder()
+          .addBuilder(com.google.cloud.retail.v2beta.MerchantCenterFeedFilter.getDefaultInstance());
+    }
+    /**
+     *
+     *
+     * 
      +     * Criteria for the Merchant Center feeds to be ingested via the link.
+     * All offers will be ingested if the list is empty.
+     * Otherwise the offers will be ingested from selected feeds.
+     * 
      
+     *
+     * repeated .google.cloud.retail.v2beta.MerchantCenterFeedFilter feeds = 6;
+     */
+    public com.google.cloud.retail.v2beta.MerchantCenterFeedFilter.Builder addFeedsBuilder(
+        int index) {
+      return getFeedsFieldBuilder()
+          .addBuilder(
+              index, com.google.cloud.retail.v2beta.MerchantCenterFeedFilter.getDefaultInstance());
+    }
+    /**
+     *
+     *
+     * 
      +     * Criteria for the Merchant Center feeds to be ingested via the link.
+     * All offers will be ingested if the list is empty.
+     * Otherwise the offers will be ingested from selected feeds.
+     * 
      
+     *
+     * repeated .google.cloud.retail.v2beta.MerchantCenterFeedFilter feeds = 6;
+     */
+    public java.util.List
+        getFeedsBuilderList() {
+      return getFeedsFieldBuilder().getBuilderList();
+    }
+
+    private com.google.protobuf.RepeatedFieldBuilderV3<
+            com.google.cloud.retail.v2beta.MerchantCenterFeedFilter,
+            com.google.cloud.retail.v2beta.MerchantCenterFeedFilter.Builder,
+            com.google.cloud.retail.v2beta.MerchantCenterFeedFilterOrBuilder>
+        getFeedsFieldBuilder() {
+      if (feedsBuilder_ == null) {
+        feedsBuilder_ =
+            new com.google.protobuf.RepeatedFieldBuilderV3<
+                com.google.cloud.retail.v2beta.MerchantCenterFeedFilter,
+                com.google.cloud.retail.v2beta.MerchantCenterFeedFilter.Builder,
+                com.google.cloud.retail.v2beta.MerchantCenterFeedFilterOrBuilder>(
+                feeds_, ((bitField0_ & 0x00000002) != 0), getParentForChildren(), isClean());
+        feeds_ = null;
+      }
+      return feedsBuilder_;
+    }
+
     @java.lang.Override
     public final Builder setUnknownFields(final com.google.protobuf.UnknownFieldSet unknownFields) {
       return super.setUnknownFields(unknownFields);
diff --git a/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/MerchantCenterLinkOrBuilder.java b/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/MerchantCenterLinkOrBuilder.java
index 0fb134c8d448..e49b0c4010e9 100644
--- a/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/MerchantCenterLinkOrBuilder.java
+++ b/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/MerchantCenterLinkOrBuilder.java
@@ -28,7 +28,7 @@ public interface MerchantCenterLinkOrBuilder
    *
    * 
          * Required. The linked [Merchant center account
-   * id](https://developers.google.com/shopping-content/guides/accountstatuses).
+   * ID](https://developers.google.com/shopping-content/guides/accountstatuses).
    * The account must be a standalone account or a sub-account of a MCA.
    * 
      
    *
@@ -42,11 +42,11 @@ public interface MerchantCenterLinkOrBuilder
    *
    *
    * 
      -   * The branch id (e.g. 0/1/2) within this catalog that products from
+   * The branch ID (e.g. 0/1/2) within this catalog that products from
    * merchant_center_account_id are streamed to. When updating this field, an
    * empty value will use the currently configured default branch. However,
    * changing the default branch later on won't change the linked branch here.
-   * A single branch id can only have one linked merchant center account id.
+   * A single branch ID can only have one linked merchant center account ID.
    * 
      
    *
    * string branch_id = 2;
@@ -58,11 +58,11 @@ public interface MerchantCenterLinkOrBuilder
    *
    *
    * 
      -   * The branch id (e.g. 0/1/2) within this catalog that products from
+   * The branch ID (e.g. 0/1/2) within this catalog that products from
    * merchant_center_account_id are streamed to. When updating this field, an
    * empty value will use the currently configured default branch. However,
    * changing the default branch later on won't change the linked branch here.
-   * A single branch id can only have one linked merchant center account id.
+   * A single branch ID can only have one linked merchant center account ID.
    * 
      
    *
    * string branch_id = 2;
@@ -215,4 +215,66 @@ public interface MerchantCenterLinkOrBuilder
    * @return The bytes for languageCode.
    */
   com.google.protobuf.ByteString getLanguageCodeBytes();
+
+  /**
+   *
+   *
+   * 
      +   * Criteria for the Merchant Center feeds to be ingested via the link.
+   * All offers will be ingested if the list is empty.
+   * Otherwise the offers will be ingested from selected feeds.
+   * 
      
+   *
+   * repeated .google.cloud.retail.v2beta.MerchantCenterFeedFilter feeds = 6;
+   */
+  java.util.List getFeedsList();
+  /**
+   *
+   *
+   * 
      +   * Criteria for the Merchant Center feeds to be ingested via the link.
+   * All offers will be ingested if the list is empty.
+   * Otherwise the offers will be ingested from selected feeds.
+   * 
      
+   *
+   * repeated .google.cloud.retail.v2beta.MerchantCenterFeedFilter feeds = 6;
+   */
+  com.google.cloud.retail.v2beta.MerchantCenterFeedFilter getFeeds(int index);
+  /**
+   *
+   *
+   * 
      +   * Criteria for the Merchant Center feeds to be ingested via the link.
+   * All offers will be ingested if the list is empty.
+   * Otherwise the offers will be ingested from selected feeds.
+   * 
      
+   *
+   * repeated .google.cloud.retail.v2beta.MerchantCenterFeedFilter feeds = 6;
+   */
+  int getFeedsCount();
+  /**
+   *
+   *
+   * 
      +   * Criteria for the Merchant Center feeds to be ingested via the link.
+   * All offers will be ingested if the list is empty.
+   * Otherwise the offers will be ingested from selected feeds.
+   * 
      
+   *
+   * repeated .google.cloud.retail.v2beta.MerchantCenterFeedFilter feeds = 6;
+   */
+  java.util.List
+      getFeedsOrBuilderList();
+  /**
+   *
+   *
+   * 
      +   * Criteria for the Merchant Center feeds to be ingested via the link.
+   * All offers will be ingested if the list is empty.
+   * Otherwise the offers will be ingested from selected feeds.
+   * 
      
+   *
+   * repeated .google.cloud.retail.v2beta.MerchantCenterFeedFilter feeds = 6;
+   */
+  com.google.cloud.retail.v2beta.MerchantCenterFeedFilterOrBuilder getFeedsOrBuilder(int index);
 }
diff --git a/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/Model.java b/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/Model.java
index c7ca9140b2e4..971536d2d992 100644
--- a/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/Model.java
+++ b/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/Model.java
@@ -1887,7 +1887,7 @@ public com.google.protobuf.TimestampOrBuilder getUpdateTimeOrBuilder() {
    * Required. The type of model e.g. `home-page`.
    * Currently supported values: `recommended-for-you`, `others-you-may-like`,
    * `frequently-bought-together`, `page-optimization`, `similar-items`,
-   * `buy-it-again`, and `recently-viewed`(readonly value).
+   * `buy-it-again`, `on-sale-items`, and `recently-viewed`(readonly value).
    * This field together with
    * [optimization_objective][google.cloud.retail.v2beta.Model.optimization_objective]
    * describe model metadata to use to control model training and serving.
@@ -1922,7 +1922,7 @@ public java.lang.String getType() {
    * Required. The type of model e.g. `home-page`.
    * Currently supported values: `recommended-for-you`, `others-you-may-like`,
    * `frequently-bought-together`, `page-optimization`, `similar-items`,
-   * `buy-it-again`, and `recently-viewed`(readonly value).
+   * `buy-it-again`, `on-sale-items`, and `recently-viewed`(readonly value).
    * This field together with
    * [optimization_objective][google.cloud.retail.v2beta.Model.optimization_objective]
    * describe model metadata to use to control model training and serving.
@@ -4000,7 +4000,7 @@ public com.google.protobuf.TimestampOrBuilder getUpdateTimeOrBuilder() {
      * Required. The type of model e.g. `home-page`.
      * Currently supported values: `recommended-for-you`, `others-you-may-like`,
      * `frequently-bought-together`, `page-optimization`, `similar-items`,
-     * `buy-it-again`, and `recently-viewed`(readonly value).
+     * `buy-it-again`, `on-sale-items`, and `recently-viewed`(readonly value).
      * This field together with
      * [optimization_objective][google.cloud.retail.v2beta.Model.optimization_objective]
      * describe model metadata to use to control model training and serving.
@@ -4034,7 +4034,7 @@ public java.lang.String getType() {
      * Required. The type of model e.g. `home-page`.
      * Currently supported values: `recommended-for-you`, `others-you-may-like`,
      * `frequently-bought-together`, `page-optimization`, `similar-items`,
-     * `buy-it-again`, and `recently-viewed`(readonly value).
+     * `buy-it-again`, `on-sale-items`, and `recently-viewed`(readonly value).
      * This field together with
      * [optimization_objective][google.cloud.retail.v2beta.Model.optimization_objective]
      * describe model metadata to use to control model training and serving.
@@ -4068,7 +4068,7 @@ public com.google.protobuf.ByteString getTypeBytes() {
      * Required. The type of model e.g. `home-page`.
      * Currently supported values: `recommended-for-you`, `others-you-may-like`,
      * `frequently-bought-together`, `page-optimization`, `similar-items`,
-     * `buy-it-again`, and `recently-viewed`(readonly value).
+     * `buy-it-again`, `on-sale-items`, and `recently-viewed`(readonly value).
      * This field together with
      * [optimization_objective][google.cloud.retail.v2beta.Model.optimization_objective]
      * describe model metadata to use to control model training and serving.
@@ -4101,7 +4101,7 @@ public Builder setType(java.lang.String value) {
      * Required. The type of model e.g. `home-page`.
      * Currently supported values: `recommended-for-you`, `others-you-may-like`,
      * `frequently-bought-together`, `page-optimization`, `similar-items`,
-     * `buy-it-again`, and `recently-viewed`(readonly value).
+     * `buy-it-again`, `on-sale-items`, and `recently-viewed`(readonly value).
      * This field together with
      * [optimization_objective][google.cloud.retail.v2beta.Model.optimization_objective]
      * describe model metadata to use to control model training and serving.
@@ -4130,7 +4130,7 @@ public Builder clearType() {
      * Required. The type of model e.g. `home-page`.
      * Currently supported values: `recommended-for-you`, `others-you-may-like`,
      * `frequently-bought-together`, `page-optimization`, `similar-items`,
-     * `buy-it-again`, and `recently-viewed`(readonly value).
+     * `buy-it-again`, `on-sale-items`, and `recently-viewed`(readonly value).
      * This field together with
      * [optimization_objective][google.cloud.retail.v2beta.Model.optimization_objective]
      * describe model metadata to use to control model training and serving.
diff --git a/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/ModelOrBuilder.java b/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/ModelOrBuilder.java
index 0b5e244f74a5..7338ef628f3b 100644
--- a/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/ModelOrBuilder.java
+++ b/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/ModelOrBuilder.java
@@ -246,7 +246,7 @@ public interface ModelOrBuilder
    * Required. The type of model e.g. `home-page`.
    * Currently supported values: `recommended-for-you`, `others-you-may-like`,
    * `frequently-bought-together`, `page-optimization`, `similar-items`,
-   * `buy-it-again`, and `recently-viewed`(readonly value).
+   * `buy-it-again`, `on-sale-items`, and `recently-viewed`(readonly value).
    * This field together with
    * [optimization_objective][google.cloud.retail.v2beta.Model.optimization_objective]
    * describe model metadata to use to control model training and serving.
@@ -270,7 +270,7 @@ public interface ModelOrBuilder
    * Required. The type of model e.g. `home-page`.
    * Currently supported values: `recommended-for-you`, `others-you-may-like`,
    * `frequently-bought-together`, `page-optimization`, `similar-items`,
-   * `buy-it-again`, and `recently-viewed`(readonly value).
+   * `buy-it-again`, `on-sale-items`, and `recently-viewed`(readonly value).
    * This field together with
    * [optimization_objective][google.cloud.retail.v2beta.Model.optimization_objective]
    * describe model metadata to use to control model training and serving.
diff --git a/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/OutputResult.java b/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/OutputResult.java
index 47cfeb1a7832..d1b25d93fb36 100644
--- a/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/OutputResult.java
+++ b/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/OutputResult.java
@@ -22,7 +22,8 @@
  *
  *
  * 
      - * Output result.
+ * Output result that stores the information about where the exported data is
+ * stored.
  * 
      
  *
  * Protobuf type {@code google.cloud.retail.v2beta.OutputResult}
@@ -39,6 +40,7 @@ private OutputResult(com.google.protobuf.GeneratedMessageV3.Builder builder)
 
   private OutputResult() {
     bigqueryResult_ = java.util.Collections.emptyList();
+    gcsResult_ = java.util.Collections.emptyList();
   }
 
   @java.lang.Override
@@ -73,7 +75,7 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    *
    *
    * 
      -   * Export result in BigQuery.
+   * The BigQuery location where the result is stored.
    * 
      
    *
    * repeated .google.cloud.retail.v2beta.BigQueryOutputResult bigquery_result = 1;
@@ -87,7 +89,7 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    *
    *
    * 
      -   * Export result in BigQuery.
+   * The BigQuery location where the result is stored.
    * 
      
    *
    * repeated .google.cloud.retail.v2beta.BigQueryOutputResult bigquery_result = 1;
@@ -101,7 +103,7 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    *
    *
    * 
      -   * Export result in BigQuery.
+   * The BigQuery location where the result is stored.
    * 
      
    *
    * repeated .google.cloud.retail.v2beta.BigQueryOutputResult bigquery_result = 1;
@@ -114,7 +116,7 @@ public int getBigqueryResultCount() {
    *
    *
    * 
      -   * Export result in BigQuery.
+   * The BigQuery location where the result is stored.
    * 
      
    *
    * repeated .google.cloud.retail.v2beta.BigQueryOutputResult bigquery_result = 1;
@@ -127,7 +129,7 @@ public com.google.cloud.retail.v2beta.BigQueryOutputResult getBigqueryResult(int
    *
    *
    * 
      -   * Export result in BigQuery.
+   * The BigQuery location where the result is stored.
    * 
      
    *
    * repeated .google.cloud.retail.v2beta.BigQueryOutputResult bigquery_result = 1;
@@ -138,6 +140,75 @@ public com.google.cloud.retail.v2beta.BigQueryOutputResultOrBuilder getBigqueryR
     return bigqueryResult_.get(index);
   }
 
+  public static final int GCS_RESULT_FIELD_NUMBER = 2;
+  private java.util.List gcsResult_;
+  /**
+   *
+   *
+   * 
      +   * The Google Cloud Storage location where the result is stored.
+   * 
      
+   *
+   * repeated .google.cloud.retail.v2beta.GcsOutputResult gcs_result = 2;
+   */
+  @java.lang.Override
+  public java.util.List getGcsResultList() {
+    return gcsResult_;
+  }
+  /**
+   *
+   *
+   * 
      +   * The Google Cloud Storage location where the result is stored.
+   * 
      
+   *
+   * repeated .google.cloud.retail.v2beta.GcsOutputResult gcs_result = 2;
+   */
+  @java.lang.Override
+  public java.util.List
+      getGcsResultOrBuilderList() {
+    return gcsResult_;
+  }
+  /**
+   *
+   *
+   * 
      +   * The Google Cloud Storage location where the result is stored.
+   * 
      
+   *
+   * repeated .google.cloud.retail.v2beta.GcsOutputResult gcs_result = 2;
+   */
+  @java.lang.Override
+  public int getGcsResultCount() {
+    return gcsResult_.size();
+  }
+  /**
+   *
+   *
+   * 
      +   * The Google Cloud Storage location where the result is stored.
+   * 
      
+   *
+   * repeated .google.cloud.retail.v2beta.GcsOutputResult gcs_result = 2;
+   */
+  @java.lang.Override
+  public com.google.cloud.retail.v2beta.GcsOutputResult getGcsResult(int index) {
+    return gcsResult_.get(index);
+  }
+  /**
+   *
+   *
+   * 
      +   * The Google Cloud Storage location where the result is stored.
+   * 
      
+   *
+   * repeated .google.cloud.retail.v2beta.GcsOutputResult gcs_result = 2;
+   */
+  @java.lang.Override
+  public com.google.cloud.retail.v2beta.GcsOutputResultOrBuilder getGcsResultOrBuilder(int index) {
+    return gcsResult_.get(index);
+  }
+
   private byte memoizedIsInitialized = -1;
 
   @java.lang.Override
@@ -155,6 +226,9 @@ public void writeTo(com.google.protobuf.CodedOutputStream output) throws java.io
     for (int i = 0; i < bigqueryResult_.size(); i++) {
       output.writeMessage(1, bigqueryResult_.get(i));
     }
+    for (int i = 0; i < gcsResult_.size(); i++) {
+      output.writeMessage(2, gcsResult_.get(i));
+    }
     getUnknownFields().writeTo(output);
   }
 
@@ -167,6 +241,9 @@ public int getSerializedSize() {
     for (int i = 0; i < bigqueryResult_.size(); i++) {
       size += com.google.protobuf.CodedOutputStream.computeMessageSize(1, bigqueryResult_.get(i));
     }
+    for (int i = 0; i < gcsResult_.size(); i++) {
+      size += com.google.protobuf.CodedOutputStream.computeMessageSize(2, gcsResult_.get(i));
+    }
     size += getUnknownFields().getSerializedSize();
     memoizedSize = size;
     return size;
@@ -184,6 +261,7 @@ public boolean equals(final java.lang.Object obj) {
         (com.google.cloud.retail.v2beta.OutputResult) obj;
 
     if (!getBigqueryResultList().equals(other.getBigqueryResultList())) return false;
+    if (!getGcsResultList().equals(other.getGcsResultList())) return false;
     if (!getUnknownFields().equals(other.getUnknownFields())) return false;
     return true;
   }
@@ -199,6 +277,10 @@ public int hashCode() {
       hash = (37 * hash) + BIGQUERY_RESULT_FIELD_NUMBER;
       hash = (53 * hash) + getBigqueryResultList().hashCode();
     }
+    if (getGcsResultCount() > 0) {
+      hash = (37 * hash) + GCS_RESULT_FIELD_NUMBER;
+      hash = (53 * hash) + getGcsResultList().hashCode();
+    }
     hash = (29 * hash) + getUnknownFields().hashCode();
     memoizedHashCode = hash;
     return hash;
@@ -303,7 +385,8 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build
    *
    *
    * 
      -   * Output result.
+   * Output result that stores the information about where the exported data is
+   * stored.
    * 
      
    *
    * Protobuf type {@code google.cloud.retail.v2beta.OutputResult}
@@ -344,6 +427,13 @@ public Builder clear() {
         bigqueryResultBuilder_.clear();
       }
       bitField0_ = (bitField0_ & ~0x00000001);
+      if (gcsResultBuilder_ == null) {
+        gcsResult_ = java.util.Collections.emptyList();
+      } else {
+        gcsResult_ = null;
+        gcsResultBuilder_.clear();
+      }
+      bitField0_ = (bitField0_ & ~0x00000002);
       return this;
     }
 
@@ -381,6 +471,15 @@ public com.google.cloud.retail.v2beta.OutputResult buildPartial() {
       } else {
         result.bigqueryResult_ = bigqueryResultBuilder_.build();
       }
+      if (gcsResultBuilder_ == null) {
+        if (((bitField0_ & 0x00000002) != 0)) {
+          gcsResult_ = java.util.Collections.unmodifiableList(gcsResult_);
+          bitField0_ = (bitField0_ & ~0x00000002);
+        }
+        result.gcsResult_ = gcsResult_;
+      } else {
+        result.gcsResult_ = gcsResultBuilder_.build();
+      }
       onBuilt();
       return result;
     }
@@ -457,6 +556,33 @@ public Builder mergeFrom(com.google.cloud.retail.v2beta.OutputResult other) {
           }
         }
       }
+      if (gcsResultBuilder_ == null) {
+        if (!other.gcsResult_.isEmpty()) {
+          if (gcsResult_.isEmpty()) {
+            gcsResult_ = other.gcsResult_;
+            bitField0_ = (bitField0_ & ~0x00000002);
+          } else {
+            ensureGcsResultIsMutable();
+            gcsResult_.addAll(other.gcsResult_);
+          }
+          onChanged();
+        }
+      } else {
+        if (!other.gcsResult_.isEmpty()) {
+          if (gcsResultBuilder_.isEmpty()) {
+            gcsResultBuilder_.dispose();
+            gcsResultBuilder_ = null;
+            gcsResult_ = other.gcsResult_;
+            bitField0_ = (bitField0_ & ~0x00000002);
+            gcsResultBuilder_ =
+                com.google.protobuf.GeneratedMessageV3.alwaysUseFieldBuilders
+                    ? getGcsResultFieldBuilder()
+                    : null;
+          } else {
+            gcsResultBuilder_.addAllMessages(other.gcsResult_);
+          }
+        }
+      }
       this.mergeUnknownFields(other.getUnknownFields());
       onChanged();
       return this;
@@ -497,6 +623,19 @@ public Builder mergeFrom(
                 }
                 break;
               } // case 10
+            case 18:
+              {
+                com.google.cloud.retail.v2beta.GcsOutputResult m =
+                    input.readMessage(
+                        com.google.cloud.retail.v2beta.GcsOutputResult.parser(), extensionRegistry);
+                if (gcsResultBuilder_ == null) {
+                  ensureGcsResultIsMutable();
+                  gcsResult_.add(m);
+                } else {
+                  gcsResultBuilder_.addMessage(m);
+                }
+                break;
+              } // case 18
             default:
               {
                 if (!super.parseUnknownField(input, extensionRegistry, tag)) {
@@ -538,7 +677,7 @@ private void ensureBigqueryResultIsMutable() {
      *
      *
      * 
      -     * Export result in BigQuery.
+     * The BigQuery location where the result is stored.
      * 
      
      *
      * repeated .google.cloud.retail.v2beta.BigQueryOutputResult bigquery_result = 1;
@@ -555,7 +694,7 @@ private void ensureBigqueryResultIsMutable() {
      *
      *
      * 
      -     * Export result in BigQuery.
+     * The BigQuery location where the result is stored.
      * 
      
      *
      * repeated .google.cloud.retail.v2beta.BigQueryOutputResult bigquery_result = 1;
@@ -571,7 +710,7 @@ public int getBigqueryResultCount() {
      *
      *
      * 
      -     * Export result in BigQuery.
+     * The BigQuery location where the result is stored.
      * 
      
      *
      * repeated .google.cloud.retail.v2beta.BigQueryOutputResult bigquery_result = 1;
@@ -587,7 +726,7 @@ public com.google.cloud.retail.v2beta.BigQueryOutputResult getBigqueryResult(int
      *
      *
      * 
      -     * Export result in BigQuery.
+     * The BigQuery location where the result is stored.
      * 
      
      *
      * repeated .google.cloud.retail.v2beta.BigQueryOutputResult bigquery_result = 1;
@@ -610,7 +749,7 @@ public Builder setBigqueryResult(
      *
      *
      * 
      -     * Export result in BigQuery.
+     * The BigQuery location where the result is stored.
      * 
      
      *
      * repeated .google.cloud.retail.v2beta.BigQueryOutputResult bigquery_result = 1;
@@ -630,7 +769,7 @@ public Builder setBigqueryResult(
      *
      *
      * 
      -     * Export result in BigQuery.
+     * The BigQuery location where the result is stored.
      * 
      
      *
      * repeated .google.cloud.retail.v2beta.BigQueryOutputResult bigquery_result = 1;
@@ -652,7 +791,7 @@ public Builder addBigqueryResult(com.google.cloud.retail.v2beta.BigQueryOutputRe
      *
      *
      * 
      -     * Export result in BigQuery.
+     * The BigQuery location where the result is stored.
      * 
      
      *
      * repeated .google.cloud.retail.v2beta.BigQueryOutputResult bigquery_result = 1;
@@ -675,7 +814,7 @@ public Builder addBigqueryResult(
      *
      *
      * 
      -     * Export result in BigQuery.
+     * The BigQuery location where the result is stored.
      * 
      
      *
      * repeated .google.cloud.retail.v2beta.BigQueryOutputResult bigquery_result = 1;
@@ -695,7 +834,7 @@ public Builder addBigqueryResult(
      *
      *
      * 
      -     * Export result in BigQuery.
+     * The BigQuery location where the result is stored.
      * 
      
      *
      * repeated .google.cloud.retail.v2beta.BigQueryOutputResult bigquery_result = 1;
@@ -715,7 +854,7 @@ public Builder addBigqueryResult(
      *
      *
      * 
      -     * Export result in BigQuery.
+     * The BigQuery location where the result is stored.
      * 
      
      *
      * repeated .google.cloud.retail.v2beta.BigQueryOutputResult bigquery_result = 1;
@@ -735,7 +874,7 @@ public Builder addAllBigqueryResult(
      *
      *
      * 
      -     * Export result in BigQuery.
+     * The BigQuery location where the result is stored.
      * 
      
      *
      * repeated .google.cloud.retail.v2beta.BigQueryOutputResult bigquery_result = 1;
@@ -754,7 +893,7 @@ public Builder clearBigqueryResult() {
      *
      *
      * 
      -     * Export result in BigQuery.
+     * The BigQuery location where the result is stored.
      * 
      
      *
      * repeated .google.cloud.retail.v2beta.BigQueryOutputResult bigquery_result = 1;
@@ -773,7 +912,7 @@ public Builder removeBigqueryResult(int index) {
      *
      *
      * 
      -     * Export result in BigQuery.
+     * The BigQuery location where the result is stored.
      * 
      
      *
      * repeated .google.cloud.retail.v2beta.BigQueryOutputResult bigquery_result = 1;
@@ -786,7 +925,7 @@ public com.google.cloud.retail.v2beta.BigQueryOutputResult.Builder getBigqueryRe
      *
      *
      * 
      -     * Export result in BigQuery.
+     * The BigQuery location where the result is stored.
      * 
      
      *
      * repeated .google.cloud.retail.v2beta.BigQueryOutputResult bigquery_result = 1;
@@ -803,7 +942,7 @@ public com.google.cloud.retail.v2beta.BigQueryOutputResultOrBuilder getBigqueryR
      *
      *
      * 
      -     * Export result in BigQuery.
+     * The BigQuery location where the result is stored.
      * 
      
      *
      * repeated .google.cloud.retail.v2beta.BigQueryOutputResult bigquery_result = 1;
@@ -820,7 +959,7 @@ public com.google.cloud.retail.v2beta.BigQueryOutputResultOrBuilder getBigqueryR
      *
      *
      * 
      -     * Export result in BigQuery.
+     * The BigQuery location where the result is stored.
      * 
      
      *
      * repeated .google.cloud.retail.v2beta.BigQueryOutputResult bigquery_result = 1;
@@ -833,7 +972,7 @@ public com.google.cloud.retail.v2beta.BigQueryOutputResult.Builder addBigqueryRe
      *
      *
      * 
      -     * Export result in BigQuery.
+     * The BigQuery location where the result is stored.
      * 
      
      *
      * repeated .google.cloud.retail.v2beta.BigQueryOutputResult bigquery_result = 1;
@@ -848,7 +987,7 @@ public com.google.cloud.retail.v2beta.BigQueryOutputResult.Builder addBigqueryRe
      *
      *
      * 
      -     * Export result in BigQuery.
+     * The BigQuery location where the result is stored.
      * 
      
      *
      * repeated .google.cloud.retail.v2beta.BigQueryOutputResult bigquery_result = 1;
@@ -878,6 +1017,358 @@ public com.google.cloud.retail.v2beta.BigQueryOutputResult.Builder addBigqueryRe
       return bigqueryResultBuilder_;
     }
 
+    private java.util.List gcsResult_ =
+        java.util.Collections.emptyList();
+
+    private void ensureGcsResultIsMutable() {
+      if (!((bitField0_ & 0x00000002) != 0)) {
+        gcsResult_ =
+            new java.util.ArrayList(gcsResult_);
+        bitField0_ |= 0x00000002;
+      }
+    }
+
+    private com.google.protobuf.RepeatedFieldBuilderV3<
+            com.google.cloud.retail.v2beta.GcsOutputResult,
+            com.google.cloud.retail.v2beta.GcsOutputResult.Builder,
+            com.google.cloud.retail.v2beta.GcsOutputResultOrBuilder>
+        gcsResultBuilder_;
+
+    /**
+     *
+     *
+     * 
      +     * The Google Cloud Storage location where the result is stored.
+     * 
      
+     *
+     * repeated .google.cloud.retail.v2beta.GcsOutputResult gcs_result = 2;
+     */
+    public java.util.List getGcsResultList() {
+      if (gcsResultBuilder_ == null) {
+        return java.util.Collections.unmodifiableList(gcsResult_);
+      } else {
+        return gcsResultBuilder_.getMessageList();
+      }
+    }
+    /**
+     *
+     *
+     * 
      +     * The Google Cloud Storage location where the result is stored.
+     * 
      
+     *
+     * repeated .google.cloud.retail.v2beta.GcsOutputResult gcs_result = 2;
+     */
+    public int getGcsResultCount() {
+      if (gcsResultBuilder_ == null) {
+        return gcsResult_.size();
+      } else {
+        return gcsResultBuilder_.getCount();
+      }
+    }
+    /**
+     *
+     *
+     * 
      +     * The Google Cloud Storage location where the result is stored.
+     * 
      
+     *
+     * repeated .google.cloud.retail.v2beta.GcsOutputResult gcs_result = 2;
+     */
+    public com.google.cloud.retail.v2beta.GcsOutputResult getGcsResult(int index) {
+      if (gcsResultBuilder_ == null) {
+        return gcsResult_.get(index);
+      } else {
+        return gcsResultBuilder_.getMessage(index);
+      }
+    }
+    /**
+     *
+     *
+     * 
      +     * The Google Cloud Storage location where the result is stored.
+     * 
      
+     *
+     * repeated .google.cloud.retail.v2beta.GcsOutputResult gcs_result = 2;
+     */
+    public Builder setGcsResult(int index, com.google.cloud.retail.v2beta.GcsOutputResult value) {
+      if (gcsResultBuilder_ == null) {
+        if (value == null) {
+          throw new NullPointerException();
+        }
+        ensureGcsResultIsMutable();
+        gcsResult_.set(index, value);
+        onChanged();
+      } else {
+        gcsResultBuilder_.setMessage(index, value);
+      }
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * The Google Cloud Storage location where the result is stored.
+     * 
      
+     *
+     * repeated .google.cloud.retail.v2beta.GcsOutputResult gcs_result = 2;
+     */
+    public Builder setGcsResult(
+        int index, com.google.cloud.retail.v2beta.GcsOutputResult.Builder builderForValue) {
+      if (gcsResultBuilder_ == null) {
+        ensureGcsResultIsMutable();
+        gcsResult_.set(index, builderForValue.build());
+        onChanged();
+      } else {
+        gcsResultBuilder_.setMessage(index, builderForValue.build());
+      }
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * The Google Cloud Storage location where the result is stored.
+     * 
      
+     *
+     * repeated .google.cloud.retail.v2beta.GcsOutputResult gcs_result = 2;
+     */
+    public Builder addGcsResult(com.google.cloud.retail.v2beta.GcsOutputResult value) {
+      if (gcsResultBuilder_ == null) {
+        if (value == null) {
+          throw new NullPointerException();
+        }
+        ensureGcsResultIsMutable();
+        gcsResult_.add(value);
+        onChanged();
+      } else {
+        gcsResultBuilder_.addMessage(value);
+      }
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * The Google Cloud Storage location where the result is stored.
+     * 
      
+     *
+     * repeated .google.cloud.retail.v2beta.GcsOutputResult gcs_result = 2;
+     */
+    public Builder addGcsResult(int index, com.google.cloud.retail.v2beta.GcsOutputResult value) {
+      if (gcsResultBuilder_ == null) {
+        if (value == null) {
+          throw new NullPointerException();
+        }
+        ensureGcsResultIsMutable();
+        gcsResult_.add(index, value);
+        onChanged();
+      } else {
+        gcsResultBuilder_.addMessage(index, value);
+      }
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * The Google Cloud Storage location where the result is stored.
+     * 
      
+     *
+     * repeated .google.cloud.retail.v2beta.GcsOutputResult gcs_result = 2;
+     */
+    public Builder addGcsResult(
+        com.google.cloud.retail.v2beta.GcsOutputResult.Builder builderForValue) {
+      if (gcsResultBuilder_ == null) {
+        ensureGcsResultIsMutable();
+        gcsResult_.add(builderForValue.build());
+        onChanged();
+      } else {
+        gcsResultBuilder_.addMessage(builderForValue.build());
+      }
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * The Google Cloud Storage location where the result is stored.
+     * 
      
+     *
+     * repeated .google.cloud.retail.v2beta.GcsOutputResult gcs_result = 2;
+     */
+    public Builder addGcsResult(
+        int index, com.google.cloud.retail.v2beta.GcsOutputResult.Builder builderForValue) {
+      if (gcsResultBuilder_ == null) {
+        ensureGcsResultIsMutable();
+        gcsResult_.add(index, builderForValue.build());
+        onChanged();
+      } else {
+        gcsResultBuilder_.addMessage(index, builderForValue.build());
+      }
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * The Google Cloud Storage location where the result is stored.
+     * 
      
+     *
+     * repeated .google.cloud.retail.v2beta.GcsOutputResult gcs_result = 2;
+     */
+    public Builder addAllGcsResult(
+        java.lang.Iterable values) {
+      if (gcsResultBuilder_ == null) {
+        ensureGcsResultIsMutable();
+        com.google.protobuf.AbstractMessageLite.Builder.addAll(values, gcsResult_);
+        onChanged();
+      } else {
+        gcsResultBuilder_.addAllMessages(values);
+      }
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * The Google Cloud Storage location where the result is stored.
+     * 
      
+     *
+     * repeated .google.cloud.retail.v2beta.GcsOutputResult gcs_result = 2;
+     */
+    public Builder clearGcsResult() {
+      if (gcsResultBuilder_ == null) {
+        gcsResult_ = java.util.Collections.emptyList();
+        bitField0_ = (bitField0_ & ~0x00000002);
+        onChanged();
+      } else {
+        gcsResultBuilder_.clear();
+      }
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * The Google Cloud Storage location where the result is stored.
+     * 
      
+     *
+     * repeated .google.cloud.retail.v2beta.GcsOutputResult gcs_result = 2;
+     */
+    public Builder removeGcsResult(int index) {
+      if (gcsResultBuilder_ == null) {
+        ensureGcsResultIsMutable();
+        gcsResult_.remove(index);
+        onChanged();
+      } else {
+        gcsResultBuilder_.remove(index);
+      }
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * The Google Cloud Storage location where the result is stored.
+     * 
      
+     *
+     * repeated .google.cloud.retail.v2beta.GcsOutputResult gcs_result = 2;
+     */
+    public com.google.cloud.retail.v2beta.GcsOutputResult.Builder getGcsResultBuilder(int index) {
+      return getGcsResultFieldBuilder().getBuilder(index);
+    }
+    /**
+     *
+     *
+     * 
      +     * The Google Cloud Storage location where the result is stored.
+     * 
      
+     *
+     * repeated .google.cloud.retail.v2beta.GcsOutputResult gcs_result = 2;
+     */
+    public com.google.cloud.retail.v2beta.GcsOutputResultOrBuilder getGcsResultOrBuilder(
+        int index) {
+      if (gcsResultBuilder_ == null) {
+        return gcsResult_.get(index);
+      } else {
+        return gcsResultBuilder_.getMessageOrBuilder(index);
+      }
+    }
+    /**
+     *
+     *
+     * 
      +     * The Google Cloud Storage location where the result is stored.
+     * 
      
+     *
+     * repeated .google.cloud.retail.v2beta.GcsOutputResult gcs_result = 2;
+     */
+    public java.util.List
+        getGcsResultOrBuilderList() {
+      if (gcsResultBuilder_ != null) {
+        return gcsResultBuilder_.getMessageOrBuilderList();
+      } else {
+        return java.util.Collections.unmodifiableList(gcsResult_);
+      }
+    }
+    /**
+     *
+     *
+     * 
      +     * The Google Cloud Storage location where the result is stored.
+     * 
      
+     *
+     * repeated .google.cloud.retail.v2beta.GcsOutputResult gcs_result = 2;
+     */
+    public com.google.cloud.retail.v2beta.GcsOutputResult.Builder addGcsResultBuilder() {
+      return getGcsResultFieldBuilder()
+          .addBuilder(com.google.cloud.retail.v2beta.GcsOutputResult.getDefaultInstance());
+    }
+    /**
+     *
+     *
+     * 
      +     * The Google Cloud Storage location where the result is stored.
+     * 
      
+     *
+     * repeated .google.cloud.retail.v2beta.GcsOutputResult gcs_result = 2;
+     */
+    public com.google.cloud.retail.v2beta.GcsOutputResult.Builder addGcsResultBuilder(int index) {
+      return getGcsResultFieldBuilder()
+          .addBuilder(index, com.google.cloud.retail.v2beta.GcsOutputResult.getDefaultInstance());
+    }
+    /**
+     *
+     *
+     * 
      +     * The Google Cloud Storage location where the result is stored.
+     * 
      
+     *
+     * repeated .google.cloud.retail.v2beta.GcsOutputResult gcs_result = 2;
+     */
+    public java.util.List
+        getGcsResultBuilderList() {
+      return getGcsResultFieldBuilder().getBuilderList();
+    }
+
+    private com.google.protobuf.RepeatedFieldBuilderV3<
+            com.google.cloud.retail.v2beta.GcsOutputResult,
+            com.google.cloud.retail.v2beta.GcsOutputResult.Builder,
+            com.google.cloud.retail.v2beta.GcsOutputResultOrBuilder>
+        getGcsResultFieldBuilder() {
+      if (gcsResultBuilder_ == null) {
+        gcsResultBuilder_ =
+            new com.google.protobuf.RepeatedFieldBuilderV3<
+                com.google.cloud.retail.v2beta.GcsOutputResult,
+                com.google.cloud.retail.v2beta.GcsOutputResult.Builder,
+                com.google.cloud.retail.v2beta.GcsOutputResultOrBuilder>(
+                gcsResult_, ((bitField0_ & 0x00000002) != 0), getParentForChildren(), isClean());
+        gcsResult_ = null;
+      }
+      return gcsResultBuilder_;
+    }
+
     @java.lang.Override
     public final Builder setUnknownFields(final com.google.protobuf.UnknownFieldSet unknownFields) {
       return super.setUnknownFields(unknownFields);
diff --git a/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/OutputResultOrBuilder.java b/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/OutputResultOrBuilder.java
index 5977b79a778f..c7e7477098e0 100644
--- a/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/OutputResultOrBuilder.java
+++ b/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/OutputResultOrBuilder.java
@@ -27,7 +27,7 @@ public interface OutputResultOrBuilder
    *
    *
    * 
      -   * Export result in BigQuery.
+   * The BigQuery location where the result is stored.
    * 
      
    *
    * repeated .google.cloud.retail.v2beta.BigQueryOutputResult bigquery_result = 1;
@@ -37,7 +37,7 @@ public interface OutputResultOrBuilder
    *
    *
    * 
      -   * Export result in BigQuery.
+   * The BigQuery location where the result is stored.
    * 
      
    *
    * repeated .google.cloud.retail.v2beta.BigQueryOutputResult bigquery_result = 1;
@@ -47,7 +47,7 @@ public interface OutputResultOrBuilder
    *
    *
    * 
      -   * Export result in BigQuery.
+   * The BigQuery location where the result is stored.
    * 
      
    *
    * repeated .google.cloud.retail.v2beta.BigQueryOutputResult bigquery_result = 1;
@@ -57,7 +57,7 @@ public interface OutputResultOrBuilder
    *
    *
    * 
      -   * Export result in BigQuery.
+   * The BigQuery location where the result is stored.
    * 
      
    *
    * repeated .google.cloud.retail.v2beta.BigQueryOutputResult bigquery_result = 1;
@@ -68,11 +68,63 @@ public interface OutputResultOrBuilder
    *
    *
    * 
      -   * Export result in BigQuery.
+   * The BigQuery location where the result is stored.
    * 
      
    *
    * repeated .google.cloud.retail.v2beta.BigQueryOutputResult bigquery_result = 1;
    */
   com.google.cloud.retail.v2beta.BigQueryOutputResultOrBuilder getBigqueryResultOrBuilder(
       int index);
+
+  /**
+   *
+   *
+   * 
      +   * The Google Cloud Storage location where the result is stored.
+   * 
      
+   *
+   * repeated .google.cloud.retail.v2beta.GcsOutputResult gcs_result = 2;
+   */
+  java.util.List getGcsResultList();
+  /**
+   *
+   *
+   * 
      +   * The Google Cloud Storage location where the result is stored.
+   * 
      
+   *
+   * repeated .google.cloud.retail.v2beta.GcsOutputResult gcs_result = 2;
+   */
+  com.google.cloud.retail.v2beta.GcsOutputResult getGcsResult(int index);
+  /**
+   *
+   *
+   * 
      +   * The Google Cloud Storage location where the result is stored.
+   * 
      
+   *
+   * repeated .google.cloud.retail.v2beta.GcsOutputResult gcs_result = 2;
+   */
+  int getGcsResultCount();
+  /**
+   *
+   *
+   * 
      +   * The Google Cloud Storage location where the result is stored.
+   * 
      
+   *
+   * repeated .google.cloud.retail.v2beta.GcsOutputResult gcs_result = 2;
+   */
+  java.util.List
+      getGcsResultOrBuilderList();
+  /**
+   *
+   *
+   * 
      +   * The Google Cloud Storage location where the result is stored.
+   * 
      
+   *
+   * repeated .google.cloud.retail.v2beta.GcsOutputResult gcs_result = 2;
+   */
+  com.google.cloud.retail.v2beta.GcsOutputResultOrBuilder getGcsResultOrBuilder(int index);
 }
diff --git a/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/PredictRequest.java b/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/PredictRequest.java
index 9a6bfab16b96..073d6e28b198 100644
--- a/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/PredictRequest.java
+++ b/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/PredictRequest.java
@@ -97,7 +97,7 @@ protected com.google.protobuf.MapField internalGetMapField(int number) {
    * The ID of the Recommendations AI serving config or placement.
    * Before you can request predictions from your model, you must create at
    * least one serving config or placement for it. For more information, see
-   * [Managing serving configurations]
+   * [Manage serving configs]
    * (https://cloud.google.com/retail/docs/manage-configs).
    * The full list of available serving configs can be seen at
    * https://console.cloud.google.com/ai/retail/catalogs/default_catalog/configs
@@ -132,7 +132,7 @@ public java.lang.String getPlacement() {
    * The ID of the Recommendations AI serving config or placement.
    * Before you can request predictions from your model, you must create at
    * least one serving config or placement for it. For more information, see
-   * [Managing serving configurations]
+   * [Manage serving configs]
    * (https://cloud.google.com/retail/docs/manage-configs).
    * The full list of available serving configs can be seen at
    * https://console.cloud.google.com/ai/retail/catalogs/default_catalog/configs
@@ -344,12 +344,11 @@ public com.google.protobuf.ByteString getPageTokenBytes() {
    *  * tag=("Red" OR "Blue") tag="New-Arrival" tag=(NOT "promotional")
    *  * filterOutOfStockItems  tag=(-"promotional")
    *  * filterOutOfStockItems
-   * If your filter blocks all prediction results, the API will return generic
-   * (unfiltered) popular products. If you only want results strictly matching
-   * the filters, set `strictFiltering` to True in `PredictRequest.params` to
-   * receive empty results instead.
-   * Note that the API will never return items with storageStatus of "EXPIRED"
-   * or "DELETED" regardless of filter choices.
+   * If your filter blocks all prediction results, the API will return *no*
+   * results. If instead you want empty result sets to return generic
+   * (unfiltered) popular products, set `strictFiltering` to False in
+   * `PredictRequest.params`. Note that the API will never return items with
+   * storageStatus of "EXPIRED" or "DELETED" regardless of filter choices.
    * If `filterSyntaxV2` is set to true under the `params` field, then
    * attribute-based expressions are expected instead of the above described
    * tag-based syntax. Examples:
@@ -395,12 +394,11 @@ public java.lang.String getFilter() {
    *  * tag=("Red" OR "Blue") tag="New-Arrival" tag=(NOT "promotional")
    *  * filterOutOfStockItems  tag=(-"promotional")
    *  * filterOutOfStockItems
-   * If your filter blocks all prediction results, the API will return generic
-   * (unfiltered) popular products. If you only want results strictly matching
-   * the filters, set `strictFiltering` to True in `PredictRequest.params` to
-   * receive empty results instead.
-   * Note that the API will never return items with storageStatus of "EXPIRED"
-   * or "DELETED" regardless of filter choices.
+   * If your filter blocks all prediction results, the API will return *no*
+   * results. If instead you want empty result sets to return generic
+   * (unfiltered) popular products, set `strictFiltering` to False in
+   * `PredictRequest.params`. Note that the API will never return items with
+   * storageStatus of "EXPIRED" or "DELETED" regardless of filter choices.
    * If `filterSyntaxV2` is set to true under the `params` field, then
    * attribute-based expressions are expected instead of the above described
    * tag-based syntax. Examples:
@@ -487,7 +485,7 @@ public int getParamsCount() {
    * * `returnScore`: Boolean. If set to true, the prediction 'score'
    *    corresponding to each returned product will be set in the
    *    `results.metadata` field in the prediction response. The given
-   *    'score' indicates the probability of an product being clicked/purchased
+   *    'score' indicates the probability of a product being clicked/purchased
    *    given the user's context and history.
    * * `strictFiltering`: Boolean. True by default. If set to false, the service
    *    will return generic (unfiltered) popular products instead of empty if
@@ -533,7 +531,7 @@ public java.util.Map getParams() {
    * * `returnScore`: Boolean. If set to true, the prediction 'score'
    *    corresponding to each returned product will be set in the
    *    `results.metadata` field in the prediction response. The given
-   *    'score' indicates the probability of an product being clicked/purchased
+   *    'score' indicates the probability of a product being clicked/purchased
    *    given the user's context and history.
    * * `strictFiltering`: Boolean. True by default. If set to false, the service
    *    will return generic (unfiltered) popular products instead of empty if
@@ -570,7 +568,7 @@ public java.util.Map getParamsMap()
    * * `returnScore`: Boolean. If set to true, the prediction 'score'
    *    corresponding to each returned product will be set in the
    *    `results.metadata` field in the prediction response. The given
-   *    'score' indicates the probability of an product being clicked/purchased
+   *    'score' indicates the probability of a product being clicked/purchased
    *    given the user's context and history.
    * * `strictFiltering`: Boolean. True by default. If set to false, the service
    *    will return generic (unfiltered) popular products instead of empty if
@@ -612,7 +610,7 @@ public com.google.protobuf.Value getParamsOrDefault(
    * * `returnScore`: Boolean. If set to true, the prediction 'score'
    *    corresponding to each returned product will be set in the
    *    `results.metadata` field in the prediction response. The given
-   *    'score' indicates the probability of an product being clicked/purchased
+   *    'score' indicates the probability of a product being clicked/purchased
    *    given the user's context and history.
    * * `strictFiltering`: Boolean. True by default. If set to false, the service
    *    will return generic (unfiltered) popular products instead of empty if
@@ -1353,7 +1351,7 @@ public Builder mergeFrom(
      * The ID of the Recommendations AI serving config or placement.
      * Before you can request predictions from your model, you must create at
      * least one serving config or placement for it. For more information, see
-     * [Managing serving configurations]
+     * [Manage serving configs]
      * (https://cloud.google.com/retail/docs/manage-configs).
      * The full list of available serving configs can be seen at
      * https://console.cloud.google.com/ai/retail/catalogs/default_catalog/configs
@@ -1387,7 +1385,7 @@ public java.lang.String getPlacement() {
      * The ID of the Recommendations AI serving config or placement.
      * Before you can request predictions from your model, you must create at
      * least one serving config or placement for it. For more information, see
-     * [Managing serving configurations]
+     * [Manage serving configs]
      * (https://cloud.google.com/retail/docs/manage-configs).
      * The full list of available serving configs can be seen at
      * https://console.cloud.google.com/ai/retail/catalogs/default_catalog/configs
@@ -1421,7 +1419,7 @@ public com.google.protobuf.ByteString getPlacementBytes() {
      * The ID of the Recommendations AI serving config or placement.
      * Before you can request predictions from your model, you must create at
      * least one serving config or placement for it. For more information, see
-     * [Managing serving configurations]
+     * [Manage serving configs]
      * (https://cloud.google.com/retail/docs/manage-configs).
      * The full list of available serving configs can be seen at
      * https://console.cloud.google.com/ai/retail/catalogs/default_catalog/configs
@@ -1454,7 +1452,7 @@ public Builder setPlacement(java.lang.String value) {
      * The ID of the Recommendations AI serving config or placement.
      * Before you can request predictions from your model, you must create at
      * least one serving config or placement for it. For more information, see
-     * [Managing serving configurations]
+     * [Manage serving configs]
      * (https://cloud.google.com/retail/docs/manage-configs).
      * The full list of available serving configs can be seen at
      * https://console.cloud.google.com/ai/retail/catalogs/default_catalog/configs
@@ -1483,7 +1481,7 @@ public Builder clearPlacement() {
      * The ID of the Recommendations AI serving config or placement.
      * Before you can request predictions from your model, you must create at
      * least one serving config or placement for it. For more information, see
-     * [Managing serving configurations]
+     * [Manage serving configs]
      * (https://cloud.google.com/retail/docs/manage-configs).
      * The full list of available serving configs can be seen at
      * https://console.cloud.google.com/ai/retail/catalogs/default_catalog/configs
@@ -2020,12 +2018,11 @@ public Builder setPageTokenBytes(com.google.protobuf.ByteString value) {
      *  * tag=("Red" OR "Blue") tag="New-Arrival" tag=(NOT "promotional")
      *  * filterOutOfStockItems  tag=(-"promotional")
      *  * filterOutOfStockItems
-     * If your filter blocks all prediction results, the API will return generic
-     * (unfiltered) popular products. If you only want results strictly matching
-     * the filters, set `strictFiltering` to True in `PredictRequest.params` to
-     * receive empty results instead.
-     * Note that the API will never return items with storageStatus of "EXPIRED"
-     * or "DELETED" regardless of filter choices.
+     * If your filter blocks all prediction results, the API will return *no*
+     * results. If instead you want empty result sets to return generic
+     * (unfiltered) popular products, set `strictFiltering` to False in
+     * `PredictRequest.params`. Note that the API will never return items with
+     * storageStatus of "EXPIRED" or "DELETED" regardless of filter choices.
      * If `filterSyntaxV2` is set to true under the `params` field, then
      * attribute-based expressions are expected instead of the above described
      * tag-based syntax. Examples:
@@ -2070,12 +2067,11 @@ public java.lang.String getFilter() {
      *  * tag=("Red" OR "Blue") tag="New-Arrival" tag=(NOT "promotional")
      *  * filterOutOfStockItems  tag=(-"promotional")
      *  * filterOutOfStockItems
-     * If your filter blocks all prediction results, the API will return generic
-     * (unfiltered) popular products. If you only want results strictly matching
-     * the filters, set `strictFiltering` to True in `PredictRequest.params` to
-     * receive empty results instead.
-     * Note that the API will never return items with storageStatus of "EXPIRED"
-     * or "DELETED" regardless of filter choices.
+     * If your filter blocks all prediction results, the API will return *no*
+     * results. If instead you want empty result sets to return generic
+     * (unfiltered) popular products, set `strictFiltering` to False in
+     * `PredictRequest.params`. Note that the API will never return items with
+     * storageStatus of "EXPIRED" or "DELETED" regardless of filter choices.
      * If `filterSyntaxV2` is set to true under the `params` field, then
      * attribute-based expressions are expected instead of the above described
      * tag-based syntax. Examples:
@@ -2120,12 +2116,11 @@ public com.google.protobuf.ByteString getFilterBytes() {
      *  * tag=("Red" OR "Blue") tag="New-Arrival" tag=(NOT "promotional")
      *  * filterOutOfStockItems  tag=(-"promotional")
      *  * filterOutOfStockItems
-     * If your filter blocks all prediction results, the API will return generic
-     * (unfiltered) popular products. If you only want results strictly matching
-     * the filters, set `strictFiltering` to True in `PredictRequest.params` to
-     * receive empty results instead.
-     * Note that the API will never return items with storageStatus of "EXPIRED"
-     * or "DELETED" regardless of filter choices.
+     * If your filter blocks all prediction results, the API will return *no*
+     * results. If instead you want empty result sets to return generic
+     * (unfiltered) popular products, set `strictFiltering` to False in
+     * `PredictRequest.params`. Note that the API will never return items with
+     * storageStatus of "EXPIRED" or "DELETED" regardless of filter choices.
      * If `filterSyntaxV2` is set to true under the `params` field, then
      * attribute-based expressions are expected instead of the above described
      * tag-based syntax. Examples:
@@ -2169,12 +2164,11 @@ public Builder setFilter(java.lang.String value) {
      *  * tag=("Red" OR "Blue") tag="New-Arrival" tag=(NOT "promotional")
      *  * filterOutOfStockItems  tag=(-"promotional")
      *  * filterOutOfStockItems
-     * If your filter blocks all prediction results, the API will return generic
-     * (unfiltered) popular products. If you only want results strictly matching
-     * the filters, set `strictFiltering` to True in `PredictRequest.params` to
-     * receive empty results instead.
-     * Note that the API will never return items with storageStatus of "EXPIRED"
-     * or "DELETED" regardless of filter choices.
+     * If your filter blocks all prediction results, the API will return *no*
+     * results. If instead you want empty result sets to return generic
+     * (unfiltered) popular products, set `strictFiltering` to False in
+     * `PredictRequest.params`. Note that the API will never return items with
+     * storageStatus of "EXPIRED" or "DELETED" regardless of filter choices.
      * If `filterSyntaxV2` is set to true under the `params` field, then
      * attribute-based expressions are expected instead of the above described
      * tag-based syntax. Examples:
@@ -2214,12 +2208,11 @@ public Builder clearFilter() {
      *  * tag=("Red" OR "Blue") tag="New-Arrival" tag=(NOT "promotional")
      *  * filterOutOfStockItems  tag=(-"promotional")
      *  * filterOutOfStockItems
-     * If your filter blocks all prediction results, the API will return generic
-     * (unfiltered) popular products. If you only want results strictly matching
-     * the filters, set `strictFiltering` to True in `PredictRequest.params` to
-     * receive empty results instead.
-     * Note that the API will never return items with storageStatus of "EXPIRED"
-     * or "DELETED" regardless of filter choices.
+     * If your filter blocks all prediction results, the API will return *no*
+     * results. If instead you want empty result sets to return generic
+     * (unfiltered) popular products, set `strictFiltering` to False in
+     * `PredictRequest.params`. Note that the API will never return items with
+     * storageStatus of "EXPIRED" or "DELETED" regardless of filter choices.
      * If `filterSyntaxV2` is set to true under the `params` field, then
      * attribute-based expressions are expected instead of the above described
      * tag-based syntax. Examples:
@@ -2343,7 +2336,7 @@ public int getParamsCount() {
      * * `returnScore`: Boolean. If set to true, the prediction 'score'
      *    corresponding to each returned product will be set in the
      *    `results.metadata` field in the prediction response. The given
-     *    'score' indicates the probability of an product being clicked/purchased
+     *    'score' indicates the probability of a product being clicked/purchased
      *    given the user's context and history.
      * * `strictFiltering`: Boolean. True by default. If set to false, the service
      *    will return generic (unfiltered) popular products instead of empty if
@@ -2389,7 +2382,7 @@ public java.util.Map getParams() {
      * * `returnScore`: Boolean. If set to true, the prediction 'score'
      *    corresponding to each returned product will be set in the
      *    `results.metadata` field in the prediction response. The given
-     *    'score' indicates the probability of an product being clicked/purchased
+     *    'score' indicates the probability of a product being clicked/purchased
      *    given the user's context and history.
      * * `strictFiltering`: Boolean. True by default. If set to false, the service
      *    will return generic (unfiltered) popular products instead of empty if
@@ -2426,7 +2419,7 @@ public java.util.Map getParamsMap()
      * * `returnScore`: Boolean. If set to true, the prediction 'score'
      *    corresponding to each returned product will be set in the
      *    `results.metadata` field in the prediction response. The given
-     *    'score' indicates the probability of an product being clicked/purchased
+     *    'score' indicates the probability of a product being clicked/purchased
      *    given the user's context and history.
      * * `strictFiltering`: Boolean. True by default. If set to false, the service
      *    will return generic (unfiltered) popular products instead of empty if
@@ -2468,7 +2461,7 @@ public com.google.protobuf.Value getParamsOrDefault(
      * * `returnScore`: Boolean. If set to true, the prediction 'score'
      *    corresponding to each returned product will be set in the
      *    `results.metadata` field in the prediction response. The given
-     *    'score' indicates the probability of an product being clicked/purchased
+     *    'score' indicates the probability of a product being clicked/purchased
      *    given the user's context and history.
      * * `strictFiltering`: Boolean. True by default. If set to false, the service
      *    will return generic (unfiltered) popular products instead of empty if
@@ -2517,7 +2510,7 @@ public Builder clearParams() {
      * * `returnScore`: Boolean. If set to true, the prediction 'score'
      *    corresponding to each returned product will be set in the
      *    `results.metadata` field in the prediction response. The given
-     *    'score' indicates the probability of an product being clicked/purchased
+     *    'score' indicates the probability of a product being clicked/purchased
      *    given the user's context and history.
      * * `strictFiltering`: Boolean. True by default. If set to false, the service
      *    will return generic (unfiltered) popular products instead of empty if
@@ -2562,7 +2555,7 @@ public java.util.Map getMutablePara
      * * `returnScore`: Boolean. If set to true, the prediction 'score'
      *    corresponding to each returned product will be set in the
      *    `results.metadata` field in the prediction response. The given
-     *    'score' indicates the probability of an product being clicked/purchased
+     *    'score' indicates the probability of a product being clicked/purchased
      *    given the user's context and history.
      * * `strictFiltering`: Boolean. True by default. If set to false, the service
      *    will return generic (unfiltered) popular products instead of empty if
@@ -2606,7 +2599,7 @@ public Builder putParams(java.lang.String key, com.google.protobuf.Value value)
      * * `returnScore`: Boolean. If set to true, the prediction 'score'
      *    corresponding to each returned product will be set in the
      *    `results.metadata` field in the prediction response. The given
-     *    'score' indicates the probability of an product being clicked/purchased
+     *    'score' indicates the probability of a product being clicked/purchased
      *    given the user's context and history.
      * * `strictFiltering`: Boolean. True by default. If set to false, the service
      *    will return generic (unfiltered) popular products instead of empty if
diff --git a/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/PredictRequestOrBuilder.java b/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/PredictRequestOrBuilder.java
index 8a88463196e1..3cff540f8861 100644
--- a/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/PredictRequestOrBuilder.java
+++ b/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/PredictRequestOrBuilder.java
@@ -36,7 +36,7 @@ public interface PredictRequestOrBuilder
    * The ID of the Recommendations AI serving config or placement.
    * Before you can request predictions from your model, you must create at
    * least one serving config or placement for it. For more information, see
-   * [Managing serving configurations]
+   * [Manage serving configs]
    * (https://cloud.google.com/retail/docs/manage-configs).
    * The full list of available serving configs can be seen at
    * https://console.cloud.google.com/ai/retail/catalogs/default_catalog/configs
@@ -60,7 +60,7 @@ public interface PredictRequestOrBuilder
    * The ID of the Recommendations AI serving config or placement.
    * Before you can request predictions from your model, you must create at
    * least one serving config or placement for it. For more information, see
-   * [Managing serving configurations]
+   * [Manage serving configs]
    * (https://cloud.google.com/retail/docs/manage-configs).
    * The full list of available serving configs can be seen at
    * https://console.cloud.google.com/ai/retail/catalogs/default_catalog/configs
@@ -217,12 +217,11 @@ public interface PredictRequestOrBuilder
    *  * tag=("Red" OR "Blue") tag="New-Arrival" tag=(NOT "promotional")
    *  * filterOutOfStockItems  tag=(-"promotional")
    *  * filterOutOfStockItems
-   * If your filter blocks all prediction results, the API will return generic
-   * (unfiltered) popular products. If you only want results strictly matching
-   * the filters, set `strictFiltering` to True in `PredictRequest.params` to
-   * receive empty results instead.
-   * Note that the API will never return items with storageStatus of "EXPIRED"
-   * or "DELETED" regardless of filter choices.
+   * If your filter blocks all prediction results, the API will return *no*
+   * results. If instead you want empty result sets to return generic
+   * (unfiltered) popular products, set `strictFiltering` to False in
+   * `PredictRequest.params`. Note that the API will never return items with
+   * storageStatus of "EXPIRED" or "DELETED" regardless of filter choices.
    * If `filterSyntaxV2` is set to true under the `params` field, then
    * attribute-based expressions are expected instead of the above described
    * tag-based syntax. Examples:
@@ -257,12 +256,11 @@ public interface PredictRequestOrBuilder
    *  * tag=("Red" OR "Blue") tag="New-Arrival" tag=(NOT "promotional")
    *  * filterOutOfStockItems  tag=(-"promotional")
    *  * filterOutOfStockItems
-   * If your filter blocks all prediction results, the API will return generic
-   * (unfiltered) popular products. If you only want results strictly matching
-   * the filters, set `strictFiltering` to True in `PredictRequest.params` to
-   * receive empty results instead.
-   * Note that the API will never return items with storageStatus of "EXPIRED"
-   * or "DELETED" regardless of filter choices.
+   * If your filter blocks all prediction results, the API will return *no*
+   * results. If instead you want empty result sets to return generic
+   * (unfiltered) popular products, set `strictFiltering` to False in
+   * `PredictRequest.params`. Note that the API will never return items with
+   * storageStatus of "EXPIRED" or "DELETED" regardless of filter choices.
    * If `filterSyntaxV2` is set to true under the `params` field, then
    * attribute-based expressions are expected instead of the above described
    * tag-based syntax. Examples:
@@ -305,7 +303,7 @@ public interface PredictRequestOrBuilder
    * * `returnScore`: Boolean. If set to true, the prediction 'score'
    *    corresponding to each returned product will be set in the
    *    `results.metadata` field in the prediction response. The given
-   *    'score' indicates the probability of an product being clicked/purchased
+   *    'score' indicates the probability of a product being clicked/purchased
    *    given the user's context and history.
    * * `strictFiltering`: Boolean. True by default. If set to false, the service
    *    will return generic (unfiltered) popular products instead of empty if
@@ -339,7 +337,7 @@ public interface PredictRequestOrBuilder
    * * `returnScore`: Boolean. If set to true, the prediction 'score'
    *    corresponding to each returned product will be set in the
    *    `results.metadata` field in the prediction response. The given
-   *    'score' indicates the probability of an product being clicked/purchased
+   *    'score' indicates the probability of a product being clicked/purchased
    *    given the user's context and history.
    * * `strictFiltering`: Boolean. True by default. If set to false, the service
    *    will return generic (unfiltered) popular products instead of empty if
@@ -376,7 +374,7 @@ public interface PredictRequestOrBuilder
    * * `returnScore`: Boolean. If set to true, the prediction 'score'
    *    corresponding to each returned product will be set in the
    *    `results.metadata` field in the prediction response. The given
-   *    'score' indicates the probability of an product being clicked/purchased
+   *    'score' indicates the probability of a product being clicked/purchased
    *    given the user's context and history.
    * * `strictFiltering`: Boolean. True by default. If set to false, the service
    *    will return generic (unfiltered) popular products instead of empty if
@@ -410,7 +408,7 @@ public interface PredictRequestOrBuilder
    * * `returnScore`: Boolean. If set to true, the prediction 'score'
    *    corresponding to each returned product will be set in the
    *    `results.metadata` field in the prediction response. The given
-   *    'score' indicates the probability of an product being clicked/purchased
+   *    'score' indicates the probability of a product being clicked/purchased
    *    given the user's context and history.
    * * `strictFiltering`: Boolean. True by default. If set to false, the service
    *    will return generic (unfiltered) popular products instead of empty if
@@ -449,7 +447,7 @@ com.google.protobuf.Value getParamsOrDefault(
    * * `returnScore`: Boolean. If set to true, the prediction 'score'
    *    corresponding to each returned product will be set in the
    *    `results.metadata` field in the prediction response. The given
-   *    'score' indicates the probability of an product being clicked/purchased
+   *    'score' indicates the probability of a product being clicked/purchased
    *    given the user's context and history.
    * * `strictFiltering`: Boolean. True by default. If set to false, the service
    *    will return generic (unfiltered) popular products instead of empty if
diff --git a/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/Product.java b/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/Product.java
index b38b1b3a65bb..3c993880309e 100644
--- a/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/Product.java
+++ b/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/Product.java
@@ -576,6 +576,13 @@ public ExpirationCase getExpirationCase() {
    * 
          * The timestamp when this product becomes unavailable for
    * [SearchService.Search][google.cloud.retail.v2beta.SearchService.Search].
+   * Note that this is only applicable to
+   * [Type.PRIMARY][google.cloud.retail.v2beta.Product.Type.PRIMARY] and
+   * [Type.COLLECTION][google.cloud.retail.v2beta.Product.Type.COLLECTION],
+   * and ignored for
+   * [Type.VARIANT][google.cloud.retail.v2beta.Product.Type.VARIANT]. In
+   * general, we suggest the users to delete the stale products explicitly,
+   * instead of using this field to determine staleness.
    * If it is set, the [Product][google.cloud.retail.v2beta.Product] is not
    * available for
    * [SearchService.Search][google.cloud.retail.v2beta.SearchService.Search]
@@ -607,6 +614,13 @@ public boolean hasExpireTime() {
    * 
          * The timestamp when this product becomes unavailable for
    * [SearchService.Search][google.cloud.retail.v2beta.SearchService.Search].
+   * Note that this is only applicable to
+   * [Type.PRIMARY][google.cloud.retail.v2beta.Product.Type.PRIMARY] and
+   * [Type.COLLECTION][google.cloud.retail.v2beta.Product.Type.COLLECTION],
+   * and ignored for
+   * [Type.VARIANT][google.cloud.retail.v2beta.Product.Type.VARIANT]. In
+   * general, we suggest the users to delete the stale products explicitly,
+   * instead of using this field to determine staleness.
    * If it is set, the [Product][google.cloud.retail.v2beta.Product] is not
    * available for
    * [SearchService.Search][google.cloud.retail.v2beta.SearchService.Search]
@@ -641,6 +655,13 @@ public com.google.protobuf.Timestamp getExpireTime() {
    * 
          * The timestamp when this product becomes unavailable for
    * [SearchService.Search][google.cloud.retail.v2beta.SearchService.Search].
+   * Note that this is only applicable to
+   * [Type.PRIMARY][google.cloud.retail.v2beta.Product.Type.PRIMARY] and
+   * [Type.COLLECTION][google.cloud.retail.v2beta.Product.Type.COLLECTION],
+   * and ignored for
+   * [Type.VARIANT][google.cloud.retail.v2beta.Product.Type.VARIANT]. In
+   * general, we suggest the users to delete the stale products explicitly,
+   * instead of using this field to determine staleness.
    * If it is set, the [Product][google.cloud.retail.v2beta.Product] is not
    * available for
    * [SearchService.Search][google.cloud.retail.v2beta.SearchService.Search]
@@ -673,7 +694,14 @@ public com.google.protobuf.TimestampOrBuilder getExpireTimeOrBuilder() {
    *
    *
    * 
      -   * Input only. The TTL (time to live) of the product.
+   * Input only. The TTL (time to live) of the product. Note that this is only
+   * applicable to
+   * [Type.PRIMARY][google.cloud.retail.v2beta.Product.Type.PRIMARY] and
+   * [Type.COLLECTION][google.cloud.retail.v2beta.Product.Type.COLLECTION],
+   * and ignored for
+   * [Type.VARIANT][google.cloud.retail.v2beta.Product.Type.VARIANT]. In
+   * general, we suggest the users to delete the stale products explicitly,
+   * instead of using this field to determine staleness.
    * If it is set, it must be a non-negative value, and
    * [expire_time][google.cloud.retail.v2beta.Product.expire_time] is set as
    * current timestamp plus [ttl][google.cloud.retail.v2beta.Product.ttl]. The
@@ -703,7 +731,14 @@ public boolean hasTtl() {
    *
    *
    * 
      -   * Input only. The TTL (time to live) of the product.
+   * Input only. The TTL (time to live) of the product. Note that this is only
+   * applicable to
+   * [Type.PRIMARY][google.cloud.retail.v2beta.Product.Type.PRIMARY] and
+   * [Type.COLLECTION][google.cloud.retail.v2beta.Product.Type.COLLECTION],
+   * and ignored for
+   * [Type.VARIANT][google.cloud.retail.v2beta.Product.Type.VARIANT]. In
+   * general, we suggest the users to delete the stale products explicitly,
+   * instead of using this field to determine staleness.
    * If it is set, it must be a non-negative value, and
    * [expire_time][google.cloud.retail.v2beta.Product.expire_time] is set as
    * current timestamp plus [ttl][google.cloud.retail.v2beta.Product.ttl]. The
@@ -736,7 +771,14 @@ public com.google.protobuf.Duration getTtl() {
    *
    *
    * 
      -   * Input only. The TTL (time to live) of the product.
+   * Input only. The TTL (time to live) of the product. Note that this is only
+   * applicable to
+   * [Type.PRIMARY][google.cloud.retail.v2beta.Product.Type.PRIMARY] and
+   * [Type.COLLECTION][google.cloud.retail.v2beta.Product.Type.COLLECTION],
+   * and ignored for
+   * [Type.VARIANT][google.cloud.retail.v2beta.Product.Type.VARIANT]. In
+   * general, we suggest the users to delete the stale products explicitly,
+   * instead of using this field to determine staleness.
    * If it is set, it must be a non-negative value, and
    * [expire_time][google.cloud.retail.v2beta.Product.expire_time] is set as
    * current timestamp plus [ttl][google.cloud.retail.v2beta.Product.ttl]. The
@@ -2019,6 +2061,11 @@ public com.google.cloud.retail.v2beta.RatingOrBuilder getRatingOrBuilder() {
    * The timestamp when this [Product][google.cloud.retail.v2beta.Product]
    * becomes available for
    * [SearchService.Search][google.cloud.retail.v2beta.SearchService.Search].
+   * Note that this is only applicable to
+   * [Type.PRIMARY][google.cloud.retail.v2beta.Product.Type.PRIMARY] and
+   * [Type.COLLECTION][google.cloud.retail.v2beta.Product.Type.COLLECTION], and
+   * ignored for
+   * [Type.VARIANT][google.cloud.retail.v2beta.Product.Type.VARIANT].
    * 
      
    *
    * .google.protobuf.Timestamp available_time = 18;
@@ -2036,6 +2083,11 @@ public boolean hasAvailableTime() {
    * The timestamp when this [Product][google.cloud.retail.v2beta.Product]
    * becomes available for
    * [SearchService.Search][google.cloud.retail.v2beta.SearchService.Search].
+   * Note that this is only applicable to
+   * [Type.PRIMARY][google.cloud.retail.v2beta.Product.Type.PRIMARY] and
+   * [Type.COLLECTION][google.cloud.retail.v2beta.Product.Type.COLLECTION], and
+   * ignored for
+   * [Type.VARIANT][google.cloud.retail.v2beta.Product.Type.VARIANT].
    * 
      
    *
    * .google.protobuf.Timestamp available_time = 18;
@@ -2055,6 +2107,11 @@ public com.google.protobuf.Timestamp getAvailableTime() {
    * The timestamp when this [Product][google.cloud.retail.v2beta.Product]
    * becomes available for
    * [SearchService.Search][google.cloud.retail.v2beta.SearchService.Search].
+   * Note that this is only applicable to
+   * [Type.PRIMARY][google.cloud.retail.v2beta.Product.Type.PRIMARY] and
+   * [Type.COLLECTION][google.cloud.retail.v2beta.Product.Type.COLLECTION], and
+   * ignored for
+   * [Type.VARIANT][google.cloud.retail.v2beta.Product.Type.VARIANT].
    * 
      
    *
    * .google.protobuf.Timestamp available_time = 18;
@@ -3104,13 +3161,17 @@ public com.google.protobuf.TimestampOrBuilder getPublishTimeOrBuilder() {
    * Note: Returning more fields in
    * [SearchResponse][google.cloud.retail.v2beta.SearchResponse] can increase
    * response payload size and serving latency.
+   * This field is deprecated. Use the retrievable site-wide control instead.
    * 
      
    *
-   * .google.protobuf.FieldMask retrievable_fields = 30;
+   * .google.protobuf.FieldMask retrievable_fields = 30 [deprecated = true];
    *
+   * @deprecated google.cloud.retail.v2beta.Product.retrievable_fields is deprecated. See
+   *     google/cloud/retail/v2beta/product.proto;l=573
    * @return Whether the retrievableFields field is set.
    */
   @java.lang.Override
+  @java.lang.Deprecated
   public boolean hasRetrievableFields() {
     return retrievableFields_ != null;
   }
@@ -3164,13 +3225,17 @@ public boolean hasRetrievableFields() {
    * Note: Returning more fields in
    * [SearchResponse][google.cloud.retail.v2beta.SearchResponse] can increase
    * response payload size and serving latency.
+   * This field is deprecated. Use the retrievable site-wide control instead.
    * 
      
    *
-   * .google.protobuf.FieldMask retrievable_fields = 30;
+   * .google.protobuf.FieldMask retrievable_fields = 30 [deprecated = true];
    *
+   * @deprecated google.cloud.retail.v2beta.Product.retrievable_fields is deprecated. See
+   *     google/cloud/retail/v2beta/product.proto;l=573
    * @return The retrievableFields.
    */
   @java.lang.Override
+  @java.lang.Deprecated
   public com.google.protobuf.FieldMask getRetrievableFields() {
     return retrievableFields_ == null
         ? com.google.protobuf.FieldMask.getDefaultInstance()
@@ -3226,11 +3291,13 @@ public com.google.protobuf.FieldMask getRetrievableFields() {
    * Note: Returning more fields in
    * [SearchResponse][google.cloud.retail.v2beta.SearchResponse] can increase
    * response payload size and serving latency.
+   * This field is deprecated. Use the retrievable site-wide control instead.
    * 
      
    *
-   * .google.protobuf.FieldMask retrievable_fields = 30;
+   * .google.protobuf.FieldMask retrievable_fields = 30 [deprecated = true];
    */
   @java.lang.Override
+  @java.lang.Deprecated
   public com.google.protobuf.FieldMaskOrBuilder getRetrievableFieldsOrBuilder() {
     return getRetrievableFields();
   }
@@ -5096,6 +5163,13 @@ public Builder clearExpiration() {
      * 
            * The timestamp when this product becomes unavailable for
      * [SearchService.Search][google.cloud.retail.v2beta.SearchService.Search].
+     * Note that this is only applicable to
+     * [Type.PRIMARY][google.cloud.retail.v2beta.Product.Type.PRIMARY] and
+     * [Type.COLLECTION][google.cloud.retail.v2beta.Product.Type.COLLECTION],
+     * and ignored for
+     * [Type.VARIANT][google.cloud.retail.v2beta.Product.Type.VARIANT]. In
+     * general, we suggest the users to delete the stale products explicitly,
+     * instead of using this field to determine staleness.
      * If it is set, the [Product][google.cloud.retail.v2beta.Product] is not
      * available for
      * [SearchService.Search][google.cloud.retail.v2beta.SearchService.Search]
@@ -5127,6 +5201,13 @@ public boolean hasExpireTime() {
      * 
            * The timestamp when this product becomes unavailable for
      * [SearchService.Search][google.cloud.retail.v2beta.SearchService.Search].
+     * Note that this is only applicable to
+     * [Type.PRIMARY][google.cloud.retail.v2beta.Product.Type.PRIMARY] and
+     * [Type.COLLECTION][google.cloud.retail.v2beta.Product.Type.COLLECTION],
+     * and ignored for
+     * [Type.VARIANT][google.cloud.retail.v2beta.Product.Type.VARIANT]. In
+     * general, we suggest the users to delete the stale products explicitly,
+     * instead of using this field to determine staleness.
      * If it is set, the [Product][google.cloud.retail.v2beta.Product] is not
      * available for
      * [SearchService.Search][google.cloud.retail.v2beta.SearchService.Search]
@@ -5168,6 +5249,13 @@ public com.google.protobuf.Timestamp getExpireTime() {
      * 
            * The timestamp when this product becomes unavailable for
      * [SearchService.Search][google.cloud.retail.v2beta.SearchService.Search].
+     * Note that this is only applicable to
+     * [Type.PRIMARY][google.cloud.retail.v2beta.Product.Type.PRIMARY] and
+     * [Type.COLLECTION][google.cloud.retail.v2beta.Product.Type.COLLECTION],
+     * and ignored for
+     * [Type.VARIANT][google.cloud.retail.v2beta.Product.Type.VARIANT]. In
+     * general, we suggest the users to delete the stale products explicitly,
+     * instead of using this field to determine staleness.
      * If it is set, the [Product][google.cloud.retail.v2beta.Product] is not
      * available for
      * [SearchService.Search][google.cloud.retail.v2beta.SearchService.Search]
@@ -5206,6 +5294,13 @@ public Builder setExpireTime(com.google.protobuf.Timestamp value) {
      * 
            * The timestamp when this product becomes unavailable for
      * [SearchService.Search][google.cloud.retail.v2beta.SearchService.Search].
+     * Note that this is only applicable to
+     * [Type.PRIMARY][google.cloud.retail.v2beta.Product.Type.PRIMARY] and
+     * [Type.COLLECTION][google.cloud.retail.v2beta.Product.Type.COLLECTION],
+     * and ignored for
+     * [Type.VARIANT][google.cloud.retail.v2beta.Product.Type.VARIANT]. In
+     * general, we suggest the users to delete the stale products explicitly,
+     * instead of using this field to determine staleness.
      * If it is set, the [Product][google.cloud.retail.v2beta.Product] is not
      * available for
      * [SearchService.Search][google.cloud.retail.v2beta.SearchService.Search]
@@ -5241,6 +5336,13 @@ public Builder setExpireTime(com.google.protobuf.Timestamp.Builder builderForVal
      * 
            * The timestamp when this product becomes unavailable for
      * [SearchService.Search][google.cloud.retail.v2beta.SearchService.Search].
+     * Note that this is only applicable to
+     * [Type.PRIMARY][google.cloud.retail.v2beta.Product.Type.PRIMARY] and
+     * [Type.COLLECTION][google.cloud.retail.v2beta.Product.Type.COLLECTION],
+     * and ignored for
+     * [Type.VARIANT][google.cloud.retail.v2beta.Product.Type.VARIANT]. In
+     * general, we suggest the users to delete the stale products explicitly,
+     * instead of using this field to determine staleness.
      * If it is set, the [Product][google.cloud.retail.v2beta.Product] is not
      * available for
      * [SearchService.Search][google.cloud.retail.v2beta.SearchService.Search]
@@ -5288,6 +5390,13 @@ public Builder mergeExpireTime(com.google.protobuf.Timestamp value) {
      * 
            * The timestamp when this product becomes unavailable for
      * [SearchService.Search][google.cloud.retail.v2beta.SearchService.Search].
+     * Note that this is only applicable to
+     * [Type.PRIMARY][google.cloud.retail.v2beta.Product.Type.PRIMARY] and
+     * [Type.COLLECTION][google.cloud.retail.v2beta.Product.Type.COLLECTION],
+     * and ignored for
+     * [Type.VARIANT][google.cloud.retail.v2beta.Product.Type.VARIANT]. In
+     * general, we suggest the users to delete the stale products explicitly,
+     * instead of using this field to determine staleness.
      * If it is set, the [Product][google.cloud.retail.v2beta.Product] is not
      * available for
      * [SearchService.Search][google.cloud.retail.v2beta.SearchService.Search]
@@ -5329,6 +5438,13 @@ public Builder clearExpireTime() {
      * 
            * The timestamp when this product becomes unavailable for
      * [SearchService.Search][google.cloud.retail.v2beta.SearchService.Search].
+     * Note that this is only applicable to
+     * [Type.PRIMARY][google.cloud.retail.v2beta.Product.Type.PRIMARY] and
+     * [Type.COLLECTION][google.cloud.retail.v2beta.Product.Type.COLLECTION],
+     * and ignored for
+     * [Type.VARIANT][google.cloud.retail.v2beta.Product.Type.VARIANT]. In
+     * general, we suggest the users to delete the stale products explicitly,
+     * instead of using this field to determine staleness.
      * If it is set, the [Product][google.cloud.retail.v2beta.Product] is not
      * available for
      * [SearchService.Search][google.cloud.retail.v2beta.SearchService.Search]
@@ -5357,6 +5473,13 @@ public com.google.protobuf.Timestamp.Builder getExpireTimeBuilder() {
      * 
            * The timestamp when this product becomes unavailable for
      * [SearchService.Search][google.cloud.retail.v2beta.SearchService.Search].
+     * Note that this is only applicable to
+     * [Type.PRIMARY][google.cloud.retail.v2beta.Product.Type.PRIMARY] and
+     * [Type.COLLECTION][google.cloud.retail.v2beta.Product.Type.COLLECTION],
+     * and ignored for
+     * [Type.VARIANT][google.cloud.retail.v2beta.Product.Type.VARIANT]. In
+     * general, we suggest the users to delete the stale products explicitly,
+     * instead of using this field to determine staleness.
      * If it is set, the [Product][google.cloud.retail.v2beta.Product] is not
      * available for
      * [SearchService.Search][google.cloud.retail.v2beta.SearchService.Search]
@@ -5393,6 +5516,13 @@ public com.google.protobuf.TimestampOrBuilder getExpireTimeOrBuilder() {
      * 
            * The timestamp when this product becomes unavailable for
      * [SearchService.Search][google.cloud.retail.v2beta.SearchService.Search].
+     * Note that this is only applicable to
+     * [Type.PRIMARY][google.cloud.retail.v2beta.Product.Type.PRIMARY] and
+     * [Type.COLLECTION][google.cloud.retail.v2beta.Product.Type.COLLECTION],
+     * and ignored for
+     * [Type.VARIANT][google.cloud.retail.v2beta.Product.Type.VARIANT]. In
+     * general, we suggest the users to delete the stale products explicitly,
+     * instead of using this field to determine staleness.
      * If it is set, the [Product][google.cloud.retail.v2beta.Product] is not
      * available for
      * [SearchService.Search][google.cloud.retail.v2beta.SearchService.Search]
@@ -5444,7 +5574,14 @@ public com.google.protobuf.TimestampOrBuilder getExpireTimeOrBuilder() {
      *
      *
      * 
      -     * Input only. The TTL (time to live) of the product.
+     * Input only. The TTL (time to live) of the product. Note that this is only
+     * applicable to
+     * [Type.PRIMARY][google.cloud.retail.v2beta.Product.Type.PRIMARY] and
+     * [Type.COLLECTION][google.cloud.retail.v2beta.Product.Type.COLLECTION],
+     * and ignored for
+     * [Type.VARIANT][google.cloud.retail.v2beta.Product.Type.VARIANT]. In
+     * general, we suggest the users to delete the stale products explicitly,
+     * instead of using this field to determine staleness.
      * If it is set, it must be a non-negative value, and
      * [expire_time][google.cloud.retail.v2beta.Product.expire_time] is set as
      * current timestamp plus [ttl][google.cloud.retail.v2beta.Product.ttl]. The
@@ -5474,7 +5611,14 @@ public boolean hasTtl() {
      *
      *
      * 
      -     * Input only. The TTL (time to live) of the product.
+     * Input only. The TTL (time to live) of the product. Note that this is only
+     * applicable to
+     * [Type.PRIMARY][google.cloud.retail.v2beta.Product.Type.PRIMARY] and
+     * [Type.COLLECTION][google.cloud.retail.v2beta.Product.Type.COLLECTION],
+     * and ignored for
+     * [Type.VARIANT][google.cloud.retail.v2beta.Product.Type.VARIANT]. In
+     * general, we suggest the users to delete the stale products explicitly,
+     * instead of using this field to determine staleness.
      * If it is set, it must be a non-negative value, and
      * [expire_time][google.cloud.retail.v2beta.Product.expire_time] is set as
      * current timestamp plus [ttl][google.cloud.retail.v2beta.Product.ttl]. The
@@ -5514,7 +5658,14 @@ public com.google.protobuf.Duration getTtl() {
      *
      *
      * 
      -     * Input only. The TTL (time to live) of the product.
+     * Input only. The TTL (time to live) of the product. Note that this is only
+     * applicable to
+     * [Type.PRIMARY][google.cloud.retail.v2beta.Product.Type.PRIMARY] and
+     * [Type.COLLECTION][google.cloud.retail.v2beta.Product.Type.COLLECTION],
+     * and ignored for
+     * [Type.VARIANT][google.cloud.retail.v2beta.Product.Type.VARIANT]. In
+     * general, we suggest the users to delete the stale products explicitly,
+     * instead of using this field to determine staleness.
      * If it is set, it must be a non-negative value, and
      * [expire_time][google.cloud.retail.v2beta.Product.expire_time] is set as
      * current timestamp plus [ttl][google.cloud.retail.v2beta.Product.ttl]. The
@@ -5551,7 +5702,14 @@ public Builder setTtl(com.google.protobuf.Duration value) {
      *
      *
      * 
      -     * Input only. The TTL (time to live) of the product.
+     * Input only. The TTL (time to live) of the product. Note that this is only
+     * applicable to
+     * [Type.PRIMARY][google.cloud.retail.v2beta.Product.Type.PRIMARY] and
+     * [Type.COLLECTION][google.cloud.retail.v2beta.Product.Type.COLLECTION],
+     * and ignored for
+     * [Type.VARIANT][google.cloud.retail.v2beta.Product.Type.VARIANT]. In
+     * general, we suggest the users to delete the stale products explicitly,
+     * instead of using this field to determine staleness.
      * If it is set, it must be a non-negative value, and
      * [expire_time][google.cloud.retail.v2beta.Product.expire_time] is set as
      * current timestamp plus [ttl][google.cloud.retail.v2beta.Product.ttl]. The
@@ -5585,7 +5743,14 @@ public Builder setTtl(com.google.protobuf.Duration.Builder builderForValue) {
      *
      *
      * 
      -     * Input only. The TTL (time to live) of the product.
+     * Input only. The TTL (time to live) of the product. Note that this is only
+     * applicable to
+     * [Type.PRIMARY][google.cloud.retail.v2beta.Product.Type.PRIMARY] and
+     * [Type.COLLECTION][google.cloud.retail.v2beta.Product.Type.COLLECTION],
+     * and ignored for
+     * [Type.VARIANT][google.cloud.retail.v2beta.Product.Type.VARIANT]. In
+     * general, we suggest the users to delete the stale products explicitly,
+     * instead of using this field to determine staleness.
      * If it is set, it must be a non-negative value, and
      * [expire_time][google.cloud.retail.v2beta.Product.expire_time] is set as
      * current timestamp plus [ttl][google.cloud.retail.v2beta.Product.ttl]. The
@@ -5631,7 +5796,14 @@ public Builder mergeTtl(com.google.protobuf.Duration value) {
      *
      *
      * 
      -     * Input only. The TTL (time to live) of the product.
+     * Input only. The TTL (time to live) of the product. Note that this is only
+     * applicable to
+     * [Type.PRIMARY][google.cloud.retail.v2beta.Product.Type.PRIMARY] and
+     * [Type.COLLECTION][google.cloud.retail.v2beta.Product.Type.COLLECTION],
+     * and ignored for
+     * [Type.VARIANT][google.cloud.retail.v2beta.Product.Type.VARIANT]. In
+     * general, we suggest the users to delete the stale products explicitly,
+     * instead of using this field to determine staleness.
      * If it is set, it must be a non-negative value, and
      * [expire_time][google.cloud.retail.v2beta.Product.expire_time] is set as
      * current timestamp plus [ttl][google.cloud.retail.v2beta.Product.ttl]. The
@@ -5671,7 +5843,14 @@ public Builder clearTtl() {
      *
      *
      * 
      -     * Input only. The TTL (time to live) of the product.
+     * Input only. The TTL (time to live) of the product. Note that this is only
+     * applicable to
+     * [Type.PRIMARY][google.cloud.retail.v2beta.Product.Type.PRIMARY] and
+     * [Type.COLLECTION][google.cloud.retail.v2beta.Product.Type.COLLECTION],
+     * and ignored for
+     * [Type.VARIANT][google.cloud.retail.v2beta.Product.Type.VARIANT]. In
+     * general, we suggest the users to delete the stale products explicitly,
+     * instead of using this field to determine staleness.
      * If it is set, it must be a non-negative value, and
      * [expire_time][google.cloud.retail.v2beta.Product.expire_time] is set as
      * current timestamp plus [ttl][google.cloud.retail.v2beta.Product.ttl]. The
@@ -5698,7 +5877,14 @@ public com.google.protobuf.Duration.Builder getTtlBuilder() {
      *
      *
      * 
      -     * Input only. The TTL (time to live) of the product.
+     * Input only. The TTL (time to live) of the product. Note that this is only
+     * applicable to
+     * [Type.PRIMARY][google.cloud.retail.v2beta.Product.Type.PRIMARY] and
+     * [Type.COLLECTION][google.cloud.retail.v2beta.Product.Type.COLLECTION],
+     * and ignored for
+     * [Type.VARIANT][google.cloud.retail.v2beta.Product.Type.VARIANT]. In
+     * general, we suggest the users to delete the stale products explicitly,
+     * instead of using this field to determine staleness.
      * If it is set, it must be a non-negative value, and
      * [expire_time][google.cloud.retail.v2beta.Product.expire_time] is set as
      * current timestamp plus [ttl][google.cloud.retail.v2beta.Product.ttl]. The
@@ -5733,7 +5919,14 @@ public com.google.protobuf.DurationOrBuilder getTtlOrBuilder() {
      *
      *
      * 
      -     * Input only. The TTL (time to live) of the product.
+     * Input only. The TTL (time to live) of the product. Note that this is only
+     * applicable to
+     * [Type.PRIMARY][google.cloud.retail.v2beta.Product.Type.PRIMARY] and
+     * [Type.COLLECTION][google.cloud.retail.v2beta.Product.Type.COLLECTION],
+     * and ignored for
+     * [Type.VARIANT][google.cloud.retail.v2beta.Product.Type.VARIANT]. In
+     * general, we suggest the users to delete the stale products explicitly,
+     * instead of using this field to determine staleness.
      * If it is set, it must be a non-negative value, and
      * [expire_time][google.cloud.retail.v2beta.Product.expire_time] is set as
      * current timestamp plus [ttl][google.cloud.retail.v2beta.Product.ttl]. The
@@ -8766,6 +8959,11 @@ public com.google.cloud.retail.v2beta.RatingOrBuilder getRatingOrBuilder() {
      * The timestamp when this [Product][google.cloud.retail.v2beta.Product]
      * becomes available for
      * [SearchService.Search][google.cloud.retail.v2beta.SearchService.Search].
+     * Note that this is only applicable to
+     * [Type.PRIMARY][google.cloud.retail.v2beta.Product.Type.PRIMARY] and
+     * [Type.COLLECTION][google.cloud.retail.v2beta.Product.Type.COLLECTION], and
+     * ignored for
+     * [Type.VARIANT][google.cloud.retail.v2beta.Product.Type.VARIANT].
      * 
      
      *
      * .google.protobuf.Timestamp available_time = 18;
@@ -8782,6 +8980,11 @@ public boolean hasAvailableTime() {
      * The timestamp when this [Product][google.cloud.retail.v2beta.Product]
      * becomes available for
      * [SearchService.Search][google.cloud.retail.v2beta.SearchService.Search].
+     * Note that this is only applicable to
+     * [Type.PRIMARY][google.cloud.retail.v2beta.Product.Type.PRIMARY] and
+     * [Type.COLLECTION][google.cloud.retail.v2beta.Product.Type.COLLECTION], and
+     * ignored for
+     * [Type.VARIANT][google.cloud.retail.v2beta.Product.Type.VARIANT].
      * 
      
      *
      * .google.protobuf.Timestamp available_time = 18;
@@ -8804,6 +9007,11 @@ public com.google.protobuf.Timestamp getAvailableTime() {
      * The timestamp when this [Product][google.cloud.retail.v2beta.Product]
      * becomes available for
      * [SearchService.Search][google.cloud.retail.v2beta.SearchService.Search].
+     * Note that this is only applicable to
+     * [Type.PRIMARY][google.cloud.retail.v2beta.Product.Type.PRIMARY] and
+     * [Type.COLLECTION][google.cloud.retail.v2beta.Product.Type.COLLECTION], and
+     * ignored for
+     * [Type.VARIANT][google.cloud.retail.v2beta.Product.Type.VARIANT].
      * 
      
      *
      * .google.protobuf.Timestamp available_time = 18;
@@ -8828,6 +9036,11 @@ public Builder setAvailableTime(com.google.protobuf.Timestamp value) {
      * The timestamp when this [Product][google.cloud.retail.v2beta.Product]
      * becomes available for
      * [SearchService.Search][google.cloud.retail.v2beta.SearchService.Search].
+     * Note that this is only applicable to
+     * [Type.PRIMARY][google.cloud.retail.v2beta.Product.Type.PRIMARY] and
+     * [Type.COLLECTION][google.cloud.retail.v2beta.Product.Type.COLLECTION], and
+     * ignored for
+     * [Type.VARIANT][google.cloud.retail.v2beta.Product.Type.VARIANT].
      * 
      
      *
      * .google.protobuf.Timestamp available_time = 18;
@@ -8849,6 +9062,11 @@ public Builder setAvailableTime(com.google.protobuf.Timestamp.Builder builderFor
      * The timestamp when this [Product][google.cloud.retail.v2beta.Product]
      * becomes available for
      * [SearchService.Search][google.cloud.retail.v2beta.SearchService.Search].
+     * Note that this is only applicable to
+     * [Type.PRIMARY][google.cloud.retail.v2beta.Product.Type.PRIMARY] and
+     * [Type.COLLECTION][google.cloud.retail.v2beta.Product.Type.COLLECTION], and
+     * ignored for
+     * [Type.VARIANT][google.cloud.retail.v2beta.Product.Type.VARIANT].
      * 
      
      *
      * .google.protobuf.Timestamp available_time = 18;
@@ -8877,6 +9095,11 @@ public Builder mergeAvailableTime(com.google.protobuf.Timestamp value) {
      * The timestamp when this [Product][google.cloud.retail.v2beta.Product]
      * becomes available for
      * [SearchService.Search][google.cloud.retail.v2beta.SearchService.Search].
+     * Note that this is only applicable to
+     * [Type.PRIMARY][google.cloud.retail.v2beta.Product.Type.PRIMARY] and
+     * [Type.COLLECTION][google.cloud.retail.v2beta.Product.Type.COLLECTION], and
+     * ignored for
+     * [Type.VARIANT][google.cloud.retail.v2beta.Product.Type.VARIANT].
      * 
      
      *
      * .google.protobuf.Timestamp available_time = 18;
@@ -8899,6 +9122,11 @@ public Builder clearAvailableTime() {
      * The timestamp when this [Product][google.cloud.retail.v2beta.Product]
      * becomes available for
      * [SearchService.Search][google.cloud.retail.v2beta.SearchService.Search].
+     * Note that this is only applicable to
+     * [Type.PRIMARY][google.cloud.retail.v2beta.Product.Type.PRIMARY] and
+     * [Type.COLLECTION][google.cloud.retail.v2beta.Product.Type.COLLECTION], and
+     * ignored for
+     * [Type.VARIANT][google.cloud.retail.v2beta.Product.Type.VARIANT].
      * 
      
      *
      * .google.protobuf.Timestamp available_time = 18;
@@ -8915,6 +9143,11 @@ public com.google.protobuf.Timestamp.Builder getAvailableTimeBuilder() {
      * The timestamp when this [Product][google.cloud.retail.v2beta.Product]
      * becomes available for
      * [SearchService.Search][google.cloud.retail.v2beta.SearchService.Search].
+     * Note that this is only applicable to
+     * [Type.PRIMARY][google.cloud.retail.v2beta.Product.Type.PRIMARY] and
+     * [Type.COLLECTION][google.cloud.retail.v2beta.Product.Type.COLLECTION], and
+     * ignored for
+     * [Type.VARIANT][google.cloud.retail.v2beta.Product.Type.VARIANT].
      * 
      
      *
      * .google.protobuf.Timestamp available_time = 18;
@@ -8935,6 +9168,11 @@ public com.google.protobuf.TimestampOrBuilder getAvailableTimeOrBuilder() {
      * The timestamp when this [Product][google.cloud.retail.v2beta.Product]
      * becomes available for
      * [SearchService.Search][google.cloud.retail.v2beta.SearchService.Search].
+     * Note that this is only applicable to
+     * [Type.PRIMARY][google.cloud.retail.v2beta.Product.Type.PRIMARY] and
+     * [Type.COLLECTION][google.cloud.retail.v2beta.Product.Type.COLLECTION], and
+     * ignored for
+     * [Type.VARIANT][google.cloud.retail.v2beta.Product.Type.VARIANT].
      * 
      
      *
      * .google.protobuf.Timestamp available_time = 18;
@@ -12371,12 +12609,16 @@ public com.google.protobuf.TimestampOrBuilder getPublishTimeOrBuilder() {
      * Note: Returning more fields in
      * [SearchResponse][google.cloud.retail.v2beta.SearchResponse] can increase
      * response payload size and serving latency.
+     * This field is deprecated. Use the retrievable site-wide control instead.
      * 
      
      *
-     * .google.protobuf.FieldMask retrievable_fields = 30;
+     * .google.protobuf.FieldMask retrievable_fields = 30 [deprecated = true];
      *
+     * @deprecated google.cloud.retail.v2beta.Product.retrievable_fields is deprecated. See
+     *     google/cloud/retail/v2beta/product.proto;l=573
      * @return Whether the retrievableFields field is set.
      */
+    @java.lang.Deprecated
     public boolean hasRetrievableFields() {
       return retrievableFieldsBuilder_ != null || retrievableFields_ != null;
     }
@@ -12430,12 +12672,16 @@ public boolean hasRetrievableFields() {
      * Note: Returning more fields in
      * [SearchResponse][google.cloud.retail.v2beta.SearchResponse] can increase
      * response payload size and serving latency.
+     * This field is deprecated. Use the retrievable site-wide control instead.
      * 
      
      *
-     * .google.protobuf.FieldMask retrievable_fields = 30;
+     * .google.protobuf.FieldMask retrievable_fields = 30 [deprecated = true];
      *
+     * @deprecated google.cloud.retail.v2beta.Product.retrievable_fields is deprecated. See
+     *     google/cloud/retail/v2beta/product.proto;l=573
      * @return The retrievableFields.
      */
+    @java.lang.Deprecated
     public com.google.protobuf.FieldMask getRetrievableFields() {
       if (retrievableFieldsBuilder_ == null) {
         return retrievableFields_ == null
@@ -12495,10 +12741,12 @@ public com.google.protobuf.FieldMask getRetrievableFields() {
      * Note: Returning more fields in
      * [SearchResponse][google.cloud.retail.v2beta.SearchResponse] can increase
      * response payload size and serving latency.
+     * This field is deprecated. Use the retrievable site-wide control instead.
      * 
      
      *
-     * .google.protobuf.FieldMask retrievable_fields = 30;
+     * .google.protobuf.FieldMask retrievable_fields = 30 [deprecated = true];
      */
+    @java.lang.Deprecated
     public Builder setRetrievableFields(com.google.protobuf.FieldMask value) {
       if (retrievableFieldsBuilder_ == null) {
         if (value == null) {
@@ -12562,10 +12810,12 @@ public Builder setRetrievableFields(com.google.protobuf.FieldMask value) {
      * Note: Returning more fields in
      * [SearchResponse][google.cloud.retail.v2beta.SearchResponse] can increase
      * response payload size and serving latency.
+     * This field is deprecated. Use the retrievable site-wide control instead.
      * 
      
      *
-     * .google.protobuf.FieldMask retrievable_fields = 30;
+     * .google.protobuf.FieldMask retrievable_fields = 30 [deprecated = true];
      */
+    @java.lang.Deprecated
     public Builder setRetrievableFields(com.google.protobuf.FieldMask.Builder builderForValue) {
       if (retrievableFieldsBuilder_ == null) {
         retrievableFields_ = builderForValue.build();
@@ -12626,10 +12876,12 @@ public Builder setRetrievableFields(com.google.protobuf.FieldMask.Builder builde
      * Note: Returning more fields in
      * [SearchResponse][google.cloud.retail.v2beta.SearchResponse] can increase
      * response payload size and serving latency.
+     * This field is deprecated. Use the retrievable site-wide control instead.
      * 
      
      *
-     * .google.protobuf.FieldMask retrievable_fields = 30;
+     * .google.protobuf.FieldMask retrievable_fields = 30 [deprecated = true];
      */
+    @java.lang.Deprecated
     public Builder mergeRetrievableFields(com.google.protobuf.FieldMask value) {
       if (retrievableFieldsBuilder_ == null) {
         if (retrievableFields_ != null) {
@@ -12697,10 +12949,12 @@ public Builder mergeRetrievableFields(com.google.protobuf.FieldMask value) {
      * Note: Returning more fields in
      * [SearchResponse][google.cloud.retail.v2beta.SearchResponse] can increase
      * response payload size and serving latency.
+     * This field is deprecated. Use the retrievable site-wide control instead.
      * 
      
      *
-     * .google.protobuf.FieldMask retrievable_fields = 30;
+     * .google.protobuf.FieldMask retrievable_fields = 30 [deprecated = true];
      */
+    @java.lang.Deprecated
     public Builder clearRetrievableFields() {
       if (retrievableFieldsBuilder_ == null) {
         retrievableFields_ = null;
@@ -12762,10 +13016,12 @@ public Builder clearRetrievableFields() {
      * Note: Returning more fields in
      * [SearchResponse][google.cloud.retail.v2beta.SearchResponse] can increase
      * response payload size and serving latency.
+     * This field is deprecated. Use the retrievable site-wide control instead.
      * 
      
      *
-     * .google.protobuf.FieldMask retrievable_fields = 30;
+     * .google.protobuf.FieldMask retrievable_fields = 30 [deprecated = true];
      */
+    @java.lang.Deprecated
     public com.google.protobuf.FieldMask.Builder getRetrievableFieldsBuilder() {
 
       onChanged();
@@ -12821,10 +13077,12 @@ public com.google.protobuf.FieldMask.Builder getRetrievableFieldsBuilder() {
      * Note: Returning more fields in
      * [SearchResponse][google.cloud.retail.v2beta.SearchResponse] can increase
      * response payload size and serving latency.
+     * This field is deprecated. Use the retrievable site-wide control instead.
      * 
      
      *
-     * .google.protobuf.FieldMask retrievable_fields = 30;
+     * .google.protobuf.FieldMask retrievable_fields = 30 [deprecated = true];
      */
+    @java.lang.Deprecated
     public com.google.protobuf.FieldMaskOrBuilder getRetrievableFieldsOrBuilder() {
       if (retrievableFieldsBuilder_ != null) {
         return retrievableFieldsBuilder_.getMessageOrBuilder();
@@ -12884,9 +13142,10 @@ public com.google.protobuf.FieldMaskOrBuilder getRetrievableFieldsOrBuilder() {
      * Note: Returning more fields in
      * [SearchResponse][google.cloud.retail.v2beta.SearchResponse] can increase
      * response payload size and serving latency.
+     * This field is deprecated. Use the retrievable site-wide control instead.
      * 
      
      *
-     * .google.protobuf.FieldMask retrievable_fields = 30;
+     * .google.protobuf.FieldMask retrievable_fields = 30 [deprecated = true];
      */
     private com.google.protobuf.SingleFieldBuilderV3<
             com.google.protobuf.FieldMask,
diff --git a/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/ProductOrBuilder.java b/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/ProductOrBuilder.java
index 7eb5c6fa175c..d9635c0cb6ac 100644
--- a/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/ProductOrBuilder.java
+++ b/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/ProductOrBuilder.java
@@ -29,6 +29,13 @@ public interface ProductOrBuilder
    * 
          * The timestamp when this product becomes unavailable for
    * [SearchService.Search][google.cloud.retail.v2beta.SearchService.Search].
+   * Note that this is only applicable to
+   * [Type.PRIMARY][google.cloud.retail.v2beta.Product.Type.PRIMARY] and
+   * [Type.COLLECTION][google.cloud.retail.v2beta.Product.Type.COLLECTION],
+   * and ignored for
+   * [Type.VARIANT][google.cloud.retail.v2beta.Product.Type.VARIANT]. In
+   * general, we suggest the users to delete the stale products explicitly,
+   * instead of using this field to determine staleness.
    * If it is set, the [Product][google.cloud.retail.v2beta.Product] is not
    * available for
    * [SearchService.Search][google.cloud.retail.v2beta.SearchService.Search]
@@ -57,6 +64,13 @@ public interface ProductOrBuilder
    * 
          * The timestamp when this product becomes unavailable for
    * [SearchService.Search][google.cloud.retail.v2beta.SearchService.Search].
+   * Note that this is only applicable to
+   * [Type.PRIMARY][google.cloud.retail.v2beta.Product.Type.PRIMARY] and
+   * [Type.COLLECTION][google.cloud.retail.v2beta.Product.Type.COLLECTION],
+   * and ignored for
+   * [Type.VARIANT][google.cloud.retail.v2beta.Product.Type.VARIANT]. In
+   * general, we suggest the users to delete the stale products explicitly,
+   * instead of using this field to determine staleness.
    * If it is set, the [Product][google.cloud.retail.v2beta.Product] is not
    * available for
    * [SearchService.Search][google.cloud.retail.v2beta.SearchService.Search]
@@ -85,6 +99,13 @@ public interface ProductOrBuilder
    * 
          * The timestamp when this product becomes unavailable for
    * [SearchService.Search][google.cloud.retail.v2beta.SearchService.Search].
+   * Note that this is only applicable to
+   * [Type.PRIMARY][google.cloud.retail.v2beta.Product.Type.PRIMARY] and
+   * [Type.COLLECTION][google.cloud.retail.v2beta.Product.Type.COLLECTION],
+   * and ignored for
+   * [Type.VARIANT][google.cloud.retail.v2beta.Product.Type.VARIANT]. In
+   * general, we suggest the users to delete the stale products explicitly,
+   * instead of using this field to determine staleness.
    * If it is set, the [Product][google.cloud.retail.v2beta.Product] is not
    * available for
    * [SearchService.Search][google.cloud.retail.v2beta.SearchService.Search]
@@ -110,7 +131,14 @@ public interface ProductOrBuilder
    *
    *
    * 
      -   * Input only. The TTL (time to live) of the product.
+   * Input only. The TTL (time to live) of the product. Note that this is only
+   * applicable to
+   * [Type.PRIMARY][google.cloud.retail.v2beta.Product.Type.PRIMARY] and
+   * [Type.COLLECTION][google.cloud.retail.v2beta.Product.Type.COLLECTION],
+   * and ignored for
+   * [Type.VARIANT][google.cloud.retail.v2beta.Product.Type.VARIANT]. In
+   * general, we suggest the users to delete the stale products explicitly,
+   * instead of using this field to determine staleness.
    * If it is set, it must be a non-negative value, and
    * [expire_time][google.cloud.retail.v2beta.Product.expire_time] is set as
    * current timestamp plus [ttl][google.cloud.retail.v2beta.Product.ttl]. The
@@ -137,7 +165,14 @@ public interface ProductOrBuilder
    *
    *
    * 
      -   * Input only. The TTL (time to live) of the product.
+   * Input only. The TTL (time to live) of the product. Note that this is only
+   * applicable to
+   * [Type.PRIMARY][google.cloud.retail.v2beta.Product.Type.PRIMARY] and
+   * [Type.COLLECTION][google.cloud.retail.v2beta.Product.Type.COLLECTION],
+   * and ignored for
+   * [Type.VARIANT][google.cloud.retail.v2beta.Product.Type.VARIANT]. In
+   * general, we suggest the users to delete the stale products explicitly,
+   * instead of using this field to determine staleness.
    * If it is set, it must be a non-negative value, and
    * [expire_time][google.cloud.retail.v2beta.Product.expire_time] is set as
    * current timestamp plus [ttl][google.cloud.retail.v2beta.Product.ttl]. The
@@ -164,7 +199,14 @@ public interface ProductOrBuilder
    *
    *
    * 
      -   * Input only. The TTL (time to live) of the product.
+   * Input only. The TTL (time to live) of the product. Note that this is only
+   * applicable to
+   * [Type.PRIMARY][google.cloud.retail.v2beta.Product.Type.PRIMARY] and
+   * [Type.COLLECTION][google.cloud.retail.v2beta.Product.Type.COLLECTION],
+   * and ignored for
+   * [Type.VARIANT][google.cloud.retail.v2beta.Product.Type.VARIANT]. In
+   * general, we suggest the users to delete the stale products explicitly,
+   * instead of using this field to determine staleness.
    * If it is set, it must be a non-negative value, and
    * [expire_time][google.cloud.retail.v2beta.Product.expire_time] is set as
    * current timestamp plus [ttl][google.cloud.retail.v2beta.Product.ttl]. The
@@ -1168,6 +1210,11 @@ com.google.cloud.retail.v2beta.CustomAttribute getAttributesOrDefault(
    * The timestamp when this [Product][google.cloud.retail.v2beta.Product]
    * becomes available for
    * [SearchService.Search][google.cloud.retail.v2beta.SearchService.Search].
+   * Note that this is only applicable to
+   * [Type.PRIMARY][google.cloud.retail.v2beta.Product.Type.PRIMARY] and
+   * [Type.COLLECTION][google.cloud.retail.v2beta.Product.Type.COLLECTION], and
+   * ignored for
+   * [Type.VARIANT][google.cloud.retail.v2beta.Product.Type.VARIANT].
    * 
      
    *
    * .google.protobuf.Timestamp available_time = 18;
@@ -1182,6 +1229,11 @@ com.google.cloud.retail.v2beta.CustomAttribute getAttributesOrDefault(
    * The timestamp when this [Product][google.cloud.retail.v2beta.Product]
    * becomes available for
    * [SearchService.Search][google.cloud.retail.v2beta.SearchService.Search].
+   * Note that this is only applicable to
+   * [Type.PRIMARY][google.cloud.retail.v2beta.Product.Type.PRIMARY] and
+   * [Type.COLLECTION][google.cloud.retail.v2beta.Product.Type.COLLECTION], and
+   * ignored for
+   * [Type.VARIANT][google.cloud.retail.v2beta.Product.Type.VARIANT].
    * 
      
    *
    * .google.protobuf.Timestamp available_time = 18;
@@ -1196,6 +1248,11 @@ com.google.cloud.retail.v2beta.CustomAttribute getAttributesOrDefault(
    * The timestamp when this [Product][google.cloud.retail.v2beta.Product]
    * becomes available for
    * [SearchService.Search][google.cloud.retail.v2beta.SearchService.Search].
+   * Note that this is only applicable to
+   * [Type.PRIMARY][google.cloud.retail.v2beta.Product.Type.PRIMARY] and
+   * [Type.COLLECTION][google.cloud.retail.v2beta.Product.Type.COLLECTION], and
+   * ignored for
+   * [Type.VARIANT][google.cloud.retail.v2beta.Product.Type.VARIANT].
    * 
      
    *
    * .google.protobuf.Timestamp available_time = 18;
@@ -2060,12 +2117,16 @@ com.google.cloud.retail.v2beta.CustomAttribute getAttributesOrDefault(
    * Note: Returning more fields in
    * [SearchResponse][google.cloud.retail.v2beta.SearchResponse] can increase
    * response payload size and serving latency.
+   * This field is deprecated. Use the retrievable site-wide control instead.
    * 
      
    *
-   * .google.protobuf.FieldMask retrievable_fields = 30;
+   * .google.protobuf.FieldMask retrievable_fields = 30 [deprecated = true];
    *
+   * @deprecated google.cloud.retail.v2beta.Product.retrievable_fields is deprecated. See
+   *     google/cloud/retail/v2beta/product.proto;l=573
    * @return Whether the retrievableFields field is set.
    */
+  @java.lang.Deprecated
   boolean hasRetrievableFields();
   /**
    *
@@ -2117,12 +2178,16 @@ com.google.cloud.retail.v2beta.CustomAttribute getAttributesOrDefault(
    * Note: Returning more fields in
    * [SearchResponse][google.cloud.retail.v2beta.SearchResponse] can increase
    * response payload size and serving latency.
+   * This field is deprecated. Use the retrievable site-wide control instead.
    * 
      
    *
-   * .google.protobuf.FieldMask retrievable_fields = 30;
+   * .google.protobuf.FieldMask retrievable_fields = 30 [deprecated = true];
    *
+   * @deprecated google.cloud.retail.v2beta.Product.retrievable_fields is deprecated. See
+   *     google/cloud/retail/v2beta/product.proto;l=573
    * @return The retrievableFields.
    */
+  @java.lang.Deprecated
   com.google.protobuf.FieldMask getRetrievableFields();
   /**
    *
@@ -2174,10 +2239,12 @@ com.google.cloud.retail.v2beta.CustomAttribute getAttributesOrDefault(
    * Note: Returning more fields in
    * [SearchResponse][google.cloud.retail.v2beta.SearchResponse] can increase
    * response payload size and serving latency.
+   * This field is deprecated. Use the retrievable site-wide control instead.
    * 
      
    *
-   * .google.protobuf.FieldMask retrievable_fields = 30;
+   * .google.protobuf.FieldMask retrievable_fields = 30 [deprecated = true];
    */
+  @java.lang.Deprecated
   com.google.protobuf.FieldMaskOrBuilder getRetrievableFieldsOrBuilder();
 
   /**
diff --git a/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/ProductProto.java b/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/ProductProto.java
index 88878cdd39d3..22bb00c8e19a 100644
--- a/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/ProductProto.java
+++ b/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/ProductProto.java
@@ -52,7 +52,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
           + "promotion.proto\032\036google/protobuf/duratio"
           + "n.proto\032 google/protobuf/field_mask.prot"
           + "o\032\037google/protobuf/timestamp.proto\032\036goog"
-          + "le/protobuf/wrappers.proto\"\213\016\n\007Product\0221"
+          + "le/protobuf/wrappers.proto\"\217\016\n\007Product\0221"
           + "\n\013expire_time\030\020 \001(\0132\032.google.protobuf.Ti"
           + "mestampH\000\022-\n\003ttl\030\021 \001(\0132\031.google.protobuf"
           + ".DurationB\003\340A\004H\000\022\021\n\004name\030\001 \001(\tB\003\340A\005\022\017\n\002i"
@@ -82,31 +82,31 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
           + "s\030\034 \003(\t\022\022\n\nconditions\030\035 \003(\t\0229\n\npromotion"
           + "s\030\" \003(\0132%.google.cloud.retail.v2beta.Pro"
           + "motion\0220\n\014publish_time\030! \001(\0132\032.google.pr"
-          + "otobuf.Timestamp\0226\n\022retrievable_fields\030\036"
-          + " \001(\0132\032.google.protobuf.FieldMask\022:\n\010vari"
-          + "ants\030\037 \003(\0132#.google.cloud.retail.v2beta."
-          + "ProductB\003\340A\003\022J\n\021local_inventories\030# \003(\0132"
-          + "*.google.cloud.retail.v2beta.LocalInvent"
-          + "oryB\003\340A\003\032^\n\017AttributesEntry\022\013\n\003key\030\001 \001(\t"
-          + "\022:\n\005value\030\002 \001(\0132+.google.cloud.retail.v2"
-          + "beta.CustomAttribute:\0028\001\"F\n\004Type\022\024\n\020TYPE"
-          + "_UNSPECIFIED\020\000\022\013\n\007PRIMARY\020\001\022\013\n\007VARIANT\020\002"
-          + "\022\016\n\nCOLLECTION\020\003\"i\n\014Availability\022\034\n\030AVAI"
-          + "LABILITY_UNSPECIFIED\020\000\022\014\n\010IN_STOCK\020\001\022\020\n\014"
-          + "OUT_OF_STOCK\020\002\022\014\n\010PREORDER\020\003\022\r\n\tBACKORDE"
-          + "R\020\004:\204\001\352A\200\001\n\035retail.googleapis.com/Produc"
-          + "t\022_projects/{project}/locations/{locatio"
-          + "n}/catalogs/{catalog}/branches/{branch}/"
-          + "products/{product}B\014\n\nexpirationB\304\002\n\036com"
-          + ".google.cloud.retail.v2betaB\014ProductProt"
-          + "oP\001Z@google.golang.org/genproto/googleap"
-          + "is/cloud/retail/v2beta;retail\242\002\006RETAIL\252\002"
-          + "\032Google.Cloud.Retail.V2Beta\312\002\032Google\\Clo"
-          + "ud\\Retail\\V2beta\352\002\035Google::Cloud::Retail"
-          + "::V2beta\352Al\n\034retail.googleapis.com/Branc"
-          + "h\022Lprojects/{project}/locations/{locatio"
-          + "n}/catalogs/{catalog}/branches/{branch}b"
-          + "\006proto3"
+          + "otobuf.Timestamp\022:\n\022retrievable_fields\030\036"
+          + " \001(\0132\032.google.protobuf.FieldMaskB\002\030\001\022:\n\010"
+          + "variants\030\037 \003(\0132#.google.cloud.retail.v2b"
+          + "eta.ProductB\003\340A\003\022J\n\021local_inventories\030# "
+          + "\003(\0132*.google.cloud.retail.v2beta.LocalIn"
+          + "ventoryB\003\340A\003\032^\n\017AttributesEntry\022\013\n\003key\030\001"
+          + " \001(\t\022:\n\005value\030\002 \001(\0132+.google.cloud.retai"
+          + "l.v2beta.CustomAttribute:\0028\001\"F\n\004Type\022\024\n\020"
+          + "TYPE_UNSPECIFIED\020\000\022\013\n\007PRIMARY\020\001\022\013\n\007VARIA"
+          + "NT\020\002\022\016\n\nCOLLECTION\020\003\"i\n\014Availability\022\034\n\030"
+          + "AVAILABILITY_UNSPECIFIED\020\000\022\014\n\010IN_STOCK\020\001"
+          + "\022\020\n\014OUT_OF_STOCK\020\002\022\014\n\010PREORDER\020\003\022\r\n\tBACK"
+          + "ORDER\020\004:\204\001\352A\200\001\n\035retail.googleapis.com/Pr"
+          + "oduct\022_projects/{project}/locations/{loc"
+          + "ation}/catalogs/{catalog}/branches/{bran"
+          + "ch}/products/{product}B\014\n\nexpirationB\304\002\n"
+          + "\036com.google.cloud.retail.v2betaB\014Product"
+          + "ProtoP\001Z@google.golang.org/genproto/goog"
+          + "leapis/cloud/retail/v2beta;retail\242\002\006RETA"
+          + "IL\252\002\032Google.Cloud.Retail.V2Beta\312\002\032Google"
+          + "\\Cloud\\Retail\\V2beta\352\002\035Google::Cloud::Re"
+          + "tail::V2beta\352Al\n\034retail.googleapis.com/B"
+          + "ranch\022Lprojects/{project}/locations/{loc"
+          + "ation}/catalogs/{catalog}/branches/{bran"
+          + "ch}b\006proto3"
     };
     descriptor =
         com.google.protobuf.Descriptors.FileDescriptor.internalBuildGeneratedFileFrom(
diff --git a/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/Rule.java b/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/Rule.java
index 69e561cc8467..59f49ac3a338 100644
--- a/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/Rule.java
+++ b/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/Rule.java
@@ -2457,7 +2457,7 @@ public interface TwowaySynonymsActionOrBuilder
    *
    * 
          * Creates a set of terms that will be treated as synonyms of each other.
-   * Example: synonyms of "sneakers" and "shoes".
+   * Example: synonyms of "sneakers" and "shoes":
    *  * "sneakers" will use a synonym of "shoes".
    *  * "shoes" will use a synonym of "sneakers".
    * 
      
@@ -2746,7 +2746,7 @@ protected Builder newBuilderForType(
      *
      * 
            * Creates a set of terms that will be treated as synonyms of each other.
-     * Example: synonyms of "sneakers" and "shoes".
+     * Example: synonyms of "sneakers" and "shoes":
      *  * "sneakers" will use a synonym of "shoes".
      *  * "shoes" will use a synonym of "sneakers".
      * 
      
diff --git a/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/SearchRequest.java b/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/SearchRequest.java
index 602e70606b38..c4aa6f768aac 100644
--- a/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/SearchRequest.java
+++ b/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/SearchRequest.java
@@ -349,7 +349,7 @@ public interface FacetSpecOrBuilder
      *
      * 
            * Maximum of facet values that should be returned for this facet. If
-     * unspecified, defaults to 20. The maximum allowed value is 300. Values
+     * unspecified, defaults to 50. The maximum allowed value is 300. Values
      * above 300 will be coerced to 300.
      * If this field is negative, an INVALID_ARGUMENT is returned.
      * 
      
@@ -4514,7 +4514,7 @@ public com.google.cloud.retail.v2beta.SearchRequest.FacetSpec.FacetKey getFacetK
      *
      * 
            * Maximum of facet values that should be returned for this facet. If
-     * unspecified, defaults to 20. The maximum allowed value is 300. Values
+     * unspecified, defaults to 50. The maximum allowed value is 300. Values
      * above 300 will be coerced to 300.
      * If this field is negative, an INVALID_ARGUMENT is returned.
      * 
      
@@ -5360,7 +5360,7 @@ public Builder clearFacetKey() {
        *
        * 
              * Maximum of facet values that should be returned for this facet. If
-       * unspecified, defaults to 20. The maximum allowed value is 300. Values
+       * unspecified, defaults to 50. The maximum allowed value is 300. Values
        * above 300 will be coerced to 300.
        * If this field is negative, an INVALID_ARGUMENT is returned.
        * 
      
@@ -5378,7 +5378,7 @@ public int getLimit() {
        *
        * 
              * Maximum of facet values that should be returned for this facet. If
-       * unspecified, defaults to 20. The maximum allowed value is 300. Values
+       * unspecified, defaults to 50. The maximum allowed value is 300. Values
        * above 300 will be coerced to 300.
        * If this field is negative, an INVALID_ARGUMENT is returned.
        * 
      
@@ -5399,7 +5399,7 @@ public Builder setLimit(int value) {
        *
        * 
              * Maximum of facet values that should be returned for this facet. If
-       * unspecified, defaults to 20. The maximum allowed value is 300. Values
+       * unspecified, defaults to 50. The maximum allowed value is 300. Values
        * above 300 will be coerced to 300.
        * If this field is negative, an INVALID_ARGUMENT is returned.
        * 
      
@@ -11573,7 +11573,7 @@ public com.google.protobuf.Parser getParserForType() {
    * `projects/*/locations/global/catalogs/default_catalog/servingConfigs/default_serving_config`
    * or the name of the legacy placement resource, such as
    * `projects/*/locations/global/catalogs/default_catalog/placements/default_search`.
-   * This field is used to identify the serving configuration name and the set
+   * This field is used to identify the serving config name and the set
    * of models that will be used to make the search.
    * 
      
    *
@@ -11601,7 +11601,7 @@ public java.lang.String getPlacement() {
    * `projects/*/locations/global/catalogs/default_catalog/servingConfigs/default_serving_config`
    * or the name of the legacy placement resource, such as
    * `projects/*/locations/global/catalogs/default_catalog/placements/default_search`.
-   * This field is used to identify the serving configuration name and the set
+   * This field is used to identify the serving config name and the set
    * of models that will be used to make the search.
    * 
      
    *
@@ -14156,7 +14156,7 @@ public Builder mergeFrom(
      * `projects/*/locations/global/catalogs/default_catalog/servingConfigs/default_serving_config`
      * or the name of the legacy placement resource, such as
      * `projects/*/locations/global/catalogs/default_catalog/placements/default_search`.
-     * This field is used to identify the serving configuration name and the set
+     * This field is used to identify the serving config name and the set
      * of models that will be used to make the search.
      * 
      
      *
@@ -14183,7 +14183,7 @@ public java.lang.String getPlacement() {
      * `projects/*/locations/global/catalogs/default_catalog/servingConfigs/default_serving_config`
      * or the name of the legacy placement resource, such as
      * `projects/*/locations/global/catalogs/default_catalog/placements/default_search`.
-     * This field is used to identify the serving configuration name and the set
+     * This field is used to identify the serving config name and the set
      * of models that will be used to make the search.
      * 
      
      *
@@ -14210,7 +14210,7 @@ public com.google.protobuf.ByteString getPlacementBytes() {
      * `projects/*/locations/global/catalogs/default_catalog/servingConfigs/default_serving_config`
      * or the name of the legacy placement resource, such as
      * `projects/*/locations/global/catalogs/default_catalog/placements/default_search`.
-     * This field is used to identify the serving configuration name and the set
+     * This field is used to identify the serving config name and the set
      * of models that will be used to make the search.
      * 
      
      *
@@ -14236,7 +14236,7 @@ public Builder setPlacement(java.lang.String value) {
      * `projects/*/locations/global/catalogs/default_catalog/servingConfigs/default_serving_config`
      * or the name of the legacy placement resource, such as
      * `projects/*/locations/global/catalogs/default_catalog/placements/default_search`.
-     * This field is used to identify the serving configuration name and the set
+     * This field is used to identify the serving config name and the set
      * of models that will be used to make the search.
      * 
      
      *
@@ -14258,7 +14258,7 @@ public Builder clearPlacement() {
      * `projects/*/locations/global/catalogs/default_catalog/servingConfigs/default_serving_config`
      * or the name of the legacy placement resource, such as
      * `projects/*/locations/global/catalogs/default_catalog/placements/default_search`.
-     * This field is used to identify the serving configuration name and the set
+     * This field is used to identify the serving config name and the set
      * of models that will be used to make the search.
      * 
      
      *
diff --git a/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/SearchRequestOrBuilder.java b/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/SearchRequestOrBuilder.java
index 4cf93287a4ed..4281bd8eed9e 100644
--- a/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/SearchRequestOrBuilder.java
+++ b/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/SearchRequestOrBuilder.java
@@ -31,7 +31,7 @@ public interface SearchRequestOrBuilder
    * `projects/*/locations/global/catalogs/default_catalog/servingConfigs/default_serving_config`
    * or the name of the legacy placement resource, such as
    * `projects/*/locations/global/catalogs/default_catalog/placements/default_search`.
-   * This field is used to identify the serving configuration name and the set
+   * This field is used to identify the serving config name and the set
    * of models that will be used to make the search.
    * 
      
    *
@@ -48,7 +48,7 @@ public interface SearchRequestOrBuilder
    * `projects/*/locations/global/catalogs/default_catalog/servingConfigs/default_serving_config`
    * or the name of the legacy placement resource, such as
    * `projects/*/locations/global/catalogs/default_catalog/placements/default_search`.
-   * This field is used to identify the serving configuration name and the set
+   * This field is used to identify the serving config name and the set
    * of models that will be used to make the search.
    * 
      
    *
diff --git a/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/UserEventServiceProto.java b/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/UserEventServiceProto.java
index b8802e9ae807..967da628048f 100644
--- a/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/UserEventServiceProto.java
+++ b/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/UserEventServiceProto.java
@@ -66,58 +66,60 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
           + "cloud/retail/v2beta/purge_config.proto\032+"
           + "google/cloud/retail/v2beta/user_event.pr"
           + "oto\032#google/longrunning/operations.proto"
-          + "\"l\n\025WriteUserEventRequest\022\023\n\006parent\030\001 \001("
-          + "\tB\003\340A\002\022>\n\nuser_event\030\002 \001(\0132%.google.clou"
-          + "d.retail.v2beta.UserEventB\003\340A\002\"a\n\027Collec"
-          + "tUserEventRequest\022\023\n\006parent\030\001 \001(\tB\003\340A\002\022\027"
-          + "\n\nuser_event\030\002 \001(\tB\003\340A\002\022\013\n\003uri\030\003 \001(\t\022\013\n\003"
-          + "ets\030\004 \001(\003\"\202\002\n\027RejoinUserEventsRequest\022\023\n"
-          + "\006parent\030\001 \001(\tB\003\340A\002\022i\n\027user_event_rejoin_"
-          + "scope\030\002 \001(\0162H.google.cloud.retail.v2beta"
-          + ".RejoinUserEventsRequest.UserEventRejoin"
-          + "Scope\"g\n\024UserEventRejoinScope\022\'\n#USER_EV"
-          + "ENT_REJOIN_SCOPE_UNSPECIFIED\020\000\022\021\n\rJOINED"
-          + "_EVENTS\020\001\022\023\n\017UNJOINED_EVENTS\020\002\">\n\030Rejoin"
-          + "UserEventsResponse\022\"\n\032rejoined_user_even"
-          + "ts_count\030\001 \001(\003\"\032\n\030RejoinUserEventsMetada"
-          + "ta2\373\t\n\020UserEventService\022\303\001\n\016WriteUserEve"
-          + "nt\0221.google.cloud.retail.v2beta.WriteUse"
-          + "rEventRequest\032%.google.cloud.retail.v2be"
-          + "ta.UserEvent\"W\202\323\344\223\002Q\"C/v2beta/{parent=pr"
-          + "ojects/*/locations/*/catalogs/*}/userEve"
-          + "nts:write:\nuser_event\022\254\001\n\020CollectUserEve"
-          + "nt\0223.google.cloud.retail.v2beta.CollectU"
-          + "serEventRequest\032\024.google.api.HttpBody\"M\202"
-          + "\323\344\223\002G\022E/v2beta/{parent=projects/*/locati"
-          + "ons/*/catalogs/*}/userEvents:collect\022\226\002\n"
-          + "\017PurgeUserEvents\0222.google.cloud.retail.v"
-          + "2beta.PurgeUserEventsRequest\032\035.google.lo"
-          + "ngrunning.Operation\"\257\001\202\323\344\223\002H\"C/v2beta/{p"
-          + "arent=projects/*/locations/*/catalogs/*}"
-          + "/userEvents:purge:\001*\312A^\n2google.cloud.re"
-          + "tail.v2beta.PurgeUserEventsResponse\022(goo"
-          + "gle.cloud.retail.v2beta.PurgeMetadata\022\233\002"
-          + "\n\020ImportUserEvents\0223.google.cloud.retail"
-          + ".v2beta.ImportUserEventsRequest\032\035.google"
-          + ".longrunning.Operation\"\262\001\202\323\344\223\002I\"D/v2beta"
-          + "/{parent=projects/*/locations/*/catalogs"
-          + "/*}/userEvents:import:\001*\312A`\n3google.clou"
-          + "d.retail.v2beta.ImportUserEventsResponse"
-          + "\022)google.cloud.retail.v2beta.ImportMetad"
-          + "ata\022\357\001\n\020RejoinUserEvents\0223.google.cloud."
-          + "retail.v2beta.RejoinUserEventsRequest\032\035."
-          + "google.longrunning.Operation\"\206\001\202\323\344\223\002I\"D/"
-          + "v2beta/{parent=projects/*/locations/*/ca"
-          + "talogs/*}/userEvents:rejoin:\001*\312A4\n\030Rejoi"
-          + "nUserEventsResponse\022\030RejoinUserEventsMet"
-          + "adata\032I\312A\025retail.googleapis.com\322A.https:"
-          + "//www.googleapis.com/auth/cloud-platform"
-          + "B\336\001\n\036com.google.cloud.retail.v2betaB\025Use"
-          + "rEventServiceProtoP\001Z@google.golang.org/"
-          + "genproto/googleapis/cloud/retail/v2beta;"
-          + "retail\242\002\006RETAIL\252\002\032Google.Cloud.Retail.V2"
-          + "Beta\312\002\032Google\\Cloud\\Retail\\V2beta\352\002\035Goog"
-          + "le::Cloud::Retail::V2betab\006proto3"
+          + "\"\201\001\n\025WriteUserEventRequest\022\023\n\006parent\030\001 \001"
+          + "(\tB\003\340A\002\022>\n\nuser_event\030\002 \001(\0132%.google.clo"
+          + "ud.retail.v2beta.UserEventB\003\340A\002\022\023\n\013write"
+          + "_async\030\003 \001(\010\"\237\001\n\027CollectUserEventRequest"
+          + "\022\027\n\rprebuilt_rule\030\006 \001(\tH\000\022\023\n\006parent\030\001 \001("
+          + "\tB\003\340A\002\022\027\n\nuser_event\030\002 \001(\tB\003\340A\002\022\013\n\003uri\030\003"
+          + " \001(\t\022\013\n\003ets\030\004 \001(\003\022\020\n\010raw_json\030\005 \001(\tB\021\n\017c"
+          + "onversion_rule\"\202\002\n\027RejoinUserEventsReque"
+          + "st\022\023\n\006parent\030\001 \001(\tB\003\340A\002\022i\n\027user_event_re"
+          + "join_scope\030\002 \001(\0162H.google.cloud.retail.v"
+          + "2beta.RejoinUserEventsRequest.UserEventR"
+          + "ejoinScope\"g\n\024UserEventRejoinScope\022\'\n#US"
+          + "ER_EVENT_REJOIN_SCOPE_UNSPECIFIED\020\000\022\021\n\rJ"
+          + "OINED_EVENTS\020\001\022\023\n\017UNJOINED_EVENTS\020\002\">\n\030R"
+          + "ejoinUserEventsResponse\022\"\n\032rejoined_user"
+          + "_events_count\030\001 \001(\003\"\032\n\030RejoinUserEventsM"
+          + "etadata2\373\t\n\020UserEventService\022\303\001\n\016WriteUs"
+          + "erEvent\0221.google.cloud.retail.v2beta.Wri"
+          + "teUserEventRequest\032%.google.cloud.retail"
+          + ".v2beta.UserEvent\"W\202\323\344\223\002Q\"C/v2beta/{pare"
+          + "nt=projects/*/locations/*/catalogs/*}/us"
+          + "erEvents:write:\nuser_event\022\254\001\n\020CollectUs"
+          + "erEvent\0223.google.cloud.retail.v2beta.Col"
+          + "lectUserEventRequest\032\024.google.api.HttpBo"
+          + "dy\"M\202\323\344\223\002G\022E/v2beta/{parent=projects/*/l"
+          + "ocations/*/catalogs/*}/userEvents:collec"
+          + "t\022\226\002\n\017PurgeUserEvents\0222.google.cloud.ret"
+          + "ail.v2beta.PurgeUserEventsRequest\032\035.goog"
+          + "le.longrunning.Operation\"\257\001\202\323\344\223\002H\"C/v2be"
+          + "ta/{parent=projects/*/locations/*/catalo"
+          + "gs/*}/userEvents:purge:\001*\312A^\n2google.clo"
+          + "ud.retail.v2beta.PurgeUserEventsResponse"
+          + "\022(google.cloud.retail.v2beta.PurgeMetada"
+          + "ta\022\233\002\n\020ImportUserEvents\0223.google.cloud.r"
+          + "etail.v2beta.ImportUserEventsRequest\032\035.g"
+          + "oogle.longrunning.Operation\"\262\001\202\323\344\223\002I\"D/v"
+          + "2beta/{parent=projects/*/locations/*/cat"
+          + "alogs/*}/userEvents:import:\001*\312A`\n3google"
+          + ".cloud.retail.v2beta.ImportUserEventsRes"
+          + "ponse\022)google.cloud.retail.v2beta.Import"
+          + "Metadata\022\357\001\n\020RejoinUserEvents\0223.google.c"
+          + "loud.retail.v2beta.RejoinUserEventsReque"
+          + "st\032\035.google.longrunning.Operation\"\206\001\202\323\344\223"
+          + "\002I\"D/v2beta/{parent=projects/*/locations"
+          + "/*/catalogs/*}/userEvents:rejoin:\001*\312A4\n\030"
+          + "RejoinUserEventsResponse\022\030RejoinUserEven"
+          + "tsMetadata\032I\312A\025retail.googleapis.com\322A.h"
+          + "ttps://www.googleapis.com/auth/cloud-pla"
+          + "tformB\336\001\n\036com.google.cloud.retail.v2beta"
+          + "B\025UserEventServiceProtoP\001Z@google.golang"
+          + ".org/genproto/googleapis/cloud/retail/v2"
+          + "beta;retail\242\002\006RETAIL\252\002\032Google.Cloud.Reta"
+          + "il.V2Beta\312\002\032Google\\Cloud\\Retail\\V2beta\352\002"
+          + "\035Google::Cloud::Retail::V2betab\006proto3"
     };
     descriptor =
         com.google.protobuf.Descriptors.FileDescriptor.internalBuildGeneratedFileFrom(
@@ -139,7 +141,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
         new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable(
             internal_static_google_cloud_retail_v2beta_WriteUserEventRequest_descriptor,
             new java.lang.String[] {
-              "Parent", "UserEvent",
+              "Parent", "UserEvent", "WriteAsync",
             });
     internal_static_google_cloud_retail_v2beta_CollectUserEventRequest_descriptor =
         getDescriptor().getMessageTypes().get(1);
@@ -147,7 +149,7 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
         new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable(
             internal_static_google_cloud_retail_v2beta_CollectUserEventRequest_descriptor,
             new java.lang.String[] {
-              "Parent", "UserEvent", "Uri", "Ets",
+              "PrebuiltRule", "Parent", "UserEvent", "Uri", "Ets", "RawJson", "ConversionRule",
             });
     internal_static_google_cloud_retail_v2beta_RejoinUserEventsRequest_descriptor =
         getDescriptor().getMessageTypes().get(2);
diff --git a/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/WriteUserEventRequest.java b/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/WriteUserEventRequest.java
index ae96e972cab2..a0fbb8474213 100644
--- a/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/WriteUserEventRequest.java
+++ b/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/WriteUserEventRequest.java
@@ -172,6 +172,27 @@ public com.google.cloud.retail.v2beta.UserEventOrBuilder getUserEventOrBuilder()
     return getUserEvent();
   }
 
+  public static final int WRITE_ASYNC_FIELD_NUMBER = 3;
+  private boolean writeAsync_;
+  /**
+   *
+   *
+   * 
      +   * If set to true, the user event will be written asynchronously after
+   * validation, and the API will respond without waiting for the write.
+   * Therefore, silent failures can occur even if the API returns success. In
+   * case of silent failures, error messages can be found in Stackdriver logs.
+   * 
      
+   *
+   * bool write_async = 3;
+   *
+   * @return The writeAsync.
+   */
+  @java.lang.Override
+  public boolean getWriteAsync() {
+    return writeAsync_;
+  }
+
   private byte memoizedIsInitialized = -1;
 
   @java.lang.Override
@@ -192,6 +213,9 @@ public void writeTo(com.google.protobuf.CodedOutputStream output) throws java.io
     if (userEvent_ != null) {
       output.writeMessage(2, getUserEvent());
     }
+    if (writeAsync_ != false) {
+      output.writeBool(3, writeAsync_);
+    }
     getUnknownFields().writeTo(output);
   }
 
@@ -207,6 +231,9 @@ public int getSerializedSize() {
     if (userEvent_ != null) {
       size += com.google.protobuf.CodedOutputStream.computeMessageSize(2, getUserEvent());
     }
+    if (writeAsync_ != false) {
+      size += com.google.protobuf.CodedOutputStream.computeBoolSize(3, writeAsync_);
+    }
     size += getUnknownFields().getSerializedSize();
     memoizedSize = size;
     return size;
@@ -228,6 +255,7 @@ public boolean equals(final java.lang.Object obj) {
     if (hasUserEvent()) {
       if (!getUserEvent().equals(other.getUserEvent())) return false;
     }
+    if (getWriteAsync() != other.getWriteAsync()) return false;
     if (!getUnknownFields().equals(other.getUnknownFields())) return false;
     return true;
   }
@@ -245,6 +273,8 @@ public int hashCode() {
       hash = (37 * hash) + USER_EVENT_FIELD_NUMBER;
       hash = (53 * hash) + getUserEvent().hashCode();
     }
+    hash = (37 * hash) + WRITE_ASYNC_FIELD_NUMBER;
+    hash = (53 * hash) + com.google.protobuf.Internal.hashBoolean(getWriteAsync());
     hash = (29 * hash) + getUnknownFields().hashCode();
     memoizedHashCode = hash;
     return hash;
@@ -391,6 +421,8 @@ public Builder clear() {
         userEvent_ = null;
         userEventBuilder_ = null;
       }
+      writeAsync_ = false;
+
       return this;
     }
 
@@ -424,6 +456,7 @@ public com.google.cloud.retail.v2beta.WriteUserEventRequest buildPartial() {
       } else {
         result.userEvent_ = userEventBuilder_.build();
       }
+      result.writeAsync_ = writeAsync_;
       onBuilt();
       return result;
     }
@@ -481,6 +514,9 @@ public Builder mergeFrom(com.google.cloud.retail.v2beta.WriteUserEventRequest ot
       if (other.hasUserEvent()) {
         mergeUserEvent(other.getUserEvent());
       }
+      if (other.getWriteAsync() != false) {
+        setWriteAsync(other.getWriteAsync());
+      }
       this.mergeUnknownFields(other.getUnknownFields());
       onChanged();
       return this;
@@ -519,6 +555,12 @@ public Builder mergeFrom(
 
                 break;
               } // case 18
+            case 24:
+              {
+                writeAsync_ = input.readBool();
+
+                break;
+              } // case 24
             default:
               {
                 if (!super.parseUnknownField(input, extensionRegistry, tag)) {
@@ -850,6 +892,67 @@ public com.google.cloud.retail.v2beta.UserEventOrBuilder getUserEventOrBuilder()
       return userEventBuilder_;
     }
 
+    private boolean writeAsync_;
+    /**
+     *
+     *
+     * 
      +     * If set to true, the user event will be written asynchronously after
+     * validation, and the API will respond without waiting for the write.
+     * Therefore, silent failures can occur even if the API returns success. In
+     * case of silent failures, error messages can be found in Stackdriver logs.
+     * 
      
+     *
+     * bool write_async = 3;
+     *
+     * @return The writeAsync.
+     */
+    @java.lang.Override
+    public boolean getWriteAsync() {
+      return writeAsync_;
+    }
+    /**
+     *
+     *
+     * 
      +     * If set to true, the user event will be written asynchronously after
+     * validation, and the API will respond without waiting for the write.
+     * Therefore, silent failures can occur even if the API returns success. In
+     * case of silent failures, error messages can be found in Stackdriver logs.
+     * 
      
+     *
+     * bool write_async = 3;
+     *
+     * @param value The writeAsync to set.
+     * @return This builder for chaining.
+     */
+    public Builder setWriteAsync(boolean value) {
+
+      writeAsync_ = value;
+      onChanged();
+      return this;
+    }
+    /**
+     *
+     *
+     * 
      +     * If set to true, the user event will be written asynchronously after
+     * validation, and the API will respond without waiting for the write.
+     * Therefore, silent failures can occur even if the API returns success. In
+     * case of silent failures, error messages can be found in Stackdriver logs.
+     * 
      
+     *
+     * bool write_async = 3;
+     *
+     * @return This builder for chaining.
+     */
+    public Builder clearWriteAsync() {
+
+      writeAsync_ = false;
+      onChanged();
+      return this;
+    }
+
     @java.lang.Override
     public final Builder setUnknownFields(final com.google.protobuf.UnknownFieldSet unknownFields) {
       return super.setUnknownFields(unknownFields);
diff --git a/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/WriteUserEventRequestOrBuilder.java b/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/WriteUserEventRequestOrBuilder.java
index cd01b63d9539..f3cc963579ea 100644
--- a/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/WriteUserEventRequestOrBuilder.java
+++ b/java-retail/proto-google-cloud-retail-v2beta/src/main/java/com/google/cloud/retail/v2beta/WriteUserEventRequestOrBuilder.java
@@ -90,4 +90,20 @@ public interface WriteUserEventRequestOrBuilder
    * 
    */
   com.google.cloud.retail.v2beta.UserEventOrBuilder getUserEventOrBuilder();
+
+  /**
+   *
+   *
+   * 
      +   * If set to true, the user event will be written asynchronously after
+   * validation, and the API will respond without waiting for the write.
+   * Therefore, silent failures can occur even if the API returns success. In
+   * case of silent failures, error messages can be found in Stackdriver logs.
+   * 
      
+   *
+   * bool write_async = 3;
+   *
+   * @return The writeAsync.
+   */
+  boolean getWriteAsync();
 }
diff --git a/java-retail/proto-google-cloud-retail-v2beta/src/main/proto/google/cloud/retail/v2beta/catalog.proto b/java-retail/proto-google-cloud-retail-v2beta/src/main/proto/google/cloud/retail/v2beta/catalog.proto
index c95e3ac93403..ca691cc86ae8 100644
--- a/java-retail/proto-google-cloud-retail-v2beta/src/main/proto/google/cloud/retail/v2beta/catalog.proto
+++ b/java-retail/proto-google-cloud-retail-v2beta/src/main/proto/google/cloud/retail/v2beta/catalog.proto
@@ -104,8 +104,7 @@ message CatalogAttribute {
 
   // The status of the indexable option of a catalog attribute.
   enum IndexableOption {
-    // Value used when unset. Defaults to
-    // [INDEXABLE_ENABLED][google.cloud.retail.v2beta.CatalogAttribute.IndexableOption.INDEXABLE_ENABLED].
+    // Value used when unset.
     INDEXABLE_OPTION_UNSPECIFIED = 0;
 
     // Indexable option enabled for an attribute.
@@ -117,8 +116,7 @@ message CatalogAttribute {
 
   // The status of the dynamic facetable option of a catalog attribute.
   enum DynamicFacetableOption {
-    // Value used when unset. Defaults to
-    // [DYNAMIC_FACETABLE_ENABLED][google.cloud.retail.v2beta.CatalogAttribute.DynamicFacetableOption.DYNAMIC_FACETABLE_ENABLED].
+    // Value used when unset.
     DYNAMIC_FACETABLE_OPTION_UNSPECIFIED = 0;
 
     // Dynamic facetable option enabled for an attribute.
@@ -130,8 +128,7 @@ message CatalogAttribute {
 
   // The status of the searchable option of a catalog attribute.
   enum SearchableOption {
-    // Value used when unset. Defaults to
-    // [SEARCHABLE_DISABLED][google.cloud.retail.v2beta.CatalogAttribute.SearchableOption.SEARCHABLE_DISABLED].
+    // Value used when unset.
     SEARCHABLE_OPTION_UNSPECIFIED = 0;
 
     // Searchable option enabled for an attribute.
@@ -154,6 +151,19 @@ message CatalogAttribute {
     EXACT_SEARCHABLE_DISABLED = 2;
   }
 
+  // The status of the retrievable option of a catalog attribute.
+  enum RetrievableOption {
+    // Value used when unset. Defaults to
+    // [RETRIEVABLE_DISABLED][google.cloud.retail.v2beta.CatalogAttribute.RetrievableOption.RETRIEVABLE_DISABLED].
+    RETRIEVABLE_OPTION_UNSPECIFIED = 0;
+
+    // Retrievable option enabled for an attribute.
+    RETRIEVABLE_ENABLED = 1;
+
+    // Retrievable option disabled for an attribute.
+    RETRIEVABLE_DISABLED = 2;
+  }
+
   // Required. Attribute name.
   // For example: `color`, `brands`, `attributes.custom_attribute`, such as
   // `attributes.xyz`.
@@ -177,13 +187,13 @@ message CatalogAttribute {
   // APIs. This field is `False` for pre-loaded
   // [CatalogAttribute][google.cloud.retail.v2beta.CatalogAttribute]s.
   //
-  // Only pre-loaded
-  // [CatalogAttribute][google.cloud.retail.v2beta.CatalogAttribute]s that are
-  // neither in use by products nor predefined can be deleted.
-  // [CatalogAttribute][google.cloud.retail.v2beta.CatalogAttribute]s that are
-  // either in use by products or are predefined cannot be deleted; however,
-  // their configuration properties will reset to default values upon removal
-  // request.
+  // Only pre-loaded [catalog
+  // attributes][google.cloud.retail.v2beta.CatalogAttribute] that are neither
+  // in use by products nor predefined can be deleted. [Catalog
+  // attributes][google.cloud.retail.v2beta.CatalogAttribute] that are
+  // either in use by products or are predefined attributes cannot be deleted;
+  // however, their configuration properties will reset to default values upon
+  // removal request.
   //
   // After catalog changes, it takes about 10 minutes for this field to update.
   bool in_use = 9 [(google.api.field_behavior) = OUTPUT_ONLY];
@@ -197,12 +207,16 @@ message CatalogAttribute {
   // is CATALOG_LEVEL_ATTRIBUTE_CONFIG, if INDEXABLE_ENABLED attribute values
   // are indexed so that it can be filtered, faceted, or boosted in
   // [SearchService.Search][google.cloud.retail.v2beta.SearchService.Search].
+  //
+  // Must be specified, otherwise throws INVALID_FORMAT error.
   IndexableOption indexable_option = 5;
 
   // If DYNAMIC_FACETABLE_ENABLED, attribute values are available for dynamic
   // facet. Could only be DYNAMIC_FACETABLE_DISABLED if
   // [CatalogAttribute.indexable_option][google.cloud.retail.v2beta.CatalogAttribute.indexable_option]
   // is INDEXABLE_DISABLED. Otherwise, an INVALID_ARGUMENT error is returned.
+  //
+  // Must be specified, otherwise throws INVALID_FORMAT error.
   DynamicFacetableOption dynamic_facetable_option = 6;
 
   // When
@@ -215,6 +229,8 @@ message CatalogAttribute {
   // will not be searchable by text queries in
   // [SearchService.Search][google.cloud.retail.v2beta.SearchService.Search], as
   // there are no text values associated to numerical attributes.
+  //
+  // Must be specified, otherwise throws INVALID_FORMAT error.
   SearchableOption searchable_option = 7;
 
   // When
@@ -229,6 +245,10 @@ message CatalogAttribute {
   // This property only applies to textual custom attributes and requires
   // indexable set to enabled to enable exact-searchable.
   ExactSearchableOption exact_searchable_option = 11;
+
+  // If RETRIEVABLE_ENABLED, attribute values are retrievable in the search
+  // results.
+  RetrievableOption retrievable_option = 12;
 }
 
 // Catalog level attribute config.
@@ -353,16 +373,16 @@ message CompletionConfig {
 // will be streamed to the linked branch.
 message MerchantCenterLink {
   // Required. The linked [Merchant center account
-  // id](https://developers.google.com/shopping-content/guides/accountstatuses).
+  // ID](https://developers.google.com/shopping-content/guides/accountstatuses).
   // The account must be a standalone account or a sub-account of a MCA.
   int64 merchant_center_account_id = 1 [(google.api.field_behavior) = REQUIRED];
 
-  // The branch id (e.g. 0/1/2) within this catalog that products from
+  // The branch ID (e.g. 0/1/2) within this catalog that products from
   // merchant_center_account_id are streamed to. When updating this field, an
   // empty value will use the currently configured default branch. However,
   // changing the default branch later on won't change the linked branch here.
   //
-  // A single branch id can only have one linked merchant center account id.
+  // A single branch ID can only have one linked merchant center account ID.
   string branch_id = 2;
 
   // String representing the destination to import for, all if left empty.
@@ -392,6 +412,21 @@ message MerchantCenterLink {
   //
   // Example value: `en`.
   string language_code = 5;
+
+  // Criteria for the Merchant Center feeds to be ingested via the link.
+  // All offers will be ingested if the list is empty.
+  // Otherwise the offers will be ingested from selected feeds.
+  repeated MerchantCenterFeedFilter feeds = 6;
+}
+
+// Merchant Center Feed filter criterion.
+message MerchantCenterFeedFilter {
+  // Merchant Center primary feed ID.
+  int64 primary_feed_id = 1;
+
+  // Merchant Center primary feed name. The name is used for the display
+  // purposes only.
+  string primary_feed_name = 2;
 }
 
 // Configures Merchant Center linking.
diff --git a/java-retail/proto-google-cloud-retail-v2beta/src/main/proto/google/cloud/retail/v2beta/catalog_service.proto b/java-retail/proto-google-cloud-retail-v2beta/src/main/proto/google/cloud/retail/v2beta/catalog_service.proto
index 7001c211324f..bab1fc34aa5e 100644
--- a/java-retail/proto-google-cloud-retail-v2beta/src/main/proto/google/cloud/retail/v2beta/catalog_service.proto
+++ b/java-retail/proto-google-cloud-retail-v2beta/src/main/proto/google/cloud/retail/v2beta/catalog_service.proto
@@ -483,13 +483,18 @@ message BatchRemoveCatalogAttributesRequest {
 // Response of the
 // [CatalogService.BatchRemoveCatalogAttributes][google.cloud.retail.v2beta.CatalogService.BatchRemoveCatalogAttributes].
 message BatchRemoveCatalogAttributesResponse {
-  // Catalog attributes that were deleted. Only attributes that are not [in
-  // use][CatalogAttribute.in_use] by products can be deleted.
+  // Catalog attributes that were deleted. Only pre-loaded [catalog
+  // attributes][google.cloud.retail.v2beta.CatalogAttribute] that are
+  // neither [in
+  // use][google.cloud.retail.v2beta.CatalogAttribute.in_use] by
+  // products nor predefined can be deleted.
   repeated string deleted_catalog_attributes = 1;
 
-  // Catalog attributes that were reset. Attributes that are [in
-  // use][CatalogAttribute.in_use] by products cannot be deleted, however their
-  // configuration properties will reset to default values upon removal request.
+  // Catalog attributes that were reset. [Catalog
+  // attributes][google.cloud.retail.v2beta.CatalogAttribute] that are either
+  // [in use][google.cloud.retail.v2beta.CatalogAttribute.in_use] by products or
+  // are predefined attributes cannot be deleted; however, their configuration
+  // properties will reset to default values upon removal request.
   repeated string reset_catalog_attributes = 2;
 }
 
diff --git a/java-retail/proto-google-cloud-retail-v2beta/src/main/proto/google/cloud/retail/v2beta/common.proto b/java-retail/proto-google-cloud-retail-v2beta/src/main/proto/google/cloud/retail/v2beta/common.proto
index fd1247636b4a..5aab1d0ddc31 100644
--- a/java-retail/proto-google-cloud-retail-v2beta/src/main/proto/google/cloud/retail/v2beta/common.proto
+++ b/java-retail/proto-google-cloud-retail-v2beta/src/main/proto/google/cloud/retail/v2beta/common.proto
@@ -218,7 +218,8 @@ message Rule {
   }
 
   // Creates a set of terms that will be treated as synonyms of each other.
-  // Example: synonyms of "sneakers" and "shoes".
+  // Example: synonyms of "sneakers" and "shoes":
+  //
   //  * "sneakers" will use a synonym of "shoes".
   //  * "shoes" will use a synonym of "sneakers".
   message TwowaySynonymsAction {
diff --git a/java-retail/proto-google-cloud-retail-v2beta/src/main/proto/google/cloud/retail/v2beta/completion_service.proto b/java-retail/proto-google-cloud-retail-v2beta/src/main/proto/google/cloud/retail/v2beta/completion_service.proto
index 4db036647f97..635189b60960 100644
--- a/java-retail/proto-google-cloud-retail-v2beta/src/main/proto/google/cloud/retail/v2beta/completion_service.proto
+++ b/java-retail/proto-google-cloud-retail-v2beta/src/main/proto/google/cloud/retail/v2beta/completion_service.proto
@@ -110,8 +110,10 @@ message CompleteQueryRequest {
   // number of language codes is 3.
   repeated string language_codes = 3;
 
-  // The device type context for completion suggestions.
-  // It is useful to apply different suggestions on different device types, e.g.
+  // The device type context for completion suggestions. We recommend that you
+  // leave this field empty.
+  //
+  // It can apply different suggestions on different device types, e.g.
   // `DESKTOP`, `MOBILE`. If it is empty, the suggestions are across all device
   // types.
   //
diff --git a/java-retail/proto-google-cloud-retail-v2beta/src/main/proto/google/cloud/retail/v2beta/control.proto b/java-retail/proto-google-cloud-retail-v2beta/src/main/proto/google/cloud/retail/v2beta/control.proto
index 238f0f5fe69e..2d6367199eeb 100644
--- a/java-retail/proto-google-cloud-retail-v2beta/src/main/proto/google/cloud/retail/v2beta/control.proto
+++ b/java-retail/proto-google-cloud-retail-v2beta/src/main/proto/google/cloud/retail/v2beta/control.proto
@@ -68,8 +68,8 @@ message Control {
   string display_name = 2 [(google.api.field_behavior) = REQUIRED];
 
   // Output only. List of [serving
-  // configuration][google.cloud.retail.v2beta.ServingConfig] ids that are
-  // associated with this control in the same
+  // config][google.cloud.retail.v2beta.ServingConfig] ids that are associated
+  // with this control in the same
   // [Catalog][google.cloud.retail.v2beta.Catalog].
   //
   // Note the association is managed via the
diff --git a/java-retail/proto-google-cloud-retail-v2beta/src/main/proto/google/cloud/retail/v2beta/export_config.proto b/java-retail/proto-google-cloud-retail-v2beta/src/main/proto/google/cloud/retail/v2beta/export_config.proto
index de24f41907ae..d330c6faa530 100644
--- a/java-retail/proto-google-cloud-retail-v2beta/src/main/proto/google/cloud/retail/v2beta/export_config.proto
+++ b/java-retail/proto-google-cloud-retail-v2beta/src/main/proto/google/cloud/retail/v2beta/export_config.proto
@@ -81,10 +81,14 @@ message ExportUserEventsResponse {
   OutputResult output_result = 3;
 }
 
-// Output result.
+// Output result that stores the information about where the exported data is
+// stored.
 message OutputResult {
-  // Export result in BigQuery.
+  // The BigQuery location where the result is stored.
   repeated BigQueryOutputResult bigquery_result = 1;
+
+  // The Google Cloud Storage location where the result is stored.
+  repeated GcsOutputResult gcs_result = 2;
 }
 
 // A BigQuery output result.
@@ -95,3 +99,9 @@ message BigQueryOutputResult {
   // The ID of a BigQuery Table.
   string table_id = 2;
 }
+
+// A Gcs output result.
+message GcsOutputResult {
+  // The uri of Gcs output
+  string output_uri = 1;
+}
diff --git a/java-retail/proto-google-cloud-retail-v2beta/src/main/proto/google/cloud/retail/v2beta/model.proto b/java-retail/proto-google-cloud-retail-v2beta/src/main/proto/google/cloud/retail/v2beta/model.proto
index ea4bd30c6c97..3141b0df500e 100644
--- a/java-retail/proto-google-cloud-retail-v2beta/src/main/proto/google/cloud/retail/v2beta/model.proto
+++ b/java-retail/proto-google-cloud-retail-v2beta/src/main/proto/google/cloud/retail/v2beta/model.proto
@@ -160,7 +160,8 @@ message Model {
   //
   // Currently supported values: `recommended-for-you`, `others-you-may-like`,
   // `frequently-bought-together`, `page-optimization`, `similar-items`,
-  // `buy-it-again`, and `recently-viewed`(readonly value).
+  // `buy-it-again`, `on-sale-items`, and `recently-viewed`(readonly value).
+  //
   //
   // This field together with
   // [optimization_objective][google.cloud.retail.v2beta.Model.optimization_objective]
diff --git a/java-retail/proto-google-cloud-retail-v2beta/src/main/proto/google/cloud/retail/v2beta/prediction_service.proto b/java-retail/proto-google-cloud-retail-v2beta/src/main/proto/google/cloud/retail/v2beta/prediction_service.proto
index 1ac3026d63fa..7b3f322f197b 100644
--- a/java-retail/proto-google-cloud-retail-v2beta/src/main/proto/google/cloud/retail/v2beta/prediction_service.proto
+++ b/java-retail/proto-google-cloud-retail-v2beta/src/main/proto/google/cloud/retail/v2beta/prediction_service.proto
@@ -62,7 +62,7 @@ message PredictRequest {
   // The ID of the Recommendations AI serving config or placement.
   // Before you can request predictions from your model, you must create at
   // least one serving config or placement for it. For more information, see
-  // [Managing serving configurations]
+  // [Manage serving configs]
   // (https://cloud.google.com/retail/docs/manage-configs).
   //
   // The full list of available serving configs can be seen at
@@ -117,12 +117,11 @@ message PredictRequest {
   //  * filterOutOfStockItems  tag=(-"promotional")
   //  * filterOutOfStockItems
   //
-  // If your filter blocks all prediction results, the API will return generic
-  // (unfiltered) popular products. If you only want results strictly matching
-  // the filters, set `strictFiltering` to True in `PredictRequest.params` to
-  // receive empty results instead.
-  // Note that the API will never return items with storageStatus of "EXPIRED"
-  // or "DELETED" regardless of filter choices.
+  // If your filter blocks all prediction results, the API will return *no*
+  // results. If instead you want empty result sets to return generic
+  // (unfiltered) popular products, set `strictFiltering` to False in
+  // `PredictRequest.params`. Note that the API will never return items with
+  // storageStatus of "EXPIRED" or "DELETED" regardless of filter choices.
   //
   // If `filterSyntaxV2` is set to true under the `params` field, then
   // attribute-based expressions are expected instead of the above described
@@ -149,7 +148,7 @@ message PredictRequest {
   // * `returnScore`: Boolean. If set to true, the prediction 'score'
   //    corresponding to each returned product will be set in the
   //    `results.metadata` field in the prediction response. The given
-  //    'score' indicates the probability of an product being clicked/purchased
+  //    'score' indicates the probability of a product being clicked/purchased
   //    given the user's context and history.
   // * `strictFiltering`: Boolean. True by default. If set to false, the service
   //    will return generic (unfiltered) popular products instead of empty if
diff --git a/java-retail/proto-google-cloud-retail-v2beta/src/main/proto/google/cloud/retail/v2beta/product.proto b/java-retail/proto-google-cloud-retail-v2beta/src/main/proto/google/cloud/retail/v2beta/product.proto
index 8b10090136fc..383c06a2bab2 100644
--- a/java-retail/proto-google-cloud-retail-v2beta/src/main/proto/google/cloud/retail/v2beta/product.proto
+++ b/java-retail/proto-google-cloud-retail-v2beta/src/main/proto/google/cloud/retail/v2beta/product.proto
@@ -105,6 +105,13 @@ message Product {
   oneof expiration {
     // The timestamp when this product becomes unavailable for
     // [SearchService.Search][google.cloud.retail.v2beta.SearchService.Search].
+    // Note that this is only applicable to
+    // [Type.PRIMARY][google.cloud.retail.v2beta.Product.Type.PRIMARY] and
+    // [Type.COLLECTION][google.cloud.retail.v2beta.Product.Type.COLLECTION],
+    // and ignored for
+    // [Type.VARIANT][google.cloud.retail.v2beta.Product.Type.VARIANT]. In
+    // general, we suggest the users to delete the stale products explicitly,
+    // instead of using this field to determine staleness.
     //
     // If it is set, the [Product][google.cloud.retail.v2beta.Product] is not
     // available for
@@ -125,7 +132,14 @@ message Product {
     // [expiration_date](https://support.google.com/merchants/answer/6324499).
     google.protobuf.Timestamp expire_time = 16;
 
-    // Input only. The TTL (time to live) of the product.
+    // Input only. The TTL (time to live) of the product. Note that this is only
+    // applicable to
+    // [Type.PRIMARY][google.cloud.retail.v2beta.Product.Type.PRIMARY] and
+    // [Type.COLLECTION][google.cloud.retail.v2beta.Product.Type.COLLECTION],
+    // and ignored for
+    // [Type.VARIANT][google.cloud.retail.v2beta.Product.Type.VARIANT]. In
+    // general, we suggest the users to delete the stale products explicitly,
+    // instead of using this field to determine staleness.
     //
     // If it is set, it must be a non-negative value, and
     // [expire_time][google.cloud.retail.v2beta.Product.expire_time] is set as
@@ -363,6 +377,11 @@ message Product {
   // The timestamp when this [Product][google.cloud.retail.v2beta.Product]
   // becomes available for
   // [SearchService.Search][google.cloud.retail.v2beta.SearchService.Search].
+  // Note that this is only applicable to
+  // [Type.PRIMARY][google.cloud.retail.v2beta.Product.Type.PRIMARY] and
+  // [Type.COLLECTION][google.cloud.retail.v2beta.Product.Type.COLLECTION], and
+  // ignored for
+  // [Type.VARIANT][google.cloud.retail.v2beta.Product.Type.VARIANT].
   google.protobuf.Timestamp available_time = 18;
 
   // The online availability of the
@@ -550,7 +569,9 @@ message Product {
   // Note: Returning more fields in
   // [SearchResponse][google.cloud.retail.v2beta.SearchResponse] can increase
   // response payload size and serving latency.
-  google.protobuf.FieldMask retrievable_fields = 30;
+  //
+  // This field is deprecated. Use the retrievable site-wide control instead.
+  google.protobuf.FieldMask retrievable_fields = 30 [deprecated = true];
 
   // Output only. Product variants grouped together on primary product which
   // share similar product attributes. It's automatically grouped by
diff --git a/java-retail/proto-google-cloud-retail-v2beta/src/main/proto/google/cloud/retail/v2beta/search_service.proto b/java-retail/proto-google-cloud-retail-v2beta/src/main/proto/google/cloud/retail/v2beta/search_service.proto
index 5a1004410e64..9bbf255b2152 100644
--- a/java-retail/proto-google-cloud-retail-v2beta/src/main/proto/google/cloud/retail/v2beta/search_service.proto
+++ b/java-retail/proto-google-cloud-retail-v2beta/src/main/proto/google/cloud/retail/v2beta/search_service.proto
@@ -218,7 +218,7 @@ message SearchRequest {
     FacetKey facet_key = 1 [(google.api.field_behavior) = REQUIRED];
 
     // Maximum of facet values that should be returned for this facet. If
-    // unspecified, defaults to 20. The maximum allowed value is 300. Values
+    // unspecified, defaults to 50. The maximum allowed value is 300. Values
     // above 300 will be coerced to 300.
     //
     // If this field is negative, an INVALID_ARGUMENT is returned.
@@ -478,7 +478,7 @@ message SearchRequest {
   // `projects/*/locations/global/catalogs/default_catalog/servingConfigs/default_serving_config`
   // or the name of the legacy placement resource, such as
   // `projects/*/locations/global/catalogs/default_catalog/placements/default_search`.
-  // This field is used to identify the serving configuration name and the set
+  // This field is used to identify the serving config name and the set
   // of models that will be used to make the search.
   string placement = 1 [(google.api.field_behavior) = REQUIRED];
 
diff --git a/java-retail/proto-google-cloud-retail-v2beta/src/main/proto/google/cloud/retail/v2beta/user_event_service.proto b/java-retail/proto-google-cloud-retail-v2beta/src/main/proto/google/cloud/retail/v2beta/user_event_service.proto
index 74dccdff892f..4dc822bdc3b3 100644
--- a/java-retail/proto-google-cloud-retail-v2beta/src/main/proto/google/cloud/retail/v2beta/user_event_service.proto
+++ b/java-retail/proto-google-cloud-retail-v2beta/src/main/proto/google/cloud/retail/v2beta/user_event_service.proto
@@ -124,10 +124,24 @@ message WriteUserEventRequest {
 
   // Required. User event to write.
   UserEvent user_event = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // If set to true, the user event will be written asynchronously after
+  // validation, and the API will respond without waiting for the write.
+  // Therefore, silent failures can occur even if the API returns success. In
+  // case of silent failures, error messages can be found in Stackdriver logs.
+  bool write_async = 3;
 }
 
 // Request message for CollectUserEvent method.
 message CollectUserEventRequest {
+  // The rule that can convert the raw_json to a user event. It is needed
+  // only when the raw_json is set.
+  oneof conversion_rule {
+    // The prebuilt rule name that can convert a specific type of raw_json.
+    // For example: "default_schema/v1.0"
+    string prebuilt_rule = 6;
+  }
+
   // Required. The parent catalog name, such as
   // `projects/1234/locations/global/catalogs/default_catalog`.
   string parent = 1 [(google.api.field_behavior) = REQUIRED];
@@ -146,6 +160,12 @@ message CollectUserEventRequest {
   // otherwise identical get requests. The name is abbreviated to reduce the
   // payload bytes.
   int64 ets = 4;
+
+  // An arbitrary serialized JSON string that contains necessary information
+  // that can comprise a user event. When this field is specified, the
+  // user_event field will be ignored. Note: line-delimited JSON is not
+  // supported, a single JSON only.
+  string raw_json = 5;
 }
 
 // Request message for RejoinUserEvents method.
diff --git a/java-retail/samples/snippets/generated/com/google/cloud/retail/v2/usereventservice/collectuserevent/AsyncCollectUserEvent.java b/java-retail/samples/snippets/generated/com/google/cloud/retail/v2/usereventservice/collectuserevent/AsyncCollectUserEvent.java
index 7cd3d563d20e..17bc1cffb36c 100644
--- a/java-retail/samples/snippets/generated/com/google/cloud/retail/v2/usereventservice/collectuserevent/AsyncCollectUserEvent.java
+++ b/java-retail/samples/snippets/generated/com/google/cloud/retail/v2/usereventservice/collectuserevent/AsyncCollectUserEvent.java
@@ -41,6 +41,7 @@ public static void asyncCollectUserEvent() throws Exception {
               .setUserEvent("userEvent315571599")
               .setUri("uri116076")
               .setEts(100772)
+              .setRawJson("rawJson985449776")
               .build();
       ApiFuture future =
           userEventServiceClient.collectUserEventCallable().futureCall(request);
diff --git a/java-retail/samples/snippets/generated/com/google/cloud/retail/v2/usereventservice/collectuserevent/SyncCollectUserEvent.java b/java-retail/samples/snippets/generated/com/google/cloud/retail/v2/usereventservice/collectuserevent/SyncCollectUserEvent.java
index 431f08625af5..f3a83a66ce78 100644
--- a/java-retail/samples/snippets/generated/com/google/cloud/retail/v2/usereventservice/collectuserevent/SyncCollectUserEvent.java
+++ b/java-retail/samples/snippets/generated/com/google/cloud/retail/v2/usereventservice/collectuserevent/SyncCollectUserEvent.java
@@ -40,6 +40,7 @@ public static void syncCollectUserEvent() throws Exception {
               .setUserEvent("userEvent315571599")
               .setUri("uri116076")
               .setEts(100772)
+              .setRawJson("rawJson985449776")
               .build();
       HttpBody response = userEventServiceClient.collectUserEvent(request);
     }
diff --git a/java-retail/samples/snippets/generated/com/google/cloud/retail/v2/usereventservice/writeuserevent/AsyncWriteUserEvent.java b/java-retail/samples/snippets/generated/com/google/cloud/retail/v2/usereventservice/writeuserevent/AsyncWriteUserEvent.java
index db00d6afaab2..019b88c8be6e 100644
--- a/java-retail/samples/snippets/generated/com/google/cloud/retail/v2/usereventservice/writeuserevent/AsyncWriteUserEvent.java
+++ b/java-retail/samples/snippets/generated/com/google/cloud/retail/v2/usereventservice/writeuserevent/AsyncWriteUserEvent.java
@@ -39,6 +39,7 @@ public static void asyncWriteUserEvent() throws Exception {
           WriteUserEventRequest.newBuilder()
               .setParent("parent-995424086")
               .setUserEvent(UserEvent.newBuilder().build())
+              .setWriteAsync(true)
               .build();
       ApiFuture future =
           userEventServiceClient.writeUserEventCallable().futureCall(request);
diff --git a/java-retail/samples/snippets/generated/com/google/cloud/retail/v2/usereventservice/writeuserevent/SyncWriteUserEvent.java b/java-retail/samples/snippets/generated/com/google/cloud/retail/v2/usereventservice/writeuserevent/SyncWriteUserEvent.java
index 5ec87c71ecd2..d3ee7e597362 100644
--- a/java-retail/samples/snippets/generated/com/google/cloud/retail/v2/usereventservice/writeuserevent/SyncWriteUserEvent.java
+++ b/java-retail/samples/snippets/generated/com/google/cloud/retail/v2/usereventservice/writeuserevent/SyncWriteUserEvent.java
@@ -38,6 +38,7 @@ public static void syncWriteUserEvent() throws Exception {
           WriteUserEventRequest.newBuilder()
               .setParent("parent-995424086")
               .setUserEvent(UserEvent.newBuilder().build())
+              .setWriteAsync(true)
               .build();
       UserEvent response = userEventServiceClient.writeUserEvent(request);
     }
diff --git a/java-retail/samples/snippets/generated/com/google/cloud/retail/v2alpha/catalogservice/batchremovecatalogattributes/AsyncBatchRemoveCatalogAttributes.java b/java-retail/samples/snippets/generated/com/google/cloud/retail/v2alpha/catalogservice/batchremovecatalogattributes/AsyncBatchRemoveCatalogAttributes.java
new file mode 100644
index 000000000000..31aaa808c6a0
--- /dev/null
+++ b/java-retail/samples/snippets/generated/com/google/cloud/retail/v2alpha/catalogservice/batchremovecatalogattributes/AsyncBatchRemoveCatalogAttributes.java
@@ -0,0 +1,53 @@
+/*
+ * Copyright 2022 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.google.cloud.retail.v2alpha.samples;
+
+// [START retail_v2alpha_generated_CatalogService_BatchRemoveCatalogAttributes_async]
+import com.google.api.core.ApiFuture;
+import com.google.cloud.retail.v2alpha.AttributesConfigName;
+import com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesRequest;
+import com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesResponse;
+import com.google.cloud.retail.v2alpha.CatalogServiceClient;
+import java.util.ArrayList;
+
+public class AsyncBatchRemoveCatalogAttributes {
+
+  public static void main(String[] args) throws Exception {
+    asyncBatchRemoveCatalogAttributes();
+  }
+
+  public static void asyncBatchRemoveCatalogAttributes() throws Exception {
+    // This snippet has been automatically generated and should be regarded as a code template only.
+    // It will require modifications to work:
+    // - It may require correct/in-range values for request initialization.
+    // - It may require specifying regional endpoints when creating the service client as shown in
+    // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+    try (CatalogServiceClient catalogServiceClient = CatalogServiceClient.create()) {
+      BatchRemoveCatalogAttributesRequest request =
+          BatchRemoveCatalogAttributesRequest.newBuilder()
+              .setAttributesConfig(
+                  AttributesConfigName.of("[PROJECT]", "[LOCATION]", "[CATALOG]").toString())
+              .addAllAttributeKeys(new ArrayList())
+              .build();
+      ApiFuture future =
+          catalogServiceClient.batchRemoveCatalogAttributesCallable().futureCall(request);
+      // Do something.
+      BatchRemoveCatalogAttributesResponse response = future.get();
+    }
+  }
+}
+// [END retail_v2alpha_generated_CatalogService_BatchRemoveCatalogAttributes_async]
diff --git a/java-retail/samples/snippets/generated/com/google/cloud/retail/v2alpha/catalogservice/batchremovecatalogattributes/SyncBatchRemoveCatalogAttributes.java b/java-retail/samples/snippets/generated/com/google/cloud/retail/v2alpha/catalogservice/batchremovecatalogattributes/SyncBatchRemoveCatalogAttributes.java
new file mode 100644
index 000000000000..dce5455dad77
--- /dev/null
+++ b/java-retail/samples/snippets/generated/com/google/cloud/retail/v2alpha/catalogservice/batchremovecatalogattributes/SyncBatchRemoveCatalogAttributes.java
@@ -0,0 +1,50 @@
+/*
+ * Copyright 2022 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.google.cloud.retail.v2alpha.samples;
+
+// [START retail_v2alpha_generated_CatalogService_BatchRemoveCatalogAttributes_sync]
+import com.google.cloud.retail.v2alpha.AttributesConfigName;
+import com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesRequest;
+import com.google.cloud.retail.v2alpha.BatchRemoveCatalogAttributesResponse;
+import com.google.cloud.retail.v2alpha.CatalogServiceClient;
+import java.util.ArrayList;
+
+public class SyncBatchRemoveCatalogAttributes {
+
+  public static void main(String[] args) throws Exception {
+    syncBatchRemoveCatalogAttributes();
+  }
+
+  public static void syncBatchRemoveCatalogAttributes() throws Exception {
+    // This snippet has been automatically generated and should be regarded as a code template only.
+    // It will require modifications to work:
+    // - It may require correct/in-range values for request initialization.
+    // - It may require specifying regional endpoints when creating the service client as shown in
+    // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
+    try (CatalogServiceClient catalogServiceClient = CatalogServiceClient.create()) {
+      BatchRemoveCatalogAttributesRequest request =
+          BatchRemoveCatalogAttributesRequest.newBuilder()
+              .setAttributesConfig(
+                  AttributesConfigName.of("[PROJECT]", "[LOCATION]", "[CATALOG]").toString())
+              .addAllAttributeKeys(new ArrayList())
+              .build();
+      BatchRemoveCatalogAttributesResponse response =
+          catalogServiceClient.batchRemoveCatalogAttributes(request);
+    }
+  }
+}
+// [END retail_v2alpha_generated_CatalogService_BatchRemoveCatalogAttributes_sync]
diff --git a/java-retail/samples/snippets/generated/com/google/cloud/retail/v2alpha/completionservice/completequery/AsyncCompleteQuery.java b/java-retail/samples/snippets/generated/com/google/cloud/retail/v2alpha/completionservice/completequery/AsyncCompleteQuery.java
index d527f5bb0ae9..d2c8e86b12eb 100644
--- a/java-retail/samples/snippets/generated/com/google/cloud/retail/v2alpha/completionservice/completequery/AsyncCompleteQuery.java
+++ b/java-retail/samples/snippets/generated/com/google/cloud/retail/v2alpha/completionservice/completequery/AsyncCompleteQuery.java
@@ -46,6 +46,7 @@ public static void asyncCompleteQuery() throws Exception {
               .setDeviceType("deviceType781190832")
               .setDataset("dataset1443214456")
               .setMaxSuggestions(618824852)
+              .setEnableAttributeSuggestions(true)
               .build();
       ApiFuture future =
           completionServiceClient.completeQueryCallable().futureCall(request);
diff --git a/java-retail/samples/snippets/generated/com/google/cloud/retail/v2alpha/completionservice/completequery/SyncCompleteQuery.java b/java-retail/samples/snippets/generated/com/google/cloud/retail/v2alpha/completionservice/completequery/SyncCompleteQuery.java
index 565fb3c35856..822992d18b04 100644
--- a/java-retail/samples/snippets/generated/com/google/cloud/retail/v2alpha/completionservice/completequery/SyncCompleteQuery.java
+++ b/java-retail/samples/snippets/generated/com/google/cloud/retail/v2alpha/completionservice/completequery/SyncCompleteQuery.java
@@ -45,6 +45,7 @@ public static void syncCompleteQuery() throws Exception {
               .setDeviceType("deviceType781190832")
               .setDataset("dataset1443214456")
               .setMaxSuggestions(618824852)
+              .setEnableAttributeSuggestions(true)
               .build();
       CompleteQueryResponse response = completionServiceClient.completeQuery(request);
     }
diff --git a/java-retail/samples/snippets/generated/com/google/cloud/retail/v2alpha/usereventservice/collectuserevent/AsyncCollectUserEvent.java b/java-retail/samples/snippets/generated/com/google/cloud/retail/v2alpha/usereventservice/collectuserevent/AsyncCollectUserEvent.java
index a51649b4f343..af3aa455a29f 100644
--- a/java-retail/samples/snippets/generated/com/google/cloud/retail/v2alpha/usereventservice/collectuserevent/AsyncCollectUserEvent.java
+++ b/java-retail/samples/snippets/generated/com/google/cloud/retail/v2alpha/usereventservice/collectuserevent/AsyncCollectUserEvent.java
@@ -41,6 +41,7 @@ public static void asyncCollectUserEvent() throws Exception {
               .setUserEvent("userEvent315571599")
               .setUri("uri116076")
               .setEts(100772)
+              .setRawJson("rawJson985449776")
               .build();
       ApiFuture future =
           userEventServiceClient.collectUserEventCallable().futureCall(request);
diff --git a/java-retail/samples/snippets/generated/com/google/cloud/retail/v2alpha/usereventservice/collectuserevent/SyncCollectUserEvent.java b/java-retail/samples/snippets/generated/com/google/cloud/retail/v2alpha/usereventservice/collectuserevent/SyncCollectUserEvent.java
index 91087075e65c..96d1c7828c19 100644
--- a/java-retail/samples/snippets/generated/com/google/cloud/retail/v2alpha/usereventservice/collectuserevent/SyncCollectUserEvent.java
+++ b/java-retail/samples/snippets/generated/com/google/cloud/retail/v2alpha/usereventservice/collectuserevent/SyncCollectUserEvent.java
@@ -40,6 +40,7 @@ public static void syncCollectUserEvent() throws Exception {
               .setUserEvent("userEvent315571599")
               .setUri("uri116076")
               .setEts(100772)
+              .setRawJson("rawJson985449776")
               .build();
       HttpBody response = userEventServiceClient.collectUserEvent(request);
     }
diff --git a/java-retail/samples/snippets/generated/com/google/cloud/retail/v2alpha/usereventservice/writeuserevent/AsyncWriteUserEvent.java b/java-retail/samples/snippets/generated/com/google/cloud/retail/v2alpha/usereventservice/writeuserevent/AsyncWriteUserEvent.java
index 0522fe794949..51c58e946530 100644
--- a/java-retail/samples/snippets/generated/com/google/cloud/retail/v2alpha/usereventservice/writeuserevent/AsyncWriteUserEvent.java
+++ b/java-retail/samples/snippets/generated/com/google/cloud/retail/v2alpha/usereventservice/writeuserevent/AsyncWriteUserEvent.java
@@ -39,6 +39,7 @@ public static void asyncWriteUserEvent() throws Exception {
           WriteUserEventRequest.newBuilder()
               .setParent("parent-995424086")
               .setUserEvent(UserEvent.newBuilder().build())
+              .setWriteAsync(true)
               .build();
       ApiFuture future =
           userEventServiceClient.writeUserEventCallable().futureCall(request);
diff --git a/java-retail/samples/snippets/generated/com/google/cloud/retail/v2alpha/usereventservice/writeuserevent/SyncWriteUserEvent.java b/java-retail/samples/snippets/generated/com/google/cloud/retail/v2alpha/usereventservice/writeuserevent/SyncWriteUserEvent.java
index 3cf24203876f..ca78b00bafa0 100644
--- a/java-retail/samples/snippets/generated/com/google/cloud/retail/v2alpha/usereventservice/writeuserevent/SyncWriteUserEvent.java
+++ b/java-retail/samples/snippets/generated/com/google/cloud/retail/v2alpha/usereventservice/writeuserevent/SyncWriteUserEvent.java
@@ -38,6 +38,7 @@ public static void syncWriteUserEvent() throws Exception {
           WriteUserEventRequest.newBuilder()
               .setParent("parent-995424086")
               .setUserEvent(UserEvent.newBuilder().build())
+              .setWriteAsync(true)
               .build();
       UserEvent response = userEventServiceClient.writeUserEvent(request);
     }
diff --git a/java-retail/samples/snippets/generated/com/google/cloud/retail/v2beta/usereventservice/collectuserevent/AsyncCollectUserEvent.java b/java-retail/samples/snippets/generated/com/google/cloud/retail/v2beta/usereventservice/collectuserevent/AsyncCollectUserEvent.java
index 81b574a8ef6d..3b36f51b3010 100644
--- a/java-retail/samples/snippets/generated/com/google/cloud/retail/v2beta/usereventservice/collectuserevent/AsyncCollectUserEvent.java
+++ b/java-retail/samples/snippets/generated/com/google/cloud/retail/v2beta/usereventservice/collectuserevent/AsyncCollectUserEvent.java
@@ -41,6 +41,7 @@ public static void asyncCollectUserEvent() throws Exception {
               .setUserEvent("userEvent315571599")
               .setUri("uri116076")
               .setEts(100772)
+              .setRawJson("rawJson985449776")
               .build();
       ApiFuture future =
           userEventServiceClient.collectUserEventCallable().futureCall(request);
diff --git a/java-retail/samples/snippets/generated/com/google/cloud/retail/v2beta/usereventservice/collectuserevent/SyncCollectUserEvent.java b/java-retail/samples/snippets/generated/com/google/cloud/retail/v2beta/usereventservice/collectuserevent/SyncCollectUserEvent.java
index e961a6cb3e9a..4ed89a965ff7 100644
--- a/java-retail/samples/snippets/generated/com/google/cloud/retail/v2beta/usereventservice/collectuserevent/SyncCollectUserEvent.java
+++ b/java-retail/samples/snippets/generated/com/google/cloud/retail/v2beta/usereventservice/collectuserevent/SyncCollectUserEvent.java
@@ -40,6 +40,7 @@ public static void syncCollectUserEvent() throws Exception {
               .setUserEvent("userEvent315571599")
               .setUri("uri116076")
               .setEts(100772)
+              .setRawJson("rawJson985449776")
               .build();
       HttpBody response = userEventServiceClient.collectUserEvent(request);
     }
diff --git a/java-retail/samples/snippets/generated/com/google/cloud/retail/v2beta/usereventservice/writeuserevent/AsyncWriteUserEvent.java b/java-retail/samples/snippets/generated/com/google/cloud/retail/v2beta/usereventservice/writeuserevent/AsyncWriteUserEvent.java
index ada5abf09c6f..08a4993ff7d1 100644
--- a/java-retail/samples/snippets/generated/com/google/cloud/retail/v2beta/usereventservice/writeuserevent/AsyncWriteUserEvent.java
+++ b/java-retail/samples/snippets/generated/com/google/cloud/retail/v2beta/usereventservice/writeuserevent/AsyncWriteUserEvent.java
@@ -39,6 +39,7 @@ public static void asyncWriteUserEvent() throws Exception {
           WriteUserEventRequest.newBuilder()
               .setParent("parent-995424086")
               .setUserEvent(UserEvent.newBuilder().build())
+              .setWriteAsync(true)
               .build();
       ApiFuture future =
           userEventServiceClient.writeUserEventCallable().futureCall(request);
diff --git a/java-retail/samples/snippets/generated/com/google/cloud/retail/v2beta/usereventservice/writeuserevent/SyncWriteUserEvent.java b/java-retail/samples/snippets/generated/com/google/cloud/retail/v2beta/usereventservice/writeuserevent/SyncWriteUserEvent.java
index 099e96b289c9..a910775d6c73 100644
--- a/java-retail/samples/snippets/generated/com/google/cloud/retail/v2beta/usereventservice/writeuserevent/SyncWriteUserEvent.java
+++ b/java-retail/samples/snippets/generated/com/google/cloud/retail/v2beta/usereventservice/writeuserevent/SyncWriteUserEvent.java
@@ -38,6 +38,7 @@ public static void syncWriteUserEvent() throws Exception {
           WriteUserEventRequest.newBuilder()
               .setParent("parent-995424086")
               .setUserEvent(UserEvent.newBuilder().build())
+              .setWriteAsync(true)
               .build();
       UserEvent response = userEventServiceClient.writeUserEvent(request);
     }
diff --git a/versions.txt b/versions.txt
index a7c8d4a2bf0f..26acef5dc131 100644
--- a/versions.txt
+++ b/versions.txt
@@ -599,4 +599,4 @@ google-cloud-monitoring-metricsscope:0.1.0:0.1.0
 proto-google-cloud-monitoring-metricsscope-v1:0.1.0:0.1.0
 grpc-google-cloud-monitoring-metricsscope-v1:0.1.0:0.1.0
 proto-google-cloud-tpu-v2:2.8.0:2.8.0
-grpc-google-cloud-tpu-v2:2.8.0:2.8.0
\ No newline at end of file
+grpc-google-cloud-tpu-v2:2.8.0:2.8.0