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,使其在连接页面元素上的两个最近连接点处进行连接。

CreateSlideRequest 字段

创建幻灯片。

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

string

用户提供的对象 ID。

如果您指定了 ID,则该 ID 在演示文稿的所有页面和页面元素中必须是唯一的。ID 必须以字母数字字符或下划线(与正则表达式 [a-zA-Z0-9_] 匹配)开头;其余字符可以包含这些字符以及连字符或冒号(与正则表达式 [a-zA-Z0-9_-:] 匹配)。ID 长度必须介于 5 到 50 个字符之间(含 5 和 50)。

如果您未指定 ID,系统会生成唯一的 ID。

insertionIndex

integer

可选的零索引,用于指示插入幻灯片的位置。

如果您未指定索引,则系统会在结尾创建幻灯片。

slideLayoutReference

object (LayoutReference)

要根据当前母版(将为以下项之一)插入的幻灯片的布局引用:

  • 上一张幻灯片索引的母版。
  • 第一张幻灯片的母版(如果 insertIndex 为零)。
  • 演示文稿中的第一个母版(如果没有幻灯片)。

如果在当前主组件中找不到 LayoutReference,会返回 400 错误请求错误。

如果您未指定布局引用,则幻灯片将使用预定义的 BLANK 布局。

placeholderIdMappings[]

object (LayoutPlaceholderIdMapping)

(可选)从布局上的 placeholder 映射到幻灯片上从指定布局创建的对象 ID 的列表。只有在指定了 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。

预定义的布局

预定义的布局类型。这些都是演示文稿中的常见布局。不过,无法保证这些布局存在于当前母版中,因为它们可能已被删除或不属于所用主题。此外,每个布局上的占位符可能已更改。

枚举
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

用户将根据指定布局在幻灯片上创建的占位符(由用户指定)。

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 在演示文稿的所有页面和页面元素中必须是唯一的。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 的 Body 占位符。

layoutPlaceholderObjectId

string

布局中将应用于幻灯片的布局的对象 ID。

CreateShapeRequest

创建新的形状。

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

string

用户提供的对象 ID。

如果您指定了 ID,则该 ID 在演示文稿的所有页面和页面元素中必须是唯一的。ID 必须以字母数字字符或下划线(与正则表达式 [a-zA-Z0-9_] 匹配)开头;其余字符可以包含这些字符以及连字符或冒号(与正则表达式 [a-zA-Z0-9_-:] 匹配)。ID 的长度不得小于 5 或大于 50。如果为空,系统会生成一个唯一标识符。

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 在演示文稿的所有页面和页面元素中必须是唯一的。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 字形聚类内插入。在这些情况下,文本将立即插入 Grapheme 集群之后。

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)

列将被删除的参考单元格位置。

此单元格所跨列会被删除。如果是合并的单元格,则将删除多列。如果此删除操作后表中不再存在任何列,则系统会删除整个表。

替换所有文本请求

将符合某个条件的所有文本实例替换为 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

如果非空,则仅匹配指定页面上的页面元素。

如果指定了 notes master 的网页对象 ID,或者演示文稿中不存在具有该对象 ID 的网页,则返回 400 错误请求错误。

联合字段 criteria。用于匹配要替换的文本的条件。 criteria 只能是下列其中一项:
containsText

object (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)

转换更新的应用模式。

ApplyMode

转换更新的应用模式。

枚举
APPLY_MODE_UNSPECIFIED 未指定模式。
RELATIVE 将新的 AffineTransform 矩阵应用于现有矩阵,并将现有矩阵替换为生成的串联。
ABSOLUTE 将现有的 AffineTransform 矩阵替换为新的矩阵。

UpdateSlidesPositionRequest

更新幻灯片在演示文稿中的位置。

JSON 表示法
{
  "slideObjectIds": [
    string
  ],
  "insertionIndex": integer
}
字段
slideObjectIds[]

string

演示文稿中应移动的幻灯片的 ID。此列表中的幻灯片必须按现有的演示顺序(不能重复)进行演示。

insertionIndex

integer

应插入幻灯片的索引,具体取决于移动发生之前幻灯片的排列方式。演示文稿中的幻灯片的个数必须在 0 到 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_index,最大值为 2;对于 textRange.end_index,最大值为 3。

删除跨越段落边界的文本可能会导致段落样式和列表在两个段落合并时发生变化。

将仅包含代理对的一个代码单元的范围扩展为包含这两个代码单元。

范围

指定已编入索引的集合的连续范围,例如文本中的字符。

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

integer

集合开始处的可选索引(从零开始)。对于 FIXED_RANGEFROM_START_INDEX 范围是必需的。

endIndex

integer

集合末尾的可选索引(从零开始)。FIXED_RANGE 个范围是必需的。

type

enum (Type)

范围类型。

类型

范围类型。

枚举
RANGE_TYPE_UNSPECIFIED 未指定范围类型。不得使用此值。
FIXED_RANGE 固定范围。必须指定 startIndexendIndex
FROM_START_INDEX startIndex 开始,持续到集合结束。不得指定 endIndex
ALL 将范围设置为集合的整个长度。不得同时指定 startIndexendIndex

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 在演示文稿的所有页面和页面元素中必须是唯一的。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.readonly 或 drive.file OAuth 范围。

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

string

用户提供的对象 ID。

如果您指定了 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

此视频的唯一标识符。

例如,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 表格图表。

注意:若要创建图表,至少需要 spreadsheet.readonly、spreadsheets、drive.readonly、drive.file 或 drive OAuth scope 中的一个。

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。如果为空,系统会生成一个唯一标识符。

elementProperties

object (PageElementProperties)

图表的元素属性。

当提供的尺寸的宽高比与图表的宽高比不一致时,图表会根据尺寸进行缩放和居中,以保持宽高比不变。执行此操作后,系统将应用所提供的转换。

spreadsheetId

string

包含图表的 Google 表格电子表格的 ID。

您可能需要向部分旧文件的 HTTP 标头添加资源密钥。如需了解详情,请参阅使用资源键访问链接共享的文件

chartId

integer

Google 表格中电子表格中特定图表的 ID。

linkingMode

enum (LinkingMode)

将图表关联到源电子表格的模式。如果未指定图表,图表将会是未链接的图片。

关联模式

将图表关联到源电子表格的模式。

枚举
NOT_LINKED_IMAGE 该图表未与源电子表格关联,因此无法更新。未关联的图表会作为图片插入。
LINKED 关联图表后,该图表即可更新,其他协作者将会看到指向电子表格的链接。

CreateLineRequest

创建一条线。

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

string

用户提供的对象 ID。

如果您指定了 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 表格的图表。

注意:刷新图表至少需要 spreadsheet.readonly、spreadsheets、drive.readonly 或 drive OAuth scope 中的一个。

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"

如需将属性重置为默认值,请在字段掩码中包含其字段名称,但请勿设置字段本身。

表范围

表范围表示对表的子集的引用。

请务必注意,表格范围指定的单元格不一定会形成矩形。例如,假设我们有一个 3 x 3 的表格,其中最后一行的所有单元格都合并在一起。该表如下所示:

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

包含位置 (0, 0)、行 span = 3 且列 span = 2 的表格范围指定以下单元格:

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

object (TableCellLocation)

表范围的起始位置。

rowSpan

integer

表范围的行跨度。

columnSpan

integer

表范围的列 span。

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

创建与指定文本索引范围重叠的所有段落的项目符号。

通过计算每个段落前面的制表符来确定每个段落的嵌套级别。为避免出现项目符号和相应段落之间的多余空格,该请求会移除这些前导标签页。这可能会更改文本各个部分的索引。

如果正在更新段落之前的段落位于具有匹配预设的列表中,则系统会将要更新的段落添加到上一个列表中。

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 数字,以 0 为前缀的数字,例如“01”“02”或“03”。位数超过 1 个的数字的前缀不是 0。
  • 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 数字字形,后跟句点。

AltAllShapesWithImageRequest

将符合指定条件的所有形状替换为提供的图片。

插入到演示文稿中后,替换形状的图片为矩形,且不会采用形状。

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,或者演示文稿中不存在具有该对象 ID 的网页,则返回 400 bad 请求错误。

联合字段 criteria。形状必须匹配才能被替换的条件。 criteria 只能是下列其中一项:
containsText

object (SubstringMatchCriteria)

如果设置此标记,此请求将替换包含给定文本的所有形状。

联合字段 image_source。图片来源的类型。 image_source 只能是下列其中一项:
imageUrl

string

图片网址。

系统会在插入时获取图片一次,并存储副本以在演示文稿内显示。图片大小不得超过 50MB,且不得超过 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。演示文稿中的所有值都必须是唯一的,并且必须以字母数字字符或下划线开头(与正则表达式 [a-zA-Z0-9_] 匹配);剩余字符可以包含连字符或冒号(与正则表达式 [a-zA-Z0-9_-:] 匹配)。新 ID 的长度不能少于 5 个或大于 50。

如果地图中省略了源对象的任何 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"

如需将属性重置为默认值,请在字段掩码中包含其字段名称,但请勿设置字段本身。

AltAllShapesWithSheetsChartRequest

将提供的指定条件匹配的所有形状替换为提供的 Google 表格图表。系统会缩放图表,并将其居中置于原始形状的边界内。

注意:要将形状替换为图表,至少需要一个 spreadsheet.readonly、spreadsheets、drive.readonly 或 drive OAuth scope 中的一个。

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,或者演示文稿中不存在具有该对象 ID 的网页,则返回 400 bad 请求错误。

关联模式

将图表关联到源电子表格的模式。

枚举
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

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

如需将属性重置为默认值,请在字段掩码中包含其字段名称,但请勿设置字段本身。

边框位置

表格边框位置。

枚举
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”,但该属性处于未设置状态,则列宽将默认为 406400 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)

用于指定要取消合并的表格单元格的表范围。

此范围中的所有已合并单元格将被取消合并,尚未合并的单元格不会受到影响。如果范围内没有合并的单元格,则请求不执行任何操作。如有任何合并单元格内有文本,则相应文本将保留在转换后未合并单元格的左上角(“头部”)单元格中。

GroupObjectsRequest

对对象进行分组以创建对象组。例如,对 PageElements 进行分组以创建与所有子级相同的网页上的 Group

JSON 表示法
{
  "groupObjectId": string,
  "childrenObjectIds": [
    string
  ]
}
字段
groupObjectId

string

用户为要创建的群组提供的对象 ID。

如果您指定了 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。

只能将不在其他 groups 中的 groups 取消分组。所有群组都应位于同一页面上。已删除群组。系统会保留所有子级的视觉尺寸和位置。

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

图片网址。

系统会在插入时获取图片一次,并存储副本以在演示文稿内显示。图片必须小于 50MB,不能超过 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"

如需将属性重置为默认值,请在字段掩码中包含其字段名称,但请勿设置字段本身。

UpdatePageElementZOrderRequest

更新页面元素的 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(表示它是“连接器”)的行。线条的起始连接和结束连接必须位于不同的页面元素上。