feat(discoveryengine): update the api

#### discoveryengine:v1

The following keys were added:
- schemas.GoogleCloudDiscoveryengineV1AnswerQueryRequestQueryUnderstandingSpec.properties.disableSpellCorrection.type (Total Keys: 1)
- schemas.GoogleCloudDiscoveryengineV1SearchRequest.properties.displaySpec.$ref (Total Keys: 1)
- schemas.GoogleCloudDiscoveryengineV1SearchRequestDisplaySpec (Total Keys: 3)
- schemas.GoogleCloudDiscoveryengineV1alphaAlertPolicyConfig (Total Keys: 9)
- schemas.GoogleCloudDiscoveryengineV1alphaDataConnector.properties.alertPolicyConfigs (Total Keys: 2)
- schemas.GoogleCloudDiscoveryengineV1betaSearchRequest.properties.displaySpec.$ref (Total Keys: 1)
- schemas.GoogleCloudDiscoveryengineV1betaSearchRequestDisplaySpec (Total Keys: 3)

#### discoveryengine:v1alpha

The following keys were added:
- schemas.GoogleCloudDiscoveryengineV1alphaAlertPolicyConfig (Total Keys: 9)
- schemas.GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestQueryUnderstandingSpec.properties.disableSpellCorrection.type (Total Keys: 1)
- schemas.GoogleCloudDiscoveryengineV1alphaDataConnector.properties.alertPolicyConfigs (Total Keys: 2)
- schemas.GoogleCloudDiscoveryengineV1alphaWidgetConfigAccessSettings.properties.languageCode.type (Total Keys: 1)
- schemas.GoogleCloudDiscoveryengineV1betaSearchRequest.properties.displaySpec.$ref (Total Keys: 1)
- schemas.GoogleCloudDiscoveryengineV1betaSearchRequestDisplaySpec (Total Keys: 3)

#### discoveryengine:v1beta

The following keys were added:
- schemas.GoogleCloudDiscoveryengineV1alphaAlertPolicyConfig (Total Keys: 9)
- schemas.GoogleCloudDiscoveryengineV1alphaDataConnector.properties.alertPolicyConfigs (Total Keys: 2)
- schemas.GoogleCloudDiscoveryengineV1betaAnswerQueryRequestQueryUnderstandingSpec.properties.disableSpellCorrection.type (Total Keys: 1)
- schemas.GoogleCloudDiscoveryengineV1betaSearchRequest.properties.displaySpec.$ref (Total Keys: 1)
- schemas.GoogleCloudDiscoveryengineV1betaSearchRequestDisplaySpec (Total Keys: 3)

Author: yoshi-automation

docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.controls.html

@@ -161,7 +161,7 @@ <h3>Method Details</h3>
       &quot;enabled&quot;: True or False, # Optional. The enabled promotion will be returned for any serving configs associated with the parent of the control this promotion is attached to. This flag is used for basic site search only.
       &quot;imageUri&quot;: &quot;A String&quot;, # Optional. The promotion thumbnail image url.
       &quot;title&quot;: &quot;A String&quot;, # Required. The title of the promotion. Maximum length: 160 characters.
-      &quot;uri&quot;: &quot;A String&quot;, # Required. The URL for the page the user wants to promote.
+      &quot;uri&quot;: &quot;A String&quot;, # Optional. The URL for the page the user wants to promote. Must be set for site search. For other verticals, this is optional.
     },
   },
   &quot;redirectAction&quot;: { # Redirects a shopper to the provided URI. # Defines a redirect-type control.
@@ -238,7 +238,7 @@ <h3>Method Details</h3>
       &quot;enabled&quot;: True or False, # Optional. The enabled promotion will be returned for any serving configs associated with the parent of the control this promotion is attached to. This flag is used for basic site search only.
       &quot;imageUri&quot;: &quot;A String&quot;, # Optional. The promotion thumbnail image url.
       &quot;title&quot;: &quot;A String&quot;, # Required. The title of the promotion. Maximum length: 160 characters.
-      &quot;uri&quot;: &quot;A String&quot;, # Required. The URL for the page the user wants to promote.
+      &quot;uri&quot;: &quot;A String&quot;, # Optional. The URL for the page the user wants to promote. Must be set for site search. For other verticals, this is optional.
     },
   },
   &quot;redirectAction&quot;: { # Redirects a shopper to the provided URI. # Defines a redirect-type control.
@@ -339,7 +339,7 @@ <h3>Method Details</h3>
       &quot;enabled&quot;: True or False, # Optional. The enabled promotion will be returned for any serving configs associated with the parent of the control this promotion is attached to. This flag is used for basic site search only.
       &quot;imageUri&quot;: &quot;A String&quot;, # Optional. The promotion thumbnail image url.
       &quot;title&quot;: &quot;A String&quot;, # Required. The title of the promotion. Maximum length: 160 characters.
-      &quot;uri&quot;: &quot;A String&quot;, # Required. The URL for the page the user wants to promote.
+      &quot;uri&quot;: &quot;A String&quot;, # Optional. The URL for the page the user wants to promote. Must be set for site search. For other verticals, this is optional.
     },
   },
   &quot;redirectAction&quot;: { # Redirects a shopper to the provided URI. # Defines a redirect-type control.
@@ -427,7 +427,7 @@ <h3>Method Details</h3>
           &quot;enabled&quot;: True or False, # Optional. The enabled promotion will be returned for any serving configs associated with the parent of the control this promotion is attached to. This flag is used for basic site search only.
           &quot;imageUri&quot;: &quot;A String&quot;, # Optional. The promotion thumbnail image url.
           &quot;title&quot;: &quot;A String&quot;, # Required. The title of the promotion. Maximum length: 160 characters.
-          &quot;uri&quot;: &quot;A String&quot;, # Required. The URL for the page the user wants to promote.
+          &quot;uri&quot;: &quot;A String&quot;, # Optional. The URL for the page the user wants to promote. Must be set for site search. For other verticals, this is optional.
         },
       },
       &quot;redirectAction&quot;: { # Redirects a shopper to the provided URI. # Defines a redirect-type control.
@@ -522,7 +522,7 @@ <h3>Method Details</h3>
       &quot;enabled&quot;: True or False, # Optional. The enabled promotion will be returned for any serving configs associated with the parent of the control this promotion is attached to. This flag is used for basic site search only.
       &quot;imageUri&quot;: &quot;A String&quot;, # Optional. The promotion thumbnail image url.
       &quot;title&quot;: &quot;A String&quot;, # Required. The title of the promotion. Maximum length: 160 characters.
-      &quot;uri&quot;: &quot;A String&quot;, # Required. The URL for the page the user wants to promote.
+      &quot;uri&quot;: &quot;A String&quot;, # Optional. The URL for the page the user wants to promote. Must be set for site search. For other verticals, this is optional.
     },
   },
   &quot;redirectAction&quot;: { # Redirects a shopper to the provided URI. # Defines a redirect-type control.
@@ -599,7 +599,7 @@ <h3>Method Details</h3>
       &quot;enabled&quot;: True or False, # Optional. The enabled promotion will be returned for any serving configs associated with the parent of the control this promotion is attached to. This flag is used for basic site search only.
       &quot;imageUri&quot;: &quot;A String&quot;, # Optional. The promotion thumbnail image url.
       &quot;title&quot;: &quot;A String&quot;, # Required. The title of the promotion. Maximum length: 160 characters.
-      &quot;uri&quot;: &quot;A String&quot;, # Required. The URL for the page the user wants to promote.
+      &quot;uri&quot;: &quot;A String&quot;, # Optional. The URL for the page the user wants to promote. Must be set for site search. For other verticals, this is optional.
     },
   },
   &quot;redirectAction&quot;: { # Redirects a shopper to the provided URI. # Defines a redirect-type control.

docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.servingConfigs.html

@@ -148,6 +148,7 @@ <h3>Method Details</h3>
     &quot;text&quot;: &quot;A String&quot;, # Plain text.
   },
   &quot;queryUnderstandingSpec&quot;: { # Query understanding specification. # Query understanding specification.
+    &quot;disableSpellCorrection&quot;: True or False, # Optional. Whether to disable spell correction. The default value is `false`.
     &quot;queryClassificationSpec&quot;: { # Query classification specification. # Query classification specification.
       &quot;types&quot;: [ # Enabled query classification types.
         &quot;A String&quot;,
@@ -1043,6 +1044,9 @@ <h3>Method Details</h3>
       &quot;filter&quot;: &quot;A String&quot;, # Optional. Filter specification to filter documents in the data store specified by data_store field. For more information on filtering, see [Filtering](https://cloud.google.com/generative-ai-app-builder/docs/filter-search-metadata)
     },
   ],
+  &quot;displaySpec&quot;: { # Specifies features for display, like match highlighting. # Optional. Config for display feature, like match highlighting on search results.
+    &quot;matchHighlightingCondition&quot;: &quot;A String&quot;, # The condition under which match highlighting should occur.
+  },
   &quot;facetSpecs&quot;: [ # Facet specifications for faceted search. If empty, no facets are returned. A maximum of 100 values are allowed. Otherwise, an `INVALID_ARGUMENT` error is returned.
     { # A facet specification to perform faceted search.
       &quot;enableDynamicPosition&quot;: True or False, # Enables dynamic position for this facet. If set to true, the position of this facet among all facets in the response is determined automatically. If dynamic facets are enabled, it is ordered together. If set to false, the position of this facet in the response is the same as in the request, and it is ranked before the facets with dynamic position enable and all dynamic facets. For example, you may always want to have rating facet returned in the response, but it&#x27;s not necessarily to always display the rating facet at the top. In that case, you can set enable_dynamic_position to true so that the position of rating facet in response is determined automatically. Another example, assuming you have the following facets in the request: * &quot;rating&quot;, enable_dynamic_position = true * &quot;price&quot;, enable_dynamic_position = false * &quot;brands&quot;, enable_dynamic_position = false And also you have a dynamic facets enabled, which generates a facet `gender`. Then the final order of the facets in the response can be (&quot;price&quot;, &quot;brands&quot;, &quot;rating&quot;, &quot;gender&quot;) or (&quot;price&quot;, &quot;brands&quot;, &quot;gender&quot;, &quot;rating&quot;) depends on how API orders &quot;gender&quot; and &quot;rating&quot; facets. However, notice that &quot;price&quot; and &quot;brands&quot; are always ranked at first and second position because their enable_dynamic_position is false.
@@ -1233,7 +1237,7 @@ <h3>Method Details</h3>
       &quot;enabled&quot;: True or False, # Optional. The enabled promotion will be returned for any serving configs associated with the parent of the control this promotion is attached to. This flag is used for basic site search only.
       &quot;imageUri&quot;: &quot;A String&quot;, # Optional. The promotion thumbnail image url.
       &quot;title&quot;: &quot;A String&quot;, # Required. The title of the promotion. Maximum length: 160 characters.
-      &quot;uri&quot;: &quot;A String&quot;, # Required. The URL for the page the user wants to promote.
+      &quot;uri&quot;: &quot;A String&quot;, # Optional. The URL for the page the user wants to promote. Must be set for site search. For other verticals, this is optional.
     },
   ],
   &quot;sessionInfo&quot;: { # Information about the session. # Session information. Only set if SearchRequest.session is provided. See its description for more details.
@@ -1378,6 +1382,9 @@ <h3>Method Details</h3>
       &quot;filter&quot;: &quot;A String&quot;, # Optional. Filter specification to filter documents in the data store specified by data_store field. For more information on filtering, see [Filtering](https://cloud.google.com/generative-ai-app-builder/docs/filter-search-metadata)
     },
   ],
+  &quot;displaySpec&quot;: { # Specifies features for display, like match highlighting. # Optional. Config for display feature, like match highlighting on search results.
+    &quot;matchHighlightingCondition&quot;: &quot;A String&quot;, # The condition under which match highlighting should occur.
+  },
   &quot;facetSpecs&quot;: [ # Facet specifications for faceted search. If empty, no facets are returned. A maximum of 100 values are allowed. Otherwise, an `INVALID_ARGUMENT` error is returned.
     { # A facet specification to perform faceted search.
       &quot;enableDynamicPosition&quot;: True or False, # Enables dynamic position for this facet. If set to true, the position of this facet among all facets in the response is determined automatically. If dynamic facets are enabled, it is ordered together. If set to false, the position of this facet in the response is the same as in the request, and it is ranked before the facets with dynamic position enable and all dynamic facets. For example, you may always want to have rating facet returned in the response, but it&#x27;s not necessarily to always display the rating facet at the top. In that case, you can set enable_dynamic_position to true so that the position of rating facet in response is determined automatically. Another example, assuming you have the following facets in the request: * &quot;rating&quot;, enable_dynamic_position = true * &quot;price&quot;, enable_dynamic_position = false * &quot;brands&quot;, enable_dynamic_position = false And also you have a dynamic facets enabled, which generates a facet `gender`. Then the final order of the facets in the response can be (&quot;price&quot;, &quot;brands&quot;, &quot;rating&quot;, &quot;gender&quot;) or (&quot;price&quot;, &quot;brands&quot;, &quot;gender&quot;, &quot;rating&quot;) depends on how API orders &quot;gender&quot; and &quot;rating&quot; facets. However, notice that &quot;price&quot; and &quot;brands&quot; are always ranked at first and second position because their enable_dynamic_position is false.
@@ -1568,7 +1575,7 @@ <h3>Method Details</h3>
       &quot;enabled&quot;: True or False, # Optional. The enabled promotion will be returned for any serving configs associated with the parent of the control this promotion is attached to. This flag is used for basic site search only.
       &quot;imageUri&quot;: &quot;A String&quot;, # Optional. The promotion thumbnail image url.
       &quot;title&quot;: &quot;A String&quot;, # Required. The title of the promotion. Maximum length: 160 characters.
-      &quot;uri&quot;: &quot;A String&quot;, # Required. The URL for the page the user wants to promote.
+      &quot;uri&quot;: &quot;A String&quot;, # Optional. The URL for the page the user wants to promote. Must be set for site search. For other verticals, this is optional.
     },
   ],
   &quot;sessionInfo&quot;: { # Information about the session. # Session information. Only set if SearchRequest.session is provided. See its description for more details.
@@ -1696,6 +1703,7 @@ <h3>Method Details</h3>
     &quot;text&quot;: &quot;A String&quot;, # Plain text.
   },
   &quot;queryUnderstandingSpec&quot;: { # Query understanding specification. # Query understanding specification.
+    &quot;disableSpellCorrection&quot;: True or False, # Optional. Whether to disable spell correction. The default value is `false`.
     &quot;queryClassificationSpec&quot;: { # Query classification specification. # Query classification specification.
       &quot;types&quot;: [ # Enabled query classification types.
         &quot;A String&quot;,

docs/dyn/discoveryengine_v1.projects.locations.collections.engines.controls.html

@@ -161,7 +161,7 @@ <h3>Method Details</h3>
       &quot;enabled&quot;: True or False, # Optional. The enabled promotion will be returned for any serving configs associated with the parent of the control this promotion is attached to. This flag is used for basic site search only.
       &quot;imageUri&quot;: &quot;A String&quot;, # Optional. The promotion thumbnail image url.
       &quot;title&quot;: &quot;A String&quot;, # Required. The title of the promotion. Maximum length: 160 characters.
-      &quot;uri&quot;: &quot;A String&quot;, # Required. The URL for the page the user wants to promote.
+      &quot;uri&quot;: &quot;A String&quot;, # Optional. The URL for the page the user wants to promote. Must be set for site search. For other verticals, this is optional.
     },
   },
   &quot;redirectAction&quot;: { # Redirects a shopper to the provided URI. # Defines a redirect-type control.
@@ -238,7 +238,7 @@ <h3>Method Details</h3>
       &quot;enabled&quot;: True or False, # Optional. The enabled promotion will be returned for any serving configs associated with the parent of the control this promotion is attached to. This flag is used for basic site search only.
       &quot;imageUri&quot;: &quot;A String&quot;, # Optional. The promotion thumbnail image url.
       &quot;title&quot;: &quot;A String&quot;, # Required. The title of the promotion. Maximum length: 160 characters.
-      &quot;uri&quot;: &quot;A String&quot;, # Required. The URL for the page the user wants to promote.
+      &quot;uri&quot;: &quot;A String&quot;, # Optional. The URL for the page the user wants to promote. Must be set for site search. For other verticals, this is optional.
     },
   },
   &quot;redirectAction&quot;: { # Redirects a shopper to the provided URI. # Defines a redirect-type control.
@@ -339,7 +339,7 @@ <h3>Method Details</h3>
       &quot;enabled&quot;: True or False, # Optional. The enabled promotion will be returned for any serving configs associated with the parent of the control this promotion is attached to. This flag is used for basic site search only.
       &quot;imageUri&quot;: &quot;A String&quot;, # Optional. The promotion thumbnail image url.
       &quot;title&quot;: &quot;A String&quot;, # Required. The title of the promotion. Maximum length: 160 characters.
-      &quot;uri&quot;: &quot;A String&quot;, # Required. The URL for the page the user wants to promote.
+      &quot;uri&quot;: &quot;A String&quot;, # Optional. The URL for the page the user wants to promote. Must be set for site search. For other verticals, this is optional.
     },
   },
   &quot;redirectAction&quot;: { # Redirects a shopper to the provided URI. # Defines a redirect-type control.
@@ -427,7 +427,7 @@ <h3>Method Details</h3>
           &quot;enabled&quot;: True or False, # Optional. The enabled promotion will be returned for any serving configs associated with the parent of the control this promotion is attached to. This flag is used for basic site search only.
           &quot;imageUri&quot;: &quot;A String&quot;, # Optional. The promotion thumbnail image url.
           &quot;title&quot;: &quot;A String&quot;, # Required. The title of the promotion. Maximum length: 160 characters.
-          &quot;uri&quot;: &quot;A String&quot;, # Required. The URL for the page the user wants to promote.
+          &quot;uri&quot;: &quot;A String&quot;, # Optional. The URL for the page the user wants to promote. Must be set for site search. For other verticals, this is optional.
         },
       },
       &quot;redirectAction&quot;: { # Redirects a shopper to the provided URI. # Defines a redirect-type control.
@@ -522,7 +522,7 @@ <h3>Method Details</h3>
       &quot;enabled&quot;: True or False, # Optional. The enabled promotion will be returned for any serving configs associated with the parent of the control this promotion is attached to. This flag is used for basic site search only.
       &quot;imageUri&quot;: &quot;A String&quot;, # Optional. The promotion thumbnail image url.
       &quot;title&quot;: &quot;A String&quot;, # Required. The title of the promotion. Maximum length: 160 characters.
-      &quot;uri&quot;: &quot;A String&quot;, # Required. The URL for the page the user wants to promote.
+      &quot;uri&quot;: &quot;A String&quot;, # Optional. The URL for the page the user wants to promote. Must be set for site search. For other verticals, this is optional.
     },
   },
   &quot;redirectAction&quot;: { # Redirects a shopper to the provided URI. # Defines a redirect-type control.
@@ -599,7 +599,7 @@ <h3>Method Details</h3>
       &quot;enabled&quot;: True or False, # Optional. The enabled promotion will be returned for any serving configs associated with the parent of the control this promotion is attached to. This flag is used for basic site search only.
       &quot;imageUri&quot;: &quot;A String&quot;, # Optional. The promotion thumbnail image url.
       &quot;title&quot;: &quot;A String&quot;, # Required. The title of the promotion. Maximum length: 160 characters.
-      &quot;uri&quot;: &quot;A String&quot;, # Required. The URL for the page the user wants to promote.
+      &quot;uri&quot;: &quot;A String&quot;, # Optional. The URL for the page the user wants to promote. Must be set for site search. For other verticals, this is optional.
     },
   },
   &quot;redirectAction&quot;: { # Redirects a shopper to the provided URI. # Defines a redirect-type control.