REST Resource: documents

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

string

僅供輸出。文件 ID。

string

文件標題。

object (Tab)

文件中的分頁。

分頁可以包含子分頁，也就是在另一個分頁中巢狀的分頁。子分頁會以 Tab.childTabs 欄位表示。

string

僅供輸出。文件的修訂版本 ID。可在更新要求中使用，用於指定要套用更新的文件修訂版本，以及如果文件在該修訂版本之後經過編輯，要求應如何運作。只有在使用者具備文件的編輯權限時，才會填入這項資料。

修訂版本 ID 不是連續編號，而是不透明字串。修訂版本 ID 的格式可能會隨時間變更。系統傳回的修訂版本 ID 只保證在傳回後的 24 小時內有效，且無法跨使用者共用。如果兩次呼叫之間的修訂 ID 沒有變更，表示文件並未變更。相反地，如果 ID 有所變更 (針對相同的文件和使用者)，通常表示文件已更新。不過，ID 變更也可能是因為 ID 格式變更等內部因素造成。

enum (SuggestionsViewMode)

僅供輸出。套用至文件的建議檢視模式。

注意：編輯文件時，變更必須以含有 SUGGESTIONS_INLINE 的文件為依據。

object (Body)

僅供輸出。文件的主要內容。

舊版欄位：請改用 Document.tabs.documentTab.body，當 includeTabsContent 參數設為 true 時，這會顯示所有分頁的實際文件內容。如果為 false 或未設定，則此欄位會包含文件中第一個分頁的相關資訊。

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

僅供輸出。文件中的標頭，以標頭 ID 做為索引。

舊版欄位：請改用 Document.tabs.documentTab.headers，當 includeTabsContent 參數設為 true 時，這會顯示所有分頁的實際文件內容。如果為 false 或未設定，則此欄位會包含文件中第一個分頁的相關資訊。

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

僅供輸出。文件中的頁尾，以頁尾 ID 做為索引。

舊版欄位：請改用 Document.tabs.documentTab.footers，當 includeTabsContent 參數設為 true 時，這會顯示所有分頁的實際文件內容。如果為 false 或未設定，則此欄位會包含文件中第一個分頁的相關資訊。

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

僅供輸出。文件中的註腳，以註腳 ID 做為索引。

舊版欄位：請改用 Document.tabs.documentTab.footnotes，當 includeTabsContent 參數設為 true 時，這會顯示所有分頁的實際文件內容。如果為 false 或未設定，則此欄位會包含文件中第一個分頁的相關資訊。

object (DocumentStyle)

僅供輸出。文件樣式。

舊版欄位：請改用 Document.tabs.documentTab.documentStyle，當 includeTabsContent 參數設為 true 時，這會顯示所有分頁的實際文件內容。如果為 false 或未設定，則此欄位會包含文件中第一個分頁的相關資訊。

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

僅供輸出。建議的文件樣式變更，以建議 ID 做為索引。

舊版欄位：請改用 Document.tabs.documentTab.suggestedDocumentStyleChanges，當 includeTabsContent 參數設為 true 時，這會顯示所有分頁的實際文件內容。如果為 false 或未設定，則此欄位會包含文件中第一個分頁的相關資訊。

object (NamedStyles)

僅供輸出。文件的命名樣式。

舊版欄位：請改用 Document.tabs.documentTab.namedStyles，當 includeTabsContent 參數設為 true 時，這會顯示所有分頁的實際文件內容。如果為 false 或未設定，則此欄位會包含文件中第一個分頁的相關資訊。

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

僅供輸出。建議變更文件的命名樣式，並以建議 ID 做為索引。

舊版欄位：請改用 Document.tabs.documentTab.suggestedNamedStylesChanges，當 includeTabsContent 參數設為 true 時，這會顯示所有分頁的實際文件內容。如果為 false 或未設定，則此欄位會包含文件中第一個分頁的相關資訊。

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

僅供輸出。文件中的清單，以清單 ID 做為索引。

舊版欄位：請改用 Document.tabs.documentTab.lists，當 includeTabsContent 參數設為 true 時，這會顯示所有分頁的實際文件內容。如果為 false 或未設定，則此欄位會包含文件中第一個分頁的相關資訊。

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

僅供輸出。文件中的已命名範圍，以名稱做為索引。

舊版欄位：請改用 Document.tabs.documentTab.namedRanges，當 includeTabsContent 參數設為 true 時，這會顯示所有分頁的實際文件內容。如果為 false 或未設定，則此欄位會包含文件中第一個分頁的相關資訊。

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

僅供輸出。文件中的內嵌物件，以物件 ID 做為索引。

舊版欄位：請改用 Document.tabs.documentTab.inlineObjects，當 includeTabsContent 參數設為 true 時，這會顯示所有分頁的實際文件內容。如果為 false 或未設定，則此欄位會包含文件中第一個分頁的相關資訊。

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

僅供輸出。文件中已定位的物件，以物件 ID 做為索引。

舊版欄位：請改用 Document.tabs.documentTab.positionedObjects，當 includeTabsContent 參數設為 true 時，這會顯示所有分頁的實際文件內容。如果為 false 或未設定，則此欄位會包含文件中第一個分頁的相關資訊。

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

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

object (TabProperties)

分頁的屬性，例如 ID 和標題。

object (Tab)

這個分頁內嵌套的子分頁。

object (DocumentTab)

包含文件內容 (例如文字和圖片) 的分頁。

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

string

僅供輸出。分頁的 ID。這個欄位無法變更。

string

使用者看到的分頁名稱。

string

選用設定。父項分頁的 ID。如果目前的分頁是根層級分頁，也就是沒有任何父項，則為空白。

integer

父項中分頁的索引，從零開始。

integer

僅供輸出。文件中分頁的深度。根層級分頁的編號從 0 開始。

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

object (Body)

文件分頁的主要內容。

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

文件分頁中的標頭，以標頭 ID 做為索引。

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

文件分頁中的頁尾，以頁尾 ID 做為索引。

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

文件分頁中的註腳，以註腳 ID 做為索引。

object (DocumentStyle)

文件分頁的樣式。

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

建議的文件分頁樣式變更，以建議 ID 做為索引。

object (NamedStyles)

文件分頁的命名樣式。

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

建議對文件分頁的命名樣式進行哪些變更，並以建議 ID 做為索引。

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

文件分頁中的清單，以清單 ID 做為索引。

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

文件分頁中的已命名範圍，按名稱排序。

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

文件分頁中的內嵌物件，以物件 ID 做為索引。

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

文件分頁中已定位的物件，以物件 ID 做為索引。

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

object (StructuralElement)

內文內容。

主體內容的索引以零為起始值。

{
  "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 (「normal」)。

字型粗細只是算繪字型粗細的其中一個元件。在考量繼承後，weight 和文字樣式的已解析 bold 值組合會決定算繪重量：

• 如果文字為粗體，且粗體重量小於 400，則算繪重量為 400。
• 如果文字為粗體，且權重大於或等於 400，但小於 700，則算繪權重為 700。
• 如果權重大於或等於 700，則算繪權重會等於權重。
• 如果文字不是粗體，則算繪重量會等於粗體。

{

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

string

外部網址。

string

這份文件中分頁的 ID。

object (BookmarkLink)

本文件中的書籤。

在只有一個分頁的文件中，如果 includeTabsContent 參數設為 false 或未設定，則該分頁內的書籤連結會繼續傳回 Link.bookmarkId。否則會傳回這個欄位。

object (HeadingLink)

本文件中的標題。

在包含單一分頁的文件中，如果 includeTabsContent 參數設為 false 或未設定，單一分頁內的標題連結仍會傳回 Link.headingId。否則會傳回這個欄位。

string

此文件中的書籤 ID。

舊版欄位：請改為將 includeTabsContent 設為 true，並使用 Link.bookmark 進行讀取和寫入作業。只有在包含單一分頁的文件中，includeTabsContent 設為 false，且連結至該分頁中的書籤時，系統才會傳回這個欄位。否則，系統會傳回 Link.bookmark。

如果這個欄位用於寫入要求，系統會將書籤視為來自要求中指定的分頁 ID。如果要求中未指定分頁 ID，系統會將其視為來自文件中的第一個分頁。

string

這份文件中標題的 ID。

舊版欄位：請改為將 includeTabsContent 設為 true，並使用 Link.heading 進行讀取和寫入作業。只有在文件包含單一分頁且連結至該分頁內的標題時，系統才會傳回這個欄位，且 includeTabsContent 已設為 false。否則，系統會傳回 Link.heading。

如果在寫入要求中使用這個欄位，系統會將標題視為來自要求中指定的分頁 ID。如果要求中未指定分頁 ID，系統會將其視為來自文件中的第一個分頁。

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

string

此文件中的書籤 ID。

string

含有此書籤的分頁 ID。

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

string

這份文件中標題的 ID。

string

包含此標題的分頁 ID。

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

object (TextStyle)

只包含這項建議中所做的變更的 TextStyle。您可以搭配使用 textStyleSuggestionState，查看哪些欄位已變更，以及這些欄位的新值。

object (TextStyleSuggestionState)

遮罩，用來指出在這個建議中，哪些基本 TextStyle 欄位已變更。

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

boolean

指出是否有建議變更 bold。

boolean

指出是否有建議變更 italic。

boolean

指出是否有建議變更 underline。

boolean

指出是否有建議變更 strikethrough。

boolean

指出是否有建議變更 smallCaps。

boolean

指出是否有建議變更 backgroundColor。

boolean

指出是否有建議變更 foregroundColor。

boolean

指出是否有建議變更 fontSize。

boolean

指出是否有建議變更 weightedFontFamily。

boolean

指出是否有建議變更 baselineOffset。

boolean

指出是否有建議變更 link。

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

enum (Type)

這個自動文字的類型。

string

建議的插入 ID。如果 AutoText 是巢狀建議變更，可能會有多個插入 ID。如果為空白，則表示這不是建議的插入位置。

string

建議刪除的 ID。如果為空白，表示系統不會建議刪除這項內容。

object (TextStyle)

此自動文字的文字樣式。

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

建議文字樣式會變更為這項 AutoText，並以建議 ID 做為索引。

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

string

建議的插入 ID。如果 PageBreak 是巢狀建議變更，可能會有多個插入 ID。如果為空白，則表示這不是建議的插入位置。

string

建議刪除的 ID。如果為空白，表示系統不會建議刪除這項內容。

object (TextStyle)

此頁面中斷的文字樣式。

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

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

建議的文字樣式會變更為這個 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))

建議文字樣式會變更為這個以建議 ID 做為索引的 ColumnBreak。

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

string

包含此註腳參照內容的 footnote ID。

string

這個附註的顯示編號。

string

建議的插入 ID。如果 FootnoteReference 是巢狀建議變更，可能會有多個插入 ID。如果為空白，則表示這不是建議的插入位置。

string

建議刪除的 ID。如果為空白，表示系統不會建議刪除這項內容。

object (TextStyle)

這個 FootnoteReference 的文字樣式。

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

建議的文字樣式會變更為這個 FootnoteReference，並以建議 ID 做為索引。

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

string

建議的插入 ID。如果 HorizontalRule 是巢狀建議變更，可能會有多個插入 ID。如果為空白，則表示這不是建議的插入位置。

string

建議刪除的 ID。如果為空白，表示系統不會建議刪除這項內容。

object (TextStyle)

此 HorizontalRule 的文字樣式。

與文字內容 (例如文字行和註腳參照) 類似，水平線的文字樣式可能會影響內容版面配置，以及插入在水平線旁的文字樣式。

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

建議的文字樣式會變更為這個 HorizontalRule，並以建議 ID 做為索引。

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

string

建議的插入 ID。如果 Equation 是巢狀建議變更，可能會有多個插入 ID。如果為空白，則表示這不是建議的插入位置。

string

建議刪除的 ID。如果為空白，表示系統不會建議刪除這項內容。

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

string

這個元素包含的 InlineObject ID。

string

建議的插入 ID。如果 InlineObjectElement 是巢狀的建議變更，可能會有多個插入 ID。如果為空白，則表示這不是建議的插入位置。

string

建議刪除的 ID。如果為空白，表示系統不會建議刪除這項內容。

object (TextStyle)

這個 InlineObjectElement 的文字樣式。

與文字內容 (例如文字行和附註參照) 類似，內嵌物件元素的文字樣式可能會影響內容版面配置，以及插入在文字旁邊的文字樣式。

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

建議文字樣式會變更為此 InlineObject，並以建議 ID 做為索引。

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

string

僅供輸出。這個連結的專屬 ID。

string

將此人連結插入文件的建議 ID。如果 Person 是巢狀建議變更 (例如不同使用者提出的建議內含建議)，可能會有多個插入 ID。如果空白，則系統不會建議插入這個人物連結。

string

從文件中移除此人連結的建議 ID。舉例來說，如果有多位使用者建議刪除 Person，則該 Person 可能會有多個刪除 ID。如果空白，系統就不會建議刪除這個使用者連結。

object (TextStyle)

這個 Person 的文字樣式。

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

建議文字樣式會變更為這個 Person，並以建議 ID 做為索引。

object (PersonProperties)

僅供輸出。這個 Person 的屬性。這個欄位一律會出現。

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

string

僅供輸出。如果連結文字顯示使用者名稱，而非電子郵件地址，請輸入使用者名稱。

string

僅供輸出。與這個 Person 連結的電子郵件地址。這個欄位一律會出現。

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

string

僅供輸出。這個連結的 ID。

string

在文件中插入此連結的建議 ID。如果 RichLink 是巢狀建議變更 (例如不同使用者提出的建議內含建議)，可能會有多個插入 ID。如果空白，則系統不會建議插入這個人物連結。

string

從文件中移除這個連結的建議 ID。舉例來說，如果有多位使用者建議刪除 RichLink，則該項目可能會有多個刪除 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)

這個段落的 tab 停用清單。分頁符號清單不會繼承。

這是唯讀屬性。

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。如果更新，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，這個值會用於該區段第一頁的標題。如果為否，則該章節第一頁的標題會使用 defaultHeaderId。如果未設定，則值會繼承先前的 SectionBreak's SectionStyle。如果在第一個 SectionBreak 中未設定值，則會繼承 DocumentStyle 的 firstPageHeaderId。

這是唯讀屬性。

string

頁尾 ID，僅用於該部分的第一頁。如果 useFirstPageHeaderFooter 為 true，這個值會用於區段第一頁的頁尾。如果為 false，則章節第一頁的頁尾會使用 defaultFooterId。如果未設定，則值會繼承先前的 SectionBreak's SectionStyle。如果在第一個 SectionBreak 中未設定值，則會繼承 DocumentStyle 的 firstPageFooterId。

這是唯讀屬性。

string

僅用於偶數頁的標頭 ID。如果 DocumentStyle 的 useEvenPageHeaderFooter 值為 true，這個值會用於該區段中偶數頁的標題。如果為 false，偶數頁的頁首會使用 defaultHeaderId。如果未設定，則值會繼承先前的 SectionBreak's SectionStyle。如果在第一個 SectionBreak 中未設定值，則會繼承 DocumentStyle 的 evenPageHeaderId。

這是唯讀屬性。

string

僅用於偶數頁的頁尾 ID。如果 DocumentStyle 的 useEvenPageHeaderFooter 值為 true，這個值會用於該區段中偶數頁的頁尾。如果設為 false，偶數頁的頁尾會使用 defaultFooterId。如果未設定，則值會繼承先前的 SectionBreak's SectionStyle。如果在第一個 SectionBreak 中未設定值，則會繼承 DocumentStyle 的 evenPageFooterId。

這是唯讀屬性。

boolean

指出是否要為章節的第一頁使用第一頁標頭 / 頁尾 ID。如果未設定，則會繼承 DocumentStyle 的 useFirstPageHeaderFooter，適用於第一個部分。如果未為後續區塊設定值，則應將其解讀為 false。

更新這項屬性時，必須設定具體值。取消設定此屬性會導致 400 錯誤要求。

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)

表格儲存格中內容的對齊方式。預設對齊方式會與 Google 文件編輯器中新建立的資料表儲存格對齊方式一致。

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

object (OptionalColor)

邊框的顏色。

這個顏色不得為透明。

object (Dimension)

框線的寬度。

enum (DashStyle)

框線的虛線樣式。

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

object (TableCellStyle)

只包含這項建議中所做的變更的 TableCellStyle。您可以搭配使用 tableCellStyleSuggestionState，查看哪些欄位已變更，以及這些欄位的新值。

object (TableCellStyleSuggestionState)

遮罩，用於指出在這個建議中，哪些基本 TableCellStyle 欄位已變更。

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

boolean

指出是否有建議變更 rowSpan。

boolean

指出是否有建議變更 columnSpan。

boolean

指出是否有建議變更 backgroundColor。

boolean

指出是否有建議變更 borderLeft。

boolean

指出是否有建議變更 borderRight。

boolean

指出是否有建議變更 borderTop。

boolean

指出是否有建議變更 borderBottom。

boolean

指出是否有建議變更 paddingLeft。

boolean

指出是否有建議變更 paddingRight。

boolean

指出是否有建議變更 paddingTop。

boolean

指出是否有建議變更 paddingBottom。

boolean

指出是否有建議變更 contentAlignment。

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

object (Dimension)

列的最小高度。列在 Google 文件編輯器中顯示時，高度會等於或大於這個值，以便顯示列中儲存格中的所有內容。

boolean

列是否為表格標題。

boolean

資料列是否無法溢出頁面或欄界線。

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

object (TableRowStyle)

只包含這項建議中所做的變更的 TableRowStyle。您可以搭配使用 tableRowStyleSuggestionState，查看哪些欄位已變更，以及這些欄位的新值。

object (TableRowStyleSuggestionState)

遮罩，用來指出在這個建議中，哪些基本 TableRowStyle 欄位已變更。

{
  "minRowHeightSuggested": boolean
}

boolean

指出是否有建議變更 minRowHeight。

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

object (TableColumnProperties)

每個資料欄的屬性。

請注意，在 Google 文件中，表格包含資料列，而資料列包含儲存格，類似於 HTML。因此，您可以在資料列的 tableRowStyle 中找到資料列的屬性。

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

enum (WidthType)

資料欄的寬度類型。

object (Dimension)

資料欄的寬度。當資料欄的 widthType 為 FIXED_WIDTH 時，請設定此值。

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

object (StructuralElement)

目錄內容。

string

建議的插入 ID。如果 TableOfContents 是巢狀建議變更，可能會有多個插入 ID。如果為空白，則表示這不是建議的插入項目。

string

建議刪除的 ID。如果為空白，表示系統不會建議刪除這項內容。

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

string

標頭的 ID。

object (StructuralElement)

標頭內容。

標頭內容的索引從零開始。

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

string

頁尾的 ID。