收款
要应用于文档的单个更新。
JSON 表示法 |
---|
{ // Union field |
田野 | |
---|---|
联合字段
request 。要应用的具体请求。仅需要一个字段。
request
只能是下列其中一项:
|
|
replaceAllText
|
替换指定文本的所有实例。 |
insertText
|
在指定位置插入文本。 |
updateTextStyle
|
更新指定范围的文本样式。 |
createParagraphBullets
|
为段落创建项目符号。 |
deleteParagraphBullets
|
从段落中删除项目符号。 |
createNamedRange
|
创建一个命名范围。 |
deleteNamedRange
|
删除命名范围。 |
updateParagraphStyle
|
更新指定范围内的段落样式。 |
deleteContentRange
|
从文档中删除内容。 |
insertInlineImage
|
在指定位置插入内嵌图片。 |
insertTable
|
在指定位置插入表格。 |
insertTableRow
|
在表中插入一个空行。 |
insertTableColumn
|
在表中插入一个空列。 |
deleteTableRow
|
从表中删除行。 |
deleteTableColumn
|
从表中删除列。 |
insertPageBreak
|
在指定位置插入分页符。 |
deletePositionedObject
|
从文档中删除已定位的对象。 |
updateTableColumnProperties
|
更新表中列的属性。 |
updateTableCellStyle
|
更新表格单元格的样式。 |
updateTableRowStyle
|
更新表中的行样式。 |
replaceImage
|
替换文档中的图片。 |
updateDocumentStyle
|
更新文档的样式。 |
mergeTableCells
|
合并表格中的单元格。 |
unmergeTableCells
|
取消合并表格中的单元格。 |
createHeader
|
创建一个标头。 |
createFooter
|
创建页脚。 |
createFootnote
|
创建脚注。 |
replaceNamedRangeContent
|
替换命名范围中的内容。 |
updateSectionStyle
|
更新指定范围的版块样式。 |
insertSectionBreak
|
在指定位置插入分节符。 |
deleteHeader
|
从文档中删除标头。 |
deleteFooter
|
从文档中删除页脚。 |
pinTableHeaderRows
|
更新表中固定标题行的数量。 |
ReplaceAllTextRequest
将符合某个条件的所有文本实例替换为
replace text
。
JSON 表示法 |
---|
{ "replaceText": string, "tabsCriteria": { object ( |
田野 | |
---|---|
replaceText
|
将用于替换匹配文本的文本。 |
tabsCriteria
|
可选。用于指定在哪些标签页中进行替换的条件。 如果省略,替换项会应用于所有标签页。 在包含单个标签页的文档中:
在包含多个标签页的文档中:
|
联合字段
criteria 。用于匹配要替换的文本的条件。
criteria
只能是下列其中一项:
|
|
containsText
|
在文档中查找与此子字符串匹配的文本。 |
SubstringMatchCriteria
与文档中的特定文本字符串匹配的条件。
JSON 表示法 |
---|
{ "text": string, "matchCase": boolean } |
田野 | |
---|---|
text
|
要在文档中搜索的文本。 |
matchCase
|
指示搜索是否应遵循大小写:
|
TabsCriteria
指定请求在哪些标签页中执行的条件。
JSON 表示法 |
---|
{ "tabIds": [ string ] } |
田野 | |
---|---|
tabIds[]
|
在其中执行请求的标签页 ID 的列表。 |
InsertTextRequest
在指定位置插入文本。
JSON 表示法 |
---|
{ "text": string, // Union field |
田野 | |
---|---|
text
|
要插入的文本。
插入换行符会隐式创建一个新的
系统会自动确定所插入文字的文字样式,通常会保留相邻文字的样式。在大多数情况下,所插入文字的文字样式与插入索引前的文字一致。 插入的文本中将删除部分控制字符(U+0000-U+0008、U+000C-U+001F)和 Unicode 基本多语言平面专用区域 (U+E000-U+F8FF) 中的字符。 |
联合字段
insertion_location 。要插入文本的位置。
insertion_location
只能是下列其中一项:
|
|
location
|
在文档的特定索引处插入文本。
文本必须插入现有文本的边界内
|
endOfSegmentLocation
|
在页眉、页脚、脚注或文档正文的末尾插入文本。 |
位置
文档中的特定位置。
JSON 表示法 |
---|
{ "segmentId": string, "index": integer, "tabId": string } |
田野 | |
---|---|
segmentId
|
营业地点所在的页眉、页脚或脚注的 ID。空的细分 ID 表示文档正文。 |
index
|
从零开始的索引,采用 UTF-16 代码单元。
索引相对于由 指定的片段的开头
|
tabId
|
营业地点所在的标签页。如果省略此参数,则请求将应用于第一个标签页。 在包含单个标签页的文档中:
在包含多个标签页的文档中:
|
EndOfSegmentLocation
正文、页眉、页脚或脚注末尾的位置。该位置紧跟在文档段中最后一个换行符的前面。
JSON 表示法 |
---|
{ "segmentId": string, "tabId": string } |
田野 | |
---|---|
segmentId
|
营业地点所在的页眉、页脚或脚注的 ID。空细分受众群 ID 表示文档正文。 |
tabId
|
营业地点所在的标签页。如果省略此参数,则请求将应用于第一个标签页。 在包含单个标签页的文档中:
在包含多个标签页的文档中:
|
UpdateTextStyleRequest
更新文本样式。
JSON 表示法 |
---|
{ "textStyle": { object ( |
田野 | |
---|---|
textStyle
|
要为文本设置的样式。 如果特定样式的值与父样式的值匹配,则该样式将设为继承。
为了反映文档编辑器的行为,某些文字样式更改可能会导致其他更改。请参阅
|
fields
|
应更新的字段。
必须至少指定一个字段。根
例如,要将文本样式更新为粗体,可将
要将属性重置为默认值,请在字段掩码中添加其字段名称,但不设置字段本身。 |
联合字段
insertion_location 。用于更新文本样式的范围的类型。
insertion_location
只能是下列其中一项:
|
|
range
|
要设置样式的文本范围。 可以扩展范围以包括相邻的换行符。 如果该范围中完全包含属于某个列表的段落,则该段落的项目符号也会更新为匹配的文本样式。 无法在相对 UpdateTextStyleRequest 内插入范围。 |
CreateParagraphBulletsRequest
为与指定范围重叠的所有段落创建项目符号。
每个段落的嵌套级别通过计算每个段落前面的前导制表符来确定。为避免项目符号与相应段落之间留出过多空间,此请求移除了这些前置制表符。这可能会更改文本的各部分索引。
如果要更新的段落前面的段落所在的列表具有匹配预设,则要更新的段落会添加到前面的列表中。
JSON 表示法 |
---|
{ "range": { object ( |
田野 | |
---|---|
range
|
要应用项目符号预设的范围。 |
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”。 -
DECIMAL
:“1”、“2”或“3”等数字。 -
ZERODECIMAL
:单个数字以零为前缀的数字,例如“01”、“02”或“03”。多位数的数字不加前缀 0。 -
ROMAN
:小写罗马数字,如“i”、“ii”或“iii”。 -
UPPERROMAN
:大写罗马数字,如“I”、“II”或“III”。 -
LEFTTRIANGLE
:指向左边的三角形,对应 Unicode U+25c4 代码点
枚举 | |
---|---|
BULLET_GLYPH_PRESET_UNSPECIFIED
|
未指定项目符号预设。 |
BULLET_DISC_CIRCLE_SQUARE
|
带有
DISC ,
CIRCLE
和
SQUARE
前 3 个列表嵌套级别的项目符号。
|
BULLET_DIAMONDX_ARROW3D_SQUARE
|
带有
DIAMONDX ,
ARROW3D
和
SQUARE
前 3 个列表嵌套级别的项目符号。
|
BULLET_CHECKBOX
|
项目符号列表
CHECKBOX
所有列表嵌套级别的项目符号符号。
|
BULLET_ARROW_DIAMOND_DISC
|
带有
ARROW ,
DIAMOND
和
DISC
前 3 个列表嵌套级别的项目符号。
|
BULLET_STAR_CIRCLE_SQUARE
|
带有
STAR ,
CIRCLE
和
SQUARE
前 3 个列表嵌套级别的项目符号。
|
BULLET_ARROW3D_CIRCLE_SQUARE
|
带有
ARROW3D ,
CIRCLE
和
SQUARE
前 3 个列表嵌套级别的项目符号。
|
BULLET_LEFTTRIANGLE_DIAMOND_DISC
|
带有
LEFTTRIANGLE ,
DIAMOND
和
DISC
前 3 个列表嵌套级别的项目符号。
|
BULLET_DIAMONDX_HOLLOWDIAMOND_SQUARE
|
带有
DIAMONDX ,
HOLLOWDIAMOND
和
SQUARE
前 3 个列表嵌套级别的项目符号。
|
BULLET_DIAMOND_CIRCLE_SQUARE
|
带有
DIAMOND ,
CIRCLE
和
SQUARE
前 3 个列表嵌套级别的项目符号。
|
NUMBERED_DECIMAL_ALPHA_ROMAN
|
编号列表
DECIMAL ,
ALPHA
和
ROMAN
前 3 个列表嵌套级别的数字字形,后跟英文句点。
|
NUMBERED_DECIMAL_ALPHA_ROMAN_PARENS
|
编号列表
DECIMAL ,
ALPHA
和
ROMAN
前 3 个列表嵌套级别的数字字形,后跟圆括号。
|
NUMBERED_DECIMAL_NESTED
|
编号列表
DECIMAL
以句点分隔的数字字形,其中每个嵌套级别都使用前一个嵌套级别的字形作为前缀。例如:“1.”。“1.1.”“2.”、“2.2.”。
|
NUMBERED_UPPERALPHA_ALPHA_ROMAN
|
编号列表
UPPERALPHA ,
ALPHA
和
ROMAN
前 3 个列表嵌套级别的数字字形,后跟英文句点。
|
NUMBERED_UPPERROMAN_UPPERALPHA_DECIMAL
|
编号列表
UPPERROMAN ,
UPPERALPHA
和
DECIMAL
前 3 个列表嵌套级别的数字字形,后跟英文句点。
|
NUMBERED_ZERODECIMAL_ALPHA_ROMAN
|
编号列表
ZERODECIMAL ,
ALPHA
和
ROMAN
前 3 个列表嵌套级别的数字字形,后跟英文句点。
|
DeleteParagraphBulletsRequest
从与指定范围重叠的所有段落中删除项目符号。
系统会在相应段落的开头添加缩进,从而直观地保留每个段落的嵌套级别。
JSON 表示法 |
---|
{
"range": {
object (
|
田野 | |
---|---|
range
|
要删除项目符号的范围。 |
CreateNamedRangeRequest
创建
NamedRange
引用指定范围的数据。
JSON 表示法 |
---|
{
"name": string,
"range": {
object (
|
田野 | |
---|---|
name
|
NamedRange 的名称。名称不必是唯一的。 名称必须至少包含 1 个字符,且不超过 256 个字符(以 UTF-16 代码单元衡量)。 |
range
|
要应用名称的范围。 |
DeleteNamedRangeRequest
删除
NamedRange
。
JSON 表示法 |
---|
{ "tabsCriteria": { object ( |
田野 | |
---|---|
tabsCriteria
|
可选。用于指定应在哪些标签页中删除范围的条件。如果省略此参数,删除范围会应用于所有标签页。 在包含单个标签页的文档中:
在包含多个标签页的文档中:
|
联合字段
named_range_reference 。用于确定要删除的范围的值。您只能设置一个。
named_range_reference
只能是下列其中一项:
|
|
namedRangeId
|
要删除的命名范围的 ID。 |
name
|
要删除的范围的名称。具有给定名称的所有命名范围都将被删除。 |
UpdateParagraphStyleRequest
更新与指定范围重叠的所有段落的样式。
JSON 表示法 |
---|
{ "paragraphStyle": { object ( |
田野 | |
---|---|
paragraphStyle
|
要在段落上设置的样式。
为了反映文档编辑器的行为,某些段落样式可能会造成其他更改。请参阅
|
fields
|
应更新的字段。
必须至少指定一个字段。根
例如,要更新段落样式的对齐属性,请将
要将属性重置为默认值,请在字段掩码中添加其字段名称,但不设置字段本身。 |
联合字段
insertion_location 。用于更新段落样式的范围类型。
insertion_location
只能是下列其中一项:
|
|
range
|
与段落重叠的范围设置样式。 |
DeleteContentRangeRequest
从文档中删除内容。
JSON 表示法 |
---|
{
"range": {
object (
|
田野 | |
---|---|
range
|
要删除的内容的范围。 删除跨越段落边界的文本可能会导致两个段落合并后,段落样式、列表、定位对象和书签发生变化。 尝试删除特定范围可能会导致文档结构无效,在这种情况下,系统会返回 400 错误请求错误。 无效删除请求的一些示例包括:
|
InsertInlineImageRequest
会在
InlineObject
包含指定位置的图片。
JSON 表示法 |
---|
{ "uri": string, "objectSize": { object ( |
田野 | |
---|---|
uri
|
映像 URI。 在插入时,系统会提取一次图片,并存储副本以便在文档内展示。图片必须小于 50MB,不能超过 2500 万像素,并且必须是 PNG、JPEG 或 GIF 格式之一。
提供的 URI 必须可公开访问,并且长度不得超过 2 kB。URI 本身与图片一起保存,并通过
|
objectSize
|
图片在文档中应显示的尺寸。此属性是可选的,文档中图片的最终尺寸由以下规则决定:* 如果未指定宽度和高度,则会根据图片的分辨率计算图片的默认尺寸。* 如果指定了其中一个尺寸,则计算另一个尺寸以保持图片的宽高比。* 如果同时指定了宽度和高度,则系统会对图片进行缩放,使其适合指定的尺寸,同时保持其宽高比。 |
联合字段
insertion_location 。要插入图片的位置。
insertion_location
只能是下列其中一项:
|
|
location
|
在文档的特定索引处插入图片。
图片必须插入到现有图片的边界内
内嵌图片无法插入到脚注或等式中。 |
endOfSegmentLocation
|
在页眉、页脚或文档正文的末尾插入文本。 内嵌图片无法插入到脚注中。 |
InsertTableRequest
在指定位置插入表格。
系统会在插入的表格前插入换行符。
JSON 表示法 |
---|
{ "rows": integer, "columns": integer, // Union field |
田野 | |
---|---|
rows
|
表中的行数。 |
columns
|
表中的列数。 |
联合字段
insertion_location 。要插入表格的位置。
insertion_location
只能是下列其中一项:
|
|
location
|
在特定模型索引处插入表。 系统会在插入的表之前插入换行符,因此表的起始索引将位于指定位置索引 + 1 处。
表格必须插入到现有表格的边界内。
表格无法插入到脚注或等式中。 |
endOfSegmentLocation
|
在给定页眉、页脚或文档正文的末尾插入表格。系统会在插入的表格前插入换行符。 无法在脚注中插入表格。 |
InsertTableRowRequest
在表中插入一个空行。
JSON 表示法 |
---|
{
"tableCellLocation": {
object (
|
田野 | |
---|---|
tableCellLocation
|
要插入行的引用表单元格的位置。 系统会在引用单元格所在行的上方(或下方)插入一个新行。如果引用单元格是合并单元格,系统会在合并单元格的上方(或下方)插入新行。 |
insertBelow
|
是否在引用单元格位置下方插入新行。
|
TableCellLocation
表格中单个单元格的位置。
JSON 表示法 |
---|
{
"tableStartLocation": {
object (
|
田野 | |
---|---|
tableStartLocation
|
表格在文档中开始的位置。 |
rowIndex
|
从零开始的行索引。例如,表中第二行的行索引为 1。 |
columnIndex
|
从零开始的列索引。例如,表中第二列的列索引为 1。 |
InsertTableColumnRequest
在表中插入一个空列。
JSON 表示法 |
---|
{
"tableCellLocation": {
object (
|
田野 | |
---|---|
tableCellLocation
|
要插入列的参考表格单元格位置。 系统会在引用单元格所在列的左侧(或右侧)插入一个新列。如果引用单元格是合并单元格,系统会在合并单元格的左侧(或右侧)插入一个新列。 |
insertRight
|
是否在引用单元格位置的右侧插入新列。
|
DeleteTableRowRequest
从表中删除行。
JSON 表示法 |
---|
{
"tableCellLocation": {
object (
|
田野 | |
---|---|
tableCellLocation
|
要删除行的参考表格单元格位置。 此单元格跨越的行将被删除。如果这是一个跨越多行的合并单元格,则该单元格跨越的所有行都将被删除。如果在执行此删除操作后表中没有保留的行,则整个表都将被删除。 |
DeleteTableColumnRequest
从表中删除列。
JSON 表示法 |
---|
{
"tableCellLocation": {
object (
|
田野 | |
---|---|
tableCellLocation
|
要删除引用表单元格的位置。 此单元格跨越的列将被删除。如果这是一个跨列的合并单元格,则该单元格跨越的所有列都将被删除。如果在执行此删除操作后,表中没有保留的列,则整个表都会被删除。 |
InsertPageBreakRequest
在指定位置插入分页符,后接换行符。
JSON 表示法 |
---|
{ // Union field |
田野 | |
---|---|
联合字段
insertion_location 。要插入分页符的位置。
insertion_location
只能是下列其中一项:
|
|
location
|
在文档的特定索引处插入分页符。
分页符必须插入到现有
无法在表格、等式、脚注、页眉或页脚中插入分页符。由于分页符只能插入到正文内部,因此
|
endOfSegmentLocation
|
在文档正文的末尾插入分页符。
不能在脚注、页眉或页脚中插入分页符。由于分页符只能插入到正文内部,因此
|
DeletePositionedObjectRequest
删除
PositionedObject
文档。
JSON 表示法 |
---|
{ "objectId": string, "tabId": string } |
田野 | |
---|---|
objectId
|
要删除的定位对象的 ID。 |
tabId
|
要删除的定位对象所在的标签页。如果省略此参数,则请求将应用于第一个标签页。 在包含单个标签页的文档中:
在包含多个标签页的文档中:
|
UpdateTableColumnPropertiesRequest
更新
TableColumnProperties
表中列的集合。
JSON 表示法 |
---|
{ "tableStartLocation": { object ( |
田野 | |
---|---|
tableStartLocation
|
表格在文档中开始的位置。 |
columnIndices[]
|
应更新其属性的列索引列表(从零开始)。如果未指定索引,系统将更新所有列。 |
tableColumnProperties
|
要更新的表格列属性。
如果
|
fields
|
应更新的字段。
必须至少指定一个字段。根
例如,要更新列宽,请将
|
UpdateTableCellStyleRequest
更新表格单元格范围的样式。
JSON 表示法 |
---|
{ "tableCellStyle": { object ( |
田野 | |
---|---|
tableCellStyle
|
要在表格单元格中设置的样式。 更新边框时,如果某个单元格与相邻单元格共用边框,则相邻单元格的相应边框属性也会随之更新。合并后不可见的边框不会更新。 由于更新同一请求中相邻单元格共享的边框可能会导致边框更新出现冲突,因此边框更新按以下顺序应用:
|
fields
|
应更新的字段。
必须至少指定一个字段。根
例如,要更新表格单元格的背景颜色,请将
要将属性重置为默认值,请在字段掩码中添加其字段名称,但不设置字段本身。 |
联合字段
cells 。要更新的单元格。
cells
只能是下列其中一项:
|
|
tableRange
|
表格范围,表示要应用更新的表格子集。 |
tableStartLocation
|
表格在文档中开始的位置。指定后,更新将应用于表格中的所有单元格。 |
TableRange
表格范围表示对表格子集的引用。
请务必注意,由表格范围指定的单元格不一定会形成矩形。例如,假设我们有一个 3 x 3 的表格,其中最后一行的所有单元格都合并在一起。表格如下所示:
[ ][ ][ ]
[ ][ ][ ]
[ ]
如果一个表格范围中的表格单元格位置为 = (tableStartLocation, 行 = 0, 列 = 0),行 span = 3 且列 span = 2,则会指定以下单元格:
[ x ][ x ][ ]
[ x ][ x ][ ]
[ x x x ]
JSON 表示法 |
---|
{
"tableCellLocation": {
object (
|
田野 | |
---|---|
tableCellLocation
|
表格范围开始的单元格位置。 |
rowSpan
|
表范围的行跨度。 |
columnSpan
|
表格范围的列跨度。 |
UpdateTableRowStyleRequest
更新
TableRowStyle
表格中行的一系列行。
JSON 表示法 |
---|
{ "tableStartLocation": { object ( |
田野 | |
---|---|
tableStartLocation
|
表格在文档中开始的位置。 |
rowIndices[]
|
应更新其样式的行索引列表(从零开始)。如果未指定索引,系统将更新所有行。 |
tableRowStyle
|
要为行设置的样式。 |
fields
|
应更新的字段。
必须至少指定一个字段。根
例如,要更新最小行高,请将
|
ReplaceImageRequest
使用新图片替换现有图片。
替换图片会移除一些
image effects
以便反映文档编辑器的行为。
JSON 表示法 |
---|
{
"imageObjectId": string,
"uri": string,
"imageReplaceMethod": enum (
|
田野 | |
---|---|
imageObjectId
|
要替换的现有图片的 ID。该 ID 可从 get 请求的响应中检索到。 |
uri
|
新图片的 URI。 在插入时,系统会提取一次图片,并存储副本以便在文档内展示。图片必须小于 50MB,不能超过 2500 万像素,并且必须采用 PNG、JPEG 或 GIF 格式。
提供的 URI 的长度不能超过 2 KB。URI 随图片一起保存,并通过
|
imageReplaceMethod
|
替换方法。 |
tabId
|
要替换的图片所在的标签页。如果省略此参数,则请求将应用于第一个标签页。 在包含单个标签页的文档中:
在包含多个标签页的文档中:
|
ImageReplaceMethod
图片替换方法。
枚举 | |
---|---|
IMAGE_REPLACE_METHOD_UNSPECIFIED
|
未指定的图片替换方法。不得使用此值。 |
CENTER_CROP
|
缩放图片并将其居中,以填充原始图片的边界。图片可能会被剪裁,以填充原始图片的边界。图片的渲染尺寸与原始图片相同。 |
UpdateDocumentStyleRequest
更新
DocumentStyle
。
JSON 表示法 |
---|
{
"documentStyle": {
object (
|
田野 | |
---|---|
documentStyle
|
要在文档上设置的样式。
为了反映文档编辑器的行为,某些文档样式更改可能会导致其他更改。请参阅
|
fields
|
应更新的字段。
必须至少指定一个字段。根
例如,要更新背景,请将
|
tabId
|
包含要更新的样式的标签页。如果省略此参数,则请求会应用于第一个标签页。 在包含单个标签页的文档中:
在包含多个标签页的文档中:
|
MergeTableCellsRequest
合并单元格中的单元格
Table
。
JSON 表示法 |
---|
{
"tableRange": {
object (
|
田野 | |
---|---|
tableRange
|
表格范围,用于指定要合并的表格中的哪些单元格。 要合并的单元格中的任何文本都会串联起来并存储在“head”中单元格。当内容方向为从左到右时,此单元格为范围的左上角单元格,否则为范围的右上方单元格。 如果范围是非矩形(在某些情况下,范围包括已合并的单元格或表格为非矩形就会出现这种情况),系统会返回 400 错误请求错误。 |
UnmergeTableCellsRequest
取消合并
Table
。
JSON 表示法 |
---|
{
"tableRange": {
object (
|
田野 | |
---|---|
tableRange
|
表格范围,用于指定要取消合并的表格单元格。 系统会取消合并此范围中的所有已合并单元格,而已取消合并的单元格不会受到影响。如果范围中没有合并的单元格,则请求将不执行任何操作。 如果任何合并单元格中有文本,这些文本将保留在“标题”单元格中生成的未合并单元格块的单元格。“头”当内容方向是从左到右时,单元格位于左上角,否则位于右上角。 |
CreateHeaderRequest
创建
Header
。新标题会应用于
SectionStyle
在
SectionBreak
否则,将应用于
DocumentStyle
。
如果指定类型的标头已存在,则返回 400 错误请求错误。
JSON 表示法 |
---|
{ "type": enum ( |
田野 | |
---|---|
type
|
要创建的标头类型。 |
sectionBreakLocation
|
该
|
CreateFootnoteRequest
创建
Footnote
并将新的
FootnoteReference
指定位置。
新的
Footnote
细分将包含空格后跟换行符。
JSON 表示法 |
---|
{ // Union field |
田野 | |
---|---|
联合字段
footnote_reference_location 。要插入脚注引用的位置。
footnote_reference_location
只能是下列其中一项:
|
|
location
|
在文档中的特定索引处插入脚注引用。
脚注引用必须插入现有
脚注引用不能插入到等式、页眉、页脚或脚注中。由于脚注引用只能插入正文中,
|
endOfSegmentLocation
|
在文档正文的末尾插入脚注引用。
脚注引用不能插入到页眉、页脚或脚注中。由于脚注引用只能插入正文中,
|
ReplaceNamedRangeContentRequest
替换指定
NamedRange
或
NamedRanges
替换内容。
请注意,
NamedRange
可能由多次不连续的
ranges
。在这种情况下,只会替换第一个范围中的内容。其他范围及其内容将被删除。
如果替换或删除任何范围会导致文档结构无效,系统将返回 400 错误请求错误。
JSON 表示法 |
---|
{ "tabsCriteria": { object ( |
田野 | |
---|---|
tabsCriteria
|
可选。用于指定在哪些标签页中进行替换的条件。如果省略,替换项会应用于所有标签页。 在包含单个标签页的文档中:
在包含多个标签页的文档中:
|
联合字段
replacement_content 。要用来替换命名范围的现有内容的内容。
replacement_content
只能是下列其中一项:
|
|
text
|
使用给定文本替换指定命名范围的内容。 |
联合字段
named_range_reference 。对要替换其内容的命名范围的引用。
named_range_reference
只能是下列其中一项:
|
|
namedRangeId
|
要替换其内容的命名范围的 ID。 如果不存在具有指定 ID 的命名范围,系统会返回 400 错误请求错误。 |
namedRangeName
|
该
如果有多个
|
UpdateSectionStyleRequest
更新
SectionStyle
。
JSON 表示法 |
---|
{ "range": { object ( |
田野 | |
---|---|
range
|
与要设置样式的版块重叠的范围。
由于分节符只能插入正文内部,因此
|
sectionStyle
|
要在版块上设置的样式。
为了反映文档编辑器的行为,某些版块样式更改可能会导致其他更改。请参阅
|
fields
|
应更新的字段。
必须至少指定一个字段。根
例如,要更新左外边距,请将
|
InsertSectionBreakRequest
在指定位置插入分节符。
系统会在分节符前插入换行符。
JSON 表示法 |
---|
{ "sectionType": enum ( |
田野 | |
---|---|
sectionType
|
要插入的部分的类型。 |
联合字段
insertion_location 。要插入换行符的位置。
insertion_location
只能是下列其中一项:
|
|
location
|
在文档的特定索引处插入换行符和分节符。
分节符必须插入现有分节符的边界内。
无法在表格、等式、脚注、页眉或页脚中插入分节符。由于分节符只能插入正文内部,因此
|
endOfSegmentLocation
|
在文档正文的末尾插入换行符和分节符。
不能在脚注、页眉或页脚中插入分节符。由于分节符只能插入正文内部,因此
|
DeleteHeaderRequest
删除
Header
文档。
JSON 表示法 |
---|
{ "headerId": string, "tabId": string } |
田野 | |
---|---|
headerId
|
要删除的标头的 ID。如果该标头是在
|
tabId
|
包含要删除的标题的标签页。如果省略此参数,则请求将应用于第一个标签页。 在包含单个标签页的文档中:
在包含多个标签页的文档中:
|
PinTableHeaderRowsRequest
更新表中固定的表格标题行数。
JSON 表示法 |
---|
{
"tableStartLocation": {
object (
|
田野 | |
---|---|
tableStartLocation
|
表格在文档中开始的位置。 |
pinnedHeaderRowsCount
|
要固定的表格行数,其中 0 表示取消固定所有行。 |