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)

文字與一般位置的垂直偏移值。

根據 fontSize 欄位計算，含有 SUPERSCRIPT 或 SUBSCRIPT 基準偏移的文字會以較小的字型大小自動轉譯。這個欄位的變更不會影響 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)

這個資料欄符號的文字樣式。

與文字內容 (例如文字執行和註腳參考) 類似，分欄符號的文字樣式可能會影響內容版面配置以及旁邊插入的文字樣式。

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，例如多位使用者建議刪除這個 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，例如多位使用者建議刪除這個 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)

區段的資料欄屬性。

如果該部分留空，這個部分會列出文件編輯器中的預設屬性。每個區段最多只能更新 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。如果更新，請在 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。如果未設定後續向量的值，則應解讀為 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 建議中對應已命名樣式的順序相符。