Requests

使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

object (CreateSlideRequest)

创建新幻灯片。

object (CreateShapeRequest)

创建新形状。

object (CreateTableRequest)

创建一个新表。

object (InsertTextRequest)

在形状或表格单元格中插入文本。

object (InsertTableRowsRequest)

将行插入表中。

object (InsertTableColumnsRequest)

将列插入表中。

object (DeleteTableRowRequest)

从表中删除行。

object (DeleteTableColumnRequest)

从表中删除列。

object (ReplaceAllTextRequest)

替换指定文本的所有实例。

object (DeleteObjectRequest)

从演示文稿中删除页面或页面元素。

object (UpdatePageElementTransformRequest)

更新页面元素的转换。

object (UpdateSlidesPositionRequest)

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

object (DeleteTextRequest)

从形状或表格单元格中删除文本。

object (CreateImageRequest)

创建图片。

object (CreateVideoRequest)

创建视频。

object (CreateSheetsChartRequest)

创建嵌入式 Google 表格图表。

object (CreateLineRequest)

创建线条。

object (RefreshSheetsChartRequest)

刷新 Google 表格图表。

object (UpdateShapePropertiesRequest)

更新 Shape。

object (UpdateImagePropertiesRequest)

更新 Image。

object (UpdateVideoPropertiesRequest)

更新 Video。

object (UpdatePagePropertiesRequest)

更新 Page。

object (UpdateTableCellPropertiesRequest)

更新 TableCell 的属性。

object (UpdateLinePropertiesRequest)

更新 Line 的属性。

object (CreateParagraphBulletsRequest)

为段落创建项目符号。

object (ReplaceAllShapesWithImageRequest)

将与某些条件匹配的所有形状替换为图片。

object (DuplicateObjectRequest)

复制幻灯片或页面元素。

object (UpdateTextStyleRequest)

更新 Shape 或 Table。

object (ReplaceAllShapesWithSheetsChartRequest)

将符合某些条件的所有形状替换为 Google 表格图表。

object (DeleteParagraphBulletsRequest)

从段落中删除项目符号。

object (UpdateParagraphStyleRequest)

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

object (UpdateTableBorderPropertiesRequest)

更新 Table。

object (UpdateTableColumnPropertiesRequest)

更新 Table 列。

object (UpdateTableRowPropertiesRequest)

更新 Table 。

object (MergeTableCellsRequest)

合并单元格中的单元格 Table。

object (UnmergeTableCellsRequest)

取消合并 Table。

object (GroupObjectsRequest)

对对象（例如页面元素）进行分组。

object (UngroupObjectsRequest)

取消分组对象，例如 groups。

object (UpdatePageElementAltTextRequest)

更新 page element 的替代文本标题和/或说明。

object (ReplaceImageRequest)

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

object (UpdateSlidePropertiesRequest)

更新幻灯片的属性

object (UpdatePageElementsZOrderRequest)

更新 page elements。

object (UpdateLineCategoryRequest)

更新 line。

object (RerouteLineRequest)

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

string

用户提供的对象 ID。

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

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

integer

可选的从零开始的索引，用于指明要插入幻灯片的位置。

如果您未指定索引，系统会在最后创建幻灯片。

object (LayoutReference)

要插入的幻灯片的布局引用，基于当前母版，该母版为以下之一：

• 上一张幻灯片索引的主副本。
• 如果 insertionIndex 为零，则为第一个幻灯片的主幻灯片。
• 演示文稿中的第一张母版（如果没有幻灯片）。

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

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

object (LayoutPlaceholderIdMapping)

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

enum (PredefinedLayout)

预定义的布局。

string

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

string

用户为要在幻灯片中创建的上文中所述占位符提供的对象 ID。

如果您指定 ID，则它在演示文稿的所有页面和页面元素中必须是唯一的。ID 必须以字母数字字符或下划线开头（与正则表达式 [a-zA-Z0-9_] 匹配）；其余字符可以包括这些字符，还可以包括连字符或英文冒号（与正则表达式 [a-zA-Z0-9_-:] 匹配）。ID 的长度不得少于 5 个字符，也不得超过 50 个字符。

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

object (Placeholder)

布局上将应用于幻灯片的占位符。只需 type 和 index 即可。例如，预定义的 TITLE_AND_BODY 布局中通常会有一个索引为 0 的 TITLE 占位符，以及一个索引为 0 的 BODY 占位符。

string

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

string

用户提供的对象 ID。

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

object (PageElementProperties)

形状的元素属性。

enum (Type)

形状类型。

string

元素所在页面的对象 ID。

object (Size)

元素的尺寸。

object (AffineTransform)

元素的转换。

string

用户提供的对象 ID。

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

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

object (PageElementProperties)

表格的元素属性。

系统将按照所提供的大小创建表，但不低于最小大小。如果未提供大小，系统会自动调整表格大小。

表转换的缩放比例必须为 1，且不含剪切分量。如果未提供任何转换，则表将在页面居中显示。

integer

表中的行数。

integer

表中的列数。

string

要插入文本的形状或表格的对象 ID。

object (TableCellLocation)

如果要将文本插入表格单元格，则可选的表格单元格位置。如果存在，objectId 必须引用表。

string

要插入的文本。

插入换行符会在该索引处隐式创建一个新的 ParagraphMarker。新段落的段落样式将从当前插入索引处的段落复制，包括列表和项目符号。

系统会自动确定插入文本的文本样式，通常会保留相邻文本的样式。在大多数情况下，系统会将文字添加到 TextRun 。

插入的文本中将删除部分控制字符（U+0000-U+0008、U+000C-U+001F）和 Unicode 基本多语言平面专用区域 (U+E000-U+F8FF) 中的字符。

integer

要插入文本的位置（以 Unicode 代码单元为单位），基于 TextElement 索引。

索引从零开始，从字符串的开头计算。系统可能会调整索引，以防止在 Unicode 字符集群内进行插入。在这些情况下，文本将立即插入字形聚类之后。

string

要插入行的表。

object (TableCellLocation)

要从中插入行的数据表单元格引用位置。

系统会在引用单元格所在行的上方（或下方）插入一个新行。如果引用单元格是合并单元格，系统会在合并单元格的上方（或下方）插入新行。

boolean

是否在引用单元格位置下方插入新行。

• True ：在单元格下方插入。
• False ：在单元格上方插入。

integer

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

string

要插入列的表。

object (TableCellLocation)

要从中插入列的引用表格单元格位置。

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

boolean

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

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

integer

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

string

要从中删除行的表。

object (TableCellLocation)

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

系统会删除此单元格跨越的行。如果这是一个合并单元格，多行将被删除。如果此删除操作后表中没有剩余行，则系统会删除整个表。

string

要从中删除列的表。

object (TableCellLocation)

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

系统会删除此单元格跨越的列。如果这是合并的单元格，则系统会删除多列。如果此删除操作后表中没有剩余列，则系统会删除整个表。

string

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

string

如果不为空，则仅将匹配范围限制为给定网页上的网页元素。

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

object (SubstringMatchCriteria)

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

string

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

boolean

指示搜索时是否应区分大小写：

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

string

要删除的页面或页面元素的对象 ID。

如果在删除操作后，group 仅包含 1 个或没有页面元素，则该组也会被删除。

如果删除了布局上的某个占位符，则所有空的继承占位符也会被删除。

string

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

object (AffineTransform)

用于更新页面元素的输入转换矩阵。

enum (ApplyMode)

转换更新的应用模式。

string

应移动的演示文稿中幻灯片的 ID。此列表中的幻灯片必须按现有演示文稿顺序排列，且不得出现重复。

integer

应插入幻灯片的索引，基于移动前的幻灯片排列方式。必须介于 0 和演示文稿中的幻灯片数量之间（包括 0 和幻灯片数）。

string

要从中删除文本的形状或表格的对象 ID。

object (TableCellLocation)

要从表格单元格中删除文本时，可选的表格单元格位置。如果存在，objectId 必须引用表。

object (Range)

要删除的文本范围，基于 TextElement 索引。

形状或表格单元格文本的末尾总是有一个隐式的换行符，这些字符无法删除。 Range.Type.ALL 将使用正确的边界，但在为范围类型指定显式边界时必须小心 FROM_START_INDEX 和 FIXED_RANGE。例如，如果文本为“ABC”，后跟隐式换行符，则 textRange.start_index 的最大值为 2，textRange.end_index 的最大值为 3。

删除跨越段落边界的文本可能会导致段落样式和列表发生变化，因为系统会合并这两个段落。

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

integer

集合开头的可选从零开始的索引。对于 FIXED_RANGE 和 FROM_START_INDEX 范围，此参数为必需参数。

integer

集合末尾的可选索引（从零开始）。必须使用 FIXED_RANGE 范围。

enum (Type)

范围的类型。

string

用户提供的对象 ID。

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

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

object (PageElementProperties)

图片的元素属性。

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

PageElementProperties.size 属性是可选属性。如果您未指定尺寸，系统会使用图片的默认尺寸。

通过 PageElementProperties.transform 属性是可选属性。如果您未指定转换，图片将放置在页面的左上角。

string

图片的网址。

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

提供的网址必须可公开访问，且长度不得超过 2 KB。该网址会随图片一起保存，并通过 Image.source_url 字段公开。

string

用户提供的对象 ID。

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

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

object (PageElementProperties)

视频的元素属性。

通过 PageElementProperties.size 属性是可选属性。如果您未指定尺寸，服务器会选择默认尺寸。

PageElementProperties.transform 属性是可选属性。转换不得包含剪切分量。如果您未指定转换，视频将放置在页面的左上角。

enum (Source)

视频源。

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 标头中添加资源密钥。如需了解详情，请参阅使用资源键访问链接共享的文件。

string

用户提供的对象 ID。

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

object (PageElementProperties)

图表的元素属性。

如果所提供大小的宽高比与图表宽高比不匹配，系统会根据大小缩放并居中显示图表，以保持宽高比。系统会在此操作之后应用所提供的转换。

string

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

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

integer

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

enum (LinkingMode)

图表与源电子表格关联的模式。如果未指定，则图表将是未关联的图片。

string

用户提供的对象 ID。

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

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

object (PageElementProperties)

线条的元素属性。

enum (Category)

要创建的线条的类别。

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

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

如果您同时指定 category 和 lineCategory、 category 优先级。

enum (LineCategory)

要创建的线条的类别。

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

如果您同时指定了 category 和 lineCategory，则 category 优先。

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

如果您未指定任一项，则系统会使用 STRAIGHT。

string

要刷新的图表的对象 ID。

string

要应用更新的形状的对象 ID。

object (ShapeProperties)

要更新的形状属性。

string (FieldMask format)

应更新的字段。

必须至少指定一个字段。根 shapeProperties 是隐含的，不应指定。单个 "*" 可以用作列出每个字段的简写形式。

例如，如需更新形状背景纯色填充颜色，请将 fields 设置为 "shapeBackgroundFill.solidFill.color"。

如需将某个属性重置为默认值，请在字段掩码中添加其字段名称，但将该字段本身保持未设置状态。

string

要应用更新的图片的对象 ID。

object (ImageProperties)

要更新的图片属性。

string (FieldMask format)

应更新的字段。

必须至少指定一个字段。根 imageProperties 是隐含的，因此不应指定。列出每个字段时，您可以使用单个 "*" 作为快捷方式。

例如，如需更新图片轮廓颜色，请将 fields 设置为 "outline.outlineFill.solidFill.color"。

如需将某个属性重置为默认值，请在字段掩码中添加其字段名称，但将该字段本身保持未设置状态。

string

要应用更新的视频的对象 ID。

object (VideoProperties)

要更新的视频属性。

string (FieldMask format)

应更新的字段。

必须至少指定一个字段。根 videoProperties 是隐含的，不应指定。单个 "*" 可以用作列出每个字段的简写形式。

例如，如需更新视频轮廓颜色，请将 fields 更改为 "outline.outlineFill.solidFill.color"。

如需将某个属性重置为默认值，请在字段掩码中添加其字段名称，但将该字段本身保持未设置状态。

string

要应用更新的网页的对象 ID。

object (PageProperties)

要更新的页面属性。

string (FieldMask format)

应更新的字段。

必须至少指定一个字段。根 pageProperties 是隐含的，不应指定。单个 "*" 可以用作列出每个字段的简写形式。

例如，要更新网页背景纯色填充色，请将 fields 更改为 "pageBackgroundFill.solidFill.color"。

如需将某个属性重置为默认值，请在字段掩码中添加其字段名称，但将该字段本身保持未设置状态。

string

表的对象 ID。

object (TableRange)

表范围，表示要应用更新的表的子集。如果未指定表范围，则更新将应用于整个表。

object (TableCellProperties)

要更新的表格单元格属性。

string (FieldMask format)

应更新的字段。

必须至少指定一个字段。根 tableCellProperties 是隐含的，因此不应指定。列出每个字段时，您可以使用单个 "*" 作为快捷方式。

例如，要更新表格单元格背景纯色的填充色，请将 fields 更改为 "tableCellBackgroundFill.solidFill.color"。

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

object (TableCellLocation)

表格范围的起始位置。

integer

表范围的行跨度。

integer

表格范围的列跨度。

string

要应用更新的行对象 ID。

object (LineProperties)

要更新的线条属性。

string (FieldMask format)

应更新的字段。

必须至少指定一个字段。根 lineProperties 是隐含的，不应指定。单个 "*" 可以用作列出每个字段的简写形式。

例如，如需更新线条实心填充颜色，请将 fields 设置为 "lineFill.solidFill.color"。

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

string

包含要添加项目符号的文本的形状或表格的对象 ID。

object (TableCellLocation)

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

object (Range)

要应用项目符号预设的文字范围，基于 TextElement 索引。

enum (BulletGlyphPreset)

要使用的项目符号类型。默认为 BULLET_DISC_CIRCLE_SQUARE 预设。

enum (ReplaceMethod)

替换方法。

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

如果您同时指定 replaceMethod 和 imageReplaceMethod、 imageReplaceMethod 优先级。

enum (ImageReplaceMethod)

图片替换方法。

如果您同时指定了 replaceMethod 和 imageReplaceMethod，则以 imageReplaceMethod 为准。

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

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

string

如果不为空，则仅将匹配范围限制为给定网页上的网页元素。

如果给定 notes page 或 notes master 的页面对象 ID，或者演示文稿中不存在具有该对象 ID 的页面，则返回 400 Bad Request 错误。

object (SubstringMatchCriteria)

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

string

图片的网址。

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

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

string

要复制的对象的 ID。

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。

string

包含要设置样式的文本的形状或表格的对象 ID。

object (TableCellLocation)

表格中包含要设置样式的文本的单元格的位置。如果 objectId 是指一个表 cellLocation 都必须有一个值。否则，不得这样做。

object (TextStyle)

要在文本上设置的样式。

如果特定样式的值与父样式的值匹配，则该样式将设为继承。

某些文本样式更改可能会导致其他更改，以体现幻灯片编辑器的行为。请参阅 TextStyle 。

object (Range)

文本样式的范围。

可以扩大范围以包括相邻的换行符。

如果该范围中完全包含属于某个列表的段落，则该段落的项目符号也会更新为匹配的文本样式。

string (FieldMask format)

应更新的字段。

必须至少指定一个字段。根 style 是隐含的，不应指定。列出每个字段时，您可以使用单个 "*" 作为快捷方式。

例如，要将文本样式更新为粗体，可将 fields 更改为 "bold"。

如需将某个属性重置为默认值，请在字段掩码中添加其字段名称，但将该字段本身保持未设置状态。

object (SubstringMatchCriteria)

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

string

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

integer

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

enum (LinkingMode)

图表与源电子表格关联的模式。如果未指定，则图表将是未关联的图片。

string

如果不为空，则仅将匹配范围限制为给定网页上的网页元素。

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

string

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

object (TableCellLocation)

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

object (Range)

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

string

包含要设置样式的文本的形状或表格的对象 ID。

object (TableCellLocation)

表格中包含要设置样式的段落的单元格的所在位置。如果 objectId 引用表格，则 cellLocation 必须具有值。否则，不得这样做。

object (ParagraphStyle)

段落的样式。

object (Range)

包含要设置样式的段落的文本范围。

string (FieldMask format)

应更新的字段。

必须至少指定一个字段。根 style 是隐含的，因此不应指定。单个 "*" 可以用作列出每个字段的简写形式。

例如，要更新段落对齐方式，可将 fields 更改为 "alignment"。

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

string

表的对象 ID。

object (TableRange)

表范围，表示要应用更新的表的子集。如果未指定表范围，则更新将应用于整个表。

enum (BorderPosition)

表格范围中应该应用更新的边框位置。如果未指定边框位置，则更新将应用于表格范围中的所有边框。

object (TableBorderProperties)

要更新的表格边框属性。

string (FieldMask format)

应更新的字段。

必须至少指定一个字段。根 tableBorderProperties 是隐含的，因此不应指定。列出每个字段时，您可以使用单个 "*" 作为快捷方式。

例如，如需更新表格边框的纯色填充颜色，请将 fields 设置为 "tableBorderFill.solidFill.color"。

如需将某个属性重置为默认值，请在字段掩码中添加其字段名称，但将该字段本身保持未设置状态。

string

表的对象 ID。

integer

从零开始的索引列表，用于指定要更新的列。如果未提供任何索引，系统将更新表中的所有列。

object (TableColumnProperties)

要更新的表格列属性。

如果 tableColumnProperties#columnWidth 小于 406,400 EMU (32 点)，则系统会返回 400 错误请求错误。

string (FieldMask format)

应更新的字段。

必须至少指定一个字段。根 tableColumnProperties 是隐含的，因此不应指定。列出每个字段时，您可以使用单个 "*" 作为快捷方式。

例如，要更新列宽，请将 fields 更改为 "columnWidth"。

如果字段掩码中包含“columnWidth”，但该属性未设置，则列宽将默认为 406,400 EMU（32 个点）。

string

表的对象 ID。

integer

一个从零开始的索引列表，用于指定要更新的行。如果未提供索引，系统将更新表中的所有行。

object (TableRowProperties)

要更新的表行属性。

string (FieldMask format)

应更新的字段。

必须至少指定一个字段。根 tableRowProperties 是隐含的，因此不应指定。列出每个字段时，您可以使用单个 "*" 作为快捷方式。

例如，要更新最小行高，请将 fields 更改为 "minRowHeight"。

如果字段掩码中包含“minRowHeight”，但该属性未设置，则最小行高将默认为 0。

string

表的对象 ID。

object (TableRange)

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

要合并的单元格中的任何文本都会串联起来，并存储在相应范围的左上角（“头”）单元格。如果范围是非矩形（在某些情况下可能会包含已合并的单元格，就会出现这种情况），系统会返回 400 错误请求错误。

string

表的对象 ID。

object (TableRange)

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

此范围中的所有合并单元格都将取消合并，已取消合并的单元格不会受到影响。如果范围中没有合并的单元格，则请求将不执行任何操作。如果任何合并的单元格中都包含文本，则文本将保留在合并后的未合并单元格块的左上角（“标题”）单元格中。

string

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

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

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

string

要分组的对象的对象 ID。

只有页面元素可以分组。同一网页上至少应有两个尚未加入其他组的页面元素。某些页面元素（例如 videos、tables 和 placeholders）无法分组。

string

要取消分组的对象的对象 ID。

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

string

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

string

已更新页面元素的替代文本标题。如果此政策未设置，现有值将会保留。标题会向屏幕阅读器和其他无障碍功能界面显示。仅使用与网页元素内容相关的直观易懂的值。

string

页面元素的更新版替代文本说明。如果未设置，系统将保留现有值。此说明会向屏幕阅读器和其他无障碍界面公开。仅使用与网页元素内容相关的直观易懂的值。

string

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

enum (ImageReplaceMethod)

替换方法。

string

图片的网址。

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

提供的网址长度不得超过 2 KB。该网址会随图片一起保存，并通过 Image.source_url 字段公开。

string

应用更新所应用到的幻灯片的对象 ID。

object (SlideProperties)

要更新的幻灯片属性。

string (FieldMask format)

应更新的字段。

必须至少指定一个字段。根“slideProperties”是隐含的，不应指定。列出每个字段时，您可以使用单个 "*" 作为快捷方式。

例如，如需更新幻灯片是否被跳过，请将 fields 设置为 "isSkipped"。

如需将某个属性重置为默认值，请在字段掩码中添加其字段名称，但将该字段本身保持未设置状态。

string

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

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

enum (ZOrderOperation)

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

对多个页面元素应用操作时，系统会保留这些页面元素在操作前内的相对 Z 顺序。

string

要应用更新的行对象 ID。

只有带有 category 且表示为“连接器”的线条才能更新。

更新线路类别后，系统可能会重新为其分配路线。

enum (LineCategory)

要更新到的线条类别。

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

string

要重新路由的线条的对象 ID。

只有带有 category 表示“连接器”的线条才能重新路由。线条的起点和终点连接必须位于不同的页面元素上。