google-apis-discoveryengine_v1 0.30.0 → 0.31.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: f24697c704f9865670640b6bd825889910ad451679e58832d600a6a7bf74c71c
4
- data.tar.gz: 129d534eef45d913e99f9326d1b7eeaac48333a99d657a77619415ee4abc911c
3
+ metadata.gz: 2b05b0f462246dfad48f6ce65a90a2e6ccec713645f448fd20c0566c6321e43f
4
+ data.tar.gz: a9bcd610dd4d62d8d53a54a6cf927b5f84ab82232d5994ef91dcc5b6dd4ea8cd
5
5
  SHA512:
6
- metadata.gz: 832c9150fb89208990b93207cbc422e9e0dceeaf95baddf99ce968c83667721ef9f9f18b17849452c361f3a43e3658382e2f495c4e156da8f5fbe3f09063f66c
7
- data.tar.gz: 3b0dc1b74c39fcbfb23c6a9e024f8f0c9b16a0e730974a510ec7b6d3a5877d910db1985108d99b92a496f37a7439ca88ec92ee1ffe07b6e1aa94ddd8ba4201e4
6
+ metadata.gz: 9865467cb76ec32278368dd8c2e338c9463b793f39b316d01e41cde2b2b80e60cb529968fa8a933b48cdde9d79bd0715eb9ccf782c09b7d3a1b68c826cb1357e
7
+ data.tar.gz: 2952d4f0515e6a8a3b89b1f3aed4e7c19f0d7f585999647a9ebee51350161cab12936fec6c7a0f3879ab15c1b8fbb6f37a3cc516fdb9cfb1274a143d6031f408
data/CHANGELOG.md CHANGED
@@ -1,5 +1,9 @@
1
1
  # Release history for google-apis-discoveryengine_v1
2
2
 
3
+ ### v0.31.0 (2025-03-23)
4
+
5
+ * Regenerated from discovery document revision 20250320
6
+
3
7
  ### v0.30.0 (2025-03-16)
4
8
 
5
9
  * Regenerated from discovery document revision 20250312
@@ -3261,6 +3261,11 @@ module Google
3261
3261
  # @return [String]
3262
3262
  attr_accessor :name
3263
3263
 
3264
+ # Output only. Whether the NotebookLM Corpus is ready to be used.
3265
+ # Corresponds to the JSON property `notebooklmState`
3266
+ # @return [String]
3267
+ attr_accessor :notebooklm_state
3268
+
3264
3269
  # Optional. Single-regional CMEKs that are required for some VAIS features.
3265
3270
  # Corresponds to the JSON property `singleRegionKeys`
3266
3271
  # @return [Array<Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1SingleRegionKey>]
@@ -3282,6 +3287,7 @@ module Google
3282
3287
  @kms_key_version = args[:kms_key_version] if args.key?(:kms_key_version)
3283
3288
  @last_rotation_timestamp_micros = args[:last_rotation_timestamp_micros] if args.key?(:last_rotation_timestamp_micros)
3284
3289
  @name = args[:name] if args.key?(:name)
3290
+ @notebooklm_state = args[:notebooklm_state] if args.key?(:notebooklm_state)
3285
3291
  @single_region_keys = args[:single_region_keys] if args.key?(:single_region_keys)
3286
3292
  @state = args[:state] if args.key?(:state)
3287
3293
  end
@@ -4333,6 +4339,17 @@ module Google
4333
4339
  class GoogleCloudDiscoveryengineV1DataStore
4334
4340
  include Google::Apis::Core::Hashable
4335
4341
 
4342
+ # Immutable. Whether data in the DataStore has ACL information. If set to `true`,
4343
+ # the source data must have ACL. ACL will be ingested when data is ingested by
4344
+ # DocumentService.ImportDocuments methods. When ACL is enabled for the DataStore,
4345
+ # Document can't be accessed by calling DocumentService.GetDocument or
4346
+ # DocumentService.ListDocuments. Currently ACL is only supported in `GENERIC`
4347
+ # industry vertical with non-`PUBLIC_WEBSITE` content config.
4348
+ # Corresponds to the JSON property `aclEnabled`
4349
+ # @return [Boolean]
4350
+ attr_accessor :acl_enabled
4351
+ alias_method :acl_enabled?, :acl_enabled
4352
+
4336
4353
  # Configuration data for advance site search.
4337
4354
  # Corresponds to the JSON property `advancedSiteSearchConfig`
4338
4355
  # @return [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1AdvancedSiteSearchConfig]
@@ -4447,6 +4464,7 @@ module Google
4447
4464
 
4448
4465
  # Update properties of this object
4449
4466
  def update!(**args)
4467
+ @acl_enabled = args[:acl_enabled] if args.key?(:acl_enabled)
4450
4468
  @advanced_site_search_config = args[:advanced_site_search_config] if args.key?(:advanced_site_search_config)
4451
4469
  @billing_estimation = args[:billing_estimation] if args.key?(:billing_estimation)
4452
4470
  @cmek_config = args[:cmek_config] if args.key?(:cmek_config)
@@ -6635,6 +6653,25 @@ module Google
6635
6653
  end
6636
6654
  end
6637
6655
 
6656
+ # Response message for CmekConfigService.ListCmekConfigs method.
6657
+ class GoogleCloudDiscoveryengineV1ListCmekConfigsResponse
6658
+ include Google::Apis::Core::Hashable
6659
+
6660
+ # All the customer's CmekConfigs.
6661
+ # Corresponds to the JSON property `cmekConfigs`
6662
+ # @return [Array<Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1CmekConfig>]
6663
+ attr_accessor :cmek_configs
6664
+
6665
+ def initialize(**args)
6666
+ update!(**args)
6667
+ end
6668
+
6669
+ # Update properties of this object
6670
+ def update!(**args)
6671
+ @cmek_configs = args[:cmek_configs] if args.key?(:cmek_configs)
6672
+ end
6673
+ end
6674
+
6638
6675
  # Response for ListControls method.
6639
6676
  class GoogleCloudDiscoveryengineV1ListControlsResponse
6640
6677
  include Google::Apis::Core::Hashable
@@ -8154,10 +8191,10 @@ module Google
8154
8191
  # @return [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1SearchRequestContentSearchSpec]
8155
8192
  attr_accessor :content_search_spec
8156
8193
 
8157
- # Specifications that define the specific [DataStore]s to be searched, along
8158
- # with configurations for those data stores. This is only considered for Engines
8159
- # with multiple data stores. For engines with a single data store, the specs
8160
- # directly under SearchRequest should be used.
8194
+ # Specifications that define the specific DataStores to be searched, along with
8195
+ # configurations for those data stores. This is only considered for Engines with
8196
+ # multiple data stores. For engines with a single data store, the specs directly
8197
+ # under SearchRequest should be used.
8161
8198
  # Corresponds to the JSON property `dataStoreSpecs`
8162
8199
  # @return [Array<Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1SearchRequestDataStoreSpec>]
8163
8200
  attr_accessor :data_store_specs
@@ -8398,7 +8435,7 @@ module Google
8398
8435
  include Google::Apis::Core::Hashable
8399
8436
 
8400
8437
  # Condition boost specifications. If a document matches multiple conditions in
8401
- # the specifictions, boost scores from these specifications are all applied and
8438
+ # the specifications, boost scores from these specifications are all applied and
8402
8439
  # combined in a non-linear way. Maximum number of specifications is 20.
8403
8440
  # Corresponds to the JSON property `conditionBoostSpecs`
8404
8441
  # @return [Array<Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1SearchRequestBoostSpecConditionBoostSpec>]
@@ -11061,6 +11098,14 @@ module Google
11061
11098
  attr_accessor :is_action_configured
11062
11099
  alias_method :is_action_configured?, :is_action_configured
11063
11100
 
11101
+ # Optional. The Service Directory resource name (projects/*/locations/*/
11102
+ # namespaces/*/services/*) representing a VPC network endpoint used to connect
11103
+ # to the data source's `instance_uri`, defined in DataConnector.params. Required
11104
+ # when VPC Service Controls are enabled.
11105
+ # Corresponds to the JSON property `serviceName`
11106
+ # @return [String]
11107
+ attr_accessor :service_name
11108
+
11064
11109
  def initialize(**args)
11065
11110
  update!(**args)
11066
11111
  end
@@ -11069,6 +11114,7 @@ module Google
11069
11114
  def update!(**args)
11070
11115
  @action_params = args[:action_params] if args.key?(:action_params)
11071
11116
  @is_action_configured = args[:is_action_configured] if args.key?(:is_action_configured)
11117
+ @service_name = args[:service_name] if args.key?(:service_name)
11072
11118
  end
11073
11119
  end
11074
11120
 
@@ -11164,6 +11210,11 @@ module Google
11164
11210
  # @return [String]
11165
11211
  attr_accessor :answer_text
11166
11212
 
11213
+ # List of blob attachments in the answer.
11214
+ # Corresponds to the JSON property `blobAttachments`
11215
+ # @return [Array<Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1alphaAnswerBlobAttachment>]
11216
+ attr_accessor :blob_attachments
11217
+
11167
11218
  # Citations.
11168
11219
  # Corresponds to the JSON property `citations`
11169
11220
  # @return [Array<Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1alphaAnswerCitation>]
@@ -11234,6 +11285,7 @@ module Google
11234
11285
  def update!(**args)
11235
11286
  @answer_skipped_reasons = args[:answer_skipped_reasons] if args.key?(:answer_skipped_reasons)
11236
11287
  @answer_text = args[:answer_text] if args.key?(:answer_text)
11288
+ @blob_attachments = args[:blob_attachments] if args.key?(:blob_attachments)
11237
11289
  @citations = args[:citations] if args.key?(:citations)
11238
11290
  @complete_time = args[:complete_time] if args.key?(:complete_time)
11239
11291
  @create_time = args[:create_time] if args.key?(:create_time)
@@ -11249,6 +11301,57 @@ module Google
11249
11301
  end
11250
11302
  end
11251
11303
 
11304
+ # Stores binarydata attached to text answer, e.g. image, video, audio, etc.
11305
+ class GoogleCloudDiscoveryengineV1alphaAnswerBlobAttachment
11306
+ include Google::Apis::Core::Hashable
11307
+
11308
+ # Output only. The attribution type of the blob.
11309
+ # Corresponds to the JSON property `attributionType`
11310
+ # @return [String]
11311
+ attr_accessor :attribution_type
11312
+
11313
+ # The media type and data of the blob.
11314
+ # Corresponds to the JSON property `data`
11315
+ # @return [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1alphaAnswerBlobAttachmentBlob]
11316
+ attr_accessor :data
11317
+
11318
+ def initialize(**args)
11319
+ update!(**args)
11320
+ end
11321
+
11322
+ # Update properties of this object
11323
+ def update!(**args)
11324
+ @attribution_type = args[:attribution_type] if args.key?(:attribution_type)
11325
+ @data = args[:data] if args.key?(:data)
11326
+ end
11327
+ end
11328
+
11329
+ # The media type and data of the blob.
11330
+ class GoogleCloudDiscoveryengineV1alphaAnswerBlobAttachmentBlob
11331
+ include Google::Apis::Core::Hashable
11332
+
11333
+ # Output only. Raw bytes.
11334
+ # Corresponds to the JSON property `data`
11335
+ # NOTE: Values are automatically base64 encoded/decoded in the client library.
11336
+ # @return [String]
11337
+ attr_accessor :data
11338
+
11339
+ # Output only. The media type (MIME type) of the generated or retrieved data.
11340
+ # Corresponds to the JSON property `mimeType`
11341
+ # @return [String]
11342
+ attr_accessor :mime_type
11343
+
11344
+ def initialize(**args)
11345
+ update!(**args)
11346
+ end
11347
+
11348
+ # Update properties of this object
11349
+ def update!(**args)
11350
+ @data = args[:data] if args.key?(:data)
11351
+ @mime_type = args[:mime_type] if args.key?(:mime_type)
11352
+ end
11353
+ end
11354
+
11252
11355
  # Citation info for a segment.
11253
11356
  class GoogleCloudDiscoveryengineV1alphaAnswerCitation
11254
11357
  include Google::Apis::Core::Hashable
@@ -11433,6 +11536,11 @@ module Google
11433
11536
  class GoogleCloudDiscoveryengineV1alphaAnswerReferenceChunkInfo
11434
11537
  include Google::Apis::Core::Hashable
11435
11538
 
11539
+ # Output only. Stores indexes of blobattachments linked to this chunk.
11540
+ # Corresponds to the JSON property `blobAttachmentIndexes`
11541
+ # @return [Array<Fixnum>]
11542
+ attr_accessor :blob_attachment_indexes
11543
+
11436
11544
  # Chunk resource name.
11437
11545
  # Corresponds to the JSON property `chunk`
11438
11546
  # @return [String]
@@ -11462,6 +11570,7 @@ module Google
11462
11570
 
11463
11571
  # Update properties of this object
11464
11572
  def update!(**args)
11573
+ @blob_attachment_indexes = args[:blob_attachment_indexes] if args.key?(:blob_attachment_indexes)
11465
11574
  @chunk = args[:chunk] if args.key?(:chunk)
11466
11575
  @content = args[:content] if args.key?(:content)
11467
11576
  @document_metadata = args[:document_metadata] if args.key?(:document_metadata)
@@ -11598,6 +11707,11 @@ module Google
11598
11707
  class GoogleCloudDiscoveryengineV1alphaAnswerReferenceUnstructuredDocumentInfoChunkContent
11599
11708
  include Google::Apis::Core::Hashable
11600
11709
 
11710
+ # Output only. Stores indexes of blobattachments linked to this chunk.
11711
+ # Corresponds to the JSON property `blobAttachmentIndexes`
11712
+ # @return [Array<Fixnum>]
11713
+ attr_accessor :blob_attachment_indexes
11714
+
11601
11715
  # Chunk textual content.
11602
11716
  # Corresponds to the JSON property `content`
11603
11717
  # @return [String]
@@ -11622,6 +11736,7 @@ module Google
11622
11736
 
11623
11737
  # Update properties of this object
11624
11738
  def update!(**args)
11739
+ @blob_attachment_indexes = args[:blob_attachment_indexes] if args.key?(:blob_attachment_indexes)
11625
11740
  @content = args[:content] if args.key?(:content)
11626
11741
  @page_identifier = args[:page_identifier] if args.key?(:page_identifier)
11627
11742
  @relevance_score = args[:relevance_score] if args.key?(:relevance_score)
@@ -11939,6 +12054,11 @@ module Google
11939
12054
  # @return [String]
11940
12055
  attr_accessor :name
11941
12056
 
12057
+ # Output only. Whether the NotebookLM Corpus is ready to be used.
12058
+ # Corresponds to the JSON property `notebooklmState`
12059
+ # @return [String]
12060
+ attr_accessor :notebooklm_state
12061
+
11942
12062
  # Optional. Single-regional CMEKs that are required for some VAIS features.
11943
12063
  # Corresponds to the JSON property `singleRegionKeys`
11944
12064
  # @return [Array<Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1alphaSingleRegionKey>]
@@ -11960,6 +12080,7 @@ module Google
11960
12080
  @kms_key_version = args[:kms_key_version] if args.key?(:kms_key_version)
11961
12081
  @last_rotation_timestamp_micros = args[:last_rotation_timestamp_micros] if args.key?(:last_rotation_timestamp_micros)
11962
12082
  @name = args[:name] if args.key?(:name)
12083
+ @notebooklm_state = args[:notebooklm_state] if args.key?(:notebooklm_state)
11963
12084
  @single_region_keys = args[:single_region_keys] if args.key?(:single_region_keys)
11964
12085
  @state = args[:state] if args.key?(:state)
11965
12086
  end
@@ -16358,10 +16479,10 @@ module Google
16358
16479
  # @return [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1alphaCustomFineTuningSpec]
16359
16480
  attr_accessor :custom_fine_tuning_spec
16360
16481
 
16361
- # Specifications that define the specific [DataStore]s to be searched, along
16362
- # with configurations for those data stores. This is only considered for Engines
16363
- # with multiple data stores. For engines with a single data store, the specs
16364
- # directly under SearchRequest should be used.
16482
+ # Specifications that define the specific DataStores to be searched, along with
16483
+ # configurations for those data stores. This is only considered for Engines with
16484
+ # multiple data stores. For engines with a single data store, the specs directly
16485
+ # under SearchRequest should be used.
16365
16486
  # Corresponds to the JSON property `dataStoreSpecs`
16366
16487
  # @return [Array<Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1alphaSearchRequestDataStoreSpec>]
16367
16488
  attr_accessor :data_store_specs
@@ -16492,29 +16613,30 @@ module Google
16492
16613
  # This overrides ServingConfig.ranking_expression. The syntax and supported
16493
16614
  # features depend on the ranking_expression_backend value. If
16494
16615
  # ranking_expression_backend is not provided, it defaults to BYOE. === BYOE ===
16495
- # If ranking expression is not provided or set to BYOE, it should be a single
16496
- # function or multiple functions that are joined by "+". * ranking_expression =
16497
- # function, ` " + ", function `; Supported functions: * double * relevance_score
16498
- # * double * dotProduct(embedding_field_path) Function variables: * `
16499
- # relevance_score`: pre-defined keywords, used for measure relevance between
16500
- # query and document. * `embedding_field_path`: the document embedding field
16501
- # used with query embedding vector. * `dotProduct`: embedding function between
16502
- # embedding_field_path and query embedding vector. Example ranking expression:
16503
- # If document has an embedding field doc_embedding, the ranking expression could
16504
- # be `0.5 * relevance_score + 0.3 * dotProduct(doc_embedding)`. === CLEARBOX ===
16505
- # If ranking expression is set to CLEARBOX, the following expression types (and
16506
- # combinations of those chained using + or * operators) are supported: * double *
16507
- # signal * log(signal) * exp(signal) * rr(signal, double > 0) -- reciprocal
16508
- # rank transformation with second argument being a denominator constant. *
16509
- # is_nan(signal) -- returns 0 if signal is NaN, 1 otherwise. * fill_nan(signal1,
16510
- # signal2 | double) -- if signal1 is NaN, returns signal2 | double, else returns
16511
- # signal1. Examples: * 0.2 * gecko_score + 0.8 * log(bm25_score) * 0.2 * exp(
16512
- # fill_nan(gecko_score, 0)) + 0.3 * is_nan(bm25_score) * 0.2 * rr(gecko_score,
16513
- # 16) + 0.8 * rr(bm25_score, 32) The following signals are supported: *
16514
- # gecko_score -- semantic similarity adjustment * bm25_score -- keyword match
16515
- # adjustment * jetstream_score -- semantic relevance adjustment * pctr_rank --
16516
- # predicted conversion rate adjustment as a rank * freshness_rank -- freshness
16517
- # adjustment as a rank * base_rank -- the default rank of the result
16616
+ # If ranking_expression_backend is not provided or set to `BYOE`, it should be a
16617
+ # single function or multiple functions that are joined by "+". *
16618
+ # ranking_expression = function, ` " + ", function `; Supported functions: *
16619
+ # double * relevance_score * double * dotProduct(embedding_field_path) Function
16620
+ # variables: * `relevance_score`: pre-defined keywords, used for measure
16621
+ # relevance between query and document. * `embedding_field_path`: the document
16622
+ # embedding field used with query embedding vector. * `dotProduct`: embedding
16623
+ # function between embedding_field_path and query embedding vector. Example
16624
+ # ranking expression: If document has an embedding field doc_embedding, the
16625
+ # ranking expression could be `0.5 * relevance_score + 0.3 * dotProduct(
16626
+ # doc_embedding)`. === CLEARBOX === If ranking_expression_backend is set to `
16627
+ # CLEARBOX`, the following expression types (and combinations of those chained
16628
+ # using + or * operators) are supported: * double * signal * log(signal) * exp(
16629
+ # signal) * rr(signal, double > 0) -- reciprocal rank transformation with second
16630
+ # argument being a denominator constant. * is_nan(signal) -- returns 0 if signal
16631
+ # is NaN, 1 otherwise. * fill_nan(signal1, signal2 | double) -- if signal1 is
16632
+ # NaN, returns signal2 | double, else returns signal1. Examples: * 0.2 *
16633
+ # gecko_score + 0.8 * log(bm25_score) * 0.2 * exp(fill_nan(gecko_score, 0)) + 0.
16634
+ # 3 * is_nan(bm25_score) * 0.2 * rr(gecko_score, 16) + 0.8 * rr(bm25_score, 32)
16635
+ # The following signals are supported: * gecko_score -- semantic similarity
16636
+ # adjustment * bm25_score -- keyword match adjustment * jetstream_score --
16637
+ # semantic relevance adjustment * pctr_rank -- predicted conversion rate
16638
+ # adjustment as a rank * freshness_rank -- freshness adjustment as a rank *
16639
+ # base_rank -- the default rank of the result
16518
16640
  # Corresponds to the JSON property `rankingExpression`
16519
16641
  # @return [String]
16520
16642
  attr_accessor :ranking_expression
@@ -16681,7 +16803,7 @@ module Google
16681
16803
  include Google::Apis::Core::Hashable
16682
16804
 
16683
16805
  # Condition boost specifications. If a document matches multiple conditions in
16684
- # the specifictions, boost scores from these specifications are all applied and
16806
+ # the specifications, boost scores from these specifications are all applied and
16685
16807
  # combined in a non-linear way. Maximum number of specifications is 20.
16686
16808
  # Corresponds to the JSON property `conditionBoostSpecs`
16687
16809
  # @return [Array<Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1alphaSearchRequestBoostSpecConditionBoostSpec>]
@@ -17080,6 +17202,12 @@ module Google
17080
17202
  # @return [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1alphaSearchRequestContentSearchSpecSummarySpecModelSpec]
17081
17203
  attr_accessor :model_spec
17082
17204
 
17205
+ # Multimodal specification: Will return an image from specified source. If
17206
+ # multiple sources are specified, the pick is a quality based decision.
17207
+ # Corresponds to the JSON property `multimodalSpec`
17208
+ # @return [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1alphaSearchRequestContentSearchSpecSummarySpecMultiModalSpec]
17209
+ attr_accessor :multimodal_spec
17210
+
17083
17211
  # The number of top results to generate the summary from. If the number of
17084
17212
  # results returned is less than `summaryResultCount`, the summary is generated
17085
17213
  # from all of the results. At most 10 results for documents mode, or 50 for
@@ -17113,6 +17241,7 @@ module Google
17113
17241
  @language_code = args[:language_code] if args.key?(:language_code)
17114
17242
  @model_prompt_spec = args[:model_prompt_spec] if args.key?(:model_prompt_spec)
17115
17243
  @model_spec = args[:model_spec] if args.key?(:model_spec)
17244
+ @multimodal_spec = args[:multimodal_spec] if args.key?(:multimodal_spec)
17116
17245
  @summary_result_count = args[:summary_result_count] if args.key?(:summary_result_count)
17117
17246
  @use_semantic_chunks = args[:use_semantic_chunks] if args.key?(:use_semantic_chunks)
17118
17247
  end
@@ -17164,6 +17293,26 @@ module Google
17164
17293
  end
17165
17294
  end
17166
17295
 
17296
+ # Multimodal specification: Will return an image from specified source. If
17297
+ # multiple sources are specified, the pick is a quality based decision.
17298
+ class GoogleCloudDiscoveryengineV1alphaSearchRequestContentSearchSpecSummarySpecMultiModalSpec
17299
+ include Google::Apis::Core::Hashable
17300
+
17301
+ # Optional. Source of image returned in the answer.
17302
+ # Corresponds to the JSON property `imageSource`
17303
+ # @return [String]
17304
+ attr_accessor :image_source
17305
+
17306
+ def initialize(**args)
17307
+ update!(**args)
17308
+ end
17309
+
17310
+ # Update properties of this object
17311
+ def update!(**args)
17312
+ @image_source = args[:image_source] if args.key?(:image_source)
17313
+ end
17314
+ end
17315
+
17167
17316
  # A struct to define data stores to filter on in a search call and
17168
17317
  # configurations for those data stores. Otherwise, an `INVALID_ARGUMENT` error
17169
17318
  # is returned.
@@ -18457,6 +18606,11 @@ module Google
18457
18606
  # @return [String]
18458
18607
  attr_accessor :name
18459
18608
 
18609
+ # Output only. Whether the NotebookLM Corpus is ready to be used.
18610
+ # Corresponds to the JSON property `notebooklmState`
18611
+ # @return [String]
18612
+ attr_accessor :notebooklm_state
18613
+
18460
18614
  # Optional. Single-regional CMEKs that are required for some VAIS features.
18461
18615
  # Corresponds to the JSON property `singleRegionKeys`
18462
18616
  # @return [Array<Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1betaSingleRegionKey>]
@@ -18478,6 +18632,7 @@ module Google
18478
18632
  @kms_key_version = args[:kms_key_version] if args.key?(:kms_key_version)
18479
18633
  @last_rotation_timestamp_micros = args[:last_rotation_timestamp_micros] if args.key?(:last_rotation_timestamp_micros)
18480
18634
  @name = args[:name] if args.key?(:name)
18635
+ @notebooklm_state = args[:notebooklm_state] if args.key?(:notebooklm_state)
18481
18636
  @single_region_keys = args[:single_region_keys] if args.key?(:single_region_keys)
18482
18637
  @state = args[:state] if args.key?(:state)
18483
18638
  end
@@ -19071,6 +19226,17 @@ module Google
19071
19226
  class GoogleCloudDiscoveryengineV1betaDataStore
19072
19227
  include Google::Apis::Core::Hashable
19073
19228
 
19229
+ # Immutable. Whether data in the DataStore has ACL information. If set to `true`,
19230
+ # the source data must have ACL. ACL will be ingested when data is ingested by
19231
+ # DocumentService.ImportDocuments methods. When ACL is enabled for the DataStore,
19232
+ # Document can't be accessed by calling DocumentService.GetDocument or
19233
+ # DocumentService.ListDocuments. Currently ACL is only supported in `GENERIC`
19234
+ # industry vertical with non-`PUBLIC_WEBSITE` content config.
19235
+ # Corresponds to the JSON property `aclEnabled`
19236
+ # @return [Boolean]
19237
+ attr_accessor :acl_enabled
19238
+ alias_method :acl_enabled?, :acl_enabled
19239
+
19074
19240
  # Configuration data for advance site search.
19075
19241
  # Corresponds to the JSON property `advancedSiteSearchConfig`
19076
19242
  # @return [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1betaAdvancedSiteSearchConfig]
@@ -19195,6 +19361,7 @@ module Google
19195
19361
 
19196
19362
  # Update properties of this object
19197
19363
  def update!(**args)
19364
+ @acl_enabled = args[:acl_enabled] if args.key?(:acl_enabled)
19198
19365
  @advanced_site_search_config = args[:advanced_site_search_config] if args.key?(:advanced_site_search_config)
19199
19366
  @billing_estimation = args[:billing_estimation] if args.key?(:billing_estimation)
19200
19367
  @cmek_config = args[:cmek_config] if args.key?(:cmek_config)
@@ -21239,10 +21406,10 @@ module Google
21239
21406
  # @return [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1betaSearchRequestContentSearchSpec]
21240
21407
  attr_accessor :content_search_spec
21241
21408
 
21242
- # Specifications that define the specific [DataStore]s to be searched, along
21243
- # with configurations for those data stores. This is only considered for Engines
21244
- # with multiple data stores. For engines with a single data store, the specs
21245
- # directly under SearchRequest should be used.
21409
+ # Specifications that define the specific DataStores to be searched, along with
21410
+ # configurations for those data stores. This is only considered for Engines with
21411
+ # multiple data stores. For engines with a single data store, the specs directly
21412
+ # under SearchRequest should be used.
21246
21413
  # Corresponds to the JSON property `dataStoreSpecs`
21247
21414
  # @return [Array<Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1betaSearchRequestDataStoreSpec>]
21248
21415
  attr_accessor :data_store_specs
@@ -21373,29 +21540,30 @@ module Google
21373
21540
  # This overrides ServingConfig.ranking_expression. The syntax and supported
21374
21541
  # features depend on the ranking_expression_backend value. If
21375
21542
  # ranking_expression_backend is not provided, it defaults to BYOE. === BYOE ===
21376
- # If ranking expression is not provided or set to BYOE, it should be a single
21377
- # function or multiple functions that are joined by "+". * ranking_expression =
21378
- # function, ` " + ", function `; Supported functions: * double * relevance_score
21379
- # * double * dotProduct(embedding_field_path) Function variables: * `
21380
- # relevance_score`: pre-defined keywords, used for measure relevance between
21381
- # query and document. * `embedding_field_path`: the document embedding field
21382
- # used with query embedding vector. * `dotProduct`: embedding function between
21383
- # embedding_field_path and query embedding vector. Example ranking expression:
21384
- # If document has an embedding field doc_embedding, the ranking expression could
21385
- # be `0.5 * relevance_score + 0.3 * dotProduct(doc_embedding)`. === CLEARBOX ===
21386
- # If ranking expression is set to CLEARBOX, the following expression types (and
21387
- # combinations of those chained using + or * operators) are supported: * double *
21388
- # signal * log(signal) * exp(signal) * rr(signal, double > 0) -- reciprocal
21389
- # rank transformation with second argument being a denominator constant. *
21390
- # is_nan(signal) -- returns 0 if signal is NaN, 1 otherwise. * fill_nan(signal1,
21391
- # signal2 | double) -- if signal1 is NaN, returns signal2 | double, else returns
21392
- # signal1. Examples: * 0.2 * gecko_score + 0.8 * log(bm25_score) * 0.2 * exp(
21393
- # fill_nan(gecko_score, 0)) + 0.3 * is_nan(bm25_score) * 0.2 * rr(gecko_score,
21394
- # 16) + 0.8 * rr(bm25_score, 32) The following signals are supported: *
21395
- # gecko_score -- semantic similarity adjustment * bm25_score -- keyword match
21396
- # adjustment * jetstream_score -- semantic relevance adjustment * pctr_rank --
21397
- # predicted conversion rate adjustment as a rank * freshness_rank -- freshness
21398
- # adjustment as a rank * base_rank -- the default rank of the result
21543
+ # If ranking_expression_backend is not provided or set to `BYOE`, it should be a
21544
+ # single function or multiple functions that are joined by "+". *
21545
+ # ranking_expression = function, ` " + ", function `; Supported functions: *
21546
+ # double * relevance_score * double * dotProduct(embedding_field_path) Function
21547
+ # variables: * `relevance_score`: pre-defined keywords, used for measure
21548
+ # relevance between query and document. * `embedding_field_path`: the document
21549
+ # embedding field used with query embedding vector. * `dotProduct`: embedding
21550
+ # function between embedding_field_path and query embedding vector. Example
21551
+ # ranking expression: If document has an embedding field doc_embedding, the
21552
+ # ranking expression could be `0.5 * relevance_score + 0.3 * dotProduct(
21553
+ # doc_embedding)`. === CLEARBOX === If ranking_expression_backend is set to `
21554
+ # CLEARBOX`, the following expression types (and combinations of those chained
21555
+ # using + or * operators) are supported: * double * signal * log(signal) * exp(
21556
+ # signal) * rr(signal, double > 0) -- reciprocal rank transformation with second
21557
+ # argument being a denominator constant. * is_nan(signal) -- returns 0 if signal
21558
+ # is NaN, 1 otherwise. * fill_nan(signal1, signal2 | double) -- if signal1 is
21559
+ # NaN, returns signal2 | double, else returns signal1. Examples: * 0.2 *
21560
+ # gecko_score + 0.8 * log(bm25_score) * 0.2 * exp(fill_nan(gecko_score, 0)) + 0.
21561
+ # 3 * is_nan(bm25_score) * 0.2 * rr(gecko_score, 16) + 0.8 * rr(bm25_score, 32)
21562
+ # The following signals are supported: * gecko_score -- semantic similarity
21563
+ # adjustment * bm25_score -- keyword match adjustment * jetstream_score --
21564
+ # semantic relevance adjustment * pctr_rank -- predicted conversion rate
21565
+ # adjustment as a rank * freshness_rank -- freshness adjustment as a rank *
21566
+ # base_rank -- the default rank of the result
21399
21567
  # Corresponds to the JSON property `rankingExpression`
21400
21568
  # @return [String]
21401
21569
  attr_accessor :ranking_expression
@@ -21561,7 +21729,7 @@ module Google
21561
21729
  include Google::Apis::Core::Hashable
21562
21730
 
21563
21731
  # Condition boost specifications. If a document matches multiple conditions in
21564
- # the specifictions, boost scores from these specifications are all applied and
21732
+ # the specifications, boost scores from these specifications are all applied and
21565
21733
  # combined in a non-linear way. Maximum number of specifications is 20.
21566
21734
  # Corresponds to the JSON property `conditionBoostSpecs`
21567
21735
  # @return [Array<Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1betaSearchRequestBoostSpecConditionBoostSpec>]
@@ -21960,6 +22128,12 @@ module Google
21960
22128
  # @return [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1betaSearchRequestContentSearchSpecSummarySpecModelSpec]
21961
22129
  attr_accessor :model_spec
21962
22130
 
22131
+ # Multimodal specification: Will return an image from specified source. If
22132
+ # multiple sources are specified, the pick is a quality based decision.
22133
+ # Corresponds to the JSON property `multimodalSpec`
22134
+ # @return [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1betaSearchRequestContentSearchSpecSummarySpecMultiModalSpec]
22135
+ attr_accessor :multimodal_spec
22136
+
21963
22137
  # The number of top results to generate the summary from. If the number of
21964
22138
  # results returned is less than `summaryResultCount`, the summary is generated
21965
22139
  # from all of the results. At most 10 results for documents mode, or 50 for
@@ -21993,6 +22167,7 @@ module Google
21993
22167
  @language_code = args[:language_code] if args.key?(:language_code)
21994
22168
  @model_prompt_spec = args[:model_prompt_spec] if args.key?(:model_prompt_spec)
21995
22169
  @model_spec = args[:model_spec] if args.key?(:model_spec)
22170
+ @multimodal_spec = args[:multimodal_spec] if args.key?(:multimodal_spec)
21996
22171
  @summary_result_count = args[:summary_result_count] if args.key?(:summary_result_count)
21997
22172
  @use_semantic_chunks = args[:use_semantic_chunks] if args.key?(:use_semantic_chunks)
21998
22173
  end
@@ -22044,6 +22219,26 @@ module Google
22044
22219
  end
22045
22220
  end
22046
22221
 
22222
+ # Multimodal specification: Will return an image from specified source. If
22223
+ # multiple sources are specified, the pick is a quality based decision.
22224
+ class GoogleCloudDiscoveryengineV1betaSearchRequestContentSearchSpecSummarySpecMultiModalSpec
22225
+ include Google::Apis::Core::Hashable
22226
+
22227
+ # Optional. Source of image returned in the answer.
22228
+ # Corresponds to the JSON property `imageSource`
22229
+ # @return [String]
22230
+ attr_accessor :image_source
22231
+
22232
+ def initialize(**args)
22233
+ update!(**args)
22234
+ end
22235
+
22236
+ # Update properties of this object
22237
+ def update!(**args)
22238
+ @image_source = args[:image_source] if args.key?(:image_source)
22239
+ end
22240
+ end
22241
+
22047
22242
  # A struct to define data stores to filter on in a search call and
22048
22243
  # configurations for those data stores. Otherwise, an `INVALID_ARGUMENT` error
22049
22244
  # is returned.
@@ -16,13 +16,13 @@ module Google
16
16
  module Apis
17
17
  module DiscoveryengineV1
18
18
  # Version of the google-apis-discoveryengine_v1 gem
19
- GEM_VERSION = "0.30.0"
19
+ GEM_VERSION = "0.31.0"
20
20
 
21
21
  # Version of the code generator used to generate this client
22
22
  GENERATOR_VERSION = "0.16.0"
23
23
 
24
24
  # Revision of the discovery document this client was generated from
25
- REVISION = "20250312"
25
+ REVISION = "20250320"
26
26
  end
27
27
  end
28
28
  end
@@ -1126,6 +1126,12 @@ module Google
1126
1126
  include Google::Apis::Core::JsonObjectSupport
1127
1127
  end
1128
1128
 
1129
+ class GoogleCloudDiscoveryengineV1ListCmekConfigsResponse
1130
+ class Representation < Google::Apis::Core::JsonRepresentation; end
1131
+
1132
+ include Google::Apis::Core::JsonObjectSupport
1133
+ end
1134
+
1129
1135
  class GoogleCloudDiscoveryengineV1ListControlsResponse
1130
1136
  class Representation < Google::Apis::Core::JsonRepresentation; end
1131
1137
 
@@ -1804,6 +1810,18 @@ module Google
1804
1810
  include Google::Apis::Core::JsonObjectSupport
1805
1811
  end
1806
1812
 
1813
+ class GoogleCloudDiscoveryengineV1alphaAnswerBlobAttachment
1814
+ class Representation < Google::Apis::Core::JsonRepresentation; end
1815
+
1816
+ include Google::Apis::Core::JsonObjectSupport
1817
+ end
1818
+
1819
+ class GoogleCloudDiscoveryengineV1alphaAnswerBlobAttachmentBlob
1820
+ class Representation < Google::Apis::Core::JsonRepresentation; end
1821
+
1822
+ include Google::Apis::Core::JsonObjectSupport
1823
+ end
1824
+
1807
1825
  class GoogleCloudDiscoveryengineV1alphaAnswerCitation
1808
1826
  class Representation < Google::Apis::Core::JsonRepresentation; end
1809
1827
 
@@ -2704,6 +2722,12 @@ module Google
2704
2722
  include Google::Apis::Core::JsonObjectSupport
2705
2723
  end
2706
2724
 
2725
+ class GoogleCloudDiscoveryengineV1alphaSearchRequestContentSearchSpecSummarySpecMultiModalSpec
2726
+ class Representation < Google::Apis::Core::JsonRepresentation; end
2727
+
2728
+ include Google::Apis::Core::JsonObjectSupport
2729
+ end
2730
+
2707
2731
  class GoogleCloudDiscoveryengineV1alphaSearchRequestDataStoreSpec
2708
2732
  class Representation < Google::Apis::Core::JsonRepresentation; end
2709
2733
 
@@ -3508,6 +3532,12 @@ module Google
3508
3532
  include Google::Apis::Core::JsonObjectSupport
3509
3533
  end
3510
3534
 
3535
+ class GoogleCloudDiscoveryengineV1betaSearchRequestContentSearchSpecSummarySpecMultiModalSpec
3536
+ class Representation < Google::Apis::Core::JsonRepresentation; end
3537
+
3538
+ include Google::Apis::Core::JsonObjectSupport
3539
+ end
3540
+
3511
3541
  class GoogleCloudDiscoveryengineV1betaSearchRequestDataStoreSpec
3512
3542
  class Representation < Google::Apis::Core::JsonRepresentation; end
3513
3543
 
@@ -4650,6 +4680,7 @@ module Google
4650
4680
  property :kms_key_version, as: 'kmsKeyVersion'
4651
4681
  property :last_rotation_timestamp_micros, :numeric_string => true, as: 'lastRotationTimestampMicros'
4652
4682
  property :name, as: 'name'
4683
+ property :notebooklm_state, as: 'notebooklmState'
4653
4684
  collection :single_region_keys, as: 'singleRegionKeys', class: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1SingleRegionKey, decorator: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1SingleRegionKey::Representation
4654
4685
 
4655
4686
  property :state, as: 'state'
@@ -4942,6 +4973,7 @@ module Google
4942
4973
  class GoogleCloudDiscoveryengineV1DataStore
4943
4974
  # @private
4944
4975
  class Representation < Google::Apis::Core::JsonRepresentation
4976
+ property :acl_enabled, as: 'aclEnabled'
4945
4977
  property :advanced_site_search_config, as: 'advancedSiteSearchConfig', class: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1AdvancedSiteSearchConfig, decorator: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1AdvancedSiteSearchConfig::Representation
4946
4978
 
4947
4979
  property :billing_estimation, as: 'billingEstimation', class: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1DataStoreBillingEstimation, decorator: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1DataStoreBillingEstimation::Representation
@@ -5599,6 +5631,14 @@ module Google
5599
5631
  end
5600
5632
  end
5601
5633
 
5634
+ class GoogleCloudDiscoveryengineV1ListCmekConfigsResponse
5635
+ # @private
5636
+ class Representation < Google::Apis::Core::JsonRepresentation
5637
+ collection :cmek_configs, as: 'cmekConfigs', class: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1CmekConfig, decorator: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1CmekConfig::Representation
5638
+
5639
+ end
5640
+ end
5641
+
5602
5642
  class GoogleCloudDiscoveryengineV1ListControlsResponse
5603
5643
  # @private
5604
5644
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -6717,6 +6757,7 @@ module Google
6717
6757
  class Representation < Google::Apis::Core::JsonRepresentation
6718
6758
  hash :action_params, as: 'actionParams'
6719
6759
  property :is_action_configured, as: 'isActionConfigured'
6760
+ property :service_name, as: 'serviceName'
6720
6761
  end
6721
6762
  end
6722
6763
 
@@ -6750,6 +6791,8 @@ module Google
6750
6791
  class Representation < Google::Apis::Core::JsonRepresentation
6751
6792
  collection :answer_skipped_reasons, as: 'answerSkippedReasons'
6752
6793
  property :answer_text, as: 'answerText'
6794
+ collection :blob_attachments, as: 'blobAttachments', class: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1alphaAnswerBlobAttachment, decorator: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1alphaAnswerBlobAttachment::Representation
6795
+
6753
6796
  collection :citations, as: 'citations', class: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1alphaAnswerCitation, decorator: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1alphaAnswerCitation::Representation
6754
6797
 
6755
6798
  property :complete_time, as: 'completeTime'
@@ -6771,6 +6814,23 @@ module Google
6771
6814
  end
6772
6815
  end
6773
6816
 
6817
+ class GoogleCloudDiscoveryengineV1alphaAnswerBlobAttachment
6818
+ # @private
6819
+ class Representation < Google::Apis::Core::JsonRepresentation
6820
+ property :attribution_type, as: 'attributionType'
6821
+ property :data, as: 'data', class: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1alphaAnswerBlobAttachmentBlob, decorator: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1alphaAnswerBlobAttachmentBlob::Representation
6822
+
6823
+ end
6824
+ end
6825
+
6826
+ class GoogleCloudDiscoveryengineV1alphaAnswerBlobAttachmentBlob
6827
+ # @private
6828
+ class Representation < Google::Apis::Core::JsonRepresentation
6829
+ property :data, :base64 => true, as: 'data'
6830
+ property :mime_type, as: 'mimeType'
6831
+ end
6832
+ end
6833
+
6774
6834
  class GoogleCloudDiscoveryengineV1alphaAnswerCitation
6775
6835
  # @private
6776
6836
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -6831,6 +6891,7 @@ module Google
6831
6891
  class GoogleCloudDiscoveryengineV1alphaAnswerReferenceChunkInfo
6832
6892
  # @private
6833
6893
  class Representation < Google::Apis::Core::JsonRepresentation
6894
+ collection :blob_attachment_indexes, as: 'blobAttachmentIndexes'
6834
6895
  property :chunk, as: 'chunk'
6835
6896
  property :content, as: 'content'
6836
6897
  property :document_metadata, as: 'documentMetadata', class: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1alphaAnswerReferenceChunkInfoDocumentMetadata, decorator: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1alphaAnswerReferenceChunkInfoDocumentMetadata::Representation
@@ -6875,6 +6936,7 @@ module Google
6875
6936
  class GoogleCloudDiscoveryengineV1alphaAnswerReferenceUnstructuredDocumentInfoChunkContent
6876
6937
  # @private
6877
6938
  class Representation < Google::Apis::Core::JsonRepresentation
6939
+ collection :blob_attachment_indexes, as: 'blobAttachmentIndexes'
6878
6940
  property :content, as: 'content'
6879
6941
  property :page_identifier, as: 'pageIdentifier'
6880
6942
  property :relevance_score, as: 'relevanceScore'
@@ -6979,6 +7041,7 @@ module Google
6979
7041
  property :kms_key_version, as: 'kmsKeyVersion'
6980
7042
  property :last_rotation_timestamp_micros, :numeric_string => true, as: 'lastRotationTimestampMicros'
6981
7043
  property :name, as: 'name'
7044
+ property :notebooklm_state, as: 'notebooklmState'
6982
7045
  collection :single_region_keys, as: 'singleRegionKeys', class: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1alphaSingleRegionKey, decorator: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1alphaSingleRegionKey::Representation
6983
7046
 
6984
7047
  property :state, as: 'state'
@@ -8315,6 +8378,8 @@ module Google
8315
8378
 
8316
8379
  property :model_spec, as: 'modelSpec', class: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1alphaSearchRequestContentSearchSpecSummarySpecModelSpec, decorator: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1alphaSearchRequestContentSearchSpecSummarySpecModelSpec::Representation
8317
8380
 
8381
+ property :multimodal_spec, as: 'multimodalSpec', class: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1alphaSearchRequestContentSearchSpecSummarySpecMultiModalSpec, decorator: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1alphaSearchRequestContentSearchSpecSummarySpecMultiModalSpec::Representation
8382
+
8318
8383
  property :summary_result_count, as: 'summaryResultCount'
8319
8384
  property :use_semantic_chunks, as: 'useSemanticChunks'
8320
8385
  end
@@ -8334,6 +8399,13 @@ module Google
8334
8399
  end
8335
8400
  end
8336
8401
 
8402
+ class GoogleCloudDiscoveryengineV1alphaSearchRequestContentSearchSpecSummarySpecMultiModalSpec
8403
+ # @private
8404
+ class Representation < Google::Apis::Core::JsonRepresentation
8405
+ property :image_source, as: 'imageSource'
8406
+ end
8407
+ end
8408
+
8337
8409
  class GoogleCloudDiscoveryengineV1alphaSearchRequestDataStoreSpec
8338
8410
  # @private
8339
8411
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -8696,6 +8768,7 @@ module Google
8696
8768
  property :kms_key_version, as: 'kmsKeyVersion'
8697
8769
  property :last_rotation_timestamp_micros, :numeric_string => true, as: 'lastRotationTimestampMicros'
8698
8770
  property :name, as: 'name'
8771
+ property :notebooklm_state, as: 'notebooklmState'
8699
8772
  collection :single_region_keys, as: 'singleRegionKeys', class: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1betaSingleRegionKey, decorator: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1betaSingleRegionKey::Representation
8700
8773
 
8701
8774
  property :state, as: 'state'
@@ -8871,6 +8944,7 @@ module Google
8871
8944
  class GoogleCloudDiscoveryengineV1betaDataStore
8872
8945
  # @private
8873
8946
  class Representation < Google::Apis::Core::JsonRepresentation
8947
+ property :acl_enabled, as: 'aclEnabled'
8874
8948
  property :advanced_site_search_config, as: 'advancedSiteSearchConfig', class: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1betaAdvancedSiteSearchConfig, decorator: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1betaAdvancedSiteSearchConfig::Representation
8875
8949
 
8876
8950
  property :billing_estimation, as: 'billingEstimation', class: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1betaDataStoreBillingEstimation, decorator: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1betaDataStoreBillingEstimation::Representation
@@ -9633,6 +9707,8 @@ module Google
9633
9707
 
9634
9708
  property :model_spec, as: 'modelSpec', class: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1betaSearchRequestContentSearchSpecSummarySpecModelSpec, decorator: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1betaSearchRequestContentSearchSpecSummarySpecModelSpec::Representation
9635
9709
 
9710
+ property :multimodal_spec, as: 'multimodalSpec', class: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1betaSearchRequestContentSearchSpecSummarySpecMultiModalSpec, decorator: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1betaSearchRequestContentSearchSpecSummarySpecMultiModalSpec::Representation
9711
+
9636
9712
  property :summary_result_count, as: 'summaryResultCount'
9637
9713
  property :use_semantic_chunks, as: 'useSemanticChunks'
9638
9714
  end
@@ -9652,6 +9728,13 @@ module Google
9652
9728
  end
9653
9729
  end
9654
9730
 
9731
+ class GoogleCloudDiscoveryengineV1betaSearchRequestContentSearchSpecSummarySpecMultiModalSpec
9732
+ # @private
9733
+ class Representation < Google::Apis::Core::JsonRepresentation
9734
+ property :image_source, as: 'imageSource'
9735
+ end
9736
+ end
9737
+
9655
9738
  class GoogleCloudDiscoveryengineV1betaSearchRequestDataStoreSpec
9656
9739
  # @private
9657
9740
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -88,6 +88,218 @@ module Google
88
88
  execute_or_queue_command(command, &block)
89
89
  end
90
90
 
91
+ # Gets the CmekConfig.
92
+ # @param [String] name
93
+ # Required. Resource name of CmekConfig, such as `projects/*/locations/*/
94
+ # cmekConfig` or `projects/*/locations/*/cmekConfigs/*`. If the caller does not
95
+ # have permission to access the CmekConfig, regardless of whether or not it
96
+ # exists, a PERMISSION_DENIED error is returned.
97
+ # @param [String] fields
98
+ # Selector specifying which fields to include in a partial response.
99
+ # @param [String] quota_user
100
+ # Available to use for quota purposes for server-side applications. Can be any
101
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
102
+ # @param [Google::Apis::RequestOptions] options
103
+ # Request-specific options
104
+ #
105
+ # @yield [result, err] Result & error if block supplied
106
+ # @yieldparam result [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1CmekConfig] parsed result object
107
+ # @yieldparam err [StandardError] error object if request failed
108
+ #
109
+ # @return [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1CmekConfig]
110
+ #
111
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
112
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
113
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
114
+ def get_project_location_single_cmek_config(name, fields: nil, quota_user: nil, options: nil, &block)
115
+ command = make_simple_command(:get, 'v1/{+name}', options)
116
+ command.response_representation = Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1CmekConfig::Representation
117
+ command.response_class = Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1CmekConfig
118
+ command.params['name'] = name unless name.nil?
119
+ command.query['fields'] = fields unless fields.nil?
120
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
121
+ execute_or_queue_command(command, &block)
122
+ end
123
+
124
+ # Provisions a CMEK key for use in a location of a customer's project. This
125
+ # method will also conduct location validation on the provided cmekConfig to
126
+ # make sure the key is valid and can be used in the selected location.
127
+ # @param [String] name
128
+ # Required. The name of the CmekConfig of the form `projects/`project`/locations/
129
+ # `location`/cmekConfig` or `projects/`project`/locations/`location`/cmekConfigs/
130
+ # `cmekConfig``.
131
+ # @param [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1CmekConfig] google_cloud_discoveryengine_v1_cmek_config_object
132
+ # @param [Boolean] set_default
133
+ # Set the following CmekConfig as the default to be used for child resources if
134
+ # one is not specified.
135
+ # @param [String] fields
136
+ # Selector specifying which fields to include in a partial response.
137
+ # @param [String] quota_user
138
+ # Available to use for quota purposes for server-side applications. Can be any
139
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
140
+ # @param [Google::Apis::RequestOptions] options
141
+ # Request-specific options
142
+ #
143
+ # @yield [result, err] Result & error if block supplied
144
+ # @yieldparam result [Google::Apis::DiscoveryengineV1::GoogleLongrunningOperation] parsed result object
145
+ # @yieldparam err [StandardError] error object if request failed
146
+ #
147
+ # @return [Google::Apis::DiscoveryengineV1::GoogleLongrunningOperation]
148
+ #
149
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
150
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
151
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
152
+ def update_project_location_cmek_config(name, google_cloud_discoveryengine_v1_cmek_config_object = nil, set_default: nil, fields: nil, quota_user: nil, options: nil, &block)
153
+ command = make_simple_command(:patch, 'v1/{+name}', options)
154
+ command.request_representation = Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1CmekConfig::Representation
155
+ command.request_object = google_cloud_discoveryengine_v1_cmek_config_object
156
+ command.response_representation = Google::Apis::DiscoveryengineV1::GoogleLongrunningOperation::Representation
157
+ command.response_class = Google::Apis::DiscoveryengineV1::GoogleLongrunningOperation
158
+ command.params['name'] = name unless name.nil?
159
+ command.query['setDefault'] = set_default unless set_default.nil?
160
+ command.query['fields'] = fields unless fields.nil?
161
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
162
+ execute_or_queue_command(command, &block)
163
+ end
164
+
165
+ # De-provisions a CmekConfig.
166
+ # @param [String] name
167
+ # Required. The resource name of the CmekConfig to delete, such as `projects/`
168
+ # project`/locations/`location`/cmekConfigs/`cmek_config``.
169
+ # @param [String] fields
170
+ # Selector specifying which fields to include in a partial response.
171
+ # @param [String] quota_user
172
+ # Available to use for quota purposes for server-side applications. Can be any
173
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
174
+ # @param [Google::Apis::RequestOptions] options
175
+ # Request-specific options
176
+ #
177
+ # @yield [result, err] Result & error if block supplied
178
+ # @yieldparam result [Google::Apis::DiscoveryengineV1::GoogleLongrunningOperation] parsed result object
179
+ # @yieldparam err [StandardError] error object if request failed
180
+ #
181
+ # @return [Google::Apis::DiscoveryengineV1::GoogleLongrunningOperation]
182
+ #
183
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
184
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
185
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
186
+ def delete_project_location_cmek_config(name, fields: nil, quota_user: nil, options: nil, &block)
187
+ command = make_simple_command(:delete, 'v1/{+name}', options)
188
+ command.response_representation = Google::Apis::DiscoveryengineV1::GoogleLongrunningOperation::Representation
189
+ command.response_class = Google::Apis::DiscoveryengineV1::GoogleLongrunningOperation
190
+ command.params['name'] = name unless name.nil?
191
+ command.query['fields'] = fields unless fields.nil?
192
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
193
+ execute_or_queue_command(command, &block)
194
+ end
195
+
196
+ # Gets the CmekConfig.
197
+ # @param [String] name
198
+ # Required. Resource name of CmekConfig, such as `projects/*/locations/*/
199
+ # cmekConfig` or `projects/*/locations/*/cmekConfigs/*`. If the caller does not
200
+ # have permission to access the CmekConfig, regardless of whether or not it
201
+ # exists, a PERMISSION_DENIED error is returned.
202
+ # @param [String] fields
203
+ # Selector specifying which fields to include in a partial response.
204
+ # @param [String] quota_user
205
+ # Available to use for quota purposes for server-side applications. Can be any
206
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
207
+ # @param [Google::Apis::RequestOptions] options
208
+ # Request-specific options
209
+ #
210
+ # @yield [result, err] Result & error if block supplied
211
+ # @yieldparam result [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1CmekConfig] parsed result object
212
+ # @yieldparam err [StandardError] error object if request failed
213
+ #
214
+ # @return [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1CmekConfig]
215
+ #
216
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
217
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
218
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
219
+ def get_project_location_cmek_config(name, fields: nil, quota_user: nil, options: nil, &block)
220
+ command = make_simple_command(:get, 'v1/{+name}', options)
221
+ command.response_representation = Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1CmekConfig::Representation
222
+ command.response_class = Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1CmekConfig
223
+ command.params['name'] = name unless name.nil?
224
+ command.query['fields'] = fields unless fields.nil?
225
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
226
+ execute_or_queue_command(command, &block)
227
+ end
228
+
229
+ # Lists all the CmekConfigs with the project.
230
+ # @param [String] parent
231
+ # Required. The parent location resource name, such as `projects/`project`/
232
+ # locations/`location``. If the caller does not have permission to list
233
+ # CmekConfigs under this location, regardless of whether or not a CmekConfig
234
+ # exists, a PERMISSION_DENIED error is returned.
235
+ # @param [String] fields
236
+ # Selector specifying which fields to include in a partial response.
237
+ # @param [String] quota_user
238
+ # Available to use for quota purposes for server-side applications. Can be any
239
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
240
+ # @param [Google::Apis::RequestOptions] options
241
+ # Request-specific options
242
+ #
243
+ # @yield [result, err] Result & error if block supplied
244
+ # @yieldparam result [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1ListCmekConfigsResponse] parsed result object
245
+ # @yieldparam err [StandardError] error object if request failed
246
+ #
247
+ # @return [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1ListCmekConfigsResponse]
248
+ #
249
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
250
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
251
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
252
+ def list_project_location_cmek_configs(parent, fields: nil, quota_user: nil, options: nil, &block)
253
+ command = make_simple_command(:get, 'v1/{+parent}/cmekConfigs', options)
254
+ command.response_representation = Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1ListCmekConfigsResponse::Representation
255
+ command.response_class = Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1ListCmekConfigsResponse
256
+ command.params['parent'] = parent unless parent.nil?
257
+ command.query['fields'] = fields unless fields.nil?
258
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
259
+ execute_or_queue_command(command, &block)
260
+ end
261
+
262
+ # Provisions a CMEK key for use in a location of a customer's project. This
263
+ # method will also conduct location validation on the provided cmekConfig to
264
+ # make sure the key is valid and can be used in the selected location.
265
+ # @param [String] name
266
+ # Required. The name of the CmekConfig of the form `projects/`project`/locations/
267
+ # `location`/cmekConfig` or `projects/`project`/locations/`location`/cmekConfigs/
268
+ # `cmekConfig``.
269
+ # @param [Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1CmekConfig] google_cloud_discoveryengine_v1_cmek_config_object
270
+ # @param [Boolean] set_default
271
+ # Set the following CmekConfig as the default to be used for child resources if
272
+ # one is not specified.
273
+ # @param [String] fields
274
+ # Selector specifying which fields to include in a partial response.
275
+ # @param [String] quota_user
276
+ # Available to use for quota purposes for server-side applications. Can be any
277
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
278
+ # @param [Google::Apis::RequestOptions] options
279
+ # Request-specific options
280
+ #
281
+ # @yield [result, err] Result & error if block supplied
282
+ # @yieldparam result [Google::Apis::DiscoveryengineV1::GoogleLongrunningOperation] parsed result object
283
+ # @yieldparam err [StandardError] error object if request failed
284
+ #
285
+ # @return [Google::Apis::DiscoveryengineV1::GoogleLongrunningOperation]
286
+ #
287
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
288
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
289
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
290
+ def patch_project_location_cmek_config(name, google_cloud_discoveryengine_v1_cmek_config_object = nil, set_default: nil, fields: nil, quota_user: nil, options: nil, &block)
291
+ command = make_simple_command(:patch, 'v1/{+name}', options)
292
+ command.request_representation = Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1CmekConfig::Representation
293
+ command.request_object = google_cloud_discoveryengine_v1_cmek_config_object
294
+ command.response_representation = Google::Apis::DiscoveryengineV1::GoogleLongrunningOperation::Representation
295
+ command.response_class = Google::Apis::DiscoveryengineV1::GoogleLongrunningOperation
296
+ command.params['name'] = name unless name.nil?
297
+ command.query['setDefault'] = set_default unless set_default.nil?
298
+ command.query['fields'] = fields unless fields.nil?
299
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
300
+ execute_or_queue_command(command, &block)
301
+ end
302
+
91
303
  # Gets the latest state of a long-running operation. Clients can use this method
92
304
  # to poll the operation result at intervals as recommended by the API service.
93
305
  # @param [String] name
@@ -7575,6 +7787,37 @@ module Google
7575
7787
  execute_or_queue_command(command, &block)
7576
7788
  end
7577
7789
 
7790
+ # Gets the latest state of a long-running operation. Clients can use this method
7791
+ # to poll the operation result at intervals as recommended by the API service.
7792
+ # @param [String] name
7793
+ # The name of the operation resource.
7794
+ # @param [String] fields
7795
+ # Selector specifying which fields to include in a partial response.
7796
+ # @param [String] quota_user
7797
+ # Available to use for quota purposes for server-side applications. Can be any
7798
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
7799
+ # @param [Google::Apis::RequestOptions] options
7800
+ # Request-specific options
7801
+ #
7802
+ # @yield [result, err] Result & error if block supplied
7803
+ # @yieldparam result [Google::Apis::DiscoveryengineV1::GoogleLongrunningOperation] parsed result object
7804
+ # @yieldparam err [StandardError] error object if request failed
7805
+ #
7806
+ # @return [Google::Apis::DiscoveryengineV1::GoogleLongrunningOperation]
7807
+ #
7808
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
7809
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
7810
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
7811
+ def get_project_location_podcast_operation(name, fields: nil, quota_user: nil, options: nil, &block)
7812
+ command = make_simple_command(:get, 'v1/{+name}', options)
7813
+ command.response_representation = Google::Apis::DiscoveryengineV1::GoogleLongrunningOperation::Representation
7814
+ command.response_class = Google::Apis::DiscoveryengineV1::GoogleLongrunningOperation
7815
+ command.params['name'] = name unless name.nil?
7816
+ command.query['fields'] = fields unless fields.nil?
7817
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
7818
+ execute_or_queue_command(command, &block)
7819
+ end
7820
+
7578
7821
  # Ranks a list of text records based on the given input query.
7579
7822
  # @param [String] ranking_config
7580
7823
  # Required. The resource name of the rank service config, such as `projects/`
metadata CHANGED
@@ -1,13 +1,13 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-apis-discoveryengine_v1
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.30.0
4
+ version: 0.31.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
8
8
  bindir: bin
9
9
  cert_chain: []
10
- date: 2025-03-16 00:00:00.000000000 Z
10
+ date: 2025-03-23 00:00:00.000000000 Z
11
11
  dependencies:
12
12
  - !ruby/object:Gem::Dependency
13
13
  name: google-apis-core
@@ -57,7 +57,7 @@ licenses:
57
57
  metadata:
58
58
  bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
59
59
  changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-discoveryengine_v1/CHANGELOG.md
60
- documentation_uri: https://googleapis.dev/ruby/google-apis-discoveryengine_v1/v0.30.0
60
+ documentation_uri: https://googleapis.dev/ruby/google-apis-discoveryengine_v1/v0.31.0
61
61
  source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-discoveryengine_v1
62
62
  rdoc_options: []
63
63
  require_paths: