Requests

Yêu cầu

Một loại nội dung cập nhật duy nhất để áp dụng cho một 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 nhóm 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 trạng thái sau:
createSlide

object (CreateSlideRequest)

Tạo một 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ác 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 trường hợp của văn bản đã 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 phép 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 một 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 đường thẳng.

refreshSheetsChart

object (RefreshSheetsChartRequest)

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

updateShapeProperties

object (UpdateShapePropertiesRequest)

Cập nhật các thuộc tính của 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 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 TableCell.

updateLineProperties

object (UpdateLinePropertiesRequest)

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

createParagraphBullets

object (CreateParagraphBulletsRequest)

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

replaceAllShapesWithImage

object (ReplaceAllShapesWithImageRequest)

Thay thế tất cả các hình dạng đáp ứng một số tiêu chí bằng một hình ảnh.

duplicateObject

object (DuplicateObjectRequest)

Sao chép một phần tử trang hoặc trang trình bày.

updateTextStyle

object (UpdateTextStyleRequest)

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

replaceAllShapesWithSheetsChart

object (ReplaceAllShapesWithSheetsChartRequest)

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

deleteParagraphBullets

object (DeleteParagraphBulletsRequest)

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

updateParagraphStyle

object (UpdateParagraphStyleRequest)

Cập nhật kiểu của các đoạn trong 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 hàng Table.

mergeTableCells

object (MergeTableCellsRequest)

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

unmergeTableCells

object (UnmergeTableCellsRequest)

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

groupObjects

object (GroupObjectsRequest)

Nhóm các đối tượng, chẳng hạn như các phần tử trên 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ả văn bản thay thế của page element.

replaceImage

object (ReplaceImageRequest)

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

updateSlideProperties

object (UpdateSlidePropertiesRequest)

Cập nhật các thuộc tính của một 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 một line.

rerouteLine

object (RerouteLineRequest)

Định tuyến lại một line sao cho nó đượ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 được kết nối.

CreateSlideRequest

Tạo một 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, thì 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 những ký tự đó cũng như dấu gạch ngang 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ột mã nhận dạng, thì một mã nhận dạng duy nhất sẽ được tạo.

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 mẫu chính hiện tại, là một trong những mẫu chính sau:

  • Trang cái của chỉ mục trang trình bày trước.
  • Mẫu của trang trình bày đầu tiên, nếu insertionIndex bằng 0.
  • Mẫu chính đầ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 mẫu chính hiện tại, thì hệ thống sẽ trả về lỗi 400 yêu cầu không hợp lệ.

Nếu bạn không chỉ định một tham chiếu bố cục, thì trang trình bày sẽ sử dụng bố cục BLANK được xác định trước.

placeholderIdMappings[]

object (LayoutPlaceholderIdMapping)

Một danh sách không bắt buộc gồm các ánh xạ mã nhận dạng đối tượng từ placeholder (các) trên bố cục đến các phần giữ chỗ được tạo trên trang trình bày từ bố cục đã chỉ định. Chỉ có thể dùng khi bạn chỉ định slideLayoutReference.

LayoutReference

Thông tin tham khảo về bố cục trang trình bày. Điều này có thể tham chiếu đế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 nhóm kind. Loại LayoutReference. kind chỉ có thể là một trong những trạng thá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

Các loại bố cục được xác định trước. Đây là những bố cục thường thấy trong bản trình bày. Tuy nhiên, không có gì đảm bảo rằng những bố cục này sẽ xuất hiện trong mẫu hiện tại vì chúng có thể đã bị xoá hoặc không thuộc chủ đề được sử dụng. Ngoài ra, các phần giữ chỗ trên mỗi bố cục có thể đã được 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 đề phần.
SECTION_TITLE_AND_DESCRIPTION Bố cục có tiêu đề và tiêu đề phụ ở một bên và nội dung 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 đề là một số lớn.

LayoutPlaceholderIdMapping

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

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, thì 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 những ký tự đó cũng như dấu gạch ngang 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 nhỏ hơn 5 hoặc lớn hơn 50.

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

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

object (Placeholder)

Phần giữ chỗ trên bố cục sẽ được áp dụng cho một trang trình bày. Bạn chỉ cần type và index. Ví dụ: bố cục TITLE_AND_BODY được xác định trước thường có một phần giữ chỗ TITLE có chỉ mục 0 và một 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ột mã nhận dạng, thì 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 những ký tự đó cũng như dấu gạch ngang 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 nhỏ hơn 5 hoặc lớn hơn 50. Nếu trống, một giá trị nhận dạng riêng biệt sẽ được tạo.

elementProperties

object (PageElementProperties)

Các thuộc tính của phần tử cho hình dạng.

shapeType

enum (Type)

Loại hình dạng.

PageElementProperties

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

Lưu ý: Khi bạn tạo PageElement lần đầu, API có thể sửa đổi giá trị của cả size và transform, nhưng kích thước trực quan 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 nơi phần tử đó nằm.

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, thì 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 những ký tự đó cũng như dấu gạch ngang 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 nhỏ hơn 5 hoặc lớn hơn 50.

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

elementProperties

object (PageElementProperties)

Thuộc tính phần tử cho bảng.

Bảng sẽ được tạo ở kích thước bạn 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 điều chỉnh kích thước.

Các phép biến đổi bảng phải có tỷ lệ là 1 và không có thành phần cắt. Nếu không có phép biến đổi nào được cung cấp, bảng sẽ được đặt ở 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ã đố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í ô của bảng (không bắt buộc) nếu văn bản được chèn vào một ô của 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 văn mới sẽ được sao chép từ đoạn văn tại chỉ mục chèn hiện tại, bao gồm cả danh sách và dấu đầu dòng.

Kiểu văn bản cho văn bản được chèn sẽ được xác định tự động, thường 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 hiện có 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à ký tự trong Vùng sử dụng riêng của Mặt phẳng đa ngôn ngữ cơ bản của Unicode (U+E000 – U+F8FF) sẽ bị xoá 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 chỉ mục TextElement.

Chỉ mục này dựa trên mốc 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 chữ cái Unicode. Trong những trường hợp này, văn bản sẽ được chèn ngay sau cụm chữ.

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 cần chèn hàng vào.

cellLocation

object (TableCellLocation)

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

Một hàng mới sẽ được chèn lên trên (hoặc xuống dưới) hàng có ô tham chiếu. Nếu ô tham chiếu là một ô đã hợp nhất, thì một hàng mới sẽ được chèn lên trên (hoặc xuống dưới) ô đã hợp nhất.

insertBelow

boolean

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 yêu cầu.

InsertTableColumnsRequest

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

Các cột khác trong bảng sẽ được đổi kích thước cho phù hợp 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 cần chèn cột.

cellLocation

object (TableCellLocation)

Vị trí ô tham chiếu trong bảng mà 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 có ô tham chiếu. Nếu ô tham chiếu là một ô đã hợp nhất, thì mộ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

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.
number

integer

Số cột cần chèn. Tối đa 20 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í ô tham chiếu trong bảng mà hàng sẽ bị xoá.

Hàng mà ô này trải dài sẽ bị xoá. Nếu đây là một ô đã hợp nhất, thì nhiều hàng sẽ bị xoá. Nếu không còn hàng nào trong bảng sau khi xoá, 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 cần xoá cột.

cellLocation

object (TableCellLocation)

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

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

ReplaceAllTextRequest

Thay thế tất cả các trường hợp văn bản khớp với một tiêu chí bằng replace text.

Biểu diễn dưới dạng JSON 
{
  "replaceText": string,
  "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 trùng khớp.

pageObjectIds[]

string

Nếu không trống, hãy giới hạn số lượt khớp chỉ cho các phần tử trang trên những trang đã cho.

Trả về lỗi 400 yêu cầu không hợp lệ nếu bạn cung cấp mã nhận dạng đối tượng trang của notes master hoặc nếu một 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 nhóm criteria. Tiêu chí dùng để so khớp văn bản cần thay thế. criteria chỉ có thể là một trong những trạng thái sau:
containsText

object (SubstringMatchCriteria)

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

SubstringMatchCriteria

Một 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,
  "searchByRegex": boolean
}
Trường
text

string

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

matchCase

boolean

Cho biết liệu cụm từ 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 : cụm từ tìm kiếm không phân biệt chữ hoa chữ thường.
searchByRegex

boolean

Không bắt buộc. True nếu giá trị tìm kiếm được coi là một biểu thức chính quy. Mọi dấu gạch chéo ngược trong mẫu đều phải được thoát.

  • True : văn bản tìm kiếm được coi là một biểu thức chính quy.
  • False: văn bản tìm kiếm được coi là một chuỗi con để so khớp.

DeleteObjectRequest

Xoá một đối tượng, có thể là pages hoặc page elements, khỏi bản trình bày.

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

string

Mã đối tượng của trang hoặc phần tử trang cần xoá.

Nếu sau 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 một phần giữ chỗ bị xoá trên bố cục, thì mọi phần giữ chỗ trống kế thừa cũng sẽ bị xoá.

UpdatePageElementTransformRequest

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

Việc cập nhật phép biến đổi của một nhóm sẽ thay đổi phép biến đổi tuyệt đối của các phần tử trên trang trong nhóm đó, điều này có thể làm thay đổi hình thức trực quan của các phần tử. Hãy xem tài liệu về PageElement.transform để biết thêm thông tin 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 bản cập nhật biế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 kết quả của phép nối.
ABSOLUTE Thay thế ma trận AffineTransform hiện có 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ã nhận dạng của các trang trình bày trong bản trình bày cần được 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 nơi các trang trình bày sẽ được chèn, dựa trên cách sắp xếp trang trình bày trước khi di chuyển. Phải nằm trong khoảng từ 0 đến số trang trình bày trong bản trình bày, kể cả 0 và số trang trình bày.

DeleteTextRequest

Xoá văn bản khỏi một hình 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ã nhận dạng đố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í ô bảng không bắt buộc nếu văn bản cần xoá nằm trong một ô 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 chỉ mục TextElement.

Luôn có một ký tự xuống dòng ngầm ở cuối văn bản của hình dạng hoặc ô trong bảng mà bạn không thể xoá. Range.Type.ALL sẽ sử dụng ranh giới chính xác, nhưng bạn phải cẩn thận khi chỉ định ranh giới rõ ràng cho các loại phạm vi 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 cho textRange.start_index và 3 cho textRange.end_index.

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

Các dải chỉ chứa một đơn vị mã của một cặp thay thế sẽ được mở rộng để chứa cả hai đơn vị mã.

Phạm vi

Chỉ định một dải liên tục của một tập hợ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 tuỳ chọn dựa trên 0 của phần đầu bộ sưu tập. Bắt buộc đối với các dải FIXED_RANGE và FROM_START_INDEX.

endIndex

integer

Chỉ mục dựa trên 0 (không bắt buộc) của phần cuối bộ sưu tập. Bắt buộc đối với các dải FIXED_RANGE.

type

enum (Type)

Loại phạm vi.

Loại

Các loại phạm vi.

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

CreateImageRequest

Tạo một 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, thì 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 những ký tự đó cũng như dấu gạch ngang 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 nhỏ hơn 5 hoặc lớn hơn 50.

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

elementProperties

object (PageElementProperties)

Các 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 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.

Thuộc tính 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 dùng.

Thuộc tính PageElementProperties.transform là không bắt buộc. Nếu bạn không chỉ định một 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 nhóm image_source. Loại nguồn hình ảnh. image_source chỉ có thể là một trong những trạng thái sau:
url

string

URL của 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ị 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 được cung cấp phải có thể truy cập công khai và có độ dài tối đa là 2 KB. URL được lưu cùng với hình ảnh và hiển thị thông qua trường 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 OAuth 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, thì 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 những ký tự đó cũng như dấu gạch ngang 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 nhỏ hơn 5 hoặc lớn hơn 50.

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

elementProperties

object (PageElementProperties)

Các thuộc tính của phần tử cho video.

Thuộc tính 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.

Thuộc tính PageElementProperties.transform là không bắt buộc. Phép biến đổi không được có thành phần cắt. Nếu bạn không chỉ định một 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 thì mã nhận dạng là 1xCgQLFTJi5_Xl8DgW_lcUYq5e-q6Hi5Q.

Để truy cập vào một tệp video trên Google Drive, bạn có thể cần thêm một khoá tài nguyên vào tiêu đề HTTP cho một nhóm nhỏ các tệp cũ. Để biết thêm thông tin, hãy xem bài viết 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 trong 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 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ã nhận dạng đố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 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ự từ [a-zA-Z0-9_] và sau đó là một số ký tự bất kỳ sau đây [a-zA-Z0-9_-:]. Độ dài của mã nhận dạng không được nhỏ hơn 5 hoặc lớn hơn 50. Nếu trống, một giá trị nhận dạng riêng biệt sẽ được tạo.

elementProperties

object (PageElementProperties)

Các 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 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.

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 nhóm nhỏ các tệp cũ. Để biết thêm thông tin, hãy xem bài viết Truy cập vào tệp được chia sẻ qua đường liên kết bằng khoá tài nguyên.

chartId

integer

Mã nhận dạng 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à một 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 đồ này 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 Khi bạn liên kết biểu đồ, biểu đồ đó sẽ được cập nhật và những cộng tác viên khác sẽ thấy đường liên kết đến bảng tính.

CreateLineRequest

Tạo một đường thẳ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, thì 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 những ký tự đó cũng như dấu gạch ngang 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 nhỏ hơn 5 hoặc lớn hơn 50.

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

elementProperties

object (PageElementProperties)

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

lineCategory
(deprecated)

enum (Category)

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

Không dùng nữa : sử dụng category thay thế.

line type chính xác được tạo sẽ đượ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ử khác trên trang.

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

category

enum (LineCategory)

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

line type chính xác được tạo sẽ đượ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ử khác trên 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 mà bạn chỉ định sẽ được dùng.

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

Danh mục

Danh mục dòng.

Enum
STRAIGHT Đầu nối thẳng, bao gồm cả đầu nối 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 đầu nối bị cong từ 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 trong 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 đồ trong Google Trang tính.

LƯU Ý: Để làm mới biểu đồ, bạn phải 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à các 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 cập nhật.

Bạn phải chỉ định ít nhất một trường. shapeProperties gốc được ngầm hiểu và không được chỉ định. Bạn có thể dùng một "*" làm ký hiệu 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 của thuộc tính đó 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 cập nhật.

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

Ví dụ: để cập nhật màu đường viền của hình ảnh, hãy đặt fields thành "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 của thuộc tính đó vào mặt nạ trường nhưng để trống 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ã nhận dạng đố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 cập nhật.

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

Ví dụ: để cập nhật màu đường viền video, hãy đặt fields thành "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 của thuộc tính đó 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 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 mà nội dung cập nhật được áp dụng.

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 cập nhật.

Bạn phải chỉ định ít nhất một trường. pageProperties gốc được ngầm hiểu và không được chỉ định. Bạn có thể dùng một "*" làm ký hiệu 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 trang, hãy đặt fields thành "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 của thuộc tính đó 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)

Dải ô của bảng đại diện cho một phần của bảng mà các nội dung cập nhật được áp dụng. Nếu bạn không chỉ định một phạm vi bảng, thì các 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 ô của 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. tableCellProperties gốc được ngầm hiểu và không được chỉ định. Bạn có thể dùng một "*" làm ký hiệu 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 ô trong bảng, 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 của thuộc tính đó vào mặt nạ trường nhưng để trống trường đó.

TableRange

Dải ô bảng biểu thị một tham chiếu đến một tập hợp con của bảng.

Bạn cần lưu ý rằng các ô do một dải ô trong bảng chỉ định không nhất thiết phải tạo thành một 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: 

 [   ][   ][   ]
 [   ][   ][   ]
 [             ]

Một dải ô trong bảng có vị trí = (0, 0), khoảng hàng = 3 và khoảng cột = 2 sẽ 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 phạm vi bảng.

rowSpan

integer

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

columnSpan

integer

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

UpdateLinePropertiesRequest

Cập nhật các thuộc tính của 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 đường kẻ mà nội dung cập nhật được áp dụng.

lineProperties

object (LineProperties)

Các thuộc tính đường kẻ 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. lineProperties gốc được ngầm hiểu và không được chỉ định. Bạn có thể dùng một "*" làm ký hiệu 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 kẻ, hãy đặt fields thành "lineFill.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 của thuộc tính đó vào mặt nạ trường nhưng để trống 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 dải chỉ mục văn bản đã cho.

Cấp độ lồng của mỗi đoạn văn sẽ được xác định bằng cách đếm các ký tự tab ở đầu mỗi đoạn văn. Để tránh có quá nhiều khoảng trống giữa dấu đầu dòng và đoạn văn tương ứng, yêu cầu này sẽ xoá các dấu tab đầu tiên. Điều này có thể làm thay đổi chỉ mục của các phần trong văn bản.

Nếu đoạn văn ngay trước các đoạn văn đang được cập nhật nằm trong một danh sách có giá trị đặt sẵn 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ã đối tượng của hình hoặc bảng có 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 một ô 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 để áp dụng các chế độ cài đặt sẵn cho dấu đầu dòng, dựa trên chỉ mục TextElement.

bulletPreset

enum (BulletGlyphPreset)

Các loại biểu tượng dấu đầu dòng sẽ được dùng. Mặc định là chế độ đặt sẵn BULLET_DISC_CIRCLE_SQUARE.

BulletGlyphPreset

Các mẫu biểu tượng dấu đầu dòng đặt sẵn cho danh sách trong văn bản.

Các mẫu này sử dụng những loại dấu đầu dòng sau:

  • ARROW : Mũi tên, tương ứng với điểm mã Unicode U+2794
  • ARROW3D : Mũi tên có hiệu ứng đổ bóng 3D, tương ứng với điểm mã Unicode U+27a2
  • CHECKBOX : Một hình vuông rỗng, tương ứng với điểm mã Unicode U+274f
  • CIRCLE : Một vòng tròn rỗng, tương ứng với điểm mã Unicode U+25cb
  • DIAMOND : Một hình kim cương đặc, tương ứng với điểm mã Unicode U+25c6
  • DIAMONDX : Một viên 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 liền, tương ứng với điểm mã Unicode U+25cf
  • SQUARE : Một hình vuông đặc, tương ứng với đ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, chẳng hạn như "a", "b" hoặc "c".
  • UPPERALPHA : Một chữ cái viết 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 : Một số có các chữ số đơn được thêm số 0 vào trước, chẳng hạn như "01", "02" hoặc "03". Các số có nhiều chữ số không có số 0 ở đầu.
  • ROMAN : Chữ số La Mã viết thường, chẳng hạn như "i", "ii" hoặc "iii".
  • UPPERROMAN : Một chữ số La Mã viết hoa, chẳng hạn như "I", "II" hoặc "III".
  • LEFTTRIANGLE : Hình tam giác chỉ 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 các 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 với các ký tự dấu đầu dòng DIAMONDX, ARROW3D và SQUARE 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 với các biểu tượng dấu đầu dòng CHECKBOX cho tất cả các cấp độ lồng danh sách.
BULLET_ARROW_DIAMOND_DISC Danh sách có dấu đầu dòng với các ký tự dấu đầu dòng ARROW, DIAMOND và DISC 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 với các ký tự dấu đầu dòng STAR, CIRCLE và SQUARE 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 các 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 các 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 các 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 với các ký tự dấu đầu dòng DIAMOND, CIRCLE và SQUARE cho 3 cấp độ lồng ghép danh sách đầu tiên.
NUMBERED_DIGIT_ALPHA_ROMAN Một danh sách được đánh số có 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 chấm.
NUMBERED_DIGIT_ALPHA_ROMAN_PARENS Một danh sách được đánh số có 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 ghép sử dụng ký tự của cấp độ lồng ghép trước đó làm tiền tố. Ví dụ: "1.", '1.1.', '2.', '2.2.'.
NUMBERED_UPPERALPHA_ALPHA_ROMAN Một danh sách được đánh số có các ký tự số UPPERALPHA, ALPHA và ROMAN 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 Một danh sách được đánh số có 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 Một danh sách được đánh số có các ký tự số ZERODIGIT, ALPHA và ROMAN 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 phù hợp với tiêu chí đã cho bằng hình ảnh được cung cấp.

Sau khi được chèn vào bản trình bày, hình ảnh thay thế các hình dạng sẽ có dạng hình chữ nhật và không có 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 : sử dụng imageReplaceMethod thay thế.

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à imageReplaceMethod, thì 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ì giá trị replaceMethod mà bạn chỉ định sẽ được dùng.

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

pageObjectIds[]

string

Nếu không trống, hãy giới hạn số lượt khớp chỉ cho các phần tử trang trên những trang đã cho.

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

Trường nhóm criteria. Các tiêu chí mà hình dạng phải đáp ứng để được thay thế. criteria chỉ có thể là một trong những trạng thá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 có chứa văn bản đã cho.

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

string

URL của 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ị 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 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 trường 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 sao cho vừa với kích thước của hình dạng ban đầu và giữ nguyên tỷ lệ khung hình của hình ảnh. Kích thước hiển thị 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 bạn 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 để lấp đầy hình dạng. Kích thước hiển thị 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. Bạn 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 sao cho vừa với kích thước của hình dạng ban đầu và giữ nguyên tỷ lệ khung hình của hình ảnh. Kích thước hiển thị 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 bạn 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 để lấp đầy hình dạng. Kích thước hiển thị của hình ảnh sẽ giống với hình dạng ban đầu.

DuplicateObjectRequest

Sao chép một phần tử trang hoặc trang trình bày.

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 được chỉ định. Khi bạn sao chép một phần tử trang, bản sao sẽ được đặt trên cùng một trang ở cùng vị trí với bản gốc.

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

string

Mã nhận dạng 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, chẳng hạn như khi bạn sao chép một trang trình bày hoặc một 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, bằng cách 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 các mã 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 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ũng có thể bao gồm những ký tự đó cũng như dấu gạch ngang 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 mới phải có độ dài từ 5 đến 50 ký tự.

Nếu bạn bỏ qua bất kỳ mã nhận dạng nào của đối tượng nguồn trong bản đồ, thì một mã nhận dạng ngẫu nhiên mới sẽ được chỉ định. Nếu bản đồ trống hoặc chưa đượ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 của 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 được tạo kiểu.

cellLocation

object (TableCellLocation)

Vị trí của ô trong bảng có chứa văn bản cần tạo kiểu. Nếu objectId đề cập đế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 cho 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 gốc, thì kiểu đó sẽ được đặt thành kế thừa.

Một số thay đổi về kiểu văn bản có thể gây ra những 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. Hã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 tạo kiểu.

Phạm vi có thể được mở rộng để bao gồm các dòng mới liền kề.

Nếu dải ô chứa toàn bộ một đoạn thuộc danh sách, thì dấu đầu dòng của đoạn đó cũng sẽ đượ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. style gốc được ngầm hiểu và không được chỉ định. Bạn có thể dùng một "*" làm ký hiệu 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 thuộc tính về giá trị mặc định, hãy thêm tên trường của thuộc tính đó vào mặt nạ trường nhưng để trống trường đó.

ReplaceAllShapesWithSheetsChartRequest

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

LƯU Ý: Để thay thế hình bằng 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 
{
  "containsText": {
    object (SubstringMatchCriteria)
  },
  "spreadsheetId": string,
  "chartId": integer,
  "linkingMode": enum (LinkingMode),
  "pageObjectIds": [
    string
  ]
}
Trường
containsText

object (SubstringMatchCriteria)

Các tiêu chí mà hình dạng phải đáp ứng để được thay thế. Yêu cầu này sẽ thay thế tất cả các hình 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ã nhận dạng 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à một hình ảnh không được liên kết.

pageObjectIds[]

string

Nếu không trống, hãy giới hạn số lượt khớp chỉ cho các phần tử trang trên những trang đã cho.

Trả về lỗi 400 yêu cầu không hợp lệ nếu bạn cung cấp mã nhận dạng đối tượng trang của notes page hoặc notes master, hoặc nếu không có trang nào có mã nhận dạng đối tượng đó 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 đồ này 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 Khi bạn liên kết biểu đồ, biểu đồ đó sẽ được cập nhật và những cộng tác viên khác sẽ thấy đường 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 trùng lặp với chỉ mục văn bản đã cho range.

Cấp độ lồng ghép của mỗi đoạn văn sẽ được giữ nguyên bằng cách thêm thụt lề vào đầu đoạn vă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 một ô 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 chỉ mục TextElement.

UpdateParagraphStyleRequest

Cập nhật kiểu cho tất cả các đoạn trong Shape hoặc Table trùng lặp với dải 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 được tạo kiểu.

cellLocation

object (TableCellLocation)

Vị trí của ô trong bảng chứa(các) đoạn văn cần tạo kiểu. Nếu objectId đề cập đế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 (ParagraphStyle)

Kiểu của đoạn văn.

textRange

object (Range)

Phạm vi văn bản chứa(các) đoạn văn cần tạo kiểu.

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. style gốc được ngầm hiểu và không được chỉ định. Bạn có thể dùng một "*" làm ký hiệu viết tắt để liệt kê mọi trường.

Ví dụ: để cập nhật chế độ căn chỉnh đoạn văn, hãy đặt fields thành "alignment".

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

UpdateTableBorderPropertiesRequest

Cập nhật các thuộc tính của đường viền bảng trong 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 một phần của bảng mà các nội dung cập nhật được áp dụng. Nếu bạn không chỉ định một phạm vi bảng, thì các 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 dải ô của bảng mà bạn muốn áp dụng nội dung cập nhật. Nếu bạn không chỉ định vị trí đường viền, thì các nội dung cập nhật sẽ áp dụng cho tất cả đường viền trong phạm vi 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. tableBorderProperties gốc được ngầm hiểu và không được chỉ định. Bạn có thể dùng một "*" làm ký hiệu 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 của thuộc tính đó vào mặt nạ trường nhưng để trống trường đó.

BorderPosition

Vị trí đường viền 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 phạm vi.
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 của dải ô.
OUTER Đường viền dọc theo bên ngoài của dải ô.
RIGHT Đường viền ở bên phải của dải ô.
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 chỉ mục từ 0 chỉ định những cột cần cập nhật. Nếu bạn không cung cấp chỉ mục, 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 của bảng cần cập nhật.

Nếu giá trị của tableColumnProperties#columnWidth trong yêu cầu nhỏ hơn 406.400 EMU (32 điểm), thì hệ thống sẽ trả về lỗi 400 yêu cầu không hợp lệ.

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. tableColumnProperties gốc được ngầm hiểu và không được chỉ định. Bạn có thể dùng một "*" làm ký hiệu viết tắ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 "columnWidth" có trong mặt nạ trường nhưng bạn không đặt thuộc tính này, thì 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 hàng Table.

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

string

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

rowIndices[]

integer

Danh sách các chỉ mục từ 0, cho biết những hàng cần cập nhật. Nếu bạn không cung cấp chỉ mục, 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 hàng của 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ầm hiểu và không được chỉ định. Bạn có thể dùng một "*" làm ký hiệu viết tắ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ần hợp nhất trong bảng.

Mọi văn bản trong các ô được hợp nhất sẽ được nối và lưu trữ trong ô trên cùng 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ì lỗi 400 yêu cầu không hợp lệ sẽ được trả về.

UnmergeTableCellsRequest

Huỷ hợp nhất các ô trong một 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ần tách trong bảng.

Tất cả các ô đã hợp nhất trong dải ô này sẽ được tách ra và những ô đã tách ra sẽ không bị ảnh hưởng. Nếu dải ô không có ô nào được hợp nhất, thì yêu cầu sẽ không làm gì cả. Nếu có văn bản trong bất kỳ ô nào đã hợp nhất, văn bản đó sẽ vẫn nằm trong ô trên cùng bên trái ("đầu") của khối ô chưa 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 Group trên cùng một trang với tất cả các thành phần 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ột mã nhận dạng, thì 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 những ký tự đó cũng như dấu gạch ngang 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 nhỏ hơn 5 hoặc lớn hơn 50.

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

childrenObjectIds[]

string

Mã nhận dạng đố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ử trên trang. Phải có ít nhất 2 phần tử trang trên cùng một trang chưa có trong một nhóm khác. Bạn không thể nhóm một số phần tử trên trang, chẳng hạn như videos, tables và placeholders.

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ã nhận dạng đối tượng của các đối tượng cần tách nhóm.

Chỉ những groups không nằm trong groups khác mới có thể được tách 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ả các thành phần con đều được giữ nguyên.

UpdatePageElementAltTextRequest

Cập nhật tiêu đề và/hoặc nội dung mô tả văn bản thay thế của một 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à các nội dung cập nhật được áp dụng.

title

string

Tiêu đề văn bản thay thế mới 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 sẽ xuất hiện trên 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.

description

string

Nội dung mô tả văn bản thay thế mới 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ì. Trình đọc màn hình và các giao diện hỗ trợ tiếp cận khác có thể truy cập vào nội dung mô tả này. 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ã nhận dạng 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 nhóm image_source. Loại nguồn hình ảnh. image_source chỉ có thể là một trong những trạng thái sau:
url

string

URL của 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ị trong bản trình bày. 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 ở định dạng PNG, JPEG hoặc GIF.

URL bạn cung cấp không được dài quá 2 KB. URL được lưu cùng với hình ảnh và hiển thị thông qua trường 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ã nhận dạng đối tượng của trang trình bày mà nội dung cập nhật đượ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 cập nhật.

Bạn phải chỉ định ít nhất một trường. "slideProperties" gốc được ngầm hiểu và không được chỉ định. Bạn có thể dùng một "*" làm ký hiệu viết tắ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 của thuộc tính đó vào mặt nạ trường nhưng để trống 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 các phần tử ở phía sau.

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ử trên trang cần cập nhật.

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

operation

enum (ZOrderOperation)

Thao tác Z-order cần áp dụng cho các phần tử trên trang.

Khi áp dụng thao tác 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 thao tác được duy trì.

ZOrderOperation

Thao tác cập nhật thứ tự Z của một 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ử trên trang lên đầu trang.
BRING_FORWARD Đưa các phần tử trang lên trước một phần tử trên trang so với phần tử ở phía trước nhất trong các phần tử trang được chỉ định.
SEND_BACKWARD Di chuyển các phần tử trên trang về phía sau một phần tử trên trang so với phần tử ở phía sau cùng trong số các phần tử trên trang được chỉ định.
SEND_TO_BACK Đưa các phần tử của trang ra phía sau trang.

UpdateLineCategoryRequest

Cập nhật danh mục của một 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 đường kẻ mà nội dung cập nhật được áp dụng.

Bạn chỉ có thể cập nhật một đường kẻ có category cho biết đó là "đường kết nối".

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

lineCategory

enum (LineCategory)

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

line type chính xác đượ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ử trang khác.

RerouteLineRequest

Định tuyến lại một line sao cho nó đượ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 được 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.

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