# Copyright 2020 Google LLC
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#      http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

require 'date'
require 'google/apis/core/base_service'
require 'google/apis/core/json_representation'
require 'google/apis/core/hashable'
require 'google/apis/errors'

module Google
  module Apis
    module DocsV1
      
      # A ParagraphElement representing a spot in the text that's dynamically replaced
      # with content that can change over time, like a page number.
      class AutoText
        include Google::Apis::Core::Hashable
      
        # The suggested deletion IDs. If empty, then there are no suggested deletions of
        # this content.
        # Corresponds to the JSON property `suggestedDeletionIds`
        # @return [Array<String>]
        attr_accessor :suggested_deletion_ids
      
        # The suggested insertion IDs. An AutoText may have multiple insertion IDs if it'
        # s a nested suggested change. If empty, then this is not a suggested insertion.
        # Corresponds to the JSON property `suggestedInsertionIds`
        # @return [Array<String>]
        attr_accessor :suggested_insertion_ids
      
        # The suggested text style changes to this AutoText, keyed by suggestion ID.
        # Corresponds to the JSON property `suggestedTextStyleChanges`
        # @return [Hash<String,Google::Apis::DocsV1::SuggestedTextStyle>]
        attr_accessor :suggested_text_style_changes
      
        # Represents the styling that can be applied to text. Inherited text styles are
        # represented as unset fields in this message. A text style's parent depends on
        # where the text style is defined: * The TextStyle of text in a Paragraph
        # inherits from the paragraph's corresponding named style type. * The TextStyle
        # on a named style inherits from the normal text named style. * The TextStyle of
        # the normal text named style inherits from the default text style in the Docs
        # editor. * The TextStyle on a Paragraph element that's contained in a table may
        # inherit its text style from the table style. If the text style does not
        # inherit from a parent, unsetting fields will revert the style to a value
        # matching the defaults in the Docs editor.
        # Corresponds to the JSON property `textStyle`
        # @return [Google::Apis::DocsV1::TextStyle]
        attr_accessor :text_style
      
        # The type of this auto text.
        # Corresponds to the JSON property `type`
        # @return [String]
        attr_accessor :type
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @suggested_deletion_ids = args[:suggested_deletion_ids] if args.key?(:suggested_deletion_ids)
          @suggested_insertion_ids = args[:suggested_insertion_ids] if args.key?(:suggested_insertion_ids)
          @suggested_text_style_changes = args[:suggested_text_style_changes] if args.key?(:suggested_text_style_changes)
          @text_style = args[:text_style] if args.key?(:text_style)
          @type = args[:type] if args.key?(:type)
        end
      end
      
      # Represents the background of a document.
      class Background
        include Google::Apis::Core::Hashable
      
        # A color that can either be fully opaque or fully transparent.
        # Corresponds to the JSON property `color`
        # @return [Google::Apis::DocsV1::OptionalColor]
        attr_accessor :color
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @color = args[:color] if args.key?(:color)
        end
      end
      
      # A mask that indicates which of the fields on the base Background have been
      # changed in this suggestion. For any field set to true, the Backgound has a new
      # suggested value.
      class BackgroundSuggestionState
        include Google::Apis::Core::Hashable
      
        # Indicates whether the current background color has been modified in this
        # suggestion.
        # Corresponds to the JSON property `backgroundColorSuggested`
        # @return [Boolean]
        attr_accessor :background_color_suggested
        alias_method :background_color_suggested?, :background_color_suggested
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @background_color_suggested = args[:background_color_suggested] if args.key?(:background_color_suggested)
        end
      end
      
      # Request message for BatchUpdateDocument.
      class BatchUpdateDocumentRequest
        include Google::Apis::Core::Hashable
      
        # A list of updates to apply to the document.
        # Corresponds to the JSON property `requests`
        # @return [Array<Google::Apis::DocsV1::Request>]
        attr_accessor :requests
      
        # Provides control over how write requests are executed.
        # Corresponds to the JSON property `writeControl`
        # @return [Google::Apis::DocsV1::WriteControl]
        attr_accessor :write_control
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @requests = args[:requests] if args.key?(:requests)
          @write_control = args[:write_control] if args.key?(:write_control)
        end
      end
      
      # Response message from a BatchUpdateDocument request.
      class BatchUpdateDocumentResponse
        include Google::Apis::Core::Hashable
      
        # The ID of the document to which the updates were applied to.
        # Corresponds to the JSON property `documentId`
        # @return [String]
        attr_accessor :document_id
      
        # The reply of the updates. This maps 1:1 with the updates, although replies to
        # some requests may be empty.
        # Corresponds to the JSON property `replies`
        # @return [Array<Google::Apis::DocsV1::Response>]
        attr_accessor :replies
      
        # Provides control over how write requests are executed.
        # Corresponds to the JSON property `writeControl`
        # @return [Google::Apis::DocsV1::WriteControl]
        attr_accessor :write_control
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @document_id = args[:document_id] if args.key?(:document_id)
          @replies = args[:replies] if args.key?(:replies)
          @write_control = args[:write_control] if args.key?(:write_control)
        end
      end
      
      # The document body. The body typically contains the full document contents
      # except for headers, footers, and footnotes.
      class Body
        include Google::Apis::Core::Hashable
      
        # The contents of the body. The indexes for the body's content begin at zero.
        # Corresponds to the JSON property `content`
        # @return [Array<Google::Apis::DocsV1::StructuralElement>]
        attr_accessor :content
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @content = args[:content] if args.key?(:content)
        end
      end
      
      # A reference to a bookmark in this document.
      class BookmarkLink
        include Google::Apis::Core::Hashable
      
        # The ID of a bookmark in this document.
        # Corresponds to the JSON property `id`
        # @return [String]
        attr_accessor :id
      
        # The ID of the tab containing this bookmark.
        # Corresponds to the JSON property `tabId`
        # @return [String]
        attr_accessor :tab_id
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @id = args[:id] if args.key?(:id)
          @tab_id = args[:tab_id] if args.key?(:tab_id)
        end
      end
      
      # Describes the bullet of a paragraph.
      class Bullet
        include Google::Apis::Core::Hashable
      
        # The ID of the list this paragraph belongs to.
        # Corresponds to the JSON property `listId`
        # @return [String]
        attr_accessor :list_id
      
        # The nesting level of this paragraph in the list.
        # Corresponds to the JSON property `nestingLevel`
        # @return [Fixnum]
        attr_accessor :nesting_level
      
        # Represents the styling that can be applied to text. Inherited text styles are
        # represented as unset fields in this message. A text style's parent depends on
        # where the text style is defined: * The TextStyle of text in a Paragraph
        # inherits from the paragraph's corresponding named style type. * The TextStyle
        # on a named style inherits from the normal text named style. * The TextStyle of
        # the normal text named style inherits from the default text style in the Docs
        # editor. * The TextStyle on a Paragraph element that's contained in a table may
        # inherit its text style from the table style. If the text style does not
        # inherit from a parent, unsetting fields will revert the style to a value
        # matching the defaults in the Docs editor.
        # Corresponds to the JSON property `textStyle`
        # @return [Google::Apis::DocsV1::TextStyle]
        attr_accessor :text_style
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @list_id = args[:list_id] if args.key?(:list_id)
          @nesting_level = args[:nesting_level] if args.key?(:nesting_level)
          @text_style = args[:text_style] if args.key?(:text_style)
        end
      end
      
      # A mask that indicates which of the fields on the base Bullet have been changed
      # in this suggestion. For any field set to true, there's a new suggested value.
      class BulletSuggestionState
        include Google::Apis::Core::Hashable
      
        # Indicates if there was a suggested change to the list_id.
        # Corresponds to the JSON property `listIdSuggested`
        # @return [Boolean]
        attr_accessor :list_id_suggested
        alias_method :list_id_suggested?, :list_id_suggested
      
        # Indicates if there was a suggested change to the nesting_level.
        # Corresponds to the JSON property `nestingLevelSuggested`
        # @return [Boolean]
        attr_accessor :nesting_level_suggested
        alias_method :nesting_level_suggested?, :nesting_level_suggested
      
        # A mask that indicates which of the fields on the base TextStyle have been
        # changed in this suggestion. For any field set to true, there's a new suggested
        # value.
        # Corresponds to the JSON property `textStyleSuggestionState`
        # @return [Google::Apis::DocsV1::TextStyleSuggestionState]
        attr_accessor :text_style_suggestion_state
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @list_id_suggested = args[:list_id_suggested] if args.key?(:list_id_suggested)
          @nesting_level_suggested = args[:nesting_level_suggested] if args.key?(:nesting_level_suggested)
          @text_style_suggestion_state = args[:text_style_suggestion_state] if args.key?(:text_style_suggestion_state)
        end
      end
      
      # A solid color.
      class Color
        include Google::Apis::Core::Hashable
      
        # An RGB color.
        # Corresponds to the JSON property `rgbColor`
        # @return [Google::Apis::DocsV1::RgbColor]
        attr_accessor :rgb_color
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @rgb_color = args[:rgb_color] if args.key?(:rgb_color)
        end
      end
      
      # A ParagraphElement representing a column break. A column break makes the
      # subsequent text start at the top of the next column.
      class ColumnBreak
        include Google::Apis::Core::Hashable
      
        # The suggested deletion IDs. If empty, then there are no suggested deletions of
        # this content.
        # Corresponds to the JSON property `suggestedDeletionIds`
        # @return [Array<String>]
        attr_accessor :suggested_deletion_ids
      
        # The suggested insertion IDs. A ColumnBreak may have multiple insertion IDs if
        # it's a nested suggested change. If empty, then this is not a suggested
        # insertion.
        # Corresponds to the JSON property `suggestedInsertionIds`
        # @return [Array<String>]
        attr_accessor :suggested_insertion_ids
      
        # The suggested text style changes to this ColumnBreak, keyed by suggestion ID.
        # Corresponds to the JSON property `suggestedTextStyleChanges`
        # @return [Hash<String,Google::Apis::DocsV1::SuggestedTextStyle>]
        attr_accessor :suggested_text_style_changes
      
        # Represents the styling that can be applied to text. Inherited text styles are
        # represented as unset fields in this message. A text style's parent depends on
        # where the text style is defined: * The TextStyle of text in a Paragraph
        # inherits from the paragraph's corresponding named style type. * The TextStyle
        # on a named style inherits from the normal text named style. * The TextStyle of
        # the normal text named style inherits from the default text style in the Docs
        # editor. * The TextStyle on a Paragraph element that's contained in a table may
        # inherit its text style from the table style. If the text style does not
        # inherit from a parent, unsetting fields will revert the style to a value
        # matching the defaults in the Docs editor.
        # Corresponds to the JSON property `textStyle`
        # @return [Google::Apis::DocsV1::TextStyle]
        attr_accessor :text_style
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @suggested_deletion_ids = args[:suggested_deletion_ids] if args.key?(:suggested_deletion_ids)
          @suggested_insertion_ids = args[:suggested_insertion_ids] if args.key?(:suggested_insertion_ids)
          @suggested_text_style_changes = args[:suggested_text_style_changes] if args.key?(:suggested_text_style_changes)
          @text_style = args[:text_style] if args.key?(:text_style)
        end
      end
      
      # Creates a Footer. The new footer is applied to the SectionStyle at the
      # location of the SectionBreak if specified, otherwise it is applied to the
      # DocumentStyle. If a footer of the specified type already exists, a 400 bad
      # request error is returned.
      class CreateFooterRequest
        include Google::Apis::Core::Hashable
      
        # A particular location in the document.
        # Corresponds to the JSON property `sectionBreakLocation`
        # @return [Google::Apis::DocsV1::Location]
        attr_accessor :section_break_location
      
        # The type of footer to create.
        # Corresponds to the JSON property `type`
        # @return [String]
        attr_accessor :type
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @section_break_location = args[:section_break_location] if args.key?(:section_break_location)
          @type = args[:type] if args.key?(:type)
        end
      end
      
      # The result of creating a footer.
      class CreateFooterResponse
        include Google::Apis::Core::Hashable
      
        # The ID of the created footer.
        # Corresponds to the JSON property `footerId`
        # @return [String]
        attr_accessor :footer_id
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @footer_id = args[:footer_id] if args.key?(:footer_id)
        end
      end
      
      # Creates a Footnote segment and inserts a new FootnoteReference to it at the
      # given location. The new Footnote segment will contain a space followed by a
      # newline character.
      class CreateFootnoteRequest
        include Google::Apis::Core::Hashable
      
        # Location at the end of a body, header, footer or footnote. The location is
        # immediately before the last newline in the document segment.
        # Corresponds to the JSON property `endOfSegmentLocation`
        # @return [Google::Apis::DocsV1::EndOfSegmentLocation]
        attr_accessor :end_of_segment_location
      
        # A particular location in the document.
        # Corresponds to the JSON property `location`
        # @return [Google::Apis::DocsV1::Location]
        attr_accessor :location
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @end_of_segment_location = args[:end_of_segment_location] if args.key?(:end_of_segment_location)
          @location = args[:location] if args.key?(:location)
        end
      end
      
      # The result of creating a footnote.
      class CreateFootnoteResponse
        include Google::Apis::Core::Hashable
      
        # The ID of the created footnote.
        # Corresponds to the JSON property `footnoteId`
        # @return [String]
        attr_accessor :footnote_id
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @footnote_id = args[:footnote_id] if args.key?(:footnote_id)
        end
      end
      
      # Creates a Header. The new header is applied to the SectionStyle at the
      # location of the SectionBreak if specified, otherwise it is applied to the
      # DocumentStyle. If a header of the specified type already exists, a 400 bad
      # request error is returned.
      class CreateHeaderRequest
        include Google::Apis::Core::Hashable
      
        # A particular location in the document.
        # Corresponds to the JSON property `sectionBreakLocation`
        # @return [Google::Apis::DocsV1::Location]
        attr_accessor :section_break_location
      
        # The type of header to create.
        # Corresponds to the JSON property `type`
        # @return [String]
        attr_accessor :type
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @section_break_location = args[:section_break_location] if args.key?(:section_break_location)
          @type = args[:type] if args.key?(:type)
        end
      end
      
      # The result of creating a header.
      class CreateHeaderResponse
        include Google::Apis::Core::Hashable
      
        # The ID of the created header.
        # Corresponds to the JSON property `headerId`
        # @return [String]
        attr_accessor :header_id
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @header_id = args[:header_id] if args.key?(:header_id)
        end
      end
      
      # Creates a NamedRange referencing the given range.
      class CreateNamedRangeRequest
        include Google::Apis::Core::Hashable
      
        # The name of the NamedRange. Names do not need to be unique. Names must be at
        # least 1 character and no more than 256 characters, measured in UTF-16 code
        # units.
        # Corresponds to the JSON property `name`
        # @return [String]
        attr_accessor :name
      
        # Specifies a contiguous range of text.
        # Corresponds to the JSON property `range`
        # @return [Google::Apis::DocsV1::Range]
        attr_accessor :range
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @name = args[:name] if args.key?(:name)
          @range = args[:range] if args.key?(:range)
        end
      end
      
      # The result of creating a named range.
      class CreateNamedRangeResponse
        include Google::Apis::Core::Hashable
      
        # The ID of the created named range.
        # Corresponds to the JSON property `namedRangeId`
        # @return [String]
        attr_accessor :named_range_id
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @named_range_id = args[:named_range_id] if args.key?(:named_range_id)
        end
      end
      
      # Creates bullets for all of the paragraphs that overlap with the given range.
      # The nesting level of each paragraph will be determined by counting leading
      # tabs in front of each paragraph. To avoid excess space between the bullet and
      # the corresponding paragraph, these leading tabs are removed by this request.
      # This may change the indices of parts of the text. If the paragraph immediately
      # before paragraphs being updated is in a list with a matching preset, the
      # paragraphs being updated are added to that preceding list.
      class CreateParagraphBulletsRequest
        include Google::Apis::Core::Hashable
      
        # The kinds of bullet glyphs to be used.
        # Corresponds to the JSON property `bulletPreset`
        # @return [String]
        attr_accessor :bullet_preset
      
        # Specifies a contiguous range of text.
        # Corresponds to the JSON property `range`
        # @return [Google::Apis::DocsV1::Range]
        attr_accessor :range
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @bullet_preset = args[:bullet_preset] if args.key?(:bullet_preset)
          @range = args[:range] if args.key?(:range)
        end
      end
      
      # The crop properties of an image. The crop rectangle is represented using
      # fractional offsets from the original content's 4 edges. - If the offset is in
      # the interval (0, 1), the corresponding edge of crop rectangle is positioned
      # inside of the image's original bounding rectangle. - If the offset is negative
      # or greater than 1, the corresponding edge of crop rectangle is positioned
      # outside of the image's original bounding rectangle. - If all offsets and
      # rotation angles are 0, the image is not cropped.
      class CropProperties
        include Google::Apis::Core::Hashable
      
        # The clockwise rotation angle of the crop rectangle around its center, in
        # radians. Rotation is applied after the offsets.
        # Corresponds to the JSON property `angle`
        # @return [Float]
        attr_accessor :angle
      
        # The offset specifies how far inwards the bottom edge of the crop rectangle is
        # from the bottom edge of the original content as a fraction of the original
        # content's height.
        # Corresponds to the JSON property `offsetBottom`
        # @return [Float]
        attr_accessor :offset_bottom
      
        # The offset specifies how far inwards the left edge of the crop rectangle is
        # from the left edge of the original content as a fraction of the original
        # content's width.
        # Corresponds to the JSON property `offsetLeft`
        # @return [Float]
        attr_accessor :offset_left
      
        # The offset specifies how far inwards the right edge of the crop rectangle is
        # from the right edge of the original content as a fraction of the original
        # content's width.
        # Corresponds to the JSON property `offsetRight`
        # @return [Float]
        attr_accessor :offset_right
      
        # The offset specifies how far inwards the top edge of the crop rectangle is
        # from the top edge of the original content as a fraction of the original
        # content's height.
        # Corresponds to the JSON property `offsetTop`
        # @return [Float]
        attr_accessor :offset_top
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @angle = args[:angle] if args.key?(:angle)
          @offset_bottom = args[:offset_bottom] if args.key?(:offset_bottom)
          @offset_left = args[:offset_left] if args.key?(:offset_left)
          @offset_right = args[:offset_right] if args.key?(:offset_right)
          @offset_top = args[:offset_top] if args.key?(:offset_top)
        end
      end
      
      # A mask that indicates which of the fields on the base CropProperties have been
      # changed in this suggestion. For any field set to true, there's a new suggested
      # value.
      class CropPropertiesSuggestionState
        include Google::Apis::Core::Hashable
      
        # Indicates if there was a suggested change to angle.
        # Corresponds to the JSON property `angleSuggested`
        # @return [Boolean]
        attr_accessor :angle_suggested
        alias_method :angle_suggested?, :angle_suggested
      
        # Indicates if there was a suggested change to offset_bottom.
        # Corresponds to the JSON property `offsetBottomSuggested`
        # @return [Boolean]
        attr_accessor :offset_bottom_suggested
        alias_method :offset_bottom_suggested?, :offset_bottom_suggested
      
        # Indicates if there was a suggested change to offset_left.
        # Corresponds to the JSON property `offsetLeftSuggested`
        # @return [Boolean]
        attr_accessor :offset_left_suggested
        alias_method :offset_left_suggested?, :offset_left_suggested
      
        # Indicates if there was a suggested change to offset_right.
        # Corresponds to the JSON property `offsetRightSuggested`
        # @return [Boolean]
        attr_accessor :offset_right_suggested
        alias_method :offset_right_suggested?, :offset_right_suggested
      
        # Indicates if there was a suggested change to offset_top.
        # Corresponds to the JSON property `offsetTopSuggested`
        # @return [Boolean]
        attr_accessor :offset_top_suggested
        alias_method :offset_top_suggested?, :offset_top_suggested
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @angle_suggested = args[:angle_suggested] if args.key?(:angle_suggested)
          @offset_bottom_suggested = args[:offset_bottom_suggested] if args.key?(:offset_bottom_suggested)
          @offset_left_suggested = args[:offset_left_suggested] if args.key?(:offset_left_suggested)
          @offset_right_suggested = args[:offset_right_suggested] if args.key?(:offset_right_suggested)
          @offset_top_suggested = args[:offset_top_suggested] if args.key?(:offset_top_suggested)
        end
      end
      
      # Deletes content from the document.
      class DeleteContentRangeRequest
        include Google::Apis::Core::Hashable
      
        # Specifies a contiguous range of text.
        # Corresponds to the JSON property `range`
        # @return [Google::Apis::DocsV1::Range]
        attr_accessor :range
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @range = args[:range] if args.key?(:range)
        end
      end
      
      # Deletes a Footer from the document.
      class DeleteFooterRequest
        include Google::Apis::Core::Hashable
      
        # The id of the footer to delete. If this footer is defined on DocumentStyle,
        # the reference to this footer is removed, resulting in no footer of that type
        # for the first section of the document. If this footer is defined on a
        # SectionStyle, the reference to this footer is removed and the footer of that
        # type is now continued from the previous section.
        # Corresponds to the JSON property `footerId`
        # @return [String]
        attr_accessor :footer_id
      
        # The tab that contains the footer to delete. When omitted, the request is
        # applied to the first tab. In a document containing a single tab: - If provided,
        # must match the singular tab's ID. - If omitted, the request applies to the
        # singular tab. In a document containing multiple tabs: - If provided, the
        # request applies to the specified tab. - If omitted, the request applies to the
        # first tab in the document.
        # Corresponds to the JSON property `tabId`
        # @return [String]
        attr_accessor :tab_id
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @footer_id = args[:footer_id] if args.key?(:footer_id)
          @tab_id = args[:tab_id] if args.key?(:tab_id)
        end
      end
      
      # Deletes a Header from the document.
      class DeleteHeaderRequest
        include Google::Apis::Core::Hashable
      
        # The id of the header to delete. If this header is defined on DocumentStyle,
        # the reference to this header is removed, resulting in no header of that type
        # for the first section of the document. If this header is defined on a
        # SectionStyle, the reference to this header is removed and the header of that
        # type is now continued from the previous section.
        # Corresponds to the JSON property `headerId`
        # @return [String]
        attr_accessor :header_id
      
        # The tab containing the header to delete. When omitted, the request is applied
        # to the first tab. In a document containing a single tab: - If provided, must
        # match the singular tab's ID. - If omitted, the request applies to the singular
        # tab. In a document containing multiple tabs: - If provided, the request
        # applies to the specified tab. - If omitted, the request applies to the first
        # tab in the document.
        # Corresponds to the JSON property `tabId`
        # @return [String]
        attr_accessor :tab_id
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @header_id = args[:header_id] if args.key?(:header_id)
          @tab_id = args[:tab_id] if args.key?(:tab_id)
        end
      end
      
      # Deletes a NamedRange.
      class DeleteNamedRangeRequest
        include Google::Apis::Core::Hashable
      
        # The name of the range(s) to delete. All named ranges with the given name will
        # be deleted.
        # Corresponds to the JSON property `name`
        # @return [String]
        attr_accessor :name
      
        # The ID of the named range to delete.
        # Corresponds to the JSON property `namedRangeId`
        # @return [String]
        attr_accessor :named_range_id
      
        # A criteria that specifies in which tabs a request executes.
        # Corresponds to the JSON property `tabsCriteria`
        # @return [Google::Apis::DocsV1::TabsCriteria]
        attr_accessor :tabs_criteria
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @name = args[:name] if args.key?(:name)
          @named_range_id = args[:named_range_id] if args.key?(:named_range_id)
          @tabs_criteria = args[:tabs_criteria] if args.key?(:tabs_criteria)
        end
      end
      
      # Deletes bullets from all of the paragraphs that overlap with the given range.
      # The nesting level of each paragraph will be visually preserved by adding
      # indent to the start of the corresponding paragraph.
      class DeleteParagraphBulletsRequest
        include Google::Apis::Core::Hashable
      
        # Specifies a contiguous range of text.
        # Corresponds to the JSON property `range`
        # @return [Google::Apis::DocsV1::Range]
        attr_accessor :range
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @range = args[:range] if args.key?(:range)
        end
      end
      
      # Deletes a PositionedObject from the document.
      class DeletePositionedObjectRequest
        include Google::Apis::Core::Hashable
      
        # The ID of the positioned object to delete.
        # Corresponds to the JSON property `objectId`
        # @return [String]
        attr_accessor :object_id_prop
      
        # The tab that the positioned object to delete is in. When omitted, the request
        # is applied to the first tab. In a document containing a single tab: - If
        # provided, must match the singular tab's ID. - If omitted, the request applies
        # to the singular tab. In a document containing multiple tabs: - If provided,
        # the request applies to the specified tab. - If omitted, the request applies to
        # the first tab in the document.
        # Corresponds to the JSON property `tabId`
        # @return [String]
        attr_accessor :tab_id
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @object_id_prop = args[:object_id_prop] if args.key?(:object_id_prop)
          @tab_id = args[:tab_id] if args.key?(:tab_id)
        end
      end
      
      # Deletes a column from a table.
      class DeleteTableColumnRequest
        include Google::Apis::Core::Hashable
      
        # Location of a single cell within a table.
        # Corresponds to the JSON property `tableCellLocation`
        # @return [Google::Apis::DocsV1::TableCellLocation]
        attr_accessor :table_cell_location
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @table_cell_location = args[:table_cell_location] if args.key?(:table_cell_location)
        end
      end
      
      # Deletes a row from a table.
      class DeleteTableRowRequest
        include Google::Apis::Core::Hashable
      
        # Location of a single cell within a table.
        # Corresponds to the JSON property `tableCellLocation`
        # @return [Google::Apis::DocsV1::TableCellLocation]
        attr_accessor :table_cell_location
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @table_cell_location = args[:table_cell_location] if args.key?(:table_cell_location)
        end
      end
      
      # A magnitude in a single direction in the specified units.
      class Dimension
        include Google::Apis::Core::Hashable
      
        # The magnitude.
        # Corresponds to the JSON property `magnitude`
        # @return [Float]
        attr_accessor :magnitude
      
        # The units for magnitude.
        # Corresponds to the JSON property `unit`
        # @return [String]
        attr_accessor :unit
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @magnitude = args[:magnitude] if args.key?(:magnitude)
          @unit = args[:unit] if args.key?(:unit)
        end
      end
      
      # A Google Docs document.
      class Document
        include Google::Apis::Core::Hashable
      
        # The document body. The body typically contains the full document contents
        # except for headers, footers, and footnotes.
        # Corresponds to the JSON property `body`
        # @return [Google::Apis::DocsV1::Body]
        attr_accessor :body
      
        # Output only. The ID of the document.
        # Corresponds to the JSON property `documentId`
        # @return [String]
        attr_accessor :document_id
      
        # The style of the document.
        # Corresponds to the JSON property `documentStyle`
        # @return [Google::Apis::DocsV1::DocumentStyle]
        attr_accessor :document_style
      
        # Output only. The footers in the document, keyed by footer ID. Legacy field:
        # Instead, use Document.tabs.documentTab.footers, which exposes the actual
        # document content from all tabs when the includeTabsContent parameter is set to
        # `true`. If `false` or unset, this field contains information about the first
        # tab in the document.
        # Corresponds to the JSON property `footers`
        # @return [Hash<String,Google::Apis::DocsV1::Footer>]
        attr_accessor :footers
      
        # Output only. The footnotes in the document, keyed by footnote ID. Legacy field:
        # Instead, use Document.tabs.documentTab.footnotes, which exposes the actual
        # document content from all tabs when the includeTabsContent parameter is set to
        # `true`. If `false` or unset, this field contains information about the first
        # tab in the document.
        # Corresponds to the JSON property `footnotes`
        # @return [Hash<String,Google::Apis::DocsV1::Footnote>]
        attr_accessor :footnotes
      
        # Output only. The headers in the document, keyed by header ID. Legacy field:
        # Instead, use Document.tabs.documentTab.headers, which exposes the actual
        # document content from all tabs when the includeTabsContent parameter is set to
        # `true`. If `false` or unset, this field contains information about the first
        # tab in the document.
        # Corresponds to the JSON property `headers`
        # @return [Hash<String,Google::Apis::DocsV1::Header>]
        attr_accessor :headers
      
        # Output only. The inline objects in the document, keyed by object ID. Legacy
        # field: Instead, use Document.tabs.documentTab.inlineObjects, which exposes the
        # actual document content from all tabs when the includeTabsContent parameter is
        # set to `true`. If `false` or unset, this field contains information about the
        # first tab in the document.
        # Corresponds to the JSON property `inlineObjects`
        # @return [Hash<String,Google::Apis::DocsV1::InlineObject>]
        attr_accessor :inline_objects
      
        # Output only. The lists in the document, keyed by list ID. Legacy field:
        # Instead, use Document.tabs.documentTab.lists, which exposes the actual
        # document content from all tabs when the includeTabsContent parameter is set to
        # `true`. If `false` or unset, this field contains information about the first
        # tab in the document.
        # Corresponds to the JSON property `lists`
        # @return [Hash<String,Google::Apis::DocsV1::List>]
        attr_accessor :lists
      
        # Output only. The named ranges in the document, keyed by name. Legacy field:
        # Instead, use Document.tabs.documentTab.namedRanges, which exposes the actual
        # document content from all tabs when the includeTabsContent parameter is set to
        # `true`. If `false` or unset, this field contains information about the first
        # tab in the document.
        # Corresponds to the JSON property `namedRanges`
        # @return [Hash<String,Google::Apis::DocsV1::NamedRanges>]
        attr_accessor :named_ranges
      
        # The named styles. Paragraphs in the document can inherit their TextStyle and
        # ParagraphStyle from these named styles.
        # Corresponds to the JSON property `namedStyles`
        # @return [Google::Apis::DocsV1::NamedStyles]
        attr_accessor :named_styles
      
        # Output only. The positioned objects in the document, keyed by object ID.
        # Legacy field: Instead, use Document.tabs.documentTab.positionedObjects, which
        # exposes the actual document content from all tabs when the includeTabsContent
        # parameter is set to `true`. If `false` or unset, this field contains
        # information about the first tab in the document.
        # Corresponds to the JSON property `positionedObjects`
        # @return [Hash<String,Google::Apis::DocsV1::PositionedObject>]
        attr_accessor :positioned_objects
      
        # Output only. The revision ID of the document. Can be used in update requests
        # to specify which revision of a document to apply updates to and how the
        # request should behave if the document has been edited since that revision.
        # Only populated if the user has edit access to the document. The revision ID is
        # not a sequential number but an opaque string. The format of the revision ID
        # might change over time. A returned revision ID is only guaranteed to be valid
        # for 24 hours after it has been returned and cannot be shared across users. If
        # the revision ID is unchanged between calls, then the document has not changed.
        # Conversely, a changed ID (for the same document and user) usually means the
        # document has been updated. However, a changed ID can also be due to internal
        # factors such as ID format changes.
        # Corresponds to the JSON property `revisionId`
        # @return [String]
        attr_accessor :revision_id
      
        # Output only. The suggested changes to the style of the document, keyed by
        # suggestion ID. Legacy field: Instead, use Document.tabs.documentTab.
        # suggestedDocumentStyleChanges, which exposes the actual document content from
        # all tabs when the includeTabsContent parameter is set to `true`. If `false` or
        # unset, this field contains information about the first tab in the document.
        # Corresponds to the JSON property `suggestedDocumentStyleChanges`
        # @return [Hash<String,Google::Apis::DocsV1::SuggestedDocumentStyle>]
        attr_accessor :suggested_document_style_changes
      
        # Output only. The suggested changes to the named styles of the document, keyed
        # by suggestion ID. Legacy field: Instead, use Document.tabs.documentTab.
        # suggestedNamedStylesChanges, which exposes the actual document content from
        # all tabs when the includeTabsContent parameter is set to `true`. If `false` or
        # unset, this field contains information about the first tab in the document.
        # Corresponds to the JSON property `suggestedNamedStylesChanges`
        # @return [Hash<String,Google::Apis::DocsV1::SuggestedNamedStyles>]
        attr_accessor :suggested_named_styles_changes
      
        # Output only. The suggestions view mode applied to the document. Note: When
        # editing a document, changes must be based on a document with
        # SUGGESTIONS_INLINE.
        # Corresponds to the JSON property `suggestionsViewMode`
        # @return [String]
        attr_accessor :suggestions_view_mode
      
        # Tabs that are part of a document. Tabs can contain child tabs, a tab nested
        # within another tab. Child tabs are represented by the Tab.childTabs field.
        # Corresponds to the JSON property `tabs`
        # @return [Array<Google::Apis::DocsV1::Tab>]
        attr_accessor :tabs
      
        # The title of the document.
        # Corresponds to the JSON property `title`
        # @return [String]
        attr_accessor :title
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @body = args[:body] if args.key?(:body)
          @document_id = args[:document_id] if args.key?(:document_id)
          @document_style = args[:document_style] if args.key?(:document_style)
          @footers = args[:footers] if args.key?(:footers)
          @footnotes = args[:footnotes] if args.key?(:footnotes)
          @headers = args[:headers] if args.key?(:headers)
          @inline_objects = args[:inline_objects] if args.key?(:inline_objects)
          @lists = args[:lists] if args.key?(:lists)
          @named_ranges = args[:named_ranges] if args.key?(:named_ranges)
          @named_styles = args[:named_styles] if args.key?(:named_styles)
          @positioned_objects = args[:positioned_objects] if args.key?(:positioned_objects)
          @revision_id = args[:revision_id] if args.key?(:revision_id)
          @suggested_document_style_changes = args[:suggested_document_style_changes] if args.key?(:suggested_document_style_changes)
          @suggested_named_styles_changes = args[:suggested_named_styles_changes] if args.key?(:suggested_named_styles_changes)
          @suggestions_view_mode = args[:suggestions_view_mode] if args.key?(:suggestions_view_mode)
          @tabs = args[:tabs] if args.key?(:tabs)
          @title = args[:title] if args.key?(:title)
        end
      end
      
      # The style of the document.
      class DocumentStyle
        include Google::Apis::Core::Hashable
      
        # Represents the background of a document.
        # Corresponds to the JSON property `background`
        # @return [Google::Apis::DocsV1::Background]
        attr_accessor :background
      
        # The ID of the default footer. If not set, there's no default footer. This
        # property is read-only.
        # Corresponds to the JSON property `defaultFooterId`
        # @return [String]
        attr_accessor :default_footer_id
      
        # The ID of the default header. If not set, there's no default header. This
        # property is read-only.
        # Corresponds to the JSON property `defaultHeaderId`
        # @return [String]
        attr_accessor :default_header_id
      
        # The ID of the footer used only for even pages. The value of
        # use_even_page_header_footer determines whether to use the default_footer_id or
        # this value for the footer on even pages. If not set, there's no even page
        # footer. This property is read-only.
        # Corresponds to the JSON property `evenPageFooterId`
        # @return [String]
        attr_accessor :even_page_footer_id
      
        # The ID of the header used only for even pages. The value of
        # use_even_page_header_footer determines whether to use the default_header_id or
        # this value for the header on even pages. If not set, there's no even page
        # header. This property is read-only.
        # Corresponds to the JSON property `evenPageHeaderId`
        # @return [String]
        attr_accessor :even_page_header_id
      
        # The ID of the footer used only for the first page. If not set then a unique
        # footer for the first page does not exist. The value of
        # use_first_page_header_footer determines whether to use the default_footer_id
        # or this value for the footer on the first page. If not set, there's no first
        # page footer. This property is read-only.
        # Corresponds to the JSON property `firstPageFooterId`
        # @return [String]
        attr_accessor :first_page_footer_id
      
        # The ID of the header used only for the first page. If not set then a unique
        # header for the first page does not exist. The value of
        # use_first_page_header_footer determines whether to use the default_header_id
        # or this value for the header on the first page. If not set, there's no first
        # page header. This property is read-only.
        # Corresponds to the JSON property `firstPageHeaderId`
        # @return [String]
        attr_accessor :first_page_header_id
      
        # Optional. Indicates whether to flip the dimensions of the page_size, which
        # allows changing the page orientation between portrait and landscape.
        # Corresponds to the JSON property `flipPageOrientation`
        # @return [Boolean]
        attr_accessor :flip_page_orientation
        alias_method :flip_page_orientation?, :flip_page_orientation
      
        # A magnitude in a single direction in the specified units.
        # Corresponds to the JSON property `marginBottom`
        # @return [Google::Apis::DocsV1::Dimension]
        attr_accessor :margin_bottom
      
        # A magnitude in a single direction in the specified units.
        # Corresponds to the JSON property `marginFooter`
        # @return [Google::Apis::DocsV1::Dimension]
        attr_accessor :margin_footer
      
        # A magnitude in a single direction in the specified units.
        # Corresponds to the JSON property `marginHeader`
        # @return [Google::Apis::DocsV1::Dimension]
        attr_accessor :margin_header
      
        # A magnitude in a single direction in the specified units.
        # Corresponds to the JSON property `marginLeft`
        # @return [Google::Apis::DocsV1::Dimension]
        attr_accessor :margin_left
      
        # A magnitude in a single direction in the specified units.
        # Corresponds to the JSON property `marginRight`
        # @return [Google::Apis::DocsV1::Dimension]
        attr_accessor :margin_right
      
        # A magnitude in a single direction in the specified units.
        # Corresponds to the JSON property `marginTop`
        # @return [Google::Apis::DocsV1::Dimension]
        attr_accessor :margin_top
      
        # The page number from which to start counting the number of pages.
        # Corresponds to the JSON property `pageNumberStart`
        # @return [Fixnum]
        attr_accessor :page_number_start
      
        # A width and height.
        # Corresponds to the JSON property `pageSize`
        # @return [Google::Apis::DocsV1::Size]
        attr_accessor :page_size
      
        # Indicates whether DocumentStyle margin_header, SectionStyle margin_header and
        # DocumentStyle margin_footer, SectionStyle margin_footer are respected. When
        # false, the default values in the Docs editor for header and footer margin is
        # used. This property is read-only.
        # Corresponds to the JSON property `useCustomHeaderFooterMargins`
        # @return [Boolean]
        attr_accessor :use_custom_header_footer_margins
        alias_method :use_custom_header_footer_margins?, :use_custom_header_footer_margins
      
        # Indicates whether to use the even page header / footer IDs for the even pages.
        # Corresponds to the JSON property `useEvenPageHeaderFooter`
        # @return [Boolean]
        attr_accessor :use_even_page_header_footer
        alias_method :use_even_page_header_footer?, :use_even_page_header_footer
      
        # Indicates whether to use the first page header / footer IDs for the first page.
        # Corresponds to the JSON property `useFirstPageHeaderFooter`
        # @return [Boolean]
        attr_accessor :use_first_page_header_footer
        alias_method :use_first_page_header_footer?, :use_first_page_header_footer
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @background = args[:background] if args.key?(:background)
          @default_footer_id = args[:default_footer_id] if args.key?(:default_footer_id)
          @default_header_id = args[:default_header_id] if args.key?(:default_header_id)
          @even_page_footer_id = args[:even_page_footer_id] if args.key?(:even_page_footer_id)
          @even_page_header_id = args[:even_page_header_id] if args.key?(:even_page_header_id)
          @first_page_footer_id = args[:first_page_footer_id] if args.key?(:first_page_footer_id)
          @first_page_header_id = args[:first_page_header_id] if args.key?(:first_page_header_id)
          @flip_page_orientation = args[:flip_page_orientation] if args.key?(:flip_page_orientation)
          @margin_bottom = args[:margin_bottom] if args.key?(:margin_bottom)
          @margin_footer = args[:margin_footer] if args.key?(:margin_footer)
          @margin_header = args[:margin_header] if args.key?(:margin_header)
          @margin_left = args[:margin_left] if args.key?(:margin_left)
          @margin_right = args[:margin_right] if args.key?(:margin_right)
          @margin_top = args[:margin_top] if args.key?(:margin_top)
          @page_number_start = args[:page_number_start] if args.key?(:page_number_start)
          @page_size = args[:page_size] if args.key?(:page_size)
          @use_custom_header_footer_margins = args[:use_custom_header_footer_margins] if args.key?(:use_custom_header_footer_margins)
          @use_even_page_header_footer = args[:use_even_page_header_footer] if args.key?(:use_even_page_header_footer)
          @use_first_page_header_footer = args[:use_first_page_header_footer] if args.key?(:use_first_page_header_footer)
        end
      end
      
      # A mask that indicates which of the fields on the base DocumentStyle have been
      # changed in this suggestion. For any field set to true, there's a new suggested
      # value.
      class DocumentStyleSuggestionState
        include Google::Apis::Core::Hashable
      
        # A mask that indicates which of the fields on the base Background have been
        # changed in this suggestion. For any field set to true, the Backgound has a new
        # suggested value.
        # Corresponds to the JSON property `backgroundSuggestionState`
        # @return [Google::Apis::DocsV1::BackgroundSuggestionState]
        attr_accessor :background_suggestion_state
      
        # Indicates if there was a suggested change to default_footer_id.
        # Corresponds to the JSON property `defaultFooterIdSuggested`
        # @return [Boolean]
        attr_accessor :default_footer_id_suggested
        alias_method :default_footer_id_suggested?, :default_footer_id_suggested
      
        # Indicates if there was a suggested change to default_header_id.
        # Corresponds to the JSON property `defaultHeaderIdSuggested`
        # @return [Boolean]
        attr_accessor :default_header_id_suggested
        alias_method :default_header_id_suggested?, :default_header_id_suggested
      
        # Indicates if there was a suggested change to even_page_footer_id.
        # Corresponds to the JSON property `evenPageFooterIdSuggested`
        # @return [Boolean]
        attr_accessor :even_page_footer_id_suggested
        alias_method :even_page_footer_id_suggested?, :even_page_footer_id_suggested
      
        # Indicates if there was a suggested change to even_page_header_id.
        # Corresponds to the JSON property `evenPageHeaderIdSuggested`
        # @return [Boolean]
        attr_accessor :even_page_header_id_suggested
        alias_method :even_page_header_id_suggested?, :even_page_header_id_suggested
      
        # Indicates if there was a suggested change to first_page_footer_id.
        # Corresponds to the JSON property `firstPageFooterIdSuggested`
        # @return [Boolean]
        attr_accessor :first_page_footer_id_suggested
        alias_method :first_page_footer_id_suggested?, :first_page_footer_id_suggested
      
        # Indicates if there was a suggested change to first_page_header_id.
        # Corresponds to the JSON property `firstPageHeaderIdSuggested`
        # @return [Boolean]
        attr_accessor :first_page_header_id_suggested
        alias_method :first_page_header_id_suggested?, :first_page_header_id_suggested
      
        # Optional. Indicates if there was a suggested change to flip_page_orientation.
        # Corresponds to the JSON property `flipPageOrientationSuggested`
        # @return [Boolean]
        attr_accessor :flip_page_orientation_suggested
        alias_method :flip_page_orientation_suggested?, :flip_page_orientation_suggested
      
        # Indicates if there was a suggested change to margin_bottom.
        # Corresponds to the JSON property `marginBottomSuggested`
        # @return [Boolean]
        attr_accessor :margin_bottom_suggested
        alias_method :margin_bottom_suggested?, :margin_bottom_suggested
      
        # Indicates if there was a suggested change to margin_footer.
        # Corresponds to the JSON property `marginFooterSuggested`
        # @return [Boolean]
        attr_accessor :margin_footer_suggested
        alias_method :margin_footer_suggested?, :margin_footer_suggested
      
        # Indicates if there was a suggested change to margin_header.
        # Corresponds to the JSON property `marginHeaderSuggested`
        # @return [Boolean]
        attr_accessor :margin_header_suggested
        alias_method :margin_header_suggested?, :margin_header_suggested
      
        # Indicates if there was a suggested change to margin_left.
        # Corresponds to the JSON property `marginLeftSuggested`
        # @return [Boolean]
        attr_accessor :margin_left_suggested
        alias_method :margin_left_suggested?, :margin_left_suggested
      
        # Indicates if there was a suggested change to margin_right.
        # Corresponds to the JSON property `marginRightSuggested`
        # @return [Boolean]
        attr_accessor :margin_right_suggested
        alias_method :margin_right_suggested?, :margin_right_suggested
      
        # Indicates if there was a suggested change to margin_top.
        # Corresponds to the JSON property `marginTopSuggested`
        # @return [Boolean]
        attr_accessor :margin_top_suggested
        alias_method :margin_top_suggested?, :margin_top_suggested
      
        # Indicates if there was a suggested change to page_number_start.
        # Corresponds to the JSON property `pageNumberStartSuggested`
        # @return [Boolean]
        attr_accessor :page_number_start_suggested
        alias_method :page_number_start_suggested?, :page_number_start_suggested
      
        # A mask that indicates which of the fields on the base Size have been changed
        # in this suggestion. For any field set to true, the Size has a new suggested
        # value.
        # Corresponds to the JSON property `pageSizeSuggestionState`
        # @return [Google::Apis::DocsV1::SizeSuggestionState]
        attr_accessor :page_size_suggestion_state
      
        # Indicates if there was a suggested change to use_custom_header_footer_margins.
        # Corresponds to the JSON property `useCustomHeaderFooterMarginsSuggested`
        # @return [Boolean]
        attr_accessor :use_custom_header_footer_margins_suggested
        alias_method :use_custom_header_footer_margins_suggested?, :use_custom_header_footer_margins_suggested
      
        # Indicates if there was a suggested change to use_even_page_header_footer.
        # Corresponds to the JSON property `useEvenPageHeaderFooterSuggested`
        # @return [Boolean]
        attr_accessor :use_even_page_header_footer_suggested
        alias_method :use_even_page_header_footer_suggested?, :use_even_page_header_footer_suggested
      
        # Indicates if there was a suggested change to use_first_page_header_footer.
        # Corresponds to the JSON property `useFirstPageHeaderFooterSuggested`
        # @return [Boolean]
        attr_accessor :use_first_page_header_footer_suggested
        alias_method :use_first_page_header_footer_suggested?, :use_first_page_header_footer_suggested
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @background_suggestion_state = args[:background_suggestion_state] if args.key?(:background_suggestion_state)
          @default_footer_id_suggested = args[:default_footer_id_suggested] if args.key?(:default_footer_id_suggested)
          @default_header_id_suggested = args[:default_header_id_suggested] if args.key?(:default_header_id_suggested)
          @even_page_footer_id_suggested = args[:even_page_footer_id_suggested] if args.key?(:even_page_footer_id_suggested)
          @even_page_header_id_suggested = args[:even_page_header_id_suggested] if args.key?(:even_page_header_id_suggested)
          @first_page_footer_id_suggested = args[:first_page_footer_id_suggested] if args.key?(:first_page_footer_id_suggested)
          @first_page_header_id_suggested = args[:first_page_header_id_suggested] if args.key?(:first_page_header_id_suggested)
          @flip_page_orientation_suggested = args[:flip_page_orientation_suggested] if args.key?(:flip_page_orientation_suggested)
          @margin_bottom_suggested = args[:margin_bottom_suggested] if args.key?(:margin_bottom_suggested)
          @margin_footer_suggested = args[:margin_footer_suggested] if args.key?(:margin_footer_suggested)
          @margin_header_suggested = args[:margin_header_suggested] if args.key?(:margin_header_suggested)
          @margin_left_suggested = args[:margin_left_suggested] if args.key?(:margin_left_suggested)
          @margin_right_suggested = args[:margin_right_suggested] if args.key?(:margin_right_suggested)
          @margin_top_suggested = args[:margin_top_suggested] if args.key?(:margin_top_suggested)
          @page_number_start_suggested = args[:page_number_start_suggested] if args.key?(:page_number_start_suggested)
          @page_size_suggestion_state = args[:page_size_suggestion_state] if args.key?(:page_size_suggestion_state)
          @use_custom_header_footer_margins_suggested = args[:use_custom_header_footer_margins_suggested] if args.key?(:use_custom_header_footer_margins_suggested)
          @use_even_page_header_footer_suggested = args[:use_even_page_header_footer_suggested] if args.key?(:use_even_page_header_footer_suggested)
          @use_first_page_header_footer_suggested = args[:use_first_page_header_footer_suggested] if args.key?(:use_first_page_header_footer_suggested)
        end
      end
      
      # A tab with document contents.
      class DocumentTab
        include Google::Apis::Core::Hashable
      
        # The document body. The body typically contains the full document contents
        # except for headers, footers, and footnotes.
        # Corresponds to the JSON property `body`
        # @return [Google::Apis::DocsV1::Body]
        attr_accessor :body
      
        # The style of the document.
        # Corresponds to the JSON property `documentStyle`
        # @return [Google::Apis::DocsV1::DocumentStyle]
        attr_accessor :document_style
      
        # The footers in the document tab, keyed by footer ID.
        # Corresponds to the JSON property `footers`
        # @return [Hash<String,Google::Apis::DocsV1::Footer>]
        attr_accessor :footers
      
        # The footnotes in the document tab, keyed by footnote ID.
        # Corresponds to the JSON property `footnotes`
        # @return [Hash<String,Google::Apis::DocsV1::Footnote>]
        attr_accessor :footnotes
      
        # The headers in the document tab, keyed by header ID.
        # Corresponds to the JSON property `headers`
        # @return [Hash<String,Google::Apis::DocsV1::Header>]
        attr_accessor :headers
      
        # The inline objects in the document tab, keyed by object ID.
        # Corresponds to the JSON property `inlineObjects`
        # @return [Hash<String,Google::Apis::DocsV1::InlineObject>]
        attr_accessor :inline_objects
      
        # The lists in the document tab, keyed by list ID.
        # Corresponds to the JSON property `lists`
        # @return [Hash<String,Google::Apis::DocsV1::List>]
        attr_accessor :lists
      
        # The named ranges in the document tab, keyed by name.
        # Corresponds to the JSON property `namedRanges`
        # @return [Hash<String,Google::Apis::DocsV1::NamedRanges>]
        attr_accessor :named_ranges
      
        # The named styles. Paragraphs in the document can inherit their TextStyle and
        # ParagraphStyle from these named styles.
        # Corresponds to the JSON property `namedStyles`
        # @return [Google::Apis::DocsV1::NamedStyles]
        attr_accessor :named_styles
      
        # The positioned objects in the document tab, keyed by object ID.
        # Corresponds to the JSON property `positionedObjects`
        # @return [Hash<String,Google::Apis::DocsV1::PositionedObject>]
        attr_accessor :positioned_objects
      
        # The suggested changes to the style of the document tab, keyed by suggestion ID.
        # Corresponds to the JSON property `suggestedDocumentStyleChanges`
        # @return [Hash<String,Google::Apis::DocsV1::SuggestedDocumentStyle>]
        attr_accessor :suggested_document_style_changes
      
        # The suggested changes to the named styles of the document tab, keyed by
        # suggestion ID.
        # Corresponds to the JSON property `suggestedNamedStylesChanges`
        # @return [Hash<String,Google::Apis::DocsV1::SuggestedNamedStyles>]
        attr_accessor :suggested_named_styles_changes
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @body = args[:body] if args.key?(:body)
          @document_style = args[:document_style] if args.key?(:document_style)
          @footers = args[:footers] if args.key?(:footers)
          @footnotes = args[:footnotes] if args.key?(:footnotes)
          @headers = args[:headers] if args.key?(:headers)
          @inline_objects = args[:inline_objects] if args.key?(:inline_objects)
          @lists = args[:lists] if args.key?(:lists)
          @named_ranges = args[:named_ranges] if args.key?(:named_ranges)
          @named_styles = args[:named_styles] if args.key?(:named_styles)
          @positioned_objects = args[:positioned_objects] if args.key?(:positioned_objects)
          @suggested_document_style_changes = args[:suggested_document_style_changes] if args.key?(:suggested_document_style_changes)
          @suggested_named_styles_changes = args[:suggested_named_styles_changes] if args.key?(:suggested_named_styles_changes)
        end
      end
      
      # The properties of an embedded drawing and used to differentiate the object
      # type. An embedded drawing is one that's created and edited within a document.
      # Note that extensive details are not supported.
      class EmbeddedDrawingProperties
        include Google::Apis::Core::Hashable
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
        end
      end
      
      # A mask that indicates which of the fields on the base
      # EmbeddedDrawingProperties have been changed in this suggestion. For any field
      # set to true, there's a new suggested value.
      class EmbeddedDrawingPropertiesSuggestionState
        include Google::Apis::Core::Hashable
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
        end
      end
      
      # An embedded object in the document.
      class EmbeddedObject
        include Google::Apis::Core::Hashable
      
        # The description of the embedded object. The `title` and `description` are both
        # combined to display alt text.
        # Corresponds to the JSON property `description`
        # @return [String]
        attr_accessor :description
      
        # The properties of an embedded drawing and used to differentiate the object
        # type. An embedded drawing is one that's created and edited within a document.
        # Note that extensive details are not supported.
        # Corresponds to the JSON property `embeddedDrawingProperties`
        # @return [Google::Apis::DocsV1::EmbeddedDrawingProperties]
        attr_accessor :embedded_drawing_properties
      
        # A border around an EmbeddedObject.
        # Corresponds to the JSON property `embeddedObjectBorder`
        # @return [Google::Apis::DocsV1::EmbeddedObjectBorder]
        attr_accessor :embedded_object_border
      
        # The properties of an image.
        # Corresponds to the JSON property `imageProperties`
        # @return [Google::Apis::DocsV1::ImageProperties]
        attr_accessor :image_properties
      
        # A reference to the external linked source content.
        # Corresponds to the JSON property `linkedContentReference`
        # @return [Google::Apis::DocsV1::LinkedContentReference]
        attr_accessor :linked_content_reference
      
        # A magnitude in a single direction in the specified units.
        # Corresponds to the JSON property `marginBottom`
        # @return [Google::Apis::DocsV1::Dimension]
        attr_accessor :margin_bottom
      
        # A magnitude in a single direction in the specified units.
        # Corresponds to the JSON property `marginLeft`
        # @return [Google::Apis::DocsV1::Dimension]
        attr_accessor :margin_left
      
        # A magnitude in a single direction in the specified units.
        # Corresponds to the JSON property `marginRight`
        # @return [Google::Apis::DocsV1::Dimension]
        attr_accessor :margin_right
      
        # A magnitude in a single direction in the specified units.
        # Corresponds to the JSON property `marginTop`
        # @return [Google::Apis::DocsV1::Dimension]
        attr_accessor :margin_top
      
        # A width and height.
        # Corresponds to the JSON property `size`
        # @return [Google::Apis::DocsV1::Size]
        attr_accessor :size
      
        # The title of the embedded object. The `title` and `description` are both
        # combined to display alt text.
        # Corresponds to the JSON property `title`
        # @return [String]
        attr_accessor :title
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @description = args[:description] if args.key?(:description)
          @embedded_drawing_properties = args[:embedded_drawing_properties] if args.key?(:embedded_drawing_properties)
          @embedded_object_border = args[:embedded_object_border] if args.key?(:embedded_object_border)
          @image_properties = args[:image_properties] if args.key?(:image_properties)
          @linked_content_reference = args[:linked_content_reference] if args.key?(:linked_content_reference)
          @margin_bottom = args[:margin_bottom] if args.key?(:margin_bottom)
          @margin_left = args[:margin_left] if args.key?(:margin_left)
          @margin_right = args[:margin_right] if args.key?(:margin_right)
          @margin_top = args[:margin_top] if args.key?(:margin_top)
          @size = args[:size] if args.key?(:size)
          @title = args[:title] if args.key?(:title)
        end
      end
      
      # A border around an EmbeddedObject.
      class EmbeddedObjectBorder
        include Google::Apis::Core::Hashable
      
        # A color that can either be fully opaque or fully transparent.
        # Corresponds to the JSON property `color`
        # @return [Google::Apis::DocsV1::OptionalColor]
        attr_accessor :color
      
        # The dash style of the border.
        # Corresponds to the JSON property `dashStyle`
        # @return [String]
        attr_accessor :dash_style
      
        # The property state of the border property.
        # Corresponds to the JSON property `propertyState`
        # @return [String]
        attr_accessor :property_state
      
        # A magnitude in a single direction in the specified units.
        # Corresponds to the JSON property `width`
        # @return [Google::Apis::DocsV1::Dimension]
        attr_accessor :width
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @color = args[:color] if args.key?(:color)
          @dash_style = args[:dash_style] if args.key?(:dash_style)
          @property_state = args[:property_state] if args.key?(:property_state)
          @width = args[:width] if args.key?(:width)
        end
      end
      
      # A mask that indicates which of the fields on the base EmbeddedObjectBorder
      # have been changed in this suggestion. For any field set to true, there's a new
      # suggested value.
      class EmbeddedObjectBorderSuggestionState
        include Google::Apis::Core::Hashable
      
        # Indicates if there was a suggested change to color.
        # Corresponds to the JSON property `colorSuggested`
        # @return [Boolean]
        attr_accessor :color_suggested
        alias_method :color_suggested?, :color_suggested
      
        # Indicates if there was a suggested change to dash_style.
        # Corresponds to the JSON property `dashStyleSuggested`
        # @return [Boolean]
        attr_accessor :dash_style_suggested
        alias_method :dash_style_suggested?, :dash_style_suggested
      
        # Indicates if there was a suggested change to property_state.
        # Corresponds to the JSON property `propertyStateSuggested`
        # @return [Boolean]
        attr_accessor :property_state_suggested
        alias_method :property_state_suggested?, :property_state_suggested
      
        # Indicates if there was a suggested change to width.
        # Corresponds to the JSON property `widthSuggested`
        # @return [Boolean]
        attr_accessor :width_suggested
        alias_method :width_suggested?, :width_suggested
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @color_suggested = args[:color_suggested] if args.key?(:color_suggested)
          @dash_style_suggested = args[:dash_style_suggested] if args.key?(:dash_style_suggested)
          @property_state_suggested = args[:property_state_suggested] if args.key?(:property_state_suggested)
          @width_suggested = args[:width_suggested] if args.key?(:width_suggested)
        end
      end
      
      # A mask that indicates which of the fields on the base EmbeddedObject have been
      # changed in this suggestion. For any field set to true, there's a new suggested
      # value.
      class EmbeddedObjectSuggestionState
        include Google::Apis::Core::Hashable
      
        # Indicates if there was a suggested change to description.
        # Corresponds to the JSON property `descriptionSuggested`
        # @return [Boolean]
        attr_accessor :description_suggested
        alias_method :description_suggested?, :description_suggested
      
        # A mask that indicates which of the fields on the base
        # EmbeddedDrawingProperties have been changed in this suggestion. For any field
        # set to true, there's a new suggested value.
        # Corresponds to the JSON property `embeddedDrawingPropertiesSuggestionState`
        # @return [Google::Apis::DocsV1::EmbeddedDrawingPropertiesSuggestionState]
        attr_accessor :embedded_drawing_properties_suggestion_state
      
        # A mask that indicates which of the fields on the base EmbeddedObjectBorder
        # have been changed in this suggestion. For any field set to true, there's a new
        # suggested value.
        # Corresponds to the JSON property `embeddedObjectBorderSuggestionState`
        # @return [Google::Apis::DocsV1::EmbeddedObjectBorderSuggestionState]
        attr_accessor :embedded_object_border_suggestion_state
      
        # A mask that indicates which of the fields on the base ImageProperties have
        # been changed in this suggestion. For any field set to true, there's a new
        # suggested value.
        # Corresponds to the JSON property `imagePropertiesSuggestionState`
        # @return [Google::Apis::DocsV1::ImagePropertiesSuggestionState]
        attr_accessor :image_properties_suggestion_state
      
        # A mask that indicates which of the fields on the base LinkedContentReference
        # have been changed in this suggestion. For any field set to true, there's a new
        # suggested value.
        # Corresponds to the JSON property `linkedContentReferenceSuggestionState`
        # @return [Google::Apis::DocsV1::LinkedContentReferenceSuggestionState]
        attr_accessor :linked_content_reference_suggestion_state
      
        # Indicates if there was a suggested change to margin_bottom.
        # Corresponds to the JSON property `marginBottomSuggested`
        # @return [Boolean]
        attr_accessor :margin_bottom_suggested
        alias_method :margin_bottom_suggested?, :margin_bottom_suggested
      
        # Indicates if there was a suggested change to margin_left.
        # Corresponds to the JSON property `marginLeftSuggested`
        # @return [Boolean]
        attr_accessor :margin_left_suggested
        alias_method :margin_left_suggested?, :margin_left_suggested
      
        # Indicates if there was a suggested change to margin_right.
        # Corresponds to the JSON property `marginRightSuggested`
        # @return [Boolean]
        attr_accessor :margin_right_suggested
        alias_method :margin_right_suggested?, :margin_right_suggested
      
        # Indicates if there was a suggested change to margin_top.
        # Corresponds to the JSON property `marginTopSuggested`
        # @return [Boolean]
        attr_accessor :margin_top_suggested
        alias_method :margin_top_suggested?, :margin_top_suggested
      
        # A mask that indicates which of the fields on the base Size have been changed
        # in this suggestion. For any field set to true, the Size has a new suggested
        # value.
        # Corresponds to the JSON property `sizeSuggestionState`
        # @return [Google::Apis::DocsV1::SizeSuggestionState]
        attr_accessor :size_suggestion_state
      
        # Indicates if there was a suggested change to title.
        # Corresponds to the JSON property `titleSuggested`
        # @return [Boolean]
        attr_accessor :title_suggested
        alias_method :title_suggested?, :title_suggested
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @description_suggested = args[:description_suggested] if args.key?(:description_suggested)
          @embedded_drawing_properties_suggestion_state = args[:embedded_drawing_properties_suggestion_state] if args.key?(:embedded_drawing_properties_suggestion_state)
          @embedded_object_border_suggestion_state = args[:embedded_object_border_suggestion_state] if args.key?(:embedded_object_border_suggestion_state)
          @image_properties_suggestion_state = args[:image_properties_suggestion_state] if args.key?(:image_properties_suggestion_state)
          @linked_content_reference_suggestion_state = args[:linked_content_reference_suggestion_state] if args.key?(:linked_content_reference_suggestion_state)
          @margin_bottom_suggested = args[:margin_bottom_suggested] if args.key?(:margin_bottom_suggested)
          @margin_left_suggested = args[:margin_left_suggested] if args.key?(:margin_left_suggested)
          @margin_right_suggested = args[:margin_right_suggested] if args.key?(:margin_right_suggested)
          @margin_top_suggested = args[:margin_top_suggested] if args.key?(:margin_top_suggested)
          @size_suggestion_state = args[:size_suggestion_state] if args.key?(:size_suggestion_state)
          @title_suggested = args[:title_suggested] if args.key?(:title_suggested)
        end
      end
      
      # Location at the end of a body, header, footer or footnote. The location is
      # immediately before the last newline in the document segment.
      class EndOfSegmentLocation
        include Google::Apis::Core::Hashable
      
        # The ID of the header, footer or footnote the location is in. An empty segment
        # ID signifies the document's body.
        # Corresponds to the JSON property `segmentId`
        # @return [String]
        attr_accessor :segment_id
      
        # The tab that the location is in. When omitted, the request is applied to the
        # first tab. In a document containing a single tab: - If provided, must match
        # the singular tab's ID. - If omitted, the request applies to the singular tab.
        # In a document containing multiple tabs: - If provided, the request applies to
        # the specified tab. - If omitted, the request applies to the first tab in the
        # document.
        # Corresponds to the JSON property `tabId`
        # @return [String]
        attr_accessor :tab_id
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @segment_id = args[:segment_id] if args.key?(:segment_id)
          @tab_id = args[:tab_id] if args.key?(:tab_id)
        end
      end
      
      # A ParagraphElement representing an equation.
      class Equation
        include Google::Apis::Core::Hashable
      
        # The suggested deletion IDs. If empty, then there are no suggested deletions of
        # this content.
        # Corresponds to the JSON property `suggestedDeletionIds`
        # @return [Array<String>]
        attr_accessor :suggested_deletion_ids
      
        # The suggested insertion IDs. An Equation may have multiple insertion IDs if it'
        # s a nested suggested change. If empty, then this is not a suggested insertion.
        # Corresponds to the JSON property `suggestedInsertionIds`
        # @return [Array<String>]
        attr_accessor :suggested_insertion_ids
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @suggested_deletion_ids = args[:suggested_deletion_ids] if args.key?(:suggested_deletion_ids)
          @suggested_insertion_ids = args[:suggested_insertion_ids] if args.key?(:suggested_insertion_ids)
        end
      end
      
      # A document footer.
      class Footer
        include Google::Apis::Core::Hashable
      
        # The contents of the footer. The indexes for a footer's content begin at zero.
        # Corresponds to the JSON property `content`
        # @return [Array<Google::Apis::DocsV1::StructuralElement>]
        attr_accessor :content
      
        # The ID of the footer.
        # Corresponds to the JSON property `footerId`
        # @return [String]
        attr_accessor :footer_id
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @content = args[:content] if args.key?(:content)
          @footer_id = args[:footer_id] if args.key?(:footer_id)
        end
      end
      
      # A document footnote.
      class Footnote
        include Google::Apis::Core::Hashable
      
        # The contents of the footnote. The indexes for a footnote's content begin at
        # zero.
        # Corresponds to the JSON property `content`
        # @return [Array<Google::Apis::DocsV1::StructuralElement>]
        attr_accessor :content
      
        # The ID of the footnote.
        # Corresponds to the JSON property `footnoteId`
        # @return [String]
        attr_accessor :footnote_id
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @content = args[:content] if args.key?(:content)
          @footnote_id = args[:footnote_id] if args.key?(:footnote_id)
        end
      end
      
      # A ParagraphElement representing a footnote reference. A footnote reference is
      # the inline content rendered with a number and is used to identify the footnote.
      class FootnoteReference
        include Google::Apis::Core::Hashable
      
        # The ID of the footnote that contains the content of this footnote reference.
        # Corresponds to the JSON property `footnoteId`
        # @return [String]
        attr_accessor :footnote_id
      
        # The rendered number of this footnote.
        # Corresponds to the JSON property `footnoteNumber`
        # @return [String]
        attr_accessor :footnote_number
      
        # The suggested deletion IDs. If empty, then there are no suggested deletions of
        # this content.
        # Corresponds to the JSON property `suggestedDeletionIds`
        # @return [Array<String>]
        attr_accessor :suggested_deletion_ids
      
        # The suggested insertion IDs. A FootnoteReference may have multiple insertion
        # IDs if it's a nested suggested change. If empty, then this is not a suggested
        # insertion.
        # Corresponds to the JSON property `suggestedInsertionIds`
        # @return [Array<String>]
        attr_accessor :suggested_insertion_ids
      
        # The suggested text style changes to this FootnoteReference, keyed by
        # suggestion ID.
        # Corresponds to the JSON property `suggestedTextStyleChanges`
        # @return [Hash<String,Google::Apis::DocsV1::SuggestedTextStyle>]
        attr_accessor :suggested_text_style_changes
      
        # Represents the styling that can be applied to text. Inherited text styles are
        # represented as unset fields in this message. A text style's parent depends on
        # where the text style is defined: * The TextStyle of text in a Paragraph
        # inherits from the paragraph's corresponding named style type. * The TextStyle
        # on a named style inherits from the normal text named style. * The TextStyle of
        # the normal text named style inherits from the default text style in the Docs
        # editor. * The TextStyle on a Paragraph element that's contained in a table may
        # inherit its text style from the table style. If the text style does not
        # inherit from a parent, unsetting fields will revert the style to a value
        # matching the defaults in the Docs editor.
        # Corresponds to the JSON property `textStyle`
        # @return [Google::Apis::DocsV1::TextStyle]
        attr_accessor :text_style
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @footnote_id = args[:footnote_id] if args.key?(:footnote_id)
          @footnote_number = args[:footnote_number] if args.key?(:footnote_number)
          @suggested_deletion_ids = args[:suggested_deletion_ids] if args.key?(:suggested_deletion_ids)
          @suggested_insertion_ids = args[:suggested_insertion_ids] if args.key?(:suggested_insertion_ids)
          @suggested_text_style_changes = args[:suggested_text_style_changes] if args.key?(:suggested_text_style_changes)
          @text_style = args[:text_style] if args.key?(:text_style)
        end
      end
      
      # A document header.
      class Header
        include Google::Apis::Core::Hashable
      
        # The contents of the header. The indexes for a header's content begin at zero.
        # Corresponds to the JSON property `content`
        # @return [Array<Google::Apis::DocsV1::StructuralElement>]
        attr_accessor :content
      
        # The ID of the header.
        # Corresponds to the JSON property `headerId`
        # @return [String]
        attr_accessor :header_id
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @content = args[:content] if args.key?(:content)
          @header_id = args[:header_id] if args.key?(:header_id)
        end
      end
      
      # A reference to a heading in this document.
      class HeadingLink
        include Google::Apis::Core::Hashable
      
        # The ID of a heading in this document.
        # Corresponds to the JSON property `id`
        # @return [String]
        attr_accessor :id
      
        # The ID of the tab containing this heading.
        # Corresponds to the JSON property `tabId`
        # @return [String]
        attr_accessor :tab_id
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @id = args[:id] if args.key?(:id)
          @tab_id = args[:tab_id] if args.key?(:tab_id)
        end
      end
      
      # A ParagraphElement representing a horizontal line.
      class HorizontalRule
        include Google::Apis::Core::Hashable
      
        # The suggested deletion IDs. If empty, then there are no suggested deletions of
        # this content.
        # Corresponds to the JSON property `suggestedDeletionIds`
        # @return [Array<String>]
        attr_accessor :suggested_deletion_ids
      
        # The suggested insertion IDs. A HorizontalRule may have multiple insertion IDs
        # if it is a nested suggested change. If empty, then this is not a suggested
        # insertion.
        # Corresponds to the JSON property `suggestedInsertionIds`
        # @return [Array<String>]
        attr_accessor :suggested_insertion_ids
      
        # The suggested text style changes to this HorizontalRule, keyed by suggestion
        # ID.
        # Corresponds to the JSON property `suggestedTextStyleChanges`
        # @return [Hash<String,Google::Apis::DocsV1::SuggestedTextStyle>]
        attr_accessor :suggested_text_style_changes
      
        # Represents the styling that can be applied to text. Inherited text styles are
        # represented as unset fields in this message. A text style's parent depends on
        # where the text style is defined: * The TextStyle of text in a Paragraph
        # inherits from the paragraph's corresponding named style type. * The TextStyle
        # on a named style inherits from the normal text named style. * The TextStyle of
        # the normal text named style inherits from the default text style in the Docs
        # editor. * The TextStyle on a Paragraph element that's contained in a table may
        # inherit its text style from the table style. If the text style does not
        # inherit from a parent, unsetting fields will revert the style to a value
        # matching the defaults in the Docs editor.
        # Corresponds to the JSON property `textStyle`
        # @return [Google::Apis::DocsV1::TextStyle]
        attr_accessor :text_style
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @suggested_deletion_ids = args[:suggested_deletion_ids] if args.key?(:suggested_deletion_ids)
          @suggested_insertion_ids = args[:suggested_insertion_ids] if args.key?(:suggested_insertion_ids)
          @suggested_text_style_changes = args[:suggested_text_style_changes] if args.key?(:suggested_text_style_changes)
          @text_style = args[:text_style] if args.key?(:text_style)
        end
      end
      
      # The properties of an image.
      class ImageProperties
        include Google::Apis::Core::Hashable
      
        # The clockwise rotation angle of the image, in radians.
        # Corresponds to the JSON property `angle`
        # @return [Float]
        attr_accessor :angle
      
        # The brightness effect of the image. The value should be in the interval [-1.0,
        # 1.0], where 0 means no effect.
        # Corresponds to the JSON property `brightness`
        # @return [Float]
        attr_accessor :brightness
      
        # A URI to the image with a default lifetime of 30 minutes. This URI is tagged
        # with the account of the requester. Anyone with the URI effectively accesses
        # the image as the original requester. Access to the image may be lost if the
        # document's sharing settings change.
        # Corresponds to the JSON property `contentUri`
        # @return [String]
        attr_accessor :content_uri
      
        # The contrast effect of the image. The value should be in the interval [-1.0, 1.
        # 0], where 0 means no effect.
        # Corresponds to the JSON property `contrast`
        # @return [Float]
        attr_accessor :contrast
      
        # The crop properties of an image. The crop rectangle is represented using
        # fractional offsets from the original content's 4 edges. - If the offset is in
        # the interval (0, 1), the corresponding edge of crop rectangle is positioned
        # inside of the image's original bounding rectangle. - If the offset is negative
        # or greater than 1, the corresponding edge of crop rectangle is positioned
        # outside of the image's original bounding rectangle. - If all offsets and
        # rotation angles are 0, the image is not cropped.
        # Corresponds to the JSON property `cropProperties`
        # @return [Google::Apis::DocsV1::CropProperties]
        attr_accessor :crop_properties
      
        # The source URI is the URI used to insert the image. The source URI can be
        # empty.
        # Corresponds to the JSON property `sourceUri`
        # @return [String]
        attr_accessor :source_uri
      
        # The transparency effect of the image. The value should be in the interval [0.0,
        # 1.0], where 0 means no effect and 1 means transparent.
        # Corresponds to the JSON property `transparency`
        # @return [Float]
        attr_accessor :transparency
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @angle = args[:angle] if args.key?(:angle)
          @brightness = args[:brightness] if args.key?(:brightness)
          @content_uri = args[:content_uri] if args.key?(:content_uri)
          @contrast = args[:contrast] if args.key?(:contrast)
          @crop_properties = args[:crop_properties] if args.key?(:crop_properties)
          @source_uri = args[:source_uri] if args.key?(:source_uri)
          @transparency = args[:transparency] if args.key?(:transparency)
        end
      end
      
      # A mask that indicates which of the fields on the base ImageProperties have
      # been changed in this suggestion. For any field set to true, there's a new
      # suggested value.
      class ImagePropertiesSuggestionState
        include Google::Apis::Core::Hashable
      
        # Indicates if there was a suggested change to angle.
        # Corresponds to the JSON property `angleSuggested`
        # @return [Boolean]
        attr_accessor :angle_suggested
        alias_method :angle_suggested?, :angle_suggested
      
        # Indicates if there was a suggested change to brightness.
        # Corresponds to the JSON property `brightnessSuggested`
        # @return [Boolean]
        attr_accessor :brightness_suggested
        alias_method :brightness_suggested?, :brightness_suggested
      
        # Indicates if there was a suggested change to content_uri.
        # Corresponds to the JSON property `contentUriSuggested`
        # @return [Boolean]
        attr_accessor :content_uri_suggested
        alias_method :content_uri_suggested?, :content_uri_suggested
      
        # Indicates if there was a suggested change to contrast.
        # Corresponds to the JSON property `contrastSuggested`
        # @return [Boolean]
        attr_accessor :contrast_suggested
        alias_method :contrast_suggested?, :contrast_suggested
      
        # A mask that indicates which of the fields on the base CropProperties have been
        # changed in this suggestion. For any field set to true, there's a new suggested
        # value.
        # Corresponds to the JSON property `cropPropertiesSuggestionState`
        # @return [Google::Apis::DocsV1::CropPropertiesSuggestionState]
        attr_accessor :crop_properties_suggestion_state
      
        # Indicates if there was a suggested change to source_uri.
        # Corresponds to the JSON property `sourceUriSuggested`
        # @return [Boolean]
        attr_accessor :source_uri_suggested
        alias_method :source_uri_suggested?, :source_uri_suggested
      
        # Indicates if there was a suggested change to transparency.
        # Corresponds to the JSON property `transparencySuggested`
        # @return [Boolean]
        attr_accessor :transparency_suggested
        alias_method :transparency_suggested?, :transparency_suggested
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @angle_suggested = args[:angle_suggested] if args.key?(:angle_suggested)
          @brightness_suggested = args[:brightness_suggested] if args.key?(:brightness_suggested)
          @content_uri_suggested = args[:content_uri_suggested] if args.key?(:content_uri_suggested)
          @contrast_suggested = args[:contrast_suggested] if args.key?(:contrast_suggested)
          @crop_properties_suggestion_state = args[:crop_properties_suggestion_state] if args.key?(:crop_properties_suggestion_state)
          @source_uri_suggested = args[:source_uri_suggested] if args.key?(:source_uri_suggested)
          @transparency_suggested = args[:transparency_suggested] if args.key?(:transparency_suggested)
        end
      end
      
      # An object that appears inline with text. An InlineObject contains an
      # EmbeddedObject such as an image.
      class InlineObject
        include Google::Apis::Core::Hashable
      
        # Properties of an InlineObject.
        # Corresponds to the JSON property `inlineObjectProperties`
        # @return [Google::Apis::DocsV1::InlineObjectProperties]
        attr_accessor :inline_object_properties
      
        # The ID of this inline object. Can be used to update an object’s properties.
        # Corresponds to the JSON property `objectId`
        # @return [String]
        attr_accessor :object_id_prop
      
        # The suggested deletion IDs. If empty, then there are no suggested deletions of
        # this content.
        # Corresponds to the JSON property `suggestedDeletionIds`
        # @return [Array<String>]
        attr_accessor :suggested_deletion_ids
      
        # The suggested changes to the inline object properties, keyed by suggestion ID.
        # Corresponds to the JSON property `suggestedInlineObjectPropertiesChanges`
        # @return [Hash<String,Google::Apis::DocsV1::SuggestedInlineObjectProperties>]
        attr_accessor :suggested_inline_object_properties_changes
      
        # The suggested insertion ID. If empty, then this is not a suggested insertion.
        # Corresponds to the JSON property `suggestedInsertionId`
        # @return [String]
        attr_accessor :suggested_insertion_id
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @inline_object_properties = args[:inline_object_properties] if args.key?(:inline_object_properties)
          @object_id_prop = args[:object_id_prop] if args.key?(:object_id_prop)
          @suggested_deletion_ids = args[:suggested_deletion_ids] if args.key?(:suggested_deletion_ids)
          @suggested_inline_object_properties_changes = args[:suggested_inline_object_properties_changes] if args.key?(:suggested_inline_object_properties_changes)
          @suggested_insertion_id = args[:suggested_insertion_id] if args.key?(:suggested_insertion_id)
        end
      end
      
      # A ParagraphElement that contains an InlineObject.
      class InlineObjectElement
        include Google::Apis::Core::Hashable
      
        # The ID of the InlineObject this element contains.
        # Corresponds to the JSON property `inlineObjectId`
        # @return [String]
        attr_accessor :inline_object_id
      
        # The suggested deletion IDs. If empty, then there are no suggested deletions of
        # this content.
        # Corresponds to the JSON property `suggestedDeletionIds`
        # @return [Array<String>]
        attr_accessor :suggested_deletion_ids
      
        # The suggested insertion IDs. An InlineObjectElement may have multiple
        # insertion IDs if it's a nested suggested change. If empty, then this is not a
        # suggested insertion.
        # Corresponds to the JSON property `suggestedInsertionIds`
        # @return [Array<String>]
        attr_accessor :suggested_insertion_ids
      
        # The suggested text style changes to this InlineObject, keyed by suggestion ID.
        # Corresponds to the JSON property `suggestedTextStyleChanges`
        # @return [Hash<String,Google::Apis::DocsV1::SuggestedTextStyle>]
        attr_accessor :suggested_text_style_changes
      
        # Represents the styling that can be applied to text. Inherited text styles are
        # represented as unset fields in this message. A text style's parent depends on
        # where the text style is defined: * The TextStyle of text in a Paragraph
        # inherits from the paragraph's corresponding named style type. * The TextStyle
        # on a named style inherits from the normal text named style. * The TextStyle of
        # the normal text named style inherits from the default text style in the Docs
        # editor. * The TextStyle on a Paragraph element that's contained in a table may
        # inherit its text style from the table style. If the text style does not
        # inherit from a parent, unsetting fields will revert the style to a value
        # matching the defaults in the Docs editor.
        # Corresponds to the JSON property `textStyle`
        # @return [Google::Apis::DocsV1::TextStyle]
        attr_accessor :text_style
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @inline_object_id = args[:inline_object_id] if args.key?(:inline_object_id)
          @suggested_deletion_ids = args[:suggested_deletion_ids] if args.key?(:suggested_deletion_ids)
          @suggested_insertion_ids = args[:suggested_insertion_ids] if args.key?(:suggested_insertion_ids)
          @suggested_text_style_changes = args[:suggested_text_style_changes] if args.key?(:suggested_text_style_changes)
          @text_style = args[:text_style] if args.key?(:text_style)
        end
      end
      
      # Properties of an InlineObject.
      class InlineObjectProperties
        include Google::Apis::Core::Hashable
      
        # An embedded object in the document.
        # Corresponds to the JSON property `embeddedObject`
        # @return [Google::Apis::DocsV1::EmbeddedObject]
        attr_accessor :embedded_object
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @embedded_object = args[:embedded_object] if args.key?(:embedded_object)
        end
      end
      
      # A mask that indicates which of the fields on the base InlineObjectProperties
      # have been changed in this suggestion. For any field set to true, there's a new
      # suggested value.
      class InlineObjectPropertiesSuggestionState
        include Google::Apis::Core::Hashable
      
        # A mask that indicates which of the fields on the base EmbeddedObject have been
        # changed in this suggestion. For any field set to true, there's a new suggested
        # value.
        # Corresponds to the JSON property `embeddedObjectSuggestionState`
        # @return [Google::Apis::DocsV1::EmbeddedObjectSuggestionState]
        attr_accessor :embedded_object_suggestion_state
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @embedded_object_suggestion_state = args[:embedded_object_suggestion_state] if args.key?(:embedded_object_suggestion_state)
        end
      end
      
      # Inserts an InlineObject containing an image at the given location.
      class InsertInlineImageRequest
        include Google::Apis::Core::Hashable
      
        # Location at the end of a body, header, footer or footnote. The location is
        # immediately before the last newline in the document segment.
        # Corresponds to the JSON property `endOfSegmentLocation`
        # @return [Google::Apis::DocsV1::EndOfSegmentLocation]
        attr_accessor :end_of_segment_location
      
        # A particular location in the document.
        # Corresponds to the JSON property `location`
        # @return [Google::Apis::DocsV1::Location]
        attr_accessor :location
      
        # A width and height.
        # Corresponds to the JSON property `objectSize`
        # @return [Google::Apis::DocsV1::Size]
        attr_accessor :object_size
      
        # The image URI. The image is fetched once at insertion time and a copy is
        # stored for display inside the document. Images must be less than 50MB in size,
        # cannot exceed 25 megapixels, and must be in one of PNG, JPEG, or GIF format.
        # The provided URI must be publicly accessible and at most 2 kB in length. The
        # URI itself is saved with the image, and exposed via the ImageProperties.
        # content_uri field.
        # Corresponds to the JSON property `uri`
        # @return [String]
        attr_accessor :uri
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @end_of_segment_location = args[:end_of_segment_location] if args.key?(:end_of_segment_location)
          @location = args[:location] if args.key?(:location)
          @object_size = args[:object_size] if args.key?(:object_size)
          @uri = args[:uri] if args.key?(:uri)
        end
      end
      
      # The result of inserting an inline image.
      class InsertInlineImageResponse
        include Google::Apis::Core::Hashable
      
        # The ID of the created InlineObject.
        # Corresponds to the JSON property `objectId`
        # @return [String]
        attr_accessor :object_id_prop
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @object_id_prop = args[:object_id_prop] if args.key?(:object_id_prop)
        end
      end
      
      # The result of inserting an embedded Google Sheets chart.
      class InsertInlineSheetsChartResponse
        include Google::Apis::Core::Hashable
      
        # The object ID of the inserted chart.
        # Corresponds to the JSON property `objectId`
        # @return [String]
        attr_accessor :object_id_prop
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @object_id_prop = args[:object_id_prop] if args.key?(:object_id_prop)
        end
      end
      
      # Inserts a page break followed by a newline at the specified location.
      class InsertPageBreakRequest
        include Google::Apis::Core::Hashable
      
        # Location at the end of a body, header, footer or footnote. The location is
        # immediately before the last newline in the document segment.
        # Corresponds to the JSON property `endOfSegmentLocation`
        # @return [Google::Apis::DocsV1::EndOfSegmentLocation]
        attr_accessor :end_of_segment_location
      
        # A particular location in the document.
        # Corresponds to the JSON property `location`
        # @return [Google::Apis::DocsV1::Location]
        attr_accessor :location
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @end_of_segment_location = args[:end_of_segment_location] if args.key?(:end_of_segment_location)
          @location = args[:location] if args.key?(:location)
        end
      end
      
      # Inserts a person mention.
      class InsertPersonRequest
        include Google::Apis::Core::Hashable
      
        # Location at the end of a body, header, footer or footnote. The location is
        # immediately before the last newline in the document segment.
        # Corresponds to the JSON property `endOfSegmentLocation`
        # @return [Google::Apis::DocsV1::EndOfSegmentLocation]
        attr_accessor :end_of_segment_location
      
        # A particular location in the document.
        # Corresponds to the JSON property `location`
        # @return [Google::Apis::DocsV1::Location]
        attr_accessor :location
      
        # Properties specific to a linked Person.
        # Corresponds to the JSON property `personProperties`
        # @return [Google::Apis::DocsV1::PersonProperties]
        attr_accessor :person_properties
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @end_of_segment_location = args[:end_of_segment_location] if args.key?(:end_of_segment_location)
          @location = args[:location] if args.key?(:location)
          @person_properties = args[:person_properties] if args.key?(:person_properties)
        end
      end
      
      # Inserts a section break at the given location. A newline character will be
      # inserted before the section break.
      class InsertSectionBreakRequest
        include Google::Apis::Core::Hashable
      
        # Location at the end of a body, header, footer or footnote. The location is
        # immediately before the last newline in the document segment.
        # Corresponds to the JSON property `endOfSegmentLocation`
        # @return [Google::Apis::DocsV1::EndOfSegmentLocation]
        attr_accessor :end_of_segment_location
      
        # A particular location in the document.
        # Corresponds to the JSON property `location`
        # @return [Google::Apis::DocsV1::Location]
        attr_accessor :location
      
        # The type of section to insert.
        # Corresponds to the JSON property `sectionType`
        # @return [String]
        attr_accessor :section_type
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @end_of_segment_location = args[:end_of_segment_location] if args.key?(:end_of_segment_location)
          @location = args[:location] if args.key?(:location)
          @section_type = args[:section_type] if args.key?(:section_type)
        end
      end
      
      # Inserts an empty column into a table.
      class InsertTableColumnRequest
        include Google::Apis::Core::Hashable
      
        # Whether to insert new column to the right of the reference cell location. - `
        # True`: insert to the right. - `False`: insert to the left.
        # Corresponds to the JSON property `insertRight`
        # @return [Boolean]
        attr_accessor :insert_right
        alias_method :insert_right?, :insert_right
      
        # Location of a single cell within a table.
        # Corresponds to the JSON property `tableCellLocation`
        # @return [Google::Apis::DocsV1::TableCellLocation]
        attr_accessor :table_cell_location
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @insert_right = args[:insert_right] if args.key?(:insert_right)
          @table_cell_location = args[:table_cell_location] if args.key?(:table_cell_location)
        end
      end
      
      # Inserts a table at the specified location. A newline character will be
      # inserted before the inserted table.
      class InsertTableRequest
        include Google::Apis::Core::Hashable
      
        # The number of columns in the table.
        # Corresponds to the JSON property `columns`
        # @return [Fixnum]
        attr_accessor :columns
      
        # Location at the end of a body, header, footer or footnote. The location is
        # immediately before the last newline in the document segment.
        # Corresponds to the JSON property `endOfSegmentLocation`
        # @return [Google::Apis::DocsV1::EndOfSegmentLocation]
        attr_accessor :end_of_segment_location
      
        # A particular location in the document.
        # Corresponds to the JSON property `location`
        # @return [Google::Apis::DocsV1::Location]
        attr_accessor :location
      
        # The number of rows in the table.
        # Corresponds to the JSON property `rows`
        # @return [Fixnum]
        attr_accessor :rows
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @columns = args[:columns] if args.key?(:columns)
          @end_of_segment_location = args[:end_of_segment_location] if args.key?(:end_of_segment_location)
          @location = args[:location] if args.key?(:location)
          @rows = args[:rows] if args.key?(:rows)
        end
      end
      
      # Inserts an empty row into a table.
      class InsertTableRowRequest
        include Google::Apis::Core::Hashable
      
        # Whether to insert new row below the reference cell location. - `True`: insert
        # below the cell. - `False`: insert above the cell.
        # Corresponds to the JSON property `insertBelow`
        # @return [Boolean]
        attr_accessor :insert_below
        alias_method :insert_below?, :insert_below
      
        # Location of a single cell within a table.
        # Corresponds to the JSON property `tableCellLocation`
        # @return [Google::Apis::DocsV1::TableCellLocation]
        attr_accessor :table_cell_location
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @insert_below = args[:insert_below] if args.key?(:insert_below)
          @table_cell_location = args[:table_cell_location] if args.key?(:table_cell_location)
        end
      end
      
      # Inserts text at the specified location.
      class InsertTextRequest
        include Google::Apis::Core::Hashable
      
        # Location at the end of a body, header, footer or footnote. The location is
        # immediately before the last newline in the document segment.
        # Corresponds to the JSON property `endOfSegmentLocation`
        # @return [Google::Apis::DocsV1::EndOfSegmentLocation]
        attr_accessor :end_of_segment_location
      
        # A particular location in the document.
        # Corresponds to the JSON property `location`
        # @return [Google::Apis::DocsV1::Location]
        attr_accessor :location
      
        # The text to be inserted. Inserting a newline character will implicitly create
        # a new Paragraph at that index. The paragraph style of the new paragraph will
        # be copied from the paragraph at the current insertion index, including lists
        # and bullets. Text styles for inserted text will be determined automatically,
        # generally preserving the styling of neighboring text. In most cases, the text
        # style for the inserted text will match the text immediately before the
        # insertion index. Some control characters (U+0000-U+0008, U+000C-U+001F) and
        # characters from the Unicode Basic Multilingual Plane Private Use Area (U+E000-
        # U+F8FF) will be stripped out of the inserted text.
        # Corresponds to the JSON property `text`
        # @return [String]
        attr_accessor :text
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @end_of_segment_location = args[:end_of_segment_location] if args.key?(:end_of_segment_location)
          @location = args[:location] if args.key?(:location)
          @text = args[:text] if args.key?(:text)
        end
      end
      
      # A reference to another portion of a document or an external URL resource.
      class Link
        include Google::Apis::Core::Hashable
      
        # A reference to a bookmark in this document.
        # Corresponds to the JSON property `bookmark`
        # @return [Google::Apis::DocsV1::BookmarkLink]
        attr_accessor :bookmark
      
        # The ID of a bookmark in this document. Legacy field: Instead, set
        # includeTabsContent to `true` and use Link.bookmark for read and write
        # operations. This field is only returned when includeTabsContent is set to `
        # false` in documents containing a single tab and links to a bookmark within the
        # singular tab. Otherwise, Link.bookmark is returned. If this field is used in a
        # write request, the bookmark is considered to be from the tab ID specified in
        # the request. If a tab ID is not specified in the request, it is considered to
        # be from the first tab in the document.
        # Corresponds to the JSON property `bookmarkId`
        # @return [String]
        attr_accessor :bookmark_id
      
        # A reference to a heading in this document.
        # Corresponds to the JSON property `heading`
        # @return [Google::Apis::DocsV1::HeadingLink]
        attr_accessor :heading
      
        # The ID of a heading in this document. Legacy field: Instead, set
        # includeTabsContent to `true` and use Link.heading for read and write
        # operations. This field is only returned when includeTabsContent is set to `
        # false` in documents containing a single tab and links to a heading within the
        # singular tab. Otherwise, Link.heading is returned. If this field is used in a
        # write request, the heading is considered to be from the tab ID specified in
        # the request. If a tab ID is not specified in the request, it is considered to
        # be from the first tab in the document.
        # Corresponds to the JSON property `headingId`
        # @return [String]
        attr_accessor :heading_id
      
        # The ID of a tab in this document.
        # Corresponds to the JSON property `tabId`
        # @return [String]
        attr_accessor :tab_id
      
        # An external URL.
        # Corresponds to the JSON property `url`
        # @return [String]
        attr_accessor :url
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @bookmark = args[:bookmark] if args.key?(:bookmark)
          @bookmark_id = args[:bookmark_id] if args.key?(:bookmark_id)
          @heading = args[:heading] if args.key?(:heading)
          @heading_id = args[:heading_id] if args.key?(:heading_id)
          @tab_id = args[:tab_id] if args.key?(:tab_id)
          @url = args[:url] if args.key?(:url)
        end
      end
      
      # A reference to the external linked source content.
      class LinkedContentReference
        include Google::Apis::Core::Hashable
      
        # A reference to a linked chart embedded from Google Sheets.
        # Corresponds to the JSON property `sheetsChartReference`
        # @return [Google::Apis::DocsV1::SheetsChartReference]
        attr_accessor :sheets_chart_reference
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @sheets_chart_reference = args[:sheets_chart_reference] if args.key?(:sheets_chart_reference)
        end
      end
      
      # A mask that indicates which of the fields on the base LinkedContentReference
      # have been changed in this suggestion. For any field set to true, there's a new
      # suggested value.
      class LinkedContentReferenceSuggestionState
        include Google::Apis::Core::Hashable
      
        # A mask that indicates which of the fields on the base SheetsChartReference
        # have been changed in this suggestion. For any field set to true, there's a new
        # suggested value.
        # Corresponds to the JSON property `sheetsChartReferenceSuggestionState`
        # @return [Google::Apis::DocsV1::SheetsChartReferenceSuggestionState]
        attr_accessor :sheets_chart_reference_suggestion_state
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @sheets_chart_reference_suggestion_state = args[:sheets_chart_reference_suggestion_state] if args.key?(:sheets_chart_reference_suggestion_state)
        end
      end
      
      # A List represents the list attributes for a group of paragraphs that all
      # belong to the same list. A paragraph that's part of a list has a reference to
      # the list's ID in its bullet.
      class List
        include Google::Apis::Core::Hashable
      
        # The properties of a list that describe the look and feel of bullets belonging
        # to paragraphs associated with a list.
        # Corresponds to the JSON property `listProperties`
        # @return [Google::Apis::DocsV1::ListProperties]
        attr_accessor :list_properties
      
        # The suggested deletion IDs. If empty, then there are no suggested deletions of
        # this list.
        # Corresponds to the JSON property `suggestedDeletionIds`
        # @return [Array<String>]
        attr_accessor :suggested_deletion_ids
      
        # The suggested insertion ID. If empty, then this is not a suggested insertion.
        # Corresponds to the JSON property `suggestedInsertionId`
        # @return [String]
        attr_accessor :suggested_insertion_id
      
        # The suggested changes to the list properties, keyed by suggestion ID.
        # Corresponds to the JSON property `suggestedListPropertiesChanges`
        # @return [Hash<String,Google::Apis::DocsV1::SuggestedListProperties>]
        attr_accessor :suggested_list_properties_changes
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @list_properties = args[:list_properties] if args.key?(:list_properties)
          @suggested_deletion_ids = args[:suggested_deletion_ids] if args.key?(:suggested_deletion_ids)
          @suggested_insertion_id = args[:suggested_insertion_id] if args.key?(:suggested_insertion_id)
          @suggested_list_properties_changes = args[:suggested_list_properties_changes] if args.key?(:suggested_list_properties_changes)
        end
      end
      
      # The properties of a list that describe the look and feel of bullets belonging
      # to paragraphs associated with a list.
      class ListProperties
        include Google::Apis::Core::Hashable
      
        # Describes the properties of the bullets at the associated level. A list has at
        # most 9 levels of nesting with nesting level 0 corresponding to the top-most
        # level and nesting level 8 corresponding to the most nested level. The nesting
        # levels are returned in ascending order with the least nested returned first.
        # Corresponds to the JSON property `nestingLevels`
        # @return [Array<Google::Apis::DocsV1::NestingLevel>]
        attr_accessor :nesting_levels
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @nesting_levels = args[:nesting_levels] if args.key?(:nesting_levels)
        end
      end
      
      # A mask that indicates which of the fields on the base ListProperties have been
      # changed in this suggestion. For any field set to true, there's a new suggested
      # value.
      class ListPropertiesSuggestionState
        include Google::Apis::Core::Hashable
      
        # A mask that indicates which of the fields on the corresponding NestingLevel in
        # nesting_levels have been changed in this suggestion. The nesting level
        # suggestion states are returned in ascending order of the nesting level with
        # the least nested returned first.
        # Corresponds to the JSON property `nestingLevelsSuggestionStates`
        # @return [Array<Google::Apis::DocsV1::NestingLevelSuggestionState>]
        attr_accessor :nesting_levels_suggestion_states
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @nesting_levels_suggestion_states = args[:nesting_levels_suggestion_states] if args.key?(:nesting_levels_suggestion_states)
        end
      end
      
      # A particular location in the document.
      class Location
        include Google::Apis::Core::Hashable
      
        # The zero-based index, in UTF-16 code units. The index is relative to the
        # beginning of the segment specified by segment_id.
        # Corresponds to the JSON property `index`
        # @return [Fixnum]
        attr_accessor :index
      
        # The ID of the header, footer or footnote the location is in. An empty segment
        # ID signifies the document's body.
        # Corresponds to the JSON property `segmentId`
        # @return [String]
        attr_accessor :segment_id
      
        # The tab that the location is in. When omitted, the request is applied to the
        # first tab. In a document containing a single tab: - If provided, must match
        # the singular tab's ID. - If omitted, the request applies to the singular tab.
        # In a document containing multiple tabs: - If provided, the request applies to
        # the specified tab. - If omitted, the request applies to the first tab in the
        # document.
        # Corresponds to the JSON property `tabId`
        # @return [String]
        attr_accessor :tab_id
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @index = args[:index] if args.key?(:index)
          @segment_id = args[:segment_id] if args.key?(:segment_id)
          @tab_id = args[:tab_id] if args.key?(:tab_id)
        end
      end
      
      # Merges cells in a Table.
      class MergeTableCellsRequest
        include Google::Apis::Core::Hashable
      
        # A table range represents a reference to a subset of a table. It's important to
        # note that the cells specified by a table range do not necessarily form a
        # rectangle. For example, let's say we have a 3 x 3 table where all the cells of
        # the last row are merged together. The table looks like this: [ ] A table range
        # with table cell location = (table_start_location, row = 0, column = 0), row
        # span = 3 and column span = 2 specifies the following cells: x x [ x x x ]
        # Corresponds to the JSON property `tableRange`
        # @return [Google::Apis::DocsV1::TableRange]
        attr_accessor :table_range
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @table_range = args[:table_range] if args.key?(:table_range)
        end
      end
      
      # A collection of Ranges with the same named range ID. Named ranges allow
      # developers to associate parts of a document with an arbitrary user-defined
      # label so their contents can be programmatically read or edited later. A
      # document can contain multiple named ranges with the same name, but every named
      # range has a unique ID. A named range is created with a single Range, and
      # content inserted inside a named range generally expands that range. However,
      # certain document changes can cause the range to be split into multiple ranges.
      # Named ranges are not private. All applications and collaborators that have
      # access to the document can see its named ranges.
      class NamedRange
        include Google::Apis::Core::Hashable
      
        # The name of the named range.
        # Corresponds to the JSON property `name`
        # @return [String]
        attr_accessor :name
      
        # The ID of the named range.
        # Corresponds to the JSON property `namedRangeId`
        # @return [String]
        attr_accessor :named_range_id
      
        # The ranges that belong to this named range.
        # Corresponds to the JSON property `ranges`
        # @return [Array<Google::Apis::DocsV1::Range>]
        attr_accessor :ranges
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @name = args[:name] if args.key?(:name)
          @named_range_id = args[:named_range_id] if args.key?(:named_range_id)
          @ranges = args[:ranges] if args.key?(:ranges)
        end
      end
      
      # A collection of all the NamedRanges in the document that share a given name.
      class NamedRanges
        include Google::Apis::Core::Hashable
      
        # The name that all the named ranges share.
        # Corresponds to the JSON property `name`
        # @return [String]
        attr_accessor :name
      
        # The NamedRanges that share the same name.
        # Corresponds to the JSON property `namedRanges`
        # @return [Array<Google::Apis::DocsV1::NamedRange>]
        attr_accessor :named_ranges
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @name = args[:name] if args.key?(:name)
          @named_ranges = args[:named_ranges] if args.key?(:named_ranges)
        end
      end
      
      # A named style. Paragraphs in the document can inherit their TextStyle and
      # ParagraphStyle from this named style when they have the same named style type.
      class NamedStyle
        include Google::Apis::Core::Hashable
      
        # The type of this named style.
        # Corresponds to the JSON property `namedStyleType`
        # @return [String]
        attr_accessor :named_style_type
      
        # Styles that apply to a whole paragraph. Inherited paragraph styles are
        # represented as unset fields in this message. A paragraph style's parent
        # depends on where the paragraph style is defined: * The ParagraphStyle on a
        # Paragraph inherits from the paragraph's corresponding named style type. * The
        # ParagraphStyle on a named style inherits from the normal text named style. *
        # The ParagraphStyle of the normal text named style inherits from the default
        # paragraph style in the Docs editor. * The ParagraphStyle on a Paragraph
        # element that's contained in a table may inherit its paragraph style from the
        # table style. If the paragraph style does not inherit from a parent, unsetting
        # fields will revert the style to a value matching the defaults in the Docs
        # editor.
        # Corresponds to the JSON property `paragraphStyle`
        # @return [Google::Apis::DocsV1::ParagraphStyle]
        attr_accessor :paragraph_style
      
        # Represents the styling that can be applied to text. Inherited text styles are
        # represented as unset fields in this message. A text style's parent depends on
        # where the text style is defined: * The TextStyle of text in a Paragraph
        # inherits from the paragraph's corresponding named style type. * The TextStyle
        # on a named style inherits from the normal text named style. * The TextStyle of
        # the normal text named style inherits from the default text style in the Docs
        # editor. * The TextStyle on a Paragraph element that's contained in a table may
        # inherit its text style from the table style. If the text style does not
        # inherit from a parent, unsetting fields will revert the style to a value
        # matching the defaults in the Docs editor.
        # Corresponds to the JSON property `textStyle`
        # @return [Google::Apis::DocsV1::TextStyle]
        attr_accessor :text_style
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @named_style_type = args[:named_style_type] if args.key?(:named_style_type)
          @paragraph_style = args[:paragraph_style] if args.key?(:paragraph_style)
          @text_style = args[:text_style] if args.key?(:text_style)
        end
      end
      
      # A suggestion state of a NamedStyle message.
      class NamedStyleSuggestionState
        include Google::Apis::Core::Hashable
      
        # The named style type that this suggestion state corresponds to. This field is
        # provided as a convenience for matching the NamedStyleSuggestionState with its
        # corresponding NamedStyle.
        # Corresponds to the JSON property `namedStyleType`
        # @return [String]
        attr_accessor :named_style_type
      
        # A mask that indicates which of the fields on the base ParagraphStyle have been
        # changed in this suggestion. For any field set to true, there's a new suggested
        # value.
        # Corresponds to the JSON property `paragraphStyleSuggestionState`
        # @return [Google::Apis::DocsV1::ParagraphStyleSuggestionState]
        attr_accessor :paragraph_style_suggestion_state
      
        # A mask that indicates which of the fields on the base TextStyle have been
        # changed in this suggestion. For any field set to true, there's a new suggested
        # value.
        # Corresponds to the JSON property `textStyleSuggestionState`
        # @return [Google::Apis::DocsV1::TextStyleSuggestionState]
        attr_accessor :text_style_suggestion_state
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @named_style_type = args[:named_style_type] if args.key?(:named_style_type)
          @paragraph_style_suggestion_state = args[:paragraph_style_suggestion_state] if args.key?(:paragraph_style_suggestion_state)
          @text_style_suggestion_state = args[:text_style_suggestion_state] if args.key?(:text_style_suggestion_state)
        end
      end
      
      # The named styles. Paragraphs in the document can inherit their TextStyle and
      # ParagraphStyle from these named styles.
      class NamedStyles
        include Google::Apis::Core::Hashable
      
        # The named styles. There's an entry for each of the possible named style types.
        # Corresponds to the JSON property `styles`
        # @return [Array<Google::Apis::DocsV1::NamedStyle>]
        attr_accessor :styles
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @styles = args[:styles] if args.key?(:styles)
        end
      end
      
      # The suggestion state of a NamedStyles message.
      class NamedStylesSuggestionState
        include Google::Apis::Core::Hashable
      
        # A mask that indicates which of the fields on the corresponding NamedStyle in
        # styles have been changed in this suggestion. The order of these named style
        # suggestion states matches the order of the corresponding named style within
        # the named styles suggestion.
        # Corresponds to the JSON property `stylesSuggestionStates`
        # @return [Array<Google::Apis::DocsV1::NamedStyleSuggestionState>]
        attr_accessor :styles_suggestion_states
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @styles_suggestion_states = args[:styles_suggestion_states] if args.key?(:styles_suggestion_states)
        end
      end
      
      # Contains properties describing the look and feel of a list bullet at a given
      # level of nesting.
      class NestingLevel
        include Google::Apis::Core::Hashable
      
        # The alignment of the bullet within the space allotted for rendering the bullet.
        # Corresponds to the JSON property `bulletAlignment`
        # @return [String]
        attr_accessor :bullet_alignment
      
        # The format string used by bullets at this level of nesting. The glyph format
        # contains one or more placeholders, and these placeholders are replaced with
        # the appropriate values depending on the glyph_type or glyph_symbol. The
        # placeholders follow the pattern `%[nesting_level]`. Furthermore, placeholders
        # can have prefixes and suffixes. Thus, the glyph format follows the pattern `%[
        # nesting_level]`. Note that the prefix and suffix are optional and can be
        # arbitrary strings. For example, the glyph format `%0.` indicates that the
        # rendered glyph will replace the placeholder with the corresponding glyph for
        # nesting level 0 followed by a period as the suffix. So a list with a glyph
        # type of UPPER_ALPHA and glyph format `%0.` at nesting level 0 will result in a
        # list with rendered glyphs `A.` `B.` `C.` The glyph format can contain
        # placeholders for the current nesting level as well as placeholders for parent
        # nesting levels. For example, a list can have a glyph format of `%0.` at
        # nesting level 0 and a glyph format of `%0.%1.` at nesting level 1. Assuming
        # both nesting levels have DECIMAL glyph types, this would result in a list with
        # rendered glyphs `1.` `2.` ` 2.1.` ` 2.2.` `3.` For nesting levels that are
        # ordered, the string that replaces a placeholder in the glyph format for a
        # particular paragraph depends on the paragraph's order within the list.
        # Corresponds to the JSON property `glyphFormat`
        # @return [String]
        attr_accessor :glyph_format
      
        # A custom glyph symbol used by bullets when paragraphs at this level of nesting
        # is unordered. The glyph symbol replaces placeholders within the glyph_format.
        # For example, if the glyph_symbol is the solid circle corresponding to Unicode
        # U+25cf code point and the glyph_format is `%0`, the rendered glyph would be
        # the solid circle.
        # Corresponds to the JSON property `glyphSymbol`
        # @return [String]
        attr_accessor :glyph_symbol
      
        # The type of glyph used by bullets when paragraphs at this level of nesting is
        # ordered. The glyph type determines the type of glyph used to replace
        # placeholders within the glyph_format when paragraphs at this level of nesting
        # are ordered. For example, if the nesting level is 0, the glyph_format is `%0.`
        # and the glyph type is DECIMAL, then the rendered glyph would replace the
        # placeholder `%0` in the glyph format with a number corresponding to the list
        # item's order within the list.
        # Corresponds to the JSON property `glyphType`
        # @return [String]
        attr_accessor :glyph_type
      
        # A magnitude in a single direction in the specified units.
        # Corresponds to the JSON property `indentFirstLine`
        # @return [Google::Apis::DocsV1::Dimension]
        attr_accessor :indent_first_line
      
        # A magnitude in a single direction in the specified units.
        # Corresponds to the JSON property `indentStart`
        # @return [Google::Apis::DocsV1::Dimension]
        attr_accessor :indent_start
      
        # The number of the first list item at this nesting level. A value of 0 is
        # treated as a value of 1 for lettered lists and Roman numeral lists. For values
        # of both 0 and 1, lettered and Roman numeral lists will begin at `a` and `i`
        # respectively. This value is ignored for nesting levels with unordered glyphs.
        # Corresponds to the JSON property `startNumber`
        # @return [Fixnum]
        attr_accessor :start_number
      
        # Represents the styling that can be applied to text. Inherited text styles are
        # represented as unset fields in this message. A text style's parent depends on
        # where the text style is defined: * The TextStyle of text in a Paragraph
        # inherits from the paragraph's corresponding named style type. * The TextStyle
        # on a named style inherits from the normal text named style. * The TextStyle of
        # the normal text named style inherits from the default text style in the Docs
        # editor. * The TextStyle on a Paragraph element that's contained in a table may
        # inherit its text style from the table style. If the text style does not
        # inherit from a parent, unsetting fields will revert the style to a value
        # matching the defaults in the Docs editor.
        # Corresponds to the JSON property `textStyle`
        # @return [Google::Apis::DocsV1::TextStyle]
        attr_accessor :text_style
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @bullet_alignment = args[:bullet_alignment] if args.key?(:bullet_alignment)
          @glyph_format = args[:glyph_format] if args.key?(:glyph_format)
          @glyph_symbol = args[:glyph_symbol] if args.key?(:glyph_symbol)
          @glyph_type = args[:glyph_type] if args.key?(:glyph_type)
          @indent_first_line = args[:indent_first_line] if args.key?(:indent_first_line)
          @indent_start = args[:indent_start] if args.key?(:indent_start)
          @start_number = args[:start_number] if args.key?(:start_number)
          @text_style = args[:text_style] if args.key?(:text_style)
        end
      end
      
      # A mask that indicates which of the fields on the base NestingLevel have been
      # changed in this suggestion. For any field set to true, there's a new suggested
      # value.
      class NestingLevelSuggestionState
        include Google::Apis::Core::Hashable
      
        # Indicates if there was a suggested change to bullet_alignment.
        # Corresponds to the JSON property `bulletAlignmentSuggested`
        # @return [Boolean]
        attr_accessor :bullet_alignment_suggested
        alias_method :bullet_alignment_suggested?, :bullet_alignment_suggested
      
        # Indicates if there was a suggested change to glyph_format.
        # Corresponds to the JSON property `glyphFormatSuggested`
        # @return [Boolean]
        attr_accessor :glyph_format_suggested
        alias_method :glyph_format_suggested?, :glyph_format_suggested
      
        # Indicates if there was a suggested change to glyph_symbol.
        # Corresponds to the JSON property `glyphSymbolSuggested`
        # @return [Boolean]
        attr_accessor :glyph_symbol_suggested
        alias_method :glyph_symbol_suggested?, :glyph_symbol_suggested
      
        # Indicates if there was a suggested change to glyph_type.
        # Corresponds to the JSON property `glyphTypeSuggested`
        # @return [Boolean]
        attr_accessor :glyph_type_suggested
        alias_method :glyph_type_suggested?, :glyph_type_suggested
      
        # Indicates if there was a suggested change to indent_first_line.
        # Corresponds to the JSON property `indentFirstLineSuggested`
        # @return [Boolean]
        attr_accessor :indent_first_line_suggested
        alias_method :indent_first_line_suggested?, :indent_first_line_suggested
      
        # Indicates if there was a suggested change to indent_start.
        # Corresponds to the JSON property `indentStartSuggested`
        # @return [Boolean]
        attr_accessor :indent_start_suggested
        alias_method :indent_start_suggested?, :indent_start_suggested
      
        # Indicates if there was a suggested change to start_number.
        # Corresponds to the JSON property `startNumberSuggested`
        # @return [Boolean]
        attr_accessor :start_number_suggested
        alias_method :start_number_suggested?, :start_number_suggested
      
        # A mask that indicates which of the fields on the base TextStyle have been
        # changed in this suggestion. For any field set to true, there's a new suggested
        # value.
        # Corresponds to the JSON property `textStyleSuggestionState`
        # @return [Google::Apis::DocsV1::TextStyleSuggestionState]
        attr_accessor :text_style_suggestion_state
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @bullet_alignment_suggested = args[:bullet_alignment_suggested] if args.key?(:bullet_alignment_suggested)
          @glyph_format_suggested = args[:glyph_format_suggested] if args.key?(:glyph_format_suggested)
          @glyph_symbol_suggested = args[:glyph_symbol_suggested] if args.key?(:glyph_symbol_suggested)
          @glyph_type_suggested = args[:glyph_type_suggested] if args.key?(:glyph_type_suggested)
          @indent_first_line_suggested = args[:indent_first_line_suggested] if args.key?(:indent_first_line_suggested)
          @indent_start_suggested = args[:indent_start_suggested] if args.key?(:indent_start_suggested)
          @start_number_suggested = args[:start_number_suggested] if args.key?(:start_number_suggested)
          @text_style_suggestion_state = args[:text_style_suggestion_state] if args.key?(:text_style_suggestion_state)
        end
      end
      
      # A collection of object IDs.
      class ObjectReferences
        include Google::Apis::Core::Hashable
      
        # The object IDs.
        # Corresponds to the JSON property `objectIds`
        # @return [Array<String>]
        attr_accessor :object_ids
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @object_ids = args[:object_ids] if args.key?(:object_ids)
        end
      end
      
      # A color that can either be fully opaque or fully transparent.
      class OptionalColor
        include Google::Apis::Core::Hashable
      
        # A solid color.
        # Corresponds to the JSON property `color`
        # @return [Google::Apis::DocsV1::Color]
        attr_accessor :color
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @color = args[:color] if args.key?(:color)
        end
      end
      
      # A ParagraphElement representing a page break. A page break makes the
      # subsequent text start at the top of the next page.
      class PageBreak
        include Google::Apis::Core::Hashable
      
        # The suggested deletion IDs. If empty, then there are no suggested deletions of
        # this content.
        # Corresponds to the JSON property `suggestedDeletionIds`
        # @return [Array<String>]
        attr_accessor :suggested_deletion_ids
      
        # The suggested insertion IDs. A PageBreak may have multiple insertion IDs if it'
        # s a nested suggested change. If empty, then this is not a suggested insertion.
        # Corresponds to the JSON property `suggestedInsertionIds`
        # @return [Array<String>]
        attr_accessor :suggested_insertion_ids
      
        # The suggested text style changes to this PageBreak, keyed by suggestion ID.
        # Corresponds to the JSON property `suggestedTextStyleChanges`
        # @return [Hash<String,Google::Apis::DocsV1::SuggestedTextStyle>]
        attr_accessor :suggested_text_style_changes
      
        # Represents the styling that can be applied to text. Inherited text styles are
        # represented as unset fields in this message. A text style's parent depends on
        # where the text style is defined: * The TextStyle of text in a Paragraph
        # inherits from the paragraph's corresponding named style type. * The TextStyle
        # on a named style inherits from the normal text named style. * The TextStyle of
        # the normal text named style inherits from the default text style in the Docs
        # editor. * The TextStyle on a Paragraph element that's contained in a table may
        # inherit its text style from the table style. If the text style does not
        # inherit from a parent, unsetting fields will revert the style to a value
        # matching the defaults in the Docs editor.
        # Corresponds to the JSON property `textStyle`
        # @return [Google::Apis::DocsV1::TextStyle]
        attr_accessor :text_style
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @suggested_deletion_ids = args[:suggested_deletion_ids] if args.key?(:suggested_deletion_ids)
          @suggested_insertion_ids = args[:suggested_insertion_ids] if args.key?(:suggested_insertion_ids)
          @suggested_text_style_changes = args[:suggested_text_style_changes] if args.key?(:suggested_text_style_changes)
          @text_style = args[:text_style] if args.key?(:text_style)
        end
      end
      
      # A StructuralElement representing a paragraph. A paragraph is a range of
      # content that's terminated with a newline character.
      class Paragraph
        include Google::Apis::Core::Hashable
      
        # Describes the bullet of a paragraph.
        # Corresponds to the JSON property `bullet`
        # @return [Google::Apis::DocsV1::Bullet]
        attr_accessor :bullet
      
        # The content of the paragraph, broken down into its component parts.
        # Corresponds to the JSON property `elements`
        # @return [Array<Google::Apis::DocsV1::ParagraphElement>]
        attr_accessor :elements
      
        # Styles that apply to a whole paragraph. Inherited paragraph styles are
        # represented as unset fields in this message. A paragraph style's parent
        # depends on where the paragraph style is defined: * The ParagraphStyle on a
        # Paragraph inherits from the paragraph's corresponding named style type. * The
        # ParagraphStyle on a named style inherits from the normal text named style. *
        # The ParagraphStyle of the normal text named style inherits from the default
        # paragraph style in the Docs editor. * The ParagraphStyle on a Paragraph
        # element that's contained in a table may inherit its paragraph style from the
        # table style. If the paragraph style does not inherit from a parent, unsetting
        # fields will revert the style to a value matching the defaults in the Docs
        # editor.
        # Corresponds to the JSON property `paragraphStyle`
        # @return [Google::Apis::DocsV1::ParagraphStyle]
        attr_accessor :paragraph_style
      
        # The IDs of the positioned objects tethered to this paragraph.
        # Corresponds to the JSON property `positionedObjectIds`
        # @return [Array<String>]
        attr_accessor :positioned_object_ids
      
        # The suggested changes to this paragraph's bullet.
        # Corresponds to the JSON property `suggestedBulletChanges`
        # @return [Hash<String,Google::Apis::DocsV1::SuggestedBullet>]
        attr_accessor :suggested_bullet_changes
      
        # The suggested paragraph style changes to this paragraph, keyed by suggestion
        # ID.
        # Corresponds to the JSON property `suggestedParagraphStyleChanges`
        # @return [Hash<String,Google::Apis::DocsV1::SuggestedParagraphStyle>]
        attr_accessor :suggested_paragraph_style_changes
      
        # The IDs of the positioned objects suggested to be attached to this paragraph,
        # keyed by suggestion ID.
        # Corresponds to the JSON property `suggestedPositionedObjectIds`
        # @return [Hash<String,Google::Apis::DocsV1::ObjectReferences>]
        attr_accessor :suggested_positioned_object_ids
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @bullet = args[:bullet] if args.key?(:bullet)
          @elements = args[:elements] if args.key?(:elements)
          @paragraph_style = args[:paragraph_style] if args.key?(:paragraph_style)
          @positioned_object_ids = args[:positioned_object_ids] if args.key?(:positioned_object_ids)
          @suggested_bullet_changes = args[:suggested_bullet_changes] if args.key?(:suggested_bullet_changes)
          @suggested_paragraph_style_changes = args[:suggested_paragraph_style_changes] if args.key?(:suggested_paragraph_style_changes)
          @suggested_positioned_object_ids = args[:suggested_positioned_object_ids] if args.key?(:suggested_positioned_object_ids)
        end
      end
      
      # A border around a paragraph.
      class ParagraphBorder
        include Google::Apis::Core::Hashable
      
        # A color that can either be fully opaque or fully transparent.
        # Corresponds to the JSON property `color`
        # @return [Google::Apis::DocsV1::OptionalColor]
        attr_accessor :color
      
        # The dash style of the border.
        # Corresponds to the JSON property `dashStyle`
        # @return [String]
        attr_accessor :dash_style
      
        # A magnitude in a single direction in the specified units.
        # Corresponds to the JSON property `padding`
        # @return [Google::Apis::DocsV1::Dimension]
        attr_accessor :padding
      
        # A magnitude in a single direction in the specified units.
        # Corresponds to the JSON property `width`
        # @return [Google::Apis::DocsV1::Dimension]
        attr_accessor :width
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @color = args[:color] if args.key?(:color)
          @dash_style = args[:dash_style] if args.key?(:dash_style)
          @padding = args[:padding] if args.key?(:padding)
          @width = args[:width] if args.key?(:width)
        end
      end
      
      # A ParagraphElement describes content within a Paragraph.
      class ParagraphElement
        include Google::Apis::Core::Hashable
      
        # A ParagraphElement representing a spot in the text that's dynamically replaced
        # with content that can change over time, like a page number.
        # Corresponds to the JSON property `autoText`
        # @return [Google::Apis::DocsV1::AutoText]
        attr_accessor :auto_text
      
        # A ParagraphElement representing a column break. A column break makes the
        # subsequent text start at the top of the next column.
        # Corresponds to the JSON property `columnBreak`
        # @return [Google::Apis::DocsV1::ColumnBreak]
        attr_accessor :column_break
      
        # The zero-base end index of this paragraph element, exclusive, in UTF-16 code
        # units.
        # Corresponds to the JSON property `endIndex`
        # @return [Fixnum]
        attr_accessor :end_index
      
        # A ParagraphElement representing an equation.
        # Corresponds to the JSON property `equation`
        # @return [Google::Apis::DocsV1::Equation]
        attr_accessor :equation
      
        # A ParagraphElement representing a footnote reference. A footnote reference is
        # the inline content rendered with a number and is used to identify the footnote.
        # Corresponds to the JSON property `footnoteReference`
        # @return [Google::Apis::DocsV1::FootnoteReference]
        attr_accessor :footnote_reference
      
        # A ParagraphElement representing a horizontal line.
        # Corresponds to the JSON property `horizontalRule`
        # @return [Google::Apis::DocsV1::HorizontalRule]
        attr_accessor :horizontal_rule
      
        # A ParagraphElement that contains an InlineObject.
        # Corresponds to the JSON property `inlineObjectElement`
        # @return [Google::Apis::DocsV1::InlineObjectElement]
        attr_accessor :inline_object_element
      
        # A ParagraphElement representing a page break. A page break makes the
        # subsequent text start at the top of the next page.
        # Corresponds to the JSON property `pageBreak`
        # @return [Google::Apis::DocsV1::PageBreak]
        attr_accessor :page_break
      
        # A person or email address mentioned in a document. These mentions behave as a
        # single, immutable element containing the person's name or email address.
        # Corresponds to the JSON property `person`
        # @return [Google::Apis::DocsV1::Person]
        attr_accessor :person
      
        # A link to a Google resource (such as a file in Drive, a YouTube video, or a
        # Calendar event).
        # Corresponds to the JSON property `richLink`
        # @return [Google::Apis::DocsV1::RichLink]
        attr_accessor :rich_link
      
        # The zero-based start index of this paragraph element, in UTF-16 code units.
        # Corresponds to the JSON property `startIndex`
        # @return [Fixnum]
        attr_accessor :start_index
      
        # A ParagraphElement that represents a run of text that all has the same styling.
        # Corresponds to the JSON property `textRun`
        # @return [Google::Apis::DocsV1::TextRun]
        attr_accessor :text_run
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @auto_text = args[:auto_text] if args.key?(:auto_text)
          @column_break = args[:column_break] if args.key?(:column_break)
          @end_index = args[:end_index] if args.key?(:end_index)
          @equation = args[:equation] if args.key?(:equation)
          @footnote_reference = args[:footnote_reference] if args.key?(:footnote_reference)
          @horizontal_rule = args[:horizontal_rule] if args.key?(:horizontal_rule)
          @inline_object_element = args[:inline_object_element] if args.key?(:inline_object_element)
          @page_break = args[:page_break] if args.key?(:page_break)
          @person = args[:person] if args.key?(:person)
          @rich_link = args[:rich_link] if args.key?(:rich_link)
          @start_index = args[:start_index] if args.key?(:start_index)
          @text_run = args[:text_run] if args.key?(:text_run)
        end
      end
      
      # Styles that apply to a whole paragraph. Inherited paragraph styles are
      # represented as unset fields in this message. A paragraph style's parent
      # depends on where the paragraph style is defined: * The ParagraphStyle on a
      # Paragraph inherits from the paragraph's corresponding named style type. * The
      # ParagraphStyle on a named style inherits from the normal text named style. *
      # The ParagraphStyle of the normal text named style inherits from the default
      # paragraph style in the Docs editor. * The ParagraphStyle on a Paragraph
      # element that's contained in a table may inherit its paragraph style from the
      # table style. If the paragraph style does not inherit from a parent, unsetting
      # fields will revert the style to a value matching the defaults in the Docs
      # editor.
      class ParagraphStyle
        include Google::Apis::Core::Hashable
      
        # The text alignment for this paragraph.
        # Corresponds to the JSON property `alignment`
        # @return [String]
        attr_accessor :alignment
      
        # Whether to avoid widows and orphans for the paragraph. If unset, the value is
        # inherited from the parent.
        # Corresponds to the JSON property `avoidWidowAndOrphan`
        # @return [Boolean]
        attr_accessor :avoid_widow_and_orphan
        alias_method :avoid_widow_and_orphan?, :avoid_widow_and_orphan
      
        # A border around a paragraph.
        # Corresponds to the JSON property `borderBetween`
        # @return [Google::Apis::DocsV1::ParagraphBorder]
        attr_accessor :border_between
      
        # A border around a paragraph.
        # Corresponds to the JSON property `borderBottom`
        # @return [Google::Apis::DocsV1::ParagraphBorder]
        attr_accessor :border_bottom
      
        # A border around a paragraph.
        # Corresponds to the JSON property `borderLeft`
        # @return [Google::Apis::DocsV1::ParagraphBorder]
        attr_accessor :border_left
      
        # A border around a paragraph.
        # Corresponds to the JSON property `borderRight`
        # @return [Google::Apis::DocsV1::ParagraphBorder]
        attr_accessor :border_right
      
        # A border around a paragraph.
        # Corresponds to the JSON property `borderTop`
        # @return [Google::Apis::DocsV1::ParagraphBorder]
        attr_accessor :border_top
      
        # The text direction of this paragraph. If unset, the value defaults to
        # LEFT_TO_RIGHT since paragraph direction is not inherited.
        # Corresponds to the JSON property `direction`
        # @return [String]
        attr_accessor :direction
      
        # The heading ID of the paragraph. If empty, then this paragraph is not a
        # heading. This property is read-only.
        # Corresponds to the JSON property `headingId`
        # @return [String]
        attr_accessor :heading_id
      
        # A magnitude in a single direction in the specified units.
        # Corresponds to the JSON property `indentEnd`
        # @return [Google::Apis::DocsV1::Dimension]
        attr_accessor :indent_end
      
        # A magnitude in a single direction in the specified units.
        # Corresponds to the JSON property `indentFirstLine`
        # @return [Google::Apis::DocsV1::Dimension]
        attr_accessor :indent_first_line
      
        # A magnitude in a single direction in the specified units.
        # Corresponds to the JSON property `indentStart`
        # @return [Google::Apis::DocsV1::Dimension]
        attr_accessor :indent_start
      
        # Whether all lines of the paragraph should be laid out on the same page or
        # column if possible. If unset, the value is inherited from the parent.
        # Corresponds to the JSON property `keepLinesTogether`
        # @return [Boolean]
        attr_accessor :keep_lines_together
        alias_method :keep_lines_together?, :keep_lines_together
      
        # Whether at least a part of this paragraph should be laid out on the same page
        # or column as the next paragraph if possible. If unset, the value is inherited
        # from the parent.
        # Corresponds to the JSON property `keepWithNext`
        # @return [Boolean]
        attr_accessor :keep_with_next
        alias_method :keep_with_next?, :keep_with_next
      
        # The amount of space between lines, as a percentage of normal, where normal is
        # represented as 100.0. If unset, the value is inherited from the parent.
        # Corresponds to the JSON property `lineSpacing`
        # @return [Float]
        attr_accessor :line_spacing
      
        # The named style type of the paragraph. Since updating the named style type
        # affects other properties within ParagraphStyle, the named style type is
        # applied before the other properties are updated.
        # Corresponds to the JSON property `namedStyleType`
        # @return [String]
        attr_accessor :named_style_type
      
        # Whether the current paragraph should always start at the beginning of a page.
        # If unset, the value is inherited from the parent. Attempting to update
        # page_break_before for paragraphs in unsupported regions, including Table,
        # Header, Footer and Footnote, can result in an invalid document state that
        # returns a 400 bad request error.
        # Corresponds to the JSON property `pageBreakBefore`
        # @return [Boolean]
        attr_accessor :page_break_before
        alias_method :page_break_before?, :page_break_before
      
        # The shading of a paragraph.
        # Corresponds to the JSON property `shading`
        # @return [Google::Apis::DocsV1::Shading]
        attr_accessor :shading
      
        # A magnitude in a single direction in the specified units.
        # Corresponds to the JSON property `spaceAbove`
        # @return [Google::Apis::DocsV1::Dimension]
        attr_accessor :space_above
      
        # A magnitude in a single direction in the specified units.
        # Corresponds to the JSON property `spaceBelow`
        # @return [Google::Apis::DocsV1::Dimension]
        attr_accessor :space_below
      
        # The spacing mode for the paragraph.
        # Corresponds to the JSON property `spacingMode`
        # @return [String]
        attr_accessor :spacing_mode
      
        # A list of the tab stops for this paragraph. The list of tab stops is not
        # inherited. This property is read-only.
        # Corresponds to the JSON property `tabStops`
        # @return [Array<Google::Apis::DocsV1::TabStop>]
        attr_accessor :tab_stops
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @alignment = args[:alignment] if args.key?(:alignment)
          @avoid_widow_and_orphan = args[:avoid_widow_and_orphan] if args.key?(:avoid_widow_and_orphan)
          @border_between = args[:border_between] if args.key?(:border_between)
          @border_bottom = args[:border_bottom] if args.key?(:border_bottom)
          @border_left = args[:border_left] if args.key?(:border_left)
          @border_right = args[:border_right] if args.key?(:border_right)
          @border_top = args[:border_top] if args.key?(:border_top)
          @direction = args[:direction] if args.key?(:direction)
          @heading_id = args[:heading_id] if args.key?(:heading_id)
          @indent_end = args[:indent_end] if args.key?(:indent_end)
          @indent_first_line = args[:indent_first_line] if args.key?(:indent_first_line)
          @indent_start = args[:indent_start] if args.key?(:indent_start)
          @keep_lines_together = args[:keep_lines_together] if args.key?(:keep_lines_together)
          @keep_with_next = args[:keep_with_next] if args.key?(:keep_with_next)
          @line_spacing = args[:line_spacing] if args.key?(:line_spacing)
          @named_style_type = args[:named_style_type] if args.key?(:named_style_type)
          @page_break_before = args[:page_break_before] if args.key?(:page_break_before)
          @shading = args[:shading] if args.key?(:shading)
          @space_above = args[:space_above] if args.key?(:space_above)
          @space_below = args[:space_below] if args.key?(:space_below)
          @spacing_mode = args[:spacing_mode] if args.key?(:spacing_mode)
          @tab_stops = args[:tab_stops] if args.key?(:tab_stops)
        end
      end
      
      # A mask that indicates which of the fields on the base ParagraphStyle have been
      # changed in this suggestion. For any field set to true, there's a new suggested
      # value.
      class ParagraphStyleSuggestionState
        include Google::Apis::Core::Hashable
      
        # Indicates if there was a suggested change to alignment.
        # Corresponds to the JSON property `alignmentSuggested`
        # @return [Boolean]
        attr_accessor :alignment_suggested
        alias_method :alignment_suggested?, :alignment_suggested
      
        # Indicates if there was a suggested change to avoid_widow_and_orphan.
        # Corresponds to the JSON property `avoidWidowAndOrphanSuggested`
        # @return [Boolean]
        attr_accessor :avoid_widow_and_orphan_suggested
        alias_method :avoid_widow_and_orphan_suggested?, :avoid_widow_and_orphan_suggested
      
        # Indicates if there was a suggested change to border_between.
        # Corresponds to the JSON property `borderBetweenSuggested`
        # @return [Boolean]
        attr_accessor :border_between_suggested
        alias_method :border_between_suggested?, :border_between_suggested
      
        # Indicates if there was a suggested change to border_bottom.
        # Corresponds to the JSON property `borderBottomSuggested`
        # @return [Boolean]
        attr_accessor :border_bottom_suggested
        alias_method :border_bottom_suggested?, :border_bottom_suggested
      
        # Indicates if there was a suggested change to border_left.
        # Corresponds to the JSON property `borderLeftSuggested`
        # @return [Boolean]
        attr_accessor :border_left_suggested
        alias_method :border_left_suggested?, :border_left_suggested
      
        # Indicates if there was a suggested change to border_right.
        # Corresponds to the JSON property `borderRightSuggested`
        # @return [Boolean]
        attr_accessor :border_right_suggested
        alias_method :border_right_suggested?, :border_right_suggested
      
        # Indicates if there was a suggested change to border_top.
        # Corresponds to the JSON property `borderTopSuggested`
        # @return [Boolean]
        attr_accessor :border_top_suggested
        alias_method :border_top_suggested?, :border_top_suggested
      
        # Indicates if there was a suggested change to direction.
        # Corresponds to the JSON property `directionSuggested`
        # @return [Boolean]
        attr_accessor :direction_suggested
        alias_method :direction_suggested?, :direction_suggested
      
        # Indicates if there was a suggested change to heading_id.
        # Corresponds to the JSON property `headingIdSuggested`
        # @return [Boolean]
        attr_accessor :heading_id_suggested
        alias_method :heading_id_suggested?, :heading_id_suggested
      
        # Indicates if there was a suggested change to indent_end.
        # Corresponds to the JSON property `indentEndSuggested`
        # @return [Boolean]
        attr_accessor :indent_end_suggested
        alias_method :indent_end_suggested?, :indent_end_suggested
      
        # Indicates if there was a suggested change to indent_first_line.
        # Corresponds to the JSON property `indentFirstLineSuggested`
        # @return [Boolean]
        attr_accessor :indent_first_line_suggested
        alias_method :indent_first_line_suggested?, :indent_first_line_suggested
      
        # Indicates if there was a suggested change to indent_start.
        # Corresponds to the JSON property `indentStartSuggested`
        # @return [Boolean]
        attr_accessor :indent_start_suggested
        alias_method :indent_start_suggested?, :indent_start_suggested
      
        # Indicates if there was a suggested change to keep_lines_together.
        # Corresponds to the JSON property `keepLinesTogetherSuggested`
        # @return [Boolean]
        attr_accessor :keep_lines_together_suggested
        alias_method :keep_lines_together_suggested?, :keep_lines_together_suggested
      
        # Indicates if there was a suggested change to keep_with_next.
        # Corresponds to the JSON property `keepWithNextSuggested`
        # @return [Boolean]
        attr_accessor :keep_with_next_suggested
        alias_method :keep_with_next_suggested?, :keep_with_next_suggested
      
        # Indicates if there was a suggested change to line_spacing.
        # Corresponds to the JSON property `lineSpacingSuggested`
        # @return [Boolean]
        attr_accessor :line_spacing_suggested
        alias_method :line_spacing_suggested?, :line_spacing_suggested
      
        # Indicates if there was a suggested change to named_style_type.
        # Corresponds to the JSON property `namedStyleTypeSuggested`
        # @return [Boolean]
        attr_accessor :named_style_type_suggested
        alias_method :named_style_type_suggested?, :named_style_type_suggested
      
        # Indicates if there was a suggested change to page_break_before.
        # Corresponds to the JSON property `pageBreakBeforeSuggested`
        # @return [Boolean]
        attr_accessor :page_break_before_suggested
        alias_method :page_break_before_suggested?, :page_break_before_suggested
      
        # A mask that indicates which of the fields on the base Shading have been
        # changed in this suggested change. For any field set to true, there's a new
        # suggested value.
        # Corresponds to the JSON property `shadingSuggestionState`
        # @return [Google::Apis::DocsV1::ShadingSuggestionState]
        attr_accessor :shading_suggestion_state
      
        # Indicates if there was a suggested change to space_above.
        # Corresponds to the JSON property `spaceAboveSuggested`
        # @return [Boolean]
        attr_accessor :space_above_suggested
        alias_method :space_above_suggested?, :space_above_suggested
      
        # Indicates if there was a suggested change to space_below.
        # Corresponds to the JSON property `spaceBelowSuggested`
        # @return [Boolean]
        attr_accessor :space_below_suggested
        alias_method :space_below_suggested?, :space_below_suggested
      
        # Indicates if there was a suggested change to spacing_mode.
        # Corresponds to the JSON property `spacingModeSuggested`
        # @return [Boolean]
        attr_accessor :spacing_mode_suggested
        alias_method :spacing_mode_suggested?, :spacing_mode_suggested
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @alignment_suggested = args[:alignment_suggested] if args.key?(:alignment_suggested)
          @avoid_widow_and_orphan_suggested = args[:avoid_widow_and_orphan_suggested] if args.key?(:avoid_widow_and_orphan_suggested)
          @border_between_suggested = args[:border_between_suggested] if args.key?(:border_between_suggested)
          @border_bottom_suggested = args[:border_bottom_suggested] if args.key?(:border_bottom_suggested)
          @border_left_suggested = args[:border_left_suggested] if args.key?(:border_left_suggested)
          @border_right_suggested = args[:border_right_suggested] if args.key?(:border_right_suggested)
          @border_top_suggested = args[:border_top_suggested] if args.key?(:border_top_suggested)
          @direction_suggested = args[:direction_suggested] if args.key?(:direction_suggested)
          @heading_id_suggested = args[:heading_id_suggested] if args.key?(:heading_id_suggested)
          @indent_end_suggested = args[:indent_end_suggested] if args.key?(:indent_end_suggested)
          @indent_first_line_suggested = args[:indent_first_line_suggested] if args.key?(:indent_first_line_suggested)
          @indent_start_suggested = args[:indent_start_suggested] if args.key?(:indent_start_suggested)
          @keep_lines_together_suggested = args[:keep_lines_together_suggested] if args.key?(:keep_lines_together_suggested)
          @keep_with_next_suggested = args[:keep_with_next_suggested] if args.key?(:keep_with_next_suggested)
          @line_spacing_suggested = args[:line_spacing_suggested] if args.key?(:line_spacing_suggested)
          @named_style_type_suggested = args[:named_style_type_suggested] if args.key?(:named_style_type_suggested)
          @page_break_before_suggested = args[:page_break_before_suggested] if args.key?(:page_break_before_suggested)
          @shading_suggestion_state = args[:shading_suggestion_state] if args.key?(:shading_suggestion_state)
          @space_above_suggested = args[:space_above_suggested] if args.key?(:space_above_suggested)
          @space_below_suggested = args[:space_below_suggested] if args.key?(:space_below_suggested)
          @spacing_mode_suggested = args[:spacing_mode_suggested] if args.key?(:spacing_mode_suggested)
        end
      end
      
      # A person or email address mentioned in a document. These mentions behave as a
      # single, immutable element containing the person's name or email address.
      class Person
        include Google::Apis::Core::Hashable
      
        # Output only. The unique ID of this link.
        # Corresponds to the JSON property `personId`
        # @return [String]
        attr_accessor :person_id
      
        # Properties specific to a linked Person.
        # Corresponds to the JSON property `personProperties`
        # @return [Google::Apis::DocsV1::PersonProperties]
        attr_accessor :person_properties
      
        # IDs for suggestions that remove this person link from the document. A Person
        # might have multiple deletion IDs if, for example, multiple users suggest
        # deleting it. If empty, then this person link isn't suggested for deletion.
        # Corresponds to the JSON property `suggestedDeletionIds`
        # @return [Array<String>]
        attr_accessor :suggested_deletion_ids
      
        # IDs for suggestions that insert this person link into the document. A Person
        # might have multiple insertion IDs if it's a nested suggested change (a
        # suggestion within a suggestion made by a different user, for example). If
        # empty, then this person link isn't a suggested insertion.
        # Corresponds to the JSON property `suggestedInsertionIds`
        # @return [Array<String>]
        attr_accessor :suggested_insertion_ids
      
        # The suggested text style changes to this Person, keyed by suggestion ID.
        # Corresponds to the JSON property `suggestedTextStyleChanges`
        # @return [Hash<String,Google::Apis::DocsV1::SuggestedTextStyle>]
        attr_accessor :suggested_text_style_changes
      
        # Represents the styling that can be applied to text. Inherited text styles are
        # represented as unset fields in this message. A text style's parent depends on
        # where the text style is defined: * The TextStyle of text in a Paragraph
        # inherits from the paragraph's corresponding named style type. * The TextStyle
        # on a named style inherits from the normal text named style. * The TextStyle of
        # the normal text named style inherits from the default text style in the Docs
        # editor. * The TextStyle on a Paragraph element that's contained in a table may
        # inherit its text style from the table style. If the text style does not
        # inherit from a parent, unsetting fields will revert the style to a value
        # matching the defaults in the Docs editor.
        # Corresponds to the JSON property `textStyle`
        # @return [Google::Apis::DocsV1::TextStyle]
        attr_accessor :text_style
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @person_id = args[:person_id] if args.key?(:person_id)
          @person_properties = args[:person_properties] if args.key?(:person_properties)
          @suggested_deletion_ids = args[:suggested_deletion_ids] if args.key?(:suggested_deletion_ids)
          @suggested_insertion_ids = args[:suggested_insertion_ids] if args.key?(:suggested_insertion_ids)
          @suggested_text_style_changes = args[:suggested_text_style_changes] if args.key?(:suggested_text_style_changes)
          @text_style = args[:text_style] if args.key?(:text_style)
        end
      end
      
      # Properties specific to a linked Person.
      class PersonProperties
        include Google::Apis::Core::Hashable
      
        # The email address linked to this Person. This field is always present.
        # Corresponds to the JSON property `email`
        # @return [String]
        attr_accessor :email
      
        # The name of the person if it's displayed in the link text instead of the
        # person's email address.
        # Corresponds to the JSON property `name`
        # @return [String]
        attr_accessor :name
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @email = args[:email] if args.key?(:email)
          @name = args[:name] if args.key?(:name)
        end
      end
      
      # Updates the number of pinned table header rows in a table.
      class PinTableHeaderRowsRequest
        include Google::Apis::Core::Hashable
      
        # The number of table rows to pin, where 0 implies that all rows are unpinned.
        # Corresponds to the JSON property `pinnedHeaderRowsCount`
        # @return [Fixnum]
        attr_accessor :pinned_header_rows_count
      
        # A particular location in the document.
        # Corresponds to the JSON property `tableStartLocation`
        # @return [Google::Apis::DocsV1::Location]
        attr_accessor :table_start_location
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @pinned_header_rows_count = args[:pinned_header_rows_count] if args.key?(:pinned_header_rows_count)
          @table_start_location = args[:table_start_location] if args.key?(:table_start_location)
        end
      end
      
      # An object that's tethered to a Paragraph and positioned relative to the
      # beginning of the paragraph. A PositionedObject contains an EmbeddedObject such
      # as an image.
      class PositionedObject
        include Google::Apis::Core::Hashable
      
        # The ID of this positioned object.
        # Corresponds to the JSON property `objectId`
        # @return [String]
        attr_accessor :object_id_prop
      
        # Properties of a PositionedObject.
        # Corresponds to the JSON property `positionedObjectProperties`
        # @return [Google::Apis::DocsV1::PositionedObjectProperties]
        attr_accessor :positioned_object_properties
      
        # The suggested deletion IDs. If empty, then there are no suggested deletions of
        # this content.
        # Corresponds to the JSON property `suggestedDeletionIds`
        # @return [Array<String>]
        attr_accessor :suggested_deletion_ids
      
        # The suggested insertion ID. If empty, then this is not a suggested insertion.
        # Corresponds to the JSON property `suggestedInsertionId`
        # @return [String]
        attr_accessor :suggested_insertion_id
      
        # The suggested changes to the positioned object properties, keyed by suggestion
        # ID.
        # Corresponds to the JSON property `suggestedPositionedObjectPropertiesChanges`
        # @return [Hash<String,Google::Apis::DocsV1::SuggestedPositionedObjectProperties>]
        attr_accessor :suggested_positioned_object_properties_changes
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @object_id_prop = args[:object_id_prop] if args.key?(:object_id_prop)
          @positioned_object_properties = args[:positioned_object_properties] if args.key?(:positioned_object_properties)
          @suggested_deletion_ids = args[:suggested_deletion_ids] if args.key?(:suggested_deletion_ids)
          @suggested_insertion_id = args[:suggested_insertion_id] if args.key?(:suggested_insertion_id)
          @suggested_positioned_object_properties_changes = args[:suggested_positioned_object_properties_changes] if args.key?(:suggested_positioned_object_properties_changes)
        end
      end
      
      # The positioning of a PositionedObject. The positioned object is positioned
      # relative to the beginning of the Paragraph it's tethered to.
      class PositionedObjectPositioning
        include Google::Apis::Core::Hashable
      
        # The layout of this positioned object.
        # Corresponds to the JSON property `layout`
        # @return [String]
        attr_accessor :layout
      
        # A magnitude in a single direction in the specified units.
        # Corresponds to the JSON property `leftOffset`
        # @return [Google::Apis::DocsV1::Dimension]
        attr_accessor :left_offset
      
        # A magnitude in a single direction in the specified units.
        # Corresponds to the JSON property `topOffset`
        # @return [Google::Apis::DocsV1::Dimension]
        attr_accessor :top_offset
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @layout = args[:layout] if args.key?(:layout)
          @left_offset = args[:left_offset] if args.key?(:left_offset)
          @top_offset = args[:top_offset] if args.key?(:top_offset)
        end
      end
      
      # A mask that indicates which of the fields on the base
      # PositionedObjectPositioning have been changed in this suggestion. For any
      # field set to true, there's a new suggested value.
      class PositionedObjectPositioningSuggestionState
        include Google::Apis::Core::Hashable
      
        # Indicates if there was a suggested change to layout.
        # Corresponds to the JSON property `layoutSuggested`
        # @return [Boolean]
        attr_accessor :layout_suggested
        alias_method :layout_suggested?, :layout_suggested
      
        # Indicates if there was a suggested change to left_offset.
        # Corresponds to the JSON property `leftOffsetSuggested`
        # @return [Boolean]
        attr_accessor :left_offset_suggested
        alias_method :left_offset_suggested?, :left_offset_suggested
      
        # Indicates if there was a suggested change to top_offset.
        # Corresponds to the JSON property `topOffsetSuggested`
        # @return [Boolean]
        attr_accessor :top_offset_suggested
        alias_method :top_offset_suggested?, :top_offset_suggested
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @layout_suggested = args[:layout_suggested] if args.key?(:layout_suggested)
          @left_offset_suggested = args[:left_offset_suggested] if args.key?(:left_offset_suggested)
          @top_offset_suggested = args[:top_offset_suggested] if args.key?(:top_offset_suggested)
        end
      end
      
      # Properties of a PositionedObject.
      class PositionedObjectProperties
        include Google::Apis::Core::Hashable
      
        # An embedded object in the document.
        # Corresponds to the JSON property `embeddedObject`
        # @return [Google::Apis::DocsV1::EmbeddedObject]
        attr_accessor :embedded_object
      
        # The positioning of a PositionedObject. The positioned object is positioned
        # relative to the beginning of the Paragraph it's tethered to.
        # Corresponds to the JSON property `positioning`
        # @return [Google::Apis::DocsV1::PositionedObjectPositioning]
        attr_accessor :positioning
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @embedded_object = args[:embedded_object] if args.key?(:embedded_object)
          @positioning = args[:positioning] if args.key?(:positioning)
        end
      end
      
      # A mask that indicates which of the fields on the base
      # PositionedObjectProperties have been changed in this suggestion. For any field
      # set to true, there's a new suggested value.
      class PositionedObjectPropertiesSuggestionState
        include Google::Apis::Core::Hashable
      
        # A mask that indicates which of the fields on the base EmbeddedObject have been
        # changed in this suggestion. For any field set to true, there's a new suggested
        # value.
        # Corresponds to the JSON property `embeddedObjectSuggestionState`
        # @return [Google::Apis::DocsV1::EmbeddedObjectSuggestionState]
        attr_accessor :embedded_object_suggestion_state
      
        # A mask that indicates which of the fields on the base
        # PositionedObjectPositioning have been changed in this suggestion. For any
        # field set to true, there's a new suggested value.
        # Corresponds to the JSON property `positioningSuggestionState`
        # @return [Google::Apis::DocsV1::PositionedObjectPositioningSuggestionState]
        attr_accessor :positioning_suggestion_state
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @embedded_object_suggestion_state = args[:embedded_object_suggestion_state] if args.key?(:embedded_object_suggestion_state)
          @positioning_suggestion_state = args[:positioning_suggestion_state] if args.key?(:positioning_suggestion_state)
        end
      end
      
      # Specifies a contiguous range of text.
      class Range
        include Google::Apis::Core::Hashable
      
        # The zero-based end index of this range, exclusive, in UTF-16 code units. In
        # all current uses, an end index must be provided. This field is an Int32Value
        # in order to accommodate future use cases with open-ended ranges.
        # Corresponds to the JSON property `endIndex`
        # @return [Fixnum]
        attr_accessor :end_index
      
        # The ID of the header, footer, or footnote that this range is contained in. An
        # empty segment ID signifies the document's body.
        # Corresponds to the JSON property `segmentId`
        # @return [String]
        attr_accessor :segment_id
      
        # The zero-based start index of this range, in UTF-16 code units. In all current
        # uses, a start index must be provided. This field is an Int32Value in order to
        # accommodate future use cases with open-ended ranges.
        # Corresponds to the JSON property `startIndex`
        # @return [Fixnum]
        attr_accessor :start_index
      
        # The tab that contains this range. When omitted, the request applies to the
        # first tab. In a document containing a single tab: - If provided, must match
        # the singular tab's ID. - If omitted, the request applies to the singular tab.
        # In a document containing multiple tabs: - If provided, the request applies to
        # the specified tab. - If omitted, the request applies to the first tab in the
        # document.
        # Corresponds to the JSON property `tabId`
        # @return [String]
        attr_accessor :tab_id
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @end_index = args[:end_index] if args.key?(:end_index)
          @segment_id = args[:segment_id] if args.key?(:segment_id)
          @start_index = args[:start_index] if args.key?(:start_index)
          @tab_id = args[:tab_id] if args.key?(:tab_id)
        end
      end
      
      # Replaces all instances of text matching a criteria with replace text.
      class ReplaceAllTextRequest
        include Google::Apis::Core::Hashable
      
        # A criteria that matches a specific string of text in the document.
        # Corresponds to the JSON property `containsText`
        # @return [Google::Apis::DocsV1::SubstringMatchCriteria]
        attr_accessor :contains_text
      
        # The text that will replace the matched text.
        # Corresponds to the JSON property `replaceText`
        # @return [String]
        attr_accessor :replace_text
      
        # A criteria that specifies in which tabs a request executes.
        # Corresponds to the JSON property `tabsCriteria`
        # @return [Google::Apis::DocsV1::TabsCriteria]
        attr_accessor :tabs_criteria
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @contains_text = args[:contains_text] if args.key?(:contains_text)
          @replace_text = args[:replace_text] if args.key?(:replace_text)
          @tabs_criteria = args[:tabs_criteria] if args.key?(:tabs_criteria)
        end
      end
      
      # The result of replacing text.
      class ReplaceAllTextResponse
        include Google::Apis::Core::Hashable
      
        # The number of occurrences changed by replacing all text.
        # Corresponds to the JSON property `occurrencesChanged`
        # @return [Fixnum]
        attr_accessor :occurrences_changed
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @occurrences_changed = args[:occurrences_changed] if args.key?(:occurrences_changed)
        end
      end
      
      # Replaces an existing image with a new image. Replacing an image removes some
      # image effects from the existing image in order to mirror the behavior of the
      # Docs editor.
      class ReplaceImageRequest
        include Google::Apis::Core::Hashable
      
        # The ID of the existing image that will be replaced. The ID can be retrieved
        # from the response of a get request.
        # Corresponds to the JSON property `imageObjectId`
        # @return [String]
        attr_accessor :image_object_id
      
        # The replacement method.
        # Corresponds to the JSON property `imageReplaceMethod`
        # @return [String]
        attr_accessor :image_replace_method
      
        # The tab that the image to be replaced is in. When omitted, the request is
        # applied to the first tab. In a document containing a single tab: - If provided,
        # must match the singular tab's ID. - If omitted, the request applies to the
        # singular tab. In a document containing multiple tabs: - If provided, the
        # request applies to the specified tab. - If omitted, the request applies to the
        # first tab in the document.
        # Corresponds to the JSON property `tabId`
        # @return [String]
        attr_accessor :tab_id
      
        # The URI of the new image. The image is fetched once at insertion time and a
        # copy is stored for display inside the document. Images must be less than 50MB,
        # cannot exceed 25 megapixels, and must be in PNG, JPEG, or GIF format. The
        # provided URI can't surpass 2 KB in length. The URI is saved with the image,
        # and exposed through the ImageProperties.source_uri field.
        # Corresponds to the JSON property `uri`
        # @return [String]
        attr_accessor :uri
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @image_object_id = args[:image_object_id] if args.key?(:image_object_id)
          @image_replace_method = args[:image_replace_method] if args.key?(:image_replace_method)
          @tab_id = args[:tab_id] if args.key?(:tab_id)
          @uri = args[:uri] if args.key?(:uri)
        end
      end
      
      # Replaces the contents of the specified NamedRange or NamedRanges with the
      # given replacement content. Note that an individual NamedRange may consist of
      # multiple discontinuous ranges. In this case, only the content in the first
      # range will be replaced. The other ranges and their content will be deleted. In
      # cases where replacing or deleting any ranges would result in an invalid
      # document structure, a 400 bad request error is returned.
      class ReplaceNamedRangeContentRequest
        include Google::Apis::Core::Hashable
      
        # The ID of the named range whose content will be replaced. If there is no named
        # range with the given ID a 400 bad request error is returned.
        # Corresponds to the JSON property `namedRangeId`
        # @return [String]
        attr_accessor :named_range_id
      
        # The name of the NamedRanges whose content will be replaced. If there are
        # multiple named ranges with the given name, then the content of each one will
        # be replaced. If there are no named ranges with the given name, then the
        # request will be a no-op.
        # Corresponds to the JSON property `namedRangeName`
        # @return [String]
        attr_accessor :named_range_name
      
        # A criteria that specifies in which tabs a request executes.
        # Corresponds to the JSON property `tabsCriteria`
        # @return [Google::Apis::DocsV1::TabsCriteria]
        attr_accessor :tabs_criteria
      
        # Replaces the content of the specified named range(s) with the given text.
        # Corresponds to the JSON property `text`
        # @return [String]
        attr_accessor :text
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @named_range_id = args[:named_range_id] if args.key?(:named_range_id)
          @named_range_name = args[:named_range_name] if args.key?(:named_range_name)
          @tabs_criteria = args[:tabs_criteria] if args.key?(:tabs_criteria)
          @text = args[:text] if args.key?(:text)
        end
      end
      
      # A single update to apply to a document.
      class Request
        include Google::Apis::Core::Hashable
      
        # Creates a Footer. The new footer is applied to the SectionStyle at the
        # location of the SectionBreak if specified, otherwise it is applied to the
        # DocumentStyle. If a footer of the specified type already exists, a 400 bad
        # request error is returned.
        # Corresponds to the JSON property `createFooter`
        # @return [Google::Apis::DocsV1::CreateFooterRequest]
        attr_accessor :create_footer
      
        # Creates a Footnote segment and inserts a new FootnoteReference to it at the
        # given location. The new Footnote segment will contain a space followed by a
        # newline character.
        # Corresponds to the JSON property `createFootnote`
        # @return [Google::Apis::DocsV1::CreateFootnoteRequest]
        attr_accessor :create_footnote
      
        # Creates a Header. The new header is applied to the SectionStyle at the
        # location of the SectionBreak if specified, otherwise it is applied to the
        # DocumentStyle. If a header of the specified type already exists, a 400 bad
        # request error is returned.
        # Corresponds to the JSON property `createHeader`
        # @return [Google::Apis::DocsV1::CreateHeaderRequest]
        attr_accessor :create_header
      
        # Creates a NamedRange referencing the given range.
        # Corresponds to the JSON property `createNamedRange`
        # @return [Google::Apis::DocsV1::CreateNamedRangeRequest]
        attr_accessor :create_named_range
      
        # Creates bullets for all of the paragraphs that overlap with the given range.
        # The nesting level of each paragraph will be determined by counting leading
        # tabs in front of each paragraph. To avoid excess space between the bullet and
        # the corresponding paragraph, these leading tabs are removed by this request.
        # This may change the indices of parts of the text. If the paragraph immediately
        # before paragraphs being updated is in a list with a matching preset, the
        # paragraphs being updated are added to that preceding list.
        # Corresponds to the JSON property `createParagraphBullets`
        # @return [Google::Apis::DocsV1::CreateParagraphBulletsRequest]
        attr_accessor :create_paragraph_bullets
      
        # Deletes content from the document.
        # Corresponds to the JSON property `deleteContentRange`
        # @return [Google::Apis::DocsV1::DeleteContentRangeRequest]
        attr_accessor :delete_content_range
      
        # Deletes a Footer from the document.
        # Corresponds to the JSON property `deleteFooter`
        # @return [Google::Apis::DocsV1::DeleteFooterRequest]
        attr_accessor :delete_footer
      
        # Deletes a Header from the document.
        # Corresponds to the JSON property `deleteHeader`
        # @return [Google::Apis::DocsV1::DeleteHeaderRequest]
        attr_accessor :delete_header
      
        # Deletes a NamedRange.
        # Corresponds to the JSON property `deleteNamedRange`
        # @return [Google::Apis::DocsV1::DeleteNamedRangeRequest]
        attr_accessor :delete_named_range
      
        # Deletes bullets from all of the paragraphs that overlap with the given range.
        # The nesting level of each paragraph will be visually preserved by adding
        # indent to the start of the corresponding paragraph.
        # Corresponds to the JSON property `deleteParagraphBullets`
        # @return [Google::Apis::DocsV1::DeleteParagraphBulletsRequest]
        attr_accessor :delete_paragraph_bullets
      
        # Deletes a PositionedObject from the document.
        # Corresponds to the JSON property `deletePositionedObject`
        # @return [Google::Apis::DocsV1::DeletePositionedObjectRequest]
        attr_accessor :delete_positioned_object
      
        # Deletes a column from a table.
        # Corresponds to the JSON property `deleteTableColumn`
        # @return [Google::Apis::DocsV1::DeleteTableColumnRequest]
        attr_accessor :delete_table_column
      
        # Deletes a row from a table.
        # Corresponds to the JSON property `deleteTableRow`
        # @return [Google::Apis::DocsV1::DeleteTableRowRequest]
        attr_accessor :delete_table_row
      
        # Inserts an InlineObject containing an image at the given location.
        # Corresponds to the JSON property `insertInlineImage`
        # @return [Google::Apis::DocsV1::InsertInlineImageRequest]
        attr_accessor :insert_inline_image
      
        # Inserts a page break followed by a newline at the specified location.
        # Corresponds to the JSON property `insertPageBreak`
        # @return [Google::Apis::DocsV1::InsertPageBreakRequest]
        attr_accessor :insert_page_break
      
        # Inserts a person mention.
        # Corresponds to the JSON property `insertPerson`
        # @return [Google::Apis::DocsV1::InsertPersonRequest]
        attr_accessor :insert_person
      
        # Inserts a section break at the given location. A newline character will be
        # inserted before the section break.
        # Corresponds to the JSON property `insertSectionBreak`
        # @return [Google::Apis::DocsV1::InsertSectionBreakRequest]
        attr_accessor :insert_section_break
      
        # Inserts a table at the specified location. A newline character will be
        # inserted before the inserted table.
        # Corresponds to the JSON property `insertTable`
        # @return [Google::Apis::DocsV1::InsertTableRequest]
        attr_accessor :insert_table
      
        # Inserts an empty column into a table.
        # Corresponds to the JSON property `insertTableColumn`
        # @return [Google::Apis::DocsV1::InsertTableColumnRequest]
        attr_accessor :insert_table_column
      
        # Inserts an empty row into a table.
        # Corresponds to the JSON property `insertTableRow`
        # @return [Google::Apis::DocsV1::InsertTableRowRequest]
        attr_accessor :insert_table_row
      
        # Inserts text at the specified location.
        # Corresponds to the JSON property `insertText`
        # @return [Google::Apis::DocsV1::InsertTextRequest]
        attr_accessor :insert_text
      
        # Merges cells in a Table.
        # Corresponds to the JSON property `mergeTableCells`
        # @return [Google::Apis::DocsV1::MergeTableCellsRequest]
        attr_accessor :merge_table_cells
      
        # Updates the number of pinned table header rows in a table.
        # Corresponds to the JSON property `pinTableHeaderRows`
        # @return [Google::Apis::DocsV1::PinTableHeaderRowsRequest]
        attr_accessor :pin_table_header_rows
      
        # Replaces all instances of text matching a criteria with replace text.
        # Corresponds to the JSON property `replaceAllText`
        # @return [Google::Apis::DocsV1::ReplaceAllTextRequest]
        attr_accessor :replace_all_text
      
        # Replaces an existing image with a new image. Replacing an image removes some
        # image effects from the existing image in order to mirror the behavior of the
        # Docs editor.
        # Corresponds to the JSON property `replaceImage`
        # @return [Google::Apis::DocsV1::ReplaceImageRequest]
        attr_accessor :replace_image
      
        # Replaces the contents of the specified NamedRange or NamedRanges with the
        # given replacement content. Note that an individual NamedRange may consist of
        # multiple discontinuous ranges. In this case, only the content in the first
        # range will be replaced. The other ranges and their content will be deleted. In
        # cases where replacing or deleting any ranges would result in an invalid
        # document structure, a 400 bad request error is returned.
        # Corresponds to the JSON property `replaceNamedRangeContent`
        # @return [Google::Apis::DocsV1::ReplaceNamedRangeContentRequest]
        attr_accessor :replace_named_range_content
      
        # Unmerges cells in a Table.
        # Corresponds to the JSON property `unmergeTableCells`
        # @return [Google::Apis::DocsV1::UnmergeTableCellsRequest]
        attr_accessor :unmerge_table_cells
      
        # Updates the DocumentStyle.
        # Corresponds to the JSON property `updateDocumentStyle`
        # @return [Google::Apis::DocsV1::UpdateDocumentStyleRequest]
        attr_accessor :update_document_style
      
        # Update the styling of all paragraphs that overlap with the given range.
        # Corresponds to the JSON property `updateParagraphStyle`
        # @return [Google::Apis::DocsV1::UpdateParagraphStyleRequest]
        attr_accessor :update_paragraph_style
      
        # Updates the SectionStyle.
        # Corresponds to the JSON property `updateSectionStyle`
        # @return [Google::Apis::DocsV1::UpdateSectionStyleRequest]
        attr_accessor :update_section_style
      
        # Updates the style of a range of table cells.
        # Corresponds to the JSON property `updateTableCellStyle`
        # @return [Google::Apis::DocsV1::UpdateTableCellStyleRequest]
        attr_accessor :update_table_cell_style
      
        # Updates the TableColumnProperties of columns in a table.
        # Corresponds to the JSON property `updateTableColumnProperties`
        # @return [Google::Apis::DocsV1::UpdateTableColumnPropertiesRequest]
        attr_accessor :update_table_column_properties
      
        # Updates the TableRowStyle of rows in a table.
        # Corresponds to the JSON property `updateTableRowStyle`
        # @return [Google::Apis::DocsV1::UpdateTableRowStyleRequest]
        attr_accessor :update_table_row_style
      
        # Update the styling of text.
        # Corresponds to the JSON property `updateTextStyle`
        # @return [Google::Apis::DocsV1::UpdateTextStyleRequest]
        attr_accessor :update_text_style
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @create_footer = args[:create_footer] if args.key?(:create_footer)
          @create_footnote = args[:create_footnote] if args.key?(:create_footnote)
          @create_header = args[:create_header] if args.key?(:create_header)
          @create_named_range = args[:create_named_range] if args.key?(:create_named_range)
          @create_paragraph_bullets = args[:create_paragraph_bullets] if args.key?(:create_paragraph_bullets)
          @delete_content_range = args[:delete_content_range] if args.key?(:delete_content_range)
          @delete_footer = args[:delete_footer] if args.key?(:delete_footer)
          @delete_header = args[:delete_header] if args.key?(:delete_header)
          @delete_named_range = args[:delete_named_range] if args.key?(:delete_named_range)
          @delete_paragraph_bullets = args[:delete_paragraph_bullets] if args.key?(:delete_paragraph_bullets)
          @delete_positioned_object = args[:delete_positioned_object] if args.key?(:delete_positioned_object)
          @delete_table_column = args[:delete_table_column] if args.key?(:delete_table_column)
          @delete_table_row = args[:delete_table_row] if args.key?(:delete_table_row)
          @insert_inline_image = args[:insert_inline_image] if args.key?(:insert_inline_image)
          @insert_page_break = args[:insert_page_break] if args.key?(:insert_page_break)
          @insert_person = args[:insert_person] if args.key?(:insert_person)
          @insert_section_break = args[:insert_section_break] if args.key?(:insert_section_break)
          @insert_table = args[:insert_table] if args.key?(:insert_table)
          @insert_table_column = args[:insert_table_column] if args.key?(:insert_table_column)
          @insert_table_row = args[:insert_table_row] if args.key?(:insert_table_row)
          @insert_text = args[:insert_text] if args.key?(:insert_text)
          @merge_table_cells = args[:merge_table_cells] if args.key?(:merge_table_cells)
          @pin_table_header_rows = args[:pin_table_header_rows] if args.key?(:pin_table_header_rows)
          @replace_all_text = args[:replace_all_text] if args.key?(:replace_all_text)
          @replace_image = args[:replace_image] if args.key?(:replace_image)
          @replace_named_range_content = args[:replace_named_range_content] if args.key?(:replace_named_range_content)
          @unmerge_table_cells = args[:unmerge_table_cells] if args.key?(:unmerge_table_cells)
          @update_document_style = args[:update_document_style] if args.key?(:update_document_style)
          @update_paragraph_style = args[:update_paragraph_style] if args.key?(:update_paragraph_style)
          @update_section_style = args[:update_section_style] if args.key?(:update_section_style)
          @update_table_cell_style = args[:update_table_cell_style] if args.key?(:update_table_cell_style)
          @update_table_column_properties = args[:update_table_column_properties] if args.key?(:update_table_column_properties)
          @update_table_row_style = args[:update_table_row_style] if args.key?(:update_table_row_style)
          @update_text_style = args[:update_text_style] if args.key?(:update_text_style)
        end
      end
      
      # A single response from an update.
      class Response
        include Google::Apis::Core::Hashable
      
        # The result of creating a footer.
        # Corresponds to the JSON property `createFooter`
        # @return [Google::Apis::DocsV1::CreateFooterResponse]
        attr_accessor :create_footer
      
        # The result of creating a footnote.
        # Corresponds to the JSON property `createFootnote`
        # @return [Google::Apis::DocsV1::CreateFootnoteResponse]
        attr_accessor :create_footnote
      
        # The result of creating a header.
        # Corresponds to the JSON property `createHeader`
        # @return [Google::Apis::DocsV1::CreateHeaderResponse]
        attr_accessor :create_header
      
        # The result of creating a named range.
        # Corresponds to the JSON property `createNamedRange`
        # @return [Google::Apis::DocsV1::CreateNamedRangeResponse]
        attr_accessor :create_named_range
      
        # The result of inserting an inline image.
        # Corresponds to the JSON property `insertInlineImage`
        # @return [Google::Apis::DocsV1::InsertInlineImageResponse]
        attr_accessor :insert_inline_image
      
        # The result of inserting an embedded Google Sheets chart.
        # Corresponds to the JSON property `insertInlineSheetsChart`
        # @return [Google::Apis::DocsV1::InsertInlineSheetsChartResponse]
        attr_accessor :insert_inline_sheets_chart
      
        # The result of replacing text.
        # Corresponds to the JSON property `replaceAllText`
        # @return [Google::Apis::DocsV1::ReplaceAllTextResponse]
        attr_accessor :replace_all_text
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @create_footer = args[:create_footer] if args.key?(:create_footer)
          @create_footnote = args[:create_footnote] if args.key?(:create_footnote)
          @create_header = args[:create_header] if args.key?(:create_header)
          @create_named_range = args[:create_named_range] if args.key?(:create_named_range)
          @insert_inline_image = args[:insert_inline_image] if args.key?(:insert_inline_image)
          @insert_inline_sheets_chart = args[:insert_inline_sheets_chart] if args.key?(:insert_inline_sheets_chart)
          @replace_all_text = args[:replace_all_text] if args.key?(:replace_all_text)
        end
      end
      
      # An RGB color.
      class RgbColor
        include Google::Apis::Core::Hashable
      
        # The blue component of the color, from 0.0 to 1.0.
        # Corresponds to the JSON property `blue`
        # @return [Float]
        attr_accessor :blue
      
        # The green component of the color, from 0.0 to 1.0.
        # Corresponds to the JSON property `green`
        # @return [Float]
        attr_accessor :green
      
        # The red component of the color, from 0.0 to 1.0.
        # Corresponds to the JSON property `red`
        # @return [Float]
        attr_accessor :red
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @blue = args[:blue] if args.key?(:blue)
          @green = args[:green] if args.key?(:green)
          @red = args[:red] if args.key?(:red)
        end
      end
      
      # A link to a Google resource (such as a file in Drive, a YouTube video, or a
      # Calendar event).
      class RichLink
        include Google::Apis::Core::Hashable
      
        # Output only. The ID of this link.
        # Corresponds to the JSON property `richLinkId`
        # @return [String]
        attr_accessor :rich_link_id
      
        # Properties specific to a RichLink.
        # Corresponds to the JSON property `richLinkProperties`
        # @return [Google::Apis::DocsV1::RichLinkProperties]
        attr_accessor :rich_link_properties
      
        # IDs for suggestions that remove this link from the document. A RichLink might
        # have multiple deletion IDs if, for example, multiple users suggest deleting it.
        # If empty, then this person link isn't suggested for deletion.
        # Corresponds to the JSON property `suggestedDeletionIds`
        # @return [Array<String>]
        attr_accessor :suggested_deletion_ids
      
        # IDs for suggestions that insert this link into the document. A RichLink might
        # have multiple insertion IDs if it's a nested suggested change (a suggestion
        # within a suggestion made by a different user, for example). If empty, then
        # this person link isn't a suggested insertion.
        # Corresponds to the JSON property `suggestedInsertionIds`
        # @return [Array<String>]
        attr_accessor :suggested_insertion_ids
      
        # The suggested text style changes to this RichLink, keyed by suggestion ID.
        # Corresponds to the JSON property `suggestedTextStyleChanges`
        # @return [Hash<String,Google::Apis::DocsV1::SuggestedTextStyle>]
        attr_accessor :suggested_text_style_changes
      
        # Represents the styling that can be applied to text. Inherited text styles are
        # represented as unset fields in this message. A text style's parent depends on
        # where the text style is defined: * The TextStyle of text in a Paragraph
        # inherits from the paragraph's corresponding named style type. * The TextStyle
        # on a named style inherits from the normal text named style. * The TextStyle of
        # the normal text named style inherits from the default text style in the Docs
        # editor. * The TextStyle on a Paragraph element that's contained in a table may
        # inherit its text style from the table style. If the text style does not
        # inherit from a parent, unsetting fields will revert the style to a value
        # matching the defaults in the Docs editor.
        # Corresponds to the JSON property `textStyle`
        # @return [Google::Apis::DocsV1::TextStyle]
        attr_accessor :text_style
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @rich_link_id = args[:rich_link_id] if args.key?(:rich_link_id)
          @rich_link_properties = args[:rich_link_properties] if args.key?(:rich_link_properties)
          @suggested_deletion_ids = args[:suggested_deletion_ids] if args.key?(:suggested_deletion_ids)
          @suggested_insertion_ids = args[:suggested_insertion_ids] if args.key?(:suggested_insertion_ids)
          @suggested_text_style_changes = args[:suggested_text_style_changes] if args.key?(:suggested_text_style_changes)
          @text_style = args[:text_style] if args.key?(:text_style)
        end
      end
      
      # Properties specific to a RichLink.
      class RichLinkProperties
        include Google::Apis::Core::Hashable
      
        # Output only. The [MIME type](https://developers.google.com/drive/api/v3/mime-
        # types) of the RichLink, if there's one (for example, when it's a file in Drive)
        # .
        # Corresponds to the JSON property `mimeType`
        # @return [String]
        attr_accessor :mime_type
      
        # Output only. The title of the RichLink as displayed in the link. This title
        # matches the title of the linked resource at the time of the insertion or last
        # update of the link. This field is always present.
        # Corresponds to the JSON property `title`
        # @return [String]
        attr_accessor :title
      
        # Output only. The URI to the RichLink. This is always present.
        # Corresponds to the JSON property `uri`
        # @return [String]
        attr_accessor :uri
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @mime_type = args[:mime_type] if args.key?(:mime_type)
          @title = args[:title] if args.key?(:title)
          @uri = args[:uri] if args.key?(:uri)
        end
      end
      
      # A StructuralElement representing a section break. A section is a range of
      # content that has the same SectionStyle. A section break represents the start
      # of a new section, and the section style applies to the section after the
      # section break. The document body always begins with a section break.
      class SectionBreak
        include Google::Apis::Core::Hashable
      
        # The styling that applies to a section.
        # Corresponds to the JSON property `sectionStyle`
        # @return [Google::Apis::DocsV1::SectionStyle]
        attr_accessor :section_style
      
        # The suggested deletion IDs. If empty, then there are no suggested deletions of
        # this content.
        # Corresponds to the JSON property `suggestedDeletionIds`
        # @return [Array<String>]
        attr_accessor :suggested_deletion_ids
      
        # The suggested insertion IDs. A SectionBreak may have multiple insertion IDs if
        # it's a nested suggested change. If empty, then this is not a suggested
        # insertion.
        # Corresponds to the JSON property `suggestedInsertionIds`
        # @return [Array<String>]
        attr_accessor :suggested_insertion_ids
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @section_style = args[:section_style] if args.key?(:section_style)
          @suggested_deletion_ids = args[:suggested_deletion_ids] if args.key?(:suggested_deletion_ids)
          @suggested_insertion_ids = args[:suggested_insertion_ids] if args.key?(:suggested_insertion_ids)
        end
      end
      
      # Properties that apply to a section's column.
      class SectionColumnProperties
        include Google::Apis::Core::Hashable
      
        # A magnitude in a single direction in the specified units.
        # Corresponds to the JSON property `paddingEnd`
        # @return [Google::Apis::DocsV1::Dimension]
        attr_accessor :padding_end
      
        # A magnitude in a single direction in the specified units.
        # Corresponds to the JSON property `width`
        # @return [Google::Apis::DocsV1::Dimension]
        attr_accessor :width
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @padding_end = args[:padding_end] if args.key?(:padding_end)
          @width = args[:width] if args.key?(:width)
        end
      end
      
      # The styling that applies to a section.
      class SectionStyle
        include Google::Apis::Core::Hashable
      
        # The section's columns properties. If empty, the section contains one column
        # with the default properties in the Docs editor. A section can be updated to
        # have no more than 3 columns. When updating this property, setting a concrete
        # value is required. Unsetting this property will result in a 400 bad request
        # error.
        # Corresponds to the JSON property `columnProperties`
        # @return [Array<Google::Apis::DocsV1::SectionColumnProperties>]
        attr_accessor :column_properties
      
        # The style of column separators. This style can be set even when there's one
        # column in the section. When updating this property, setting a concrete value
        # is required. Unsetting this property results in a 400 bad request error.
        # Corresponds to the JSON property `columnSeparatorStyle`
        # @return [String]
        attr_accessor :column_separator_style
      
        # The content direction of this section. If unset, the value defaults to
        # LEFT_TO_RIGHT. When updating this property, setting a concrete value is
        # required. Unsetting this property results in a 400 bad request error.
        # Corresponds to the JSON property `contentDirection`
        # @return [String]
        attr_accessor :content_direction
      
        # The ID of the default footer. If unset, the value inherits from the previous
        # SectionBreak's SectionStyle. If the value is unset in the first SectionBreak,
        # it inherits from DocumentStyle's default_footer_id. This property is read-only.
        # Corresponds to the JSON property `defaultFooterId`
        # @return [String]
        attr_accessor :default_footer_id
      
        # The ID of the default header. If unset, the value inherits from the previous
        # SectionBreak's SectionStyle. If the value is unset in the first SectionBreak,
        # it inherits from DocumentStyle's default_header_id. This property is read-only.
        # Corresponds to the JSON property `defaultHeaderId`
        # @return [String]
        attr_accessor :default_header_id
      
        # The ID of the footer used only for even pages. If the value of DocumentStyle's
        # use_even_page_header_footer is true, this value is used for the footers on
        # even pages in the section. If it is false, the footers on even pages use the
        # default_footer_id. If unset, the value inherits from the previous SectionBreak'
        # s SectionStyle. If the value is unset in the first SectionBreak, it inherits
        # from DocumentStyle's even_page_footer_id. This property is read-only.
        # Corresponds to the JSON property `evenPageFooterId`
        # @return [String]
        attr_accessor :even_page_footer_id
      
        # The ID of the header used only for even pages. If the value of DocumentStyle's
        # use_even_page_header_footer is true, this value is used for the headers on
        # even pages in the section. If it is false, the headers on even pages use the
        # default_header_id. If unset, the value inherits from the previous SectionBreak'
        # s SectionStyle. If the value is unset in the first SectionBreak, it inherits
        # from DocumentStyle's even_page_header_id. This property is read-only.
        # Corresponds to the JSON property `evenPageHeaderId`
        # @return [String]
        attr_accessor :even_page_header_id
      
        # The ID of the footer used only for the first page of the section. If
        # use_first_page_header_footer is true, this value is used for the footer on the
        # first page of the section. If it's false, the footer on the first page of the
        # section uses the default_footer_id. If unset, the value inherits from the
        # previous SectionBreak's SectionStyle. If the value is unset in the first
        # SectionBreak, it inherits from DocumentStyle's first_page_footer_id. This
        # property is read-only.
        # Corresponds to the JSON property `firstPageFooterId`
        # @return [String]
        attr_accessor :first_page_footer_id
      
        # The ID of the header used only for the first page of the section. If
        # use_first_page_header_footer is true, this value is used for the header on the
        # first page of the section. If it's false, the header on the first page of the
        # section uses the default_header_id. If unset, the value inherits from the
        # previous SectionBreak's SectionStyle. If the value is unset in the first
        # SectionBreak, it inherits from DocumentStyle's first_page_header_id. This
        # property is read-only.
        # Corresponds to the JSON property `firstPageHeaderId`
        # @return [String]
        attr_accessor :first_page_header_id
      
        # Optional. Indicates whether to flip the dimensions of DocumentStyle's
        # page_size for this section, which allows changing the page orientation between
        # portrait and landscape. If unset, the value inherits from DocumentStyle's
        # flip_page_orientation. When updating this property, setting a concrete value
        # is required. Unsetting this property results in a 400 bad request error.
        # Corresponds to the JSON property `flipPageOrientation`
        # @return [Boolean]
        attr_accessor :flip_page_orientation
        alias_method :flip_page_orientation?, :flip_page_orientation
      
        # A magnitude in a single direction in the specified units.
        # Corresponds to the JSON property `marginBottom`
        # @return [Google::Apis::DocsV1::Dimension]
        attr_accessor :margin_bottom
      
        # A magnitude in a single direction in the specified units.
        # Corresponds to the JSON property `marginFooter`
        # @return [Google::Apis::DocsV1::Dimension]
        attr_accessor :margin_footer
      
        # A magnitude in a single direction in the specified units.
        # Corresponds to the JSON property `marginHeader`
        # @return [Google::Apis::DocsV1::Dimension]
        attr_accessor :margin_header
      
        # A magnitude in a single direction in the specified units.
        # Corresponds to the JSON property `marginLeft`
        # @return [Google::Apis::DocsV1::Dimension]
        attr_accessor :margin_left
      
        # A magnitude in a single direction in the specified units.
        # Corresponds to the JSON property `marginRight`
        # @return [Google::Apis::DocsV1::Dimension]
        attr_accessor :margin_right
      
        # A magnitude in a single direction in the specified units.
        # Corresponds to the JSON property `marginTop`
        # @return [Google::Apis::DocsV1::Dimension]
        attr_accessor :margin_top
      
        # The page number from which to start counting the number of pages for this
        # section. If unset, page numbering continues from the previous section. If the
        # value is unset in the first SectionBreak, refer to DocumentStyle's
        # page_number_start. When updating this property, setting a concrete value is
        # required. Unsetting this property results in a 400 bad request error.
        # Corresponds to the JSON property `pageNumberStart`
        # @return [Fixnum]
        attr_accessor :page_number_start
      
        # Output only. The type of section.
        # Corresponds to the JSON property `sectionType`
        # @return [String]
        attr_accessor :section_type
      
        # Indicates whether to use the first page header / footer IDs for the first page
        # of the section. If unset, it inherits from DocumentStyle's
        # use_first_page_header_footer for the first section. If the value is unset for
        # subsequent sectors, it should be interpreted as false. When updating this
        # property, setting a concrete value is required. Unsetting this property
        # results in a 400 bad request error.
        # Corresponds to the JSON property `useFirstPageHeaderFooter`
        # @return [Boolean]
        attr_accessor :use_first_page_header_footer
        alias_method :use_first_page_header_footer?, :use_first_page_header_footer
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @column_properties = args[:column_properties] if args.key?(:column_properties)
          @column_separator_style = args[:column_separator_style] if args.key?(:column_separator_style)
          @content_direction = args[:content_direction] if args.key?(:content_direction)
          @default_footer_id = args[:default_footer_id] if args.key?(:default_footer_id)
          @default_header_id = args[:default_header_id] if args.key?(:default_header_id)
          @even_page_footer_id = args[:even_page_footer_id] if args.key?(:even_page_footer_id)
          @even_page_header_id = args[:even_page_header_id] if args.key?(:even_page_header_id)
          @first_page_footer_id = args[:first_page_footer_id] if args.key?(:first_page_footer_id)
          @first_page_header_id = args[:first_page_header_id] if args.key?(:first_page_header_id)
          @flip_page_orientation = args[:flip_page_orientation] if args.key?(:flip_page_orientation)
          @margin_bottom = args[:margin_bottom] if args.key?(:margin_bottom)
          @margin_footer = args[:margin_footer] if args.key?(:margin_footer)
          @margin_header = args[:margin_header] if args.key?(:margin_header)
          @margin_left = args[:margin_left] if args.key?(:margin_left)
          @margin_right = args[:margin_right] if args.key?(:margin_right)
          @margin_top = args[:margin_top] if args.key?(:margin_top)
          @page_number_start = args[:page_number_start] if args.key?(:page_number_start)
          @section_type = args[:section_type] if args.key?(:section_type)
          @use_first_page_header_footer = args[:use_first_page_header_footer] if args.key?(:use_first_page_header_footer)
        end
      end
      
      # The shading of a paragraph.
      class Shading
        include Google::Apis::Core::Hashable
      
        # A color that can either be fully opaque or fully transparent.
        # Corresponds to the JSON property `backgroundColor`
        # @return [Google::Apis::DocsV1::OptionalColor]
        attr_accessor :background_color
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @background_color = args[:background_color] if args.key?(:background_color)
        end
      end
      
      # A mask that indicates which of the fields on the base Shading have been
      # changed in this suggested change. For any field set to true, there's a new
      # suggested value.
      class ShadingSuggestionState
        include Google::Apis::Core::Hashable
      
        # Indicates if there was a suggested change to the Shading.
        # Corresponds to the JSON property `backgroundColorSuggested`
        # @return [Boolean]
        attr_accessor :background_color_suggested
        alias_method :background_color_suggested?, :background_color_suggested
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @background_color_suggested = args[:background_color_suggested] if args.key?(:background_color_suggested)
        end
      end
      
      # A reference to a linked chart embedded from Google Sheets.
      class SheetsChartReference
        include Google::Apis::Core::Hashable
      
        # The ID of the specific chart in the Google Sheets spreadsheet that's embedded.
        # Corresponds to the JSON property `chartId`
        # @return [Fixnum]
        attr_accessor :chart_id
      
        # The ID of the Google Sheets spreadsheet that contains the source chart.
        # Corresponds to the JSON property `spreadsheetId`
        # @return [String]
        attr_accessor :spreadsheet_id
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @chart_id = args[:chart_id] if args.key?(:chart_id)
          @spreadsheet_id = args[:spreadsheet_id] if args.key?(:spreadsheet_id)
        end
      end
      
      # A mask that indicates which of the fields on the base SheetsChartReference
      # have been changed in this suggestion. For any field set to true, there's a new
      # suggested value.
      class SheetsChartReferenceSuggestionState
        include Google::Apis::Core::Hashable
      
        # Indicates if there was a suggested change to chart_id.
        # Corresponds to the JSON property `chartIdSuggested`
        # @return [Boolean]
        attr_accessor :chart_id_suggested
        alias_method :chart_id_suggested?, :chart_id_suggested
      
        # Indicates if there was a suggested change to spreadsheet_id.
        # Corresponds to the JSON property `spreadsheetIdSuggested`
        # @return [Boolean]
        attr_accessor :spreadsheet_id_suggested
        alias_method :spreadsheet_id_suggested?, :spreadsheet_id_suggested
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @chart_id_suggested = args[:chart_id_suggested] if args.key?(:chart_id_suggested)
          @spreadsheet_id_suggested = args[:spreadsheet_id_suggested] if args.key?(:spreadsheet_id_suggested)
        end
      end
      
      # A width and height.
      class Size
        include Google::Apis::Core::Hashable
      
        # A magnitude in a single direction in the specified units.
        # Corresponds to the JSON property `height`
        # @return [Google::Apis::DocsV1::Dimension]
        attr_accessor :height
      
        # A magnitude in a single direction in the specified units.
        # Corresponds to the JSON property `width`
        # @return [Google::Apis::DocsV1::Dimension]
        attr_accessor :width
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @height = args[:height] if args.key?(:height)
          @width = args[:width] if args.key?(:width)
        end
      end
      
      # A mask that indicates which of the fields on the base Size have been changed
      # in this suggestion. For any field set to true, the Size has a new suggested
      # value.
      class SizeSuggestionState
        include Google::Apis::Core::Hashable
      
        # Indicates if there was a suggested change to height.
        # Corresponds to the JSON property `heightSuggested`
        # @return [Boolean]
        attr_accessor :height_suggested
        alias_method :height_suggested?, :height_suggested
      
        # Indicates if there was a suggested change to width.
        # Corresponds to the JSON property `widthSuggested`
        # @return [Boolean]
        attr_accessor :width_suggested
        alias_method :width_suggested?, :width_suggested
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @height_suggested = args[:height_suggested] if args.key?(:height_suggested)
          @width_suggested = args[:width_suggested] if args.key?(:width_suggested)
        end
      end
      
      # A StructuralElement describes content that provides structure to the document.
      class StructuralElement
        include Google::Apis::Core::Hashable
      
        # The zero-based end index of this structural element, exclusive, in UTF-16 code
        # units.
        # Corresponds to the JSON property `endIndex`
        # @return [Fixnum]
        attr_accessor :end_index
      
        # A StructuralElement representing a paragraph. A paragraph is a range of
        # content that's terminated with a newline character.
        # Corresponds to the JSON property `paragraph`
        # @return [Google::Apis::DocsV1::Paragraph]
        attr_accessor :paragraph
      
        # A StructuralElement representing a section break. A section is a range of
        # content that has the same SectionStyle. A section break represents the start
        # of a new section, and the section style applies to the section after the
        # section break. The document body always begins with a section break.
        # Corresponds to the JSON property `sectionBreak`
        # @return [Google::Apis::DocsV1::SectionBreak]
        attr_accessor :section_break
      
        # The zero-based start index of this structural element, in UTF-16 code units.
        # Corresponds to the JSON property `startIndex`
        # @return [Fixnum]
        attr_accessor :start_index
      
        # A StructuralElement representing a table.
        # Corresponds to the JSON property `table`
        # @return [Google::Apis::DocsV1::Table]
        attr_accessor :table
      
        # A StructuralElement representing a table of contents.
        # Corresponds to the JSON property `tableOfContents`
        # @return [Google::Apis::DocsV1::TableOfContents]
        attr_accessor :table_of_contents
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @end_index = args[:end_index] if args.key?(:end_index)
          @paragraph = args[:paragraph] if args.key?(:paragraph)
          @section_break = args[:section_break] if args.key?(:section_break)
          @start_index = args[:start_index] if args.key?(:start_index)
          @table = args[:table] if args.key?(:table)
          @table_of_contents = args[:table_of_contents] if args.key?(:table_of_contents)
        end
      end
      
      # A criteria that matches a specific string of text in the document.
      class SubstringMatchCriteria
        include Google::Apis::Core::Hashable
      
        # Indicates whether the search should respect case: - `True`: the search is case
        # sensitive. - `False`: the search is case insensitive.
        # Corresponds to the JSON property `matchCase`
        # @return [Boolean]
        attr_accessor :match_case
        alias_method :match_case?, :match_case
      
        # Optional. True if the find value should be treated as a regular expression.
        # Any backslashes in the pattern should be escaped. - `True`: the search text is
        # treated as a regular expressions. - `False`: the search text is treated as a
        # substring for matching.
        # Corresponds to the JSON property `searchByRegex`
        # @return [Boolean]
        attr_accessor :search_by_regex
        alias_method :search_by_regex?, :search_by_regex
      
        # The text to search for in the document.
        # Corresponds to the JSON property `text`
        # @return [String]
        attr_accessor :text
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @match_case = args[:match_case] if args.key?(:match_case)
          @search_by_regex = args[:search_by_regex] if args.key?(:search_by_regex)
          @text = args[:text] if args.key?(:text)
        end
      end
      
      # A suggested change to a Bullet.
      class SuggestedBullet
        include Google::Apis::Core::Hashable
      
        # Describes the bullet of a paragraph.
        # Corresponds to the JSON property `bullet`
        # @return [Google::Apis::DocsV1::Bullet]
        attr_accessor :bullet
      
        # A mask that indicates which of the fields on the base Bullet have been changed
        # in this suggestion. For any field set to true, there's a new suggested value.
        # Corresponds to the JSON property `bulletSuggestionState`
        # @return [Google::Apis::DocsV1::BulletSuggestionState]
        attr_accessor :bullet_suggestion_state
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @bullet = args[:bullet] if args.key?(:bullet)
          @bullet_suggestion_state = args[:bullet_suggestion_state] if args.key?(:bullet_suggestion_state)
        end
      end
      
      # A suggested change to the DocumentStyle.
      class SuggestedDocumentStyle
        include Google::Apis::Core::Hashable
      
        # The style of the document.
        # Corresponds to the JSON property `documentStyle`
        # @return [Google::Apis::DocsV1::DocumentStyle]
        attr_accessor :document_style
      
        # A mask that indicates which of the fields on the base DocumentStyle have been
        # changed in this suggestion. For any field set to true, there's a new suggested
        # value.
        # Corresponds to the JSON property `documentStyleSuggestionState`
        # @return [Google::Apis::DocsV1::DocumentStyleSuggestionState]
        attr_accessor :document_style_suggestion_state
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @document_style = args[:document_style] if args.key?(:document_style)
          @document_style_suggestion_state = args[:document_style_suggestion_state] if args.key?(:document_style_suggestion_state)
        end
      end
      
      # A suggested change to InlineObjectProperties.
      class SuggestedInlineObjectProperties
        include Google::Apis::Core::Hashable
      
        # Properties of an InlineObject.
        # Corresponds to the JSON property `inlineObjectProperties`
        # @return [Google::Apis::DocsV1::InlineObjectProperties]
        attr_accessor :inline_object_properties
      
        # A mask that indicates which of the fields on the base InlineObjectProperties
        # have been changed in this suggestion. For any field set to true, there's a new
        # suggested value.
        # Corresponds to the JSON property `inlineObjectPropertiesSuggestionState`
        # @return [Google::Apis::DocsV1::InlineObjectPropertiesSuggestionState]
        attr_accessor :inline_object_properties_suggestion_state
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @inline_object_properties = args[:inline_object_properties] if args.key?(:inline_object_properties)
          @inline_object_properties_suggestion_state = args[:inline_object_properties_suggestion_state] if args.key?(:inline_object_properties_suggestion_state)
        end
      end
      
      # A suggested change to ListProperties.
      class SuggestedListProperties
        include Google::Apis::Core::Hashable
      
        # The properties of a list that describe the look and feel of bullets belonging
        # to paragraphs associated with a list.
        # Corresponds to the JSON property `listProperties`
        # @return [Google::Apis::DocsV1::ListProperties]
        attr_accessor :list_properties
      
        # A mask that indicates which of the fields on the base ListProperties have been
        # changed in this suggestion. For any field set to true, there's a new suggested
        # value.
        # Corresponds to the JSON property `listPropertiesSuggestionState`
        # @return [Google::Apis::DocsV1::ListPropertiesSuggestionState]
        attr_accessor :list_properties_suggestion_state
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @list_properties = args[:list_properties] if args.key?(:list_properties)
          @list_properties_suggestion_state = args[:list_properties_suggestion_state] if args.key?(:list_properties_suggestion_state)
        end
      end
      
      # A suggested change to the NamedStyles.
      class SuggestedNamedStyles
        include Google::Apis::Core::Hashable
      
        # The named styles. Paragraphs in the document can inherit their TextStyle and
        # ParagraphStyle from these named styles.
        # Corresponds to the JSON property `namedStyles`
        # @return [Google::Apis::DocsV1::NamedStyles]
        attr_accessor :named_styles
      
        # The suggestion state of a NamedStyles message.
        # Corresponds to the JSON property `namedStylesSuggestionState`
        # @return [Google::Apis::DocsV1::NamedStylesSuggestionState]
        attr_accessor :named_styles_suggestion_state
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @named_styles = args[:named_styles] if args.key?(:named_styles)
          @named_styles_suggestion_state = args[:named_styles_suggestion_state] if args.key?(:named_styles_suggestion_state)
        end
      end
      
      # A suggested change to a ParagraphStyle.
      class SuggestedParagraphStyle
        include Google::Apis::Core::Hashable
      
        # Styles that apply to a whole paragraph. Inherited paragraph styles are
        # represented as unset fields in this message. A paragraph style's parent
        # depends on where the paragraph style is defined: * The ParagraphStyle on a
        # Paragraph inherits from the paragraph's corresponding named style type. * The
        # ParagraphStyle on a named style inherits from the normal text named style. *
        # The ParagraphStyle of the normal text named style inherits from the default
        # paragraph style in the Docs editor. * The ParagraphStyle on a Paragraph
        # element that's contained in a table may inherit its paragraph style from the
        # table style. If the paragraph style does not inherit from a parent, unsetting
        # fields will revert the style to a value matching the defaults in the Docs
        # editor.
        # Corresponds to the JSON property `paragraphStyle`
        # @return [Google::Apis::DocsV1::ParagraphStyle]
        attr_accessor :paragraph_style
      
        # A mask that indicates which of the fields on the base ParagraphStyle have been
        # changed in this suggestion. For any field set to true, there's a new suggested
        # value.
        # Corresponds to the JSON property `paragraphStyleSuggestionState`
        # @return [Google::Apis::DocsV1::ParagraphStyleSuggestionState]
        attr_accessor :paragraph_style_suggestion_state
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @paragraph_style = args[:paragraph_style] if args.key?(:paragraph_style)
          @paragraph_style_suggestion_state = args[:paragraph_style_suggestion_state] if args.key?(:paragraph_style_suggestion_state)
        end
      end
      
      # A suggested change to PositionedObjectProperties.
      class SuggestedPositionedObjectProperties
        include Google::Apis::Core::Hashable
      
        # Properties of a PositionedObject.
        # Corresponds to the JSON property `positionedObjectProperties`
        # @return [Google::Apis::DocsV1::PositionedObjectProperties]
        attr_accessor :positioned_object_properties
      
        # A mask that indicates which of the fields on the base
        # PositionedObjectProperties have been changed in this suggestion. For any field
        # set to true, there's a new suggested value.
        # Corresponds to the JSON property `positionedObjectPropertiesSuggestionState`
        # @return [Google::Apis::DocsV1::PositionedObjectPropertiesSuggestionState]
        attr_accessor :positioned_object_properties_suggestion_state
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @positioned_object_properties = args[:positioned_object_properties] if args.key?(:positioned_object_properties)
          @positioned_object_properties_suggestion_state = args[:positioned_object_properties_suggestion_state] if args.key?(:positioned_object_properties_suggestion_state)
        end
      end
      
      # A suggested change to a TableCellStyle.
      class SuggestedTableCellStyle
        include Google::Apis::Core::Hashable
      
        # The style of a TableCell. Inherited table cell styles are represented as unset
        # fields in this message. A table cell style can inherit from the table's style.
        # Corresponds to the JSON property `tableCellStyle`
        # @return [Google::Apis::DocsV1::TableCellStyle]
        attr_accessor :table_cell_style
      
        # A mask that indicates which of the fields on the base TableCellStyle have been
        # changed in this suggestion. For any field set to true, there's a new suggested
        # value.
        # Corresponds to the JSON property `tableCellStyleSuggestionState`
        # @return [Google::Apis::DocsV1::TableCellStyleSuggestionState]
        attr_accessor :table_cell_style_suggestion_state
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @table_cell_style = args[:table_cell_style] if args.key?(:table_cell_style)
          @table_cell_style_suggestion_state = args[:table_cell_style_suggestion_state] if args.key?(:table_cell_style_suggestion_state)
        end
      end
      
      # A suggested change to a TableRowStyle.
      class SuggestedTableRowStyle
        include Google::Apis::Core::Hashable
      
        # Styles that apply to a table row.
        # Corresponds to the JSON property `tableRowStyle`
        # @return [Google::Apis::DocsV1::TableRowStyle]
        attr_accessor :table_row_style
      
        # A mask that indicates which of the fields on the base TableRowStyle have been
        # changed in this suggestion. For any field set to true, there's a new suggested
        # value.
        # Corresponds to the JSON property `tableRowStyleSuggestionState`
        # @return [Google::Apis::DocsV1::TableRowStyleSuggestionState]
        attr_accessor :table_row_style_suggestion_state
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @table_row_style = args[:table_row_style] if args.key?(:table_row_style)
          @table_row_style_suggestion_state = args[:table_row_style_suggestion_state] if args.key?(:table_row_style_suggestion_state)
        end
      end
      
      # A suggested change to a TextStyle.
      class SuggestedTextStyle
        include Google::Apis::Core::Hashable
      
        # Represents the styling that can be applied to text. Inherited text styles are
        # represented as unset fields in this message. A text style's parent depends on
        # where the text style is defined: * The TextStyle of text in a Paragraph
        # inherits from the paragraph's corresponding named style type. * The TextStyle
        # on a named style inherits from the normal text named style. * The TextStyle of
        # the normal text named style inherits from the default text style in the Docs
        # editor. * The TextStyle on a Paragraph element that's contained in a table may
        # inherit its text style from the table style. If the text style does not
        # inherit from a parent, unsetting fields will revert the style to a value
        # matching the defaults in the Docs editor.
        # Corresponds to the JSON property `textStyle`
        # @return [Google::Apis::DocsV1::TextStyle]
        attr_accessor :text_style
      
        # A mask that indicates which of the fields on the base TextStyle have been
        # changed in this suggestion. For any field set to true, there's a new suggested
        # value.
        # Corresponds to the JSON property `textStyleSuggestionState`
        # @return [Google::Apis::DocsV1::TextStyleSuggestionState]
        attr_accessor :text_style_suggestion_state
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @text_style = args[:text_style] if args.key?(:text_style)
          @text_style_suggestion_state = args[:text_style_suggestion_state] if args.key?(:text_style_suggestion_state)
        end
      end
      
      # A tab in a document.
      class Tab
        include Google::Apis::Core::Hashable
      
        # The child tabs nested within this tab.
        # Corresponds to the JSON property `childTabs`
        # @return [Array<Google::Apis::DocsV1::Tab>]
        attr_accessor :child_tabs
      
        # A tab with document contents.
        # Corresponds to the JSON property `documentTab`
        # @return [Google::Apis::DocsV1::DocumentTab]
        attr_accessor :document_tab
      
        # Properties of a tab.
        # Corresponds to the JSON property `tabProperties`
        # @return [Google::Apis::DocsV1::TabProperties]
        attr_accessor :tab_properties
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @child_tabs = args[:child_tabs] if args.key?(:child_tabs)
          @document_tab = args[:document_tab] if args.key?(:document_tab)
          @tab_properties = args[:tab_properties] if args.key?(:tab_properties)
        end
      end
      
      # Properties of a tab.
      class TabProperties
        include Google::Apis::Core::Hashable
      
        # The zero-based index of the tab within the parent.
        # Corresponds to the JSON property `index`
        # @return [Fixnum]
        attr_accessor :index
      
        # Output only. The depth of the tab within the document. Root-level tabs start
        # at 0.
        # Corresponds to the JSON property `nestingLevel`
        # @return [Fixnum]
        attr_accessor :nesting_level
      
        # Optional. The ID of the parent tab. Empty when the current tab is a root-level
        # tab, which means it doesn't have any parents.
        # Corresponds to the JSON property `parentTabId`
        # @return [String]
        attr_accessor :parent_tab_id
      
        # Output only. The ID of the tab. This field can't be changed.
        # Corresponds to the JSON property `tabId`
        # @return [String]
        attr_accessor :tab_id
      
        # The user-visible name of the tab.
        # Corresponds to the JSON property `title`
        # @return [String]
        attr_accessor :title
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @index = args[:index] if args.key?(:index)
          @nesting_level = args[:nesting_level] if args.key?(:nesting_level)
          @parent_tab_id = args[:parent_tab_id] if args.key?(:parent_tab_id)
          @tab_id = args[:tab_id] if args.key?(:tab_id)
          @title = args[:title] if args.key?(:title)
        end
      end
      
      # A tab stop within a paragraph.
      class TabStop
        include Google::Apis::Core::Hashable
      
        # The alignment of this tab stop. If unset, the value defaults to START.
        # Corresponds to the JSON property `alignment`
        # @return [String]
        attr_accessor :alignment
      
        # A magnitude in a single direction in the specified units.
        # Corresponds to the JSON property `offset`
        # @return [Google::Apis::DocsV1::Dimension]
        attr_accessor :offset
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @alignment = args[:alignment] if args.key?(:alignment)
          @offset = args[:offset] if args.key?(:offset)
        end
      end
      
      # A StructuralElement representing a table.
      class Table
        include Google::Apis::Core::Hashable
      
        # Number of columns in the table. It's possible for a table to be non-
        # rectangular, so some rows may have a different number of cells.
        # Corresponds to the JSON property `columns`
        # @return [Fixnum]
        attr_accessor :columns
      
        # Number of rows in the table.
        # Corresponds to the JSON property `rows`
        # @return [Fixnum]
        attr_accessor :rows
      
        # The suggested deletion IDs. If empty, then there are no suggested deletions of
        # this content.
        # Corresponds to the JSON property `suggestedDeletionIds`
        # @return [Array<String>]
        attr_accessor :suggested_deletion_ids
      
        # The suggested insertion IDs. A Table may have multiple insertion IDs if it's a
        # nested suggested change. If empty, then this is not a suggested insertion.
        # Corresponds to the JSON property `suggestedInsertionIds`
        # @return [Array<String>]
        attr_accessor :suggested_insertion_ids
      
        # The contents and style of each row.
        # Corresponds to the JSON property `tableRows`
        # @return [Array<Google::Apis::DocsV1::TableRow>]
        attr_accessor :table_rows
      
        # Styles that apply to a table.
        # Corresponds to the JSON property `tableStyle`
        # @return [Google::Apis::DocsV1::TableStyle]
        attr_accessor :table_style
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @columns = args[:columns] if args.key?(:columns)
          @rows = args[:rows] if args.key?(:rows)
          @suggested_deletion_ids = args[:suggested_deletion_ids] if args.key?(:suggested_deletion_ids)
          @suggested_insertion_ids = args[:suggested_insertion_ids] if args.key?(:suggested_insertion_ids)
          @table_rows = args[:table_rows] if args.key?(:table_rows)
          @table_style = args[:table_style] if args.key?(:table_style)
        end
      end
      
      # The contents and style of a cell in a Table.
      class TableCell
        include Google::Apis::Core::Hashable
      
        # The content of the cell.
        # Corresponds to the JSON property `content`
        # @return [Array<Google::Apis::DocsV1::StructuralElement>]
        attr_accessor :content
      
        # The zero-based end index of this cell, exclusive, in UTF-16 code units.
        # Corresponds to the JSON property `endIndex`
        # @return [Fixnum]
        attr_accessor :end_index
      
        # The zero-based start index of this cell, in UTF-16 code units.
        # Corresponds to the JSON property `startIndex`
        # @return [Fixnum]
        attr_accessor :start_index
      
        # The suggested deletion IDs. If empty, then there are no suggested deletions of
        # this content.
        # Corresponds to the JSON property `suggestedDeletionIds`
        # @return [Array<String>]
        attr_accessor :suggested_deletion_ids
      
        # The suggested insertion IDs. A TableCell may have multiple insertion IDs if it'
        # s a nested suggested change. If empty, then this is not a suggested insertion.
        # Corresponds to the JSON property `suggestedInsertionIds`
        # @return [Array<String>]
        attr_accessor :suggested_insertion_ids
      
        # The suggested changes to the table cell style, keyed by suggestion ID.
        # Corresponds to the JSON property `suggestedTableCellStyleChanges`
        # @return [Hash<String,Google::Apis::DocsV1::SuggestedTableCellStyle>]
        attr_accessor :suggested_table_cell_style_changes
      
        # The style of a TableCell. Inherited table cell styles are represented as unset
        # fields in this message. A table cell style can inherit from the table's style.
        # Corresponds to the JSON property `tableCellStyle`
        # @return [Google::Apis::DocsV1::TableCellStyle]
        attr_accessor :table_cell_style
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @content = args[:content] if args.key?(:content)
          @end_index = args[:end_index] if args.key?(:end_index)
          @start_index = args[:start_index] if args.key?(:start_index)
          @suggested_deletion_ids = args[:suggested_deletion_ids] if args.key?(:suggested_deletion_ids)
          @suggested_insertion_ids = args[:suggested_insertion_ids] if args.key?(:suggested_insertion_ids)
          @suggested_table_cell_style_changes = args[:suggested_table_cell_style_changes] if args.key?(:suggested_table_cell_style_changes)
          @table_cell_style = args[:table_cell_style] if args.key?(:table_cell_style)
        end
      end
      
      # A border around a table cell. Table cell borders cannot be transparent. To
      # hide a table cell border, make its width 0.
      class TableCellBorder
        include Google::Apis::Core::Hashable
      
        # A color that can either be fully opaque or fully transparent.
        # Corresponds to the JSON property `color`
        # @return [Google::Apis::DocsV1::OptionalColor]
        attr_accessor :color
      
        # The dash style of the border.
        # Corresponds to the JSON property `dashStyle`
        # @return [String]
        attr_accessor :dash_style
      
        # A magnitude in a single direction in the specified units.
        # Corresponds to the JSON property `width`
        # @return [Google::Apis::DocsV1::Dimension]
        attr_accessor :width
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @color = args[:color] if args.key?(:color)
          @dash_style = args[:dash_style] if args.key?(:dash_style)
          @width = args[:width] if args.key?(:width)
        end
      end
      
      # Location of a single cell within a table.
      class TableCellLocation
        include Google::Apis::Core::Hashable
      
        # The zero-based column index. For example, the second column in the table has a
        # column index of 1.
        # Corresponds to the JSON property `columnIndex`
        # @return [Fixnum]
        attr_accessor :column_index
      
        # The zero-based row index. For example, the second row in the table has a row
        # index of 1.
        # Corresponds to the JSON property `rowIndex`
        # @return [Fixnum]
        attr_accessor :row_index
      
        # A particular location in the document.
        # Corresponds to the JSON property `tableStartLocation`
        # @return [Google::Apis::DocsV1::Location]
        attr_accessor :table_start_location
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @column_index = args[:column_index] if args.key?(:column_index)
          @row_index = args[:row_index] if args.key?(:row_index)
          @table_start_location = args[:table_start_location] if args.key?(:table_start_location)
        end
      end
      
      # The style of a TableCell. Inherited table cell styles are represented as unset
      # fields in this message. A table cell style can inherit from the table's style.
      class TableCellStyle
        include Google::Apis::Core::Hashable
      
        # A color that can either be fully opaque or fully transparent.
        # Corresponds to the JSON property `backgroundColor`
        # @return [Google::Apis::DocsV1::OptionalColor]
        attr_accessor :background_color
      
        # A border around a table cell. Table cell borders cannot be transparent. To
        # hide a table cell border, make its width 0.
        # Corresponds to the JSON property `borderBottom`
        # @return [Google::Apis::DocsV1::TableCellBorder]
        attr_accessor :border_bottom
      
        # A border around a table cell. Table cell borders cannot be transparent. To
        # hide a table cell border, make its width 0.
        # Corresponds to the JSON property `borderLeft`
        # @return [Google::Apis::DocsV1::TableCellBorder]
        attr_accessor :border_left
      
        # A border around a table cell. Table cell borders cannot be transparent. To
        # hide a table cell border, make its width 0.
        # Corresponds to the JSON property `borderRight`
        # @return [Google::Apis::DocsV1::TableCellBorder]
        attr_accessor :border_right
      
        # A border around a table cell. Table cell borders cannot be transparent. To
        # hide a table cell border, make its width 0.
        # Corresponds to the JSON property `borderTop`
        # @return [Google::Apis::DocsV1::TableCellBorder]
        attr_accessor :border_top
      
        # The column span of the cell. This property is read-only.
        # Corresponds to the JSON property `columnSpan`
        # @return [Fixnum]
        attr_accessor :column_span
      
        # The alignment of the content in the table cell. The default alignment matches
        # the alignment for newly created table cells in the Docs editor.
        # Corresponds to the JSON property `contentAlignment`
        # @return [String]
        attr_accessor :content_alignment
      
        # A magnitude in a single direction in the specified units.
        # Corresponds to the JSON property `paddingBottom`
        # @return [Google::Apis::DocsV1::Dimension]
        attr_accessor :padding_bottom
      
        # A magnitude in a single direction in the specified units.
        # Corresponds to the JSON property `paddingLeft`
        # @return [Google::Apis::DocsV1::Dimension]
        attr_accessor :padding_left
      
        # A magnitude in a single direction in the specified units.
        # Corresponds to the JSON property `paddingRight`
        # @return [Google::Apis::DocsV1::Dimension]
        attr_accessor :padding_right
      
        # A magnitude in a single direction in the specified units.
        # Corresponds to the JSON property `paddingTop`
        # @return [Google::Apis::DocsV1::Dimension]
        attr_accessor :padding_top
      
        # The row span of the cell. This property is read-only.
        # Corresponds to the JSON property `rowSpan`
        # @return [Fixnum]
        attr_accessor :row_span
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @background_color = args[:background_color] if args.key?(:background_color)
          @border_bottom = args[:border_bottom] if args.key?(:border_bottom)
          @border_left = args[:border_left] if args.key?(:border_left)
          @border_right = args[:border_right] if args.key?(:border_right)
          @border_top = args[:border_top] if args.key?(:border_top)
          @column_span = args[:column_span] if args.key?(:column_span)
          @content_alignment = args[:content_alignment] if args.key?(:content_alignment)
          @padding_bottom = args[:padding_bottom] if args.key?(:padding_bottom)
          @padding_left = args[:padding_left] if args.key?(:padding_left)
          @padding_right = args[:padding_right] if args.key?(:padding_right)
          @padding_top = args[:padding_top] if args.key?(:padding_top)
          @row_span = args[:row_span] if args.key?(:row_span)
        end
      end
      
      # A mask that indicates which of the fields on the base TableCellStyle have been
      # changed in this suggestion. For any field set to true, there's a new suggested
      # value.
      class TableCellStyleSuggestionState
        include Google::Apis::Core::Hashable
      
        # Indicates if there was a suggested change to background_color.
        # Corresponds to the JSON property `backgroundColorSuggested`
        # @return [Boolean]
        attr_accessor :background_color_suggested
        alias_method :background_color_suggested?, :background_color_suggested
      
        # Indicates if there was a suggested change to border_bottom.
        # Corresponds to the JSON property `borderBottomSuggested`
        # @return [Boolean]
        attr_accessor :border_bottom_suggested
        alias_method :border_bottom_suggested?, :border_bottom_suggested
      
        # Indicates if there was a suggested change to border_left.
        # Corresponds to the JSON property `borderLeftSuggested`
        # @return [Boolean]
        attr_accessor :border_left_suggested
        alias_method :border_left_suggested?, :border_left_suggested
      
        # Indicates if there was a suggested change to border_right.
        # Corresponds to the JSON property `borderRightSuggested`
        # @return [Boolean]
        attr_accessor :border_right_suggested
        alias_method :border_right_suggested?, :border_right_suggested
      
        # Indicates if there was a suggested change to border_top.
        # Corresponds to the JSON property `borderTopSuggested`
        # @return [Boolean]
        attr_accessor :border_top_suggested
        alias_method :border_top_suggested?, :border_top_suggested
      
        # Indicates if there was a suggested change to column_span.
        # Corresponds to the JSON property `columnSpanSuggested`
        # @return [Boolean]
        attr_accessor :column_span_suggested
        alias_method :column_span_suggested?, :column_span_suggested
      
        # Indicates if there was a suggested change to content_alignment.
        # Corresponds to the JSON property `contentAlignmentSuggested`
        # @return [Boolean]
        attr_accessor :content_alignment_suggested
        alias_method :content_alignment_suggested?, :content_alignment_suggested
      
        # Indicates if there was a suggested change to padding_bottom.
        # Corresponds to the JSON property `paddingBottomSuggested`
        # @return [Boolean]
        attr_accessor :padding_bottom_suggested
        alias_method :padding_bottom_suggested?, :padding_bottom_suggested
      
        # Indicates if there was a suggested change to padding_left.
        # Corresponds to the JSON property `paddingLeftSuggested`
        # @return [Boolean]
        attr_accessor :padding_left_suggested
        alias_method :padding_left_suggested?, :padding_left_suggested
      
        # Indicates if there was a suggested change to padding_right.
        # Corresponds to the JSON property `paddingRightSuggested`
        # @return [Boolean]
        attr_accessor :padding_right_suggested
        alias_method :padding_right_suggested?, :padding_right_suggested
      
        # Indicates if there was a suggested change to padding_top.
        # Corresponds to the JSON property `paddingTopSuggested`
        # @return [Boolean]
        attr_accessor :padding_top_suggested
        alias_method :padding_top_suggested?, :padding_top_suggested
      
        # Indicates if there was a suggested change to row_span.
        # Corresponds to the JSON property `rowSpanSuggested`
        # @return [Boolean]
        attr_accessor :row_span_suggested
        alias_method :row_span_suggested?, :row_span_suggested
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @background_color_suggested = args[:background_color_suggested] if args.key?(:background_color_suggested)
          @border_bottom_suggested = args[:border_bottom_suggested] if args.key?(:border_bottom_suggested)
          @border_left_suggested = args[:border_left_suggested] if args.key?(:border_left_suggested)
          @border_right_suggested = args[:border_right_suggested] if args.key?(:border_right_suggested)
          @border_top_suggested = args[:border_top_suggested] if args.key?(:border_top_suggested)
          @column_span_suggested = args[:column_span_suggested] if args.key?(:column_span_suggested)
          @content_alignment_suggested = args[:content_alignment_suggested] if args.key?(:content_alignment_suggested)
          @padding_bottom_suggested = args[:padding_bottom_suggested] if args.key?(:padding_bottom_suggested)
          @padding_left_suggested = args[:padding_left_suggested] if args.key?(:padding_left_suggested)
          @padding_right_suggested = args[:padding_right_suggested] if args.key?(:padding_right_suggested)
          @padding_top_suggested = args[:padding_top_suggested] if args.key?(:padding_top_suggested)
          @row_span_suggested = args[:row_span_suggested] if args.key?(:row_span_suggested)
        end
      end
      
      # The properties of a column in a table.
      class TableColumnProperties
        include Google::Apis::Core::Hashable
      
        # A magnitude in a single direction in the specified units.
        # Corresponds to the JSON property `width`
        # @return [Google::Apis::DocsV1::Dimension]
        attr_accessor :width
      
        # The width type of the column.
        # Corresponds to the JSON property `widthType`
        # @return [String]
        attr_accessor :width_type
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @width = args[:width] if args.key?(:width)
          @width_type = args[:width_type] if args.key?(:width_type)
        end
      end
      
      # A StructuralElement representing a table of contents.
      class TableOfContents
        include Google::Apis::Core::Hashable
      
        # The content of the table of contents.
        # Corresponds to the JSON property `content`
        # @return [Array<Google::Apis::DocsV1::StructuralElement>]
        attr_accessor :content
      
        # The suggested deletion IDs. If empty, then there are no suggested deletions of
        # this content.
        # Corresponds to the JSON property `suggestedDeletionIds`
        # @return [Array<String>]
        attr_accessor :suggested_deletion_ids
      
        # The suggested insertion IDs. A TableOfContents may have multiple insertion IDs
        # if it is a nested suggested change. If empty, then this is not a suggested
        # insertion.
        # Corresponds to the JSON property `suggestedInsertionIds`
        # @return [Array<String>]
        attr_accessor :suggested_insertion_ids
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @content = args[:content] if args.key?(:content)
          @suggested_deletion_ids = args[:suggested_deletion_ids] if args.key?(:suggested_deletion_ids)
          @suggested_insertion_ids = args[:suggested_insertion_ids] if args.key?(:suggested_insertion_ids)
        end
      end
      
      # A table range represents a reference to a subset of a table. It's important to
      # note that the cells specified by a table range do not necessarily form a
      # rectangle. For example, let's say we have a 3 x 3 table where all the cells of
      # the last row are merged together. The table looks like this: [ ] A table range
      # with table cell location = (table_start_location, row = 0, column = 0), row
      # span = 3 and column span = 2 specifies the following cells: x x [ x x x ]
      class TableRange
        include Google::Apis::Core::Hashable
      
        # The column span of the table range.
        # Corresponds to the JSON property `columnSpan`
        # @return [Fixnum]
        attr_accessor :column_span
      
        # The row span of the table range.
        # Corresponds to the JSON property `rowSpan`
        # @return [Fixnum]
        attr_accessor :row_span
      
        # Location of a single cell within a table.
        # Corresponds to the JSON property `tableCellLocation`
        # @return [Google::Apis::DocsV1::TableCellLocation]
        attr_accessor :table_cell_location
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @column_span = args[:column_span] if args.key?(:column_span)
          @row_span = args[:row_span] if args.key?(:row_span)
          @table_cell_location = args[:table_cell_location] if args.key?(:table_cell_location)
        end
      end
      
      # The contents and style of a row in a Table.
      class TableRow
        include Google::Apis::Core::Hashable
      
        # The zero-based end index of this row, exclusive, in UTF-16 code units.
        # Corresponds to the JSON property `endIndex`
        # @return [Fixnum]
        attr_accessor :end_index
      
        # The zero-based start index of this row, in UTF-16 code units.
        # Corresponds to the JSON property `startIndex`
        # @return [Fixnum]
        attr_accessor :start_index
      
        # The suggested deletion IDs. If empty, then there are no suggested deletions of
        # this content.
        # Corresponds to the JSON property `suggestedDeletionIds`
        # @return [Array<String>]
        attr_accessor :suggested_deletion_ids
      
        # The suggested insertion IDs. A TableRow may have multiple insertion IDs if it'
        # s a nested suggested change. If empty, then this is not a suggested insertion.
        # Corresponds to the JSON property `suggestedInsertionIds`
        # @return [Array<String>]
        attr_accessor :suggested_insertion_ids
      
        # The suggested style changes to this row, keyed by suggestion ID.
        # Corresponds to the JSON property `suggestedTableRowStyleChanges`
        # @return [Hash<String,Google::Apis::DocsV1::SuggestedTableRowStyle>]
        attr_accessor :suggested_table_row_style_changes
      
        # The contents and style of each cell in this row. It's possible for a table to
        # be non-rectangular, so some rows may have a different number of cells than
        # other rows in the same table.
        # Corresponds to the JSON property `tableCells`
        # @return [Array<Google::Apis::DocsV1::TableCell>]
        attr_accessor :table_cells
      
        # Styles that apply to a table row.
        # Corresponds to the JSON property `tableRowStyle`
        # @return [Google::Apis::DocsV1::TableRowStyle]
        attr_accessor :table_row_style
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @end_index = args[:end_index] if args.key?(:end_index)
          @start_index = args[:start_index] if args.key?(:start_index)
          @suggested_deletion_ids = args[:suggested_deletion_ids] if args.key?(:suggested_deletion_ids)
          @suggested_insertion_ids = args[:suggested_insertion_ids] if args.key?(:suggested_insertion_ids)
          @suggested_table_row_style_changes = args[:suggested_table_row_style_changes] if args.key?(:suggested_table_row_style_changes)
          @table_cells = args[:table_cells] if args.key?(:table_cells)
          @table_row_style = args[:table_row_style] if args.key?(:table_row_style)
        end
      end
      
      # Styles that apply to a table row.
      class TableRowStyle
        include Google::Apis::Core::Hashable
      
        # A magnitude in a single direction in the specified units.
        # Corresponds to the JSON property `minRowHeight`
        # @return [Google::Apis::DocsV1::Dimension]
        attr_accessor :min_row_height
      
        # Whether the row cannot overflow across page or column boundaries.
        # Corresponds to the JSON property `preventOverflow`
        # @return [Boolean]
        attr_accessor :prevent_overflow
        alias_method :prevent_overflow?, :prevent_overflow
      
        # Whether the row is a table header.
        # Corresponds to the JSON property `tableHeader`
        # @return [Boolean]
        attr_accessor :table_header
        alias_method :table_header?, :table_header
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @min_row_height = args[:min_row_height] if args.key?(:min_row_height)
          @prevent_overflow = args[:prevent_overflow] if args.key?(:prevent_overflow)
          @table_header = args[:table_header] if args.key?(:table_header)
        end
      end
      
      # A mask that indicates which of the fields on the base TableRowStyle have been
      # changed in this suggestion. For any field set to true, there's a new suggested
      # value.
      class TableRowStyleSuggestionState
        include Google::Apis::Core::Hashable
      
        # Indicates if there was a suggested change to min_row_height.
        # Corresponds to the JSON property `minRowHeightSuggested`
        # @return [Boolean]
        attr_accessor :min_row_height_suggested
        alias_method :min_row_height_suggested?, :min_row_height_suggested
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @min_row_height_suggested = args[:min_row_height_suggested] if args.key?(:min_row_height_suggested)
        end
      end
      
      # Styles that apply to a table.
      class TableStyle
        include Google::Apis::Core::Hashable
      
        # The properties of each column. Note that in Docs, tables contain rows and rows
        # contain cells, similar to HTML. So the properties for a row can be found on
        # the row's table_row_style.
        # Corresponds to the JSON property `tableColumnProperties`
        # @return [Array<Google::Apis::DocsV1::TableColumnProperties>]
        attr_accessor :table_column_properties
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @table_column_properties = args[:table_column_properties] if args.key?(:table_column_properties)
        end
      end
      
      # A criteria that specifies in which tabs a request executes.
      class TabsCriteria
        include Google::Apis::Core::Hashable
      
        # The list of tab IDs in which the request executes.
        # Corresponds to the JSON property `tabIds`
        # @return [Array<String>]
        attr_accessor :tab_ids
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @tab_ids = args[:tab_ids] if args.key?(:tab_ids)
        end
      end
      
      # A ParagraphElement that represents a run of text that all has the same styling.
      class TextRun
        include Google::Apis::Core::Hashable
      
        # The text of this run. Any non-text elements in the run are replaced with the
        # Unicode character U+E907.
        # Corresponds to the JSON property `content`
        # @return [String]
        attr_accessor :content
      
        # The suggested deletion IDs. If empty, then there are no suggested deletions of
        # this content.
        # Corresponds to the JSON property `suggestedDeletionIds`
        # @return [Array<String>]
        attr_accessor :suggested_deletion_ids
      
        # The suggested insertion IDs. A TextRun may have multiple insertion IDs if it's
        # a nested suggested change. If empty, then this is not a suggested insertion.
        # Corresponds to the JSON property `suggestedInsertionIds`
        # @return [Array<String>]
        attr_accessor :suggested_insertion_ids
      
        # The suggested text style changes to this run, keyed by suggestion ID.
        # Corresponds to the JSON property `suggestedTextStyleChanges`
        # @return [Hash<String,Google::Apis::DocsV1::SuggestedTextStyle>]
        attr_accessor :suggested_text_style_changes
      
        # Represents the styling that can be applied to text. Inherited text styles are
        # represented as unset fields in this message. A text style's parent depends on
        # where the text style is defined: * The TextStyle of text in a Paragraph
        # inherits from the paragraph's corresponding named style type. * The TextStyle
        # on a named style inherits from the normal text named style. * The TextStyle of
        # the normal text named style inherits from the default text style in the Docs
        # editor. * The TextStyle on a Paragraph element that's contained in a table may
        # inherit its text style from the table style. If the text style does not
        # inherit from a parent, unsetting fields will revert the style to a value
        # matching the defaults in the Docs editor.
        # Corresponds to the JSON property `textStyle`
        # @return [Google::Apis::DocsV1::TextStyle]
        attr_accessor :text_style
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @content = args[:content] if args.key?(:content)
          @suggested_deletion_ids = args[:suggested_deletion_ids] if args.key?(:suggested_deletion_ids)
          @suggested_insertion_ids = args[:suggested_insertion_ids] if args.key?(:suggested_insertion_ids)
          @suggested_text_style_changes = args[:suggested_text_style_changes] if args.key?(:suggested_text_style_changes)
          @text_style = args[:text_style] if args.key?(:text_style)
        end
      end
      
      # Represents the styling that can be applied to text. Inherited text styles are
      # represented as unset fields in this message. A text style's parent depends on
      # where the text style is defined: * The TextStyle of text in a Paragraph
      # inherits from the paragraph's corresponding named style type. * The TextStyle
      # on a named style inherits from the normal text named style. * The TextStyle of
      # the normal text named style inherits from the default text style in the Docs
      # editor. * The TextStyle on a Paragraph element that's contained in a table may
      # inherit its text style from the table style. If the text style does not
      # inherit from a parent, unsetting fields will revert the style to a value
      # matching the defaults in the Docs editor.
      class TextStyle
        include Google::Apis::Core::Hashable
      
        # A color that can either be fully opaque or fully transparent.
        # Corresponds to the JSON property `backgroundColor`
        # @return [Google::Apis::DocsV1::OptionalColor]
        attr_accessor :background_color
      
        # The text's vertical offset from its normal position. Text with `SUPERSCRIPT`
        # or `SUBSCRIPT` baseline offsets is automatically rendered in a smaller font
        # size, computed based on the `font_size` field. Changes in this field don't
        # affect the `font_size`.
        # Corresponds to the JSON property `baselineOffset`
        # @return [String]
        attr_accessor :baseline_offset
      
        # Whether or not the text is rendered as bold.
        # Corresponds to the JSON property `bold`
        # @return [Boolean]
        attr_accessor :bold
        alias_method :bold?, :bold
      
        # A magnitude in a single direction in the specified units.
        # Corresponds to the JSON property `fontSize`
        # @return [Google::Apis::DocsV1::Dimension]
        attr_accessor :font_size
      
        # A color that can either be fully opaque or fully transparent.
        # Corresponds to the JSON property `foregroundColor`
        # @return [Google::Apis::DocsV1::OptionalColor]
        attr_accessor :foreground_color
      
        # Whether or not the text is italicized.
        # Corresponds to the JSON property `italic`
        # @return [Boolean]
        attr_accessor :italic
        alias_method :italic?, :italic
      
        # A reference to another portion of a document or an external URL resource.
        # Corresponds to the JSON property `link`
        # @return [Google::Apis::DocsV1::Link]
        attr_accessor :link
      
        # Whether or not the text is in small capital letters.
        # Corresponds to the JSON property `smallCaps`
        # @return [Boolean]
        attr_accessor :small_caps
        alias_method :small_caps?, :small_caps
      
        # Whether or not the text is struck through.
        # Corresponds to the JSON property `strikethrough`
        # @return [Boolean]
        attr_accessor :strikethrough
        alias_method :strikethrough?, :strikethrough
      
        # Whether or not the text is underlined.
        # Corresponds to the JSON property `underline`
        # @return [Boolean]
        attr_accessor :underline
        alias_method :underline?, :underline
      
        # Represents a font family and weight of text.
        # Corresponds to the JSON property `weightedFontFamily`
        # @return [Google::Apis::DocsV1::WeightedFontFamily]
        attr_accessor :weighted_font_family
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @background_color = args[:background_color] if args.key?(:background_color)
          @baseline_offset = args[:baseline_offset] if args.key?(:baseline_offset)
          @bold = args[:bold] if args.key?(:bold)
          @font_size = args[:font_size] if args.key?(:font_size)
          @foreground_color = args[:foreground_color] if args.key?(:foreground_color)
          @italic = args[:italic] if args.key?(:italic)
          @link = args[:link] if args.key?(:link)
          @small_caps = args[:small_caps] if args.key?(:small_caps)
          @strikethrough = args[:strikethrough] if args.key?(:strikethrough)
          @underline = args[:underline] if args.key?(:underline)
          @weighted_font_family = args[:weighted_font_family] if args.key?(:weighted_font_family)
        end
      end
      
      # A mask that indicates which of the fields on the base TextStyle have been
      # changed in this suggestion. For any field set to true, there's a new suggested
      # value.
      class TextStyleSuggestionState
        include Google::Apis::Core::Hashable
      
        # Indicates if there was a suggested change to background_color.
        # Corresponds to the JSON property `backgroundColorSuggested`
        # @return [Boolean]
        attr_accessor :background_color_suggested
        alias_method :background_color_suggested?, :background_color_suggested
      
        # Indicates if there was a suggested change to baseline_offset.
        # Corresponds to the JSON property `baselineOffsetSuggested`
        # @return [Boolean]
        attr_accessor :baseline_offset_suggested
        alias_method :baseline_offset_suggested?, :baseline_offset_suggested
      
        # Indicates if there was a suggested change to bold.
        # Corresponds to the JSON property `boldSuggested`
        # @return [Boolean]
        attr_accessor :bold_suggested
        alias_method :bold_suggested?, :bold_suggested
      
        # Indicates if there was a suggested change to font_size.
        # Corresponds to the JSON property `fontSizeSuggested`
        # @return [Boolean]
        attr_accessor :font_size_suggested
        alias_method :font_size_suggested?, :font_size_suggested
      
        # Indicates if there was a suggested change to foreground_color.
        # Corresponds to the JSON property `foregroundColorSuggested`
        # @return [Boolean]
        attr_accessor :foreground_color_suggested
        alias_method :foreground_color_suggested?, :foreground_color_suggested
      
        # Indicates if there was a suggested change to italic.
        # Corresponds to the JSON property `italicSuggested`
        # @return [Boolean]
        attr_accessor :italic_suggested
        alias_method :italic_suggested?, :italic_suggested
      
        # Indicates if there was a suggested change to link.
        # Corresponds to the JSON property `linkSuggested`
        # @return [Boolean]
        attr_accessor :link_suggested
        alias_method :link_suggested?, :link_suggested
      
        # Indicates if there was a suggested change to small_caps.
        # Corresponds to the JSON property `smallCapsSuggested`
        # @return [Boolean]
        attr_accessor :small_caps_suggested
        alias_method :small_caps_suggested?, :small_caps_suggested
      
        # Indicates if there was a suggested change to strikethrough.
        # Corresponds to the JSON property `strikethroughSuggested`
        # @return [Boolean]
        attr_accessor :strikethrough_suggested
        alias_method :strikethrough_suggested?, :strikethrough_suggested
      
        # Indicates if there was a suggested change to underline.
        # Corresponds to the JSON property `underlineSuggested`
        # @return [Boolean]
        attr_accessor :underline_suggested
        alias_method :underline_suggested?, :underline_suggested
      
        # Indicates if there was a suggested change to weighted_font_family.
        # Corresponds to the JSON property `weightedFontFamilySuggested`
        # @return [Boolean]
        attr_accessor :weighted_font_family_suggested
        alias_method :weighted_font_family_suggested?, :weighted_font_family_suggested
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @background_color_suggested = args[:background_color_suggested] if args.key?(:background_color_suggested)
          @baseline_offset_suggested = args[:baseline_offset_suggested] if args.key?(:baseline_offset_suggested)
          @bold_suggested = args[:bold_suggested] if args.key?(:bold_suggested)
          @font_size_suggested = args[:font_size_suggested] if args.key?(:font_size_suggested)
          @foreground_color_suggested = args[:foreground_color_suggested] if args.key?(:foreground_color_suggested)
          @italic_suggested = args[:italic_suggested] if args.key?(:italic_suggested)
          @link_suggested = args[:link_suggested] if args.key?(:link_suggested)
          @small_caps_suggested = args[:small_caps_suggested] if args.key?(:small_caps_suggested)
          @strikethrough_suggested = args[:strikethrough_suggested] if args.key?(:strikethrough_suggested)
          @underline_suggested = args[:underline_suggested] if args.key?(:underline_suggested)
          @weighted_font_family_suggested = args[:weighted_font_family_suggested] if args.key?(:weighted_font_family_suggested)
        end
      end
      
      # Unmerges cells in a Table.
      class UnmergeTableCellsRequest
        include Google::Apis::Core::Hashable
      
        # A table range represents a reference to a subset of a table. It's important to
        # note that the cells specified by a table range do not necessarily form a
        # rectangle. For example, let's say we have a 3 x 3 table where all the cells of
        # the last row are merged together. The table looks like this: [ ] A table range
        # with table cell location = (table_start_location, row = 0, column = 0), row
        # span = 3 and column span = 2 specifies the following cells: x x [ x x x ]
        # Corresponds to the JSON property `tableRange`
        # @return [Google::Apis::DocsV1::TableRange]
        attr_accessor :table_range
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @table_range = args[:table_range] if args.key?(:table_range)
        end
      end
      
      # Updates the DocumentStyle.
      class UpdateDocumentStyleRequest
        include Google::Apis::Core::Hashable
      
        # The style of the document.
        # Corresponds to the JSON property `documentStyle`
        # @return [Google::Apis::DocsV1::DocumentStyle]
        attr_accessor :document_style
      
        # The fields that should be updated. At least one field must be specified. The
        # root `document_style` is implied and should not be specified. A single `"*"`
        # can be used as short-hand for listing every field. For example to update the
        # background, set `fields` to `"background"`.
        # Corresponds to the JSON property `fields`
        # @return [String]
        attr_accessor :fields
      
        # The tab that contains the style to update. When omitted, the request applies
        # to the first tab. In a document containing a single tab: - If provided, must
        # match the singular tab's ID. - If omitted, the request applies to the singular
        # tab. In a document containing multiple tabs: - If provided, the request
        # applies to the specified tab. - If not provided, the request applies to the
        # first tab in the document.
        # Corresponds to the JSON property `tabId`
        # @return [String]
        attr_accessor :tab_id
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @document_style = args[:document_style] if args.key?(:document_style)
          @fields = args[:fields] if args.key?(:fields)
          @tab_id = args[:tab_id] if args.key?(:tab_id)
        end
      end
      
      # Update the styling of all paragraphs that overlap with the given range.
      class UpdateParagraphStyleRequest
        include Google::Apis::Core::Hashable
      
        # The fields that should be updated. At least one field must be specified. The
        # root `paragraph_style` is implied and should not be specified. A single `"*"`
        # can be used as short-hand for listing every field. For example, to update the
        # paragraph style's alignment property, set `fields` to `"alignment"`. To reset
        # a property to its default value, include its field name in the field mask but
        # leave the field itself unset.
        # Corresponds to the JSON property `fields`
        # @return [String]
        attr_accessor :fields
      
        # Styles that apply to a whole paragraph. Inherited paragraph styles are
        # represented as unset fields in this message. A paragraph style's parent
        # depends on where the paragraph style is defined: * The ParagraphStyle on a
        # Paragraph inherits from the paragraph's corresponding named style type. * The
        # ParagraphStyle on a named style inherits from the normal text named style. *
        # The ParagraphStyle of the normal text named style inherits from the default
        # paragraph style in the Docs editor. * The ParagraphStyle on a Paragraph
        # element that's contained in a table may inherit its paragraph style from the
        # table style. If the paragraph style does not inherit from a parent, unsetting
        # fields will revert the style to a value matching the defaults in the Docs
        # editor.
        # Corresponds to the JSON property `paragraphStyle`
        # @return [Google::Apis::DocsV1::ParagraphStyle]
        attr_accessor :paragraph_style
      
        # Specifies a contiguous range of text.
        # Corresponds to the JSON property `range`
        # @return [Google::Apis::DocsV1::Range]
        attr_accessor :range
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @fields = args[:fields] if args.key?(:fields)
          @paragraph_style = args[:paragraph_style] if args.key?(:paragraph_style)
          @range = args[:range] if args.key?(:range)
        end
      end
      
      # Updates the SectionStyle.
      class UpdateSectionStyleRequest
        include Google::Apis::Core::Hashable
      
        # The fields that should be updated. At least one field must be specified. The
        # root `section_style` is implied and must not be specified. A single `"*"` can
        # be used as short-hand for listing every field. For example to update the left
        # margin, set `fields` to `"margin_left"`.
        # Corresponds to the JSON property `fields`
        # @return [String]
        attr_accessor :fields
      
        # Specifies a contiguous range of text.
        # Corresponds to the JSON property `range`
        # @return [Google::Apis::DocsV1::Range]
        attr_accessor :range
      
        # The styling that applies to a section.
        # Corresponds to the JSON property `sectionStyle`
        # @return [Google::Apis::DocsV1::SectionStyle]
        attr_accessor :section_style
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @fields = args[:fields] if args.key?(:fields)
          @range = args[:range] if args.key?(:range)
          @section_style = args[:section_style] if args.key?(:section_style)
        end
      end
      
      # Updates the style of a range of table cells.
      class UpdateTableCellStyleRequest
        include Google::Apis::Core::Hashable
      
        # The fields that should be updated. At least one field must be specified. The
        # root `tableCellStyle` is implied and should not be specified. A single `"*"`
        # can be used as short-hand for listing every field. For example to update the
        # table cell background color, set `fields` to `"backgroundColor"`. To reset a
        # property to its default value, include its field name in the field mask but
        # leave the field itself unset.
        # Corresponds to the JSON property `fields`
        # @return [String]
        attr_accessor :fields
      
        # The style of a TableCell. Inherited table cell styles are represented as unset
        # fields in this message. A table cell style can inherit from the table's style.
        # Corresponds to the JSON property `tableCellStyle`
        # @return [Google::Apis::DocsV1::TableCellStyle]
        attr_accessor :table_cell_style
      
        # A table range represents a reference to a subset of a table. It's important to
        # note that the cells specified by a table range do not necessarily form a
        # rectangle. For example, let's say we have a 3 x 3 table where all the cells of
        # the last row are merged together. The table looks like this: [ ] A table range
        # with table cell location = (table_start_location, row = 0, column = 0), row
        # span = 3 and column span = 2 specifies the following cells: x x [ x x x ]
        # Corresponds to the JSON property `tableRange`
        # @return [Google::Apis::DocsV1::TableRange]
        attr_accessor :table_range
      
        # A particular location in the document.
        # Corresponds to the JSON property `tableStartLocation`
        # @return [Google::Apis::DocsV1::Location]
        attr_accessor :table_start_location
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @fields = args[:fields] if args.key?(:fields)
          @table_cell_style = args[:table_cell_style] if args.key?(:table_cell_style)
          @table_range = args[:table_range] if args.key?(:table_range)
          @table_start_location = args[:table_start_location] if args.key?(:table_start_location)
        end
      end
      
      # Updates the TableColumnProperties of columns in a table.
      class UpdateTableColumnPropertiesRequest
        include Google::Apis::Core::Hashable
      
        # The list of zero-based column indices whose property should be updated. If no
        # indices are specified, all columns will be updated.
        # Corresponds to the JSON property `columnIndices`
        # @return [Array<Fixnum>]
        attr_accessor :column_indices
      
        # The fields that should be updated. At least one field must be specified. The
        # root `tableColumnProperties` is implied and should not be specified. A single `
        # "*"` can be used as short-hand for listing every field. For example to update
        # the column width, set `fields` to `"width"`.
        # Corresponds to the JSON property `fields`
        # @return [String]
        attr_accessor :fields
      
        # The properties of a column in a table.
        # Corresponds to the JSON property `tableColumnProperties`
        # @return [Google::Apis::DocsV1::TableColumnProperties]
        attr_accessor :table_column_properties
      
        # A particular location in the document.
        # Corresponds to the JSON property `tableStartLocation`
        # @return [Google::Apis::DocsV1::Location]
        attr_accessor :table_start_location
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @column_indices = args[:column_indices] if args.key?(:column_indices)
          @fields = args[:fields] if args.key?(:fields)
          @table_column_properties = args[:table_column_properties] if args.key?(:table_column_properties)
          @table_start_location = args[:table_start_location] if args.key?(:table_start_location)
        end
      end
      
      # Updates the TableRowStyle of rows in a table.
      class UpdateTableRowStyleRequest
        include Google::Apis::Core::Hashable
      
        # The fields that should be updated. At least one field must be specified. The
        # root `tableRowStyle` is implied and should not be specified. A single `"*"`
        # can be used as short-hand for listing every field. For example to update the
        # minimum row height, set `fields` to `"min_row_height"`.
        # Corresponds to the JSON property `fields`
        # @return [String]
        attr_accessor :fields
      
        # The list of zero-based row indices whose style should be updated. If no
        # indices are specified, all rows will be updated.
        # Corresponds to the JSON property `rowIndices`
        # @return [Array<Fixnum>]
        attr_accessor :row_indices
      
        # Styles that apply to a table row.
        # Corresponds to the JSON property `tableRowStyle`
        # @return [Google::Apis::DocsV1::TableRowStyle]
        attr_accessor :table_row_style
      
        # A particular location in the document.
        # Corresponds to the JSON property `tableStartLocation`
        # @return [Google::Apis::DocsV1::Location]
        attr_accessor :table_start_location
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @fields = args[:fields] if args.key?(:fields)
          @row_indices = args[:row_indices] if args.key?(:row_indices)
          @table_row_style = args[:table_row_style] if args.key?(:table_row_style)
          @table_start_location = args[:table_start_location] if args.key?(:table_start_location)
        end
      end
      
      # Update the styling of text.
      class UpdateTextStyleRequest
        include Google::Apis::Core::Hashable
      
        # The fields that should be updated. At least one field must be specified. The
        # root `text_style` is implied and should not be specified. A single `"*"` can
        # be used as short-hand for listing every field. For example, to update the text
        # style to bold, set `fields` to `"bold"`. To reset a property to its default
        # value, include its field name in the field mask but leave the field itself
        # unset.
        # Corresponds to the JSON property `fields`
        # @return [String]
        attr_accessor :fields
      
        # Specifies a contiguous range of text.
        # Corresponds to the JSON property `range`
        # @return [Google::Apis::DocsV1::Range]
        attr_accessor :range
      
        # Represents the styling that can be applied to text. Inherited text styles are
        # represented as unset fields in this message. A text style's parent depends on
        # where the text style is defined: * The TextStyle of text in a Paragraph
        # inherits from the paragraph's corresponding named style type. * The TextStyle
        # on a named style inherits from the normal text named style. * The TextStyle of
        # the normal text named style inherits from the default text style in the Docs
        # editor. * The TextStyle on a Paragraph element that's contained in a table may
        # inherit its text style from the table style. If the text style does not
        # inherit from a parent, unsetting fields will revert the style to a value
        # matching the defaults in the Docs editor.
        # Corresponds to the JSON property `textStyle`
        # @return [Google::Apis::DocsV1::TextStyle]
        attr_accessor :text_style
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @fields = args[:fields] if args.key?(:fields)
          @range = args[:range] if args.key?(:range)
          @text_style = args[:text_style] if args.key?(:text_style)
        end
      end
      
      # Represents a font family and weight of text.
      class WeightedFontFamily
        include Google::Apis::Core::Hashable
      
        # The font family of the text. The font family can be any font from the Font
        # menu in Docs or from [Google Fonts] (https://fonts.google.com/). If the font
        # name is unrecognized, the text is rendered in `Arial`.
        # Corresponds to the JSON property `fontFamily`
        # @return [String]
        attr_accessor :font_family
      
        # The weight of the font. This field can have any value that's a multiple of `
        # 100` between `100` and `900`, inclusive. This range corresponds to the
        # numerical values described in the CSS 2.1 Specification, [section 15.6](https:/
        # /www.w3.org/TR/CSS21/fonts.html#font-boldness), with non-numerical values
        # disallowed. The default value is `400` ("normal"). The font weight makes up
        # just one component of the rendered font weight. A combination of the `weight`
        # and the text style's resolved `bold` value determine the rendered weight,
        # after accounting for inheritance: * If the text is bold and the weight is less
        # than `400`, the rendered weight is 400. * If the text is bold and the weight
        # is greater than or equal to `400` but is less than `700`, the rendered weight
        # is `700`. * If the weight is greater than or equal to `700`, the rendered
        # weight is equal to the weight. * If the text is not bold, the rendered weight
        # is equal to the weight.
        # Corresponds to the JSON property `weight`
        # @return [Fixnum]
        attr_accessor :weight
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @font_family = args[:font_family] if args.key?(:font_family)
          @weight = args[:weight] if args.key?(:weight)
        end
      end
      
      # Provides control over how write requests are executed.
      class WriteControl
        include Google::Apis::Core::Hashable
      
        # The optional revision ID of the document the write request is applied to. If
        # this is not the latest revision of the document, the request is not processed
        # and returns a 400 bad request error. When a required revision ID is returned
        # in a response, it indicates the revision ID of the document after the request
        # was applied.
        # Corresponds to the JSON property `requiredRevisionId`
        # @return [String]
        attr_accessor :required_revision_id
      
        # The optional target revision ID of the document the write request is applied
        # to. If collaborator changes have occurred after the document was read using
        # the API, the changes produced by this write request are applied against the
        # collaborator changes. This results in a new revision of the document that
        # incorporates both the collaborator changes and the changes in the request,
        # with the Docs server resolving conflicting changes. When using target revision
        # ID, the API client can be thought of as another collaborator of the document.
        # The target revision ID can only be used to write to recent versions of a
        # document. If the target revision is too far behind the latest revision, the
        # request is not processed and returns a 400 bad request error. The request
        # should be tried again after retrieving the latest version of the document.
        # Usually a revision ID remains valid for use as a target revision for several
        # minutes after it's read, but for frequently edited documents this window might
        # be shorter.
        # Corresponds to the JSON property `targetRevisionId`
        # @return [String]
        attr_accessor :target_revision_id
      
        def initialize(**args)
           update!(**args)
        end
      
        # Update properties of this object
        def update!(**args)
          @required_revision_id = args[:required_revision_id] if args.key?(:required_revision_id)
          @target_revision_id = args[:target_revision_id] if args.key?(:target_revision_id)
        end
      end
    end
  end
end
