REST Resource: documents

{
  "documentId": string,
  "title": string,
  "tabs": [
    {
      object (Tab)
    }
  ],
  "revisionId": string,
  "suggestionsViewMode": enum (SuggestionsViewMode),
  "body": {
    object (Body)
  },
  "headers": {
    string: {
      object (Header)
    },
    ...
  },
  "footers": {
    string: {
      object (Footer)
    },
    ...
  },
  "footnotes": {
    string: {
      object (Footnote)
    },
    ...
  },
  "documentStyle": {
    object (DocumentStyle)
  },
  "suggestedDocumentStyleChanges": {
    string: {
      object (SuggestedDocumentStyle)
    },
    ...
  },
  "namedStyles": {
    object (NamedStyles)
  },
  "suggestedNamedStylesChanges": {
    string: {
      object (SuggestedNamedStyles)
    },
    ...
  },
  "lists": {
    string: {
      object (List)
    },
    ...
  },
  "namedRanges": {
    string: {
      object (NamedRanges)
    },
    ...
  },
  "inlineObjects": {
    string: {
      object (InlineObject)
    },
    ...
  },
  "positionedObjects": {
    string: {
      object (PositionedObject)
    },
    ...
  }
}

string

仅限输出。文档的 ID。

string

文档的标题。

object (Tab)

文档中的标签页。

标签页可以包含子标签页，即嵌套在其他标签页中的标签页。子标签页由 Tab.childTabs 字段表示。

string

仅限输出。文档的修订 ID。可在更新请求中使用，用于指定要将更新应用到文档的哪个修订版本，以及如果文档在该修订版本之后被修改，请求应如何处理。仅当用户拥有文档的编辑权限时才会填充。

修订版本 ID 不是顺序编号，而是一个不透明字符串。修订 ID 的格式可能会随时间而变化。返回的修订 ID 仅保证在返回后的 24 小时内有效，并且不能在用户之间共享。如果在两次调用之间修订 ID 保持不变，则表示文档未发生更改。反之，如果 ID 发生了更改（对于同一文档和用户），通常表示文档已更新。不过，ID 更改也可能是由内部因素（例如 ID 格式更改）导致的。

enum (SuggestionsViewMode)

仅限输出。应用于文档的建议视图模式。

注意：修改文档时，必须基于包含 SUGGESTIONS_INLINE 的文档进行更改。

object (Body)

仅限输出。文档的正文。

旧版字段：请改用 Document.tabs.documentTab.body，当 includeTabsContent 参数设置为 true 时，它会显示所有标签页中的实际文档内容。如果为 false 或未设置，此字段包含文档中第一个标签页的相关信息。

map (key: string, value: object (Header))

仅限输出。文档中的标题，按标题 ID 键控。

旧版字段：请改用 Document.tabs.documentTab.headers，当 includeTabsContent 参数设置为 true 时，它会显示所有标签页中的实际文档内容。如果为 false 或未设置，此字段包含文档中第一个标签页的相关信息。

map (key: string, value: object (Footer))

仅限输出。文档中的页脚，按页脚 ID 键控。

旧版字段：请改用 Document.tabs.documentTab.footers，当 includeTabsContent 参数设置为 true 时，它会显示所有标签页中的实际文档内容。如果为 false 或未设置，此字段包含文档中第一个标签页的相关信息。

map (key: string, value: object (Footnote))

仅限输出。文档中的脚注，按脚注 ID 键值对排列。

旧版字段：请改用 Document.tabs.documentTab.footnotes，当 includeTabsContent 参数设置为 true 时，它会显示所有标签页中的实际文档内容。如果为 false 或未设置，此字段包含文档中第一个标签页的相关信息。

object (DocumentStyle)

仅限输出。文档的样式。

旧版字段：请改用 Document.tabs.documentTab.documentStyle，当 includeTabsContent 参数设置为 true 时，它会显示所有标签页中的实际文档内容。如果为 false 或未设置，此字段包含文档中第一个标签页的相关信息。

map (key: string, value: object (SuggestedDocumentStyle))

仅限输出。对文档样式的建议更改，按建议 ID 编入键值对。

旧版字段：请改用 Document.tabs.documentTab.suggestedDocumentStyleChanges，当 includeTabsContent 参数设置为 true 时，它会显示所有标签页中的实际文档内容。如果为 false 或未设置，此字段包含文档中第一个标签页的相关信息。

object (NamedStyles)

仅限输出。文档的命名样式。

旧版字段：请改用 Document.tabs.documentTab.namedStyles，当 includeTabsContent 参数设置为 true 时，它会显示所有标签页中的实际文档内容。如果为 false 或未设置，此字段包含文档中第一个标签页的相关信息。

map (key: string, value: object (SuggestedNamedStyles))

仅限输出。对文档命名样式的建议更改，按建议 ID 编入键值对。

旧版字段：请改用 Document.tabs.documentTab.suggestedNamedStylesChanges，当 includeTabsContent 参数设置为 true 时，它会显示所有标签页中的实际文档内容。如果为 false 或未设置，此字段包含文档中第一个标签页的相关信息。

map (key: string, value: object (List))

仅限输出。文档中的列表，按列表 ID 键控。

旧版字段：请改用 Document.tabs.documentTab.lists，当 includeTabsContent 参数设置为 true 时，它会显示所有标签页中的实际文档内容。如果为 false 或未设置，此字段包含文档中第一个标签页的相关信息。

map (key: string, value: object (NamedRanges))

仅限输出。文档中的命名范围，按名称键值对排列。

旧版字段：请改用 Document.tabs.documentTab.namedRanges，当 includeTabsContent 参数设置为 true 时，它会显示所有标签页中的实际文档内容。如果为 false 或未设置，此字段包含文档中第一个标签页的相关信息。

map (key: string, value: object (InlineObject))

仅限输出。文档中的内嵌对象，按对象 ID 键控。

旧版字段：请改用 Document.tabs.documentTab.inlineObjects，当 includeTabsContent 参数设置为 true 时，它会显示所有标签页中的实际文档内容。如果为 false 或未设置，此字段包含文档中第一个标签页的相关信息。

map (key: string, value: object (PositionedObject))

仅限输出。文档中已定位的对象，按对象 ID 键控。

旧版字段：请改用 Document.tabs.documentTab.positionedObjects，当 includeTabsContent 参数设置为 true 时，它会显示所有标签页中的实际文档内容。如果为 false 或未设置，此字段包含文档中第一个标签页的相关信息。

{
  "tabProperties": {
    object (TabProperties)
  },
  "childTabs": [
    {
      object (Tab)
    }
  ],

  // Union field content can be only one of the following:
  "documentTab": {
    object (DocumentTab)
  }
  // End of list of possible types for union field content.
}

object (TabProperties)

标签页的属性，例如 ID 和标题。

object (Tab)

此标签页中嵌套的子标签页。

object (DocumentTab)

包含文档内容（例如文本和图片）的标签页。

{
  "tabId": string,
  "title": string,
  "parentTabId": string,
  "index": integer,
  "nestingLevel": integer
}

string

仅限输出。标签页的 ID。此字段无法更改。

string

标签页的用户可见名称。

string

可选。父标签页的 ID。如果当前标签页是根级标签页（即没有任何父级），则为空。

integer

标签页在父级中的索引（从零开始）。

integer

仅限输出。文档中标签页的深度。根级标签页从 0 开始编号。

{
  "body": {
    object (Body)
  },
  "headers": {
    string: {
      object (Header)
    },
    ...
  },
  "footers": {
    string: {
      object (Footer)
    },
    ...
  },
  "footnotes": {
    string: {
      object (Footnote)
    },
    ...
  },
  "documentStyle": {
    object (DocumentStyle)
  },
  "suggestedDocumentStyleChanges": {
    string: {
      object (SuggestedDocumentStyle)
    },
    ...
  },
  "namedStyles": {
    object (NamedStyles)
  },
  "suggestedNamedStylesChanges": {
    string: {
      object (SuggestedNamedStyles)
    },
    ...
  },
  "lists": {
    string: {
      object (List)
    },
    ...
  },
  "namedRanges": {
    string: {
      object (NamedRanges)
    },
    ...
  },
  "inlineObjects": {
    string: {
      object (InlineObject)
    },
    ...
  },
  "positionedObjects": {
    string: {
      object (PositionedObject)
    },
    ...
  }
}

object (Body)

“文档”标签页的主要正文。

map (key: string, value: object (Header))

文档标签页中的标题，按标题 ID 键值对排列。

map (key: string, value: object (Footer))

“文档”标签页中的页脚，按页脚 ID 键值对排列。

map (key: string, value: object (Footnote))

“文档”标签页中的脚注，按脚注 ID 键值对排列。

object (DocumentStyle)

文档标签页的样式。

map (key: string, value: object (SuggestedDocumentStyle))

对文档标签页样式建议的更改，按建议 ID 编入键值对。

object (NamedStyles)

文档标签页的命名样式。

map (key: string, value: object (SuggestedNamedStyles))

对文档标签页命名样式的建议更改，按建议 ID 编入键值对。

map (key: string, value: object (List))

“文档”标签页中的列表，按列表 ID 键值对排列。

map (key: string, value: object (NamedRanges))

“文档”标签页中的命名范围，按名称键值对排列。

map (key: string, value: object (InlineObject))

文档标签页中的内嵌对象，按对象 ID 键控。

map (key: string, value: object (PositionedObject))

文档标签页中已定位的对象，按对象 ID 键控。

{
  "content": [
    {
      object (StructuralElement)
    }
  ]
}

object (StructuralElement)

正文内容。

正文内容的索引从 0 开始。

{
  "startIndex": integer,
  "endIndex": integer,

  // Union field content can be only one of the following:
  "paragraph": {
    object (Paragraph)
  },
  "sectionBreak": {
    object (SectionBreak)
  },
  "table": {
    object (Table)
  },
  "tableOfContents": {
    object (TableOfContents)
  }
  // End of list of possible types for union field content.
}

integer

此结构元素的起始编号（从零开始），以 UTF-16 代码单元为单位。

integer

此结构元素的结束编号（从 0 开始，不包括该编号），以 UTF-16 代码单元为单位。

object (Paragraph)

段落类型的结构元素。

object (SectionBreak)

一种结构元素的章节插入点类型。

object (Table)

表格类型的结构元素。

object (TableOfContents)

目录类型的结构元素。

{
  "elements": [
    {
      object (ParagraphElement)
    }
  ],
  "paragraphStyle": {
    object (ParagraphStyle)
  },
  "suggestedParagraphStyleChanges": {
    string: {
      object (SuggestedParagraphStyle)
    },
    ...
  },
  "bullet": {
    object (Bullet)
  },
  "suggestedBulletChanges": {
    string: {
      object (SuggestedBullet)
    },
    ...
  },
  "positionedObjectIds": [
    string
  ],
  "suggestedPositionedObjectIds": {
    string: {
      object (ObjectReferences)
    },
    ...
  }
}

object (ParagraphElement)

段落的内容，分解为其组成部分。

object (ParagraphStyle)

此段落的样式。

map (key: string, value: object (SuggestedParagraphStyle))

建议的段落样式会更改为此段落，按建议 ID 键控。

object (Bullet)

此段落的项目符号。如果不存在，则段落不属于列表。

map (key: string, value: object (SuggestedBullet))

针对此段落项目符号的建议更改。

string

与此段落绑定的定位对象的 ID。

map (key: string, value: object (ObjectReferences))

建议附加到此段落的定位对象的 ID，按建议 ID 键值对排列。

{
  "startIndex": integer,
  "endIndex": integer,

  // Union field content can be only one of the following:
  "textRun": {
    object (TextRun)
  },
  "autoText": {
    object (AutoText)
  },
  "pageBreak": {
    object (PageBreak)
  },
  "columnBreak": {
    object (ColumnBreak)
  },
  "footnoteReference": {
    object (FootnoteReference)
  },
  "horizontalRule": {
    object (HorizontalRule)
  },
  "equation": {
    object (Equation)
  },
  "inlineObjectElement": {
    object (InlineObjectElement)
  },
  "person": {
    object (Person)
  },
  "richLink": {
    object (RichLink)
  }
  // End of list of possible types for union field content.
}

integer

此段落元素的起始索引（以 0 为基数），以 UTF-16 代码单元为单位。

integer

此段落元素的结束索引（从零开始，不包括该索引），以 UTF-16 代码单元为单位。

object (TextRun)

文本行段落元素。

object (AutoText)

自动文本段落元素。

object (PageBreak)

分页段落元素。

object (ColumnBreak)

列分隔段落元素。

object (FootnoteReference)

脚注引用段落元素。

object (HorizontalRule)

水平线段落元素。

object (Equation)

等式段落元素。

object (InlineObjectElement)

内嵌对象段落元素。

object (Person)

指向某个人或电子邮件地址的段落元素。

object (RichLink)

指向 Google 资源（例如 Google 云端硬盘中的文件、YouTube 视频或日历活动）的段落元素。

{
  "content": string,
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}

string

此次运行的文字。

运行作业中的所有非文本元素都会替换为 Unicode 字符 U+E907。

string

建议的广告订单 ID。如果 TextRun 是嵌套的建议更改，则可能具有多个广告插入 ID。如果为空，则表示这不是建议的插入内容。

string

建议删除的 ID。如果为空，则表示系统没有建议删除此内容。

object (TextStyle)

此运行的文字样式。

map (key: string, value: object (SuggestedTextStyle))

建议的文本样式会更改为此运行作业，按建议 ID 键控。

{
  "bold": boolean,
  "italic": boolean,
  "underline": boolean,
  "strikethrough": boolean,
  "smallCaps": boolean,
  "backgroundColor": {
    object (OptionalColor)
  },
  "foregroundColor": {
    object (OptionalColor)
  },
  "fontSize": {
    object (Dimension)
  },
  "weightedFontFamily": {
    object (WeightedFontFamily)
  },
  "baselineOffset": enum (BaselineOffset),
  "link": {
    object (Link)
  }
}

boolean

文本是否呈现为粗体。

boolean

文本是否为斜体。

boolean

文本是否带下划线。

boolean

文本是否带删除线。

boolean

文本是否采用小写大写字母。

object (OptionalColor)

文本的背景颜色。如果已设置，颜色为 RGB 颜色或透明，具体取决于 color 字段。

object (OptionalColor)

文本的前景颜色。如果已设置，颜色为 RGB 颜色或透明，具体取决于 color 字段。

object (Dimension)

文本字体的大小。

object (WeightedFontFamily)

文本的字体系列和呈现的粗细。

如果更新请求同时为 weightedFontFamily 和 bold 指定了值，则系统会先应用 weightedFontFamily，然后再应用 bold。

如果未设置 weightedFontFamily#weight，则默认为 400。

如果设置了 weightedFontFamily，则还必须设置 weightedFontFamily#fontFamily 并为其设置非空值。否则，系统会返回 400 错误请求。

enum (BaselineOffset)

文本相对于其正常位置的垂直偏移量。

具有 SUPERSCRIPT 或 SUBSCRIPT 基准线偏移的文本会自动以较小的字号呈现，该字号基于 fontSize 字段计算得出。此字段中的更改不会影响 fontSize。

object (Link)

文本的超链接目的地。如果未设置，则表示没有关联。链接不会从父文本继承。

更改更新请求中的链接会导致该范围的文本样式发生一些其他变化：

• 设置链接时，文本前景色会更新为默认链接颜色，并且文本会带有下划线。如果在同一请求中修改了这些字段，系统将使用这些值，而不是链接的默认值。
• 如果为与现有链接重叠的文本范围设置链接，系统还会将现有链接更新为指向新网址。
• 无法在换行符上设置链接。因此，如果在跨段落边界的文本范围（例如 "ABC\n123"）上设置链接，系统会将换行符分隔到各自的文本行中。系统会分别将链接应用于换行符之前和之后的运行作业。
• 移除链接后，除非在同一请求中设置了不同的样式，否则相应范围的文本样式将更新为与前文本的样式（如果前文本是另一个链接，则为默认文本样式）一致。

{
  "color": {
    object (Color)
  }
}

object (Color)

如果设置，则将用作不透明颜色。如果未设置，则表示透明颜色。

{
  "rgbColor": {
    object (RgbColor)
  }
}

object (RgbColor)

RGB 颜色值。

{
  "red": number,
  "green": number,
  "blue": number
}

number

颜色的红色分量，介于 0.0 到 1.0 之间。

number

颜色的绿色分量，介于 0.0 到 1.0 之间。

number

颜色的蓝色分量，介于 0.0 到 1.0 之间。

{
  "magnitude": number,
  "unit": enum (Unit)
}

number

幅度。

enum (Unit)

地震的大小单位。

{
  "fontFamily": string,
  "weight": integer
}

string

文本的字体系列。

字体系列可以是 Google 文档中的“字体”菜单或 Google Fonts 中的任何字体。如果无法识别字体名称，系统会使用 Arial 渲染文本。

integer

字体粗细。此字段可以是介于 100 和 900 之间（包括这两个数值）的任意 100 倍数值。此范围对应于 CSS 2.1 规范的 15.6 部分中所述的数值，不允许使用非数值。

默认值为 400（“normal”）。

字体粗细只是渲染的字体粗细的一个组成部分。在考虑继承的情况下，weight 和文本样式的已解析 bold 值的组合决定了渲染的粗细：

• 如果文本为粗体且粗体权重小于 400，则渲染的粗体权重为 400。
• 如果文本为粗体，且粗体粗细大于或等于 400 但小于 700，则渲染的粗细为 700。
• 如果权重大于或等于 700，则渲染的权重等于权重。
• 如果文本不是粗体，则渲染的粗体与粗体值相同。

{

  // Union field destination can be only one of the following:
  "url": string,
  "tabId": string,
  "bookmark": {
    object (BookmarkLink)
  },
  "heading": {
    object (HeadingLink)
  },
  "bookmarkId": string,
  "headingId": string
  // End of list of possible types for union field destination.
}

string

外部网址。

string

此文档中标签页的 ID。

object (BookmarkLink)

本文档中的书签。

在包含单个标签页的文档中，当 includeTabsContent 参数设为 false 或未设置时，指向单个标签页中的书签的链接仍会返回 Link.bookmarkId。否则，系统会返回此字段。

object (HeadingLink)

本文档中的标题。

在包含单个标签页的文档中，当 includeTabsContent 参数设为 false 或未设置时，指向单个标签页中标题的链接仍会返回 Link.headingId。否则，系统会返回此字段。

string

此文档中书签的 ID。

旧版字段：请改为将 includeTabsContent 设置为 true，并使用 Link.bookmark 进行读写操作。只有当文档包含单个标签页且链接到单个标签页中的书签时，系统才会返回此字段，并且 includeTabsContent 已设为 false。否则，系统会返回 Link.bookmark。

如果在写入请求中使用此字段，系统会认为相应书签来自请求中指定的标签页 ID。如果请求中未指定标签页 ID，则系统会将其视为来自文档中的第一个标签页。

string

此文档中标题的 ID。

旧版字段：请改为将 includeTabsContent 设置为 true，并使用 Link.heading 进行读写操作。只有当文档包含单个标签页且链接到单个标签页中的标题时，系统才会返回此字段，并且 includeTabsContent 已设为 false。否则，系统会返回 Link.heading。

如果在写入请求中使用此字段，则标题将被视为来自请求中指定的标签页 ID。如果请求中未指定标签页 ID，则系统会将其视为来自文档中的第一个标签页。

{
  "id": string,
  "tabId": string
}

string

此文档中书签的 ID。

string

包含此书签的标签页的 ID。

{
  "id": string,
  "tabId": string
}

string

此文档中标题的 ID。

string

包含此标题的标签页的 ID。

{
  "textStyle": {
    object (TextStyle)
  },
  "textStyleSuggestionState": {
    object (TextStyleSuggestionState)
  }
}

object (TextStyle)

仅包含在此建议中所做的更改的 TextStyle。您可以将其与 textStyleSuggestionState 搭配使用，以查看哪些字段发生了变化以及它们的新值。

object (TextStyleSuggestionState)

一个掩码，用于指明此建议中基础 TextStyle 的哪些字段已更改。

{
  "boldSuggested": boolean,
  "italicSuggested": boolean,
  "underlineSuggested": boolean,
  "strikethroughSuggested": boolean,
  "smallCapsSuggested": boolean,
  "backgroundColorSuggested": boolean,
  "foregroundColorSuggested": boolean,
  "fontSizeSuggested": boolean,
  "weightedFontFamilySuggested": boolean,
  "baselineOffsetSuggested": boolean,
  "linkSuggested": boolean
}

boolean

指示是否有针对 bold 的建议更改。

boolean

指示是否有针对 italic 的建议更改。

boolean

指示是否有针对 underline 的建议更改。

boolean

指示是否有针对 strikethrough 的建议更改。

boolean

指示是否有针对 smallCaps 的建议更改。

boolean

指示是否有针对 backgroundColor 的建议更改。

boolean

指示是否有针对 foregroundColor 的建议更改。

boolean

指示是否有针对 fontSize 的建议更改。

boolean

指示是否有针对 weightedFontFamily 的建议更改。

boolean

指示是否有针对 baselineOffset 的建议更改。

boolean

指示是否有针对 link 的建议更改。

{
  "type": enum (Type),
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}

enum (Type)

此自动文本的类型。

string

建议的广告订单 ID。如果 AutoText 是嵌套的建议更改，则可能具有多个广告插入 ID。如果为空，则表示这不是建议的插入内容。

string

建议删除的 ID。如果为空，则表示系统没有建议删除此内容。

object (TextStyle)

此自动文本的文字样式。

map (key: string, value: object (SuggestedTextStyle))

建议的文本样式会更改为此 AutoText，按建议 ID 键控。

{
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}

string

建议的广告订单 ID。如果 PageBreak 是嵌套的建议更改，则可能具有多个广告插入 ID。如果为空，则表示这不是建议的插入内容。

string

建议删除的 ID。如果为空，则表示系统没有建议删除此内容。

object (TextStyle)

此分页符的文本样式。

与文本内容（例如文本段落和脚注引用）类似，分页符的文本样式可能会影响内容布局以及插入其旁边的文本的样式。

map (key: string, value: object (SuggestedTextStyle))

建议的文本样式会更改为此分页符，按建议 ID 键控。

{
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}

string

建议的广告订单 ID。如果 ColumnBreak 是嵌套的建议更改，则可能具有多个插入 ID。如果为空，则表示这不是建议的插入内容。

string

建议删除的 ID。如果为空，则表示系统没有建议删除此内容。

object (TextStyle)

此列断点的文本样式。

与文本内容（例如文本段落和脚注引用）类似，列分隔符的文本样式可能会影响内容布局以及插入其旁边的文本的样式。

map (key: string, value: object (SuggestedTextStyle))

建议的文本样式会更改为此 ColumnBreak，按建议 ID 键控。

{
  "footnoteId": string,
  "footnoteNumber": string,
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}

string

包含此脚注引用内容的 footnote 的 ID。

string

此脚注的呈现编号。

string

建议的广告订单 ID。如果 FootnoteReference 是嵌套的建议更改，则可能具有多个广告插入 ID。如果为空，则表示这不是建议的插入内容。

string

建议删除的 ID。如果为空，则表示系统没有建议删除此内容。

object (TextStyle)

此 FootnoteReference 的文字样式。

map (key: string, value: object (SuggestedTextStyle))

建议的文本样式会更改为此 FootnoteReference，按建议 ID 键控。

{
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}

string

建议的广告订单 ID。如果 HorizontalRule 是嵌套的建议更改，则可能具有多个插入 ID。如果为空，则表示这不是建议的插入内容。

string

建议删除的 ID。如果为空，则表示系统没有建议删除此内容。

object (TextStyle)

此 HorizontalRule 的文本样式。

与文本内容（例如文本段落和脚注引用）类似，水平线的文本样式可能会影响内容布局以及插入在其旁边的文本的样式。

map (key: string, value: object (SuggestedTextStyle))

建议的文本样式会更改为此 HorizontalRule，按建议 ID 键控。

{
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ]
}

string

建议的广告订单 ID。如果 Equation 是嵌套的建议更改，则可能具有多个广告插入 ID。如果为空，则表示这不是建议的插入内容。

string

建议删除的 ID。如果为空，则表示系统没有建议删除此内容。

{
  "inlineObjectId": string,
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}

string

此元素包含的 InlineObject 的 ID。

string

建议的广告订单 ID。如果 InlineObjectElement 是嵌套的建议更改，则可能具有多个广告插入 ID。如果为空，则表示这不是建议的插入内容。

string

建议删除的 ID。如果为空，则表示系统没有建议删除此内容。

object (TextStyle)

此 InlineObjectElement 的文本样式。

与文本内容（例如文本段落和脚注引用）类似，内嵌对象元素的文本样式可能会影响内容布局以及插入其旁边的文本的样式。

map (key: string, value: object (SuggestedTextStyle))

建议的文本样式会更改为此 InlineObject，按建议 ID 键控。

{
  "personId": string,
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  },
  "personProperties": {
    object (PersonProperties)
  }
}

string

仅限输出。此关联的唯一 ID。

string

用于将此人员链接插入文档中的建议的 ID。如果 Person 是嵌套的建议更改（例如，其他用户提出的建议中的建议），则可能具有多个插入 ID。如果为空，则表示系统不会建议插入此人链接。

string

用于从文档中移除此人链接的建议的 ID。例如，如果有多个用户建议删除某个 Person，则该 Person 可能会有多个删除 ID。如果为空，则系统不会建议删除此人关联。

object (TextStyle)

此 Person 的文本样式。

map (key: string, value: object (SuggestedTextStyle))

建议的文本样式会更改为此 Person，按建议 ID 键控。

object (PersonProperties)

仅限输出。此 Person 的属性。此字段始终存在。

{
  "name": string,
  "email": string
}

string

仅限输出。相应人员的姓名（如果在链接文本中显示的是姓名，而不是电子邮件地址）。

string

仅限输出。与此 Person 关联的电子邮件地址。此字段始终存在。

{
  "richLinkId": string,
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  },
  "richLinkProperties": {
    object (RichLinkProperties)
  }
}

string

仅限输出。此关联的 ID。

string

用于将此链接插入文档的建议的 ID。如果 RichLink 是嵌套的建议更改（例如，其他用户提出的建议中的建议），则可能具有多个插入 ID。如果为空，则表示系统不会建议插入此人链接。

string

用于从文档中移除此链接的建议的 ID。例如，如果有多个用户建议删除某个 RichLink，则该 RichLink 可能会有多个删除 ID。如果为空，则系统不会建议删除此人关联。

object (TextStyle)

此 RichLink 的文本样式。

map (key: string, value: object (SuggestedTextStyle))

建议的文本样式会更改为此 RichLink，按建议 ID 键控。

object (RichLinkProperties)

仅限输出。此 RichLink 的属性。此字段始终存在。

{
  "title": string,
  "uri": string,
  "mimeType": string
}

string

仅限输出。链接中显示的 RichLink 的标题。此标题与链接插入或上次更新时关联资源的标题一致。此字段始终存在。

string

仅限输出。指向 RichLink 的 URI。此字段始终存在。

string

仅限输出。RichLink 的 MIME 类型（如果有，例如当它是云端硬盘中的文件时）。

{
  "headingId": string,
  "namedStyleType": enum (NamedStyleType),
  "alignment": enum (Alignment),
  "lineSpacing": number,
  "direction": enum (ContentDirection),
  "spacingMode": enum (SpacingMode),
  "spaceAbove": {
    object (Dimension)
  },
  "spaceBelow": {
    object (Dimension)
  },
  "borderBetween": {
    object (ParagraphBorder)
  },
  "borderTop": {
    object (ParagraphBorder)
  },
  "borderBottom": {
    object (ParagraphBorder)
  },
  "borderLeft": {
    object (ParagraphBorder)
  },
  "borderRight": {
    object (ParagraphBorder)
  },
  "indentFirstLine": {
    object (Dimension)
  },
  "indentStart": {
    object (Dimension)
  },
  "indentEnd": {
    object (Dimension)
  },
  "tabStops": [
    {
      object (TabStop)
    }
  ],
  "keepLinesTogether": boolean,
  "keepWithNext": boolean,
  "avoidWidowAndOrphan": boolean,
  "shading": {
    object (Shading)
  },
  "pageBreakBefore": boolean
}

string

段落的标题 ID。如果为空，则表示此段落不是标题。

此属性为只读属性。

enum (NamedStyleType)

段落的命名样式类型。

由于更新命名样式类型会影响 ParagraphStyle 中的其他属性，因此系统会先应用命名样式类型，然后再更新其他属性。

enum (Alignment)

此段落的文本对齐方式。

number

行之间的间距（以正常间距为百分比），其中正常间距表示为 100.0。如果未设置，则值会从父级继承。

enum (ContentDirection)

此段落的文本方向。如果未设置，则值默认为 LEFT_TO_RIGHT，因为段落方向不会被继承。

enum (SpacingMode)

段落的间距模式。

object (Dimension)

段落上方的额外空间量。如果未设置，则值会从父级继承。

object (Dimension)

段落下方的额外空格量。如果未设置，则值会从父级继承。

object (ParagraphBorder)

此段落与下一段落和上一段落之间的边框。如果未设置，则值会从父级继承。

当相邻段落具有相同的边框和缩进属性时，系统会渲染间隔边框。

无法部分更新段落边框。更改段落边框时，必须完整指定新边框。

object (ParagraphBorder)

此段落顶部的边框。如果未设置，则值会从父级继承。

当上方段落具有不同的边框和缩进属性时，系统会呈现顶部边框。

无法部分更新段落边框。更改段落边框时，必须完整指定新边框。

object (ParagraphBorder)

此段落底部的边框。如果未设置，则值会从父级继承。

当下方段落具有不同的边框和缩进属性时，系统会呈现底部边框。

无法部分更新段落边框。更改段落边框时，必须完整指定新边框。

object (ParagraphBorder)

此段落左侧的边框。如果未设置，则值会从父级继承。

无法部分更新段落边框。更改段落边框时，必须完整指定新的边框。

object (ParagraphBorder)

此段落右侧的边框。如果未设置，则值会从父级继承。

无法部分更新段落边框。更改段落边框时，必须完整指定新边框。

object (Dimension)

段落第一行的缩进量。如果未设置，则值会从父级继承。

object (Dimension)

相对于文本开头对应的一侧，段落的缩进量（基于当前段落方向）。如果未设置，则值会从父级继承。

object (Dimension)

相应于文本末尾一侧的段落的缩进量，基于当前段落方向。如果未设置，则值会从父级继承。

object (TabStop)

此段落的制表符列表。制表点列表不会被继承。

此属性为只读属性。

boolean

是否应尽可能让段落中的所有行都排列在同一页面或同一列中。如果未设置，则值会从父级继承。

boolean

是否应尽可能将此段落的至少一部分与下一段落排列在同一页面或同一列中。如果未设置，则值会从父级继承。

boolean

是否为段落避免出现孤行和孤立行。如果未设置，则值会从父级继承。

object (Shading)

段落的阴影。如果未设置，则值会从父级继承。

boolean

当前段落是否应始终从页面开头开始。如果未设置，则值会从父级继承。

尝试更新不受支持的区域（包括 Table、Header、Footer 和 Footnote）中段落的 pageBreakBefore 可能会导致文档状态无效，从而返回 400 错误请求错误。

{
  "color": {
    object (OptionalColor)
  },
  "width": {
    object (Dimension)
  },
  "padding": {
    object (Dimension)
  },
  "dashStyle": enum (DashStyle)
}

object (OptionalColor)

边框的颜色。

object (Dimension)

边框的宽度。

object (Dimension)

边框的内边距。

enum (DashStyle)

边框的虚线样式。

{
  "offset": {
    object (Dimension)
  },
  "alignment": enum (TabStopAlignment)
}

object (Dimension)

此标签页停止点与起始边距之间的偏移量。

enum (TabStopAlignment)

此标签页的对齐方式已停止。如果未设置，则值默认为 START。

{
  "backgroundColor": {
    object (OptionalColor)
  }
}

object (OptionalColor)

此段落阴影的背景颜色。

{
  "paragraphStyle": {
    object (ParagraphStyle)
  },
  "paragraphStyleSuggestionState": {
    object (ParagraphStyleSuggestionState)
  }
}

object (ParagraphStyle)

仅包含在此建议中所做的更改的 ParagraphStyle。您可以将其与 paragraphStyleSuggestionState 搭配使用，以查看哪些字段发生了变化以及它们的新值。

object (ParagraphStyleSuggestionState)

一个掩码，用于指示此建议中基础 ParagraphStyle 的哪些字段已更改。

{
  "headingIdSuggested": boolean,
  "namedStyleTypeSuggested": boolean,
  "alignmentSuggested": boolean,
  "lineSpacingSuggested": boolean,
  "directionSuggested": boolean,
  "spacingModeSuggested": boolean,
  "spaceAboveSuggested": boolean,
  "spaceBelowSuggested": boolean,
  "borderBetweenSuggested": boolean,
  "borderTopSuggested": boolean,
  "borderBottomSuggested": boolean,
  "borderLeftSuggested": boolean,
  "borderRightSuggested": boolean,
  "indentFirstLineSuggested": boolean,
  "indentStartSuggested": boolean,
  "indentEndSuggested": boolean,
  "keepLinesTogetherSuggested": boolean,
  "keepWithNextSuggested": boolean,
  "avoidWidowAndOrphanSuggested": boolean,
  "shadingSuggestionState": {
    object (ShadingSuggestionState)
  },
  "pageBreakBeforeSuggested": boolean
}

boolean

指示是否有针对 headingId 的建议更改。

boolean

指示是否有针对 namedStyleType 的建议更改。

boolean

指示是否有针对 alignment 的建议更改。

boolean

指示是否有针对 lineSpacing 的建议更改。

boolean

指示是否有针对 direction 的建议更改。

boolean

指示是否有针对 spacingMode 的建议更改。

boolean

指示是否有针对 spaceAbove 的建议更改。

boolean

指示是否有针对 spaceBelow 的建议更改。

boolean

指示是否有针对 borderBetween 的建议更改。

boolean

指示是否有针对 borderTop 的建议更改。

boolean

指示是否有针对 borderBottom 的建议更改。

boolean

指示是否有针对 borderLeft 的建议更改。

boolean

指示是否有针对 borderRight 的建议更改。

boolean

指示是否有针对 indentFirstLine 的建议更改。

boolean

指示是否有针对 indentStart 的建议更改。

boolean

指示是否有针对 indentEnd 的建议更改。

boolean

指示是否有针对 keepLinesTogether 的建议更改。

boolean

指示是否有针对 keepWithNext 的建议更改。

boolean

指示是否有针对 avoidWidowAndOrphan 的建议更改。

object (ShadingSuggestionState)

一个掩码，用于指示此建议中 shading 中的哪些字段已更改。

boolean

指示是否有针对 pageBreakBefore 的建议更改。

{
  "backgroundColorSuggested": boolean
}

boolean

指示是否有针对 Shading 的建议更改。

{
  "listId": string,
  "nestingLevel": integer,
  "textStyle": {
    object (TextStyle)
  }
}

string

此段落所属列表的 ID。

integer

此段落在列表中的嵌套级别。

object (TextStyle)

应用于此项目符号的段落专用文本样式。

{
  "bullet": {
    object (Bullet)
  },
  "bulletSuggestionState": {
    object (BulletSuggestionState)
  }
}

object (Bullet)

仅包含在此建议中所做的更改的 Bullet。您可以将其与 bulletSuggestionState 搭配使用，以查看哪些字段发生了变化以及它们的新值。

object (BulletSuggestionState)

一个掩码，用于指示此建议中基础 Bullet 的哪些字段已更改。

{
  "listIdSuggested": boolean,
  "nestingLevelSuggested": boolean,
  "textStyleSuggestionState": {
    object (TextStyleSuggestionState)
  }
}

boolean

指示是否有针对 listId 的建议更改。

boolean

指示是否有针对 nestingLevel 的建议更改。

object (TextStyleSuggestionState)

一个掩码，用于指示此建议中 text style 中的哪些字段已更改。

{
  "objectIds": [
    string
  ]
}

string

对象 ID。

{
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "sectionStyle": {
    object (SectionStyle)
  }
}

string

建议的广告订单 ID。如果 SectionBreak 是嵌套的建议更改，则可能具有多个广告插入 ID。如果为空，则表示这不是建议的插入内容。

string

建议删除的 ID。如果为空，则表示系统没有建议删除此内容。

object (SectionStyle)

此分节插入点后部分的样式。

{
  "columnProperties": [
    {
      object (SectionColumnProperties)
    }
  ],
  "columnSeparatorStyle": enum (ColumnSeparatorStyle),
  "contentDirection": enum (ContentDirection),
  "marginTop": {
    object (Dimension)
  },
  "marginBottom": {
    object (Dimension)
  },
  "marginRight": {
    object (Dimension)
  },
  "marginLeft": {
    object (Dimension)
  },
  "marginHeader": {
    object (Dimension)
  },
  "marginFooter": {
    object (Dimension)
  },
  "sectionType": enum (SectionType),
  "defaultHeaderId": string,
  "defaultFooterId": string,
  "firstPageHeaderId": string,
  "firstPageFooterId": string,
  "evenPageHeaderId": string,
  "evenPageFooterId": string,
  "useFirstPageHeaderFooter": boolean,
  "pageNumberStart": integer,
  "flipPageOrientation": boolean
}

object (SectionColumnProperties)

该版块的列属性。

如果为空，该部分将在 Google 文档编辑器中包含一个包含默认属性的列。更新后的版块最多只能包含 3 列。

更新此属性时，必须设置具体值。取消设置此属性将导致 400 错误“Bad Request”。

enum (ColumnSeparatorStyle)

列分隔符的样式。

即使该版块中只有一列，也可以设置此样式。

更新此属性时，必须设置具体值。取消设置此属性会导致 400 Bad Request 错误。

enum (ContentDirection)

此部分的内容方向。如果未设置，则值默认为 LEFT_TO_RIGHT。

更新此属性时，必须设置具体值。取消设置此属性会导致 400 Bad Request 错误。

object (Dimension)

该部分的页面顶部边距。如果未设置，则值默认为 DocumentStyle 中的 marginTop。

更新此属性时，必须设置具体值。取消设置此属性会导致 400 Bad Request 错误。

object (Dimension)

该部分的页面底部边距。如果未设置，则值默认为 DocumentStyle 中的 marginBottom。

更新此属性时，必须设置具体值。取消设置此属性会导致 400 Bad Request 错误。

object (Dimension)

该版块的右页边距。如果未设置，则值默认为 DocumentStyle 中的 marginRight。更新右边距会导致此部分中的列调整大小。由于边距会影响列宽，因此会在列属性之前应用。

更新此属性时，必须设置具体值。取消设置此属性会导致 400 Bad Request 错误。

object (Dimension)

该部分的左页边距。如果未设置，则值默认为 DocumentStyle 中的 marginLeft。更新左边距会导致此部分中的列调整大小。由于边距会影响列宽，因此会在列属性之前应用。

更新此属性时，必须设置具体值。取消设置此属性会导致 400 Bad Request 错误。

object (Dimension)

该部分的标题边距。如果未设置，则值默认为 DocumentStyle 中的 marginHeader。如果更新，DocumentStyle 上的 useCustomHeaderFooterMargins 会设为 true。DocumentStyle 上的 useCustomHeaderFooterMargins 的值表示是否要为此部分使用标题边距。

更新此属性时，必须设置具体值。取消设置此属性会导致 400 错误“Bad Request”。

object (Dimension)

该部分的页脚边距。如果未设置，则值默认为 DocumentStyle 中的 marginFooter。如果更新，则 DocumentStyle 上的 useCustomHeaderFooterMargins 会设为 true。DocumentStyle 上的 useCustomHeaderFooterMargins 的值表示是否要为此部分使用页脚边距

更新此属性时，必须设置具体值。取消设置此属性会导致 400 Bad Request 错误。

enum (SectionType)

仅限输出。版块的类型。

string

默认标题的 ID。如果未设置，则值会继承之前的 SectionBreak's SectionStyle。如果第一个 SectionBreak 中未设置该值，则会从 DocumentStyle 的 defaultHeaderId 继承。

此属性为只读属性。

string

默认页脚的 ID。如果未设置，则值会继承之前的 SectionBreak's SectionStyle。如果第一个 SectionBreak 中未设置该值，则会从 DocumentStyle 的 defaultFooterId 继承。

此属性为只读属性。

string

仅用于该部分第一页的标题的 ID。如果 useFirstPageHeaderFooter 为 true，则此值将用于该部分第一页的标题。如果为 false，则该部分第一页上的标题会使用 defaultHeaderId。如果未设置，则值会继承之前的 SectionBreak's SectionStyle。如果第一个 SectionBreak 中未设置该值，则会从 DocumentStyle 的 firstPageHeaderId 继承。

此属性为只读属性。

string

页脚的 ID，仅适用于该部分的第一页。如果 useFirstPageHeaderFooter 为 true，则此值将用于该部分第一页的页脚。如果为 false，则该部分第一个页面的页脚会使用 defaultFooterId。如果未设置，则值会继承之前的 SectionBreak's SectionStyle。如果第一个 SectionBreak 中未设置该值，则会从 DocumentStyle 的 firstPageFooterId 继承。

此属性为只读属性。

string

仅用于偶数页的标题的 ID。如果 DocumentStyle 的 useEvenPageHeaderFooter 的值为 true，则此值将用于该部分偶数页上的标题。如果为 false，偶数页上的标题会使用 defaultHeaderId。如果未设置，则值会继承之前的 SectionBreak's SectionStyle。如果第一个 SectionBreak 中未设置该值，则会从 DocumentStyle 的 evenPageHeaderId 继承。

此属性为只读属性。

string

仅用于偶数页的页脚的 ID。如果 DocumentStyle 的 useEvenPageHeaderFooter 的值为 true，则此值将用于该部分偶数页上的页脚。如果为 false，偶数页的页脚会使用 defaultFooterId。如果未设置，则值会继承之前的 SectionBreak's SectionStyle。如果第一个 SectionBreak 中未设置该值，则会从 DocumentStyle 的 evenPageFooterId 继承。

此属性为只读属性。

boolean

指示是否应为该部分的首页使用首页页眉 / 页脚 ID。如果未设置，则会继承第一个部分的 DocumentStyle 的 useFirstPageHeaderFooter。如果未为后续扇区设置该值，则应将其解读为 false。

更新此属性时，必须设置具体值。取消设置此属性会导致 400 Bad Request 错误。

integer

此部分的页码数从该页码开始计算。如果未设置，页面编号将从上一小节继续。如果第一个 SectionBreak 中未设置该值，请参阅 DocumentStyle 的 pageNumberStart。

更新此属性时，必须设置具体值。取消设置此属性会导致 400 Bad Request 错误。

boolean

可选。指示是否要翻转此部分 DocumentStyle 的 pageSize 的尺寸，以便在纵向和横向之间更改页面方向。如果未设置，则值会继承 DocumentStyle 的 flipPageOrientation。

更新此属性时，必须设置具体值。取消设置此属性会导致 400 Bad Request 错误。

{
  "width": {
    object (Dimension)
  },
  "paddingEnd": {
    object (Dimension)
  }
}

object (Dimension)

仅限输出。列的宽度。

object (Dimension)

列末尾的内边距。

{
  "rows": integer,
  "columns": integer,
  "tableRows": [
    {
      object (TableRow)
    }
  ],
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "tableStyle": {
    object (TableStyle)
  }
}

integer

表中的行数。

integer

表中的列数。

表格可能是非矩形的，因此某些行可能包含不同数量的单元格。

object (TableRow)

每行的具体内容和样式。

string

建议的广告订单 ID。如果 Table 是嵌套的建议更改，则可能具有多个广告插入 ID。如果为空，则表示这不是建议的插入内容。

string

建议删除的 ID。如果为空，则表示系统没有建议删除此内容。

object (TableStyle)

表的样式。

{
  "startIndex": integer,
  "endIndex": integer,
  "tableCells": [
    {
      object (TableCell)
    }
  ],
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "tableRowStyle": {
    object (TableRowStyle)
  },
  "suggestedTableRowStyleChanges": {
    string: {
      object (SuggestedTableRowStyle)
    },
    ...
  }
}

integer

此行的起始索引（从零开始），以 UTF-16 代码单元为单位。

integer

此行的结束编号（从 0 开始，不包括该编号），以 UTF-16 代码单元为单位。

object (TableCell)

此行中每个单元格的相应内容和样式。

表格可能是非矩形的，因此某些行的单元格数量可能与同一表格中的其他行不同。

string

建议的广告订单 ID。如果 TableRow 是嵌套的建议更改，则可能具有多个广告插入 ID。如果为空，则表示这不是建议的插入内容。

string

建议删除的 ID。如果为空，则表示系统没有建议删除此内容。

object (TableRowStyle)

表格的行样式。

map (key: string, value: object (SuggestedTableRowStyle))

此行采用的建议样式会发生更改，键值为建议 ID。

{
  "startIndex": integer,
  "endIndex": integer,
  "content": [
    {
      object (StructuralElement)
    }
  ],
  "tableCellStyle": {
    object (TableCellStyle)
  },
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "suggestedTableCellStyleChanges": {
    string: {
      object (SuggestedTableCellStyle)
    },
    ...
  }
}

integer

此单元的起始索引（从零开始），以 UTF-16 代码单元为单位。

integer

此单元格的结束编号（从零开始，不包括该编号），以 UTF-16 代码单元为单位。

object (StructuralElement)

单元格的内容。

object (TableCellStyle)

单元格的样式。

string

建议的广告订单 ID。如果 TableCell 是嵌套的建议更改，则可能具有多个广告插入 ID。如果为空，则表示这不是建议的插入内容。

string

建议删除的 ID。如果为空，则表示系统没有建议删除此内容。

map (key: string, value: object (SuggestedTableCellStyle))

对表格单元格样式的建议更改，按建议 ID 编入键值。

{
  "rowSpan": integer,
  "columnSpan": integer,
  "backgroundColor": {
    object (OptionalColor)
  },
  "borderLeft": {
    object (TableCellBorder)
  },
  "borderRight": {
    object (TableCellBorder)
  },
  "borderTop": {
    object (TableCellBorder)
  },
  "borderBottom": {
    object (TableCellBorder)
  },
  "paddingLeft": {
    object (Dimension)
  },
  "paddingRight": {
    object (Dimension)
  },
  "paddingTop": {
    object (Dimension)
  },
  "paddingBottom": {
    object (Dimension)
  },
  "contentAlignment": enum (ContentAlignment)
}

integer

单元格的行跨度。

此属性为只读属性。

integer

单元格的列跨度。

此属性为只读属性。

object (OptionalColor)

单元格的背景颜色。

object (TableCellBorder)

单元格的左边框。

object (TableCellBorder)

单元格的右边框。

object (TableCellBorder)

单元格的上边框。

object (TableCellBorder)

单元格的底部边框。

object (Dimension)

单元格的左内边距。

object (Dimension)

单元格的右内边距。

object (Dimension)

单元格的上内边距。

object (Dimension)

单元格的底部内边距。

enum (ContentAlignment)

表格单元格中内容的对齐方式。默认对齐方式与 Google 文档编辑器中新创建的表格单元格的对齐方式一致。

{
  "color": {
    object (OptionalColor)
  },
  "width": {
    object (Dimension)
  },
  "dashStyle": enum (DashStyle)
}

object (OptionalColor)

边框的颜色。

此颜色不得为透明。

object (Dimension)

边框的宽度。

enum (DashStyle)

边框的虚线样式。

{
  "tableCellStyle": {
    object (TableCellStyle)
  },
  "tableCellStyleSuggestionState": {
    object (TableCellStyleSuggestionState)
  }
}

object (TableCellStyle)

仅包含在此建议中所做的更改的 TableCellStyle。您可以将其与 tableCellStyleSuggestionState 搭配使用，以查看哪些字段发生了变化以及它们的新值。

object (TableCellStyleSuggestionState)

一个掩码，用于指示此建议中基础 TableCellStyle 的哪些字段已更改。

{
  "rowSpanSuggested": boolean,
  "columnSpanSuggested": boolean,
  "backgroundColorSuggested": boolean,
  "borderLeftSuggested": boolean,
  "borderRightSuggested": boolean,
  "borderTopSuggested": boolean,
  "borderBottomSuggested": boolean,
  "paddingLeftSuggested": boolean,
  "paddingRightSuggested": boolean,
  "paddingTopSuggested": boolean,
  "paddingBottomSuggested": boolean,
  "contentAlignmentSuggested": boolean
}

boolean

指示是否有针对 rowSpan 的建议更改。

boolean

指示是否有针对 columnSpan 的建议更改。

boolean

指示是否有针对 backgroundColor 的建议更改。

boolean

指示是否有针对 borderLeft 的建议更改。

boolean

指示是否有针对 borderRight 的建议更改。

boolean

指示是否有针对 borderTop 的建议更改。

boolean

指示是否有针对 borderBottom 的建议更改。

boolean

指示是否有针对 paddingLeft 的建议更改。

boolean

指示是否有针对 paddingRight 的建议更改。

boolean

指示是否有针对 paddingTop 的建议更改。

boolean

指示是否有针对 paddingBottom 的建议更改。

boolean

指示是否有针对 contentAlignment 的建议更改。

{
  "minRowHeight": {
    object (Dimension)
  },
  "tableHeader": boolean,
  "preventOverflow": boolean
}

object (Dimension)

行的最小高度。该行在 Google 文档编辑器中的高度将等于或大于此值，以便显示该行单元格中的所有内容。

boolean

行是否为表格标题。

boolean

行是否不能溢出到页面或列边界。

{
  "tableRowStyle": {
    object (TableRowStyle)
  },
  "tableRowStyleSuggestionState": {
    object (TableRowStyleSuggestionState)
  }
}

object (TableRowStyle)

仅包含在此建议中所做的更改的 TableRowStyle。您可以将其与 tableRowStyleSuggestionState 搭配使用，以查看哪些字段发生了变化以及它们的新值。

object (TableRowStyleSuggestionState)

一个掩码，用于指示此建议中基础 TableRowStyle 的哪些字段已更改。

{
  "minRowHeightSuggested": boolean
}

boolean

指示是否有针对 minRowHeight 的建议更改。

{
  "tableColumnProperties": [
    {
      object (TableColumnProperties)
    }
  ]
}

object (TableColumnProperties)

每列的属性。

请注意，在 Google 文档中，表格包含行，行包含单元格，与 HTML 类似。因此，您可以在行 tableRowStyle 中找到相应行的属性。

{
  "widthType": enum (WidthType),
  "width": {
    object (Dimension)
  }
}

enum (WidthType)

列的宽度类型。

object (Dimension)

列的宽度。当列的 widthType 为 FIXED_WIDTH 时设置。

{
  "content": [
    {
      object (StructuralElement)
    }
  ],
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ]
}

object (StructuralElement)

目录的内容。

string

建议的广告订单 ID。如果 TableOfContents 是嵌套的建议更改，则可能具有多个插入 ID。如果为空，则表示这不是建议的插入内容。

string

建议删除的 ID。如果为空，则表示系统没有建议删除此内容。

{
  "headerId": string,
  "content": [
    {
      object (StructuralElement)
    }
  ]
}

string

标头的 ID。

object (StructuralElement)

标头的内容。

标题内容的索引从零开始。

{
  "footerId": string,
  "content": [
    {
      object (StructuralElement)
    }
  ]
}

string

页脚的 ID。