Requests

Yêu cầu

Một loại nội dung cập nhật được á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.
}
Các trường
Trường nhóm kind. Loại nội dung cập nhật. Chỉ có đúng một trường là bắt buộc. kind chỉ có thể là một trong những loại sau đây:
createSlide

object (CreateSlideRequest)

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

createShape

object (CreateShapeRequest)

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

createTable

object (CreateTableRequest)

Tạo bảng mới.

insertText

object (InsertTextRequest)

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

insertTableRows

object (InsertTableRowsRequest)

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

insertTableColumns

object (InsertTableColumnsRequest)

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

deleteTableRow

object (DeleteTableRowRequest)

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

deleteTableColumn

object (DeleteTableColumnRequest)

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

replaceAllText

object (ReplaceAllTextRequest)

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

deleteObject

object (DeleteObjectRequest)

Xóa 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 tập hợp các 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 dạng hoặc một ô trong bảng.

createImage

object (CreateImageRequest)

Tạo hình ảnh.

createVideo

object (CreateVideoRequest)

Tạo video.

createSheetsChart

object (CreateSheetsChartRequest)

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

createLine

object (CreateLineRequest)

Tạo đường.

refreshSheetsChart

object (RefreshSheetsChartRequest)

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

updateShapeProperties

object (UpdateShapePropertiesRequest)

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

updateImageProperties

object (UpdateImagePropertiesRequest)

Cập nhật các thuộc tính của 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 văn bản.

replaceAllShapesWithImage

object (ReplaceAllShapesWithImageRequest)

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

duplicateObject

object (DuplicateObjectRequest)

Sao y trang trình bày hoặc phần tử trang.

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 khớp với một số tiêu chí bằng biểu đồ trên Google Trang tính.

deleteParagraphBullets

object (DeleteParagraphBulletsRequest)

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

updateParagraphStyle

object (UpdateParagraphStyleRequest)

Cập nhật kiểu của đ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)

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

groupObjects

object (GroupObjectsRequest)

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

ungroupObjects

object (UngroupObjectsRequest)

Tách 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 nội dung mô tả về một page element.

replaceImage

object (ReplaceImageRequest)

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

updateSlideProperties

object (UpdateSlidePropertiesRequest)

Cập nhật các thuộc tính của 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 line sao cho nó được kết nối tại hai trang web kết nối gần nhất trên các phần tử của trang được kết nối.

Tạo Yêu cầu trang trình bày

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)
    }
  ]
}
Các trường
objectId

string

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

Nếu bạn chỉ định ID thì ID đó 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ã này phải bắt đầu bằng một ký tự bao gồm 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 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ã phải từ 5 đến 50 ký tự.

Nếu bạn không chỉ định ID, ID duy nhất được tạo.

insertionIndex

integer

Chỉ mục không bắt buộc cho biết vị trí chèn 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 cần chèn vào, dựa trên trang chính hiện tại, đây là một trong các giá trị sau:

  • Bản chính của chỉ mục trang trình bày trước.
  • Trang cái 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 bản chính hiện tại, hệ thống sẽ trả về lỗi yêu cầu 400 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 bố cục BLANK được xác định trước.

placeholderIdMappings[]

object (LayoutPlaceholderIdMapping)

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

Tệp đối chiếu bố cục

Tài liệu tham khảo về bố cục trang trình bày. Điều này có thể tham chiếu:

  • 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.
}
Các trường
Trường nhóm kind. Loại LayoutReference. kind chỉ có thể là một trong những loại sau đây:
predefinedLayout

enum (PredefinedLayout)

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

layoutId

string

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

Bố cục định sẵn

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 có gì đảm bảo rằng những bố cục này sẽ xuất hiện trong bản cái hiện tại vì có thể chúng đã bị xoá hoặc không thuộc giao diện được sử dụng. Ngoài ra, 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ó trình 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 kia.
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.
MAIN_POINT Bố cục có một điểm chính.
BIG_NUMBER Bố cục có tiêu đề số lớn.

Layout chỗIdId

Ánh xạ ID 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 đã 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.
}
Các 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 sẽ được tạo trên trang trình bày.

Nếu bạn chỉ định ID thì ID đó 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ã này 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 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 ID, ID duy nhất đượ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 loại sau đây:
layoutPlaceholder

object (Placeholder)

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

layoutPlaceholderObjectId

string

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

Tạo hình yêu cầu

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

string

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

Nếu bạn chỉ định ID thì ID đó 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ã này 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 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, hệ thống sẽ tạo một giá trị nhận dạng duy nhất.

elementProperties

object (PageElementProperties)

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

shapeType

enum (Type)

Loại hình dạng.

Thuộc tính phần tử trang

Thuộc tính chung cho một phần tử trang.

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

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

string

ID đối tượng của trang nơi đặt phần tử.

size

object (Size)

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

transform

object (AffineTransform)

Phép biến đổi cho phần tử.

Tạo yêu cầu bảng

Tạo bảng mới.

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

string

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

Nếu bạn chỉ định ID thì ID đó 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ã này 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 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 ID, ID duy nhất đượ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 được cung cấp, theo kích thước tối thiểu. Nếu bạn không cung cấp kích thước thì bảng sẽ được tự động điều chỉnh kích thước.

Phép biến đổi bảng phải có tỷ lệ 1 và không có thành phần cắt. Nếu không có chuyể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.

Yêu cầu văn bản chèn

Chèn văn bản vào 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
}
Các trường
objectId

string

ID đố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í ô bảng tuỳ chọn nếu văn bản được chèn vào một ô bảng. Nếu có, ID đối tượng 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 ParagraphMarker mới tại chỉ mục đó. Kiểu đoạn của đoạn mới sẽ được sao chép từ đoạn tại chỉ mục chèn hiện tại, bao gồm cả danh sách và dấu đầu dòng.

Kiểu văn bản cho văn bản được chèn sẽ được xác định tự động, thường duy trì kiểu văn bản lân cận. Trong hầu hết trường hợp, văn bản sẽ được thêm vào TextRun tồn tại trong chỉ mục chèn.

Một số ký tự điều khiển (U + 0000-U + 0008, U + 000C-U + 001F) và các ký tự từ Vùng sử dụng riêng trên mặt phẳng đa ngôn ngữ Unicode Basic (U + E000-U + F8FF) sẽ bị xóa khỏi văn bản được chèn.

insertionIndex

integer

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

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

Yêu cầu InsertTableRows

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

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

string

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

cellLocation

object (TableCellLocation)

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

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

insertBelow

boolean

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

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

integer

Số hàng được chèn. Tối đa 20 yêu cầu.

Yêu cầu Chèn Bảng

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

Các cột khác trong bảng sẽ được đổi kích thước để 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
}
Các trường
tableObjectId

string

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

cellLocation

object (TableCellLocation)

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

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

insertRight

boolean

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

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

integer

Số cột được chèn. Tối đa 20 yêu cầu.

XóaBảngHàngYêu cầu

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

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

string

Bảng để xóa hàng.

cellLocation

object (TableCellLocation)

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

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

XóaBảngCộtYêu cầu

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

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

string

Bảng để xóa cột.

cellLocation

object (TableCellLocation)

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

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

Thay thế tất cả văn bản yêu cầu

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

Biểu diễn dưới dạng JSON 
{
  "replaceText": string,
  "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.
}
Các trường
replaceText

string

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

pageObjectIds[]

string

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

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

object (SubstringMatchCriteria)

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

Tiêu chí so khớp chuỗi con

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

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

string

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

matchCase

boolean

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

  • True : tìm kiếm phân biệt chữ hoa chữ thường.
  • False : cụm từ tìm kiếm có phân biệt chữ hoa chữ thường.

Xóa đối tượng yêu cầu

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

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

string

ID đối tượng của trang hoặc phần tử trang cần xóa.

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

Nếu một 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á.

UpdatePageElementTransformYêu cầu

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

Việc cập nhật biến đổi của một nhóm sẽ thay đổi biến đổi tuyệt đối của các thành phần trang trong nhóm đó. Điều này có thể thay đổi giao diện trực quan của nhóm. 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)
}
Các trường
objectId

string

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

Chế độ áp dụng

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 tại và thay thế ma trận hiện tại bằng phép nối kết quả.
ABSOLUTE Thay thế ma trận AffineTransform hiện tại bằng ma trận mới.

Cập nhật trang trình bày về yêu cầu vị trí

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
}
Các trường
slideObjectIds[]

string

Mã trang trình bày trong bản trình bày mà bạn cần 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 nơi chèn các trang trình bày, dựa trên việc 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, tính toàn bộ.

Yêu cầu xóa văn bản

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

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

string

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

cellLocation

object (TableCellLocation)

Vị trí ô bảng tuỳ chọn nếu văn bản cần xoá khỏi một ô trong bảng. Nếu có, ID đối tượng 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 của TextElement.

Luôn có một ký tự dòng mới ngầm ẩn ở cuối văn bản trong hình dạng hoặc của ô không thể xóa được. Range.Type.ALL sẽ sử dụng đúng ranh giới, nhưng bạn phải cẩn thận khi chỉ định ranh giới rõ ràng cho các loại dải ô FROM_START_INDEX và FIXED_RANGE. Ví dụ: nếu văn bản là "ABC", 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 có thể dẫn đến thay đổi đối với kiểu đoạn và danh sách khi hai đoạn văn được hợp nhất.

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 phạm vi liền kề của 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)
}
Các trường
startIndex

integer

Chỉ mục bắt đầu của tập hợp. Bắt buộc đối với các phạm vi FIXED_RANGE và FROM_START_INDEX.

endIndex

integer

Chỉ mục không bắt buộc của số cuối của tập hợp. Bắt buộc đối với phạm vi 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. Không được sử dụng giá trị này.
FIXED_RANGE Phạm vi cố định. Bạn phải chỉ định cả startIndex và endIndex.
FROM_START_INDEX Bắt đầu dải ô tại startIndex và tiếp tục cho đến khi hết bộ sưu tập. Không được chỉ định endIndex.
ALL Đặt dải ô thành toàn bộ chiều dài của tập hợp. Không được chỉ định cả startIndex và endIndex.

Tạo yêu cầu hình ảnh

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.
}
Các trường
objectId

string

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

Nếu bạn chỉ định ID thì ID đó 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ã này 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 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 ID, ID duy nhất được tạo.

elementProperties

object (PageElementProperties)

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

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

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

Bạn không bắt buộc phải sử dụng thuộc tính PageElementProperties.transform. Nếu bạn không chỉ định chuyể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 loại sau đây:
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à bản sao đượ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 phải truy cập công khai và có độ dài tối đa 2 KB. URL này được lưu cùng với hình ảnh và hiển thị thông qua trường Image.source_url.

Tạo yêu cầu video

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 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
}
Các trường
objectId

string

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

Nếu bạn chỉ định ID thì ID đó 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ã này 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 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 ID, ID duy nhất được tạo.

elementProperties

object (PageElementProperties)

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

Bạn không bắt buộc phải sử dụng thuộc tính PageElementProperties.size. Nếu bạn không chỉ định kích thước thì kích thước mặc định sẽ được máy chủ chọn.

Bạn không bắt buộc phải sử dụng thuộc tính PageElementProperties.transform. Phép biến đổi không được có thành phần cắt. Nếu bạn không chỉ định chuyể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 duy nhấ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 một 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 tệp video trên Google Drive, bạn có thể cần phải thêm khóa 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 phần Truy cập vào tệp được chia sẻ đường liên kết bằng khoá tài nguyên.

Tạo yêu cầu biểu đồ trang tính

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

LƯU Ý: Việc tạo biểu đồ yêu cầu ít nhất một trong các bảng tính.chỉ xem, bảng tính, drive.readonly, drive.file hoặc drive OAuth phạm vi.

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

string

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

Nếu được chỉ định, ID 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. ID phải bắt đầu bằng ký tự từ [a-zA-Z0-9_], sau đó là bất kỳ số nào trong các ký tự sau [a-zA-Z0-9_-:]. Độ dài của ID không được nhỏ hơn 5 hoặc lớn hơn 50. Nếu trống, hệ thống sẽ tạo một giá trị nhận dạng duy nhất.

elementProperties

object (PageElementProperties)

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

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

spreadsheetId

string

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

Bạn có thể cần thêm khóa tài nguyên vào tiêu đề HTTP cho một số tệp cũ. Để biết thêm thông tin, hãy xem phần Truy cập vào tệp được chia sẻ đườ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à một hình ảnh không được liên kết.

Chế độ liên kết

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

Tạo dòng yêu cầu

Tạo đường.

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

string

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

Nếu bạn chỉ định ID thì ID đó 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ã này 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 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 ID, ID duy nhất được tạo.

elementProperties

object (PageElementProperties)

Thuộc tính phần tử cho đường.

lineCategory
(deprecated)

enum (Category)

Danh mục dòng được tạo.

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

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

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

category

enum (LineCategory)

Danh mục dòng được tạo.

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

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 được chỉ định sẽ được sử dụng.

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

Category (Danh mục)

Danh mục dòng.

Enum
STRAIGHT Đường nối thẳng, bao gồm cả đường nối thẳng 1. Đây là danh mục mặc định khi bạn không chỉ định danh mục.
BENT Các đầ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.

Làm mới yêu cầu trang tính biểu đồ

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

LƯU Ý: Việc làm mới biểu đồ cần ít nhất một trong các bảng tính.Chỉ xem bảng tính, drive.readonly hoặc phạm vi OAuth của Drive.

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

string

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

Cập nhật

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
}
Các trường
objectId

string

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

shapeProperties

object (ShapeProperties)

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.

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

Ví dụ: để cập nhật màu nền đồng nhất của hình dạng, hãy đặt fields thành "shapeBackgroundFill.solidFill.color".

Để đặt lại thuộc tính về giá trị mặc định của nó, hãy bao gồm tên trường của nó trong mặt nạ trường nhưng không để trống trường đó.

Cập nhậtThuộc tính hình ảnh

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
}
Các 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)

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.

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

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

Để đặt lại thuộc tính về giá trị mặc định của nó, hãy bao gồm tên trường của nó trong mặt nạ trường nhưng không để trống trường đó.

Cập nhật thuộc tính video

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
}
Các trường
objectId

string

Mã đối tượng của video có á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.

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

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

Để đặt lại thuộc tính về giá trị mặc định của nó, hãy bao gồm tên trường của nó trong mặt nạ trường nhưng không để trống trường đó.

Cập nhật các thuộc tính trang yêu cầu

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
}
Các trường
objectId

string

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

pageProperties

object (PageProperties)

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.

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

Ví dụ: để cập nhật màu nền đồng nhất cho nền trang, hãy đặt fields thành "pageBackgroundFill.solidFill.color".

Để đặt lại thuộc tính về giá trị mặc định của nó, hãy bao gồm tên trường của nó trong mặt nạ trường nhưng không để trống trường đó.

Cập nhậtBảngCellPropertiesRequest

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
}
Các trường
objectId

string

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

tableRange

object (TableRange)

Dải ô của bảng thể hiện tập hợp con của bảng sẽ áp dụng nội dung cập nhật. Nếu một dải ô không được chỉ định, các nội dung cập nhật sẽ áp dụng cho toàn bộ bảng.

tableCellProperties

object (TableCellProperties)

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.

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

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

Để đặt lại thuộc tính về giá trị mặc định của nó, hãy bao gồm tên trường của nó trong mặt nạ trường nhưng không để trống trường đó.

Phạm vi bảng

Dải ô đại diện cho một tham chiếu đến một tập hợp con của bảng.

Điều quan trọng cần lưu ý là các ô được chỉ định bởi phạm vi bảng không nhất thiết phải tạo thành hình chữ nhật. Ví dụ: giả sử chúng ta có một bảng 3 x 3 trong đó tất cả các ô của hàng cuối cùng được hợp nhất với nhau. Bảng sẽ có dạng như sau: 

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

Dải ô bảng có vị trí = (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
}
Các trường
location

object (TableCellLocation)

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

rowSpan

integer

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

columnSpan

integer

Nhịp cột của dải ô bảng.

Cập nhật Dòng yêu cầu Thuộc tính

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
}
Các trường
objectId

string

Mã đối tượng của dòng mà thông tin cập nhật được áp dụng.

lineProperties

object (LineProperties)

Thuộc tính dòng cần cập nhật.

fields

string (FieldMask format)

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

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

Ví dụ: để cập nhật màu đồng nhất của dòng, hãy đặt fields thành "lineFill.solidFill.color".

Để đặt lại thuộc tính về giá trị mặc định của nó, hãy bao gồm tên trường của nó trong mặt nạ trường nhưng không để trống trường đó.

Tạo Đoạn nội dung Dấu đầu dòng Yêu cầu

Tạo dấu đầu dòng cho tất cả các đoạn chồng chéo với dải chỉ mục văn bản đã cho.

Mức lồng ghép của từng đoạn văn sẽ được xác định bằng cách đếm số thẻ đứng trước mỗi đoạn. Để tránh thừa dấu cách giữa dấu đầu dòng và đoạn văn tương ứng, những thẻ đang ở đầu này sẽ bị xoá theo yêu cầu này. Thao tác này có thể thay đổi chỉ mục của các phần văn bản.

Nếu đoạn ngay trước khi các đoạn được cập nhật nằm trong danh sách có giá trị đặt trước phù hợp thì đoạn đó sẽ được thêm vào danh sách trước đó.

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

string

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

cellLocation

object (TableCellLocation)

Vị trí ô bảng tùy chọn nếu văn bản cần sửa đổi nằm trong ô bảng. Nếu có, ID đối tượng 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 giá trị đặt trước đầu dòng, dựa trên chỉ mục TextElement.

bulletPreset

enum (BulletGlyphPreset)

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

Đặt lại BulletGlyph

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

Thay thế tất cả hình dạng bằng yêu cầu hình ảnh

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

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

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

pageObjectIds[]

string

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

Trả về lỗi yêu cầu 400 không hợp lệ nếu mã đối tượng của trang là notes page hoặc 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 nhóm criteria. Tiêu chí mà hình dạng phải phù hợp để được thay thế. criteria chỉ có thể là một trong những loại sau đây:
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 loại sau đây:
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à bản sao đượ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ị qua trường Image.source_url.

Phương thức thay thế

Phương thức thay thế.

Enum
CENTER_INSIDE Điều chỉnh và căn giữa hình ảnh để vừa với ranh giới của hình dạng ban đầu và duy trì tỷ lệ co của hình ảnh. Kích thước hình ảnh được hiển thị có thể nhỏ hơn kích thước của hình dạng. Đây là phương thức mặc định khi không chỉ định phương pháp.
CENTER_CROP Chia 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. Kích thước đượ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.

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

Enum
IMAGE_REPLACE_METHOD_UNSPECIFIED Phương thức thay thế hình ảnh không xác định. Không được sử dụng giá trị này.
CENTER_INSIDE Điều chỉnh và căn giữa hình ảnh để vừa với ranh giới của hình dạng ban đầu và duy trì tỷ lệ co của hình ảnh. Kích thước hình ảnh được hiển thị có thể nhỏ hơn kích thước của hình dạng. Đây là phương thức mặc định khi không chỉ định phương pháp.
CENTER_CROP Chia 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. Kích thước được hiển thị của hình ảnh sẽ giống với hình dạng ban đầu.

Yêu cầu đối tượng trùng lặp

Sao y trang trình bày hoặc phần tử trang.

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

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

string

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

objectIds

map (key: string, value: string)

Đối tượng được sao chép có thể chứa các đối tượng khác, ví dụ như khi sao chép trang trình bày hoặc phần tử trang nhóm. Bản đồ này xác định cách tạo ID của các đối tượng trùng lặp: khóa là ID của đối tượng gốc và giá trị của đối tượng đó là ID sẽ được chỉ định cho đối tượng trùng lặp tương ứng. Mã nhận dạng trùng lặp 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 trường objectId làm khoá và giá trị nhận dạng mới mong muốn làm giá trị.

Tất cả các khóa phải tương ứng với ID hiện có trong bản trình bày. Tất 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ó thể bao gồm 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ã mới không được nhỏ hơn 5 hoặc lớn hơn 50.

Nếu bất kỳ ID đối tượng nguồn nào bị bỏ qua khỏi bản đồ, một ID ngẫu nhiên mới sẽ được chỉ định. 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 ID 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
}
Các trường
objectId

string

ID đố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 văn bản cần định kiểu. Nếu objectId tham chiếu đến một bảng, thì cellLocation phải có một giá trị. Nếu không thì không được.

style

object (TextStyle)

(Các) kiểu để đặt trên văn bản.

Nếu giá trị của một kiểu cụ thể khớp với kiểu gốc, thì kiểu đó sẽ được đặt thành kế thừa.

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

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

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

fields

string (FieldMask format)

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

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

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

Để đặt lại thuộc tính về giá trị mặc định của nó, hãy bao gồm tên trường của nó trong mặt nạ trường nhưng không để trống trường đó.

Thay thế tất cả các hình dạng bằng yêu cầu trang tính biểu đồ

Thay thế tất cả các hình dạng khớp với tiêu chí đã cho bằng biểu đồ trong Google Trang tính cho sẵn. Biểu đồ sẽ được thu nhỏ 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 bảng tính.chỉ đọc, bảng tính, drive.readonly hoặc Drive phạm vi OAuth.

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

object (SubstringMatchCriteria)

Tiêu chí mà hình dạng phải phù hợp để được thay thế. 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.

spreadsheetId

string

Mã của bảng tính Google Trang tính có 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à 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 các kết quả phù hợp thành các phần tử trang chỉ trên các trang nhất định.

Trả về lỗi yêu cầu 400 không hợp lệ nếu mã đối tượng của trang là notes page hoặc 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.

Chế độ liên kết

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

Yêu cầu Xóa Đoạn Dấu đầu dòng

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

Mức lồng ghép của mỗi đoạn văn sẽ được duy trì trực quan bằng cách thêm thụt lề vào đầu đoạn tương ứng.

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

string

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

cellLocation

object (TableCellLocation)

Vị trí ô bảng tùy chọn nếu văn bản cần sửa đổi nằm trong ô bảng. Nếu có, ID đối tượng 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 của TextElement.

Cập nhậtStyleStyleRequest

Cập nhật kiểu cho tất cả các đoạn trong Shape hoặc Table chồng chéo 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
}
Các trường
objectId

string

ID đố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 cần tạo kiểu. Nếu objectId tham chiếu đến một bảng, thì cellLocation phải có một giá trị. Nếu không thì không được.

style

object (ParagraphStyle)

Kiểu của đoạn.

textRange

object (Range)

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

fields

string (FieldMask format)

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

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

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

Để đặt lại thuộc tính về giá trị mặc định của nó, hãy bao gồm tên trường của nó trong mặt nạ trường nhưng không để trống trường đó.

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
}
Các trường
objectId

string

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

tableRange

object (TableRange)

Dải ô của bảng thể hiện tập hợp con của bảng sẽ áp dụng nội dung cập nhật. Nếu một dải ô không được chỉ định, 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 ô mà nội dung cập nhật sẽ áp dụng. Nếu vị trí đường viền không được chỉ định, các 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)

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.

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

Ví dụ: để cập nhật màu nền đồng nhất của đường viền bảng, hãy đặt fields thành "tableBorderFill.solidFill.color".

Để đặt lại thuộc tính về giá trị mặc định của nó, hãy bao gồm tên trường của nó trong mặt nạ trường nhưng không để trống trường đó.

Vị trí đường viền

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 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 của 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 cột Table.

Biểu diễn dưới dạng JSON 
{
  "objectId": string,
  "columnIndices": [
    integer
  ],
  "tableColumnProperties": {
    object (TableColumnProperties)
  },
  "fields": string
}
Các 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 bạn không cung cấp chỉ mục nào, 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 thấp hơn 406.400 EMU (32 điểm), thì hệ thống sẽ trả về lỗi 400 không hợp lệ.

fields

string (FieldMask format)

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

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

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

Nếu '"columnWidth"' được bao gồm 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 hàng Table.

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

string

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

rowIndices[]

integer

Danh sách chỉ mục dựa trên 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 của hàng trong bảng cần cập nhật.

fields

string (FieldMask format)

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

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

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

Nếu '"minRowHeight"' được bao gồm 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ẽ 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)
  }
}
Các trường
objectId

string

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

tableRange

object (TableRange)

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

Bất kỳ văn bản nào trong các ô đang được hợp nhất đều sẽ được nối và lưu trữ trong ô phí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 dải ô che phủ các ô đã được hợp nhất), lỗi yêu cầu 400 sẽ được trả về.

Hủy hợp nhất bảngCell

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

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

string

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

tableRange

object (TableRange)

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

Tất cả các ô đã hợp nhất trong dải ô này sẽ không được hợp nhất và các ô đã được hủy hợp nhất sẽ không bị ảnh hưởng. Nếu dải ô không có ô nào được hợp nhất, thì yêu cầu sẽ không thực hiện hành động nào. Nếu có văn bản trong bất kỳ ô đã hợp nhất nào, văn bản sẽ vẫn nằm trong ô phía trên bên trái ("đầu") của khối kết hợp gồm các ô chưa được hợp nhất.

Yêu cầu nhóm đối tượng

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

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

string

ID đối tượng do người dùng cung cấp cho nhóm sẽ được tạo.

Nếu bạn chỉ định ID thì ID đó 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ã này 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 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 ID, ID duy nhất được tạo.

childrenObjectIds[]

string

ID đối tượng của các đối tượng để nhóm.

Chỉ có thể nhóm các phần tử trang. Phải có ít nhất hai 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ử trang, chẳng hạn như videos, tables và placeholders.

Yêu cầu đối tượng không theo nhóm

Tách các đối tượng, chẳng hạn như groups.

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

string

ID đối tượng của các đối tượng để tách.

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

UpdatePageElementAltTextRequest

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

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

string

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

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 thì giá trị hiện tại sẽ vẫn được giữ nguyên. Người đọc màn hình và các giao diện hỗ trợ tiếp cận khác sẽ nhìn thấy tiêu đề này. Chỉ sử dụng các giá trị dễ đọc liên quan đến nội dung phần tử trang.

description

string

Mô tả cập nhật văn bản thay thế của phần tử trang. Nếu bạn không đặt thì giá trị hiện tại sẽ vẫn được giữ nguyên. Phần mô tả 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ị dễ đọc liên quan đến nội dung phần tử trang.

Thay thế yêu cầu hình ảnh

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

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

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

string

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

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 loại sau đây:
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à bản sao được lưu trữ để hiển thị bên trong bản trình bày. Hình ảnh phải nhỏ hơn 50 MB, không được vượt quá 25 megapixel và phải ở định dạng PNG, JPEG hoặc GIF.

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

Cập nhật

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
}
Các trường
objectId

string

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

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.

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

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

Để đặt lại thuộc tính về giá trị mặc định của nó, hãy bao gồm tên trường của nó trong mặt nạ trường nhưng không để trống trường đó.

UpdatePageElementsZOrderRequest

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

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

string

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

operation

enum (ZOrderOperation)

Phép toán theo thứ tự Z để áp dụng cho các phần tử của trang.

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

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ử trang lên trước trang.
BRING_FORWARD Đưa các phần tử trang tiến lên trên một trang bởi một phần tử tương ứng với phần tử tiến trong các phần tử trang được chỉ định.
SEND_BACKWARD Đưa các phần tử trang lùi lại một trang trong một phần tử được chỉ định.
SEND_TO_BACK Đưa phần tử trang vào mặt sau của trang.

Cập nhật Dòng yêu cầu

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

string

Mã đối tượng của dòng mà thông tin cập nhật được áp dụng.

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

Dòng này 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ậ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 định tuyến danh mục để kết nối với các phần tử trang khác.

Yêu cầu định tuyến lại

Định tuyến lại line sao cho nó được kết nối tại hai trang web 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
}
Các trường
objectId

string

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

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