要求
適用於簡報的一種更新。
JSON 表示法 |
---|
{ // Union field |
欄位 | |
---|---|
聯集欄位 kind 。的更新類型。只有一個欄位。kind 只能是下列其中一個值: |
|
createSlide
|
建立新投影片。 |
createShape
|
建立新的形狀。 |
createTable
|
建立新的資料表。 |
insertText
|
將文字插入圖案或表格儲存格中。 |
insertTableRows
|
在資料表中插入資料列。 |
insertTableColumns
|
將資料欄插入資料表。 |
deleteTableRow
|
從資料表中刪除資料列。 |
deleteTableColumn
|
從資料表中刪除資料欄。 |
replaceAllText
|
取代指定文字的所有例項。 |
deleteObject
|
從簡報中刪除網頁或頁面元素。 |
updatePageElementTransform
|
更新網頁元素的轉換。 |
updateSlidesPosition
|
更新簡報中的投影片位置。 |
deleteText
|
刪除形狀或表格儲存格中的文字。 |
createImage
|
建立映像檔。 |
createVideo
|
建立影片。 |
createSheetsChart
|
建立內嵌 Google 試算表。 |
createLine
|
建立線條。 |
refreshSheetsChart
|
重新整理 Google 試算表圖表。 |
updateShapeProperties
|
更新 |
updateImageProperties
|
更新 |
updateVideoProperties
|
更新 |
updatePageProperties
|
更新 |
updateTableCellProperties
|
更新 |
updateLineProperties
|
更新 |
createParagraphBullets
|
為段落建立項目符號。 |
replaceAllShapesWithImage
|
將符合部分條件的所有形狀取代為圖片。 |
duplicateObject
|
複製投影片或頁面元素。 |
updateTextStyle
|
|
replaceAllShapesWithSheetsChart
|
將符合部分條件的所有形狀替換為 Google 試算表。 |
deleteParagraphBullets
|
從段落中刪除項目符號。 |
updateParagraphStyle
|
|
updateTableBorderProperties
|
更新 |
updateTableColumnProperties
|
更新 |
updateTableRowProperties
|
更新 |
mergeTableCells
|
合併 |
unmergeTableCells
|
取消合併 |
groupObjects
|
將物件分組,例如網頁元素。 |
ungroupObjects
|
將物件取消分組,例如 |
updatePageElementAltText
|
更新 |
replaceImage
|
使用新圖片取代現有圖片。 |
updateSlideProperties
|
更新投影片的屬性 |
updatePageElementsZOrder
|
更新 |
updateLineCategory
|
更新 |
rerouteLine
|
重新轉送 |
製作投影片要求
建立投影片。
JSON 表示法 |
---|
{ "objectId": string, "insertionIndex": integer, "slideLayoutReference": { object ( |
欄位 | |
---|---|
objectId
|
使用者提供的物件 ID。
如果您指定某個 ID,在簡報中所有頁面和網頁元素中都不得重複。ID 的開頭必須是英數字元或底線 (與規則運算式 如未指定 ID,系統會產生專屬 ID。 |
insertionIndex
|
選用的從零開始索引,用於指出插入投影片的位置。 如果沒有指定索引,投影片則會在結束時建立。 |
slideLayoutReference
|
要插入的投影片版面配置參照,以「目前主要執行個體」為基礎,其為下列其中一項:
如果目前的主頁中找不到 LayoutReference,系統會傳回 400 錯誤要求錯誤。
如未指定版面配置參考資料,投影片會使用預先定義的 |
placeholderIdMappings[]
|
選擇性的物件 ID 對應清單:從版面配置的 |
LayoutReference
投影片版面配置參考資料。這可指出:
- 預先定義的版面配置
- 簡報中的其中一個版面配置。
JSON 表示法 |
---|
{ // Union field |
欄位 | |
---|---|
聯集欄位 kind 。LayoutReference 的種類。kind 只能是下列其中一個值: |
|
predefinedLayout
|
預先定義的版面配置。 |
layoutId
|
版面配置 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 |
欄位 | |
---|---|
objectId
|
您在上方尋找的預留位置物件 ID,用來建立該投影片。
如果您指定某個 ID,在簡報中所有頁面和網頁元素中都不得重複。ID 的開頭必須是英數字元或底線 (與規則運算式 如未指定 ID,系統會產生專屬 ID。 |
聯集欄位 kind 。用來在版面配置中識別預留位置的種類。kind 只能是下列其中一個值: |
|
layoutPlaceholder
|
要套用至投影片的版面配置上的預留位置。只需要 |
layoutPlaceholderObjectId
|
版面配置中的預留位置物件 ID,會套用至投影片。 |
CreateShapeRequest
建立新的形狀。
JSON 表示法 |
---|
{ "objectId": string, "elementProperties": { object ( |
欄位 | |
---|---|
objectId
|
使用者提供的物件 ID。
如果您指定某個 ID,在簡報中所有頁面和網頁元素中都不得重複。ID 的開頭必須是英數字元或底線 (與規則運算式 |
elementProperties
|
形狀的元素屬性。 |
shapeType
|
形狀類型。 |
PageElementProperties
網頁元素的常見屬性。
注意:剛建立 PageElement
時,API 可能會修改 size
和 transform
的值,但視覺大小維持不變。
JSON 表示法 |
---|
{ "pageObjectId": string, "size": { object ( |
欄位 | |
---|---|
pageObjectId
|
元素所在網頁的物件 ID。 |
size
|
元素的大小。 |
transform
|
元素的轉換。 |
CreateTableRequest
建立新的資料表。
JSON 表示法 |
---|
{
"objectId": string,
"elementProperties": {
object (
|
欄位 | |
---|---|
objectId
|
使用者提供的物件 ID。
如果您指定某個 ID,在簡報中所有頁面和網頁元素中都不得重複。ID 的開頭必須是英數字元或底線 (與規則運算式 如未指定 ID,系統會產生專屬 ID。 |
elementProperties
|
表格的元素屬性。 表格將以提供的尺寸建立,並有大小下限。如未提供任何大小,表格就會自動調整大小。 資料表轉換的規模不得為 1 且沒有括號。如未提供轉換,資料表將會置中對齊。 |
rows
|
資料表中的資料列數 |
columns
|
資料表中的資料欄數。 |
InsertTextRequest
將文字插入圖案或表格儲存格中。
JSON 表示法 |
---|
{
"objectId": string,
"cellLocation": {
object (
|
欄位 | |
---|---|
objectId
|
要插入文字的形狀或表格物件 ID。 |
cellLocation
|
如果文字會插入表格儲存格, 你可以選擇是否要使用表格儲存格位置。如果有,objectId 必須參照一個資料表。 |
text
|
要插入的文字。
插入換行字元會間接在該索引上建立新的
系統會自動判斷插入文字的文字樣式,並保留鄰近文字的樣式。在大多數情況下,文字會新增至插入索引的 系統會從插入的文字中移除部分控製字元 (U+0000-U+0008、U+000C-U+001F) 和「萬國碼 (Unicode) 多功能私人使用區域」(U+E000-U+F8FF) 中的字元。 |
insertionIndex
|
要插入文字的索引,以萬國碼 (Unicode) 程式碼單元為基礎,依據 索引從零開始,且從字串的開頭計算。您可以調整索引,避免在萬國碼 (Unicode) 圖形叢集中插入。在這些情況下,系統將在圖表所屬叢集後方插入文字。 |
InsertTableRowsRequest
在資料表中插入資料列。
JSON 表示法 |
---|
{
"tableObjectId": string,
"cellLocation": {
object (
|
欄位 | |
---|---|
tableObjectId
|
要插入資料列的資料表。 |
cellLocation
|
要插入資料列的參照表格儲存格位置。 系統會在對應儲存格所屬的資料列上方或下方插入一列。如果參照儲存格是合併儲存格,系統會在合併儲存格的上方 (或下方) 插入一個新的列。 |
insertBelow
|
是否要在參照儲存格位置下方插入新的資料列。
|
number
|
要插入的列數。每項要求最多 20 個。 |
InsertTableColumnRequest
將資料欄插入資料表。
系統會調整表格中其他欄的大小,以符合新的資料欄。
JSON 表示法 |
---|
{
"tableObjectId": string,
"cellLocation": {
object (
|
欄位 | |
---|---|
tableObjectId
|
要插入資料欄的資料表。 |
cellLocation
|
要插入資料欄的參照資料表儲存格位置。 系統會在參照儲存格的左側 (或右側) 插入一欄。如果參照儲存格是合併儲存格,系統會在合併儲存格的左側 (或右側) 插入新欄。 |
insertRight
|
是否要在參照儲存格位置右側插入新資料欄。
|
number
|
要插入的資料欄數。每項要求最多 20 個。 |
DeleteTableRowRequest
從資料表中刪除資料列。
JSON 表示法 |
---|
{
"tableObjectId": string,
"cellLocation": {
object (
|
欄位 | |
---|---|
tableObjectId
|
要刪除資料列的來源資料表。 |
cellLocation
|
參照資料列參照所在資料列的參照位置。 系統將刪除這個儲存格跨距所在列。如果這是合併的儲存格,將刪除多列。刪除作業完成後,如果資料表沒有資料列,整個資料表都會遭到刪除。 |
DeleteTableColumnRequest
從資料表中刪除資料欄。
JSON 表示法 |
---|
{
"tableObjectId": string,
"cellLocation": {
object (
|
欄位 | |
---|---|
tableObjectId
|
要從哪個資料欄刪除資料欄。 |
cellLocation
|
參照欄的來源儲存格位置,系統將刪除資料欄。 系統將刪除這個儲存格時距的欄。如果這是合併的儲存格,將刪除多欄。刪除作業完成後,如果表格中沒有任何資料欄,整個資料表都會遭到刪除。 |
取代所有文字要求
將符合條件的所有文字項目替換成 replace text
。
JSON 表示法 |
---|
{ "replaceText": string, "pageObjectIds": [ string ], // Union field |
欄位 | |
---|---|
replaceText
|
用來取代相符文字的文字。 |
pageObjectIds[]
|
如果不是空白,將限制為僅比對特定網頁的內容元素。
如果網頁物件 ID 是 |
聯集欄位 criteria 。用來取代文字的條件。
criteria 只能是下列其中一個值: |
|
containsText
|
尋找與這個子字串相符的形狀文字。 |
SubstringMatchCriteria
符合形狀或表格中特定文字字串的條件。
JSON 表示法 |
---|
{ "text": string, "matchCase": boolean } |
欄位 | |
---|---|
text
|
要搜尋形狀或表格的文字。 |
matchCase
|
指出搜尋是否應區分大小寫:
|
DeleteObjectRequest
從簡報中刪除物件 (pages
或 page elements
)。
JSON 表示法 |
---|
{ "objectId": string } |
欄位 | |
---|---|
objectId
|
要刪除的網頁或網頁元素的物件 ID。
如果在刪除作業後 如果在版面配置中刪除預留位置,所有沿用的預留位置都會遭到刪除。 |
UpdatePageElementTransformRequest
更新網頁元素的轉換。
更新群組轉換時,該群組中的網頁元素絕對轉換,都會改變視覺外觀。詳情請參閱 PageElement.transform
的說明文件。
JSON 表示法 |
---|
{ "objectId": string, "transform": { object ( |
欄位 | |
---|---|
objectId
|
要更新的網頁元素的物件 ID。 |
transform
|
用於更新網頁元素的輸入轉換矩陣。 |
applyMode
|
轉換更新的套用模式。 |
套用模式
轉換更新的套用模式。
列舉 | |
---|---|
APPLY_MODE_UNSPECIFIED
|
未指定模式。 |
RELATIVE
|
將新的 AffineTransform 矩陣套用至現有的矩陣,並以現有的結果取代現有的矩陣。 |
ABSOLUTE
|
將現有的 AffineTransform 矩陣更換為新的矩陣。 |
UpdateSlidesPositionRequest
更新簡報中的投影片位置。
JSON 表示法 |
---|
{ "slideObjectIds": [ string ], "insertionIndex": integer } |
欄位 | |
---|---|
slideObjectIds[]
|
簡報中應移動的投影片 ID。這份清單中的投影片必須是現有的簡報順序,且不得重複。 |
insertionIndex
|
應插入投影片的索引,根據移動前的投影片排列方式。簡報中的投影片數量必須介於 0 到 (含) 之間。 |
DeleteTextRequest
刪除形狀或表格儲存格中的文字。
JSON 表示法 |
---|
{ "objectId": string, "cellLocation": { object ( |
欄位 | |
---|---|
objectId
|
即將刪除文字的形狀或表格物件 ID。 |
cellLocation
|
如果將文字從表格儲存格中刪除,可選擇使用的表格儲存格位置。如果有,objectId 必須參照一個資料表。 |
textRange
|
要刪除的文字範圍,以
形狀或表格儲存格的文字結尾一律有隱含的換行字元,因此無法刪除。 如果刪除超過段落邊界的文字,系統可能會合併兩個段落,並改變段落樣式和清單。 範圍中僅包含一個代理值組合的範圍,其中又包含兩個程式碼單元。 |
範圍
指定已建立索引的連續範圍,例如文字中的字元。
JSON 表示法 |
---|
{
"startIndex": integer,
"endIndex": integer,
"type": enum (
|
欄位 | |
---|---|
startIndex
|
集合開頭的選用零索引。至少須有 |
endIndex
|
集合結尾的選用零索引。必須達到 |
type
|
範圍類型。 |
類型
範圍類型。
列舉 | |
---|---|
RANGE_TYPE_UNSPECIFIED
|
未指定的範圍類型。這個值不可使用。 |
FIXED_RANGE
|
固定範圍。必須指定 startIndex 和 endIndex 。 |
FROM_START_INDEX
|
範圍從 startIndex 開始,直到收集結束為止。不得指定 endIndex 。
|
ALL
|
將範圍設為集合的完整長度。不得同時指定 startIndex 和 endIndex 。 |
建立 ImageRequest
建立映像檔。
JSON 表示法 |
---|
{ "objectId": string, "elementProperties": { object ( |
欄位 | |
---|---|
objectId
|
使用者提供的物件 ID。
如果您指定某個 ID,在簡報中所有頁面和網頁元素中都不得重複。ID 的開頭必須是英數字元或底線 (與規則運算式 如未指定 ID,系統會產生專屬 ID。 |
elementProperties
|
圖片的元素屬性。 如果提供之長寬比的長寬比與圖片的顯示比例不符,系統會將圖片縮放至中心大小,以維持長寬比。這項作業會在所提供的作業後套用。
|
聯集欄位 image_source 。圖片來源的種類。image_source 只能是下列其中一個值: |
|
url
|
圖片網址。 系統會在插入時間擷取一次圖片,另一份副本會顯示在簡報中。圖片大小必須小於 50 MB,檔案大小不得超過 2500 萬像素,且必須是 PNG、JPEG 或 GIF 格式。
提供的網址必須可供所有人存取,長度上限為 2 KB。網址會隨圖片一起儲存,並透過 |
CreateVideoRequest
建立影片。
注意:如要透過 Google 雲端硬碟建立影片,要求的應用程式至少須有一個 Drive、drive.readonly 或 drive.file OAuth 範圍。
JSON 表示法 |
---|
{ "objectId": string, "elementProperties": { object ( |
欄位 | |
---|---|
objectId
|
使用者提供的物件 ID。
如果您指定某個 ID,在簡報中所有頁面和網頁元素中都不得重複。ID 的開頭必須是英數字元或底線 (與規則運算式 如未指定 ID,系統會產生專屬 ID。 |
elementProperties
|
影片的元素屬性。
|
source
|
影片來源。 |
id
|
這部影片的影片來源專屬 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 ( |
欄位 | |
---|---|
objectId
|
使用者提供的物件 ID。 指定後,簡報中的每個頁面和網頁元素 ID 皆不得重複。ID 的開頭應為文字字元 [a-zA-Z0-9_],後面加上任意長度的字元 [a-zA-Z0-9_-:]。ID 的長度長度不得超過 5 個字元。如果留空,系統會產生專屬 ID。 |
elementProperties
|
圖表的元素屬性。 如果提供的長寬比與圖表長寬比不符,圖表會根據大小大小縮放及置中,以維持長寬比。這項作業會在所提供的作業後套用。 |
spreadsheetId
|
內含圖表的 Google 試算表 ID。 您可能需要為部分舊檔案在 HTTP 標頭中新增資源金鑰。詳情請參閱「使用資源金鑰存取連結共用檔案」。 |
chartId
|
Google 試算表中的特定圖表 ID。 |
linkingMode
|
連結到來源試算表的模式。如未指定,圖表就會是未連結的圖片。 |
LinkMode
將圖表連結至來源試算表的模式。
列舉 | |
---|---|
NOT_LINKED_IMAGE
|
圖表與來源試算表無關,因此無法更新。未連結的圖表會插入為圖片。 |
LINKED
|
連結圖表後,系統就會更新圖表,其他協作者則會看到試算表的連結。 |
CreateLineRequest
建立線條。
JSON 表示法 |
---|
{ "objectId": string, "elementProperties": { object ( |
欄位 | |
---|---|
objectId
|
使用者提供的物件 ID。
如果您指定某個 ID,在簡報中所有頁面和網頁元素中都不得重複。ID 的開頭必須是英數字元或底線 (與規則運算式 如未指定 ID,系統會產生專屬 ID。 |
elementProperties
|
線條的元素屬性。 |
lineCategory
|
要建立的行類別。
已淘汰
:請改用
確切的
如果同時指定 |
category
|
要建立的行類別。
確切的
如果同時指定
如果您沒有為
如未指定,系統會使用 |
類別
線段類別。
列舉 | |
---|---|
STRAIGHT
|
直線連接點,包括直接連接器 1。如未指定,則預設類別。 |
BENT
|
彎曲連接器,包括 2 到 5 個彎曲連接頭。 |
CURVED
|
弧形連接器,包括弧形連接器 2 至 5。 |
RefreshSheetsChartRequest
重新整理內嵌的 Google 試算表,將 Google 試算表的圖表更新為最新版本。
注意:重新整理試算表時,至少必須使用 Sheets.readonly、試算表、drive.readonly 或 OAuth 範圍其中之一。
JSON 表示法 |
---|
{ "objectId": string } |
欄位 | |
---|---|
objectId
|
要重新整理的圖表的物件 ID。 |
UpdateShapePropertiesRequest
更新 Shape
的屬性。
JSON 表示法 |
---|
{
"objectId": string,
"shapeProperties": {
object (
|
欄位 | |
---|---|
objectId
|
套用更新的形狀物件 ID。 |
shapeProperties
|
要更新的形狀屬性。 |
fields
|
需要更新的欄位。
至少須指定一個欄位。根
舉例來說,如要更新形狀背景填滿顏色,請將 如要將屬性重設為預設值,請在欄位遮罩中加入欄位名稱,但不要變更欄位本身。 |
UpdateImagePropertiesRequest
更新 Image
的屬性。
JSON 表示法 |
---|
{
"objectId": string,
"imageProperties": {
object (
|
欄位 | |
---|---|
objectId
|
要套用更新的圖片的物件 ID。 |
imageProperties
|
要更新的圖片屬性。 |
fields
|
需要更新的欄位。
至少須指定一個欄位。根
舉例來說,如要更新圖片外框顏色,請將 如要將屬性重設為預設值,請在欄位遮罩中加入欄位名稱,但不要變更欄位本身。 |
UpdateVideoPropertiesRequest
更新 Video
的屬性。
JSON 表示法 |
---|
{
"objectId": string,
"videoProperties": {
object (
|
欄位 | |
---|---|
objectId
|
要套用更新的影片的物件 ID。 |
videoProperties
|
要更新的影片屬性。 |
fields
|
需要更新的欄位。
至少須指定一個欄位。根
舉例來說,如要更新影片外框顏色,請將 如要將屬性重設為預設值,請在欄位遮罩中加入欄位名稱,但不要變更欄位本身。 |
UpdatePagePropertiesRequest
更新 Page
的屬性。
JSON 表示法 |
---|
{
"objectId": string,
"pageProperties": {
object (
|
欄位 | |
---|---|
objectId
|
要套用更新的頁面物件 ID。 |
pageProperties
|
要更新的頁面屬性。 |
fields
|
需要更新的欄位。
至少須指定一個欄位。根
舉例來說,如要更新網頁背景填滿顏色,請將 如要將屬性重設為預設值,請在欄位遮罩中加入欄位名稱,但不要變更欄位本身。 |
UpdateTableCellPropertiesRequest
更新 TableCell
的屬性。
JSON 表示法 |
---|
{ "objectId": string, "tableRange": { object ( |
欄位 | |
---|---|
objectId
|
資料表的物件 ID。 |
tableRange
|
表格更新所套用的表格子集。如未指定資料表範圍,您所做的變更會套用至整個資料表。 |
tableCellProperties
|
要更新的資料表儲存格屬性。 |
fields
|
需要更新的欄位。
至少須指定一個欄位。根
舉例來說,如要更新表格儲存格背景填滿顏色,請將 如要將屬性重設為預設值,請在欄位遮罩中加入欄位名稱,但不要變更欄位本身。 |
TableRange
資料表範圍代表對資料表子集的參照。
請特別注意,由表格範圍指定的儲存格不一定是矩形。舉例來說,假設有一個 3 x 3 表格,最後一列的所有儲存格會合併在一起。資料表如下所示:
[ ][ ][ ]
[ ][ ][ ]
[ ]
包含
[ x ][ x ][ ]
[ x ][ x ][ ]
[ x x x ]
JSON 表示法 |
---|
{
"location": {
object (
|
欄位 | |
---|---|
location
|
表格範圍的起始位置。 |
rowSpan
|
表格範圍的列跨距。 |
columnSpan
|
表格範圍的欄跨距。 |
UpdateLinePropertiesRequest
更新 Line
的屬性。
JSON 表示法 |
---|
{
"objectId": string,
"lineProperties": {
object (
|
欄位 | |
---|---|
objectId
|
要套用更新內容的行物件 ID。 |
lineProperties
|
要更新的行屬性。 |
fields
|
需要更新的欄位。
至少須指定一個欄位。根
舉例來說,如要更新線條填滿填滿顏色,請將 如要將屬性重設為預設值,請在欄位遮罩中加入欄位名稱,但不要變更欄位本身。 |
CreateParagraphBulletRequest
為所有與指定文字索引範圍重疊的段落建立項目符號。
每個段落的巢狀結構也會計算每個段落前方的定位點。為避免項目符號和對應段落之間的空格過多,提出要求時系統會移除這些主要分頁。這可能會改變部分文字的索引。
如果段落更新前的段落位於符合預設設定的清單中,則要更新的段落會新增至前面的清單。
JSON 表示法 |
---|
{ "objectId": string, "cellLocation": { object ( |
欄位 | |
---|---|
objectId
|
形狀或表格的物件 ID (含有要新增項目符號的文字)。 |
cellLocation
|
如果要修改的文字位於表格儲存格中,可視需要使用表格儲存格位置。如果有,objectId 必須參照一個資料表。 |
textRange
|
根據 |
bulletPreset
|
要使用的項目符號字符類型。預設值為 |
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 個清單巢狀層級的 DISC 、CIRCLE 和 SQUARE 項目符號。 |
BULLET_DIAMONDX_ARROW3D_SQUARE
|
一份清單,內含前 3 個清單巢狀層級的 DIAMONDX 、ARROW3D 和 SQUARE 項目符號。 |
BULLET_CHECKBOX
|
加入項目符號清單,內含所有清單巢狀層級的 CHECKBOX 項目符號字符。 |
BULLET_ARROW_DIAMOND_DISC
|
一份清單,內含前 3 個清單巢狀層級的 ARROW 、DIAMOND 和 DISC 項目符號。 |
BULLET_STAR_CIRCLE_SQUARE
|
一份清單,內含前 3 個清單巢狀層級的 STAR 、CIRCLE 和 SQUARE 項目符號。 |
BULLET_ARROW3D_CIRCLE_SQUARE
|
一份清單,內含前 3 個清單巢狀層級的 ARROW3D 、CIRCLE 和 SQUARE 項目符號。 |
BULLET_LEFTTRIANGLE_DIAMOND_DISC
|
一份清單,內含前 3 個清單巢狀層級的 LEFTTRIANGLE 、DIAMOND 和 DISC 項目符號。 |
BULLET_DIAMONDX_HOLLOWDIAMOND_SQUARE
|
一份清單,內含前 3 個清單巢狀層級的 DIAMONDX 、HOLLOWDIAMOND 和 SQUARE 項目符號。 |
BULLET_DIAMOND_CIRCLE_SQUARE
|
一份清單,內含前 3 個清單巢狀層級的 DIAMOND 、CIRCLE 和 SQUARE 項目符號。 |
NUMBERED_DIGIT_ALPHA_ROMAN
|
前 3 個清單巢狀層級的編號為 DIGIT 、ALPHA 和 ROMAN 數字字符,後面接著半形句號。 |
NUMBERED_DIGIT_ALPHA_ROMAN_PARENS
|
包含前 3 個清單巢狀層級的 DIGIT 、ALPHA 和 ROMAN 數字字符,後面加上括號。 |
NUMBERED_DIGIT_NESTED
|
在這個編號清單中,包含 DIGIT 數字字符,並以半形句號分隔,每個巢狀層級層級都會以前一個巢狀層級字符做為前置字串。例如:「1.」、「1.1」、「2.」、「2.2.」。
|
NUMBERED_UPPERALPHA_ALPHA_ROMAN
|
前 3 個清單巢狀層級的編號為 UPPERALPHA 、ALPHA 和 ROMAN 數字字符,後面接著半形句號。 |
NUMBERED_UPPERROMAN_UPPERALPHA_DIGIT
|
前 3 個清單巢狀層級的編號為 UPPERROMAN 、UPPERALPHA 和 DIGIT 數字字符,後面接著半形句號。 |
NUMBERED_ZERODIGIT_ALPHA_ROMAN
|
前 3 個清單巢狀層級的編號為 ZERODIGIT 、ALPHA 和 ROMAN 數字字符,後面接著半形句號。 |
取代 AllShapesWithImageRequest
將與指定圖片相符的所有形狀替換成提供的圖片。
取代使用形狀的圖片在插入簡報後是矩形,而不是採用形狀的形式。
JSON 表示法 |
---|
{ "replaceMethod": enum ( |
欄位 | |
---|---|
replaceMethod
|
取代方法。
已淘汰
:請改用
如果您同時指定 |
imageReplaceMethod
|
圖片取代方法。
如果您同時指定
如果您沒有為 如未指定,系統會使用 CENTER_INSIDE。 |
pageObjectIds[]
|
如果不是空白,將限制為僅比對特定網頁的內容元素。
如果 |
聯集欄位 criteria 。形狀必須符合的條件才會取代。criteria 只能是下列其中一個值: |
|
containsText
|
設定後,此要求會取代所有包含指定文字的形狀。 |
聯集欄位 image_source 。圖片來源的種類。image_source 只能是下列其中一個值: |
|
imageUrl
|
圖片網址。 系統會在插入時間擷取一次圖片,另一份副本會顯示在簡報中。圖片大小必須小於 50 MB,大小不得超過 2500 萬像素,且必須是 PNG、JPEG 或 GIF 格式。
提供的網址長度上限為 2 KB。網址本身會與映像檔一併儲存,並透過 |
取代方法
取代方法。
列舉 | |
---|---|
CENTER_INSIDE
|
縮放圖片,並配合原始形狀的邊界設定圖片尺寸,並維持圖片的顯示比例。圖片的顯示大小可能會小於形狀的大小。如果未指定,此為預設方法。 |
CENTER_CROP
|
縮放圖片並置中,填滿原始形狀的邊界。系統可能會裁剪圖片,以填滿形狀。圖片的顯示大小會與原始形狀相同。 |
ImageReplaceMethod
圖片取代方法。
列舉 | |
---|---|
IMAGE_REPLACE_METHOD_UNSPECIFIED
|
未指定的圖片取代方法。這個值不可使用。 |
CENTER_INSIDE
|
縮放圖片,並配合原始形狀的邊界設定圖片尺寸,並維持圖片的顯示比例。圖片的顯示大小可能會小於形狀的大小。如果未指定,此為預設方法。 |
CENTER_CROP
|
縮放圖片並置中,填滿原始形狀的邊界。系統可能會裁剪圖片,以填滿形狀。圖片的顯示大小會與原始形狀相同。 |
DuplicateObjectRequest
複製投影片或頁面元素。
複製投影片時,系統會在指定投影片後立即建立重複的投影片。複製網頁元素時,重複的網頁會置於與原始網頁相同的位置。
JSON 表示法 |
---|
{ "objectId": string, "objectIds": { string: string, ... } } |
欄位 | |
---|---|
objectId
|
要複製的物件 ID。 |
objectIds
|
複製的物件可能會包含其他物件,例如複製投影片或群組頁面元素。這張對應會定義複製物件 ID 的產生方式:索引鍵是原始物件的 ID,其值是指派給對應重複物件的 ID。這張地圖也可以包含來源物件的重複 ID,方法是將
簡報中的所有 ID 都必須對應至簡報中現有的 ID。簡報中的所有值均不得重複,且開頭必須為英數字元或底線 (與規則運算式 如果地圖中缺少任何來源物件 ID,系統會指派新的隨機 ID。如果地圖為空白或未設定,所有重複物件都會收到新的隨機 ID。 |
UpdateTextStyleRequest
JSON 表示法 |
---|
{ "objectId": string, "cellLocation": { object ( |
欄位 | |
---|---|
objectId
|
含有文字樣式的形狀或表格物件 ID。 |
cellLocation
|
表格中儲存格內的文字樣式。如果 |
style
|
設定文字的樣式。 如果特定樣式的值與父項相符,該樣式就會設為沿用。
某些文字樣式變更可能導致其他設定與簡報編輯器的行為一致。詳情請參閱 |
textRange
|
要設定樣式的文字範圍。 系統可能會擴大範圍,納入鄰近的換行符號。 如果範圍完全包含清單的段落,段落的項目符號也會更新為相符的文字樣式。 |
fields
|
需要更新的欄位。
至少須指定一個欄位。根
舉例來說,如要將文字樣式更新為粗體,請將 如要將屬性重設為預設值,請在欄位遮罩中加入欄位名稱,但不要變更欄位本身。 |
ReplaceAllShapesWithSheetsChartRequest
將符合指定條件的圖形替換成提供的 Google 試算表圖表。圖表將縮放及置中,以符合原始形狀的邊界。
注意:使用圖表取代圖形時,必須使用至少一個試算表.readonly、試算表、drive.readonly 或雲端硬碟 OAuth 範圍。
JSON 表示法 |
---|
{ "containsText": { object ( |
欄位 | |
---|---|
containsText
|
形狀必須符合的條件才會取代。要求會取代所有包含指定文字的形狀。 |
spreadsheetId
|
內含圖表的 Google 試算表 ID。 |
chartId
|
Google 試算表中的特定圖表 ID。 |
linkingMode
|
連結到來源試算表的模式。如未指定,圖表就會是未連結的圖片。 |
pageObjectIds[]
|
如果不是空白,將限制為僅比對特定網頁的內容元素。
如果 |
LinkMode
將圖表連結至來源試算表的模式。
列舉 | |
---|---|
NOT_LINKED_IMAGE
|
圖表與來源試算表無關,因此無法更新。未連結的圖表會插入為圖片。 |
LINKED
|
連結圖表後,系統就會更新圖表,其他協作者則會看到試算表的連結。 |
DeleteParagraphBulletRequest
從與指定文字索引 range
重疊的所有段落中刪除項目符號。
在每個段落的開頭加上縮排,即可保留各段落的巢狀層級。
JSON 表示法 |
---|
{ "objectId": string, "cellLocation": { object ( |
欄位 | |
---|---|
objectId
|
形狀或表格的物件 ID (含有刪除項目符號的文字)。 |
cellLocation
|
如果要修改的文字位於表格儲存格中,可視需要使用表格儲存格位置。如果有,objectId 必須參照一個資料表。 |
textRange
|
根據 |
UpdateParagraphStyleRequest
JSON 表示法 |
---|
{ "objectId": string, "cellLocation": { object ( |
欄位 | |
---|---|
objectId
|
含有文字樣式的形狀或表格物件 ID。 |
cellLocation
|
表格中儲存格所在樣式的樣式。如果 |
style
|
段落的樣式。 |
textRange
|
包含段落的樣式文字範圍。 |
fields
|
需要更新的欄位。
至少須指定一個欄位。根
舉例來說,如要更新段落對齊,請將 如要將屬性重設為預設值,請在欄位遮罩中加入欄位名稱,但不要變更欄位本身。 |
UpdateTableBorderPropertiesRequest
更新 Table
中的表格框線屬性。
JSON 表示法 |
---|
{ "objectId": string, "tableRange": { object ( |
欄位 | |
---|---|
objectId
|
資料表的物件 ID。 |
tableRange
|
表格更新所套用的表格子集。如未指定資料表範圍,您所做的變更會套用至整個資料表。 |
borderPosition
|
要套用更新的表格範圍邊框。如未指定邊框位置,更新內容將套用至表格範圍中的所有邊框。 |
tableBorderProperties
|
要更新的表格邊框屬性。 |
fields
|
需要更新的欄位。
至少須指定一個欄位。根
舉例來說,如要更新表格邊框填滿顏色,請將 如要將屬性重設為預設值,請在欄位遮罩中加入欄位名稱,但不要變更欄位本身。 |
BorderPosition
表格邊框位置。
列舉 | |
---|---|
ALL
|
範圍內所有邊框。 |
BOTTOM
|
範圍底部的框線。 |
INNER
|
範圍內部的邊框。 |
INNER_HORIZONTAL
|
超出範圍的水平框線。 |
INNER_VERTICAL
|
範圍內部的垂直框線。 |
LEFT
|
範圍左側的框線。 |
OUTER
|
位於範圍外的框線。 |
RIGHT
|
範圍右側的框線。 |
TOP
|
範圍頂端框線。 |
UpdateTableColumnPropertiesRequest
更新 Table
欄的屬性。
JSON 表示法 |
---|
{
"objectId": string,
"columnIndices": [
integer
],
"tableColumnProperties": {
object (
|
欄位 | |
---|---|
objectId
|
資料表的物件 ID。 |
columnIndices[]
|
以零為基礎的索引清單,指定要更新的資料欄。如未提供索引,表格中的所有資料欄都會更新。 |
tableColumnProperties
|
要更新的資料表欄屬性。
如果要求中的 |
fields
|
需要更新的欄位。
至少須指定一個欄位。根
舉例來說,如要更新資料欄寬度,請將 如果在欄位遮罩中加入「columnWidth」,但屬性未設定,則欄寬度會預設為 406,400 EMU (32 分)。 |
UpdateTableRowPropertiesRequest
更新 Table
列的屬性。
JSON 表示法 |
---|
{
"objectId": string,
"rowIndices": [
integer
],
"tableRowProperties": {
object (
|
欄位 | |
---|---|
objectId
|
資料表的物件 ID。 |
rowIndices[]
|
以零為基礎的索引清單,指定要更新哪些資料列。如未提供索引,系統將更新表格中的所有資料列。 |
tableRowProperties
|
要更新的資料表列屬性。 |
fields
|
需要更新的欄位。
至少須指定一個欄位。根
舉例來說,如要更新列高下限,請將 如果欄位遮罩中包含「minRowHeight」但未設定屬性,則資料列下限會預設為 0。 |
MergeTableCellsRequest
合併 Table
中的儲存格。
JSON 表示法 |
---|
{
"objectId": string,
"tableRange": {
object (
|
欄位 | |
---|---|
objectId
|
資料表的物件 ID。 |
tableRange
|
表格範圍,用於指定要合併的資料表。 系統會將合併儲存格中的所有文字串連在一起,並將其儲存在範圍的左上角 (「head」) 儲存格中。如果該範圍不是矩形 (當範圍涵蓋已合併的儲存格時),就會傳回 400 要求錯誤。 |
取消合併儲存格儲存格
取消合併 Table
中的儲存格。
JSON 表示法 |
---|
{
"objectId": string,
"tableRange": {
object (
|
欄位 | |
---|---|
objectId
|
資料表的物件 ID。 |
tableRange
|
表格範圍,用於指定要取消合併的資料表。 這個範圍中的所有合併儲存格都將取消合併,而未合併的儲存格不會受到影響。如果範圍沒有合併的儲存格,則要求不會有任何動作。如果任何合併儲存格內有任何文字,文字將保留未合併儲存格的左上方 (「head」) 儲存格。 |
GroupObjectsRequest
建立物件群組以建立物件群組。例如,將 PageElements
分組,即可在與所有子項相同的頁面上建立 Group
。
JSON 表示法 |
---|
{ "groupObjectId": string, "childrenObjectIds": [ string ] } |
欄位 | |
---|---|
groupObjectId
|
要建立群組的使用者提供的物件 ID。
如果您指定某個 ID,在簡報中所有頁面和網頁元素中都不得重複。ID 的開頭必須是英數字元或底線 (與規則運算式 如未指定 ID,系統會產生專屬 ID。 |
childrenObjectIds[]
|
要分組的物件物件 ID。
只有網頁元素可以分組。同一個網頁上至少要有兩個網頁元素,而這些元素並未加入其他群組。某些網頁元素 (例如 |
UngroupObjectsRequest
將物件取消分組,例如 groups
。
JSON 表示法 |
---|
{ "objectIds": [ string ] } |
欄位 | |
---|---|
objectIds[]
|
要取消分組的物件 ID。
只能將不屬於其他 |
UpdatePageElementAltTextRequest
更新 page element
的替代文字標題和/或說明。
JSON 表示法 |
---|
{ "objectId": string, "title": string, "description": string } |
欄位 | |
---|---|
objectId
|
要套用更新的網頁元素物件 ID。 |
title
|
更新後的頁面元素替代文字標題。如未設定,系統會保留現有的值。標題會經由螢幕閱讀器和其他無障礙功能介面顯示。僅使用與網頁元素內容相關的使用者可理解值。 |
description
|
更新後的頁面元素替代文字說明。如未設定,系統會保留現有的值。會向螢幕閱讀器和其他無障礙介面的使用者顯示說明。僅使用與網頁元素內容相關的使用者可理解值。 |
取代圖片要求
使用新圖片取代現有圖片。
取代圖片會從現有圖片中移除部分 image effects
。
JSON 表示法 |
---|
{ "imageObjectId": string, "imageReplaceMethod": enum ( |
欄位 | |
---|---|
imageObjectId
|
要取代的現有圖片 ID。您可以從 get 要求的回應中擷取這個 ID。 |
imageReplaceMethod
|
替換方法。 |
聯集欄位 image_source 。圖片來源的種類。image_source 只能是下列其中一個值: |
|
url
|
圖片網址。 系統會在插入時間擷取一次圖片,另一份副本會顯示在簡報中。圖片大小必須小於 50 MB,檔案大小不得超過 2500 萬像素,且為 PNG、JPEG 或 GIF 格式。
您提供的網址長度不得超過 2 KB。網址會隨圖片一起儲存,並透過 |
UpdateSlidePropertiesRequest
更新投影片的屬性。
JSON 表示法 |
---|
{
"objectId": string,
"slideProperties": {
object (
|
欄位 | |
---|---|
objectId
|
要套用更新的投影片的物件 ID。 |
slideProperties
|
要更新的投影片屬性。 |
fields
|
需要更新的欄位。
至少須指定一個欄位。根「slideProperties」已暗示使用,不應指定。單一
舉例來說,如要更新投影片是否略過,請將 如要將屬性重設為預設值,請在欄位遮罩中加入欄位名稱,但不要變更欄位本身。 |
UpdatePageElementsZOrderRequest
更新網頁元素的 Z 順序。Z-order 是指網頁上的元素在後置順序。正面的頁面元素可能會涵蓋背後的要素。
JSON 表示法 |
---|
{
"pageElementObjectIds": [
string
],
"operation": enum (
|
欄位 | |
---|---|
pageElementObjectIds[]
|
要更新的網頁元素物件 ID。 所有網頁元素都必須位於同一個網頁上,且不得分組。 |
operation
|
要套用至網頁元素的 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 (
|
欄位 | |
---|---|
objectId
|
要套用更新內容的行物件 ID。
只有包含 更新類別後即可重新轉送路線。 |
lineCategory
|
要更新的行類別。
確切的 |
RerouteLineRequest
重新轉送 line
,使其連線到已連結網頁元素的兩個最近連線網站。
JSON 表示法 |
---|
{ "objectId": string } |
欄位 | |
---|---|
objectId
|
要重新轉送的線的物件 ID。
只有包含 |