google-apis-discoveryengine_v1beta 0.74.0 → 0.76.0

data/lib/google/apis/discoveryengine_v1beta/classes.rb

@@ -22,6 +22,679 @@ module Google
   module Apis
     module DiscoveryengineV1beta
       
+      # Information to read/write to blobstore2.
+      class GdataBlobstore2Info
+        include Google::Apis::Core::Hashable
+      
+        # The blob generation id.
+        # Corresponds to the JSON property `blobGeneration`
+        # @return [Fixnum]
+        attr_accessor :blob_generation
+      
+        # The blob id, e.g., /blobstore/prod/playground/scotty
+        # Corresponds to the JSON property `blobId`
+        # @return [String]
+        attr_accessor :blob_id
+      
+        # Read handle passed from Bigstore -> Scotty for a GCS download. This is a
+        # signed, serialized blobstore2.ReadHandle proto which must never be set outside
+        # of Bigstore, and is not applicable to non-GCS media downloads.
+        # Corresponds to the JSON property `downloadReadHandle`
+        # NOTE: Values are automatically base64 encoded/decoded in the client library.
+        # @return [String]
+        attr_accessor :download_read_handle
+      
+        # The blob read token. Needed to read blobs that have not been replicated. Might
+        # not be available until the final call.
+        # Corresponds to the JSON property `readToken`
+        # @return [String]
+        attr_accessor :read_token
+      
+        # Metadata passed from Blobstore -> Scotty for a new GCS upload. This is a
+        # signed, serialized blobstore2.BlobMetadataContainer proto which must never be
+        # consumed outside of Bigstore, and is not applicable to non-GCS media uploads.
+        # Corresponds to the JSON property `uploadMetadataContainer`
+        # NOTE: Values are automatically base64 encoded/decoded in the client library.
+        # @return [String]
+        attr_accessor :upload_metadata_container
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @blob_generation = args[:blob_generation] if args.key?(:blob_generation)
+          @blob_id = args[:blob_id] if args.key?(:blob_id)
+          @download_read_handle = args[:download_read_handle] if args.key?(:download_read_handle)
+          @read_token = args[:read_token] if args.key?(:read_token)
+          @upload_metadata_container = args[:upload_metadata_container] if args.key?(:upload_metadata_container)
+        end
+      end
+      
+      # A sequence of media data references representing composite data. Introduced to
+      # support Bigstore composite objects. For details, visit http://go/bigstore-
+      # composites.
+      class GdataCompositeMedia
+        include Google::Apis::Core::Hashable
+      
+        # Blobstore v1 reference, set if reference_type is BLOBSTORE_REF This should be
+        # the byte representation of a blobstore.BlobRef. Since Blobstore is deprecating
+        # v1, use blobstore2_info instead. For now, any v2 blob will also be represented
+        # in this field as v1 BlobRef.
+        # Corresponds to the JSON property `blobRef`
+        # NOTE: Values are automatically base64 encoded/decoded in the client library.
+        # @return [String]
+        attr_accessor :blob_ref
+      
+        # Information to read/write to blobstore2.
+        # Corresponds to the JSON property `blobstore2Info`
+        # @return [Google::Apis::DiscoveryengineV1beta::GdataBlobstore2Info]
+        attr_accessor :blobstore2_info
+      
+        # A binary data reference for a media download. Serves as a technology-agnostic
+        # binary reference in some Google infrastructure. This value is a serialized
+        # storage_cosmo.BinaryReference proto. Storing it as bytes is a hack to get
+        # around the fact that the cosmo proto (as well as others it includes) doesn't
+        # support JavaScript. This prevents us from including the actual type of this
+        # field.
+        # Corresponds to the JSON property `cosmoBinaryReference`
+        # NOTE: Values are automatically base64 encoded/decoded in the client library.
+        # @return [String]
+        attr_accessor :cosmo_binary_reference
+      
+        # crc32.c hash for the payload.
+        # Corresponds to the JSON property `crc32cHash`
+        # @return [Fixnum]
+        attr_accessor :crc32c_hash
+      
+        # Media data, set if reference_type is INLINE
+        # Corresponds to the JSON property `inline`
+        # NOTE: Values are automatically base64 encoded/decoded in the client library.
+        # @return [String]
+        attr_accessor :inline
+      
+        # Size of the data, in bytes
+        # Corresponds to the JSON property `length`
+        # @return [Fixnum]
+        attr_accessor :length
+      
+        # MD5 hash for the payload.
+        # Corresponds to the JSON property `md5Hash`
+        # NOTE: Values are automatically base64 encoded/decoded in the client library.
+        # @return [String]
+        attr_accessor :md5_hash
+      
+        # This is a copy of the tech.blob.ObjectId proto, which could not be used
+        # directly here due to transitive closure issues with JavaScript support; see
+        # http://b/8801763.
+        # Corresponds to the JSON property `objectId`
+        # @return [Google::Apis::DiscoveryengineV1beta::GdataObjectId]
+        attr_accessor :object_id_prop
+      
+        # Path to the data, set if reference_type is PATH
+        # Corresponds to the JSON property `path`
+        # @return [String]
+        attr_accessor :path
+      
+        # Describes what the field reference contains.
+        # Corresponds to the JSON property `referenceType`
+        # @return [String]
+        attr_accessor :reference_type
+      
+        # SHA-1 hash for the payload.
+        # Corresponds to the JSON property `sha1Hash`
+        # NOTE: Values are automatically base64 encoded/decoded in the client library.
+        # @return [String]
+        attr_accessor :sha1_hash
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @blob_ref = args[:blob_ref] if args.key?(:blob_ref)
+          @blobstore2_info = args[:blobstore2_info] if args.key?(:blobstore2_info)
+          @cosmo_binary_reference = args[:cosmo_binary_reference] if args.key?(:cosmo_binary_reference)
+          @crc32c_hash = args[:crc32c_hash] if args.key?(:crc32c_hash)
+          @inline = args[:inline] if args.key?(:inline)
+          @length = args[:length] if args.key?(:length)
+          @md5_hash = args[:md5_hash] if args.key?(:md5_hash)
+          @object_id_prop = args[:object_id_prop] if args.key?(:object_id_prop)
+          @path = args[:path] if args.key?(:path)
+          @reference_type = args[:reference_type] if args.key?(:reference_type)
+          @sha1_hash = args[:sha1_hash] if args.key?(:sha1_hash)
+        end
+      end
+      
+      # Detailed Content-Type information from Scotty. The Content-Type of the media
+      # will typically be filled in by the header or Scotty's best_guess, but this
+      # extended information provides the backend with more information so that it can
+      # make a better decision if needed. This is only used on media upload requests
+      # from Scotty.
+      class GdataContentTypeInfo
+        include Google::Apis::Core::Hashable
+      
+        # Scotty's best guess of what the content type of the file is.
+        # Corresponds to the JSON property `bestGuess`
+        # @return [String]
+        attr_accessor :best_guess
+      
+        # The content type of the file derived by looking at specific bytes (i.e. "magic
+        # bytes") of the actual file.
+        # Corresponds to the JSON property `fromBytes`
+        # @return [String]
+        attr_accessor :from_bytes
+      
+        # The content type of the file derived from the file extension of the original
+        # file name used by the client.
+        # Corresponds to the JSON property `fromFileName`
+        # @return [String]
+        attr_accessor :from_file_name
+      
+        # The content type of the file as specified in the request headers, multipart
+        # headers, or RUPIO start request.
+        # Corresponds to the JSON property `fromHeader`
+        # @return [String]
+        attr_accessor :from_header
+      
+        # The content type of the file derived from the file extension of the URL path.
+        # The URL path is assumed to represent a file name (which is typically only true
+        # for agents that are providing a REST API).
+        # Corresponds to the JSON property `fromUrlPath`
+        # @return [String]
+        attr_accessor :from_url_path
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @best_guess = args[:best_guess] if args.key?(:best_guess)
+          @from_bytes = args[:from_bytes] if args.key?(:from_bytes)
+          @from_file_name = args[:from_file_name] if args.key?(:from_file_name)
+          @from_header = args[:from_header] if args.key?(:from_header)
+          @from_url_path = args[:from_url_path] if args.key?(:from_url_path)
+        end
+      end
+      
+      # Backend response for a Diff get checksums response. For details on the Scotty
+      # Diff protocol, visit http://go/scotty-diff-protocol.
+      class GdataDiffChecksumsResponse
+        include Google::Apis::Core::Hashable
+      
+        # A sequence of media data references representing composite data. Introduced to
+        # support Bigstore composite objects. For details, visit http://go/bigstore-
+        # composites.
+        # Corresponds to the JSON property `checksumsLocation`
+        # @return [Google::Apis::DiscoveryengineV1beta::GdataCompositeMedia]
+        attr_accessor :checksums_location
+      
+        # The chunk size of checksums. Must be a multiple of 256KB.
+        # Corresponds to the JSON property `chunkSizeBytes`
+        # @return [Fixnum]
+        attr_accessor :chunk_size_bytes
+      
+        # A sequence of media data references representing composite data. Introduced to
+        # support Bigstore composite objects. For details, visit http://go/bigstore-
+        # composites.
+        # Corresponds to the JSON property `objectLocation`
+        # @return [Google::Apis::DiscoveryengineV1beta::GdataCompositeMedia]
+        attr_accessor :object_location
+      
+        # The total size of the server object.
+        # Corresponds to the JSON property `objectSizeBytes`
+        # @return [Fixnum]
+        attr_accessor :object_size_bytes
+      
+        # The object version of the object the checksums are being returned for.
+        # Corresponds to the JSON property `objectVersion`
+        # @return [String]
+        attr_accessor :object_version
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @checksums_location = args[:checksums_location] if args.key?(:checksums_location)
+          @chunk_size_bytes = args[:chunk_size_bytes] if args.key?(:chunk_size_bytes)
+          @object_location = args[:object_location] if args.key?(:object_location)
+          @object_size_bytes = args[:object_size_bytes] if args.key?(:object_size_bytes)
+          @object_version = args[:object_version] if args.key?(:object_version)
+        end
+      end
+      
+      # Backend response for a Diff download response. For details on the Scotty Diff
+      # protocol, visit http://go/scotty-diff-protocol.
+      class GdataDiffDownloadResponse
+        include Google::Apis::Core::Hashable
+      
+        # A sequence of media data references representing composite data. Introduced to
+        # support Bigstore composite objects. For details, visit http://go/bigstore-
+        # composites.
+        # Corresponds to the JSON property `objectLocation`
+        # @return [Google::Apis::DiscoveryengineV1beta::GdataCompositeMedia]
+        attr_accessor :object_location
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @object_location = args[:object_location] if args.key?(:object_location)
+        end
+      end
+      
+      # A Diff upload request. For details on the Scotty Diff protocol, visit http://
+      # go/scotty-diff-protocol.
+      class GdataDiffUploadRequest
+        include Google::Apis::Core::Hashable
+      
+        # A sequence of media data references representing composite data. Introduced to
+        # support Bigstore composite objects. For details, visit http://go/bigstore-
+        # composites.
+        # Corresponds to the JSON property `checksumsInfo`
+        # @return [Google::Apis::DiscoveryengineV1beta::GdataCompositeMedia]
+        attr_accessor :checksums_info
+      
+        # A sequence of media data references representing composite data. Introduced to
+        # support Bigstore composite objects. For details, visit http://go/bigstore-
+        # composites.
+        # Corresponds to the JSON property `objectInfo`
+        # @return [Google::Apis::DiscoveryengineV1beta::GdataCompositeMedia]
+        attr_accessor :object_info
+      
+        # The object version of the object that is the base version the incoming diff
+        # script will be applied to. This field will always be filled in.
+        # Corresponds to the JSON property `objectVersion`
+        # @return [String]
+        attr_accessor :object_version
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @checksums_info = args[:checksums_info] if args.key?(:checksums_info)
+          @object_info = args[:object_info] if args.key?(:object_info)
+          @object_version = args[:object_version] if args.key?(:object_version)
+        end
+      end
+      
+      # Backend response for a Diff upload request. For details on the Scotty Diff
+      # protocol, visit http://go/scotty-diff-protocol.
+      class GdataDiffUploadResponse
+        include Google::Apis::Core::Hashable
+      
+        # The object version of the object at the server. Must be included in the end
+        # notification response. The version in the end notification response must
+        # correspond to the new version of the object that is now stored at the server,
+        # after the upload.
+        # Corresponds to the JSON property `objectVersion`
+        # @return [String]
+        attr_accessor :object_version
+      
+        # A sequence of media data references representing composite data. Introduced to
+        # support Bigstore composite objects. For details, visit http://go/bigstore-
+        # composites.
+        # Corresponds to the JSON property `originalObject`
+        # @return [Google::Apis::DiscoveryengineV1beta::GdataCompositeMedia]
+        attr_accessor :original_object
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @object_version = args[:object_version] if args.key?(:object_version)
+          @original_object = args[:original_object] if args.key?(:original_object)
+        end
+      end
+      
+      # Backend response for a Diff get version response. For details on the Scotty
+      # Diff protocol, visit http://go/scotty-diff-protocol.
+      class GdataDiffVersionResponse
+        include Google::Apis::Core::Hashable
+      
+        # The total size of the server object.
+        # Corresponds to the JSON property `objectSizeBytes`
+        # @return [Fixnum]
+        attr_accessor :object_size_bytes
+      
+        # The version of the object stored at the server.
+        # Corresponds to the JSON property `objectVersion`
+        # @return [String]
+        attr_accessor :object_version
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @object_size_bytes = args[:object_size_bytes] if args.key?(:object_size_bytes)
+          @object_version = args[:object_version] if args.key?(:object_version)
+        end
+      end
+      
+      # Parameters specific to media downloads.
+      class GdataDownloadParameters
+        include Google::Apis::Core::Hashable
+      
+        # A boolean to be returned in the response to Scotty. Allows/disallows gzip
+        # encoding of the payload content when the server thinks it's advantageous (
+        # hence, does not guarantee compression) which allows Scotty to GZip the
+        # response to the client.
+        # Corresponds to the JSON property `allowGzipCompression`
+        # @return [Boolean]
+        attr_accessor :allow_gzip_compression
+        alias_method :allow_gzip_compression?, :allow_gzip_compression
+      
+        # Determining whether or not Apiary should skip the inclusion of any Content-
+        # Range header on its response to Scotty.
+        # Corresponds to the JSON property `ignoreRange`
+        # @return [Boolean]
+        attr_accessor :ignore_range
+        alias_method :ignore_range?, :ignore_range
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @allow_gzip_compression = args[:allow_gzip_compression] if args.key?(:allow_gzip_compression)
+          @ignore_range = args[:ignore_range] if args.key?(:ignore_range)
+        end
+      end
+      
+      # A reference to data stored on the filesystem, on GFS or in blobstore.
+      class GdataMedia
+        include Google::Apis::Core::Hashable
+      
+        # Deprecated, use one of explicit hash type fields instead. Algorithm used for
+        # calculating the hash. As of 2011/01/21, "MD5" is the only possible value for
+        # this field. New values may be added at any time.
+        # Corresponds to the JSON property `algorithm`
+        # @return [String]
+        attr_accessor :algorithm
+      
+        # Use object_id instead.
+        # Corresponds to the JSON property `bigstoreObjectRef`
+        # NOTE: Values are automatically base64 encoded/decoded in the client library.
+        # @return [String]
+        attr_accessor :bigstore_object_ref
+      
+        # Blobstore v1 reference, set if reference_type is BLOBSTORE_REF This should be
+        # the byte representation of a blobstore.BlobRef. Since Blobstore is deprecating
+        # v1, use blobstore2_info instead. For now, any v2 blob will also be represented
+        # in this field as v1 BlobRef.
+        # Corresponds to the JSON property `blobRef`
+        # NOTE: Values are automatically base64 encoded/decoded in the client library.
+        # @return [String]
+        attr_accessor :blob_ref
+      
+        # Information to read/write to blobstore2.
+        # Corresponds to the JSON property `blobstore2Info`
+        # @return [Google::Apis::DiscoveryengineV1beta::GdataBlobstore2Info]
+        attr_accessor :blobstore2_info
+      
+        # A composite media composed of one or more media objects, set if reference_type
+        # is COMPOSITE_MEDIA. The media length field must be set to the sum of the
+        # lengths of all composite media objects. Note: All composite media must have
+        # length specified.
+        # Corresponds to the JSON property `compositeMedia`
+        # @return [Array<Google::Apis::DiscoveryengineV1beta::GdataCompositeMedia>]
+        attr_accessor :composite_media
+      
+        # MIME type of the data
+        # Corresponds to the JSON property `contentType`
+        # @return [String]
+        attr_accessor :content_type
+      
+        # Detailed Content-Type information from Scotty. The Content-Type of the media
+        # will typically be filled in by the header or Scotty's best_guess, but this
+        # extended information provides the backend with more information so that it can
+        # make a better decision if needed. This is only used on media upload requests
+        # from Scotty.
+        # Corresponds to the JSON property `contentTypeInfo`
+        # @return [Google::Apis::DiscoveryengineV1beta::GdataContentTypeInfo]
+        attr_accessor :content_type_info
+      
+        # A binary data reference for a media download. Serves as a technology-agnostic
+        # binary reference in some Google infrastructure. This value is a serialized
+        # storage_cosmo.BinaryReference proto. Storing it as bytes is a hack to get
+        # around the fact that the cosmo proto (as well as others it includes) doesn't
+        # support JavaScript. This prevents us from including the actual type of this
+        # field.
+        # Corresponds to the JSON property `cosmoBinaryReference`
+        # NOTE: Values are automatically base64 encoded/decoded in the client library.
+        # @return [String]
+        attr_accessor :cosmo_binary_reference
+      
+        # For Scotty Uploads: Scotty-provided hashes for uploads For Scotty Downloads: (
+        # WARNING: DO NOT USE WITHOUT PERMISSION FROM THE SCOTTY TEAM.) A Hash provided
+        # by the agent to be used to verify the data being downloaded. Currently only
+        # supported for inline payloads. Further, only crc32c_hash is currently
+        # supported.
+        # Corresponds to the JSON property `crc32cHash`
+        # @return [Fixnum]
+        attr_accessor :crc32c_hash
+      
+        # Backend response for a Diff get checksums response. For details on the Scotty
+        # Diff protocol, visit http://go/scotty-diff-protocol.
+        # Corresponds to the JSON property `diffChecksumsResponse`
+        # @return [Google::Apis::DiscoveryengineV1beta::GdataDiffChecksumsResponse]
+        attr_accessor :diff_checksums_response
+      
+        # Backend response for a Diff download response. For details on the Scotty Diff
+        # protocol, visit http://go/scotty-diff-protocol.
+        # Corresponds to the JSON property `diffDownloadResponse`
+        # @return [Google::Apis::DiscoveryengineV1beta::GdataDiffDownloadResponse]
+        attr_accessor :diff_download_response
+      
+        # A Diff upload request. For details on the Scotty Diff protocol, visit http://
+        # go/scotty-diff-protocol.
+        # Corresponds to the JSON property `diffUploadRequest`
+        # @return [Google::Apis::DiscoveryengineV1beta::GdataDiffUploadRequest]
+        attr_accessor :diff_upload_request
+      
+        # Backend response for a Diff upload request. For details on the Scotty Diff
+        # protocol, visit http://go/scotty-diff-protocol.
+        # Corresponds to the JSON property `diffUploadResponse`
+        # @return [Google::Apis::DiscoveryengineV1beta::GdataDiffUploadResponse]
+        attr_accessor :diff_upload_response
+      
+        # Backend response for a Diff get version response. For details on the Scotty
+        # Diff protocol, visit http://go/scotty-diff-protocol.
+        # Corresponds to the JSON property `diffVersionResponse`
+        # @return [Google::Apis::DiscoveryengineV1beta::GdataDiffVersionResponse]
+        attr_accessor :diff_version_response
+      
+        # Parameters specific to media downloads.
+        # Corresponds to the JSON property `downloadParameters`
+        # @return [Google::Apis::DiscoveryengineV1beta::GdataDownloadParameters]
+        attr_accessor :download_parameters
+      
+        # Original file name
+        # Corresponds to the JSON property `filename`
+        # @return [String]
+        attr_accessor :filename
+      
+        # Deprecated, use one of explicit hash type fields instead. These two hash
+        # related fields will only be populated on Scotty based media uploads and will
+        # contain the content of the hash group in the NotificationRequest: http://cs/#
+        # google3/blobstore2/api/scotty/service/proto/upload_listener.proto&q=class:Hash
+        # Hex encoded hash value of the uploaded media.
+        # Corresponds to the JSON property `hash`
+        # @return [String]
+        attr_accessor :hash_prop
+      
+        # For Scotty uploads only. If a user sends a hash code and the backend has
+        # requested that Scotty verify the upload against the client hash, Scotty will
+        # perform the check on behalf of the backend and will reject it if the hashes
+        # don't match. This is set to true if Scotty performed this verification.
+        # Corresponds to the JSON property `hashVerified`
+        # @return [Boolean]
+        attr_accessor :hash_verified
+        alias_method :hash_verified?, :hash_verified
+      
+        # Media data, set if reference_type is INLINE
+        # Corresponds to the JSON property `inline`
+        # NOTE: Values are automatically base64 encoded/decoded in the client library.
+        # @return [String]
+        attr_accessor :inline
+      
+        # |is_potential_retry| is set false only when Scotty is certain that it has not
+        # sent the request before. When a client resumes an upload, this field must be
+        # set true in agent calls, because Scotty cannot be certain that it has never
+        # sent the request before due to potential failure in the session state
+        # persistence.
+        # Corresponds to the JSON property `isPotentialRetry`
+        # @return [Boolean]
+        attr_accessor :is_potential_retry
+        alias_method :is_potential_retry?, :is_potential_retry
+      
+        # Size of the data, in bytes
+        # Corresponds to the JSON property `length`
+        # @return [Fixnum]
+        attr_accessor :length
+      
+        # Scotty-provided MD5 hash for an upload.
+        # Corresponds to the JSON property `md5Hash`
+        # NOTE: Values are automatically base64 encoded/decoded in the client library.
+        # @return [String]
+        attr_accessor :md5_hash
+      
+        # Media id to forward to the operation GetMedia. Can be set if reference_type is
+        # GET_MEDIA.
+        # Corresponds to the JSON property `mediaId`
+        # NOTE: Values are automatically base64 encoded/decoded in the client library.
+        # @return [String]
+        attr_accessor :media_id
+      
+        # This is a copy of the tech.blob.ObjectId proto, which could not be used
+        # directly here due to transitive closure issues with JavaScript support; see
+        # http://b/8801763.
+        # Corresponds to the JSON property `objectId`
+        # @return [Google::Apis::DiscoveryengineV1beta::GdataObjectId]
+        attr_accessor :object_id_prop
+      
+        # Path to the data, set if reference_type is PATH
+        # Corresponds to the JSON property `path`
+        # @return [String]
+        attr_accessor :path
+      
+        # Describes what the field reference contains.
+        # Corresponds to the JSON property `referenceType`
+        # @return [String]
+        attr_accessor :reference_type
+      
+        # Scotty-provided SHA1 hash for an upload.
+        # Corresponds to the JSON property `sha1Hash`
+        # NOTE: Values are automatically base64 encoded/decoded in the client library.
+        # @return [String]
+        attr_accessor :sha1_hash
+      
+        # Scotty-provided SHA256 hash for an upload.
+        # Corresponds to the JSON property `sha256Hash`
+        # NOTE: Values are automatically base64 encoded/decoded in the client library.
+        # @return [String]
+        attr_accessor :sha256_hash
+      
+        # Time at which the media data was last updated, in milliseconds since UNIX
+        # epoch
+        # Corresponds to the JSON property `timestamp`
+        # @return [Fixnum]
+        attr_accessor :timestamp
+      
+        # A unique fingerprint/version id for the media data
+        # Corresponds to the JSON property `token`
+        # @return [String]
+        attr_accessor :token
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @algorithm = args[:algorithm] if args.key?(:algorithm)
+          @bigstore_object_ref = args[:bigstore_object_ref] if args.key?(:bigstore_object_ref)
+          @blob_ref = args[:blob_ref] if args.key?(:blob_ref)
+          @blobstore2_info = args[:blobstore2_info] if args.key?(:blobstore2_info)
+          @composite_media = args[:composite_media] if args.key?(:composite_media)
+          @content_type = args[:content_type] if args.key?(:content_type)
+          @content_type_info = args[:content_type_info] if args.key?(:content_type_info)
+          @cosmo_binary_reference = args[:cosmo_binary_reference] if args.key?(:cosmo_binary_reference)
+          @crc32c_hash = args[:crc32c_hash] if args.key?(:crc32c_hash)
+          @diff_checksums_response = args[:diff_checksums_response] if args.key?(:diff_checksums_response)
+          @diff_download_response = args[:diff_download_response] if args.key?(:diff_download_response)
+          @diff_upload_request = args[:diff_upload_request] if args.key?(:diff_upload_request)
+          @diff_upload_response = args[:diff_upload_response] if args.key?(:diff_upload_response)
+          @diff_version_response = args[:diff_version_response] if args.key?(:diff_version_response)
+          @download_parameters = args[:download_parameters] if args.key?(:download_parameters)
+          @filename = args[:filename] if args.key?(:filename)
+          @hash_prop = args[:hash_prop] if args.key?(:hash_prop)
+          @hash_verified = args[:hash_verified] if args.key?(:hash_verified)
+          @inline = args[:inline] if args.key?(:inline)
+          @is_potential_retry = args[:is_potential_retry] if args.key?(:is_potential_retry)
+          @length = args[:length] if args.key?(:length)
+          @md5_hash = args[:md5_hash] if args.key?(:md5_hash)
+          @media_id = args[:media_id] if args.key?(:media_id)
+          @object_id_prop = args[:object_id_prop] if args.key?(:object_id_prop)
+          @path = args[:path] if args.key?(:path)
+          @reference_type = args[:reference_type] if args.key?(:reference_type)
+          @sha1_hash = args[:sha1_hash] if args.key?(:sha1_hash)
+          @sha256_hash = args[:sha256_hash] if args.key?(:sha256_hash)
+          @timestamp = args[:timestamp] if args.key?(:timestamp)
+          @token = args[:token] if args.key?(:token)
+        end
+      end
+      
+      # This is a copy of the tech.blob.ObjectId proto, which could not be used
+      # directly here due to transitive closure issues with JavaScript support; see
+      # http://b/8801763.
+      class GdataObjectId
+        include Google::Apis::Core::Hashable
+      
+        # The name of the bucket to which this object belongs.
+        # Corresponds to the JSON property `bucketName`
+        # @return [String]
+        attr_accessor :bucket_name
+      
+        # Generation of the object. Generations are monotonically increasing across
+        # writes, allowing them to be be compared to determine which generation is newer.
+        # If this is omitted in a request, then you are requesting the live object. See
+        # http://go/bigstore-versions
+        # Corresponds to the JSON property `generation`
+        # @return [Fixnum]
+        attr_accessor :generation
+      
+        # The name of the object.
+        # Corresponds to the JSON property `objectName`
+        # @return [String]
+        attr_accessor :object_name
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @bucket_name = args[:bucket_name] if args.key?(:bucket_name)
+          @generation = args[:generation] if args.key?(:generation)
+          @object_name = args[:object_name] if args.key?(:object_name)
+        end
+      end
+      
       # `Distribution` contains summary statistics for a population of values. It
       # optionally contains a histogram representing the distribution of those values
       # across a set of buckets. The summary statistics are the count, mean, sum of
@@ -867,6 +1540,28 @@ module Google
         end
       end
       
+      # Discovery Engine Assistant resource.
+      class GoogleCloudDiscoveryengineV1Assistant
+        include Google::Apis::Core::Hashable
+      
+        # Immutable. Resource name of the assistant. Format: `projects/`project`/
+        # locations/`location`/collections/`collection`/engines/`engine`/assistants/`
+        # assistant`` It must be a UTF-8 encoded string with a length limit of 1024
+        # characters.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @name = args[:name] if args.key?(:name)
+        end
+      end
+      
       # Metadata related to the progress of the SiteSearchEngineService.
       # BatchCreateTargetSites operation. This will be returned by the google.
       # longrunning.Operation.metadata field.
@@ -989,14 +1684,14 @@ module Google
         attr_accessor :is_default
         alias_method :is_default?, :is_default
       
-        # KMS key resource name which will be used to encrypt resources `projects/`
-        # project`/locations/`location`/keyRings/`keyRing`/cryptoKeys/`keyId``.
+        # Required. KMS key resource name which will be used to encrypt resources `
+        # projects/`project`/locations/`location`/keyRings/`keyRing`/cryptoKeys/`keyId``.
         # Corresponds to the JSON property `kmsKey`
         # @return [String]
         attr_accessor :kms_key
       
-        # KMS key version resource name which will be used to encrypt resources `/
-        # cryptoKeyVersions/`keyVersion``.
+        # Output only. KMS key version resource name which will be used to encrypt
+        # resources `/cryptoKeyVersions/`keyVersion``.
         # Corresponds to the JSON property `kmsKeyVersion`
         # @return [String]
         attr_accessor :kms_key_version
@@ -5617,14 +6312,14 @@ module Google
         attr_accessor :is_default
         alias_method :is_default?, :is_default
       
-        # KMS key resource name which will be used to encrypt resources `projects/`
-        # project`/locations/`location`/keyRings/`keyRing`/cryptoKeys/`keyId``.
+        # Required. KMS key resource name which will be used to encrypt resources `
+        # projects/`project`/locations/`location`/keyRings/`keyRing`/cryptoKeys/`keyId``.
         # Corresponds to the JSON property `kmsKey`
         # @return [String]
         attr_accessor :kms_key
       
-        # KMS key version resource name which will be used to encrypt resources `/
-        # cryptoKeyVersions/`keyVersion``.
+        # Output only. KMS key version resource name which will be used to encrypt
+        # resources `/cryptoKeyVersions/`keyVersion``.
         # Corresponds to the JSON property `kmsKeyVersion`
         # @return [String]
         attr_accessor :kms_key_version
@@ -8543,6 +9238,48 @@ module Google
         end
       end
       
+      # Metadata related to the progress of the Export operation. This is returned by
+      # the google.longrunning.Operation.metadata field.
+      class GoogleCloudDiscoveryengineV1alphaExportMetricsMetadata
+        include Google::Apis::Core::Hashable
+      
+        # Operation create time.
+        # Corresponds to the JSON property `createTime`
+        # @return [String]
+        attr_accessor :create_time
+      
+        # Operation last update time. If the operation is done, this is also the finish
+        # time.
+        # Corresponds to the JSON property `updateTime`
+        # @return [String]
+        attr_accessor :update_time
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @create_time = args[:create_time] if args.key?(:create_time)
+          @update_time = args[:update_time] if args.key?(:update_time)
+        end
+      end
+      
+      # Response of the ExportMetricsRequest. If the long running operation was
+      # successful, then this message is returned by the google.longrunning.Operations.
+      # response field.
+      class GoogleCloudDiscoveryengineV1alphaExportMetricsResponse
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
       # Configurations for fields of a schema. For example, configuring a field is
       # indexable, or searchable.
       class GoogleCloudDiscoveryengineV1alphaFieldConfig
@@ -9359,9 +10096,12 @@ module Google
       class GoogleCloudDiscoveryengineV1alphaListSessionsRequest
         include Google::Apis::Core::Hashable
       
-        # A filter to apply on the list results. The supported features are:
-        # user_pseudo_id, state, starred. Examples: "user_pseudo_id = some_id" "starred =
-        # true"
+        # A comma-separated list of fields to filter by, in EBNF grammar. The supported
+        # fields are: * `user_pseudo_id` * `state` * `display_name` * `starred` * `
+        # is_pinned` * `labels` * `create_time` * `update_time` Examples: * `
+        # user_pseudo_id = some_id` * `display_name = "some_name"` * `starred = true` * `
+        # is_pinned=true AND (NOT labels:hidden)` * `create_time > "1970-01-01T12:00:00Z"
+        # `
         # Corresponds to the JSON property `filter`
         # @return [String]
         attr_accessor :filter
@@ -11532,6 +12272,17 @@ module Google
       class GoogleCloudDiscoveryengineV1alphaSearchRequestNaturalLanguageQueryUnderstandingSpec
         include Google::Apis::Core::Hashable
       
+        # Optional. Controls behavior of how extracted filters are applied to the search.
+        # The default behavior depends on the request. For single datastore structured
+        # search, the default is `HARD_FILTER`. For multi-datastore search, the default
+        # behavior is `SOFT_BOOST`. Location-based filters are always applied as hard
+        # filters, and the `SOFT_BOOST` setting will not affect them. This field is only
+        # used if SearchRequest.natural_language_query_understanding_spec.
+        # filter_extraction_condition is set to FilterExtractionCondition.ENABLED.
+        # Corresponds to the JSON property `extractedFilterBehavior`
+        # @return [String]
+        attr_accessor :extracted_filter_behavior
+      
         # The condition under which filter extraction should occur. Server behavior
         # defaults to `DISABLED`.
         # Corresponds to the JSON property `filterExtractionCondition`
@@ -11553,6 +12304,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @extracted_filter_behavior = args[:extracted_filter_behavior] if args.key?(:extracted_filter_behavior)
           @filter_extraction_condition = args[:filter_extraction_condition] if args.key?(:filter_extraction_condition)
           @geo_search_query_detection_field_names = args[:geo_search_query_detection_field_names] if args.key?(:geo_search_query_detection_field_names)
         end
@@ -14820,6 +15572,14 @@ module Google
         # @return [Array<String>]
         attr_accessor :assist_skipped_reasons
       
+        # Immutable. Identifier. Resource name of the `AssistAnswer`. Format: `projects/`
+        # project`/locations/`location`/collections/`collection`/engines/`engine`/
+        # sessions/`session`/assistAnswers/`assist_answer`` This field must be a UTF-8
+        # encoded string with a length limit of 1024 characters.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
         # Replies of the assistant.
         # Corresponds to the JSON property `replies`
         # @return [Array<Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaAssistAnswerReply>]
@@ -14837,6 +15597,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @assist_skipped_reasons = args[:assist_skipped_reasons] if args.key?(:assist_skipped_reasons)
+          @name = args[:name] if args.key?(:name)
           @replies = args[:replies] if args.key?(:replies)
           @state = args[:state] if args.key?(:state)
         end
@@ -14890,6 +15651,28 @@ module Google
         end
       end
       
+      # Discovery Engine Assistant resource.
+      class GoogleCloudDiscoveryengineV1betaAssistant
+        include Google::Apis::Core::Hashable
+      
+        # Immutable. Resource name of the assistant. Format: `projects/`project`/
+        # locations/`location`/collections/`collection`/engines/`engine`/assistants/`
+        # assistant`` It must be a UTF-8 encoded string with a length limit of 1024
+        # characters.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @name = args[:name] if args.key?(:name)
+        end
+      end
+      
       # Multi-modal content.
       class GoogleCloudDiscoveryengineV1betaAssistantContent
         include Google::Apis::Core::Hashable
@@ -16228,14 +17011,14 @@ module Google
         attr_accessor :is_default
         alias_method :is_default?, :is_default
       
-        # KMS key resource name which will be used to encrypt resources `projects/`
-        # project`/locations/`location`/keyRings/`keyRing`/cryptoKeys/`keyId``.
+        # Required. KMS key resource name which will be used to encrypt resources `
+        # projects/`project`/locations/`location`/keyRings/`keyRing`/cryptoKeys/`keyId``.
         # Corresponds to the JSON property `kmsKey`
         # @return [String]
         attr_accessor :kms_key
       
-        # KMS key version resource name which will be used to encrypt resources `/
-        # cryptoKeyVersions/`keyVersion``.
+        # Output only. KMS key version resource name which will be used to encrypt
+        # resources `/cryptoKeyVersions/`keyVersion``.
         # Corresponds to the JSON property `kmsKeyVersion`
         # @return [String]
         attr_accessor :kms_key_version
@@ -21215,6 +21998,11 @@ module Google
         # @return [String]
         attr_accessor :data_use_terms_version
       
+        # Parameters for Agentspace.
+        # Corresponds to the JSON property `saasParams`
+        # @return [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaProvisionProjectRequestSaasParams]
+        attr_accessor :saas_params
+      
         def initialize(**args)
            update!(**args)
         end
@@ -21223,6 +22011,28 @@ module Google
         def update!(**args)
           @accept_data_use_terms = args[:accept_data_use_terms] if args.key?(:accept_data_use_terms)
           @data_use_terms_version = args[:data_use_terms_version] if args.key?(:data_use_terms_version)
+          @saas_params = args[:saas_params] if args.key?(:saas_params)
+        end
+      end
+      
+      # Parameters for Agentspace.
+      class GoogleCloudDiscoveryengineV1betaProvisionProjectRequestSaasParams
+        include Google::Apis::Core::Hashable
+      
+        # Optional. Set to `true` to specify that caller has read and would like to give
+        # consent to the [Terms for Agent Space quality of service].
+        # Corresponds to the JSON property `acceptBizQos`
+        # @return [Boolean]
+        attr_accessor :accept_biz_qos
+        alias_method :accept_biz_qos?, :accept_biz_qos
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @accept_biz_qos = args[:accept_biz_qos] if args.key?(:accept_biz_qos)
         end
       end
       
@@ -21700,7 +22510,7 @@ module Google
         # @return [String]
         attr_accessor :query
       
-        # Required. A list of records to rank. At most 200 records to rank.
+        # Required. A list of records to rank.
         # Corresponds to the JSON property `records`
         # @return [Array<Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaRankingRecord>]
         attr_accessor :records
@@ -23713,6 +24523,17 @@ module Google
       class GoogleCloudDiscoveryengineV1betaSearchRequestNaturalLanguageQueryUnderstandingSpec
         include Google::Apis::Core::Hashable
       
+        # Optional. Controls behavior of how extracted filters are applied to the search.
+        # The default behavior depends on the request. For single datastore structured
+        # search, the default is `HARD_FILTER`. For multi-datastore search, the default
+        # behavior is `SOFT_BOOST`. Location-based filters are always applied as hard
+        # filters, and the `SOFT_BOOST` setting will not affect them. This field is only
+        # used if SearchRequest.natural_language_query_understanding_spec.
+        # filter_extraction_condition is set to FilterExtractionCondition.ENABLED.
+        # Corresponds to the JSON property `extractedFilterBehavior`
+        # @return [String]
+        attr_accessor :extracted_filter_behavior
+      
         # The condition under which filter extraction should occur. Server behavior
         # defaults to `DISABLED`.
         # Corresponds to the JSON property `filterExtractionCondition`
@@ -23734,6 +24555,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @extracted_filter_behavior = args[:extracted_filter_behavior] if args.key?(:extracted_filter_behavior)
           @filter_extraction_condition = args[:filter_extraction_condition] if args.key?(:filter_extraction_condition)
           @geo_search_query_detection_field_names = args[:geo_search_query_detection_field_names] if args.key?(:geo_search_query_detection_field_names)
         end
@@ -25556,12 +26378,6 @@ module Google
         # @return [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaStreamAssistRequestToolsSpecImageGenerationSpec]
         attr_accessor :image_generation_spec
       
-        # Optional. The name of the tool registry to use. Format: `projects/`project`/
-        # locations/`location`/toolRegistries/`tool_registry``
-        # Corresponds to the JSON property `toolRegistry`
-        # @return [String]
-        attr_accessor :tool_registry
-      
         # Specification of the Vertex AI Search tool.
         # Corresponds to the JSON property `vertexAiSearchSpec`
         # @return [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaStreamAssistRequestToolsSpecVertexAiSearchSpec]
@@ -25584,7 +26400,6 @@ module Google
         # Update properties of this object
         def update!(**args)
           @image_generation_spec = args[:image_generation_spec] if args.key?(:image_generation_spec)
-          @tool_registry = args[:tool_registry] if args.key?(:tool_registry)
           @vertex_ai_search_spec = args[:vertex_ai_search_spec] if args.key?(:vertex_ai_search_spec)
           @video_generation_spec = args[:video_generation_spec] if args.key?(:video_generation_spec)
           @web_grounding_spec = args[:web_grounding_spec] if args.key?(:web_grounding_spec)
@@ -25615,14 +26430,6 @@ module Google
         # @return [Array<Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaSearchRequestDataStoreSpec>]
         attr_accessor :data_store_specs
       
-        # Optional. Deprecated. Please refrain from using this field. Whether the Vertex
-        # AI Search tool is disabled. Default value is false, the tool is enabled by
-        # default.
-        # Corresponds to the JSON property `disabled`
-        # @return [Boolean]
-        attr_accessor :disabled
-        alias_method :disabled?, :disabled
-      
         # Optional. The filter syntax consists of an expression language for
         # constructing a predicate from one or more fields of the documents being
         # filtered. Filter expression is case-sensitive. If this field is unrecognizable,
@@ -25645,7 +26452,6 @@ module Google
         # Update properties of this object
         def update!(**args)
           @data_store_specs = args[:data_store_specs] if args.key?(:data_store_specs)
-          @disabled = args[:disabled] if args.key?(:disabled)
           @filter = args[:filter] if args.key?(:filter)
         end
       end
@@ -25667,20 +26473,12 @@ module Google
       class GoogleCloudDiscoveryengineV1betaStreamAssistRequestToolsSpecWebGroundingSpec
         include Google::Apis::Core::Hashable
       
-        # Optional. Deprecated. Please refrain from using this field. Whether the web
-        # grounding tool is enabled.
-        # Corresponds to the JSON property `enabled`
-        # @return [Boolean]
-        attr_accessor :enabled
-        alias_method :enabled?, :enabled
-      
         def initialize(**args)
            update!(**args)
         end
       
         # Update properties of this object
         def update!(**args)
-          @enabled = args[:enabled] if args.key?(:enabled)
         end
       end