Requests

Yêu cầu

Một loại nội dung cập nhật duy nhất để áp dụng cho bản trình bày.

Biểu diễn dưới dạng JSON 
{

  // Union field kind can be only one of the following:
  "createSlide": {
    object (CreateSlideRequest)
  },
  "createShape": {
    object (CreateShapeRequest)
  },
  "createTable": {
    object (CreateTableRequest)
  },
  "insertText": {
    object (InsertTextRequest)
  },
  "insertTableRows": {
    object (InsertTableRowsRequest)
  },
  "insertTableColumns": {
    object (InsertTableColumnsRequest)
  },
  "deleteTableRow": {
    object (DeleteTableRowRequest)
  },
  "deleteTableColumn": {
    object (DeleteTableColumnRequest)
  },
  "replaceAllText": {
    object (ReplaceAllTextRequest)
  },
  "deleteObject": {
    object (DeleteObjectRequest)
  },
  "updatePageElementTransform": {
    object (UpdatePageElementTransformRequest)
  },
  "updateSlidesPosition": {
    object (UpdateSlidesPositionRequest)
  },
  "deleteText": {
    object (DeleteTextRequest)
  },
  "createImage": {
    object (CreateImageRequest)
  },
  "createVideo": {
    object (CreateVideoRequest)
  },
  "createSheetsChart": {
    object (CreateSheetsChartRequest)
  },
  "createLine": {
    object (CreateLineRequest)
  },
  "refreshSheetsChart": {
    object (RefreshSheetsChartRequest)
  },
  "updateShapeProperties": {
    object (UpdateShapePropertiesRequest)
  },
  "updateImageProperties": {
    object (UpdateImagePropertiesRequest)
  },
  "updateVideoProperties": {
    object (UpdateVideoPropertiesRequest)
  },
  "updatePageProperties": {
    object (UpdatePagePropertiesRequest)
  },
  "updateTableCellProperties": {
    object (UpdateTableCellPropertiesRequest)
  },
  "updateLineProperties": {
    object (UpdateLinePropertiesRequest)
  },
  "createParagraphBullets": {
    object (CreateParagraphBulletsRequest)
  },
  "replaceAllShapesWithImage": {
    object (ReplaceAllShapesWithImageRequest)
  },
  "duplicateObject": {
    object (DuplicateObjectRequest)
  },
  "updateTextStyle": {
    object (UpdateTextStyleRequest)
  },
  "replaceAllShapesWithSheetsChart": {
    object (ReplaceAllShapesWithSheetsChartRequest)
  },
  "deleteParagraphBullets": {
    object (DeleteParagraphBulletsRequest)
  },
  "updateParagraphStyle": {
    object (UpdateParagraphStyleRequest)
  },
  "updateTableBorderProperties": {
    object (UpdateTableBorderPropertiesRequest)
  },
  "updateTableColumnProperties": {
    object (UpdateTableColumnPropertiesRequest)
  },
  "updateTableRowProperties": {
    object (UpdateTableRowPropertiesRequest)
  },
  "mergeTableCells": {
    object (MergeTableCellsRequest)
  },
  "unmergeTableCells": {
    object (UnmergeTableCellsRequest)
  },
  "groupObjects": {
    object (GroupObjectsRequest)
  },
  "ungroupObjects": {
    object (UngroupObjectsRequest)
  },
  "updatePageElementAltText": {
    object (UpdatePageElementAltTextRequest)
  },
  "replaceImage": {
    object (ReplaceImageRequest)
  },
  "updateSlideProperties": {
    object (UpdateSlidePropertiesRequest)
  },
  "updatePageElementsZOrder": {
    object (UpdatePageElementsZOrderRequest)
  },
  "updateLineCategory": {
    object (UpdateLineCategoryRequest)
  },
  "rerouteLine": {
    object (RerouteLineRequest)
  }
  // End of list of possible types for union field kind.
}
Trường
Trường hợp hợp nhất kind. Loại nội dung cập nhật. Bạn phải điền đúng một trường. kind chỉ có thể là một trong những loại sau:
createSlide

object (CreateSlideRequest)

Tạo trang trình bày mới.

createShape

object (CreateShapeRequest)

Tạo một hình dạng mới.

createTable

object (CreateTableRequest)

Tạo một bảng mới.

insertText

object (InsertTextRequest)

Chèn văn bản vào một hình dạng hoặc ô trong bảng.

insertTableRows

object (InsertTableRowsRequest)

Chèn các hàng vào bảng.

insertTableColumns

object (InsertTableColumnsRequest)

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

deleteTableRow

object (DeleteTableRowRequest)

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

deleteTableColumn

object (DeleteTableColumnRequest)

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

replaceAllText

object (ReplaceAllTextRequest)

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

deleteObject

object (DeleteObjectRequest)

Xoá một trang hoặc phần tử trang khỏi bản trình bày.

updatePageElementTransform

object (UpdatePageElementTransformRequest)

Cập nhật biến đổi của một phần tử trang.

updateSlidesPosition

object (UpdateSlidesPositionRequest)

Cập nhật vị trí của một nhóm trang trình bày trong bản trình bày.

deleteText

object (DeleteTextRequest)

Xoá văn bản khỏi một hình hoặc ô trong bảng.

createImage

object (CreateImageRequest)

Tạo hình ảnh.

createVideo

object (CreateVideoRequest)

Tạo video.

createSheetsChart

object (CreateSheetsChartRequest)

Tạo biểu đồ được nhúng trong Google Trang tính.

createLine

object (CreateLineRequest)

Tạo một dòng.

refreshSheetsChart

object (RefreshSheetsChartRequest)

Làm mới biểu đồ trên Google Trang tính.

updateShapeProperties

object (UpdateShapePropertiesRequest)

Cập nhật các thuộc tính của một Shape.

updateImageProperties

object (UpdateImagePropertiesRequest)

Cập nhật các thuộc tính của Image.

updateVideoProperties

object (UpdateVideoPropertiesRequest)

Cập nhật các thuộc tính của một Video.

updatePageProperties

object (UpdatePagePropertiesRequest)

Cập nhật các thuộc tính của Page.

updateTableCellProperties

object (UpdateTableCellPropertiesRequest)

Cập nhật các thuộc tính của một TableCell.

updateLineProperties

object (UpdateLinePropertiesRequest)

Cập nhật các thuộc tính của một Line.

createParagraphBullets

object (CreateParagraphBulletsRequest)

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

replaceAllShapesWithImage

object (ReplaceAllShapesWithImageRequest)

Thay thế tất cả hình dạng khớp với một số tiêu chí bằng hình ảnh.

duplicateObject

object (DuplicateObjectRequest)

Nhân bản một trang trình bày hoặc phần tử trang.

updateTextStyle

object (UpdateTextStyleRequest)

Cập nhật kiểu văn bản trong Shape hoặc Table.

replaceAllShapesWithSheetsChart

object (ReplaceAllShapesWithSheetsChartRequest)

Thay thế tất cả các hình dạng khớp với một số tiêu chí bằng biểu đồ Google Trang tính.

deleteParagraphBullets

object (DeleteParagraphBulletsRequest)

Xoá dấu đầu dòng khỏi các đoạn văn bản.

updateParagraphStyle

object (UpdateParagraphStyleRequest)

Cập nhật kiểu của các đoạn trong một Shape hoặc Table.

updateTableBorderProperties

object (UpdateTableBorderPropertiesRequest)

Cập nhật các thuộc tính của đường viền bảng trong Table.

updateTableColumnProperties

object (UpdateTableColumnPropertiesRequest)

Cập nhật các thuộc tính của cột Table.

updateTableRowProperties

object (UpdateTableRowPropertiesRequest)

Cập nhật các thuộc tính của một Table hàng.

mergeTableCells

object (MergeTableCellsRequest)

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

unmergeTableCells

object (UnmergeTableCellsRequest)

Huỷ hợp nhất ô trong Table.

groupObjects

object (GroupObjectsRequest)

Các đối tượng của nhóm, chẳng hạn như các phần tử trang.

ungroupObjects

object (UngroupObjectsRequest)

Huỷ nhóm các đối tượng, chẳng hạn như groups.

updatePageElementAltText

object (UpdatePageElementAltTextRequest)

Cập nhật tiêu đề và/hoặc nội dung mô tả của văn bản thay thế cho một page element.

replaceImage

object (ReplaceImageRequest)

Thay thế hình ảnh hiện tại bằng hình ảnh mới.

updateSlideProperties

object (UpdateSlidePropertiesRequest)

Cập nhật các thuộc tính của Trang trình bày

updatePageElementsZOrder

object (UpdatePageElementsZOrderRequest)

Cập nhật thứ tự Z của page elements.

updateLineCategory

object (UpdateLineCategoryRequest)

Cập nhật danh mục của line.

rerouteLine

object (RerouteLineRequest)

Chuyển hướng lại một line sao cho thành phần này được kết nối tại hai vị trí kết nối gần nhất trên các phần tử trang đã kết nối.

CreateSlideRequest

Tạo trang trình bày.

Biểu diễn dưới dạng JSON 
{
  "objectId": string,
  "insertionIndex": integer,
  "slideLayoutReference": {
    object (LayoutReference)
  },
  "placeholderIdMappings": [
    {
      object (LayoutPlaceholderIdMapping)
    }
  ]
}
Trường
objectId

string

Mã nhận dạng đối tượng do người dùng cung cấp.

Nếu bạn chỉ định một mã nhận dạng, mã đó phải là duy nhất trong số tất cả các trang và phần tử trang trong bản trình bày. Mã nhận dạng phải bắt đầu bằng một ký tự chữ và số hoặc dấu gạch dưới (khớp với biểu thức chính quy [a-zA-Z0-9_]); các ký tự còn lại có thể bao gồm các ký tự đó cũng như dấu gạch nối hoặc dấu hai chấm (khớp với biểu thức chính quy [a-zA-Z0-9_-:]). Mã nhận dạng phải có độ dài từ 5 đến 50 ký tự.

Nếu bạn không chỉ định mã nhận dạng, hệ thống sẽ tạo một mã nhận dạng duy nhất.

insertionIndex

integer

Chỉ mục bắt đầu từ 0 (không bắt buộc) cho biết vị trí chèn các trang trình bày.

Nếu bạn không chỉ định chỉ mục, trang trình bày sẽ được tạo ở cuối.

slideLayoutReference

object (LayoutReference)

Tham chiếu bố cục của trang trình bày sẽ được chèn, dựa trên trang cái hiện tại, là một trong những loại sau:

  • Trang cái của chỉ mục trang trình bày trước.
  • Trang chính của trang trình bày đầu tiên, nếu insertIndex bằng 0.
  • Trang tổng thể đầu tiên trong bản trình bày, nếu không có trang trình bày nào.

Nếu không tìm thấy LayoutReference trong trang cái hiện tại, thì hệ thống sẽ trả về lỗi 400 với yêu cầu không hợp lệ.

Nếu bạn không chỉ định tham chiếu bố cục, trang trình bày sẽ sử dụng thuộc tính BLANK của bạn.

placeholderIdMappings[]

object (LayoutPlaceholderIdMapping)

Danh sách tuỳ chọn gồm các ánh xạ mã đối tượng từ placeholder (các) trên bố cục cho phần giữ chỗ được tạo trên trang trình bày từ bố cục được chỉ định. Chỉ có thể sử dụng khi slideLayoutReference được chỉ định.

LayoutReference

Tài liệu tham khảo về bố cục trang trình bày. Thông tin này có thể liên quan đến:

  • Bố cục được xác định trước
  • Một trong các bố cục trong bản trình bày.
Biểu diễn dưới dạng JSON 
{

  // Union field kind can be only one of the following:
  "predefinedLayout": enum (PredefinedLayout),
  "layoutId": string
  // End of list of possible types for union field kind.
}
Trường
Trường kết hợp kind. Loại LayoutReference. kind chỉ có thể là một trong những loại sau:
predefinedLayout

enum (PredefinedLayout)

Bố cục được xác định trước.

layoutId

string

Mã bố cục: mã đối tượng của một trong các bố cục trong bản trình bày.

PredefinedLayout

Loại bố cục định sẵn. Đây là những bố cục thường thấy trong bản trình bày. Tuy nhiên, không thể đảm bảo rằng những bố cục này sẽ xuất hiện trong giao diện chính hiện tại vì chúng có thể đã bị xoá hoặc không phải là một phần của giao diện được sử dụng. Ngoài ra, trình giữ chỗ trên mỗi bố cục có thể đã thay đổi.

Enum
PREDEFINED_LAYOUT_UNSPECIFIED Bố cục không xác định.
BLANK Bố cục trống, không có phần giữ chỗ.
CAPTION_ONLY Bố cục có chú thích ở dưới cùng.
TITLE Bố cục có tiêu đề và phụ đề.
TITLE_AND_BODY Bố cục có tiêu đề và nội dung.
TITLE_AND_TWO_COLUMNS Bố cục có tiêu đề và hai cột.
TITLE_ONLY Bố cục chỉ có tiêu đề.
SECTION_HEADER Bố cục có tiêu đề mục.
SECTION_TITLE_AND_DESCRIPTION Bố cục có tiêu đề và phụ đề ở một bên và mô tả ở bên còn lại.
ONE_COLUMN_TEXT Bố cục có một tiêu đề và một nội dung, được sắp xếp trong một cột duy nhất.
MAIN_POINT Bố cục có một điểm chính.
BIG_NUMBER Bố cục có tiêu đề số lớn.

LayoutPlaceholderIdMapping

Mục ánh xạ mã nhận dạng do người dùng chỉ định cho phần giữ chỗ sẽ được tạo trên một trang trình bày từ một bố cục cụ thể.

Biểu diễn dưới dạng JSON 
{
  "objectId": string,

  // Union field kind can be only one of the following:
  "layoutPlaceholder": {
    object (Placeholder)
  },
  "layoutPlaceholderObjectId": string
  // End of list of possible types for union field kind.
}
Trường
objectId

string

Mã đối tượng do người dùng cung cấp cho phần giữ chỗ được xác định ở trên để tạo trên một trang trình bày.

Nếu bạn chỉ định một mã nhận dạng, mã đó phải là duy nhất trong số tất cả các trang và phần tử trang trong bản trình bày. Mã nhận dạng phải bắt đầu bằng một ký tự chữ-số hoặc dấu gạch dưới (khớp với biểu thức chính quy [a-zA-Z0-9_]); các ký tự còn lại có thể bao gồm các ký tự đó cũng như dấu gạch nối hoặc dấu hai chấm (khớp với biểu thức chính quy [a-zA-Z0-9_-:]). Độ dài của giấy tờ tuỳ thân không được nhỏ hơn 5 hoặc lớn hơn 50.

Nếu bạn không chỉ định mã nhận dạng, thì một mã duy nhất sẽ được tạo.

Trường hợp hợp nhất kind. Loại để xác định phần giữ chỗ trên bố cục. kind chỉ có thể là một trong các trạng thái sau:
layoutPlaceholder

object (Placeholder)

Phần giữ chỗ trên một bố cục sẽ được áp dụng cho trang trình bày. Chỉ type và index là cần thiết. Ví dụ: bố cục TITLE_AND_BODY được xác định trước thường có phần giữ chỗ TITLE có chỉ mục 0 và phần giữ chỗ BODY có chỉ mục 0.

layoutPlaceholderObjectId

string

Mã đối tượng của phần giữ chỗ trên bố cục sẽ được áp dụng cho một trang trình bày.

CreateShapeRequest

Tạo một hình dạng mới.

Biểu diễn dưới dạng JSON 
{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "shapeType": enum (Type)
}
Trường
objectId

string

Mã nhận dạng đối tượng do người dùng cung cấp.

Nếu bạn chỉ định mã nhận dạng, mã nhận dạng đó phải là duy nhất trong tất cả các trang và phần tử trang trong bản trình bày. Mã nhận dạng phải bắt đầu bằng một ký tự chữ-số hoặc dấu gạch dưới (khớp với biểu thức chính quy [a-zA-Z0-9_]); các ký tự còn lại có thể bao gồm các ký tự đó cũng như dấu gạch nối hoặc dấu hai chấm (khớp với biểu thức chính quy [a-zA-Z0-9_-:]). Độ dài của giấy tờ tuỳ thân không được nhỏ hơn 5 hoặc lớn hơn 50. Nếu để trống, hệ thống sẽ tạo một giá trị nhận dạng duy nhất.

elementProperties

object (PageElementProperties)

Thuộc tính phần tử cho hình dạng.

shapeType

enum (Type)

Loại hình dạng.

PageElementProperties

Các thuộc tính phổ biến cho một phần tử trang.

Lưu ý: Khi ban đầu bạn tạo một PageElement, API có thể sửa đổi giá trị của cả hai size và transform, nhưng kích thước hình ảnh sẽ không thay đổi.

Biểu diễn dưới dạng JSON 
{
  "pageObjectId": string,
  "size": {
    object (Size)
  },
  "transform": {
    object (AffineTransform)
  }
}
Trường
pageObjectId

string

Mã đối tượng của trang chứa phần tử.

size

object (Size)

Kích thước của phần tử.

transform

object (AffineTransform)

Biến đổi cho phần tử.

CreateTableRequest

Tạo một bảng mới.

Biểu diễn dưới dạng JSON 
{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "rows": integer,
  "columns": integer
}
Trường
objectId

string

Mã nhận dạng đối tượng do người dùng cung cấp.

Nếu bạn chỉ định một mã nhận dạng, mã đó phải là duy nhất trong số tất cả các trang và phần tử trang trong bản trình bày. Mã nhận dạng phải bắt đầu bằng một ký tự chữ-số hoặc dấu gạch dưới (khớp với biểu thức chính quy [a-zA-Z0-9_]); các ký tự còn lại có thể bao gồm các ký tự đó cũng như dấu gạch nối hoặc dấu hai chấm (khớp với biểu thức chính quy [a-zA-Z0-9_-:]). Độ dài của mã nhận dạng không được ít hơn 5 hoặc nhiều hơn 50.

Nếu bạn không chỉ định mã nhận dạng, thì một mã duy nhất sẽ được tạo.

elementProperties

object (PageElementProperties)

Các thuộc tính phần tử của bảng.

Bảng sẽ được tạo ở kích thước đã cung cấp, tuỳ thuộc vào kích thước tối thiểu. Nếu bạn không cung cấp kích thước, bảng sẽ tự động được định kích thước.

Biến đổi bảng phải có tỷ lệ bằng 1 và không có thành phần cắt. Nếu bạn không cung cấp phép biến đổi nào, bảng sẽ được căn giữa trang.

rows

integer

Số hàng trong bảng.

columns

integer

Số cột trong bảng.

InsertTextRequest

Chèn văn bản vào một hình dạng hoặc ô trong bảng.

Biểu diễn dưới dạng JSON 
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "text": string,
  "insertionIndex": integer
}
Trường
objectId

string

Mã nhận dạng đối tượng của hình dạng hoặc bảng nơi văn bản sẽ được chèn.

cellLocation

object (TableCellLocation)

Vị trí ô bảng không bắt buộc nếu bạn muốn chèn văn bản vào một ô bảng. Nếu có, objectId phải tham chiếu đến một bảng.

text

string

Văn bản cần chèn.

Việc chèn ký tự dòng mới sẽ ngầm tạo một ParagraphMarker mới 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 là giữ nguyên kiểu của văn bản lân cận. Trong hầu hết các trường hợp, văn bản sẽ được thêm vào TextRun tồn tại ở 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.

insertionIndex

integer

Chỉ mục nơi văn bản sẽ được chèn, theo đơn vị mã Unicode, dựa trên các chỉ mục TextElement.

Chỉ mục dựa trên 0 và được tính từ đầu chuỗi. Bạn có thể điều chỉnh chỉ mục để ngăn việc chèn bên trong các cụm ký tự Unicode. Trong những trường hợp này, văn bản sẽ được chèn ngay sau cụm grapheme.

InsertTableRowsRequest

Chèn các hàng vào bảng.

Biểu diễn dưới dạng JSON 
{
  "tableObjectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "insertBelow": boolean,
  "number": integer
}
Trường
tableObjectId

string

Bảng để chèn hàng vào.

cellLocation

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.

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

integer

Số hàng cần chèn. Tối đa 20 cho mỗi yêu cầu.

InsertTableColumnsRequest

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

Các cột khác trong bảng sẽ được đổi kích thước cho vừa với cột mới.

Biểu diễn dưới dạng JSON 
{
  "tableObjectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "insertRight": boolean,
  "number": integer
}
Trường
tableObjectId

string

Bảng để chèn cột vào.

cellLocation

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.

insertRight

boolean

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

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

integer

Số lượng cột sẽ được chèn. Tối đa 20 cho mỗi yêu cầu.

DeleteTableRowRequest

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

Biểu diễn dưới dạng JSON 
{
  "tableObjectId": string,
  "cellLocation": {
    object (TableCellLocation)
  }
}
Trường
tableObjectId

string

Bảng cần xoá hàng.

cellLocation

object (TableCellLocation)

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

Hàng kéo dài trong ô này sẽ bị xoá. Nếu đây là ô được hợp nhất, nhiều hàng 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á.

DeleteTableColumnRequest

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

Biểu diễn dưới dạng JSON 
{
  "tableObjectId": string,
  "cellLocation": {
    object (TableCellLocation)
  }
}
Trường
tableObjectId

string

Bảng để xoá cột.

cellLocation

object (TableCellLocation)

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

Cột trải rộng trong ô này sẽ bị xoá. Nếu đây là ô được hợp nhất, nhiều cột 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á.

ReplaceAllTextRequest

Thay thế tất cả các lần xuất hiện của văn bản phù hợp với tiêu chí bằng replace text.

Biểu diễn dưới dạng JSON 
{
  "replaceText": string,
  "pageObjectIds": [
    string
  ],

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

string

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

pageObjectIds[]

string

Nếu giá trị không trống, hãy giới hạn việc so khớp chỉ với các phần tử trang trên các trang nhất định.

Trả về lỗi yêu cầu không hợp lệ 400 nếu được cung cấp mã nhận dạng đối tượng trang của notes master hoặc nếu trang có mã nhận dạng đối tượng đó không tồn tại trong bản trình bày.

Trường kết hợp criteria. Tiêu chí được sử dụng để khớp văn bản cần thay thế. criteria chỉ có thể là một trong các trạng thái sau:
containsText

object (SubstringMatchCriteria)

Tìm văn bản có hình dạng khớp với chuỗi con này.

SubstringMatchCriteria

Tiêu chí khớp với một chuỗi văn bản cụ thể trong một hình dạng hoặc bảng.

Biểu diễn dưới dạng JSON 
{
  "text": string,
  "matchCase": boolean
}
Trường
text

string

Văn bản cần tìm kiếm trong hình dạng hoặc bảng.

matchCase

boolean

Cho biết liệu nội dung tìm kiếm có phân biệt chữ hoa chữ thường hay không:

  • True: nội dung tìm kiếm có 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.

DeleteObjectRequest

Xoá đối tượng pages hoặc page elements trong bản trình bày.

Biểu diễn dưới dạng JSON 
{
  "objectId": string
}
Trường
objectId

string

Mã nhận dạng đối tượng của trang hoặc thành phần trang cần xoá.

Nếu sau một thao tác xoá, group chỉ chứa 1 hoặc không có phần tử trang nào, thì nhóm đó cũng sẽ bị xoá.

Nếu phần giữ chỗ bị xoá trên một bố cục, thì mọi phần giữ chỗ kế thừa trống cũng sẽ bị xoá.

UpdatePageElementTransformRequest

Cập nhật biến đổi của một phần tử trang.

Việc cập nhật cách biến đổi của một nhóm sẽ làm thay đổi sự biến đổi tuyệt đối của các phần tử trang trong nhóm đó. Điều này có thể làm thay đổi giao diện trực quan của các phần tử đó. Hãy xem tài liệu dành cho PageElement.transform để biết thêm chi tiết.

Biểu diễn dưới dạng JSON 
{
  "objectId": string,
  "transform": {
    object (AffineTransform)
  },
  "applyMode": enum (ApplyMode)
}
Trường
objectId

string

Mã đối tượng của phần tử trang cần cập nhật.

transform

object (AffineTransform)

Ma trận biến đổi đầu vào dùng để cập nhật phần tử trang.

applyMode

enum (ApplyMode)

Chế độ áp dụng của nội dung cập nhật chuyển đổi.

ApplyMode

Các chế độ áp dụng của bản cập nhật biến đổi.

Enum
APPLY_MODE_UNSPECIFIED Chế độ không xác định.
RELATIVE Áp dụng ma trận AffineTransform mới cho ma trận hiện có và thay thế ma trận hiện có bằng phép nối thu được.
ABSOLUTE Thay thế ma trận AffineTransform hiện tại bằng ma trận mới.

UpdateSlidesPositionRequest

Cập nhật vị trí của các trang trình bày trong bản trình bày.

Biểu diễn dưới dạng JSON 
{
  "slideObjectIds": [
    string
  ],
  "insertionIndex": integer
}
Trường
slideObjectIds[]

string

Mã của các trang trình bày trong bản trình bày cần di chuyển. Các trang trình bày trong danh sách này phải theo thứ tự trình bày hiện có và không được trùng lặp.

insertionIndex

integer

Chỉ mục mà tại đó các trang trình bày sẽ được chèn vào, dựa trên cách sắp xếp trang trình bày trước khi quá trình di chuyển diễn ra. Phải nằm trong khoảng từ 0 đến số trang trình bày trong bản trình bày, bao gồm cả số trang trình bày đó.

DeleteTextRequest

Xoá văn bản khỏi một hình dạng hoặc ô trong bảng.

Biểu diễn dưới dạng JSON 
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "textRange": {
    object (Range)
  }
}
Trường
objectId

string

Mã đối tượng của hình dạng hoặc bảng mà văn bản sẽ bị xoá.

cellLocation

object (TableCellLocation)

Vị trí ô không bắt buộc trong bảng nếu văn bản sắp bị xoá khỏi một ô trong bảng. Nếu có, objectId phải tham chiếu đến một bảng.

textRange

object (Range)

Phạm vi văn bản cần xoá, dựa trên các chỉ mục TextElement.

Luôn có một ký tự dòng mới ngầm ẩn ở cuối văn bản của ô hoặc hình dạng không thể xoá được. Range.Type.ALL sẽ sử dụng các giới hạn chính xác, nhưng bạn phải cẩn thận khi chỉ định các giới hạn rõ ràng cho các loại dải ô FROM_START_INDEX và FIXED_RANGE. Ví dụ: nếu văn bản là "ABC", theo sau là một dòng mới ngầm ẩn, thì giá trị tối đa là 2 đối với textRange.start_index và 3 đối với textRange.end_index.

Việc xoá văn bản nằm trên ranh giới của một đoạn văn có thể dẫn đến thay đổi đối với kiểu đoạn văn và danh sách khi hai đoạn văn được hợp nhất.

Những phạm vi chỉ bao gồm một đơn vị mã của cặp thay thế được mở rộng để bao gồm cả hai đơn vị mã.

Phạm vi

Chỉ định một dải liên tục của một bộ sưu tập được lập chỉ mục, chẳng hạn như các ký tự trong văn bản.

Biểu diễn dưới dạng JSON 
{
  "startIndex": integer,
  "endIndex": integer,
  "type": enum (Type)
}
Trường
startIndex

integer

Chỉ mục bắt đầu bằng 0 ở vị trí đầu tập hợp. Bắt buộc đối với FIXED_RANGE và FROM_START_INDEX phạm vi ngày.

endIndex

integer

Chỉ mục gốc (không bắt buộc) ở cuối tập hợp. Bắt buộc đối với các dải ô FIXED_RANGE.

type

enum (Type)

Loại dải ô.

Loại

Các loại dải ô.

Enum
RANGE_TYPE_UNSPECIFIED Loại dải ô không xác định. Không được sử dụng giá trị này.
FIXED_RANGE Phạm vi cố định. Bạn phải chỉ định cả startIndex và endIndex.
FROM_START_INDEX Bắt đầu phạm vi lúc startIndex và tiếp tục cho đến khi kết thúc bộ sưu tập. Chiến lược phát hành đĩa đơn endIndex không được chỉ định.
ALL Đặt dải ô thành toàn bộ thời lượng của bộ sưu tập. Bạn không được chỉ định cả startIndex và endIndex.

CreateImageRequest

Tạo hình ảnh.

Biểu diễn dưới dạng JSON 
{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },

  // Union field image_source can be only one of the following:
  "url": string
  // End of list of possible types for union field image_source.
}
Trường
objectId

string

Mã nhận dạng đối tượng do người dùng cung cấp.

Nếu bạn chỉ định một mã nhận dạng, mã đó phải là duy nhất trong số tất cả các trang và phần tử trang trong bản trình bày. Mã nhận dạng phải bắt đầu bằng một ký tự chữ-số hoặc dấu gạch dưới (khớp với biểu thức chính quy [a-zA-Z0-9_]); các ký tự còn lại có thể bao gồm các ký tự đó cũng như dấu gạch nối hoặc dấu hai chấm (khớp với biểu thức chính quy [a-zA-Z0-9_-:]). Độ dài của mã nhận dạng không được ít hơn 5 hoặc nhiều hơn 50.

Nếu bạn không chỉ định mã nhận dạng, thì một mã duy nhất sẽ được tạo.

elementProperties

object (PageElementProperties)

Thuộc tính phần tử cho hình ảnh.

Khi tỷ lệ khung hình của kích thước được cung cấp không khớp với tỷ lệ khung hình của hình ảnh, hình ảnh sẽ được điều chỉnh theo tỷ lệ và căn giữa theo kích thước để duy trì tỷ lệ khung hình. Phép biến đổi được cung cấp sẽ được áp dụng sau thao tác này.

Chiến lược phát hành đĩa đơn PageElementProperties.size là không bắt buộc. Nếu bạn không chỉ định kích thước, thì kích thước mặc định của hình ảnh sẽ được sử dụng.

Thuộc tính PageElementProperties.transform là không bắt buộc. Nếu bạn không chỉ định phép biến đổi, hình ảnh sẽ được đặt ở góc trên cùng bên trái của trang.

Trường kết hợp image_source. Loại nguồn hình ảnh. image_source chỉ có thể là một trong các trạng thái sau:
url

string

URL hình ảnh.

Hình ảnh được tìm nạp 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ị bên trong bản trình bày. Hình ảnh phải có kích thước dưới 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.

URL bạn cung cấp phải có thể truy cập công khai và có kích thước tối đa là 2 KB. URL được lưu cùng với hình ảnh và được hiển thị thông qua Image.source_url .

CreateVideoRequest

Tạo video.

LƯU Ý: Để tạo video từ Google Drive, ứng dụng yêu cầu phải có ít nhất một trong các phạm vi của Drive, drive.readonly hoặc drive.file.

Biểu diễn dưới dạng JSON 
{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "source": enum (Source),
  "id": string
}
Trường
objectId

string

Mã nhận dạng đối tượng do người dùng cung cấp.

Nếu bạn chỉ định một mã nhận dạng, mã đó phải là duy nhất trong số tất cả các trang và phần tử trang trong bản trình bày. Mã nhận dạng phải bắt đầu bằng một ký tự chữ-số hoặc dấu gạch dưới (khớp với biểu thức chính quy [a-zA-Z0-9_]); các ký tự còn lại có thể bao gồm các ký tự đó cũng như dấu gạch nối hoặc dấu hai chấm (khớp với biểu thức chính quy [a-zA-Z0-9_-:]). Độ dài của mã nhận dạng không được ít hơn 5 hoặc nhiều hơn 50.

Nếu bạn không chỉ định mã nhận dạng, hệ thống sẽ tạo một mã nhận dạng duy nhất.

elementProperties

object (PageElementProperties)

Thuộc tính phần tử cho video.

Chiến lược phát hành đĩa đơn PageElementProperties.size là không bắt buộc. Nếu bạn không chỉ định kích thước, máy chủ sẽ chọn kích thước mặc định.

Chiến lược phát hành đĩa đơn PageElementProperties.transform là không bắt buộc. Biến đổi không được có các thành phần cắt. Nếu bạn không chỉ định phép biến đổi, video sẽ được đặt ở góc trên cùng bên trái của trang.

source

enum (Source)

Nguồn video.

id

string

Giá trị nhận dạng riêng biệt của nguồn video cho video này.

Ví dụ: Đối với video trên YouTube https://www.youtube.com/watch?v=7U3axjORYZ0, mã nhận dạng là 7U3axjORYZ0. Đối với video trên Google Drive https://drive.google.com/file/d/1xCgQLFTJi5_Xl8DgW_lcUYq5e-q6Hi5Q mã nhận dạng là 1xCgQLFTJi5_Xl8DgW_lcUYq5e-q6Hi5Q.

Để truy cập vào tệp video trên Google Drive, bạn có thể cần thêm khoá tài nguyên vào tiêu đề HTTP cho một nhóm nhỏ tệp cũ. Để biết thêm thông tin, hãy xem phần Truy cập vào tệp được chia sẻ qua đường liên kết bằng khoá tài nguyên.

CreateSheetsChartRequest

Tạo biểu đồ được nhúng trên Google Trang tính.

LƯU Ý: Để tạo biểu đồ, bạn cần có ít nhất một trong các phạm vi OAuth sau: spreadsheets.readonly, spreadsheets, drive.readonly, drive.file hoặc drive.

Biểu diễn dưới dạng JSON 
{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "spreadsheetId": string,
  "chartId": integer,
  "linkingMode": enum (LinkingMode)
}
Trường
objectId

string

Mã đối tượng do người dùng cung cấp.

Nếu được chỉ định, mã nhận dạng phải là duy nhất trong tất cả các trang và phần tử trang trong bản trình bày. Mã nhận dạng phải bắt đầu bằng một ký tự từ [a-zA-Z0-9_], theo sau là một số ký tự bất kỳ trong số [a-zA-Z0-9_-:]. Mã nhận dạng không được ngắn hơn 5 ký tự hoặc dài hơn 50 ký tự. Nếu để trống, hệ thống sẽ tạo một mã nhận dạng duy nhất.

elementProperties

object (PageElementProperties)

Thuộc tính phần tử cho biểu đồ.

Khi tỷ lệ khung hình của kích thước được cung cấp không khớp với tỷ lệ khung hình của biểu đồ, biểu đồ sẽ được điều chỉnh theo tỷ lệ và căn giữa theo kích thước để duy trì tỷ lệ khung hình. Biến đổi được cung cấp sẽ được áp dụng sau thao tác này.

spreadsheetId

string

Mã nhận dạng của bảng tính Google Trang tính chứa biểu đồ.

Bạn có thể cần thêm khoá tài nguyên vào tiêu đề HTTP cho một tập hợp con các tệp cũ. Để biết thêm thông tin, hãy xem Truy cập vào tệp được chia sẻ đường liên kết bằng khoá tài nguyên.

chartId

integer

Mã của biểu đồ cụ thể trong bảng tính Google Trang tính.

linkingMode

enum (LinkingMode)

Chế độ mà biểu đồ được liên kết với bảng tính nguồn. Khi không được chỉ định, biểu đồ sẽ là hình ảnh không được liên kết.

LinkingMode

Chế độ mà biểu đồ được liên kết với bảng tính nguồn.

Enum
NOT_LINKED_IMAGE Biểu đồ không được liên kết với bảng tính nguồn và không thể cập nhật. Biểu đồ không được liên kết sẽ được chèn dưới dạng hình ảnh.
LINKED Việc liên kết biểu đồ cho phép bạn cập nhật biểu đồ và các cộng tác viên khác sẽ thấy một liên kết đến bảng tính.

CreateLineRequest

Tạo một dòng.

Biểu diễn dưới dạng JSON 
{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "lineCategory": enum (Category),
  "category": enum (LineCategory)
}
Trường
objectId

string

Mã nhận dạng đối tượng do người dùng cung cấp.

Nếu bạn chỉ định một mã nhận dạng, mã đó phải là duy nhất trong số tất cả các trang và phần tử trang trong bản trình bày. Mã nhận dạng phải bắt đầu bằng một ký tự chữ-số hoặc dấu gạch dưới (khớp với biểu thức chính quy [a-zA-Z0-9_]); các ký tự còn lại có thể bao gồm các ký tự đó cũng như dấu gạch nối hoặc dấu hai chấm (khớp với biểu thức chính quy [a-zA-Z0-9_-:]). Độ dài của mã nhận dạng không được ít hơn 5 hoặc nhiều hơn 50.

Nếu bạn không chỉ định mã nhận dạng, hệ thống sẽ tạo một mã nhận dạng duy nhất.

elementProperties

object (PageElementProperties)

Các thuộc tính phần tử của đường.

lineCategory
(deprecated)

enum (Category)

Danh mục của dòng cần tạo.

Không được tán thành : sử dụng category thay thế.

line type chính xác được tạo được xác định dựa trên danh mục và cách danh mục đó được định tuyến để kết nối với các phần tử trang khác.

Nếu bạn chỉ định cả category và một lineCategory, category sẽ được ưu tiên.

category

enum (LineCategory)

Danh mục của dòng cần tạo.

Cụm từ chính xác line type được tạo dựa trên danh mục và cách danh mục được định tuyến để kết nối với các phần tử khác của trang.

Nếu bạn chỉ định cả category và lineCategory, thì category sẽ được ưu tiên.

Nếu bạn không chỉ định giá trị cho category, nhưng chỉ định giá trị cho lineCategory, thì giá trị lineCategory đã chỉ định sẽ được sử dụng.

Nếu bạn không chỉ định, thì STRAIGHT sẽ được sử dụng.

Danh mục

Danh mục dòng.

Enum
STRAIGHT Giắc cắm thẳng, bao gồm cả giắc cắm thẳng 1. Đây là danh mục mặc định khi bạn không chỉ định danh mục.
BENT Đầu nối bị cong, bao gồm cả đầu nối bị cong 2 đến 5.
CURVED Đường nối cong, bao gồm cả đường nối cong 2 đến 5.

RefreshSheetsChartRequest

Làm mới biểu đồ được nhúng trên Google Trang tính bằng cách thay thế biểu đồ đó bằng phiên bản mới nhất của biểu đồ trên Google Trang tính.

LƯU Ý: Để làm mới biểu đồ, bạn cần có ít nhất một trong các phạm vi OAuth spreadsheets.readonly, spreadsheets, drive.readonly hoặc drive.

Biểu diễn dưới dạng JSON 
{
  "objectId": string
}
Trường
objectId

string

Mã đối tượng của biểu đồ cần làm mới.

UpdateShapePropertiesRequest

Cập nhật các thuộc tính của Shape.

Biểu diễn dưới dạng JSON 
{
  "objectId": string,
  "shapeProperties": {
    object (ShapeProperties)
  },
  "fields": string
}
Trường
objectId

string

Mã nhận dạng đối tượng của hình dạng mà nội dung cập nhật được áp dụng.

shapeProperties

object (ShapeProperties)

Các thuộc tính hình dạng cần cập nhật.

fields

string (FieldMask format)

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

Bạn phải chỉ định ít nhất một trường. Gốc shapeProperties đã đượ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 đồng nhất của hình dạng, hãy đặt fields thành "shapeBackgroundFill.solidFill.color".

Để đặt lại một thuộc tính về giá trị mặc định, hãy thêm tên trường vào mặt nạ trường nhưng để trống trường đó.

UpdateImagePropertiesRequest

Cập nhật các thuộc tính của Image.

Biểu diễn dưới dạng JSON 
{
  "objectId": string,
  "imageProperties": {
    object (ImageProperties)
  },
  "fields": string
}
Trường
objectId

string

Mã đối tượng của hình ảnh mà nội dung cập nhật được áp dụng.

imageProperties

object (ImageProperties)

Các thuộc tính hình ảnh cần cập nhật.

fields

string (FieldMask format)

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

Bạn phải chỉ định ít nhất một trường. Gốc imageProperties đã được ngụ ý và không được chỉ định. Bạn có thể dùng một "*" để liệt kê mọi trường.

Ví dụ: để cập nhật màu viền của hình ảnh, hãy đặt fields đến "outline.outlineFill.solidFill.color".

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

UpdateVideoPropertiesRequest

Cập nhật các thuộc tính của Video.

Biểu diễn dưới dạng JSON 
{
  "objectId": string,
  "videoProperties": {
    object (VideoProperties)
  },
  "fields": string
}
Trường
objectId

string

Mã đối tượng của video mà nội dung cập nhật được áp dụng.

videoProperties

object (VideoProperties)

Các thuộc tính video cần cập nhật.

fields

string (FieldMask format)

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

Bạn phải chỉ định ít nhất một trường. Gốc videoProperties đã đượ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.

Chẳng hạn, để cập nhật màu viền của video, hãy đặt fields đến "outline.outlineFill.solidFill.color".

Để đặt lại một thuộc tính về giá trị mặc định, hãy thêm tên trường vào mặt nạ trường nhưng để trống trường đó.

UpdatePagePropertiesRequest

Cập nhật các thuộc tính của một Page.

Biểu diễn dưới dạng JSON 
{
  "objectId": string,
  "pageProperties": {
    object (PageProperties)
  },
  "fields": string
}
Trường
objectId

string

Mã đối tượng của trang áp dụng nội dung cập nhật.

pageProperties

object (PageProperties)

Các thuộc tính trang cần cập nhật.

fields

string (FieldMask format)

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

Bạn phải chỉ định ít nhất một trường. pageProperties gốc được ngụ ý và không được chỉ định. Bạn có thể dùng một "*" để liệt kê mọi trường.

Ví dụ: để cập nhật màu nền đồng nhất của trang, đặt fields đến "pageBackgroundFill.solidFill.color".

Để đặt lại một thuộc tính về giá trị mặc định, hãy thêm tên trường vào mặt nạ trường nhưng để trống trường đó.

UpdateTableCellPropertiesRequest

Cập nhật các thuộc tính của TableCell.

Biểu diễn dưới dạng JSON 
{
  "objectId": string,
  "tableRange": {
    object (TableRange)
  },
  "tableCellProperties": {
    object (TableCellProperties)
  },
  "fields": string
}
Trường
objectId

string

Mã đối tượng của bảng.

tableRange

object (TableRange)

Phạm vi 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. Nếu một dải ô của bảng không được chỉ định, thì nội dung cập nhật sẽ áp dụng cho toàn bộ bảng.

tableCellProperties

object (TableCellProperties)

Các thuộc tính ô trong bảng cần cập nhật.

fields

string (FieldMask format)

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

Bạn phải chỉ định ít nhất một trường. Gốc tableCellProperties đã đượ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 ô bảng đồng nhất, hãy đặt fields thành "tableCellBackgroundFill.solidFill.color".

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

TableRange

Dải ô của bảng đạ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 dải ô của 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 ô trong bảng có vị trí = (0, 0), span hàng = 3 và span cột = 2 chỉ định các ô sau: 

 [ x ][ x ][   ]
 [ x ][ x ][   ]
 [ x    x    x ]
Biểu diễn dưới dạng JSON 
{
  "location": {
    object (TableCellLocation)
  },
  "rowSpan": integer,
  "columnSpan": integer
}
Trường
location

object (TableCellLocation)

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

rowSpan

integer

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

columnSpan

integer

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

UpdateLinePropertiesRequest

Cập nhật các thuộc tính của một Line.

Biểu diễn dưới dạng JSON 
{
  "objectId": string,
  "lineProperties": {
    object (LineProperties)
  },
  "fields": string
}
Trường
objectId

string

Mã đối tượng của dòng mà bản cập nhật được áp dụng.

lineProperties

object (LineProperties)

Các thuộc tính dòng cần cập nhật.

fields

string (FieldMask format)

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

Bạn phải chỉ định ít nhất một trường. lineProperties gốc đượ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 tô liền của đường, hãy đặt fields thành "lineFill.solidFill.color".

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

CreateParagraphBulletsRequest

Tạo dấu đầu dòng cho tất cả các đoạn văn trùng lặp với phạm vi chỉ mục văn bản đã cho.

Mức độ lồng ghép của mỗi đoạn sẽ được xác định bằng cách đếm các thẻ ở đầu mỗi đoạn. Để tránh thừa khoảng trống giữa dấu đầu dòng và đoạn tương ứng, yêu cầu này sẽ xoá các thẻ ở đầ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 đoạn được cập nhật nằm trong danh sách có giá trị đặt trước phù hợp, thì các đoạn văn đang được cập nhật sẽ được thêm vào danh sách trước đó.

Biểu diễn dưới dạng JSON 
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "textRange": {
    object (Range)
  },
  "bulletPreset": enum (BulletGlyphPreset)
}
Trường
objectId

string

Mã nhận dạng đối tượng của hình dạng hoặc bảng chứa văn bản cần thêm dấu đầu dòng.

cellLocation

object (TableCellLocation)

Vị trí ô bảng không bắt buộc nếu văn bản cần sửa đổi nằm trong ô bảng. Nếu có, objectId phải tham chiếu đến một bảng.

textRange

object (Range)

Phạm vi văn bản cần áp dụng giá trị đặt trước cho dấu đầu dòng, dựa trên TextElement chỉ mục.

bulletPreset

enum (BulletGlyphPreset)

Các loại ký tự dấu đầu dòng sẽ được sử dụng. Mặc định là BULLET_DISC_CIRCLE_SQUARE giá trị đặt trước.

BulletGlyphPreset

Mẫu đặt trước của các ký tự dấu đầu dòng cho danh sách trong văn bản.

Các mẫu này sử dụng các 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ô bóng 3D, tương ứng với điểm mã Unicode U+27a2
  • CHECKBOX: Hình vuông rỗng, tương ứng với điểm mã Unicode U+274f
  • CIRCLE : Một vòng tròn rỗng, tương ứng với một điểm mã Unicode U+25cb
  • DIAMOND : Một viên kim cương đặc, tương ứng với điểm mã Unicode U+25c6
  • DIAMONDX: Hình kim cương có dấu "x", tương ứng với điểm mã Unicode U+2756
  • HOLLOWDIAMOND: Hình thoi rỗng, tương ứng với điểm mã Unicode U+25c7
  • DISC : Một vòng tròn đặc, tương ứng với điểm mã Unicode U+25cf
  • SQUARE: Một hình vuông đặc, tương ứng với một điểm mã Unicode U+25a0
  • STAR : Một ngôi sao, tương ứng với điểm mã Unicode U+2605
  • ALPHA : Một chữ cái viết thường, như "a", "b" hoặc "c".
  • UPPERALPHA: Chữ hoa, chẳng hạn như "A", "B" hoặc "C".
  • DIGIT : Một số, chẳng hạn như '1', '2' hoặc '3'.
  • ZERODIGIT: Số có tiền tố là số có một chữ số, chẳng hạn như "01", "02" hoặc "03". Số có nhiều chữ số không có tiền tố là số 0.
  • ROMAN: Chữ số La Mã viết thường, chẳng hạn như "i", "ii" hoặc "iii".
  • UPPERROMAN: Số La Mã viết hoa, chẳng hạn như "I", "II" hoặc "III".
  • LEFTTRIANGLE : Một hình tam giác trỏ sang trái, tương ứng với điểm mã Unicode U+25c4
Enum
BULLET_DISC_CIRCLE_SQUARE Danh sách có dấu đầu dòng với ký tự dấu đầu dòng DISC, CIRCLE và SQUARE cho 3 cấp độ lồng ghép danh sách đầu tiên.
BULLET_DIAMONDX_ARROW3D_SQUARE Danh sách có dấu đầu dòng chứa DIAMONDX! ARROW3D và SQUARE ký tự gạch đầu dòng cho 3 cấp độ lồng ghép danh sách đầu tiên.
BULLET_CHECKBOX Danh sách có dấu đầu dòng gồm CHECKBOX ký tự gạch đầu dòng cho tất cả các cấp độ lồng nhau của danh sách.
BULLET_ARROW_DIAMOND_DISC Danh sách có dấu đầu dòng chứa ARROW! DIAMOND và DISC ký tự gạch đầu dòng cho 3 cấp độ lồng ghép danh sách đầu tiên.
BULLET_STAR_CIRCLE_SQUARE Danh sách có dấu đầu dòng chứa STAR! CIRCLE và SQUARE ký tự gạch đầu dòng cho 3 cấp độ lồng ghép danh sách đầu tiên.
BULLET_ARROW3D_CIRCLE_SQUARE Danh sách có dấu đầu dòng với ký tự dấu đầu dòng ARROW3D, CIRCLE và SQUARE cho 3 cấp độ lồng ghép danh sách đầu tiên.
BULLET_LEFTTRIANGLE_DIAMOND_DISC Danh sách có dấu đầu dòng với ký tự dấu đầu dòng LEFTTRIANGLE, DIAMOND và DISC cho 3 cấp độ lồng ghép danh sách đầu tiên.
BULLET_DIAMONDX_HOLLOWDIAMOND_SQUARE Danh sách có dấu đầu dòng với ký tự dấu đầu dòng DIAMONDX, HOLLOWDIAMOND và SQUARE cho 3 cấp độ lồng ghép danh sách đầu tiên.
BULLET_DIAMOND_CIRCLE_SQUARE Danh sách có dấu đầu dòng chứa DIAMOND! CIRCLE và SQUARE ký tự gạch đầu dòng cho 3 cấp độ lồng ghép danh sách đầu tiên.
NUMBERED_DIGIT_ALPHA_ROMAN Danh sách được đánh số có DIGIT! ALPHA và ROMAN ký tự số cho 3 cấp độ lồng ghép danh sách đầu tiên, theo sau là dấu chấm.
NUMBERED_DIGIT_ALPHA_ROMAN_PARENS Danh sách được đánh số bằng các ký tự số DIGIT, ALPHA và ROMAN cho 3 cấp độ lồng ghép danh sách đầu tiên, theo sau là dấu ngoặc đơn.
NUMBERED_DIGIT_NESTED Danh sách được đánh số có các ký tự số DIGIT được phân tách bằng dấu chấm, trong đó mỗi cấp lồng nhau sử dụng ký tự của cấp lồng nhau 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ố có UPPERALPHA! ALPHA và ROMAN ký tự số cho 3 cấp độ lồng ghép danh sách đầu tiên, theo sau là dấu chấm.
NUMBERED_UPPERROMAN_UPPERALPHA_DIGIT Danh sách được đánh số bằng các ký tự số UPPERROMAN, UPPERALPHA và DIGIT cho 3 cấp độ lồng ghép danh sách đầu tiên, theo sau là dấu chấm.
NUMBERED_ZERODIGIT_ALPHA_ROMAN Danh sách được đánh số có ZERODIGIT! ALPHA và ROMAN ký tự số cho 3 cấp độ lồng ghép danh sách đầu tiên, theo sau là dấu chấm.

ReplaceAllShapesWithImageRequest

Thay thế tất cả các hình dạng khớp với tiêu chí đã cho bằng hình ảnh được cung cấp.

Hình ảnh thay thế các hình dạng có dạng hình chữ nhật sau khi được chèn vào bản trình bày và không có hình dạng của các hình dạng đó.

Biểu diễn dưới dạng JSON 
{
  "replaceMethod": enum (ReplaceMethod),
  "imageReplaceMethod": enum (ImageReplaceMethod),
  "pageObjectIds": [
    string
  ],

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

  // Union field image_source can be only one of the following:
  "imageUrl": string
  // End of list of possible types for union field image_source.
}
Trường
replaceMethod
(deprecated)

enum (ReplaceMethod)

Phương thức thay thế.

Không dùng nữa: hãy sử dụng imageReplaceMethod.

Nếu bạn chỉ định cả replaceMethod và imageReplaceMethod, thì imageReplaceMethod sẽ được ưu tiên.

imageReplaceMethod

enum (ImageReplaceMethod)

Phương thức thay thế hình ảnh.

Nếu bạn chỉ định cả replaceMethod và một imageReplaceMethod, imageReplaceMethod sẽ được ưu tiên.

Nếu bạn không chỉ định giá trị cho imageReplaceMethod, nhưng chỉ định giá trị cho replaceMethod, thì hàm được chỉ định replaceMethod giá trị được sử dụng.

Nếu bạn không chỉ định, thì CENTER_INSIDE sẽ được sử dụng.

pageObjectIds[]

string

Nếu không trống, hãy giới hạn các kết quả trùng khớp chỉ với các phần tử trang trên các trang đã cho.

Trả về lỗi yêu cầu không hợp lệ 400 nếu được cung cấp mã nhận dạng đối tượng trang của notes page hoặc notes master, hoặc nếu trang có mã nhận dạng đối tượng đó không tồn tại trong bản trình bày.

Trường hợp hợp nhất criteria. Tiêu chí mà hình dạng phải khớp để được thay thế. criteria chỉ có thể là một trong những loại sau:
containsText

object (SubstringMatchCriteria)

Nếu được đặt, yêu cầu này sẽ thay thế tất cả các hình dạng chứa văn bản đã cho.

Trường kết hợp image_source. Loại nguồn hình ảnh. image_source chỉ có thể là một trong những loại sau:
imageUrl

string

URL hình ảnh.

Hình ảnh được tìm nạp 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ị bên trong bản trình bày. Hình ảnh phải có kích thước dưới 50 MB, không được vượt quá 25 megapixel và phải ở định dạng PNG, JPEG hoặc GIF.

URL được cung cấp có thể dài tối đa 2 kB. Bản thân URL được lưu cùng với hình ảnh và hiển thị thông qua Image.source_url .

ReplaceMethod

Phương thức thay thế.

Enum
CENTER_INSIDE Điều chỉnh tỷ lệ và căn giữa hình ảnh để vừa với giới hạn của hình dạng ban đầu, đồng thời duy trì tỷ lệ khung hình của hình ảnh. Kích thước kết xuất của hình ảnh có thể nhỏ hơn kích thước của hình dạng. Đây là phương thức mặc định khi không chỉ định phương thức nào.
CENTER_CROP Điều chỉnh tỷ lệ và căn giữa hình ảnh để lấp đầy ranh giới của hình dạng ban đầu. Hình ảnh có thể bị cắt để vừa với hình dạng. Kích thước kết xuất của hình ảnh sẽ giống với kích thước của hình dạng ban đầu.

ImageReplaceMethod

Phương thức thay thế hình ảnh.

Enum
IMAGE_REPLACE_METHOD_UNSPECIFIED Phương thức thay thế hình ảnh chưa được chỉ định. Không được sử dụng giá trị này.
CENTER_INSIDE Điều chỉnh tỷ lệ và căn giữa hình ảnh để vừa với giới hạn của hình dạng ban đầu, đồng thời duy trì tỷ lệ khung hình của hình ảnh. Kích thước kết xuất của hình ảnh có thể nhỏ hơn kích thước của hình dạng. Đây là phương thức mặc định khi không được chỉ định.
CENTER_CROP Điều chỉnh theo tỷ lệ và căn giữa hình ảnh để lấp đầy các ranh giới của hình dạng ban đầu. Hình ảnh có thể bị cắt để vừa với hình dạng. Kích thước kết xuất của hình ảnh sẽ giống với hình dạng ban đầu.

DuplicateObjectRequest

Nhân bản một trang trình bày hoặc phần tử trang.

Khi bạn sao chép một trang trình bày, trang trình bày trùng lặp sẽ được tạo ngay sau trang trình bày đã chỉ định. Khi sao chép phần tử trang, bản sao sẽ được đặt trên cùng một trang ở cùng một vị trí với phần tử gốc.

Biểu diễn dưới dạng JSON 
{
  "objectId": string,
  "objectIds": {
    string: string,
    ...
  }
}
Trường
objectId

string

Mã của đối tượng cần sao chép.

objectIds

map (key: string, value: string)

Đối tượng được sao chép có thể chứa các đối tượng khác, ví dụ: khi sao chép một trang trình bày hoặc phần tử trang nhóm. Bản đồ này xác định cách tạo mã nhận dạng của các đối tượng trùng lặp: khoá là mã nhận dạng của các đối tượng ban đầu và giá trị là mã nhận dạng sẽ được chỉ định cho đối tượng trùng lặp tương ứng. Bạn cũng có thể chỉ định mã nhận dạng của bản sao đối tượng nguồn trong bản đồ này, sử dụng cùng một giá trị của trường objectId làm khoá và mã nhận dạng mới mong muốn làm giá trị.

Tất cả các khoá phải tương ứng với mã nhận dạng hiện có trong bản trình bày. Tất cả các giá trị phải là duy nhất trong bản trình bày và phải bắt đầu bằng ký tự chữ-số hoặc dấu gạch dưới (khớp với biểu thức chính quy) [a-zA-Z0-9_]); các ký tự còn lại có thể bao gồm các ký tự đó cũng như dấu gạch nối hoặc dấu hai chấm (khớp với biểu thức chính quy [a-zA-Z0-9_-:]). Độ dài của mã nhận dạng mới không được nhỏ hơn 5 hoặc lớn hơn 50.

Nếu có mã nhận dạng nào của đối tượng nguồn bị bỏ qua khỏi bản đồ, thì hệ thống sẽ chỉ định một mã nhận dạng ngẫu nhiên mới. Nếu bản đồ trống hoặc không được đặt, tất cả các đối tượng trùng lặp sẽ nhận được một mã nhận dạng ngẫu nhiên mới.

UpdateTextStyleRequest

Cập nhật kiểu văn bản trong Shape hoặc Table.

Biểu diễn dưới dạng JSON 
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "style": {
    object (TextStyle)
  },
  "textRange": {
    object (Range)
  },
  "fields": string
}
Trường
objectId

string

Mã đối tượng của hình dạng hoặc bảng có văn bản cần tạo kiểu.

cellLocation

object (TableCellLocation)

Vị trí của ô trong bảng chứa văn bản cần tạo kiểu. Nếu objectId tham chiếu đến một bảng, thì cellLocation phải có giá trị. Nếu không, bạn không được làm như vậy.

style

object (TextStyle)

(Các) 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 đặ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 nhằm phản ánh hành vi của trình chỉnh sửa Trang trình bày. Xem tài liệu về TextStyle để biết thêm thông tin.

textRange

object (Range)

Phạm vi văn bản cần định 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.

fields

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 style đã đượ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 thành "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 đó.

ReplaceAllShapesWithSheetsChartRequest

Thay thế tất cả các hình dạng khớp với tiêu chí đã cho bằng biểu đồ được cung cấp trên Google Trang tính. Biểu đồ sẽ được điều chỉnh theo tỷ lệ và căn giữa cho vừa với giới hạn của hình dạng ban đầu.

LƯU Ý: Để thay thế hình dạng bằng biểu đồ, bạn cần có ít nhất một trong các phạm vi spreadsheets.readonly, spreadsheets, drive.readonly hoặc drive OAuth.

Biểu diễn dưới dạng JSON 
{
  "containsText": {
    object (SubstringMatchCriteria)
  },
  "spreadsheetId": string,
  "chartId": integer,
  "linkingMode": enum (LinkingMode),
  "pageObjectIds": [
    string
  ]
}
Trường
containsText

object (SubstringMatchCriteria)

Tiêu chí mà hình dạng phải khớp để được thay thế. Yêu cầu này sẽ thay thế tất cả các hình dạng chứa văn bản đã cho.

spreadsheetId

string

Mã nhận dạng của bảng tính Google Trang tính chứa biểu đồ.

chartId

integer

Mã của biểu đồ cụ thể trong bảng tính Google Trang tính.

linkingMode

enum (LinkingMode)

Chế độ mà biểu đồ được liên kết với bảng tính nguồn. Khi không được chỉ định, biểu đồ sẽ là hình ảnh không được liên kết.

pageObjectIds[]

string

Nếu không trống, hãy giới hạn các kết quả trùng khớp chỉ với các phần tử trang trên các trang đã cho.

Trả về lỗi yêu cầu không hợp lệ 400 nếu được cung cấp mã nhận dạng đối tượng trang của notes page hoặc notes master, hoặc nếu trang có mã nhận dạng đối tượng đó không tồn tại trong bản trình bày.

LinkingMode

Chế độ mà biểu đồ được liên kết với bảng tính nguồn.

Enum
NOT_LINKED_IMAGE Biểu đồ không được liên kết với bảng tính nguồn và không thể cập nhật. Biểu đồ không được liên kết sẽ được chèn dưới dạng hình ảnh.
LINKED Việc liên kết biểu đồ cho phép bạn cập nhật biểu đồ và các cộng tác viên khác sẽ thấy một liên kết đến bảng tính.

DeleteParagraphBulletsRequest

Xoá dấu đầu dòng khỏi tất cả các đoạn văn bản trùng lặp với chỉ mục văn bản đã cho range.

Mức độ lồng ghép của mỗi đoạn sẽ được bảo toàn 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 
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "textRange": {
    object (Range)
  }
}
Trường
objectId

string

Mã đối tượng của hình hoặc bảng chứa văn bản cần xoá dấu đầu dòng.

cellLocation

object (TableCellLocation)

Vị trí ô bảng không bắt buộc nếu văn bản cần sửa đổi nằm trong ô bảng. Nếu có, objectId phải tham chiếu đến một bảng.

textRange

object (Range)

Phạm vi văn bản cần xoá dấu đầu dòng, dựa trên các chỉ mục TextElement.

UpdateParagraphStyleRequest

Cập nhật kiểu cho tất cả các đoạn trong một Shape hoặc Table trùng với phạm vi chỉ mục văn bản đã cho.

Biểu diễn dưới dạng JSON 
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "style": {
    object (ParagraphStyle)
  },
  "textRange": {
    object (Range)
  },
  "fields": string
}
Trường
objectId

string

Mã đối tượng của hình dạng hoặc bảng có văn bản cần tạo kiểu.

cellLocation

object (TableCellLocation)

Vị trí của ô trong bảng chứa(các) đoạn cần tạo kiểu. Nếu objectId đề cập đến một bảng, cellLocation phải có giá trị. Nếu không, bạn không được làm vậy.

style

object (ParagraphStyle)

Kiểu của đoạn.

textRange

object (Range)

Dải ô văn bản chứa(các) đoạn cần tạo kiểu.

fields

string (FieldMask format)

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

Bạn phải chỉ định ít nhất một trường. style gốc đượ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 cách căn chỉnh đoạ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 đó.

UpdateTableBorderPropertiesRequest

Cập nhật các thuộc tính của đường viền bảng trong một Table.

Biểu diễn dưới dạng JSON 
{
  "objectId": string,
  "tableRange": {
    object (TableRange)
  },
  "borderPosition": enum (BorderPosition),
  "tableBorderProperties": {
    object (TableBorderProperties)
  },
  "fields": string
}
Trường
objectId

string

Mã đối tượng của bảng.

tableRange

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. Nếu bạn không chỉ định dải ô, thì nội dung cập nhật sẽ áp dụng cho toàn bộ bảng.

borderPosition

enum (BorderPosition)

Vị trí đường viền trong phạm vi bảng mà nội dung cập nhật sẽ áp dụng. Nếu bạn không chỉ định vị trí đường viền, nội dung cập nhật sẽ áp dụng cho tất cả đường viền trong dải ô của bảng.

tableBorderProperties

object (TableBorderProperties)

Các thuộc tính đường viền bảng cần cập nhật.

fields

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 tableBorderProperties đã đượ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 đồng nhất của đường viền bảng, hãy đặt fields thành "tableBorderFill.solidFill.color".

Để đặt lại một thuộc tính về giá trị mặc định, hãy thêm tên trường vào mặt nạ trường nhưng để trống trường đó.

BorderPosition

Vị trí đường viền của bảng.

Enum
ALL Tất cả đường viền trong dải ô.
BOTTOM Đường viền ở cuối dải ô.
INNER Đường viền ở bên trong dải ô.
INNER_HORIZONTAL Đường viền ngang ở bên trong dải ô.
INNER_VERTICAL Đường viền dọc ở bên trong dải ô.
LEFT Đường viền ở bên trái dải ô.
OUTER Đường viền dọc theo bên ngoài dải ô.
RIGHT Đường viền ở bên phải của phạm vi.
TOP Đường viền ở đầu dải ô.

UpdateTableColumnPropertiesRequest

Cập nhật các thuộc tính của cột Table.

Biểu diễn dưới dạng JSON 
{
  "objectId": string,
  "columnIndices": [
    integer
  ],
  "tableColumnProperties": {
    object (TableColumnProperties)
  },
  "fields": string
}
Trường
objectId

string

Mã đối tượng của bảng.

columnIndices[]

integer

Danh sách các chỉ mục dựa trên 0 chỉ định cột cần cập nhật. Nếu không có chỉ mục nào được cung cấp, tất cả các cột trong bảng sẽ được cập nhật.

tableColumnProperties

object (TableColumnProperties)

Các thuộc tính cột trong bảng cần cập nhật.

Nếu giá trị của tableColumnProperties#columnWidth trong yêu cầu là ít hơn 406.400 EMU (32 điểm), một lỗi yêu cầu không hợp lệ 400 được trả về.

fields

string (FieldMask format)

Các trường cần 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. Bạn có thể dùng một "*" để 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 "columnWidth".

Nếu là '"columnWidth"' có trong mặt nạ trường nhưng thuộc tính không được đặt, chiều rộng cột sẽ mặc định là 406.400 EMU (32 điểm).

UpdateTableRowPropertiesRequest

Cập nhật các thuộc tính của một Table hàng.

Biểu diễn dưới dạng JSON 
{
  "objectId": string,
  "rowIndices": [
    integer
  ],
  "tableRowProperties": {
    object (TableRowProperties)
  },
  "fields": string
}
Trường
objectId

string

Mã nhận dạng đối tượng của bảng.

rowIndices[]

integer

Danh sách các chỉ mục dựa trên 0 chỉ định những hàng cần cập nhật. Nếu không có chỉ mục nào được cung cấp, tất cả các hàng trong bảng sẽ được cập nhật.

tableRowProperties

object (TableRowProperties)

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

fields

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. tableRowProperties gốc được ngụ ý và không được chỉ định. Bạn có thể dùng một "*" để 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".

Nếu "minRowHeight" có trong mặt nạ trường nhưng thuộc tính này không được đặt, thì chiều cao tối thiểu của hàng sẽ mặc định là 0.

MergeTableCellsRequest

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

Biểu diễn dưới dạng JSON 
{
  "objectId": string,
  "tableRange": {
    object (TableRange)
  }
}
Trường
objectId

string

Mã đối tượng của bảng.

tableRange

object (TableRange)

Dải ô của bảng chỉ định những ô của 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ía trên bên trái ("đầu") của dả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), thì hệ thống sẽ trả về lỗi 400 yêu cầu không hợp lệ.

UnmergeTableCellsRequest

Huỷ hợp nhất các ô trong Table.

Biểu diễn dưới dạng JSON 
{
  "objectId": string,
  "tableRange": {
    object (TableRange)
  }
}
Trường
objectId

string

Mã đối tượng của bảng.

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ó ô đượ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ỳ ô nào đã hợp nhất, thì văn bản đó sẽ vẫn nằm trong ô trên cùng bên trái ("đầu") của khối ô không hợp nhất thu được.

GroupObjectsRequest

Nhóm các đối tượng để tạo một nhóm đối tượng. Ví dụ: nhóm PageElements để tạo một Group trên cùng một trang với tất cả trang con.

Biểu diễn dưới dạng JSON 
{
  "groupObjectId": string,
  "childrenObjectIds": [
    string
  ]
}
Trường
groupObjectId

string

Mã đối tượng do người dùng cung cấp cho nhóm cần tạo.

Nếu bạn chỉ định mã nhận dạng, mã nhận dạng đó phải là duy nhất trong tất cả các trang và phần tử trang trong bản trình bày. Mã nhận dạng phải bắt đầu bằng một ký tự chữ-số hoặc dấu gạch dưới (khớp với biểu thức chính quy [a-zA-Z0-9_]); các ký tự còn lại có thể bao gồm các ký tự đó cũng như dấu gạch nối hoặc dấu hai chấm (khớp với biểu thức chính quy [a-zA-Z0-9_-:]). Độ dài của mã nhận dạng không được ít hơn 5 hoặc nhiều hơn 50.

Nếu bạn không chỉ định mã nhận dạng, hệ thống sẽ tạo một mã nhận dạng duy nhất.

childrenObjectIds[]

string

Mã đối tượng của các đối tượng cần nhóm.

Bạn chỉ có thể nhóm các phần tử trang. Phải có ít nhất hai phần tử trang trên một trang chưa có trong một nhóm khác. Một số phần tử trang, chẳng hạn như videos! tables và placeholders Không thể nhóm.

UngroupObjectsRequest

Huỷ nhóm các đối tượng, chẳng hạn như groups.

Biểu diễn dưới dạng JSON 
{
  "objectIds": [
    string
  ]
}
Trường
objectIds[]

string

Mã đối tượng của các đối tượng cần huỷ nhóm.

Chỉ groups không có bên trong groups có thể huỷ nhóm. Tất cả các nhóm phải nằm trên cùng một trang. Nhóm đó sẽ bị xoá. Kích thước và vị trí trực quan của tất cả thành phần con được giữ nguyên.

UpdatePageElementAltTextRequest

Cập nhật tiêu đề văn bản thay thế và/hoặc mô tả của page element.

Biểu diễn dưới dạng JSON 
{
  "objectId": string,
  "title": string,
  "description": string
}
Trường
objectId

string

Mã nhận dạng đối tượng của phần tử trang mà nội dung cập nhật được áp dụng.

title

string

Tiêu đề văn bản thay thế đã cập nhật của phần tử trang. Nếu bạn không đặt giá trị này, giá trị hiện có sẽ được duy trì. Tiêu đề này hiển thị với trình đọc màn hình và các giao diện hỗ trợ tiếp cận khác. Chỉ sử dụng các giá trị liên quan đến nội dung của phần tử trang mà con người có thể đọc được.

description

string

Nội dung mô tả văn bản thay thế được cập nhật của phần tử trang. Nếu bạn không đặt giá trị này, giá trị hiện có sẽ được duy trì. Nội dung mô tả hiển thị với trình đọc màn hình và các giao diện hỗ trợ tiếp cận khác. Chỉ sử dụng các giá trị mà con người có thể đọc được liên quan đến nội dung của phần tử trang.

ReplaceImageRequest

Thay thế hình ảnh hiện có 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ó.

Biểu diễn dưới dạng JSON 
{
  "imageObjectId": string,
  "imageReplaceMethod": enum (ImageReplaceMethod),

  // Union field image_source can be only one of the following:
  "url": string
  // End of list of possible types for union field image_source.
}
Trường
imageObjectId

string

Mã của hình ảnh hiện có sẽ được thay thế. Bạn có thể truy xuất mã nhận dạng từ phản hồi của một yêu cầu get.

imageReplaceMethod

enum (ImageReplaceMethod)

Phương thức thay thế.

Trường kết hợp image_source. Loại nguồn hình ảnh. image_source chỉ có thể là một trong những loại sau:
url

string

URL hình ảnh.

Hình ảnh được tìm nạp một lần tại thời điểm chèn và một bản sao được lưu trữ để hiển thị bên trong bản trình bày. 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.

URL đã cung cấp không được có độ dài vượt quá 2 KB. URL được lưu cùng với hình ảnh và được hiển thị thông qua Image.source_url .

UpdateSlidePropertiesRequest

Cập nhật các thuộc tính của một Trang trình bày.

Biểu diễn dưới dạng JSON 
{
  "objectId": string,
  "slideProperties": {
    object (SlideProperties)
  },
  "fields": string
}
Trường
objectId

string

Mã đối tượng của trang trình bày mà nội dung cập nhật sẽ được áp dụng.

slideProperties

object (SlideProperties)

Các thuộc tính của trang trình bày cần cập nhật.

fields

string (FieldMask format)

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

Bạn phải chỉ định ít nhất một trường. Phần tử gốc "slideProperties" được ngụ ý và không được chỉ định. Bạn có thể dùng một "*" để liệt kê mọi trường.

Ví dụ: để cập nhật xem một trang trình bày có bị bỏ qua hay không, hãy đặt fields thành "isSkipped".

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

UpdatePageElementsZOrderRequest

Cập nhật thứ tự Z của các phần tử trang. Thứ tự Z là thứ tự của các phần tử trên trang từ sau ra trước. Phần tử trang ở phía trước có thể che phủ các phần tử phía sau nó.

Biểu diễn dưới dạng JSON 
{
  "pageElementObjectIds": [
    string
  ],
  "operation": enum (ZOrderOperation)
}
Trường
pageElementObjectIds[]

string

Mã đối tượng của các phần tử trang cần cập nhật.

Tất cả các phần tử trang phải ở trên cùng một trang và không được nhóm lại với nhau.

operation

enum (ZOrderOperation)

Toán tử thứ tự Z để áp dụng trên các phần tử của trang.

Khi áp dụng toán tử trên nhiều phần tử trang, thứ tự Z tương đối trong các phần tử trang này trước khi toán tử được duy trì.

ZOrderOperation

Thao tác cập nhật thứ tự Z của phần tử trang.

Enum
Z_ORDER_OPERATION_UNSPECIFIED Thao tác không xác định.
BRING_TO_FRONT Đưa các phần tử trang lên đầu trang.
BRING_FORWARD Đưa các phần tử trang lên trước trên trang bằng một phần tử tương ứng với phần tử phía trước trong các phần tử trang được chỉ định.
SEND_BACKWARD Chuyển các phần tử trang lùi lại trên trang theo một phần tử so với phần tử lùi xa nhất trong các phần tử trang được chỉ định.
SEND_TO_BACK Chuyển các thành phần trang về cuối trang.

UpdateLineCategoryRequest

Cập nhật danh mục của line.

Biểu diễn dưới dạng JSON 
{
  "objectId": string,
  "lineCategory": enum (LineCategory)
}
Trường
objectId

string

Mã đối tượng của dòng mà bản cập nhật được áp dụng.

Chỉ một dòng có category cho biết đó là "trình kết nối" có thể được cập nhật.

Đường dây có thể được định tuyến lại sau khi cập nhật danh mục.

lineCategory

enum (LineCategory)

Danh mục dòng cần cập nhật.

Cụm từ chính xác line type được xác định dựa trên danh mục cần cập nhật và cách danh mục được định tuyến để kết nối với các phần tử khác của trang.

RerouteLineRequest

Chuyển hướng lại line để kết nối tại hai vị trí kết nối gần nhất trên các phần tử trang đã kết nối.

Biểu diễn dưới dạng JSON 
{
  "objectId": string
}
Trường
objectId

string

Mã đối tượng của đường cần định tuyến lại.

Chỉ một dòng có category cho biết đó là "trình kết nối" có thể định tuyến lại. Các kết nối bắt đầu và kết thúc của dòng phải nằm trên các phần tử trang khác nhau.