google-apis-firestore_v1 0.39.0 → 0.40.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 17c479452bc8d5098e825d87d006e26ffa97ce45f042235775d3f26f833e1fb9
-  data.tar.gz: b0853a54160285b512ef35811cdcfb216302e01b6da03e1fae337ce9ccb6320e
+  metadata.gz: 9f49b7196e442f0a00b5054282e2ca801c4ce4b05b34a999356ec436838a6127
+  data.tar.gz: 4ff8ff144116f5e49a2e47ef0eb1d76d7753c5a443423561403116a61b833d83
 SHA512:
-  metadata.gz: ecde6cad8b7d9322d3dd1143e961d6537dd4fa310f851bd39280a385e8c0306d623b3c342e18d4b158e8ab8f1bbc923aab31df85af4bf7beb04a0d6b3ac04268
-  data.tar.gz: 36c8dfb5c7f5ca7a692ca243f1dea66dc77ece6fa0dad89f67232604d1a408d69256e6e9e9a7df8466659c99ae7d2d7e8b98fd886ac48d353bf0b037a2ade067
+  metadata.gz: cc5fa26b3a63854c82f4818bb7306fb20341699080b73d81d3a96957f41619343188b8270aaef0e543711274ef55522313230113615b4db6eed19aa614313c9b
+  data.tar.gz: 42745540b791410f625f8116b44fe37ec72700ee0864a447a66c5664cadf31c177a360d68b7db60a6f0956c61c94258ead42cdda7956c820acf3ed699e4632d8

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Release history for google-apis-firestore_v1
 
+### v0.40.0 (2023-05-14)
+
+* Regenerated from discovery document revision 20230508
+
 ### v0.39.0 (2023-04-30)
 
 * Regenerated from discovery document revision 20230421

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

@@ -284,6 +284,88 @@ module Google
         end
       end
       
+      # A sequence of bits, encoded in a byte array. Each byte in the `bitmap` byte
+      # array stores 8 bits of the sequence. The only exception is the last byte,
+      # which may store 8 _or fewer_ bits. The `padding` defines the number of bits of
+      # the last byte to be ignored as "padding". The values of these "padding" bits
+      # are unspecified and must be ignored. To retrieve the first bit, bit 0,
+      # calculate: `(bitmap[0] & 0x01) != 0`. To retrieve the second bit, bit 1,
+      # calculate: `(bitmap[0] & 0x02) != 0`. To retrieve the third bit, bit 2,
+      # calculate: `(bitmap[0] & 0x04) != 0`. To retrieve the fourth bit, bit 3,
+      # calculate: `(bitmap[0] & 0x08) != 0`. To retrieve bit n, calculate: `(bitmap[n
+      # / 8] & (0x01 << (n % 8))) != 0`. The "size" of a `BitSequence` (the number of
+      # bits it contains) is calculated by this formula: `(bitmap.length * 8) -
+      # padding`.
+      class BitSequence
+        include Google::Apis::Core::Hashable
+      
+        # The bytes that encode the bit sequence. May have a length of zero.
+        # Corresponds to the JSON property `bitmap`
+        # NOTE: Values are automatically base64 encoded/decoded in the client library.
+        # @return [String]
+        attr_accessor :bitmap
+      
+        # The number of bits of the last byte in `bitmap` to ignore as "padding". If the
+        # length of `bitmap` is zero, then this value must be `0`. Otherwise, this value
+        # must be between 0 and 7, inclusive.
+        # Corresponds to the JSON property `padding`
+        # @return [Fixnum]
+        attr_accessor :padding
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @bitmap = args[:bitmap] if args.key?(:bitmap)
+          @padding = args[:padding] if args.key?(:padding)
+        end
+      end
+      
+      # A bloom filter (https://en.wikipedia.org/wiki/Bloom_filter). The bloom filter
+      # hashes the entries with MD5 and treats the resulting 128-bit hash as 2
+      # distinct 64-bit hash values, interpreted as unsigned integers using 2's
+      # complement encoding. These two hash values, named `h1` and `h2`, are then used
+      # to compute the `hash_count` hash values using the formula, starting at `i=0`:
+      # h(i) = h1 + (i * h2) These resulting values are then taken modulo the number
+      # of bits in the bloom filter to get the bits of the bloom filter to test for
+      # the given entry.
+      class BloomFilter
+        include Google::Apis::Core::Hashable
+      
+        # A sequence of bits, encoded in a byte array. Each byte in the `bitmap` byte
+        # array stores 8 bits of the sequence. The only exception is the last byte,
+        # which may store 8 _or fewer_ bits. The `padding` defines the number of bits of
+        # the last byte to be ignored as "padding". The values of these "padding" bits
+        # are unspecified and must be ignored. To retrieve the first bit, bit 0,
+        # calculate: `(bitmap[0] & 0x01) != 0`. To retrieve the second bit, bit 1,
+        # calculate: `(bitmap[0] & 0x02) != 0`. To retrieve the third bit, bit 2,
+        # calculate: `(bitmap[0] & 0x04) != 0`. To retrieve the fourth bit, bit 3,
+        # calculate: `(bitmap[0] & 0x08) != 0`. To retrieve bit n, calculate: `(bitmap[n
+        # / 8] & (0x01 << (n % 8))) != 0`. The "size" of a `BitSequence` (the number of
+        # bits it contains) is calculated by this formula: `(bitmap.length * 8) -
+        # padding`.
+        # Corresponds to the JSON property `bits`
+        # @return [Google::Apis::FirestoreV1::BitSequence]
+        attr_accessor :bits
+      
+        # The number of hashes used by the algorithm.
+        # Corresponds to the JSON property `hashCount`
+        # @return [Fixnum]
+        attr_accessor :hash_count
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @bits = args[:bits] if args.key?(:bits)
+          @hash_count = args[:hash_count] if args.key?(:hash_count)
+        end
+      end
+      
       # A selection of a collection, such as `messages as m1`.
       class CollectionSelector
         include Google::Apis::Core::Hashable
@@ -707,6 +789,18 @@ module Google
         # @return [Fixnum]
         attr_accessor :target_id
       
+        # A bloom filter (https://en.wikipedia.org/wiki/Bloom_filter). The bloom filter
+        # hashes the entries with MD5 and treats the resulting 128-bit hash as 2
+        # distinct 64-bit hash values, interpreted as unsigned integers using 2's
+        # complement encoding. These two hash values, named `h1` and `h2`, are then used
+        # to compute the `hash_count` hash values using the formula, starting at `i=0`:
+        # h(i) = h1 + (i * h2) These resulting values are then taken modulo the number
+        # of bits in the bloom filter to get the bits of the bloom filter to test for
+        # the given entry.
+        # Corresponds to the JSON property `unchangedNames`
+        # @return [Google::Apis::FirestoreV1::BloomFilter]
+        attr_accessor :unchanged_names
+      
         def initialize(**args)
            update!(**args)
         end
@@ -715,6 +809,7 @@ module Google
         def update!(**args)
           @count = args[:count] if args.key?(:count)
           @target_id = args[:target_id] if args.key?(:target_id)
+          @unchanged_names = args[:unchanged_names] if args.key?(:unchanged_names)
         end
       end
       
@@ -855,6 +950,139 @@ module Google
         end
       end
       
+      # A Backup of a Cloud Firestore Database. The backup contains all documents and
+      # index configurations for the given database at specific point in time.
+      class GoogleFirestoreAdminV1Backup
+        include Google::Apis::Core::Hashable
+      
+        # Output only. Name of the Firestore database that the backup is from. Format is
+        # `projects/`project`/databases/`database``.
+        # Corresponds to the JSON property `database`
+        # @return [String]
+        attr_accessor :database
+      
+        # Output only. The system-generated UUID4 for the Firestore database that the
+        # backup is from.
+        # Corresponds to the JSON property `databaseUid`
+        # @return [String]
+        attr_accessor :database_uid
+      
+        # Output only. The timestamp at which this backup expires.
+        # Corresponds to the JSON property `expireTime`
+        # @return [String]
+        attr_accessor :expire_time
+      
+        # Output only. The unique resource name of the Backup. Format is `projects/`
+        # project`/locations/`location`/backups/`backup``.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # Output only. The backup contains an externally consistent copy of the database
+        # at this time.
+        # Corresponds to the JSON property `snapshotTime`
+        # @return [String]
+        attr_accessor :snapshot_time
+      
+        # Output only. The current state of the backup.
+        # Corresponds to the JSON property `state`
+        # @return [String]
+        attr_accessor :state
+      
+        # Backup specific statistics.
+        # Corresponds to the JSON property `stats`
+        # @return [Google::Apis::FirestoreV1::GoogleFirestoreAdminV1Stats]
+        attr_accessor :stats
+      
+        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)
+          @expire_time = args[:expire_time] if args.key?(:expire_time)
+          @name = args[:name] if args.key?(:name)
+          @snapshot_time = args[:snapshot_time] if args.key?(:snapshot_time)
+          @state = args[:state] if args.key?(:state)
+          @stats = args[:stats] if args.key?(:stats)
+        end
+      end
+      
+      # A backup schedule for a Cloud Firestore Database. This resource is owned by
+      # the database it is backing up, and is deleted along with the database. The
+      # actual backups are not though.
+      class GoogleFirestoreAdminV1BackupSchedule
+        include Google::Apis::Core::Hashable
+      
+        # Output only. The timestamp at which this backup schedule was created and
+        # effective since. No backups will be created for this schedule before this time.
+        # Corresponds to the JSON property `createTime`
+        # @return [String]
+        attr_accessor :create_time
+      
+        # Represent a recurring schedule that runs at a specific time every day. The
+        # time zone is UTC.
+        # Corresponds to the JSON property `dailyRecurrence`
+        # @return [Google::Apis::FirestoreV1::GoogleFirestoreAdminV1DailyRecurrence]
+        attr_accessor :daily_recurrence
+      
+        # Output only. The unique backup schedule identifier across all locations and
+        # databases for the given project. This will be auto-assigned. Format is `
+        # projects/`project`/databases/`database`/backupSchedules/`backup_schedule``
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # At what relative time in the future, compared to the creation time of the
+        # backup should the backup be deleted, i.e. keep backups for 7 days.
+        # Corresponds to the JSON property `retention`
+        # @return [String]
+        attr_accessor :retention
+      
+        # Output only. The timestamp at which this backup schedule was most recently
+        # updated. When a backup schedule is first created, this is the same as
+        # create_time.
+        # Corresponds to the JSON property `updateTime`
+        # @return [String]
+        attr_accessor :update_time
+      
+        # Represents a recurring schedule that runs on a specified day of the week. The
+        # time zone is UTC.
+        # Corresponds to the JSON property `weeklyRecurrence`
+        # @return [Google::Apis::FirestoreV1::GoogleFirestoreAdminV1WeeklyRecurrence]
+        attr_accessor :weekly_recurrence
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @create_time = args[:create_time] if args.key?(:create_time)
+          @daily_recurrence = args[:daily_recurrence] if args.key?(:daily_recurrence)
+          @name = args[:name] if args.key?(:name)
+          @retention = args[:retention] if args.key?(:retention)
+          @update_time = args[:update_time] if args.key?(:update_time)
+          @weekly_recurrence = args[:weekly_recurrence] if args.key?(:weekly_recurrence)
+        end
+      end
+      
+      # Represent a recurring schedule that runs at a specific time every day. The
+      # time zone is UTC.
+      class GoogleFirestoreAdminV1DailyRecurrence
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
       # A Cloud Firestore Database. Currently only one database is allowed per cloud
       # project; this database must have a `database_id` of '(default)'.
       class GoogleFirestoreAdminV1Database
@@ -1519,6 +1747,55 @@ module Google
         end
       end
       
+      # The response for FirestoreAdmin.ListBackupSchedules.
+      class GoogleFirestoreAdminV1ListBackupSchedulesResponse
+        include Google::Apis::Core::Hashable
+      
+        # List of all backup schedules.
+        # Corresponds to the JSON property `backupSchedules`
+        # @return [Array<Google::Apis::FirestoreV1::GoogleFirestoreAdminV1BackupSchedule>]
+        attr_accessor :backup_schedules
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @backup_schedules = args[:backup_schedules] if args.key?(:backup_schedules)
+        end
+      end
+      
+      # The response for FirestoreAdmin.ListBackups.
+      class GoogleFirestoreAdminV1ListBackupsResponse
+        include Google::Apis::Core::Hashable
+      
+        # List of all backups for the project. Ordered by `location ASC, create_time
+        # DESC, name ASC`.
+        # Corresponds to the JSON property `backups`
+        # @return [Array<Google::Apis::FirestoreV1::GoogleFirestoreAdminV1Backup>]
+        attr_accessor :backups
+      
+        # List of locations that existing backups were not able to be fetched from.
+        # Instead of failing the entire requests when a single location is unreachable,
+        # this response returns a partial result set and list of locations unable to be
+        # reached here. The request can be retried against a single location to get a
+        # concrete error.
+        # Corresponds to the JSON property `unreachable`
+        # @return [Array<String>]
+        attr_accessor :unreachable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @backups = args[:backups] if args.key?(:backups)
+          @unreachable = args[:unreachable] if args.key?(:unreachable)
+        end
+      end
+      
       # The list of databases for a project.
       class GoogleFirestoreAdminV1ListDatabasesResponse
         include Google::Apis::Core::Hashable
@@ -1629,6 +1906,69 @@ module Google
         end
       end
       
+      # The request message for FirestoreAdmin.RestoreDatabase.
+      class GoogleFirestoreAdminV1RestoreDatabaseRequest
+        include Google::Apis::Core::Hashable
+      
+        # Required. Backup to restore from. Must be from the same project as the parent.
+        # Format is: `projects/`project_id`/locations/`location`/backups/`backup``
+        # Corresponds to the JSON property `backup`
+        # @return [String]
+        attr_accessor :backup
+      
+        # 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
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @backup = args[:backup] if args.key?(:backup)
+          @database_id = args[:database_id] if args.key?(:database_id)
+        end
+      end
+      
+      # Backup specific statistics.
+      class GoogleFirestoreAdminV1Stats
+        include Google::Apis::Core::Hashable
+      
+        # Output only. The total number of documents contained in the backup.
+        # Corresponds to the JSON property `documentCount`
+        # @return [Fixnum]
+        attr_accessor :document_count
+      
+        # Output only. The total number of index entries contained in the backup.
+        # Corresponds to the JSON property `indexCount`
+        # @return [Fixnum]
+        attr_accessor :index_count
+      
+        # Output only. Summation of the size of all documents and index entries in the
+        # backup, measured in bytes.
+        # Corresponds to the JSON property `sizeBytes`
+        # @return [Fixnum]
+        attr_accessor :size_bytes
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @document_count = args[:document_count] if args.key?(:document_count)
+          @index_count = args[:index_count] if args.key?(:index_count)
+          @size_bytes = args[:size_bytes] if args.key?(:size_bytes)
+        end
+      end
+      
       # The TTL (time-to-live) configuration for documents that have this `Field` set.
       # Storing a timestamp value into a TTL-enabled field will be treated as the
       # document's absolute expiration time. Timestamp values in the past indicate
@@ -1685,6 +2025,26 @@ module Google
         end
       end
       
+      # Represents a recurring schedule that runs on a specified day of the week. The
+      # time zone is UTC.
+      class GoogleFirestoreAdminV1WeeklyRecurrence
+        include Google::Apis::Core::Hashable
+      
+        # The day of week to run. DAY_OF_WEEK_UNSPECIFIED is not allowed.
+        # Corresponds to the JSON property `day`
+        # @return [String]
+        attr_accessor :day
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @day = args[:day] if args.key?(:day)
+        end
+      end
+      
       # The request message for Operations.CancelOperation.
       class GoogleLongrunningCancelOperationRequest
         include Google::Apis::Core::Hashable
@@ -2655,6 +3015,14 @@ module Google
         # @return [Google::Apis::FirestoreV1::DocumentsTarget]
         attr_accessor :documents
       
+        # The number of documents that last matched the query at the resume token or
+        # read time. This value is only relevant when a `resume_type` is provided. This
+        # value being present and greater than zero signals that the client wants `
+        # ExistenceFilter.unchanged_names` to be included in the response.
+        # Corresponds to the JSON property `expectedCount`
+        # @return [Fixnum]
+        attr_accessor :expected_count
+      
         # If the target should be removed once it is current and consistent.
         # Corresponds to the JSON property `once`
         # @return [Boolean]
@@ -2692,6 +3060,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @documents = args[:documents] if args.key?(:documents)
+          @expected_count = args[:expected_count] if args.key?(:expected_count)
           @once = args[:once] if args.key?(:once)
           @query = args[:query] if args.key?(:query)
           @read_time = args[:read_time] if args.key?(:read_time)

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.39.0"
+      GEM_VERSION = "0.40.0"
 
       # Version of the code generator used to generate this client
       GENERATOR_VERSION = "0.12.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20230421"
+      REVISION = "20230508"
     end
   end
 end

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

@@ -76,6 +76,18 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class BitSequence
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class BloomFilter
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class CollectionSelector
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -190,6 +202,24 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleFirestoreAdminV1Backup
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleFirestoreAdminV1BackupSchedule
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleFirestoreAdminV1DailyRecurrence
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleFirestoreAdminV1Database
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -268,6 +298,18 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleFirestoreAdminV1ListBackupSchedulesResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleFirestoreAdminV1ListBackupsResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleFirestoreAdminV1ListDatabasesResponse
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -298,6 +340,18 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleFirestoreAdminV1RestoreDatabaseRequest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleFirestoreAdminV1Stats
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleFirestoreAdminV1TtlConfig
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -316,6 +370,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleFirestoreAdminV1WeeklyRecurrence
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleLongrunningCancelOperationRequest
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -621,6 +681,23 @@ module Google
         end
       end
       
+      class BitSequence
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :bitmap, :base64 => true, as: 'bitmap'
+          property :padding, as: 'padding'
+        end
+      end
+      
+      class BloomFilter
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :bits, as: 'bits', class: Google::Apis::FirestoreV1::BitSequence, decorator: Google::Apis::FirestoreV1::BitSequence::Representation
+      
+          property :hash_count, as: 'hashCount'
+        end
+      end
+      
       class CollectionSelector
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -745,6 +822,8 @@ module Google
         class Representation < Google::Apis::Core::JsonRepresentation
           property :count, as: 'count'
           property :target_id, as: 'targetId'
+          property :unchanged_names, as: 'unchangedNames', class: Google::Apis::FirestoreV1::BloomFilter, decorator: Google::Apis::FirestoreV1::BloomFilter::Representation
+      
         end
       end
       
@@ -796,6 +875,40 @@ module Google
         end
       end
       
+      class GoogleFirestoreAdminV1Backup
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :database, as: 'database'
+          property :database_uid, as: 'databaseUid'
+          property :expire_time, as: 'expireTime'
+          property :name, as: 'name'
+          property :snapshot_time, as: 'snapshotTime'
+          property :state, as: 'state'
+          property :stats, as: 'stats', class: Google::Apis::FirestoreV1::GoogleFirestoreAdminV1Stats, decorator: Google::Apis::FirestoreV1::GoogleFirestoreAdminV1Stats::Representation
+      
+        end
+      end
+      
+      class GoogleFirestoreAdminV1BackupSchedule
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :create_time, as: 'createTime'
+          property :daily_recurrence, as: 'dailyRecurrence', class: Google::Apis::FirestoreV1::GoogleFirestoreAdminV1DailyRecurrence, decorator: Google::Apis::FirestoreV1::GoogleFirestoreAdminV1DailyRecurrence::Representation
+      
+          property :name, as: 'name'
+          property :retention, as: 'retention'
+          property :update_time, as: 'updateTime'
+          property :weekly_recurrence, as: 'weeklyRecurrence', class: Google::Apis::FirestoreV1::GoogleFirestoreAdminV1WeeklyRecurrence, decorator: Google::Apis::FirestoreV1::GoogleFirestoreAdminV1WeeklyRecurrence::Representation
+      
+        end
+      end
+      
+      class GoogleFirestoreAdminV1DailyRecurrence
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+        end
+      end
+      
       class GoogleFirestoreAdminV1Database
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -954,6 +1067,23 @@ module Google
         end
       end
       
+      class GoogleFirestoreAdminV1ListBackupSchedulesResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :backup_schedules, as: 'backupSchedules', class: Google::Apis::FirestoreV1::GoogleFirestoreAdminV1BackupSchedule, decorator: Google::Apis::FirestoreV1::GoogleFirestoreAdminV1BackupSchedule::Representation
+      
+        end
+      end
+      
+      class GoogleFirestoreAdminV1ListBackupsResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :backups, as: 'backups', class: Google::Apis::FirestoreV1::GoogleFirestoreAdminV1Backup, decorator: Google::Apis::FirestoreV1::GoogleFirestoreAdminV1Backup::Representation
+      
+          collection :unreachable, as: 'unreachable'
+        end
+      end
+      
       class GoogleFirestoreAdminV1ListDatabasesResponse
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -994,6 +1124,23 @@ module Google
         end
       end
       
+      class GoogleFirestoreAdminV1RestoreDatabaseRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :backup, as: 'backup'
+          property :database_id, as: 'databaseId'
+        end
+      end
+      
+      class GoogleFirestoreAdminV1Stats
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :document_count, :numeric_string => true, as: 'documentCount'
+          property :index_count, :numeric_string => true, as: 'indexCount'
+          property :size_bytes, :numeric_string => true, as: 'sizeBytes'
+        end
+      end
+      
       class GoogleFirestoreAdminV1TtlConfig
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -1014,6 +1161,13 @@ module Google
         end
       end
       
+      class GoogleFirestoreAdminV1WeeklyRecurrence
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :day, as: 'day'
+        end
+      end
+      
       class GoogleLongrunningCancelOperationRequest
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -1295,6 +1449,7 @@ module Google
         class Representation < Google::Apis::Core::JsonRepresentation
           property :documents, as: 'documents', class: Google::Apis::FirestoreV1::DocumentsTarget, decorator: Google::Apis::FirestoreV1::DocumentsTarget::Representation
       
+          property :expected_count, as: 'expectedCount'
           property :once, as: 'once'
           property :query, as: 'query', class: Google::Apis::FirestoreV1::QueryTarget, decorator: Google::Apis::FirestoreV1::QueryTarget::Representation
       

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

@@ -308,6 +308,216 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Create a new database by restore from an existing backup. The new database
+        # must be in the same cloud region or multi-region location as the existing
+        # backup. 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 backup. The long-
+        # running operation can be used to track the progress of the restore, with the
+        # Operation's metadata field type being the RestoreDatabaseMetadata. The
+        # response type is the Database if the restore was successful. The new database
+        # is not readable or writeable until the LRO has completed. Cancelling the
+        # returned operation will stop the restore and delete the in-progress database,
+        # if the restore is still active.
+        # @param [String] parent
+        #   Required. The project to restore the database in. Format is `projects/`
+        #   project_id``.
+        # @param [Google::Apis::FirestoreV1::GoogleFirestoreAdminV1RestoreDatabaseRequest] google_firestore_admin_v1_restore_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 restore_project_database(parent, google_firestore_admin_v1_restore_database_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1/{+parent}/databases:restore', options)
+          command.request_representation = Google::Apis::FirestoreV1::GoogleFirestoreAdminV1RestoreDatabaseRequest::Representation
+          command.request_object = google_firestore_admin_v1_restore_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
+        
+        # Creates a backup schedule on a database. At most two backup schedules can be
+        # configured on a database, one daily backup schedule with retention up to 7
+        # days and one weekly backup schedule with retention up to 14 weeks.
+        # @param [String] parent
+        #   Required. The parent database. Format `projects/`project`/databases/`database``
+        # @param [Google::Apis::FirestoreV1::GoogleFirestoreAdminV1BackupSchedule] google_firestore_admin_v1_backup_schedule_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::GoogleFirestoreAdminV1BackupSchedule] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::FirestoreV1::GoogleFirestoreAdminV1BackupSchedule]
+        #
+        # @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 create_project_database_backup_schedule(parent, google_firestore_admin_v1_backup_schedule_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1/{+parent}/backupSchedules', options)
+          command.request_representation = Google::Apis::FirestoreV1::GoogleFirestoreAdminV1BackupSchedule::Representation
+          command.request_object = google_firestore_admin_v1_backup_schedule_object
+          command.response_representation = Google::Apis::FirestoreV1::GoogleFirestoreAdminV1BackupSchedule::Representation
+          command.response_class = Google::Apis::FirestoreV1::GoogleFirestoreAdminV1BackupSchedule
+          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
+        
+        # Deletes a backup schedule.
+        # @param [String] name
+        #   Required. The name of backup schedule. Format `projects/`project`/databases/`
+        #   database`/backupSchedules/`backup_schedule``
+        # @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::Empty] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::FirestoreV1::Empty]
+        #
+        # @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 delete_project_database_backup_schedule(name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:delete, 'v1/{+name}', options)
+          command.response_representation = Google::Apis::FirestoreV1::Empty::Representation
+          command.response_class = Google::Apis::FirestoreV1::Empty
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Gets information about a backup schedule.
+        # @param [String] name
+        #   Required. The name of the backup schedule. Format `projects/`project`/
+        #   databases/`database`/backupSchedules/`backup_schedule``
+        # @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::GoogleFirestoreAdminV1BackupSchedule] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::FirestoreV1::GoogleFirestoreAdminV1BackupSchedule]
+        #
+        # @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 get_project_database_backup_schedule(name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1/{+name}', options)
+          command.response_representation = Google::Apis::FirestoreV1::GoogleFirestoreAdminV1BackupSchedule::Representation
+          command.response_class = Google::Apis::FirestoreV1::GoogleFirestoreAdminV1BackupSchedule
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # List backup schedules.
+        # @param [String] parent
+        #   Required. The parent database. Format is `projects/`project`/databases/`
+        #   database``.
+        # @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::GoogleFirestoreAdminV1ListBackupSchedulesResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::FirestoreV1::GoogleFirestoreAdminV1ListBackupSchedulesResponse]
+        #
+        # @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 list_project_database_backup_schedules(parent, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1/{+parent}/backupSchedules', options)
+          command.response_representation = Google::Apis::FirestoreV1::GoogleFirestoreAdminV1ListBackupSchedulesResponse::Representation
+          command.response_class = Google::Apis::FirestoreV1::GoogleFirestoreAdminV1ListBackupSchedulesResponse
+          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
+        
+        # Updates a backup schedule.
+        # @param [String] name
+        #   Output only. The unique backup schedule identifier across all locations and
+        #   databases for the given project. This will be auto-assigned. Format is `
+        #   projects/`project`/databases/`database`/backupSchedules/`backup_schedule``
+        # @param [Google::Apis::FirestoreV1::GoogleFirestoreAdminV1BackupSchedule] google_firestore_admin_v1_backup_schedule_object
+        # @param [String] update_mask
+        #   The list of fields to be updated.
+        # @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::GoogleFirestoreAdminV1BackupSchedule] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::FirestoreV1::GoogleFirestoreAdminV1BackupSchedule]
+        #
+        # @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 patch_project_database_backup_schedule(name, google_firestore_admin_v1_backup_schedule_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:patch, 'v1/{+name}', options)
+          command.request_representation = Google::Apis::FirestoreV1::GoogleFirestoreAdminV1BackupSchedule::Representation
+          command.request_object = google_firestore_admin_v1_backup_schedule_object
+          command.response_representation = Google::Apis::FirestoreV1::GoogleFirestoreAdminV1BackupSchedule::Representation
+          command.response_class = Google::Apis::FirestoreV1::GoogleFirestoreAdminV1BackupSchedule
+          command.params['name'] = name unless name.nil?
+          command.query['updateMask'] = update_mask unless update_mask.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Gets the metadata and configuration for a Field.
         # @param [String] name
         #   Required. A name of the form `projects/`project_id`/databases/`database_id`/
@@ -1519,6 +1729,101 @@ module Google
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)
         end
+        
+        # Deletes a backup.
+        # @param [String] name
+        #   Required. Name of the backup to delete. format is `projects/`project`/
+        #   locations/`location`/backups/`backup``.
+        # @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::Empty] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::FirestoreV1::Empty]
+        #
+        # @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 delete_project_location_backup(name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:delete, 'v1/{+name}', options)
+          command.response_representation = Google::Apis::FirestoreV1::Empty::Representation
+          command.response_class = Google::Apis::FirestoreV1::Empty
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Gets information about a backup.
+        # @param [String] name
+        #   Required. Name of the backup to fetch. Format is `projects/`project`/locations/
+        #   `location`/backups/`backup``.
+        # @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::GoogleFirestoreAdminV1Backup] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::FirestoreV1::GoogleFirestoreAdminV1Backup]
+        #
+        # @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 get_project_location_backup(name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1/{+name}', options)
+          command.response_representation = Google::Apis::FirestoreV1::GoogleFirestoreAdminV1Backup::Representation
+          command.response_class = Google::Apis::FirestoreV1::GoogleFirestoreAdminV1Backup
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Lists all the backups.
+        # @param [String] parent
+        #   Required. The location to list backups from. Format is `projects/`project`/
+        #   locations/`location``. Use ``location` = '-'` to list backups from all
+        #   locations for the given project. This allows listing backups from a single
+        #   location or from all locations.
+        # @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::GoogleFirestoreAdminV1ListBackupsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::FirestoreV1::GoogleFirestoreAdminV1ListBackupsResponse]
+        #
+        # @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 list_project_location_backups(parent, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1/{+parent}/backups', options)
+          command.response_representation = Google::Apis::FirestoreV1::GoogleFirestoreAdminV1ListBackupsResponse::Representation
+          command.response_class = Google::Apis::FirestoreV1::GoogleFirestoreAdminV1ListBackupsResponse
+          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
 
         protected
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-firestore_v1
 version: !ruby/object:Gem::Version
-  version: 0.39.0
+  version: 0.40.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-04-30 00:00:00.000000000 Z
+date: 2023-05-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-apis-core
@@ -58,7 +58,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.39.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-firestore_v1/v0.40.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-firestore_v1
 post_install_message: 
 rdoc_options: []