google-apis-firestore_v1 0.77.0 → 0.78.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5d16c926cf7afc137fc9d8f0c68715663c2ea08d5fdee997500e72e8f7a884ab
-  data.tar.gz: f626502ed09adc521f8906ed68d484abe267541757b338450af09fd6dfe7e8ba
+  metadata.gz: d1015bd464ddc72d0f2f0d4d5d2c58666d9edd64a33bc5935e8de3406052cf7d
+  data.tar.gz: 19a21c1ada5adf4cda59c5bc8c4fa0471b09cee6c323505b24cf62d3d44cf941
 SHA512:
-  metadata.gz: 6ba0d1254deaf5f2f95a3f4b9b76f6a2326c1a0153b3b578af48e40c7c8f266263a76c047c93d9d1a2b20f10868bb14d68d772a58551071f9260ccc5e13fb9e4
-  data.tar.gz: bb4acfad535d1873475496f6c22799e0c55c6c1d91353767f3c32c07aaebf149bb6ee272e939b183864b106825f1160e949a7ac67ce83e09db05a1b27dbb1b25
+  metadata.gz: 2c84c49f3d07ab9b8e1fc34c507cff56d0670d44250b453dcb7bd7e0010e03b1b74afba7c95ac29ef1cbbd8bc08a57da8c728e95093e412b57b44f28e36ae259
+  data.tar.gz: 262bff697534f176cd1c462e80665adf06fcfdbdcc91873782216fcdb4b16072dee28b1f682736bc06c8551b67a50fc545705e159ae8056795f5f809d7c6f4de

data/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Release history for google-apis-firestore_v1
 
+### v0.78.0 (2025-06-29)
+
+* Regenerated from discovery document revision 20250618
+* Regenerated using generator version 0.18.0
+
 ### v0.77.0 (2025-05-11)
 
 * Regenerated using generator version 0.17.0

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

@@ -1395,6 +1395,109 @@ module Google
         end
       end
       
+      # Metadata for the long-running operation from the CloneDatabase request.
+      class GoogleFirestoreAdminV1CloneDatabaseMetadata
+        include Google::Apis::Core::Hashable
+      
+        # The name of the database being cloned to.
+        # Corresponds to the JSON property `database`
+        # @return [String]
+        attr_accessor :database
+      
+        # The time the clone finished, unset for ongoing clones.
+        # Corresponds to the JSON property `endTime`
+        # @return [String]
+        attr_accessor :end_time
+      
+        # The operation state of the clone.
+        # Corresponds to the JSON property `operationState`
+        # @return [String]
+        attr_accessor :operation_state
+      
+        # A consistent snapshot of a database at a specific point in time. A PITR (Point-
+        # in-time recovery) snapshot with previous versions of a database's data is
+        # available for every minute up to the associated database's data retention
+        # period. If the PITR feature is enabled, the retention period is 7 days;
+        # otherwise, it is one hour.
+        # Corresponds to the JSON property `pitrSnapshot`
+        # @return [Google::Apis::FirestoreV1::GoogleFirestoreAdminV1PitrSnapshot]
+        attr_accessor :pitr_snapshot
+      
+        # Describes the progress of the operation. Unit of work is generic and must be
+        # interpreted based on where Progress is used.
+        # Corresponds to the JSON property `progressPercentage`
+        # @return [Google::Apis::FirestoreV1::GoogleFirestoreAdminV1Progress]
+        attr_accessor :progress_percentage
+      
+        # The time the clone was started.
+        # Corresponds to the JSON property `startTime`
+        # @return [String]
+        attr_accessor :start_time
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @database = args[:database] if args.key?(:database)
+          @end_time = args[:end_time] if args.key?(:end_time)
+          @operation_state = args[:operation_state] if args.key?(:operation_state)
+          @pitr_snapshot = args[:pitr_snapshot] if args.key?(:pitr_snapshot)
+          @progress_percentage = args[:progress_percentage] if args.key?(:progress_percentage)
+          @start_time = args[:start_time] if args.key?(:start_time)
+        end
+      end
+      
+      # The request message for FirestoreAdmin.CloneDatabase.
+      class GoogleFirestoreAdminV1CloneDatabaseRequest
+        include Google::Apis::Core::Hashable
+      
+        # Required. The ID to use for the database, which will become the final
+        # component of the database's resource name. This database ID must not be
+        # associated with an existing database. This value should be 4-63 characters.
+        # Valid characters are /a-z-/ with first character a letter and the last a
+        # letter or a number. Must not be UUID-like /[0-9a-f]`8`(-[0-9a-f]`4`)`3`-[0-9a-
+        # f]`12`/. "(default)" database ID is also valid.
+        # Corresponds to the JSON property `databaseId`
+        # @return [String]
+        attr_accessor :database_id
+      
+        # Encryption configuration for a new database being created from another source.
+        # The source could be a Backup .
+        # Corresponds to the JSON property `encryptionConfig`
+        # @return [Google::Apis::FirestoreV1::GoogleFirestoreAdminV1EncryptionConfig]
+        attr_accessor :encryption_config
+      
+        # A consistent snapshot of a database at a specific point in time. A PITR (Point-
+        # in-time recovery) snapshot with previous versions of a database's data is
+        # available for every minute up to the associated database's data retention
+        # period. If the PITR feature is enabled, the retention period is 7 days;
+        # otherwise, it is one hour.
+        # Corresponds to the JSON property `pitrSnapshot`
+        # @return [Google::Apis::FirestoreV1::GoogleFirestoreAdminV1PitrSnapshot]
+        attr_accessor :pitr_snapshot
+      
+        # Optional. Immutable. Tags to be bound to the cloned database. The tags should
+        # be provided in the format of `tagKeys/`tag_key_id` -> tagValues/`tag_value_id``
+        # .
+        # Corresponds to the JSON property `tags`
+        # @return [Hash<String,String>]
+        attr_accessor :tags
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @database_id = args[:database_id] if args.key?(:database_id)
+          @encryption_config = args[:encryption_config] if args.key?(:encryption_config)
+          @pitr_snapshot = args[:pitr_snapshot] if args.key?(:pitr_snapshot)
+          @tags = args[:tags] if args.key?(:tags)
+        end
+      end
+      
       # The CMEK (Customer Managed Encryption Key) configuration for a Firestore
       # database. If not present, the database is secured by the default Google
       # encryption key.
@@ -2537,6 +2640,43 @@ module Google
         end
       end
       
+      # A consistent snapshot of a database at a specific point in time. A PITR (Point-
+      # in-time recovery) snapshot with previous versions of a database's data is
+      # available for every minute up to the associated database's data retention
+      # period. If the PITR feature is enabled, the retention period is 7 days;
+      # otherwise, it is one hour.
+      class GoogleFirestoreAdminV1PitrSnapshot
+        include Google::Apis::Core::Hashable
+      
+        # Required. The name of the database that this was a snapshot of. Format: `
+        # projects/`project`/databases/`database``.
+        # Corresponds to the JSON property `database`
+        # @return [String]
+        attr_accessor :database
+      
+        # Output only. Public UUID of the database the snapshot was associated with.
+        # Corresponds to the JSON property `databaseUid`
+        # NOTE: Values are automatically base64 encoded/decoded in the client library.
+        # @return [String]
+        attr_accessor :database_uid
+      
+        # Required. Snapshot time of the database.
+        # Corresponds to the JSON property `snapshotTime`
+        # @return [String]
+        attr_accessor :snapshot_time
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @database = args[:database] if args.key?(:database)
+          @database_uid = args[:database_uid] if args.key?(:database_uid)
+          @snapshot_time = args[:snapshot_time] if args.key?(:snapshot_time)
+        end
+      end
+      
       # Describes the progress of the operation. Unit of work is generic and must be
       # interpreted based on where Progress is used.
       class GoogleFirestoreAdminV1Progress

data/lib/google/apis/firestore_v1/gem_version.rb

@@ -16,13 +16,13 @@ module Google
   module Apis
     module FirestoreV1
       # Version of the google-apis-firestore_v1 gem
-      GEM_VERSION = "0.77.0"
+      GEM_VERSION = "0.78.0"
 
       # Version of the code generator used to generate this client
-      GENERATOR_VERSION = "0.17.0"
+      GENERATOR_VERSION = "0.18.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20250414"
+      REVISION = "20250618"
     end
   end
 end

data/lib/google/apis/firestore_v1/representations.rb

@@ -262,6 +262,18 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleFirestoreAdminV1CloneDatabaseMetadata
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleFirestoreAdminV1CloneDatabaseRequest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleFirestoreAdminV1CmekConfig
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -442,6 +454,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleFirestoreAdminV1PitrSnapshot
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleFirestoreAdminV1Progress
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -1149,6 +1167,32 @@ module Google
         end
       end
       
+      class GoogleFirestoreAdminV1CloneDatabaseMetadata
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :database, as: 'database'
+          property :end_time, as: 'endTime'
+          property :operation_state, as: 'operationState'
+          property :pitr_snapshot, as: 'pitrSnapshot', class: Google::Apis::FirestoreV1::GoogleFirestoreAdminV1PitrSnapshot, decorator: Google::Apis::FirestoreV1::GoogleFirestoreAdminV1PitrSnapshot::Representation
+      
+          property :progress_percentage, as: 'progressPercentage', class: Google::Apis::FirestoreV1::GoogleFirestoreAdminV1Progress, decorator: Google::Apis::FirestoreV1::GoogleFirestoreAdminV1Progress::Representation
+      
+          property :start_time, as: 'startTime'
+        end
+      end
+      
+      class GoogleFirestoreAdminV1CloneDatabaseRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :database_id, as: 'databaseId'
+          property :encryption_config, as: 'encryptionConfig', class: Google::Apis::FirestoreV1::GoogleFirestoreAdminV1EncryptionConfig, decorator: Google::Apis::FirestoreV1::GoogleFirestoreAdminV1EncryptionConfig::Representation
+      
+          property :pitr_snapshot, as: 'pitrSnapshot', class: Google::Apis::FirestoreV1::GoogleFirestoreAdminV1PitrSnapshot, decorator: Google::Apis::FirestoreV1::GoogleFirestoreAdminV1PitrSnapshot::Representation
+      
+          hash :tags, as: 'tags'
+        end
+      end
+      
       class GoogleFirestoreAdminV1CmekConfig
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -1453,6 +1497,15 @@ module Google
         end
       end
       
+      class GoogleFirestoreAdminV1PitrSnapshot
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :database, as: 'database'
+          property :database_uid, :base64 => true, as: 'databaseUid'
+          property :snapshot_time, as: 'snapshotTime'
+        end
+      end
+      
       class GoogleFirestoreAdminV1Progress
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

data/lib/google/apis/firestore_v1/service.rb

@@ -91,6 +91,48 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Creates a new database by cloning an existing one. The new database must be in
+        # the same cloud region or multi-region location as the existing database. This
+        # behaves similar to FirestoreAdmin.CreateDatabase except instead of creating a
+        # new empty database, a new database is created with the database type, index
+        # configuration, and documents from an existing database. The long-running
+        # operation can be used to track the progress of the clone, with the Operation's
+        # metadata field type being the CloneDatabaseMetadata. The response type is the
+        # Database if the clone was successful. The new database is not readable or
+        # writeable until the LRO has completed.
+        # @param [String] parent
+        #   Required. The project to clone the database in. Format is `projects/`
+        #   project_id``.
+        # @param [Google::Apis::FirestoreV1::GoogleFirestoreAdminV1CloneDatabaseRequest] google_firestore_admin_v1_clone_database_request_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::FirestoreV1::GoogleLongrunningOperation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::FirestoreV1::GoogleLongrunningOperation]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def clone_project_database(parent, google_firestore_admin_v1_clone_database_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1/{+parent}/databases:clone', options)
+          command.request_representation = Google::Apis::FirestoreV1::GoogleFirestoreAdminV1CloneDatabaseRequest::Representation
+          command.request_object = google_firestore_admin_v1_clone_database_request_object
+          command.response_representation = Google::Apis::FirestoreV1::GoogleLongrunningOperation::Representation
+          command.response_class = Google::Apis::FirestoreV1::GoogleLongrunningOperation
+          command.params['parent'] = parent unless parent.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Create a database.
         # @param [String] parent
         #   Required. A parent name of the form `projects/`project_id``

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-firestore_v1
 version: !ruby/object:Gem::Version
-  version: 0.77.0
+  version: 0.78.0
 platform: ruby
 authors:
 - Google LLC
@@ -57,7 +57,7 @@ licenses:
 metadata:
   bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
   changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-firestore_v1/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-firestore_v1/v0.77.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-firestore_v1/v0.78.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-firestore_v1
 rdoc_options: []
 require_paths:
@@ -73,7 +73,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.8
+rubygems_version: 3.6.9
 specification_version: 4
 summary: Simple REST client for Cloud Firestore API V1
 test_files: []