@googleapis/docs 3.0.2 → 3.1.0

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [3.1.0](https://github.com/googleapis/google-api-nodejs-client/compare/docs-v3.0.2...docs-v3.1.0) (2024-08-16)
+
+
+### Features
+
+* **docs:** update the API ([0736162](https://github.com/googleapis/google-api-nodejs-client/commit/07361625ae5b3bfee8e3e556b766a83f4c020854))
+
 ## [3.0.2](https://github.com/googleapis/google-api-nodejs-client/compare/docs-v3.0.1...docs-v3.0.2) (2024-05-02)
 
 

package/build/v1.d.ts

@@ -155,6 +155,19 @@ export declare namespace docs_v1 {
          */
         content?: Schema$StructuralElement[];
     }
+    /**
+     * A reference to a bookmark in this document.
+     */
+    export interface Schema$BookmarkLink {
+        /**
+         * The ID of a bookmark in this document.
+         */
+        id?: string | null;
+        /**
+         * The ID of the tab containing this bookmark.
+         */
+        tabId?: string | null;
+    }
     /**
      * Describes the bullet of a paragraph.
      */
@@ -389,6 +402,10 @@ export declare namespace docs_v1 {
          * 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 | null;
+        /**
+         * The tab that contains the footer to delete. When omitted, the request is applied to the first tab. In a document containing a single tab: - If provided, must match the singular tab's ID. - If omitted, the request applies to the singular tab. In a document containing multiple tabs: - If provided, the request applies to the specified tab. - If omitted, the request applies to the first tab in the document.
+         */
+        tabId?: string | null;
     }
     /**
      * Deletes a Header from the document.
@@ -398,6 +415,10 @@ export declare namespace docs_v1 {
          * The id of the header to delete. If this header is defined on DocumentStyle, the reference to this header is removed, resulting in no header of that type for the first section of the document. If this header is defined on a SectionStyle, the reference to this header is removed and the header of that type is now continued from the previous section.
          */
         headerId?: string | null;
+        /**
+         * The tab containing the header to delete. When omitted, the request is applied to the first tab. In a document containing a single tab: - If provided, must match the singular tab's ID. - If omitted, the request applies to the singular tab. In a document containing multiple tabs: - If provided, the request applies to the specified tab. - If omitted, the request applies to the first tab in the document.
+         */
+        tabId?: string | null;
     }
     /**
      * Deletes a NamedRange.
@@ -411,6 +432,10 @@ export declare namespace docs_v1 {
          * The ID of the named range to delete.
          */
         namedRangeId?: string | null;
+        /**
+         * Optional. The criteria used to specify which tab(s) the range deletion should occur in. When omitted, the range deletion is applied to all tabs. In a document containing a single tab: - If provided, must match the singular tab's ID. - If omitted, the range deletion applies to the singular tab. In a document containing multiple tabs: - If provided, the range deletion applies to the specified tabs. - If not provided, the range deletion applies to all tabs.
+         */
+        tabsCriteria?: Schema$TabsCriteria;
     }
     /**
      * Deletes bullets from all of the paragraphs that overlap with the given range. The nesting level of each paragraph will be visually preserved by adding indent to the start of the corresponding paragraph.
@@ -429,6 +454,10 @@ export declare namespace docs_v1 {
          * The ID of the positioned object to delete.
          */
         objectId?: string | null;
+        /**
+         * 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 | null;
     }
     /**
      * Deletes a column from a table.
@@ -466,7 +495,7 @@ export declare namespace docs_v1 {
      */
     export interface Schema$Document {
         /**
-         * Output only. The main body of the 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?: Schema$Body;
         /**
@@ -474,51 +503,51 @@ export declare namespace docs_v1 {
          */
         documentId?: string | null;
         /**
-         * Output only. The style of the document.
+         * 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.
          */
         documentStyle?: Schema$DocumentStyle;
         /**
-         * Output only. The footers in the document, keyed by footer ID.
+         * Output only. The footers in the document, keyed by footer ID. Legacy field: Instead, use Document.tabs.documentTab.footers, which exposes the actual document content from all tabs when the includeTabsContent parameter is set to `true`. If `false` or unset, this field contains information about the first tab in the document.
          */
         footers?: {
             [key: string]: Schema$Footer;
         } | null;
         /**
-         * Output only. The footnotes in the document, keyed by footnote ID.
+         * Output only. The footnotes in the document, keyed by footnote ID. Legacy field: Instead, use Document.tabs.documentTab.footnotes, which exposes the actual document content from all tabs when the includeTabsContent parameter is set to `true`. If `false` or unset, this field contains information about the first tab in the document.
          */
         footnotes?: {
             [key: string]: Schema$Footnote;
         } | null;
         /**
-         * Output only. The headers in the document, keyed by header ID.
+         * Output only. The headers in the document, keyed by header ID. Legacy field: Instead, use Document.tabs.documentTab.headers, which exposes the actual document content from all tabs when the includeTabsContent parameter is set to `true`. If `false` or unset, this field contains information about the first tab in the document.
          */
         headers?: {
             [key: string]: Schema$Header;
         } | null;
         /**
-         * Output only. The inline objects in the document, keyed by object ID.
+         * Output only. The inline objects in the document, keyed by object ID. Legacy field: Instead, use Document.tabs.documentTab.inlineObjects, which exposes the actual document content from all tabs when the includeTabsContent parameter is set to `true`. If `false` or unset, this field contains information about the first tab in the document.
          */
         inlineObjects?: {
             [key: string]: Schema$InlineObject;
         } | null;
         /**
-         * Output only. The lists in the document, keyed by list ID.
+         * Output only. The lists in the document, keyed by list ID. Legacy field: Instead, use Document.tabs.documentTab.lists, which exposes the actual document content from all tabs when the includeTabsContent parameter is set to `true`. If `false` or unset, this field contains information about the first tab in the document.
          */
         lists?: {
             [key: string]: Schema$List;
         } | null;
         /**
-         * Output only. The named ranges in the document, keyed by name.
+         * Output only. The named ranges in the document, keyed by name. Legacy field: Instead, use Document.tabs.documentTab.namedRanges, which exposes the actual document content from all tabs when the includeTabsContent parameter is set to `true`. If `false` or unset, this field contains information about the first tab in the document.
          */
         namedRanges?: {
             [key: string]: Schema$NamedRanges;
         } | null;
         /**
-         * Output only. The named styles of the document.
+         * Output only. The named styles of the document. Legacy field: Instead, use Document.tabs.documentTab.namedStyles, 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.
          */
         namedStyles?: Schema$NamedStyles;
         /**
-         * Output only. The positioned objects in the document, keyed by object ID.
+         * Output only. The positioned objects in the document, keyed by object ID. Legacy field: Instead, use Document.tabs.documentTab.positionedObjects, which exposes the actual document content from all tabs when the includeTabsContent parameter is set to `true`. If `false` or unset, this field contains information about the first tab in the document.
          */
         positionedObjects?: {
             [key: string]: Schema$PositionedObject;
@@ -528,13 +557,13 @@ export declare namespace docs_v1 {
          */
         revisionId?: string | null;
         /**
-         * Output only. The suggested changes to the style of the document, keyed by suggestion ID.
+         * Output only. The suggested changes to the style of the document, keyed by suggestion ID. Legacy field: Instead, use Document.tabs.documentTab.suggestedDocumentStyleChanges, which exposes the actual document content from all tabs when the includeTabsContent parameter is set to `true`. If `false` or unset, this field contains information about the first tab in the document.
          */
         suggestedDocumentStyleChanges?: {
             [key: string]: Schema$SuggestedDocumentStyle;
         } | null;
         /**
-         * Output only. The suggested changes to the named styles of the document, keyed by suggestion ID.
+         * 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?: {
             [key: string]: Schema$SuggestedNamedStyles;
@@ -543,6 +572,10 @@ export declare namespace docs_v1 {
          * 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?: string | null;
+        /**
+         * Tabs that are part of a document. Tabs can contain child tabs, a tab nested within another tab. Child tabs are represented by the Tab.childTabs field.
+         */
+        tabs?: Schema$Tab[];
         /**
          * The title of the document.
          */
@@ -710,6 +743,77 @@ export declare namespace docs_v1 {
          */
         useFirstPageHeaderFooterSuggested?: boolean | null;
     }
+    /**
+     * A tab with document contents.
+     */
+    export interface Schema$DocumentTab {
+        /**
+         * The main body of the document tab.
+         */
+        body?: Schema$Body;
+        /**
+         * The style of the document tab.
+         */
+        documentStyle?: Schema$DocumentStyle;
+        /**
+         * The footers in the document tab, keyed by footer ID.
+         */
+        footers?: {
+            [key: string]: Schema$Footer;
+        } | null;
+        /**
+         * The footnotes in the document tab, keyed by footnote ID.
+         */
+        footnotes?: {
+            [key: string]: Schema$Footnote;
+        } | null;
+        /**
+         * The headers in the document tab, keyed by header ID.
+         */
+        headers?: {
+            [key: string]: Schema$Header;
+        } | null;
+        /**
+         * The inline objects in the document tab, keyed by object ID.
+         */
+        inlineObjects?: {
+            [key: string]: Schema$InlineObject;
+        } | null;
+        /**
+         * The lists in the document tab, keyed by list ID.
+         */
+        lists?: {
+            [key: string]: Schema$List;
+        } | null;
+        /**
+         * The named ranges in the document tab, keyed by name.
+         */
+        namedRanges?: {
+            [key: string]: Schema$NamedRanges;
+        } | null;
+        /**
+         * The named styles of the document tab.
+         */
+        namedStyles?: Schema$NamedStyles;
+        /**
+         * The positioned objects in the document tab, keyed by object ID.
+         */
+        positionedObjects?: {
+            [key: string]: Schema$PositionedObject;
+        } | null;
+        /**
+         * The suggested changes to the style of the document tab, keyed by suggestion ID.
+         */
+        suggestedDocumentStyleChanges?: {
+            [key: string]: Schema$SuggestedDocumentStyle;
+        } | null;
+        /**
+         * The suggested changes to the named styles of the document tab, keyed by suggestion ID.
+         */
+        suggestedNamedStylesChanges?: {
+            [key: string]: Schema$SuggestedNamedStyles;
+        } | null;
+    }
     /**
      * 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.
      */
@@ -868,6 +972,10 @@ export declare namespace docs_v1 {
          * The ID of the header, footer or footnote the location is in. An empty segment ID signifies the document's body.
          */
         segmentId?: string | null;
+        /**
+         * The tab that the location is in. When omitted, the request is applied to the first tab. In a document containing a single tab: - If provided, must match the singular tab's ID. - If omitted, the request applies to the singular tab. In a document containing multiple tabs: - If provided, the request applies to the specified tab. - If omitted, the request applies to the first tab in the document.
+         */
+        tabId?: string | null;
     }
     /**
      * A ParagraphElement representing an equation.
@@ -952,6 +1060,19 @@ export declare namespace docs_v1 {
          */
         headerId?: string | null;
     }
+    /**
+     * A reference to a heading in this document.
+     */
+    export interface Schema$HeadingLink {
+        /**
+         * The ID of a heading in this document.
+         */
+        id?: string | null;
+        /**
+         * The ID of the tab containing this heading.
+         */
+        tabId?: string | null;
+    }
     /**
      * A ParagraphElement representing a horizontal line.
      */
@@ -1251,13 +1372,25 @@ export declare namespace docs_v1 {
      */
     export interface Schema$Link {
         /**
-         * The ID of a bookmark in this document.
+         * A bookmark in this document. In documents containing a single tab, links to bookmarks within the singular tab continue to return Link.bookmarkId when the includeTabsContent parameter is set to `false` or unset. Otherwise, this field is returned.
+         */
+        bookmark?: Schema$BookmarkLink;
+        /**
+         * The ID of a bookmark in this document. Legacy field: Instead, set includeTabsContent to `true` and use Link.bookmark for read and write operations. This field is only returned when includeTabsContent is set to `false` in documents containing a single tab and links to a bookmark within the singular tab. Otherwise, Link.bookmark is returned. If this field is used in a write request, the bookmark is considered to be from the tab ID specified in the request. If a tab ID is not specified in the request, it is considered to be from the first tab in the document.
          */
         bookmarkId?: string | null;
         /**
-         * The ID of a heading in this document.
+         * A heading in this document. In documents containing a single tab, links to headings within the singular tab continue to return Link.headingId when the includeTabsContent parameter is set to `false` or unset. Otherwise, this field is returned.
+         */
+        heading?: Schema$HeadingLink;
+        /**
+         * The ID of a heading in this document. Legacy field: Instead, set includeTabsContent to `true` and use Link.heading for read and write operations. This field is only returned when includeTabsContent is set to `false` in documents containing a single tab and links to a heading within the singular tab. Otherwise, Link.heading is returned. If this field is used in a write request, the heading is considered to be from the tab ID specified in the request. If a tab ID is not specified in the request, it is considered to be from the first tab in the document.
          */
         headingId?: string | null;
+        /**
+         * The ID of a tab in this document.
+         */
+        tabId?: string | null;
         /**
          * An external URL.
          */
@@ -1334,6 +1467,10 @@ export declare namespace docs_v1 {
          * The ID of the header, footer or footnote the location is in. An empty segment ID signifies the document's body.
          */
         segmentId?: string | null;
+        /**
+         * The tab that the location is in. When omitted, the request is applied to the first tab. In a document containing a single tab: - If provided, must match the singular tab's ID. - If omitted, the request applies to the singular tab. In a document containing multiple tabs: - If provided, the request applies to the specified tab. - If omitted, the request applies to the first tab in the document.
+         */
+        tabId?: string | null;
     }
     /**
      * Merges cells in a Table.
@@ -1996,6 +2133,10 @@ export declare namespace docs_v1 {
          * The zero-based start index of this range, in UTF-16 code units. In all current uses, a start index must be provided. This field is an Int32Value in order to accommodate future use cases with open-ended ranges.
          */
         startIndex?: number | null;
+        /**
+         * 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 | null;
     }
     /**
      * Replaces all instances of text matching a criteria with replace text.
@@ -2009,6 +2150,10 @@ export declare namespace docs_v1 {
          * The text that will replace the matched text.
          */
         replaceText?: string | null;
+        /**
+         * Optional. The criteria used to specify in which tabs the replacement occurs. When omitted, the replacement applies to all tabs. In a document containing a single tab: - If provided, must match the singular tab's ID. - If omitted, the replacement applies to the singular tab. In a document containing multiple tabs: - If provided, the replacement applies to the specified tabs. - If omitted, the replacement applies to all tabs.
+         */
+        tabsCriteria?: Schema$TabsCriteria;
     }
     /**
      * The result of replacing text.
@@ -2031,6 +2176,10 @@ export declare namespace docs_v1 {
          * The replacement method.
          */
         imageReplaceMethod?: string | null;
+        /**
+         * The tab that the image to be replaced is in. When omitted, the request is applied to the first tab. In a document containing a single tab: - If provided, must match the singular tab's ID. - If omitted, the request applies to the singular tab. In a document containing multiple tabs: - If provided, the request applies to the specified tab. - If omitted, the request applies to the first tab in the document.
+         */
+        tabId?: string | null;
         /**
          * The URI of the new image. The image is fetched once at insertion time and a copy is stored for display inside the document. Images must be less than 50MB, cannot exceed 25 megapixels, and must be in PNG, JPEG, or GIF format. The provided URI can't surpass 2 KB in length. The URI is saved with the image, and exposed through the ImageProperties.source_uri field.
          */
@@ -2048,6 +2197,10 @@ export declare namespace docs_v1 {
          * The name of the NamedRanges whose content will be replaced. If there are multiple named ranges with the given name, then the content of each one will be replaced. If there are no named ranges with the given name, then the request will be a no-op.
          */
         namedRangeName?: string | null;
+        /**
+         * Optional. The criteria used to specify in which tabs the replacement occurs. When omitted, the replacement applies to all tabs. In a document containing a single tab: - If provided, must match the singular tab's ID. - If omitted, the replacement applies to the singular tab. In a document containing multiple tabs: - If provided, the replacement applies to the specified tabs. - If omitted, the replacement applies to all tabs.
+         */
+        tabsCriteria?: Schema$TabsCriteria;
         /**
          * Replaces the content of the specified named range(s) with the given text.
          */
@@ -2641,6 +2794,23 @@ export declare namespace docs_v1 {
          */
         textStyleSuggestionState?: Schema$TextStyleSuggestionState;
     }
+    /**
+     * A tab in a document.
+     */
+    export interface Schema$Tab {
+        /**
+         * The child tabs nested within this tab.
+         */
+        childTabs?: Schema$Tab[];
+        /**
+         * A tab with document contents, like text and images.
+         */
+        documentTab?: Schema$DocumentTab;
+        /**
+         * The properties of the tab, like ID and title.
+         */
+        tabProperties?: Schema$TabProperties;
+    }
     /**
      * A StructuralElement representing a table.
      */
@@ -2962,6 +3132,40 @@ export declare namespace docs_v1 {
          */
         tableColumnProperties?: Schema$TableColumnProperties[];
     }
+    /**
+     * Properties of a tab.
+     */
+    export interface Schema$TabProperties {
+        /**
+         * The zero-based index of the tab within the parent.
+         */
+        index?: number | null;
+        /**
+         * Output only. The depth of the tab within the document. Root-level tabs start at 0.
+         */
+        nestingLevel?: number | null;
+        /**
+         * Optional. The ID of the parent tab. Empty when the current tab is a root-level tab, which means it doesn't have any parents.
+         */
+        parentTabId?: string | null;
+        /**
+         * Output only. The ID of the tab. This field can't be changed.
+         */
+        tabId?: string | null;
+        /**
+         * The user-visible name of the tab.
+         */
+        title?: string | null;
+    }
+    /**
+     * A criteria that specifies in which tabs a request executes.
+     */
+    export interface Schema$TabsCriteria {
+        /**
+         * The list of tab IDs in which the request executes.
+         */
+        tabIds?: string[] | null;
+    }
     /**
      * A tab stop within a paragraph.
      */
@@ -3121,6 +3325,10 @@ export declare namespace docs_v1 {
          * The fields that should be updated. At least one field must be specified. The root `document_style` is implied and should not be specified. A single `"*"` can be used as short-hand for listing every field. For example to update the background, set `fields` to `"background"`.
          */
         fields?: string | null;
+        /**
+         * The tab that contains the style to update. When omitted, the request applies to the first tab. In a document containing a single tab: - If provided, must match the singular tab's ID. - If omitted, the request applies to the singular tab. In a document containing multiple tabs: - If provided, the request applies to the specified tab. - If not provided, the request applies to the first tab in the document.
+         */
+        tabId?: string | null;
     }
     /**
      * Update the styling of all paragraphs that overlap with the given range.
@@ -3329,6 +3537,10 @@ export declare namespace docs_v1 {
          * The ID of the document to retrieve.
          */
         documentId?: string;
+        /**
+         * Whether to populate the Document.tabs field instead of the text content fields like `body` and `documentStyle` on Document. - When `True`: Document content populates in the Document.tabs field instead of the text content fields in Document. - When `False`: The content of the document's first tab populates the content fields in Document excluding Document.tabs. If a document has only one tab, then that tab is used to populate the document content. Document.tabs will be empty.
+         */
+        includeTabsContent?: boolean;
         /**
          * The suggestions view mode to apply to the document. This allows viewing the document with all suggestions inline, accepted or rejected. If one is not specified, DEFAULT_FOR_CURRENT_ACCESS is used.
          */

package/build/v1.js.map

@@ -1 +1 @@
-{"version":3,"file":"v1.js","sourceRoot":"","sources":["../v1.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"v1.js","sourceRoot":"","sources":["../v1.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@googleapis/docs",
-  "version": "3.0.2",
+  "version": "3.1.0",
   "description": "docs",
   "main": "build/index.js",
   "types": "build/index.d.ts",

package/v1.ts

@@ -208,6 +208,19 @@ export namespace docs_v1 {
      */
     content?: Schema$StructuralElement[];
   }
+  /**
+   * A reference to a bookmark in this document.
+   */
+  export interface Schema$BookmarkLink {
+    /**
+     * The ID of a bookmark in this document.
+     */
+    id?: string | null;
+    /**
+     * The ID of the tab containing this bookmark.
+     */
+    tabId?: string | null;
+  }
   /**
    * Describes the bullet of a paragraph.
    */
@@ -442,6 +455,10 @@ export namespace docs_v1 {
      * 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 | null;
+    /**
+     * The tab that contains the footer to delete. When omitted, the request is applied to the first tab. In a document containing a single tab: - If provided, must match the singular tab's ID. - If omitted, the request applies to the singular tab. In a document containing multiple tabs: - If provided, the request applies to the specified tab. - If omitted, the request applies to the first tab in the document.
+     */
+    tabId?: string | null;
   }
   /**
    * Deletes a Header from the document.
@@ -451,6 +468,10 @@ export namespace docs_v1 {
      * The id of the header to delete. If this header is defined on DocumentStyle, the reference to this header is removed, resulting in no header of that type for the first section of the document. If this header is defined on a SectionStyle, the reference to this header is removed and the header of that type is now continued from the previous section.
      */
     headerId?: string | null;
+    /**
+     * The tab containing the header to delete. When omitted, the request is applied to the first tab. In a document containing a single tab: - If provided, must match the singular tab's ID. - If omitted, the request applies to the singular tab. In a document containing multiple tabs: - If provided, the request applies to the specified tab. - If omitted, the request applies to the first tab in the document.
+     */
+    tabId?: string | null;
   }
   /**
    * Deletes a NamedRange.
@@ -464,6 +485,10 @@ export namespace docs_v1 {
      * The ID of the named range to delete.
      */
     namedRangeId?: string | null;
+    /**
+     * Optional. The criteria used to specify which tab(s) the range deletion should occur in. When omitted, the range deletion is applied to all tabs. In a document containing a single tab: - If provided, must match the singular tab's ID. - If omitted, the range deletion applies to the singular tab. In a document containing multiple tabs: - If provided, the range deletion applies to the specified tabs. - If not provided, the range deletion applies to all tabs.
+     */
+    tabsCriteria?: Schema$TabsCriteria;
   }
   /**
    * Deletes bullets from all of the paragraphs that overlap with the given range. The nesting level of each paragraph will be visually preserved by adding indent to the start of the corresponding paragraph.
@@ -482,6 +507,10 @@ export namespace docs_v1 {
      * The ID of the positioned object to delete.
      */
     objectId?: string | null;
+    /**
+     * 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 | null;
   }
   /**
    * Deletes a column from a table.
@@ -519,7 +548,7 @@ export namespace docs_v1 {
    */
   export interface Schema$Document {
     /**
-     * Output only. The main body of the 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?: Schema$Body;
     /**
@@ -527,39 +556,39 @@ export namespace docs_v1 {
      */
     documentId?: string | null;
     /**
-     * Output only. The style of the document.
+     * 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.
      */
     documentStyle?: Schema$DocumentStyle;
     /**
-     * Output only. The footers in the document, keyed by footer ID.
+     * Output only. The footers in the document, keyed by footer ID. Legacy field: Instead, use Document.tabs.documentTab.footers, which exposes the actual document content from all tabs when the includeTabsContent parameter is set to `true`. If `false` or unset, this field contains information about the first tab in the document.
      */
     footers?: {[key: string]: Schema$Footer} | null;
     /**
-     * Output only. The footnotes in the document, keyed by footnote ID.
+     * Output only. The footnotes in the document, keyed by footnote ID. Legacy field: Instead, use Document.tabs.documentTab.footnotes, which exposes the actual document content from all tabs when the includeTabsContent parameter is set to `true`. If `false` or unset, this field contains information about the first tab in the document.
      */
     footnotes?: {[key: string]: Schema$Footnote} | null;
     /**
-     * Output only. The headers in the document, keyed by header ID.
+     * Output only. The headers in the document, keyed by header ID. Legacy field: Instead, use Document.tabs.documentTab.headers, which exposes the actual document content from all tabs when the includeTabsContent parameter is set to `true`. If `false` or unset, this field contains information about the first tab in the document.
      */
     headers?: {[key: string]: Schema$Header} | null;
     /**
-     * Output only. The inline objects in the document, keyed by object ID.
+     * Output only. The inline objects in the document, keyed by object ID. Legacy field: Instead, use Document.tabs.documentTab.inlineObjects, which exposes the actual document content from all tabs when the includeTabsContent parameter is set to `true`. If `false` or unset, this field contains information about the first tab in the document.
      */
     inlineObjects?: {[key: string]: Schema$InlineObject} | null;
     /**
-     * Output only. The lists in the document, keyed by list ID.
+     * Output only. The lists in the document, keyed by list ID. Legacy field: Instead, use Document.tabs.documentTab.lists, which exposes the actual document content from all tabs when the includeTabsContent parameter is set to `true`. If `false` or unset, this field contains information about the first tab in the document.
      */
     lists?: {[key: string]: Schema$List} | null;
     /**
-     * Output only. The named ranges in the document, keyed by name.
+     * Output only. The named ranges in the document, keyed by name. Legacy field: Instead, use Document.tabs.documentTab.namedRanges, which exposes the actual document content from all tabs when the includeTabsContent parameter is set to `true`. If `false` or unset, this field contains information about the first tab in the document.
      */
     namedRanges?: {[key: string]: Schema$NamedRanges} | null;
     /**
-     * Output only. The named styles of the document.
+     * Output only. The named styles of the document. Legacy field: Instead, use Document.tabs.documentTab.namedStyles, 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.
      */
     namedStyles?: Schema$NamedStyles;
     /**
-     * Output only. The positioned objects in the document, keyed by object ID.
+     * Output only. The positioned objects in the document, keyed by object ID. Legacy field: Instead, use Document.tabs.documentTab.positionedObjects, which exposes the actual document content from all tabs when the includeTabsContent parameter is set to `true`. If `false` or unset, this field contains information about the first tab in the document.
      */
     positionedObjects?: {[key: string]: Schema$PositionedObject} | null;
     /**
@@ -567,13 +596,13 @@ export namespace docs_v1 {
      */
     revisionId?: string | null;
     /**
-     * Output only. The suggested changes to the style of the document, keyed by suggestion ID.
+     * Output only. The suggested changes to the style of the document, keyed by suggestion ID. Legacy field: Instead, use Document.tabs.documentTab.suggestedDocumentStyleChanges, which exposes the actual document content from all tabs when the includeTabsContent parameter is set to `true`. If `false` or unset, this field contains information about the first tab in the document.
      */
     suggestedDocumentStyleChanges?: {
       [key: string]: Schema$SuggestedDocumentStyle;
     } | null;
     /**
-     * Output only. The suggested changes to the named styles of the document, keyed by suggestion ID.
+     * 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?: {
       [key: string]: Schema$SuggestedNamedStyles;
@@ -582,6 +611,10 @@ export namespace docs_v1 {
      * 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?: string | null;
+    /**
+     * Tabs that are part of a document. Tabs can contain child tabs, a tab nested within another tab. Child tabs are represented by the Tab.childTabs field.
+     */
+    tabs?: Schema$Tab[];
     /**
      * The title of the document.
      */
@@ -749,6 +782,63 @@ export namespace docs_v1 {
      */
     useFirstPageHeaderFooterSuggested?: boolean | null;
   }
+  /**
+   * A tab with document contents.
+   */
+  export interface Schema$DocumentTab {
+    /**
+     * The main body of the document tab.
+     */
+    body?: Schema$Body;
+    /**
+     * The style of the document tab.
+     */
+    documentStyle?: Schema$DocumentStyle;
+    /**
+     * The footers in the document tab, keyed by footer ID.
+     */
+    footers?: {[key: string]: Schema$Footer} | null;
+    /**
+     * The footnotes in the document tab, keyed by footnote ID.
+     */
+    footnotes?: {[key: string]: Schema$Footnote} | null;
+    /**
+     * The headers in the document tab, keyed by header ID.
+     */
+    headers?: {[key: string]: Schema$Header} | null;
+    /**
+     * The inline objects in the document tab, keyed by object ID.
+     */
+    inlineObjects?: {[key: string]: Schema$InlineObject} | null;
+    /**
+     * The lists in the document tab, keyed by list ID.
+     */
+    lists?: {[key: string]: Schema$List} | null;
+    /**
+     * The named ranges in the document tab, keyed by name.
+     */
+    namedRanges?: {[key: string]: Schema$NamedRanges} | null;
+    /**
+     * The named styles of the document tab.
+     */
+    namedStyles?: Schema$NamedStyles;
+    /**
+     * The positioned objects in the document tab, keyed by object ID.
+     */
+    positionedObjects?: {[key: string]: Schema$PositionedObject} | null;
+    /**
+     * The suggested changes to the style of the document tab, keyed by suggestion ID.
+     */
+    suggestedDocumentStyleChanges?: {
+      [key: string]: Schema$SuggestedDocumentStyle;
+    } | null;
+    /**
+     * The suggested changes to the named styles of the document tab, keyed by suggestion ID.
+     */
+    suggestedNamedStylesChanges?: {
+      [key: string]: Schema$SuggestedNamedStyles;
+    } | null;
+  }
   /**
    * 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.
    */
@@ -905,6 +995,10 @@ export namespace docs_v1 {
      * The ID of the header, footer or footnote the location is in. An empty segment ID signifies the document's body.
      */
     segmentId?: string | null;
+    /**
+     * The tab that the location is in. When omitted, the request is applied to the first tab. In a document containing a single tab: - If provided, must match the singular tab's ID. - If omitted, the request applies to the singular tab. In a document containing multiple tabs: - If provided, the request applies to the specified tab. - If omitted, the request applies to the first tab in the document.
+     */
+    tabId?: string | null;
   }
   /**
    * A ParagraphElement representing an equation.
@@ -989,6 +1083,19 @@ export namespace docs_v1 {
      */
     headerId?: string | null;
   }
+  /**
+   * A reference to a heading in this document.
+   */
+  export interface Schema$HeadingLink {
+    /**
+     * The ID of a heading in this document.
+     */
+    id?: string | null;
+    /**
+     * The ID of the tab containing this heading.
+     */
+    tabId?: string | null;
+  }
   /**
    * A ParagraphElement representing a horizontal line.
    */
@@ -1288,13 +1395,25 @@ export namespace docs_v1 {
    */
   export interface Schema$Link {
     /**
-     * The ID of a bookmark in this document.
+     * A bookmark in this document. In documents containing a single tab, links to bookmarks within the singular tab continue to return Link.bookmarkId when the includeTabsContent parameter is set to `false` or unset. Otherwise, this field is returned.
+     */
+    bookmark?: Schema$BookmarkLink;
+    /**
+     * The ID of a bookmark in this document. Legacy field: Instead, set includeTabsContent to `true` and use Link.bookmark for read and write operations. This field is only returned when includeTabsContent is set to `false` in documents containing a single tab and links to a bookmark within the singular tab. Otherwise, Link.bookmark is returned. If this field is used in a write request, the bookmark is considered to be from the tab ID specified in the request. If a tab ID is not specified in the request, it is considered to be from the first tab in the document.
      */
     bookmarkId?: string | null;
     /**
-     * The ID of a heading in this document.
+     * A heading in this document. In documents containing a single tab, links to headings within the singular tab continue to return Link.headingId when the includeTabsContent parameter is set to `false` or unset. Otherwise, this field is returned.
+     */
+    heading?: Schema$HeadingLink;
+    /**
+     * The ID of a heading in this document. Legacy field: Instead, set includeTabsContent to `true` and use Link.heading for read and write operations. This field is only returned when includeTabsContent is set to `false` in documents containing a single tab and links to a heading within the singular tab. Otherwise, Link.heading is returned. If this field is used in a write request, the heading is considered to be from the tab ID specified in the request. If a tab ID is not specified in the request, it is considered to be from the first tab in the document.
      */
     headingId?: string | null;
+    /**
+     * The ID of a tab in this document.
+     */
+    tabId?: string | null;
     /**
      * An external URL.
      */
@@ -1371,6 +1490,10 @@ export namespace docs_v1 {
      * The ID of the header, footer or footnote the location is in. An empty segment ID signifies the document's body.
      */
     segmentId?: string | null;
+    /**
+     * The tab that the location is in. When omitted, the request is applied to the first tab. In a document containing a single tab: - If provided, must match the singular tab's ID. - If omitted, the request applies to the singular tab. In a document containing multiple tabs: - If provided, the request applies to the specified tab. - If omitted, the request applies to the first tab in the document.
+     */
+    tabId?: string | null;
   }
   /**
    * Merges cells in a Table.
@@ -2031,6 +2154,10 @@ export namespace docs_v1 {
      * The zero-based start index of this range, in UTF-16 code units. In all current uses, a start index must be provided. This field is an Int32Value in order to accommodate future use cases with open-ended ranges.
      */
     startIndex?: number | null;
+    /**
+     * 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 | null;
   }
   /**
    * Replaces all instances of text matching a criteria with replace text.
@@ -2044,6 +2171,10 @@ export namespace docs_v1 {
      * The text that will replace the matched text.
      */
     replaceText?: string | null;
+    /**
+     * Optional. The criteria used to specify in which tabs the replacement occurs. When omitted, the replacement applies to all tabs. In a document containing a single tab: - If provided, must match the singular tab's ID. - If omitted, the replacement applies to the singular tab. In a document containing multiple tabs: - If provided, the replacement applies to the specified tabs. - If omitted, the replacement applies to all tabs.
+     */
+    tabsCriteria?: Schema$TabsCriteria;
   }
   /**
    * The result of replacing text.
@@ -2066,6 +2197,10 @@ export namespace docs_v1 {
      * The replacement method.
      */
     imageReplaceMethod?: string | null;
+    /**
+     * The tab that the image to be replaced is in. When omitted, the request is applied to the first tab. In a document containing a single tab: - If provided, must match the singular tab's ID. - If omitted, the request applies to the singular tab. In a document containing multiple tabs: - If provided, the request applies to the specified tab. - If omitted, the request applies to the first tab in the document.
+     */
+    tabId?: string | null;
     /**
      * The URI of the new image. The image is fetched once at insertion time and a copy is stored for display inside the document. Images must be less than 50MB, cannot exceed 25 megapixels, and must be in PNG, JPEG, or GIF format. The provided URI can't surpass 2 KB in length. The URI is saved with the image, and exposed through the ImageProperties.source_uri field.
      */
@@ -2083,6 +2218,10 @@ export namespace docs_v1 {
      * The name of the NamedRanges whose content will be replaced. If there are multiple named ranges with the given name, then the content of each one will be replaced. If there are no named ranges with the given name, then the request will be a no-op.
      */
     namedRangeName?: string | null;
+    /**
+     * Optional. The criteria used to specify in which tabs the replacement occurs. When omitted, the replacement applies to all tabs. In a document containing a single tab: - If provided, must match the singular tab's ID. - If omitted, the replacement applies to the singular tab. In a document containing multiple tabs: - If provided, the replacement applies to the specified tabs. - If omitted, the replacement applies to all tabs.
+     */
+    tabsCriteria?: Schema$TabsCriteria;
     /**
      * Replaces the content of the specified named range(s) with the given text.
      */
@@ -2676,6 +2815,23 @@ export namespace docs_v1 {
      */
     textStyleSuggestionState?: Schema$TextStyleSuggestionState;
   }
+  /**
+   * A tab in a document.
+   */
+  export interface Schema$Tab {
+    /**
+     * The child tabs nested within this tab.
+     */
+    childTabs?: Schema$Tab[];
+    /**
+     * A tab with document contents, like text and images.
+     */
+    documentTab?: Schema$DocumentTab;
+    /**
+     * The properties of the tab, like ID and title.
+     */
+    tabProperties?: Schema$TabProperties;
+  }
   /**
    * A StructuralElement representing a table.
    */
@@ -2997,6 +3153,40 @@ export namespace docs_v1 {
      */
     tableColumnProperties?: Schema$TableColumnProperties[];
   }
+  /**
+   * Properties of a tab.
+   */
+  export interface Schema$TabProperties {
+    /**
+     * The zero-based index of the tab within the parent.
+     */
+    index?: number | null;
+    /**
+     * Output only. The depth of the tab within the document. Root-level tabs start at 0.
+     */
+    nestingLevel?: number | null;
+    /**
+     * Optional. The ID of the parent tab. Empty when the current tab is a root-level tab, which means it doesn't have any parents.
+     */
+    parentTabId?: string | null;
+    /**
+     * Output only. The ID of the tab. This field can't be changed.
+     */
+    tabId?: string | null;
+    /**
+     * The user-visible name of the tab.
+     */
+    title?: string | null;
+  }
+  /**
+   * A criteria that specifies in which tabs a request executes.
+   */
+  export interface Schema$TabsCriteria {
+    /**
+     * The list of tab IDs in which the request executes.
+     */
+    tabIds?: string[] | null;
+  }
   /**
    * A tab stop within a paragraph.
    */
@@ -3156,6 +3346,10 @@ export namespace docs_v1 {
      * The fields that should be updated. At least one field must be specified. The root `document_style` is implied and should not be specified. A single `"*"` can be used as short-hand for listing every field. For example to update the background, set `fields` to `"background"`.
      */
     fields?: string | null;
+    /**
+     * The tab that contains the style to update. When omitted, the request applies to the first tab. In a document containing a single tab: - If provided, must match the singular tab's ID. - If omitted, the request applies to the singular tab. In a document containing multiple tabs: - If provided, the request applies to the specified tab. - If not provided, the request applies to the first tab in the document.
+     */
+    tabId?: string | null;
   }
   /**
    * Update the styling of all paragraphs that overlap with the given range.
@@ -3594,6 +3788,10 @@ export namespace docs_v1 {
      * The ID of the document to retrieve.
      */
     documentId?: string;
+    /**
+     * Whether to populate the Document.tabs field instead of the text content fields like `body` and `documentStyle` on Document. - When `True`: Document content populates in the Document.tabs field instead of the text content fields in Document. - When `False`: The content of the document's first tab populates the content fields in Document excluding Document.tabs. If a document has only one tab, then that tab is used to populate the document content. Document.tabs will be empty.
+     */
+    includeTabsContent?: boolean;
     /**
      * The suggestions view mode to apply to the document. This allows viewing the document with all suggestions inline, accepted or rejected. If one is not specified, DEFAULT_FOR_CURRENT_ACCESS is used.
      */