Requests

要求

要套用至簡報的單一更新類型。

JSON 表示法 
{

  // Union field kind can be only one of the following:
  "createSlide": {
    object (CreateSlideRequest)
  },
  "createShape": {
    object (CreateShapeRequest)
  },
  "createTable": {
    object (CreateTableRequest)
  },
  "insertText": {
    object (InsertTextRequest)
  },
  "insertTableRows": {
    object (InsertTableRowsRequest)
  },
  "insertTableColumns": {
    object (InsertTableColumnsRequest)
  },
  "deleteTableRow": {
    object (DeleteTableRowRequest)
  },
  "deleteTableColumn": {
    object (DeleteTableColumnRequest)
  },
  "replaceAllText": {
    object (ReplaceAllTextRequest)
  },
  "deleteObject": {
    object (DeleteObjectRequest)
  },
  "updatePageElementTransform": {
    object (UpdatePageElementTransformRequest)
  },
  "updateSlidesPosition": {
    object (UpdateSlidesPositionRequest)
  },
  "deleteText": {
    object (DeleteTextRequest)
  },
  "createImage": {
    object (CreateImageRequest)
  },
  "createVideo": {
    object (CreateVideoRequest)
  },
  "createSheetsChart": {
    object (CreateSheetsChartRequest)
  },
  "createLine": {
    object (CreateLineRequest)
  },
  "refreshSheetsChart": {
    object (RefreshSheetsChartRequest)
  },
  "updateShapeProperties": {
    object (UpdateShapePropertiesRequest)
  },
  "updateImageProperties": {
    object (UpdateImagePropertiesRequest)
  },
  "updateVideoProperties": {
    object (UpdateVideoPropertiesRequest)
  },
  "updatePageProperties": {
    object (UpdatePagePropertiesRequest)
  },
  "updateTableCellProperties": {
    object (UpdateTableCellPropertiesRequest)
  },
  "updateLineProperties": {
    object (UpdateLinePropertiesRequest)
  },
  "createParagraphBullets": {
    object (CreateParagraphBulletsRequest)
  },
  "replaceAllShapesWithImage": {
    object (ReplaceAllShapesWithImageRequest)
  },
  "duplicateObject": {
    object (DuplicateObjectRequest)
  },
  "updateTextStyle": {
    object (UpdateTextStyleRequest)
  },
  "replaceAllShapesWithSheetsChart": {
    object (ReplaceAllShapesWithSheetsChartRequest)
  },
  "deleteParagraphBullets": {
    object (DeleteParagraphBulletsRequest)
  },
  "updateParagraphStyle": {
    object (UpdateParagraphStyleRequest)
  },
  "updateTableBorderProperties": {
    object (UpdateTableBorderPropertiesRequest)
  },
  "updateTableColumnProperties": {
    object (UpdateTableColumnPropertiesRequest)
  },
  "updateTableRowProperties": {
    object (UpdateTableRowPropertiesRequest)
  },
  "mergeTableCells": {
    object (MergeTableCellsRequest)
  },
  "unmergeTableCells": {
    object (UnmergeTableCellsRequest)
  },
  "groupObjects": {
    object (GroupObjectsRequest)
  },
  "ungroupObjects": {
    object (UngroupObjectsRequest)
  },
  "updatePageElementAltText": {
    object (UpdatePageElementAltTextRequest)
  },
  "replaceImage": {
    object (ReplaceImageRequest)
  },
  "updateSlideProperties": {
    object (UpdateSlidePropertiesRequest)
  },
  "updatePageElementsZOrder": {
    object (UpdatePageElementsZOrderRequest)
  },
  "updateLineCategory": {
    object (UpdateLineCategoryRequest)
  },
  "rerouteLine": {
    object (RerouteLineRequest)
  }
  // End of list of possible types for union field kind.
}
欄位
聯集欄位 kind。更新類型。只需要填寫一個欄位。 kind 只能為下列其中一項：
createSlide

object (CreateSlideRequest)

建立新投影片。

createShape

object (CreateShapeRequest)

建立新形狀。

createTable

object (CreateTableRequest)

建立新資料表。

insertText

object (InsertTextRequest)

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

insertTableRows

object (InsertTableRowsRequest)

在表格中插入列。

insertTableColumns

object (InsertTableColumnsRequest)

在表格中插入資料欄。

deleteTableRow

object (DeleteTableRowRequest)

從資料表中刪除資料列。

deleteTableColumn

object (DeleteTableColumnRequest)

從表格中刪除資料欄。

replaceAllText

object (ReplaceAllTextRequest)

取代所有指定文字的執行個體。

deleteObject

object (DeleteObjectRequest)

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

updatePageElementTransform

object (UpdatePageElementTransformRequest)

更新頁面元素的轉換。

updateSlidesPosition

object (UpdateSlidesPositionRequest)

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

deleteText

object (DeleteTextRequest)

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

createImage

object (CreateImageRequest)

建立圖片。

createVideo

object (CreateVideoRequest)

建立影片。

createSheetsChart

object (CreateSheetsChartRequest)

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

createLine

object (CreateLineRequest)

建立線條。

refreshSheetsChart

object (RefreshSheetsChartRequest)

重新整理 Google 試算表圖表。

updateShapeProperties

object (UpdateShapePropertiesRequest)

更新 Shape。

updateImageProperties

object (UpdateImagePropertiesRequest)

更新 Image。

updateVideoProperties

object (UpdateVideoPropertiesRequest)

更新 Video。

updatePageProperties

object (UpdatePagePropertiesRequest)

更新 Page。

updateTableCellProperties

object (UpdateTableCellPropertiesRequest)

更新 TableCell。

updateLineProperties

object (UpdateLinePropertiesRequest)

更新 Line。

createParagraphBullets

object (CreateParagraphBulletsRequest)

為段落建立項目符號。

replaceAllShapesWithImage

object (ReplaceAllShapesWithImageRequest)

以圖片取代所有符合某些條件的形狀。

duplicateObject

object (DuplicateObjectRequest)

複製投影片或頁面元素。

updateTextStyle

object (UpdateTextStyleRequest)

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

replaceAllShapesWithSheetsChart

object (ReplaceAllShapesWithSheetsChartRequest)

以 Google 試算表圖表取代所有符合部分條件的形狀。

deleteParagraphBullets

object (DeleteParagraphBulletsRequest)

從段落中刪除項目符號。

updateParagraphStyle

object (UpdateParagraphStyleRequest)

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

updateTableBorderProperties

object (UpdateTableBorderPropertiesRequest)

更新 Table。

updateTableColumnProperties

object (UpdateTableColumnPropertiesRequest)

更新 Table 。

updateTableRowProperties

object (UpdateTableRowPropertiesRequest)

更新 Table 列。

mergeTableCells

object (MergeTableCellsRequest)

合併 Table。

unmergeTableCells

object (UnmergeTableCellsRequest)

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

groupObjects

object (GroupObjectsRequest)

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

ungroupObjects

object (UngroupObjectsRequest)

取消分組物件，例如 groups。

updatePageElementAltText

object (UpdatePageElementAltTextRequest)

更新 page element。

replaceImage

object (ReplaceImageRequest)

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

updateSlideProperties

object (UpdateSlidePropertiesRequest)

更新投影片屬性

updatePageElementsZOrder

object (UpdatePageElementsZOrderRequest)

更新 page elements。

updateLineCategory

object (UpdateLineCategoryRequest)

更新特定應用程式的類別 line。

rerouteLine

object (RerouteLineRequest)

重新轉送 line 讓網域在相連網頁元素中位於兩個最接近的連線網站。

CreateSlideRequest

建立投影片。

JSON 表示法 
{
  "objectId": string,
  "insertionIndex": integer,
  "slideLayoutReference": {
    object (LayoutReference)
  },
  "placeholderIdMappings": [
    {
      object (LayoutPlaceholderIdMapping)
    }
  ]
}
欄位
objectId

string

使用者提供的物件 ID。

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

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

insertionIndex

integer

選用的索引 (從 0 開始)，指出投影片插入位置。

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

slideLayoutReference

object (LayoutReference)

待插入投影片的版面配置參考，根據 「目前的主要執行個體」，即為下列其中之一：

  • 上一張投影片索引的主投影片。
  • 如果 insertIndex 為零，則為第一張投影片主投影片。
  • 簡報中的第一個主投影片 (如果沒有任何投影片)。

如果在目前的主要執行個體中找不到 LayoutReference，則會傳回 400 錯誤的要求錯誤。

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

placeholderIdMappings[]

object (LayoutPlaceholderIdMapping)

物件 ID 對應的選用清單： placeholder (s) 由指定版面配置在投影片上建立的預留位置。只能在下列情況使用 slideLayoutReference 。

LayoutReference

投影片版面配置參考資料。這可能會參照以下任一項目：

  • 預先定義的版面配置
  • 簡報中的一種版面配置。
JSON 表示法 
{

  // Union field kind can be only one of the following:
  "predefinedLayout": enum (PredefinedLayout),
  "layoutId": string
  // End of list of possible types for union field kind.
}
欄位
聯集欄位 kind。LayoutReference 的種類。 kind 只能為下列其中一項：
predefinedLayout

enum (PredefinedLayout)

預先定義的版面配置。

layoutId

string

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

PredefinedLayout

預先定義的版面配置類型。以下為簡報中的常見版面配置。不過，由於這些版面配置可能已刪除，或不屬於已使用的主題，因此無法保證會在目前的主要執行個體中顯示。此外，每個版面配置的預留位置可能已變更。

列舉
PREDEFINED_LAYOUT_UNSPECIFIED 未指定的版面配置。
BLANK 空白版面配置，不含預留位置。
CAPTION_ONLY 版面配置，底部有說明文字。
TITLE 含有標題和副標題的版面配置。
TITLE_AND_BODY 含有標題和內文的版面配置。
TITLE_AND_TWO_COLUMNS 含有標題和兩欄的版面配置。
TITLE_ONLY 只顯示標題的版面配置。
SECTION_HEADER 含有區段標題的版面配置。
SECTION_TITLE_AND_DESCRIPTION 版面配置的其中一側顯示標題和副標題，另一側顯示說明。
ONE_COLUMN_TEXT 版面配置含有一個標題和一個內文，並排在同一欄中。
MAIN_POINT 使用主要點的版面配置。
BIG_NUMBER 版面配置內含大量標題。

LayoutPlaceholderIdMapping

使用者為預留位置指定的 ID 對應，系統將根據指定版面配置在投影片上建立該預留位置。

JSON 表示法 
{
  "objectId": string,

  // Union field kind can be only one of the following:
  "layoutPlaceholder": {
    object (Placeholder)
  },
  "layoutPlaceholderObjectId": string
  // End of list of possible types for union field kind.
}
欄位
objectId

string

使用者提供的物件 ID。這個預留位置要建立在投影片上。

您指定的 ID 不得與簡報中所有頁面和頁面元素重複，ID 的開頭必須是英數字元或底線 (與規則運算式相符) [a-zA-Z0-9_]);其餘字元可能包含這些字元，以及連字號或冒號 (與規則運算式相符) [a-zA-Z0-9_-:])。ID 長度不得小於 5 或大於 50。

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

聯集欄位 kind。用於識別版面配置上預留位置的種類。 kind 只能為下列其中一項：
layoutPlaceholder

object (Placeholder)

版面配置上的預留位置，將套用至投影片。僅限 type 和 index 。例如預先定義的 TITLE_AND_BODY 版面配置中通常可能會有索引 0 的 TITLE 預留位置，以及索引 0 的 BODY 預留位置。

layoutPlaceholderObjectId

string

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

CreateShapeRequest

建立新形狀。

JSON 表示法 
{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "shapeType": enum (Type)
}
欄位
objectId

string

使用者提供的物件 ID。

您指定的 ID 不得與簡報中所有頁面和頁面元素重複，ID 的開頭必須是英數字元或底線 (與規則運算式相符) [a-zA-Z0-9_]);其餘字元可能包含這些字元，以及連字號或冒號 (與規則運算式相符) [a-zA-Z0-9_-:])。ID 長度不得小於 5 或大於 50。如果留空，系統會產生專屬 ID。

elementProperties

object (PageElementProperties)

形狀的元素屬性。

shapeType

enum (Type)

形狀類型。

PageElementProperties

網頁元素的常見屬性。

注意：在建立範本時 PageElement，API 可能會修改 size 和 transform，但視覺大小會維持不變。

JSON 表示法 
{
  "pageObjectId": string,
  "size": {
    object (Size)
  },
  "transform": {
    object (AffineTransform)
  }
}
欄位
pageObjectId

string

元素所在網頁的物件 ID。

size

object (Size)

元素大小。

transform

object (AffineTransform)

元素的轉換。

CreateTableRequest

建立新資料表。

JSON 表示法 
{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "rows": integer,
  "columns": integer
}
欄位
objectId

string

使用者提供的物件 ID。

您指定的 ID 不得與簡報中所有頁面和頁面元素重複，ID 的開頭必須是英數字元或底線 (與規則運算式相符) [a-zA-Z0-9_]);其餘字元可能包含這些字元，以及連字號或冒號 (與規則運算式相符) [a-zA-Z0-9_-:])。ID 長度不得小於 5 或大於 50。

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

elementProperties

object (PageElementProperties)

表格的元素屬性。

資料表會根據提供的大小建立，但會有最小大小。如未提供大小，表格會自動調整大小。

資料表轉換的比例必須是 1，且不能有剪刀元件。如未提供轉換，表格會置中顯示在頁面上。

rows

integer

資料表中的資料列數。

columns

integer

資料表中的資料欄數。

InsertTextRequest

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

JSON 表示法 
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "text": string,
  "insertionIndex": integer
}
欄位
objectId

string

要插入文字的形狀或表格的物件 ID。

cellLocation

object (TableCellLocation)

將文字插入表格儲存格時，選填的表格儲存格位置。如果存在，objectId 必須參照資料表。

text

string

要插入的文字。

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

系統會自動決定插入文字的文字樣式，一般會沿用鄰近文字的樣式。在大部分的情況下，系統會將文字新增到 TextRun 也存在於插入索引的媒體

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

insertionIndex

integer

要插入文字的索引 (以 Unicode 程式碼單位，取決於 TextElement 索引。

索引從 0 開始計算，從字串的開頭開始計算。可能會調整索引，防止在 Unicode 圖譜叢集內插入。在這類情況下，文字會緊接在石墨點之後插入。

InsertTableRowsRequest

在表格中插入列。

JSON 表示法 
{
  "tableObjectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "insertBelow": boolean,
  "number": integer
}
欄位
tableObjectId

string

要插入資料列的資料表。

cellLocation

object (TableCellLocation)

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

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

insertBelow

boolean

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

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

integer

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

InsertTableColumnsRequest

在表格中插入資料欄。

系統也會根據新的資料欄調整表格中的其他資料欄的大小。

JSON 表示法 
{
  "tableObjectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "insertRight": boolean,
  "number": integer
}
欄位
tableObjectId

string

要插入資料欄的目標資料表。

cellLocation

object (TableCellLocation)

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

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

insertRight

boolean

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

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

integer

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

DeleteTableRowRequest

從資料表中刪除資料列。

JSON 表示法 
{
  "tableObjectId": string,
  "cellLocation": {
    object (TableCellLocation)
  }
}
欄位
tableObjectId

string

要從哪個資料表刪除資料列。

cellLocation

object (TableCellLocation)

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

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

DeleteTableColumnRequest

從表格中刪除資料欄。

JSON 表示法 
{
  "tableObjectId": string,
  "cellLocation": {
    object (TableCellLocation)
  }
}
欄位
tableObjectId

string

要刪除的資料欄。

cellLocation

object (TableCellLocation)

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

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

ReplaceAllTextRequest

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

JSON 表示法 
{
  "replaceText": string,
  "pageObjectIds": [
    string
  ],

  // 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

要取代相符文字的文字。

pageObjectIds[]

string

如果非空白，則系統只會將比對範圍限制在特定網頁元素。

如果指定的網頁物件 ID 為 notes master，或是簡報中沒有該物件 ID 的頁面。

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

object (SubstringMatchCriteria)

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

SubstringMatchCriteria

與形狀或表格中特定文字字串相符的條件。

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

string

要在形狀或表格中搜尋的文字。

matchCase

boolean

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

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

DeleteObjectRequest

刪除物件，或 pages 或 page elements，透過簡報。

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

string

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

如果在刪除作業完成後 group 只包含 1 或無頁面元素，也會刪除群組。

如果刪除版面配置的預留位置，系統會一併刪除所有繼承的預留位置。

UpdatePageElementTransformRequest

更新頁面元素的轉換。

更新群組的轉換將會變更該群組中網頁元素的絕對轉換，進而變更其外觀外觀。詳情請參閱 PageElement.transform ，掌握更多詳細資訊。

JSON 表示法 
{
  "objectId": string,
  "transform": {
    object (AffineTransform)
  },
  "applyMode": enum (ApplyMode)
}
欄位
objectId

string

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

transform

object (AffineTransform)

用來更新頁面元素的輸入轉換矩陣。

applyMode

enum (ApplyMode)

轉換更新的套用模式。

ApplyMode

轉換更新的套用模式。

列舉
APPLY_MODE_UNSPECIFIED 未指定模式。
RELATIVE 將新的 AffineTransform 矩陣套用至現有矩陣，並將現有矩陣替換為產生的串連。
ABSOLUTE 以新的 AffineTransform 矩陣取代現有的 AffineTransform 矩陣

UpdateSlidesPositionRequest

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

JSON 表示法 
{
  "slideObjectIds": [
    string
  ],
  "insertionIndex": integer
}
欄位
slideObjectIds[]

string

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

insertionIndex

integer

應插入投影片的索引 (根據移動前的投影片排列方式而定)。必須介於 0 至簡報中的投影片數量 (含首尾)。

DeleteTextRequest

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

JSON 表示法 
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "textRange": {
    object (Range)
  }
}
欄位
objectId

string

要刪除文字的形狀或表格物件 ID。

cellLocation

object (TableCellLocation)

如要從表格儲存格中刪除文字，這項選填的表格儲存格位置。如果存在，objectId 必須參照資料表。

textRange

object (Range)

要刪除的文字範圍 (根據 TextElement 索引。

形狀或表格儲存格的文字結尾一律會有隱含的換行字元，使用者無法刪除。 Range.Type.ALL 會使用正確的上下限，但指定範圍類型的明確邊界時必須謹慎 FROM_START_INDEX 和 FIXED_RANGE。舉例來說，如果文字是「ABC」，後面接著隱式換行，則 textRange.start_index 3 代表 textRange.end_index。

如果刪除超過段落邊界的文字，段落樣式和清單可能會隨著兩個段落合併而變更。

代理值配對中只有一個代碼單位的範圍會擴大至包含兩個代碼單位。

範圍

指定已建立索引集合的連續範圍，例如文字中的字元。

JSON 表示法 
{
  "startIndex": integer,
  "endIndex": integer,
  "type": enum (Type)
}
欄位
startIndex

integer

集合開頭的選用零從零開始索引。以下執行個體的必要條件： FIXED_RANGE 和 FROM_START_INDEX 範圍。

endIndex

integer

集合結尾的選用索引 (選用)。以下執行個體的必要條件： FIXED_RANGE 範圍。

type

enum (Type)

範圍類型。

類型

範圍類型。

列舉
RANGE_TYPE_UNSPECIFIED 未指定的範圍類型。不能使用這個值。
FIXED_RANGE 固定範圍。兩者 startIndex 和 endIndex 。
FROM_START_INDEX 範圍開始為 startIndex 直到收集結束為止 endIndex 不得指定。
ALL 將範圍設為集合的完整長度。兩者 startIndex 和 endIndex 不得指定。

CreateImageRequest

建立圖片。

JSON 表示法 
{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },

  // Union field image_source can be only one of the following:
  "url": string
  // End of list of possible types for union field image_source.
}
欄位
objectId

string

使用者提供的物件 ID。

您指定的 ID 不得與簡報中所有頁面和頁面元素重複，ID 的開頭必須是英數字元或底線 (與規則運算式相符) [a-zA-Z0-9_]);其餘字元可能包含這些字元，以及連字號或冒號 (與規則運算式相符) [a-zA-Z0-9_-:])。ID 長度不得小於 5 或大於 50。

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

elementProperties

object (PageElementProperties)

圖片的元素屬性。

如果提供的尺寸與圖片的長寬比不符，圖片會根據大小調整並置中，以維持長寬比。系統會在此作業完成後套用提供的轉換。

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

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

聯集欄位 image_source。圖片來源的類型。 image_source 只能為下列其中一項：
url

string

圖片網址。

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

提供的網址必須可公開存取，長度上限為 2 KB。網址會隨圖片儲存，並透過 Image.source_url ] 欄位。

CreateVideoRequest

建立影片。

注意：提出要求的應用程式至少要有一個 drive.readonly 或 drive.file OAuth 範圍，才能透過 Google 雲端硬碟建立影片。

JSON 表示法 
{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "source": enum (Source),
  "id": string
}
欄位
objectId

string

使用者提供的物件 ID。

您指定的 ID 不得與簡報中所有頁面和頁面元素重複，ID 的開頭必須是英數字元或底線 (與規則運算式相符) [a-zA-Z0-9_]);其餘字元可能包含這些字元，以及連字號或冒號 (與規則運算式相符) [a-zA-Z0-9_-:])。ID 長度不得小於 5 或大於 50。

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

elementProperties

object (PageElementProperties)

影片的元素屬性。

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

PageElementProperties.transform 屬性為選用項目。轉換不得含有堆積元件。如未指定轉換效果，影片會置於頁面左上角。

source

enum (Source)

影片來源。

id

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 標頭中新增資源金鑰。若需更多資訊，請參閲 使用資源金鑰存取連結共用的檔案。

CreateSheetsChartRequest

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

注意：至少需要有一個 Sheets.readonly、試算表、drive.readonly、drive.file 或雲端硬碟 OAuth 範圍，才能建立圖表。

JSON 表示法 
{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "spreadsheetId": string,
  "chartId": integer,
  "linkingMode": enum (LinkingMode)
}
欄位
objectId

string

使用者提供的物件 ID。

如有指定，則簡報中所有頁面和頁面元素的 ID 不得重複。ID 必須以文字字元 [a-zA-Z0-9_] 開頭，後面接著下列任意數量的字元 [a-zA-Z0-9_-:]。ID 長度不得超過 5 或 50。如果留空，系統會產生專屬 ID。

elementProperties

object (PageElementProperties)

圖表的元素屬性。

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

spreadsheetId

string

含有圖表的 Google 試算表 ID。

您可能需要在 HTTP 標頭中新增部分舊檔案的資源金鑰。若需更多資訊，請參閲 使用資源金鑰存取連結共用的檔案。

chartId

integer

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

linkingMode

enum (LinkingMode)

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

LinkingMode

圖表連結至來源試算表的模式。

列舉
NOT_LINKED_IMAGE 圖表與來源試算表沒有關聯，因此無法更新。未連結的圖表將插入為圖片格式。
LINKED 連結圖表即可更新圖表，其他協作者則會看到試算表的連結。

CreateLineRequest

建立線條。

JSON 表示法 
{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "lineCategory": enum (Category),
  "category": enum (LineCategory)
}
欄位
objectId

string

使用者提供的物件 ID。

您指定的 ID 不得與簡報中所有頁面和頁面元素重複，ID 的開頭必須是英數字元或底線 (與規則運算式相符) [a-zA-Z0-9_]);其餘字元可能包含這些字元，以及連字號或冒號 (與規則運算式相符) [a-zA-Z0-9_-:])。ID 長度不得小於 5 或大於 50。

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

elementProperties

object (PageElementProperties)

線條的元素屬性。

lineCategory
(deprecated)

enum (Category)

要建立的線條類別。

已淘汰 ：使用 category 。

與 line type 是依照類別及其間的轉送方式來決定。

如果您同時指定 category 和 lineCategory， category 優先順序較高。

category

enum (LineCategory)

要建立的線條類別。

與 line type 是依照類別及其間的轉送方式來決定。

如果您同時指定 category 和 lineCategory， category 優先順序較高。

如果沒有為 category，但指定以下項目的值： lineCategory，然後是指定的 lineCategory 值。

如果未指定 STRAIGHT

類別

線條類別。

列舉
STRAIGHT 直線連接頭，包括直立連接頭 1。如未指定，則會使用預設類別。
BENT 彎曲連接器，包括彎曲連接器 2 至 5。
CURVED 弧形連接器，包括弧形連接 2 到 5。

RefreshSheetsChartRequest

將嵌入的 Google 試算表圖表替換為最新的 Google 試算表圖表版本，藉此重新整理圖表。

注意：重新整理圖表至少需要其中一個 Sheets.readonly、試算表、drive.readonly 或雲端硬碟 OAuth 範圍。

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

string

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

UpdateShapePropertiesRequest

更新 Deployment 的屬性 Shape。

JSON 表示法 
{
  "objectId": string,
  "shapeProperties": {
    object (ShapeProperties)
  },
  "fields": string
}
欄位
objectId

string

要套用更新的形狀物件 ID。

shapeProperties

object (ShapeProperties)

要更新的形狀屬性。

fields

string (FieldMask format)

要更新的欄位。

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

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

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

UpdateImagePropertiesRequest

更新 Deployment 的屬性 Image。

JSON 表示法 
{
  "objectId": string,
  "imageProperties": {
    object (ImageProperties)
  },
  "fields": string
}
欄位
objectId

string

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

imageProperties

object (ImageProperties)

要更新的圖片屬性。

fields

string (FieldMask format)

要更新的欄位。

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

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

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

UpdateVideoPropertiesRequest

更新 Deployment 的屬性 Video。

JSON 表示法 
{
  "objectId": string,
  "videoProperties": {
    object (VideoProperties)
  },
  "fields": string
}
欄位
objectId

string

套用更新的影片物件 ID。

videoProperties

object (VideoProperties)

要更新的影片屬性。

fields

string (FieldMask format)

要更新的欄位。

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

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

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

UpdatePagePropertiesRequest

更新 Page。

JSON 表示法 
{
  "objectId": string,
  "pageProperties": {
    object (PageProperties)
  },
  "fields": string
}
欄位
objectId

string

要套用更新的網頁物件 ID。

pageProperties

object (PageProperties)

要更新的頁面屬性。

fields

string (FieldMask format)

要更新的欄位。

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

舉例來說，如要更新網頁背景的單色填滿顏色，請將 fields 到 "pageBackgroundFill.solidFill.color"。

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

UpdateTableCellPropertiesRequest

更新 Deployment 的屬性 TableCell。

JSON 表示法 
{
  "objectId": string,
  "tableRange": {
    object (TableRange)
  },
  "tableCellProperties": {
    object (TableCellProperties)
  },
  "fields": string
}
欄位
objectId

string

資料表的物件 ID。

tableRange

object (TableRange)

這個表格範圍代表要套用更新的資料表中子集。如果未指定表格範圍，系統會將更新套用到整個資料表。

tableCellProperties

object (TableCellProperties)

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

fields

string (FieldMask format)

要更新的欄位。

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

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

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

TableRange

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

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

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

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

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

object (TableCellLocation)

表格範圍的起始位置。

rowSpan

integer

表格範圍的資料列時距，

columnSpan

integer

表格範圍的資料欄時距。

UpdateLinePropertiesRequest

更新 Line。

JSON 表示法 
{
  "objectId": string,
  "lineProperties": {
    object (LineProperties)
  },
  "fields": string
}
欄位
objectId

string

要套用更新的項目行的物件 ID。

lineProperties

object (LineProperties)

要更新的線條屬性。

fields

string (FieldMask format)

要更新的欄位。

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

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

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

CreateParagraphBulletsRequest

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

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

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

JSON 表示法 
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "textRange": {
    object (Range)
  },
  "bulletPreset": enum (BulletGlyphPreset)
}
欄位
objectId

string

圖形或表格的物件 ID，內含要加入項目符號的文字。

cellLocation

object (TableCellLocation)

如果要修改的文字位於表格儲存格中，選填的表格儲存格位置。如果存在，objectId 必須參照資料表。

textRange

object (Range)

要套用項目符號預設的文字範圍 (根據 TextElement 索引。

bulletPreset

enum (BulletGlyphPreset)

要使用的項目符號符號。預設為 BULLET_DISC_CIRCLE_SQUARE 預設設定。

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」。
  • DIGIT ：數字，例如「1」、「2」或「3」。
  • ZERODIGIT ：以零為開頭的數字，例如「01」、「02」或「03」。包含多位數的數值不會加上 0 前置字元。
  • ROMAN ：小寫羅馬數字，例如「i」、「ii」或「iii」。
  • UPPERROMAN ：大寫羅馬數字，例如「I」、「II」或「III」。
  • LEFTTRIANGLE ：指向左方的三角形，對應 Unicode U+25c4 碼點
列舉
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_DIGIT_ALPHA_ROMAN 含有 DIGIT, ALPHA 和 ROMAN 前 3 個清單巢狀層級的數字字符，後面接著句號。
NUMBERED_DIGIT_ALPHA_ROMAN_PARENS 含有 DIGIT, ALPHA 和 ROMAN 前 3 個清單巢狀層級的數值字符，後接括號。
NUMBERED_DIGIT_NESTED 含有 DIGIT 以半形句號分隔的數字字符；每個巢狀層級都會使用先前巢狀層級的字符做為前置字元。例如「1.」、「1.1.」，「2.」，「2.2.」。
NUMBERED_UPPERALPHA_ALPHA_ROMAN 含有 UPPERALPHA, ALPHA 和 ROMAN 前 3 個清單巢狀層級的數字字符，後面接著句號。
NUMBERED_UPPERROMAN_UPPERALPHA_DIGIT 含有 UPPERROMAN, UPPERALPHA 和 DIGIT 前 3 個清單巢狀層級的數字字符，後面接著句號。
NUMBERED_ZERODIGIT_ALPHA_ROMAN 含有 ZERODIGIT, ALPHA 和 ROMAN 前 3 個清單巢狀層級的數字字符，後面接著句號。

ReplaceAllShapesWithImageRequest

以提供的圖片取代所有符合指定條件的形狀。

插入簡報後，用來取代形狀的圖片不會呈現形狀形式。

JSON 表示法 
{
  "replaceMethod": enum (ReplaceMethod),
  "imageReplaceMethod": enum (ImageReplaceMethod),
  "pageObjectIds": [
    string
  ],

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

  // Union field image_source can be only one of the following:
  "imageUrl": string
  // End of list of possible types for union field image_source.
}
欄位
replaceMethod
(deprecated)

enum (ReplaceMethod)

取代方法。

已淘汰 ：使用 imageReplaceMethod 。

如果您同時指定 replaceMethod 和 imageReplaceMethod， imageReplaceMethod 優先順序較高。

imageReplaceMethod

enum (ImageReplaceMethod)

圖片取代方法。

如果您同時指定 replaceMethod 和 imageReplaceMethod， imageReplaceMethod 優先順序較高。

如果沒有為 imageReplaceMethod，但指定以下項目的值： replaceMethod，然後是指定的 replaceMethod 值。

如未指定，則會使用 CENTER_INSIDE。

pageObjectIds[]

string

如果非空白，則系統只會將比對範圍限制在特定網頁元素。

如果指定的網頁物件 ID 為 notes page 或 notes master，或者簡報中沒有含有該物件 ID 的頁面。

聯集欄位 criteria。形狀要符合的條件才能被取代。 criteria 只能為下列其中一項：
containsText

object (SubstringMatchCriteria)

如果設定，此要求會取代包含指定文字的所有形狀。

聯集欄位 image_source。圖片來源的類型。 image_source 只能為下列其中一項：
imageUrl

string

圖片網址。

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

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

ReplaceMethod

取代方法。

列舉
CENTER_INSIDE 縮放和置中圖片，使其符合原始形狀的邊界，並維持圖片的長寬比。圖片算繪後的大小可能會小於形狀大小。如未指定，這是預設方法。
CENTER_CROP 縮放及置中圖片，填滿原始形狀的邊界。圖片可能會為了填滿形狀而遭到裁剪。圖片算繪後的大小會與原始形狀相同。

ImageReplaceMethod

圖片取代方法。

列舉
IMAGE_REPLACE_METHOD_UNSPECIFIED 未指定的圖片取代方法。不能使用這個值。
CENTER_INSIDE 縮放和置中圖片，使其符合原始形狀的邊界，並維持圖片的長寬比。圖片算繪後的大小可能會小於形狀大小。如未指定，這是預設方法。
CENTER_CROP 縮放及置中圖片，填滿原始形狀的邊界。圖片可能會為了填滿形狀而遭到裁剪。圖片算繪後的大小會與原始形狀相同。

DuplicateObjectRequest

複製投影片或頁面元素。

複製投影片時，系統會在指定投影片後方立即建立複製的投影片。複製網頁元素時，系統會將副本放在原始頁面的相同位置。

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

string

要複製的物件 ID。

objectIds

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。

UpdateTextStyleRequest

更新 Shape 或 Table。

JSON 表示法 
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "style": {
    object (TextStyle)
  },
  "textRange": {
    object (Range)
  },
  "fields": string
}
欄位
objectId

string

形狀或表格的物件 ID，其中包含要設定樣式的文字。

cellLocation

object (TableCellLocation)

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

style

object (TextStyle)

要在文字上設定的樣式。

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

部分文字樣式變更可能會導致其他變更套用至簡報編輯器的行為。詳情請參閱 TextStyle 瞭解詳情

textRange

object (Range)

要設定樣式的文字範圍。

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

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

fields

string (FieldMask format)

要更新的欄位。

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

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

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

ReplaceAllShapesWithSheetsChartRequest

將符合指定條件的所有形狀替換成系統提供的 Google 試算表圖表。系統會縮放圖表並置中，以符合原始形狀的邊界。

注意：以圖表取代圖形時，您至少要有一個 Sheets.readonly、試算表、drive.readonly 或雲端硬碟 OAuth 範圍，

JSON 表示法 
{
  "containsText": {
    object (SubstringMatchCriteria)
  },
  "spreadsheetId": string,
  "chartId": integer,
  "linkingMode": enum (LinkingMode),
  "pageObjectIds": [
    string
  ]
}
欄位
containsText

object (SubstringMatchCriteria)

形狀要符合的條件才能被取代。要求會取代所有包含指定文字的形狀。

spreadsheetId

string

含有圖表的 Google 試算表 ID。

chartId

integer

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

linkingMode

enum (LinkingMode)

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

pageObjectIds[]

string

如果非空白，則系統只會將比對範圍限制在特定網頁元素。

如果指定的網頁物件 ID 為 notes page 或 notes master，或者簡報中沒有含有該物件 ID 的頁面。

LinkingMode

圖表連結至來源試算表的模式。

列舉
NOT_LINKED_IMAGE 圖表與來源試算表沒有關聯，因此無法更新。未連結的圖表將插入為圖片格式。
LINKED 連結圖表即可更新圖表，其他協作者則會看到試算表的連結。

DeleteParagraphBulletsRequest

從與指定文字索引重疊的所有段落中刪除項目符號 range。

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

JSON 表示法 
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "textRange": {
    object (Range)
  }
}
欄位
objectId

string

形狀或表格的物件 ID，內含要刪除項目符號的文字。

cellLocation

object (TableCellLocation)

如果要修改的文字位於表格儲存格中，選填的表格儲存格位置。如果存在，objectId 必須參照資料表。

textRange

object (Range)

要刪除項目符號的文字範圍 (以下依據： TextElement 索引。

UpdateParagraphStyleRequest

更新 a 內所有段落的樣式 Shape 或 Table 與指定的文字索引範圍重疊

JSON 表示法 
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "style": {
    object (ParagraphStyle)
  },
  "textRange": {
    object (Range)
  },
  "fields": string
}
欄位
objectId

string

形狀或表格的物件 ID，其中包含要設定樣式的文字。

cellLocation

object (TableCellLocation)

表格中包含要設定樣式的段落的儲存格位置。如果 objectId 指的是資料表 cellLocation 必須有一個值。否則就不得。

style

object (ParagraphStyle)

段落的樣式。

textRange

object (Range)

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

fields

string (FieldMask format)

要更新的欄位。

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

舉例來說，如果想更新段落對齊方式，請將 fields 到 "alignment"。

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

UpdateTableBorderPropertiesRequest

更新 Table。

JSON 表示法 
{
  "objectId": string,
  "tableRange": {
    object (TableRange)
  },
  "borderPosition": enum (BorderPosition),
  "tableBorderProperties": {
    object (TableBorderProperties)
  },
  "fields": string
}
欄位
objectId

string

資料表的物件 ID。

tableRange

object (TableRange)

這個表格範圍代表要套用更新的資料表中子集。如果未指定表格範圍，系統會將更新套用到整個資料表。

borderPosition

enum (BorderPosition)

要套用更新的表格範圍的邊框位置。如果未指定框線位置，則更新會套用至表格範圍中的所有框線。

tableBorderProperties

object (TableBorderProperties)

要更新的表格框線屬性。

fields

string (FieldMask format)

要更新的欄位。

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

舉例來說，如要更新表格邊框純填滿顏色，請設定 fields 到 "tableBorderFill.solidFill.color"。

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

BorderPosition

表格框線位置。

列舉
ALL 範圍內的所有框線。
BOTTOM 範圍底部的框線。
INNER 範圍內部的框線。
INNER_HORIZONTAL 範圍內部的水平框線。
INNER_VERTICAL 範圍內部的垂直框線。
LEFT 範圍左側的框線。
OUTER 位於範圍外的框線。
RIGHT 位於範圍右側的框線。
TOP 範圍頂端的框線。

UpdateTableColumnPropertiesRequest

更新 Table 。

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

string

資料表的物件 ID。

columnIndices[]

integer

在清單中以零為基準，指定要更新哪些資料欄。如果沒有提供索引，系統就會更新資料表中的所有資料欄。

tableColumnProperties

object (TableColumnProperties)

要更新的表格欄屬性。

如果 tableColumnProperties#columnWidth 要求小於 406,400 EMU (32 分)，會傳回 400 錯誤的要求錯誤。

fields

string (FieldMask format)

要更新的欄位。

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

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

如果「"columnWidth」"，但該屬性未設定，欄寬度將預設為 406,400 EMU (32 點)。

UpdateTableRowPropertiesRequest

更新 Table 列。

JSON 表示法 
{
  "objectId": string,
  "rowIndices": [
    integer
  ],
  "tableRowProperties": {
    object (TableRowProperties)
  },
  "fields": string
}
欄位
objectId

string

資料表的物件 ID。

rowIndices[]

integer

在一個以零為基礎的索引清單中，指定要更新哪些資料列。如未提供索引，就會更新資料表中的所有資料列。

tableRowProperties

object (TableRowProperties)

要更新的表格列屬性。

fields

string (FieldMask format)

要更新的欄位。

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

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

如果「minRowHeight」，但該屬性並未設定，則最低列高會預設為 0。

MergeTableCellsRequest

合併 Table。

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

string

資料表的物件 ID。

tableRange

object (TableRange)

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

合併的儲存格中的所有文字都會串連起來，並儲存在範圍的左上方 (「head」) 儲存格中。如果這個範圍不是矩形 (在某些情況下，這個範圍涵蓋已合併的儲存格時就會發生)，系統會傳回 400 錯誤的要求錯誤。

UnmergeTableCellsRequest

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

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

string

資料表的物件 ID。

tableRange

object (TableRange)

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

此範圍中所有合併的儲存格都會取消合併，且已取消合併的儲存格不會受到影響。如果範圍未包含合併的儲存格，要求則不會執行任何操作。如果合併的儲存格中有任何文字，文字仍會保留在系統所產生未合併儲存格的左上方 (「head」) 儲存格中。

GroupObjectsRequest

將物件分組，藉此建立物件群組。例如群組 PageElements 來建立 Group 顯示與所有子帳戶相同的頁面

JSON 表示法 
{
  "groupObjectId": string,
  "childrenObjectIds": [
    string
  ]
}
欄位
groupObjectId

string

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

您指定的 ID 不得與簡報中所有頁面和頁面元素重複，ID 的開頭必須是英數字元或底線 (與規則運算式相符) [a-zA-Z0-9_]);其餘字元可能包含這些字元，以及連字號或冒號 (與規則運算式相符) [a-zA-Z0-9_-:])。ID 長度不得小於 5 或大於 50。

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

childrenObjectIds[]

string

要分組的物件 ID。

您只能將網頁元素分組。同一個網頁上應至少有兩個網頁元素，而不能是其他群組。部分網頁元素，例如 videos, tables 和 placeholders 無法分組。

UngroupObjectsRequest

取消分組物件，例如 groups。

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

string

要取消分組的物件物件 ID。

僅限 groups 搜尋到 groups 可以取消分組所有群組均應位於同一個頁面。系統會刪除群組本身。所有子項的視覺大小和位置都會保留下來。

UpdatePageElementAltTextRequest

更新 page element。

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

string

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

title

string

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

description

string

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

ReplaceImageRequest

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

取代圖片會移除一部分 image effects 直接在現有圖片中自動生成說明文字

JSON 表示法 
{
  "imageObjectId": string,
  "imageReplaceMethod": enum (ImageReplaceMethod),

  // Union field image_source can be only one of the following:
  "url": string
  // End of list of possible types for union field image_source.
}
欄位
imageObjectId

string

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

imageReplaceMethod

enum (ImageReplaceMethod)

取代方式。

聯集欄位 image_source。圖片來源的類型。 image_source 只能為下列其中一項：
url

string

圖片網址。

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

提供的網址長度不得超過 2 KB。網址會隨圖片儲存，並透過 Image.source_url ] 欄位。

UpdateSlidePropertiesRequest

更新投影片的屬性。

JSON 表示法 
{
  "objectId": string,
  "slideProperties": {
    object (SlideProperties)
  },
  "fields": string
}
欄位
objectId

string

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

slideProperties

object (SlideProperties)

要更新的投影片屬性。

fields

string (FieldMask format)

要更新的欄位。

至少須指定一個欄位。根層級「SlideProperties」為默示，且不應該指定。單一 "*" 可做為列出每個欄位的簡寫。

舉例來說，如果想更新是否略過投影片 fields 到 "isSkipped"。

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

UpdatePageElementsZOrderRequest

更新頁面元素的 Z 順序。Z 順序是指網頁中元素從前到前方的順序。前端的網頁元素可能會遮住後方的元素。

JSON 表示法 
{
  "pageElementObjectIds": [
    string
  ],
  "operation": enum (ZOrderOperation)
}
欄位
pageElementObjectIds[]

string

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

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

operation

enum (ZOrderOperation)

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

將這項作業套用至多個頁面元素時，在作業維持之前，這些頁面元素中的相對 Z 順序。

ZOrderOperation

更新頁面元素 Z 順序的作業。

列舉
Z_ORDER_OPERATION_UNSPECIFIED 未指定的作業。
BRING_TO_FRONT 將網頁元素顯示在頁面前方。
BRING_FORWARD 針對指定網頁元素中最前一項的元素，將網頁上的網頁元素往前移動一個元素。
SEND_BACKWARD 相對於指定網頁元素中最後面的元素，將網頁元素反向傳送一個元素。
SEND_TO_BACK 將網頁元素傳送至網頁背面。

UpdateLineCategoryRequest

更新特定應用程式的類別 line。

JSON 表示法 
{
  "objectId": string,
  "lineCategory": enum (LineCategory)
}
欄位
objectId

string

要套用更新的項目行的物件 ID。

一行必須包含 category 代表這是「連接器」可以更新

這條路線可能在更新類別後重新規劃路線。

lineCategory

enum (LineCategory)

要更新的線條類別。

與 line type 會根據要更新的類別和轉送至其他網頁元素的方式決定。

RerouteLineRequest

重新轉送 line 讓網域在相連網頁元素中位於兩個最接近的連線網站。

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

string

要重新轉送線條的物件 ID。

一行必須包含 category 代表這是「連接器」可以重新規劃路線。線條的開始與結束連線必須位於不同的頁面元素中。