REST Resource: documents

{
  "documentId": string,
  "title": string,
  "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)
    },
    ...
  },
  "revisionId": string,
  "suggestionsViewMode": enum (SuggestionsViewMode),
  "inlineObjects": {
    string: {
      object (InlineObject)
    },
    ...
  },
  "positionedObjects": {
    string: {
      object (PositionedObject)
    },
    ...
  }
}

string

仅供输出。文档的 ID。

string

文档的标题。

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))

仅供输出。文档中的命名范围，按名称进行键控。

string

仅供输出。文档的修订版本 ID。可用于更新请求，以指定要将更新应用到文档的哪个修订版本，以及如果文档在对该修订版本进行编辑后，该请求应采取何种行为。仅当用户拥有文档的编辑权限时填充。

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

enum (SuggestionsViewMode)

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

注意：编辑文档时，必须基于带有 SUGGESTIONS_INLINE 的文档进行更改。

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

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

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

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

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

object (StructuralElement)

正文的内容。

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

{
  "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

此结构元素的结束索引（从零开始，不含该索引），采用 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

此段落元素的起始索引（从零开始），采用 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 Fonts 中的任何字体。如果字体名称无法识别，文本将采用 Arial 呈现。

integer

字体粗细。此字段可具有 100 介于 100 和 900 之间（包括这两个数值）的任意值。此范围对应于 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,
  "bookmarkId": string,
  "headingId": string
  // End of list of possible types for union field destination.
}

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))

建议的文本样式会更改为此自动文本，由建议 ID 键控。

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

string

建议的插入 ID。如果是嵌套建议的更改，PageBreak 可能会有多个插入 ID。如果为空，则不建议插入。

string

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

object (TextStyle)

此 PageBreak 的文本样式。

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

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

建议的文本样式将更改此 PageBreak，由建议 ID 键控。

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

string

建议的插入 ID。如果是嵌套建议的更改，ColumnBreak 可能会有多个插入 ID。如果为空，则不建议插入。

string

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

object (TextStyle)

此 ColumnBreak 的文本样式。

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

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 可能有多个删除 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 可能有多个删除 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 bad request”错误。

{
  "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)

版块的列属性。

如果为空，则此部分包含一列具有文档编辑器中的默认属性。每个版块最多只能包含 3 列。

更新此属性时，需要设置具体的值。取消设置此属性将导致 400 bad request 错误。

enum (ColumnSeparatorStyle)

列分隔符的样式。

即使相应部分中只有一列，您也可以设置此样式。

更新此属性时，需要设置具体的值。取消设置此属性会导致 400 错误请求错误。

enum (ContentDirection)

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

更新此属性时，需要设置具体的值。取消设置此属性会导致 400 错误请求错误。

object (Dimension)

相应部分的上边距。如果未设置，则值默认为 DocumentStyle 的 marginTop。

更新此属性时，需要设置具体的值。取消设置此属性会导致 400 错误请求错误。

object (Dimension)

此版块的下边距。如果未设置，则值默认为 DocumentStyle 的 marginBottom。

更新此属性时，需要设置具体的值。取消设置此属性会导致 400 错误请求错误。

object (Dimension)

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

更新此属性时，需要设置具体的值。取消设置此属性会导致 400 错误请求错误。

object (Dimension)

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

更新此属性时，需要设置具体的值。取消设置此属性会导致 400 错误请求错误。

object (Dimension)

部分的标题外边距。如果未设置，则值默认为 DocumentStyle 的 marginHeader。如果更新，则 DocumentStyle 上的 useCustomHeaderFooterMargins 会设置为 true。DocumentStyle 上 useCustomHeaderFooterMargins 的值表示是否要遵循此部分的页眉外边距。

更新此属性时，需要设置具体的值。取消设置此属性会导致 400 错误请求错误。

object (Dimension)

部分的页脚外边距。如果未设置，则值默认为 DocumentStyle 的 marginFooter。如果更新，则 DocumentStyle 上的 useCustomHeaderFooterMargins 会设置为 true。DocumentStyle 上 useCustomHeaderFooterMargins 的值表示是否要在此版块中遵循页脚外边距

更新此属性时，需要设置具体的值。取消设置此属性会导致 400 错误请求错误。

enum (SectionType)

仅供输出。部分的类型。

string

默认标头的 ID。如果未设置，则该值将继承自上一个 SectionBreak'sSectionStyle。如果未设置第一个分节符的值，它将继承 DocumentStyle 的 defaultHeaderId。

此属性为只读属性。

string

默认页脚的 ID。如果未设置，则该值将继承自上一个 SectionBreak'sSectionStyle。如果未设置第一个分节符的值，它将继承 DocumentStyle 的 defaultFooterId。

此属性为只读属性。

string

仅用于章节第一页的标题 ID。如果 useFirstPageHeaderFooter 为 true，此值将用作该节第一页的页眉。如果为 false，该节第一页的页眉会使用 defaultHeaderId。如果未设置，则该值将继承自上一个 SectionBreak'sSectionStyle。如果未设置第一个分节符的值，它将继承 DocumentStyle 的 firstPageHeaderId。

此属性为只读属性。

string

仅用于章节第一页的页脚 ID。如果 useFirstPageHeaderFooter 为 true，此值会用作该部分第一页的页脚。如果为 false，该版块第一页的页脚会使用 defaultFooterId。如果未设置，则该值将继承自上一个 SectionBreak'sSectionStyle。如果未设置第一个分节符的值，它将继承 DocumentStyle 的 firstPageFooterId。

此属性为只读属性。

string

仅用于偶数页的标题 ID。如果 DocumentStyle 的 useEvenPageHeaderFooter 的值为 true，则此值将用作该部分中偶数页的标题。如果为 false，偶数页上的标头都会使用 defaultHeaderId。如果未设置，则该值将继承自上一个 SectionBreak'sSectionStyle。如果未设置第一个分节符的值，它将继承 DocumentStyle 的 evenPageHeaderId。

此属性为只读属性。

string

仅用于偶数页的页脚 ID。如果 DocumentStyle 的 useEvenPageHeaderFooter 的值为 true，则此值将用于相应部分中偶数页的页脚。如果为 false，偶数页面上的页脚会使用 defaultFooterId。如果未设置，则该值将继承自上一个 SectionBreak'sSectionStyle。如果未设置第一个分节符的值，它将继承 DocumentStyle 的 evenPageFooterId。

此属性为只读属性。

boolean

指明是否使用该版块第一页的首页页眉 / 页脚 ID。如果未设置，它将从 DocumentStyle 的 useFirstPageHeaderFooter 继承第一部分的 useFirstPageHeaderFooter。如果未设置后续扇区的转化价值，应解读为 false。

更新此属性时，需要设置具体的值。取消设置此属性会导致 400 错误请求错误。

integer

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

更新此属性时，需要设置具体的值。取消设置此属性会导致 400 错误请求错误。

boolean

可选。指示是否在此部分翻转 DocumentStyle 的 pageSize 的尺寸，以允许在纵向和横向之间切换页面方向。如果未设置，则该值将继承自 DocumentStyle 的 flipPageOrientation。

更新此属性时，需要设置具体的值。取消设置此属性会导致 400 错误请求错误。

{
  "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

此行的结束索引（从零开始，不含边界值），采用 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)

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

{
  "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)

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

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。

object (StructuralElement)

页脚的内容。

页脚内容的索引从零开始。

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

string

脚注的 ID。

object (StructuralElement)

脚注的内容。

脚注内容的索引从零开始。

{
  "background": {
    object (Background)
  },
  "defaultHeaderId": string,
  "defaultFooterId": string,
  "evenPageHeaderId": string,
  "evenPageFooterId": string,
  "firstPageHeaderId": string,
  "firstPageFooterId": string,
  "useFirstPageHeaderFooter": boolean,
  "useEvenPageHeaderFooter": boolean,
  "pageNumberStart": integer,
  "marginTop": {
    object (Dimension)
  },
  "marginBottom": {
    object (Dimension)
  },
  "marginRight": {
    object (Dimension)
  },
  "marginLeft": {
    object (Dimension)
  },
  "pageSize": {
    object (Size)
  },
  "marginHeader": {
    object (Dimension)
  },
  "marginFooter": {
    object (Dimension)
  },
  "useCustomHeaderFooterMargins": boolean,
  "flipPageOrientation": boolean
}

object (Background)

文档的背景。文档不能有透明的背景颜色。

string

默认标头的 ID。如果未设置，则没有默认标头。

此属性为只读属性。

string

默认页脚的 ID。如果未设置，则没有默认页脚。

此属性为只读属性。

string

仅用于偶数页的标题 ID。useEvenPageHeaderFooter 的值可决定是将 defaultHeaderId 还是此值用于偶数页的页眉。如果未设置，则没有偶数页页眉。

此属性为只读属性。

string

仅用于偶数页的页脚 ID。useEvenPageHeaderFooter 的值用于决定是将 defaultFooterId 还是此值用于偶数页面上的页脚。如果未设置，则没有偶数页页脚。

此属性为只读属性。

string

仅用于首页的标题 ID。如果未设置，则第一个页面的唯一页眉不存在。useFirstPageHeaderFooter 的值用于确定第一页页眉是使用 defaultHeaderId 还是此值。如果未设置，则没有首页页眉。

此属性为只读属性。

string

仅用于首页的页脚的 ID。如果未设置，则第一个页面没有唯一页脚。useFirstPageHeaderFooter 的值决定是将 defaultFooterId 还是此值用于首页的页脚。如果未设置，则没有首页页脚。

此属性为只读属性。

boolean

指明是否使用首页的首页页眉 / 页脚 ID。

boolean

指明是否对偶数页使用偶数页页眉 / 页脚 ID。

integer

开始计算页数的页码。

object (Dimension)

上边距。

更新文档样式的上页外边距会清除所有版块样式的上外边距。

object (Dimension)

下边距。

更新文档样式的下页边距会清除所有版块样式的下边距。

object (Dimension)

右页外边距。

更新文档样式的右侧页面外边距会清除所有版块样式的右侧页面外边距。还可能会导致列在所有版块中调整大小。

object (Dimension)

左侧页边距。

更新文档样式的左侧页面外边距会清除所有版块样式的左侧页面外边距。还可能会导致列在所有版块中调整大小。

object (Size)

文档中一页的大小。

object (Dimension)

页面顶部和页眉内容之间的间距。

object (Dimension)

页面底部与页脚内容之间的间距。

boolean

指示是否遵循 DocumentStyle marginHeader、SectionStyle marginHeader 和 DocumentStyle marginFooter、SectionStyle marginFooter。如果为 false，使用文档编辑器中的页眉和页脚外边距的默认值。

此属性为只读属性。

boolean

可选。指示是否翻转 pageSize 的尺寸，以允许在纵向和横向之间切换页面方向。

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

object (OptionalColor)

背景颜色。

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

object (Dimension)

对象的高度。

object (Dimension)

对象的宽度。

{
  "documentStyle": {
    object (DocumentStyle)
  },
  "documentStyleSuggestionState": {
    object (DocumentStyleSuggestionState)
  }
}

object (DocumentStyle)

仅包含此建议中所做更改的 DocumentStyle。这可以与 documentStyleSuggestionState 结合使用，以查看哪些字段已更改以及它们的新值。

object (DocumentStyleSuggestionState)

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

{
  "backgroundSuggestionState": {
    object (BackgroundSuggestionState)
  },
  "defaultHeaderIdSuggested": boolean,
  "defaultFooterIdSuggested": boolean,
  "evenPageHeaderIdSuggested": boolean,
  "evenPageFooterIdSuggested": boolean,
  "firstPageHeaderIdSuggested": boolean,
  "firstPageFooterIdSuggested": boolean,
  "useFirstPageHeaderFooterSuggested": boolean,
  "useEvenPageHeaderFooterSuggested": boolean,
  "pageNumberStartSuggested": boolean,
  "marginTopSuggested": boolean,
  "marginBottomSuggested": boolean,
  "marginRightSuggested": boolean,
  "marginLeftSuggested": boolean,
  "pageSizeSuggestionState": {
    object (SizeSuggestionState)
  },
  "marginHeaderSuggested": boolean,
  "marginFooterSuggested": boolean,
  "useCustomHeaderFooterMarginsSuggested": boolean,
  "flipPageOrientationSuggested": boolean
}

object (BackgroundSuggestionState)

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

boolean

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

object (SizeSuggestionState)

一个掩码，用于指示此建议中 [size] [google.apps.docs.v1.DocumentStyle.size] 中的哪些字段已更改。

boolean

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

boolean

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

boolean

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

boolean

可选。指示是否有对 flipPageOrientation 的建议更改。

{
  "backgroundColorSuggested": boolean
}

boolean

指示此建议中是否已修改当前背景颜色。

{
  "heightSuggested": boolean,
  "widthSuggested": boolean
}

boolean

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

boolean

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

{
  "styles": [
    {
      object (NamedStyle)
    }
  ]
}

object (NamedStyle)

已命名的样式。

每个可能的 named style types 都有一个对应的条目。

{
  "namedStyleType": enum (NamedStyleType),
  "textStyle": {
    object (TextStyle)
  },
  "paragraphStyle": {
    object (ParagraphStyle)
  }
}

enum (NamedStyleType)

已命名的样式的类型。

object (TextStyle)

此已命名样式的文本样式。

object (ParagraphStyle)

此已命名样式的段落样式。

{
  "namedStyles": {
    object (NamedStyles)
  },
  "namedStylesSuggestionState": {
    object (NamedStylesSuggestionState)
  }
}

object (NamedStyles)

仅包含此建议中所做更改的 NamedStyles。这可以与 namedStylesSuggestionState 结合使用，以查看哪些字段已更改以及它们的新值。

object (NamedStylesSuggestionState)

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

{
  "stylesSuggestionStates": [
    {
      object (NamedStyleSuggestionState)
    }
  ]
}

object (NamedStyleSuggestionState)

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

这些已命名样式建议状态的顺序与 named styles 建议中相应已命名样式的顺序一致。