Requests

{

  // 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.
}

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 使其在连接的网页元素上两个最近的连接站点处关联。

{
  "objectId": string,
  "insertionIndex": integer,
  "slideLayoutReference": {
    object (LayoutReference)
  },
  "placeholderIdMappings": [
    {
      object (LayoutPlaceholderIdMapping)
    }
  ]
}

string

用户提供的对象 ID。

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

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

integer

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

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

object (LayoutReference)

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

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

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

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

object (LayoutPlaceholderIdMapping)

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

{

  // 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.
}

enum (PredefinedLayout)

预定义的布局。

string

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

{
  "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.
}

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。

{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "shapeType": enum (Type)
}

string

用户提供的对象 ID。

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

object (PageElementProperties)

形状的元素属性。

enum (Type)

形状类型。

{
  "pageObjectId": string,
  "size": {
    object (Size)
  },
  "transform": {
    object (AffineTransform)
  }
}

string

元素所在页面的对象 ID。

object (Size)

元素的尺寸。

object (AffineTransform)

元素的转换。

{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "rows": integer,
  "columns": integer
}

string

用户提供的对象 ID。

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

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

object (PageElementProperties)

表格的元素属性。

表格将按照所提供的大小创建，具体取决于最小大小。如果未提供大小，则系统会自动调整表格的大小。

表转换的缩放比例必须为 1，并且没有剪切组件。如果未提供任何转换，则表将在页面居中显示。

integer

表中的行数。

integer

表中的列数。

{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "text": string,
  "insertionIndex": 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 字形聚类中插入内容。在这些情况下，文本将立即插入字形聚类。

{
  "tableObjectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "insertBelow": boolean,
  "number": integer
}

string

要向其插入行的表。

object (TableCellLocation)

要插入行的引用表单元格的位置。

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

boolean

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

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

integer

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

{
  "tableObjectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "insertRight": boolean,
  "number": integer
}

string

要向其插入列的表格。

object (TableCellLocation)

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

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

boolean

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

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

integer

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

{
  "tableObjectId": string,
  "cellLocation": {
    object (TableCellLocation)
  }
}

string

要从中删除行的表。

object (TableCellLocation)

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

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

{
  "tableObjectId": string,
  "cellLocation": {
    object (TableCellLocation)
  }
}

string

要从中删除列的表。

object (TableCellLocation)

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

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

{
  "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.
}

string

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

string

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

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

object (SubstringMatchCriteria)

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

{
  "text": string,
  "matchCase": boolean
}

string

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

boolean

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

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

{
  "objectId": string
}

string

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

如果在删除操作执行后， group 仅包含 1 个页面元素或未包含任何页面元素，则该组也会被删除。

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

{
  "objectId": string,
  "transform": {
    object (AffineTransform)
  },
  "applyMode": enum (ApplyMode)
}

string

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

object (AffineTransform)

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

enum (ApplyMode)

转换更新的应用模式。

{
  "slideObjectIds": [
    string
  ],
  "insertionIndex": integer
}

string

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

integer

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

{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "textRange": {
    object (Range)
  }
}

string

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

object (TableCellLocation)

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

object (Range)

要删除的文本范围，根据 TextElement 索引。

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

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

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

{
  "startIndex": integer,
  "endIndex": integer,
  "type": enum (Type)
}

integer

集合开头的可选从零开始的索引。必须使用 FIXED_RANGE 和 FROM_START_INDEX 范围。

integer

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

enum (Type)

范围的类型。

{
  "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.
}

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 字段。

{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "source": enum (Source),
  "id": string
}

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

{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "spreadsheetId": string,
  "chartId": integer,
  "linkingMode": enum (LinkingMode)
}

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)

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

{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "lineCategory": enum (Category),
  "category": enum (LineCategory)
}

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 。

{
  "objectId": string
}

string

要刷新的图表的对象 ID。

{
  "objectId": string,
  "shapeProperties": {
    object (ShapeProperties)
  },
  "fields": string
}

string

应用更新所应用到的形状的对象 ID。

object (ShapeProperties)

要更新的形状属性。

string (FieldMask format)

应更新的字段。

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

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

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

{
  "objectId": string,
  "imageProperties": {
    object (ImageProperties)
  },
  "fields": string
}

string

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

object (ImageProperties)

要更新的图片属性。

string (FieldMask format)

应更新的字段。

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

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

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

{
  "objectId": string,
  "videoProperties": {
    object (VideoProperties)
  },
  "fields": string
}

string

应用更新所应用到的视频的对象 ID。

object (VideoProperties)

要更新的视频属性。

string (FieldMask format)

应更新的字段。

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

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

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

{
  "objectId": string,
  "pageProperties": {
    object (PageProperties)
  },
  "fields": string
}

string

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

object (PageProperties)

要更新的页面属性。

string (FieldMask format)

应更新的字段。

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

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

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

{
  "objectId": string,
  "tableRange": {
    object (TableRange)
  },
  "tableCellProperties": {
    object (TableCellProperties)
  },
  "fields": string
}

string

表的对象 ID。

object (TableRange)

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

object (TableCellProperties)

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

string (FieldMask format)

应更新的字段。

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

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

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

{
  "location": {
    object (TableCellLocation)
  },
  "rowSpan": integer,
  "columnSpan": integer
}

object (TableCellLocation)

表格范围的起始位置。

integer

表范围的行跨度。

integer

表格范围的列跨度。

{
  "objectId": string,
  "lineProperties": {
    object (LineProperties)
  },
  "fields": string
}

string

应用更新行的对象 ID。

object (LineProperties)

要更新的线条属性。

string (FieldMask format)

应更新的字段。

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

例如，要更新线条纯色的填充颜色，请将 fields 更改为 "lineFill.solidFill.color"。

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

{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "textRange": {
    object (Range)
  },
  "bulletPreset": enum (BulletGlyphPreset)
}

string

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

object (TableCellLocation)

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

object (Range)

要应用项目符号预设的文本范围，具体取决于 TextElement 索引。

enum (BulletGlyphPreset)

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

{
  "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.
}

enum (ReplaceMethod)

替换方法。

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

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

enum (ImageReplaceMethod)

图片替换方法。

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

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

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

string

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

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

object (SubstringMatchCriteria)

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

string

图片网址。

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

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

{
  "objectId": string,
  "objectIds": {
    string: string,
    ...
  }
}

string

要复制的对象的 ID。

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。

{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "style": {
    object (TextStyle)
  },
  "textRange": {
    object (Range)
  },
  "fields": string
}

string

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

object (TableCellLocation)

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

object (TextStyle)

要在文本上设置的样式。

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

某些文本样式更改可能会导致其他旨在反映幻灯片编辑器行为的更改。请参阅 TextStyle 。

object (Range)

要设置样式的文本范围。

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

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

string (FieldMask format)

应更新的字段。

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

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

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

{
  "containsText": {
    object (SubstringMatchCriteria)
  },
  "spreadsheetId": string,
  "chartId": integer,
  "linkingMode": enum (LinkingMode),
  "pageObjectIds": [
    string
  ]
}

object (SubstringMatchCriteria)

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

string

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

integer

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

enum (LinkingMode)

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

string

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

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

{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "textRange": {
    object (Range)
  }
}

string

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

object (TableCellLocation)

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

object (Range)

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

{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "style": {
    object (ParagraphStyle)
  },
  "textRange": {
    object (Range)
  },
  "fields": string
}

string

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

object (TableCellLocation)

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

object (ParagraphStyle)

段落的样式。

object (Range)

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

string (FieldMask format)

应更新的字段。

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

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

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

{
  "objectId": string,
  "tableRange": {
    object (TableRange)
  },
  "borderPosition": enum (BorderPosition),
  "tableBorderProperties": {
    object (TableBorderProperties)
  },
  "fields": string
}

string

表的对象 ID。

object (TableRange)

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

enum (BorderPosition)

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

object (TableBorderProperties)

要更新的表格边框属性。

string (FieldMask format)

应更新的字段。

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

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

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

{
  "objectId": string,
  "columnIndices": [
    integer
  ],
  "tableColumnProperties": {
    object (TableColumnProperties)
  },
  "fields": string
}

string

表的对象 ID。

integer

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

object (TableColumnProperties)

要更新的表格列属性。

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

string (FieldMask format)

应更新的字段。

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

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

如果为 '"columnWidth"'，但该属性未设置，则列宽将默认为 406,400 EMU（32 点）。

{
  "objectId": string,
  "rowIndices": [
    integer
  ],
  "tableRowProperties": {
    object (TableRowProperties)
  },
  "fields": string
}

string

表的对象 ID。

integer

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

object (TableRowProperties)

要更新的表格行属性。

string (FieldMask format)

应更新的字段。

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

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

如果为 '"minRowHeight"'包含在字段掩码中，但属性未设置，则最小行高默认为 0。

{
  "objectId": string,
  "tableRange": {
    object (TableRange)
  }
}

string

表的对象 ID。

object (TableRange)

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

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

{
  "objectId": string,
  "tableRange": {
    object (TableRange)
  }
}

string

表的对象 ID。

object (TableRange)

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

系统会取消合并此范围中的所有已合并单元格，而已取消合并的单元格不会受到影响。如果范围中没有合并的单元格，则请求将不执行任何操作。如果任何合并的单元格中存在文本，则这些文本将保留在所合并的未合并单元格块的左上角（“头”）单元格。

{
  "groupObjectId": string,
  "childrenObjectIds": [
    string
  ]
}

string

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

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

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

string

要分组的对象的对象 ID。

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

{
  "objectIds": [
    string
  ]
}

string

要取消分组的对象的 ID。

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

{
  "objectId": string,
  "title": string,
  "description": string
}

string

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

string

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

string

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

{
  "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.
}

string

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

enum (ImageReplaceMethod)

替换方法。

string

图片网址。

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

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

{
  "objectId": string,
  "slideProperties": {
    object (SlideProperties)
  },
  "fields": string
}

string

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

object (SlideProperties)

要更新的幻灯片属性。

string (FieldMask format)

应更新的字段。

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

例如，要更新是否跳过某张幻灯片，请将 fields 更改为 "isSkipped"。

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

{
  "pageElementObjectIds": [
    string
  ],
  "operation": enum (ZOrderOperation)
}

string

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

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

enum (ZOrderOperation)

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

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

{
  "objectId": string,
  "lineCategory": enum (LineCategory)
}

string

应用更新行的对象 ID。

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

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

enum (LineCategory)

要更新到的线条类别。

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

{
  "objectId": string
}

string

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

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