google-apis-docs_v1 0.47.0 → 0.49.0

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

@@ -22,6 +22,81 @@ module Google
   module Apis
     module DocsV1
       
+      # Accepts a suggestion. Returns a 403 forbidden error if the requesting user
+      # does not have edit access to the document. [Developer Preview](https://
+      # developers.google.com/workspace/preview).
+      class AcceptSuggestionRequest
+        include Google::Apis::Core::Hashable
+      
+        # The ID of the suggestion.
+        # Corresponds to the JSON property `suggestionId`
+        # @return [String]
+        attr_accessor :suggestion_id
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @suggestion_id = args[:suggestion_id] if args.key?(:suggestion_id)
+        end
+      end
+      
+      # Inserts a reply Post into a CommentThread or SuggestionThread. [Developer
+      # Preview](https://developers.google.com/workspace/preview).
+      class AddCommentReplyRequest
+        include Google::Apis::Core::Hashable
+      
+        # The ID of the CommentThread to add the reply to.
+        # Corresponds to the JSON property `commentId`
+        # @return [String]
+        attr_accessor :comment_id
+      
+        # Represents a single post in a comment or suggestion thread. [Developer Preview]
+        # (https://developers.google.com/workspace/preview).
+        # Corresponds to the JSON property `post`
+        # @return [Google::Apis::DocsV1::Post]
+        attr_accessor :post
+      
+        # The ID of the SuggestionThread to add the reply to.
+        # Corresponds to the JSON property `suggestionId`
+        # @return [String]
+        attr_accessor :suggestion_id
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @comment_id = args[:comment_id] if args.key?(:comment_id)
+          @post = args[:post] if args.key?(:post)
+          @suggestion_id = args[:suggestion_id] if args.key?(:suggestion_id)
+        end
+      end
+      
+      # Response message for adding a reply. [Developer Preview](https://developers.
+      # google.com/workspace/preview).
+      class AddCommentReplyResponse
+        include Google::Apis::Core::Hashable
+      
+        # Represents a single post in a comment or suggestion thread. [Developer Preview]
+        # (https://developers.google.com/workspace/preview).
+        # Corresponds to the JSON property `post`
+        # @return [Google::Apis::DocsV1::Post]
+        attr_accessor :post
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @post = args[:post] if args.key?(:post)
+        end
+      end
+      
       # Adds a document tab. When a tab is added at a given index, all subsequent tabs'
       # indexes are incremented.
       class AddDocumentTabRequest
@@ -187,6 +262,12 @@ module Google
       class BatchUpdateDocumentResponse
         include Google::Apis::Core::Hashable
       
+        # Whether comment updates were applied in the batch request. [Developer Preview](
+        # https://developers.google.com/workspace/preview).
+        # Corresponds to the JSON property `commentUpdateState`
+        # @return [String]
+        attr_accessor :comment_update_state
+      
         # The ID of the document to which the updates were applied to.
         # Corresponds to the JSON property `documentId`
         # @return [String]
@@ -198,6 +279,12 @@ module Google
         # @return [Array<Google::Apis::DocsV1::Response>]
         attr_accessor :replies
       
+        # The suggestions which were affected by each update. This maps 1:1 with the
+        # updates. [Developer Preview](https://developers.google.com/workspace/preview).
+        # Corresponds to the JSON property `suggestionResponses`
+        # @return [Array<Google::Apis::DocsV1::SuggestionResponse>]
+        attr_accessor :suggestion_responses
+      
         # Provides control over how write requests are executed.
         # Corresponds to the JSON property `writeControl`
         # @return [Google::Apis::DocsV1::WriteControl]
@@ -209,8 +296,10 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @comment_update_state = args[:comment_update_state] if args.key?(:comment_update_state)
           @document_id = args[:document_id] if args.key?(:document_id)
           @replies = args[:replies] if args.key?(:replies)
+          @suggestion_responses = args[:suggestion_responses] if args.key?(:suggestion_responses)
           @write_control = args[:write_control] if args.key?(:write_control)
         end
       end
@@ -405,6 +494,135 @@ module Google
         end
       end
       
+      # One or more locations in the document that are tied to CommentThreads with the
+      # same anchorId. Note: Multiple anchors may refer to the same location. [
+      # Developer Preview](https://developers.google.com/workspace/preview).
+      class CommentAnchor
+        include Google::Apis::Core::Hashable
+      
+        # The ID of the comment anchor.
+        # Corresponds to the JSON property `anchorId`
+        # @return [String]
+        attr_accessor :anchor_id
+      
+        # A collection of Ranges in the document which are tied to this anchor.
+        # 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)
+          @anchor_id = args[:anchor_id] if args.key?(:anchor_id)
+          @ranges = args[:ranges] if args.key?(:ranges)
+        end
+      end
+      
+      # Represents a single comment thread. [Developer Preview](https://developers.
+      # google.com/workspace/preview).
+      class CommentThread
+        include Google::Apis::Core::Hashable
+      
+        # The ID of the CommentAnchor in the document that this thread is tied to.
+        # Multiple comment threads may be anchored to the same CommentAnchor.
+        # Corresponds to the JSON property `anchorId`
+        # @return [String]
+        attr_accessor :anchor_id
+      
+        # The unique ID of the comment thread.
+        # Corresponds to the JSON property `commentId`
+        # @return [String]
+        attr_accessor :comment_id
+      
+        # Represents a single post in a comment or suggestion thread. [Developer Preview]
+        # (https://developers.google.com/workspace/preview).
+        # Corresponds to the JSON property `headPost`
+        # @return [Google::Apis::DocsV1::Post]
+        attr_accessor :head_post
+      
+        # The quoted text from the document when the comment was created, formatted as
+        # plain-text.
+        # Corresponds to the JSON property `plainTextQuote`
+        # @return [String]
+        attr_accessor :plain_text_quote
+      
+        # Replies to the head post.
+        # Corresponds to the JSON property `replies`
+        # @return [Array<Google::Apis::DocsV1::Post>]
+        attr_accessor :replies
+      
+        # Whether the thread is open or resolved.
+        # Corresponds to the JSON property `status`
+        # @return [String]
+        attr_accessor :status
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @anchor_id = args[:anchor_id] if args.key?(:anchor_id)
+          @comment_id = args[:comment_id] if args.key?(:comment_id)
+          @head_post = args[:head_post] if args.key?(:head_post)
+          @plain_text_quote = args[:plain_text_quote] if args.key?(:plain_text_quote)
+          @replies = args[:replies] if args.key?(:replies)
+          @status = args[:status] if args.key?(:status)
+        end
+      end
+      
+      # Creates a new DropdownDefinition in the document.
+      class CreateDropdownDefinitionRequest
+        include Google::Apis::Core::Hashable
+      
+        # A dropdown definition in the document.
+        # Corresponds to the JSON property `dropdownDefinition`
+        # @return [Google::Apis::DocsV1::DropdownDefinition]
+        attr_accessor :dropdown_definition
+      
+        # The ID of the tab to create the dropdown definition 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)
+          @dropdown_definition = args[:dropdown_definition] if args.key?(:dropdown_definition)
+          @tab_id = args[:tab_id] if args.key?(:tab_id)
+        end
+      end
+      
+      # Response message for creating a dropdown definition.
+      class CreateDropdownDefinitionResponse
+        include Google::Apis::Core::Hashable
+      
+        # A dropdown definition in the document.
+        # Corresponds to the JSON property `dropdownDefinition`
+        # @return [Google::Apis::DocsV1::DropdownDefinition]
+        attr_accessor :dropdown_definition
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @dropdown_definition = args[:dropdown_definition] if args.key?(:dropdown_definition)
+        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
@@ -921,6 +1139,61 @@ module Google
         end
       end
       
+      # Deletes a reply Post from a CommentThread or SuggestionThread. Returns a 400
+      # bad request error if: - The requesting user is not the author of the post. -
+      # The reply post contains an action. - The reply post contains an assignee. [
+      # Developer Preview](https://developers.google.com/workspace/preview).
+      class DeleteCommentReplyRequest
+        include Google::Apis::Core::Hashable
+      
+        # The ID of the CommentThread which the post belongs to.
+        # Corresponds to the JSON property `commentId`
+        # @return [String]
+        attr_accessor :comment_id
+      
+        # The ID of the reply Post being deleted.
+        # Corresponds to the JSON property `postId`
+        # @return [String]
+        attr_accessor :post_id
+      
+        # The ID of the SuggestionThread which the post belongs to.
+        # Corresponds to the JSON property `suggestionId`
+        # @return [String]
+        attr_accessor :suggestion_id
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @comment_id = args[:comment_id] if args.key?(:comment_id)
+          @post_id = args[:post_id] if args.key?(:post_id)
+          @suggestion_id = args[:suggestion_id] if args.key?(:suggestion_id)
+        end
+      end
+      
+      # Deletes a CommentThread. Returns a 400 bad request error if the requesting
+      # user is not the author of the headPost. [Developer Preview](https://developers.
+      # google.com/workspace/preview).
+      class DeleteCommentRequest
+        include Google::Apis::Core::Hashable
+      
+        # The ID of the CommentThread that is being deleted.
+        # Corresponds to the JSON property `commentId`
+        # @return [String]
+        attr_accessor :comment_id
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @comment_id = args[:comment_id] if args.key?(:comment_id)
+        end
+      end
+      
       # Deletes content from the document.
       class DeleteContentRangeRequest
         include Google::Apis::Core::Hashable
@@ -940,6 +1213,38 @@ module Google
         end
       end
       
+      # Deletes a DropdownDefinition. If the dropdown definition is referenced by any
+      # dropdown instances (chips) in the document, a 400 bad request error is
+      # returned.
+      class DeleteDropdownDefinitionRequest
+        include Google::Apis::Core::Hashable
+      
+        # The ID of the DropdownDefinition to delete.
+        # Corresponds to the JSON property `dropdownDefinitionId`
+        # @return [String]
+        attr_accessor :dropdown_definition_id
+      
+        # The ID of the tab that contains the dropdown definition 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)
+          @dropdown_definition_id = args[:dropdown_definition_id] if args.key?(:dropdown_definition_id)
+          @tab_id = args[:tab_id] if args.key?(:tab_id)
+        end
+      end
+      
       # Deletes a Footer from the document.
       class DeleteFooterRequest
         include Google::Apis::Core::Hashable
@@ -1091,6 +1396,27 @@ module Google
         end
       end
       
+      # Deletes a suggestion. Returns a 403 forbidden error if the requesting user is
+      # not the author of the suggestion. [Developer Preview](https://developers.
+      # google.com/workspace/preview).
+      class DeleteSuggestionRequest
+        include Google::Apis::Core::Hashable
+      
+        # The ID of the suggestion.
+        # Corresponds to the JSON property `suggestionId`
+        # @return [String]
+        attr_accessor :suggestion_id
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @suggestion_id = args[:suggestion_id] if args.key?(:suggestion_id)
+        end
+      end
+      
       # Deletes a tab. If the tab has child tabs, they are deleted as well.
       class DeleteTabRequest
         include Google::Apis::Core::Hashable
@@ -1183,6 +1509,20 @@ module Google
         # @return [Google::Apis::DocsV1::Body]
         attr_accessor :body
       
+        # Output only. The comments associated with the document. Only populated if the
+        # commentsViewMode parameter is set to require comments (such as `
+        # COMMENTS_VIEW_MODE_INCLUDED`). [Developer Preview](https://developers.google.
+        # com/workspace/preview).
+        # Corresponds to the JSON property `comments`
+        # @return [Array<Google::Apis::DocsV1::CommentThread>]
+        attr_accessor :comments
+      
+        # Output only. The comments view mode applied to the document. [Developer
+        # Preview](https://developers.google.com/workspace/preview).
+        # Corresponds to the JSON property `commentsViewMode`
+        # @return [String]
+        attr_accessor :comments_view_mode
+      
         # Output only. The ID of the document.
         # Corresponds to the JSON property `documentId`
         # @return [String]
@@ -1295,6 +1635,14 @@ module Google
         # @return [Hash<String,Google::Apis::DocsV1::SuggestedNamedStyles>]
         attr_accessor :suggested_named_styles_changes
       
+        # Output only. The suggestions associated with the document. Only populated if
+        # the commentsViewMode parameter is set to require comments (such as `
+        # COMMENTS_VIEW_MODE_INCLUDED`). [Developer Preview](https://developers.google.
+        # com/workspace/preview).
+        # Corresponds to the JSON property `suggestions`
+        # @return [Array<Google::Apis::DocsV1::SuggestionThread>]
+        attr_accessor :suggestions
+      
         # 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.
@@ -1321,6 +1669,8 @@ module Google
         # Update properties of this object
         def update!(**args)
           @body = args[:body] if args.key?(:body)
+          @comments = args[:comments] if args.key?(:comments)
+          @comments_view_mode = args[:comments_view_mode] if args.key?(:comments_view_mode)
           @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)
@@ -1334,6 +1684,7 @@ module Google
           @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 = args[:suggestions] if args.key?(:suggestions)
           @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)
@@ -1687,11 +2038,24 @@ module Google
         # @return [Google::Apis::DocsV1::Body]
         attr_accessor :body
       
+        # The comment anchors in a document tab, keyed by anchor ID. Only populated if
+        # the commentsViewMode parameter is set to require comments (such as `
+        # COMMENTS_VIEW_MODE_INCLUDED`). [Developer Preview](https://developers.google.
+        # com/workspace/preview).
+        # Corresponds to the JSON property `commentAnchors`
+        # @return [Hash<String,Google::Apis::DocsV1::CommentAnchor>]
+        attr_accessor :comment_anchors
+      
         # The style of the document.
         # Corresponds to the JSON property `documentStyle`
         # @return [Google::Apis::DocsV1::DocumentStyle]
         attr_accessor :document_style
       
+        # The dropdown definitions in a document tab, keyed by dropdown definition ID.
+        # Corresponds to the JSON property `dropdownDefinitions`
+        # @return [Hash<String,Google::Apis::DocsV1::DropdownDefinition>]
+        attr_accessor :dropdown_definitions
+      
         # The footers in the document tab, keyed by footer ID.
         # Corresponds to the JSON property `footers`
         # @return [Hash<String,Google::Apis::DocsV1::Footer>]
@@ -1751,7 +2115,9 @@ module Google
         # Update properties of this object
         def update!(**args)
           @body = args[:body] if args.key?(:body)
+          @comment_anchors = args[:comment_anchors] if args.key?(:comment_anchors)
           @document_style = args[:document_style] if args.key?(:document_style)
+          @dropdown_definitions = args[:dropdown_definitions] if args.key?(:dropdown_definitions)
           @footers = args[:footers] if args.key?(:footers)
           @footnotes = args[:footnotes] if args.key?(:footnotes)
           @headers = args[:headers] if args.key?(:headers)
@@ -1765,6 +2131,273 @@ module Google
         end
       end
       
+      # A dropdown in the document. The chip is displayed as a dropdown menu that
+      # allows users to select an option from a configurable list of options.
+      class Dropdown
+        include Google::Apis::Core::Hashable
+      
+        # The ID of this dropdown.
+        # Corresponds to the JSON property `dropdownId`
+        # @return [String]
+        attr_accessor :dropdown_id
+      
+        # Properties specific to a dropdown.
+        # Corresponds to the JSON property `dropdownProperties`
+        # @return [Google::Apis::DocsV1::DropdownProperties]
+        attr_accessor :dropdown_properties
+      
+        # IDs for suggestions that remove this dropdown from the document. If empty,
+        # then this dropdown isn't suggested for deletion.
+        # Corresponds to the JSON property `suggestedDeletionIds`
+        # @return [Array<String>]
+        attr_accessor :suggested_deletion_ids
+      
+        # The suggested properties changes to this dropdown, keyed by suggestion ID.
+        # Corresponds to the JSON property `suggestedDropdownPropertiesChanges`
+        # @return [Hash<String,Google::Apis::DocsV1::SuggestedDropdownProperties>]
+        attr_accessor :suggested_dropdown_properties_changes
+      
+        # IDs for suggestions that insert this dropdown into the document. If empty,
+        # then this dropdown 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 dropdown, 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)
+          @dropdown_id = args[:dropdown_id] if args.key?(:dropdown_id)
+          @dropdown_properties = args[:dropdown_properties] if args.key?(:dropdown_properties)
+          @suggested_deletion_ids = args[:suggested_deletion_ids] if args.key?(:suggested_deletion_ids)
+          @suggested_dropdown_properties_changes = args[:suggested_dropdown_properties_changes] if args.key?(:suggested_dropdown_properties_changes)
+          @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 dropdown definition in the document.
+      class DropdownDefinition
+        include Google::Apis::Core::Hashable
+      
+        # The ID of this dropdown definition. If you specify an ID, it must be unique
+        # among all IDs in the tab. The ID must start with `kix.` and match regex `^kix\.
+        # [a-zA-Z0-9_-]`2,14`$` (length 6-18 chars). If you don't specify an ID, a
+        # unique one is generated.
+        # Corresponds to the JSON property `dropdownDefinitionId`
+        # @return [String]
+        attr_accessor :dropdown_definition_id
+      
+        # Properties of a dropdown definition.
+        # Corresponds to the JSON property `dropdownDefinitionProperties`
+        # @return [Google::Apis::DocsV1::DropdownDefinitionProperties]
+        attr_accessor :dropdown_definition_properties
+      
+        # ID for suggestion that deletes this dropdown definition.
+        # Corresponds to the JSON property `suggestedDeletionId`
+        # @return [String]
+        attr_accessor :suggested_deletion_id
+      
+        # Suggested property changes to this definition, keyed by suggestion ID.
+        # Corresponds to the JSON property `suggestedDropdownDefinitionPropertiesChanges`
+        # @return [Hash<String,Google::Apis::DocsV1::SuggestedDropdownDefinitionProperties>]
+        attr_accessor :suggested_dropdown_definition_properties_changes
+      
+        # ID for suggestion that inserts this dropdown definition.
+        # 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)
+          @dropdown_definition_id = args[:dropdown_definition_id] if args.key?(:dropdown_definition_id)
+          @dropdown_definition_properties = args[:dropdown_definition_properties] if args.key?(:dropdown_definition_properties)
+          @suggested_deletion_id = args[:suggested_deletion_id] if args.key?(:suggested_deletion_id)
+          @suggested_dropdown_definition_properties_changes = args[:suggested_dropdown_definition_properties_changes] if args.key?(:suggested_dropdown_definition_properties_changes)
+          @suggested_insertion_id = args[:suggested_insertion_id] if args.key?(:suggested_insertion_id)
+        end
+      end
+      
+      # Properties of a dropdown definition.
+      class DropdownDefinitionProperties
+        include Google::Apis::Core::Hashable
+      
+        # The list of options defined by this dropdown definition. A dropdown definition
+        # must have at least 2 options and at most 50 options.
+        # Corresponds to the JSON property `options`
+        # @return [Array<Google::Apis::DocsV1::DropdownOption>]
+        attr_accessor :options
+      
+        # The title of the dropdown definition.
+        # 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)
+          @options = args[:options] if args.key?(:options)
+          @title = args[:title] if args.key?(:title)
+        end
+      end
+      
+      # A mask that indicates which of the fields on the base
+      # DropdownDefinitionProperties have been changed in this suggestion. For any
+      # field set to true, there's a new suggested value.
+      class DropdownDefinitionPropertiesSuggestionState
+        include Google::Apis::Core::Hashable
+      
+        # Indicates if there was a suggested change to options.
+        # Corresponds to the JSON property `optionsSuggested`
+        # @return [Boolean]
+        attr_accessor :options_suggested
+        alias_method :options_suggested?, :options_suggested
+      
+        # 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)
+          @options_suggested = args[:options_suggested] if args.key?(:options_suggested)
+          @title_suggested = args[:title_suggested] if args.key?(:title_suggested)
+        end
+      end
+      
+      # An option in a Dropdown.
+      class DropdownOption
+        include Google::Apis::Core::Hashable
+      
+        # The display value of this dropdown option.
+        # Corresponds to the JSON property `displayValue`
+        # @return [String]
+        attr_accessor :display_value
+      
+        # The ID of this dropdown option. If you specify an ID, it must be unique among
+        # all options in this dropdown definition. The ID must start with `dropdownItem.`
+        # and match regex `^dropdownItem\.[a-zA-Z0-9_-]`2,14`$` (length 15-27 chars).
+        # If you don't specify an ID, a unique one is generated.
+        # Corresponds to the JSON property `optionId`
+        # @return [String]
+        attr_accessor :option_id
+      
+        # 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)
+          @display_value = args[:display_value] if args.key?(:display_value)
+          @option_id = args[:option_id] if args.key?(:option_id)
+          @text_style = args[:text_style] if args.key?(:text_style)
+        end
+      end
+      
+      # Properties specific to a dropdown.
+      class DropdownProperties
+        include Google::Apis::Core::Hashable
+      
+        # The human-readable display text of the currently selected item. This field is
+        # populated by the server based on the dropdown definition and the selected
+        # option ID. It may differ from `DropdownOption.display_value` if the underlying
+        # option definition was modified or deleted, or during pending suggested changes.
+        # Corresponds to the JSON property `displayValue`
+        # @return [String]
+        attr_accessor :display_value
+      
+        # The ID of the DropdownDefinition that defines the options for this dropdown.
+        # Corresponds to the JSON property `dropdownDefinitionId`
+        # @return [String]
+        attr_accessor :dropdown_definition_id
+      
+        # The ID of the selected option in this dropdown.
+        # Corresponds to the JSON property `selectedOptionId`
+        # @return [String]
+        attr_accessor :selected_option_id
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @display_value = args[:display_value] if args.key?(:display_value)
+          @dropdown_definition_id = args[:dropdown_definition_id] if args.key?(:dropdown_definition_id)
+          @selected_option_id = args[:selected_option_id] if args.key?(:selected_option_id)
+        end
+      end
+      
+      # A mask that indicates which of the fields on the base DropdownProperties have
+      # been changed in this suggestion. For any field set to true, there's a new
+      # suggested value.
+      class DropdownPropertiesSuggestionState
+        include Google::Apis::Core::Hashable
+      
+        # Indicates if there was a suggested change to selected_option_id.
+        # Corresponds to the JSON property `selectedOptionIdSuggested`
+        # @return [Boolean]
+        attr_accessor :selected_option_id_suggested
+        alias_method :selected_option_id_suggested?, :selected_option_id_suggested
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @selected_option_id_suggested = args[:selected_option_id_suggested] if args.key?(:selected_option_id_suggested)
+        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.
@@ -2603,6 +3236,63 @@ module Google
         end
       end
       
+      # Inserts a CommentThread into the document. [Developer Preview](https://
+      # developers.google.com/workspace/preview).
+      class InsertCommentRequest
+        include Google::Apis::Core::Hashable
+      
+        # Optional. The email address of the assignee of the comment. Leave empty for a
+        # non-assigned comment. May not exceed 2048 UTF-8 code units.
+        # Corresponds to the JSON property `assigneeEmailAddress`
+        # @return [String]
+        attr_accessor :assignee_email_address
+      
+        # The text of the comment, as plain text. This text content will be handled
+        # similarly to comments created in the Docs editor. It will have similar
+        # behaviors for formatting, notifications, etc. This field cannot be empty, and
+        # must not exceed 2048 UTF-8 code units.
+        # Corresponds to the JSON property `content`
+        # @return [String]
+        attr_accessor :content
+      
+        # 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)
+          @assignee_email_address = args[:assignee_email_address] if args.key?(:assignee_email_address)
+          @content = args[:content] if args.key?(:content)
+          @range = args[:range] if args.key?(:range)
+        end
+      end
+      
+      # Response message for inserting a comment. [Developer Preview](https://
+      # developers.google.com/workspace/preview).
+      class InsertCommentResponse
+        include Google::Apis::Core::Hashable
+      
+        # Represents a single comment thread. [Developer Preview](https://developers.
+        # google.com/workspace/preview).
+        # Corresponds to the JSON property `commentThread`
+        # @return [Google::Apis::DocsV1::CommentThread]
+        attr_accessor :comment_thread
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @comment_thread = args[:comment_thread] if args.key?(:comment_thread)
+        end
+      end
+      
       # Inserts a date at the specified location.
       class InsertDateRequest
         include Google::Apis::Core::Hashable
@@ -2629,9 +3319,70 @@ module Google
       
         # Update properties of this object
         def update!(**args)
-          @date_element_properties = args[:date_element_properties] if args.key?(:date_element_properties)
+          @date_element_properties = args[:date_element_properties] if args.key?(:date_element_properties)
+          @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 Dropdown at the specified location.
+      class InsertDropdownRequest
+        include Google::Apis::Core::Hashable
+      
+        # Required. The DropdownDefinition ID.
+        # Corresponds to the JSON property `dropdownDefinitionId`
+        # @return [String]
+        attr_accessor :dropdown_definition_id
+      
+        # 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
+      
+        # Optional initial value for the dropdown. If this field is not specified, the
+        # new dropdown will default to selecting the first option defined in the
+        # dropdown definition. If this field is specified but does not reference a valid
+        # option in the dropdown definition, a 400 bad request error is returned.
+        # Corresponds to the JSON property `selectedOptionId`
+        # @return [String]
+        attr_accessor :selected_option_id
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @dropdown_definition_id = args[:dropdown_definition_id] if args.key?(:dropdown_definition_id)
           @end_of_segment_location = args[:end_of_segment_location] if args.key?(:end_of_segment_location)
           @location = args[:location] if args.key?(:location)
+          @selected_option_id = args[:selected_option_id] if args.key?(:selected_option_id)
+        end
+      end
+      
+      # The result of inserting a Dropdown.
+      class InsertDropdownResponse
+        include Google::Apis::Core::Hashable
+      
+        # A dropdown in the document. The chip is displayed as a dropdown menu that
+        # allows users to select an option from a configurable list of options.
+        # Corresponds to the JSON property `dropdown`
+        # @return [Google::Apis::DocsV1::Dropdown]
+        attr_accessor :dropdown
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @dropdown = args[:dropdown] if args.key?(:dropdown)
         end
       end
       
@@ -3807,6 +4558,12 @@ module Google
         # @return [Google::Apis::DocsV1::DateElement]
         attr_accessor :date_element
       
+        # A dropdown in the document. The chip is displayed as a dropdown menu that
+        # allows users to select an option from a configurable list of options.
+        # Corresponds to the JSON property `dropdown`
+        # @return [Google::Apis::DocsV1::Dropdown]
+        attr_accessor :dropdown
+      
         # The zero-base end index of this paragraph element, exclusive, in UTF-16 code
         # units.
         # Corresponds to the JSON property `endIndex`
@@ -3871,6 +4628,7 @@ module Google
           @auto_text = args[:auto_text] if args.key?(:auto_text)
           @column_break = args[:column_break] if args.key?(:column_break)
           @date_element = args[:date_element] if args.key?(:date_element)
+          @dropdown = args[:dropdown] if args.key?(:dropdown)
           @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)
@@ -4507,6 +5265,157 @@ module Google
         end
       end
       
+      # Represents a single post in a comment or suggestion thread. [Developer Preview]
+      # (https://developers.google.com/workspace/preview).
+      class Post
+        include Google::Apis::Core::Hashable
+      
+        # Optional. The email of the user who is being newly assigned to the thread as
+        # part of this post. Returns a 400 bad request error if: - The parent thread is
+        # a CommentThread whose headPost does not have an assignee. - The parent thread
+        # is a SuggestionThread. - commentAction is specified as `RESOLVE` or `REOPEN`. -
+        # `assigneeEmail` exceeds 2048 UTF-8 code units.
+        # Corresponds to the JSON property `assigneeEmail`
+        # @return [String]
+        attr_accessor :assignee_email
+      
+        # Represents a user who authored a comment or suggestion post. [Developer
+        # Preview](https://developers.google.com/workspace/preview).
+        # Corresponds to the JSON property `author`
+        # @return [Google::Apis::DocsV1::PostAuthor]
+        attr_accessor :author
+      
+        # Optional. The action type for comment posts.
+        # Corresponds to the JSON property `commentAction`
+        # @return [String]
+        attr_accessor :comment_action
+      
+        # The content of the post. Required to be non-empty if commentAction is not `
+        # RESOLVE` or `REOPEN`. This text content will be handled similarly to comments
+        # created in the Docs editor. It will have similar behaviors for formatting,
+        # notifications, etc. May not exceed 2048 UTF-8 code units.
+        # Corresponds to the JSON property `content`
+        # @return [String]
+        attr_accessor :content
+      
+        # Output only. The content of the post as HTML.
+        # Corresponds to the JSON property `contentHtml`
+        # @return [String]
+        attr_accessor :content_html
+      
+        # Output only. The time the post was created.
+        # Corresponds to the JSON property `createTime`
+        # @return [String]
+        attr_accessor :create_time
+      
+        # Output only. Whether the post is deleted. If `true`, content and author fields
+        # will be empty.
+        # Corresponds to the JSON property `deleted`
+        # @return [Boolean]
+        attr_accessor :deleted
+        alias_method :deleted?, :deleted
+      
+        # Output only. Whether the post is from a copied document. This field cannot be
+        # set directly by callers.
+        # Corresponds to the JSON property `fromCopiedDocument`
+        # @return [Boolean]
+        attr_accessor :from_copied_document
+        alias_method :from_copied_document?, :from_copied_document
+      
+        # Output only. Whether the post is from a document comparison. This field cannot
+        # be set directly by callers.
+        # Corresponds to the JSON property `fromDocumentComparison`
+        # @return [Boolean]
+        attr_accessor :from_document_comparison
+        alias_method :from_document_comparison?, :from_document_comparison
+      
+        # Output only. Whether the post is from an imported document. This field cannot
+        # be set directly by callers.
+        # Corresponds to the JSON property `fromImportedDocument`
+        # @return [Boolean]
+        attr_accessor :from_imported_document
+        alias_method :from_imported_document?, :from_imported_document
+      
+        # Output only. The unique ID of the post.
+        # Corresponds to the JSON property `postId`
+        # @return [String]
+        attr_accessor :post_id
+      
+        # Output only. The action type for suggestion posts.
+        # Corresponds to the JSON property `suggestionAction`
+        # @return [String]
+        attr_accessor :suggestion_action
+      
+        # Output only. The time the post was last updated.
+        # Corresponds to the JSON property `updateTime`
+        # @return [String]
+        attr_accessor :update_time
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @assignee_email = args[:assignee_email] if args.key?(:assignee_email)
+          @author = args[:author] if args.key?(:author)
+          @comment_action = args[:comment_action] if args.key?(:comment_action)
+          @content = args[:content] if args.key?(:content)
+          @content_html = args[:content_html] if args.key?(:content_html)
+          @create_time = args[:create_time] if args.key?(:create_time)
+          @deleted = args[:deleted] if args.key?(:deleted)
+          @from_copied_document = args[:from_copied_document] if args.key?(:from_copied_document)
+          @from_document_comparison = args[:from_document_comparison] if args.key?(:from_document_comparison)
+          @from_imported_document = args[:from_imported_document] if args.key?(:from_imported_document)
+          @post_id = args[:post_id] if args.key?(:post_id)
+          @suggestion_action = args[:suggestion_action] if args.key?(:suggestion_action)
+          @update_time = args[:update_time] if args.key?(:update_time)
+        end
+      end
+      
+      # Represents a user who authored a comment or suggestion post. [Developer
+      # Preview](https://developers.google.com/workspace/preview).
+      class PostAuthor
+        include Google::Apis::Core::Hashable
+      
+        # Whether the user is anonymous.
+        # Corresponds to the JSON property `anonymous`
+        # @return [Boolean]
+        attr_accessor :anonymous
+        alias_method :anonymous?, :anonymous
+      
+        # The display name of the user. May be absent if the author is anonymous.
+        # Corresponds to the JSON property `displayName`
+        # @return [String]
+        attr_accessor :display_name
+      
+        # Whether the user is the authenticated user making the request.
+        # Corresponds to the JSON property `me`
+        # @return [Boolean]
+        attr_accessor :me
+        alias_method :me?, :me
+      
+        # The resource name of the post author user, which can also be used to identify
+        # the user in the [Google People API](https://developers.google.com/people/api/
+        # rest/v1/people). Format: `users/`user``. Will not be populated if the
+        # anonymous field is `true` or if the post is from an imported document.
+        # Corresponds to the JSON property `user`
+        # @return [String]
+        attr_accessor :user
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @anonymous = args[:anonymous] if args.key?(:anonymous)
+          @display_name = args[:display_name] if args.key?(:display_name)
+          @me = args[:me] if args.key?(:me)
+          @user = args[:user] if args.key?(:user)
+        end
+      end
+      
       # Specifies a contiguous range of text.
       class Range
         include Google::Apis::Core::Hashable
@@ -4554,6 +5463,28 @@ module Google
         end
       end
       
+      # Rejects a suggestion. Returns a 403 forbidden error if the requesting user
+      # does not have edit access to the document and is not the author of the
+      # suggestion. [Developer Preview](https://developers.google.com/workspace/
+      # preview).
+      class RejectSuggestionRequest
+        include Google::Apis::Core::Hashable
+      
+        # The ID of the suggestion.
+        # Corresponds to the JSON property `suggestionId`
+        # @return [String]
+        attr_accessor :suggestion_id
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @suggestion_id = args[:suggestion_id] if args.key?(:suggestion_id)
+        end
+      end
+      
       # Replaces all instances of text matching a criteria with replace text.
       class ReplaceAllTextRequest
         include Google::Apis::Core::Hashable
@@ -4703,12 +5634,30 @@ module Google
       class Request
         include Google::Apis::Core::Hashable
       
+        # Accepts a suggestion. Returns a 403 forbidden error if the requesting user
+        # does not have edit access to the document. [Developer Preview](https://
+        # developers.google.com/workspace/preview).
+        # Corresponds to the JSON property `acceptSuggestion`
+        # @return [Google::Apis::DocsV1::AcceptSuggestionRequest]
+        attr_accessor :accept_suggestion
+      
+        # Inserts a reply Post into a CommentThread or SuggestionThread. [Developer
+        # Preview](https://developers.google.com/workspace/preview).
+        # Corresponds to the JSON property `addCommentReply`
+        # @return [Google::Apis::DocsV1::AddCommentReplyRequest]
+        attr_accessor :add_comment_reply
+      
         # Adds a document tab. When a tab is added at a given index, all subsequent tabs'
         # indexes are incremented.
         # Corresponds to the JSON property `addDocumentTab`
         # @return [Google::Apis::DocsV1::AddDocumentTabRequest]
         attr_accessor :add_document_tab
       
+        # Creates a new DropdownDefinition in the document.
+        # Corresponds to the JSON property `createDropdownDefinition`
+        # @return [Google::Apis::DocsV1::CreateDropdownDefinitionRequest]
+        attr_accessor :create_dropdown_definition
+      
         # 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
@@ -4748,11 +5697,33 @@ module Google
         # @return [Google::Apis::DocsV1::CreateParagraphBulletsRequest]
         attr_accessor :create_paragraph_bullets
       
+        # Deletes a CommentThread. Returns a 400 bad request error if the requesting
+        # user is not the author of the headPost. [Developer Preview](https://developers.
+        # google.com/workspace/preview).
+        # Corresponds to the JSON property `deleteComment`
+        # @return [Google::Apis::DocsV1::DeleteCommentRequest]
+        attr_accessor :delete_comment
+      
+        # Deletes a reply Post from a CommentThread or SuggestionThread. Returns a 400
+        # bad request error if: - The requesting user is not the author of the post. -
+        # The reply post contains an action. - The reply post contains an assignee. [
+        # Developer Preview](https://developers.google.com/workspace/preview).
+        # Corresponds to the JSON property `deleteCommentReply`
+        # @return [Google::Apis::DocsV1::DeleteCommentReplyRequest]
+        attr_accessor :delete_comment_reply
+      
         # Deletes content from the document.
         # Corresponds to the JSON property `deleteContentRange`
         # @return [Google::Apis::DocsV1::DeleteContentRangeRequest]
         attr_accessor :delete_content_range
       
+        # Deletes a DropdownDefinition. If the dropdown definition is referenced by any
+        # dropdown instances (chips) in the document, a 400 bad request error is
+        # returned.
+        # Corresponds to the JSON property `deleteDropdownDefinition`
+        # @return [Google::Apis::DocsV1::DeleteDropdownDefinitionRequest]
+        attr_accessor :delete_dropdown_definition
+      
         # Deletes a Footer from the document.
         # Corresponds to the JSON property `deleteFooter`
         # @return [Google::Apis::DocsV1::DeleteFooterRequest]
@@ -4780,6 +5751,13 @@ module Google
         # @return [Google::Apis::DocsV1::DeletePositionedObjectRequest]
         attr_accessor :delete_positioned_object
       
+        # Deletes a suggestion. Returns a 403 forbidden error if the requesting user is
+        # not the author of the suggestion. [Developer Preview](https://developers.
+        # google.com/workspace/preview).
+        # Corresponds to the JSON property `deleteSuggestion`
+        # @return [Google::Apis::DocsV1::DeleteSuggestionRequest]
+        attr_accessor :delete_suggestion
+      
         # Deletes a tab. If the tab has child tabs, they are deleted as well.
         # Corresponds to the JSON property `deleteTab`
         # @return [Google::Apis::DocsV1::DeleteTabRequest]
@@ -4795,11 +5773,22 @@ module Google
         # @return [Google::Apis::DocsV1::DeleteTableRowRequest]
         attr_accessor :delete_table_row
       
+        # Inserts a CommentThread into the document. [Developer Preview](https://
+        # developers.google.com/workspace/preview).
+        # Corresponds to the JSON property `insertComment`
+        # @return [Google::Apis::DocsV1::InsertCommentRequest]
+        attr_accessor :insert_comment
+      
         # Inserts a date at the specified location.
         # Corresponds to the JSON property `insertDate`
         # @return [Google::Apis::DocsV1::InsertDateRequest]
         attr_accessor :insert_date
       
+        # Inserts a Dropdown at the specified location.
+        # Corresponds to the JSON property `insertDropdown`
+        # @return [Google::Apis::DocsV1::InsertDropdownRequest]
+        attr_accessor :insert_dropdown
+      
         # Inserts an InlineObject containing an image at the given location.
         # Corresponds to the JSON property `insertInlineImage`
         # @return [Google::Apis::DocsV1::InsertInlineImageRequest]
@@ -4857,6 +5846,14 @@ module Google
         # @return [Google::Apis::DocsV1::PinTableHeaderRowsRequest]
         attr_accessor :pin_table_header_rows
       
+        # Rejects a suggestion. Returns a 403 forbidden error if the requesting user
+        # does not have edit access to the document and is not the author of the
+        # suggestion. [Developer Preview](https://developers.google.com/workspace/
+        # preview).
+        # Corresponds to the JSON property `rejectSuggestion`
+        # @return [Google::Apis::DocsV1::RejectSuggestionRequest]
+        attr_accessor :reject_suggestion
+      
         # Replaces all instances of text matching a criteria with replace text.
         # Corresponds to the JSON property `replaceAllText`
         # @return [Google::Apis::DocsV1::ReplaceAllTextRequest]
@@ -4884,6 +5881,14 @@ module Google
         # @return [Google::Apis::DocsV1::UnmergeTableCellsRequest]
         attr_accessor :unmerge_table_cells
       
+        # Updates a Post in a CommentThread or SuggestionThread. Returns a 400 bad
+        # request error if: - The post is the headPost of a SuggestionThread. - The
+        # requesting user is not the author of the post. [Developer Preview](https://
+        # developers.google.com/workspace/preview).
+        # Corresponds to the JSON property `updateCommentPost`
+        # @return [Google::Apis::DocsV1::UpdateCommentPostRequest]
+        attr_accessor :update_comment_post
+      
         # Updates the DocumentStyle.
         # Corresponds to the JSON property `updateDocumentStyle`
         # @return [Google::Apis::DocsV1::UpdateDocumentStyleRequest]
@@ -4894,6 +5899,16 @@ module Google
         # @return [Google::Apis::DocsV1::UpdateDocumentTabPropertiesRequest]
         attr_accessor :update_document_tab_properties
       
+        # Updates the properties of a DropdownDefinition.
+        # Corresponds to the JSON property `updateDropdownDefinitionProperties`
+        # @return [Google::Apis::DocsV1::UpdateDropdownDefinitionPropertiesRequest]
+        attr_accessor :update_dropdown_definition_properties
+      
+        # Updates the properties of a Dropdown.
+        # Corresponds to the JSON property `updateDropdownProperties`
+        # @return [Google::Apis::DocsV1::UpdateDropdownPropertiesRequest]
+        attr_accessor :update_dropdown_properties
+      
         # Updates a named style.
         # Corresponds to the JSON property `updateNamedStyle`
         # @return [Google::Apis::DocsV1::UpdateNamedStyleRequest]
@@ -4935,22 +5950,31 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @accept_suggestion = args[:accept_suggestion] if args.key?(:accept_suggestion)
+          @add_comment_reply = args[:add_comment_reply] if args.key?(:add_comment_reply)
           @add_document_tab = args[:add_document_tab] if args.key?(:add_document_tab)
+          @create_dropdown_definition = args[:create_dropdown_definition] if args.key?(:create_dropdown_definition)
           @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_comment = args[:delete_comment] if args.key?(:delete_comment)
+          @delete_comment_reply = args[:delete_comment_reply] if args.key?(:delete_comment_reply)
           @delete_content_range = args[:delete_content_range] if args.key?(:delete_content_range)
+          @delete_dropdown_definition = args[:delete_dropdown_definition] if args.key?(:delete_dropdown_definition)
           @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_suggestion = args[:delete_suggestion] if args.key?(:delete_suggestion)
           @delete_tab = args[:delete_tab] if args.key?(:delete_tab)
           @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_comment = args[:insert_comment] if args.key?(:insert_comment)
           @insert_date = args[:insert_date] if args.key?(:insert_date)
+          @insert_dropdown = args[:insert_dropdown] if args.key?(:insert_dropdown)
           @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)
@@ -4962,12 +5986,16 @@ module Google
           @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)
+          @reject_suggestion = args[:reject_suggestion] if args.key?(:reject_suggestion)
           @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_comment_post = args[:update_comment_post] if args.key?(:update_comment_post)
           @update_document_style = args[:update_document_style] if args.key?(:update_document_style)
           @update_document_tab_properties = args[:update_document_tab_properties] if args.key?(:update_document_tab_properties)
+          @update_dropdown_definition_properties = args[:update_dropdown_definition_properties] if args.key?(:update_dropdown_definition_properties)
+          @update_dropdown_properties = args[:update_dropdown_properties] if args.key?(:update_dropdown_properties)
           @update_named_style = args[:update_named_style] if args.key?(:update_named_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)
@@ -4982,11 +6010,22 @@ module Google
       class Response
         include Google::Apis::Core::Hashable
       
+        # Response message for adding a reply. [Developer Preview](https://developers.
+        # google.com/workspace/preview).
+        # Corresponds to the JSON property `addCommentReply`
+        # @return [Google::Apis::DocsV1::AddCommentReplyResponse]
+        attr_accessor :add_comment_reply
+      
         # The result of adding a document tab.
         # Corresponds to the JSON property `addDocumentTab`
         # @return [Google::Apis::DocsV1::AddDocumentTabResponse]
         attr_accessor :add_document_tab
       
+        # Response message for creating a dropdown definition.
+        # Corresponds to the JSON property `createDropdownDefinition`
+        # @return [Google::Apis::DocsV1::CreateDropdownDefinitionResponse]
+        attr_accessor :create_dropdown_definition
+      
         # The result of creating a footer.
         # Corresponds to the JSON property `createFooter`
         # @return [Google::Apis::DocsV1::CreateFooterResponse]
@@ -5007,6 +6046,17 @@ module Google
         # @return [Google::Apis::DocsV1::CreateNamedRangeResponse]
         attr_accessor :create_named_range
       
+        # Response message for inserting a comment. [Developer Preview](https://
+        # developers.google.com/workspace/preview).
+        # Corresponds to the JSON property `insertComment`
+        # @return [Google::Apis::DocsV1::InsertCommentResponse]
+        attr_accessor :insert_comment
+      
+        # The result of inserting a Dropdown.
+        # Corresponds to the JSON property `insertDropdown`
+        # @return [Google::Apis::DocsV1::InsertDropdownResponse]
+        attr_accessor :insert_dropdown
+      
         # The result of inserting an inline image.
         # Corresponds to the JSON property `insertInlineImage`
         # @return [Google::Apis::DocsV1::InsertInlineImageResponse]
@@ -5028,11 +6078,15 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @add_comment_reply = args[:add_comment_reply] if args.key?(:add_comment_reply)
           @add_document_tab = args[:add_document_tab] if args.key?(:add_document_tab)
+          @create_dropdown_definition = args[:create_dropdown_definition] if args.key?(:create_dropdown_definition)
           @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_comment = args[:insert_comment] if args.key?(:insert_comment)
+          @insert_dropdown = args[:insert_dropdown] if args.key?(:insert_dropdown)
           @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)
@@ -5735,6 +6789,60 @@ module Google
         end
       end
       
+      # A suggested change to dropdown definition properties.
+      class SuggestedDropdownDefinitionProperties
+        include Google::Apis::Core::Hashable
+      
+        # Properties of a dropdown definition.
+        # Corresponds to the JSON property `dropdownDefinitionProperties`
+        # @return [Google::Apis::DocsV1::DropdownDefinitionProperties]
+        attr_accessor :dropdown_definition_properties
+      
+        # A mask that indicates which of the fields on the base
+        # DropdownDefinitionProperties have been changed in this suggestion. For any
+        # field set to true, there's a new suggested value.
+        # Corresponds to the JSON property `dropdownDefinitionPropertiesSuggestionState`
+        # @return [Google::Apis::DocsV1::DropdownDefinitionPropertiesSuggestionState]
+        attr_accessor :dropdown_definition_properties_suggestion_state
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @dropdown_definition_properties = args[:dropdown_definition_properties] if args.key?(:dropdown_definition_properties)
+          @dropdown_definition_properties_suggestion_state = args[:dropdown_definition_properties_suggestion_state] if args.key?(:dropdown_definition_properties_suggestion_state)
+        end
+      end
+      
+      # A suggested change to dropdown properties.
+      class SuggestedDropdownProperties
+        include Google::Apis::Core::Hashable
+      
+        # Properties specific to a dropdown.
+        # Corresponds to the JSON property `dropdownProperties`
+        # @return [Google::Apis::DocsV1::DropdownProperties]
+        attr_accessor :dropdown_properties
+      
+        # A mask that indicates which of the fields on the base DropdownProperties have
+        # been changed in this suggestion. For any field set to true, there's a new
+        # suggested value.
+        # Corresponds to the JSON property `dropdownPropertiesSuggestionState`
+        # @return [Google::Apis::DocsV1::DropdownPropertiesSuggestionState]
+        attr_accessor :dropdown_properties_suggestion_state
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @dropdown_properties = args[:dropdown_properties] if args.key?(:dropdown_properties)
+          @dropdown_properties_suggestion_state = args[:dropdown_properties_suggestion_state] if args.key?(:dropdown_properties_suggestion_state)
+        end
+      end
+      
       # A suggested change to InlineObjectProperties.
       class SuggestedInlineObjectProperties
         include Google::Apis::Core::Hashable
@@ -5971,6 +7079,104 @@ module Google
         end
       end
       
+      # The suggestions which were affected by a given update. [Developer Preview](
+      # https://developers.google.com/workspace/preview).
+      class SuggestionResponse
+        include Google::Apis::Core::Hashable
+      
+        # The IDs of suggestions which were accepted during the update.
+        # Corresponds to the JSON property `acceptedSuggestionIds`
+        # @return [Array<String>]
+        attr_accessor :accepted_suggestion_ids
+      
+        # The IDs of suggestions which were created during the update.
+        # Corresponds to the JSON property `createdSuggestionIds`
+        # @return [Array<String>]
+        attr_accessor :created_suggestion_ids
+      
+        # The IDs of suggestions which were deleted during the update.
+        # Corresponds to the JSON property `deletedSuggestionIds`
+        # @return [Array<String>]
+        attr_accessor :deleted_suggestion_ids
+      
+        # The IDs of suggestions which were rejected during the update.
+        # Corresponds to the JSON property `rejectedSuggestionIds`
+        # @return [Array<String>]
+        attr_accessor :rejected_suggestion_ids
+      
+        # The IDs of suggestions whose summaries were updated during the update.
+        # Corresponds to the JSON property `updatedSummarySuggestionIds`
+        # @return [Array<String>]
+        attr_accessor :updated_summary_suggestion_ids
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @accepted_suggestion_ids = args[:accepted_suggestion_ids] if args.key?(:accepted_suggestion_ids)
+          @created_suggestion_ids = args[:created_suggestion_ids] if args.key?(:created_suggestion_ids)
+          @deleted_suggestion_ids = args[:deleted_suggestion_ids] if args.key?(:deleted_suggestion_ids)
+          @rejected_suggestion_ids = args[:rejected_suggestion_ids] if args.key?(:rejected_suggestion_ids)
+          @updated_summary_suggestion_ids = args[:updated_summary_suggestion_ids] if args.key?(:updated_summary_suggestion_ids)
+        end
+      end
+      
+      # Represents a single suggestion thread. Suggestion threads are created as a
+      # byproduct of saving changes to the document while in suggestion mode, and
+      # cannot be created directly. [Developer Preview](https://developers.google.com/
+      # workspace/preview).
+      class SuggestionThread
+        include Google::Apis::Core::Hashable
+      
+        # Represents a single post in a comment or suggestion thread. [Developer Preview]
+        # (https://developers.google.com/workspace/preview).
+        # Corresponds to the JSON property `headPost`
+        # @return [Google::Apis::DocsV1::Post]
+        attr_accessor :head_post
+      
+        # Replies to the head post.
+        # Corresponds to the JSON property `replies`
+        # @return [Array<Google::Apis::DocsV1::Post>]
+        attr_accessor :replies
+      
+        # Whether the thread is open, accepted, or rejected.
+        # Corresponds to the JSON property `status`
+        # @return [String]
+        attr_accessor :status
+      
+        # The unique ID of the suggestion.
+        # Corresponds to the JSON property `suggestionId`
+        # @return [String]
+        attr_accessor :suggestion_id
+      
+        # Summary of the suggested differences in the document, in HTML. May be empty.
+        # Corresponds to the JSON property `summaryHtml`
+        # @return [String]
+        attr_accessor :summary_html
+      
+        # Summary of the suggested differences in the document, in plain text. May be
+        # empty.
+        # Corresponds to the JSON property `summaryText`
+        # @return [String]
+        attr_accessor :summary_text
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @head_post = args[:head_post] if args.key?(:head_post)
+          @replies = args[:replies] if args.key?(:replies)
+          @status = args[:status] if args.key?(:status)
+          @suggestion_id = args[:suggestion_id] if args.key?(:suggestion_id)
+          @summary_html = args[:summary_html] if args.key?(:summary_html)
+          @summary_text = args[:summary_text] if args.key?(:summary_text)
+        end
+      end
+      
       # A tab in a document.
       class Tab
         include Google::Apis::Core::Hashable
@@ -6963,6 +8169,49 @@ module Google
         end
       end
       
+      # Updates a Post in a CommentThread or SuggestionThread. Returns a 400 bad
+      # request error if: - The post is the headPost of a SuggestionThread. - The
+      # requesting user is not the author of the post. [Developer Preview](https://
+      # developers.google.com/workspace/preview).
+      class UpdateCommentPostRequest
+        include Google::Apis::Core::Hashable
+      
+        # The ID of the CommentThread which the post belongs to.
+        # Corresponds to the JSON property `commentId`
+        # @return [String]
+        attr_accessor :comment_id
+      
+        # The new text of the comment, as plain text. This text content will be handled
+        # similarly to comments created in the Docs editor. It will have similar
+        # behaviors for formatting, notifications, etc. This field cannot be empty, and
+        # must not exceed 2048 UTF-8 code units.
+        # Corresponds to the JSON property `content`
+        # @return [String]
+        attr_accessor :content
+      
+        # The ID of the post being updated.
+        # Corresponds to the JSON property `postId`
+        # @return [String]
+        attr_accessor :post_id
+      
+        # The ID of the SuggestionThread which the post belongs to.
+        # Corresponds to the JSON property `suggestionId`
+        # @return [String]
+        attr_accessor :suggestion_id
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @comment_id = args[:comment_id] if args.key?(:comment_id)
+          @content = args[:content] if args.key?(:content)
+          @post_id = args[:post_id] if args.key?(:post_id)
+          @suggestion_id = args[:suggestion_id] if args.key?(:suggestion_id)
+        end
+      end
+      
       # Updates the DocumentStyle.
       class UpdateDocumentStyleRequest
         include Google::Apis::Core::Hashable
@@ -7029,6 +8278,112 @@ module Google
         end
       end
       
+      # Updates the properties of a DropdownDefinition.
+      class UpdateDropdownDefinitionPropertiesRequest
+        include Google::Apis::Core::Hashable
+      
+        # The ID of the DropdownDefinition to update.
+        # Corresponds to the JSON property `dropdownDefinitionId`
+        # @return [String]
+        attr_accessor :dropdown_definition_id
+      
+        # Properties of a dropdown definition.
+        # Corresponds to the JSON property `dropdownDefinitionProperties`
+        # @return [Google::Apis::DocsV1::DropdownDefinitionProperties]
+        attr_accessor :dropdown_definition_properties
+      
+        # The fields that should be updated. At least one field must be specified. The
+        # root `dropdown_definition_properties` is implied and should not be specified.
+        # A single `"*"` can be used as short-hand for listing every field. When `
+        # dropdown_definition_properties.options` is included in the field mask, the
+        # full, complete list of desired options must be provided in `
+        # dropdown_definition_properties.options`.
+        # Corresponds to the JSON property `fields`
+        # @return [String]
+        attr_accessor :fields
+      
+        # A map of option IDs to their replacements, used to automatically reassign
+        # orphaned Dropdown chips when an option is deleted. The keys are the IDs of the
+        # options being deleted, and the values are the IDs of their replacement options.
+        # If an option being deleted is selected in one or more Dropdown chips in the
+        # document, a replacement entry for that option must be provided in this map,
+        # and the replacement option ID must exist in the updated DropdownDefinition. If
+        # a replacement is required but not provided, a 400 bad request error is
+        # returned. Options being deleted that are not selected in any Dropdown chips do
+        # not require a replacement. For example, if option A is being replaced by
+        # option B, the map should be ``"A": "B"``.
+        # Corresponds to the JSON property `selectedOptionIdReplacements`
+        # @return [Hash<String,String>]
+        attr_accessor :selected_option_id_replacements
+      
+        # The ID of the tab that contains the dropdown definition to update. 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)
+          @dropdown_definition_id = args[:dropdown_definition_id] if args.key?(:dropdown_definition_id)
+          @dropdown_definition_properties = args[:dropdown_definition_properties] if args.key?(:dropdown_definition_properties)
+          @fields = args[:fields] if args.key?(:fields)
+          @selected_option_id_replacements = args[:selected_option_id_replacements] if args.key?(:selected_option_id_replacements)
+          @tab_id = args[:tab_id] if args.key?(:tab_id)
+        end
+      end
+      
+      # Updates the properties of a Dropdown.
+      class UpdateDropdownPropertiesRequest
+        include Google::Apis::Core::Hashable
+      
+        # Required. The Dropdown ID.
+        # Corresponds to the JSON property `dropdownId`
+        # @return [String]
+        attr_accessor :dropdown_id
+      
+        # Properties specific to a dropdown.
+        # Corresponds to the JSON property `dropdownProperties`
+        # @return [Google::Apis::DocsV1::DropdownProperties]
+        attr_accessor :dropdown_properties
+      
+        # The fields that should be updated. At least one field must be specified. The
+        # root `dropdown_properties` is implied and should not be specified. A single `"*
+        # "` can be used as short-hand for listing every field.
+        # Corresponds to the JSON property `fields`
+        # @return [String]
+        attr_accessor :fields
+      
+        # The ID of the tab that contains the dropdown to update. 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)
+          @dropdown_id = args[:dropdown_id] if args.key?(:dropdown_id)
+          @dropdown_properties = args[:dropdown_properties] if args.key?(:dropdown_properties)
+          @fields = args[:fields] if args.key?(:fields)
+          @tab_id = args[:tab_id] if args.key?(:tab_id)
+        end
+      end
+      
       # Updates a named style.
       class UpdateNamedStyleRequest
         include Google::Apis::Core::Hashable
@@ -7395,6 +8750,13 @@ module Google
         # @return [String]
         attr_accessor :target_revision_id
       
+        # How the request updates should be applied to the document. If unspecified, the
+        # request updates will be applied as normal edits. [Developer Preview](https://
+        # developers.google.com/workspace/preview).
+        # Corresponds to the JSON property `writeMode`
+        # @return [String]
+        attr_accessor :write_mode
+      
         def initialize(**args)
            update!(**args)
         end
@@ -7403,6 +8765,7 @@ module Google
         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)
+          @write_mode = args[:write_mode] if args.key?(:write_mode)
         end
       end
     end