@maxim_mazurok/gapi.client.docs-v1 0.4.20260909 → 0.4.20260928

package/index.d.ts

@@ -9,7 +9,7 @@
 // This file was generated by https://github.com/Maxim-Mazurok/google-api-typings-generator. Please do not edit it manually.
 // In case of any problems please post issue to https://github.com/Maxim-Mazurok/google-api-typings-generator
 // Generated from: https://docs.googleapis.com/$discovery/rest?version=v1
-// Revision: 20260909
+// Revision: 20260928
 
 /// <reference types="gapi.client" />
 
@@ -24,6 +24,22 @@ declare namespace gapi.client {
   function load(name: 'docs', version: 'v1', callback: () => any): void;
 
   namespace docs {
+    interface AcceptSuggestionRequest {
+      /** The ID of the suggestion. */
+      suggestionId?: string;
+    }
+    interface AddCommentReplyRequest {
+      /** The ID of the CommentThread to add the reply to. */
+      commentId?: string;
+      /** The Post representing the reply. */
+      post?: Post;
+      /** The ID of the SuggestionThread to add the reply to. */
+      suggestionId?: string;
+    }
+    interface AddCommentReplyResponse {
+      /** The newly-inserted reply Post. */
+      post?: Post;
+    }
     interface AddDocumentTabRequest {
       /** The properties of the tab to add. All properties are optional. */
       tabProperties?: TabProperties;
@@ -59,10 +75,18 @@ declare namespace gapi.client {
       writeControl?: WriteControl;
     }
     interface BatchUpdateDocumentResponse {
+      /** Whether comment updates were applied in the batch request. [Developer Preview](https://developers.google.com/workspace/preview). */
+      commentUpdateState?:
+        | 'COMMENT_UPDATE_STATE_UNSPECIFIED'
+        | 'NO_UPDATES_REQUESTED'
+        | 'ALL_SAVED'
+        | 'ALL_FAILED_UNKNOWN_REASON';
       /** The ID of the document to which the updates were applied to. */
       documentId?: string;
       /** The reply of the updates. This maps 1:1 with the updates, although replies to some requests may be empty. */
       replies?: Response[];
+      /** The suggestions which were affected by each update. This maps 1:1 with the updates. [Developer Preview](https://developers.google.com/workspace/preview). */
+      suggestionResponses?: SuggestionResponse[];
       /** The updated write control after applying the request. */
       writeControl?: WriteControl;
     }
@@ -106,6 +130,36 @@ declare namespace gapi.client {
       /** The text style of this ColumnBreak. Similar to text content, like text runs and footnote references, the text style of a column break can affect content layout as well as the styling of text inserted next to it. */
       textStyle?: TextStyle;
     }
+    interface CommentAnchor {
+      /** The ID of the comment anchor. */
+      anchorId?: string;
+      /** A collection of Ranges in the document which are tied to this anchor. */
+      ranges?: Range[];
+    }
+    interface CommentThread {
+      /** The ID of the CommentAnchor in the document that this thread is tied to. Multiple comment threads may be anchored to the same CommentAnchor. */
+      anchorId?: string;
+      /** The unique ID of the comment thread. */
+      commentId?: string;
+      /** The first post in the thread. */
+      headPost?: Post;
+      /** The quoted text from the document when the comment was created, formatted as plain-text. */
+      plainTextQuote?: string;
+      /** Replies to the head post. */
+      replies?: Post[];
+      /** Whether the thread is open or resolved. */
+      status?: 'STATUS_UNSPECIFIED' | 'OPEN' | 'RESOLVED';
+    }
+    interface CreateDropdownDefinitionRequest {
+      /** Required. The DropdownDefinition to create. */
+      dropdownDefinition?: DropdownDefinition;
+      /** 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. */
+      tabId?: string;
+    }
+    interface CreateDropdownDefinitionResponse {
+      /** The newly-created DropdownDefinition. */
+      dropdownDefinition?: DropdownDefinition;
+    }
     interface CreateFooterRequest {
       /** The location of the SectionBreak immediately preceding the section whose SectionStyle this footer should belong to. If this is unset or refers to the first section break in the document, the footer applies to the document style. */
       sectionBreakLocation?: Location;
@@ -246,10 +300,28 @@ declare namespace gapi.client {
       /** Indicates if there was a suggested change to time_zone_id. */
       timeZoneIdSuggested?: boolean;
     }
+    interface DeleteCommentReplyRequest {
+      /** The ID of the CommentThread which the post belongs to. */
+      commentId?: string;
+      /** The ID of the reply Post being deleted. */
+      postId?: string;
+      /** The ID of the SuggestionThread which the post belongs to. */
+      suggestionId?: string;
+    }
+    interface DeleteCommentRequest {
+      /** The ID of the CommentThread that is being deleted. */
+      commentId?: string;
+    }
     interface DeleteContentRangeRequest {
       /** The range of content to delete. Deleting text that crosses a paragraph boundary may result in changes to paragraph styles, lists, positioned objects and bookmarks as the two paragraphs are merged. Attempting to delete certain ranges can result in an invalid document structure in which case a 400 bad request error is returned. Some examples of invalid delete requests include: * Deleting one code unit of a surrogate pair. * Deleting the last newline character of a Body, Header, Footer, Footnote, TableCell or TableOfContents. * Deleting the start or end of a Table, TableOfContents or Equation without deleting the entire element. * Deleting the newline character before a Table, TableOfContents or SectionBreak without deleting the element. * Deleting individual rows or cells of a table. Deleting the content within a table cell is allowed. */
       range?: Range;
     }
+    interface DeleteDropdownDefinitionRequest {
+      /** The ID of the DropdownDefinition to delete. */
+      dropdownDefinitionId?: string;
+      /** 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. */
+      tabId?: string;
+    }
     interface DeleteFooterRequest {
       /** 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. */
       footerId?: string;
@@ -280,6 +352,10 @@ declare namespace gapi.client {
       /** 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. */
       tabId?: string;
     }
+    interface DeleteSuggestionRequest {
+      /** The ID of the suggestion. */
+      suggestionId?: string;
+    }
     interface DeleteTableColumnRequest {
       /** The reference table cell location from which the column will be deleted. The column this cell spans will be deleted. If this is a merged cell that spans multiple columns, all columns that the cell spans will be deleted. If no columns remain in the table after this deletion, the whole table is deleted. */
       tableCellLocation?: TableCellLocation;
@@ -301,6 +377,14 @@ declare namespace gapi.client {
     interface Document {
       /** Output only. The main body of the document. Legacy field: Instead, use Document.tabs.documentTab.body, 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. */
       body?: 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). */
+      comments?: CommentThread[];
+      /** Output only. The comments view mode applied to the document. [Developer Preview](https://developers.google.com/workspace/preview). */
+      commentsViewMode?:
+        | 'COMMENTS_VIEW_MODE_UNSPECIFIED'
+        | 'COMMENTS_VIEW_MODE_DEFAULT_FOR_CURRENT_ACCESS'
+        | 'COMMENTS_VIEW_MODE_OMITTED'
+        | 'COMMENTS_VIEW_MODE_INCLUDED';
       /** Output only. The ID of the document. */
       documentId?: string;
       /** Output only. The style of the document. Legacy field: Instead, use Document.tabs.documentTab.documentStyle, 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. */
@@ -327,6 +411,8 @@ declare namespace gapi.client {
       suggestedDocumentStyleChanges?: {[P in string]: SuggestedDocumentStyle};
       /** 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. */
       suggestedNamedStylesChanges?: {[P in string]: SuggestedNamedStyles};
+      /** 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). */
+      suggestions?: SuggestionThread[];
       /** 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. */
       suggestionsViewMode?:
         | 'DEFAULT_FOR_CURRENT_ACCESS'
@@ -427,8 +513,12 @@ declare namespace gapi.client {
     interface DocumentTab {
       /** The main body of the document tab. */
       body?: 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). */
+      commentAnchors?: {[P in string]: CommentAnchor};
       /** The style of the document tab. */
       documentStyle?: DocumentStyle;
+      /** The dropdown definitions in a document tab, keyed by dropdown definition ID. */
+      dropdownDefinitions?: {[P in string]: DropdownDefinition};
       /** The footers in the document tab, keyed by footer ID. */
       footers?: {[P in string]: Footer};
       /** The footnotes in the document tab, keyed by footnote ID. */
@@ -450,6 +540,70 @@ declare namespace gapi.client {
       /** The suggested changes to the named styles of the document tab, keyed by suggestion ID. */
       suggestedNamedStylesChanges?: {[P in string]: SuggestedNamedStyles};
     }
+    interface Dropdown {
+      /** The ID of this dropdown. */
+      dropdownId?: string;
+      /** The properties of this dropdown. */
+      dropdownProperties?: DropdownProperties;
+      /** IDs for suggestions that remove this dropdown from the document. If empty, then this dropdown isn't suggested for deletion. */
+      suggestedDeletionIds?: string[];
+      /** The suggested properties changes to this dropdown, keyed by suggestion ID. */
+      suggestedDropdownPropertiesChanges?: {
+        [P in string]: SuggestedDropdownProperties;
+      };
+      /** IDs for suggestions that insert this dropdown into the document. If empty, then this dropdown isn't a suggested insertion. */
+      suggestedInsertionIds?: string[];
+      /** The suggested text style changes to this dropdown, keyed by suggestion ID. */
+      suggestedTextStyleChanges?: {[P in string]: SuggestedTextStyle};
+      /** The text style of this dropdown. */
+      textStyle?: TextStyle;
+    }
+    interface DropdownDefinition {
+      /** 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. */
+      dropdownDefinitionId?: string;
+      /** The properties of this dropdown definition. */
+      dropdownDefinitionProperties?: DropdownDefinitionProperties;
+      /** ID for suggestion that deletes this dropdown definition. */
+      suggestedDeletionId?: string;
+      /** Suggested property changes to this definition, keyed by suggestion ID. */
+      suggestedDropdownDefinitionPropertiesChanges?: {
+        [P in string]: SuggestedDropdownDefinitionProperties;
+      };
+      /** ID for suggestion that inserts this dropdown definition. */
+      suggestedInsertionId?: string;
+    }
+    interface DropdownDefinitionProperties {
+      /** The list of options defined by this dropdown definition. A dropdown definition must have at least 2 options and at most 50 options. */
+      options?: DropdownOption[];
+      /** The title of the dropdown definition. */
+      title?: string;
+    }
+    interface DropdownDefinitionPropertiesSuggestionState {
+      /** Indicates if there was a suggested change to options. */
+      optionsSuggested?: boolean;
+      /** Indicates if there was a suggested change to title. */
+      titleSuggested?: boolean;
+    }
+    interface DropdownOption {
+      /** The display value of this dropdown option. */
+      displayValue?: string;
+      /** 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. */
+      optionId?: string;
+      /** The text style of this dropdown option. Currently, only the `foreground_color` and `background_color` properties are supported. If other properties are set, a 400 bad request error is returned. */
+      textStyle?: TextStyle;
+    }
+    interface DropdownProperties {
+      /** 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. */
+      displayValue?: string;
+      /** The ID of the DropdownDefinition that defines the options for this dropdown. */
+      dropdownDefinitionId?: string;
+      /** The ID of the selected option in this dropdown. */
+      selectedOptionId?: string;
+    }
+    interface DropdownPropertiesSuggestionState {
+      /** Indicates if there was a suggested change to selected_option_id. */
+      selectedOptionIdSuggested?: boolean;
+    }
     interface EmbeddedDrawingProperties {}
     interface EmbeddedDrawingPropertiesSuggestionState {}
     interface EmbeddedObject {
@@ -646,6 +800,18 @@ declare namespace gapi.client {
       /** A mask that indicates which of the fields in embedded_object have been changed in this suggestion. */
       embeddedObjectSuggestionState?: EmbeddedObjectSuggestionState;
     }
+    interface InsertCommentRequest {
+      /** 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. */
+      assigneeEmailAddress?: string;
+      /** 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. */
+      content?: string;
+      /** The Range in the document that is tied to this comment. */
+      range?: Range;
+    }
+    interface InsertCommentResponse {
+      /** The newly-inserted comment thread. */
+      commentThread?: CommentThread;
+    }
     interface InsertDateRequest {
       /** The properties of the date to insert. */
       dateElementProperties?: DateElementProperties;
@@ -654,6 +820,20 @@ declare namespace gapi.client {
       /** Inserts the date at a specific index in the document. The date must be inserted inside the bounds of an existing Paragraph. For instance, it cannot be inserted at a table's start index (i.e. between an existing table and its preceding paragraph). */
       location?: Location;
     }
+    interface InsertDropdownRequest {
+      /** Required. The DropdownDefinition ID. */
+      dropdownDefinitionId?: string;
+      /** The EndOfSegmentLocation in the document to insert the dropdown at. */
+      endOfSegmentLocation?: EndOfSegmentLocation;
+      /** The Location in the document to insert the dropdown at. */
+      location?: 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. */
+      selectedOptionId?: string;
+    }
+    interface InsertDropdownResponse {
+      /** The newly-inserted Dropdown. */
+      dropdown?: Dropdown;
+    }
     interface InsertInlineImageRequest {
       /** Inserts the text at the end of a header, footer or the document body. Inline images cannot be inserted inside a footnote. */
       endOfSegmentLocation?: EndOfSegmentLocation;
@@ -938,6 +1118,8 @@ declare namespace gapi.client {
       columnBreak?: ColumnBreak;
       /** A paragraph element that represents a date. */
       dateElement?: DateElement;
+      /** A paragraph element that represents a dropdown menu. */
+      dropdown?: Dropdown;
       /** The zero-base end index of this paragraph element, exclusive, in UTF-16 code units. */
       endIndex?: number;
       /** An equation paragraph element. */
@@ -1137,6 +1319,52 @@ declare namespace gapi.client {
       /** A mask that indicates which of the fields in positioning have been changed in this suggestion. */
       positioningSuggestionState?: PositionedObjectPositioningSuggestionState;
     }
+    interface Post {
+      /** 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. */
+      assigneeEmail?: string;
+      /** Output only. The user who created the post. */
+      author?: PostAuthor;
+      /** Optional. The action type for comment posts. */
+      commentAction?:
+        | 'COMMENT_ACTION_TYPE_UNSPECIFIED'
+        | 'NO_COMMENT_ACTION_CHANGE'
+        | 'RESOLVE'
+        | 'REOPEN';
+      /** 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. */
+      content?: string;
+      /** Output only. The content of the post as HTML. */
+      contentHtml?: string;
+      /** Output only. The time the post was created. */
+      createTime?: string;
+      /** Output only. Whether the post is deleted. If `true`, content and author fields will be empty. */
+      deleted?: boolean;
+      /** Output only. Whether the post is from a copied document. This field cannot be set directly by callers. */
+      fromCopiedDocument?: boolean;
+      /** Output only. Whether the post is from a document comparison. This field cannot be set directly by callers. */
+      fromDocumentComparison?: boolean;
+      /** Output only. Whether the post is from an imported document. This field cannot be set directly by callers. */
+      fromImportedDocument?: boolean;
+      /** Output only. The unique ID of the post. */
+      postId?: string;
+      /** Output only. The action type for suggestion posts. */
+      suggestionAction?:
+        | 'SUGGESTION_ACTION_TYPE_UNSPECIFIED'
+        | 'NO_SUGGESTION_ACTION_CHANGE'
+        | 'ACCEPT'
+        | 'REJECT';
+      /** Output only. The time the post was last updated. */
+      updateTime?: string;
+    }
+    interface PostAuthor {
+      /** Whether the user is anonymous. */
+      anonymous?: boolean;
+      /** The display name of the user. May be absent if the author is anonymous. */
+      displayName?: string;
+      /** Whether the user is the authenticated user making the request. */
+      me?: boolean;
+      /** 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. */
+      user?: string;
+    }
     interface Range {
       /** 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. */
       endIndex?: number;
@@ -1147,6 +1375,10 @@ declare namespace gapi.client {
       /** 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. */
       tabId?: string;
     }
+    interface RejectSuggestionRequest {
+      /** The ID of the suggestion. */
+      suggestionId?: string;
+    }
     interface ReplaceAllTextRequest {
       /** Finds text in the document matching this substring. */
       containsText?: SubstringMatchCriteria;
@@ -1180,8 +1412,14 @@ declare namespace gapi.client {
       text?: string;
     }
     interface Request {
+      /** Accepts a suggestion. [Developer Preview](https://developers.google.com/workspace/preview). */
+      acceptSuggestion?: AcceptSuggestionRequest;
+      /** Adds a reply to a CommentThread or SuggestionThread. [Developer Preview](https://developers.google.com/workspace/preview). */
+      addCommentReply?: AddCommentReplyRequest;
       /** Adds a document tab. */
       addDocumentTab?: AddDocumentTabRequest;
+      /** Creates a DropdownDefinition. */
+      createDropdownDefinition?: CreateDropdownDefinitionRequest;
       /** Creates a footer. */
       createFooter?: CreateFooterRequest;
       /** Creates a footnote. */
@@ -1192,8 +1430,14 @@ declare namespace gapi.client {
       createNamedRange?: CreateNamedRangeRequest;
       /** Creates bullets for paragraphs. */
       createParagraphBullets?: CreateParagraphBulletsRequest;
+      /** Deletes a CommentThread. [Developer Preview](https://developers.google.com/workspace/preview). */
+      deleteComment?: DeleteCommentRequest;
+      /** Deletes a reply Post from a CommentThread or SuggestionThread. [Developer Preview](https://developers.google.com/workspace/preview). */
+      deleteCommentReply?: DeleteCommentReplyRequest;
       /** Deletes content from the document. */
       deleteContentRange?: DeleteContentRangeRequest;
+      /** Deletes a DropdownDefinition. */
+      deleteDropdownDefinition?: DeleteDropdownDefinitionRequest;
       /** Deletes a footer from the document. */
       deleteFooter?: DeleteFooterRequest;
       /** Deletes a header from the document. */
@@ -1204,14 +1448,20 @@ declare namespace gapi.client {
       deleteParagraphBullets?: DeleteParagraphBulletsRequest;
       /** Deletes a positioned object from the document. */
       deletePositionedObject?: DeletePositionedObjectRequest;
+      /** Deletes a suggestion. [Developer Preview](https://developers.google.com/workspace/preview). */
+      deleteSuggestion?: DeleteSuggestionRequest;
       /** Deletes a document tab. */
       deleteTab?: DeleteTabRequest;
       /** Deletes a column from a table. */
       deleteTableColumn?: DeleteTableColumnRequest;
       /** Deletes a row from a table. */
       deleteTableRow?: DeleteTableRowRequest;
+      /** Inserts a CommentThread into the document. [Developer Preview](https://developers.google.com/workspace/preview). */
+      insertComment?: InsertCommentRequest;
       /** Inserts a date. */
       insertDate?: InsertDateRequest;
+      /** Inserts a Dropdown at the specified location. */
+      insertDropdown?: InsertDropdownRequest;
       /** Inserts an inline image at the specified location. */
       insertInlineImage?: InsertInlineImageRequest;
       /** Inserts a page break at the specified location. */
@@ -1234,6 +1484,8 @@ declare namespace gapi.client {
       mergeTableCells?: MergeTableCellsRequest;
       /** Updates the number of pinned header rows in a table. */
       pinTableHeaderRows?: PinTableHeaderRowsRequest;
+      /** Rejects a suggestion. [Developer Preview](https://developers.google.com/workspace/preview). */
+      rejectSuggestion?: RejectSuggestionRequest;
       /** Replaces all instances of the specified text. */
       replaceAllText?: ReplaceAllTextRequest;
       /** Replaces an image in the document. */
@@ -1242,10 +1494,16 @@ declare namespace gapi.client {
       replaceNamedRangeContent?: ReplaceNamedRangeContentRequest;
       /** Unmerges cells in a table. */
       unmergeTableCells?: UnmergeTableCellsRequest;
+      /** Updates an existing post (head post or reply) of a CommentThread or SuggestionThread. [Developer Preview](https://developers.google.com/workspace/preview). */
+      updateCommentPost?: UpdateCommentPostRequest;
       /** Updates the style of the document. */
       updateDocumentStyle?: UpdateDocumentStyleRequest;
       /** Updates the properties of a document tab. */
       updateDocumentTabProperties?: UpdateDocumentTabPropertiesRequest;
+      /** Updates the properties of a DropdownDefinition. */
+      updateDropdownDefinitionProperties?: UpdateDropdownDefinitionPropertiesRequest;
+      /** Updates the properties of a Dropdown. */
+      updateDropdownProperties?: UpdateDropdownPropertiesRequest;
       /** Updates a named style. */
       updateNamedStyle?: UpdateNamedStyleRequest;
       /** Updates the paragraph style at the specified range. */
@@ -1262,8 +1520,12 @@ declare namespace gapi.client {
       updateTextStyle?: UpdateTextStyleRequest;
     }
     interface Response {
+      /** The result of adding a reply to a comment or suggestion. [Developer Preview](https://developers.google.com/workspace/preview). */
+      addCommentReply?: AddCommentReplyResponse;
       /** The result of adding a document tab. */
       addDocumentTab?: AddDocumentTabResponse;
+      /** The result of creating a dropdown definition. */
+      createDropdownDefinition?: CreateDropdownDefinitionResponse;
       /** The result of creating a footer. */
       createFooter?: CreateFooterResponse;
       /** The result of creating a footnote. */
@@ -1272,6 +1534,10 @@ declare namespace gapi.client {
       createHeader?: CreateHeaderResponse;
       /** The result of creating a named range. */
       createNamedRange?: CreateNamedRangeResponse;
+      /** The result of inserting a comment. [Developer Preview](https://developers.google.com/workspace/preview). */
+      insertComment?: InsertCommentResponse;
+      /** The result of inserting a dropdown. */
+      insertDropdown?: InsertDropdownResponse;
       /** The result of inserting an inline image. */
       insertInlineImage?: InsertInlineImageResponse;
       /** The result of inserting an inline Google Sheets chart. */
@@ -1437,6 +1703,18 @@ declare namespace gapi.client {
       /** A mask that indicates which of the fields on the base DocumentStyle have been changed in this suggestion. */
       documentStyleSuggestionState?: DocumentStyleSuggestionState;
     }
+    interface SuggestedDropdownDefinitionProperties {
+      /** A DropdownDefinitionProperties that only includes the changes made in this suggestion. This can be used along with the dropdown_definition_properties_suggestion_state to see which fields have changed and their new values. */
+      dropdownDefinitionProperties?: DropdownDefinitionProperties;
+      /** A mask that indicates which of the fields on the base DropdownDefinitionProperties have been changed in this suggestion. */
+      dropdownDefinitionPropertiesSuggestionState?: DropdownDefinitionPropertiesSuggestionState;
+    }
+    interface SuggestedDropdownProperties {
+      /** A DropdownProperties that only includes the changes made in this suggestion. This can be used along with the dropdown_properties_suggestion_state to see which fields have changed and their new values. */
+      dropdownProperties?: DropdownProperties;
+      /** A mask that indicates which of the fields on the base DropdownProperties have been changed in this suggestion. */
+      dropdownPropertiesSuggestionState?: DropdownPropertiesSuggestionState;
+    }
     interface SuggestedInlineObjectProperties {
       /** An InlineObjectProperties that only includes the changes made in this suggestion. This can be used along with the inline_object_properties_suggestion_state to see which fields have changed and their new values. */
       inlineObjectProperties?: InlineObjectProperties;
@@ -1485,6 +1763,32 @@ declare namespace gapi.client {
       /** A mask that indicates which of the fields on the base TextStyle have been changed in this suggestion. */
       textStyleSuggestionState?: TextStyleSuggestionState;
     }
+    interface SuggestionResponse {
+      /** The IDs of suggestions which were accepted during the update. */
+      acceptedSuggestionIds?: string[];
+      /** The IDs of suggestions which were created during the update. */
+      createdSuggestionIds?: string[];
+      /** The IDs of suggestions which were deleted during the update. */
+      deletedSuggestionIds?: string[];
+      /** The IDs of suggestions which were rejected during the update. */
+      rejectedSuggestionIds?: string[];
+      /** The IDs of suggestions whose summaries were updated during the update. */
+      updatedSummarySuggestionIds?: string[];
+    }
+    interface SuggestionThread {
+      /** The first post in the thread. */
+      headPost?: Post;
+      /** Replies to the head post. */
+      replies?: Post[];
+      /** Whether the thread is open, accepted, or rejected. */
+      status?: 'STATUS_UNSPECIFIED' | 'OPEN' | 'ACCEPTED' | 'REJECTED';
+      /** The unique ID of the suggestion. */
+      suggestionId?: string;
+      /** Summary of the suggested differences in the document, in HTML. May be empty. */
+      summaryHtml?: string;
+      /** Summary of the suggested differences in the document, in plain text. May be empty. */
+      summaryText?: string;
+    }
     interface Tab {
       /** The child tabs nested within this tab. */
       childTabs?: Tab[];
@@ -1740,6 +2044,16 @@ declare namespace gapi.client {
       /** The table range specifying which cells of the table to unmerge. All merged cells in this range will be unmerged, and cells that are already unmerged will not be affected. If the range has no merged cells, the request will do nothing. If there is text in any of the merged cells, the text will remain in the "head" cell of the resulting block of unmerged cells. The "head" cell is the upper-left cell when the content direction is from left to right, and the upper-right otherwise. */
       tableRange?: TableRange;
     }
+    interface UpdateCommentPostRequest {
+      /** The ID of the CommentThread which the post belongs to. */
+      commentId?: string;
+      /** 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. */
+      content?: string;
+      /** The ID of the post being updated. */
+      postId?: string;
+      /** The ID of the SuggestionThread which the post belongs to. */
+      suggestionId?: string;
+    }
     interface UpdateDocumentStyleRequest {
       /** The styles to set on the document. Certain document style changes may cause other changes in order to mirror the behavior of the Docs editor. See the documentation of DocumentStyle for more information. */
       documentStyle?: DocumentStyle;
@@ -1754,6 +2068,28 @@ declare namespace gapi.client {
       /** The tab properties to update. */
       tabProperties?: TabProperties;
     }
+    interface UpdateDropdownDefinitionPropertiesRequest {
+      /** The ID of the DropdownDefinition to update. */
+      dropdownDefinitionId?: string;
+      /** The properties to update. */
+      dropdownDefinitionProperties?: DropdownDefinitionProperties;
+      /** 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`. */
+      fields?: string;
+      /** 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"}`. */
+      selectedOptionIdReplacements?: {[P in string]: string};
+      /** 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. */
+      tabId?: string;
+    }
+    interface UpdateDropdownPropertiesRequest {
+      /** Required. The Dropdown ID. */
+      dropdownId?: string;
+      /** The properties to update. */
+      dropdownProperties?: DropdownProperties;
+      /** 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. */
+      fields?: string;
+      /** 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. */
+      tabId?: string;
+    }
     interface UpdateNamedStyleRequest {
       /** The NamedStyle fields that should be updated. At least `named_style_type` must be specified. The root `named_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 include `"text_style"` and `"text_style.bold"`. To update the paragraph style's alignment property, set `fields` to include `"paragraph_style"` and `"paragraph_style.alignment"`. To reset a property to its default value, include its field name in the field mask but leave the field itself unset. Specifying `"text_style"` or `"paragraph_style"` with an empty TextStyle or ParagraphStyle will reset all of its nested fields. */
       fields?: string;
@@ -1827,6 +2163,8 @@ declare namespace gapi.client {
       requiredRevisionId?: string;
       /** 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. */
       targetRevisionId?: string;
+      /** 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). */
+      writeMode?: 'WRITE_MODE_UNSPECIFIED' | 'EDIT' | 'SUGGEST';
     }
     interface DocumentsResource {
       /** Applies one or more updates to the document. Each request is validated before being applied. If any request is not valid, then the entire request will fail and nothing will be applied. Some requests have replies to give you some information about how they are applied. Other requests do not need to return information; these each return an empty reply. The order of replies matches that of the requests. For example, suppose you call batchUpdate with four updates, and only the third one returns information. The response would have two empty replies, the reply to the third request, and another empty reply, in that order. Because other users may be editing the document, the document might not exactly reflect your changes: your changes may be altered with respect to collaborator changes. If there are no collaborators, the document should reflect your changes. In any case, the updates in your request are guaranteed to be applied together atomically. */
@@ -1951,6 +2289,12 @@ declare namespace gapi.client {
         alt?: 'json' | 'media' | 'proto';
         /** JSONP */
         callback?: string;
+        /** The comments view mode to apply to the document. This allows viewing the document with comments omitted or included. If one is not specified, COMMENTS_VIEW_MODE_OMITTED is used. If you set comments_view_mode to any value, you must also set include_tabs_content to `true` or use a field mask that references the Document.tabs field (or any subfield). If you set comments_view_mode to COMMENTS_VIEW_MODE_INCLUDED, you must also explicitly set suggestions_view_mode to SUGGESTIONS_INLINE. If you set comments_view_mode to COMMENTS_VIEW_MODE_INCLUDED or COMMENTS_VIEW_MODE_DEFAULT_FOR_CURRENT_ACCESS, you may not set suggestions_view_mode to PREVIEW_WITHOUT_SUGGESTIONS or PREVIEW_SUGGESTIONS_ACCEPTED. [Developer Preview](https://developers.google.com/workspace/preview). */
+        commentsViewMode?:
+          | 'COMMENTS_VIEW_MODE_UNSPECIFIED'
+          | 'COMMENTS_VIEW_MODE_DEFAULT_FOR_CURRENT_ACCESS'
+          | 'COMMENTS_VIEW_MODE_OMITTED'
+          | 'COMMENTS_VIEW_MODE_INCLUDED';
         /** The ID of the document to retrieve. */
         documentId: string;
         /** Selector specifying which fields to include in a partial response. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maxim_mazurok/gapi.client.docs-v1",
-  "version": "0.4.20260909",
+  "version": "0.4.20260928",
   "description": "TypeScript typings for Google Docs API v1",
   "repository": {
     "type": "git",