Requests

bookmark_border 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

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)

更新投影片的屬性

object (UpdatePageElementsZOrderRequest)

更新 page elements 的 Z 順序。

object (UpdateLineCategoryRequest)

更新 line 的類別。

object (RerouteLineRequest)

重新導向 line，讓它連結至已連結網頁元素上最近的兩個連線位置。

string

使用者提供的物件 ID。

如果您指定 ID，則該 ID 在簡報中的所有頁面和頁面元素中都不得重複。ID 開頭必須是英數字元或底線 (符合 [a-zA-Z0-9_] 規則運算式)；其餘字元可以包含這些字元，以及連字號或半形冒號 (符合 [a-zA-Z0-9_-:] 規則運算式)。ID 長度必須介於 5 至 50 個半形字元之間 (含兩端)。

如果您未指定 ID，系統會產生不重複的 ID。

integer

可選的零起始索引，用於指出要插入幻燈片的位置。

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

object (LayoutReference)

要插入的投影片版面配置參照，以目前的母片為依據，如下列其中一種：

• 上一個投影片索引的主檔案。
• 如果插入索引為零，則為第一張投影片的主檔。
• 簡報中的第一個投影片 (如果沒有投影片)。

如果在目前的母片中找不到 LayoutReference，系統會傳回 400 無效要求錯誤。

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

object (LayoutPlaceholderIdMapping)

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

enum (PredefinedLayout)

預先定義的版面配置。

string

版面配置 ID：呈現內容中某個版面配置的物件 ID。

string

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

如果您指定 ID，則該 ID 在簡報中的所有頁面和頁面元素中都不得重複。ID 開頭必須是英數字元或底線 (符合 [a-zA-Z0-9_] 的規則運算式)；其餘字元可包含上述字元，以及連字號或冒號 (符合 [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 在簡報中的所有頁面和頁面元素中都不得重複。ID 開頭必須是英數字元或底線 (符合 [a-zA-Z0-9_] 的規則運算式)；其餘字元可包含上述字元，以及連字號或冒號 (符合 [a-zA-Z0-9_-:] 的規則運算式)。ID 長度不得少於 5 個字元，也不能超過 50 個字元。如果留空，系統會產生專屬 ID。

object (PageElementProperties)

形狀的元素屬性。

enum (Type)

形狀類型。

string

元素所在頁面的物件 ID。

object (Size)

元素的大小。

object (AffineTransform)

元素的轉換。

string

使用者提供的物件 ID。

如果您指定 ID，則該 ID 在簡報中的所有頁面和頁面元素中都不得重複。ID 開頭必須是英數字元或底線 (符合 [a-zA-Z0-9_] 的規則運算式)；其餘字元可包含上述字元，以及連字號或冒號 (符合 [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

系統會根據 TextElement 索引，以萬國碼碼元為單位，插入文字的索引。

索引以零為基數，並從字串開頭開始計算。您可以調整索引，防止在萬國碼字素叢集內插入字元。在這種情況下，系統會立即在構詞單元叢集後插入文字。

string

要插入資料列的資料表。

object (TableCellLocation)

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

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

boolean

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

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

integer

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

string

要插入資料欄的資料表。

object (TableCellLocation)

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

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

boolean

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

• True ：插入至右側。
• False ：插入至左側。

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 在簡報中的所有頁面和頁面元素中都不得重複。ID 開頭必須是英數字元或底線 (符合 [a-zA-Z0-9_] 的規則運算式)；其餘字元可包含上述字元，以及連字號或冒號 (符合 [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 在簡報中的所有頁面和頁面元素中都不得重複。ID 開頭必須是英數字元或底線 (符合 [a-zA-Z0-9_] 的規則運算式)；其餘字元可包含上述字元，以及連字號或冒號 (符合 [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 在簡報中的所有頁面和頁面元素中都不得重複。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 在簡報中的所有頁面和頁面元素中都不得重複。ID 開頭必須是英數字元或底線 (符合 [a-zA-Z0-9_] 的規則運算式)；其餘字元可包含上述字元，以及連字號或冒號 (符合 [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，且不得超過 2,500 萬像素，格式必須為 PNG、JPEG 或 GIF。

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

string

要複製的物件 ID。

map (key: string, value: string)

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

所有鍵都必須對應至簡報中的現有 ID。所有值在呈現時都必須是唯一值，且開頭須為英數字元或底線 (符合 [a-zA-Z0-9_] 的規則運算式)；其餘字元則可包含上述字元，以及連字號或冒號 (符合 [a-zA-Z0-9_-:] 的規則運算式)。新 ID 的長度不得少於 5 或超過 50。

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

string

包含要設定樣式的文字的圖形或表格物件 ID。

object (TableCellLocation)

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

object (TextStyle)

要套用至文字的樣式。

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

某些文字樣式變更可能會導致其他變更，以反映簡報編輯器的行為。詳情請參閱 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 無效要求錯誤。

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 在簡報中的所有頁面和頁面元素中都不得重複。ID 開頭必須是英數字元或底線 (符合 [a-zA-Z0-9_] 的規則運算式)；其餘字元可包含上述字元，以及連字號或冒號 (符合 [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，且不得超過 2,000 萬像素，格式必須為 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) 才能重新導向。線條的起點和終點連線必須位於不同的網頁元素。