Requests

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 request can be only one of the following:
  "replaceAllText": {
    object (ReplaceAllTextRequest)
  },
  "insertText": {
    object (InsertTextRequest)
  },
  "updateTextStyle": {
    object (UpdateTextStyleRequest)
  },
  "createParagraphBullets": {
    object (CreateParagraphBulletsRequest)
  },
  "deleteParagraphBullets": {
    object (DeleteParagraphBulletsRequest)
  },
  "createNamedRange": {
    object (CreateNamedRangeRequest)
  },
  "deleteNamedRange": {
    object (DeleteNamedRangeRequest)
  },
  "updateParagraphStyle": {
    object (UpdateParagraphStyleRequest)
  },
  "deleteContentRange": {
    object (DeleteContentRangeRequest)
  },
  "insertInlineImage": {
    object (InsertInlineImageRequest)
  },
  "insertTable": {
    object (InsertTableRequest)
  },
  "insertTableRow": {
    object (InsertTableRowRequest)
  },
  "insertTableColumn": {
    object (InsertTableColumnRequest)
  },
  "deleteTableRow": {
    object (DeleteTableRowRequest)
  },
  "deleteTableColumn": {
    object (DeleteTableColumnRequest)
  },
  "insertPageBreak": {
    object (InsertPageBreakRequest)
  },
  "deletePositionedObject": {
    object (DeletePositionedObjectRequest)
  },
  "updateTableColumnProperties": {
    object (UpdateTableColumnPropertiesRequest)
  },
  "updateTableCellStyle": {
    object (UpdateTableCellStyleRequest)
  },
  "updateTableRowStyle": {
    object (UpdateTableRowStyleRequest)
  },
  "replaceImage": {
    object (ReplaceImageRequest)
  },
  "updateDocumentStyle": {
    object (UpdateDocumentStyleRequest)
  },
  "mergeTableCells": {
    object (MergeTableCellsRequest)
  },
  "unmergeTableCells": {
    object (UnmergeTableCellsRequest)
  },
  "createHeader": {
    object (CreateHeaderRequest)
  },
  "createFooter": {
    object (CreateFooterRequest)
  },
  "createFootnote": {
    object (CreateFootnoteRequest)
  },
  "replaceNamedRangeContent": {
    object (ReplaceNamedRangeContentRequest)
  },
  "updateSectionStyle": {
    object (UpdateSectionStyleRequest)
  },
  "insertSectionBreak": {
    object (InsertSectionBreakRequest)
  },
  "deleteHeader": {
    object (DeleteHeaderRequest)
  },
  "deleteFooter": {
    object (DeleteFooterRequest)
  },
  "pinTableHeaderRows": {
    object (PinTableHeaderRowsRequest)
  }
  // End of list of possible types for union field request.
}
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

object (ReplaceAllTextRequest)

Thay thế tất cả các bản sao của văn bản được chỉ định.

insertText

object (InsertTextRequest)

Chèn văn bản tại vị trí đã chỉ định.

updateTextStyle

object (UpdateTextStyleRequest)

Cập nhật kiểu văn bản trong dải ô được chỉ định.

createParagraphBullets

object (CreateParagraphBulletsRequest)

Tạo dấu đầu dòng cho đoạn văn bản.

deleteParagraphBullets

object (DeleteParagraphBulletsRequest)

Xóa dấu đầu dòng khỏi đoạn.

createNamedRange

object (CreateNamedRangeRequest)

Tạo một dải ô được đặt tên.

deleteNamedRange

object (DeleteNamedRangeRequest)

Xóa một dải ô được đặt tên.

updateParagraphStyle

object (UpdateParagraphStyleRequest)

Cập nhật kiểu đoạn văn trong phạm vi chỉ định.

deleteContentRange

object (DeleteContentRangeRequest)

Xóa nội dung khỏi tài liệu.

insertInlineImage

object (InsertInlineImageRequest)

Chèn một hình ảnh nội dòng tại vị trí đã chỉ định.

insertTable

object (InsertTableRequest)

Chèn bảng tại vị trí đã chỉ định.

insertTableRow

object (InsertTableRowRequest)

Chèn một hàng trống vào bảng.

insertTableColumn

object (InsertTableColumnRequest)

Chèn một cột trống vào bảng.

deleteTableRow

object (DeleteTableRowRequest)

Xóa một hàng khỏi bảng.

deleteTableColumn

object (DeleteTableColumnRequest)

Xóa một cột khỏi bảng.

insertPageBreak

object (InsertPageBreakRequest)

Chèn ngắt trang tại vị trí đã chỉ định.

deletePositionedObject

object (DeletePositionedObjectRequest)

Xoá đối tượng đã định vị khỏi tài liệu.

updateTableColumnProperties

object (UpdateTableColumnPropertiesRequest)

Cập nhật thuộc tính của các cột trong bảng.

updateTableCellStyle

object (UpdateTableCellStyleRequest)

Cập nhật kiểu của ô trong bảng.

updateTableRowStyle

object (UpdateTableRowStyleRequest)

Cập nhật kiểu hàng trong bảng.

replaceImage

object (ReplaceImageRequest)

Thay thế hình ảnh trong tài liệu.

updateDocumentStyle

object (UpdateDocumentStyleRequest)

Cập nhật kiểu của tài liệu.

mergeTableCells

object (MergeTableCellsRequest)

Hợp nhất ô trong bảng.

unmergeTableCells

object (UnmergeTableCellsRequest)

Hủy hợp nhất ô trong bảng.

createHeader

object (CreateHeaderRequest)

Tạo tiêu đề.

createFootnote

object (CreateFootnoteRequest)

Tạo chú thích cuối trang.

replaceNamedRangeContent

object (ReplaceNamedRangeContentRequest)

Thay thế nội dung trong dải ô được đặt tên.

updateSectionStyle

object (UpdateSectionStyleRequest)

Cập nhật kiểu mục của dải ô chỉ định.

insertSectionBreak

object (InsertSectionBreakRequest)

Chèn ngắt phần tại vị trí đã chỉ định.

deleteHeader

object (DeleteHeaderRequest)

Xóa tiêu đề khỏi tài liệu.

pinTableHeaderRows

object (PinTableHeaderRowsRequest)

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 criteria can be only one of the following:
  "containsText": {
    object (SubstringMatchCriteria)
  }
  // End of list of possible types for union field criteria.
}
Các trường
replaceText

string

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

object (SubstringMatchCriteria)

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

string

Văn bản để tìm kiếm trong tài liệu.

matchCase

boolean

Cho biết liệu cụm từ tìm kiếm có nên tuân thủ hay không:

  • True : tìm kiếm phân biệt chữ hoa chữ thường.
  • False : cụm từ tìm kiếm có phân biệt chữ hoa chữ thườ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 insertion_location can be only one of the following:
  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
  // End of list of possible types for union field insertion_location.
}
Các trường
text

string

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 Paragraph mới tại chỉ mục đó. Kiểu đoạn của đoạn mới sẽ được sao chép từ đoạn tại chỉ mục chèn hiện tại, bao gồm cả danh sách và dấu đầu dòng.

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

object (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 Paragraph hiện có. Ví dụ: văn bản không được chèn vào chỉ mục bắt đầu của bảng (tức là giữa bảng và đoạn trước). Văn bản phải được chèn vào đoạn trước.

endOfSegmentLocation

object (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

string

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

integer

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 segmentId xác định.

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

string

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 (TextStyle)
  },
  "fields": string,

  // Union field insertion_location can be only one of the following:
  "range": {
    object (Range)
  }
  // End of list of possible types for union field insertion_location.
}
Các trường
textStyle

object (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ề TextStyle để biết thêm thông tin.

fields

string (FieldMask format)

Các trường cần được cập nhật.

Phải chỉ định ít nhất một trường. Gốc textStyle là ngụ ý và không nên chỉ định. Bạn có thể sử dụng một "*" để viết tắt khi liệt kê mọi trường.

Ví dụ: để cập nhật kiểu chữ thành in đậm, hãy đặt fields thành "bold".

Để đặ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

object (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 (Range)
  },
  "bulletPreset": enum (BulletGlyphPreset)
}
Các trường
range

object (Range)

Dải ô để áp dụng giá trị đặt sẵn dấu đầu dòng.

bulletPreset

enum (BulletGlyphPreset)

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 (Range)
  }
}
Các trường
range

object (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 (Range)
  }
}
Các trường
name

string

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

object (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 named_range_reference can be only one of the following:
  "namedRangeId": string,
  "name": string
  // End of list of possible types for union field named_range_reference.
}
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

string

Mã của dải ô được đặt tên cần xóa.

name

string

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 (ParagraphStyle)
  },
  "fields": string,

  // Union field insertion_location can be only one of the following:
  "range": {
    object (Range)
  }
  // End of list of possible types for union field insertion_location.
}
Các trường
paragraphStyle

object (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ề ParagraphStyle để biết thêm thông tin.

fields

string (FieldMask format)

Các trường cần được cập nhật.

Phải chỉ định ít nhất một trường. Gốc paragraphStyle là ngụ ý và không nên chỉ định. Bạn có thể sử dụng một "*" để viết tắt khi liệt kê mọi trường.

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 fields thành "alignment".

Để đặ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

object (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 (Range)
  }
}
Các trường
range

object (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 (Size)
  },

  // Union field insertion_location can be only one of the following:
  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
  // End of list of possible types for union field insertion_location.
}
Các trường
uri

string

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 ImageProperties.content_uri.

objectSize

object (Size)

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

object (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 Paragraph hiện có. Ví dụ: nó không thể được chèn vào chỉ mục bắt đầu của bảng (tức là giữa bảng và đoạn trước của bảng).

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

object (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 insertion_location can be only one of the following:
  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
  // End of list of possible types for union field insertion_location.
}
Các trường
rows

integer

Số hàng trong bảng.

columns

integer

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

object (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 Paragraph hiện có. Ví dụ: bạn không thể chèn bảng này vào chỉ mục bắt đầu của bảng (tức là giữa bảng hiện tại và đoạn trước).

Bạn không thể chèn bảng bên trong chú thích hoặc phương trình.

endOfSegmentLocation

object (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 (TableCellLocation)
  },
  "insertBelow": boolean
}
Các trường
tableCellLocation

object (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

boolean

Liệu có chèn hàng mới bên dưới vị trí ô tham chiếu hay không.

  • True : chèn bên dưới ô.
  • False : chèn lên trên ô.

Vị trí bảng

Vị trí của một ô trong bảng.

Biểu diễn dưới dạng JSON 
{
  "tableStartLocation": {
    object (Location)
  },
  "rowIndex": integer,
  "columnIndex": integer
}
Các trường
tableStartLocation

object (Location)

Vị trí bảng bắt đầu trong tài liệu.

rowIndex

integer

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

integer

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 (TableCellLocation)
  },
  "insertRight": boolean
}
Các trường
tableCellLocation

object (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

boolean

Liệu có chèn cột mới vào bên phải vị trí ô tham chiếu hay không.

  • True : chèn vào bên phải.
  • False : chèn vào bên trái.

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 (TableCellLocation)
  }
}
Các trường
tableCellLocation

object (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 (TableCellLocation)
  }
}
Các trường
tableCellLocation

object (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 insertion_location can be only one of the following:
  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
  // End of list of possible types for union field insertion_location.
}
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

object (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 Paragraph hiện có. Ví dụ: nó không thể được chèn vào chỉ mục bắt đầu của bảng (tức là giữa bảng và đoạn trước của bảng).

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 segment ID phải trống.

endOfSegmentLocation

object (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 segment ID phải 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

string

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 (Location)
  },
  "columnIndices": [
    integer
  ],
  "tableColumnProperties": {
    object (TableColumnProperties)
  },
  "fields": string
}
Các trường
tableStartLocation

object (Location)

Vị trí bảng bắt đầu trong tài liệu.

columnIndices[]

integer

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

object (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 tableColumnProperties#width nhỏ hơn 5 điểm (5/72 inch), hệ thống sẽ trả về lỗi yêu cầu không hợp lệ 400.

fields

string (FieldMask format)

Các trường cần được cập nhật.

Phải chỉ định ít nhất một trường. Gốc tableColumnProperties là ngụ ý và không nên chỉ định. Bạn có thể sử dụng một "*" để viết tắt khi liệt kê mọi trường.

Ví dụ: để cập nhật chiều rộng cột, hãy đặt fields thành "width".

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 (TableCellStyle)
  },
  "fields": string,

  // Union field cells can be only one of the following:
  "tableRange": {
    object (TableRange)
  },
  "tableStartLocation": {
    object (Location)
  }
  // End of list of possible types for union field cells.
}
Các trường
tableCellStyle

object (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:

  • borderRight
  • borderLeft
  • borderBottom
  • borderTop
fields

string (FieldMask format)

Các trường cần được cập nhật.

Phải chỉ định ít nhất một trường. Gốc tableCellStyle là ngụ ý và không nên chỉ định. Bạn có thể sử dụng một "*" để viết tắt khi liệt kê mọi trường.

Ví dụ: để cập nhật màu nền của ô trong bảng, hãy đặt fields thành "backgroundColor".

Để đặ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

object (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

object (Location)

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 (TableCellLocation)
  },
  "rowSpan": integer,
  "columnSpan": integer
}
Các trường
tableCellLocation

object (TableCellLocation)

Vị trí ô nơi phạm vi bảng bắt đầu.

rowSpan

integer

Khoảng hàng của dải ô bảng.

columnSpan

integer

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 (Location)
  },
  "rowIndices": [
    integer
  ],
  "tableRowStyle": {
    object (TableRowStyle)
  },
  "fields": string
}
Các trường
tableStartLocation

object (Location)

Vị trí bảng bắt đầu trong tài liệu.

rowIndices[]

integer

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

object (TableRowStyle)

Kiểu sẽ được đặt trên hàng.

fields

string (FieldMask format)

Các trường cần được cập nhật.

Phải chỉ định ít nhất một trường. Gốc tableRowStyle là ngụ ý và không nên chỉ định. Bạn có thể sử dụng một "*" để viết tắt khi liệt kê mọi trường.

Ví dụ: để cập nhật chiều cao tối thiểu của hàng, hãy đặt fields thành "minRowHeight".

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 (ImageReplaceMethod)
}
Các trường
imageObjectId

string

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

string

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 ImageProperties.source_uri.

imageReplaceMethod

enum (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 (DocumentStyle)
  },
  "fields": string
}
Các trường
documentStyle

object (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ề DocumentStyle để biết thêm thông tin.

fields

string (FieldMask format)

Các trường cần được cập nhật.

Phải chỉ định ít nhất một trường. Gốc documentStyle là ngụ ý và không nên chỉ định. Bạn có thể sử dụng một "*" để viết tắt khi liệt kê mọi trường.

Ví dụ: để cập nhật nền, hãy đặt fields thành "background".

MergeTableCellsRequest

Hợp nhất các ô trong một Table.

Biểu diễn dưới dạng JSON 
{
  "tableRange": {
    object (TableRange)
  }
}
Các trường
tableRange

object (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 (TableRange)
  }
}
Các trường
tableRange

object (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 (HeaderFooterType),
  "sectionBreakLocation": {
    object (Location)
  }
}
Các trường
type

enum (HeaderFooterType)

Loại tiêu đề cần tạo.

sectionBreakLocation

object (Location)

Vị trí của SectionBreak bắt đầu phần chứa tiêu đề này. Nếu `sectionBreakLocation' không được đặt hoặc nếu đề cập đến ngắt phần đầu tiên trong nội dung tài liệu, thì tiêu đề sẽ áp dụng cho DocumentStyle

Loại chân trang đầu trang

Các loại đầu trang và chân trang có thể được tạo.

Enum
DEFAULT Đầu trang/chân trang mặc định.

Tạo Chân trang Yêu cầu

Tạo một Footer. Chân trang mới sẽ áp dụng cho SectionStyle tại vị trí SectionBreak, nếu không, chân trang mới sẽ được áp dụng cho DocumentStyle.

Nếu chân trang 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 (HeaderFooterType),
  "sectionBreakLocation": {
    object (Location)
  }
}
Các trường
type

enum (HeaderFooterType)

Loại chân trang cần tạo.

sectionBreakLocation

object (Location)

Vị trí của SectionBreak ngay trước phần có chân trang phải là SectionStyle. Nếu bạn không đặt chính sách này hoặc đề cập đến dấu ngắt phần đầu tiên trong tài liệu, thì chân trang sẽ áp dụng cho kiểu tài liệu.

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 footnote_reference_location can be only one of the following:
  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
  // End of list of possible types for union field footnote_reference_location.
}
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

object (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 Paragraph hiện có. Ví dụ: nó không thể được chèn vào chỉ mục bắt đầu của bảng (tức là giữa bảng và đoạn trước của bảng).

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 segment ID phải trống.

endOfSegmentLocation

object (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 segment ID phải 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 replacement_content can be only one of the following:
  "text": string
  // End of list of possible types for union field replacement_content.

  // Union field named_range_reference can be only one of the following:
  "namedRangeId": string,
  "namedRangeName": string
  // End of list of possible types for union field named_range_reference.
}
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

string

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

string

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

string

Tên của NamedRanges có nội dung sẽ được thay thế.

Nếu có nhiều named ranges với tên đã cho, nội dung của từng phần tử này sẽ được thay thế. Nếu không có dải ô được đặt tên nào có tên đã cho, thì yêu cầu sẽ không hoạt động.

UpdateSectionStyleRequest

Cập nhật SectionStyle.

Biểu diễn dưới dạng JSON 
{
  "range": {
    object (Range)
  },
  "sectionStyle": {
    object (SectionStyle)
  },
  "fields": string
}
Các trường
range

object (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 segment ID phải trống.

sectionStyle

object (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ề SectionStyle để biết thêm thông tin.

fields

string (FieldMask format)

Các trường cần được cập nhật.

Phải chỉ định ít nhất một trường. Gốc sectionStyle là ngụ ý và không được chỉ định. Bạn có thể sử dụng một "*" để viết tắt khi liệt kê mọi trường.

Ví dụ: để cập nhật lề trái, hãy đặt fields thành "marginLeft".

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 (SectionType),

  // Union field insertion_location can be only one of the following:
  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
  // End of list of possible types for union field insertion_location.
}
Các trường
sectionType

enum (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

object (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 Paragraph hiện có. Ví dụ: nó không thể được chèn vào chỉ mục bắt đầu của bảng (tức là giữa bảng và đoạn trước của bảng).

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 segment ID phải trống.

endOfSegmentLocation

object (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 segment ID phải 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

string

Mã tiêu đề cần xóa. Nếu tiêu đề này được xác định trên DocumentStyle, thì tham chiếu đến tiêu đề này sẽ bị xoá, dẫn đến việc không có tiêu đề nào thuộc loại đó cho phần đầu tiên của tài liệu. Nếu bạn xác định tiêu đề này trên SectionStyle, thì tham chiếu đến tiêu đề này sẽ bị xoá và tiêu đề của loại đó hiện tiếp tục ở phần trước.

Xóa chân trang yêu cầu

Xoá Footer khỏi tài liệu.

Biểu diễn dưới dạng JSON 
{
  "footerId": string
}
Các trường
footerId

string

Mã của chân trang cần xóa. Nếu chân trang này được xác định trên DocumentStyle, thì tham chiếu đến chân trang này sẽ bị xoá, dẫn đến việc không có chân trang thuộc loại đó cho phần đầu tiên của tài liệu. Nếu đã xác định chân trang này trên SectionStyle, thì tham chiếu đến chân trang này sẽ bị xoá và chân trang đó sẽ được tiếp tục trong phần trước.

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 (Location)
  },
  "pinnedHeaderRowsCount": integer
}
Các trường
tableStartLocation

object (Location)

Vị trí bảng bắt đầu trong tài liệu.

pinnedHeaderRowsCount

integer

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.