请求
一种要应用于演示文稿的更新。
JSON 表示法 |
---|
{ // Union field |
字段 | |
---|---|
联合字段 kind 。更新的类型。只有一个字段是必填字段。
kind 只能是下列其中一项:
|
|
createSlide
|
创建新的幻灯片。 |
createShape
|
创建新的形状。 |
createTable
|
创建新表。 |
insertText
|
将文本插入形状或表格单元格。 |
insertTableRows
|
将行插入表中。 |
insertTableColumns
|
将列插入表中。 |
deleteTableRow
|
从表中删除一行。 |
deleteTableColumn
|
从表中删除列。 |
replaceAllText
|
替换指定文本的所有实例。 |
deleteObject
|
从演示文稿中删除页面或页面元素。 |
updatePageElementTransform
|
更新页面元素的转换。 |
updateSlidesPosition
|
更新一组幻灯片在演示文稿中的位置。 |
deleteText
|
删除形状或表格单元格中的文本。 |
createImage
|
创建映像。 |
createVideo
|
创建视频。 |
createSheetsChart
|
创建嵌入式 Google 表格图表。 |
createLine
|
创建一条线。 |
refreshSheetsChart
|
刷新 Google 表格图表。 |
updateShapeProperties
|
更新 |
updateImageProperties
|
更新 |
updateVideoProperties
|
更新 |
updatePageProperties
|
更新 |
updateTableCellProperties
|
更新 |
updateLineProperties
|
更新 |
createParagraphBullets
|
创建段落项目符号。 |
replaceAllShapesWithImage
|
将符合特定条件的所有形状替换为图片。 |
duplicateObject
|
复制幻灯片或页面元素。 |
updateTextStyle
|
|
replaceAllShapesWithSheetsChart
|
使用 Google 表格图表替换某些符合某些条件的形状。 |
deleteParagraphBullets
|
从段落中删除项目符号。 |
updateParagraphStyle
|
|
updateTableBorderProperties
|
更新 |
updateTableColumnProperties
|
更新 |
updateTableRowProperties
|
更新 |
mergeTableCells
|
合并 |
unmergeTableCells
|
取消合并 |
groupObjects
|
将对象(例如页面元素)分组。 |
ungroupObjects
|
为对象取消分组,例如 |
updatePageElementAltText
|
更新 |
replaceImage
|
用新图片替换现有图片。 |
updateSlideProperties
|
更新幻灯片的属性 |
updatePageElementsZOrder
|
更新 |
updateLineCategory
|
更新 |
rerouteLine
|
重新路由 |
CreateSlideRequest 字段
创建幻灯片。
JSON 表示法 |
---|
{ "objectId": string, "insertionIndex": integer, "slideLayoutReference": { object ( |
字段 | |
---|---|
objectId
|
用户提供的对象 ID。
如果您指定了 ID,则该 ID 在演示文稿的所有页面和页面元素中必须是唯一的。ID 必须以字母数字字符或下划线(与正则表达式 如果您未指定 ID,系统会生成唯一的 ID。 |
insertionIndex
|
可选的零索引,用于指示插入幻灯片的位置。 如果您未指定索引,则系统会在结尾创建幻灯片。 |
slideLayoutReference
|
要根据当前母版(将为以下项之一)插入的幻灯片的布局引用:
如果在当前主组件中找不到 LayoutReference,会返回 400 错误请求错误。
如果您未指定布局引用,则幻灯片将使用预定义的 |
placeholderIdMappings[]
|
(可选)从布局上的 |
LayoutReference
幻灯片布局参考。这可能引用以下两者之一:
- 预定义的布局
- 演示文稿中的布局之一。
JSON 表示法 |
---|
{ // Union field |
字段 | |
---|---|
联合字段 kind 。LayoutReference 的种类。kind 只能是下列其中一项:
|
|
predefinedLayout
|
预定义布局。 |
layoutId
|
布局 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 |
字段 | |
---|---|
objectId
|
用户为上述占位符确定的要在幻灯片上创建的对象 ID。
如果您指定了 ID,则该 ID 在演示文稿的所有页面和页面元素中必须是唯一的。ID 必须以字母数字字符或下划线(与正则表达式 如果您未指定 ID,系统会生成唯一的 ID。 |
联合字段 kind 。用于标识布局上的占位符的种类。
kind 只能是下列其中一项:
|
|
layoutPlaceholder
|
布局上将应用于幻灯片的占位符。只需 |
layoutPlaceholderObjectId
|
布局中将应用于幻灯片的布局的对象 ID。 |
CreateShapeRequest
创建新的形状。
JSON 表示法 |
---|
{ "objectId": string, "elementProperties": { object ( |
字段 | |
---|---|
objectId
|
用户提供的对象 ID。
如果您指定了 ID,则该 ID 在演示文稿的所有页面和页面元素中必须是唯一的。ID 必须以字母数字字符或下划线(与正则表达式 |
elementProperties
|
形状的元素属性。 |
shapeType
|
形状类型。 |
PageElementProperties
页面元素的常用属性。
注意:在您最初创建 PageElement
时,API 可能会修改 size
和 transform
的值,但视觉尺寸不会发生变化。
JSON 表示法 |
---|
{ "pageObjectId": string, "size": { object ( |
字段 | |
---|---|
pageObjectId
|
元素所在的页面的对象 ID。 |
size
|
元素的大小。 |
transform
|
元素的转换。 |
CreateTableRequest
创建新表。
JSON 表示法 |
---|
{
"objectId": string,
"elementProperties": {
object (
|
字段 | |
---|---|
objectId
|
用户提供的对象 ID。
如果您指定了 ID,则该 ID 在演示文稿的所有页面和页面元素中必须是唯一的。ID 必须以字母数字字符或下划线(与正则表达式 如果您未指定 ID,系统会生成唯一的 ID。 |
elementProperties
|
表的元素属性。 系统将以提供的大小(受最小大小限制)创建表。如果未提供尺寸,表会自动调整大小。 表转换的缩放比例必须为 1,没有剪切组件。如果未提供转换,表格将位于页面上的居中位置。 |
rows
|
表中的行数。 |
columns
|
表中的列数。 |
InsertTextRequest
将文本插入形状或表格单元格。
JSON 表示法 |
---|
{
"objectId": string,
"cellLocation": {
object (
|
字段 | |
---|---|
objectId
|
将插入文本的形状或表格的对象 ID。 |
cellLocation
|
可选表格单元格的位置(如果该文本要插入表格单元格)。如果存在,objectId 必须引用表。 |
text
|
要插入的文本。
插入换行符将在该索引处隐式创建一个新的
系统会自动确定插入文字的文本样式,并且通常保留相邻文本的样式。在大多数情况下,系统会将文本添加到插入索引处的 系统会从插入的文本中删除某些控制字符(U+0000-U+0008、U+000C-U+001F)和 Unicode 基本多语言平面私人使用区域 (U+E000-U+F8FF) 中的字符。 |
insertionIndex
|
用于插入文本的索引,基于 Unicode 代码单元,基于 索引从零开始,从字符串的开头计算。索引可能会被调整,以防止在 Unicode 字形聚类内插入。在这些情况下,文本将立即插入 Grapheme 集群之后。 |
InsertTableRowsRequest
将行插入表中。
JSON 表示法 |
---|
{
"tableObjectId": string,
"cellLocation": {
object (
|
字段 | |
---|---|
tableObjectId
|
要插入行的表。 |
cellLocation
|
将从中插入行的引用表格单元格的位置。 将在引用单元格所在的行上方(或下方)插入一个新行。如果引用单元格是一个合并单元格,则会在合并的单元格上方(或下方)插入一个新行。 |
insertBelow
|
是否在引用单元格位置下方插入新行。
|
number
|
要插入的行数。每个请求最多 20 个。 |
InsertTableColumnsRequest
将列插入表中。
系统会调整表格中其他列的大小以适应新的列。
JSON 表示法 |
---|
{
"tableObjectId": string,
"cellLocation": {
object (
|
字段 | |
---|---|
tableObjectId
|
要插入列的表。 |
cellLocation
|
将从中插入列的引用表格单元格的位置。 将把新列插入引用单元格所在的列的左侧(或右侧)。如果参考单元格是一个合并单元格,则会在合并的单元格的左侧(或右侧)插入一个新列。 |
insertRight
|
是否在引用单元格的位置右侧插入新列。
|
number
|
要插入的列数。每个请求最多 20 个。 |
DeleteTableRowRequest
从表中删除一行。
JSON 表示法 |
---|
{
"tableObjectId": string,
"cellLocation": {
object (
|
字段 | |
---|---|
tableObjectId
|
要从中删除行的表。 |
cellLocation
|
从中删除行的参考表格单元格位置。 此单元格范围所在的行将被删除。如果是合并的单元格,则将删除多行。如果此删除操作后表中不再保留任何行,则系统会删除整个表。 |
DeleteTableColumnRequest
从表中删除列。
JSON 表示法 |
---|
{
"tableObjectId": string,
"cellLocation": {
object (
|
字段 | |
---|---|
tableObjectId
|
要从中删除列的表。 |
cellLocation
|
列将被删除的参考单元格位置。 此单元格所跨列会被删除。如果是合并的单元格,则将删除多列。如果此删除操作后表中不再存在任何列,则系统会删除整个表。 |
替换所有文本请求
将符合某个条件的所有文本实例替换为 replace text
。
JSON 表示法 |
---|
{ "replaceText": string, "pageObjectIds": [ string ], // Union field |
字段 | |
---|---|
replaceText
|
会替换匹配的文本。 |
pageObjectIds[]
|
如果非空,则仅匹配指定页面上的页面元素。
如果指定了 |
联合字段 criteria 。用于匹配要替换的文本的条件。
criteria 只能是下列其中一项:
|
|
containsText
|
查找形状中与此子字符串匹配的文本。 |
子字符串匹配条件
与形状或表格中的特定文本字符串匹配的条件。
JSON 表示法 |
---|
{ "text": string, "matchCase": boolean } |
字段 | |
---|---|
text
|
要在形状或表格中搜索的文本。 |
matchCase
|
指示搜索是否应遵循大小写:
|
DeleteObjectRequest
从演示文稿中删除 pages
或 page elements
的对象。
JSON 表示法 |
---|
{ "objectId": string } |
字段 | |
---|---|
objectId
|
要删除的页面或页面元素的对象 ID。
如果 如果删除布局中的占位符,则所有空的继承占位符也会被删除。 |
UpdatePageElementTransformRequest
更新页面元素的转换。
更新组的转换会更改该组中页面元素的绝对转换,从而改变其视觉外观。如需了解详情,请参阅 PageElement.transform
的文档。
JSON 表示法 |
---|
{ "objectId": string, "transform": { object ( |
字段 | |
---|---|
objectId
|
要更新的页面元素的对象 ID。 |
transform
|
用于更新页面元素的输入转换矩阵。 |
applyMode
|
转换更新的应用模式。 |
ApplyMode
转换更新的应用模式。
枚举 | |
---|---|
APPLY_MODE_UNSPECIFIED
|
未指定模式。 |
RELATIVE
|
将新的 AffineTransform 矩阵应用于现有矩阵,并将现有矩阵替换为生成的串联。 |
ABSOLUTE
|
将现有的 AffineTransform 矩阵替换为新的矩阵。 |
UpdateSlidesPositionRequest
更新幻灯片在演示文稿中的位置。
JSON 表示法 |
---|
{ "slideObjectIds": [ string ], "insertionIndex": integer } |
字段 | |
---|---|
slideObjectIds[]
|
演示文稿中应移动的幻灯片的 ID。此列表中的幻灯片必须按现有的演示顺序(不能重复)进行演示。 |
insertionIndex
|
应插入幻灯片的索引,具体取决于移动发生之前幻灯片的排列方式。演示文稿中的幻灯片的个数必须在 0 到 0(含)之间。 |
DeleteTextRequest
删除形状或表格单元格中的文本。
JSON 表示法 |
---|
{ "objectId": string, "cellLocation": { object ( |
字段 | |
---|---|
objectId
|
从中删除文本的形状或表格的对象 ID。 |
cellLocation
|
如果要从表格单元格中删除文本,则可以选择表格单元格的位置。如果存在,objectId 必须引用表。 |
textRange
|
要删除的文本范围,基于
形状或表格单元格文本的末尾一律包含隐式换行符,且无法删除。
删除跨越段落边界的文本可能会导致段落样式和列表在两个段落合并时发生变化。 将仅包含代理对的一个代码单元的范围扩展为包含这两个代码单元。 |
范围
指定已编入索引的集合的连续范围,例如文本中的字符。
JSON 表示法 |
---|
{
"startIndex": integer,
"endIndex": integer,
"type": enum (
|
字段 | |
---|---|
startIndex
|
集合开始处的可选索引(从零开始)。对于 |
endIndex
|
集合末尾的可选索引(从零开始)。 |
type
|
范围类型。 |
类型
范围类型。
枚举 | |
---|---|
RANGE_TYPE_UNSPECIFIED
|
未指定范围类型。不得使用此值。 |
FIXED_RANGE
|
固定范围。必须指定 startIndex 和 endIndex 。
|
FROM_START_INDEX
|
从 startIndex 开始,持续到集合结束。不得指定 endIndex 。 |
ALL
|
将范围设置为集合的整个长度。不得同时指定 startIndex 和 endIndex 。
|
CreateImageRequest
创建映像。
JSON 表示法 |
---|
{ "objectId": string, "elementProperties": { object ( |
字段 | |
---|---|
objectId
|
用户提供的对象 ID。
如果您指定了 ID,则该 ID 在演示文稿的所有页面和页面元素中必须是唯一的。ID 必须以字母数字字符或下划线(与正则表达式 如果您未指定 ID,系统会生成唯一的 ID。 |
elementProperties
|
图片的元素属性。 当指定尺寸的宽高比与图片宽高比不匹配时,图片将根据尺寸进行缩放和居中,以保持宽高比。执行此操作后,系统将应用所提供的转换。
|
联合字段 image_source 。图片来源的类型。
image_source 只能是下列其中一项:
|
|
url
|
图片网址。 系统会在插入时获取图片一次,并存储副本以在演示文稿内显示。图片大小不得超过 50 MB,且不得超过 2500 万像素,并且必须采用 PNG、JPEG 或 GIF 格式。
提供的网址必须可公开访问,长度不得超过 2 KB。该网址会随图片一起保存,并通过 |
CreateVideoRequest
创建视频。
注意:要通过 Google 云端硬盘创建视频,请求方的应用必须至少具有云端硬盘、drive.readonly 或 drive.file OAuth 范围。
JSON 表示法 |
---|
{ "objectId": string, "elementProperties": { object ( |
字段 | |
---|---|
objectId
|
用户提供的对象 ID。
如果您指定了 ID,则该 ID 在演示文稿的所有页面和页面元素中必须是唯一的。ID 必须以字母数字字符或下划线(与正则表达式 如果您未指定 ID,系统会生成唯一的 ID。 |
elementProperties
|
视频的元素属性。
|
source
|
视频来源。 |
id
|
此视频的唯一标识符。 例如,YouTube 视频 https://www.youtube.com/watch?v=7U3axjORYZ0 的 ID 为 7U3axjORYZ0。如果是 Google 云端硬盘视频 https://drive.google.com/file/d/1xCgQLFTJi5_Xl8DgW_lcUYq5e-q6Hi5Q,则 ID 为 1xCgQLFTJi5_Xl8DgW_lcUYq5e-q6Hi5Q。 如需访问 Google 云端硬盘视频文件,您可能需要在部分旧文件的 HTTP 标头中添加资源密钥。如需了解详情,请参阅使用资源键访问链接共享的文件。 |
CreateSheetsChartRequest
创建嵌入式 Google 表格图表。
注意:若要创建图表,至少需要 spreadsheet.readonly、spreadsheets、drive.readonly、drive.file 或 drive OAuth scope 中的一个。
JSON 表示法 |
---|
{ "objectId": string, "elementProperties": { object ( |
字段 | |
---|---|
objectId
|
用户提供的对象 ID。 如果指定,此 ID 必须在演示文稿的所有页面和页面元素中具有唯一性。此 ID 应以单词字符 [a-zA-Z0-9_] 开头,后跟任意数量的以下字符 [a-zA-Z0-9_-:]。ID 的长度不应小于 5 或大于 50。如果为空,系统会生成一个唯一标识符。 |
elementProperties
|
图表的元素属性。 当提供的尺寸的宽高比与图表的宽高比不一致时,图表会根据尺寸进行缩放和居中,以保持宽高比不变。执行此操作后,系统将应用所提供的转换。 |
spreadsheetId
|
包含图表的 Google 表格电子表格的 ID。 您可能需要向部分旧文件的 HTTP 标头添加资源密钥。如需了解详情,请参阅使用资源键访问链接共享的文件。 |
chartId
|
Google 表格中电子表格中特定图表的 ID。 |
linkingMode
|
将图表关联到源电子表格的模式。如果未指定图表,图表将会是未链接的图片。 |
关联模式
将图表关联到源电子表格的模式。
枚举 | |
---|---|
NOT_LINKED_IMAGE
|
该图表未与源电子表格关联,因此无法更新。未关联的图表会作为图片插入。 |
LINKED
|
关联图表后,该图表即可更新,其他协作者将会看到指向电子表格的链接。 |
CreateLineRequest
创建一条线。
JSON 表示法 |
---|
{ "objectId": string, "elementProperties": { object ( |
字段 | |
---|---|
objectId
|
用户提供的对象 ID。
如果您指定了 ID,则该 ID 在演示文稿的所有页面和页面元素中必须是唯一的。ID 必须以字母数字字符或下划线(与正则表达式 如果您未指定 ID,系统会生成唯一的 ID。 |
elementProperties
|
线的元素属性。 |
lineCategory
|
要创建的行的类别。
已弃用
:请改用
确切的
如果您同时指定 |
category
|
要创建的行的类别。
确切的
如果您同时指定
如果您没有为
如果您未指定任何一项,则系统会使用 |
类别
线类别。
枚举 | |
---|---|
STRAIGHT
|
直线连接器,包括直线连接器 1。当未指定类别时,它是默认类别。 |
BENT
|
连接连接器,包括弯曲连接器 2 到 5。 |
CURVED
|
曲线连接器,包括曲线连接器 2 到 5。 |
RefreshSheetsChartRequest
使用 Google 表格中的最新版图表替换嵌入式 Google 表格的图表。
注意:刷新图表至少需要 spreadsheet.readonly、spreadsheets、drive.readonly 或 drive OAuth scope 中的一个。
JSON 表示法 |
---|
{ "objectId": string } |
字段 | |
---|---|
objectId
|
要刷新的图表的对象 ID。 |
UpdateShapePropertiesRequest
更新 Shape
的属性。
JSON 表示法 |
---|
{
"objectId": string,
"shapeProperties": {
object (
|
字段 | |
---|---|
objectId
|
应用更新的形状的对象 ID。 |
shapeProperties
|
要更新的形状属性。 |
fields
|
应更新的字段。
必须至少指定一个字段。根隐式意味着
例如,如需更新形状背景纯色填充颜色,请将 如需将属性重置为默认值,请在字段掩码中包含其字段名称,但请勿设置字段本身。 |
UpdateImagePropertiesRequest
更新 Image
的属性。
JSON 表示法 |
---|
{
"objectId": string,
"imageProperties": {
object (
|
字段 | |
---|---|
objectId
|
应用更新的映像的对象 ID。 |
imageProperties
|
要更新的图片属性。 |
fields
|
应更新的字段。
必须至少指定一个字段。根隐式意味着
例如,如需更新图片轮廓颜色,请将 如需将属性重置为默认值,请在字段掩码中包含其字段名称,但请勿设置字段本身。 |
UpdateVideoPropertiesRequest
更新 Video
的属性。
JSON 表示法 |
---|
{
"objectId": string,
"videoProperties": {
object (
|
字段 | |
---|---|
objectId
|
应用更新的视频的对象 ID。 |
videoProperties
|
要更新的视频属性。 |
fields
|
应更新的字段。
必须至少指定一个字段。根隐式意味着
例如,如需更新视频轮廓颜色,请将 如需将属性重置为默认值,请在字段掩码中包含其字段名称,但请勿设置字段本身。 |
UpdatePagePropertiesRequest
更新 Page
的属性。
JSON 表示法 |
---|
{
"objectId": string,
"pageProperties": {
object (
|
字段 | |
---|---|
objectId
|
应用更新的页面的对象 ID。 |
pageProperties
|
要更新的页面属性。 |
fields
|
应更新的字段。
必须至少指定一个字段。根隐式意味着
例如,如需更新页面背景纯色填充颜色,请将 如需将属性重置为默认值,请在字段掩码中包含其字段名称,但请勿设置字段本身。 |
UpdateTableCellPropertiesRequest
更新 TableCell
的属性。
JSON 表示法 |
---|
{ "objectId": string, "tableRange": { object ( |
字段 | |
---|---|
objectId
|
表格的对象 ID。 |
tableRange
|
表示要应用更新的表子集的表范围。如果未指定表范围,则更新将应用于整个表。 |
tableCellProperties
|
要更新的表格单元格属性。 |
fields
|
应更新的字段。
必须至少指定一个字段。根隐式意味着
例如,如需更新表格单元格背景纯色填充颜色,请将 如需将属性重置为默认值,请在字段掩码中包含其字段名称,但请勿设置字段本身。 |
表范围
表范围表示对表的子集的引用。
请务必注意,表格范围指定的单元格不一定会形成矩形。例如,假设我们有一个 3 x 3 的表格,其中最后一行的所有单元格都合并在一起。该表如下所示:
[ ][ ][ ]
[ ][ ][ ]
[ ]
包含位置 (0, 0)、行 span = 3 且列 span = 2 的表格范围指定以下单元格:
[ x ][ x ][ ]
[ x ][ x ][ ]
[ x x x ]
JSON 表示法 |
---|
{
"location": {
object (
|
字段 | |
---|---|
location
|
表范围的起始位置。 |
rowSpan
|
表范围的行跨度。 |
columnSpan
|
表范围的列 span。 |
UpdateLinePropertiesRequest
更新 Line
的属性。
JSON 表示法 |
---|
{
"objectId": string,
"lineProperties": {
object (
|
字段 | |
---|---|
objectId
|
应用更新的行的对象 ID。 |
lineProperties
|
要更新的行属性。 |
fields
|
应更新的字段。
必须至少指定一个字段。根隐式意味着
例如,如需更新线条纯填充颜色,请将 如需将属性重置为默认值,请在字段掩码中包含其字段名称,但请勿设置字段本身。 |
CreateParagraphBulletsRequest
创建与指定文本索引范围重叠的所有段落的项目符号。
通过计算每个段落前面的制表符来确定每个段落的嵌套级别。为避免出现项目符号和相应段落之间的多余空格,该请求会移除这些前导标签页。这可能会更改文本各个部分的索引。
如果正在更新段落之前的段落位于具有匹配预设的列表中,则系统会将要更新的段落添加到上一个列表中。
JSON 表示法 |
---|
{ "objectId": string, "cellLocation": { object ( |
字段 | |
---|---|
objectId
|
形状或表格的对象 ID,其中包含要添加项目符号的文本。 |
cellLocation
|
可选表格单元格的位置(如果要修改的文本位于表格单元格中)。如果存在,objectId 必须引用表。 |
textRange
|
要应用项目符号预设的文本范围(基于 |
bulletPreset
|
使用的项目符号类型。默认为 |
BulletGlyphPreset
为文本列表设置项目符号的预设模式。
这些模式使用以下项目符号:
-
ARROW
:箭头,与 Unicode U+2794 代码点相对应 -
ARROW3D
:箭头带有 3D 阴影,对应于 Unicode U+27a2 代码点 -
CHECKBOX
:一个空心方形,对应于 Unicode U+274f 代码点 -
CIRCLE
:一个空心圆,对应 Unicode U+25cb 代码点 -
DIAMOND
:实心菱形,对应 Unicode U+25c6 代码点 -
DIAMONDX
:一个带“x”的菱形,对应 Unicode U+2756 代码点 -
HOLLOWDIAMOND
:一个空心菱形,对应一个 Unicode U+25c7 代码点 -
DISC
:一个实心圆,对应 Unicode U+25cf 代码点 -
SQUARE
:一个实心方形,对应一个 Unicode U+25a0 代码点 -
STAR
:星号,对应于 Unicode U+2605 代码点 -
ALPHA
:小写字母,如“a”、“b”或“c”。 -
UPPERALPHA
大写字母,如“A”、“B”或“C”。 -
DIGIT
:数字,例如“1”“2”或“3”。 -
ZERODIGIT
数字,以 0 为前缀的数字,例如“01”“02”或“03”。位数超过 1 个的数字的前缀不是 0。 -
ROMAN
:小写的罗马数字,例如“i”、“ii”或“iii”。 -
UPPERROMAN
:大写罗马数字,如“I”、“II”或“III”。 -
LEFTTRIANGLE
:指向左边的三角形,对应于 Unicode U+25c4 代码点
枚举 | |
---|---|
BULLET_DISC_CIRCLE_SQUARE
|
一个项目符号列表,其中包含前 3 个列表嵌套级别的 DISC 、CIRCLE 和 SQUARE 项目符号。 |
BULLET_DIAMONDX_ARROW3D_SQUARE
|
一个项目符号列表,其中包含前 3 个列表嵌套级别的 DIAMONDX 、ARROW3D 和 SQUARE 项目符号。 |
BULLET_CHECKBOX
|
一个项目符号列表,其中包含所有列表嵌套级别的 CHECKBOX 项目符号。 |
BULLET_ARROW_DIAMOND_DISC
|
一个项目符号列表,其中包含前 3 个列表嵌套级别的 ARROW 、DIAMOND 和 DISC 项目符号。 |
BULLET_STAR_CIRCLE_SQUARE
|
一个项目符号列表,其中包含前 3 个列表嵌套级别的 STAR 、CIRCLE 和 SQUARE 项目符号。 |
BULLET_ARROW3D_CIRCLE_SQUARE
|
一个项目符号列表,其中包含前 3 个列表嵌套级别的 ARROW3D 、CIRCLE 和 SQUARE 项目符号。 |
BULLET_LEFTTRIANGLE_DIAMOND_DISC
|
一个项目符号列表,其中包含前 3 个列表嵌套级别的 LEFTTRIANGLE 、DIAMOND 和 DISC 项目符号。 |
BULLET_DIAMONDX_HOLLOWDIAMOND_SQUARE
|
一个项目符号列表,其中包含前 3 个列表嵌套级别的 DIAMONDX 、HOLLOWDIAMOND 和 SQUARE 项目符号。 |
BULLET_DIAMOND_CIRCLE_SQUARE
|
一个项目符号列表,其中包含前 3 个列表嵌套级别的 DIAMOND 、CIRCLE 和 SQUARE 项目符号。 |
NUMBERED_DIGIT_ALPHA_ROMAN
|
一个编号列表,包含前 3 个列表嵌套级别对应的 DIGIT 、ALPHA 和 ROMAN 数字字形,后跟句点。 |
NUMBERED_DIGIT_ALPHA_ROMAN_PARENS
|
一个编号列表,包含前 3 个列表嵌套级别的 DIGIT 、ALPHA 和 ROMAN 数字字形,后跟圆括号。 |
NUMBERED_DIGIT_NESTED
|
一个编号列表,包含 DIGIT 个数字字形(以英文句点分隔),其中每个嵌套级别均使用上一个嵌套级别的字形作为前缀。例如:“1”。“1.1.”、“2.”、“2.2.”
|
NUMBERED_UPPERALPHA_ALPHA_ROMAN
|
一个编号列表,包含前 3 个列表嵌套级别对应的 UPPERALPHA 、ALPHA 和 ROMAN 数字字形,后跟句点。 |
NUMBERED_UPPERROMAN_UPPERALPHA_DIGIT
|
一个编号列表,包含前 3 个列表嵌套级别对应的 UPPERROMAN 、UPPERALPHA 和 DIGIT 数字字形,后跟句点。 |
NUMBERED_ZERODIGIT_ALPHA_ROMAN
|
一个编号列表,包含前 3 个列表嵌套级别对应的 ZERODIGIT 、ALPHA 和 ROMAN 数字字形,后跟句点。 |
AltAllShapesWithImageRequest
将符合指定条件的所有形状替换为提供的图片。
插入到演示文稿中后,替换形状的图片为矩形,且不会采用形状。
JSON 表示法 |
---|
{ "replaceMethod": enum ( |
字段 | |
---|---|
replaceMethod
|
替换方法。
已弃用
:请改用
如果您同时指定 |
imageReplaceMethod
|
图片替换方法。
如果您同时指定
如果您没有为 如果您未指定任何一项,系统会使用 CENTER_INSIDE。 |
pageObjectIds[]
|
如果非空,则仅匹配指定页面上的页面元素。
如果给定 |
联合字段 criteria 。形状必须匹配才能被替换的条件。
criteria 只能是下列其中一项:
|
|
containsText
|
如果设置此标记,此请求将替换包含给定文本的所有形状。 |
联合字段 image_source 。图片来源的类型。
image_source 只能是下列其中一项:
|
|
imageUrl
|
图片网址。 系统会在插入时获取图片一次,并存储副本以在演示文稿内显示。图片大小不得超过 50MB,且不得超过 2500 万像素,并且必须采用 PNG、JPEG 或 GIF 格式。
所提供的网址长度不得超过 2 KB。网址本身随图片一起保存,并通过 |
替换方法
替换方法。
枚举 | |
---|---|
CENTER_INSIDE
|
缩放图片并使其居中,以符合原始形状的边界,并保持图片的宽高比。图片渲染的尺寸可能会小于形状的尺寸。这是未指定方法时的默认方法。 |
CENTER_CROP
|
缩放图像并居中,以填充原始形状的边界。图片可能会被剪裁以填充形状。图片渲染后的尺寸将与原始形状相同。 |
ImageReplaceMethod
图片替换方法。
枚举 | |
---|---|
IMAGE_REPLACE_METHOD_UNSPECIFIED
|
未指定图片替换方法。不得使用此值。 |
CENTER_INSIDE
|
缩放图片并使其居中,以符合原始形状的边界,并保持图片的宽高比。图片渲染的尺寸可能会小于形状的尺寸。这是未指定方法时的默认方法。 |
CENTER_CROP
|
缩放图像并居中,以填充原始形状的边界。图片可能会被剪裁以填充形状。图片渲染后的尺寸将与原始形状相同。 |
DuplicateObjectRequest
复制幻灯片或页面元素。
复制幻灯片时,系统会按照指定幻灯片后立即创建重复幻灯片。复制页面元素时,复制内容会放置在原始元素的同一位置。
JSON 表示法 |
---|
{ "objectId": string, "objectIds": { string: string, ... } } |
字段 | |
---|---|
objectId
|
要复制的对象的 ID。 |
objectIds
|
所复制的对象可能包含其他对象,例如在复制幻灯片或组页面元素时。此映射定义了重复对象的 ID 的生成方式:键是原始对象的 ID,其值是将会分配给相应重复对象的 ID。此映射中也可以使用源对象的重复 ID,使用与
所有键都必须对应演示文稿中的现有 ID。演示文稿中的所有值都必须是唯一的,并且必须以字母数字字符或下划线开头(与正则表达式 如果地图中省略了源对象的任何 ID,则系统会分配新的随机 ID。如果地图为空或未设置,所有重复对象都将收到一个新的随机 ID。 |
UpdateTextStyleRequest
JSON 表示法 |
---|
{ "objectId": string, "cellLocation": { object ( |
字段 | |
---|---|
objectId
|
需要设置文本样式的形状或表格的对象 ID。 |
cellLocation
|
表格中单元格内要添加样式的文本的位置。如果 |
style
|
要为文本设置的样式。 如果特定样式的值与父样式的值相匹配,则该样式将设置为继承。
某些文本样式的更改可能会导致其他变化,从而反映幻灯片编辑器的行为。如需了解详情,请参阅 |
textRange
|
要设置样式的文本范围。 范围可能会扩展,以包含相邻的换行符。 如果范围完全包含属于列表的段落,那么段落的项目符号也会更新为匹配的文本样式。 |
fields
|
应更新的字段。
必须至少指定一个字段。根隐式意味着
例如,如需将文本样式更新为粗体,请将 如需将属性重置为默认值,请在字段掩码中包含其字段名称,但请勿设置字段本身。 |
AltAllShapesWithSheetsChartRequest
将提供的指定条件匹配的所有形状替换为提供的 Google 表格图表。系统会缩放图表,并将其居中置于原始形状的边界内。
注意:要将形状替换为图表,至少需要一个 spreadsheet.readonly、spreadsheets、drive.readonly 或 drive OAuth scope 中的一个。
JSON 表示法 |
---|
{ "containsText": { object ( |
字段 | |
---|---|
containsText
|
形状必须匹配才能被替换的条件。此请求将替换包含给定文本的所有形状。 |
spreadsheetId
|
包含图表的 Google 表格电子表格的 ID。 |
chartId
|
Google 表格中电子表格中特定图表的 ID。 |
linkingMode
|
将图表关联到源电子表格的模式。如果未指定图表,图表将会是未链接的图片。 |
pageObjectIds[]
|
如果非空,则仅匹配指定页面上的页面元素。
如果给定 |
关联模式
将图表关联到源电子表格的模式。
枚举 | |
---|---|
NOT_LINKED_IMAGE
|
该图表未与源电子表格关联,因此无法更新。未关联的图表会作为图片插入。 |
LINKED
|
关联图表后,该图表即可更新,其他协作者将会看到指向电子表格的链接。 |
DeleteParagraphBulletsRequest
从与给定文本索引 range
重叠的所有段落中删除项目符号。
通过在相应段落的开头添加缩进,每个段落的嵌套级别都将在视觉上保留下来。
JSON 表示法 |
---|
{ "objectId": string, "cellLocation": { object ( |
字段 | |
---|---|
objectId
|
包含要删除项目符号的文本的形状或表格的对象 ID。 |
cellLocation
|
可选表格单元格的位置(如果要修改的文本位于表格单元格中)。如果存在,objectId 必须引用表。 |
textRange
|
要删除项目符号的文本范围,基于 |
UpdateParagraphStyleRequest
JSON 表示法 |
---|
{ "objectId": string, "cellLocation": { object ( |
字段 | |
---|---|
objectId
|
需要设置文本样式的形状或表格的对象 ID。 |
cellLocation
|
表格内要设置段落的单元格的位置。如果 |
style
|
段落的样式。 |
textRange
|
包含要设置的段落的文本范围。 |
fields
|
应更新的字段。
必须至少指定一个字段。根隐式意味着
例如,如需更新段落对齐方式,请将 如需将属性重置为默认值,请在字段掩码中包含其字段名称,但请勿设置字段本身。 |
UpdateTableBorderPropertiesRequest
更新 Table
中表格边框的属性。
JSON 表示法 |
---|
{ "objectId": string, "tableRange": { object ( |
字段 | |
---|---|
objectId
|
表格的对象 ID。 |
tableRange
|
表示要应用更新的表子集的表范围。如果未指定表范围,则更新将应用于整个表。 |
borderPosition
|
表格应该使用的边框位置。如果未指定边框位置,更新将应用于表格范围中的所有边框。 |
tableBorderProperties
|
要更新的表格边框属性。 |
fields
|
应更新的字段。
必须至少指定一个字段。根隐式意味着
例如,如需更新表格边框纯色颜色,请将 如需将属性重置为默认值,请在字段掩码中包含其字段名称,但请勿设置字段本身。 |
边框位置
表格边框位置。
枚举 | |
---|---|
ALL
|
范围内的所有边框。 |
BOTTOM
|
范围底部的边框。 |
INNER
|
范围内部的边框。 |
INNER_HORIZONTAL
|
范围内部的水平边框。 |
INNER_VERTICAL
|
范围内部的垂直边框。 |
LEFT
|
范围左侧的边框。 |
OUTER
|
范围之外的边框。 |
RIGHT
|
范围右侧的边框。 |
TOP
|
范围顶部的边框。 |
UpdateTableColumnPropertiesRequest
更新 Table
列的属性。
JSON 表示法 |
---|
{
"objectId": string,
"columnIndices": [
integer
],
"tableColumnProperties": {
object (
|
字段 | |
---|---|
objectId
|
表格的对象 ID。 |
columnIndices[]
|
以零为起点的索引,用于指定要更新的列。如果未提供索引,系统会更新表中的所有列。 |
tableColumnProperties
|
要更新的表列属性。
如果请求中 |
fields
|
应更新的字段。
必须至少指定一个字段。根隐式意味着
例如,如需更新列宽,请将 如果字段掩码包含“columnWidth”,但该属性处于未设置状态,则列宽将默认为 406400 EMU(32 点)。 |
UpdateTableRowPropertiesRequest
更新 Table
行的属性。
JSON 表示法 |
---|
{
"objectId": string,
"rowIndices": [
integer
],
"tableRowProperties": {
object (
|
字段 | |
---|---|
objectId
|
表格的对象 ID。 |
rowIndices[]
|
以零为单位的索引,用于指定要更新的行。如果未提供索引,则该表中的所有行都将更新。 |
tableRowProperties
|
要更新的表格行属性。 |
fields
|
应更新的字段。
必须至少指定一个字段。根隐式意味着
例如,如需更新最小行高,请将 如果字段掩码包含“minRowHeight”,但属性未设置,则最小行高将默认为 0。 |
MergeTableCellsRequest
合并 Table
中的单元格。
JSON 表示法 |
---|
{
"objectId": string,
"tableRange": {
object (
|
字段 | |
---|---|
objectId
|
表格的对象 ID。 |
tableRange
|
指定要合并的表单元格的表范围。 被合并的单元格中的任何文本都会串联起来,并存储在相应范围的左上角(“head”)单元格中。如果范围是非矩形(在某些情况下,当范围涵盖已合并的单元格时,系统会返回 400 错误请求错误)。 |
UnmergeTableCellsRequest
取消合并 Table
中的单元格。
JSON 表示法 |
---|
{
"objectId": string,
"tableRange": {
object (
|
字段 | |
---|---|
objectId
|
表格的对象 ID。 |
tableRange
|
用于指定要取消合并的表格单元格的表范围。 此范围中的所有已合并单元格将被取消合并,尚未合并的单元格不会受到影响。如果范围内没有合并的单元格,则请求不执行任何操作。如有任何合并单元格内有文本,则相应文本将保留在转换后未合并单元格的左上角(“头部”)单元格中。 |
GroupObjectsRequest
对对象进行分组以创建对象组。例如,对 PageElements
进行分组以创建与所有子级相同的网页上的 Group
。
JSON 表示法 |
---|
{ "groupObjectId": string, "childrenObjectIds": [ string ] } |
字段 | |
---|---|
groupObjectId
|
用户为要创建的群组提供的对象 ID。
如果您指定了 ID,则该 ID 在演示文稿的所有页面和页面元素中必须是唯一的。ID 必须以字母数字字符或下划线(与正则表达式 如果您未指定 ID,系统会生成唯一的 ID。 |
childrenObjectIds[]
|
要分组的对象的对象 ID。
只能对页面元素进行分组。同一网页上应至少有两个尚未存在于其他组的网页元素。某些页面元素(如 |
UngroupObjectsRequest
为对象取消分组,例如 groups
。
JSON 表示法 |
---|
{ "objectIds": [ string ] } |
字段 | |
---|---|
objectIds[]
|
要分组的对象的对象 ID。
只能将不在其他 |
UpdatePageElementAltTextRequest
更新 page element
的替代文本标题和/或说明。
JSON 表示法 |
---|
{ "objectId": string, "title": string, "description": string } |
字段 | |
---|---|
objectId
|
应用更新的页面元素的对象 ID。 |
title
|
更新后的页面元素替代文本标题。如果未设置,将保留现有值。标题会展示给屏幕阅读器和其他无障碍界面。仅使用与网页元素内容相关的人类可读值。 |
description
|
更新后的页面元素替代文本说明。如果未设置,将保留现有值。此说明会展示给屏幕阅读器和其他无障碍界面。仅使用与网页元素内容相关的人类可读值。 |
替换图片请求
用新图片替换现有图片。
替换映像将从现有映像中移除一些 image effects
。
JSON 表示法 |
---|
{ "imageObjectId": string, "imageReplaceMethod": enum ( |
字段 | |
---|---|
imageObjectId
|
要替换的现有图片的 ID。可以从 get 请求的响应中检索该 ID。 |
imageReplaceMethod
|
替换方法。 |
联合字段 image_source 。图片来源的类型。
image_source 只能是下列其中一项:
|
|
url
|
图片网址。 系统会在插入时获取图片一次,并存储副本以在演示文稿内显示。图片必须小于 50MB,不能超过 2500 万像素,并且必须采用 PNG、JPEG 或 GIF 格式。
提供的网址不能超过 2 KB。该网址会随图片一起保存,并通过 |
UpdateSlidePropertiesRequest
更新幻灯片的属性。
JSON 表示法 |
---|
{
"objectId": string,
"slideProperties": {
object (
|
字段 | |
---|---|
objectId
|
应用更新的幻灯片的对象 ID。 |
slideProperties
|
要更新的幻灯片属性。 |
fields
|
应更新的字段。
必须至少指定一个字段。暗示了根“slideProperties”,不得指定。单个
例如,如需更新是否跳过幻灯片,请将 如需将属性重置为默认值,请在字段掩码中包含其字段名称,但请勿设置字段本身。 |
UpdatePageElementZOrderRequest
更新页面元素的 Z 轴顺序。Z 轴顺序是从高到低的顺序排列页面上的元素。前面的页面元素可能会覆盖它后面的元素。
JSON 表示法 |
---|
{
"pageElementObjectIds": [
string
],
"operation": enum (
|
字段 | |
---|---|
pageElementObjectIds[]
|
要更新的页面元素的对象 ID。 所有页面元素都必须位于同一页面上,且不得分组。 |
operation
|
要应用到页面元素的 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 (
|
字段 | |
---|---|
objectId
|
应用更新的行的对象 ID。
只能更新带有 线条可能会在更新其类别后重新规划。 |
lineCategory
|
要更新的订单项类别。
确切的 |
RerouteLineRequest
重新路由 line
,使其在连接页面元素上的两个最近连接点处进行连接。
JSON 表示法 |
---|
{ "objectId": string } |
字段 | |
---|---|
objectId
|
要重新路由的线路的对象 ID。
只能重新路由包含 |