Requests

{

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

object (ReplaceAllTextRequest)

Thay thế tất cả các lần xuất hiện của văn bản được chỉ định.

object (InsertTextRequest)

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

object (UpdateTextStyleRequest)

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

object (CreateParagraphBulletsRequest)

Tạo dấu đầu dòng cho đoạn.

object (DeleteParagraphBulletsRequest)

Xoá dấu đầu dòng khỏi đoạn.

object (CreateNamedRangeRequest)

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

object (DeleteNamedRangeRequest)

Xoá một dải ô được đặt tên.

object (UpdateParagraphStyleRequest)

Cập nhật kiểu đoạn ở dải ô được chỉ định.

object (DeleteContentRangeRequest)

Xoá nội dung khỏi tài liệu.

object (InsertInlineImageRequest)

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

object (InsertTableRequest)

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

object (InsertTableRowRequest)

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

object (InsertTableColumnRequest)

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

object (DeleteTableRowRequest)

Xoá một hàng khỏi bảng.

object (DeleteTableColumnRequest)

Xoá một cột khỏi bảng.

object (InsertPageBreakRequest)

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

object (DeletePositionedObjectRequest)

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

object (UpdateTableColumnPropertiesRequest)

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

object (UpdateTableCellStyleRequest)

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

object (UpdateTableRowStyleRequest)

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

object (ReplaceImageRequest)

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

object (UpdateDocumentStyleRequest)

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

object (MergeTableCellsRequest)

Hợp nhất các ô trong một bảng.

object (UnmergeTableCellsRequest)

Huỷ hợp nhất các ô trong bảng.

object (CreateHeaderRequest)

Tạo tiêu đề.

object (CreateFooterRequest)

Tạo chân trang.

object (CreateFootnoteRequest)

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

object (ReplaceNamedRangeContentRequest)

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

object (UpdateSectionStyleRequest)

Cập nhật kiểu phần của dải ô được chỉ định.

object (InsertSectionBreakRequest)

Chèn dấu ngắt mục tại vị trí đã chỉ định.

object (DeleteHeaderRequest)

Xoá tiêu đề khỏi tài liệu.

object (DeleteFooterRequest)

Xoá một chân trang khỏi tài liệu.

object (PinTableHeaderRowsRequest)

Cập nhật số lượng hàng tiêu đề được ghim trong một bảng.

{
  "replaceText": string,
  "tabsCriteria": {
    object (TabsCriteria)
  },

  // Union field criteria can be only one of the following:
  "containsText": {
    object (SubstringMatchCriteria)
  }
  // End of list of possible types for union field criteria.
}

string

Văn bản sẽ thay thế văn bản phù hợp.

object (TabsCriteria)

Không bắt buộc. Tiêu chí dùng để chỉ định thẻ nào sẽ thay thế.

Khi bị bỏ qua, thay thế sẽ áp dụng cho tất cả các thẻ.

Trong tài liệu chỉ chứa một thẻ:

• Nếu được cung cấp, mã này phải khớp với mã của thẻ duy nhất.

• Nếu bị bỏ qua, thì thay thế sẽ áp dụng cho thẻ số ít.

Trong một tài liệu chứa nhiều thẻ:

• Nếu được cung cấp, thay thế sẽ áp dụng cho các thẻ được chỉ định.

• Nếu bị bỏ qua, thay thế sẽ áp dụng cho tất cả các thẻ.

object (SubstringMatchCriteria)

Tìm văn bản trong tài liệu khớp với chuỗi con này.

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

string

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

boolean

Cho biết liệu nội dung tìm kiếm có tuân theo cách viết hoa/viết thường hay không:

• True : tìm kiếm phân biệt chữ hoa chữ thường.
• False : nội dung tìm kiếm không phân biệt chữ hoa chữ thường.

{
  "tabIds": [
    string
  ]
}

string

Danh sách mã thẻ mà yêu cầu thực thi.

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

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 dòng mới Paragraph tại chỉ mục đó. Kiểu đoạn văn của đoạn mới sẽ được sao chép từ đoạn đó ở 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 giữ nguyên kiểu của văn bản bên cạnh. 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ự trong Khu vực sử dụng riêng của máy bay đa ngôn ngữ cơ bản Unicode (U+E000-U+F8FF) sẽ bị loại bỏ khỏi văn bản được chèn.

object (Location)

Chèn văn bản tại một chỉ mục cụ thể trong tài liệu.

Bạn phải chèn văn bản bên trong ranh giới hiện tại Paragraph. Ví dụ: không thể chèn văn bả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 đó). Bạn phải chèn văn bản vào đoạn trước.

object (EndOfSegmentLocation)

Chèn văn bản vào cuối đầu trang, chân trang, chú thích cuối trang hoặc nội dung tài liệu.

{
  "segmentId": string,
  "index": integer,
  "tabId": string
}

string

Mã nhận dạng của đầu trang, chân trang hoặc chú thích cuối trang của vị trí đó. Mã phân đoạn trống biểu thị phần nội dung của tài liệu.

integer

Chỉ số bắt đầu từ 0, theo đơn vị mã UTF-16.

Chỉ mục tương ứng với đầu đoạn được chỉ định bởi segmentId.

string

Thẻ chứa vị trí. Khi bạn bỏ qua, yêu cầu sẽ được áp dụng cho thẻ đầu tiên.

Trong tài liệu chỉ chứa một thẻ:

• Nếu được cung cấp, mã này phải khớp với mã của thẻ duy nhất.

• Nếu bị bỏ qua, yêu cầu sẽ áp dụng cho thẻ số ít.

Trong một tài liệu chứa nhiều thẻ:

• Nếu được cung cấp, yêu cầu sẽ áp dụng cho thẻ được chỉ định.

• Nếu bị bỏ qua, yêu cầu sẽ áp dụng cho thẻ đầu tiên trong tài liệu.

{
  "segmentId": string,
  "tabId": string
}

string

Mã nhận dạng của đầu trang, chân trang hoặc chú thích cuối trang của vị trí đó. Mã phân đoạn trống biểu thị phần nội dung của tài liệu.

string

Thẻ chứa vị trí. Khi bạn bỏ qua, yêu cầu sẽ được áp dụng cho thẻ đầu tiên.

Trong tài liệu chỉ chứa một thẻ:

• Nếu được cung cấp, mã này phải khớp với mã của thẻ duy nhất.

• Nếu bị bỏ qua, yêu cầu sẽ áp dụng cho thẻ số ít.

Trong một tài liệu chứa nhiều thẻ:

• Nếu được cung cấp, yêu cầu sẽ áp dụng cho thẻ được chỉ định.

• Nếu bị bỏ qua, yêu cầu sẽ áp dụng cho thẻ đầu tiên trong tài liệu.

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

object (TextStyle)

Kiểu cần đặt trên văn bản.

Nếu giá trị của một kiểu cụ thể khớp với giá trị của kiểu mẹ, thì kiểu đó sẽ được thiết lập để kế thừa.

Một số thay đổi về kiểu văn bản có thể gây ra những thay đổi khác để phản ánh hành vi của Trình chỉnh sửa Tài liệu. Xem tài liệu về TextStyle để biết thêm thông tin.

string (FieldMask format)

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

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

Ví dụ: để cập nhật kiểu văn bản thành in đậm, hãy đặt fields đến "bold"

Để đặt lại một tài sản về giá trị mặc định, hãy đưa tên trường của tài sản đó vào mặt nạ trường nhưng không đặt trường đó.

object (Range)

Phạm vi văn bản cầ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 đầy đủ một đoạn thuộc một danh sách, dấu đầu dòng của đoạn đó cũng được cập nhật theo kiểu văn bản phù hợp.

Bạn không thể chèn các dải ô bên trong một UpdateTextStyleRequest tương đối.

{
  "range": {
    object (Range)
  },
  "bulletPreset": enum (BulletGlyphPreset)
}

object (Range)

Dải ô để áp dụng giá trị đặt trước cho dấu đầu dòng.

enum (BulletGlyphPreset)

Các loại ký tự gạch đầu dòng sẽ được sử dụng.

{
  "range": {
    object (Range)
  }
}

object (Range)

Dải ô để xoá dấu đầu dòng.

{
  "name": string,
  "range": {
    object (Range)
  }
}

string

Tên của Namedrange. Tên không cần phải là duy nhất.

Tên phải có ít nhất 1 ký tự và không quá 256 ký tự, được đo bằng đơn vị mã UTF-16.

object (Range)

Dải ô áp dụng tên.

{
  "tabsCriteria": {
    object (TabsCriteria)
  },

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

object (TabsCriteria)

Không bắt buộc. Tiêu chí dùng để chỉ định(các) thẻ nào sẽ bị xoá. Khi bạn bỏ qua, thao tác xoá dải ô sẽ áp dụng cho tất cả các thẻ.

Trong tài liệu chỉ chứa một thẻ:

• Nếu được cung cấp, mã này phải khớp với mã của thẻ duy nhất.

• Nếu bạn bỏ qua thuộc tính này, việc xoá dải ô sẽ áp dụng cho thẻ số ít.

Trong một tài liệu chứa nhiều thẻ:

• Nếu được cung cấp, việc xoá dải ô sẽ áp dụng cho các thẻ được chỉ định.

• Nếu không được cung cấp, thao tác xoá dải ô sẽ áp dụng cho tất cả các thẻ.

string

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

string

Tên của(các) dải ô cần xoá. Tất cả các dải ô được đặt tên có tên đã cho sẽ bị xóa.

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

object (ParagraphStyle)

Kiểu cần đặt trên đoạn.

Một số thay đổi về kiểu đoạn văn bản có thể gây ra những thay đổi khác để phản ánh hành vi của Trình chỉnh sửa tài liệu. Xem tài liệu về ParagraphStyle để biết thêm thông tin.

string (FieldMask format)

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

Bạn phải chỉ định ít nhất một trường. Gốc paragraphStyle đã được ngụ ý và không được chỉ định. Một "*" có thể được sử dụng làm cú pháp viết tắt để 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 bản, hãy đặt fields đến "alignment"

Để đặt lại một tài sản về giá trị mặc định, hãy đưa tên trường của tài sản đó vào mặt nạ trường nhưng không đặt trường đó.

object (Range)

Dải ô chồng chéo các đoạn văn cần tạo kiểu.

{
  "range": {
    object (Range)
  }
}

object (Range)

Dải ô nội dung cần xoá.

Việc xóa văn bản vượt qua ranh giới của đoạn văn bản có thể dẫn đến các thay đổi đối với kiểu đoạn văn, danh sách, đối tượng được định vị và dấu trang khi hai đoạn văn được hợp nhất.

Việc cố gắng xoá một số dải ô 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 đó, hệ thống sẽ trả về lỗi yêu cầu không hợp lệ 400.

Một số ví dụ về yêu cầu xoá không hợp lệ bao gồm:

• Xoá một đơn vị mã của cặp thay thế.
• Xoá ký tự dòng mới cuối cùng của Body, Header! Footer, Footnote, TableCell hoặc TableOfContents.
• Xóa phần đầu hoặc phần cuối của Table, TableOfContents hoặc Equation mà không xoá toàn bộ phần tử.
• Xoá ký tự dòng mới trước Table, TableOfContents hoặc SectionBreak mà không xoá phần tử.
• Xoá từng hàng hoặc ô trong bảng. Bạn được phép xoá nội dung trong một ô của bảng.

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

string

URI hình ảnh.

Hệ thống sẽ tìm nạp hình ảnh một lần tại thời điểm chèn và một bản sao sẽ được lưu trữ để hiển thị 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 có thể 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ị thông qua ImageProperties.content_uri .

object (Size)

Kích thước mà hình ảnh sẽ hiển thị như trong tài liệu. Thuộc tính này là không bắt buộc 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 không chỉ định chiều rộng và chiều cao, thì kích thước mặc định của hình ảnh sẽ được tính dựa trên độ phân giải của hình ảnh đó. * Nếu bạn chỉ định một kích thước, thì kích thước còn lại sẽ được tính để duy trì tỷ lệ khung hình của hình ảnh. * Nếu cả chiều rộng và chiều cao được chỉ định, hình ảnh sẽ được điều chỉnh tỷ lệ cho vừa với kích thước được cung cấp trong khi vẫn duy trì tỷ lệ co.

object (Location)

Chèn hình ảnh tại một chỉ mục cụ thể trong tài liệu.

Hình ảnh phải được chèn bên trong ranh giới của hình ảnh hiện có Paragraph. Ví dụ: không thể 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 cùng dòng vào chú thích cuối trang hoặc phương trình.

object (EndOfSegmentLocation)

Chèn văn bản vào cuối đầu trang, chân trang hoặc phần nội dung tài liệu.

Không thể chèn hình ảnh cùng dòng vào chú thích cuối trang.

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

integer

Số hàng trong bảng.

integer

Số cột trong bảng.

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 đã chèn, do đó, chỉ mục bắt đầu của bảng sẽ có chỉ mục vị trí được chỉ định + 1.

Bảng phải được chèn bên trong ranh giới của bảng hiện có Paragraph. Ví dụ: bạn không thể chèn ký tự này vào chỉ mục bắt đầu của bảng (tức là giữa một bảng hiện có và đoạn trước của bảng đó).

Không thể chèn bảng vào chú thích cuối trang hoặc phương trình.

object (EndOfSegmentLocation)

Chèn bảng vào cuối phần đầu trang, chân trang hoặc nội dung tài liệu đã cho. Một ký tự dòng mới sẽ được chèn trước bảng đã chèn.

Không thể chèn bảng vào chú thích cuối trang.

{
  "tableCellLocation": {
    object (TableCellLocation)
  },
  "insertBelow": boolean
}

object (TableCellLocation)

Vị trí ô trong bảng tham chiếu mà các hàng sẽ được chèn từ đó.

Một hàng mới sẽ được chèn vào phía 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 phía trên (hoặc bên dưới) ô đã hợp nhất.

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 phía trên ô.

{
  "tableStartLocation": {
    object (Location)
  },
  "rowIndex": integer,
  "columnIndex": integer
}

object (Location)

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

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.

integer

Chỉ mục cột từ 0. Ví dụ: cột thứ hai trong bảng có chỉ mục cột là 1.

{
  "tableCellLocation": {
    object (TableCellLocation)
  },
  "insertRight": boolean
}

object (TableCellLocation)

Vị trí ô trong bảng tham chiếu mà từ đó các cột sẽ được chèn vào.

Một cột mới sẽ được chèn vào bên trái (hoặc bên phải) của cột chứa ô tham chiếu. Nếu ô tham chiếu là một ô đã hợp nhất, cột mới sẽ được chèn vào bên trái (hoặc bên phải) của ô đã hợp nhất.

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.

{
  "tableCellLocation": {
    object (TableCellLocation)
  }
}

object (TableCellLocation)

Vị trí ô trong bảng tham chiếu mà hàng sẽ bị xoá.

Hàng mở rộng của ô này sẽ bị xoá. Nếu đây là một ô được hợp nhất trải dài trên nhiều hàng, tất cả các hàng mà các hàng đó kéo dài sẽ bị xoá. Nếu không còn hàng nào trong bảng sau lần xoá này thì toàn bộ bảng sẽ bị xoá.

{
  "tableCellLocation": {
    object (TableCellLocation)
  }
}

object (TableCellLocation)

Vị trí ô trong bảng tham chiếu mà cột sẽ bị xoá.

Cột trải rộng trong ô này sẽ bị xoá. Nếu đây là một ô được hợp nhất trải dài trên nhiều cột, tất cả các cột mà các ô đó kéo dài sẽ bị xoá. Nếu không còn cột nào trong bảng sau khi bạn xoá thì toàn bộ bảng sẽ bị xoá.

{

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

object (Location)

Chèn ngắt trang ở một chỉ mục cụ thể trong tài liệu.

Ngắt trang phải được chèn bên trong giới hạn của một văn bản hiện có Paragraph. Ví dụ: không thể 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).

Ngắt trang không được chèn trong bảng, phương trình, chú thích cuối trang, đầu trang hoặc chân trang. Vì ngắt trang chỉ có thể được chèn bên trong phần nội dung, nên segment ID phải để trống.

object (EndOfSegmentLocation)

Chèn ngắt trang vào cuối nội dung tài liệu.

Không thể chèn ngắt trang bên trong chú thích cuối trang, đầu trang hoặc chân trang. Vì ngắt trang chỉ có thể được chèn bên trong phần nội dung, nên segment ID phải để trống.

{
  "objectId": string,
  "tabId": string
}

string

Mã của đối tượng được định vị cần xoá.

string

Thẻ chứa đối tượng được định vị cần xoá. Khi bạn bỏ qua, yêu cầu sẽ được áp dụng cho thẻ đầu tiên.

Trong tài liệu chỉ chứa một thẻ:

• Nếu được cung cấp, mã này phải khớp với mã của thẻ duy nhất.

• Nếu bị bỏ qua, yêu cầu sẽ áp dụng cho thẻ số ít.

Trong một tài liệu chứa nhiều thẻ:

• Nếu được cung cấp, yêu cầu sẽ áp dụng cho thẻ được chỉ định.

• Nếu bị bỏ qua, yêu cầu sẽ áp dụng cho thẻ đầu tiên trong tài liệu.

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

object (Location)

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

integer

Danh sách các chỉ mục cột dựa trên 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.

object (TableColumnProperties)

Các thuộc tính của cột trong 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), thì hệ thống sẽ trả về lỗi 400 yêu cầu không hợp lệ.

string (FieldMask format)

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

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

Ví dụ: để cập nhật chiều rộng của cột, hãy đặt fields đến "width"

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

object (TableCellStyle)

Kiểu cần đặt trên các ô trong bảng.

Khi cập nhật đường viền, nếu một ô có đường viền với một ô liền kề, thuộc tính đường viền tương ứng của ô liền kề cũng sẽ được cập nhật. Các đường viền được hợp nhất và không hiển thị sẽ không được cập nhật.

Do việc cập nhật đường viền được các ô liền kề chia sẻ trong cùng một yêu cầu có thể gây ra xung đột cập nhật đường viền, nên các cập nhật đường viền được áp dụng theo thứ tự sau:

• borderRight
• borderLeft
• borderBottom
• borderTop

string (FieldMask format)

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

Bạn phải chỉ định ít nhất một trường. Gốc tableCellStyle đã được ngụ ý và không được chỉ định. Một "*" có thể được sử dụng làm cú pháp viết tắt để 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 đến "backgroundColor"

Để đặt lại một tài sản về giá trị mặc định, hãy đưa tên trường của tài sản đó vào mặt nạ trường nhưng không đặt trường đó.

object (TableRange)

Dải ô của bảng đại diện cho tập hợp con của bảng mà nội dung cập nhật được áp dụng.

object (Location)

Vị trí nơi bảng bắt đầu trong tài liệu. Khi được chỉ định, nội dung cập nhật sẽ được áp dụng cho tất cả các ô trong bảng.

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

object (TableCellLocation)

Vị trí ô nơi dải ô của bảng bắt đầu.

integer

Độ rộng hàng của dải ô của bảng.

integer

Khoảng cột của dải ô bảng.

{
  "tableStartLocation": {
    object (Location)
  },
  "rowIndices": [
    integer
  ],
  "tableRowStyle": {
    object (TableRowStyle)
  },
  "fields": string
}

object (Location)

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

integer

Danh sách chỉ mục hàng dựa trên 0 có kiểu 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 hàng sẽ được cập nhật.

object (TableRowStyle)

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

string (FieldMask format)

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

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

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

{
  "imageObjectId": string,
  "uri": string,
  "imageReplaceMethod": enum (ImageReplaceMethod),
  "tabId": string
}

string

Mã nhận dạng của hình ảnh hiện tại 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.

string

URI của hình ảnh mới.

Hệ thống sẽ tìm nạp hình ảnh một lần tại thời điểm chèn và một bản sao sẽ được lưu trữ để hiển thị 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 đã cung cấp không được vượt quá 2 KB. URI được lưu cùng với hình ảnh và hiển thị thông qua ImageProperties.source_uri .

enum (ImageReplaceMethod)

Phương thức thay thế.

string

Thẻ chứa hình ảnh cần thay thế. Khi bạn bỏ qua, yêu cầu sẽ được áp dụng cho thẻ đầu tiên.

Trong tài liệu chỉ chứa một thẻ:

• Nếu được cung cấp, mã này phải khớp với mã của thẻ duy nhất.

• Nếu bị bỏ qua, yêu cầu sẽ áp dụng cho thẻ số ít.

Trong một tài liệu chứa nhiều thẻ:

• Nếu được cung cấp, yêu cầu sẽ áp dụng cho thẻ được chỉ định.

• Nếu bị bỏ qua, yêu cầu sẽ áp dụng cho thẻ đầu tiên trong tài liệu.

{
  "documentStyle": {
    object (DocumentStyle)
  },
  "fields": string,
  "tabId": string
}

object (DocumentStyle)

Kiểu cần đặt trên tài liệu.

Một số thay đổi về kiểu tài liệu có thể gây ra những thay đổi khác để phản ánh hành vi của Trình chỉnh sửa tài liệu. Xem tài liệu về DocumentStyle để biết thêm thông tin.

string (FieldMask format)

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

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

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

string

Thẻ chứa kiểu cần cập nhật. Khi bị bỏ qua, yêu cầu sẽ áp dụng cho thẻ đầu tiên.

Trong tài liệu chỉ chứa một thẻ:

• Nếu được cung cấp, mã này phải khớp với mã của thẻ duy nhất.

• Nếu bị bỏ qua, yêu cầu sẽ áp dụng cho thẻ số ít.

Trong một tài liệu chứa nhiều thẻ:

• Nếu được cung cấp, yêu cầu sẽ áp dụng cho thẻ được chỉ định.

• Nếu không được cung cấp, yêu cầu sẽ áp dụng cho thẻ đầu tiên trong tài liệu.

{
  "tableRange": {
    object (TableRange)
  }
}

object (TableRange)

Dải ô của bảng chỉ định các ô trong bảng cần hợp nhất.

Mọi văn bản trong các ô đang được hợp nhất 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 là từ trái sang phải và là ô trên bên phải của dải ô nếu ngược lại.

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 gồm các ô đã được hợp nhất hoặc khi bảng không phải là hình chữ nhật), thì lỗi yêu cầu không hợp lệ 400 sẽ được trả về.

{
  "tableRange": {
    object (TableRange)
  }
}

object (TableRange)

Dải ô của bảng chỉ định các ô trong bảng cần huỷ hợp nhất.

Tất cả các ô đã hợp nhất trong dải ô này sẽ bị huỷ hợp nhất và các ô chưa được 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, yêu cầu sẽ không có tác dụng gì.

Nếu có văn bản trong bất kỳ ô đã hợp nhất nào, thì văn bản đó sẽ vẫn nằm trong "đầu" ô của khối kết quả gồm các ô chưa hợp nhất. Biểu tượng "đầu" ô là ô phía trên bên trái khi hướng nội dung là từ trái sang phải và là ô phía trên bên phải nếu không có hướng nội dung.

{
  "type": enum (HeaderFooterType),
  "sectionBreakLocation": {
    object (Location)
  }
}

enum (HeaderFooterType)

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

object (Location)

Vị trí của SectionBreak phần đầu tiên sẽ bắt đầu với phần mà tiêu đề này sẽ chứa. Nếu "sectionBreakLocation" không được đặt hoặc nếu quy tắc này đề 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

{
  "type": enum (HeaderFooterType),
  "sectionBreakLocation": {
    object (Location)
  }
}

enum (HeaderFooterType)

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

object (Location)

Vị trí của SectionBreak ngay trước phần có SectionStyle chân trang này. Nếu chính sách này không được đặt 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 kiểu tài liệu.

{

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

object (Location)

Chèn phần tham chiếu đến chú thích cuối trang tại một chỉ mục cụ thể trong tài liệu.

Bạn phải chèn phần tham chiếu đến chú thích cuối trang vào bên trong giới hạn của thuộc tính hiện có Paragraph. Ví dụ: không thể 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 cuối trang vào trong một phương trình, đầu trang, chân trang hoặc chú thích cuối trang. Vì phần tham chiếu đến chú thích cuối trang chỉ có thể được chèn vào phần nội dung, nên segment ID phải để trống.

object (EndOfSegmentLocation)

Chèn phần tham chiếu đến chú thích cuối trang vào cuối nội dung tài liệu.

Không thể chèn phần tham chiếu đến chú thích cuối trang vào trong đầu trang, chân trang hoặc chú thích cuối trang. Vì phần tham chiếu đến chú thích cuối trang chỉ có thể được chèn vào phần nội dung, nên segment ID phải để trống.

{
  "tabsCriteria": {
    object (TabsCriteria)
  },

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

object (TabsCriteria)

Không bắt buộc. Tiêu chí dùng để chỉ định thẻ nào sẽ thay thế. Khi bị bỏ qua, thay thế sẽ áp dụng cho tất cả các thẻ.

Trong tài liệu chỉ chứa một thẻ:

• Nếu được cung cấp, mã này phải khớp với mã của thẻ duy nhất.

• Nếu bị bỏ qua, thì thay thế sẽ áp dụng cho thẻ số ít.

Trong một tài liệu chứa nhiều thẻ:

• Nếu được cung cấp, thay thế sẽ áp dụng cho các thẻ được chỉ định.

• Nếu bị bỏ qua, thay thế sẽ áp dụng cho tất cả các thẻ.

string

Thay thế nội dung của(các) dải ô được đặt tên được chỉ định bằng văn bản đã cho.

string

Mã của dải ô được đặt tên có nội dung sẽ bị thay thế.

Nếu không có dải ô được đặt tên có mã nhận dạng đã cho, thì hệ thống sẽ trả về lỗi yêu cầu không hợp lệ 400.

string

Tên của NamedRanges nội dung có nội dung sẽ bị thay thế.

Nếu có nhiều named ranges với tên đã đặt, thì nội dung của mỗi trang 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.

{
  "range": {
    object (Range)
  },
  "sectionStyle": {
    object (SectionStyle)
  },
  "fields": string
}

object (Range)

Dải ô chồng chéo các phần cần tạo kiểu.

Do ngắt phần chỉ có thể được chèn vào trong phần nội dung, nên segment ID phải để trống.

object (SectionStyle)

Kiểu sẽ được đặt trên mục.

Một số thay đổi về kiểu của phầ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. Xem tài liệu về SectionStyle để biết thêm thông tin.

string (FieldMask format)

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

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

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

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

enum (SectionType)

Loại phần cần chèn.

object (Location)

Chèn một dòng mới và ngắt mục tại một chỉ mục cụ thể trong tài liệu.

Bạn phải chèn dấu ngắt mục bên trong ranh giới của thuộc tính hiện có Paragraph. Ví dụ: không thể 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).

Bạn không thể chèn dấu ngắt mục trong bảng, phương trình, chú thích cuối trang, đầu trang hoặc chân trang. Vì dấu ngắt phần chỉ có thể được chèn vào trong phần nội dung, nên segment ID phải để trống.

object (EndOfSegmentLocation)

Chèn một dòng mới và ngắt phần ở cuối nội dung tài liệu.

Không thể chèn ngắt mục bên trong chú thích cuối trang, đầu trang hoặc chân trang. Do ngắt phần chỉ có thể được chèn vào trong phần nội dung, nên segment ID phải để trống.

{
  "headerId": string,
  "tabId": string
}

string

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

string

Thẻ chứa tiêu đề cần xoá. Khi bạn bỏ qua, yêu cầu sẽ được áp dụng cho thẻ đầu tiên.

Trong tài liệu chỉ chứa một thẻ:

• Nếu được cung cấp, mã này phải khớp với mã của thẻ duy nhất.

• Nếu bị bỏ qua, yêu cầu sẽ áp dụng cho thẻ số ít.

Trong một tài liệu chứa nhiều thẻ:

• Nếu được cung cấp, yêu cầu sẽ áp dụng cho thẻ được chỉ định.

• Nếu bị bỏ qua, yêu cầu sẽ áp dụng cho thẻ đầu tiên trong tài liệu.

{
  "footerId": string,
  "tabId": string
}

string

Mã của chân trang cần xoá. Nếu chân trang này được xác định trên DocumentStyle, 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 chân trang này được xác định trên SectionStyle, nội dung tham chiếu đến chân trang này sẽ bị xoá và chân trang thuộc loại đó hiện được tiếp tục ở phần trước.

string

Thẻ chứa chân trang cần xoá. Khi bạn bỏ qua, yêu cầu sẽ được áp dụng cho thẻ đầu tiên.

Trong tài liệu chỉ chứa một thẻ:

• Nếu được cung cấp, mã này phải khớp với mã của thẻ duy nhất.

• Nếu bị bỏ qua, yêu cầu sẽ áp dụng cho thẻ số ít.

Trong một tài liệu chứa nhiều thẻ:

• Nếu được cung cấp, yêu cầu sẽ áp dụng cho thẻ được chỉ định.

• Nếu bị bỏ qua, yêu cầu sẽ áp dụng cho thẻ đầu tiên trong tài liệu.

{
  "tableStartLocation": {
    object (Location)
  },
  "pinnedHeaderRowsCount": integer
}

object (Location)

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

integer

Số hàng của bảng cần ghim, trong đó 0 biểu thị tất cả các hàng đã được bỏ ghim.