google-apis-sheets_v4 0.39.0 → 0.41.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f801b72d0d557a3014db491b284b087b294d167319f313e7654c35af3afaf95a
-  data.tar.gz: 735fc8f7c4f74bca2aaff356970c0f4e6e391ce792a9bfc22f9d1165aa34b191
+  metadata.gz: b480e5466bc36e73ba80e34972d75d8dd6e211caa0dfe2443b5c5a46b451f8cc
+  data.tar.gz: e6468749cdaaebd44ae206dc484a97562eda9518c89b4674cdff525b7afd0f20
 SHA512:
-  metadata.gz: 2c33f5df075b9582a90fddba9f444df323b732114d3afd6e6234b26394c097b145146a693cb01aa5641ddfe18444d2700191ae7648f9e987c4fe0991f8468487
-  data.tar.gz: 670d7a9a161172862c86641f40178e18f2a61bc92d703fabe92ff2885868aeb4bdb68c91c5ebcab2e1026a07c68b98a6fe561765d59d5bc9759095d7dc8ca4e6
+  metadata.gz: 69a7b293eb23a968ef1f77f1ee0ef74aac21a20e0b335653efe6d4865183586dba6fe3954568a2c5caa90ea2eed6c7d61039bc89a0eefddeeaafff9acae1c352
+  data.tar.gz: e957e669f3bfbe7e54d155682c7c5b5619d2b707dc7dc549e104f0bd5103791de4407bb23dc1115fb53d79f989c4e6a8a8d9313bcbdd458f8ea68dc63eb37e30

data/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Release history for google-apis-sheets_v4
 
+### v0.41.0 (2025-04-27)
+
+* Regenerated from discovery document revision 20250415
+
+### v0.40.0 (2025-04-06)
+
+* Regenerated from discovery document revision 20250325
+* Regenerated using generator version 0.16.0
+
 ### v0.39.0 (2024-12-15)
 
 * Regenerated from discovery document revision 20241203

data/OVERVIEW.md

@@ -79,7 +79,7 @@ Gem names for modern clients are often of the form `google-cloud-<service_name>`
 
 **For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure.
 
-The [product documentation](https://developers.google.com/sheets/) may provide guidance regarding the preferred client library to use.
+The [product documentation](https://developers.google.com/workspace/sheets/) may provide guidance regarding the preferred client library to use.
 
 ## Supported Ruby versions
 

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

@@ -424,6 +424,25 @@ module Google
         end
       end
       
+      # Adds a new table to the spreadsheet.
+      class AddTableRequest
+        include Google::Apis::Core::Hashable
+      
+        # A table.
+        # Corresponds to the JSON property `table`
+        # @return [Google::Apis::SheetsV4::Table]
+        attr_accessor :table
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @table = args[:table] if args.key?(:table)
+        end
+      end
+      
       # Adds new cells after the last row with data in a sheet, inserting new rows
       # into the sheet if necessary.
       class AppendCellsRequest
@@ -446,6 +465,12 @@ module Google
         # @return [Fixnum]
         attr_accessor :sheet_id
       
+        # The ID of the table to append data to. The data will be only appended to the
+        # table body. This field also takes precedence over the `sheet_id` field.
+        # Corresponds to the JSON property `tableId`
+        # @return [String]
+        attr_accessor :table_id
+      
         def initialize(**args)
            update!(**args)
         end
@@ -455,6 +480,7 @@ module Google
           @fields = args[:fields] if args.key?(:fields)
           @rows = args[:rows] if args.key?(:rows)
           @sheet_id = args[:sheet_id] if args.key?(:sheet_id)
+          @table_id = args[:table_id] if args.key?(:table_id)
         end
       end
       
@@ -1394,6 +1420,12 @@ module Google
         # @return [Array<Google::Apis::SheetsV4::SortSpec>]
         attr_accessor :sort_specs
       
+        # The table this filter is backed by, if any. When writing, only one of range or
+        # table_id may be set.
+        # Corresponds to the JSON property `tableId`
+        # @return [String]
+        attr_accessor :table_id
+      
         def initialize(**args)
            update!(**args)
         end
@@ -1404,6 +1436,7 @@ module Google
           @filter_specs = args[:filter_specs] if args.key?(:filter_specs)
           @range = args[:range] if args.key?(:range)
           @sort_specs = args[:sort_specs] if args.key?(:sort_specs)
+          @table_id = args[:table_id] if args.key?(:table_id)
         end
       end
       
@@ -1513,10 +1546,10 @@ module Google
       class BatchClearValuesByDataFilterResponse
         include Google::Apis::Core::Hashable
       
-        # The ranges that were cleared, in [A1 notation](/sheets/api/guides/concepts#
-        # cell). If the requests are for an unbounded range or a ranger larger than the
-        # bounds of the sheet, this is the actual ranges that were cleared, bounded to
-        # the sheet's limits.
+        # The ranges that were cleared, in [A1 notation](https://developers.google.com/
+        # workspace/sheets/api/guides/concepts#cell). If the requests are for an
+        # unbounded range or a ranger larger than the bounds of the sheet, this is the
+        # actual ranges that were cleared, bounded to the sheet's limits.
         # Corresponds to the JSON property `clearedRanges`
         # @return [Array<String>]
         attr_accessor :cleared_ranges
@@ -1541,8 +1574,8 @@ module Google
       class BatchClearValuesRequest
         include Google::Apis::Core::Hashable
       
-        # The ranges to clear, in [A1 notation or R1C1 notation](/sheets/api/guides/
-        # concepts#cell).
+        # The ranges to clear, in [A1 notation or R1C1 notation](https://developers.
+        # google.com/workspace/sheets/api/guides/concepts#cell).
         # Corresponds to the JSON property `ranges`
         # @return [Array<String>]
         attr_accessor :ranges
@@ -4860,6 +4893,25 @@ module Google
         end
       end
       
+      # Removes the table with the given ID from the spreadsheet.
+      class DeleteTableRequest
+        include Google::Apis::Core::Hashable
+      
+        # The ID of the table to delete.
+        # Corresponds to the JSON property `tableId`
+        # @return [String]
+        attr_accessor :table_id
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @table_id = args[:table_id] if args.key?(:table_id)
+        end
+      end
+      
       # Developer metadata associated with a location or object in a spreadsheet.
       # Developer metadata may be used to associate arbitrary data with various parts
       # of a spreadsheet and will remain associated at those locations as they move
@@ -5699,7 +5751,7 @@ module Google
         attr_accessor :filter_view_id
       
         # The named range this filter view is backed by, if any. When writing, only one
-        # of range or named_range_id may be set.
+        # of range or named_range_id or table_id may be set.
         # Corresponds to the JSON property `namedRangeId`
         # @return [String]
         attr_accessor :named_range_id
@@ -5727,6 +5779,12 @@ module Google
         # @return [Array<Google::Apis::SheetsV4::SortSpec>]
         attr_accessor :sort_specs
       
+        # The table this filter view is backed by, if any. When writing, only one of
+        # range or named_range_id or table_id may be set.
+        # Corresponds to the JSON property `tableId`
+        # @return [String]
+        attr_accessor :table_id
+      
         # The name of the filter view.
         # Corresponds to the JSON property `title`
         # @return [String]
@@ -5744,6 +5802,7 @@ module Google
           @named_range_id = args[:named_range_id] if args.key?(:named_range_id)
           @range = args[:range] if args.key?(:range)
           @sort_specs = args[:sort_specs] if args.key?(:sort_specs)
+          @table_id = args[:table_id] if args.key?(:table_id)
           @title = args[:title] if args.key?(:title)
         end
       end
@@ -5893,6 +5952,12 @@ module Google
         # @return [Array<Google::Apis::SheetsV4::DataFilter>]
         attr_accessor :data_filters
       
+        # True if tables should be excluded in the banded ranges. False if not set.
+        # Corresponds to the JSON property `excludeTablesInBandedRanges`
+        # @return [Boolean]
+        attr_accessor :exclude_tables_in_banded_ranges
+        alias_method :exclude_tables_in_banded_ranges?, :exclude_tables_in_banded_ranges
+      
         # True if grid data should be returned. This parameter is ignored if a field
         # mask was set in the request.
         # Corresponds to the JSON property `includeGridData`
@@ -5907,6 +5972,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @data_filters = args[:data_filters] if args.key?(:data_filters)
+          @exclude_tables_in_banded_ranges = args[:exclude_tables_in_banded_ranges] if args.key?(:exclude_tables_in_banded_ranges)
           @include_grid_data = args[:include_grid_data] if args.key?(:include_grid_data)
         end
       end
@@ -6874,8 +6940,8 @@ module Google
       
         # Pattern string used for formatting. If not set, a default pattern based on the
         # user's locale will be used if necessary for the given type. See the [Date and
-        # Number Formats guide](/sheets/api/guides/formats) for more information about
-        # the supported patterns.
+        # Number Formats guide](https://developers.google.com/workspace/sheets/api/
+        # guides/formats) for more information about the supported patterns.
         # Corresponds to the JSON property `pattern`
         # @return [String]
         attr_accessor :pattern
@@ -7738,7 +7804,7 @@ module Google
         attr_accessor :editors
       
         # The named range this protected range is backed by, if any. When writing, only
-        # one of range or named_range_id may be set.
+        # one of range or named_range_id or table_id may be set.
         # Corresponds to the JSON property `namedRangeId`
         # @return [String]
         attr_accessor :named_range_id
@@ -7772,6 +7838,12 @@ module Google
         attr_accessor :requesting_user_can_edit
         alias_method :requesting_user_can_edit?, :requesting_user_can_edit
       
+        # The table this protected range is backed by, if any. When writing, only one of
+        # range or named_range_id or table_id may be set.
+        # Corresponds to the JSON property `tableId`
+        # @return [String]
+        attr_accessor :table_id
+      
         # The list of unprotected ranges within a protected sheet. Unprotected ranges
         # are only supported on protected sheets.
         # Corresponds to the JSON property `unprotectedRanges`
@@ -7802,6 +7874,7 @@ module Google
           @protected_range_id = args[:protected_range_id] if args.key?(:protected_range_id)
           @range = args[:range] if args.key?(:range)
           @requesting_user_can_edit = args[:requesting_user_can_edit] if args.key?(:requesting_user_can_edit)
+          @table_id = args[:table_id] if args.key?(:table_id)
           @unprotected_ranges = args[:unprotected_ranges] if args.key?(:unprotected_ranges)
           @warning_only = args[:warning_only] if args.key?(:warning_only)
         end
@@ -8090,6 +8163,11 @@ module Google
         # @return [Google::Apis::SheetsV4::AddSlicerRequest]
         attr_accessor :add_slicer
       
+        # Adds a new table to the spreadsheet.
+        # Corresponds to the JSON property `addTable`
+        # @return [Google::Apis::SheetsV4::AddTableRequest]
+        attr_accessor :add_table
+      
         # Adds new cells after the last row with data in a sheet, inserting new rows
         # into the sheet if necessary.
         # Corresponds to the JSON property `appendCells`
@@ -8217,6 +8295,11 @@ module Google
         # @return [Google::Apis::SheetsV4::DeleteSheetRequest]
         attr_accessor :delete_sheet
       
+        # Removes the table with the given ID from the spreadsheet.
+        # Corresponds to the JSON property `deleteTable`
+        # @return [Google::Apis::SheetsV4::DeleteTableRequest]
+        attr_accessor :delete_table
+      
         # Duplicates a particular filter view.
         # Corresponds to the JSON property `duplicateFilterView`
         # @return [Google::Apis::SheetsV4::DuplicateFilterViewRequest]
@@ -8422,6 +8505,11 @@ module Google
         # @return [Google::Apis::SheetsV4::UpdateSpreadsheetPropertiesRequest]
         attr_accessor :update_spreadsheet_properties
       
+        # Updates a table in the spreadsheet.
+        # Corresponds to the JSON property `updateTable`
+        # @return [Google::Apis::SheetsV4::UpdateTableRequest]
+        attr_accessor :update_table
+      
         def initialize(**args)
            update!(**args)
         end
@@ -8438,6 +8526,7 @@ module Google
           @add_protected_range = args[:add_protected_range] if args.key?(:add_protected_range)
           @add_sheet = args[:add_sheet] if args.key?(:add_sheet)
           @add_slicer = args[:add_slicer] if args.key?(:add_slicer)
+          @add_table = args[:add_table] if args.key?(:add_table)
           @append_cells = args[:append_cells] if args.key?(:append_cells)
           @append_dimension = args[:append_dimension] if args.key?(:append_dimension)
           @auto_fill = args[:auto_fill] if args.key?(:auto_fill)
@@ -8460,6 +8549,7 @@ module Google
           @delete_protected_range = args[:delete_protected_range] if args.key?(:delete_protected_range)
           @delete_range = args[:delete_range] if args.key?(:delete_range)
           @delete_sheet = args[:delete_sheet] if args.key?(:delete_sheet)
+          @delete_table = args[:delete_table] if args.key?(:delete_table)
           @duplicate_filter_view = args[:duplicate_filter_view] if args.key?(:duplicate_filter_view)
           @duplicate_sheet = args[:duplicate_sheet] if args.key?(:duplicate_sheet)
           @find_replace = args[:find_replace] if args.key?(:find_replace)
@@ -8494,6 +8584,7 @@ module Google
           @update_sheet_properties = args[:update_sheet_properties] if args.key?(:update_sheet_properties)
           @update_slicer_spec = args[:update_slicer_spec] if args.key?(:update_slicer_spec)
           @update_spreadsheet_properties = args[:update_spreadsheet_properties] if args.key?(:update_spreadsheet_properties)
+          @update_table = args[:update_table] if args.key?(:update_table)
         end
       end
       
@@ -8926,6 +9017,11 @@ module Google
         # @return [Array<Google::Apis::SheetsV4::Slicer>]
         attr_accessor :slicers
       
+        # The tables on this sheet.
+        # Corresponds to the JSON property `tables`
+        # @return [Array<Google::Apis::SheetsV4::Table>]
+        attr_accessor :tables
+      
         def initialize(**args)
            update!(**args)
         end
@@ -8945,6 +9041,7 @@ module Google
           @protected_ranges = args[:protected_ranges] if args.key?(:protected_ranges)
           @row_groups = args[:row_groups] if args.key?(:row_groups)
           @slicers = args[:slicers] if args.key?(:slicers)
+          @tables = args[:tables] if args.key?(:tables)
         end
       end
       
@@ -9618,6 +9715,156 @@ module Google
         end
       end
       
+      # A table.
+      class Table
+        include Google::Apis::Core::Hashable
+      
+        # The table column properties.
+        # Corresponds to the JSON property `columnProperties`
+        # @return [Array<Google::Apis::SheetsV4::TableColumnProperties>]
+        attr_accessor :column_properties
+      
+        # The table name. This is unique to all tables in the same spreadsheet.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # A range on a sheet. All indexes are zero-based. Indexes are half open, i.e.
+        # the start index is inclusive and the end index is exclusive -- [start_index,
+        # end_index). Missing indexes indicate the range is unbounded on that side. For
+        # example, if `"Sheet1"` is sheet ID 123456, then: `Sheet1!A1:A1 == sheet_id:
+        # 123456, start_row_index: 0, end_row_index: 1, start_column_index: 0,
+        # end_column_index: 1` `Sheet1!A3:B4 == sheet_id: 123456, start_row_index: 2,
+        # end_row_index: 4, start_column_index: 0, end_column_index: 2` `Sheet1!A:B ==
+        # sheet_id: 123456, start_column_index: 0, end_column_index: 2` `Sheet1!A5:B ==
+        # sheet_id: 123456, start_row_index: 4, start_column_index: 0, end_column_index:
+        # 2` `Sheet1 == sheet_id: 123456` The start index must always be less than or
+        # equal to the end index. If the start index equals the end index, then the
+        # range is empty. Empty ranges are typically not meaningful and are usually
+        # rendered in the UI as `#REF!`.
+        # Corresponds to the JSON property `range`
+        # @return [Google::Apis::SheetsV4::GridRange]
+        attr_accessor :range
+      
+        # The table row properties.
+        # Corresponds to the JSON property `rowsProperties`
+        # @return [Google::Apis::SheetsV4::TableRowsProperties]
+        attr_accessor :rows_properties
+      
+        # The id of the table.
+        # Corresponds to the JSON property `tableId`
+        # @return [String]
+        attr_accessor :table_id
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @column_properties = args[:column_properties] if args.key?(:column_properties)
+          @name = args[:name] if args.key?(:name)
+          @range = args[:range] if args.key?(:range)
+          @rows_properties = args[:rows_properties] if args.key?(:rows_properties)
+          @table_id = args[:table_id] if args.key?(:table_id)
+        end
+      end
+      
+      # A data validation rule for a column in a table.
+      class TableColumnDataValidationRule
+        include Google::Apis::Core::Hashable
+      
+        # A condition that can evaluate to true or false. BooleanConditions are used by
+        # conditional formatting, data validation, and the criteria in filters.
+        # Corresponds to the JSON property `condition`
+        # @return [Google::Apis::SheetsV4::BooleanCondition]
+        attr_accessor :condition
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @condition = args[:condition] if args.key?(:condition)
+        end
+      end
+      
+      # The table column.
+      class TableColumnProperties
+        include Google::Apis::Core::Hashable
+      
+        # The 0-based column index. This index is relative to its position in the table
+        # and is not necessarily the same as the column index in the sheet.
+        # Corresponds to the JSON property `columnIndex`
+        # @return [Fixnum]
+        attr_accessor :column_index
+      
+        # The column name.
+        # Corresponds to the JSON property `columnName`
+        # @return [String]
+        attr_accessor :column_name
+      
+        # The column type.
+        # Corresponds to the JSON property `columnType`
+        # @return [String]
+        attr_accessor :column_type
+      
+        # A data validation rule for a column in a table.
+        # Corresponds to the JSON property `dataValidationRule`
+        # @return [Google::Apis::SheetsV4::TableColumnDataValidationRule]
+        attr_accessor :data_validation_rule
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @column_index = args[:column_index] if args.key?(:column_index)
+          @column_name = args[:column_name] if args.key?(:column_name)
+          @column_type = args[:column_type] if args.key?(:column_type)
+          @data_validation_rule = args[:data_validation_rule] if args.key?(:data_validation_rule)
+        end
+      end
+      
+      # The table row properties.
+      class TableRowsProperties
+        include Google::Apis::Core::Hashable
+      
+        # A color value.
+        # Corresponds to the JSON property `firstBandColorStyle`
+        # @return [Google::Apis::SheetsV4::ColorStyle]
+        attr_accessor :first_band_color_style
+      
+        # A color value.
+        # Corresponds to the JSON property `footerColorStyle`
+        # @return [Google::Apis::SheetsV4::ColorStyle]
+        attr_accessor :footer_color_style
+      
+        # A color value.
+        # Corresponds to the JSON property `headerColorStyle`
+        # @return [Google::Apis::SheetsV4::ColorStyle]
+        attr_accessor :header_color_style
+      
+        # A color value.
+        # Corresponds to the JSON property `secondBandColorStyle`
+        # @return [Google::Apis::SheetsV4::ColorStyle]
+        attr_accessor :second_band_color_style
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @first_band_color_style = args[:first_band_color_style] if args.key?(:first_band_color_style)
+          @footer_color_style = args[:footer_color_style] if args.key?(:footer_color_style)
+          @header_color_style = args[:header_color_style] if args.key?(:header_color_style)
+          @second_band_color_style = args[:second_band_color_style] if args.key?(:second_band_color_style)
+        end
+      end
+      
       # The format of a run of text in a cell. Absent values indicate that the field
       # isn't specified.
       class TextFormat
@@ -11101,6 +11348,33 @@ module Google
         end
       end
       
+      # Updates a table in the spreadsheet.
+      class UpdateTableRequest
+        include Google::Apis::Core::Hashable
+      
+        # Required. The fields that should be updated. At least one field must be
+        # specified. The root `table` is implied and should not be specified. A single `"
+        # *"` can be used as short-hand for listing every field.
+        # Corresponds to the JSON property `fields`
+        # @return [String]
+        attr_accessor :fields
+      
+        # A table.
+        # Corresponds to the JSON property `table`
+        # @return [Google::Apis::SheetsV4::Table]
+        attr_accessor :table
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @fields = args[:fields] if args.key?(:fields)
+          @table = args[:table] if args.key?(:table)
+        end
+      end
+      
       # The response when updating a range of values by a data filter in a spreadsheet.
       class UpdateValuesByDataFilterResponse
         include Google::Apis::Core::Hashable
@@ -11125,8 +11399,8 @@ module Google
         # @return [Google::Apis::SheetsV4::ValueRange]
         attr_accessor :updated_data
       
-        # The range (in [A1 notation](/sheets/api/guides/concepts#cell)) that updates
-        # were applied to.
+        # The range (in [A1 notation](https://developers.google.com/workspace/sheets/api/
+        # guides/concepts#cell)) that updates were applied to.
         # Corresponds to the JSON property `updatedRange`
         # @return [String]
         attr_accessor :updated_range
@@ -11215,11 +11489,11 @@ module Google
         # @return [String]
         attr_accessor :major_dimension
       
-        # The range the values cover, in [A1 notation](/sheets/api/guides/concepts#cell).
-        # For output, this range indicates the entire requested range, even though the
-        # values will exclude trailing rows and columns. When appending values, this
-        # field represents the range to search for a table, after which values will be
-        # appended.
+        # The range the values cover, in [A1 notation](https://developers.google.com/
+        # workspace/sheets/api/guides/concepts#cell). For output, this range indicates
+        # the entire requested range, even though the values will exclude trailing rows
+        # and columns. When appending values, this field represents the range to search
+        # for a table, after which values will be appended.
         # Corresponds to the JSON property `range`
         # @return [String]
         attr_accessor :range

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

@@ -16,13 +16,13 @@ module Google
   module Apis
     module SheetsV4
       # Version of the google-apis-sheets_v4 gem
-      GEM_VERSION = "0.39.0"
+      GEM_VERSION = "0.41.0"
 
       # Version of the code generator used to generate this client
-      GENERATOR_VERSION = "0.15.1"
+      GENERATOR_VERSION = "0.16.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20241203"
+      REVISION = "20250415"
     end
   end
 end

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

@@ -136,6 +136,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class AddTableRequest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class AppendCellsRequest
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -754,6 +760,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class DeleteTableRequest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class DeveloperMetadata
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -1276,6 +1288,30 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class Table
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class TableColumnDataValidationRule
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class TableColumnProperties
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class TableRowsProperties
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class TextFormat
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -1474,6 +1510,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class UpdateTableRequest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class UpdateValuesByDataFilterResponse
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -1677,6 +1719,14 @@ module Google
         end
       end
       
+      class AddTableRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :table, as: 'table', class: Google::Apis::SheetsV4::Table, decorator: Google::Apis::SheetsV4::Table::Representation
+      
+        end
+      end
+      
       class AppendCellsRequest
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -1684,6 +1734,7 @@ module Google
           collection :rows, as: 'rows', class: Google::Apis::SheetsV4::RowData, decorator: Google::Apis::SheetsV4::RowData::Representation
       
           property :sheet_id, as: 'sheetId'
+          property :table_id, as: 'tableId'
         end
       end
       
@@ -1860,6 +1911,7 @@ module Google
       
           collection :sort_specs, as: 'sortSpecs', class: Google::Apis::SheetsV4::SortSpec, decorator: Google::Apis::SheetsV4::SortSpec::Representation
       
+          property :table_id, as: 'tableId'
         end
       end
       
@@ -2810,6 +2862,13 @@ module Google
         end
       end
       
+      class DeleteTableRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :table_id, as: 'tableId'
+        end
+      end
+      
       class DeveloperMetadata
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -3016,6 +3075,7 @@ module Google
       
           collection :sort_specs, as: 'sortSpecs', class: Google::Apis::SheetsV4::SortSpec, decorator: Google::Apis::SheetsV4::SortSpec::Representation
       
+          property :table_id, as: 'tableId'
           property :title, as: 'title'
         end
       end
@@ -3052,6 +3112,7 @@ module Google
         class Representation < Google::Apis::Core::JsonRepresentation
           collection :data_filters, as: 'dataFilters', class: Google::Apis::SheetsV4::DataFilter, decorator: Google::Apis::SheetsV4::DataFilter::Representation
       
+          property :exclude_tables_in_banded_ranges, as: 'excludeTablesInBandedRanges'
           property :include_grid_data, as: 'includeGridData'
         end
       end
@@ -3504,6 +3565,7 @@ module Google
           property :range, as: 'range', class: Google::Apis::SheetsV4::GridRange, decorator: Google::Apis::SheetsV4::GridRange::Representation
       
           property :requesting_user_can_edit, as: 'requestingUserCanEdit'
+          property :table_id, as: 'tableId'
           collection :unprotected_ranges, as: 'unprotectedRanges', class: Google::Apis::SheetsV4::GridRange, decorator: Google::Apis::SheetsV4::GridRange::Representation
       
           property :warning_only, as: 'warningOnly'
@@ -3589,6 +3651,8 @@ module Google
       
           property :add_slicer, as: 'addSlicer', class: Google::Apis::SheetsV4::AddSlicerRequest, decorator: Google::Apis::SheetsV4::AddSlicerRequest::Representation
       
+          property :add_table, as: 'addTable', class: Google::Apis::SheetsV4::AddTableRequest, decorator: Google::Apis::SheetsV4::AddTableRequest::Representation
+      
           property :append_cells, as: 'appendCells', class: Google::Apis::SheetsV4::AppendCellsRequest, decorator: Google::Apis::SheetsV4::AppendCellsRequest::Representation
       
           property :append_dimension, as: 'appendDimension', class: Google::Apis::SheetsV4::AppendDimensionRequest, decorator: Google::Apis::SheetsV4::AppendDimensionRequest::Representation
@@ -3633,6 +3697,8 @@ module Google
       
           property :delete_sheet, as: 'deleteSheet', class: Google::Apis::SheetsV4::DeleteSheetRequest, decorator: Google::Apis::SheetsV4::DeleteSheetRequest::Representation
       
+          property :delete_table, as: 'deleteTable', class: Google::Apis::SheetsV4::DeleteTableRequest, decorator: Google::Apis::SheetsV4::DeleteTableRequest::Representation
+      
           property :duplicate_filter_view, as: 'duplicateFilterView', class: Google::Apis::SheetsV4::DuplicateFilterViewRequest, decorator: Google::Apis::SheetsV4::DuplicateFilterViewRequest::Representation
       
           property :duplicate_sheet, as: 'duplicateSheet', class: Google::Apis::SheetsV4::DuplicateSheetRequest, decorator: Google::Apis::SheetsV4::DuplicateSheetRequest::Representation
@@ -3701,6 +3767,8 @@ module Google
       
           property :update_spreadsheet_properties, as: 'updateSpreadsheetProperties', class: Google::Apis::SheetsV4::UpdateSpreadsheetPropertiesRequest, decorator: Google::Apis::SheetsV4::UpdateSpreadsheetPropertiesRequest::Representation
       
+          property :update_table, as: 'updateTable', class: Google::Apis::SheetsV4::UpdateTableRequest, decorator: Google::Apis::SheetsV4::UpdateTableRequest::Representation
+      
         end
       end
       
@@ -3849,6 +3917,8 @@ module Google
       
           collection :slicers, as: 'slicers', class: Google::Apis::SheetsV4::Slicer, decorator: Google::Apis::SheetsV4::Slicer::Representation
       
+          collection :tables, as: 'tables', class: Google::Apis::SheetsV4::Table, decorator: Google::Apis::SheetsV4::Table::Representation
+      
         end
       end
       
@@ -3987,6 +4057,53 @@ module Google
         end
       end
       
+      class Table
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :column_properties, as: 'columnProperties', class: Google::Apis::SheetsV4::TableColumnProperties, decorator: Google::Apis::SheetsV4::TableColumnProperties::Representation
+      
+          property :name, as: 'name'
+          property :range, as: 'range', class: Google::Apis::SheetsV4::GridRange, decorator: Google::Apis::SheetsV4::GridRange::Representation
+      
+          property :rows_properties, as: 'rowsProperties', class: Google::Apis::SheetsV4::TableRowsProperties, decorator: Google::Apis::SheetsV4::TableRowsProperties::Representation
+      
+          property :table_id, as: 'tableId'
+        end
+      end
+      
+      class TableColumnDataValidationRule
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :condition, as: 'condition', class: Google::Apis::SheetsV4::BooleanCondition, decorator: Google::Apis::SheetsV4::BooleanCondition::Representation
+      
+        end
+      end
+      
+      class TableColumnProperties
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :column_index, as: 'columnIndex'
+          property :column_name, as: 'columnName'
+          property :column_type, as: 'columnType'
+          property :data_validation_rule, as: 'dataValidationRule', class: Google::Apis::SheetsV4::TableColumnDataValidationRule, decorator: Google::Apis::SheetsV4::TableColumnDataValidationRule::Representation
+      
+        end
+      end
+      
+      class TableRowsProperties
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :first_band_color_style, as: 'firstBandColorStyle', class: Google::Apis::SheetsV4::ColorStyle, decorator: Google::Apis::SheetsV4::ColorStyle::Representation
+      
+          property :footer_color_style, as: 'footerColorStyle', class: Google::Apis::SheetsV4::ColorStyle, decorator: Google::Apis::SheetsV4::ColorStyle::Representation
+      
+          property :header_color_style, as: 'headerColorStyle', class: Google::Apis::SheetsV4::ColorStyle, decorator: Google::Apis::SheetsV4::ColorStyle::Representation
+      
+          property :second_band_color_style, as: 'secondBandColorStyle', class: Google::Apis::SheetsV4::ColorStyle, decorator: Google::Apis::SheetsV4::ColorStyle::Representation
+      
+        end
+      end
+      
       class TextFormat
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -4347,6 +4464,15 @@ module Google
         end
       end
       
+      class UpdateTableRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :fields, as: 'fields'
+          property :table, as: 'table', class: Google::Apis::SheetsV4::Table, decorator: Google::Apis::SheetsV4::Table::Representation
+      
+        end
+      end
+      
       class UpdateValuesByDataFilterResponse
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

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

@@ -30,7 +30,7 @@ module Google
       #    Sheets = Google::Apis::SheetsV4 # Alias the module
       #    service = Sheets::SheetsService.new
       #
-      # @see https://developers.google.com/sheets/
+      # @see https://developers.google.com/workspace/sheets/
       class SheetsService < Google::Apis::Core::BaseService
         DEFAULT_ENDPOINT_TEMPLATE = "https://sheets.$UNIVERSE_DOMAIN$/"
 
@@ -128,20 +128,22 @@ module Google
         # Returns the spreadsheet at the given ID. The caller must specify the
         # spreadsheet ID. By default, data within grids is not returned. You can include
         # grid data in one of 2 ways: * Specify a [field mask](https://developers.google.
-        # com/sheets/api/guides/field-masks) listing your desired fields using the `
-        # fields` URL parameter in HTTP * Set the includeGridData URL parameter to true.
-        # If a field mask is set, the `includeGridData` parameter is ignored For large
-        # spreadsheets, as a best practice, retrieve only the specific spreadsheet
+        # com/workspace/sheets/api/guides/field-masks) listing your desired fields using
+        # the `fields` URL parameter in HTTP * Set the includeGridData URL parameter to
+        # true. If a field mask is set, the `includeGridData` parameter is ignored For
+        # large spreadsheets, as a best practice, retrieve only the specific spreadsheet
         # fields that you want. To retrieve only subsets of spreadsheet data, use the
-        # ranges URL parameter. Ranges are specified using [A1 notation](/sheets/api/
-        # guides/concepts#cell). You can define a single cell (for example, `A1`) or
-        # multiple cells (for example, `A1:D5`). You can also get cells from other
-        # sheets within the same spreadsheet (for example, `Sheet2!A1:C4`) or retrieve
-        # multiple ranges at once (for example, `?ranges=A1:D5&ranges=Sheet2!A1:C4`).
-        # Limiting the range returns only the portions of the spreadsheet that intersect
-        # the requested ranges.
+        # ranges URL parameter. Ranges are specified using [A1 notation](https://
+        # developers.google.com/workspace/sheets/api/guides/concepts#cell). You can
+        # define a single cell (for example, `A1`) or multiple cells (for example, `A1:
+        # D5`). You can also get cells from other sheets within the same spreadsheet (
+        # for example, `Sheet2!A1:C4`) or retrieve multiple ranges at once (for example,
+        # `?ranges=A1:D5&ranges=Sheet2!A1:C4`). Limiting the range returns only the
+        # portions of the spreadsheet that intersect the requested ranges.
         # @param [String] spreadsheet_id
         #   The spreadsheet to request.
+        # @param [Boolean] exclude_tables_in_banded_ranges
+        #   True if tables should be excluded in the banded ranges. False if not set.
         # @param [Boolean] include_grid_data
         #   True if grid data should be returned. This parameter is ignored if a field
         #   mask was set in the request.
@@ -164,11 +166,12 @@ module Google
         # @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_spreadsheet(spreadsheet_id, include_grid_data: nil, ranges: nil, fields: nil, quota_user: nil, options: nil, &block)
+        def get_spreadsheet(spreadsheet_id, exclude_tables_in_banded_ranges: nil, include_grid_data: nil, ranges: nil, fields: nil, quota_user: nil, options: nil, &block)
           command = make_simple_command(:get, 'v4/spreadsheets/{spreadsheetId}', options)
           command.response_representation = Google::Apis::SheetsV4::Spreadsheet::Representation
           command.response_class = Google::Apis::SheetsV4::Spreadsheet
           command.params['spreadsheetId'] = spreadsheet_id unless spreadsheet_id.nil?
+          command.query['excludeTablesInBandedRanges'] = exclude_tables_in_banded_ranges unless exclude_tables_in_banded_ranges.nil?
           command.query['includeGridData'] = include_grid_data unless include_grid_data.nil?
           command.query['ranges'] = ranges unless ranges.nil?
           command.query['fields'] = fields unless fields.nil?
@@ -183,8 +186,8 @@ module Google
         # or more data filters returns the portions of the spreadsheet that intersect
         # ranges matched by any of the filters. By default, data within grids is not
         # returned. You can include grid data one of 2 ways: * Specify a [field mask](
-        # https://developers.google.com/sheets/api/guides/field-masks) listing your
-        # desired fields using the `fields` URL parameter in HTTP * Set the
+        # https://developers.google.com/workspace/sheets/api/guides/field-masks) listing
+        # your desired fields using the `fields` URL parameter in HTTP * Set the
         # includeGridData parameter to true. If a field mask is set, the `
         # includeGridData` parameter is ignored For large spreadsheets, as a best
         # practice, retrieve only the specific spreadsheet fields that you want.
@@ -331,7 +334,8 @@ module Google
         # Appends values to a spreadsheet. The input range is used to search for
         # existing data and find a "table" within that range. Values will be appended to
         # the next row of the table, starting with the first column of the table. See
-        # the [guide](/sheets/api/guides/values#appending_values) and [sample code](/
+        # the [guide](https://developers.google.com/workspace/sheets/api/guides/values#
+        # appending_values) and [sample code](https://developers.google.com/workspace/
         # sheets/api/samples/writing#append_values) for specific details of how tables
         # are detected and data is appended. The caller must specify the spreadsheet ID,
         # range, and a valueInputOption. The `valueInputOption` only controls how the
@@ -340,8 +344,9 @@ module Google
         # @param [String] spreadsheet_id
         #   The ID of the spreadsheet to update.
         # @param [String] range
-        #   The [A1 notation](/sheets/api/guides/concepts#cell) of a range to search for a
-        #   logical table of data. Values are appended after the last row of the table.
+        #   The [A1 notation](https://developers.google.com/workspace/sheets/api/guides/
+        #   concepts#cell) of a range to search for a logical table of data. Values are
+        #   appended after the last row of the table.
         # @param [Google::Apis::SheetsV4::ValueRange] value_range_object
         # @param [Boolean] include_values_in_response
         #   Determines if the update response should include the values of the cells that
@@ -479,8 +484,8 @@ module Google
         #   majorDimension=ROWS` returns `[[1,2],[3,4]]`, whereas requesting `ranges=["A1:
         #   B2"],majorDimension=COLUMNS` returns `[[1,3],[2,4]]`.
         # @param [Array<String>, String] ranges
-        #   The [A1 notation or R1C1 notation](/sheets/api/guides/concepts#cell) of the
-        #   range to retrieve values from.
+        #   The [A1 notation or R1C1 notation](https://developers.google.com/workspace/
+        #   sheets/api/guides/concepts#cell) of the range to retrieve values from.
         # @param [String] value_render_option
         #   How values should be represented in the output. The default render option is
         #   ValueRenderOption.FORMATTED_VALUE.
@@ -624,8 +629,8 @@ module Google
         # @param [String] spreadsheet_id
         #   The ID of the spreadsheet to update.
         # @param [String] range
-        #   The [A1 notation or R1C1 notation](/sheets/api/guides/concepts#cell) of the
-        #   values to clear.
+        #   The [A1 notation or R1C1 notation](https://developers.google.com/workspace/
+        #   sheets/api/guides/concepts#cell) of the values to clear.
         # @param [Google::Apis::SheetsV4::ClearValuesRequest] clear_values_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -662,8 +667,8 @@ module Google
         # @param [String] spreadsheet_id
         #   The ID of the spreadsheet to retrieve data from.
         # @param [String] range
-        #   The [A1 notation or R1C1 notation](/sheets/api/guides/concepts#cell) of the
-        #   range to retrieve values from.
+        #   The [A1 notation or R1C1 notation](https://developers.google.com/workspace/
+        #   sheets/api/guides/concepts#cell) of the range to retrieve values from.
         # @param [String] date_time_render_option
         #   How dates, times, and durations should be represented in the output. This is
         #   ignored if value_render_option is FORMATTED_VALUE. The default dateTime render
@@ -712,7 +717,8 @@ module Google
         # @param [String] spreadsheet_id
         #   The ID of the spreadsheet to update.
         # @param [String] range
-        #   The [A1 notation](/sheets/api/guides/concepts#cell) of the values to update.
+        #   The [A1 notation](https://developers.google.com/workspace/sheets/api/guides/
+        #   concepts#cell) of the values to update.
         # @param [Google::Apis::SheetsV4::ValueRange] value_range_object
         # @param [Boolean] include_values_in_response
         #   Determines if the update response should include the values of the cells that

data/lib/google/apis/sheets_v4.rb

@@ -23,7 +23,7 @@ module Google
     #
     # Reads and writes Google Sheets.
     #
-    # @see https://developers.google.com/sheets/
+    # @see https://developers.google.com/workspace/sheets/
     module SheetsV4
       # Version of the Google Sheets API this client connects to.
       # This is NOT the gem version.

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-sheets_v4
 version: !ruby/object:Gem::Version
-  version: 0.39.0
+  version: 0.41.0
 platform: ruby
 authors:
 - Google LLC
-autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-12-15 00:00:00.000000000 Z
+date: 2025-04-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-apis-core
@@ -58,9 +57,8 @@ 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-sheets_v4/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-sheets_v4/v0.39.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-sheets_v4/v0.41.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-sheets_v4
-post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -75,8 +73,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.23
-signing_key: 
+rubygems_version: 3.6.5
 specification_version: 4
 summary: Simple REST client for Google Sheets API V4
 test_files: []