Requests

要求

適用於文件的單一更新。

JSON 表示法 
{

  // Union field request can be only one of the following:
  "replaceAllText": {
    object (ReplaceAllTextRequest)
  },
  "insertText": {
    object (InsertTextRequest)
  },
  "updateTextStyle": {
    object (UpdateTextStyleRequest)
  },
  "createParagraphBullets": {
    object (CreateParagraphBulletsRequest)
  },
  "deleteParagraphBullets": {
    object (DeleteParagraphBulletsRequest)
  },
  "createNamedRange": {
    object (CreateNamedRangeRequest)
  },
  "deleteNamedRange": {
    object (DeleteNamedRangeRequest)
  },
  "updateParagraphStyle": {
    object (UpdateParagraphStyleRequest)
  },
  "deleteContentRange": {
    object (DeleteContentRangeRequest)
  },
  "insertInlineImage": {
    object (InsertInlineImageRequest)
  },
  "insertTable": {
    object (InsertTableRequest)
  },
  "insertTableRow": {
    object (InsertTableRowRequest)
  },
  "insertTableColumn": {
    object (InsertTableColumnRequest)
  },
  "deleteTableRow": {
    object (DeleteTableRowRequest)
  },
  "deleteTableColumn": {
    object (DeleteTableColumnRequest)
  },
  "insertPageBreak": {
    object (InsertPageBreakRequest)
  },
  "deletePositionedObject": {
    object (DeletePositionedObjectRequest)
  },
  "updateTableColumnProperties": {
    object (UpdateTableColumnPropertiesRequest)
  },
  "updateTableCellStyle": {
    object (UpdateTableCellStyleRequest)
  },
  "updateTableRowStyle": {
    object (UpdateTableRowStyleRequest)
  },
  "replaceImage": {
    object (ReplaceImageRequest)
  },
  "updateDocumentStyle": {
    object (UpdateDocumentStyleRequest)
  },
  "mergeTableCells": {
    object (MergeTableCellsRequest)
  },
  "unmergeTableCells": {
    object (UnmergeTableCellsRequest)
  },
  "createHeader": {
    object (CreateHeaderRequest)
  },
  "createFooter": {
    object (CreateFooterRequest)
  },
  "createFootnote": {
    object (CreateFootnoteRequest)
  },
  "replaceNamedRangeContent": {
    object (ReplaceNamedRangeContentRequest)
  },
  "updateSectionStyle": {
    object (UpdateSectionStyleRequest)
  },
  "insertSectionBreak": {
    object (InsertSectionBreakRequest)
  },
  "deleteHeader": {
    object (DeleteHeaderRequest)
  },
  "deleteFooter": {
    object (DeleteFooterRequest)
  },
  "pinTableHeaderRows": {
    object (PinTableHeaderRowsRequest)
  }
  // End of list of possible types for union field request.
}
欄位
聯集欄位 request。要套用的特定要求。只需要填寫一個欄位。 request 只能為下列其中一項：
replaceAllText

object (ReplaceAllTextRequest)

取代指定文字的所有例項。

insertText

object (InsertTextRequest)

在指定的位置插入文字。

updateTextStyle

object (UpdateTextStyleRequest)

更新指定範圍的文字樣式。

createParagraphBullets

object (CreateParagraphBulletsRequest)

為段落建立項目符號。

deleteParagraphBullets

object (DeleteParagraphBulletsRequest)

從段落中刪除項目符號。

createNamedRange

object (CreateNamedRangeRequest)

建立已命名範圍。

deleteNamedRange

object (DeleteNamedRangeRequest)

刪除已命名範圍。

updateParagraphStyle

object (UpdateParagraphStyleRequest)

更新指定範圍內的段落樣式。

deleteContentRange

object (DeleteContentRangeRequest)

從文件中刪除內容。

insertInlineImage

object (InsertInlineImageRequest)

在指定位置插入內嵌圖片。

insertTable

object (InsertTableRequest)

在指定位置插入資料表。

insertTableRow

object (InsertTableRowRequest)

在表格中插入空白列。

insertTableColumn

object (InsertTableColumnRequest)

在表格中插入空白資料欄。

deleteTableRow

object (DeleteTableRowRequest)

從資料表中刪除資料列。

deleteTableColumn

object (DeleteTableColumnRequest)

從表格中刪除資料欄。

insertPageBreak

object (InsertPageBreakRequest)

在指定位置插入分頁符號。

deletePositionedObject

object (DeletePositionedObjectRequest)

從文件中刪除定位物件。

updateTableColumnProperties

object (UpdateTableColumnPropertiesRequest)

更新資料表中的資料欄屬性。

updateTableCellStyle

object (UpdateTableCellStyleRequest)

更新表格儲存格的樣式。

updateTableRowStyle

object (UpdateTableRowStyleRequest)

更新表格中的資料列樣式。

replaceImage

object (ReplaceImageRequest)

取代文件中的圖片。

updateDocumentStyle

object (UpdateDocumentStyleRequest)

更新文件樣式。

mergeTableCells

object (MergeTableCellsRequest)

合併表格中的儲存格。

unmergeTableCells

object (UnmergeTableCellsRequest)

取消合併表格中的儲存格。

createHeader

object (CreateHeaderRequest)

建立標頭。

createFootnote

object (CreateFootnoteRequest)

可建立註腳。

replaceNamedRangeContent

object (ReplaceNamedRangeContentRequest)

取代已命名範圍中的內容。

updateSectionStyle

object (UpdateSectionStyleRequest)

更新指定範圍的版面樣式。

insertSectionBreak

object (InsertSectionBreakRequest)

在指定的位置插入分節符號。

deleteHeader

object (DeleteHeaderRequest)

刪除文件中的標頭。

pinTableHeaderRows

object (PinTableHeaderRowsRequest)

更新資料表中的固定標題列數量。

ReplaceAllTextRequest

將符合某個條件的所有文字項目替換為 replace text。

JSON 表示法 
{
  "replaceText": string,
  "tabsCriteria": {
    object (TabsCriteria)
  },

  // Union field criteria can be only one of the following:
  "containsText": {
    object (SubstringMatchCriteria)
  }
  // End of list of possible types for union field criteria.
}
欄位
replaceText

string

要取代相符文字的文字。

tabsCriteria

object (TabsCriteria)

選用設定。用來指定要在哪些分頁中執行替換作業的條件。

省略時，取代部分會套用至所有分頁。

在含有單一分頁的文件中：

  • 如有提供，必須與單一分頁的 ID 相符。

  • 如果省略，替換內容會套用至單一分頁。

在含有多個分頁的文件中：

  • 如有提供，替換項目會套用至指定的分頁。

  • 如果省略，取代部分會套用至所有分頁。

聯集欄位 criteria。用來比對要取代文字的條件。 criteria 只能為下列其中一項：
containsText

object (SubstringMatchCriteria)

在文件中尋找與這個子字串相符的文字。

SubstringMatchCriteria

符合文件中特定文字字串的條件。

JSON 表示法 
{
  "text": string,
  "matchCase": boolean
}
欄位
text

string

要在文件中搜尋的文字。

matchCase

boolean

表示搜尋是否應遵循大小寫：

  • True ：搜尋會區分大小寫。
  • False ：搜尋不區分大小寫。

TabsCriteria

指定要求要在哪些分頁中執行的分頁的條件。

JSON 表示法 
{
  "tabIds": [
    string
  ]
}
欄位
tabIds[]

string

執行要求的分頁 ID 清單。

InsertTextRequest

在指定的位置插入文字。

JSON 表示法 
{
  "text": string,

  // Union field insertion_location can be only one of the following:
  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
  // End of list of possible types for union field insertion_location.
}
欄位
text

string

要插入的文字。

插入換行字元將會間接建立新的 Paragraph 上述索引的結果系統會從目前插入索引的段落複製新段落的樣式，包括清單和項目符號。

系統會自動決定插入文字的文字樣式，一般會沿用鄰近文字的樣式。在大多數情況下，插入文字的文字樣式會緊接在插入索引之前的文字。

從插入的文字中移除部分控製字元 (U+0000-U+0008、U+000C-U+001F) 和 Unicode 基本多語言字面私人使用區域 (U+E000-U+F8FF) 中的字元。

聯集欄位 insertion_location。要插入文字的位置。 insertion_location 只能為下列其中一項：
location

object (Location)

將文字插入文件的特定索引。

文字必須插入現有項目邊界內 Paragraph。舉例來說，您無法將文字插入表格的起始索引 (也就是表格與前段之間)。文字必須插入在前段中。

endOfSegmentLocation

object (EndOfSegmentLocation)

在頁首、頁尾、註腳或文件內文的結尾插入文字。

地區

文件的特定位置。

JSON 表示法 
{
  "segmentId": string,
  "index": integer,
  "tabId": string
}
欄位
segmentId

string

位置所在頁首、頁尾或註腳的 ID。空白區段 ID 代表文件的內文。

index

integer

從零開始的索引，採用 UTF-16 編碼單位。

索引與 segmentId。

tabId

string

位置所在的分頁。如果省略，要求會套用至第一個分頁。

在含有單一分頁的文件中：

  • 如有提供，必須與單一分頁的 ID 相符。

  • 如果省略，要求會套用至單一分頁。

在含有多個分頁的文件中：

  • 如有提供，要求會套用至指定分頁。

  • 如果您省略這個屬性，要求會套用至文件的第一個分頁。

EndOfSegmentLocation

並在內文、頁首、頁尾或註腳結尾的位置。位置緊接在文件區段的最後一行之前。

JSON 表示法 
{
  "segmentId": string,
  "tabId": string
}
欄位
segmentId

string

位置所在頁首、頁尾或註腳的 ID。空白區段 ID 代表文件的內文。

tabId

string

位置所在的分頁。如果省略，要求會套用至第一個分頁。

在含有單一分頁的文件中：

  • 如有提供，必須與單一分頁的 ID 相符。

  • 如果省略，要求會套用至單一分頁。

在含有多個分頁的文件中：

  • 如有提供，要求會套用至指定分頁。

  • 如果您省略這個屬性，要求會套用至文件的第一個分頁。

UpdateTextStyleRequest

更新文字樣式。

JSON 表示法 
{
  "textStyle": {
    object (TextStyle)
  },
  "fields": string,

  // Union field insertion_location can be only one of the following:
  "range": {
    object (Range)
  }
  // End of list of possible types for union field insertion_location.
}
欄位
textStyle

object (TextStyle)

要為文字設定的樣式。

如果特定樣式的值與父項的值相符，該樣式就會設為沿用。

部分文字樣式變更可能會套用其他變更，以反映文件編輯器的行為。詳情請參閱 TextStyle 瞭解詳情

fields

string (FieldMask format)

要更新的欄位。

至少須指定一個欄位。根目錄 textStyle 為默示，且不應該指定。單一 "*" 可做為列出每個欄位的簡寫。

舉例來說，如要將文字樣式更新為粗體，請將 fields 到 "bold"。

如要將屬性重設為預設值，請在欄位遮罩中加入欄位名稱，但不要設定該欄位本身。

聯集欄位 insertion_location。要更新文字樣式的範圍類型。 insertion_location 只能為下列其中一項：
range

object (Range)

要設定樣式的文字範圍。

範圍可以延伸，以納入相鄰的換行符號。

如果整個範圍包含某個清單內的段落，該段落的項目符號也會更新為相符的文字樣式。

無法在相對的 UpdateTextStyleRequest 中插入範圍。

CreateParagraphBulletsRequest

為所有與指定範圍重疊的段落建立項目符號。

每個段落的巢狀結構層級取決於每個段落前方的 Tab 鍵。為避免項目符號與相應段落之間出現過多空間，系統會根據這項要求移除這些開頭的分頁。這可能會改變文字的索引。

如果更新前的段落位於清單中且具有相符預設設定的清單，則系統會將正在更新的段落加到前述清單中。

JSON 表示法 
{
  "range": {
    object (Range)
  },
  "bulletPreset": enum (BulletGlyphPreset)
}
欄位
range

object (Range)

項目符號預設套用的範圍。

bulletPreset

enum (BulletGlyphPreset)

要使用的項目符號符號。

BulletGlyphPreset

清單項目符號的預設模式。

這些模式會使用項目符號：

  • ARROW ：一個箭頭，對應至萬國碼 (Unicode) U+2794 碼點
  • ARROW3D ：具有 3D 陰影的箭頭，對應至萬國碼 (Unicode) U+27a2 碼點
  • CHECKBOX ：中空正方形，對應至萬國碼 (Unicode) U+274f 碼點
  • CIRCLE ：與 Unicode U+25cb 碼點相對應的空心圓
  • DIAMOND ：對應至萬國碼 (Unicode) U+25c6 碼點的實心菱形
  • DIAMONDX ：含有「x」的鑽石，對應 Unicode U+2756 碼點
  • HOLLOWDIAMOND ：空心菱形，對應至萬國碼 (Unicode) U+25c7 碼點
  • DISC ：對應 Unicode U+25cf 編碼點的實心圓
  • SQUARE ：代表萬國碼 (Unicode) U+25a0 碼點的實心正方形
  • STAR ：一個星號，對應至萬國碼 (Unicode) U+2605 碼點
  • ALPHA ：小寫英文字母，例如「a」、「b」或「c」。
  • UPPERALPHA ：大寫字母，例如「A」、「B」或「C」。
  • DECIMAL ：數字，例如「1」、「2」或「3」。
  • ZERODECIMAL ：以零為開頭的數字，例如「01」、「02」或「03」。包含多位數的數字不會加上 0 前置字元。
  • ROMAN ：小寫羅馬數字，例如「i」、「ii」或「iii」。
  • UPPERROMAN ：大寫羅馬數字，例如「I」、「II」或「III」。
  • LEFTTRIANGLE ：指向左方的三角形，對應 Unicode U+25c4 碼點
列舉
BULLET_GLYPH_PRESET_UNSPECIFIED 未指定項目符號預設設定。
BULLET_DISC_CIRCLE_SQUARE 項目符號清單，其中包含 DISC, CIRCLE 和 SQUARE 前 3 個清單巢狀層級的項目符號符號。
BULLET_DIAMONDX_ARROW3D_SQUARE 項目符號清單，其中包含 DIAMONDX, ARROW3D 和 SQUARE 前 3 個清單巢狀層級的項目符號符號。
BULLET_CHECKBOX 項目符號清單，其中包含 CHECKBOX 所有清單巢狀層級的項目符號字符。
BULLET_ARROW_DIAMOND_DISC 項目符號清單，其中包含 ARROW, DIAMOND 和 DISC 前 3 個清單巢狀層級的項目符號符號。
BULLET_STAR_CIRCLE_SQUARE 項目符號清單，其中包含 STAR, CIRCLE 和 SQUARE 前 3 個清單巢狀層級的項目符號符號。
BULLET_ARROW3D_CIRCLE_SQUARE 項目符號清單，其中包含 ARROW3D, CIRCLE 和 SQUARE 前 3 個清單巢狀層級的項目符號符號。
BULLET_LEFTTRIANGLE_DIAMOND_DISC 項目符號清單，其中包含 LEFTTRIANGLE, DIAMOND 和 DISC 前 3 個清單巢狀層級的項目符號符號。
BULLET_DIAMONDX_HOLLOWDIAMOND_SQUARE 項目符號清單，其中包含 DIAMONDX, HOLLOWDIAMOND 和 SQUARE 前 3 個清單巢狀層級的項目符號符號。
BULLET_DIAMOND_CIRCLE_SQUARE 項目符號清單，其中包含 DIAMOND, CIRCLE 和 SQUARE 前 3 個清單巢狀層級的項目符號符號。
NUMBERED_DECIMAL_ALPHA_ROMAN 含有 DECIMAL, ALPHA 和 ROMAN 前 3 個清單巢狀層級的數字字符，後面接著句號。
NUMBERED_DECIMAL_ALPHA_ROMAN_PARENS 含有 DECIMAL, ALPHA 和 ROMAN 前 3 個清單巢狀層級的數值字符，後接括號。
NUMBERED_DECIMAL_NESTED 含有 DECIMAL 以半形句號分隔的數字字符；每個巢狀層級都會使用先前巢狀層級的字符做為前置字元。例如「1.」、「1.1.」，「2.」，「2.2.」。
NUMBERED_UPPERALPHA_ALPHA_ROMAN 含有 UPPERALPHA, ALPHA 和 ROMAN 前 3 個清單巢狀層級的數字字符，後面接著句號。
NUMBERED_UPPERROMAN_UPPERALPHA_DECIMAL 含有 UPPERROMAN, UPPERALPHA 和 DECIMAL 前 3 個清單巢狀層級的數字字符，後面接著句號。
NUMBERED_ZERODECIMAL_ALPHA_ROMAN 含有 ZERODECIMAL, ALPHA 和 ROMAN 前 3 個清單巢狀層級的數字字符，後面接著句號。

DeleteParagraphBulletsRequest

從與指定範圍重疊的所有段落中刪除項目符號。

每個段落的巢狀結構層級都會在對應的段落開頭增加縮排。

JSON 表示法 
{
  "range": {
    object (Range)
  }
}
欄位
range

object (Range)

要刪除項目符號的範圍。

CreateNamedRangeRequest

可建立 NamedRange 參照指定範圍

JSON 表示法 
{
  "name": string,
  "range": {
    object (Range)
  }
}
欄位
name

string

NamedRange 的名稱。名稱可以重複，

名稱長度必須介於 1 至 256 個字元之間，且採 UTF-16 編碼單位。

range

object (Range)

要套用名稱的範圍。

DeleteNamedRangeRequest

刪除 NamedRange。

JSON 表示法 
{
  "tabsCriteria": {
    object (TabsCriteria)
  },

  // Union field named_range_reference can be only one of the following:
  "namedRangeId": string,
  "name": string
  // End of list of possible types for union field named_range_reference.
}
欄位
tabsCriteria

object (TabsCriteria)

選用設定。用來指定要在哪些分頁處刪除範圍。省略時，範圍刪除會套用至所有分頁。

在含有單一分頁的文件中：

  • 如有提供，必須與單一分頁的 ID 相符。

  • 如果省略，範圍刪除作業會套用至單一分頁。

在含有多個分頁的文件中：

  • 如有提供，範圍刪除會套用至指定分頁。

  • 如未提供，範圍刪除設定會套用至所有分頁。

聯集欄位 named_range_reference。這個值可決定要刪除的範圍或範圍。只能設定一個值。 named_range_reference 只能為下列其中一項：
namedRangeId

string

要刪除的已命名範圍 ID。

name

string

要刪除的範圍名稱。系統會刪除所有具指定名稱的已命名範圍，

UpdateParagraphStyleRequest

更新與指定範圍重疊的所有段落樣式。

JSON 表示法 
{
  "paragraphStyle": {
    object (ParagraphStyle)
  },
  "fields": string,

  // Union field insertion_location can be only one of the following:
  "range": {
    object (Range)
  }
  // End of list of possible types for union field insertion_location.
}
欄位
paragraphStyle

object (ParagraphStyle)

要設定段落的樣式。

部分段落樣式變更可能會使其他變更，以反映文件編輯器的行為。詳情請參閱 ParagraphStyle 瞭解詳情

fields

string (FieldMask format)

要更新的欄位。

至少須指定一個欄位。根目錄 paragraphStyle 為默示，且不應該指定。單一 "*" 可做為列出每個欄位的簡寫。

舉例來說，如要更新段落樣式的對齊屬性，請設定 fields 到 "alignment"。

如要將屬性重設為預設值，請在欄位遮罩中加入欄位名稱，但不要設定該欄位本身。

聯集欄位 insertion_location。要更新段落樣式的範圍類型。 insertion_location 只能為下列其中一項：
range

object (Range)

用於設定樣式的段落重疊範圍。

DeleteContentRangeRequest

從文件中刪除內容。

JSON 表示法 
{
  "range": {
    object (Range)
  }
}
欄位
range

object (Range)

要刪除的內容範圍。

如果刪除跨段落邊界的文字，可能會在兩個段落合併後變更段落樣式、清單、定位物件和書籤。

嘗試刪除特定範圍可能會導致文件結構無效，此時會傳回 400 錯誤的要求錯誤。

以下列舉幾個無效刪除要求：

InsertInlineImageRequest

插入 InlineObject 其中包含指定位置的圖片

JSON 表示法 
{
  "uri": string,
  "objectSize": {
    object (Size)
  },

  // Union field insertion_location can be only one of the following:
  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
  // End of list of possible types for union field insertion_location.
}
欄位
uri

string

圖片 URI。

系統會在插入圖片時擷取圖片一次，並會儲存副本以供在文件中顯示。圖片大小不得超過 50 MB、不得超過 2500 萬像素，且須為 PNG、JPEG 或 GIF 格式。

提供的 URI 必須可公開存取，且長度上限為 2 KB。URI 本身會與圖片一併儲存，並透過 ImageProperties.content_uri ] 欄位。

objectSize

object (Size)

圖片應如文件中所示的大小。這個屬性為選用屬性，且文件中的圖片最終大小取決於下列規則：* 如未指定寬度或高度，系統會根據解析度計算預設圖片大小。* 如果指定單一尺寸，系統會計算另一個尺寸以保留圖片的長寬比。* 如果指定了寬度和高度，系統會將圖片縮放至符合提供的尺寸，但維持其長寬比。

聯集欄位 insertion_location。要插入圖片的位置。 insertion_location 只能為下列其中一項：
location

object (Location)

將圖片插入文件的特定索引。

必須將圖像插入現有 Paragraph。舉例來說，系統無法將結構定義插入資料表的起始索引 (也就是表格與前段之間)。

無法在註腳或方程式中插入內嵌圖片。

endOfSegmentLocation

object (EndOfSegmentLocation)

在頁首、頁尾或文件內文的結尾插入文字。

無法在註腳中插入內嵌圖片。

InsertTableRequest

在指定位置插入資料表。

系統會在插入的資料表前插入新行字元。

JSON 表示法 
{
  "rows": integer,
  "columns": integer,

  // Union field insertion_location can be only one of the following:
  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
  // End of list of possible types for union field insertion_location.
}
欄位
rows

integer

資料表中的資料列數。

columns

integer

資料表中的資料欄數。

聯集欄位 insertion_location。插入資料表的位置。 insertion_location 只能為下列其中一項：
location

object (Location)

將資料表插入特定的模型索引。

系統會在插入的資料表前插入新行字元，因此資料表起始索引會位於指定的位置索引 + 1。

表格必須插入現有 Paragraph。例如，您無法將資料插入資料表的起始索引 (也就是在現有資料表與前段之間)。

無法在註腳或方程式中插入表格。

endOfSegmentLocation

object (EndOfSegmentLocation)

在指定的頁首、頁尾或文件內文的結尾插入表格。系統會在插入的資料表前插入新行字元。

無法在註腳中插入表格。

InsertTableRowRequest

在表格中插入空白列。

JSON 表示法 
{
  "tableCellLocation": {
    object (TableCellLocation)
  },
  "insertBelow": boolean
}
欄位
tableCellLocation

object (TableCellLocation)

要插入資料列的參照表格儲存格位置。

系統會在參照儲存格所在的資料列上方 (或下方) 插入新資料列。如果參照儲存格是合併的儲存格，系統會在合併的儲存格上方 (或下方) 插入一個新資料列。

insertBelow

boolean

是否在參照儲存格位置的下方插入新列。

  • True ：在儲存格下方插入。
  • False ：在儲存格上方插入。

TableCellLocation

表格中單一儲存格的位置。

JSON 表示法 
{
  "tableStartLocation": {
    object (Location)
  },
  "rowIndex": integer,
  "columnIndex": integer
}
欄位
tableStartLocation

object (Location)

文件中表格的位置。

rowIndex

integer

從零開始的資料列索引。舉例來說，資料表第二列的資料列索引為 1。

columnIndex

integer

從零開始的資料欄索引。舉例來說，資料表第二欄的欄索引是 1。

InsertTableColumnRequest

在表格中插入空白資料欄。

JSON 表示法 
{
  "tableCellLocation": {
    object (TableCellLocation)
  },
  "insertRight": boolean
}
欄位
tableCellLocation

object (TableCellLocation)

要插入資料欄的參照表格儲存格位置。

系統會在參照儲存格所在的資料欄左側 (或右側) 插入新的欄。如果參照儲存格是合併的儲存格，系統會在合併儲存格的左側 (或右側) 插入新資料欄。

insertRight

boolean

是否在參照儲存格位置的右側插入新欄。

  • True ：向右插入。
  • False ：向左插入。

DeleteTableRowRequest

從資料表中刪除資料列。

JSON 表示法 
{
  "tableCellLocation": {
    object (TableCellLocation)
  }
}
欄位
tableCellLocation

object (TableCellLocation)

這個參照表格儲存格是從哪個位置刪除該列。

系統將刪除這個儲存格範圍所在的列。如果合併的儲存格含有多個資料列，則儲存格範圍中的所有資料列都會遭到刪除。刪除後，如果資料表中沒有任何資料列，系統會刪除整個資料表。

DeleteTableColumnRequest

從表格中刪除資料欄。

JSON 表示法 
{
  "tableCellLocation": {
    object (TableCellLocation)
  }
}
欄位
tableCellLocation

object (TableCellLocation)

要從中刪除資料欄的參照表格儲存格位置。

即將刪除這個儲存格範圍的資料欄。如果合併的儲存格涵蓋多個資料欄，則儲存格範圍涵蓋的所有資料欄將遭到刪除。刪除後，如果資料表中沒有任何資料欄，系統會刪除整個資料表。

InsertPageBreakRequest

在指定的位置插入分頁符號，並在後面插入換行符號。

JSON 表示法 
{

  // Union field insertion_location can be only one of the following:
  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
  // End of list of possible types for union field insertion_location.
}
欄位
聯集欄位 insertion_location。插入分頁符號的位置。 insertion_location 只能為下列其中一項：
location

object (Location)

在文件的特定索引插入分頁符號。

您必須將分頁符號插入現有現有文件的邊界內 Paragraph。舉例來說，系統無法將結構定義插入資料表的起始索引 (也就是表格與前段之間)。

無法在表格、方程式、註腳、頁首或頁尾中插入分頁符號。由於分頁符號只能在內文中插入，因此 segment ID 欄位必須空白。

endOfSegmentLocation

object (EndOfSegmentLocation)

在文件內文結尾插入分頁符號。

無法在註腳、頁首或頁尾中插入分頁符號。由於分頁符號只能在內文中插入，因此 segment ID 欄位必須空白。

DeletePositionedObjectRequest

刪除 PositionedObject

JSON 表示法 
{
  "objectId": string,
  "tabId": string
}
欄位
objectId

string

要刪除的定位物件 ID。

tabId

string

待刪除物件的分頁位於其中。如果省略，要求會套用至第一個分頁。

在含有單一分頁的文件中：

  • 如有提供，必須與單一分頁的 ID 相符。

  • 如果省略，要求會套用至單一分頁。

在含有多個分頁的文件中：

  • 如有提供，要求會套用至指定分頁。

  • 如果您省略這個屬性，要求會套用至文件的第一個分頁。

UpdateTableColumnPropertiesRequest

更新 TableColumnProperties 。

JSON 表示法 
{
  "tableStartLocation": {
    object (Location)
  },
  "columnIndices": [
    integer
  ],
  "tableColumnProperties": {
    object (TableColumnProperties)
  },
  "fields": string
}
欄位
tableStartLocation

object (Location)

文件中表格的位置。

columnIndices[]

integer

從零開始的資料欄索引清單，其屬性應更新。如果沒有指定索引，就會更新所有資料欄。

tableColumnProperties

object (TableColumnProperties)

要更新的表格欄屬性。

如果 tableColumnProperties#width 少於 5 個點 (5/72 英寸)，系統會傳回 400 錯誤的要求錯誤。

fields

string (FieldMask format)

要更新的欄位。

至少須指定一個欄位。根目錄 tableColumnProperties 為默示，且不應該指定。單一 "*" 可做為列出每個欄位的簡寫。

舉例來說，如要更新資料欄寬度，請將 fields 到 "width"。

UpdateTableCellStyleRequest

更新表格儲存格範圍的樣式。

JSON 表示法 
{
  "tableCellStyle": {
    object (TableCellStyle)
  },
  "fields": string,

  // Union field cells can be only one of the following:
  "tableRange": {
    object (TableRange)
  },
  "tableStartLocation": {
    object (Location)
  }
  // End of list of possible types for union field cells.
}
欄位
tableCellStyle

object (TableCellStyle)

要在表格儲存格上設定的樣式，

更新邊框時，如果儲存格與相鄰儲存格共用邊框，相鄰儲存格的對應框線屬性也會更新。合併和隱藏的邊界不會更新。

由於在同一個要求中更新相鄰儲存格共用的邊框，可能會造成邊框更新發生衝突，因此系統會按照以下順序更新邊框：

  • borderRight
  • borderLeft
  • borderBottom
  • borderTop
fields

string (FieldMask format)

要更新的欄位。

至少須指定一個欄位。根目錄 tableCellStyle 為默示，且不應該指定。單一 "*" 可做為列出每個欄位的簡寫。

舉例來說，如要更新表格儲存格的背景顏色，請將 fields 到 "backgroundColor"。

如要將屬性重設為預設值，請在欄位遮罩中加入欄位名稱，但不要設定該欄位本身。

聯集欄位 cells。即將更新的儲存格。 cells 只能為下列其中一項：
tableRange

object (TableRange)

這個表格範圍代表要套用更新的資料表中子集。

tableStartLocation

object (Location)

文件中表格的位置。如有指定，更新就會套用至表格中的所有儲存格。

TableRange

表格範圍代表對資料表子集的參照。

請特別注意，表格範圍指定的儲存格不一定會形成矩形。舉例來說，假設有一份 3 x 3 的表格，其中最後一列所有的儲存格都合併在一起。資料表如下所示： 

 [   ][   ][   ]
 [   ][   ][   ]
 [             ]

如果表格範圍中的表格儲存格位置 = (tableStartLocation，列 = 0，欄 = 0)、列時距 = 3，欄範圍 = 2 則指定下列儲存格： 

 [ x ][ x ][   ]
 [ x ][ x ][   ]
 [ x    x    x ]
JSON 表示法 
{
  "tableCellLocation": {
    object (TableCellLocation)
  },
  "rowSpan": integer,
  "columnSpan": integer
}
欄位
tableCellLocation

object (TableCellLocation)

表格範圍的起始儲存格位置。

rowSpan

integer

表格範圍的資料列時距，

columnSpan

integer

表格範圍的資料欄時距。

UpdateTableRowStyleRequest

更新 TableRowStyle 資料表中的資料列

JSON 表示法 
{
  "tableStartLocation": {
    object (Location)
  },
  "rowIndices": [
    integer
  ],
  "tableRowStyle": {
    object (TableRowStyle)
  },
  "fields": string
}
欄位
tableStartLocation

object (Location)

文件中表格的位置。

rowIndices[]

integer

從零開始列索引的清單，其樣式應更新。如果沒有指定索引，就會更新所有資料列。

tableRowStyle

object (TableRowStyle)

要在資料列上設定的樣式，

fields

string (FieldMask format)

要更新的欄位。

至少須指定一個欄位。根目錄 tableRowStyle 為默示，且不應該指定。單一 "*" 可做為列出每個欄位的簡寫。

舉例來說，如要更新資料列的最小高度，請將 fields 到 "minRowHeight"。

ReplaceImageRequest

使用新圖片取代現有圖片。

取代圖片會移除一部分 image effects ，以反映文件編輯器的行為。

JSON 表示法 
{
  "imageObjectId": string,
  "uri": string,
  "imageReplaceMethod": enum (ImageReplaceMethod),
  "tabId": string
}
欄位
imageObjectId

string

要替換的現有圖片 ID。您可以從 get 要求的回應中擷取 ID。

uri

string

新圖片的 URI。

系統會在插入圖片時擷取圖片一次，並會儲存副本以供在文件中顯示。圖片必須小於 50 MB、不得超過 2500 萬像素，且格式須為 PNG、JPEG 或 GIF。

提供的 URI 長度不得超過 2 KB。URI 會與圖片一併儲存，並透過 ImageProperties.source_uri ] 欄位。

imageReplaceMethod

enum (ImageReplaceMethod)

取代方式。

tabId

string

要取代圖片的分頁。如果省略，要求會套用至第一個分頁。

在含有單一分頁的文件中：

  • 如有提供，必須與單一分頁的 ID 相符。

  • 如果省略，要求會套用至單一分頁。

在含有多個分頁的文件中：

  • 如有提供，要求會套用至指定分頁。

  • 如果您省略這個屬性，要求會套用至文件的第一個分頁。

ImageReplaceMethod

圖片取代方法。

列舉
IMAGE_REPLACE_METHOD_UNSPECIFIED 未指定的圖片取代方法。不能使用這個值。
CENTER_CROP 縮放及置中圖片，填滿原始圖片的邊界。系統可能會裁剪圖片，以填滿原始圖片的邊界。圖片顯示的大小會與原始圖片相同。

UpdateDocumentStyleRequest

更新 DocumentStyle。

JSON 表示法 
{
  "documentStyle": {
    object (DocumentStyle)
  },
  "fields": string,
  "tabId": string
}
欄位
documentStyle

object (DocumentStyle)

要設定的文件樣式。

部分文件樣式變更可能會使其他變更，以反映文件編輯器的行為。詳情請參閱 DocumentStyle 瞭解詳情

fields

string (FieldMask format)

要更新的欄位。

至少須指定一個欄位。根目錄 documentStyle 為默示，且不應該指定。單一 "*" 可做為列出每個欄位的簡寫。

例如更新背景 fields 到 "background"。

tabId

string

包含待更新樣式的分頁。如果省略，要求會套用至第一個分頁。

在含有單一分頁的文件中：

  • 如有提供，必須與單一分頁的 ID 相符。

  • 如果省略，要求會套用至單一分頁。

在含有多個分頁的文件中：

  • 如有提供，要求會套用至指定分頁。

  • 如未提供，要求會套用至文件的第一個分頁。

MergeTableCellsRequest

合併 Table。

JSON 表示法 
{
  "tableRange": {
    object (TableRange)
  }
}
欄位
tableRange

object (TableRange)

表格範圍，用於指定要合併的表格儲存格。

合併的儲存格中的任何文字都會串連起來，並儲存在「head」儲存格範圍。這是內容方向從左到右時範圍的左上儲存格，如果不是，則這是範圍的右上角儲存格。

如果這個範圍不是矩形 (在某些情況下，這個範圍可能涵蓋已合併的儲存格或表格並非矩形)，則會傳回 400 錯誤要求錯誤。

UnmergeTableCellsRequest

取消合併以下儲存格中的儲存格： Table。

JSON 表示法 
{
  "tableRange": {
    object (TableRange)
  }
}
欄位
tableRange

object (TableRange)

表格範圍，用於指定要取消合併的表格儲存格。

此範圍中所有合併的儲存格都會取消合併，且已取消合併的儲存格不會受到影響。如果範圍未包含合併的儲存格，要求則不會執行任何操作。

如果合併的儲存格中有任何文字，文字仍會保留在「head」中包含未合併儲存格的結果儲存格。「head」儲存格是指內容方向從左到右時左上方儲存格，如果不是的話，則是指右上角儲存格。

CreateHeaderRequest

可建立 Header。這樣新的標頭就會套用至 SectionStyle 在 SectionBreak 如果有指定，則會套用至 DocumentStyle。

如果指定的標頭已存在，系統會傳回 400 錯誤的要求錯誤。

JSON 表示法 
{
  "type": enum (HeaderFooterType),
  "sectionBreakLocation": {
    object (Location)
  }
}
欄位
type

enum (HeaderFooterType)

要建立的標頭類型。

sectionBreakLocation

object (Location)

如果 Pod 的位置 SectionBreak 這個標頭所屬的區段開頭。如果 `sectionBreakLocation'未設定，或參照文件內文的第一個分節符號，則標頭會套用至 DocumentStyle

HeaderFooterType

可建立的頁首和頁尾類型。

列舉
DEFAULT 預設的頁首/頁尾。

CreateFooterRequest

可建立 Footer。新頁尾會套用到 SectionStyle 在 SectionBreak 如果有指定，則會套用至 DocumentStyle。

如果指定類型的頁尾已存在，系統會傳回 400 錯誤的要求錯誤。

JSON 表示法 
{
  "type": enum (HeaderFooterType),
  "sectionBreakLocation": {
    object (Location)
  }
}
欄位
type

enum (HeaderFooterType)

要建立的頁尾類型。

sectionBreakLocation

object (Location)

Deployment 的 SectionBreak 緊接在 SectionStyle 應加入此頁尾。如未設定這項政策或參照文件中第一個分節符號，則頁尾會套用至文件樣式。

CreateFootnoteRequest

可建立 Footnote 然後插入一個新的區隔 FootnoteReference 傳送到特定位置的 Pod

而 Footnote 區隔會包含空格，後面接著換行字元。

JSON 表示法 
{

  // Union field footnote_reference_location can be only one of the following:
  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
  // End of list of possible types for union field footnote_reference_location.
}
欄位
聯集欄位 footnote_reference_location。要插入註腳參照的位置。 footnote_reference_location 只能為下列其中一項：
location

object (Location)

將註腳參照插入文件的特定索引。

註腳參考必須插入現有項目邊界內 Paragraph。舉例來說，系統無法將結構定義插入資料表的起始索引 (也就是表格與前段之間)。

註腳參考不得插入方程式、標頭、頁尾或註腳中。由於註腳參考只能插入內文，因此 segment ID 欄位必須空白。

endOfSegmentLocation

object (EndOfSegmentLocation)

在文件內文結尾插入註腳參考。

不得在標頭、頁尾或註腳中插入註腳參考。由於註腳參考只能插入內文，因此 segment ID 欄位必須空白。

ReplaceNamedRangeContentRequest

將指定的內容 NamedRange 或 NamedRanges 與指定的替換內容搭配使用

請注意， NamedRange 可能包含多個不連續 ranges。在此情況下，系統只會取代第一個範圍的內容。系統將刪除其他範圍及其內容。

在取代或刪除範圍會導致文件結構無效的情況下，系統會傳回 400 錯誤的要求錯誤。

JSON 表示法 
{
  "tabsCriteria": {
    object (TabsCriteria)
  },

  // Union field replacement_content can be only one of the following:
  "text": string
  // End of list of possible types for union field replacement_content.

  // Union field named_range_reference can be only one of the following:
  "namedRangeId": string,
  "namedRangeName": string
  // End of list of possible types for union field named_range_reference.
}
欄位
tabsCriteria

object (TabsCriteria)

選用設定。用來指定要在哪些分頁中執行替換作業的條件。省略時，取代部分會套用至所有分頁。

在含有單一分頁的文件中：

  • 如有提供，必須與單一分頁的 ID 相符。

  • 如果省略，替換內容會套用至單一分頁。

在含有多個分頁的文件中：

  • 如有提供，替換項目會套用至指定的分頁。

  • 如果省略，取代部分會套用至所有分頁。

聯集欄位 replacement_content。要用來取代已命名範圍現有內容的內容。 replacement_content 只能為下列其中一項：
text

string

將指定已命名範圍的內容替換成指定文字。

聯集欄位 named_range_reference。對內容將被取代的已命名範圍的參照。 named_range_reference 只能為下列其中一項：
namedRangeId

string

要替換其內容的已命名範圍 ID。

如果沒有指定 ID 的已命名範圍，則會傳回 400 錯誤的要求錯誤。

namedRangeName

string

清單的名稱 NamedRanges 其內容將被替換

如有多個 named ranges ，那麼每個項目的內容都會被取代。如果沒有指定名稱的已命名範圍，則要求為免人工管理。

UpdateSectionStyleRequest

更新 SectionStyle。

JSON 表示法 
{
  "range": {
    object (Range)
  },
  "sectionStyle": {
    object (SectionStyle)
  },
  "fields": string
}
欄位
range

object (Range)

範圍重疊了區段與樣式。

由於分節符號只能在內文中插入，因此 segment ID 欄位必須空白。

sectionStyle

object (SectionStyle)

要在區塊設定的樣式。

部分區段樣式變更可能會造成其他變更，以反映文件編輯器的行為。詳情請參閱 SectionStyle 瞭解詳情

fields

string (FieldMask format)

要更新的欄位。

至少須指定一個欄位。根目錄 sectionStyle 為默示，且不得指定。單一 "*" 可做為列出每個欄位的簡寫。

舉例來說，如果想更新左邊界，請將 fields 到 "marginLeft"。

InsertSectionBreakRequest

在指定位置插入分節符號。

系統會在分節符號前插入換行字元。

JSON 表示法 
{
  "sectionType": enum (SectionType),

  // Union field insertion_location can be only one of the following:
  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
  // End of list of possible types for union field insertion_location.
}
欄位
sectionType

enum (SectionType)

要插入的區塊類型。

聯集欄位 insertion_location。要插入換行符號的位置。 insertion_location 只能為下列其中一項：
location

object (Location)

在文件的特定索引插入換行符號和分節符號。

分節符號必須插入現有項目邊界內 Paragraph。舉例來說，系統無法將結構定義插入資料表的起始索引 (也就是表格與前段之間)。

無法在表格、方程式、註腳、標題或頁尾中插入分節符號。由於分節符號只能在內文中插入，因此 segment ID 欄位必須空白。

endOfSegmentLocation

object (EndOfSegmentLocation)

在文件內文結尾插入換行符號和分節符號。

你無法在註腳、頁首或頁尾中插入分節符號。由於分節符號只能在內文中插入，因此 segment ID 欄位必須空白。

DeleteHeaderRequest

刪除 Header

JSON 表示法 
{
  "headerId": string,
  "tabId": string
}
欄位
headerId

string

待刪除標題的 ID。如果這個標頭是在 DocumentStyle，系統會移除這個標頭的參照，因此文件的第一部分就不會出現該類型的標頭。如果這個標頭是在 SectionStyle，系統會移除這個標頭的參照，且該類型的標頭會從上一節接續處理。

tabId

string

含有要刪除的標頭的分頁。如果省略，要求會套用至第一個分頁。

在含有單一分頁的文件中：

  • 如有提供，必須與單一分頁的 ID 相符。

  • 如果省略，要求會套用至單一分頁。

在含有多個分頁的文件中：

  • 如有提供，要求會套用至指定分頁。

  • 如果您省略這個屬性，要求會套用至文件的第一個分頁。

DeleteFooterRequest

刪除 Footer

JSON 表示法 
{
  "footerId": string,
  "tabId": string
}
欄位
footerId

string

要刪除的頁尾 ID。如果定義頁尾 DocumentStyle，系統將移除此頁尾的參照，因此文件的第一個部分不會顯示該類型的頁尾。如果這個頁尾是在 SectionStyle，系統會移除此頁尾的參照，並將該類型的頁尾接續到前一節。

tabId

string

包含要刪除的頁尾的分頁。如果省略，要求會套用至第一個分頁。

在含有單一分頁的文件中：

  • 如有提供，必須與單一分頁的 ID 相符。

  • 如果省略，要求會套用至單一分頁。

在含有多個分頁的文件中：

  • 如有提供，要求會套用至指定分頁。

  • 如果您省略這個屬性，要求會套用至文件的第一個分頁。

PinTableHeaderRowsRequest

更新資料表中的固定表格標題列數量。

JSON 表示法 
{
  "tableStartLocation": {
    object (Location)
  },
  "pinnedHeaderRowsCount": integer
}
欄位
tableStartLocation

object (Location)

文件中表格的位置。

pinnedHeaderRowsCount

integer

要固定的資料表列數，其中 0 表示所有資料列均未固定。