chore: regenerate discoveryengine client (googleapis#23439)

Generated in GitHub action: https://togithub.com/googleapis/googleapis/google-api-java-client-services/actions/workflows/codegen.yaml

Author: yoshi-code-bot

clients/google-api-services-discoveryengine/v1/2.0.0/README.md

@@ -22,7 +22,7 @@ Add the following lines to your `pom.xml` file:
     <dependency>
       <groupId>com.google.apis</groupId>
       <artifactId>google-api-services-discoveryengine</artifactId>
-      <version>v1-rev20240906-2.0.0</version>
+      <version>v1-rev20240912-2.0.0</version>
     </dependency>
   </dependencies>
 </project>
@@ -35,7 +35,7 @@ repositories {
   mavenCentral()
 }
 dependencies {
-  implementation 'com.google.apis:google-api-services-discoveryengine:v1-rev20240906-2.0.0'
+  implementation 'com.google.apis:google-api-services-discoveryengine:v1-rev20240912-2.0.0'
 }
 ```
 

clients/google-api-services-discoveryengine/v1/2.0.0/com/google/api/services/discoveryengine/v1/model/GoogleCloudDiscoveryengineV1AnswerQueryRequestSearchSpecSearchResultListSearchResultUnstructuredDocumentInfo.java

@@ -37,14 +37,16 @@ public final class GoogleCloudDiscoveryengineV1AnswerQueryRequestSearchSpecSearc
   private java.lang.String document;
 
   /**
-   * List of document contexts.
+   * List of document contexts. The content will be used for Answer Generation. This is supposed to
+   * be the main content of the document that can be long and comprehensive.
    * The value may be {@code null}.
    */
   @com.google.api.client.util.Key
   private java.util.List<GoogleCloudDiscoveryengineV1AnswerQueryRequestSearchSpecSearchResultListSearchResultUnstructuredDocumentInfoDocumentContext> documentContexts;
 
   /**
-   * List of extractive answers.
+   * Deprecated: This field is deprecated and will have no effect on the Answer generation. Please
+   * use document_contexts and extractive_segments fields. List of extractive answers.
    * The value may be {@code null}.
    */
   @com.google.api.client.util.Key
@@ -89,15 +91,17 @@ public GoogleCloudDiscoveryengineV1AnswerQueryRequestSearchSpecSearchResultListS
   }
 
   /**
-   * List of document contexts.
+   * List of document contexts. The content will be used for Answer Generation. This is supposed to
+   * be the main content of the document that can be long and comprehensive.
    * @return value or {@code null} for none
    */
   public java.util.List<GoogleCloudDiscoveryengineV1AnswerQueryRequestSearchSpecSearchResultListSearchResultUnstructuredDocumentInfoDocumentContext> getDocumentContexts() {
     return documentContexts;
   }
 
   /**
-   * List of document contexts.
+   * List of document contexts. The content will be used for Answer Generation. This is supposed to
+   * be the main content of the document that can be long and comprehensive.
    * @param documentContexts documentContexts or {@code null} for none
    */
   public GoogleCloudDiscoveryengineV1AnswerQueryRequestSearchSpecSearchResultListSearchResultUnstructuredDocumentInfo setDocumentContexts(java.util.List<GoogleCloudDiscoveryengineV1AnswerQueryRequestSearchSpecSearchResultListSearchResultUnstructuredDocumentInfoDocumentContext> documentContexts) {
@@ -106,15 +110,17 @@ public GoogleCloudDiscoveryengineV1AnswerQueryRequestSearchSpecSearchResultListS
   }
 
   /**
-   * List of extractive answers.
+   * Deprecated: This field is deprecated and will have no effect on the Answer generation. Please
+   * use document_contexts and extractive_segments fields. List of extractive answers.
    * @return value or {@code null} for none
    */
   public java.util.List<GoogleCloudDiscoveryengineV1AnswerQueryRequestSearchSpecSearchResultListSearchResultUnstructuredDocumentInfoExtractiveAnswer> getExtractiveAnswers() {
     return extractiveAnswers;
   }
 
   /**
-   * List of extractive answers.
+   * Deprecated: This field is deprecated and will have no effect on the Answer generation. Please
+   * use document_contexts and extractive_segments fields. List of extractive answers.
    * @param extractiveAnswers extractiveAnswers or {@code null} for none
    */
   public GoogleCloudDiscoveryengineV1AnswerQueryRequestSearchSpecSearchResultListSearchResultUnstructuredDocumentInfo setExtractiveAnswers(java.util.List<GoogleCloudDiscoveryengineV1AnswerQueryRequestSearchSpecSearchResultListSearchResultUnstructuredDocumentInfoExtractiveAnswer> extractiveAnswers) {

clients/google-api-services-discoveryengine/v1/2.0.0/com/google/api/services/discoveryengine/v1/model/GoogleCloudDiscoveryengineV1AnswerQueryRequestSearchSpecSearchResultListSearchResultUnstructuredDocumentInfoDocumentContext.java

@@ -30,7 +30,7 @@
 public final class GoogleCloudDiscoveryengineV1AnswerQueryRequestSearchSpecSearchResultListSearchResultUnstructuredDocumentInfoDocumentContext extends com.google.api.client.json.GenericJson {
 
   /**
-   * Document content.
+   * Document content to be used for answer generation.
    * The value may be {@code null}.
    */
   @com.google.api.client.util.Key
@@ -44,15 +44,15 @@ public final class GoogleCloudDiscoveryengineV1AnswerQueryRequestSearchSpecSearc
   private java.lang.String pageIdentifier;
 
   /**
-   * Document content.
+   * Document content to be used for answer generation.
    * @return value or {@code null} for none
    */
   public java.lang.String getContent() {
     return content;
   }
 
   /**
-   * Document content.
+   * Document content to be used for answer generation.
    * @param content content or {@code null} for none
    */
   public GoogleCloudDiscoveryengineV1AnswerQueryRequestSearchSpecSearchResultListSearchResultUnstructuredDocumentInfoDocumentContext setContent(java.lang.String content) {

clients/google-api-services-discoveryengine/v1/2.0.0/com/google/api/services/discoveryengine/v1/model/GoogleCloudDiscoveryengineV1AnswerQueryRequestSearchSpecSearchResultListSearchResultUnstructuredDocumentInfoExtractiveSegment.java

@@ -18,7 +18,8 @@
 
 /**
  * Extractive segment. [Guide](https://cloud.google.com/generative-ai-app-
- * builder/docs/snippets#extractive-segments)
+ * builder/docs/snippets#extractive-segments) Answer generation will only use it if
+ * document_contexts is empty. This is supposed to be shorter snippets.
  *
  * <p> This is the Java data model class that specifies how to parse/serialize into the JSON that is
  * transmitted over HTTP when working with the Discovery Engine API. For a detailed explanation see:

clients/google-api-services-discoveryengine/v1/2.0.0/pom.xml

@@ -8,8 +8,8 @@
 
   <groupId>com.google.apis</groupId>
   <artifactId>google-api-services-discoveryengine</artifactId>
-  <version>v1-rev20240906-2.0.0</version>
-  <name>Discovery Engine API v1-rev20240906-2.0.0</name>
+  <version>v1-rev20240912-2.0.0</version>
+  <name>Discovery Engine API v1-rev20240912-2.0.0</name>
   <packaging>jar</packaging>
 
   <inceptionYear>2011</inceptionYear>

clients/google-api-services-discoveryengine/v1/README.md

@@ -22,7 +22,7 @@ Add the following lines to your `pom.xml` file:
     <dependency>
       <groupId>com.google.apis</groupId>
       <artifactId>google-api-services-discoveryengine</artifactId>
-      <version>v1-rev20240906-2.0.0</version>
+      <version>v1-rev20240912-2.0.0</version>
     </dependency>
   </dependencies>
 </project>
@@ -35,7 +35,7 @@ repositories {
   mavenCentral()
 }
 dependencies {
-  implementation 'com.google.apis:google-api-services-discoveryengine:v1-rev20240906-2.0.0'
+  implementation 'com.google.apis:google-api-services-discoveryengine:v1-rev20240912-2.0.0'
 }
 ```
 

clients/google-api-services-discoveryengine/v1alpha/2.0.0/README.md

@@ -22,7 +22,7 @@ Add the following lines to your `pom.xml` file:
     <dependency>
       <groupId>com.google.apis</groupId>
       <artifactId>google-api-services-discoveryengine</artifactId>
-      <version>v1alpha-rev20240906-2.0.0</version>
+      <version>v1alpha-rev20240912-2.0.0</version>
     </dependency>
   </dependencies>
 </project>
@@ -35,7 +35,7 @@ repositories {
   mavenCentral()
 }
 dependencies {
-  implementation 'com.google.apis:google-api-services-discoveryengine:v1alpha-rev20240906-2.0.0'
+  implementation 'com.google.apis:google-api-services-discoveryengine:v1alpha-rev20240912-2.0.0'
 }
 ```
 

clients/google-api-services-discoveryengine/v1alpha/2.0.0/com/google/api/services/discoveryengine/v1alpha/model/GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestSearchSpecSearchResultListSearchResultUnstructuredDocumentInfo.java

@@ -37,14 +37,16 @@ public final class GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestSearchSpec
   private java.lang.String document;
 
   /**
-   * List of document contexts.
+   * List of document contexts. The content will be used for Answer Generation. This is supposed to
+   * be the main content of the document that can be long and comprehensive.
    * The value may be {@code null}.
    */
   @com.google.api.client.util.Key
   private java.util.List<GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestSearchSpecSearchResultListSearchResultUnstructuredDocumentInfoDocumentContext> documentContexts;
 
   /**
-   * List of extractive answers.
+   * Deprecated: This field is deprecated and will have no effect on the Answer generation. Please
+   * use document_contexts and extractive_segments fields. List of extractive answers.
    * The value may be {@code null}.
    */
   @com.google.api.client.util.Key
@@ -89,15 +91,17 @@ public GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestSearchSpecSearchResult
   }
 
   /**
-   * List of document contexts.
+   * List of document contexts. The content will be used for Answer Generation. This is supposed to
+   * be the main content of the document that can be long and comprehensive.
    * @return value or {@code null} for none
    */
   public java.util.List<GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestSearchSpecSearchResultListSearchResultUnstructuredDocumentInfoDocumentContext> getDocumentContexts() {
     return documentContexts;
   }
 
   /**
-   * List of document contexts.
+   * List of document contexts. The content will be used for Answer Generation. This is supposed to
+   * be the main content of the document that can be long and comprehensive.
    * @param documentContexts documentContexts or {@code null} for none
    */
   public GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestSearchSpecSearchResultListSearchResultUnstructuredDocumentInfo setDocumentContexts(java.util.List<GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestSearchSpecSearchResultListSearchResultUnstructuredDocumentInfoDocumentContext> documentContexts) {
@@ -106,15 +110,17 @@ public GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestSearchSpecSearchResult
   }
 
   /**
-   * List of extractive answers.
+   * Deprecated: This field is deprecated and will have no effect on the Answer generation. Please
+   * use document_contexts and extractive_segments fields. List of extractive answers.
    * @return value or {@code null} for none
    */
   public java.util.List<GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestSearchSpecSearchResultListSearchResultUnstructuredDocumentInfoExtractiveAnswer> getExtractiveAnswers() {
     return extractiveAnswers;
   }
 
   /**
-   * List of extractive answers.
+   * Deprecated: This field is deprecated and will have no effect on the Answer generation. Please
+   * use document_contexts and extractive_segments fields. List of extractive answers.
    * @param extractiveAnswers extractiveAnswers or {@code null} for none
    */
   public GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestSearchSpecSearchResultListSearchResultUnstructuredDocumentInfo setExtractiveAnswers(java.util.List<GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestSearchSpecSearchResultListSearchResultUnstructuredDocumentInfoExtractiveAnswer> extractiveAnswers) {

clients/google-api-services-discoveryengine/v1alpha/2.0.0/com/google/api/services/discoveryengine/v1alpha/model/GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestSearchSpecSearchResultListSearchResultUnstructuredDocumentInfoDocumentContext.java

@@ -30,7 +30,7 @@
 public final class GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestSearchSpecSearchResultListSearchResultUnstructuredDocumentInfoDocumentContext extends com.google.api.client.json.GenericJson {
 
   /**
-   * Document content.
+   * Document content to be used for answer generation.
    * The value may be {@code null}.
    */
   @com.google.api.client.util.Key
@@ -44,15 +44,15 @@ public final class GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestSearchSpec
   private java.lang.String pageIdentifier;
 
   /**
-   * Document content.
+   * Document content to be used for answer generation.
    * @return value or {@code null} for none
    */
   public java.lang.String getContent() {
     return content;
   }
 
   /**
-   * Document content.
+   * Document content to be used for answer generation.
    * @param content content or {@code null} for none
    */
   public GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestSearchSpecSearchResultListSearchResultUnstructuredDocumentInfoDocumentContext setContent(java.lang.String content) {

clients/google-api-services-discoveryengine/v1alpha/2.0.0/com/google/api/services/discoveryengine/v1alpha/model/GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestSearchSpecSearchResultListSearchResultUnstructuredDocumentInfoExtractiveSegment.java

@@ -18,7 +18,8 @@
 
 /**
  * Extractive segment. [Guide](https://cloud.google.com/generative-ai-app-
- * builder/docs/snippets#extractive-segments)
+ * builder/docs/snippets#extractive-segments) Answer generation will only use it if
+ * document_contexts is empty. This is supposed to be shorter snippets.
  *
  * <p> This is the Java data model class that specifies how to parse/serialize into the JSON that is
  * transmitted over HTTP when working with the Discovery Engine API. For a detailed explanation see: