feat: [retail] support async write mode for WriteUserEvent API (#8918)

- [ ] Regenerate this pull request now.

feat: support collect and import GA4 event format with prebuilt whistle rule
feat: support exact searchable and retrievable in catalog attribute config
feat: deprecate retrievable_fields in product attribute
feat: support diversity type in serving config
feat: allow set feed id in merchant center link
feat: support data output to GCS
docs: keep the API doc up-to-date with recent changes

PiperOrigin-RevId: 495893148

Source-Link: https://togithub.com/googleapis/googleapis/commit/02dcec304088c964f198d7732e9c1d441d72d2db

Source-Link: https://togithub.com/googleapis/googleapis-gen/commit/996aa46fe482ef807a33b56d15b28ad55fbac7b9
Copy-Tag: eyJwIjoiamF2YS1yZXRhaWwvLk93bEJvdC55YW1sIiwiaCI6Ijk5NmFhNDZmZTQ4MmVmODA3YTMzYjU2ZDE1YjI4YWQ1NWZiYWM3YjkifQ==

BEGIN_NESTED_COMMIT
feat: [retail] support async write mode for WriteUserEvent API
feat: support collect GA4 event format with prebuilt whistle rule
feat: support exact searchable and retrievable in catalog attribute config
feat: deprecate retrievable_fields in product attribute
feat: support diversity type in serving config
docs: keep the API doc up-to-date with recent changes

PiperOrigin-RevId: 495660792

Source-Link: https://togithub.com/googleapis/googleapis/commit/0dbe50f7605520f48f0ce2f4359c1460391b5820

Source-Link: https://togithub.com/googleapis/googleapis-gen/commit/59b8ced066ba19657e06d78c201e620ca6ab79c2
Copy-Tag: eyJwIjoiamF2YS1yZXRhaWwvLk93bEJvdC55YW1sIiwiaCI6IjU5YjhjZWQwNjZiYTE5NjU3ZTA2ZDc4YzIwMWU2MjBjYTZhYjc5YzIifQ==
END_NESTED_COMMIT
BEGIN_NESTED_COMMIT
feat: [retail] support async write mode for WriteUserEvent API
feat: support collect and import GA4 event format with prebuilt whistle rule
feat: support exact searchable and retrievable in catalog attribute config
feat: deprecate retrievable_fields in product attribute
feat: support diversity type in serving config
feat: allow set feed id in merchant center link
feat: support batch remove catalog attribute config
feat: support attribute suggestion in autocomplete
feat: support data output to GCS
feat: expose the local inventory data in product data retrieval
feat: return personal product labels in search response
docs: keep the API doc up-to-date with recent changes

PiperOrigin-RevId: 495450955

Source-Link: https://togithub.com/googleapis/googleapis/commit/4e4e58c442ca9f7b08b36bb8788c0d63ef70484e

Source-Link: https://togithub.com/googleapis/googleapis-gen/commit/c8c05bffff889a77614526e4d3b90d41c75c31bc
Copy-Tag: eyJwIjoiamF2YS1yZXRhaWwvLk93bEJvdC55YW1sIiwiaCI6ImM4YzA1YmZmZmY4ODlhNzc2MTQ1MjZlNGQzYjkwZDQxYzc1YzMxYmMifQ==
END_NESTED_COMMIT

java-retail/README.md

@@ -19,20 +19,20 @@ If you are using Maven, add this to your pom.xml file:
 <dependency>
   <groupId>com.google.cloud</groupId>
   <artifactId>google-cloud-retail</artifactId>
-  <version>2.8.0</version>
+  <version>2.9.0</version>
 </dependency>
 ```
 
 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

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
    * }</pre>
    *
    * @param name Required. Full CompletionConfig resource name. Format:
-   *     projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/completionConfig
+   *     `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/completionConfig`
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   public final CompletionConfig getCompletionConfig(CompletionConfigName name) {
@@ -844,7 +844,7 @@ public final CompletionConfig getCompletionConfig(CompletionConfigName name) {
    * }</pre>
    *
    * @param name Required. Full CompletionConfig resource name. Format:
-   *     projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/completionConfig
+   *     `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/completionConfig`
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   public final CompletionConfig getCompletionConfig(String name) {

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.
  *
- * <p>This feature is only available for users who have Retail Search enabled. Please enable Retail
- * Search on Cloud Console before using this feature.
+ * <p>This feature is only available for users who have Retail Search enabled. Enable Retail Search
+ * on Cloud Console before using this feature.
  *
  * <p>This class provides the ability to make remote calls to the backing service through method
  * calls that map to API methods. Sample code to get started:
@@ -213,8 +213,8 @@ public final OperationsClient getHttpJsonOperationsClient() {
   /**
    * Completes the specified prefix with keyword suggestions.
    *
-   * <p>This feature is only available for users who have Retail Search enabled. Please enable
-   * Retail Search on Cloud Console before using this feature.
+   * <p>This feature is only available for users who have Retail Search enabled. Enable Retail
+   * Search on Cloud Console before using this feature.
    *
    * <p>Sample code:
    *
@@ -250,8 +250,8 @@ public final CompleteQueryResponse completeQuery(CompleteQueryRequest request) {
   /**
    * Completes the specified prefix with keyword suggestions.
    *
-   * <p>This feature is only available for users who have Retail Search enabled. Please enable
-   * Retail Search on Cloud Console before using this feature.
+   * <p>This feature is only available for users who have Retail Search enabled. Enable Retail
+   * Search on Cloud Console before using this feature.
    *
    * <p>Sample code:
    *
@@ -292,8 +292,8 @@ public final UnaryCallable<CompleteQueryRequest, CompleteQueryResponse> complete
    * <p>The operation is successfully finished only after the imported suggestions are indexed
    * successfully and ready for serving. The process takes hours.
    *
-   * <p>This feature is only available for users who have Retail Search enabled. Please enable
-   * Retail Search on Cloud Console before using this feature.
+   * <p>This feature is only available for users who have Retail Search enabled. Enable Retail
+   * Search on Cloud Console before using this feature.
    *
    * <p>Sample code:
    *
@@ -332,8 +332,8 @@ public final UnaryCallable<CompleteQueryRequest, CompleteQueryResponse> complete
    * <p>The operation is successfully finished only after the imported suggestions are indexed
    * successfully and ready for serving. The process takes hours.
    *
-   * <p>This feature is only available for users who have Retail Search enabled. Please enable
-   * Retail Search on Cloud Console before using this feature.
+   * <p>This feature is only available for users who have Retail Search enabled. Enable Retail
+   * Search on Cloud Console before using this feature.
    *
    * <p>Sample code:
    *
@@ -372,8 +372,8 @@ public final UnaryCallable<CompleteQueryRequest, CompleteQueryResponse> complete
    * <p>The operation is successfully finished only after the imported suggestions are indexed
    * successfully and ready for serving. The process takes hours.
    *
-   * <p>This feature is only available for users who have Retail Search enabled. Please enable
-   * Retail Search on Cloud Console before using this feature.
+   * <p>This feature is only available for users who have Retail Search enabled. Enable Retail
+   * Search on Cloud Console before using this feature.
    *
    * <p>Sample code:
    *