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)

更新 ShapeTable 中的文字樣式。

replaceAllShapesWithSheetsChart

object (ReplaceAllShapesWithSheetsChartRequest)

將符合部分條件的所有形狀替換為 Google 試算表。

deleteParagraphBullets

object (DeleteParagraphBulletsRequest)

從段落中刪除項目符號。

updateParagraphStyle

object (UpdateParagraphStyleRequest)

更新 ShapeTable 中的段落樣式。

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 的 Z 順序。

updateLineCategory

object (UpdateLineCategoryRequest)

更新 line 的類別。

rerouteLine

object (RerouteLineRequest)

重新轉送 line,使其連線到已連結網頁元素的兩個最近連線網站。

製作投影片要求

建立投影片。

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

選用的從零開始索引,用於指出插入投影片的位置。

如果沒有指定索引,投影片則會在結束時建立。

slideLayoutReference

object (LayoutReference)

要插入的投影片版面配置參照,以「目前主要執行個體」為基礎,其為下列其中一項:

  • 上一張投影片索引的主投影片。
  • 如果 targetIndex 為零,則為第一張投影片的主投影片。
  • 簡報中的主投影片 (如果沒有投影片)。

如果目前的主頁中找不到 LayoutReference,系統會傳回 400 錯誤要求錯誤。

如未指定版面配置參考資料,投影片會使用預先定義的 BLANK 版面配置。

placeholderIdMappings[]

object (LayoutPlaceholderIdMapping)

選擇性的物件 ID 對應清單:從版面配置的 placeholder (對應) 對應至在指定版面配置在投影片中建立的預留位置。只有在指定 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。

Pre 預先定義的 Layout

預先定義的版面配置類型。簡報中通常會提供版面配置。不過,這些版面配置不一定會出現在目前的主投影片中,因為這些版面配置已遭刪除或不屬於使用的主題。此外,每個版面配置的預留位置可能有所變更。

列舉
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)

要套用至投影片的版面配置上的預留位置。只需要 typeindex。舉例來說,預先定義的 TITLE_AND_BODY 版面配置通常包含索引 0 的 TITLE 預留位置,以及索引 0 的 內文預留位置。

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 個字元。如果留空,系統會產生專屬 ID。

elementProperties

object (PageElementProperties)

形狀的元素屬性。

shapeType

enum (Type)

形狀類型。

PageElementProperties

網頁元素的常見屬性。

注意:剛建立 PageElement 時,API 可能會修改 sizetransform 的值,但視覺大小維持不變。

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 索引。

索引從零開始,且從字串的開頭計算。您可以調整索引,避免在萬國碼 (Unicode) 圖形叢集中插入。在這些情況下,系統將在圖表所屬叢集後方插入文字。

InsertTableRowsRequest

在資料表中插入資料列。

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

string

要插入資料列的資料表。

cellLocation

object (TableCellLocation)

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

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

insertBelow

boolean

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

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

integer

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

InsertTableColumnRequest

將資料欄插入資料表。

系統會調整表格中其他欄的大小,以符合新的資料欄。

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)

參照欄的來源儲存格位置,系統將刪除資料欄。

系統將刪除這個儲存格時距的欄。如果這是合併的儲存格,將刪除多欄。刪除作業完成後,如果表格中沒有任何資料欄,整個資料表都會遭到刪除。

取代所有文字要求

將符合條件的所有文字項目替換成 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 的網頁,系統就會傳回 400 錯誤要求錯誤。

聯集欄位 criteria。用來取代文字的條件。 criteria 只能是下列其中一個值:
containsText

object (SubstringMatchCriteria)

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

SubstringMatchCriteria

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

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

string

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

matchCase

boolean

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

  • True :搜尋須區分大小寫。
  • False : 不區分大小寫。

DeleteObjectRequest

從簡報中刪除物件 (pagespage 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)

轉換更新的套用模式。

套用模式

轉換更新的套用模式。

列舉
APPLY_MODE_UNSPECIFIED 未指定模式。
RELATIVE 將新的 AffineTransform 矩陣套用至現有的矩陣,並以現有的結果取代現有的矩陣。
ABSOLUTE 將現有的 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_INDEXFIXED_RANGE 的明確邊界時,請務必謹慎。舉例來說,如果文字是「ABC」,後面是隱式換行符號,則 textRange.start_indextextRange.end_index 的最大值為 2。

如果刪除超過段落邊界的文字,系統可能會合併兩個段落,並改變段落樣式和清單。

範圍中僅包含一個代理值組合的範圍,其中又包含兩個程式碼單元。

範圍

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

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 固定範圍。必須指定 startIndexendIndex
FROM_START_INDEX 範圍從 startIndex 開始,直到收集結束為止。不得指定 endIndex
ALL 將範圍設為集合的完整長度。不得同時指定 startIndexendIndex

建立 ImageRequest

建立映像檔。

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

建立影片。

注意:如要透過 Google 雲端硬碟建立影片,要求的應用程式至少須有一個 Drive、drive.readonly 或 drive.file OAuth 範圍。

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 標頭中加入資源金鑰。詳情請參閱「使用資源金鑰存取連結共用檔案」。

建立試算表圖表

建立內嵌 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 個字元。如果留空,系統會產生專屬 ID。

elementProperties

object (PageElementProperties)

圖表的元素屬性。

如果提供的長寬比與圖表長寬比不符,圖表會根據大小大小縮放及置中,以維持長寬比。這項作業會在所提供的作業後套用。

spreadsheetId

string

內含圖表的 Google 試算表 ID。

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

chartId

integer

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

linkingMode

enum (LinkingMode)

連結到來源試算表的模式。如未指定,圖表就會是未連結的圖片。

LinkMode

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

列舉
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 取決於類別,以及系統如何轉送到其他網頁元素。

如果同時指定 categorylineCategory,則系統會優先採用 category

category

enum (LineCategory)

要建立的行類別。

確切的 line type 取決於類別,以及系統如何轉送到其他網頁元素。

如果同時指定 categorylineCategory,則系統會優先採用 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

更新 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

更新 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

更新 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

更新 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 表格,最後一列的所有儲存格會合併在一起。資料表如下所示:

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

包含

 [ 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"

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

CreateParagraphBulletRequest

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

每個段落的巢狀結構也會計算每個段落前方的定位點。為避免項目符號和對應段落之間的空格過多,提出要求時系統會移除這些主要分頁。這可能會改變部分文字的索引。

如果段落更新前的段落位於符合預設設定的清單中,則要更新的段落會新增至前面的清單。

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」。含有多個數字的數字,開頭不會加上零。
  • ROMAN :小寫羅馬數字,例如「i」、「ii」或「iii」。
  • UPPERROMAN :小寫英文數字,例如「I」、「II」或「III」。
  • LEFTTRIANGLE :指向左側的三角形,對應萬國碼 (Unicode) U+25c4 代碼點
列舉
BULLET_DISC_CIRCLE_SQUARE 一份清單,內含前 3 個清單巢狀層級的 DISCCIRCLESQUARE 項目符號。
BULLET_DIAMONDX_ARROW3D_SQUARE 一份清單,內含前 3 個清單巢狀層級的 DIAMONDXARROW3DSQUARE 項目符號。
BULLET_CHECKBOX 加入項目符號清單,內含所有清單巢狀層級的 CHECKBOX 項目符號字符。
BULLET_ARROW_DIAMOND_DISC 一份清單,內含前 3 個清單巢狀層級的 ARROWDIAMONDDISC 項目符號。
BULLET_STAR_CIRCLE_SQUARE 一份清單,內含前 3 個清單巢狀層級的 STARCIRCLESQUARE 項目符號。
BULLET_ARROW3D_CIRCLE_SQUARE 一份清單,內含前 3 個清單巢狀層級的 ARROW3DCIRCLESQUARE 項目符號。
BULLET_LEFTTRIANGLE_DIAMOND_DISC 一份清單,內含前 3 個清單巢狀層級的 LEFTTRIANGLEDIAMONDDISC 項目符號。
BULLET_DIAMONDX_HOLLOWDIAMOND_SQUARE 一份清單,內含前 3 個清單巢狀層級的 DIAMONDXHOLLOWDIAMONDSQUARE 項目符號。
BULLET_DIAMOND_CIRCLE_SQUARE 一份清單,內含前 3 個清單巢狀層級的 DIAMONDCIRCLESQUARE 項目符號。
NUMBERED_DIGIT_ALPHA_ROMAN 前 3 個清單巢狀層級的編號為 DIGITALPHAROMAN 數字字符,後面接著半形句號。
NUMBERED_DIGIT_ALPHA_ROMAN_PARENS 包含前 3 個清單巢狀層級的 DIGITALPHAROMAN 數字字符,後面加上括號。
NUMBERED_DIGIT_NESTED 在這個編號清單中,包含 DIGIT 數字字符,並以半形句號分隔,每個巢狀層級層級都會以前一個巢狀層級字符做為前置字串。例如:「1.」、「1.1」、「2.」、「2.2.」。
NUMBERED_UPPERALPHA_ALPHA_ROMAN 前 3 個清單巢狀層級的編號為 UPPERALPHAALPHAROMAN 數字字符,後面接著半形句號。
NUMBERED_UPPERROMAN_UPPERALPHA_DIGIT 前 3 個清單巢狀層級的編號為 UPPERROMANUPPERALPHADIGIT 數字字符,後面接著半形句號。
NUMBERED_ZERODIGIT_ALPHA_ROMAN 前 3 個清單巢狀層級的編號為 ZERODIGITALPHAROMAN 數字字符,後面接著半形句號。

取代 AllShapesWithImageRequest

將與指定圖片相符的所有形狀替換成提供的圖片。

取代使用形狀的圖片在插入簡報後是矩形,而不是採用形狀的形式。

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

如果您同時指定 replaceMethodimageReplaceMethod,系統會優先採用 imageReplaceMethod

imageReplaceMethod

enum (ImageReplaceMethod)

圖片取代方法。

如果您同時指定 replaceMethodimageReplaceMethod,系統會優先採用 imageReplaceMethod

如果您沒有為 imageReplaceMethod 指定值,但指定 replaceMethod 的值,則會使用指定的 replaceMethod 值。

如未指定,系統會使用 CENTER_INSIDE。

pageObjectIds[]

string

如果不是空白,將限制為僅比對特定網頁的內容元素。

如果 notes pagenotes master 的網頁物件 ID 或簡報中沒有物件,系統會傳回 400 要求錯誤。

聯集欄位 criteria。形狀必須符合的條件才會取代。criteria 只能是下列其中一個值:
containsText

object (SubstringMatchCriteria)

設定後,此要求會取代所有包含指定文字的形狀。

聯集欄位 image_source。圖片來源的種類。image_source 只能是下列其中一個值:
imageUrl

string

圖片網址。

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

提供的網址長度上限為 2 KB。網址本身會與映像檔一併儲存,並透過 Image.source_url 欄位公開。

取代方法

取代方法。

列舉
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 都必須對應至簡報中現有的 ID。簡報中的所有值均不得重複,且開頭必須為英數字元或底線 (與規則運算式 [a-zA-Z0-9_] 相符)。其餘的字元可能也包含連字號或冒號 (與規則運算式 [a-zA-Z0-9_-:] 相符)。新 ID 的長度不能超過 5 個字元。

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

UpdateTextStyleRequest

更新 ShapeTable 中的文字樣式。

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 試算表圖表。圖表將縮放及置中,以符合原始形狀的邊界。

注意:使用圖表取代圖形時,必須使用至少一個試算表.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

如果不是空白,將限制為僅比對特定網頁的內容元素。

如果 notes pagenotes master 的網頁物件 ID 或簡報中沒有物件,系統會傳回 400 要求錯誤。

LinkMode

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

列舉
NOT_LINKED_IMAGE 圖表與來源試算表無關,因此無法更新。未連結的圖表會插入為圖片。
LINKED 連結圖表後,系統就會更新圖表,其他協作者則會看到試算表的連結。

DeleteParagraphBulletRequest

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

在每個段落的開頭加上縮排,即可保留各段落的巢狀層級。

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

string

形狀或表格的物件 ID (含有刪除項目符號的文字)。

cellLocation

object (TableCellLocation)

如果要修改的文字位於表格儲存格中,可視需要使用表格儲存格位置。如果有,objectId 必須參照一個資料表。

textRange

object (Range)

根據 TextElement 索引刪除項目符號的範圍。

UpdateParagraphStyleRequest

更新 ShapeTable 中所有與指定文字索引範圍重疊的段落樣式。

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 要求錯誤。

取消合併儲存格儲存格

取消合併 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。

只有網頁元素可以分組。同一個網頁上至少要有兩個網頁元素,而這些元素並未加入其他群組。某些網頁元素 (例如 videostablesplaceholders) 無法分組。

UngroupObjectsRequest

將物件取消分組,例如 groups

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

string

要取消分組的物件 ID。

只能將不屬於其他 groupsgroups 分組。所有群組都必須位於同一個網頁上。群組本身遭到刪除。系統會保留所有子項的視覺大小和位置。

UpdatePageElementAltTextRequest

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

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

string

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

title

string

更新後的頁面元素替代文字標題。如未設定,系統會保留現有的值。標題會經由螢幕閱讀器和其他無障礙功能介面顯示。僅使用與網頁元素內容相關的使用者可理解值。

description

string

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

取代圖片要求

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

取代圖片會從現有圖片中移除部分 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-order 是指網頁上的元素在後置順序。正面的頁面元素可能會涵蓋背後的要素。

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 將網頁元素依其位於指定網頁元素的後方第 4 種進行後的元素往上移。
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 的行表示此行是「連接器」。線條的開始和結束連線必須位於不同的網頁元素。