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

updateLineCategory

object (UpdateLineCategoryRequest)

更新 line

rerouteLine

object (RerouteLineRequest)

重新路由 line 使其在连接的网页元素上两个最近的连接站点处关联。

CreateSlideRequest

创建幻灯片。

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

string

用户提供的对象 ID。

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

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

insertionIndex

integer

可选的从零开始的索引,指示幻灯片的插入位置。

如果未指定索引,系统将在结束时创建幻灯片。

slideLayoutReference

object (LayoutReference)

要插入的幻灯片的布局参考,基于 当前主实例,应为以下项之一:

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

如果在当前主实例中找不到 LayoutReference,系统会返回 400 bad request 错误。

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

placeholderIdMappings[]

object (LayoutPlaceholderIdMapping)

placeholder (s) 添加到在幻灯片上创建的从指定布局创建的占位符。只能在以下情况下使用: slideLayoutReference

LayoutReference

幻灯片布局参考。这可能引用:

  • 预定义布局
  • 演示文稿中的布局之一。
JSON 表示法
{

  // Union field kind can be only one of the following:
  "predefinedLayout": enum (PredefinedLayout),
  "layoutId": string
  // End of list of possible types for union field kind.
}
田野
联合字段 kind。LayoutReference 的类型。 kind 只能是下列其中一项:
predefinedLayout

enum (PredefinedLayout)

预定义的布局。

layoutId

string

布局 ID:演示文稿中某个布局的对象 ID。

PredefinedLayout

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

枚举
PREDEFINED_LAYOUT_UNSPECIFIED 未指定布局。
BLANK 空白布局,无占位符。
CAPTION_ONLY 底部带有图片说明的布局。
TITLE 包含标题和副标题的布局。
TITLE_AND_BODY 包含标题和正文的布局。
TITLE_AND_TWO_COLUMNS 包含标题和 2 列的布局。
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 的 BODY 占位符。

layoutPlaceholderObjectId

string

布局上将应用到幻灯片的占位符的对象 ID。

CreateShapeRequest

创建新的形状。

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

string

用户提供的对象 ID。

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

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 个。

InsertTableColumnsRequest

在表中插入列。

系统会调整表格中其他列的大小,以适应新列的大小。

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

string

要向其插入列的表格。

cellLocation

object (TableCellLocation)

要插入列的参考表格单元格位置。

系统会在引用单元格所在列的左侧(或右侧)插入一个新列。如果引用单元格是合并单元格,系统会在合并单元格的左侧(或右侧)插入一个新列。

insertRight

boolean

是否在引用单元格位置的右侧插入新列。

  • True :插入右侧。
  • False :插入左侧。
number

integer

要插入的列数。每个请求最多 20 个。

DeleteTableRowRequest

从表中删除行。

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

string

要从中删除行的表。

cellLocation

object (TableCellLocation)

要从中删除行的参考表格单元格位置。

此单元格跨越的行将被删除。如果这是一个合并单元格,多行将被删除。如果在执行此删除操作后表中没有保留的行,则整个表都将被删除。

DeleteTableColumnRequest

从表中删除列。

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

string

要从中删除列的表。

cellLocation

object (TableCellLocation)

要删除引用表单元格的位置。

此单元格跨越的列将被删除。如果这是一个合并单元格,多列将被删除。如果在执行此删除操作后,表中没有保留的列,则整个表都会被删除。

ReplaceAllTextRequest

将符合某个条件的所有文本实例替换为 replace text

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

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

string

将用于替换匹配文本的文本。

pageObjectIds[]

string

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

如果给定了某网页对象的 ID, notes master,或者演示文稿中不存在具有该对象 ID 的页面。

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

object (SubstringMatchCriteria)

在形状中查找与此子字符串匹配的文本。

SubstringMatchCriteria

与形状或表格中的特定文本字符串匹配的条件。

JSON 表示法
{
  "text": string,
  "matchCase": boolean
}
田野
text

string

要在形状或表格中搜索的文本。

matchCase

boolean

指示搜索是否应遵循大小写:

  • True :搜索区分大小写。
  • False :搜索不区分大小写。

DeleteObjectRequest

删除对象 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 3 表示 textRange.end_index

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

仅包含代理对中一个代码单元的范围会扩展,以包含两个代码单元。

续航里程

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

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 必须以字母数字字符或下划线开头(与正则表达式匹配) [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

此视频的视频来源唯一标识符。

例如适用于 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 表格图表。

注意:创建图表至少需要其中一个 spreadsheets.readonly、spreadsheets、drive.readonly、drive.file 或 云端硬盘 OAuth 范围。

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

string

用户提供的对象 ID。

如果已指定,则该 ID 在演示文稿的所有页面和页面元素中必须是唯一的。ID 应以文字字符 [a-zA-Z0-9_] 开头,后跟任意数量的以下字符 [a-zA-Z0-9_-:]。ID 的长度应小于 5 或大于 50。如果留空,系统会生成一个唯一标识符。

elementProperties

object (PageElementProperties)

图表的元素属性。

如果所提供尺寸的宽高比与图表宽高比不匹配,则图表将相对于该尺寸进行缩放和居中,以保持宽高比。所提供的转换将在此操作之后应用。

spreadsheetId

string

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

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

chartId

integer

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

linkingMode

enum (LinkingMode)

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

LinkingMode

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

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

CreateLineRequest

创建线条。

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

string

用户提供的对象 ID。

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

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

elementProperties

object (PageElementProperties)

线条的元素属性。

lineCategory
(deprecated)

enum (Category)

要创建的线条的类别。

<ph type="x-smartling-placeholder"></ph> 已弃用 :使用 category

确切的 line type 取决于类别及其如何连接到其他页面元素。

如果您同时指定 categorylineCategorycategory 优先级。

category

enum (LineCategory)

要创建的线条的类别。

确切的 line type 取决于类别及其如何连接到其他页面元素。

如果您同时指定 categorylineCategorycategory 优先级。

如果没有为 category,但要指定 lineCategory,则指定的 lineCategory 值。

如果您未指定任一项,则 STRAIGHT

类别

线条类别。

<ph type="x-smartling-placeholder">

枚举
STRAIGHT 直型连接器,包括直型连接器 1.如果未指定类别,则为默认类别。
BENT 弯曲连接器,包括弯曲的连接器 2 到 5。
CURVED 曲线连接符,包括曲线连接符 2 到 5。

RefreshSheetsChartRequest

将嵌入的 Google 表格图表替换为 Google 表格中的最新图表版本,从而刷新该图表。

注意:刷新图表至少需要一个 spreadsheets.readonly、spreadsheets、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 的表格,其中最后一行的所有单元格都合并在一起。表格如下所示:

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

位置 = (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

表格范围的列跨度。

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 :单个数字以零为前缀的数字,例如“01”、“02”或“03”。多位数的数字不加前缀 0。
  • ROMAN :小写罗马数字,如“i”、“ii”或“iii”。
  • UPPERROMAN :大写罗马数字,如“I”、“II”或“III”。
  • LEFTTRIANGLE :指向左边的三角形,对应 Unicode U+25c4 代码点
枚举
BULLET_DISC_CIRCLE_SQUARE 带有 DISC, CIRCLESQUARE 前 3 个列表嵌套级别的项目符号。
BULLET_DIAMONDX_ARROW3D_SQUARE 带有 DIAMONDX, ARROW3DSQUARE 前 3 个列表嵌套级别的项目符号。
BULLET_CHECKBOX 项目符号列表 CHECKBOX 所有列表嵌套级别的项目符号符号。
BULLET_ARROW_DIAMOND_DISC 带有 ARROW, DIAMONDDISC 前 3 个列表嵌套级别的项目符号。
BULLET_STAR_CIRCLE_SQUARE 带有 STAR, CIRCLESQUARE 前 3 个列表嵌套级别的项目符号。
BULLET_ARROW3D_CIRCLE_SQUARE 带有 ARROW3D, CIRCLESQUARE 前 3 个列表嵌套级别的项目符号。
BULLET_LEFTTRIANGLE_DIAMOND_DISC 带有 LEFTTRIANGLE, DIAMONDDISC 前 3 个列表嵌套级别的项目符号。
BULLET_DIAMONDX_HOLLOWDIAMOND_SQUARE 带有 DIAMONDX, HOLLOWDIAMONDSQUARE 前 3 个列表嵌套级别的项目符号。
BULLET_DIAMOND_CIRCLE_SQUARE 带有 DIAMOND, CIRCLESQUARE 前 3 个列表嵌套级别的项目符号。
NUMBERED_DIGIT_ALPHA_ROMAN 编号列表 DIGIT, ALPHAROMAN 前 3 个列表嵌套级别的数字字形,后跟英文句点。
NUMBERED_DIGIT_ALPHA_ROMAN_PARENS 编号列表 DIGIT, ALPHAROMAN 前 3 个列表嵌套级别的数字字形,后跟圆括号。
NUMBERED_DIGIT_NESTED 编号列表 DIGIT 以英文句点分隔的数字字形,其中每个嵌套级别都使用前一个嵌套级别的字形作为前缀。例如:“1.”。“1.1.”“2.”、“2.2.”。
NUMBERED_UPPERALPHA_ALPHA_ROMAN 编号列表 UPPERALPHA, ALPHAROMAN 前 3 个列表嵌套级别的数字字形,后跟英文句点。
NUMBERED_UPPERROMAN_UPPERALPHA_DIGIT 编号列表 UPPERROMAN, UPPERALPHADIGIT 前 3 个列表嵌套级别的数字字形,后跟英文句点。
NUMBERED_ZERODIGIT_ALPHA_ROMAN 编号列表 ZERODIGIT, ALPHAROMAN 前 3 个列表嵌套级别的数字字形,后跟英文句点。

ReplaceAllShapesWithImageRequest

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

替换形状的图片在插入演示文稿后是矩形,且未采用形状。

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

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

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

enum (ReplaceMethod)

替换方法。

<ph type="x-smartling-placeholder"></ph> 已弃用 :使用 imageReplaceMethod

如果您同时指定 replaceMethodimageReplaceMethodimageReplaceMethod 优先级。

imageReplaceMethod

enum (ImageReplaceMethod)

图片替换方法。

如果您同时指定 replaceMethodimageReplaceMethodimageReplaceMethod 优先级。

如果没有为 imageReplaceMethod,但要指定 replaceMethod,则指定的 replaceMethod 值。

如果两者都未指定,则系统会使用 CENTER_INSIDE。

pageObjectIds[]

string

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

如果给定了某网页对象的 ID, notes pagenotes master,或者如果演示文稿中不存在具有该对象 ID 的页面,则会发生该错误。

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

object (SubstringMatchCriteria)

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

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

string

图片网址。

在插入时,系统会提取一次图片,并存储副本以便在演示文稿中显示。图片必须小于 50MB,不能超过 2500 万像素,并且必须是 PNG、JPEG 或 GIF 格式之一。

提供的网址不得超过 2 kB。网址本身会与图片一起保存,并通过 Image.source_url 字段。

ReplaceMethod

替换方法。

<ph type="x-smartling-placeholder">

枚举
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。也可以使用 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"

要将属性重置为默认值,请在字段掩码中添加其字段名称,但不设置字段本身。

ReplaceAllShapesWithSheetsChartRequest

将符合指定条件的所有形状替换为提供的 Google 表格图表。该图表会进行缩放并居中,以符合原始形状的边界。

注意:要将形状替换为图表,至少需要满足以下条件之一:spreadsheets.readonly、spreadsheets、drive.readonly 或 drive OAuth 范围。

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

object (SubstringMatchCriteria)

形状必须匹配才能被替换的条件。该请求将替换所有包含给定文本的形状。

spreadsheetId

string

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

chartId

integer

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

linkingMode

enum (LinkingMode)

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

pageObjectIds[]

string

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

如果给定了某网页对象的 ID, notes pagenotes master,或者如果演示文稿中不存在具有该对象 ID 的页面,则会发生该错误。

LinkingMode

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

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

DeleteParagraphBulletsRequest

从与指定文本索引重叠的所有段落中删除项目符号 range

系统会在相应段落的开头添加缩进,从而直观地保留每个段落的嵌套级别。

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

string

包含要从中删除项目符号的文本的形状或表格的对象 ID。

cellLocation

object (TableCellLocation)

要修改的文本位于表格单元格中,则为可选表格单元格位置。如果存在,objectId 必须引用表。

textRange

object (Range)

要删除项目符号的文本范围,依据为 TextElement 索引。

UpdateParagraphStyleRequest

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

表格范围,用于指定要合并的表格中的哪些单元格。

要合并的单元格中的任何文本都会串联起来,并存储在相应范围的左上角(“头”)单元格。如果范围是非矩形(在某些情况下可能会包含已合并的单元格,就会出现这种情况),系统会返回 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 必须以字母数字字符或下划线开头(与正则表达式匹配) [a-zA-Z0-9_]);其余字符可包括连字符或冒号(与正则表达式匹配) [a-zA-Z0-9_-:])。ID 的长度不得小于 5 或大于 50。

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

childrenObjectIds[]

string

要分组的对象的对象 ID。

只能对页面元素进行分组。同一网页上至少应有两个尚未加入其他组的页面元素。某些页面元素,例如 videos, tablesplaceholders 无法分组。

UngroupObjectsRequest

取消分组对象,例如 groups

JSON 表示法
{
  "objectIds": [
    string
  ]
}
田野
objectIds[]

string

要取消分组的对象的 ID。

仅限 groups 其他公司 groups 可以取消分组所有组应在同一页面上。该群组本身会被删除。所有子级的视觉尺寸和位置都会保留下来。

UpdatePageElementAltTextRequest

更新 page element

JSON 表示法
{
  "objectId": string,
  "title": string,
  "description": string
}
田野
objectId

string

要应用更新的页面元素的对象 ID。

title

string

已更新页面元素的替代文本标题。如果此政策未设置,现有值将会保留。标题会提供给屏幕阅读器和其他无障碍界面使用。仅使用与页面元素的内容相关的人类可读值。

description

string

已更新页面元素的替代文本说明。如果此政策未设置,现有值将会保留。此说明会向屏幕阅读器和其他无障碍界面公开。仅使用与页面元素的内容相关的人类可读值。

ReplaceImageRequest

使用新图片替换现有图片。

替换图片会移除一些 image effects 提取现有映像

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

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

string

要替换的现有图片的 ID。该 ID 可从 get 请求的响应中检索到。

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"

要将属性重置为默认值,请在字段掩码中添加其字段名称,但不设置字段本身。

UpdatePageElementsZOrderRequest

更新页面元素的 Z 顺序。Z 轴顺序是页面上元素从后到前的顺序。前面的页面元素可能会覆盖其后面的元素。

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

string

要更新的页面元素的对象 ID。

所有页面元素必须位于同一页面上,且不能分为一组。

operation

enum (ZOrderOperation)

要应用于页面元素的 Z 顺序操作。

对多个页面元素应用操作时,在操作之前,这些页面元素内的相对 Z 轴顺序保持不变。

ZOrderOperation

更新页面元素的 Z 轴顺序的操作。

枚举
Z_ORDER_OPERATION_UNSPECIFIED 未指定的操作。
BRING_TO_FRONT 将页面元素置于页面开头。
BRING_FORWARD 将网页上的页面元素向前移动一个元素(相对于指定页面元素中最靠前的元素)。
SEND_BACKWARD 将页面上的页面元素向后发送一个元素(相对于指定页面元素中最落后一个元素的一个元素)。
SEND_TO_BACK 将页面元素发送到页面后部。

UpdateLineCategoryRequest

更新 line

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

string

应用更新行的对象 ID。

只有包含 category 表示它是“连接器”可以更新。

更新该线路的类别后,可以重新规划线路。

lineCategory

enum (LineCategory)

要更新到的线条类别。

确切的 line type 取决于要更新的类别,以及相应页面如何以路由方式连接到其他页面元素。

RerouteLineRequest

重新路由 line 使其在连接的网页元素上两个最近的连接站点处关联。

JSON 表示法
{
  "objectId": string
}
田野
objectId

string

要重新规划的路线的对象 ID。

只有包含 category 表示它是“连接器”可以重新路由线条的起点和终点连接必须位于不同的页面元素上。