feat(discoveryengine): update the api

#### discoveryengine:v1

The following keys were added:
- schemas.GoogleCloudDiscoveryengineV1Chunk.properties.annotationContents (Total Keys: 3)
- schemas.GoogleCloudDiscoveryengineV1SearchLinkPromotion.properties.document.type (Total Keys: 1)
- schemas.GoogleCloudDiscoveryengineV1alphaSearchLinkPromotion.properties.document.type (Total Keys: 1)
- schemas.GoogleCloudDiscoveryengineV1betaSearchLinkPromotion.properties.document.type (Total Keys: 1)

#### discoveryengine:v1alpha

The following keys were added:
- resources.projects.resources.locations.resources.collections.resources.dataConnector.methods.getConnectorSecret (Total Keys: 11)
- resources.projects.resources.locations.resources.collections.resources.dataStores.resources.branches.resources.documents.methods.getProcessedDocument.parameters.imageId (Total Keys: 2)
- resources.projects.resources.locations.resources.dataStores.resources.branches.resources.documents.methods.getProcessedDocument.parameters.imageId (Total Keys: 2)
- schemas.GoogleCloudDiscoveryengineV1SearchLinkPromotion.properties.document.type (Total Keys: 1)
- schemas.GoogleCloudDiscoveryengineV1alphaChunk.properties.annotationContents (Total Keys: 3)
- schemas.GoogleCloudDiscoveryengineV1alphaGetConnectorSecretResponse (Total Keys: 7)
- schemas.GoogleCloudDiscoveryengineV1alphaSearchLinkPromotion.properties.document.type (Total Keys: 1)
- schemas.GoogleCloudDiscoveryengineV1betaSearchLinkPromotion.properties.document.type (Total Keys: 1)

#### discoveryengine:v1beta

The following keys were added:
- schemas.GoogleCloudDiscoveryengineV1SearchLinkPromotion.properties.document.type (Total Keys: 1)
- schemas.GoogleCloudDiscoveryengineV1alphaSearchLinkPromotion.properties.document.type (Total Keys: 1)
- schemas.GoogleCloudDiscoveryengineV1betaChunk.properties.annotationContents (Total Keys: 3)
- schemas.GoogleCloudDiscoveryengineV1betaSearchLinkPromotion.properties.document.type (Total Keys: 1)

Author: yoshi-automation

docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.branches.documents.html

@@ -139,7 +139,7 @@ <h3>Method Details</h3>
           &quot;startTime&quot;: &quot;A String&quot;, # Start of time range. Range is inclusive.
         },
       ],
-      &quot;queryRegex&quot;: &quot;A String&quot;, # Optional. Query regex to match the whole search query. Cannot be set when Condition.query_terms is set. This is currently supporting promotion use case.
+      &quot;queryRegex&quot;: &quot;A String&quot;, # Optional. Query regex to match the whole search query. Cannot be set when Condition.query_terms is set. Only supported for Basic Site Search promotion serving controls.
       &quot;queryTerms&quot;: [ # Search only A list of terms to match the query on. Cannot be set when Condition.query_regex is set. Maximum of 10 query terms.
         { # Matcher for search request query
           &quot;fullMatch&quot;: True or False, # Whether the search query needs to exactly match the query term.
@@ -158,6 +158,7 @@ <h3>Method Details</h3>
     &quot;dataStore&quot;: &quot;A String&quot;, # Required. Data store with which this promotion is attached to.
     &quot;searchLinkPromotion&quot;: { # Promotion proto includes uri and other helping information to display the promotion. # Required. Promotion attached to this action.
       &quot;description&quot;: &quot;A String&quot;, # Optional. The Promotion description. Maximum length: 200 characters.
+      &quot;document&quot;: &quot;A String&quot;, # Optional. The Document the user wants to promote. For site search, leave unset and only populate uri. Can be set along with uri.
       &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.
@@ -216,7 +217,7 @@ <h3>Method Details</h3>
           &quot;startTime&quot;: &quot;A String&quot;, # Start of time range. Range is inclusive.
         },
       ],
-      &quot;queryRegex&quot;: &quot;A String&quot;, # Optional. Query regex to match the whole search query. Cannot be set when Condition.query_terms is set. This is currently supporting promotion use case.
+      &quot;queryRegex&quot;: &quot;A String&quot;, # Optional. Query regex to match the whole search query. Cannot be set when Condition.query_terms is set. Only supported for Basic Site Search promotion serving controls.
       &quot;queryTerms&quot;: [ # Search only A list of terms to match the query on. Cannot be set when Condition.query_regex is set. Maximum of 10 query terms.
         { # Matcher for search request query
           &quot;fullMatch&quot;: True or False, # Whether the search query needs to exactly match the query term.
@@ -235,6 +236,7 @@ <h3>Method Details</h3>
     &quot;dataStore&quot;: &quot;A String&quot;, # Required. Data store with which this promotion is attached to.
     &quot;searchLinkPromotion&quot;: { # Promotion proto includes uri and other helping information to display the promotion. # Required. Promotion attached to this action.
       &quot;description&quot;: &quot;A String&quot;, # Optional. The Promotion description. Maximum length: 200 characters.
+      &quot;document&quot;: &quot;A String&quot;, # Optional. The Document the user wants to promote. For site search, leave unset and only populate uri. Can be set along with uri.
       &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.
@@ -317,7 +319,7 @@ <h3>Method Details</h3>
           &quot;startTime&quot;: &quot;A String&quot;, # Start of time range. Range is inclusive.
         },
       ],
-      &quot;queryRegex&quot;: &quot;A String&quot;, # Optional. Query regex to match the whole search query. Cannot be set when Condition.query_terms is set. This is currently supporting promotion use case.
+      &quot;queryRegex&quot;: &quot;A String&quot;, # Optional. Query regex to match the whole search query. Cannot be set when Condition.query_terms is set. Only supported for Basic Site Search promotion serving controls.
       &quot;queryTerms&quot;: [ # Search only A list of terms to match the query on. Cannot be set when Condition.query_regex is set. Maximum of 10 query terms.
         { # Matcher for search request query
           &quot;fullMatch&quot;: True or False, # Whether the search query needs to exactly match the query term.
@@ -336,6 +338,7 @@ <h3>Method Details</h3>
     &quot;dataStore&quot;: &quot;A String&quot;, # Required. Data store with which this promotion is attached to.
     &quot;searchLinkPromotion&quot;: { # Promotion proto includes uri and other helping information to display the promotion. # Required. Promotion attached to this action.
       &quot;description&quot;: &quot;A String&quot;, # Optional. The Promotion description. Maximum length: 200 characters.
+      &quot;document&quot;: &quot;A String&quot;, # Optional. The Document the user wants to promote. For site search, leave unset and only populate uri. Can be set along with uri.
       &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.
@@ -405,7 +408,7 @@ <h3>Method Details</h3>
               &quot;startTime&quot;: &quot;A String&quot;, # Start of time range. Range is inclusive.
             },
           ],
-          &quot;queryRegex&quot;: &quot;A String&quot;, # Optional. Query regex to match the whole search query. Cannot be set when Condition.query_terms is set. This is currently supporting promotion use case.
+          &quot;queryRegex&quot;: &quot;A String&quot;, # Optional. Query regex to match the whole search query. Cannot be set when Condition.query_terms is set. Only supported for Basic Site Search promotion serving controls.
           &quot;queryTerms&quot;: [ # Search only A list of terms to match the query on. Cannot be set when Condition.query_regex is set. Maximum of 10 query terms.
             { # Matcher for search request query
               &quot;fullMatch&quot;: True or False, # Whether the search query needs to exactly match the query term.
@@ -424,6 +427,7 @@ <h3>Method Details</h3>
         &quot;dataStore&quot;: &quot;A String&quot;, # Required. Data store with which this promotion is attached to.
         &quot;searchLinkPromotion&quot;: { # Promotion proto includes uri and other helping information to display the promotion. # Required. Promotion attached to this action.
           &quot;description&quot;: &quot;A String&quot;, # Optional. The Promotion description. Maximum length: 200 characters.
+          &quot;document&quot;: &quot;A String&quot;, # Optional. The Document the user wants to promote. For site search, leave unset and only populate uri. Can be set along with uri.
           &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.
@@ -500,7 +504,7 @@ <h3>Method Details</h3>
           &quot;startTime&quot;: &quot;A String&quot;, # Start of time range. Range is inclusive.
         },
       ],
-      &quot;queryRegex&quot;: &quot;A String&quot;, # Optional. Query regex to match the whole search query. Cannot be set when Condition.query_terms is set. This is currently supporting promotion use case.
+      &quot;queryRegex&quot;: &quot;A String&quot;, # Optional. Query regex to match the whole search query. Cannot be set when Condition.query_terms is set. Only supported for Basic Site Search promotion serving controls.
       &quot;queryTerms&quot;: [ # Search only A list of terms to match the query on. Cannot be set when Condition.query_regex is set. Maximum of 10 query terms.
         { # Matcher for search request query
           &quot;fullMatch&quot;: True or False, # Whether the search query needs to exactly match the query term.
@@ -519,6 +523,7 @@ <h3>Method Details</h3>
     &quot;dataStore&quot;: &quot;A String&quot;, # Required. Data store with which this promotion is attached to.
     &quot;searchLinkPromotion&quot;: { # Promotion proto includes uri and other helping information to display the promotion. # Required. Promotion attached to this action.
       &quot;description&quot;: &quot;A String&quot;, # Optional. The Promotion description. Maximum length: 200 characters.
+      &quot;document&quot;: &quot;A String&quot;, # Optional. The Document the user wants to promote. For site search, leave unset and only populate uri. Can be set along with uri.
       &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.
@@ -577,7 +582,7 @@ <h3>Method Details</h3>
           &quot;startTime&quot;: &quot;A String&quot;, # Start of time range. Range is inclusive.
         },
       ],
-      &quot;queryRegex&quot;: &quot;A String&quot;, # Optional. Query regex to match the whole search query. Cannot be set when Condition.query_terms is set. This is currently supporting promotion use case.
+      &quot;queryRegex&quot;: &quot;A String&quot;, # Optional. Query regex to match the whole search query. Cannot be set when Condition.query_terms is set. Only supported for Basic Site Search promotion serving controls.
       &quot;queryTerms&quot;: [ # Search only A list of terms to match the query on. Cannot be set when Condition.query_regex is set. Maximum of 10 query terms.
         { # Matcher for search request query
           &quot;fullMatch&quot;: True or False, # Whether the search query needs to exactly match the query term.
@@ -596,6 +601,7 @@ <h3>Method Details</h3>
     &quot;dataStore&quot;: &quot;A String&quot;, # Required. Data store with which this promotion is attached to.
     &quot;searchLinkPromotion&quot;: { # Promotion proto includes uri and other helping information to display the promotion. # Required. Promotion attached to this action.
       &quot;description&quot;: &quot;A String&quot;, # Optional. The Promotion description. Maximum length: 200 characters.
+      &quot;document&quot;: &quot;A String&quot;, # Optional. The Document the user wants to promote. For site search, leave unset and only populate uri. Can be set along with uri.
       &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.

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

@@ -355,6 +355,9 @@ <h3>Method Details</h3>
   &quot;searchResults&quot;: [ # Search Results.
     { # Represents the search results.
       &quot;chunk&quot;: { # Chunk captures all raw metadata information of items to be recommended or searched in the chunk mode. # The chunk data in the search response if the SearchRequest.ContentSearchSpec.search_result_mode is set to CHUNKS.
+        &quot;annotationContents&quot;: [ # Output only. Annotation contents if the current chunk contains annotations.
+          &quot;A String&quot;,
+        ],
         &quot;chunkMetadata&quot;: { # Metadata of the current chunk. This field is only populated on SearchService.Search API. # Output only. Metadata of the current chunk.
           &quot;nextChunks&quot;: [ # The next chunks of the current chunk. The number is controlled by SearchRequest.ContentSearchSpec.ChunkSpec.num_next_chunks. This field is only populated on SearchService.Search API.
             # Object with schema name: GoogleCloudDiscoveryengineV1Chunk
@@ -364,6 +367,9 @@ <h3>Method Details</h3>
           ],
         },
         &quot;content&quot;: &quot;A String&quot;, # Content is a string from a document (parsed content).
+        &quot;dataUrls&quot;: [ # Output only. Image Data URLs if the current chunk contains images. Data URLs are composed of four parts: a prefix (data:), a MIME type indicating the type of data, an optional base64 token if non-textual, and the data itself: data:,
+          &quot;A String&quot;,
+        ],
         &quot;derivedStructData&quot;: { # Output only. This field is OUTPUT_ONLY. It contains derived data that are not in the original input document.
           &quot;a_key&quot;: &quot;&quot;, # Properties of the object.
         },
@@ -396,8 +402,8 @@ <h3>Method Details</h3>
             },
           ],
         },
-        &quot;content&quot;: { # Unstructured data linked to this document. # The unstructured data linked to this document. Content must be set if this document is under a `CONTENT_REQUIRED` data store.
-          &quot;mimeType&quot;: &quot;A String&quot;, # The MIME type of the content. Supported types: * `application/pdf` (PDF, only native PDFs are supported for now) * `text/html` (HTML) * `application/vnd.openxmlformats-officedocument.wordprocessingml.document` (DOCX) * `application/vnd.openxmlformats-officedocument.presentationml.presentation` (PPTX) * `text/plain` (TXT) See https://www.iana.org/assignments/media-types/media-types.xhtml.
+        &quot;content&quot;: { # Unstructured data linked to this document. # The unstructured data linked to this document. Content can only be set and must be set if this document is under a `CONTENT_REQUIRED` data store.
+          &quot;mimeType&quot;: &quot;A String&quot;, # The MIME type of the content. Supported types: * `application/pdf` (PDF, only native PDFs are supported for now) * `text/html` (HTML) * `text/plain` (TXT) * `text/xml` (XML) * `application/json` (JSON) * `application/vnd.openxmlformats-officedocument.wordprocessingml.document` (DOCX) * `application/vnd.openxmlformats-officedocument.presentationml.presentation` (PPTX) * `application/vnd.openxmlformats-officedocument.spreadsheetml.sheet` (XLSX) * `application/vnd.ms-excel.sheet.macroenabled.12` (XLSM) The following types are supported only if layout parser is enabled in the data store: * `image/bmp` (BMP) * `image/gif` (GIF) * `image/jpeg` (JPEG) * `image/png` (PNG) * `image/tiff` (TIFF) See https://www.iana.org/assignments/media-types/media-types.xhtml.
           &quot;rawBytes&quot;: &quot;A String&quot;, # The content represented as a stream of bytes. The maximum length is 1,000,000 bytes (1 MB / ~0.95 MiB). Note: As with all `bytes` fields, this field is represented as pure binary in Protocol Buffers and base64-encoded string in JSON. For example, `abc123!?$*&amp;()&#x27;-=@~` should be represented as `YWJjMTIzIT8kKiYoKSctPUB+` in JSON. See https://developers.google.com/protocol-buffers/docs/proto3#json.
           &quot;uri&quot;: &quot;A String&quot;, # The URI of the content. Only Cloud Storage URIs (e.g. `gs://bucket-name/path/to/file`) are supported. The maximum file size is 2.5 MB for text-based formats, 200 MB for other formats.
         },