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 kết hợp 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 các trạng thái sau:
createSlide

object (CreateSlideRequest)

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

createShape

object (CreateShapeRequest)

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

createTable

object (CreateTableRequest)

Tạo 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 trên Google Trang tính.

createLine

object (CreateLineRequest)

Tạo một đường.

refreshSheetsChart

object (RefreshSheetsChartRequest)

Làm mới một 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 một 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 một 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ả các hình dạng phù hợp với một số tiêu chí bằng một hình ảnh.

duplicateObject

object (DuplicateObjectRequest)

Sao chép 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 một Shape hoặc Table.

replaceAllShapesWithSheetsChart

object (ReplaceAllShapesWithSheetsChartRequest)

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

deleteParagraphBullets

object (DeleteParagraphBulletsRequest)

Xoá dấu đầu dòng khỏi đoạ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 một Table.

updateTableColumnProperties

object (UpdateTableColumnPropertiesRequest)

Cập nhật các thuộc tính của mộ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ăn bản thay thế và/hoặc mô tả của 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 một line.

rerouteLine

object (RerouteLineRequest)

Định tuyến lại line sao cho thẻ đượ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ử của trang được 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ã đố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_-:]). Mã nhận dạng phải dài từ 5 đến 50 ký tự.

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

insertionIndex

integer

Chỉ mục (không bắt buộc) từ 0 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 cái đầ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 tham chiếu 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 các trạng thái sau:
predefinedLayout

enum (PredefinedLayout)

Bố cục định sẵn.

layoutId

string

Layout ID: ID đố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, phần 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 đề dạng 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ỗ đã xác định ở trên. Mã này sẽ được tạo vào 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 kết hợp 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ỉ typeindex là cần thiết. Ví dụ: giá trị xác định trước TITLE_AND_BODY bố cục thường có thể 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 một bố cục sẽ được áp dụng cho trang trình bày.

CreateShapeRequest

Tạo 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ã đố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 giấy tờ tuỳ thân 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 duy nhất sẽ được tạo.

elementProperties

object (PageElementProperties)

Thuộc tính phần tử của 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 sizetransform, 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 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ã đố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 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.

elementProperties

object (PageElementProperties)

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

Bảng sẽ được tạo theo kích thước được cung cấp, phụ 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ẽ được tự động đị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 không có biến đổi nào được cung cấp, bảng sẽ được căn giữa trên 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 vào.

cellLocation

object (TableCellLocation)

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

text

string

Văn bản sẽ được chèn.

Việc chèn một ký tự dòng mới sẽ ngầm tạo một dòng mới ParagraphMarker tại chỉ mục đó. Kiểu đoạn văn của đoạn mới sẽ được sao chép từ đoạn đó ở chỉ mục chèn hiện tại, bao gồm cả danh sách và dấu đầu dòng.

Kiểu văn bản cho văn bản được chèn sẽ được xác định tự động, thường giữ nguyên kiểu của văn bản bên cạnh. Trong hầu hết các trường hợp, 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 mà văn bản sẽ được chèn vào, theo đơn vị mã Unicode, dựa trên TextElement chỉ mục.

Chỉ mục từ số 0 và được tính từ đầu chuỗi. Có thể điều chỉnh chỉ mục để ngăn việc chèn vào các cụm grapheme 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 sẽ được chèn. Tối đa 20 thuộc tính 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 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ố lượng cột sẽ được chèn. Tối đa 20 thuộc tính 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à từ đó một hàng sẽ bị xoá.

Hàng kéo dài trong ô này sẽ bị xoá. Nếu đây là một ô đã 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ẽ bị xoá.

Cột trải rộng trong ô này sẽ bị xoá. Nếu đây là một ô đã 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 cho mã đối tượng trang là notes master hoặc nếu một trang có mã đố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 trong một hình dạng phù hợ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ó tuân theo cách viết hoa/viết thường hay không:

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

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ã đối tượng của phần tử trang hoặc 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, nhóm này 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 thông tin cập nhật về 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 những 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ự bản trình bày hiện có, không bị 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ố lượng trang trình bày trong bản trình bày, tính toàn bộ.

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ã đố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 TextElement chỉ mục.

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 giới hạn chính xác, nhưng bạn phải thận trọng khi chỉ định giới hạn rõ ràng cho các loại phạm vi FROM_START_INDEXFIXED_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 xóa văn bản vượt qua ranh giới của đoạn văn bản có thể dẫn đến các thay đổi đối với kiểu đoạn và danh sách khi hai đoạ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 kề 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 bắt đầu bằng 0 ở vị trí đầu tập hợp. Bắt buộc đối với FIXED_RANGEFROM_START_INDEX phạm vi ngày.

endIndex

integer

Chỉ mục (không bắt buộc) từ 0 ở cuối tập hợp. Bắt buộc đối với FIXED_RANGE phạm vi ngày.

type

enum (Type)

Loại dải ô.

Loại

Các loại dải ô.

Enum
RANGE_TYPE_UNSPECIFIED Loại phạm vi không xác định. Không được sử dụng giá trị này.
FIXED_RANGE Một phạm vi cố định. Cả hai thuộc tính startIndexendIndex phải được chỉ định.
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. Cả hai thuộc tính startIndexendIndex không được chỉ định.

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ã đố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 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.

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 theo tỷ lệ và căn giữa tương ứng với 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, hệ thống sẽ sử dụng kích thước mặc định của hình ảnh.

Chiến lược phát hành đĩa đơn 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 truy cập được 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à được hiển thị thông qua Image.source_url .

CreateVideoRequest

Tạo một 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ã đố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 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.

elementProperties

object (PageElementProperties)

Các 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, kích thước mặc định sẽ do máy chủ chọn.

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 một tệp video trên Google Drive, bạn có thể cần phải 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.

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 bảng tính.readonly, bảng tính, drive.readonly, drive.file hoặc Drive OAuth.

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 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_], theo sau là 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 duy nhấ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 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.

spreadsheetId

string

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

Bạn có thể cần phải 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 được. 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 đườ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ã đố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 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.

elementProperties

object (PageElementProperties)

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

lineCategory
(deprecated)

enum (Category)

Danh mục của đường kẻ sẽ được tạo.

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

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à một lineCategory, category sẽ được ưu tiên.

category

enum (LineCategory)

Danh mục của đường kẻ sẽ được 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à một lineCategory, 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ì hàm được chỉ định lineCategory giá trị đượ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 đường.

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

RefreshSheetsChartRequest

Làm mới một 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 đồ trong Google Trang tính.

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

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 một Shape.

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

string

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

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. 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 cho hình dạng, đặt fields đến "shapeBackgroundFill.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 đó.

UpdateImagePropertiesRequest

Cập nhật các thuộc tính của một 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 sẽ áp dụng nội dung cập nhật.

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. Gốc imageProperties đã đượ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 đường 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 một 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 sẽ áp dụng nội dung cập nhật.

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. 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 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 đó.

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

Bạn phải chỉ định ít nhất một trường. Gốc pageProperties đã đượ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 trang, đặt fields đến "pageBackgroundFill.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 đó.

UpdateTableCellPropertiesRequest

Cập nhật các thuộc tính của một 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 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 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 đồng nhất cho ô trong bảng, hãy đặt fields đến "tableCellBackgroundFill.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 đó.

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 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 ô của bảng có vị trí = (0, 0), khoảng hàng = 3 và khoảng 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 ô trong bảng.

rowSpan

integer

Độ rộng hàng của dải ô của 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à nội dung cập nhật sẽ đượ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. Gốc lineProperties đã đượ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, đặt fields đến "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 chồng chéo 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ã đối tượng của hình dạng 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í ô không bắt buộc trong bảng nếu văn bản cần sửa đổi nằm trong 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 á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ự gạch đầu dòng sẽ được sử dụng. Mặc định là BULLET_DISC_CIRCLE_SQUARE giá trị đặt trước.

BulletGlyphPreset

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

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

  • ARROW : Một mũi tên, tương ứng với điểm mã Unicode U+2794
  • ARROW3D : Một mũi tên mang màu 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 một điểm mã Unicode U+25cb
  • DIAMOND : Một hình thoi đặc, tương ứng với điểm mã Unicode U+25c6
  • DIAMONDX : Hình thoi có dấu "x", tương ứng với điểm mã Unicode U+2756
  • HOLLOWDIAMOND : 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 điểm mã Unicode U+25a0
  • STAR : Một 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, 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 số có một chữ số với tiền tố là số 0, 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 : Một chữ số la mã viết thường, như 'i', 'ii' hoặc 'iii'.
  • UPPERROMAN : Một chữ số la mã viết hoa, 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 gồm DISC, CIRCLESQUARE ký tự gạch đầu dòng 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 gồm DIAMONDX, ARROW3DSQUARE 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 gồm ARROW, DIAMONDDISC 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 gồm STAR, CIRCLESQUARE 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 gồm ARROW3D, CIRCLESQUARE ký tự gạch đầu dòng 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 gồm LEFTTRIANGLE, DIAMONDDISC ký tự gạch đầu dòng 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 gồm DIAMONDX, HOLLOWDIAMONDSQUARE ký tự gạch đầu dòng 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 gồm DIAMOND, CIRCLESQUARE 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, ALPHAROMAN 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ố có DIGIT, ALPHAROMAN ký tự số cho 3 cấp độ lồng ghép danh sách đầu tiên, tiếp theo là dấu ngoặc đơn.
NUMBERED_DIGIT_NESTED Danh sách được đánh số có DIGIT ký tự số đượ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, ALPHAROMAN 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ố có UPPERROMAN, UPPERALPHADIGIT 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_ZERODIGIT_ALPHA_ROMAN Danh sách được đánh số có ZERODIGIT, ALPHAROMAN 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 phù hợp với tiêu chí đã cho bằng hình ảnh được cung cấp.

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

Nếu bạn chỉ định cả replaceMethod và một imageReplaceMethod, 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 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 cho mã đối tượng trang là notes page hoặc notes master hoặc nếu trang có mã đố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í mà hình dạng phải khớp để được thay thế. criteria chỉ có thể là một trong các 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 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 các trạng thá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 nhỏ hơn 50 MB, không được vượt quá 25 megapixel và phải ở một trong các định dạng PNG, JPEG hoặc GIF.

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 theo 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 và 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 như 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 theo 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 và 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 như hình dạng ban đầu.

DuplicateObjectRequest

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

Khi 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 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ử ban đầu.

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, ví dụ: khi sao chép một trang trình bày hoặc phần tử trang nhóm. Ánh xạ 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 đối tượng gốc và giá trị của đối tượng này là những mã nhận dạng sẽ được gán cho đối tượng trùng lặp tương ứng. Mã nhận dạng bản sao của đối tượng nguồn cũng có thể được chỉ định trong bản đồ này, sử dụng cùng một giá trị của thuộc tính objectId làm khoá và mã 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 bất kỳ mã nhận dạng nào của đối tượng nguồn bị bỏ qua khỏi bản đồ, thì một mã nhận dạng ngẫu nhiên mới sẽ được gán. 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 một 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 đề 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 (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 mẹ, thì kiểu đó sẽ được thiết lập để kế thừa.

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

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

Nếu dải ô chứa đầy đủ một đoạn thuộc một danh sách, dấu đầu dòng của đoạn đó cũng được cập nhật theo kiểu văn bản phù hợp.

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 đến "bold".

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

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 phải sử dụng ít nhất một trong các phạm vi bảng tính.readonly, bảng tính, drive.readonly hoặc điều khiển 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ã 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 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 cho mã đối tượng trang là notes page hoặc notes master hoặc nếu trang có mã đố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 được. 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á các dấu đầu dòng khỏi tất cả các đoạn chồng chéo với chỉ mục văn bản cho trước 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 dạng hoặc bảng có chứa văn bản cần xoá dấu đầu dòng.

cellLocation

object (TableCellLocation)

Vị trí ô không bắt buộc trong bảng nếu văn bản cần sửa đổi nằm trong 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ấu đầu dòng, dựa trên TextElement chỉ mục.

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

borderPosition

enum (BorderPosition)

Vị trí đường viền trong dải ô của 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 cho đường viền bảng, đặt fields đến "tableBorderFill.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 đó.

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 bên ngoài dải ô.
RIGHT Đường viền ở bên phải dải ô.
TOP Đường viền ở đầu dải ô.

UpdateTableColumnPropertiesRequest

Cập nhật các thuộc tính của mộ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 dựa trên 0 chỉ định cột nào 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ủa 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 cập nhật.

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

Ví dụ: để cập nhật chiều rộng của cột, hãy đặt fields đến "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ã đối tượng của bảng.

rowIndices[]

integer

Danh sách chỉ mục từ 0 chỉ định hàng nào 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 cho 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. Gốc tableRowProperties đã được ngụ ý và không được chỉ định. Một "*" có thể được sử dụng làm cú pháp viết tắt để liệt kê mọi trường.

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

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

MergeTableCellsRequest

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

Mọi văn bản trong các ô đang được hợp nhất sẽ được nối và lưu trữ trong ô phí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 ô 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, yêu cầu sẽ không có tác dụng gì. Nếu có văn bản trong bất kỳ ô đã hợp nhất nào, văn bản đó sẽ vẫn nằm trong ô phía trên bên trái ("đầu") của khối kết quả gồm các ô chưa được hợp nhất.

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 để tạo nhóm.

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.

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, tablesplaceholders 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 ở 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ã đối tượng của phần tử trang sẽ áp dụng nội dung cập nhật.

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 chính sách này, thì giá trị hiện tại sẽ được duy trì. Tiêu đề sẽ 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 chính sách này, thì giá trị hiện tại 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ị liên quan đến nội dung của phần tử trang mà con người có thể đọc được.

ReplaceImageRequest

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

Việc thay thế một hình ảnh sẽ xoá một số image effects từ hình ảnh hiện tại.

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 tại sẽ được thay thế. Mã nhận dạng có thể được truy xuất từ phản hồi của yêu cầu nhận.

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

Bạn phải chỉ định ít nhất một trường. Thuộc tính gốc 'slideProperties' đã đượ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 xem một trang trình bày có bị bỏ qua hay không, hãy đặt fields đến "isSkipped".

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

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 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 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 Đưa các phần tử trang lùi lại trên trang bằng một phần tử so với phần tử xa nhất phía sau trong các phần tử trang được chỉ định.
SEND_TO_BACK Đưa các phần tử trang ra 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 dòng mà nội dung cập nhật sẽ đượ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 này có thể được định tuyến lại sau khi cập nhật danh mục.

lineCategory

enum (LineCategory)

Danh mục đường kẻ 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

Định tuyến lại line sao cho thẻ đượ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ử của 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.

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.