Yêu cầu
Một nội dung cập nhật duy nhất áp dụng cho một tài liệu.
Biểu diễn dưới dạng JSON |
---|
{ // Union field |
Các trường | |
---|---|
Trường nhóm request . Yêu cầu cụ thể để đăng ký. Chỉ có đúng một trường là bắt buộc.
request chỉ có thể là một trong những loại sau đây:
|
|
replaceAllText
|
Thay thế tất cả các bản sao của văn bản được chỉ định. |
insertText
|
Chèn văn bản tại vị trí đã chỉ định. |
updateTextStyle
|
Cập nhật kiểu văn bản trong dải ô được chỉ định. |
createParagraphBullets
|
Tạo dấu đầu dòng cho đoạn văn bản. |
deleteParagraphBullets
|
Xóa dấu đầu dòng khỏi đoạn. |
createNamedRange
|
Tạo một dải ô được đặt tên. |
deleteNamedRange
|
Xóa một dải ô được đặt tên. |
updateParagraphStyle
|
Cập nhật kiểu đoạn văn trong phạm vi chỉ định. |
deleteContentRange
|
Xóa nội dung khỏi tài liệu. |
insertInlineImage
|
Chèn một hình ảnh nội dòng tại vị trí đã chỉ định. |
insertTable
|
Chèn bảng tại vị trí đã chỉ định. |
insertTableRow
|
Chèn một hàng trống vào bảng. |
insertTableColumn
|
Chèn một cột trống vào bảng. |
deleteTableRow
|
Xóa một hàng khỏi bảng. |
deleteTableColumn
|
Xóa một cột khỏi bảng. |
insertPageBreak
|
Chèn ngắt trang tại vị trí đã chỉ định. |
deletePositionedObject
|
Xoá đối tượng đã định vị khỏi tài liệu. |
updateTableColumnProperties
|
Cập nhật thuộc tính của các cột trong bảng. |
updateTableCellStyle
|
Cập nhật kiểu của ô trong bảng. |
updateTableRowStyle
|
Cập nhật kiểu hàng trong bảng. |
replaceImage
|
Thay thế hình ảnh trong tài liệu. |
updateDocumentStyle
|
Cập nhật kiểu của tài liệu. |
mergeTableCells
|
Hợp nhất ô trong bảng. |
unmergeTableCells
|
Hủy hợp nhất ô trong bảng. |
createHeader
|
Tạo tiêu đề. |
createFooter
|
Tạo chân trang. |
createFootnote
|
Tạo chú thích cuối trang. |
replaceNamedRangeContent
|
Thay thế nội dung trong dải ô được đặt tên. |
updateSectionStyle
|
Cập nhật kiểu mục của dải ô chỉ định. |
insertSectionBreak
|
Chèn ngắt phần tại vị trí đã chỉ định. |
deleteHeader
|
Xóa tiêu đề khỏi tài liệu. |
deleteFooter
|
Xóa chân trang khỏi tài liệu. |
pinTableHeaderRows
|
Cập nhật số lượng hàng tiêu đề được ghim trong một bảng. |
Thay thế tất cả văn bản yêu cầu
Thay thế tất cả các trường hợp văn bản khớp với một tiêu chí bằng
replace text
.
Biểu diễn dưới dạng JSON |
---|
{ "replaceText": string, // Union field |
Các trường | |
---|---|
replaceText
|
Văn bản sẽ thay thế văn bản phù hợp. |
Trường nhóm criteria . Tiêu chí dùng để khớp với văn bản cần thay thế.
criteria chỉ có thể là một trong những loại sau đây:
|
|
containsText
|
Tìm văn bản trong tài liệu khớp với chuỗi con này. |
Tiêu chí so khớp chuỗi con
Tiêu chí khớp với một chuỗi văn bản cụ thể trong tài liệu.
Biểu diễn dưới dạng JSON |
---|
{ "text": string, "matchCase": boolean } |
Các trường | |
---|---|
text
|
Văn bản để tìm kiếm trong tài liệu. |
matchCase
|
Cho biết liệu cụm từ tìm kiếm có nên tuân thủ hay không:
|
Yêu cầu văn bản chèn
Chèn văn bản tại vị trí đã chỉ định.
Biểu diễn dưới dạng JSON |
---|
{ "text": string, // Union field |
Các trường | |
---|---|
text
|
Văn bản sẽ được chèn.
Việc chèn một ký tự dòng mới sẽ ngầm tạo một
Kiểu văn bản cho văn bản được chèn sẽ được xác định tự động, thường duy trì kiểu văn bản lân cận. Trong hầu hết các trường hợp, kiểu văn bản cho văn bản được chèn sẽ khớp với văn bản ngay trước chỉ mục chèn. Một số ký tự điều khiển (U + 0000-U + 0008, U + 000C-U + 001F) và các ký tự từ Vùng sử dụng riêng trên mặt phẳng đa ngôn ngữ Unicode Basic (U + E000-U + F8FF) sẽ bị xóa khỏi văn bản được chèn. |
Trường nhóm insertion_location . Vị trí sẽ chèn văn bản.
insertion_location chỉ có thể là một trong những loại sau đây:
|
|
location
|
Chèn văn bản vào một chỉ mục cụ thể trong tài liệu.
Bạn phải chèn văn bản vào bên trong giới hạn của một |
endOfSegmentLocation
|
Chèn văn bản ở cuối tiêu đề, chân trang, chú thích hoặc nội dung tài liệu. |
Vị trí
Vị trí cụ thể trong tài liệu.
Biểu diễn dưới dạng JSON |
---|
{ "segmentId": string, "index": integer } |
Các trường | |
---|---|
segmentId
|
Mã của đầu trang, chân trang hoặc chú thích cuối trang có vị trí đó. ID phân đoạn trống biểu thị nội dung của tài liệu. |
index
|
Chỉ mục gốc 0, theo đơn vị mã UTF-16.
Chỉ số này tương ứng với phần đầu của đoạn do |
Vị trí của phân đoạn cuối
Vị trí ở cuối nội dung, đầu trang, chân trang hoặc chú thích cuối trang. Vị trí này nằm ngay trước dòng mới cuối cùng trong phân đoạn tài liệu.
Biểu diễn dưới dạng JSON |
---|
{ "segmentId": string } |
Các trường | |
---|---|
segmentId
|
Mã của đầu trang, chân trang hoặc chú thích cuối trang có vị trí đó. ID phân đoạn trống biểu thị nội dung của tài liệu. |
UpdateTextStyleRequest
Cập nhật kiểu của văn bản.
Biểu diễn dưới dạng JSON |
---|
{ "textStyle": { object ( |
Các trường | |
---|---|
textStyle
|
Các kiểu để đặt trên văn bản. Nếu giá trị của một kiểu cụ thể khớp với kiểu gốc, thì kiểu đó sẽ được đặt thành kế thừa.
Một số thay đổi về kiểu văn bản có thể gây ra các thay đổi khác để phản ánh hành vi của trình chỉnh sửa Tài liệu. Hãy xem tài liệu về |
fields
|
Các trường cần được cập nhật.
Phải chỉ định ít nhất một trường. Gốc
Ví dụ: để cập nhật kiểu chữ thành in đậm, hãy đặt Để đặt lại thuộc tính về giá trị mặc định của nó, hãy bao gồm tên trường của nó trong mặt nạ trường nhưng không để trống trường đó. |
Trường nhóm insertion_location . Loại dải ô được sử dụng để cập nhật kiểu văn bản.
insertion_location chỉ có thể là một trong những loại sau đây:
|
|
range
|
Phạm vi văn bản để tạo kiểu. Dải ô có thể được mở rộng để bao gồm các dòng mới liền kề. Nếu dải ô chứa hoàn toàn một đoạn thuộc danh sách, thì dấu đầu dòng của đoạn đó cũng được cập nhật bằng kiểu văn bản phù hợp. Không thể chèn dải ô bên trong UpdateTextStyleRequest tương đối. |
Tạo Đoạn nội dung Dấu đầu dòng Yêu cầu
Tạo dấu đầu dòng cho tất cả các đoạn chồng chéo với dải ô đã cho.
Mức lồng ghép của từng đoạn văn sẽ được xác định bằng cách đếm số thẻ đứng trước mỗi đoạn. Để tránh thừa dấu cách giữa dấu đầu dòng và đoạn văn tương ứng, những thẻ đang ở đầu này sẽ bị xoá theo yêu cầu này. Thao tác này có thể thay đổi chỉ mục của các phần văn bản.
Nếu đoạn ngay trước khi các đoạn được cập nhật nằm trong danh sách có giá trị đặt trước phù hợp thì đoạn đó sẽ được thêm vào danh sách trước đó.
Biểu diễn dưới dạng JSON |
---|
{ "range": { object ( |
Các trường | |
---|---|
range
|
Dải ô để áp dụng giá trị đặt sẵn dấu đầu dòng. |
bulletPreset
|
Các loại ký tự dấu đầu dòng được sử dụng. |
Đặt lại BulletGlyph
Mẫu đặt sẵn của dấu đầu dòng cho danh sách.
Các mẫu này sử dụng những loại dấu đầu dòng sau:
-
ARROW
: Mũi tên, tương ứng với điểm mã Unicode U+2794 -
ARROW3D
: Mũi tên có tính năng tô bóng 3D, tương ứng với điểm mã Unicode U+27a2 -
CHECKBOX
: Một hình vuông rỗng, tương ứng với một điểm mã Unicode U+274f -
CIRCLE
: Một hình tròn rỗng, tương ứng với một điểm mã Unicode U+25cb -
DIAMOND
: Hình thoi đặc, tương ứng với điểm mã Unicode U+25c6 -
DIAMONDX
: Hình thoi có dấu 'x', tương ứng với điểm mã Unicode U+2756 -
HOLLOWDIAMOND
: Một hình thoi rỗng, tương ứng với một điểm mã Unicode U+25c7 -
DISC
: Một hình tròn đặc, tương ứng với một điểm mã Unicode U+25cf -
SQUARE
: Một hình vuông vững chắc, tương ứng với một điểm mã Unicode U+25a0 -
STAR
: Một dấu sao, tương ứng với một điểm mã Unicode U+2605 -
ALPHA
: Chữ cái viết thường, như 'a', 'b' hoặc 'c'. -
UPPERALPHA
: Một chữ cái viết hoa, như 'A', 'B' hoặc 'C'. -
DECIMAL
: Một số, chẳng hạn như '1', '2' hoặc '3'. -
ZERODECIMAL
: Một số có số đơn vị ở đầu số 0, chẳng hạn như '01', '02' hoặc '03'. Các số có nhiều hơn một chữ số không được bắt đầu bằng số 0. -
ROMAN
: Chữ số la mã viết thường, như 'i', 'ii' hoặc 'iii'. -
UPPERROMAN
: Chữ số la mã viết hoa, như 'I', 'II' hoặc 'III'. -
LEFTTRIANGLE
: Hình tam giác trỏ sang trái, tương ứng với một điểm mã Unicode U+25c4
Enum | |
---|---|
BULLET_GLYPH_PRESET_UNSPECIFIED
|
Giá trị đặt trước cho dấu đầu dòng không được chỉ định. |
BULLET_DISC_CIRCLE_SQUARE
|
Danh sách có dấu đầu dòng gồm
DISC ,
CIRCLE
và
SQUARE
ký tự dấu đầu dòng cho 3 cấp lồng danh sách đầu tiên.
|
BULLET_DIAMONDX_ARROW3D_SQUARE
|
Danh sách có dấu đầu dòng gồm
DIAMONDX ,
ARROW3D
và
SQUARE
ký tự dấu đầu dòng cho 3 cấp lồng danh sách đầu tiên.
|
BULLET_CHECKBOX
|
Một danh sách có dấu đầu dòng gồm
CHECKBOX
ký tự dấu đầu dòng cho mọi cấp lồng ghép danh sách.
|
BULLET_ARROW_DIAMOND_DISC
|
Danh sách có dấu đầu dòng gồm
ARROW ,
DIAMOND
và
DISC
ký tự dấu đầu dòng cho 3 cấp lồng danh sách đầu tiên.
|
BULLET_STAR_CIRCLE_SQUARE
|
Danh sách có dấu đầu dòng gồm
STAR ,
CIRCLE
và
SQUARE
ký tự dấu đầu dòng cho 3 cấp lồng danh sách đầu tiên.
|
BULLET_ARROW3D_CIRCLE_SQUARE
|
Danh sách có dấu đầu dòng gồm
ARROW3D ,
CIRCLE
và
SQUARE
ký tự dấu đầu dòng cho 3 cấp lồng danh sách đầu tiên.
|
BULLET_LEFTTRIANGLE_DIAMOND_DISC
|
Danh sách có dấu đầu dòng gồm
LEFTTRIANGLE ,
DIAMOND
và
DISC
ký tự dấu đầu dòng cho 3 cấp lồng danh sách đầu tiên.
|
BULLET_DIAMONDX_HOLLOWDIAMOND_SQUARE
|
Danh sách có dấu đầu dòng gồm
DIAMONDX ,
HOLLOWDIAMOND
và
SQUARE
ký tự dấu đầu dòng cho 3 cấp lồng danh sách đầu tiên.
|
BULLET_DIAMOND_CIRCLE_SQUARE
|
Danh sách có dấu đầu dòng gồm
DIAMOND ,
CIRCLE
và
SQUARE
ký tự dấu đầu dòng cho 3 cấp lồng danh sách đầu tiên.
|
NUMBERED_DECIMAL_ALPHA_ROMAN
|
Danh sách được đánh số gồm DECIMAL , ALPHA và các ký tự ROMAN dưới dạng số cho 3 cấp độ lồng danh sách đầu tiên, theo sau là dấu chấm câu.
|
NUMBERED_DECIMAL_ALPHA_ROMAN_PARENS
|
Danh sách được đánh số với các ký tự số DECIMAL , ALPHA và ROMAN cho 3 cấp độ danh sách đầu tiên trong lồng, theo sau là dấu ngoặc đơn.
|
NUMBERED_DECIMAL_NESTED
|
Danh sách được đánh số với các ký tự số dạng DECIMAL được phân tách bằng dấu chấm, trong đó mỗi cấp lồng ghép sử dụng ký tự của cấp độ lồng trước đó làm tiền tố. Ví dụ: '1.', '1.1.', '2.', "2.2.".
|
NUMBERED_UPPERALPHA_ALPHA_ROMAN
|
Danh sách được đánh số gồm UPPERALPHA , ALPHA và các ký tự ROMAN dưới dạng số cho 3 cấp độ lồng danh sách đầu tiên, theo sau là dấu chấm câu.
|
NUMBERED_UPPERROMAN_UPPERALPHA_DECIMAL
|
Danh sách được đánh số gồm UPPERROMAN , UPPERALPHA và các ký tự DECIMAL dưới dạng số cho 3 cấp độ lồng danh sách đầu tiên, theo sau là dấu chấm câu.
|
NUMBERED_ZERODECIMAL_ALPHA_ROMAN
|
Danh sách được đánh số gồm ZERODECIMAL , ALPHA và các ký tự ROMAN dưới dạng số cho 3 cấp độ lồng danh sách đầu tiên, theo sau là dấu chấm câu.
|
Yêu cầu Xóa Đoạn Dấu đầu dòng
Xóa dấu đầu dòng khỏi tất cả các đoạn chồng chéo với dải ô đã cho.
Mức lồng ghép của mỗi đoạn văn sẽ được duy trì trực quan bằng cách thêm thụt lề vào đầu đoạn tương ứng.
Biểu diễn dưới dạng JSON |
---|
{
"range": {
object (
|
Các trường | |
---|---|
range
|
Dải ô để xóa dấu đầu dòng. |
Tạo tên lớp yêu cầu
Tạo một NamedRange
tham chiếu đến dải ô đã cho.
Biểu diễn dưới dạng JSON |
---|
{
"name": string,
"range": {
object (
|
Các trường | |
---|---|
name
|
Tên của NamedRange. Tên không cần phải là duy nhất. Tên phải dài tối thiểu 1 ký tự và không quá 256 ký tự, được đo bằng đơn vị mã UTF-16. |
range
|
Dải ô để áp dụng tên. |
Xóa tên yêu cầu
Xoá NamedRange
.
Biểu diễn dưới dạng JSON |
---|
{ // Union field |
Các trường | |
---|---|
Trường nhóm named_range_reference . Giá trị xác định dải ô hoặc dải ô cần xóa. Phải đặt chính xác một giá trị.
named_range_reference chỉ có thể là một trong những loại sau đây:
|
|
namedRangeId
|
Mã của dải ô được đặt tên cần xóa. |
name
|
Tên của(các) dải ô cần xóa. Tất cả dải ô được đặt tên có tên đã cho sẽ bị xóa. |
Cập nhậtStyleStyleRequest
Cập nhật kiểu của tất cả các đoạn chồng chéo với dải ô đã cho.
Biểu diễn dưới dạng JSON |
---|
{ "paragraphStyle": { object ( |
Các trường | |
---|---|
paragraphStyle
|
Kiểu để đặt trên đoạn.
Một số thay đổi kiểu đoạn văn nhất định có thể gây ra các thay đổi khác để phản ánh hành vi của trình chỉnh sửa Tài liệu. Hãy xem tài liệu về |
fields
|
Các trường cần được cập nhật.
Phải chỉ định ít nhất một trường. Gốc
Ví dụ: để cập nhật thuộc tính căn chỉnh của kiểu đoạn văn, hãy đặt Để đặt lại thuộc tính về giá trị mặc định của nó, hãy bao gồm tên trường của nó trong mặt nạ trường nhưng không để trống trường đó. |
Trường nhóm insertion_location . Loại phạm vi được sử dụng mà kiểu đoạn sẽ được cập nhật.
insertion_location chỉ có thể là một trong những loại sau đây:
|
|
range
|
Dải ô chồng chéo các đoạn văn với kiểu. |
Xóa nội dung yêu cầu
Xóa nội dung khỏi tài liệu.
Biểu diễn dưới dạng JSON |
---|
{
"range": {
object (
|
Các trường | |
---|---|
range
|
Phạm vi nội dung cần xóa. Việc xóa văn bản vượt qua ranh giới của đoạn có thể dẫn đến thay đổi đối với kiểu đoạn, danh sách, đối tượng được định vị và dấu trang khi hai đoạn đó được hợp nhất. Việc cố gắng xóa một số phạm vi nhất định có thể dẫn đến cấu trúc tài liệu không hợp lệ. Trong trường hợp đó, lỗi yêu cầu 400 sẽ được trả về. Một số ví dụ về yêu cầu xóa không hợp lệ bao gồm:
|
Chèn yêu cầu hình ảnh nội tuyến
Chèn một InlineObject
chứa hình ảnh tại vị trí đã cho.
Biểu diễn dưới dạng JSON |
---|
{ "uri": string, "objectSize": { object ( |
Các trường | |
---|---|
uri
|
URI hình ảnh. Hình ảnh được tìm nạp một lần tại thời điểm chèn và bản sao được lưu trữ để hiển thị bên trong tài liệu. Hình ảnh phải có kích thước nhỏ hơn 50 MB, không được vượt quá 25 megapixel và phải ở một trong các định dạng PNG, JPEG hoặc GIF.
URI được cung cấp phải truy cập công khai và có độ dài tối đa là 2 kB. Bản thân URI được lưu cùng với hình ảnh và hiển thị qua trường |
objectSize
|
Kích thước mà hình ảnh sẽ xuất hiện như trong tài liệu. Thuộc tính này là tùy chọn và kích thước cuối cùng của hình ảnh trong tài liệu được xác định theo các quy tắc sau: * Nếu cả chiều rộng và chiều cao đều không được chỉ định, thì kích thước mặc định của hình ảnh sẽ được tính toán dựa trên độ phân giải. * Nếu một kích thước được chỉ định thì kích thước kia sẽ được tính để duy trì tỷ lệ co của hình ảnh. * Nếu cả chiều rộng và chiều cao được chỉ định, hình ảnh được chia tỷ lệ cho vừa với kích thước được cung cấp trong khi vẫn duy trì tỷ lệ co. |
Trường nhóm insertion_location . Vị trí sẽ chèn hình ảnh.
insertion_location chỉ có thể là một trong những loại sau đây:
|
|
location
|
Chèn hình ảnh vào một chỉ mục cụ thể trong tài liệu.
Bạn phải chèn hình ảnh vào bên trong giới hạn của Không thể chèn hình ảnh nội tuyến bên trong chú thích hoặc phương trình. |
endOfSegmentLocation
|
Chèn văn bản ở cuối tiêu đề, chân trang hoặc nội dung tài liệu. Không thể chèn hình ảnh nội tuyến bên trong chú thích cuối trang. |
Yêu cầu Chèn Bảng
Chèn bảng tại vị trí đã chỉ định.
Ký tự dòng mới sẽ được chèn vào trước bảng đã chèn.
Biểu diễn dưới dạng JSON |
---|
{ "rows": integer, "columns": integer, // Union field |
Các trường | |
---|---|
rows
|
Số hàng trong bảng. |
columns
|
Số cột trong bảng. |
Trường nhóm insertion_location . Vị trí sẽ chèn bảng.
insertion_location chỉ có thể là một trong những loại sau đây:
|
|
location
|
Chèn bảng tại một chỉ mục mô hình cụ thể. Một ký tự dòng mới sẽ được chèn vào trước bảng được chèn, do đó, chỉ mục bắt đầu của bảng sẽ có tại chỉ mục vị trí đã chỉ định + 1.
Bạn phải chèn bảng này bên trong giới hạn của một Bạn không thể chèn bảng bên trong chú thích hoặc phương trình. |
endOfSegmentLocation
|
Chèn bảng vào cuối tiêu đề, chân trang hoặc nội dung tài liệu đã cho. Ký tự dòng mới sẽ được chèn vào trước bảng đã chèn. Bạn không thể chèn bảng bên trong chú thích cuối trang. |
Yêu cầu InsertTableRow
Chèn một hàng trống vào bảng.
Biểu diễn dưới dạng JSON |
---|
{
"tableCellLocation": {
object (
|
Các trường | |
---|---|
tableCellLocation
|
Vị trí ô bảng tham chiếu mà các hàng sẽ được chèn vào. Một hàng mới sẽ được chèn vào bên trên (hoặc bên dưới) hàng có ô tham chiếu. Nếu ô tham chiếu là một ô đã hợp nhất, một hàng mới sẽ được chèn vào bên trên (hoặc bên dưới) ô đã hợp nhất. |
insertBelow
|
Liệu có chèn hàng mới bên dưới vị trí ô tham chiếu hay không.
|
Vị trí bảng
Vị trí của một ô trong bảng.
Biểu diễn dưới dạng JSON |
---|
{
"tableStartLocation": {
object (
|
Các trường | |
---|---|
tableStartLocation
|
Vị trí bảng bắt đầu trong tài liệu. |
rowIndex
|
Chỉ mục hàng dựa trên 0. Ví dụ: hàng thứ hai trong bảng có chỉ mục hàng là 1. |
columnIndex
|
Chỉ mục cột số 0. Ví dụ: cột thứ hai trong bảng có chỉ mục cột là 1. |
Yêu cầu InsertTableColumn
Chèn một cột trống vào bảng.
Biểu diễn dưới dạng JSON |
---|
{
"tableCellLocation": {
object (
|
Các trường | |
---|---|
tableCellLocation
|
Vị trí ô trong bảng tham chiếu mà từ đó các cột sẽ được chèn. Một cột mới sẽ được chèn vào bên trái (hoặc bên phải) cột có ô tham chiếu. Nếu ô tham chiếu là một ô đã hợp nhất, một cột mới sẽ được chèn vào bên trái (hoặc bên phải) ô được hợp nhất. |
insertRight
|
Liệu có chèn cột mới vào bên phải vị trí ô tham chiếu hay không.
|
XóaBảngHàngYêu cầu
Xóa một hàng khỏi bảng.
Biểu diễn dưới dạng JSON |
---|
{
"tableCellLocation": {
object (
|
Các trường | |
---|---|
tableCellLocation
|
Vị trí ô trong bảng tham chiếu mà hàng sẽ bị xóa. Hàng mà ô này kéo dài sẽ bị xóa. Nếu đây là một ô đã hợp nhất kéo dài trên nhiều hàng, thì tất cả các hàng mà ô đó kéo dài sẽ bị xóa. Nếu không còn hàng nào trong bảng sau khi xoá, toàn bộ bảng sẽ bị xoá. |
XóaBảngCộtYêu cầu
Xóa một cột khỏi bảng.
Biểu diễn dưới dạng JSON |
---|
{
"tableCellLocation": {
object (
|
Các trường | |
---|---|
tableCellLocation
|
Vị trí ô trong bảng tham chiếu mà cột sẽ bị xoá. Cột mà ô này kéo dài sẽ bị xóa. Nếu đây là một ô đã hợp nhất kéo dài qua nhiều cột, thì tất cả các cột mà các ô kéo dài sẽ bị xóa. Nếu không còn cột nào trong bảng sau khi xoá, thì toàn bộ bảng sẽ bị xoá. |
Chèn yêu cầu ngắt trang
Chèn phần ngắt trang theo sau là một dòng mới ở vị trí đã chỉ định.
Biểu diễn dưới dạng JSON |
---|
{ // Union field |
Các trường | |
---|---|
Trường nhóm insertion_location . Vị trí nơi ngắt trang sẽ được chèn vào.
insertion_location chỉ có thể là một trong những loại sau đây:
|
|
location
|
Chèn phần ngắt trang tại chỉ mục cụ thể trong tài liệu.
Ngắt trang phải được chèn vào bên trong giới hạn của
Không được chèn ngắt trang bên trong bảng, phương trình, chú thích cuối trang, đầu trang hoặc chân trang. Vì chỉ có thể chèn ngắt trang trong phần nội dung, nên trường |
endOfSegmentLocation
|
Chèn ngắt trang ở cuối nội dung tài liệu.
Không được chèn ngắt trang bên trong chú thích cuối trang, đầu trang hoặc chân trang. Vì chỉ có thể chèn ngắt trang trong phần nội dung, nên trường |
DeletePositionedObjectRequest
Xoá
PositionedObject
khỏi tài liệu.
Biểu diễn dưới dạng JSON |
---|
{ "objectId": string } |
Các trường | |
---|---|
objectId
|
Mã của đối tượng được định vị để xoá. |
UpdateTableColumnPropertiesRequest
Cập nhật TableColumnProperties
của các cột trong bảng.
Biểu diễn dưới dạng JSON |
---|
{ "tableStartLocation": { object ( |
Các trường | |
---|---|
tableStartLocation
|
Vị trí bảng bắt đầu trong tài liệu. |
columnIndices[]
|
Danh sách chỉ mục cột 0 có thuộc tính cần được cập nhật. Nếu không có chỉ mục nào được chỉ định, tất cả các cột sẽ được cập nhật. |
tableColumnProperties
|
Các thuộc tính cột của bảng cần cập nhật.
Nếu giá trị của |
fields
|
Các trường cần được cập nhật.
Phải chỉ định ít nhất một trường. Gốc
Ví dụ: để cập nhật chiều rộng cột, hãy đặt |
UpdateTableCellStyleRequest
Cập nhật kiểu của một dải ô trong bảng.
Biểu diễn dưới dạng JSON |
---|
{ "tableCellStyle": { object ( |
Các trường | |
---|---|
tableCellStyle
|
Kiểu để đặt trên các ô của bảng. Khi cập nhật đường viền, nếu một ô có chung đường viền với một ô liền kề, thì thuộc tính đường viền tương ứng của ô liền kề cũng được cập nhật. Đường viền được hợp nhất và ẩn mặt không được cập nhật. Vì việc cập nhật đường viền dùng chung với các ô liền kề trong cùng một yêu cầu có thể gây ra tình trạng cập nhật biên giới xung đột, nên các bản cập nhật biên giới sẽ được áp dụng theo thứ tự sau:
|
fields
|
Các trường cần được cập nhật.
Phải chỉ định ít nhất một trường. Gốc
Ví dụ: để cập nhật màu nền của ô trong bảng, hãy đặt Để đặt lại thuộc tính về giá trị mặc định của nó, hãy bao gồm tên trường của nó trong mặt nạ trường nhưng không để trống trường đó. |
Trường nhóm cells . Các ô sẽ được cập nhật.
cells chỉ có thể là một trong những loại sau đây:
|
|
tableRange
|
Dải ô của bảng thể hiện tập hợp con của bảng sẽ áp dụng nội dung cập nhật. |
tableStartLocation
|
Vị trí bảng bắt đầu trong tài liệu. Khi được chỉ định, cập nhật sẽ được áp dụng cho tất cả các ô trong bảng. |
Phạm vi bảng
Dải ô đại diện cho một tham chiếu đến một tập hợp con của bảng.
Điều quan trọng cần lưu ý là các ô được chỉ định bởi phạm vi bảng không nhất thiết phải tạo thành hình chữ nhật. Ví dụ: giả sử chúng ta có một bảng 3 x 3 trong đó tất cả các ô của hàng cuối cùng được hợp nhất với nhau. Bảng sẽ có dạng như sau:
[ ][ ][ ]
[ ][ ][ ]
[ ]
Dải ô bảng có vị trí ô trong bảng = (tableStartLocation, row = 0, column = 0), row span = 3 and column span = 2 chỉ định các ô sau:
[ x ][ x ][ ]
[ x ][ x ][ ]
[ x x x ]
Biểu diễn dưới dạng JSON |
---|
{
"tableCellLocation": {
object (
|
Các trường | |
---|---|
tableCellLocation
|
Vị trí ô nơi phạm vi bảng bắt đầu. |
rowSpan
|
Khoảng hàng của dải ô bảng. |
columnSpan
|
Nhịp cột của dải ô bảng. |
UpdateTableRowStyleRequest
Cập nhật TableRowStyle
của các hàng trong bảng.
Biểu diễn dưới dạng JSON |
---|
{ "tableStartLocation": { object ( |
Các trường | |
---|---|
tableStartLocation
|
Vị trí bảng bắt đầu trong tài liệu. |
rowIndices[]
|
Danh sách chỉ mục hàng dựa trên 0 có kiểu nên được cập nhật. Nếu không có chỉ mục nào được chỉ định, tất cả các hàng sẽ được cập nhật. |
tableRowStyle
|
Kiểu sẽ được đặt trên hàng. |
fields
|
Các trường cần được cập nhật.
Phải chỉ định ít nhất một trường. Gốc
Ví dụ: để cập nhật chiều cao tối thiểu của hàng, hãy đặt |
Thay thế yêu cầu hình ảnh
Thay thế hình ảnh hiện tại bằng hình ảnh mới.
Việc thay thế hình ảnh sẽ xoá một số image effects
khỏi hình ảnh hiện có để phản ánh hành vi của trình chỉnh sửa Tài liệu.
Biểu diễn dưới dạng JSON |
---|
{
"imageObjectId": string,
"uri": string,
"imageReplaceMethod": enum (
|
Các trường | |
---|---|
imageObjectId
|
Mã của hình ảnh hiện có sẽ được thay thế. Mã nhận dạng có thể được truy xuất từ phản hồi của yêu cầu nhận. |
uri
|
URI của hình ảnh mới. Hình ảnh được tìm nạp một lần tại thời điểm chèn và bản sao được lưu trữ để hiển thị bên trong tài liệu. Hình ảnh phải nhỏ hơn 50 MB, không được vượt quá 25 megapixel và phải ở định dạng PNG, JPEG hoặc GIF.
URI được cung cấp không được vượt quá 2 KB độ dài. URI được lưu cùng với hình ảnh và hiển thị thông qua trường |
imageReplaceMethod
|
Phương thức thay thế. |
Phương thức thay thế hình ảnh.
Enum | |
---|---|
IMAGE_REPLACE_METHOD_UNSPECIFIED
|
Phương thức thay thế hình ảnh không xác định. Không được sử dụng giá trị này. |
CENTER_CROP
|
Chia tỷ lệ và căn giữa hình ảnh để lấp đầy các giới hạn của hình ảnh gốc. Hình ảnh có thể bị cắt để lấp đầy ranh giới của hình ảnh gốc. Kích thước được hiển thị của hình ảnh sẽ giống với hình ảnh gốc. |
UpdateDocumentStyleRequest
Cập nhật DocumentStyle
.
Biểu diễn dưới dạng JSON |
---|
{
"documentStyle": {
object (
|
Các trường | |
---|---|
documentStyle
|
Các kiểu cần đặt trên tài liệu.
Một số thay đổi về kiểu tài liệu nhất định có thể gây ra các thay đổi khác để phản ánh hành vi của trình chỉnh sửa Tài liệu. Hãy xem tài liệu về |
fields
|
Các trường cần được cập nhật.
Phải chỉ định ít nhất một trường. Gốc
Ví dụ: để cập nhật nền, hãy đặt |
MergeTableCellsRequest
Hợp nhất các ô trong một Table
.
Biểu diễn dưới dạng JSON |
---|
{
"tableRange": {
object (
|
Các trường | |
---|---|
tableRange
|
Dải ô bảng chỉ định các ô trong bảng cần hợp nhất. Bất kỳ văn bản nào trong các ô đang được hợp nhất đều sẽ được nối và lưu trữ trong ô "phần đầu" của dải ô. Đây là ô phía trên bên trái của dải ô khi hướng nội dung từ trái sang phải và ô trên bên phải của dải ô nói cách khác. Nếu dải ô không phải là hình chữ nhật (có thể xảy ra trong một số trường hợp khi dải ô bao phủ các ô đã được hợp nhất hoặc khi bảng không phải là hình chữ nhật) sẽ trả về lỗi yêu cầu 400. |
Hủy hợp nhất bảngCell
Hủy hợp nhất các ô trong Table
.
Biểu diễn dưới dạng JSON |
---|
{
"tableRange": {
object (
|
Các trường | |
---|---|
tableRange
|
Dải ô bảng chỉ định các ô trong bảng cần hủy hợp nhất. Tất cả các ô đã hợp nhất trong dải ô này sẽ không được hợp nhất và các ô đã được hủy hợp nhất sẽ không bị ảnh hưởng. Nếu dải ô không có ô nào được hợp nhất, thì yêu cầu sẽ không thực hiện hành động nào. Nếu có văn bản trong bất kỳ ô đã hợp nhất nào, văn bản sẽ vẫn nằm trong ô "đầu" của khối các ô chưa được hợp nhất thu được. Ô "head" là ô phía trên bên trái khi hướng nội dung từ trái sang phải và ngược lại bên phải phía trên. |
Tạo yêu cầu tiêu đề
Tạo một Header
. Tiêu đề mới sẽ được áp dụng cho SectionStyle
tại vị trí SectionBreak
(nếu có), nếu không thì sẽ được áp dụng cho DocumentStyle
.
Nếu tiêu đề thuộc loại được chỉ định đã tồn tại, lỗi yêu cầu 400 sẽ được trả về.
Biểu diễn dưới dạng JSON |
---|
{ "type": enum ( |
Các trường | |
---|---|
type
|
Loại tiêu đề cần tạo. |
sectionBreakLocation
|
Vị trí của |
Tạo Yêu cầu Footnote
Tạo một phân khúc Footnote
rồi chèn một FootnoteReference
mới vào phân khúc đó tại vị trí đã cho.
Phân đoạn Footnote
mới sẽ chứa một dấu cách, theo sau là một ký tự dòng mới.
Biểu diễn dưới dạng JSON |
---|
{ // Union field |
Các trường | |
---|---|
Trường nhóm footnote_reference_location . Vị trí chèn tham chiếu chú thích cuối trang.
footnote_reference_location chỉ có thể là một trong những loại sau đây:
|
|
location
|
Chèn tham chiếu chú thích cuối trang vào chỉ mục cụ thể trong tài liệu.
Tham chiếu chú thích cuối trang phải được chèn vào bên trong giới hạn của
Không thể chèn phần tham chiếu đến chú thích bên trong phương trình, tiêu đề, chân trang hoặc chú thích cuối trang. Vì bạn chỉ có thể chèn phần tham chiếu chú thích cuối trang vào phần nội dung, nên trường |
endOfSegmentLocation
|
Chèn tham chiếu chú thích cuối trang vào cuối phần thân tài liệu.
Không được chèn phần tham chiếu đến chú thích bên trong đầu trang, chân trang hoặc chú thích cuối trang. Vì bạn chỉ có thể chèn phần tham chiếu chú thích cuối trang vào phần nội dung, nên trường |
ReplaceNamedRangeContentRequest
Thay thế nội dung của NamedRange
hoặc NamedRanges
được chỉ định bằng nội dung thay thế nhất định.
Xin lưu ý rằng một NamedRange
riêng lẻ có thể bao gồm nhiều lần gián đoạn ranges
. Trong trường hợp này, chỉ nội dung trong dải ô đầu tiên sẽ được thay thế. Các dải ô khác và nội dung của chúng sẽ bị xóa.
Trong trường hợp thay thế hoặc xóa bất kỳ phạm vi nào sẽ dẫn đến cấu trúc tài liệu không hợp lệ, thì lỗi 400 sẽ được trả về.
Biểu diễn dưới dạng JSON |
---|
{ // Union field |
Các trường | |
---|---|
Trường nhóm replacement_content . Nội dung thay thế nội dung hiện có của dải ô được đặt tên.
replacement_content chỉ có thể là một trong những loại sau đây:
|
|
text
|
Thay thế nội dung của(các) dải ô được đặt tên chỉ định bằng văn bản đã cho. |
Trường nhóm named_range_reference . Tham chiếu đến(các) dải ô được đặt tên có nội dung sẽ được thay thế.
named_range_reference chỉ có thể là một trong những loại sau đây:
|
|
namedRangeId
|
Mã của dải ô được đặt tên có nội dung sẽ được thay thế. Nếu không có dải ô được đặt tên với ID đã cho, lỗi yêu cầu 400 sẽ được trả về. |
namedRangeName
|
Tên của
Nếu có nhiều |
UpdateSectionStyleRequest
Cập nhật SectionStyle
.
Biểu diễn dưới dạng JSON |
---|
{ "range": { object ( |
Các trường | |
---|---|
range
|
Dải ô chồng chéo các phần với kiểu.
Vì chỉ có thể chèn ngắt phần bên trong nội dung, nên trường |
sectionStyle
|
Kiểu sẽ đặt trên mục.
Một số thay đổi về kiểu mục có thể gây ra các thay đổi khác để phản ánh hành vi của trình chỉnh sửa Tài liệu. Hãy xem tài liệu về |
fields
|
Các trường cần được cập nhật.
Phải chỉ định ít nhất một trường. Gốc
Ví dụ: để cập nhật lề trái, hãy đặt |
Yêu cầu Chèn mục
Chèn ngắt phần tại vị trí đã cho.
Một ký tự dòng mới sẽ được chèn vào trước ngắt mục.
Biểu diễn dưới dạng JSON |
---|
{ "sectionType": enum ( |
Các trường | |
---|---|
sectionType
|
Loại mục cần chèn. |
Trường nhóm insertion_location . Vị trí sẽ ngắt quảng cáo.
insertion_location chỉ có thể là một trong những loại sau đây:
|
|
location
|
Chèn một dòng mới và một dấu ngắt phần tại một chỉ mục cụ thể trong tài liệu.
Ngắt mục phải được chèn vào bên trong giới hạn của
Không thể chèn ngắt phần bên trong bảng, phương trình, chú thích cuối trang, đầu trang hoặc chân trang. Vì chỉ có thể chèn ngắt phần trong nội dung, nên trường |
endOfSegmentLocation
|
Chèn một dòng mới và một dấu ngắt phần ở cuối nội dung tài liệu.
Không thể chèn ngắt phần bên trong chú thích cuối trang, đầu trang hoặc chân trang. Vì chỉ có thể chèn ngắt phần bên trong nội dung, nên trường |
Xóa yêu cầu tiêu đề
Xoá
Header
khỏi tài liệu.
Biểu diễn dưới dạng JSON |
---|
{ "headerId": string } |
Các trường | |
---|---|
headerId
|
Mã tiêu đề cần xóa. Nếu tiêu đề này được xác định trên |
Yêu cầu PinTableHeaderRows
Cập nhật số hàng tiêu đề bảng được ghim trong một bảng.
Biểu diễn dưới dạng JSON |
---|
{
"tableStartLocation": {
object (
|
Các trường | |
---|---|
tableStartLocation
|
Vị trí bảng bắt đầu trong tài liệu. |
pinnedHeaderRowsCount
|
Số hàng của bảng để ghim, trong đó 0 có nghĩa là tất cả các hàng đều không được ghim. |