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 文档中的“字体”菜单，也可以是 Google Fonts 中的任何字体。如果无法识别字体名称，文本将在 Arial 中呈现。

integer

字体粗细。此字段的值可以是 100 到 900（含）之间的 100 的倍数。此范围对应于 CSS 2.1 规范第 15.6 节中所述的数值，但不允许使用非数字值。

默认值为 400（“正常”）。

字体粗细只是所渲染字体粗细的一个组件。在考虑继承之后，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)

此 AutoText 的文本样式。

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)

此 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 请求错误。

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

object (SectionColumnProperties)

部分的列属性。

如果为空，此部分会包含一个列，其中包含文档编辑器中的默认属性。可以将部分更新为不超过 3 列。

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

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。更新后，useCustomHeaderFooterMargins 在 DocumentStyle 上设置为 true。DocumentStyle 上 useCustomHeaderFooterMargins 的值表示该部分是否遵循了标题外边距。

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

object (Dimension)

相应部分的页脚边距。如果未设置，则默认值为 DocumentStyle 中的 marginFooter。更新后，useCustomHeaderFooterMargins 在 DocumentStyle 上设置为 true。DocumentStyle 上 useCustomHeaderFooterMargins 的值表示是否遵循了此部分的页脚边距

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

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。如果未设置此政策，它会继承第 1 部分的 DocumentStyle 的 useFirstPageHeaderFooter。如果后续行业未设置此值，则应将其解读为 false。

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

integer

此部分要开始统计的页数。如果此政策未设置，系统会按照上一部分中的页面编号继续。如果您在第一个 SectionBreak 中未设置该值，请参阅 DocumentStyle 的 pageNumberStart。

更新此属性时，需要设置具体值。取消设置该属性会导致出现 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

单元格的列 span。

此属性处于只读状态。

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)

每列的属性。

请注意，在文档中，表包含行，而行包含单元格，类似于 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)

页脚的内容。

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

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

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 时，系统会使用文档编辑器中的页眉和页脚边距默认值。

此属性处于只读状态。

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

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 建议的更改。

{
  "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 建议中相应已命名样式的顺序一致。

{
  "namedStyleType": enum (NamedStyleType),
  "textStyleSuggestionState": {
    object (TextStyleSuggestionState)
  },
  "paragraphStyleSuggestionState": {
    object (ParagraphStyleSuggestionState)
  }
}