Requests

object (CreateSlideRequest)

建立新投影片。

object (CreateShapeRequest)

建立新圖案。

object (CreateTableRequest)

建立新資料表。

object (InsertTextRequest)

在圖案或表格儲存格中插入文字。

object (InsertTableRowsRequest)

在表格中插入列。

object (InsertTableColumnsRequest)

在表格中插入欄。

object (DeleteTableRowRequest)

從資料表中刪除資料列。

object (DeleteTableColumnRequest)

從表格中刪除資料欄。

object (ReplaceAllTextRequest)

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

object (DeleteObjectRequest)

從簡報中刪除頁面或網頁元素。

object (UpdatePageElementTransformRequest)

更新網頁元素的轉換。

object (UpdateSlidesPositionRequest)

更新簡報中一組投影片的位置。

object (DeleteTextRequest)

從圖案或表格儲存格中刪除文字。

object (CreateImageRequest)

製作圖片。

object (CreateVideoRequest)

建立影片。

object (CreateSheetsChartRequest)

建立內嵌的 Google 試算表圖表。

object (CreateLineRequest)

建立線條。

object (RefreshSheetsChartRequest)

重新整理 Google 試算表圖表。

object (UpdateShapePropertiesRequest)

更新 Shape 的屬性。

object (UpdateImagePropertiesRequest)

更新 Image 的屬性。

object (UpdateVideoPropertiesRequest)

更新 Video 的屬性。

object (UpdatePagePropertiesRequest)

更新 Page 的屬性。

object (UpdateTableCellPropertiesRequest)

更新 TableCell 的屬性。

object (UpdateLinePropertiesRequest)

更新 Line 的屬性。

object (CreateParagraphBulletsRequest)

為段落建立項目符號。

object (ReplaceAllShapesWithImageRequest)

將符合特定條件的所有圖形替換為圖片。

object (DuplicateObjectRequest)

複製投影片或網頁元素。

object (UpdateTextStyleRequest)

更新 Shape 或 Table 內的文字樣式。

object (ReplaceAllShapesWithSheetsChartRequest)

將符合特定條件的所有圖案替換為 Google 試算表圖表。

object (DeleteParagraphBulletsRequest)

刪除段落中的項目符號。

object (UpdateParagraphStyleRequest)

更新 Shape 或 Table 內的段落樣式。

object (UpdateTableBorderPropertiesRequest)

更新 Table 中表格框線的屬性。

object (UpdateTableColumnPropertiesRequest)

更新 Table 資料欄的屬性。

object (UpdateTableRowPropertiesRequest)

更新資料列的屬性。Table

object (MergeTableCellsRequest)

合併 Table 中的儲存格。

object (UnmergeTableCellsRequest)

取消合併 Table 中的儲存格。

object (GroupObjectsRequest)

將物件 (例如網頁元素) 分組。

object (UngroupObjectsRequest)

取消物件群組，例如 groups。

object (UpdatePageElementAltTextRequest)

更新圖片的替代文字標題和/或說明。page element

object (ReplaceImageRequest)

以新圖片取代現有圖片。

object (UpdateSlidePropertiesRequest)

更新 Slide 的屬性

object (UpdatePageElementsZOrderRequest)

更新 page elements 的 Z 順序。

object (UpdateLineCategoryRequest)

更新 line 的類別。

object (RerouteLineRequest)

重新將 line 路由，使其連線至所連線頁面元素上最接近的兩個連線網站。

object (InsertCommentRequest)

在簡報中插入 CommentThread 。

object (AddCommentReplyRequest)

回覆 CommentThread。

object (UpdateCommentPostRequest)

更新現有貼文 (主貼文或回覆) 的 CommentThread。

object (DeleteCommentRequest)

刪除 CommentThread。

object (DeleteCommentReplyRequest)

從 CommentThread 中刪除回覆 Post。

string

使用者提供的物件 ID。

如果指定 ID，簡報中所有網頁和網頁元素都不得重複。ID 開頭必須是英數字元或底線 (符合 regex [a-zA-Z0-9_])，其餘字元可包含英數字元、底線、連字號或半形冒號 (符合 regex [a-zA-Z0-9_-:])。ID 長度必須介於 5 到 50 個字元之間 (含頭尾)。

如未指定 ID，系統會產生專屬 ID。

integer

選用的零起始索引，指出要插入投影片的位置。

如果未指定索引，系統會在結尾建立投影片。

object (LayoutReference)

要插入的投影片的版面配置參照，根據目前母片，可以是下列其中一項：

• 前一張投影片索引的主版。
• 如果 insertionIndex 為零，則為第一張投影片的母片。
• 簡報中的第一個母片 (如果沒有投影片)。

如果系統在目前的主版中找不到 LayoutReference，就會傳回 400 錯誤要求。

如未指定版面配置參照，投影片會使用預先定義的BLANK版面配置。

object (LayoutPlaceholderIdMapping)

從版面配置的 placeholder 到在指定版面配置的投影片上建立的預留位置，物件 ID 對應清單 (選用)。只能在指定 slideLayoutReference 時使用。

enum (PredefinedLayout)

預先定義的版面配置。

string

版面配置 ID：簡報中其中一個版面配置的物件 ID。

string

使用者提供的物件 ID，用於在投影片上建立上述預留位置。

如果指定 ID，簡報中所有網頁和網頁元素都不得重複。ID 開頭必須是英數字元或底線 (符合 regex [a-zA-Z0-9_])，其餘字元可包含英數字元、底線、連字號或半形冒號 (符合 regex [a-zA-Z0-9_-:])。ID 長度不得少於 5 個字元，也不得超過 50 個字元。

如未指定 ID，系統會產生專屬 ID。

object (Placeholder)

版面配置中的預留位置，會套用至投影片。只需要 type 和 index。舉例來說，預先定義的TITLE_AND_BODY版面配置通常會有索引為 0 的 TITLE 預留位置，以及索引為 0 的 BODY 預留位置。

string

版面配置上預留位置的物件 ID，將套用至投影片。

string

使用者提供的物件 ID。

如果指定 ID，簡報中所有網頁和網頁元素都不得重複。ID 開頭必須是英數字元或底線 (符合 regex [a-zA-Z0-9_])，其餘字元可包含英數字元、底線、連字號或半形冒號 (符合 regex [a-zA-Z0-9_-:])。ID 長度不得少於 5 個字元，也不得超過 50 個字元。如果留空，系統會產生專屬 ID。

object (PageElementProperties)

形狀的元素屬性。

enum (Type)

形狀類型。

string

元素所在頁面的物件 ID。

object (Size)

元素的大小。

object (AffineTransform)

元素的轉換。

string

使用者提供的物件 ID。

如果指定 ID，簡報中所有網頁和網頁元素都不得重複。ID 開頭必須是英數字元或底線 (符合 regex [a-zA-Z0-9_])，其餘字元可包含英數字元、底線、連字號或半形冒號 (符合 regex [a-zA-Z0-9_-:])。ID 長度不得少於 5 個字元，也不得超過 50 個字元。

如未指定 ID，系統會產生專屬 ID。

object (PageElementProperties)

資料表的元素屬性。

系統會以您提供的大小建立資料表，但不得小於下限。如果未提供大小，系統會自動調整表格大小。

表格轉換的比例必須為 1，且不得有剪切元件。如果未提供轉換，表格會置中顯示在頁面上。

integer

資料表中的資料列數。

integer

資料表中的欄數。

string

要插入文字的圖案或表格物件 ID。

object (TableCellLocation)

如要將文字插入表格儲存格，則為選填的表格儲存格位置。如果有的話，objectId 必須參照資料表。

string

要插入的文字。

插入換行字元時，系統會隱含地在該索引處建立新的 ParagraphMarker。新段落的段落樣式會從目前插入索引處的段落複製，包括清單和項目符號。

系統會自動決定插入文字的文字樣式，通常會保留鄰近文字的樣式。在大多數情況下，文字會新增至插入索引處的 TextRun。

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

integer

以 Unicode 程式碼單元為單位，根據 TextElement 索引，指出要插入文字的索引。

索引以零為基準，並從字串開頭計算。系統可能會調整索引，避免在 Unicode 字素叢集內插入內容。在這些情況下，系統會將文字插入字素叢集後方。

string

要插入列的表格。

object (TableCellLocation)

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

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

boolean

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

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

integer

要插入的列數。每項要求最多 20 個。

string

要插入資料欄的表格。

object (TableCellLocation)

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

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

boolean

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

• True ：插入右側。
• False : insert to the left.

integer

要插入的欄數。每項要求最多 20 個。

string

要從中刪除資料列的表格。

object (TableCellLocation)

要刪除資料列的參照表格儲存格位置。

系統會刪除這個儲存格跨越的資料列。如果是合併儲存格，系統會刪除多個資料列。如果刪除後資料表中沒有任何資料列，系統會刪除整個資料表。

string

要從中刪除資料欄的表格。

object (TableCellLocation)

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

系統會刪除這個儲存格跨越的資料欄。如果是合併儲存格，系統會刪除多個欄。如果刪除後資料表中沒有任何資料欄，系統會刪除整個資料表。

string

要取代相符文字的文字。

string

如果不是空白，則比對結果只會顯示指定網頁上的網頁元素。

如果提供 notes master 的頁面物件 ID，或簡報中沒有該物件 ID 的頁面，則會傳回 400 錯誤要求。

object (SubstringMatchCriteria)

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

string

要在圖案或表格中搜尋的文字。

boolean

指出搜尋是否應區分大小寫：

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

boolean

(選用步驟) 如果應將尋找值視為規則運算式，則為 True。模式中的所有反斜線都應逸出。

• True ：搜尋文字會視為規則運算式。
• False ：搜尋文字會視為子字串進行比對。

string

要刪除的網頁或網頁元素物件 ID。

如果刪除作業後，group 只包含 1 個或不包含任何頁面元素，系統也會刪除群組。

如果版面配置中的預留位置遭到刪除，所有空白的繼承預留位置也會一併刪除。

string

要更新的網頁元素物件 ID。

object (AffineTransform)

用於更新網頁元素的輸入轉換矩陣。

enum (ApplyMode)

轉換更新的套用模式。

string

要移動的簡報投影片 ID。這份清單中的投影片必須按照現有簡報順序排列，且不得重複。

integer

投影片的插入位置索引，以移動前的投影片排列方式為準。必須介於零和簡報中的投影片數量之間 (含)。

string

要刪除文字的圖案或表格的物件 ID。

object (TableCellLocation)

如果文字要從表格儲存格中刪除，則為選用的表格儲存格位置。如果有的話，objectId 必須參照資料表。

object (Range)

要刪除的文字範圍 (以TextElement索引為準)。

形狀或表格儲存格的文字結尾一律會有隱含的換行字元，無法刪除。 Range.Type.ALL 會使用正確的界線，但為範圍類型指定明確界線時，請務必小心 FROM_START_INDEX 和 FIXED_RANGE。舉例來說，如果文字是「ABC」，後面接著隱含換行符，則 textRange.start_index 的最大值為 2，textRange.end_index 的最大值為 3。

刪除跨越段落邊界的文字時，系統會合併兩個段落，因此段落樣式和清單可能會有所變更。

如果範圍只包含一個代理配對的程式碼單元，系統會擴展範圍，納入兩個程式碼單元。

integer

集合開頭的選用索引 (以零為基準)。FIXED_RANGE 和 FROM_START_INDEX 範圍為必填欄位。

integer

集合結尾的選填索引 (以零為基準)。FIXED_RANGE範圍為必填欄位。

enum (Type)

範圍類型。

string

使用者提供的物件 ID。

如果指定 ID，簡報中所有網頁和網頁元素都不得重複。ID 開頭必須是英數字元或底線 (符合 regex [a-zA-Z0-9_])，其餘字元可包含英數字元、底線、連字號或半形冒號 (符合 regex [a-zA-Z0-9_-:])。ID 長度不得少於 5 個字元，也不得超過 50 個字元。

如未指定 ID，系統會產生專屬 ID。

object (PageElementProperties)

圖片的元素屬性。

如果提供的尺寸顯示比例與圖片顯示比例不符，系統會根據尺寸縮放圖片並置中，以維持顯示比例。這項作業完成後，系統會套用提供的轉換。

PageElementProperties.size 屬性為選用項目。如未指定大小，系統會使用圖片的預設大小。

PageElementProperties.transform 屬性為選用項目。如果未指定轉換，圖片會放置在頁面左上角。

string

圖片網址。

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

提供的網址必須可公開存取，且長度不得超過 2 KB。網址會與圖片一併儲存，並透過 Image.source_url 欄位公開。

string

使用者提供的物件 ID。

如果指定 ID，簡報中所有網頁和網頁元素都不得重複。ID 開頭必須是英數字元或底線 (符合 regex [a-zA-Z0-9_])，其餘字元可包含英數字元、底線、連字號或半形冒號 (符合 regex [a-zA-Z0-9_-:])。ID 長度不得少於 5 個字元，也不得超過 50 個字元。

如未指定 ID，系統會產生專屬 ID。

object (PageElementProperties)

影片的元素屬性。

PageElementProperties.size 屬性為選用項目。如未指定大小，伺服器會選擇預設大小。

PageElementProperties.transform 屬性為選用項目。轉換不得有剪切元件。如果未指定轉換，影片會放置在網頁左上角。

enum (Source)

影片來源。

string

這部影片的影片來源專屬 ID。

例如：YouTube 影片 https://www.youtube.com/watch?v=7U3axjORYZ0 的 ID 為 7U3axjORYZ0。Google 雲端硬碟影片 https://drive.google.com/file/d/1xCgQLFTJi5_Xl8DgW_lcUYq5e-q6Hi5Q ID 為 1xCgQLFTJi5_Xl8DgW_lcUYq5e-q6Hi5Q。

如要存取 Google 雲端硬碟影片檔案，您可能需要為部分舊檔案的 HTTP 標頭新增資源金鑰。詳情請參閱「使用資源金鑰存取透過連結共用的檔案」。

string

使用者提供的物件 ID。

如果指定 ID，簡報中所有網頁和網頁元素都不得重複。ID 開頭應為字元 [a-zA-Z0-9_]，後面可接任意數量的下列字元 [a-zA-Z0-9_-:]。ID 長度不得少於 5 個字元，也不得超過 50 個字元。如果留空，系統會產生專屬 ID。

object (PageElementProperties)

圖表的元素屬性。

如果提供的尺寸顯示比例與圖表顯示比例不符，系統會根據尺寸縮放圖表並置中，以維持顯示比例。這項作業完成後，系統會套用提供的轉換。

string

含有圖表的 Google 試算表 ID。

您可能需要為部分舊檔案的 HTTP 標頭新增資源金鑰。詳情請參閱「使用資源金鑰存取透過連結共用的檔案」。

integer

Google 試算表中的特定圖表 ID。

enum (LinkingMode)

圖表連結至來源試算表的模式。如未指定，圖表會是未連結的圖片。

string

使用者提供的物件 ID。

如果指定 ID，簡報中所有網頁和網頁元素都不得重複。ID 開頭必須是英數字元或底線 (符合 regex [a-zA-Z0-9_])，其餘字元可包含英數字元、底線、連字號或半形冒號 (符合 regex [a-zA-Z0-9_-:])。ID 長度不得少於 5 個字元，也不得超過 50 個字元。

如未指定 ID，系統會產生專屬 ID。

object (PageElementProperties)

線條的元素屬性。

enum (Category)

要建立的線條類別。

已淘汰 ：請改用 category。

系統會根據類別和路由方式，判斷要建立的確切 line type ，以便連結至其他頁面元素。

如果同時指定 category 和 lineCategory，系統會優先採用 category。

enum (LineCategory)

要建立的線條類別。

系統會根據類別和路由方式，判斷要建立的確切 line type ，以便連結至其他頁面元素。

如果同時指定 category 和 lineCategory，系統會優先採用 category。

如未指定 category 的值，但指定了 lineCategory 的值，則會使用指定的 lineCategory 值。

如未指定任一項，則會使用 STRAIGHT。

string

要重新整理的圖表物件 ID。

string

要套用更新的圖案物件 ID。

object (ShapeProperties)

要更新的形狀屬性。

string (FieldMask format)

要更新的欄位。

至少須指定一個欄位。根目錄 shapeProperties 為隱含值，不應指定。單一 "*" 可做為列出每個欄位的簡寫。

舉例來說，如要更新形狀背景的純色填滿顏色，請將 fields 設為 "shapeBackgroundFill.solidFill.color"。

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

string

要套用更新的圖片物件 ID。

object (ImageProperties)

要更新的圖片屬性。

string (FieldMask format)

要更新的欄位。

至少須指定一個欄位。根目錄 imageProperties 為隱含值，不應指定。單一 "*" 可做為列出每個欄位的簡寫。

舉例來說，如要更新圖片外框顏色，請將 fields 設為 "outline.outlineFill.solidFill.color"。

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

string

更新內容套用的影片物件 ID。

object (VideoProperties)

要更新的影片屬性。

string (FieldMask format)

要更新的欄位。

至少須指定一個欄位。根目錄 videoProperties 為隱含值，不應指定。單一 "*" 可做為列出每個欄位的簡寫。

舉例來說，如要更新影片外框顏色，請將 fields 設為 "outline.outlineFill.solidFill.color"。

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

string

更新套用的頁面物件 ID。

object (PageProperties)

要更新的頁面屬性。

string (FieldMask format)

要更新的欄位。

至少須指定一個欄位。根目錄 pageProperties 為隱含值，不應指定。單一 "*" 可做為列出每個欄位的簡寫。

舉例來說，如要更新頁面背景的純色填滿顏色，請將 fields 設為 "pageBackgroundFill.solidFill.color"。

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

string

資料表的物件 ID。

object (TableRange)

代表要套用更新的表格子集的表格範圍。如未指定表格範圍，更新會套用至整個表格。

object (TableCellProperties)

要更新的表格儲存格屬性。

string (FieldMask format)

要更新的欄位。

至少須指定一個欄位。根目錄 tableCellProperties 為隱含值，不應指定。單一 "*" 可做為列出每個欄位的簡寫。

舉例來說，如要更新表格儲存格背景的純色填滿顏色，請將 fields 設為 "tableCellBackgroundFill.solidFill.color"。

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

object (TableCellLocation)

表格範圍的起始位置。

integer

表格範圍的資料列跨度。

integer

表格範圍的欄跨度。

string

更新套用至的行物件 ID。

object (LineProperties)

要更新的行屬性。

string (FieldMask format)

要更新的欄位。

至少須指定一個欄位。根目錄 lineProperties 為隱含值，不應指定。單一 "*" 可做為列出每個欄位的簡寫。

舉例來說，如要更新線條的實心填滿顏色，請將 fields 設為 "lineFill.solidFill.color"。

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

string

包含要新增項目符號文字的圖案或表格物件 ID。

object (TableCellLocation)

如果待修改的文字位於表格儲存格中，則為選用的表格儲存格位置。如果有的話，objectId 必須參照資料表。

object (Range)

要套用項目符號預設樣式的文字範圍，以索引為準。TextElement

enum (BulletGlyphPreset)

要使用的項目符號字元種類。預設為 BULLET_DISC_CIRCLE_SQUARE 預設集。

enum (ReplaceMethod)

取代方法。

已淘汰 ：請改用 imageReplaceMethod。

如果同時指定 replaceMethod 和 imageReplaceMethod，系統會優先採用 imageReplaceMethod。

enum (ImageReplaceMethod)

圖片替換方法。

如果同時指定 replaceMethod 和 imageReplaceMethod，系統會優先採用 imageReplaceMethod。

如未指定 imageReplaceMethod 的值，但指定了 replaceMethod 的值，則會使用指定的 replaceMethod 值。

如未指定，則會使用 CENTER_INSIDE。

string

如果不是空白，則比對結果只會顯示指定網頁上的網頁元素。

如果提供 notes page 或 notes master 的頁面物件 ID，或是簡報中沒有該物件 ID 的頁面，系統會傳回 400 錯誤要求。

object (SubstringMatchCriteria)

如果設定此要求，系統會取代所有含有指定文字的圖案。

string

圖片網址。

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

提供的網址長度最多為 2 KB。網址本身會與圖片一併儲存，並透過 Image.source_url 欄位公開。

string

要複製的物件 ID。

map (key: string, value: string)

複製的物件可能包含其他物件，例如複製投影片或群組網頁元素時。這張對應表會定義重複物件的 ID 產生方式：鍵是原始物件的 ID，值則是將指派給對應重複物件的 ID。您也可以在這個對應中指定來源物件重複項的 ID，方法是使用與 objectId 欄位相同的值做為鍵，並使用新 ID 做為值。

所有鍵都必須對應簡報中的現有 ID。所有值在簡報中都不得重複，且開頭須為英數字元或底線 (符合 regex [a-zA-Z0-9_])；其餘字元可包含英數字元、底線、連字號或半形冒號 (符合 regex [a-zA-Z0-9_-:])。新 ID 的長度不得少於 5 個字元，也不得超過 50 個字元。

如果地圖中省略了來源物件的任何 ID，系統會指派新的隨機 ID。如果對應表為空白或未設定，所有重複物件都會收到新的隨機 ID。

string

要設定樣式的文字所屬形狀或表格的物件 ID。

object (TableCellLocation)

表格中含有要設定樣式文字的儲存格位置。如果 objectId 是指表格，則 cellLocation 必須有值。否則不得使用。

object (TextStyle)

要為文字設定的樣式。

如果特定樣式的值與父項相符，該樣式會設為繼承。

某些文字樣式變更可能會導致其他變更，以反映 Google 簡報編輯器的行為。詳情請參閱 TextStyle 的說明文件。

object (Range)

要設定樣式的文字範圍。

範圍可能會擴大，納入相鄰的新行。

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

string (FieldMask format)

要更新的欄位。

至少須指定一個欄位。根目錄 style 為隱含值，不應指定。單一 "*" 可做為列出每個欄位的簡寫。

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

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

object (SubstringMatchCriteria)

形狀必須符合的條件，才能進行替換。這項要求會取代所有含有指定文字的圖案。

string

含有圖表的 Google 試算表 ID。

integer

Google 試算表中的特定圖表 ID。

enum (LinkingMode)

圖表連結至來源試算表的模式。如未指定，圖表會是未連結的圖片。

string

如果不是空白，則比對結果只會顯示指定網頁上的網頁元素。

如果提供 notes page 或 notes master 的頁面物件 ID，或是簡報中沒有該物件 ID 的頁面，系統會傳回 400 錯誤要求。

string

含有要刪除項目符號文字的圖案或表格物件 ID。

object (TableCellLocation)

如果待修改的文字位於表格儲存格中，則為選用的表格儲存格位置。如果有的話，objectId 必須參照資料表。

object (Range)

要刪除項目符號的文字範圍 (以索引為準)。 TextElement

string

要設定樣式的文字所屬形狀或表格的物件 ID。

object (TableCellLocation)

表格中含有要設定樣式段落的儲存格位置。如果 objectId 是指表格，則 cellLocation 必須有值。否則不得為空值。

object (ParagraphStyle)

段落的樣式。

object (Range)

包含要設定樣式的段落的文字範圍。

string (FieldMask format)

要更新的欄位。

至少須指定一個欄位。根目錄 style 為隱含值，不應指定。單一 "*" 可做為列出每個欄位的簡寫。

舉例來說，如要更新段落對齊方式，請將 fields 設為 "alignment"。

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

string

資料表的物件 ID。

object (TableRange)

代表要套用更新的表格子集的表格範圍。如未指定表格範圍，更新會套用至整個表格。

enum (BorderPosition)

更新應套用的表格範圍中的邊框位置。如未指定邊框位置，更新就會套用至表格範圍內的所有邊框。

object (TableBorderProperties)

要更新的表格框線屬性。

string (FieldMask format)

要更新的欄位。

至少須指定一個欄位。根目錄 tableBorderProperties 為隱含值，不應指定。單一 "*" 可做為列出每個欄位的簡寫。

舉例來說，如要更新表格框線的實心填滿顏色，請將 fields 設為 "tableBorderFill.solidFill.color"。

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

string

資料表的物件 ID。

integer

以零為起始的索引清單，指定要更新的資料欄。如未提供任何索引，系統會更新資料表中的所有資料欄。

object (TableColumnProperties)

要更新的表格欄屬性。

如果要求中的 tableColumnProperties#columnWidth 值小於 406,400 EMU (32 點)，系統會傳回 400 Bad Request 錯誤。

string (FieldMask format)

要更新的欄位。

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

舉例來說，如要更新欄寬，請將 fields 設為 "columnWidth"。

如果欄位遮罩中包含「columnWidth」，但屬性未設定，欄寬預設為 406,400 EMU (32 點)。

string

資料表的物件 ID。

integer

以零為基準的索引清單，指定要更新的列。如未提供任何索引，系統會更新資料表中的所有資料列。

object (TableRowProperties)

要更新的資料列屬性。

string (FieldMask format)

要更新的欄位。

至少須指定一個欄位。根目錄 tableRowProperties 為隱含值，不應指定。單一 "*" 可做為列出每個欄位的簡寫。

舉例來說，如要更新列高下限，請將 fields 設為 "minRowHeight"。

如果欄位遮罩中包含「minRowHeight」，但屬性未設定，最低列高預設為 0。

string

資料表的物件 ID。

object (TableRange)

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

合併儲存格時，其中的文字會串連起來，並儲存在範圍的左上角 (「前端」) 儲存格。如果範圍不是矩形 (在範圍涵蓋已合併的儲存格時，有時會發生這種情況)，系統會傳回 400 錯誤要求錯誤。

string

資料表的物件 ID。

object (TableRange)

指定要取消合併表格中哪些儲存格的表格範圍。

這個範圍內的所有合併儲存格都會取消合併，而原本就未合併的儲存格則不受影響。如果範圍沒有合併的儲存格，要求就不會執行任何動作。如果合併的儲存格含有文字，文字會保留在取消合併後儲存格區塊的左上角 (「標題」) 儲存格。

string

要建立的群組的使用者提供物件 ID。

如果指定 ID，簡報中所有網頁和網頁元素都不得重複。ID 開頭必須是英數字元或底線 (符合 regex [a-zA-Z0-9_])，其餘字元可包含英數字元、底線、連字號或半形冒號 (符合 regex [a-zA-Z0-9_-:])。ID 長度不得少於 5 個字元，也不得超過 50 個字元。

如未指定 ID，系統會產生專屬 ID。

string

要分組的物件 ID。

只有頁面元素可以分組。同一頁面上至少要有兩個網頁元素，且這些元素尚未加入其他群組。部分頁面元素 (例如 videos、 tables 和 placeholders) 無法加入群組。

string

要取消分組的物件 ID。

只有不在其他 groups 內的 groups 可以取消分組。所有群組都應位於同一頁面。群組本身會遭到刪除。所有子項的視覺大小和位置都會保留。

string

更新套用的網頁元素物件 ID。

string

網頁元素的更新替代文字標題。如未設定，系統會保留現有值。螢幕閱讀器和其他無障礙介面會顯示標題。僅使用與網頁元素內容相關的人類可讀取值。

string

網頁元素的更新替代文字說明。如未設定，系統會保留現有值。螢幕閱讀器和其他無障礙介面會顯示這項說明。僅使用與網頁元素內容相關的人類可讀取值。

string

要取代的現有圖片 ID。可從 GET 要求的相關回應中擷取 ID。

enum (ImageReplaceMethod)

取代方法。

string

圖片網址。

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

提供的網址長度不得超過 2 KB。網址會與圖片一併儲存，並透過 Image.source_url 欄位公開。

string

要套用更新的投影片物件 ID。

object (SlideProperties)

要更新的投影片屬性。

string (FieldMask format)

要更新的欄位。

至少須指定一個欄位。根「slideProperties」是隱含的，不應指定。單一 "*" 可做為列出每個欄位的簡寫。

舉例來說，如要更新投影片是否略過，請將 fields 設為 "isSkipped"。

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

string

要更新的網頁元素物件 ID。

所有網頁元素都必須位於同一網頁，且不得分組。

enum (ZOrderOperation)

要套用至頁面元素的 Z 順序作業。

對多個網頁元素套用這項作業時，系統會保留這些網頁元素在作業前的相對 Z 順序。

string

更新套用至的行物件 ID。

只有標示為「連接器」的線條 (category) 可以更新。

更新類別後，路線可能會重新規劃。

enum (LineCategory)

要更新的行類別。

確切的line type取決於要更新的類別，以及如何將其連線至其他頁面元素。

string

要重新轉送的行物件 ID。

只有標示為「連接器」的線條 (category) 可以重新導向。線條的開始和結束連線必須位於不同的頁面元素上。

string

留言文字 (純文字)。

這類文字內容的處理方式，與在 Google 簡報編輯器中建立的註解類似。格式設定、通知等行為與舊版相同。

這個欄位不得空白，且不得超過 2048 個 UTF-8 程式碼單元。

string

(選用步驟) 留言指派對象的電子郵件地址。

如要建立未指派的留言，請留空。

不得超過 2048 個 UTF-8 程式碼單元。

string

與這則留言相關聯的 Page 或 PageElement 物件 ID。如果指定的 objectId 是 Group，留言最多會錨定至群組的 100 個非群組後代。

object (ShapeTextAnchor)

將註解錨定至 內的特定文字範圍。 Shape。

object (TableCellTextAnchor)

將註解錨定至單一儲存格內的特定文字範圍。 Table.

object (TableAnchor)

將註解錨定至 Table 中的特定儲存格範圍。如果範圍內的儲存格不含文字，則會傳回 400 錯誤要求錯誤。

string

包含文字的網頁元素物件 ID。

object (Range)

錨點的文字範圍。

string

包含儲存格的表格物件 ID。

object (TableCellLocation)

儲存格在表格中的位置。

object (Range)

錨點的文字範圍。

string

資料表的物件 ID。

object (TableRange)

要套用錨點的表格儲存格範圍。如果省略，系統會將表格中的所有儲存格做為錨點。

string

要新增回覆的 CommentThread ID。

object (Post)

代表回覆的 Post。

string

貼文所屬的 CommentThread ID。

string

要更新的貼文 ID。

string

留言的新文字，以純文字格式呈現。

這類文字內容的處理方式，與在 Google 簡報編輯器中建立的註解類似。格式設定、通知等行為與舊版相同。

這個欄位不得空白，且不得超過 2048 個 UTF-8 程式碼單元。

string

要刪除的 CommentThread ID。

string

貼文所屬的 CommentThread ID。

string

要刪除的回覆 ID Post 。